前言¶
在 DSH 裏做開發或日常協作時，任務往往分散在聊天、筆記和外部待辦工具之間；Agent 能幫你寫代碼，卻未必能穩定讀寫同一份「今天要做什麼」的清單。若把跟蹤面板做成獨立 SaaS，又引入賬號、同步和隱私成本。下面介紹維護者 vogtersea 發佈的客戶端插件 dsh-worklog：在 Harness 側邊欄掛載「工作志」，數據落在本機單個 SQLite 文件，並向 Agent 註冊五個讀寫工具，使人與 AI 共用同一套工作項。
這是什麼¶
dsh-worklog 是 DeepSeek Harness 的客戶端類插件（社區目錄：vogtersea/dsh-worklog）。定位是「在 DSH 裏直接可用的個人工作跟蹤面板」：自帶全部功能，不依賴外部服務，也無需另裝數據庫。源碼託管於 GitHub，許可證 MIT；package.json 中當前版本爲 0.2.0，要求 DSH 引擎 >=0.2.1-rc.3。
核心功能¶
面板視圖¶
插件提供多視圖管理同一批工作項（README 中的能力表）：
| 視圖 | 說明 |
|---|---|
| 儀表盤 | 逾期 / 今日到期 / 臨期 / 本週 / 無截止日期 五個分桶 |
| 周視圖 | 一週七天各列一處，按截止日期落位，今天高亮 |
| 工作詳情 | 標題、詳情、完成條件、優先級、項目、標籤；可追加進展記錄 |
| 例行 | 每週/每月模板，按週期自動生成本期任務，同一週期不重複生成 |
| 項目 | 把工作歸到項目下 |
| 歸檔 | 已完成的全部留存 |
界面採用服務端渲染 + 同源 iframe 嵌入插件路由，無獨立前端構建步驟；支持深色模式（實現見 lib/views.js）。
Agent 工具¶
插件向 Agent 註冊 5 個工具，AI 與面板讀寫同一份 SQLite 數據：
| 工具 | 用途 |
|---|---|
worklog_list |
按周、狀態、關鍵詞列出工作項 |
worklog_add |
新建一條工作 |
worklog_done |
標記完成 |
worklog_progress |
追加進展記錄 |
worklog_summary |
概覽各分桶數量 |
README 說明：報告類彙總不調用外部模型，由 DSH 的 Agent 通過上述工具完成。
數據存放¶
數據路徑（尊重 DSH_HOME，多 profile 互不干擾）：
~/.dsh/worklog/worklog.db
單個 SQLite 文件，WAL 模式；備份即複製該文件。存儲層使用 Node 自帶的 node:sqlite（lib/store.js），無原生編譯依賴。
安裝與啓用¶
在目標 profile 下執行官方 README 中的安裝命令：
dsh plugin --profile <profile> add dsh-worklog
若在本倉庫目錄內做本地鏈接安裝：
dsh plugin --profile <profile> add link:.
安裝完成後，側邊欄會出現「工作志」一行。插件通過 cordis.patch.yml 將條目寫入 profile 的插件表；客戶端注入 @deepseek-ai/dsh-client-ui-slots，平臺爲 web。
典型用法¶
- 人工維護：在側邊欄打開工作志，在儀表盤或周視圖查看分桶與截止日，進入詳情編輯優先級、項目、標籤並追加進展。
- 例行任務：配置每週/每月模板，由插件按週期生成本期任務（同一週期不重複生成）。
- Agent 協作：在對話中讓 Agent 調用
worklog_list/worklog_add/worklog_progress等工具，與你在面板上的操作保持一致。
維護者在倉庫中提供了本地調試與驗收入口（開發時可選）：
node test/dev-server.mjs # http://127.0.0.1:8091/worklog-plugin/app
node test/integration.mjs
node test/acceptance.mjs
適用場景與注意¶
適合：已在 DSH 中常駐工作的個人開發者，希望任務清單、進展與 Agent 工具鏈在同一進程生態內閉環，且接受本地單文件存儲與自行備份。
設計取捨（README 原文）：單用戶場景，無多用戶與登錄；未實現 Word 導出、Obsidian 集成與外部推送；本質不依賴外部系統。
安全與信任：插件以當前 DSH 進程權限運行，可讀寫 ~/.dsh/worklog/worklog.db 並在 UI 中展示數據。安裝前請閱讀 源碼與 LICENSE，確認符合你的環境與合規要求。SkillHub 等社區目錄爲獨立站點，與 DeepSeek / 幻方無官方從屬關係；Harness 生態遵循「一切皆插件」，本插件是其中一項客戶端擴展。
結尾¶
dsh-worklog 把個人工作跟蹤收進 DSH 側邊欄，用本地 SQLite 與五個 Agent 工具對齊人機視圖。進一步瞭解可訪問目錄頁 skillhub.cn/plugins/vogtersea/dsh-worklog 與倉庫 github.com/vogtersea/dsh-worklog。
