前言¶

DSH 的理念是通過插件擴展智能體能力。dsh-memoryhub 解決的是“項目記憶如何跨會話使用”的問題：它把 MemoryHub 維護的 .memoryhub/ checkpoint 記憶接入 dsh 會話，並把 dsh 會話回存到 MemoryHub。下面介紹它的能力、安裝方式與配置點。

這是什麼¶

dsh-memoryhub 是 solknight48 維護的 DeepSeek Harness（dsh）插件，許可證爲 MIT。

它把 MemoryHub（mh）接入 dsh：

• 會話啓動時加載 .memoryhub/ 下的 checkpoint memory；
• 保存 dsh 會話回 MemoryHub checkpoints；
• 註冊 mh workflow skill 和 mh_* 工具。

核心功能¶

記憶加載與回存¶

MemoryHub 將項目記憶保存爲 .memoryhub/ 下 git-versioned checkpoints 中的 purified sessions。

dsh-memoryhub 會在會話啓動時在會話工作區運行 mh load，並把 checkpoint memory 注入爲 durable plugin context。

mh_save 用於將 dsh 會話保存回 MemoryHub：將 durable event log 渲染爲 pi-format JSONL transcript，並通過 mh save --transcript 保存。

註冊的工具與 skill¶

插件註冊六個 mh_* 工具：

• mh_load
• mh_save
• mh_status
• mh_list
• mh_search
• mh_checkpoint

它還會註冊 mh workflow skill，說明何時加載、如何保存以及 hub rules。

Web UI 的 Memory tab¶

在 dsh web UI 中，插件會增加一個 Memory tab，嵌入 mh ui 的 checkpoint map。

Memory tab 通過下面接口獲取會話工作區的 mh ui URL：

GET /plugins/memoryhub/mh-ui?session=<id>

Memory tab 僅在存在 web server 時註冊；headless compositions 不會看到該功能。

安裝與啓用¶

前置條件¶

先安裝 mh 並加入 PATH：

uv tool install git+https://github.com/solknight48/memoryhub

運行環境需要：

• git >= 2.32
• Python >= 3.12
• Node >= 22

插件依賴 @deepseek-ai/schemastery ^3.18.1，並 peer depend 於 @deepseek-ai/cordis ^4.0.1 及多個 ^0.1.0-rc.6 的 dsh 包。

安裝插件¶

從 GitHub 安裝：

dsh plugin --profile web add github:solknight48/dsh-memoryhub

如果是本地 checkout 安裝：

dsh plugin --profile web add ./dsh-memoryhub

Git 安裝可能涉及 pnpm prepare 構建。使用 pnpm >= 10 時，首次運行 prepare 前可能需要在 profile 的 pnpm-workspace.yaml 中 allowlist dsh-memoryhub，然後重新執行 add。

配置¶

配置位於：

$DSH_HOME/profiles/<name>/cordis.patch.yml

字段可選，默認值包括：

# 可選字段默認值
# autoLoad: true
# registerTools: true
# registerSkill: true
# uiTab: true

與 UI 相關的配置點：

• uiBudget 默認爲 none。需要 memoryhub repo 中支持 mh ui --budget 的 mh（2026-08-14 或以後）。
• uiReadOnly: true 會以只讀方式提供 map；mh 的 loopback bind、one-shot token、Host check 安全模型保持不變。

典型用法¶

1、確認 mh 已安裝並在 PATH 中。

2、執行安裝命令，將插件加入 web profile：

dsh plugin --profile web add github:solknight48/dsh-memoryhub

3、開啓新會話後，默認 autoLoad 會觸發 mh load，把 checkpoint memory 注入會話上下文。

4、如果只想加載能放入 budget 的最新會話，可傳 mh_load 的 budget 參數。

5、需要把當前 dsh 會話保存回 MemoryHub 時，使用 mh_save。

6、在 dsh web UI 中通過 Memory tab 查看會話工作區的 mh ui checkpoint map。

適用場景與注意¶

適合已經使用 MemoryHub / mh，並希望把 dsh 會話上下文和項目記憶串起來的開發者。

注意：

• 插件會調用 mh，因此 mh 必須可執行且版本滿足要求。
• 插件以當前 dsh 進程權限運行；安裝前應檢查源碼與許可證。
• 許可證爲 MIT。
• Memory tab 依賴 web server，headless compositions 中不可見。
• 如果環境使用 pnpm >= 10，需按 dsh 提示 allowlist dsh-memoryhub。

鏈接¶

• GitHub：https://github.com/solknight48/dsh-memoryhub
• 目錄頁：https://www.skillhub.cn/plugins/solknight48/dsh-memoryhub