前言¶
DeepSeek Harness (DSH) 採用插件化架構，爲智能體提供長期記憶是其中的關鍵環節。ZCode 提供了基於提取子代理和 markdown 記憶室的記憶模型，但 dsh-zcode-scribe 在此基礎上做了進一步的安全加固。它不僅繼承了記憶管理的架構理念，還引入了嚴格的路徑安全規則，防止遍歷攻擊、Unicode 僞造和 NTFS 備用數據流。
插件定位¶
- 名稱:
dsh-zcode-scribe - 作者: BOWLUNA
- 分類: 記憶
- 開源協議: MIT
- 核心價值: 爲 DSH 提供一個只讀的記憶房間、
scribe_recall工具，以及一套拒絕目錄遍歷、Unicode 欺騙和 NTFS 備用數據流注入的路徑安全規則。
核心功能¶
- 只讀記憶室: 基於 markdown 的持久化存儲，索引不會靜默截斷。
- scribe_recall 工具: 已註冊的工具，在宿主程序中真實執行，用於從記憶室檢索信息。
- 路徑安全規則: 包含 52 個測試用例，對路徑進行嚴格校驗，拒絕目錄遍歷、Unicode 欺騙以及 NTFS 備用數據流攻擊。
安裝與前置依賴¶
在安裝之前，請確保已安裝必要的前置依賴：
@deepseek-ai/dsh-tools(版本範圍>=0.1.5-rc.2 <0.2.0 || >=0.1.6-alpha.1 <0.2.0)@deepseek-ai/schemastery(版本^3.18.2)
安裝命令如下：
dsh plugin --profile web add dsh-zcode-scribe
典型用法¶
插件包含測試套件和啓動檢查工具，可用於驗證安裝和功能狀態：
node test/run.mjs
node tools/boot-check.mjs --port 32050
適用場景與注意¶
- 當前狀態: 插件處於早期階段，目前爲只讀模式。
- 已實現:
scribe_recall工具已可用，且在真實會話中經過驗證。 - 未實現: 寫入、提取和窄化寫入器功能尚未開放，受里程碑 M0 的限制。
- 功能影響: 當前安裝僅改變模型能請求什麼（通過註冊工具），尚未改變模型知道什麼（尚未注入提示詞）。
- 架構繼承: 記憶模型源自 ZCode，包括提取子代理和清單，但不需要依賴 ZCode 的完整安裝。
結語¶
dsh-zcode-scribe 爲 DeepSeek Harness 提供了一個安全、可擴展的長期記憶基礎。它通過嚴格的路徑安全檢查和只讀模式，降低了記憶注入和路徑遍歷的風險。隨着里程碑 M0 的達成，後續將開放寫入和提取能力。
