dsh-cc-dream-memory 0.0.0-stage → 0.12.0

package/CHANGELOG.md

@@ -0,0 +1,324 @@
+# Changelog — dsh-cc-dream-memory
+
+## 0.12.0 (2026-11-09)
+
+First public release, under a new name.
+
+- Fixed Dream merge preservation: existing user/feedback facts can move across files; filtered writes cannot leave dependent deletions or index edits; partial apply protects merge destinations, and repeated mutations of one file are refused. Incomplete filtered batches retain their session watermarks.
+- Previously saved incomplete plans with destructive operations are refused; reject those proposals and generate a new dry-run after upgrading.
+- Dream previews now list removed body lines. Evidence is operation-level with host-resolved sources; new user facts still require typed-user evidence, while memory-sourced preference corrections require explicit review. Generated bodies must remain within the full-read limit.
+- Fixed write-conflict false positives with English word boundaries and clause-level polarity; real conflicts enter the existing review queue instead of being discarded. Balanced lexical recall and enabled recall from opted-in user memory without mixing scopes.
+- Added a model-free Dream input estimate in commands and the interface before paid dry-run; documented the 149,984-token real-project observation separately from the small synthetic demo. The existing unlimited default is explicit rather than presented as a spending cap.
+- Added an explicit loopback Host allowlist before bridge token discovery and API actions. Evaluation now verifies the installed profile's package identity and canonical source before real model execution.
+- Corrected the author and contributor metadata to list muuuuuuuuuer and Claude, with DeepSeek Harness acknowledged separately.
+- Prepared public npm publishing with verification before publish, included the security notice, and made README documentation links absolute. Both npm package-name and GitHub installation commands are documented.
+- **Renamed to `dsh-cc-dream-memory`.** npm's `dsh-cc-memory` is an unrelated plugin. Your memories stay in `$DSH_HOME/cc-memory/`. Remove the old package and install this one.
+- **The row id is now `cc-dream-memory`.** That plugin also used `cc-memory`, and when two rows share an id the later one silently replaces the earlier one. If your profile patch overrides `id: cc-memory`, rename it.
+- The interface title is now "Memory" / "记忆".
+- Fixed: in a clean web profile the Memory page could not reach its API, because `webServer` starts after the plugin. The API now registers when the service comes up.
+- Fixed: the memory prompt asked for absolute dates without giving today's date, so models guessed one and stored it in notes. It now states the date.
+- Fixed: a name written like a file name (`deploy-process.md`) no longer produces `project_deploy_process_md.md`.
+- Fixed: a Dream that only restyles a note's name (`deploy_command` for "Deploy command") keeps the original name.
+
+## 0.11.1 (2026-11-08)
+
+- 统一模型 save/update 的低置信和 confirm 审阅，force 只跳过重复拦截；词面冲突返回原记忆，不再创建第二条有效事实。
+- 待审更新、删除、改名和直接模型更新携带原文件哈希，在存储写锁内核对，拒绝覆盖并发编辑。
+- Dream 结构化引文逐新增行检查，保存本轮可核验的来源位置；旧操作级引文保持手动兼容并提示审阅。
+- 自动 Dream 语义改写和未经证明的删除转待审；大幅缩减也保留为提案；未处理提案不再被下一轮覆盖。工具引文保留独立 call/result 序号。
+- 保留现有 UI 冻结、纯 Markdown 存储与四工具预算；真实模型试点结果单独记录，不将回归测试当成效果证明。
+
+## 0.11.0 (2026-11-08)
+
+重写 Dream 的读取与证据链，补齐记忆侧的自动召回和删除。
+
+**Dream**
+
+- **不再抽样**：短会话整段进入；长会话切块，每块一次模型调用提取笔记（`dreamMapChunkChars`、`dreamMapMaxChunks`）。此前每个会话只抽样读 12KB，长会话的大部分内容进不了 Dream。
+- **收集阶段改为纯读取**：`gatherDreamInput` 不再写 state；读到哪里记在计划的 `reads` 里，只有 apply 成功才移动水位线。dry-run、失败、未批准的 review 都不会让会话被跳过。只读了一部分的会话下轮从断点继续。
+- **来源标签**：`[user]` 只代表用户手打的字；转发的长材料标 `[user-pasted]`（启发式）；宿主注入的内容和自动召回不进转写。
+- **证据检查**：读过会话时，新增内容须带能在原文找到的引用，否则丢弃；`user`/`feedback` 须引用 `[user]` 行。长会话笔记的来源和日期由插件按命中位置确定，不信模型自称。过度收缩的写入：自动 Dream 丢弃，手动 Dream 警告。
+- 记忆中指向已不存在路径的内容作为“可能过时”提示给模型。
+- `--focus <主题>` 与 `POST /dream {focus}`：指定这一轮优先关注的内容。
+- 重写 system prompt：不再沿用 Orient/Gather 四阶段结构，改用自己的措辞，并写明来源标签和证据要求。
+- 修复预检成本估算（此前按输入 0 字符估算，`block` 模式形同虚设）。
+- `apply-ops` 只应用部分操作，因此不再移动水位线。
+
+**记忆**
+
+- **自动召回**（`autoRecall`，默认开）：用户消息明显涉及某条记忆时附上它，词面匹配，不调模型，每条每会话一次。`/memory metrics` 显示次数。
+- `memory_update` 支持 `delete`（软删除，confirm 模式下进待审队列）。
+- `memory_read` 对超过 30 天的记忆附 `ageDays`/`staleness`。
+- 注入文本增加写法指引（Why/How to apply、绝对日期、引用前核实、可用 `session_search` 查历史）。
+- 预算提示和写入警告不再说模型没有删除手段。
+
+**评测**
+
+- 修复 v0.10.14 runner 的多处错误：`dreamInstruction`、`objective` 未定义导致运行即崩；Dream 工作目录错误；纯度检查无条件报错；开放工具场景下 C 看不到 B 的记忆；dev-09 实际没有测到 transcript；dev-06 的正则把引用的记录日期判为失败。
+- 新增 `--fake-model` 与 `test/eval-run-smoke`：不花钱跑完整编排。`--plan` 走不到这些路径，所以此前的错误没被发现。
+- contract 从 v13 升到 v14。
+
+**测试与文档**
+
+- 修复间歇性失败：临时目录清理与后台 metrics 写入竞争（ENOTEMPTY），改为带重试的清理。
+- README、ARCHITECTURE、eval 文档按当前行为更新；清理文档中的本机路径。
+
+**未验证**：尚未用真实模型跑评测，也未在真实宿主内跑过新 Dream。效果没有结论。
+
+**升级提示**：0.10.x 生成但未应用的 `plan.json` 不要再 apply，它来自旧的抽样读取，也没有经过证据检查；重新 dry-run 一次。
+
+## 0.10.14 (2026-11-08)
+
+评测装置与 identity/预算修复：
+
+- **manifest 覆盖所有场景文件**：`frozen-manifest.json` 记录 `scenarios.dev.json`、`scenarios.coding.dev.json`、`scenarios.dream-session.dev.json` 的哈希；`--plan` 也先过门禁，`--scenario-file` 不再绕过冻结校验。
+- **开放工具隔离**：编码场景工作区改到系统临时目录并单独 `git init`，不再暴露插件仓库/rubric/git 历史；客观检查在 agent 跑完后执行 `node --test`，并对比测试文件哈希（agent 前捕获）。
+- **记忆价值场景**：新增 dev-08（JSDoc 约定只在历史里，任务文本不提），通过 `sourceIncludes` 客观检查约定是否被应用。
+- **Dream transcript 路径**：新增 `scenarios.dream-session.dev.json`，C 组 `memory_eval_dream({sessions:true})` 要求 `sessionsReviewed>0`，不再只测 `noSessions` 纯整理。
+- identity：裸仓库/separate-git-dir/submodule 根含 `HEAD`+`objects` 也识别为 `git`，不再误报 workspace 共享警告；budget-notice 显示索引真实行/字节数（`totalLines/totalBytes`），不是注入采样后的数字。
+- 文档：ARCH 工具数与 Dream 输入描述、README/eval 隔离说明、本机路径与未核实事故编号清理。
+
+## 0.10.13 (2026-11-08)
+
+复核 43e309d 的 Dream 输入回归：
+
+- **时间线**：对话与工具证据统一按事件 order 排序；工具调用/结果成对采样（错误对优先、全 session 均匀），不再出现工具堆末尾、只留调用不留结果。assistant 文本与 tool 参数也做行首转义。
+- **corpus 水位线**：corpus fallback 读到的 session 会 `ensureSession` 后 `noteSessionRead`，成功 Dream 后可被 clearSessions 标记；`dreamProcessedSessions` 的 seq 在 normalize 后保留；新增两轮 + 状态重载回归测试。
+- **最近用户消息**：采样后若最近 5 条用户消息缺失，从最早一条开始拼接尾部窗口，保证摘录按时间排序且最近消息可见。
+- 验收指标改为结构指标（时间排序、最近 5 条用户消息、连续两轮不重复读），弃用真人发言占比。
+- 文档：ARCH 工具数 4、输入描述改为事件顺序/成对工具证据；README 去掉默认不删除与未核实事故编号、绝对路径；eval 去掉硬编码安装路径并移除版本库里的 `eval/rescores/`；dream prompt 注释不再称 mirror Claude Code。
+- 真实 dry-run（2026-11-08，备份 `.state.json` 后）：`ran=true`、`applied=false`、`sessionsReviewed=8`、`ops=4`、`inputChars=63010`；状态新增 8 个 session 的 seq/complete，`lastError` 清空；未 apply。
+
+## 0.10.12 (2026-11-08)
+
+复核 43e309d/v0.10.10 的剩余项：
+
+- **转义所有非用户文本**：assistant 文本与 tool-call 参数此前未转义，`\n[user] ...` 仍可伪造用户行；现在 assistant/tool-call/tool-result 统一行首转义，只有 host 生成的 `[user]` 行代表用户。
+- **探针不再满足 minSessions**：新增 `pruneProbeSessions`，在 minSessions 闸门前读取并删除 probe-only session；读不出的 session 保留。5 个 `Reply with exactly` 不再唤醒自动 Dream。
+- **超预算提示**：不再要求模型“重写索引”（模型无 merge/delete 工具），改为建议 memory_update、避免重复、由人类在 Memory 页（Dry run）或 /dream 处理。
+- 测试：`review-v18` 覆盖 assistant/tool-call 伪造、pre-gate 探针、隔离 dry-run；`npm test` 366 条，`npm run verify` PASS。
+
+## 0.10.11 (2026-11-08)
+
+复核 979e67b 的回归修复：
+
+- **字节预算**：`buildIndexHead` 在字节超限时按整行同时保留最早 head 与最新 tail，加截断标记，不再把末行切半；中文索引（约 176 字节/行）测试覆盖。
+- **confirm + rename**：`normalizeRecord` 保留顶层 `name`；批准时 rename 与 content/description 合并为一次 store 操作；工具 + 待审 + 批准全流程测试。
+- **worktree identity**：读取 `<gitdir>/commondir`，覆盖裸仓库、`--separate-git-dir` 与 linked worktree；不再出现同一仓库 SPLIT。
+- **memory_update 原子性**：改名与正文先校验后写入；失败不留半生效状态；仅大小写改名的同一文件不再报 CONFLICT。
+- **子代理**：`subagentWriteMode` 默认 `off`（看不见记忆就不写），注入默认不变。
+- **文档**：ARCH 工具数 8→4、版本 0.10.11；README/ARCH 预算默认值与“写入混入推断=已加规则、未验证”状态。
+- **评测装置**：新增 B0 对照组（相同工具、空记忆），报告比较改为 A→B0→B→C；新增 `eval/scenarios.coding.dev.json` 开放工具普通编码场景（测试阶段不锁工具，评分含改动文件）。
+- 真实重跑未执行：当前进程没有 `DEEPSEEK_API_KEY`，`eval/run.mjs` 会直接退出；已用 `--plan`/`validate` 验证装置，等 key 后重跑。
+
+## 0.10.10 (2026-11-08)
+
+**外部复核 979e67b 的发布阻断项修复**
+
+- **安全：工具输出伪造 `[user]` 行**：`dream-session-text.js` 对工具调用/结果做行首转义（`\[user]`），Dream prompt 明确 transcript 是 untrusted data，`user`/`feedback` 类型只能来自真实 `[user]` 行。
+- **水位线回归**：undo 会移除该批 watermark；`apply-ops` 部分应用不再把整批 session 标记为已处理；只有完整读完（未 truncation）的 session 才推进 `dreamProcessedSessions`，并按 `id + seq` 支持增量读取。
+- **工具证据**：只保留 `tool/call` 事件（assistant block 不再重复）；结果 id 从 `data.message.toolCallId`/`source.callId` 读取；保留 `isError` 结果并优先分配预算；工具预算改为全 session 均匀采样，不再只覆盖前 3.4%。
+- **探针**：去掉 `/m`（一行探针不再丢弃整个长 session）；探针从 `sessionsSince` 删除，不满足 `minSessions`。
+- **总预算**：`dreamInputMaxChars` 60k→96k，8 个长 session 按候选数公平分配（8×12k），不再只读前 4 个。
+- **文档/发布**：README/ARCHITECTURE 去掉“复刻”；修 README 表格错位与“删除关闭”错误；修 CHANGELOG 0.10.8 关于 README 的失实说法；`private` 移除；Dream prompt 首句不再照抄社区文本。
+- 子代理写入默认改为 `off`（看不见记忆就不写）；注入提醒之外，写入时也会在索引 80% 预算返回 warning。
+
+## 0.10.9 (2026-11-08)
+
+官方 memory 对照审计修复：
+
+- **Worktree 共享记忆**：`resolveProjectRoot` 解析 `.git` 文件里的 `gitdir: .../.git/worktrees/<name>`，worktree 归到主仓库根；同时归一化 Windows 盘符大小写（`C:\` 与 `c:\` 不再分裂）。
+- **预算对齐官方**：项目索引默认 200 行 / 25KB（原 100/8KB）；超限时注入最早 + 最新条目（不再只保留最老的行），达到 80% 预算时提前提醒模型优先 `memory_update`/合并。
+- **子代理默认**：`injectSubagents` 默认改为 `false`（官方主记忆不加载进 subagent）；写入仍由 `subagentWriteMode` 控制并写入文档。
+- **写入质量**：默认规则新增“区分用户原话与推断，推断/示例不得写成用户事实”；`memory_update` 支持 `name` 改名（保留 created/provenance，旧文件进回收站；confirm 待审批准后也执行改名）。
+- 文档修正：worktree 共享、预算、子代理默认、rename，以及与官方的已知差异（无自动召回/fact-check/instructions/独立 subagent 目录）。
+
+## 0.10.8 (2026-11-08)
+
+**Dream 输入审计修复（最严重：Dream 基本没读到真实对话）**
+
+- `extractSessionText` 现在只把 `source.kind === 'user'`（或无 source 的旧事件）当用户发言；`agent-instructions`、`runtime-context`、`skill-catalog`、`time-context` 等注入内容全部过滤，不再以 `[user]` 进入 Dream。
+- 会话文本纳入 **assistant 文本 + tool call/result 证据**（每个 session 工具内容上限 `dreamMaxToolChars`，默认 4000），不再只读首尾文本；session 上限默认从 6000 提升到 **12000**。
+- 新增**已处理水位线** `dreamProcessedSessions`：成功 Dream 后记录 session id；corpus fallback 不再重读已处理且未重新活跃的 session（此前 11-05 的 session 会被反复读取）。
+- 过滤探针/无真人发言的 session（如 `Reply with exactly: OK`）；退化数据仍保留在 skippedSessions。
+- 本次修复的验收改为结构指标：摘录按时间排序、最近 5 条用户消息都在、连续两轮不重复读已读完 session；不再用真人发言占比作为指标。
+- 定位说明：package.json 改为“实验性、可审计的 auto memory/Dream，受 Claude Code 启发”；README/ARCHITECTURE 当时实际未改（0.10.9 已改）。不宣传复刻或超过官方；与原版的差距写入已知限制。
+
+## 0.10.7 (2026-11-08)
+
+评估运行门禁与评分校准：
+
+- **门禁**：tool 发现失败（非零退出/EPERM/空列表）在首个模型请求前中止；frozen manifest（场景/rubric/插件版本/contract）不匹配即拒绝启动。
+- **运行有效性**：snapshot hash 不符、Dream 结果缺失或 sessionsReviewed≠0 → device-invalid，不参与比较；模型失败/超时按任务失败；judge 缺失/JSON 无效 → grading-missing，进入重评。
+- **纯逻辑行为测试**：新增 `eval/harness-lib.mjs` 与 `test/eval-harness.test.mjs`（发现失败、manifest 过期、快照/Dream 失效、评分缺失、成功门槛）。
+- **评分表述**：旧答案重评分改名“对 v2 约束的兼容性检查”，不再据此断言违反当时指令；新增 formatViolation / providedForbiddenContent 区分“提到禁词”与“实际提供操作”，格式违规单独记录。
+- 更新 frozen manifest（contract v13、0.10.7 与资产哈希）和 PILOT-REPORT 说明。
+
+## 0.10.6 (2026-11-08)
+
+评估装置修复（首轮试点的结论作废，仅保留为装置诊断）：
+
+- **工具隔离**：eval 每个会话禁用全部模型侧基础工具（保留 memory 工具与 executor），修复 A 组读取 evaluator 数据的污染；headless 探针验证只剩 4 个 memory 工具。
+- **B/C 快照分离**：`checkpoint-before-dream` / `checkpoint-after-dream`，测试前按组恢复并校验 sha256，修复 C 的 Dream 结果被 B 快照覆盖。
+- **纯整理 Dream**：`noSessions` 贯通 dream-input/dream/runtime/eval 工具，评估时 `sessionsReviewed` 必须为 0；非 0 记错误。
+- **评分冻结**：dev-01 变体 rubric v2（任务与评分一致），旧 v1 保留；`eval/rescore.mjs` 对旧回答匿名重评，旧评分不覆盖。
+- **无模型断言**：`eval/assert-harness.mjs` 27 项；`eval/freeze.mjs` + `eval/frozen-manifest.json` 冻结场景/rubric/版本。
+- 更新 `eval/PILOT-REPORT.md`（污染、C 恢复、rubric 歧义、口径修正；效果结论待重跑）与 `eval/README.md`。
+
+## 0.10.5 (2026-11-08)
+
+- **评估工具链（eval/）**：A/B/C 配对实验的 6 个开发场景、rubric、检查点协议、headless runner；`node eval/run.mjs`（真实模型）与 `node eval/validate.mjs`（无模型 dry-run）。
+- **eval-only 管理工具**：config `evalMode`（默认 false）为 true 时注册 `memory_eval_dream`，让 headless 评估可以在 C 组触发一次真实 Dream；正常 profile 不出现该工具，4 个模型工具不变。
+- 首轮开发试点结果与校准记录见 `eval/PILOT-REPORT.md`（n=1，仅诊断；未作为正式收益结论）。
+- 修复 runner 的按组隔离 memoryRoot、A 组不重复历史、测试产物纳入评分、judge 注入已知历史与材料、eval 工具返回 lossless 摘要。
+
+## 0.10.4 (2026-11-08)
+
+**关键修复：Memory Web UI 一直显示「页面在记忆插件加载前打开」只读横幅、Dream 按钮不可用。**
+
+- 根因：Host `webserver` 的 prefix 路由匹配规则是 `pathname === prefix || pathname.startsWith(prefix + '/')`；插件注册的路由多了一个尾部斜杠（`/api/cc-memory/`），导致真实 Host 上 **所有** `/api/cc-memory/*` 请求都不匹配、静默 404。此前的测试直接调用 handler，因此没有覆盖到真实路由匹配。
+- 修复：注册路径改为 `/api/cc-memory`（无尾部斜杠）；新增回归测试同时验证「prefix 必须能匹配 /status、/bridge」。
+- UI-FREEZE（用户批准范围：修复 Dream 不可用）：client.js 的 bridge 恢复逻辑由同步 XHR 改为 **异步 fetch**（`apply` 变为 async，DSH 客户端 loader 会 await），页面在全局 `__CC_MEMORY_API__` 缺失时从 `GET /api/cc-memory/bridge` 取回 base/token；可见 UI 文案/布局未变（Dream 命名保持不变），已重新冻结 UI 哈希。
+- 新增 client 测试：缺少注入 global 时成功从 /bridge 恢复 API 模式；测试 342 条。
+
+## 0.10.3 (2026-11-07)
+
+UI-FREEZE: 用户明确要求把功能从「整理 / Tidy」更名为 **Dream**（Claude Code 的 dreaming 语义），并修复 Dream 入口不可用。
+
+- **UI 更名（已重新冻结）**：Memory 页第二 tab 与全部可见文案从 Tidy/整理 改为 Dream；`client.js`/locale 哈希已更新（UI-FREEZE 批准来源：用户 2026-11-07 消息）。
+- **Dream 入口修复**：新增 `GET /api/cc-memory/bridge`（loopback + DSH auth 门禁，返回与 index 注入相同的 base/token）；client 在 `__CC_MEMORY_API__` 缺失时同步 XHR 恢复 API 模式，页面早于插件加载/桌面缓存注入缺失不再降级为只读。
+- **新增 `/dream` 短命令**：`/dream run [--dry-run]`、`/dream status`、`/dream apply`、`/dream history`、`/dream undo`（等价 `/memory dream …`），即使 UI 降级也能触达。
+- README/ARCHITECTURE 同步 Dream 命名与 `/dream`、/bridge 说明；测试 340 条。
+
+## 0.10.2 (2026-11-07)
+
+**UI 设计冻结**（用户明确指令）：
+
+- 冻结范围：`client.js`、`locale/en.json`、`locale/zh.json`、`icon.svg`。
+- 新增 `.ui-freeze.json`（规范化 sha256）+ `scripts/ui-freeze.mjs`（verify/re-freeze）+ `test/ui-freeze.test.mjs`（每次全量测试校验）。
+- 未获用户明确批准并运行 `node scripts/ui-freeze.mjs --update` 前，任何 UI 改动都会让测试失败；commit 需以 `UI-FREEZE:` 说明批准来源。
+- 新增 `npm run ui:verify` / `npm run ui:freeze` 与 [UI-FREEZE.md](UI-FREEZE.md)。
+
+## Unreleased
+
+Memory 页重做（client v4 UI）：
+
+- **三个标签代替 8 张堆叠卡片**：「记忆」（搜索 + 类型筛选 + 列表/详情，可新建、编辑、删除，待确认写入置顶）、「整理」（生成方案 → 逐条查看改动 → 应用所选 → 撤销）、「设置」（全局开关、记忆规则、回收站/备份恢复、存储位置）。
+- 统一的动作反馈：toast、两段确认、一次只跑一个动作；窄屏单列；亮/暗主题跟随宿主；输入框下的状态 chip 自带样式并显示待处理数。
+- 页面上移除：效果趋势、健康分、合并、文件历史、导入/导出、changelog 尾部（命令与 HTTP API 仍保留）；client 删除对应未使用的请求方法。
+- `GET /dream-history` 的条目新增 `undone`，已撤销的批次 `undoable:false`（之前会被当成可撤销）。
+- client 测试改为覆盖新 UI 的纯函数与 locale 键完整性；测试 333 条全绿，verify PASS。
+
+## 0.10.1 (2026-11-07)
+
+外部 review 修复（v12）：
+
+- **Bug 1 运行时开关不生效**：DreamEngine/MemoryStore 接受 live config provider，切换 on/off、user on/off 后已存在的 engine/store 立即生效，不再需要重载插件。
+- **Bug 2 confirm 可绕过**：writeMode:'confirm' 下 memory_save（含 force:true）与 memory_update 都进待审队列；approve update 保留 created/provenance。
+- **Bug 3 回滚丢并发写**：dream 失败回滚改为 touched-only + 应用后哈希校验，未触碰文件/被并发修改的文件不动；返回 conflicts，回滚前快照到 .dreams/<ts>-rollback/。
+- **Bug 4 lastPlan 指针被误清**：applyLastPlan 仅在 applied:true 时清计划；applyPending 统一返回 {applied:boolean}（锁冲突 {applied:false,error:'dream-locked'}）。
+- **Bug 5 bySession 泄漏**：agent/disposed 时 runtime.forgetSession 清理；LRU 上限 500。
+- **覆写历史**：模型 update/save 覆盖与 dream 写入前保留旧版本到 .history/<file>/（keepHistory:true，historyMaxPerFile:20）。
+- **user scope 可写**：memory_save/update 支持 scope:'project'|'user'。
+- **注入提示修正**：不再让模型执行 /memory dream run、不再要求 merge/delete stale、不暴露绝对记忆路径。
+- **其它**：memory_read 指标 best-effort；重复检查只读 ≤12 个候选 body；锁 stale 回收检查 pid 存活；dream 会话摘录改为头/中/尾三段抽样。
+- 测试 332 条；10 连全绿 + verify PASS；文档按当前行为重写（历史移入本文件）。
+
+## 0.10.0 (2026-11-08)
+
+v11 用户六步（第 1–5 步）：
+
+- **撤销 dream 数据安全**：meta 记录被触碰文件 sha256（apply 后）、created/rewritten/deleted/operations；undo 只处理这些文件，当前哈希不一致则整体拒绝（conflicts）；undo 前整体备份；索引由 reconcile 修正不覆盖 MEMORY.md；旧批次无 hashes → legacy-batch 只读。
+- **模型侧写入**：注入新增 When-to-save；强制规则（不存密钥/记忆不覆盖指令）不可被用户规则删除，用户规则追加在内置规则之后；写入策略放宽（短正文直接写、冲突/疑似重复改 advisory、只有高度重复拦截、低置信仅 confidence:'low'/confirm）；机密扫描分级 deny/warn（sk-proj/sk-ant/github_pat_/gho_/AIza/JWT/连接串/中文密码 → deny）。
+- **dream 真正整理**：prompt 改为保留仍然成立的事实、被取代状态直接替换；禁止版本号/测试数/提交哈希/行数/流水账/一次性事务；dreamAllowDelete 默认 true。
+- **桌面 API**：移除 tapIndex/.api-tap.log，改用 webserver/index-inject 结构化 row（kind:'global'），仅 owner peer 注入 token（peer 缺失 fail-closed）；桌面 Electron 会应用 global row，相对 base 经 dsh-app:// 转发并带认证 cookie。
+- **client**：降级 banner 文案准确化（不再承诺刷新必好）、命令模式待审写入入口。
+- 模型侧工具精简到 4 个（save/update/read/search，描述+Schema ≤3000 字符）、recall 排序并入 search（本次后续提交）。
+- 测试 313 条（第 1–5 步全部覆盖）；10 连绿 + verify PASS（以最终输出为准）。
+
+## 0.9.0 (2026-11-07)
+
+v10 P1 修复（恢复语义 / 编辑审计 / 检索 / 指标价值 / CC 互通 / 子会话 / 事务锁 / compaction 摘要）：
+
+- **恢复语义**：每次 apply/apply-ops 写 `.dreams/<ts>/meta.json`；新增 `runtime.undoLastDream` / `DreamEngine.undoLastDream`（恢复备份、新增文件移 trash、索引 reconcile、changelog）；`GET /dream-history`、`/memory dream history|undo`；UI Dream 历史时间线（legacy 批次只读）。
+- **编辑/合并/审计**：status/HTTP/命令新增 `writeFile`（POST /file）、`mergeFiles`（POST /merge）、`fileHistory`（GET /file-history）；UI Edit 表单、文件多选 Merge、History 折叠（provenance/changelog/planRefs）。
+- **检索**：store.search 升级（name/desc/body 权重、phrase bonus、recency、type 过滤、offset、score/snippets）；新工具 `memory_recall`；`GET /search`、`/memory search`；UI 搜索框。
+- **指标价值**：metrics 增 daily 桶（60 天）/adoptions/recordAdoption/dreams.quality；`GET /metrics?days=7` 返回 summary+trend+quality；效果卡 7 日趋势 + dream quality。
+- **Claude Code 互通**：新增 `src/import-export.js`（importClaudeMemory/exportClaudeMemory）；`POST /import|/export`、`/memory import|export`；UI Import/Export。
+- **子会话归属**：config `subagentWriteMode:'shared'|'off'`；off 时 subagent 写工具返回 `subagent-readonly`；status.subagentPolicy。
+- **事务一致性**：新增 `src/lock.js` `withFileLock` + paths.writeLockFile；store mutating 方法持跨进程写锁。
+- **compaction 记忆摘要**：compaction 刷新时注入 `<memory-digest>`（最近修改 top5 + 最多读取 top3，≤400 字符），config `compactionDigest:true`。
+- locale 288 键/语言；测试 282 条；verify PASS（60 JS / 30 test files）。
+
+## 0.8.0 (2026-11-07)
+
+v9 P0 语义层修复（5 个“信任”缺口）：
+
+- **写入策略层**：新增 `src/policy.js`（CJK/latin 相似度、同主题极性冲突检测、低置信判定）与 `src/pending-writes.js`（待审写入队列）。`memory_save` 新增 `force`/`confidence`，返回 duplicate/possible-duplicate/conflict/queued-review/allow；`memory_update` 跨文件检查；新增 `memory_refresh` 工具；`/memory writes|approve|reject`；HTTP `GET/POST /pending-writes`；`/status.pendingWrites`。
+- **项目身份/多记忆空间**：新增 `src/identity.js`（config.projectId > workspace 标记 `.cc-memory.json`/`.dsh-memory-project` > git root > workspace）；`paths.buildPaths` 支持显式 projectId sanitize；user scope 独立预算（`userIndexMaxLines:30`/`userIndexMaxBytes:4096`）；`/memory user on|off` + UI 开关。
+- **会话即时刷新**：`runtime.setSessionMode/sessionMode/refreshSession`；`injectionMode` 会话级 live 优先；`manual` 原因强制重建冻结快照；`POST /session-live`；`/memory refresh|live on|off` + UI pill。
+- **dream 触发/可见/阻塞**：新增 `src/readiness.js`（`dreamReadiness` 闸门与 nextEligibleAt、`memoryHealth` 0-100 分 + suggestions、`expireStaleProposal` TTL）；pending 提案 72h 超时自动归档，不再永久阻塞；`/status.readiness`/`healthScore`；UI 显示就绪/阻塞原因/健康度。
+- **预算与成本联动**：索引超预算注入提示「去整理」；健康度建议 over-budget/many-never-read/dream-overdue/pending-stale/non-git-sharing/rules-truncated；新增 `dreamCostMode:'warn'|'review'|'block'`（预检 block 不调 LLM；review 不应用转提案；block 不写记忆）与 `dreamMaxTotalTokens` 联动。
+- config 新增 `writeMode/policy thresholds/pendingProposalTtlHours/dreamCostMode/projectId/userIndex*`；UI 新增待审写入卡、Dream 就绪/成本、健康度徽标+suggestions、User memory 开关、Session live pill；locale 207 键/语言。
+
+## 0.7.0 (2026-11-07)
+
+v8：效果指标 + 成本展示。
+
+- **效果指标**：新增 `src/metrics.js`（`<projectDir>/.metrics.json`，跨进程锁 + 写前重读合并 + 原子写）；记录注入次数、每条记忆的读/写、search 次数/命中、dream proposed/applied/rejected/failed/appliedOps、最近成本；派生 Top read、neverRead、dream 接受率。
+- **埋点**：注入构建、`memory_read/save/update/search`、`/memory show`、`/remember`、dream 生命周期。
+- **暴露**：`/status.metrics`、`GET /metrics`、`memory_status.metrics`、`/memory metrics`、`/memory json.metrics`；Web 新增「效果」卡（6 格 + top/neverRead + 无数据提示）。
+- **成本**：plan/changelog/state/metrics 记录 `durationMs/inputChars/outputChars/usage`；Dream 卡与计划预览展示耗时/tokens；新增 `dreamMaxTotalTokens`（默认 0=off）软上限，超限 `costExceeded` + warning 仍应用并显示徽标。
+- **状态**：`lastDreamCostExceeded/lastDreamUsage` 进入 status；client `normalizeMetrics`；locale 157 键/语言（+24）。
+- **测试**：新增 `test/metrics-v8.test.mjs` 9、`test/dream-v8.test.mjs` 6，client 测试更新；全量总数见 verify 输出。
+
+## 0.6.0 (2026-11-07)
+
+v7 backlog：可靠性收口后的能力补齐。
+
+- **共用状态服务** `src/status.js`：`createStatusService(runtime)` 成为 HTTP 与 commands 的唯一状态来源（status/file/rules/toggle/delete/dream/backups/trash/restore），消除两套并行组装。
+- **Dream diff 与按条应用**：`runtime.previewPlan()` 返回逐条 before/after/changed；`runtime.applyPlanOperations({indexes})` 只应用选中操作（备份+回滚+reconcile+changelog）；HTTP `POST /dream {action:'preview'|'apply-ops'}`；命令 `/memory dream preview|apply-ops`；UI 勾选 + 两段确认。
+- **备份/回收站恢复**：`GET /backups`、`GET /trash`、`POST /restore`（整批或单文件，写 changelog + reconcile）；命令 `/memory backups|trash|restore`；UI「备份与回收站」卡。
+- **Provenance**：frontmatter 新增可选 `created`/`source_session`/`via`；tools/commands/dream 写入自动标注，update 保留 created；`/status.entries`、`/memory list`、UI 文件行展示。
+- **机密扫描**：`src/secrets.js`（8 类规则 + 高熵 base64），配置 `secretScan: warn|deny|off`（默认 warn）；写入/dream/rules 前扫描，deny 拒绝落盘、warn 带 warnings，excerpt 只留 12 字符。
+- **锁与成本**：人工 apply/apply-ops 现在持 `.consolidate-lock`（冲突 `dream-locked`）；plan/changelog/state 记录 `durationMs`/`inputChars`/`outputChars`/`usage`。
+- **客户端**：provenance 徽标、Dream 计划 diff 预览+按条应用、备份/回收站恢复卡；测试钩子 `window.__CC_MEMORY_INTERNALS__`；locale 133 键/语言。
+- **仓库/交付**：git 仓库、MIT LICENSE、GitHub Actions CI（Windows/Ubuntu × Node 22/24）、`npm pack` 校验、client 自动化测试入库。
+
+## 0.5.0 (2026-11-07)
+
+可靠性修复轮（按 review 反馈，未加新功能）：
+
+- **可等待卸载**：新增 `createMemoryPlugin()`，`dispose()` 会 `runtime.drain()` 等待后台写入；修复 `hardening-v5` 测试的 ENOTEMPTY 竞态，测试套件 155 条、连续 10 次全量运行全绿。
+- **静默 API 安全与稳定**：仅接受 loopback 来源；POST 校验 Origin；token 持久化 `~/.dsh/cc-memory/.api-token`（插件重载不再失效）；rules 写入追加 `.memory-rules.log` 审计（scope/source/bytes/sha256）。
+- **客户端降级可诊断**：API bridge 缺失/401 时显示明确 banner（区分「页面早于插件加载」与「token 轮换」）并提供「刷新页面」按钮，不再静默退回命令模式。
+- **不再错放记忆**：`workingDirectory.ensure` 返回空时该会话禁用记忆功能（不再回退 `process.cwd()`）。
+- **跨进程状态合并**：`.state.json` 每次写前在 `<state>.lock` 下重读磁盘并合并（多 Host 进程交错写不丢 sessions/counters）。
+- **中文检索**：`store.search` 增加 CJK bigram 分词，无空格中文查询可命中。
+- **UI 决策**：保留紧凑单页布局；记忆正文默认 Markdown 渲染并可切原文；运行时开关标注「全局」。
+- **tap 诊断**：`~/.dsh/cc-memory/.api-tap.log` 记录 index 注入次数，用于排查“页面仍降级”是页面/时序问题还是 Host 未走 tap。
+- **文档纠偏**：locale 实际 97 UI 键（JSON 99 = 97 + 2 meta）；README Web 视图描述与实际实现对齐；已知限制补齐多进程状态覆盖/来源字段/机密扫描/客户端测试/指标等未完成项。
+
+语义化版本。数据默认在 `~/.dsh/cc-memory`，与插件版本解耦；升级/回滚插件不会删除记忆数据。
+
+## 0.4.0 (2026-11-07)
+
+- **会话级冻结注入（默认）**：会话开始注入一次索引后冻结，compaction 时刷新；`memory_save`/dream/其他会话写入不再改动本会话注入。新增 `injectionMode: 'session' | 'live'`。
+- **预算收紧**：`indexMaxLines` 100、`indexMaxBytes` 8192（原 200/25600）。
+- **子会话开关**：`injectSubagents`（默认 true）；false 时 `parentSession`/`origin:'subagent'` 会话不注入。
+- **注入无效化来源**：`runtime.invalidateInjection(sessionId, reason)`（memory-write/config/rules）；冻结模式只响应 config/rules + compaction。
+- 注入文本使用可编辑的 `memory-rules.md`（project > global > 内置默认）。
+
+## 0.3.0 (2026-11-07)
+
+- **静默 HTTP API**：`/api/cc-memory/*`（token 注入页面 index），Memory 视图/状态 chip 不再走斜杠命令，轨迹不再新增 `memory · …` 行；无 webServer 时降级命令模式。
+- **运行时开关**：`~/.dsh/cc-memory/.plugin-state.json` 覆盖（enabled / autoMemoryEnabled / autoDreamEnabled），`/memory plugin on|off` 与 UI 开关即时生效、可逆。
+- **可编辑 rules** + **Memory 视图重做** + composer dock 状态 chip。
+
+## 0.2.0 (2026-11-07)
+
+- 外部 review 修复：截断文件禁写、unicode 文件名/冲突后缀、subagent 会话过滤与 prompt 权威规则、按 projectRoot 缓存、软删除 `.trash/`、索引 reconcile、dry-run 计划复用、apply 失败回滚、`/memory plugin` 语义、review reject、失败退避。
+
+## 0.1.0 (2026-11-07)
+
+- 首个版本：auto memory 索引注入、8 个 `memory_*` 工具、`/memory` 与 `/remember`、确定性 dream 引擎（闸门/四阶段/备份/changelog）、Memory Web 视图、locale/icon。

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 dsh-cc-dream-memory contributors
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -1,3 +1,208 @@
-# Temporary Holding Version
+<div align="center">
 
-This version is a temporary placeholder for this package. An operational version to replace this has been submitted for review and is awaiting a staged release.
+<img src="https://raw.githubusercontent.com/muuuuuuuuuer/dsh-cc-dream-memory/main/assets/icon.png" width="88" alt="">
+
+# dsh-cc-dream-memory
+
+**Claude Code-style auto memory and Dream for DeepSeek Harness.**
+
+Your agent remembers across sessions. Every change Dream proposes is one you can review and undo.
+
+[![npm](https://img.shields.io/npm/v/dsh-cc-dream-memory)](https://www.npmjs.com/package/dsh-cc-dream-memory)
+[![CI](https://github.com/muuuuuuuuuer/dsh-cc-dream-memory/actions/workflows/ci.yml/badge.svg)](https://github.com/muuuuuuuuuer/dsh-cc-dream-memory/actions/workflows/ci.yml)
+[![MIT](https://img.shields.io/badge/license-MIT-blue)](https://github.com/muuuuuuuuuer/dsh-cc-dream-memory/blob/main/LICENSE)
+
+English · [简体中文](https://github.com/muuuuuuuuuer/dsh-cc-dream-memory/blob/main/README.zh.md)
+
+</div>
+
+## Before and after
+
+Tell your agent something once, then ask in a new session. Same project, same model, same question. The only difference is the plugin.
+
+<p align="center">
+  <img src="https://raw.githubusercontent.com/muuuuuuuuuer/dsh-cc-dream-memory/main/assets/before-after.png" width="860" alt="Two answers to the same request. Without the plugin, the answer uses section headings and tells you to run the retired legacy-deploy.sh. With the plugin, it opens with the conclusion and risks and tells you to run make release.">
+</p>
+
+Without the plugin, the agent replied "Both noted" and promised not to recommend the old script, then recommended it in the next session. With the plugin, it saved two notes on its own and used them.
+
+We ran the second session three times on each side. The deploy step was `legacy-deploy.sh` in all three runs without the plugin, and `make release` in all three with it. The picture shows the first run of each. The project is made up, and its README still names the old script on purpose. This is one example, not a benchmark. See [Status](#status).
+
+## Install
+
+Requires Node 22 or newer and DeepSeek Harness 0.2.2-rc.1 or newer.
+
+```bash
+dsh plugin --profile web add dsh-cc-dream-memory
+```
+
+Restart DeepSeek Harness and start a new session. If `dsh` is not on your PATH, use `npx`:
+
+```bash
+npx @deepseek-ai/dsh plugin --profile web add dsh-cc-dream-memory
+```
+
+In the desktop app, open **Plugins → Add plugin** and enter `dsh-cc-dream-memory`.
+
+You can also install directly from GitHub:
+
+```bash
+dsh plugin --profile web add github:muuuuuuuuuer/dsh-cc-dream-memory
+```
+
+## Dream
+
+Notes go stale. Here, three sessions changed the facts while five older notes stayed as they were. A Dream read those sessions and proposed six changes, and all six were applied.
+
+<p align="center">
+  <img src="https://raw.githubusercontent.com/muuuuuuuuuer/dsh-cc-dream-memory/main/assets/dream-before-after.png" width="860" alt="The Memories tab before and after a Dream. Before: five notes, with two duplicates and stale deploy and freeze facts. After: four notes, with the duplicates merged, the facts corrected and the handoff format added.">
+</p>
+
+You can apply only some of the changes, and one command undoes the whole Dream.
+
+## The interface
+
+A **Memory** tab sits next to Chat in every session, and the status bar shows how many notes the project has.
+
+<p align="center">
+  <img src="https://raw.githubusercontent.com/muuuuuuuuuer/dsh-cc-dream-memory/main/assets/memory-tab.png" width="860" alt="DeepSeek Harness with the Memory tab open, listing four notes with search, type filters and a New button">
+</p>
+
+<table>
+  <tr>
+    <td width="50%" valign="top">
+      <img src="https://raw.githubusercontent.com/muuuuuuuuuer/dsh-cc-dream-memory/main/assets/dream-plan.png" alt="A Dream plan with six selectable changes, one opened to show its new text">
+      <br>
+      <b>Dream.</b> Open any change to read it, then apply only what you agree with.
+    </td>
+    <td width="50%" valign="top">
+      <img src="https://raw.githubusercontent.com/muuuuuuuuuer/dsh-cc-dream-memory/main/assets/settings.png" alt="Settings with switches for memory and automatic Dreams, and an editable list of what to remember">
+      <br>
+      <b>Settings.</b> Switches for memory and automatic Dreams, and the rules for what is worth saving.
+    </td>
+  </tr>
+</table>
+
+<p align="center">
+  <img src="https://raw.githubusercontent.com/muuuuuuuuuer/dsh-cc-dream-memory/main/assets/memory-light.png" width="680" alt="The Memories tab in the light theme">
+  <br>
+  <sub>It follows the host's light and dark themes. Every screenshot is real, from DeepSeek Harness, with a made-up project.</sub>
+</p>
+
+## Why this one
+
+**Bring your memories.** Notes are plain Markdown in a Claude Code-compatible layout: a `MEMORY.md` index plus one file per topic. Already have Claude Code memories? `/memory import` brings them over, and you can open every file in your editor.
+
+**Dream shows its sources.** Dream reads whole sessions, not samples. Each new fact has to quote the conversation, and a quote the plugin cannot find in the transcript gets the change dropped. `/memory dream preview` prints the quotes:
+
+```text
+[2] write feedback_handoff_notes.md (changed)
+    quote: "For handoff notes I want the conclusion first, then risks, with no headings."
+```
+
+**Nothing is final.** Dream only proposes a plan. You pick the changes, a backup is taken first, deleted notes go to a trash folder, and one command undoes the whole Dream. Automatic Dreams are off until you turn them on.
+
+## Try it
+
+Run these in a session.
+
+1. Tell your agent something worth keeping, or save it yourself:
+
+   ```text
+   /remember --type=project Release notes live in docs/releases.md
+   ```
+
+2. Start a new session. The `MEMORY.md` index loads once and stays frozen for that session. When a message clearly matches a memory, the plugin attaches that memory to the step.
+
+3. After a few sessions, make a plan. This changes nothing:
+
+   ```text
+   /memory dream run --dry-run
+   /memory dream preview
+   ```
+
+4. Apply what you agree with, and undo it if you change your mind:
+
+   ```text
+   /memory dream apply-ops 0,2
+   /memory dream undo
+   ```
+
+You can do steps 3 and 4 on the **Dream** tab of the Memory view too. See the [command reference](https://github.com/muuuuuuuuuer/dsh-cc-dream-memory/blob/main/docs/commands.md) for everything else.
+
+## Coming from Claude Code
+
+```text
+/memory import ~/.claude/projects/<your-project>
+```
+
+The import reads `MEMORY.md` and the topic files, and keeps their `name`, `description` and `type`. It skips files that already exist, and secret scanning still applies. `/memory export <path>` writes the same layout back.
+
+What is different here:
+
+| | This plugin |
+|---|---|
+| Consolidation | A JSON plan the plugin validates and applies, with backups and undo |
+| New facts from Dream | Must quote the transcript |
+| Automatic Dream | Off by default |
+| Recall | Word matching on names and descriptions, no model call |
+| Subagents | No injected memory by default |
+
+## Is it right for you?
+
+This plugin suits you if you want to read and correct what your agent remembers, and you work on the same projects for a long time.
+
+Look elsewhere if you need:
+
+- **Vector search or a hosted memory service.** This plugin has neither. Recall is word matching, so a rephrased question can miss. `@openviking/dsh-memory-plugin`, `@honcho-ai/dsh-honcho` and `dsh-tdai-memory` take other approaches.
+- **Approval for every single write.** `dsh-memento` is built around that. Here, ordinary saves are automatic and only uncertain ones wait for review. `writeMode: confirm` queues all of them.
+
+## Your data
+
+- Memories stay on your machine, under `$DSH_HOME/cc-memory/`. The plugin has no telemetry.
+- Memory text goes to your model provider as part of normal prompts.
+- Dream sends session text and memories to the provider you configured. The synthetic three-short-session demo used 6,500 to 11,000 tokens. One real-project batch used **149,984 reported total tokens and about 263 seconds**, then applied two memory writes and one index update. These are different workloads, not a typical-use estimate. See the [aggregate observations](https://github.com/muuuuuuuuuer/dsh-cc-dream-memory/blob/main/eval/REAL-WORKSPACE-OBSERVATIONS-2026-11-09.md).
+- Before paying for a dry-run, use `/memory dream estimate`, or review the input estimate shown when starting Dream in the interface. Estimation makes no model call; dry-run does. Actual total usage can exceed the rough input estimate. `dreamMaxTotalTokens: 0` means unlimited; set an explicit budget and `dreamCostMode: block` if you need the existing cost guard.
+- Writes that match common key formats are refused. This is a heuristic and will not catch every secret. See [SECURITY.md](https://github.com/muuuuuuuuuer/dsh-cc-dream-memory/blob/main/SECURITY.md).
+
+## Status
+
+**Experimental, and we do not yet know how much it helps.** DeepSeek Harness is itself a preview, and its plugin API can change.
+
+What has been checked:
+
+- The test suite runs on Windows and Ubuntu with Node 22 and 24.
+- The packed plugin was installed into a clean profile on DeepSeek Harness 0.2.2-rc.1. A full Dream ran there with a real model on made-up sessions: plan, preview, selective apply and undo.
+
+What has not:
+
+- **Whether memory improves answers in general.** The comparison at the top is one scenario built to show the difference. In a [small pilot](https://github.com/muuuuuuuuuer/dsh-cc-dream-memory/blob/main/eval/RELIABILITY-REPORT-2026-11-08.md), stored memory helped with a stable preference, failed a one-paragraph instruction like every other group, and gave a result on a user correction that we do not trust. Dream changed nothing in that pilot, so it says nothing about Dream.
+- **Long use on real projects.** We are looking for this feedback. If you try Dream on real work, please [tell us what it got right and wrong](https://github.com/muuuuuuuuuer/dsh-cc-dream-memory/issues/new?template=feedback.yml).
+
+Known limits:
+
+- A quote proves the words exist in the session. It does not prove the conclusion drawn from them is right, so read the plan.
+- Telling your typing apart from pasted text is a heuristic, and short pastes get through.
+- The interface comes in English and Chinese.
+
+## More
+
+- [Command reference](https://github.com/muuuuuuuuuer/dsh-cc-dream-memory/blob/main/docs/commands.md)
+- [Manual](https://github.com/muuuuuuuuuer/dsh-cc-dream-memory/blob/main/docs/manual.zh.md) and [architecture](https://github.com/muuuuuuuuuer/dsh-cc-dream-memory/blob/main/docs/ARCHITECTURE.md) (Chinese)
+- [How the evaluation works](https://github.com/muuuuuuuuuer/dsh-cc-dream-memory/blob/main/eval/README.md) (Chinese)
+- [Contributing](https://github.com/muuuuuuuuuer/dsh-cc-dream-memory/blob/main/CONTRIBUTING.md) · [Security](https://github.com/muuuuuuuuuer/dsh-cc-dream-memory/blob/main/SECURITY.md) · [Changelog](https://github.com/muuuuuuuuuer/dsh-cc-dream-memory/blob/main/CHANGELOG.md)
+
+## Contributors
+
+- [muuuuuuuuuer](https://github.com/muuuuuuuuuer) — maintainer.
+- [Claude](https://github.com/claude) — AI coding assistance through Claude Code.
+
+## Acknowledgements
+
+[DeepSeek Harness](https://github.com/deepseek-ai/deepseek-harness) was also used during development.
+
+## License
+
+[MIT](https://github.com/muuuuuuuuuer/dsh-cc-dream-memory/blob/main/LICENSE)
+
+This is an independent community plugin, not affiliated with or endorsed by Anthropic or DeepSeek. Claude Code is a product of Anthropic.