前言¶
在 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。
