Amoss-1/routine-taskboard

routine-taskboard

一个挂载在侧边栏的 DSH Web GUI 例行看板：每个长期存在的
计划任务（Windows 计划任务 / KAi cron）渲染为一行——计划、
载体、依赖脚本（编号步骤，可点击，可单独
运行）、带类型的输入/输出产物，以及一个健康指示灯。

自 v0.1.9 起完全自包含。 该看板由插件自身的
fixture 注册表驱动——它不依赖官方 dsh-taskboard
插件或其 /dsh-taskboard/state API。所有机器特定的映射都存放在
包外的用户配置文件中，因此升级永远不会覆盖它们。

安装

dsh plugin --profile web add routine-taskboard

重启 dsh web。侧边栏中会出现一个 例行看板 条目；点击它
可在对话列内切换该看板（与其他 dsh 看板面板互斥）。

你将获得

- 看板视图 — 计划名称 / 时间 / 载体 / 依赖脚本 / 输入文件 / 输出文件，
由插件自身的 GET /routine-taskboard/fixtures 注册表提供数据。
- 行操作 — ▶ 启动（schtasks /Run）、⏸ 停用（/DISABLE）、
↻ 重新上线（/ENABLE），适用于 Windows 计划任务载体。按钮会根据
状态自适应：已停用的任务只显示 重新上线；活动任务显示 启动+停用。
- 脚本步骤 — 多脚本任务渲染为编号步骤（1. 2. 3.）；
每个步骤都可点击（在资源管理器中显示），并带有自己的 ▶ 以仅运行
该脚本（解释器按扩展名选择：py/ps1/bat/vbs/mjs/js）。
- 健康指示灯与徽章 — 三种状态：运行中（绿色）/ 已停用（琥珀色）/
异常（红色），计划名称旁带有文字徽章。

Fixture 注册表（看板自身的数据）

看板从 $DSH_HOME/storages/routine-taskboard.json 渲染——一个
标牌数组（id / name / time / carrier / taskName / scripts / input / output /
healthKey / status）。默认随附为空；可通过宿主 API 注册卡片，或直接
填充该文件。它完全独立于任何其他插件。

用户配置（可选，推荐）

机器特定的路径和精选映射不随附。创建：

$DSH_HOME/storages/routine-taskboard.config.json

{
"pipelineFile": "D:/data/pipeline_status.json",
"scriptBases": [["^ops-automation[\\\\/", "D:\\work\\ops-automation\\"], ["^douyin_update\\.py$", "D:\\work\\douyin\\douyin_update.py"]],
"ioMap": { "douyin-update": { "input": "D:\\data\\门店记录表.xlsx", "output": "D:\\data\\维表.xlsx" } },
"ioByTitle": [{ "match": "临时区清理", "input": "D:\\work\\temp", "output": "" }],
"scriptMap": { "daily-report": [{ "label": "run.bat", "path": "D:\\work\\daily-report\\run.bat" }] },
"scriptByTitle": [{ "match": "会话守护", "scripts": [{ "label": "guard.ps1", "path": "D:\\x\\guard.ps1" }] }],
"pathHints": { "依赖文档": "D:\\data\\依赖文档\\" }
}

- pipelineFile — 业务健康台账（{tasks:{key:{status,note}}}）；
RTB_PIPELINE_FILE 环境变量为回退项。
- scriptBases — [regexSource, absoluteBase] 对，将卡片描述中的
相对脚本标记转换为绝对路径。
- ioMap / ioByTitle —— 按健康键或标题子串索引的精选输入/输出覆盖项（它们优先于正则提取）。
- scriptMap / scriptByTitle —— 为描述未能充分体现真实流水线的卡片提供的精选脚本步骤列表。
- pathHints —— 用于补全相对产物名称的文件夹基路径。

文件不存在 = 完全通用行为（仅正则提取）。该文件在插件启动时读取，并通过 GET /routine-taskboard/config 提供给客户端。

路由（宿主）

| 路由 | 方法 | 用途 |
| --- | --- | --- |
| /routine-taskboard/fixtures | GET | 看板自身的 fixture 注册表 |
| /routine-taskboard/pipeline | GET | 流水线账本内容 |
| /routine-taskboard/config | GET | 供客户端使用的用户配置 |
| /routine-taskboard/open | POST | 在资源管理器中显示路径 |
| /routine-taskboard/run | POST | schtasks /Run |
| /routine-taskboard/state | POST | schtasks /Change /DISABLE|/ENABLE |
| /routine-taskboard/run-script | POST | 分离运行一个脚本 |

开发与贡献

任何人都可以接手这个项目。事实来源：

git clone https://github.com/Amoss-1/routine-taskboard.git
cd routine-taskboard

目录结构

lib/index.js   # 宿主：路由 + fixture 注册表 + 配置加载（node）
lib/client.js  # Web 客户端：看板 UI、侧边栏入口、操作（浏览器）
cordis.patch.yml  # 打包补丁：在配置文件中注册插件行
README.md, LICENSE, package.json

宿主如何挂载

lib/index.js 导出 name、inject 和 apply(ctx)。路由注册位于
workspace/agent/web 链之下 —— 照搬官方模式：

ctx.inject(['workspaceRegistry'], (wsCtx) => {
wsCtx.inject(['agents'], (agentCtx) => {
agentCtx.inject(['webServer'], (webCtx) => {
webCtx.webServer.register({ kind: 'prefix', path: '/routine-taskboard', handler })
})
})
})

webServer 在普通插件 ctx 的顶层不可用。

本地迭代

1. 编辑 lib/*.js；语法检查：node --check lib/index.js && node --check lib/client.js。
2. 宿主变更：复制到配置文件中并重启 dsh web。
3. 客户端变更：浏览器强制刷新（Ctrl+Shift+R）即可。
4. 启动脚本仅在配置文件 package.json/锁文件发生变化时才强制重启；手动编辑宿主后，
touch cordis.patch.yml（修改时间）或使用强制重启。

发布

1. 在 package.json 中提升 version。
2. npm publish（验证 tarball 包含 lib/index.js + lib/client.js
—— 曾经发布过一个缺少 lib/ 的损坏包；请检查 npm pack --dry-run）。
3. 将相同文件推送到 GitHub 仓库（Amoss-1/routine-taskboard）。
4. 用户通过插件市场更新；升级永远不会触碰
$DSH_HOME/storages/routine-taskboard.config.json 或 fixture 注册表。

贡献

欢迎贡献 —— 缺陷报告、UI 打磨、文档和功能。
完整指南（环境搭建、issue/PR
流程、约定、发布检查清单）。仓库地址为
；采用 MIT 许可证。

许可证

MIT © Amoss-1