前言¶
在使用 DSH（DeepSeek Harness）進行開發時，AI 負責生成內容，人工負責管理。這些產出（方案、分析、規格等）容易散落在工作區中，幾天後很難找到。dsh-asset-library 插件提供了一層資產管理體系，用於發現、整理、管理和複用這些 AI 產物。它不作爲一個獨立軟件存在，而是像 Finder 之於 macOS，集成在 DSH 的體驗中。
核心功能¶
四軸歸納與本地存儲¶
插件將 AI 產出歸類爲本地 Markdown 文件。它支持按四個維度歸納資產：時間、文件類型、會話和項目。默認存儲路徑爲 <DSH_HOME>/asset-library/。
資產發現與評分¶
插件會掃描工作區，識別 AI 產出文件（而非依賴、源代碼或腳手架文件），並根據以下標準打分（0-100）：
- Markdown 結構（標題層級、段落）：+20
- 標題完整性：+10
- 目錄存在（≥3 個小標題）：+10
- AI 語言特徵（如“以下是”、“綜上”、“方案”）：+20
- 來自工作區頂層：+30
新鮮度（生成後時間）僅用於排序，不進入推薦分。硬性排除項包括 node_modules、.git、dist、package.json、LICENSE、憑據、圖片、壓縮包和源代碼。
狀態管理與側欄交互¶
資產狀態流轉爲：草稿 -> 已確認 -> 已歸檔。
* 草稿：自動掃描進來的條目。
* 已確認：用戶主動保存的條目。
* 已歸檔：詳情頁中手動切換的條目。
側欄（右側 25%）每 15 秒掃描一次。檢測到新資產時，側欄會自動展開，允許保存或忽略，而不打斷對話。
安裝與啓用¶
使用以下命令安裝插件：
dsh plugin --profile web add /path/to/dsh-asset-library
安裝後，側欄會出現“素材庫”入口。也可以訪問 <dsh web 地址>/ext/asset-library/ 打開獨立的管理頁。
典型用法¶
斜槓命令¶
在會話輸入框中直接使用，不進入模型請求：
/save：保存上一條助手回覆。/save <標題>：保存並指定標題。/save note <正文>：直接保存筆記。/save list [關鍵詞]：列出素材並過濾。
模型工具¶
插件提供工具供模型調用：
asset_save_file：保存文件（文本內聯正文；二進制/超大文件僅登記路徑）。asset_save_snippet：保存文本片段。asset_list：列出資產（支持按軸、項目、關鍵詞過濾）。asset_overview：總覽視圖。asset_read：讀取資產全文。
HTTP API¶
提供標準 HTTP 接口：
GET /ext/assets/list：列表查詢（支持分頁）。POST /ext/assets/register：登記資產。GET /ext/assets/<id>：元數據。GET /ext/assets/<id>/content：元數據 + 全文。GET /ext/assets/<id>/file：下載文件。PATCH /ext/assets/<id>：更新資產。DELETE /ext/assets/<id>：刪除資產。
注意：出於安全考慮，所有寫操作以及讀取正文僅限本地迴環來源。
Markdown 閱讀器¶
資產詳情頁直接渲染 Markdown 內容（標題、列表、代碼塊等），支持長文檔自動目錄。標題 ≥4 個時自動生成目錄。
配置¶
通過 cordis.patch.yml 覆蓋配置項：
- id: asset-library
config:
rootDir: /your/library # 默認 <DSH_HOME>/asset-library
autoCollect: true # 默認 true
maxPerTurn: 20 # 單輪自動採集上限
mutationTools: [write, edit] # 視爲文件變更的工具名
maxInlineBytes: 262144 # 正文內聯上限（字節）
技術細節與限制¶
依賴管理¶
該插件的 dependencies 爲空。這是爲了避免與宿主 DSH 版本衝突，防止 pnpm 裝入不匹配的副本導致啓動失敗。
實現方式¶
- 側邊欄：通過 DOM 注入實現（DSH 暫未開放共享模塊槽位）。
- 管理頁：獨立頁面，非原生面板。
- 文件監聽：無文件系統監聽。外部改動需手動刷新或重啓。
結語¶
dsh-asset-library 將 AI 產出沉澱爲可檢索、可管理的資產。通過四軸歸納和本地存儲，它解決了內容散落的問題。安裝後即可在 DSH 側邊欄或管理頁使用。
