前言¶
在 DeepSeek Harness (DSH) 工作區開發時，智能體會話之間通常缺乏上下文共享。每次新會話開局，智能體都需要重新瞭解項目背景；會話結束時，進展記錄往往散落在對話歷史中，難以追溯。dsh-project-progress 插件解決的是這個痛點，它爲工作區提供一個共享的 PROGRESS.md 文檔，用於維護項目檔案和進展時間線。
這是什麼¶
這是一個 DeepSeek Harness (DSH) 插件，用於爲 DSH 工作區創建共享項目進展文檔。它實現了跨會話的進度感知與發佈狀態檔案管理，由 Jolly-J 維護。
核心功能¶
插件在工作區根目錄維護一份 PROGRESS.md，文檔分爲兩個區：
- 項目檔案：維護穩定事實，如發佈狀態、GitHub 倉庫地址、安裝命令等。
- 進展時間線：只追加的條目，記錄輪次、步驟、token 用量等。
通過系統提示詞注入實現跨會話進度感知，智能體一開局就能讀到項目狀態。插件提供三個模型工具：
project_status：讀取當前工作區的共享文檔。project_update：向時間線追加一條進展。project_facts：整體替換「項目檔案」區。
安裝與啓用¶
執行以下命令安裝：
dsh plugin --profile web add https://github.com/Jolly-J/dsh-project-progress.git
安裝完成後重啓 dsh web 即可。
數據與隱私¶
- 本地讀寫：所有讀寫發生在本地工作區，只創建/更新工作區根目錄的
PROGRESS.md，可隨時手動編輯或刪除。 - 無網絡調用：不上傳任何內容，不讀取密鑰。
- 會話限制：僅對頂層會話自動追加進展，子代理會話不寫入。
- 寫入規則：自動條目是結構化的（標題、輪次、token 用量），時間線只追加，舊條目不重寫。
- 語言：文案目前是中文。
典型用法¶
- 執行
dsh plugin --profile web add https://github.com/Jolly-J/dsh-project-progress.git進行安裝。 - 使用
project_update手動追加進展記錄。 - 使用
project_facts更新項目檔案信息。 - 在工作區根目錄手動編輯
PROGRESS.md。
適用場景與注意¶
該插件適合需要在多會話中保持項目上下文的開發者。由於插件以當前 dsh 進程權限運行，安裝前建議檢查源碼與許可證。
短結尾¶
經過上面的步驟，你可以在 DSH 工作區中擁有一個結構化的項目進展文檔。它通過本地文件和工具實現了隱私保護下的跨會話狀態管理，是開發流程中的實用輔助。
