前言¶

DeepSeek Harness (DSH) 生態通過插件機制擴展能力。在長期運行或跨會話處理多個任務時，coding agent 往往難以維持對項目狀態的一致性記憶。dsh-project-portfolio 是一個非官方插件，它通過將項目信息封裝在嵌入的技能和工具中，讓 agent 在用戶的配置目錄下維護一份基於 Markdown 的項目清單與歷史記錄。

核心功能¶

該插件提供以下核心能力：

1. 嵌入式技能：包含 project-portfolio 技能，內置了通用、GitHub PR/Issue、求職和副業四種項目模板。該技能作爲資源包隨插件安裝。
2. 只讀清單工具 (portfolio_status)：用於查看完整的 watchlist 以及每個項目文件的目錄索引（包含標題、狀態、目標、下一步操作、最後檢查時間）。
3. 歷史記錄工具 (portfolio_log)：用於向特定項目文件追加帶日期的歷史記錄行（自動創建 History 章節）。該工具對文件路徑進行 slug 校驗，確保只能操作配置目錄內的文件。
4. 增量同步：基於 Watchlist 機制，實現增量更新。

安裝與啓用¶

通過官方插件命令安裝，該插件會自動註冊技能和工具。

dsh plugin add dsh-project-portfolio --profile web

安裝後，插件會通過 dsh.bundle.patch 機制自動掛載，並將技能模板和工具註冊到當前會話中。

典型用法¶

1. 觸發自動加載：在對話中詢問項目狀態，例如“where do my projects stand?”，agent 會自動加載相關技能。
2. 查看項目清單：調用 portfolio_status 工具，獲取當前所有監控項目和文件的頭信息。
3. 追加歷史記錄：調用 portfolio_log 工具，爲指定項目添加一條帶時間戳的記錄。

注意事項¶

• 該插件依賴 DSH 的 tools 服務才能正常工作。
• 數據完全存儲在本地配置的 portfolioDir 中，不包含任何網絡請求或遙測數據。
• 文件路徑經過校驗，防止目錄遍歷攻擊。
• 作爲社區插件，不與 DeepSeek 官方存在關聯。

總結¶

dsh-project-portfolio 解決了 coding agent 在多項目場景下的記憶斷層問題。它將項目管理從對話中剝離，沉澱爲用戶可控的本地 Markdown 文件，通過工具接口供 agent 調用，適合需要長期維護項目進度或跨月追蹤任務的場景。

GitHub 倉庫 | 社區目錄