前言¶
在 DeepSeek Harness（DSH）裏啓用 MemOS 官方雲記憶插件後，連接、召回條數、寫回範圍等參數都落在 YAML 或英文設置項裏。逐項對照上游文檔改配置，容易漏字段，也不方便做連接驗證。社區維護者 lxl2000927 發佈的 dsh-memos-panel（當前 v1.2.9）是面向同一套上游能力的第三方中文面板：把 MemOS 相關參數分組展示，並可選本地隱私篩選與召回二次篩選。它與 DeepSeek、MemTensor 或 Purge 無官方從屬關係，需在安裝前自行閱讀源碼與許可證。
這是什麼¶
dsh-memos-panel 爲 DSH 插件 @memtensor/memos-cloud-dsh-plugin（固定兼容 0.1.2）提供中文配置界面。面板不替代官方記憶服務，而是在宿主 Settings 之上彙總 35 項上游參數、6 項召回篩選和 6 項隱私設置，共 47 項、8 個分類；默認只展開 7 項常用設置，其餘分類入口平鋪可見。配置入口在 設置 → MemOS 記憶；插件詳情頁僅展示插件信息。
運行層通過 bundle 停用原始 memos-cloud 生命週期條目，改爲本包的 memos-cloud-guard，避免與上游重複召回和寫回；上游版本不匹配或配置校驗失敗時會停止請求，不會退回未過濾請求。
核心功能¶
中文分組配置¶
- 中文名稱在左、英文參數名在右；正文與輸入 15px、說明 14px。
- 分組支持平滑展開、收起及待保存提示，摺疊後保留草稿。
- 搜索全部參數、「僅看更改」、逐項或按組恢復默認、JSON 格式化、放棄草稿及版本衝突檢查。
- 頁面頂部摘要使用已保存配置；草稿需點擊「保存配置」才生效。恢復默認只移除選定參數的覆蓋值，密鑰不會隨分組重置而刪除。
連接測試¶
MemOS 與召回篩選服務各有獨立連接測試；只發送固定樣例，不寫入記憶，不使用真實召回內容。兩個 API Key 獨立保存，空輸入保留已有值，狀態接口不返回已存密鑰。
召回二次篩選（可選）¶
默認關閉。開啓後，在 MemOS 召回投影與注入之間調用 OpenAI 兼容的 /chat/completions 端點，挑選與當前問題相關的條目並去重。v1.2.9 側重記憶質量：篩選優先用戶明確更正、本地去重精確重複候選、事實與偏好分別佔用候選預算，二次篩選後再執行最終注入預算；篩選關閉時沿用原有召回行爲。
主要參數包括 recallFilterEnabled（默認 false）、recallFilterBaseUrl、recallFilterApiKey、recallFilterModel、recallFilterTimeoutMs（默認 6000ms）、recallFilterFailOpen（默認 true）。配置完整後再開啓；過濾失敗不刪除雲端記憶。
本地隱私篩選¶
六項設置：篩選總開關、憑據攔截、手機號脫敏、郵箱脫敏、自定義攔截詞和自定義脫敏詞。規則只處理發往 MemOS 與二次篩選服務的請求，不處理 DSH 主模型請求。隱私配置保存在定位到的配置目錄內的 memos-panel.privacy.json，不混入 MemOS 原生配置。
宿主適配¶
面板不會修改 Purge 補丁、DSH SDK 或官方 MemOS 包。優先沿用宿主 Settings；缺少舊註冊接口時使用插件內部適配層讀取 settings-legacy.yaml 的 memos-cloud 段。缺失可選 SDK peer 時從運行中的 DSH 入口解析，無需手工創建目錄鏈接。
安裝與啓用¶
安裝前須已在 DSH 中安裝並啓用官方 MemOS 插件，版本須爲 0.1.2。插件以當前 DSH 進程權限運行，安裝前應檢查 GitHub 倉庫 源碼與 MIT / Apache-2.0 許可說明。
- 打開 DSH「插件 → 添加插件」，使用發佈包直鏈安裝：
https://github.com/lxl2000927/dsh-memos-panel/releases/download/v1.2.9/dsh-memos-panel-1.2.9.tgz
-
更新已有面板時使用同一鏈接。安裝完成後完全退出並重新打開 DSH，使後端生命週期重新加載。
-
在「設置 → MemOS 記憶」檢查連接狀態和配置。舊賬號與 Key 會繼續沿用，不要重新填寫或更換用戶 ID。
也可從 Release v1.2.9 下載 .tgz 和 .sha256 後本地安裝。Git 源地址爲：
https://github.com/lxl2000927/dsh-memos-panel.git#v1.2.9
本項目通過 GitHub 發佈，未發佈到 npm；僅輸入包名 dsh-memos-panel 不能保證安裝的是本項目。Web Profile 可使用 dsh plugin --profile web add <安裝包地址>；README 註明本版本未獨立驗證 Web 部署。
典型用法¶
MemOS 連接與記憶行爲¶
- MemOS API Key：在 MemOS 控制台 獲取；輸入框留空保留已有值。
- 賬號 / 用戶 ID：長期記憶的穩定歸屬標識，跨設備使用同一值；啓用身份信息攔截時，含手機號或郵箱的標識會阻止請求。
- API 服務地址：默認
https://memos.memtensor.cn/api/openmem/v1；遠端要求 HTTPS，本地迴環可用 HTTP。 - 回答前檢索記憶、對話完成後保存記憶：分別控制每輪首個模型步驟前的召回注入，以及成功結束輪次的雲端寫回；條數、字符預算、知識庫和標籤在各字段下顯示默認值與範圍。
配置完成後使用頁面上的 MemOS 連接測試確認可達性。
開啓召回二次篩選¶
在面板中填寫 recallFilterBaseUrl（含 /v1，不要填 /chat/completions）、密鑰、模型 ID 與超時，先用「測試篩選連接」驗證，再打開 recallFilterEnabled。開啓後有候選記憶的輪次會增加一次模型調用與延遲；當前問題與候選內容會發往所填端點，需先按本地隱私規則處理。
適用場景與注意¶
| 項目 | 範圍與驗證 |
|---|---|
| DSH | 聲明 >=0.2.1-rc.2 <0.3.0-0；Windows 桌面版 0.2.1-rc.5 等見 README 兼容表 |
| MemOS 上游 | @memtensor/memos-cloud-dsh-plugin 0.1.2 |
| Node.js | ≥24.9（開發與打包） |
適合需要在 DSH 裏用中文界面集中管理 MemOS 參數、並希望在寫回/召回鏈路上加一層本地隱私或可選二次篩選的開發者。插件不上傳配置到 GitHub、不收集遙測；卸載 dsh-memos-panel 不刪除上游插件、已有設置或雲端記憶。如需停止全部記憶請求，應關閉召回與寫回或停用記憶插件。
結尾¶
dsh-memos-panel 把 MemOS 0.1.2 的配置、測試與可選篩選收進「設置 → MemOS 記憶」，降低英文參數與分散 YAML 的對照成本。目錄與元信息見 SkillHub 插件頁；源碼、更新記錄與問題反饋見 GitHub：lxl2000927/dsh-memos-panel。
