前言¶
在 DSH 裏跑智能體時,上下文往往只存在於當前會話。關掉終端或換一臺機器,之前沉澱的偏好、結論和約定就帶不過去。有人會在項目裏自建向量庫或 JSON 狀態文件,但還要自己管鑑權、部署和檢索接口。
下面介紹維護者 renorai 發佈的 dsh-renor(分類:記憶)。它不實現業務邏輯,只在 DSH profile 裏插入一行配置,讓 @deepseek-ai/dsh-mcp-client 通過 Streamable HTTP 連到 Renor 託管的 MCP 端點 https://mcp.renor.cloud/mcp。模型在需要時調用 Renor 提供的工具讀寫記憶;插件本身不會自動保存或召回任何內容。
DSH 社區插件目錄是獨立站點,與 DeepSeek / 幻方無官方從屬關係;安裝第三方插件前宜自行查看倉庫源碼與許可證(本插件爲 MIT)。
這是什麼¶
dsh-renor 是 DeepSeek Harness (DSH) 的配置型插件:倉庫裏主要是 cordis.patch.yml 和說明文檔,沒有自研運行時代碼。作用可以概括成一句話——把 DSH 接到 Renor 這家面向 AI Agent 的託管記憶服務上。
維護者標註的 peer 依賴爲 @deepseek-ai/dsh-mcp-client(>=0.2.2-rc.1)。插件在 profile 補丁里註冊名爲 renor 的 MCP 客戶端行,serverName 爲 renor,傳輸方式爲 streamable-http。
連接後能用到什麼¶
DSH 啓動併成功連上 Renor 後,服務端暴露的工具會以 mcp__renor__<tool> 的形式出現在智能體側。README 舉了兩個例子:
mcp__renor__get_context:按請求讀取 Renor 中與之相關的記憶;mcp__renor__remember:保存一條陳述。
完整工具列表在連接時由服務器下發;當前全集見 Renor 工具參考。每個工具的描述與 schema 會隨請求發給模型,官方文檔註明全套工具大約會給每次請求增加約 10,000 tokens(數字出處同上文檔)。
是否調用這些工具由模型決定,沒有「每輪自動寫入 Renor」的行爲。
安裝與啓用¶
按倉庫 README,建議順序如下。
- 在 renor.cloud 註冊 Renor 賬號。
- 打開 app.renor.cloud 儀表盤,進入 API keys,選擇 Create key。密鑰只顯示一次,有效期 365 天,可在同一頁面撤銷。
- 在運行
dsh的進程環境中設置密鑰(不要寫進cordis.patch.yml):
export RENOR_API_KEY="paste-your-key-here"
- 對指定 profile 安裝插件並重啓 DSH:
dsh plugin --profile <name> add github:renorai/dsh-renor
- 啓動會話後,可讓智能體列出 Renor 相關工具,或嘗試調用
get_context做連通性檢查。
卸載時:從 profile 的 cordis.patch.yml 刪除 renor 行,或用 dsh plugin 移除插件,然後重啓 DSH。
鑑權方式說明¶
Renor 對部分 MCP 客戶端支持 OAuth,但 README 寫明撰寫時使用的 @deepseek-ai/dsh-mcp-client(0.2.2-rc.1)在 streamable-http 配置下只接受 URL 與靜態 headers,沒有 OAuth 選項。因此本插件通過 header 發送 Authorization: Bearer <key>,密鑰從環境變量 RENOR_API_KEY 在加載 profile 時讀取。
若未設置 RENOR_API_KEY,插件會發送空的 Authorization;Renor 返回 401,Renor 工具不會出現,會記錄錯誤,但 DSH 仍可正常啓動。若未來 DSH 的 MCP 客戶端支持 OAuth,README 建議本插件可改用 OAuth。
配置補丁內容¶
插件通過 cordis.patch.yml 向 profile 插入一行(節選結構與官方一致):
- insert:
- id: renor
name: '@deepseek-ai/dsh-mcp-client'
config:
serverName: renor
transport: streamable-http
url: https://mcp.renor.cloud/mcp
headers:
Authorization: !!js "process.env.RENOR_API_KEY ? `Bearer ${process.env.RENOR_API_KEY}` : ''"
補丁會整體替換某一行的 config;若要改 toolCallTimeoutMs 等字段,需把該行復制到你自己的 profile 補丁里再編輯。若使用自託管 Renor HTTP 服務,可改 url。
package.json 中版本爲 0.1.0,通過 dsh.bundle.patch 指向上述文件。
數據去向與權限邊界¶
README 對數據流做了明確劃分,使用前宜知悉:
- 發往 Renor(
mcp.renor.cloud):API 密鑰,以及模型在工具參數裏填入的檢索查詢、remember保存的陳述。工具結果會像其它 tool 結果一樣回到對話,並隨之下發給你配置的 DSH 模型提供方。 - Renor 側存儲:記憶存放在 Google Cloud
us-central1(美國);語義檢索會把筆記與查詢發往同區域的 Google Vertex AI。細節見 Renor 安全頁。 - 本插件不會主動發送:不讀取你的文件或會話歷史;只有模型發起的 tool call 會到達 Renor。
- 用戶側控制:可在儀表盤導出全部記憶(Markdown)、刪除記憶、撤銷 API key。
插件以當前 dsh 進程的權限與環境變量運行;密鑰應只授予你信任的運行環境。
典型用法¶
倉庫未給出固定 prompt 模板,驗證步驟是可復現的:
- 完成安裝並設置
RENOR_API_KEY後重啓 DSH。 - 在會話中請智能體列出可用的
mcp__renor__*工具。 - 先讓智能體調用
remember寫入一條你希望長期保留的陳述,再在新會話或相關話題下調用get_context檢索。
記憶是否持久、檢索質量取決於 Renor 服務與模型是否選擇調用工具,而不是 DSH 默認行爲。
適用場景與注意¶
更適合:希望在多臺機器或多會話間共享 Agent 記憶、又不想自建 MCP 記憶服務與檢索後端的 DSH 用戶;能接受 Renor 託管與美國區域基礎設施的開發者。
需要注意:
- 工具 schema 帶來的 token 開銷(約 10,000/請求)在長上下文或多工具場景下要計入成本。
- README 寫明倉庫內的
npm test校驗補丁格式與 Authorization 表達式,不包含「安裝到運行中的 DSH 並連接線上服務器」的集成測試;生產依賴前建議自行做一次端到端驗證。 - GitHub 星標爲 0(以目錄抓取信息爲準),不代表功能不可用,但社區反饋樣本較少,宜以官方文檔與自測爲準。
結尾¶
dsh-renor 把 DSH 的插件化配置與 Renor 託管記憶 MCP 接在一起:一行 patch、一個環境變量、官方給出的 dsh plugin --profile <name> add github:renorai/dsh-renor,即可讓模型在需要時通過 mcp__renor__get_context 與 mcp__renor__remember 等工具操作外部記憶。