前言¶
在 DeepSeek Harness(DSH)裏做多輪對話時,上下文窗口會截斷較早內容;若把「記住用戶偏好、項目約定、上次結論」完全交給模型自行發揮,既不可靠,也難以審計。社區裏常見做法是外掛向量庫或手寫摘要腳本,與 Harness 的生命週期、系統提示拼裝往往脫節。
下面介紹 risense-ai 維護的 Respire memory for DeepSeek Harness(npm 包 @rsrsai/dsh):以原生 TypeScript 插件形式掛進 profile,通過 Harness 已有的 agent 與 systemPrompt 鉤子調用 Respire 引擎(rsrs CLI),由引擎負責存儲、去重、加密、模型推理、賬號與同步;插件側只做規則註冊、回合前召回與回合結束時的有限檢查。
這是什麼¶
- 定位:DeepSeek Harness 的「記憶」類插件,bundle 名對應啓用項
respire-memory,來源應爲@rsrsai/dsh。 - 維護者:risense-ai;源碼與說明見 GitHub: risense-ai/respire-dsh,社區目錄頁 skillhub.cn/plugins/risense-ai/respire-dsh。
- 與引擎的關係:
@rsrsai/cli(通過全局安裝的rsrs-cli)是記憶引擎;@rsrsai/dsh是 Harness 插件。插件始終以rsrs --client-only調用引擎,不替你在聊天裏收密碼、不安裝運行時、不改賬號配置;需要本機已有可用的 rsrs host runtime。
核心功能(與 README 一致)¶
插件在 Harness 內大致做三件事:
- 穩定規則:經
systemPrompt.section向系統提示註冊與記憶相關的規則。 - 回合前召回:在
agent/pre-step從 Respire 拉取與當前步相關的記憶並注入流程。 - 回合結束檢查:在
agent/turn-stopping檢查是否有可寫入的新發現;每個請求最多一次(單輪有界 steer,停止時不查引擎;若本會話從未確認引擎可用則跳過)。
存儲、去重、加密、語義模型與庫解鎖等能力由 rsrs 承擔;插件依賴 Harness 標準 desktop profile 已提供的 agents、systemPrompt、subprocess、workingDirectory、tools 等服務。
環境與前置條件¶
資料中寫明的約束如下:
| 項 | 要求 |
|---|---|
| Node.js | 24+(package.json 中 engines.node: >=24) |
| DeepSeek Harness | README 安裝說明在 0.2.1-rc.5 上驗證;包聲明 dsh 爲 >=0.2.1-rc.2 <0.3.0 |
| rsrs CLI | 需單獨安裝;插件不 bundled 引擎 |
先安裝並檢查引擎(在 profile 的執行環境中執行):
npm install -g rsrs-cli@latest
rsrs --version
rsrs --client-only status --json
賬號、庫解鎖、可選語義模型等,按 rsrs 自帶的交互流程配置;未完成的部分需你在本機自行完成,插件不會在對話裏索要密鑰。
安裝與啓用¶
不要在普通終端裏只跑 npm install @rsrsai/dsh 就指望 profile 自動加載插件;Harness 裏應通過 plugin_manager 安裝 npm bundle。
在 Harness 中讓助手執行(或你自行調用 plugin_manager):
{
"action": "install_bundle",
"target": "@rsrsai/dsh"
}
需要固定版本時,target 可寫爲 @rsrsai/dsh@0.1.13 等形式(以 npm 上實際發佈爲準)。安裝或替換版本後 重啓 Harness;在 Plugins 頁或 dsh plugin --profile <profile> list 中確認:有且僅有一個啓用的 respire-memory 條目,且來自 @rsrsai/dsh。
若曾安裝舊 bundle @rsrsai/respire-dsh,先在插件管理中禁用並移除舊 bundle,再安裝 @rsrsai/dsh;保留現有記憶庫、賬號與 rsrs 配置。若 manager 要求先 stop profile,按提示操作後再繼續。
本地開發時,可將倉庫 checkout 的絕對路徑作爲 target;發佈包已含編譯好的 lib/,無需在 profile 裏跑 build。
典型用法與驗證¶
README 建議的安裝後驗證思路(可交給 Harness 內助手執行,核心是觀察行爲而非只聽說明):
- 在新對話裏做一次 recall 相關檢查。
- 請你提供一條 非敏感 測試事實,再檢查是否真正寫入記錄。
- 在另一次 recall 回合裏,在不成功顯式 store 的情況下,確認 stop 提醒 等行爲是否符合預期。
資料註明:npm 安裝與模塊加載已驗證;完整 desktop 對話端到端在 README 中未宣稱已全部驗證,你應在自己環境上完成上述觀察後再視爲可用。
也可把 README 中的「Install with AI」整段 prompt 粘貼給 Harness 內助手,由其在當前 profile 中按 README 執行檢查與 install_bundle,並彙報仍需你在 rsrs 側完成的登錄、解鎖或模型步驟。
通過插件市場發現更新¶
npm registry 仍是版本真相來源;倉庫另發佈 Harness 可用的 plugin market index(format 1),便於在 Discover 裏看到版本與更新提示:
- 主索引:
https://raw.githubusercontent.com/risense-ai/respire-dsh/market-index/marketplace.json - GitHub 不可達時的鏡像:
https://cdn.jsdelivr.net/gh/risense-ai/respire-dsh@market-index/marketplace.json(第三方 CDN,可能滯後,以 raw URL 爲準)
配置步驟(摘自 README):
- 打開 Harness Plugins,在 Experimental plugins 旁選 More,啓用 Custom plugin markets,出現 Discover 頁籤。
- 在 Discover 中選 Add index source,粘貼上述 URL 之一。
- Respire 卡片會列出已發佈版本;若有比當前安裝更新的兼容版本,會標記 Update available。索引在頁面加載或刷新時拉取,緩存約十分鐘,不後臺輪詢。
- 安裝新版本:打開條目版本列表選 Install;第三方條目無一鍵 Update,會先移除舊 bundle 再裝新版,manager 完成後需 重啓 Harness。
- 重啓後覈對 Plugins 頁或
dsh plugin --profile <profile> list中的版本,以及 profile 的package.json是否 exact pin。
命令行固定版本示例:
dsh plugin --profile <profile> add @rsrsai/dsh@<version> --save-exact
回滾時用上一版本號執行同一條命令。若錯誤版本導致 Harness 無法啓動,需先退出桌面進程,再用 bundled CLI 執行上述命令後重啓。
適用場景與注意¶
適合:已在用或計劃用 Respire(rsrs)做個人/項目記憶庫,並希望記憶規則、召回與寫入檢查與 DSH 對話回合對齊,而不是在 profile 外另寫一套 glue 腳本的開發者。
務必注意:
- 插件以 當前 DSH profile 進程權限 運行,並調用本機
rsrs;安裝前請閱讀源碼與 MIT 許可證,自行評估數據出境、加密與賬號策略。 - 其他 Harness 版本 未在 README 中驗證;與 0.2.1-rc.5 不一致時可能行爲異常。
- 社區目錄 skillhub.cn 是獨立生態索引,與 DeepSeek / 幻方無官方從屬關係;DSH 本身遵循「一切皆插件」,本插件是其中一條記憶鏈路。
結尾¶
@rsrsai/dsh 把 Respire 的記憶能力接到 Harness 的標準鉤子上:系統提示段、回合前召回、回合結束時的有界檢查,引擎能力留在 rsrs。先做環境與 rsrs --client-only status 檢查,再用 install_bundle 安裝 bundle,重啓後確認唯一的 respire-memory 來源,最後在新對話裏用非敏感事實做存儲與召回驗證。
- 目錄頁:https://www.skillhub.cn/plugins/risense-ai/respire-dsh
- GitHub:https://github.com/risense-ai/respire-dsh
- npm:https://www.npmjs.com/package/@rsrsai/dsh