dsh-continual-evolve

<b>为 <a href="https://github.com/deepseek-ai/deepseek-harness">DeepSeek Harness</a> 提供有治理、可自进化的记忆层。</b><br> 模型提议，代码门禁，一个数据库落盘。

<p align="center">中文 | <a href="README.en.md">English</a></p>

全部记忆与技能住在一个中央 SQLite 库里（~/.dsh/evolve/memory.db，按工作区路径行分区）。会话开局注入它的索引，而插件的代码是字面意义的唯一写者——每条模型提案都要在一个事务内过机械门禁才会落盘。这里没有任何安全属性依赖模型自觉。

亮点

• 一个库，一个写者——全部状态住一个 SQLite 文件；只有插件代码能写它。
• 开局注入索引——本工作区的钩子作为单个 prompt section 注入，会话内冻结，按 User Profile / Project Meta / Project Memory / Feedback Memory 四组排列。
• 预算超了降级，不丢条——CJK 感知的 token 预算（默认 6000）：完整钩子行 → 只留 id 行 → 「其余 N 条」计数行。
• 两个工具——evolve_write 落记忆与技能；evolve_read 按 id 取正文、按关键词检索（trigram FTS，CJK 感知）。
• 提案制提取——按会话隔离的轮级自动化：无空闲计时器、便宜预检门、duplicate/no-change 预筛，每次跳过都记账。
• 内容质量自进化环——自有提示词、预算与账本；判词为改写／隔离／归档／仅建议；删除永不自动；默认试运行。
• 记忆分层——L0 跟人走，L1 跟项目走，L2 不进库；L0 只能经两次独立判定 + 30 天实习进入。
• 观测是读数，不是体感——代际自检、近 7 天注入→被读转化率、离线检索基线。
• 回滚靠账本——每次变更都留 before/after 快照，外加孤儿索引行与含密钥条目的巡检。
• 插件管理卡片——只读的库投影（搜索、预览）与全局 review.* 设置卡。

快速开始

# 从 npm（安装即激活——自带 bundle patch）
dsh plugin add dsh-continual-evolve

# 或从源码（首次 GitHub 安装需批准 allowBuilds 构建步骤）
dsh plugin add ZK-Andy/dsh-continual-evolve

装完或升级后，重启你实际在用的 profile（桌面端，或 dsh <profile>）。需要 Node ≥ 22.5（node:sqlite）；缺失时插件降级为 no-op 并在控制台告警。

没有命令要记——直接说：

「记住我做 review 用 oxlint，不用 eslint」  → evolve_write，过门禁落盘
「把这套做法存成技能」                        → 物化成 SKILL.md，重启后 skill 工具能发现
「所有项目都用」                              → 技能搬到全局分区

[!TIP] 重启后打开插件管理里的本插件页面：第一行对比「运行代 / 盘面代」，两者不同会标红并写明需重启；plugin_log 里有同一条 build-identity。

会话中途写入的记忆下个会话才可见——注入的 section 冻结以保 prompt cache。

工作原理

  输入  ──  「记住…」(evolve_write)  ·  会话轮次 (提取)
  门禁  ──  id 规范 · type · secret 筛查 · 64KB 上限 · Why/How 契约 · 单事务
  存储  ──  memory.db，按工作区行分区
  出口  ──  下个会话注入索引  ·  评审环（改写 / 隔离 / 归档）

开局注入

• 只注册一个 system-prompt section（order 400）：本工作区的索引，只含钩子（id、标题、描述截 20 字、可选「不适用」）；类型不逐行标注，由块内四组分组承担（组内行序 feedback > user > reference）。外加库路径与两段指南，并列按 id 稳定。
• 每会话只算一次并逐字节复用——prompt cache 持续命中；空 store 零 token。
• 预算按 token 计，CJK 感知（中文 1.5 token/字，其余 4 字符/token）。装不下分三档降级：完整钩子行 → 只留 - [id] 行 → （其余 N 条未展开…） 计数行。被裁掉的记忆仍能靠 evolve_read 捞回。

唯一写路径

• evolve_write(kind, …) 承接 create / update / delete（kind = memory | skill），技能另有 move-to-global。
• 门禁在一个事务内完成：id 规范、type 枚举、feedback 的 Why:/How to apply: 契约、secret 筛查、64KB 正文上限、可选 corrects 纠错链、可选 notWhen 不适用条件；记忆的 update 只改 active 行，已归档或已隔离的按状态拒绝（归档是历史、隔离待人工复核，要改只能重建）。
• evolve_read(kind, …) 按 id 取正文、按关键词检索：先按词组取 AND（trigram FTS，兜底 LIKE），再退 OR，中文片段按 3 字窗口展开。
• 按 id 取到的每份正文计一次查阅——这是存在心跳，不是有用证明。长期零查阅是删除候选，但剪枝始终人工。

提取

轨迹到记忆的那条轨，全程 extraction_log 可对账。

• 轮级且按会话隔离：agent/turn-stopping 调度该会话自己的边界，运行中只保留最新边界（合并，不排队）；compaction/start 与会话收尾触发 drain。没有空闲计时器。
• 一次运行读取游标之后的增量，过一道便宜预检门，用 FTS 取相似既有记忆作上下文，一次 LLM 调用的提案过同一套门禁。预检拒绝按 model-skip 消费增量；门不清则 fail-open 透传。
• 落盘前有确定性预筛：与既有正文全等的 duplicate、字段没变的 no-change 不进写门禁（原因落成 pre-screen: duplicate×N）。失败不推游标；每次跳过都记账。

质量评审

第二条后台轨，结构上独立：自有提示词、自有日预算（默认 100 条）、自有 review_log、无游标——只共享写门禁。

• 便宜门先判某条值不值得细看，批了才跑贵改写。
• 贵改写按内容质量打分并给出改写提案——记忆看归属 + 准确/可用/可复用/不重复/不过时；技能看触发精度/可执行完备/不重复，其中「可复用」按分区判。
• 判词四个出口：改写 · 隔离（隐藏、永不删除）· 归档（保留历史、不再注入）· 仅建议「这条该进仓库文档」。插件绝不写你的仓库。
• 新写即审，重审由事件驱动；日历只是兜底抽样（review.staleDays 是「最长免审期」，连续 keep 使其翻倍）。默认试运行。

分层与提级

…