DSH Knowledge Forge：本地優先的自動 Wiki 與技能記憶插件

前言¶

DeepSeek Harness (DSH) 是一個插件優先的 Agent Harness。在 Agent 會話中，包含大量有價值的工程記憶：嘗試了什麼、用戶如何糾正、哪些證據重要、哪些決策生效，以及任務卡在哪裏。原始對話記錄過於龐大且充滿噪音，不適合直接放入長期上下文；而單次總結又難以審計。

DSH Knowledge Forge 是一個原生 DeepSeek Harness 插件，它在不依賴外部記憶服務的情況下，爲 DSH 添加自動本地知識蒸餾能力。它將 Agent 對話軌跡轉化爲漸進式可重用的知識，將操作證據與可重用知識分離。

核心功能¶

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

本地優先捕獲：在將內容持久化到項目本地 SQLite 之前，會對包含憑證內容的文本進行脫敏，並限制頂層輪次的長度。
會話感知批處理：滿足 5 個待處理頂層輪次或等待 60 分鐘的條件後，獨立處理一個源 Session。
一次性蒸餾：使用一個非交互式、無工具、輸出結構嚴格的後臺 Agent 進行知識提煉。
Wiki → 技能演進：將第一個有價值的任務案例存儲爲可讀的 Wiki 頁面；當獨立案例重複執行同一穩定工作流時，將其提升爲原生 DSH Skill。
漸進式披露：在 Agent 上下文中注入緊湊的 Wiki 索引，僅在需要時加載完整的 Wiki 頁面或 Skill。
白盒可觀測性：保留可讀的 Markdown 工件、批處理收據、重試狀態，並提供 DSH Web Dashboard。

工作原理¶

Knowledge Forge 維護一個本地知識循環：

捕獲已完成頂層輪次：插件監聽 DSH 的頂層輪次生命週期，提取用戶可見消息、助手輸出、精簡後的工具證據及相關路徑。推理軌跡和完整工具輸出不會被複制。
獨立調度 Session：當一個 Session 擁有 5 個待處理輪次，或其最舊的待處理輪次等待了 60 分鐘時，該 Session 被視爲“到期”。不同 Session 的輪次不會合並。
運行一次性後臺策展人：Knowledge Forge 啓動一個受限的 DSH 子 Agent：僅一次非交互式響應、無工具、嚴格 JSON 輸出模式、覆蓋所有輸入事件。所有候選和知識文本被視爲不可信數據。
蒸餾與演進：策略是漸進式的。首先丟棄查找類、閒聊及未變化的 Skill 複用。如果現有 Skill 覆蓋任務，則複用。對於持久化的任務案例，寫入或更新 Wiki（包含目標、反饋、證據、決策、結果等）。只有當新獨立案例重複相同穩定工作流時，纔將其提升爲 Skill，此時 Wiki 主體替換爲指向 Skill 的輕量級元數據。

安裝與啓用¶

前置要求：
- Node.js ^22.19.0 || >=24.0.0
- DeepSeek Harness 0.1.0-rc.6

安裝步驟：

克隆倉庫並安裝依賴：

    git clone https://github.com/bill084153-cell/dsh-knowledge-forge.git
    cd dsh-knowledge-forge
    npm install

構建並打包插件：

    npm run build
    npm pack

這將生成一個 `.tgz` 壓縮包。

安裝到 DSH Web 配置文件：

    dsh plugin --profile web add ./dsh-knowledge-forge-0.1.0.tgz

啓動 DSH 並驗證：

    dsh web

安裝完成後，可以通過以下命令驗證：

    dsh plugin --profile web exec dsh-knowledge-forge doctor --workspace .

醫生檢查應輸出工作區路徑、本地數據庫路徑、隊列計數、Wiki 計數、Skill 計數以及狀態。

存儲與保留¶

插件將數據寫入當前項目目錄，不依賴外部服務：

<project>/.dsh/
├── knowledge-forge/
│   ├── knowledge-forge.sqlite     # 隊列狀態、批次、收據、重試、全文索引
│   └── wiki/
│       ├── index.md               # 注入到 Agent 上下文的緊湊召回映射
│       └── pages/
│           └── <wiki-id>.md       # 持久化的任務案例或 Skill 元數據
└── skills/
    └── <skill-id>/
        └── SKILL.md               # 原生 DSH Skill

SQLite 用於維護運行時狀態（隊列、調度、重試），Markdown 文件（Wiki 頁面和 SKILL.md）作爲長期可讀、可編輯的工件。

適用場景與注意事項¶

適用場景：
- 需要在本地管理 Agent 開發記憶，不希望數據上傳至雲端記憶服務的場景。
- 希望從對話記錄中沉澱結構化 Wiki 和可複用 Skill 的場景。

注意事項：
- 插件以當前 DSH 進程的權限運行，安裝前應檢查源碼與許可證。
- 直接從 GitHub 安裝 TypeScript DSH 插件需要構建時間。建議先打包 tarball，這能保持安裝過程的明確性，並避免在用戶 DSH 配置文件中運行倉庫構建腳本。
- DSH 理念是「一切皆插件」，社區目錄是獨立站點，與 DeepSeek 或幻方無官方從屬關係。

結語¶

經過上述步驟，DSH Knowledge Forge 已經接入 Harness。它通過 SQLite 和 Markdown 的組合，實現了本地化的知識沉澱與演進。Agent 可以從對話中提取 Wiki，進而轉化爲 Skill，從而在未來的會話中複用這些知識，減少重複勞動，提升開發效率。

插件目錄：https://www.skillhub.cn/plugins/bill084153-cell/dsh-knowledge-forge
項目倉庫：https://github.com/bill084153-cell/dsh-knowledge-forge