meimiaoji-creator/meow-dsh-task

meow-dsh-task

面向 DeepSeek Harness（DSH）的 dsh-plugin：跨会话、离线、git 共享的任务追踪 + 任务管理 UI（双面插件包）。

Listed on dsh-plugin.org

meow-dsh-task 给 DSH 会话补上“团队任务追踪”这一层：任务、研发计划、检查点、评审、issue、交接清单全部落盘为 JSON 真相层（.dsh-task/），并自动渲染成团队可读的 markdown（docs/tasks/）随仓库共享。模型侧通过 15 个 meow_dsh_task_ 工具读写；人类侧通过 /meow-dsh-task 命令组与内置的任务管理页（/meow-task）查看。与 dsh 原生任务体系（todo_write / plan / goal）并行共存，独立存储独立前缀，零 dsh 源码改动（纯 Cordis 注入）。

界面展示

安装

通过 dsh 官方插件管理器安装（profile = web，npm 源）：

dsh 插件 --profile web add meow-dsh-task

如果想直接装 GitHub 仓库的 main 分支：

dsh 插件 --profile web add github:meimiaoji-creator/meow-dsh-task

本地调试（仓库目录内）：

dsh 插件 --profile web add link:./

安装完成后，重启 dsh：输入框右端出现 任务 按钮，点击即打开任务面板（内嵌 /meow-task 页，含任务清单与「高级配置」tab，可按工作区设置 taskRoot 覆盖）。

功能

15 个 meow_dsh_task_ 工具（模型侧）

任务生命周期全覆盖，全部从当前会话工作区自动解析存储实例：

| 工具 | 用途 |
|---|---|
| meow_dsh_task_init | 初始化任务清单（新任务/新阶段起点） |
| meow_dsh_task_list | 列出当前计划的任务（“暂无任务”触发引导协议） |
| meow_dsh_task_claim | 认领任务（仅“待开始”且未被认领，带并发保护） |
| meow_dsh_task_status_update | 更新任务状态 |
| meow_dsh_task_checkpoint_append | 追加检查点日志（断点续跑依据） |
| meow_dsh_task_todo_update | 维护任务内子待办 |
| meow_dsh_task_review_start / review_close | 开启/关闭评审里程碑 |
| meow_dsh_task_issue_report / issue_resolve | 上报/解决评审 issue |
| meow_dsh_task_handoff_write | 写交接清单（5 字段，供接盘者恢复上下文） |
| meow_dsh_task_plan_create / plan_list / plan_switch / plan_close | 研发计划管理（任务按计划分组，.dsh-task/plans//） |

/meow-dsh-task 命令组（人类侧）

/meow-dsh-task  ...

不加子命令或传 help 显示用法。

任务管理页 + JSON API（web 侧）

- /meow-task：任务管理页（按 ?workspace= 参数切换工作区；含任务清单与「高级配置」tab，配置按工作区保存）
- /api/meow-task/：JSON API（读请求携带的 workspace 参数，或默认工作区）
- 输入框右端 任务 按钮打开任务面板（覆盖会话视图），纯 React + 内联样式，无第三方 UI 依赖

meow-dsh-task 任务管理页

截图占位：在本地 dsh（web profile）跑起来后，打开 /meow-task 页截一张真实图覆盖 docs/screenshots/task-page.png 即可。

系统提示词注入

五协议按 order 110–114 注入（ctx.systemPrompt.section）：

| 协议 | order | 触发时机 |
|---|---|---|
| meow-dsh-task:bootstrap | 110 | .dsh-task/ 无任务文件时教模型先初始化 |
| meow-dsh-task:startup | 111 | 开工/接盘前先读记忆恢复上下文 |
| meow-dsh-task:exec | 112 | 执行期纪律（认领、检查点、不直接改文件） |
| meow-dsh-task:complete | 113 | 阶段性完成/关键决策时记检查点 |
| meow-dsh-task:review | 114 | 评审与 issue 回流 |

多工作区 + git 共享

- taskRoot 解析链：插件配置显式指定 > 环境变量 MEOW_DSH_TASK_ROOT > 当前会话工作区（session.header.cwd）> process.cwd()；每个工作区各自缓存存储实例
- 真相层 /.dsh-task/plans//（JSON/JSONL）自动渲染为 /docs/tasks/ markdown，正文没变就跳过写，缩小团队合并冲突面

工具输出示例

meow_dsh_task_claim

已认领 T-07《标准化 README》→ engineer（runId a1b2c3…）
下一步：先读 docs/02 现状，再动手改。

meow_dsh_task_checkpoint_append

检查点已追加（T-07 #2）：五协议接线完成，渲染 notifier 组合挂到 storage.onCreate。

meow_dsh_task_handoff_write

交接清单已写入：目标/已完/半成品/卡点/下一步 5 字段齐全，接盘者可凭 runId 续聊原实现者。

权限与运行时行为

会做

- 写文件（仅限三处）：
- /.dsh-task/ —— 任务真相层（JSON/JSONL，模型不直接编辑，全部走工具）
- /docs/tasks/ —— 渲染产物（团队可读 markdown，纳入 git）
- $DSH_HOME/meow-dsh-task/workspace-config.json（无 DSH_HOME 时 ~/.dsh/）—— 高级配置（taskRoot 覆盖等）
- 注册工具：15 个 meow_dsh_task_（ctx.tools.register）
- 注册命令：/meow-dsh-task（ctx.commands.register）
- 注入系统提示词：5 个 section，order 110–114（ctx.systemPrompt.section）
- 注册 Web 路由：/meow-task、/meow-task/static、/api/meow-task（ctx.webServer.register）
- 注入 client 槽位：conversation.input.right（任务按钮）、shell.overlay、conversation.view（任务面板）

不会做

- ❌ 不读聊天记录 / 会话历史 / 其他插件配置
- ❌ 不调用任何 DSH 之外的第三方 API，完全离线（无 telemetry、不向外发请求）
- ❌ 不修改 DSH 源码（零源码改动，纯 Cordis apply(ctx) 注入）
- ❌ 不持久化任何用户隐私（落盘内容只有任务/计划/检查点等协作元数据）

兼容性

| 项目 | 要求 |
|---|---|
| DSH profile | 仅 web（强依赖 webServer 服务） |
| DSH runtime | @deepseek-ai/cordis ^0.1.0 |
| 运行平台 | Node 18+，ESM only |

已知不兼容

- ❌ TUI / CLI profile（client 槽位与 web 路由均不可用）
- ❌ 旧版 cordis API（inject/apply 形态）

依赖与 peer

- peerDependencies：@deepseek-ai/cordis ^0.1.0
- client.inject：@deepseek-ai/dsh-client-runtime、@deepseek-ai/dsh-client-ui-conversation、@deepseek-ai/dsh-client-ui-layout
- 运行时零第三方依赖（仅 Node 内置模块：node:os、node:path、node:fs）

开发

本仓库以编译产物形态维护：lib/（ESM）+ cordis.patch.yml（bundle 组合层，只插入一行 meow-dsh-task）就是运行与发布的全部内容，插件行为以 lib/ 为准。

- 本地调试安装：dsh 插件 --profile web add link:./
- 配置示例（cordis.patch.yml 中取消注释即可）：taskRoot 显式指定、repoMap 多仓库前缀映射

License

MIT © meimiaoji-creator