dsh-nexus：DeepSeek Harness 的零配置记忆层

前言¶

DeepSeek Harness（DSH）采用插件化架构，开发者通常需要自行处理智能体的记忆持久化与成本控制问题。dsh-nexus 插件旨在提供一个零配置、成本自保的记忆层。它默认零 token、零外部服务，通过“原子 + 门控 + 可审计”的三层结构管理记忆，而非简单的文本追加。

核心功能¶

该插件通过单一的面板实现所有交互，核心能力集中在成本控制、审计与数据清理上。

面板与注入真相¶

面板打包在 lib/nexus.html，通过设置页的「记忆」入口或独立页 /nexus 访问。
顶部会显示当前注入的上下文条数、总字节数及预算剩余。展开详情后，可以查看每条记忆未进入上下文的具体原因，包括：
* 单条超预算
* 被挤掉
* 归属未知
* 属于其他项目
* 本会话
* 非活跃

成本控制与审计¶

• 预算高亮：单条记忆占用的预算超过总预算的 30% 时，会以橙色高亮显示。
• 运行状态：设置页的“运行状态”模块会实时统计今日写入、待确认、已拒收及注入次数。
• 成本明细：在同一处提供注入、提炼、编码三项的 token 与字节数统计。

数据管理¶

• 一键清理：插件能自动识别子代理回执、提示词等误写内容（例如某次测试中 29/33 条为误写），支持一键归档并拉黑，且 5 秒内可撤销。
• 三态删除：支持归档（可回溯）→ 回收站（可恢复）→ 彻底清除（真删并清边）。注意 /memory purge 命令仅做归档，真删需在面板回收站操作。
• 自绘交互：面板中的状态、作用域、提炼模型下拉框均为自绘弹层，避免原生 <select> 在 macOS 亮色模式下的样式问题。

安装与启用¶

由于尚未发布到 npm，目前只能通过 GitHub 源或本地 tarball 安装。

1. 通过 GitHub 安装（推荐）：

    dsh plugin --profile web add github:chenqiuyushuang/dsh-nexus

安装后运行 `dsh web` 启动服务。

2. 本地 tarball 安装：
   若需离线安装，需先在本地构建并打包：

    npm run build && npm pack

安装时使用 `file:` 协议指向生成的 tarball 文件，并确保修改版本号以触发更新。

3. 校验安装：
   安装完成后，建议运行校验脚本以确保代码与面板一致性：

    npm run verify:install

典型用法¶

在会话中，可以通过命令行与面板配合使用：

• 基础操作：

    /memory list|search <q>      # 列表或搜索
    /memory show <id>            # 查看详情
    /memory edit <id> <新陈述>   # 编辑
    /memory delete <id...>       # 删除（进入回收站）

• 审核与冲突处理：

    /memory confirm <id...>      # 确认记忆
    /memory reject <id...> [原因] # 拒收记忆
    /memory conflict [keep-new|keep-old|keep-both <id...>|--all] # 处理冲突

• 会话与维护：

    /memory session [read-write|write-only|pause] # 修改会话模式
    /memory cost                     # 查看成本
    /memory doctor                   # 自检（检查库计数、待裁决冲突、注入占用等）
    /memory import <file>            # 导入记忆
    /memory integrate [run]          # 整合记忆

安全与存储¶

安全配置¶

• 写入限制：写操作要求 Origin == Host（含端口）精确匹配。
• 读取限制：读操作要求 Host 为 loopback，防止 DNS rebinding 攻击。
• 远程访问：如需远程访问，必须在宿主配置中显式开启 webuiAllowRemote: true。
• 安全扫描：支持对密钥、身份证、私钥的出厂扫描。

存储结构¶

插件使用两类存储，需注意区分：
* 投影目录（默认 ~/.dsh/nexus）：存放人类可读的 MEMORY.md / USER.md，权限为目录 0700、文件 0600。
* 原子库：通过宿主的 storage-domain 后端存储，由宿主决定权限。

注意事项¶

• npm 未发布：目前无法通过 npm install 直接安装，必须使用 GitHub 源或本地 tarball。
• 价值密度门（影子期）：目前的记忆打分机制（价值密度门）处于影子期，只记录不拦截。需要积累真实使用样本并验证误拦率为 0 后，才会切换为拦截模式。
• 版本更新：使用 file: 安装时，若包体未变，pnpm 不会更新，必须升级版本号。
• 插件重启：安装新版本后，必须重启 dsh web 进程才能生效。

结语¶

dsh-nexus 提供了一套结构化的记忆管理方案，通过预算控制、审计面板和三态删除机制，解决了智能体记忆管理的成本与可追溯性问题。对于需要精细控制上下文成本的 DSH 用户，这是一个值得部署的插件。

• 项目地址：https://github.com/chenqiuyushuang/dsh-nexus
• 许可协议：MIT