Why this exists

一个有本事的助手，依然是个失忆的助手。每次会话它都从头来过：不知道您已经懂了特征向量、却从没碰过张量网络；不知道您宁可被纠正、也不愿被鼓励；也不知道三周前您已经决定不走那条路。于是您一次次重新自我介绍，而这场本可以从有趣处开始的对话，从零开始。

yammory_system 给 DeepSeek Harness 一个地方存住这些知识，以及一套不去猜也能用上它的办法。三件事让它区别于一个记忆仓库：

• 先决定怎么说话，再去检索。 七面画像携带分领域知识水位，所以助手在开口之前就知道您能接住哪些词——注入发生在提示组装时，而非检索之后。
• 没有您，什么都不写。 每条写路径都被强制经过服务内部 DSH 自己的审批门。被拒的写同样留证；静默写入不是本插件能到达的状态。
• 它的工作您可以查。 模型看过的每一句都有记录，库是一个您可以浏览、导出与审计的普通 SQLite 文件，一整类错误由设计拦下，而非靠自觉。

Install

# 1. install the bundle into your profile
dsh plugin --profile web add "github:KhalilYamber/yammory-system#main"

# 2. restart and verify the row
dsh --profile web --dump-config | grep -A3 'id: yammory_system'

其他渠道与卸载：

• git channel（最新 main）：dsh plugin --profile web add git+https://github.com/KhalilYamber/yammory-system.git。
• tarball channel：在本仓库执行 npm pack，然后 dsh plugin --profile web add ./yammory_system-<version>.tgz。
• uninstall：dsh plugin --profile web remove yammory_system（记忆库与会话日志保留）。

The first minute

重启之后，什么都不用配，您就该看到：

Table of contents

• Why this exists
• Install
• The first minute
• How it works
• Capabilities
• Compatibility
• Configuration
• Tools & surfaces
• MCP server
• Permissions & data
• Security boundaries
• Known limitations
• How it's different
• dsh-memory-protocol v1
• What we learned from the terminal memories
• Development
• Topics
• Contributors
• Upstream

How it works

yammory_system 是能力接缝，不是又一个仓库：一个类型安全的 ctx.memory 服务、一个本地 SQLite 提供方（node:sqlite，WAL，0600，位于 $DSH_HOME/dsh-memento/memory.db），以及它的消费方——memory 工具与注入系统提示的冻结快照。

两条轨道 × 两个层级 × 按 agent 隔离：user 轨（关于用户的事实）与 agent 轨（环境事实与约定），各自再分为 user-global 与 workspace 层，并按 agentPreset 隔离。快照在会话首次组装提示时冻结一次，会话中途不再变化。预热块承载表达约束与常驻画像，末行是一行目录（本工作区与 agent 轨另有 N 条记忆不在本块），让模型知道还有东西可按需取——只报条数，正文仍留在 memory_recall 那一侧。

Capabilities

• 审批门不可绕过。 每条写路径（add / replace / remove / seed）都被强制经过服务内部的审批 waterfall，而非工具层。writePolicy: ask | auto | off 是模型看不见的配置；replace / remove / consolidate 的审批载荷携带将被改动条目的全文，被拒的写同样落一条 *-denied 审计行。

• 模型可见 ⟺ 已记录。 注入的快照逐字进入 system/message；每次写都能从 approval/asked + approval/decided + 插件自有审计表重建。

• 有界且诚实。 每轨每层软预警线（默认 user 2000 / agent 4000）。越线绝不拦写——只提示这一格值得整合。绝不截断、绝不自动压缩。

• 会话级开关。 每个会话一个自己的记忆开关（插件自有 SQLite 表，schema v6；默认开）。关掉即四件同时停：注入停（该会话的冻结预热块立刻作废）、召回禁（SESSION_MEMORY_OFF）、写入停（与审批门同层拦截）、观察不碰（本会话不扫，历史选区也不选它）。管理面只读（/memory list / budgets / audit / export）照常可用。用 /memory session on|off 或输入框下方的开关切换；开关状态本身绝不进会话日志，审计行 text 恒为 null。

• 观察，并让观察自己跑下去。 观察通道读一段您自己的旧发言，落下面向「问卷够不到的那几面」的行为条目。

  • 闹钟：一条只读检查在距上次观察超过一周时提醒——一行 observe-due 审计 ＋ 下一次会话预热段末行一句。
  • 无人值守轮：一条每周的计划任务能在一个工作区里跑完它——无头 dsh 会话扫描、至多推断 3 条带证据的条目、过同一道审批门落库，放行靠它自己的写策略来源（source:observation，auto / ask / off）。
  • 调度在哪：插件里不装定时器；调度是一条 Windows 计划任务，与整理轮同理。

• 整理与度量。 模型驱动的整理把「在讲同一件事」的条目并成一条带 merged 标的条目，旧条目降级为 superseded——仍在库里，退出每个会话的可见集，绝不物理删。它不跨桶（track × scope × agentKey，workspace 层再加 workspaceKey），也绝不自动跑。

  • 谁说了算：合并能否不经人眼落写，由五根机械硬杠判定（同桶 / 条数 / 去标点、空白与符号后逐字一致 / 相似度 / 覆盖度），不由模型自报把握。只有「去过标点、空白与符号后逐字相同」的那一档判 auto、可以无人值守落写；改写过的同义句连 review 线都够不着，落 skip（原地不动）；一字之差落 review，等您过目。
  • 后台轮：由您自己的计划任务唤起的无头 dsh 会话自行合掉机制上明确无歧义的重复，硬杠不敢担保的部分留着等您。写入把审计来源钉成 tidy-auto，所以粒度写策略（source:tidy-auto）可以只放行这一条路，其余写入仍留在审批门后。
  • 只提示，不动手：只读的 agent/turn-stopping 检查只提示积压过线——一行 tidy-due 审计 ＋ 下个会话预热段末行一句。
  • 三数：/memory stats 打印可观测三数（重复率 / 召回命中率 / 注入量），抽屉面板里同样有这三行；成功率刻意留白，因为本仓库没有「注入之后对方是否真听懂了」这条信号源。
  • 面板按钮：整理全库现在真的会跑——点一下即登记标记（tidy_requests，schema v7）并起一轮无头会话去整理，会话里的模型自己读计划、自己合，跑完清标记、落批次号。面板只留一行状态（排队中 → 整理中 → 已完成 · 合并 N 组，或 没有需要合并的条目，失败则给「重试」）＋ 下方批次块里的整批撤回按钮；前端不冒对话、不占上下文。执行体是探测出来的而非按平台猜死（配置点名 → 宿主自身的 CLI 入口 → PATH），一轮没落下任何批次也会自己留一行「正常退出」凭据，按钮不会卡死。tidy.enabled: false 可退回旧的排队式。

• 治理：把降级走回来，把冲突按面裁决。

  • restore 把一次降级走反方向（superseded → active，version 不动，重新进入每个会话的可见集），它是脱离降级态的唯一出口。
  • arbitrate 处理「同一条事实、两个来源」：在一个面上裁决，方向由固定表决定——能力听观察、意愿听自陈，其余五面两条都留并各打 gap 标（落差本身即证据）。表即方向，所以没有反向参数可传；同组内保留 updatedAt 最新者。
  • 与所有写路径同门：同一审批门、同一会话开关、同一桶内边界。审计也逐条留痕——restore 每条一行，arbitrate 每次降级一行（text 恒为 null，只记 id）、打标一行 arbitrate-tag，收尾一行 arbitrate 摘要写清保留了谁、降级了谁、理由是什么。

Compatibility

Configuration

所有可调项均为 Schemastery Config 字段（可在 cordis.yml 中修改）。非法值在加载期响亮失败。在 yammory_system 行下覆盖。

设置面板。 DSH 设置服务挂载时，下表除 enabled 外的全部字段可在 DSH 设置侧栏的插件一级项 yammory-system（与通用设置、插件等并列）中编辑；修改写入设置用户层（settings.yaml），无需改文件。几乎全部即时生效（写策略、语言、预算、各上限、提案、面板；dbPath / auditRetentionDays 经重开 store 生效；retrieval.vector 经重装检索器生效）——只有 snapshotOrder 需要 DSH 重载。设置服务缺失时一切回退组合配置，与从前完全一致。侧栏底部的记忆入口可在同一页面隐藏（panel.enabled）。

Tools & surfaces

MCP server

yammory_system 附带一个只读 stdio MCP 服务器（yammory_system-mcp），让外部 MCP 客户端（Claude、Codex 等）无需 harness 即可检索记忆库。它通过 newline-delimited JSON（NDJSON）承载 JSON-RPC 2.0——每行一个 JSON 对象，不支持 Content-Length 分帧。

只读。 数据库以 node:sqlite 的 readOnly: true 打开（不跑迁移、不写 WAL、不 bump recall-count）；库文件不存在时返回空结果而非崩溃。

直接运行：

node bin/mcp-server.mjs
# 或从 GitHub 渠道装好之后：npx yammory_system-mcp
#（本仓库尚未发布到 npm 注册表；上面的 -p github:… 就是取包来源）

数据库路径取自 $DSH_MEMENTO_DB_PATH（绝对路径，或相对 $DSH_HOME）；默认为 $DSH_HOME/dsh-memento/memory.db。

Claude Desktop（claude_desktop_config.json）配置示例：

{
  "mcpServers": {
    "yammory_system": {
      "command": "npx",
      "args": ["-y", "-p", "github:KhalilYamber/yammory-system", "yammory_system-mcp"],
      "env": {
        "DSH_MEMENTO_DB_PATH": "/home/you/.dsh/dsh-memento/memory.db"
      }
    }
  }
}

服务器只读：无网络、无写入、无审批门——仅检索与统计。

Permissions & data

• Permissions：workshop 清单声明 harness:tool、filesystem:read、filesystem:write，以及 network:none / subprocess:none / shell:none / python:none / credentials:none。写审批走官方审批接缝。这份声明有一处要照实读：整理全库按钮会起一轮一次性无头会话（dsh --profile headless）——它是本插件唯一的一次进程启动，由用户触发、落日志、可整批撤回，并可由 tidy.enabled 关掉。
• Data：本地 SQLite 数据库（0600），零网络、零凭据。
• Session log：审计完整性来自审批对（approval/asked + approval/decided）加插件自有审计表。

Security boundaries

• 仅公开服务。 只消费 tools、systemPrompt 与审批接缝；不改 engine / agent-loop / apiproxy / 官方 UI。
• 零网络、零凭据。 本地数据库，POSIX 文件权限 0600。
• 失败要大声。 库损坏、schema 过新或非法配置在加载期抛错；子串歧义返回结构化错误。越预警线不拦写。
• 一进程一库。 多个会话共享 SQLite 库；共享同一 $DSH_HOME 的两个进程写同一文件（SQLite 锁下后写覆盖）。

Known limitations

• 会话事件已声明、尚未发出（rc.2）。 memory/added|updated|removed|recalled|snapshot 已合并声明，但 rc.2 没有仓库外事件类型的注册面；一旦 harness 构建收录这些类型即自动开启发出。
• 一轮后台整理只覆盖一个工作区。 闸一只读 cwd 与调用方精确相等的会话，所以从面板起的那一轮覆盖它启程时所在的工作目录（外加 user-global 层）。别的工作区各有各的一轮。
• ask 策略需要 answerer。 未组合 UI/ACP answerer 时，写入失败关闭。
• 无 FTS5 索引。 子串搜索走大小写不敏感的 instr（对 CJK 正确）。
• 观察面是白名单，而白名单有边界。 memory_observe scan 只保留 source.kind 为 user / user-rpc 的 user/message 事件；本机实测这一条会挡下全部 user/message 的 48%（运行时上下文、AGENTS.md、skill 目录、goal 轮次、子代理通知）。但它分不出「人打的」与「外部桥接注入、同样声明 kind: 'user' 的」——事件日志只带这一个信号。故单条引文只算弱证据；要下结论，须跨会话重复出现。
• 被叫作「语义」的那半边召回还不语义。 retrieval.vector 只在注册了真正声明为语义的嵌入 provider 时才生效，而本仓库自带的那个 provider 声明 false，所以今天这个开关是按设计回落到关键词召回。要开真正的语义召回，得先有一个本仓库尚未选定的嵌入来源。

How it's different

今天真正立得住的差异是上表最后两条：带分领域知识水位的七面画像（在任何检索发生之前就决定助手该用什么口吻说话），以及分面裁决（同一条事实有两个来源时怎么收场——能力听观察、意愿听自陈，其余五面两条都留、各打一个 gap 标）。

名称是 yammory_system（走 GitHub 渠道安装；尚未发布到 npm 注册表）。不是 dsh-recall（易与 dsh-external/Recall 混淆），也不是已删除的旧名 dsh-memory。

dsh-memory-protocol v1

yammory_system 是 DSH 记忆协议的社区预演——官方 ctx.memory 接缝的一个候选形态。该协议把本插件的接缝规范化为跨插件契约：

• Entry spec — 两条轨道 × 两个层级 × 按 agent 隔离，外加短 tags（≤16 × ≤32 字符）与每次 replace 递增的每条目 version。

• Write semantics — 幂等的唯一子串条件写；批准即所见载荷（replace / remove / consolidate 携带将被改动的全文）。

• Audit contract — 每次写都能从 approval/asked + approval/decided + 提供方账本重建。

• 预警线模型 — 每层软预警线 / AMBIGUOUS_MATCH 语义。

• Schema versioning — 带响亮版本检查的迁移规则。

• Spec — docs/protocol-v1.md（中文: protocol-v1.zh.md）；规范性 JSON Schema 见 docs/schemas/dsh-memory-protocol-v1.schema.json。

Adapter registry — ctx.memoryAdapters（register / list / adapt / export）让第三方记忆插件通过注册纯数据转换器接入协议（可逆 register()；导入走审批门 seed，导出只读）。接入指南：docs/adapters-guide.md（中文: adapters-guide.zh.md）。

Conformance suite — test/protocol-conformance/：可分发用例集，任何声明兼容的提供方都能跑（node test/protocol-conformance/run.mjs --provider ./your-factory.mjs）；本仓库 CI 以自有提供方为黄金参考运行它（npm run test:conformance）。

• Upstream proposal — docs/upstream-proposal.md（中文: upstream-proposal.zh.md）：为何官方 ctx.memory 接缝应采纳该协议、差异与迁移路径。

What we learned from the terminal memories

yammory_system 不是 Claude Code、Codex 或 Hermes 的移植——但其设计刻意吸收了它们各自做对的部分，并拒绝有害的部分：

来源：Claude Code memory · Codex AGENTS.md · Hermes memory · Hermes #48181。

刻意拒绝的部分：隐藏地自动摘要进模型私有状态（此处压缩摘要成为等待人类 approve/dismiss 的待处理提案）、仓库/向量库野心，以及任何缺少人类可见审批或审计链的写入。也采纳了：Hermes 记载的"两个进程共享一个主目录写同一记忆文件"的告诫——见 Security boundaries。

Development

npm install              # node ^22.19 || >=24
npm test                 # node --test: 484 tests
npm run lint             # oxlint
npm run test:conformance # dsh-memory-protocol v1 conformance suite
npm run typecheck        # tsc --checkJs gate
npm run check:coverage   # line-coverage gate
npm run check:readmes    # five-language README consistency gate
npm run verify:self-contained # reject out-of-repo dependency specs
npm run verify:artifacts # artifact presence + syntax + import

lib/ 零 DSH 依赖（仅 node: 内置模块）；DSH 导入只出现在 index.mjs。

Topics

dsh, dsh-plugin, deepseek-harness, memory, agent-memory, approval, audit, sqlite, cordis, llm

Contributors

• @Niuniu-Sir — issue #1 中的启动崩溃报告，催生了 0.3.1 引入的 ~/.dsh 回退。

Upstream

This project is a fork of dsh-memento, originally part of the PerryLink DSH plugin family. Upstream attribution and the Apache-2.0 licence are preserved.

Apache License 2.0 © 2026 dsh-memento contributors