shengsheng90/DSH-taskboard

DSH Taskboard – DeepSeek Harness 的原生任务管理插件

是什么

• 一个插件（@shengsheng/dsh-taskboard），为 DeepSeek Harness AI 代理平台添加完整的 Taskboard UI 和 API。
• 所有数据均本地存储在 SQLite 文件（taskboard.sqlite）和附件文件夹中——无需外部服务。
• 提供 Harness Web 客户端内的侧边栏按钮 / 覆盖页面，以及无头 JSON CLI（dsh-taskboard）。
• 暴露一组进程内工具（taskboard_*），代理可在每轮中调用，实现任务的列出、认领、评论和提交审核。

核心功能

功能	你将获得
项目与任务层级	项目具有短键（如 DSH），生成可读 ID 如 DSH-42。任务具有状态（backlog → todo → in_progress → in_review → done）以及 blocked 和 canceled。
仅限人类操作	批准、接受、退回、归档、取消、强制接管、永久删除——仅通过 UI 或 CLI，代理工具无法执行。
代理工作流	代理可认领 todo 任务，在关联工作区中工作，然后提交审核。人类随后必须接受任务为 done。
自动化	可为每个项目定义自动化（间隔、模型预设、工作器数量、配额策略）。调度器将认领符合条件的 todo 项，并驱动代理会话至 in_review 状态。
CLI	dsh-taskboard 提供项目、任务、关系、附件、工作流和存储诊断的 JSON 输出命令。退出码区分成功、使用错误、存储问题、领域错误和乐观冲突（TASK_STALE_VERSION）。
配置	可通过 cordis.patch.yml、环境变量或配置文件覆盖，调整路径、分页限制、附件大小上限、工作器限制和刷新间隔。
安全与恢复	开启时进行 SQLite 完整性检查，提供明确的备份说明，以及详细的安全部署设计文档。

安装流程（Harness 操作员使用）

1. 检测正在运行的 Harness – 找到 Web 监听端口（默认 3080）及其工作目录。
2. 构建插件 – 克隆仓库，运行 pnpm install && pnpm build && pnpm pack。这将生成 lib/ 文件和一个 tarball shengsheng-dsh-taskboard-<version>.tgz。
3. 将插件添加到配置文件 – 使用 Harness CLI：dsh plugin --profile web add -w /path/to/tgz（-w 标志对 pnpm 工作区为必需）。
4. 验证组合配置 – dsh --profile web --dump-config 应显示 # == @shengsheng/dsh-taskboard 层。
5. 重启 Harness – 添加插件后，重启 Harness 进程以加载 UI 包。
6. 确认激活 – 对 Harness 根路径的 GET 请求必须包含 @shengsheng/dsh-taskboard，且客户端包可访问（200 响应）。侧边栏现在显示 Taskboard 按钮。

使用 UI

• 点击侧边栏页脚的 Taskboard 按钮。
• 创建项目（选择短键），然后创建任务。
• 人类用户将任务从 backlog → todo（批准）。代理认领 todo 项，工作并提交 in_review。人类最终接受任务为 done。
• UI 提供 Board、List、Gantt、Workflow 和 Dashboard 视图，均尊重当前 Harness 本地化设置。

使用 CLI

# 列出项目
 dsh-taskboard --database .dsh/taskboard.sqlite project list
# 创建项目
 dsh-taskboard --database .dsh/taskboard.sqlite project create --key DSH --name "My project"
# 创建任务
 dsh-taskboard --database .dsh/taskboard.sqlite task create \
    --project <project-id> --title "Ship the plugin"
# 认领任务（代理使用工具，人类可通过 CLI 执行）
 dsh-taskboard task claim --task <opaque-id> --expected_version 1

所有命令输出结构化 JSON，便于管道化到脚本中。

代理工具（在运行中的 Harness 代理中调用）

• taskboard_list – 列出特定项目的任务。
• taskboard_get – 获取任务完整详情。
• taskboard_claim – 使用乐观版本检查认领 todo 任务。
• taskboard_comment – 添加 Markdown 评论。
• taskboard_submit_review – 将拥有中的 in_progress 任务移至 in_review。
• taskboard_block, taskboard_release_claim, taskboard_relate – 其他生命周期控制。

为何重要

• 提供一个与 Harness 代理运行时紧密集成的 原生、离线优先 任务追踪系统，避免使用独立的项目管理工具。
• 强制明确分离：代理只能处理任务；人类保留最终接受权，这对安全的 AI 辅助开发至关重要。
• SQLite 后端设计使系统轻量且可移植，适用于 Harness 的本地或边缘部署。

许可证

• Apache-2.0（参见 LICENSE）。

---

以上所有细节均直接取自仓库的 README；未推断任何额外功能。