前言¶
在 DeepSeek Harness (DSH) 的開發流程中,會話的無狀態特性有時會帶來上下文管理的難題。如果需要在不同的對話會話之間保持任務狀態的連續性,現有的基礎能力往往無法直接滿足。dsh-tasklist 插件正是爲了解決這一問題而存在,它提供了一種持久化的任務列表記憶機制。
插件介紹¶
dsh-tasklist 是一個用於 DeepSeek Harness 的跨會話任務列表記憶插件,由開發者 lsLs-kid 維護。它通過提供任務創建、更新、轉換和歸檔的能力,幫助開發者在對話上下文之外建立獨立的工作流狀態。
核心功能¶
該插件主要提供以下能力:
-
任務生命週期管理
使用tasklist_update工具,可以執行創建、更新、轉換和歸檔任務的操作。 -
任務查詢
使用tasklist_query工具,可以在需要時讀取並過濾任務列表。 -
可視化面板
插件提供浮動 Web 小部件,面板會實時輪詢並顯示所有活躍任務,以及當前會話中各個代理正在處理的具體任務。
安裝與啓用¶
插件需要安裝到特定的配置文件中。請確保當前環境滿足依賴要求,然後執行以下命令:
dsh plugin --profile web add dsh-tasklist
依賴與運行要求¶
該插件對運行環境有硬性依賴,必須運行在支持 Web 服務器的環境中:
- 依賴注入:插件聲明瞭
@deepseek-ai/dsh-host-webserver作爲硬注入的 peer dependency(版本^0.1.1-rc.2)。 - 運行限制:由於依賴 Web 服務,插件無法在 headless 或 CLI 類型的 profile 中啓動。
使用說明¶
安裝後,可以通過調用相應的工具函數來管理任務:
- 更新任務:調用
tasklist_update來創建新任務、更新現有任務、改變任務狀態或歸檔任務。 - 查詢任務:調用
tasklist_query來按需讀取過濾後的任務。
插件在 Web 環境下會掛載文件:
* /dsh-tasklist/widget.js
* /dsh-tasklist/recommended.json
* /dsh-tasklist/state.json(顯示活躍任務及代理分配)
發佈與構建¶
插件發佈到 npm registry,安裝時會攜帶完整性校驗元數據。構建過程使用 pnpm,並在發佈前自動運行 prepack 腳本進行構建。
適用場景與注意事項¶
該插件適用於需要持久化任務狀態且運行在 Web 服務器環境下的 DSH 場景。
在安裝前,請務必:
1. 檢查插件的源代碼以確保安全性。
2. 覈對許可證信息(當前插件信息中缺少明確的許可證說明)。
結語¶
dsh-tasklist 爲 DSH 生態提供了一個輕量級的任務管理方案。如需查看源代碼或提交反饋,可訪問其 GitHub 倉庫:https://github.com/lsLs-kid/dsh-tasklist。