在 DeepSeek Harness (DSH) 的智能体开发与运维中，长期运行的后台任务（如 Windows 计划任务或 KAi cron）往往缺乏可视化的监控入口。除了命令行查看状态，缺乏一个直观的看板来统一管理这些载体的调度、依赖脚本及健康状态。amoss-1/routine-taskboard 插件正是为此设计，它将 DSH Web GUI 的侧边栏改造为“例行看板”，为这些长寿命任务提供了一站式的管理界面。
插件定位¶
该插件由 Amoss-1 维护，是 DeepSeek Harness 插件生态中的一员。它专注于在 Web 界面展示计划任务、脚本步骤及健康灯。插件自 v0.1.9 起完全自包含，不再依赖官方的 dsh-taskboard 插件或其 /dsh-taskboard/state API。
核心功能¶
- 看板视图：在 DSH Web 侧边栏点击“例行看板”，即可在对话列切换到板式视图。每个长寿命调度任务渲染为一行，包含计划名称、时间、载体、依赖脚本、输入/输出文件及健康指示灯。
- 脚本步骤与执行：支持多脚本任务按编号步骤显示（1. 2. 3.）。每一步均可点击并在资源管理器中定位，也可单独点击 ▶ 运行。支持的脚本后缀包括 py/ps1/bat/vbs/mjs。
- 状态操作：针对 Windows 计划任务载体，提供行级操作按钮。按钮状态随任务状态变化：运行中显示“启动”和“停用”；已停用仅显示“重新上线”。
- 健康指示：通过三色指示灯展示状态：运行中（绿）、已停用（琥珀色）、异常（红）。
安装与启用¶
- 在终端执行安装命令：
dsh plugin --profile web add routine-taskboard
- 重启
dsh web服务。 - 在侧边栏会出现“例行看板”入口，点击即可在对话列切换视图。
配置与数据¶
- 固定装置注册表：插件通过
$DSH_HOME/storages/routine-taskboard.json读取任务卡片数据（包含 id、name、scripts、input、output、healthKey、status 等）。该文件默认为空数组，需通过主机 API 或直接编辑文件注册卡片。 - 用户配置文件：机器特定的路径映射和 curated 映射存放在
$DSH_HOME/storages/routine-taskboard.config.json。该文件不会在插件升级时被覆盖，适合存放业务路径和脚本映射。 - 后备机制：如果未配置文件，插件默认使用正则表达式提取路径。业务健康台账的文件路径可由环境变量
RTB_PIPELINE_FILE指定。
接口说明¶
插件通过以下主机路由提供数据访问与操作能力：
| 路由 | 方法 | 功能 |
|---|---|---|
/routine-taskboard/fixtures |
GET | 获取看板数据 |
/routine-taskboard/pipeline |
GET | 获取业务健康台账内容 |
/routine-taskboard/config |
GET | 获取用户配置 |
/routine-taskboard/open |
POST | 在资源管理器中打开指定路径 |
/routine-taskboard/run |
POST | 执行 schtasks /Run |
/routine-taskboard/state |
POST | 修改任务状态（/DISABLE 或 /ENABLE） |
/routine-taskboard/run-script |
POST | 后台运行单个脚本 |
注意事项¶
- 插件自 v0.1.9 起完全自包含，不依赖官方
dsh-taskboard。 - 升级插件时，用户配置文件（
.config.json）和固定装置注册表（.json）不会被覆盖。 - 插件以 DSH 进程的权限运行，安装前请检查源码与许可证。
总结¶
Routine Taskboard 通过可视化的行视图和脚本操作能力，降低了长期后台任务的维护成本。如需了解更多或贡献代码，可访问其 GitHub 仓库。
