前言¶
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 倉庫。