前言¶

DeepSeek Harness (DSH) 作爲一個開發者預覽工具，通過插件化架構提供靈活性。在智能體開發中，區分“記憶機制是否真正生效”與“模型泛化能力的提升”往往很困難。dsh-memoryos 旨在解決這一問題，通過證據優先的策略，爲項目提供長期記憶，並提供嚴格的基線對比能力。

這是什麼¶

這是一個爲 DeepSeek Harness (DSH) 提供證據優先長期項目記憶的插件，底層由 MemoryOS 驅動。它是一個純 JavaScript Bundle，由 tianhao8687 維護，旨在在 DSH 進程中增加作用域內的項目記憶工具和精確的 Provider 使用記錄，而不改變 MemoryOS 的持久化、檢索、真值解析或上下文編譯邏輯。

核心功能¶

• 證據優先的長期項目記憶：專注於圍繞記憶主張的可控真實智能體證據。
• 作用域項目記憶工具：提供針對特定項目的記憶訪問。
• 精確的 Provider 使用收集：精確記錄輸入/輸出/緩存使用，與估計的 MemoryOS 組件歸因分離。
• 嚴格的 no_memory 基線：在 no_memory 條件下，整個組件（包括控制工具）完全缺失，僅保留使用收集器。
• 控制工具：允許在聊天中開啓或關閉 MemoryOS，狀態持久化。
• 上下文模式：支持緊湊、漸進、解釋和增量上下文模式。
• 顯式寫入配置文件：支持 supersede、keep_both、reject 等策略。
• 默認只讀：默認情況下爲只讀；寫入和受控上下文驅逐需要顯式 opt-in。

安裝與啓用¶

該 Bundle 是 DSH 適配器，不是數據庫。必須先啓動本地 MemoryOS 服務。

1. 啓動 MemoryOS 服務
   在 MemoryOS 源代碼目錄中運行：

    python -m memoryos --data-dir ./data serve --port 8000 --no-open

2. 安裝 DSH Bundle
   使用發佈標籤以獲得可重現性：

    dsh plugin --profile memoryos add github:tianhao8687/dsh-memoryos#v0.2.0
    dsh --profile memoryos --dump-config

3. 配置環境變量
   啓動 DSH 時設置相關變量（以 PowerShell 爲例）：

    $env:MEMORYOS_BASE_URL = 'http://127.0.0.1:8000'
    $env:MEMORYOS_AUTH_TOKEN = '<local-memoryos-token>'
    $env:MEMORYOS_CONDITION = 'msc_context_only'
    $env:MEMORYOS_BUDGET_TOKENS = '512'
    $env:MEMORYOS_MAX_CONTEXT_CALLS = '1'
    $env:MEMORYOS_RESPONSE_FORMAT = 'deepseek-compact'
    dsh --profile memoryos

典型用法¶

插件提供了通過聊天控制 MemoryOS 的能力，無需桌面快捷方式或 shell 命令：

• 開啓/關閉：輸入 關閉 OS 或 開啓 OS。模型必須調用 memoryos_control 工具。
• 查詢狀態：輸入 OS 現在開着嗎？
• 安裝命令：

    dsh plugin --profile memoryos add github:tianhao8687/dsh-memoryos#v0.2.0

• 配置環境變量：

    $env:MEMORYOS_BASE_URL = 'http://127.0.0.1:8000'

適用場景與注意¶

• 適用場景：需要嚴格證據、基線對比以及精細控制記憶上下文範圍的開發者。
• 兼容性：已固定在 DeepSeek Harness 0.1.0-rc.5（commit 47f943859bef60e4160492346772ded9b24f765a）。
• 架構注意：Bundle 是 DSH 適配器，不是數據庫。SQLite、遷移、檢索、當前真值、衝突關係和上下文編譯邏輯保留在 MemoryOS 中。
• 默認只讀：默認情況下爲只讀。評估寫入和受控上下文驅逐需要顯式 opt-in。
• 嚴格基線：當 MEMORYOS_CONDITION=no_memory 時，整個組件（包括控制工具）完全缺失，僅保留使用收集器。
• 安全提示：插件以當前 DSH 進程權限運行，安裝前請檢查源碼與許可證。

短結尾¶

dsh-memoryos 通過提供嚴格的 no_memory 基線和精確的追蹤，幫助開發者驗證記憶機制的有效性。更多細節請參考官方目錄：https://www.skillhub.cn/plugins/tianhao8687/dsh-memoryos 或 GitHub 倉庫：https://github.com/tianhao8687/dsh-memoryos。