前言¶
DeepSeek Harness(DSH)以插件化架构支持了丰富的交互与逻辑扩展,但默认的会话机制并不具备长期、跨会话的任务持久化能力。在长时间的研发或复杂任务流中,模型容易遗忘上下文,任务状态也难以在团队间同步。meow-dsh-task 是一个双面插件包,它通过为模型侧提供 15 个工具、为人类侧提供命令与 Web 界面,将任务管理能力补全到 DSH 生态中。
这是什么¶
meow-dsh-task 是由 meimiaoji-creator 维护的一个 DSH 插件,核心价值在于提供跨会话、离线、git 共享的任务追踪与管理系统。它将任务数据落盘为 JSON 真相层,并自动渲染为团队可读的 Markdown 文档,通过 git 进行版本控制。
安装与启用¶
插件仅支持 web profile。安装完成后需重启 DSH 以加载插件。
dsh 插件 --profile web add meow-dsh-task
若需调试本地代码,可使用以下命令:
dsh 插件 --profile web add link:./
安装成功后,DSH 会话界面的输入框右侧会出现 任务 按钮,点击即可打开任务面板。
核心功能¶
1. 双面交互设计¶
插件分为模型侧与人类侧,分别提供不同的操作接口。
模型侧(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:写交接清单。
* meow_dsh_task_plan_create / plan_list / plan_switch / plan_close:研发计划管理。
人类侧(命令组)
通过 /meow-dsh-task 命令组进行操作,支持子命令:
* /meow-dsh-task list
* /meow-dsh-task claim
* /meow-dsh-task status
* /meow-dsh-task checkpoint
* 以及 init、todo、review、issue、handoff 等子命令。
Web 侧(UI 与 API)
* 任务管理页:访问 /meow-task 可查看任务清单,支持通过 ?workspace= 参数切换工作区。页面包含任务清单与高级配置 tab。
* JSON API:提供 /api/meow-task/* 接口,支持程序化读写。
* 注入:任务按钮被注入至 conversation.input.right,任务面板覆盖 conversation.view。
2. 系统提示词注入(5 个协议)¶
插件向 ctx.systemPrompt.section 注入了 5 个协议,按 order 110–114 排序:
* meow-dsh-task:bootstrap (110):任务文件不存在时,引导模型先初始化。
* meow-dsh-task:startup (111):开工或接盘前,引导模型读取记忆恢复上下文。
* meow-dsh-task:exec (112):执行期纪律,规范认领、检查点记录及文件操作。
* meow-dsh-task:complete (113):阶段性完成或关键决策时记录检查点。
* meow-dsh-task:review (114):评审流程与 issue 回流处理。
3. 多工作区与 Git 共享¶
插件支持多工作区并行。taskRoot 解析优先级为:插件配置显式指定 > 环境变量 MEOW_DSH_TASK_ROOT > 当前会话工作区 > process.cwd()。
* 真相层:存储在 <taskRoot>/.dsh-task/plans/<planId>/,格式为 JSON/JSONL。
* 渲染产物:自动渲染为 <taskRoot>/docs/tasks/ 的 Markdown 文件。
* 冲突控制:正文未变更时跳过写操作,减少 git 合并冲突面。
权限与运行时行为¶
插件在运行时会执行以下操作,但在设计上做了严格限制:
会做
* 写文件:仅限三处(真相层 .dsh-task/、渲染产物 docs/tasks/、配置文件 $DSH_HOME/meow-dsh-task/workspace-config.json)。
* 注册:注册 15 个工具、1 个命令组、3 个 Web 路由(/meow-task、/meow-task/static、/api/meow-task)。
* 注入:注入 5 个系统提示词协议及 client 槽位。
不会做
* 不读聊天记录、会话历史或其他插件配置。
* 不调用任何外部 API,完全离线运行。
* 不修改 DSH 源码,纯 Cordis 注入实现。
兼容性¶
- DSH Profile:仅支持
webprofile。 - 运行平台:Node 18+,ESM only。
- DSH Runtime:依赖
@deepseek-ai/cordis ^0.1.0。
不兼容场景包括:TUI / CLI profile(因依赖 webServer 和 client UI 槽位)以及旧版 cordis API。
总结¶
meow-dsh-task 通过将任务数据结构化并持久化,解决了 DSH 在长期任务流转中的状态丢失问题。它既为模型提供了严谨的工具链,也为人类提供了可视化的管理界面,同时通过 git 共享机制降低了团队协作成本。如需了解更多细节,可参考其 GitHub 仓库。