变更日志
[1.28.1] - 2026-10-28
文档完善
- 明确调用宿主与会话来源独立:可按环境条件由 Qoder 等 Agent 运行相同扫描与分析流程,读取本机 WorkBuddy 等已支持来源;来源矩阵中的
unsupported不等于禁止该 Agent 发起扫描。 - 补充课堂调用提示、文件访问和增量数据根接续条件,区分合成演示脚本与真实宿主语义分析。
- 保留验证边界:Qoder 宿主完整实跑为
NOT_VERIFIED,其自身历史会话尚未正式接入;本次未变更适配器、脚本或账本格式。
[1.28.0] - 2026-10-27
公开化与修复
- 发行构建从指定 Git 提交读取完整通用文件允许清单,支持仓库根
self-evolve/与skills/self-evolve/两种布局;未知新增文件、非法路径、符号链接和已有输出均拒绝。 - 自用与公开使用同一套完整代码、文档、示例和测试;仅排除个人配置、运行状态与内部维护材料,不裁剪功能或另做精简版本。
data_root.yaml、core_skills.yaml、asset_owners.yaml和scheduled_tasks.yaml均作为本机配置,不入 Git 或发行包;旧调度示例默认关闭,填写时区并显式启用后再使用。无配置时给出可执行引导。- 通用文档与历史变更记录去除私人运行标识、会话规模及本机部署选择,保留功能机制、版本轨迹和验证边界。
- 修复课堂演示
--keep的临时目录在函数返回后仍被清理的问题;需要打开报告的演示使用--keep,后续命令显式绑定合成 home 和数据根。 - 工作方向分类迁入可选的本地 JSON 配置,周报与偏好提取共享通用默认;坏配置明确报错,不回显内容。
- 分别说明旧工作台的 SiliconFlow 请求、Claude CLI 模型通道与本机原文备份,以及启用旧周任务后的触发条件;默认扫描入口不调用这些能力。
- 可选 YAML 测试在缺依赖时明确跳过;需要 YAML 的隔离子进程保留父进程的依赖位置,兼容安装在用户目录的 PyYAML。
[1.27.2] - 2026-10-27
修复
- Codex 附件头与未闭合宿主上下文标签进入扫描适配:只有
## My request:之后的文本保留为用户原话,附件说明与宿主样板不进入user_excerpts;未闭合、跨类型错配或嵌套的宿主标签使该轮保守拒绝。适配器版本升至 14,历史记录自动重读。
验证
- Python 3.13 全量 346 项通过;Python 3.11 workflow/report/adoption/dialect 119 项通过。新增成对回归:附件头+真人请求分离(含纠偏措辞的附件文案作为纠偏引文拒绝、真人原话通过)、未闭合/嵌套/跨类型宿主块+真人文本整轮拒绝;轮中出现的附件头也会分离。
- 隔离的多 Runtime 实际扫描用于检查已知宿主和框架标记过滤及附件分离;这一结果不代表对所有来源或注入形式的覆盖。
[1.27.1] - 2026-10-26
修复
- 收紧“用户明确纠偏”的来源判定:扫描层只保留助手轮之后出现的用户轮,剔除 AGENTS 注入、命令包装、宿主提示、子代理/任务通知等框架噪声;真实 Codex
response_item用户轮保留并折叠相邻镜像,WorkBuddy/CodeBuddytype=message顶层role正确映射。适配器版本升至 13,历史成功记录自动重读;旧 packet 即使 evidence_id 相同也不能回灌过期 user_excerpts。 - 同一用户轮中嵌入的
<in-app-browser-context>/<external_codex_apps_open_page>宿主上下文整段剥离,## My request:宿主分隔标记去除;宿主免责声明不能作为用户原话,同轮真实用户文本仍保留。 user_excerpts不再截断为 6 条;每条限长并由每会话字符预算显式标记截断,避免活跃会话的后续真实纠偏被静默丢弃。纠偏引文必须自身包含明确的纠正/否定语义且逐字匹配保留的用户轮;纯脱敏占位符不能作为用户原话。
验证
- 最终 R4 回归:Python 3.13 全量 340 项通过;Python 3.11 workflow/report/adoption/dialect 113 项通过。复合用户轮回归验证:两句宿主免责声明拒绝,同轮保留的纠偏文本仍可导入;真实 Codex 与 WorkBuddy 存储方言均有正例。
- 隔离的多 Runtime 实际扫描用于检查已知框架噪声过滤;读取失败保留待重试,角色归类与噪声过滤不认证真人身份。
[1.27.0] - 2026-10-25
新增
- 分析合同新增可选
profile:按工作行为观察、用户明确纠偏、Agent 推断分层,绑定本轮证据、适用范围、置信度和复核条件;旧分析兼容,非法结构 fail-closed。 - 扫描层记录用户轮来源(
user_excerpts),用户原话在会话页与画像条目中单独展示。“用户明确纠偏”必须引用用户原话摘录,且该摘录能在所引证据的用户轮里逐字找到——任务指令、Agent 自述与索引摘录都不能冒充用户偏好。 - 本地 HTML 报告由六页扩展为七页,新增个人画像页。总览与画像页明确本轮发现、处理、送审和累计覆盖口径;低信息证据在会话页默认折叠为“本轮上下文”,可展开核对,可见计数只统计主证据区。
验证
- Python 3.13 全量 334 项通过;Python 3.11 报告/流程/采用定向 108 项通过。Python 3.14 全量受本机旧 PyYAML
collections.Hashable问题影响,沿用既有环境边界。 - 完成多 Runtime 扫描、分析导入与七页报告检查。浏览器回归覆盖页面布局、画像证据往返、筛选重置、复制降级与无 JS 手动复制;系统剪贴板权限与 Linux/Windows 真机仍未验证。
[1.26.0] - 2026-10-25
新增
- 为已导入建议登记稳定 ID、具体修订、接受/实施/验证结果与回执。采用记录独立保存,不迁移扫描 SQLite;报告生成新的只读快照,历史分析与 HTML 保留。
- Skill 页与复制工单展示采用状态和回执引用。“已登记验证通过”代表提交者登记的结果,不代表脚本执行过测试、安装或身份认证。
修复
- 跨会话声明要求至少两个独立会话引用,创建动作与创建层级保持一致;显式 null 和非法字段类型返回具名错误,省略可选字段仍兼容。
- 剪贴板与兼容复制抛出异常时也能展开手动工单;区分候选文件完成、安装识别和采用后的验证。
- 校正前轮任务状态及样例解释:产品画像需求单独追踪,不把无支持引用的产品想法包装成新 Skill 沉淀。
验证
- Python 3.13 全量 319 项通过;Python 3.11 采用链 18 项通过。独立审查补齐“旧分析已登记/未登记,展示升级后重放”反例,均拒绝旧修订恢复。
- 实际 CLI 登记、状态与六页快照通过,保留旧扫描库与历史产物;真实浏览器桌面/390px、DOM 筛选与重置通过。原生指针工具及系统剪贴板权限未验证,Linux/Windows 真机与真实目标 Skill 安装仍未验证。
[1.25.0] - 2026-10-22
新增
- Skill 沉淀页每条建议新增“复制采纳工单”:本地静态 HTML 优先使用 Clipboard API,file:// 受限时回退 execCommand,再失败展开可全选复制的工单;无脚本时 details 内文本仍可手动复制。
- 工单包含目标、字段、理由、修改点、脱敏证据、实施边界、验证与回执要求;one-off-context 明确先补独立证据或人工复核。复制工单是提示词,不是安装命令,页面仍不自动修改或安装目标 Skill。
验证
- 新增渲染回归覆盖复制按钮/无脚本工单、旧分析默认值、HTML 转义、one-off-context 警示与无绝对路径。
- python3.13 全量 293 tests / OK。
- 浏览器验证 Clipboard API、execCommand 降级和手动全选路径,检查页面布局、无远端资源及复制控件。
[1.24.0] - 2026-10-22
新增
- Skill 建议合同新增可选 proposal_layer(patch-existing / add-reference / add-template / add-script / create)与 evidence_strength(cross-session / single-session-correction / one-off-context):旧分析兼容导入,非法枚举 fail-closed;create 缺失时报告仅按 action 保守推断新建。
- Skill 沉淀页为每条建议显示建议层级、证据强度、匹配依据(证据条数与 Runtime、目标 Skill 库存命中)、单次上下文待复核提示;低强度建议仍可搜索和访问,不自动应用。
验证
- 新增旧分析兼容、字段渲染与非法枚举拒绝回归;隔离的真实来源样本用于扫描与导入检查,覆盖补 reference、补已有 Skill、新建 Skill 及相应证据强度。
- python3.13 全量 291 tests / OK;Python 3.14 全量失败为本机旧版 PyYAML collections.Hashable 兼容问题,与本次变更无关。
[1.23.1] - 2026-10-22
修复(由 dot 凌晨审计整理)
- 顶层
type=message+role的对话恢复未知载荷校验;仅已知 usage-only 元数据豁免,避免格式不认识却被记为 transcript/filtered。 - ADAPTER_VERSION 8 → 9,未变化但由旧 adapter 误过滤的输入重新处理;保留历史记录。
- 合成反例在旧 main 下出现 8 次断言失败;修后定向 61 tests 通过(public workflow、方言、载荷守卫)。未跑全量、真实用户来源、安装或课堂效果验收。
[1.23.0] - 2026-10-21
修复(真实来源抽样发现的读取失败)
- 推理块:助手回合只含
type=thinking块时被判为未知载荷,整个会话读取失败。提取器按设计丢弃该块,白名单同步承认这一形态(Claude Code 与 QwenWorkCN 常见)。 - 工具行误判:WorkBuddy/CodeBuddy 的
function_call行携带message={usage},此前被当成对话行判为未知载荷。 - 顶层 role 方言:WorkBuddy/CodeBuddy 用
type=message、顶层role和顶层content承载对话;提取器扩展识别,避免加载成功但文本为空。
新增
- QwenWorkCN 接入来源表(
~/.qwenworkcn/projects,与 Claude Code 同源信封)。此前登记为 unsupported。 - ADAPTER_VERSION 7 → 8:旧版误记的 failed/filtered 行在新版自动重读修正。
- 课堂讲义
references/21-teaching-demo.md与演示脚本references/22-teaching-demo-playbook.md;scripts/teaching_demo.py合成 7 类来源 + 2 个坏文件,在临时 home 与隔离数据根跑真实 CLI,供课前彩排(不写真实数据根、不触网、不调模型)。
验证
- 对多种 Runtime 的真实来源抽样检查修复前后的解析行为;空会话保留单独分类。
- 对真实来源运行隔离数据根的端到端对照,检查失败、增量与送审结果。
- 全量回归 278 tests / OK(273 + 5 项方言回归)。
[1.22.0] - 2026-10-21
修复
- 发行构建无条件排除
config/data_root.yaml、config/core_skills.yaml、config/asset_owners.yaml三个本地覆盖文件;即使旧分支仍跟踪这些文件,公开包也不携带个人路径或重点 Skill 配置。 - 本地配置退出 Git 跟踪后保留在自用工作区;发行清单显式登记排除项。
验证
- 新增发行构建回归:绑定当前 OID 构建公开包,断言三个本地配置既不出现在文件列表,也进入
excluded清单。
[1.21.0] - 2026-10-16
变更(批次 C R1 返修收口)
- SKILL.md 移除 homepage frontmatter 字段(私仓链接不作为公开分发地址;公开地址确定后统一填写);"Python 包(仅旧工作台)"标题改为"旧工作台 + 公开流程可选 YAML 配置"。
- 支持声明统一:SKILL.md 与 references/00 的 Python 版本统一为 3.11+(3.11 全量实测;3.10 未验证)。
验证(批次 C R1 收口)
- 中断恢复验证使用同步屏障和 SIGKILL,检查 interrupted 标记及剩余处理去重。
- 三安静条件实证:无变化+待分析=awaiting_agent 进包;全部处置后=no_pending_evidence 静默;坏会话=partial+failed 可见。
- 分析未完成重送审:dismissed 证据跨轮保留可再次进包。
- 最终报告浏览器回归(含处置状态+已核验候选展示)全 PASS(1455/390px、跨页证据、筛选、安装说明)。
[1.20.0] - 2026-10-16
新增(批次 C 出口返修 C-F1~C-F4)
scripts/build_release.py:发行物绑定工具——OID 绑定的 git archive、排除维护材料(TASKS/DECISIONS/RESULT 保留在维护源)、逐文件 sha256+manifest_sha256、homepage 显式覆盖(未传=保留并登记未公开)。- SKILL.md 支持声明对齐实测:Python 改 3.11+(3.11 全量 272 tests 实测通过;3.10 未验证);PyYAML 就近说明(自定义配置文件必需,缺=可执行报错);新增"平台与验证边界"节(macOS 本机验证、Linux XDG 未真机、Windows 未验、跨宿主/签名稳定性未认证)。
- references/20 ADAPTER_VERSION 同步 v7 并补 v5-v7 沿革。
修复
public_report.py处置状态行的 f-string 嵌套引号为 Python 3.12+ 语法,3.11 SyntaxError——改辅助函数,全脚本 3.11 编译与回归通过。
验证(批次 C 出口)
- 在默认与个性化环境验证扫描、独立分析、导入、报告及后续接续;检查中断恢复和浏览器跨页证据、筛选与安装说明。
[1.19.0] - 2026-10-16
修复(批次 B 第三轮返修 B-F3 调用证据/B-F4 三组缺口)
- B-F3(调用证据):使用隔离上下文的独立消费者分析冻结输入,覆盖完整处置、部分处置与证据可靠性;包外引用不进入导入版。
- B-F4 缺口1(同名旧决定授权新内容):候选生成改为提案身份绑定——target_skill 与内容指纹(proposal_fingerprint,与 store 同算法)双重匹配,同名不同内容的旧决定不授权新提案。
- B-F4 缺口2(结构合法但产物不存在):candidate_file 真实性核验移到导入时服务端——原始路径先核验文件存在+sha256 一致,核验结论(verified 布尔)入库;报告不含原始本机路径(脱敏合同),虚构路径/哈希核验 False 并如实显示"真实性核验未通过",保持"尚无安装包"。
- B-F4 缺口3(accepted 线端到端):全链实证——消费者 C3 提案(同内容指纹)commit(in-chat auto-accept,committed_accepted)→ generate_candidate 生成候选草稿(sha256/来源分析/证据绑定)→ candidate_file 注入分析导入 → 六页 skills 页显示"候选草稿已生成(导入时已核验产物哈希一致)"+哈希前缀+无原始路径泄露。
技术优化
- 新增回归更新为 R2 终版合同(服务端核验 verified/虚构路径如实说明/无路径泄露/结构错误拒绝),全量 272 项通过。
[1.18.0] - 2026-10-16
修复(批次 B 第二轮返修 B-F1 终版/B-F3 终版/B-F4 连通 + P2 随手修)
- B-F1(P1 终版):处置冲突检查移到报告发布/JSON 写盘之前——拒绝导入零新增产物(拒绝后目录文件集合不变,回归锁定);既有的一致修订行为保留。
- B-F3(P1 终版):按裁定完成三轮真正独立消费者分析——冻结 fixture v3(原四场景+重复副本+提示注入样本,manifest 留盘),三个隔离数据根(隔离消费状态)各扫一轮(3 selected/3 filtered),三次无旧上下文消费者分析输出留盘:C1 全处置(含"用户自述连续三次=单会话自述非独立观察"表述修正+副本同源理由+注入 dismissed)、C2 部分处置(安全审查视角仅处置注入,业务证据保留待下一轮)、C3 证据可靠性视角(副本 insufficient_material 待第二独立来源+create 提案)。覆盖裁定点名的重复副本/敏感注入/部分处理场景与逐类理由。
- B-F4(P1 连通):新增
scripts/generate_candidate.py——从已导入分析+proposal_store 决定记录生成外置候选(accepted→候选草稿含 sha256/来源/证据绑定;rejected/observe→决定说明 JSON;无决定记录不生成);分析合同新增可选candidate_file(path+sha256 结构校验 fail-closed);Skill 沉淀页如实展示"候选草稿已生成(待人工审阅,非安装包)"或保持"尚无安装包"。端到端演示走通:C3 create 提案→commit→observe 决定→候选说明文件生成(隔离数据根)。 - P2 随手修(非阻断):历史 sent 集合读取对顶层非映射/坏 JSON 的历史包跳过并结构诊断,不再让 AttributeError 冒泡。
技术优化
- 新增 2 项回归(冲突拒绝零新增产物/候选文件往返与校验),全量 272 项通过。
[1.17.0] - 2026-10-16
修复(批次 B 审计返修 B-F1~B-F4 + P2 状态说明)
- B-F1(P1):处置为追加式账本状态——已消费证据不可被后续分析修订撤销/改判,冲突修订以
disposition_conflicts_reviewed拒绝(历史分析与消费记录保留);导入返回值以账本现状(含历史消费)为准,与下轮送审队列一致。 - B-F2(P1):送审轮转——曾在旧包中且未消费(dismissed/未处置)的证据在包选择中后移,新证据优先进入;dismissed 证据跨轮保留可见待人工,不再永久阻塞新证据(容量+1 跨轮推进回归锁定)。返修中连带抓获并修复 run_id 被历史 run 循环变量遮蔽导致报告写入旧 run 目录的实现 bug(spy 实证两轮同 run_id)。
- B-F3(P1 验收缺口):冻结合成 fixture(四场景:有价值发现/低价值/单次偏好/证据不足)三轮扫描全绿(初筛分型正确、轮2/3 全 unchanged),无旧上下文消费者分析四份实际输出留盘(A=analyzed 消费对账、B=安静路径、C=一致修订、D=冲突修订拒绝),供上游对照保留/剔除理由与来源。
- B-F4(P1 交付缺口):端到端资产闭环演示(全部合成、明确标注)——三份独立提案走 commit→decide→applied→verify 全生命周期:accepted(in-chat auto-accept 于 inventory resolved 后生效,applied+verified 后半圈入账)、rejected(理由入账)、observe(暂不决定);resolved 门如实呈现(未 resolved 时接受 fail-closed)。
- P2 状态说明:处置状态节区分"已分析/待补证据/低价值待人工/未声明"四类计数,待补证据标注等待条件(材料补齐后新扫描生成新证据再送审)。
技术优化
- 新增 4 项回归(修订冲突拒绝/一致修订+账本现状对账/轮转容量+1 跨轮推进/dismissed 跨轮保留可见),全量 270 项通过。
[1.16.0] - 2026-10-16
新增(批次 B:UP-03/UP-04)
- 逐证据处置合同:分析输出新增可选
evidence_dispositions(analyzed/dismissed/insufficient_material + 脱敏 note),只有 analyzed 与 insufficient_material 在导入后不再送审;dismissed 与未声明处置的证据跨轮保留待分析/待人工——空分析、部分分析绝不静默消耗整包证据;处置结构错误 fail-closed 拒绝导入。导入返回evidence_consumed/evidence_retained对账值。 - 深度分析页新增"证据处置状态"节:已处理/保留待分析计数、dismissed 与未处置证据逐条可见(含 note),仅带处置字段的分析显示(旧格式分析不受影响)。
技术优化
- 新增 5 项回归(全量处置消费/部分处置保留/dismissed 不消费/空处置不消耗+结构错误/处置状态页渲染含旧格式无节),全量 268 项通过;references/18 分析合同补处置字段文档。
[1.15.1] - 2026-10-16
修复(R4 审计收尾 A-SQL-SRC-01-R4-DELETED/A-SQL-SRC-01-R4-REGTEST)
- 删除竞态(P2):任务在发现后被软删/移除时,快照查询空结果从
[0]IndexError 改为具名source_changed_during_read——整轮 partial、正常会话继续、失败对象入账(新增集成回归:discover-then-delete 场景三方断言)。 - WAL 回归测试严格化(P2):显式启用 WAL、关闭自动 checkpoint、连接保持打开、checkpoint 后提交仅存 WAL 的哨兵记录;新增检测力证明(独立 immutable 连接确认主库看不到哨兵);删除恒真断言。
技术优化
- R4 四项行为修复(快照查询/预检副本/孤立伴生/dict text)全部 ACCEPT 保持;全量 265 项通过。
[1.15.0] - 2026-10-16
修复(第四轮审计返修 A-SQL-SRC-01-R3-WAL/A-F1-R1-R3-NOSIDECAR/A-SQL-SRC-01-R3-ORPHAN/A-F3-R5)
- A-SQL-SRC-01-R3-WAL(P1):源库查询改为临时副本即查询对象的一致快照;immutable 直连可能漏掉仅存在于 WAL 的已提交数据,且跳过活动源库的锁与变化检测;快照后复核源文件指纹(size+mtime_ns),变化报 source_changed_during_read 可重试。
- A-F1-R1-R3-NOSIDECAR(P2):无伴生的 WAL 模式主库在原地 ro 打开后仍会创建伴生——账本预检无例外全部走临时副本(副本内 WAL 最新内容仍可读到),拒绝路径对原件零字节动。
- A-SQL-SRC-01-R3-ORPHAN(P2):孤立伴生(主库缺失+WAL/SHM 在)显式 read_failed,不再冒充"未发现"。
- A-F3-R5(P2):字典 text message(
{'message':{'type':'text','text':…}})按提取器同套判定放行,不误拦;adapter 升至 v7。
技术优化
- 第四轮上游反例全部转合成回归(+4 项:WAL 独有提交可见/无伴生不变/孤立伴生失败/dict text 提取),全量 264 项通过。TOCTOU 边界:自家账本由 scan.lock 串行化协作写者,锁外替换未覆盖;生产源库以快照内一致性和变化检测覆盖。
[1.14.0] - 2026-10-16
修复(第三轮审计返修 A-F1-R1 终版/A-F1-R2/A-SQL-SRC-01/A-F3-R1 终版/A-F3-R4)
- A-F1-R1(P2 收口):非零主库预检改为临时副本校验(有伴生时)或原地只读连接(无伴生时,无法产生副作用)——拒绝路径对主库/WAL/SHM 字节与存在性零变化(探针实证);正常 WAL 中最新已提交内容在预检副本中仍被读到。
- A-F1-R2(P1):主库缺失但存在 WAL/SHM → 文件级拒绝"疑似崩溃现场,保留原文件不自动重建"(此前被当首次初始化、新建主库并删除原 WAL);新用户定义收窄为相关数据库文件全部不存在。
- A-SQL-SRC-01(P1):ZCode 源库读取统一走
_sqlite_source_open——危险形态(主库缺失/零字节+伴生)不打开,按来源失败记账;正常形态带伴生经临时副本预检后 immutable 直连。 - A-F3-R1(P2 终版):载荷白名单与提取器逐分支对齐——未知 type 块(future_text/image 等,提取器实际静默丢弃)判未知载荷显式失败,不再"显示成功但内容看不见"。
- A-F3-R4(P2):
message为字符串是可提取合法形态(提取器 message 优先规则),不再误拦;adapter 升至 v6 使 adapter 5 误记对象重读修正。
技术优化
- 第三轮上游反例转为合成回归(SHM 零副作用/主库缺失保留/ZCode 源库/future_text/string message);全量 260 项通过。
[1.13.0] - 2026-10-16
修复(第二轮审计返修 A-F1-R1/A-F2-R1/A-F3-R1/R2/R3)
- A-F1-R1(P1):拒绝路径不再破坏伴生 WAL——实测 mode=ro SQLite 打开零字节主库也会触发恢复删 WAL,改为任何 sqlite3 连接前的文件级检查拒绝零字节主库+未合并 WAL/SHM;结构预核验全部经只读 URI 连接完成,全部六表列结构纳入核验(runs/run_sessions/analyses/reviewed_evidence 错列同样拒绝)。
- A-F2-R1(P2):skill_sources 假值(false/0/[]/{})类型检查先行,不再被空值跳过静默禁用来源。
- A-F3-R1(P2):载荷白名单按提取器实际能力重写(
_content_extractable镜像 extract_message_text/extract_codex_text 可理解形态)——旧方言未知 list 项、嵌套 content dict、纯 type 行、Codex 未知 message 载荷均显式失败;带 type 键的已知/未知媒体块(如 image)与正常文本/工具块行为保留。 - A-F3-R2(P2):adapter 升至 v5,旧版误记的 filtered 对象在新版重读并修正。
- A-F3-R3(P2):共享读取器传播打开失败后,dream_sweep recent 与 backfill 两消费循环补逐会话 OSError 兜底——单对象失败可见(stderr+计数)、其余对象继续(legacy 对照重放实证)。
技术优化
- 第二轮上游反例全部转为合成回归(+5 项),全量 260 项通过;WAL 保留/假值拦截/升级重读/legacy 对照四组上游探针逐一重放实证。
[1.12.0] - 2026-10-16
修复(上游审计返修 A-F1~A-F4)
- A-F1(P1):既有账本零写入核验补齐——同版本但缺业务表、sessions 列结构不符一律拒绝(缺表/错列写入诊断);零字节主库带伴生 WAL/SHM 不再被当作新用户初始化(崩溃未 checkpoint 场景);此前"只有 meta 表"的库会被自动补建全部业务表的反例已封死。
- A-F2(P1):存在但无法解释的配置绝不静默回退——data_root.yaml 损坏/顶层非映射/值非字符串/相对路径/缺 PyYAML 时
assert_runtime_ready首先拦截并给可执行诊断,不再把账本静默切到平台默认根重扫;core_skills.yaml 的 skill_sources 结构错误(非映射、值非字符串)与python -S缺解析能力同样报错,不静默丢个人来源。修复中连带发现并纠正_DATA_ROOT_CONFIG_ERROR全局初始化晚于求值导致错误被覆盖为 None 的实现 bug。 - A-F3(P1):JSONL 读取器打开失败(权限/IO)不再返回空统计,向上传播按 failed 分类(PermissionError 入账、恢复权限后按对象重试成功);键形态认识但 content 为不可解析新结构时抛
unsupported_message_payload显式暴露,不再静默过滤成 metadata_only。已知纯工具记录(tool_use/tool_result 块)的正确过滤保留。 - A-F4(P2):空会话计数合同统一——首次处理记 new+empty+filtered 且与 run_sessions.outcome 对账,修订后记 updated,未变跳过 unchanged;本轮统计、对象账本、累计计数三方一致。
技术优化
- 上游探针转为可维护合成回归(+6 项:部分结构库、错列库、零字节+WAL、无读权限、未知载荷、空会话计数对账),全量 255 项通过。
[1.11.0] - 2026-10-16
修复
- 账本打开顺序加固:既有 SQLite 文件在任何建表 DDL 之前完成 sqlite_master/meta/schema_version 三重核验(无版本行的外部库同样 fail-closed),未知/外部结构的账本字节不动、不被
CREATE TABLE IF NOT EXISTS写入。
改进
- 补齐增量与恢复合同的对象级测试:三轮合成场景(未变/追加/新增/坏格式→修复)、同大小改写由 stat 修订捕获、ZCode 读取中修订变化 fail-closed、文件移动新对象+历史保留+session_ref 去重、来源目录消失与复现的行数守恒;references/18 补写未知库零写入保证与旧 session-summaries 的后续接续方式(对象级来源绑定、显式导入,未实现前并行保留不冒认)。
技术优化
- 新增 5 项回归,全量 249 项通过;全程隔离数据根验证,不依赖修改生产库。
[1.10.0] - 2026-10-16
改进
- Runtime 适配升级为 v4:识别 Claude 历史顶层转录的
role+content、type+content方言与纯tool_use会话(此前误报 unsupported_jsonl_schema);零行 JSONL 与空 Gemini 会话分类为empty_session(记账 filtered、报告显示"空会话"),不再污染失败统计或拉低来源状态。 - 新增
references/20-runtime-support.md支持矩阵:各 Runtime 存储/消息结构/完整性标记/空会话与失败分类、ZCode 完整消息探测结论(cli/log 仅遥测、exec 仅工具输出、checkpoints 清单加密——授权范围内无完整源,保持索引摘录降级)、未接入平台的显式补充来源方法与去重口径;SKILL.md 增加引用。
技术优化
- adapter 版本升级使此前 failed 的历史会话在修复后自动重读,无需清账本;新增 4 项 adapter 回归(旧格式正例、纯工具回显反例、空 Gemini、零行文件),全量 244 项通过。
[1.9.0] - 2026-10-16
改进
- 实际本地配置不再入 Git:
config/data_root.yaml、config/core_skills.yaml、config/asset_owners.yaml退出跟踪并加入忽略规则(本地副本保留);config/scheduled_tasks.yaml作为随 Skill 发布的任务注册表保持跟踪。新用户检出即用:缺省走平台默认数据根与默认 agent 目录来源,从.example.yaml复制填写即可恢复个性化。
修复
- 修正
self_evolve_paths数据根文档字符串中的配置文件名笔误(core_skills.yaml → data_root.yaml)。
技术优化
refresh_skill_inventory对损坏的 core_skills.yaml 从静默返回空改为可执行报错(rc=2 提示修复方向),缺文件仍走默认来源;新增 6 项配置缺省/覆盖/损坏回归(数据根三层优先级、inventory 缺省与坏配置),全量 240 项通过。- SKILL.md 与
references/02-core-skills-yaml.md就近说明实际配置不入 Git、复制.example填写与缺省行为。
[1.8.1] - 2026-10-16
改进
- 报告改为总览与五个专题二级页面:深度分析、Skill 沉淀、会话与证据、扫描与覆盖、运行说明;统一侧栏、面包屑、当前页状态和窄屏导航,首页突出关键结果与下一步。
- 分析和 Skill 建议可跨页定位并自动展开具体证据,会话页可返回原发现/建议;补充来源、完整性、建议类型和初筛筛选、搜索、空结果与重置。
- 全部页面保持同目录静态 HTML、相对链接和零远端资源;先写齐子页,再发布总览。重复导入校验完整文件组,缺页或内容变化时失败退出,旧报告继续保留。
验证
- 增加多页内部链接/锚点、搬移目录、内容边界、缺页/篡改拒绝与发布中断回归;增加可复用的真实浏览器脚本。执行结果见 TASKS.md。
文档完善
- 依据用户澄清将更新计划升为 r2:只维护同一
self-evolve源码、功能与版本,新增先行个性化配置/忽略规则任务;分发改为同源产物,补配置兼容、双配置路径及已跟踪文件检查,执行尚未开始。 - 在 TASKS.md 建立公开适配下游更新计划 r1,固定 1.8.1 实现基线,按来源/状态、分析/资产、分发/周期/验收三批衔接;保留单一任务源和完整开工说明,计划本身不代替派发或发布授权。
[1.8.0] - 2026-10-16
新增
- 增加公开版工作流:多 Runtime 只读发现与适配、SQLite 持久增量账本、当前 Agent 分析包及校验导入、自包含 HTML 报告;无需独立模型 API Key,核心仅依赖 Python 标准库。
- 支持 Claude/Codex JSONL、WorkBuddy/CodeBuddy JSONL 和 trace、Gemini JSON,以及 ZCode 只读任务搜索索引摘录;明确索引摘录与完整对话的差别,其他 Runtime 显示未接入格式或实际覆盖错误。
- 保留初始化时间、来源配置、扫描轮次、逐输入修订、失败与历史报告;未变跳过、追加重读、失败可重试、预算回填、中断识别、跨来源副本合并;已发现的存储根可跨 Runtime 环境复用。
- HTML 展示覆盖/初筛、Agent 全面分析、证据、Skill 升级/新建建议与人工安装指引;新 Skill 没有真实包时不生成下载链接。分析绑定当前包及本地轮次,拒绝篡改、未知引用和已被替代证据。
改进
first_run.py默认切换到无独立 Key 的公开版采集/报告入口,不再自动调用旧云端偏好分析;旧工作台与状态继续保留,详细合同移入兼容参考。- 入口按公开扫描、当前对话沉淀和历史排障分层;补充首次初始化与每周定时 Agent 调用提示词,区分采集完成、分析完成、部署和真实周期触发。
- 具体业务文书标题保守隔离;默认不复制原文,脱敏后逐字段转义展示,报告没有外部资源或安装/执行按钮。
验证与边界
- 新路线验证包括增量、失败/中断恢复、来源记忆、去重、预算、隐私、证据绑定和 CLI;完成真实来源小批次试跑与网页交互检查,证据见 TASKS.md。
- 这是通往公开发布的首批候选:更多 Runtime、干净分发包、完整消息格式与多轮语义质量仍待后续验收;未公开发布,未部署每周任务。
[1.7.5] - 2026-09-23
文档完善
- 更新 Review Inbox 候选所引用的 Hermes 桌面插件开发 Skill 名称;原账本和人工决定边界不变。
[1.7.4] - 2026-09-23
文档完善
- 登记 Review Inbox 的 Hermes 插件化候选,并固定认证、隐私门控、revision 与人工决定账本的迁移边界。
[1.7.3] - 2026-08-11
新增:首次一键引导 first_run.py
新人跑一条命令完成全部初始化 + 自动开 panel,解决「首次要跑 5 个命令才看到东西」的痛点。
scripts/first_run.py:依次跑 refresh-skill-inventory → nightly-dream-sweep(索引 14d)→ weekly-iteration-report(周报)→ weekly-workmode-analyze(偏好)→ panel --open(浏览器自动开)- 通过
scheduler_run --task <id> --run-now --trigger external跑各 task(COMMAND_SPECS 白名单 + scheduled_tasks 参数,不重复维护、不绕过安全边界) - workmode 需
SILICONFLOW_API_KEY,无则该阶段降级(extract 仍产 packet、returncode 0),其余阶段正常;末尾提示配 key 补全 --no-panel不自动开 panel;--skip <task-id>跳过某阶段(可重复)references/00第 6 步指向 first_run(替代散步骤)
[1.7.2] - 2026-08-11
升级:panel sidebar 布局 + 全 dashboard 统一 + 暖灰赤陶配色
按 content-registry dashboard.html 完整重做 panel 视觉/信息架构,从顶部 tab 列升级为 sidebar 布局,所有 view 统一 dashboard 设计系统。
- sidebar 布局:左侧 238px 深色 sidebar(品牌 + 6 nav + 副信息 + 底部)+ 右侧主区;nav 切换
.view带 reveal 动画 + history hash 持久 - 全 dashboard 统一:总览/Review/偏好审阅/Cron/Logs 全部用
.d-*组件(metric 卡 / paper-panel / d-table / d-badge / d-btn);沉淀报告沿用.sed-*;旧蓝白.card/.grid/.tab弃用 - 暖灰 + 赤陶配色(和 info-evaluator 米色+moss 区分):sidebar 深棕灰
#3d3530+ 主区暖灰#efece8+ 主色赤陶#a24f36+ 琥珀/暖灰辅 - 完全自包含(CSS/JS 内联,CSP
default-src 'none'),装 skill 跑panel.py即得同款 dashboard
[1.7.1] - 2026-08-10
升级:沉淀报告 tab 完整 dashboard 设计系统(参照 info-evaluator)
按 content-registry dashboard.html 的视觉/信息架构完整重做沉淀报告 tab,从简陋卡片升级为成熟设计:
- 设计系统(.sed-* 局部 CSS,不污染其他 tab):米色(
--sed-paper/--sed-surface)+ moss 绿(--sed-moss)+ serif(Songti SC/STSong)+ 14px 圆角 + 阴影 - Hero 顶部:渐变米色 + serif 大字 + 右侧 3 metric(总数 / 本周新增 / 类别)
- Subnav 子导航:kind 切换 pill(全部 N / iteration N / deep-analysis N / ...)
- Toolbar:搜索框(标题/摘要)+ 显示计数 + sort 切换(最新 / 最早)
- lib-card 报告卡片:左侧 kind 缩写(moss 绿 serif)+ 右侧标题/2 行摘要/时间·大小
- paper-panel 详情面板:点击卡片展开完整 md 渲染(H1/H2/H3 + 列表 + blockquote + 表格 + 段落 + 粗体 + 代码 + pre)
- 简易 md→html 渲染器
renderMd(text):前端 escape + pipe table + list + blockquote + 段落合并
iteration 周报 5 章节(专注度表格 + 归因 sample 列表)现在直接可读,不再 <pre> 源码。
[1.7.0] - 2026-08-10
新增:沉淀报告统一到 panel(统一审阅工作台第一步)
review/inbox/ 下的脱敏 md 报告(迭代周报 / deep-analysis / 根散落)在 panel 第 4 个 tab「沉淀报告」卡片式展示,解决「手动翻 md」痛点。参照 info-evaluator 运营布局(README 单一入口 + SKILL 权限边界 + dashboard metric/列表)。
references/17-sediment-reports.md:沉淀报告运营说明(来源/安全/单一收集入口/与 workmode 边界)render_panel.collect_review_documents(kind, sort, limit):加 metrics(total/this_week/by_kind)+ kind 过滤 + mtime sort;metrics 全集统计不受 limit/kind 影响panelGET/api/review-documents:加 query parsing(?kind=...&sort=...)- JS
renderDocuments:顶部 metric bar + kind 过滤按钮(内存即时切换)+ 卡片列表 +<details>展开全文 DEC-050:沉淀报告统一到 panel(单一权威入口 + 单一权威源原则)
边界
- 沉淀报告是阅读视图,不做决定;决定类用 Review Inbox / 偏好审阅
- 校准维度(报告标记提取准/不准 → 反馈进账本)留 1.7.x 第二步
[1.6.0] - 2026-08-10
新增:工作模式偏好账本 + 可视化审阅前台
Self Evolve 内部新建工作模式偏好子系统(维度 = focus/correction/sediment/recurrence),和 info-evaluator 的内容评分偏好(content_value/selection_capacity)分家,各自单一权威源。详见 DEC-049。
scripts/workmode_extract.py:从 session-summaries + dream_sweep 聚类提炼工作模式证据包(复用 iteration_report 归因常量,不重构报告),按 (scope, sub_topic) 聚成跨 ≥2 session 的 cluster,产出runtime/preference-bridge/workmode-packet.json(schema 复用 self-evolve-preference-evidence-v1)。scripts/workmode_ledger.py:四维状态机账本(机器/人工/应用/结果)+ 确定性 candidate_id/revision + 仅追加 events.jsonl + fcntl.flock + chmod 600。照搬 info-evaluator preference_ledger 的 scope 无关部分,隐私门控复用 self-evolve 自己的 privacy_gate(比 FORBIDDEN_TEXT 更全)。模型 = SiliconFlow DeepSeek-V3.2(enable_thinking=False,temperature 0.0),薄客户端内置不跨 skill import。scripts/workmode_pipeline.py:提炼 + 分析 + 入账,source_digest 幂等短路(未变则零模型调用)+ pipeline.lock 互斥。extract 成功即 returncode 0,分析降级(如未配 key)不算失败。- panel「偏好审阅」tab:卡片式展示候选(scope/polarity/置信度 CSS 条/跨会话证据数)+ 接受/观察/拒绝。GET
/api/workmode-candidates+ POST/api/workmode-candidates/{id}/decision(revision 绑定,陈旧 → 409)。认证全继承现有 authorize_write(Host+IP+session+Origin+nonce)。 - 调度:
workmode_analyze注册到 COMMAND_SPECS;scheduled_tasks 加weekly-workmode-analyze(外部计划由用户设置)。 scripts/setup_platform_schedule.py:检测本机 WorkBuddy / QwenWork / MyAgents / OpenClaw,为每个 enabled 任务生成各平台的配置命令。OpenClaw 用openclaw cron add --command直接挂(无需 agent prompt);尊重「skill 不创建调度」边界,只给建议。
修复
- panel 运行记录排序 bug:
collect_scheduler合并多个日志文件后直接取[-limit:],旧task-runs.jsonl(止于 2026-07)排在按月文件之后,把最新的按月记录(2026-08)挤掉 → 运行记录永远停在旧日期。改为合并后按时间戳排序再取最新。
契约变更
- 推翻 SKILL.md「Self Evolve 不维护偏好账本」的旧措辞——精确限定为「工作模式偏好」(新维度,本职);内容评分偏好仍在 info-evaluator(DEC-047 不变)。
- 与 info-evaluator 账本 schema 同源(四维状态机 + 哈希公式同构),为将来统一投影/工作台整合留接口。
验证
- 12 个账本单测全过(revision 滚动回 pending / 陈旧 revision fail-closed / decide 不改 ledger 主体 / reason 隐私拒绝 / corrupt 事件/identity 阻断 / unknown_scope 过滤)。
- 真实来源提炼和 packet schema 检查作为旧工作台的本地验证。
- test_panel 15 测试不回归;render_html 含 preferences nav/div/renderPreferences/decidePreference。
[1.5.1] - 2026-08-10
修复:迭代报告 v2 校准
- 归因正则移除
\b:避免英文词边界在中文场景失效,改善纠正短语及约束信号提取。 - 反复 Skill 自动/主动阈值:从
blob >= related//2调整为blob/related >= 0.20,减少主动调用被误判为自动调度。 - 专注度关键词校准:AI 提效 CLI 移除「脚本/CLI 工具/分发」(过宽,开发 skill 也写脚本误归),改用动作词(自动化/批处理/pipeline/cron/定时/批量/调度/流水线);skill 元工作加「进入 skill/skill 内部/skill 迭代/写 skill」。
- _session_field_blob 加 evidence_snippets:让纠正短语正则能扫到用户原话(「其实/应该是」主要出现在 evidence)。
已知限制(下版)
- 专注度统计可能被自动 cron 会话污染,后续按自动/主动区分过滤。
- 归因 sample 的 cid 引用是 session_id 前 12 位,下版可加会话主题回链。
[1.5.0] - 2026-08-10
重构:迭代报告从「堆事实」转向「归因洞察」
scripts/iteration_report.py 将报告压缩为五章节并增加三层分析(纯正则,不依赖 LLM,也不新增 session-summaries 字段):
- §1 专注度占比:按工作方向正则分类,多标签加权,并展示覆盖率与倾向总结。旧关键词分类具有特定领域倾向,不能视为通用画像。
- §2 反复纠错归因:三类归因正则(skill 边界 / 约束缺失 / 纠正短语),只在
decisions+upgrade_signals字段内匹配避免上下文稀释,sample 3-5 条带 cid;问法问题信号稀薄,有信号才显示,无信号留 nudge。 - §3 反复调用 skill + 自动 vs 主动区分:
related_skills× blob 提及共现,识别「自动 cron 调度」(相关× 高 / blob 低)vs「主动调用」,提示用户反思 skill 边界是否过宽。
新增函数:_extract_focus_distribution / _extract_attribution_signals / _extract_recurring_skills / _extract_top_decisions / _snippet / _parse_session_ts(兼容 epoch/字符串/毫秒)。
验证
- 端到端检查桌面报告的结构和可读性。
- 归因 sample 含 cid 引用;桌面写入经
sanitize_structured_textfail-closed 脱敏。
已知限制(下版迭代)
- 专注度正则偏宽(「script/skill-manager」命中过多),AI 提效 CLI 占比偏高,book-ocr 类被误归;待校准关键词。
- 反复 skill 自动/主动阈值偏严,de-ai-polish 等被全标「自动」;待调阈值。
- 纠正短语类目(sample 抽到 0),正则可放宽。
[1.4.0] - 2026-08-09
新增:迭代报告(面向用户的每周脱敏 digest)
- 新增
scripts/iteration_report.py:从 timeline-index / topic-clusters / proposals / skill-inventory 拼一份用户口吻 digest(本周扫描概览 / 高频主题 / 可沉淀资产建议 / 覆盖 skill / 下一步),区别于审阅者面向的 pending 报告。 - 双输出:① review inbox(
review/inbox/iteration/)走write_review_artifact隐私门控;② 桌面副本(~/Desktop/self-evolve-周报-*.md)用sanitize_structured_textfail-closed 脱敏 +assert_external_write_path+ 原子写。桌面副本离开 review inbox 受控环境,残留 blocker 就不写。 - scheduler 注册
iteration_reporttype(COMMAND_SPECS)+ scheduled_tasks 加weekly-iteration-report(外部计划由用户设置)。平台无关:WorkBuddy/QwenWork 等用户把外部 Cron 入口配进各自平台调度器,self-evolve 不创建调度。 - 文档:
references/12任务分层表 + 「WorkBuddy/QwenWork 平台定时任务」说明;references/00下一步提迭代报告。
验证
scheduler_run --task weekly-iteration-report --run-now --trigger external支持生成迭代报告并向 review inbox 和桌面输出。- 隐私门控:review inbox
published(blockers 空);桌面经sanitize_structured_text脱敏。
[1.3.1] - 2026-08-09
重构(配置结构整理)
- example 配置移到 config/:
templates/core_skills.yaml与templates/scheduled_tasks.yaml移到config/core_skills.example.yaml与config/scheduled_tasks.example.yaml。templates/回归只放产出模板(article.md / upgrade-direction.md)。职责清晰:config/ 管配置(example + 实例),templates/ 管产出格式。 - data_root 拆单独 YAML:data_root 从
core_skills.yaml拆到独立config/data_root.yaml(+ example),职责分离——core_skills 只管 skill 清单与来源,data_root 只管外部数据根。_data_root_from_config()改读config/data_root.yaml,优先级不变(env > data_root.yaml > 默认)。 - 删源码树 review/:真实 review 产出在外部 DATA_ROOT/review/,源码树 review/ 只剩 legacy 声明 README,无实际用途,删除。
- 更新
references/00-first-run-setup.md(复制三个 example + data_root 单独说明)与 SKILL.md(data_root 路径)。
验证
- data_root 三优先级测试通过(env > data_root.yaml > 默认,默认地址不变)。
- core_skills.yaml 与 core_skills.example.yaml 均已无 data_root 字段。
- inventory 支持合并本地配置与 Agent 默认来源。
[1.3.0] - 2026-08-09
分发就绪
Self Evolve 改造为可分发版本:Skill 路径可迁移,首次配置说明见 references/00-first-run-setup.md。
- inventory 默认扫多 agent skill 目录:
refresh_skill_inventory.py的 DEFAULT_SOURCES 从固定目录改为收集 21 个常见 agent 的用户级 skill 目录(claude/codex/workbuddy/codebuddy/agents/qoder*/qwen*/opencode/openclaw/hermes/cursor/windsurf/gemini/copilot/trae/kimi*/deepseek/grok/minimax*),只收录实际存在的目录。fallback 由config or DEFAULT改为 merge——没有个人配置时扫默认 agent 目录,有个人配置时不强行覆盖只补充。 - DATA_ROOT 可配:
self_evolve_paths.py的 default_data_root() 增加从config/core_skills.yaml读 data_root 字段,优先级 envSELF_EVOLVE_DATA_ROOT> YAMLdata_root> 平台默认(默认地址不变,向后兼容,不挪已有数据)。config 与 templates 同步加 data_root 字段,example 内可视化展示默认地址。 - 配置 example 模板:新增
templates/scheduled_tasks.yaml(timezone 占位 + sources 可选说明),配合既有templates/core_skills.yaml。 - 首次配置引导:新增
references/00-first-run-setup.md,引导新用户复制 example → 运行 inventory 扫描 → 确认覆盖自己 skill → 排查漏扫。
会话来源扩展(验证)
- 新增
scripts/probe_workbuddy_trace.py与audit_workbuddy_traces.py:验证 WorkBuddy 的 OTel span trace 可还原成会话流(处理 100KB toolInput 截断走正则兜底、累积历史 user 消息重发按内容去重、system 模板孤立<user_query>开标签中和三陷阱),为接入 WorkBuddy 作为第三会话来源做铺垫。Qoder/QwenWork 的 session 为 CC jsonl 克隆,零成本可接入。
清理
- 迁移旧版 review 产出时需先核实外部数据根和归档。
验证
- inventory 合并按 realpath 去重,支持多 Agent 来源。
- DATA_ROOT 三优先级测试通过(env > YAML > 默认,默认地址不变)。
- WorkBuddy trace 解析审计覆盖内容抽取、去重和异常处理。
[1.2.1] - 2026-08-09
修复
- 将偏好证据包从“序列化整包后脱敏”改为字符串叶子逐字段脱敏,避免私有路径替换破坏 JSON 语法并把全部合格聚类误判为隐私失败。
- 桥接 cluster ID 改为确定性短哈希,满足下游 ASCII 标识契约且不泄露内部主题或路径片段。
验证
- 新增字段级私有路径与桥接 ID 回归;偏好证据专项 6 项测试通过。
- 隐私 fail-closed 规则保持不变;桥接包经结构与隐私验包后才可进入外部分析。
[1.2.0] - 2026-08-09
新增
- 新增
export_preference_evidence.py,把跨会话明确表达导出为self-evolve-preference-evidence-v1脱敏证据包,供 Info Evaluator 生成可审偏好候选。 - 新增稳定
source_digest、离线--verify-only和跨 session/evidence 可追溯门槛。
安全
- 桥接包禁止完整 transcript、原始 session ID、绝对路径、敏感信息和提示注入;单会话与隐私失败聚类关闭处理。
- 明确 Self Evolve 只生产证据,不调用内容评分模型、不修改评分配置,也不把活动频率推导为内容价值偏好。
验证
- 新增 5 项合成回归,覆盖跨会话导出、单会话过滤、隐私关闭、摘要确定性和篡改拒绝。真实会话外部分析仍需显式授权,当前标记
NOT_VERIFIED。 - 真实试跑暴露旧隐私门控可能阻止导出;外部分析与原话材料仍须明确授权。
- 一次性原话包仅保存在仓库外 runtime,默认脱敏/fail-closed 逻辑未改变;已登记“受治理的用户授权原文模式”后续任务。
[1.1.3] - 2026-08-08
采集覆盖 + 提取质量
- Codex
_quarantine盲区补采:discover_codex_paths增加隔离目录;source_variant_for_path增加codex_quarantine,去重优先级为 1。 - evidence_snippets 跨时段抽样:命中 signal 的 texts 改等间距抽样(头/中/尾均匀取),limit 4→8,降低长 session 后期 evidence 缺失。
- ARTICLE_PHRASES 加写作意图词:加"设计手记/长文/写一篇/记录成文/分享出来/发出来"(明确写作意图,非泛技术词,保区分度)。
验证
- 191 测试绿(+2
test_evidence_snippets_samples_across_session/test_source_variant_for_codex_quarantine)。 discover_codex_paths(None)验证:codex total 1047→1390(+343_quarantine)。- 证据摘录覆盖会话的不同阶段。
[1.1.2] - 2026-08-08
提取质量修复
- sensitive_markers 剥离 MCP/系统提示:
detect_sensitive_markers改用useful_user_texts(用户消息)而非combined(含 MCP 工具描述/系统提示),避免工具描述污染敏感检测及标题。 - extract_decisions 排除对话碎片:排除句首口语短句与模糊提问,移除易误匹配的 cue;长度门槛 6→12。
验证
- 189 测试绿(+1
test_extract_decisions_excludes_conversational_and_vague)。 - 检查标题、敏感状态、decisions 过滤与 transcript 大小更新。
[1.1.1] - 2026-08-08
修复
- summarize_records 空 texts 全 source 宽容:v0.9.0 只对
claude_transcript宽容(空 texts 产 placeholder 而非 None),v1.1.1 扩展到所有 source——claude_subagentworkflow journal(非标准 schema)/claude_projectmetadata-only(只有 ai-title 行)/ 老 codex schema(record_type 平铺,message 没被 record_text_events 提取)都救活。placeholdersummary_policy=index_only不进聚类,但保留索引可检索 + raw-backup 原文。 - backfill 支持无文本记录的 placeholder 索引,避免非标准或 metadata-only 会话阻断。
不做
- 老 codex schema 适配(识别 record_type 平铺结构)——空 texts 宽容已保住它们的 metadata(cwd/timestamp/session_id),message 内容虽丢但价值低(2025-08~10 早期会话),投入产出不值。
[1.1.0] - 2026-08-08
subagent 采集 + raw-backup 全集补全
- subagent 采集支持:
source_variant_for_path加claude_subagent(subagents/路径),dedupe_session_summariespriorities 加claude_subagent:0(去重让位主会话),cluster_candidate排除claude_subagent(不进聚类/dream,但仍索引+raw-backup——subagent 是主会话子任务,内容重叠主会话,进聚类只会 flood)。CLI--include-subagents默认改True(BooleanOptionalAction),让 subagent 备份自动化。 - raw-backup 扩展到 merged 全集(v0.9.1 gap 修复):原
update_runtime_indexes的 raw-backup 循环只对本次新写的summaries跑,导致有 summary 但原文未 cp的 skipped_existing session 漏备份(CC cleanup 时丢)。改为对merged(existing + summaries)全跑 + no-clobber 幂等,下次跑一次性补全历史原文。 - 原始来源缺失时保留已有摘要;raw-backup 对已归档条目保持幂等。
- raw-sessions 按来源及 subagent 分目录保存。
验证
- 188 测试绿(+3 SubagentCollectionTests:source_variant_for_path 分类 / cluster_candidate 排除 subagent / dedupe 优先级让位主会话)。
- backfill 端到端检查累计索引、完成状态和 subagent 原文归档。
- 推论:CC 默认 cleanupPeriodDays 30→365 + ~/.claude git + DATA_ROOT raw-backup(v0.9.0-1.0.0)+ subagent 纳入(v1.1.0)——会话史现在四道半防线。
[1.0.0] - 2026-08-08
marker flaky 根治 + 清 legacy 源码树
- marker 防御改造:
legacy_state_files()排除活跃产出子树(runtime 下 dreaming/session-summaries/panel/logs/scheduler/learning-candidates + 顶层 evaluation-log/hook-runs/skill-inventory/extraction_sessions + review/output),新增is_legacy_active_artifact判定。这些 v0.7.0 后应全部写 external,即使因路径 bug 残留 legacy 也不算"冻结 state"、不参与migration_marker_validsha256 校验——根治 marker flaky(v0.9.0 实测 legacy source-index 被一次 backfill 写入致 marker 反复失效、assert_runtime_ready 阻断)。改造即时收益:legacy 还在时legacy_state_files()=[]→migration_required=False,flaky 立即止血。 - 源码树中的旧 runtime 和 review 产物迁入外部状态目录;历史迁移前需核对副本。
- 清后
LEGACY_RUNTIME_ROOT不存在、LEGACY_REVIEW_ROOT只剩 archive/README.md placeholder →legacy_state_files()=[]→migration_required()=False→ marker 不再被查询,flaky 双重根治(改造防御 + 清空根除)。 - 历史产物支持归档备份;归档不能替代核验与回填。
验证
- 185 测试全绿(+5 LegacyActiveArtifactTests:活跃子树分类 / runtime 子树排除 / 顶层文件排除 / review/output+placeholder 空 / only-active 不 present)。
- assert_runtime_ready PASS(清 legacy 前后均无 migration_required);dream_sweep recent dry-run 写 external 后 marker 仍稳定。
- raw-backup 生产路径检查 recent dry-run 和按来源分目录。
[0.9.1] - 2026-08-08
新增
- raw-backup 双保险:dream_sweep 写 session summary 时同步把会话原文 jsonl 复制到
DATA_ROOT/runtime/raw-sessions/<source_variant>/<YYMM>/<原文件名>。来源可能清理旧原文;摘要提供结构化留存,raw 副本提供原文字节留存。 - 四约束:no-clobber(同 size 跳过,幂等)+ 增量更新(原文追加致 size 变则覆盖)+ 原子写(tempfile + fsync 文件 + rename + fsync 目录)+ 三源全覆盖(claude_project / claude_transcript / codex_active / codex_archived 分目录)。
- 原文已被 CC 清理时返回
source_missing,保留已有 raw 备份不删除(双保险价值正在于此)。 archive_raw_session挂update_runtime_indexes的 summary 写入循环,统计写入source_index.raw_backup(archived / skipped / updated / source_missing / error)。
分工
- 原始来源如果另有版本管理,应独立核实其覆盖范围;不得假设所有会话均已纳入。
DATA_ROOT/raw-sessions= 当前快照(第二道,原文最新字节)。存储翻倍可接受——数据最重要。
测试
- 180 全绿(+6 RawBackupTests:首次归档 / no-clobber 幂等 / 原文变更覆盖 / 源缺失不抛错 / 三源分目录 / update_runtime_indexes stats 端到端)。
[0.9.0] - 2026-08-08
采集层(让 self-evolve 真正能搜到所有 session)
- backfill 解锁:
backfill_is_complete加_count_raw_source_files复核,新源文件出现后自动重开,不因completed=true永久锁死。 - transcripts 豁免 recent cutoff:
discover_claude_paths让~/.claude/transcripts/的旧 mtime 会话也能进入扫描。 - cursor lower-bound:
build_backfill_summaries用last_processed_mtime过滤候选,避免重复处理已去重的前段。 - retry 熔断 + 闭环:解析失败 transcript 标
failed_paths持久化并跳过,completed不要求errors==0;成功后自动从failed_paths移除。 - summarize_records 宽容 transcripts:
claude_transcript空 texts 返回 placeholder 而非 None;其他 source 仍 return None。 - 覆盖率对账:
compute_coverage_metrics写source_index.coverage(raw_total / unindexed_total / coverage_ratio),面板/调度可直接读"还差多少"。
提取层(让搜到的信号变准)
- 框架注入剥离:
strip_framework_injection剥<system-reminder>/<CRON_TASK>/<observed_from_primary_session>/<what_happened>/<occurred_at>,并挂接extract_message_text和双 marker 名单。 - decisions 真抽取:从 3 条硬编码分类模板 →
extract_decisions句子级抽取(决定/改为/因此/选定/采用X而非/放弃 等 cue)。 - article_signals 守卫:改用
useful_user_texts,避免把 assistant 的发布表述误判为用户意图。 - marker 名单兜底:
CONTEXT_NOISE_MARKERS+REPORT_NOISE_MARKERS都补入框架注入 tag。
聚类层(让聚类不假同质)
- 簇间合并步:
_merge_similar_clusters在build_clusters加簇循环后做质心相似度合并(阈值 0.55),跳过纯泛词簇防桥接雪球、size cap 防超分片——填补 reference 11 设计承诺但缺失的合并步。 - 同名收紧:
choose_cluster_title泛词同名分支要求 ≥2 命中,避免单泛词让异质簇改同名。
测试
- 174 全绿(+13 新增:transcripts 豁免 / 注入剥离 / decisions / 合并 / 同名收紧 / 熔断 / coverage / transcripts 宽容 / backfill recheck / 等)。
- 修
test_refresh_cli_only_writes_inventory_outputs补 mockassert_runtime_ready(不再依赖本机迁移态)。
文档
references/11-dream-sweep.md新增「CC 会话存储与生命周期」+「完整采集源全景」:CC 两套存储 + Codex 三套(含_quarantine盲区)+history.jsonl命令源 + 非会话目录清单 + git 无历史 + 覆盖率对账方法。
运行边界
backfill 支持重试熔断、单调游标和失败重试闭环;实际来源覆盖按各次运行记录核对。
[0.8.3] - 2026-08-06
新增
- 交互沉淀「验证回看」:
interactive_sediment加pending_verifications+verify-list子命令,列出 applied 但未 verified 的提案。references/15加步骤 0.5——触发交互沉淀时先查待验证提案,若本次涉及则提示用户回看效果,登记 verified/failed/inconclusive(复用proposal_store verify)。把 applied→verified 半圈从「靠人手动记、易漏」变成「交互沉淀时主动浮现」,为后续反哺(沉淀数据指导 curate/路由)铺数据。+3 单测。
[0.8.2] - 2026-08-06
修复
- 排除 macOS
.DS_Store等 OS 元数据出 migration state 指纹(self_evolve_paths.legacy_state_files+migrate_state.build_plan)。原委:Finder 自动改写.DS_Store→migration_marker_valid持续 flaky 失效 →assert_runtime_ready反复阻断(POST-03「自愈后又失败」的真根因)。新增is_ignored_state_file+ 3 个单测;修复后 marker 自动恢复有效,无需重新 apply。
增强
interactive_sediment.map加 inventory 过期检测:generated_at超 7 天 → 输出警告提示先refresh_skill_inventory,防止过期 inventory 导致 commit 误判 ambiguous 等 silent 降级。+2 单测。- 旧核心 Skill 配置支持按领域维护重点关注项;实际配置留在本地,不作为发行默认值。
交互沉淀的可用性
- Branch B 的顾问模式需关注术语可理解性、可选去向、价值判断辅助和主动触发提示。
[0.8.1] - 2026-08-06
修复
- 修复
interactive_sediment.commit在目标 skill 被 inventory 多 source 重复登记时静默降级为 candidate 的问题(in-chat auto-accept 失效)。_resolve_inventory_target原先只要 matches>1 就判 ambiguous;现改为多条 matches 若指向同一 SKILL.md 文件(inventory 重复登记/过期),折叠为一条走resolved,仅指向不同文件或信息缺失时才判ambiguous。新增 2 个单测覆盖(同文件→resolved、不同文件→仍 ambiguous)。 - inventory 多来源重复时需先核对目标文件身份,避免唯一目标降级为歧义。
运维
- 交互沉淀前应刷新过期 inventory,并对同一 Skill 多来源登记去重。
[0.8.0] - 2026-08-05
新增
- 新增第二运行模式「交互式对话沉淀」:用户在对话末尾主动触发(「复盘/沉淀这次对话」),agent 用 live 对话上下文复盘可复用的方法论/知识,按自适应 2 分支路由——命中已安装 skill(Branch A:
core_skills.yaml的domain_keywords/function精确匹配,inventorydescription兜底)则指名道姓写升级提案;无命中(Branch B)则进顾问模式(原子化拆分 + 资产沉淀理念 + 去向选项),决定权交用户。沉淀目的地动态推导(用户真实 inventory + 可选config/asset_owners.yaml),不预设固定分类,故初学者(少 skill)走 Branch B 被教方法论、高阶用户(基建全)走 Branch A 精准路由。与外部 Cron 磁盘索引流程互补,不替代。 - 新增
scripts/interactive_sediment.py:map子命令打印动态资产地图(区分 inventory 缺失/损坏/正常三态);commit子命令对 agent 草稿跑隐私门控(fail-closed,不写盘)、原子 no-clobber 落盘到 review/inbox(内容哈希文件名、目录 fsync),并经proposal_store登记——目标在 inventory 唯一 resolved 时登记 machinecandidate后立即decide(accepted)(in-chat 确认即人工接受),文章/无目标/歧义目标只登记candidate留待 localhost 面板。 - 新增
config/asset_owners.yaml(可选,默认空):高阶用户声明「哪类非 skill 资产归哪个 owning skill」,让 Branch A 对非 skill finding 也能指名道姓;初学者留空即走 Branch B。 - 新增
references/15-interactive-sediment.md:交互模式的 agent 契约(触发消歧、地图自举、2 分支路由、Branch B 五步顾问方法论、落盘 rc 语义、非 skill 边界、涌现新资产类型、验证要点)。 - 新增
tests/test_interactive_sediment.py:16 个 unittest 用例,覆盖 loader 边界、map 三态、commit 隐私门控 fail-closed、no-clobber、decide(accepted)真触发(查 proposal 事件流)、article/missing/ambiguous 仅 candidate。
边界(不变)
- 非 skill 资产(法律知识规则、问答等)只到「带载荷提案」为止,由 owning skill(如 legal-knowledge-engine)接手入库;self-evolve 不直接改成熟资产。
- 不改
privacy_gate.py/proposal_store.py/refresh_skill_inventory.py现有契约,只复用;不替换 Cron 磁盘索引流程;不动外部 Cron 与全局设置。
[0.6.1] - 2026-07-18
修复
- Skill 链路图修正迁移后的节点引用。
[0.7.0] - 2026-07-18
重大变更
- 将正式运行架构收敛为“外部 Cron →
scripts/scheduler_run.py”单一路径:外部 Cron 负责真实启停与时间表,任务注册表只提供命令白名单、runner.enabledkill switch、external_only、重入锁、超时、每日限额和按月运行日志。 - 移除旧会话结束执行链与创建能力;新增
scripts/legacy_hook.py,只提供状态检查和显式清理。清理默认预览,只有--apply才备份并修改全局设置,且保留其他项目配置。 - 新增统一外部数据根
SELF_EVOLVE_DATA_ROOT,把 runtime、Review Inbox、quarantine、proposal、panel 和 audit 从源码树分离。旧SELF_EVOLVE_STATE_ROOT/SKILL_EVOLVE_STATE_ROOT继续解释为 runtime 叶目录。
新增
- 新增
scripts/migrate_state.py:默认 dry-run,显式--apply以源哈希快照和目标O_EXCL只复制并校验旧状态,不删除或覆盖源文件;存在冲突时失败关闭。--legacy-root可从升级前 worktree/版本快照恢复已离开当前源码树的材料;旧 Review 输出只进入archive/legacy-output,未经重新隐私门控不会进入 Inbox 或 proposal 生命周期。 - 新增
scripts/privacy_gate.py:在 Review Inbox 前脱敏主目录、系统临时目录、挂载卷路径、联系方式、身份/案件信息等,拦截提示注入、Bearer/JWT 与其他密钥材料;隔离记录只保存规则、计数与哈希。 - 新增
scripts/proposal_store.py:分离 machine disposition 与 human decision,以稳定 fingerprint/revision、append-only 人工事件、applied commit 和 verified outcome 建立提案生命周期。 - 新增
scripts/deep_dream.py:把每日确定性索引与每周可选 LLM 深度分析分层;深度调用需要显式授权并只消费受控 cluster packet。 - 新增状态根 ownership marker:只认领专用空叶目录或可验证的既有 v0.7 布局,拒绝
/、主目录、系统临时根和非空未认领目录,避免误改共享目录权限;首次并发启动以完整临时文件 + 原子 no-clobber 发布 marker,避免一个 Cron 读到另一个 Cron 的半写入状态。 - 新增标准库
unittest测试与 synthetic fixture,覆盖调度配置/锁/崩溃配额、旧配置清理、状态迁移、隐私门控、proposal 生命周期、Claude/Codex 采集、长会话抽样、聚类、inventory/portrait、Deep last-good 和 localhost 面板关键契约。
改进
- Dream Sweep 同时发现 Claude Code 与 Codex 的 active/archived 会话,按 session identity 与指纹去重;长 JSONL 改用流式头/中/尾抽样,保留最终决策与验证信息。
- 主题聚类增加来源配额、内部一致性约束和稳定谱系:
cluster_id/topic_key不再包含完整成员摘要,成员变化独立写入member_digest/revision,旧 ID 保留在legacy_cluster_ids;每日--generate只发布确定性 timeline/cluster packet。 - inventory 按 canonical realpath 去重;
skill-inventory.json、skill-portraits.json与skill-chain-graph.json分文件持久化。画像任务先筛选缺失/过期项,再按最久未尝试优先排序并应用--limit,避免 inventory 前缀已经新鲜或持续失败时后续目标长期饥饿。增强画像按字段绑定内容哈希并合并,旧增强数据不会混入新 core,增强失败不污染有效 core 新鲜度;直接 CLI 增加单次$5、整批$100硬上限。 - Deep 状态拆分
last_attempt与last_success;预览、CLI 暂时失败或隐私失败不再覆盖最后成功产物及 proposal 引用。 - proposal schema 升至
1.4:当前 revision 只绑定唯一 Inbox 逻辑路径;Deep proposal 产物按内容寻址并以 no-clobber 方式发布。人工接受/部分接受时通过文件描述符拒绝符号链接并核验 SHA-256,再把已读字节固化为 revision-bound archive 快照;事件持久化原路径、快照路径与哈希,applied 只验证决定快照。缺失、篡改、多路径、路径逃逸、并发替换和历史路径丢失均失败关闭;事件流撕裂、未知事件或冲突终态继续失败关闭。 - localhost 面板聚焦状态观察和人工 proposal decision,并彻底移除任务执行按钮、API 和子进程代码;面板不修改外部 Cron。启动时的一次性访问令牌只存在于进程内存和 URL fragment,fragment 不进入 HTTP/日志,成功交换后立即从地址栏清除并作废。会话只保存在包含端口的
sessionStorage,状态 API 通过显式 Authorization 鉴权,不设置会跨回环端口发送的 Cookie;匿名根页只返回无数据 bootstrap,匿名 API 返回 401。服务继续校验精确 Host/Origin、请求 nonce 与 JSON Content-Type,使用 CSP nonce、移除 inline handler,并在 proposal store 损坏时失败关闭。 - 迁移复制、manifest、layout 与 completion marker 增加目录级 fsync 发布顺序;隐私门控补齐
/root和运行时非标准 HOME;修正主页、资源可达性、portraitcontent_hash示例与核心配置模板字段。 - 重写
SKILL.md与现役 references/templates,统一外部数据根、隐私门控、提案闭环、Cron-only 调度和验证说明;删除不再参与现役链路的分析 prompt 与旧评估模板。
迁移
- 源码树不再保存个人运行产物;本版本移除旧版已跟踪的
review/output/**、review/review-log.md和运行型脚本。切换/合并前应先迁移;切换后必须将升级前 Git ref 建为临时 worktree,并通过migrate_state.py --legacy-root <old-worktree>/self-evolve预览、复制和校验。当前源码树为空不能证明旧数据不存在。 - 迁移需核对旧状态副本及 manifest/marker;legacy hook 和外部 Cron 的实际部署操作应单独确认。
文档完善
- frontmatter 版本同步为
0.7.0,通用工具许可证调整为 MIT,并补齐标准 MIT 全文与统一版权信息。 config/core_skills.yaml明确 core skills 只控制重点关注和优先级,inventory 才是候选全集;去除重复 source 别名以及会与真实 Skill 漂移的version/upgrade_target副本。- DEC-037 记录单一架构、安全边界、迁移原则和机器/人工状态分离;TASKS 已按
RESULT.md勾选代码闭环,并把真实部署操作保留为SE-DEPLOY-*。
验证入口
以下统一验证已通过:
PYTHONDONTWRITEBYTECODE=1 python3 -m unittest discover -s tests -p 'test_*.py'
python3 scripts/scheduler_run.py --validate-config --json
python3 scripts/legacy_hook.py status --json
python3 scripts/migrate_state.py --dry-run --json- 标准库测试 134/134 通过;Schema v2 校验通过 7 个任务;相对链接、语法与 diff whitespace 检查通过。
- fresh 数据根下外部触发成功,缺少
--trigger external非零拒绝;把数据根指向/tmp时非零拒绝且目录权限保持不变。 - localhost 面板完成真实浏览器交互:匿名 API 401、bootstrap 200 且无私有数据、一次性 fragment 交换后被清除、会话进入端口级
sessionStorage、Cookie 数量为 0、访问令牌重放 403;访问另一个回环端口时未携带 Authorization/Cookie。proposal 接受并重载持久化、错误 nonce 403、任务执行端点 404、Host/Origin/CSP 检查通过、无 inline handler、初始/最终控制台错误均为 0、IPv4/IPv6 loopback 可用。 - synthetic Claude/Codex fixture 覆盖 active/archive 发现、长会话尾部、跨来源去重、稳定聚类、画像新鲜度、隐私隔离和人工决定不可被机器覆盖。完整证据见
RESULT.md。
[0.6.0] - 2026-07-03
新增:Skill 功能画像层 + 链路图(供 agent-eval-lab Step 0 组合 / 协同迭代消费)
- 新增
scripts/distill_skill_portrait.py:对全仓 skill 用 LLM 蒸馏核心层画像(capability/inputs/outputs/depends_on/can_chain_to/not_for),增量按SKILL.mdmtime,失败降级不破坏索引层;fulfill子命令消费enhance-requests.jsonl蒸馏增强层。纯标准库 +claude -pheadless。已验证:build_chain_graph 交叉对账、extract_json 容忍杂质、增量判定、--no-llm 降级全通过。 - 新增
references/14-skill-portrait.md:画像层机制(核心层 5 字段全仓 + 增强层 4 字段按需 + 顶层skill_chain_graphDAG + 控制反转请求协议 +portrait_schema_version字段版本演进)。 runtime/skill-inventory.json每个 entry 新增portrait字段,顶层新增portrait_schema_version+skill_chain_graph;refresh_skill_inventory.py不变(扫描与蒸馏解耦)。config/scheduled_tasks.yaml:加nightly-skill-portrait-distill(默认 disabled,外部 cron 直调脚本)。references/10-skill-inventory.md补第七节"与功能画像层的关系";SKILL.md读取顺序加 14、运行资源段补 portrait 说明。- frontmatter version 0.4.5 → 0.6.0(顺带修正落后于 CHANGELOG 的版本号)。
- Skill 画像数据通过
skill-inventory.json与enhance-requests.jsonl暴露给上游消费方,保持生产与消费分工。
[0.5.0] - 2026-06-20
重大变更
- SessionEnd hook 完全下线,沉淀与索引改由外部 Cron 定时任务驱动。
- 背景:历史上
~/.claude/settings.json注册了 self-evolve 的 SessionEnd hook(sediment_guard.py),会在每次会话结束时实时评分;评分通过(score>=阈值,action=generate_upgrade/article 等)就后台 Popen 一个claude -p --dangerously-skip-permissionsheadless agent session 做沉淀分析。 - 问题:
- 与 v0.4 设计意图冲突(11-dream-sweep.md / DEC-023/024 明确写"SessionEnd 只建轻量索引,跨 session 总结交给夜间脚本")
- 每次会话触发 headless,无法控制资源消耗,无法选择大模型(hook 继承父会话 model)
- 与旧版外部 Cron 任务的职责存在重叠。
- 处理:
- 从旧设置中移除 self-evolve 的 SessionEnd hook,原有配置先备份。
- 移除 self-evolve hook 时保留其他 hook,不改变其配置。
SKILL.md加 v0.4.9+ 废弃说明,标注"不要再运行 install_session_end_hook.py"
- 不删
sediment_guard.py与install_session_end_hook.py脚本本身(保留代码,以后想恢复随时装回);但默认不再触发。 - 旧运行选择定时索引与跨会话分析;当前公开流程按需由当前 Agent 分析,不依赖旧定时器。
[0.4.9] - 2026-06-16
改进
scheduler_run.py给task-runs.jsonl的reason字段做结构化增强(方案 A):dream_sweep类型:解析脚本输出,提取sessions / clusters / mode / index_mode / backfill_processed / backfill_completed / timeline / dreams / upgrade_directions / articles / context_updates等指标;同时支持 plain-text fallback 解析- sessions: N / - clusters: M标记maintain_runtime类型:解析 JSON 输出,提取runtime 体积 / summaries 总数 + flat_files / recommendations 数量;同时给maintain_runtime.py --report加上--json参数
- 修复:dream_sweep 在 dry-run 模式输出多行 JSON(顶层
{和末尾}不在同一行),旧实现只读最后一行解析失败,改为读完整文本 - 通知渠道及事件由实际部署环境配置。
[0.4.8] - 2026-06-16
运维
- MyAgents reload 可能改变 Cron 对象映射及名称;更新前核对调度系统中的对象。
- 后续操作教训:不要在已注册 cron 之后随便
myagents reload,会重置 sidecar 内存中的任务映射关系;若必须 reload,先记录当前 cron ID 清单,reload 后用持久化文件里的新 ID 重新 update name/prompt。 - Task Center 任务可分别维护名称、描述和标签。
- 流程:每条 task 走
update-status stopped → update name/desc/tags → rerun(stopped不能直接转running,需rerun走 todo→running) - 架构发现:MyAgents 有两个独立层,cron 任务(
~/.myagents/cron_tasks.json)和 Task Center 任务(/api/task/list)是不同对象,各有独立的 name/description/tags 字段。myagents cron update --name只改 cron 层的 name,不会同步到 Task Center;反之亦然。改 Task Center 用myagents task update <taskId> --name --description --tags,但要求 status=stopped 才能改。
[0.4.7] - 2026-06-16
新增
外部 Cron 可按需编排历史回填、运行时检查、面板刷新和深度梦境生成;实际是否安装、启用及时间由用户决定。
YAML
config/scheduled_tasks.yaml新增weekly-deep-dream任务条目,默认关闭;当前版本的 kill switch 不可绕过。
改进
scripts/scheduler_run.py新增 backfill-state 完成检查 hook:run_task()入口处对history-backfill-index任务读runtime/dreaming/backfill-state.json,若completed=true直接返回skipped (backfill_already_completed:...),避免无效每日跑。这与 12 doc §九「完成即停」建议对齐。RUNTIME_DREAMING = STATE_ROOT / "dreaming"常量新增,作为 backfill-state.json 路径的稳定来源。
验证
- 检查外部调度任务运行记录及对应产物。
- backfill hook 测试:模拟
backfill-state.json.completed=true→ 任务skipped (backfill_already_completed:...);completed=false或文件不存在 → 正常跑。 python3 -m py_compile scripts/scheduler_run.py通过。- 旧版本曾支持手动触发深度梦境;当前
runner.enabled为不可绕过的 kill switch。
[0.4.6] - 2026-06-15
文档完善
TASKS.md与 12 doc 同步抽象:T-083 / T-077 / T-208 措辞从"launchd 首选/后置"加 v0.4.4+ 抽象注(launchd / MyAgents cron / OpenClaw cron / Hermes cron / Linux/Unix 系统 cron / Codex automation 6 个同级载体),方便后续读者一眼看到抽象不被历史措辞误导。- 更新外部 Cron 调度抽象说明。
- 新增"v0.4.6 外部 Cron 定时任务抽象与 TASKS 措辞同步任务"已完成段(T-111/T-112)。
- 历史决策记录(DEC-024 标题、T-073 第 2 条、T-074 第 2 条)保持原样不覆写。
[0.4.5] - 2026-06-14
新增
dream_sweep.py新增--index-mode recent|backfill,默认保持 recent 行为,backfill 用于历史存量 session 回填索引。- 新增
runtime/dreaming/backfill-state.json,记录历史回填批次、跳过数量、最后处理位置、完成状态和累计统计。 config/scheduled_tasks.yaml新增默认关闭的history-backfill-index任务,可由外部定时器或本 Skill 调度器按批触发。
改进
- Backfill 默认按
newest-first从近期向更早 session 追溯,每批默认最多处理 200 条未索引或已变化 transcript。 - 已有 summary 且 transcript 指纹匹配时跳过;旧 summary 缺少指纹时默认按 legacy 已索引跳过,避免重跑全部历史。
scheduler_run.py继续只允许白名单任务,新增安全透传dream_sweep的 backfill 参数,不开放任意 shell 命令。
文档完善
SKILL.md升级到 v0.4.5,补充 recent / backfill / generate 三类运行方式和人工审边界。- 同步
config/core_skills.yaml、templates/core_skills.yaml与references/02-core-skills-yaml.md的版本、关键词和 notes。 references/11-dream-sweep.md增加历史回填架构、跳过规则和续跑状态说明。- 补充外部定时任务交接建议:每日 recent scan、每日阶段性 history backfill、每周 deep dream;明确 daily 任务不启动 Agent Session,weekly deep dream 当前尚未正式登记。
验证
python3 -m py_compile scripts/dream_sweep.py scripts/scheduler_run.py通过。config/scheduled_tasks.yaml可被 YAML 解析。dream_sweep.py --index-mode backfill支持批量回填并更新backfill-state.json。python3 scripts/dream_sweep.py --since 1d --dry-run --max-sessions 2 --json成功运行,确认 recent 模式未被 backfill 改动破坏。- 调度器支持 backfill 参数并记录处理状态。
- 面板和运行时维护命令支持展示 summary 分桶。
[0.4.4] - 2026-06-14
新增
- 新增
scripts/maintain_runtime.py,用于检查和整理runtime/运行数据。 - 新增手动调度任务
maintain-runtime,通过调度器白名单执行只读 runtime report。
改进
dream_sweep.py新生成的 session summary 改为写入runtime/session-summaries/<YYMM>/,避免所有 JSON 长期平铺在同一目录。maintain_runtime.py --organize-session-summaries默认只预览整理动作;只有传入--apply时才移动旧 summary。- Runtime 治理继续使用轻量文件系统方案,不引入 SQLite,不删除、不压缩、不改写原始 transcript。
文档完善
SKILL.md升级到 v0.4.4,补充 runtime 治理命令和月份分桶规则。DECISIONS.md新增 DEC-033,记录不引入数据库、采用轻量分桶与维护脚本的决策。TASKS.md新增 T-103 至 T-106,记录 runtime 治理任务。- 同步核心清单、模板、schema 和 Dream Sweep 设计文档中的 session summary 路径。
验证
python3 -m py_compile scripts/maintain_runtime.py scripts/dream_sweep.py scripts/scheduler_run.py scripts/render_panel.py scripts/panel.py scripts/refresh_skill_inventory.py scripts/sediment_guard.py通过。python3 scripts/maintain_runtime.py --report --json成功输出 runtime 体积、JSONL 行数和 summary 分桶状态。--organize-session-summaries可预览迁移及冲突。--organize-session-summaries --apply可将旧 summary 迁入月份目录。python3 scripts/scheduler_run.py --task maintain-runtime --run-now --json成功执行只读 runtime report。python3 scripts/dream_sweep.py --since 1d --dry-run --max-sessions 5 --json成功运行,确认新 summary 写入月份分桶路径。python3 scripts/render_panel.py --quiet成功刷新面板。
[0.4.3] - 2026-06-14
运维
- 可在外部定时器中注册
nightly-dream-sweep;调度时间和启用状态由用户配置。 - 当前版本中
runner.enabled是不可绕过的 kill switch,不应依赖旧版--allow-disabled。 - dry-run 索引与人工审阅区保持分离。
[0.4.2] - 2026-06-13
改进
- Dream Report 新增“产物方向判定”表,明确每个 cluster 应优先落到升级方向、文章草稿、上下文洞察、质量门控、工具链摩擦聚合,还是继续观察。
- 升级方向建议新增“产物方向判定”表,方便人工审阅时判断该建议属于哪类 Self Evolve 成果。
- 修正 Dream Report 的旧文案,不再暗示需要另行生成升级建议或文章草稿;现在同批
--generate会直接派生待审产物。
文档完善
SKILL.md升级到 v0.4.2,补充 Self Evolve 常规最终产物地图。references/11-dream-sweep.md增加六类产物方向:Skill / 流程升级、文章草稿、工作方式/上下文洞察、评估与质量门控、工具链摩擦聚合、继续观察/薄索引。- 同步
config/core_skills.yaml、templates/core_skills.yaml和references/02-core-skills-yaml.md的版本、关键词和 notes。
验证
python3 -m py_compile scripts/dream_sweep.py scripts/render_panel.py scripts/scheduler_run.py scripts/panel.py scripts/refresh_skill_inventory.py scripts/sediment_guard.py通过。dream_sweep.py --generate支持生成 Timeline、Dream、升级建议、文章草稿与上下文洞察。- 新生成的 Dream Report 与 Upgrade Direction 均包含“产物方向判定”。
- 对生成的待审文件执行敏感模式扫描,避免原始路径、联系方式和案件标识泄露。
python3 scripts/render_panel.py --quiet成功刷新runtime/panel/self-evolve-panel.html。
[0.4.1] - 2026-06-13
新增
- Dream Sweep
--generate新增派生产物生成:review/output/upgrade-direction/、review/output/articles/、review/output/context-updates/。 - 新增工作方式洞察草稿,用于记录用户长期偏好、跨 Agent 协作方式、项目/用户上下文更新建议。
- 新增派生产物选择规则:稳定流程和 Skill 边界生成升级建议,公开叙事素材生成文章草稿,长期协作偏好生成上下文建议。
改进
- 明确 Dream Report 只是证据索引和聚类审计,不再作为 Dream Sweep 的最终产物。
dream_sweep.py命令行输出会列出派生的 upgrade/article/context 文件路径。SKILL.md与 Dream Sweep 设计文档同步说明三类待审产物的用途和人工审边界。
验证
python3 -m py_compile scripts/dream_sweep.py通过。python3 scripts/dream_sweep.py --since 2d --generate --max-sessions 40 --min-cluster-size 2 --json已验证可生成 Timeline、Dream、升级建议、文章草稿和上下文建议。
[0.4.0] - 2026-06-13
新增
- 新增
scripts/dream_sweep.py,实现 Timeline Dream Sweep 的确定性版本。 - 支持扫描 Claude Code
~/.claude/projects/**/*.jsonl与 Codex~/.codex/archived_sessions/*.jsonl。 - 新增运行索引输出:
runtime/session-summaries/、runtime/dreaming/source-index.json、session-index.json、timeline-index.json、topic-clusters.json和runtime/dreaming/runs/。 - 支持
--dry-run只生成运行索引,支持--generate额外写入review/output/timeline/与review/output/dreams/。
改进
- Dream Sweep 增加 session 分类、噪音门控、上下文噪音过滤、案件主体/链接/路径脱敏和主题聚类。
nightly-dream-sweep可通过scheduler_run.py --allow-disabled手动触发 dry-run,但默认仍保持 disabled,不安装系统定时器。- 面板 Dream Timeline 视图支持读取
review/output/dreams/与review/output/timeline/。 - 调度器的
max_runs_per_day不再把skipped记录计入每日执行次数。 dream_sweep.py --max-sessions改为对 Claude Code 与 Codex 合并后的全局 session 列表生效,并在 source index 中记录limited数量。- 面板中的 Hook 设置文件路径压缩为
~/.claude/settings.json,减少本机用户路径外露。 - Dream 报告证据片段过滤目录列表、工具错误、代码摘录和大文件提示,避免把工具噪音误写成任务演进。
文档完善
SKILL.md升级到 v0.4.0,补充 Dream Sweep 命令、运行目录和外部调度边界。TASKS.md标记 T-091/T-092 完成,并保留launchd安装器为后续任务。DECISIONS.md新增 DEC-030,记录 Dream Sweep 首版实现范围和安全取舍。
验证
python3 -m py_compile scripts/dream_sweep.py scripts/render_panel.py scripts/scheduler_run.py scripts/panel.py scripts/refresh_skill_inventory.py scripts/sediment_guard.py通过。python3 scripts/dream_sweep.py --since 2d --dry-run --max-sessions 40 --json成功生成运行索引。python3 scripts/dream_sweep.py --since 2d --generate --max-sessions 40 --min-cluster-size 2 --json支持生成 Timeline 与 Dream 报告。python3 scripts/scheduler_run.py --task nightly-dream-sweep --run-now --allow-disabled --json可调用 Dream Sweep dry-run。python3 scripts/render_panel.py后,面板 HTML 可显示 Dream 报告入口,且不包含transcript_path或 Claude transcript 原始路径。
[0.3.22] - 2026-06-13
新增
- 新增
config/scheduled_tasks.yaml,登记render-panel-snapshot、refresh-skill-inventory和 disabled 占位任务nightly-dream-sweep。 - 新增
scripts/scheduler_run.py,支持对已登记任务执行run now,并写入runtime/scheduler/task-runs.jsonl、task-state.json和任务日志。 - 新增
scripts/panel.py,提供本地 localhost 面板和有限 API:状态、待审产物、任务列表、运行记录、日志、任务启停和run now。
改进
- 调度器只支持内置命令类型
render_panel、refresh_inventory、dream_sweep,不从 YAML 执行任意 shell 命令。 - 本地面板只允许绑定
127.0.0.1、localhost或::1;写接口必须携带X-Self-Evolve-Nonce。 - 启用/停用任务前会自动备份
config/scheduled_tasks.yaml,备份文件通过.gitignore排除。 render_panel.py暴露可复用数据聚合与 HTML 渲染函数,供静态快照和 localhost 面板共用。
文档完善
TASKS.md将阶段 B localhost 面板与调度配置任务标记完成,并新增 Dream Sweep 与 launchd 后续任务。DECISIONS.md新增 DEC-029,记录调度器和 localhost 面板的实现边界。- 更新调度设计与面板设计文档,明确 v0.3.22 已完成阶段 A/B,后续重点转向
dream_sweep.py与launchd安装器。
验证
python3 -m py_compile scripts/render_panel.py scripts/scheduler_run.py scripts/panel.py scripts/refresh_skill_inventory.py scripts/sediment_guard.py通过。config/core_skills.yaml、templates/core_skills.yaml、config/scheduled_tasks.yaml可被 YAML 解析。render-panel-snapshot与refresh-skill-inventory可通过scheduler_run.py --run-now成功执行。nightly-dream-sweep在 disabled 状态下通过run now返回skipped,不会误执行未实现的 Dream Sweep。- 使用本地面板验证页面可渲染,
render-panel-snapshot的run now可通过 nonce 保护接口触发。
[0.3.21] - 2026-06-13
新增
- 新增
scripts/render_panel.py,实现阶段 A 只读 HTML 快照面板。 - 新增
review/output/context-updates/.gitkeep,补齐上下文更新建议的待审入口。 - 生成面板默认输出到
runtime/panel/self-evolve-panel.html,包含 Overview、Review Inbox、Scheduler、Dream Timeline、Logs 五个视图。
改进
- 面板聚合
runtime/hook-runs.jsonl、runtime/evaluation-log.jsonl、runtime/learning-candidates/、review/output/、config/scheduled_tasks.yaml和runtime/skill-inventory.json。 - 面板日志数据采用摘要模型,不在 HTML 中嵌入
transcript_path、完整 transcript 路径或原始 cwd。 - Scheduler 视图在尚未配置
scheduled_tasks.yaml时显示空状态,不创建假数据。 refresh_skill_inventory.py与面板脚本支持可迁移的 Skill 路径。
验证
python3 -m py_compile scripts/render_panel.py通过。python3 scripts/render_panel.py可生成 HTML。- 使用本机 Chrome + Playwright 打开静态 HTML,确认五个视图可渲染、Review 搜索过滤可工作、Scheduler 空状态可显示。
- 检查 HTML 中不包含外部
http:///https://资源,也不包含 transcript 路径字段。
[0.3.20] - 2026-06-13
文档完善
- 新增
references/13-panel-design.md,将轻量 HTML 面板规划拆为“只读 HTML 快照”和“本地 localhost 面板”两个阶段。 - 明确面板的 5 个视图:Overview、Review Inbox、Scheduler、Dream Timeline、Logs。
- 明确面板数据源只读取 Self Evolve 自包含目录,不读取完整 transcript,不依赖外网资源。
- 明确阶段 B 的本地接口和安全边界:只绑定
127.0.0.1,写操作需要 nonce,只允许触发已登记任务,不允许任意命令输入。 - 同步
SKILL.md触发描述、核心清单、核心清单模板和 schema,使后续分析可识别轻量面板、Review Inbox 和面板设计文档。
[0.3.19] - 2026-06-13
改进
- 将 Skill 目录与 frontmatter
name从skill-evolve迁移为self-evolve,显示名统一为Self Evolve。 - 更新 Claude Code
SessionEndhook 安装器:可识别旧skill-evolve/scripts/sediment_guard.pyhook,并原地更新为self-evolve/scripts/sediment_guard.py。 - 新增
SELF_EVOLVE_*环境变量命名,同时兼容旧SKILL_EVOLVE_*,降低迁移风险。 - Headless 反递归同时设置并识别
SELF_EVOLVE_HEADLESS与旧SKILL_EVOLVE_HEADLESS。
文档完善
- 更新
SKILL.md、Hook 配置、核心清单 schema、模板与调度设计备忘中的当前名称和路径。 - 同步
review/review-log.md的标题与说明为Self Evolve。 DECISIONS.md新增 DEC-026,记录从skill-evolve正式迁移到self-evolve。TASKS.md新增 v0.3.19 改名任务记录。
[0.3.18] - 2026-06-13
改进
- 将长期产品边界从单纯
Skill Evolve扩展为self-evolve方向:除 Skill 升级建议外,纳入 Timeline Dream Sweep、定时自检、项目/用户上下文更新建议、高频工作流沉淀和文章草稿。 - 基于 MyAgents 定时任务实现,明确本 Skill 后续只借鉴任务登记、运行锁、运行 JSONL、run-now、结束条件和面板思路,不复制完整 Tauri/Rust/Sidecar 架构。
- 明确当前不立即改名、不迁移目录、不重装 hook;未来若迁移到
self-evolve,必须提供兼容安装和路径迁移方案。
文档完善
- 新增
references/12-self-evolve-scheduler.md,记录 MyAgents 调度系统研究、self-evolve命名建议、轻量launchd调度方案、面板边界和上下文更新的人在回路规则。 DECISIONS.md新增 DEC-025,记录“扩展为 self-evolve,但暂不改名”的决策。TASKS.md新增 v0.3.18 任务记录。- 同步
config/core_skills.yaml、templates/core_skills.yaml和references/02-core-skills-yaml.md中的版本、关键词与 reference。
[0.3.17] - 2026-06-13
改进
- 为 Timeline Dream Sweep 增加 session 分类与去噪策略:维护、普通 git 提交、软件更新等 session 默认只保留薄索引,不进入 Dream 报告、升级建议或文章草稿。
- 增加三层记录模型:Raw session index 保留频率和偏好,Operational pattern 低频聚合工具链摩擦点,Substantive summary 只处理实质性方法论与文章素材。
- 明确工具链失败、hook 丢失、发布失败等 session 的升格规则:同类问题重复出现或形成可复用诊断流程时,才从
index_only升格为tooling_fix。 - 明确夜间调度最终采用“脚本优先、launchd 后置”:先手动运行
scripts/dream_sweep.py,稳定后由 macOSlaunchd定时调用脚本。
文档完善
references/11-dream-sweep.md新增session_class、summary_policy、noise_reasons设计字段,以及噪音分类表和调度决策。DECISIONS.md新增 DEC-024,记录噪音 session 只建薄索引与launchd调度边界。TASKS.md增加 v0.3.17 完成记录,并把 v0.4 待办拆出 session classifier、noise gate、operational pattern 聚合和launchd安装器。
[0.3.16] - 2026-06-13
改进
- 将 v0.4 方向正式收敛为
Timeline Dream Sweep:以 Claude Code 与 Codex 双来源 session 索引为基础,按时间线识别用户研究重点、法律工作重点和 agent 协作模式变化。 - 明确
SessionEndhook 的边界:只为当前 Claude Code session 生成轻量索引,不扫描历史 session,不启动跨 session 长总结。 - 明确夜间脚本 / 定时任务的边界:补扫历史 Claude Code transcripts 与 Codex archived sessions,建立主题聚类,并只对高价值 cluster 启动独立 headless 总结 session。
- 新增 Timeline 报告层:跨主题说明一段时间内的工作重点迁移;Dream 报告继续作为单主题任务链的审计层。
文档完善
references/11-dream-sweep.md改为 Timeline Dream Sweep 跨 Agent 设计草案,补充 Claude Code + Codex 双来源、两阶段架构、统一摘要 schema、时间线维度和夜间调度边界。- 更新 v0.4 升级建议,明确首版实现顺序为“索引优先、手动 dry-run 优先、夜间总结后置”。
- 同步
config/core_skills.yaml、templates/core_skills.yaml和核心清单 schema 中的skill-evolve版本、关键词与 reference 描述。
待办事项
- 后续实现
scripts/dream_sweep.py时,应先做 source adapters、normalized session summaries、timeline index 和 topic clusters,再接入 launchd / cron / Codex automation。
[0.3.15] - 2026-06-13
新增
- 新增
references/11-dream-sweep.md,正式记录 v0.4 Dream Sweep 跨 Session 沉淀设计草案。 - 登记 Dream Sweep 的跨 session 设计草案,覆盖任务聚合、夜间扫描和报告。
改进
SKILL.md明确:当本次会话只是长周期 Skill 迭代任务的片段时,应标注“需跨 session 交叉验证”,不要把局部结论包装成完整方法论。references/08-evaluation-loop.md增加“长周期任务的片段标注”,为后续 Dream Sweep 铺垫评估边界。references/09-programmatic-gates.md补充单 session 评分不能替代跨 session 成熟度判断。templates/evaluation-record.md增加“长周期片段”和“纳入 Dream Sweep”人工处理项。config/core_skills.yaml和模板同步skill-evolve版本到 v0.3.15,并加入 Dream Sweep / 跨 session 关键词与 reference。
修复
- 修正
install_session_end_hook.py在符号链接目录下运行时的路径识别问题。
待办事项
- v0.4 实现 per-session 轻量摘要、
scripts/dream_sweep.py、Dream 报告输出和跨 session 聚类验收。
[0.3.14] - 2026-06-13
修复
- 修复多个
SessionEndhook 顺序触发时,Skill Evolve 的 headlessclaude -p可能继承父 Claude Code 会话环境的问题。 - 启动 headless 分析前清理
CLAUDECODE、CLAUDE_SESSION_ID等父会话变量,并固定cwd到 Skill Evolve 根目录,降低与 Legal Knowledge Engine 等其他 hook 的上下文串联风险。
文档完善
- 在 Hook 配置文档中补充多 hook 顺序触发时的隔离策略说明。
[0.3.13] - 2026-06-13
改进
- 新增
review/output/作为待用户查看的产物入口,升级建议写入review/output/upgrade-direction/,文章草稿写入review/output/articles/。 - 新增
review/archive/作为审完后的内部存档区,避免新产物一生成就进入 archive 造成状态含义混乱。 - 更新脚本、headless prompt、核心清单 schema 和人工审流程,明确 output 是待审,archive 是已处理。
迁移
- 已将现有升级建议和文章草稿从
review/upgrade-direction/、review/articles/迁入review/output/。
[0.3.12] - 2026-06-13
改进
- 将人工审材料统一收敛到
review/:升级建议写入review/output/upgrade-direction/,文章草稿写入review/output/articles/,纠正记录写入review/review-log.md。 - 将候选记录归入
runtime/learning-candidates/,与 hook 记录、评估日志、库存缓存和运行日志同属机器运行产物。 - 明确
config/core_skills.yaml是稳定配置源;runtime/skill-inventory.json和runtime/skill-inventory.md只是按配置扫描生成的运行缓存。
迁移
- 已迁移现有文章草稿、升级建议、纠正记录和候选记录到
review/与runtime/的新边界。
[0.3.11] - 2026-06-13
改进
- 文章草稿目录改为扁平的
articles/,不再区分draft/与published/。 - 纠正面板从 Skill 根目录迁入
reviews/review-log.md,避免根目录继续堆积运行沉淀文件。 - 新生成候选记录、升级方向清单和文章草稿统一使用
YYMMDD_文件名前缀,例如260613_<topic>.md。
迁移
- 已迁移现有文章草稿、升级方向清单、候选记录和
review-log.md到新目录与新命名。
[0.3.10] - 2026-06-12
改进
- 将核心 Skill 清单迁入本 Skill 目录的
config/core_skills.yaml,使 hook、运行状态、库存清单、沉淀材料和核心配置保持自包含。 sediment_guard.py默认读取config/core_skills.yaml,并保留SKILL_EVOLVE_CORE_SKILLS作为高级覆盖入口。templates/core_skills.yaml、reference 文档和人工审模板统一改为 Skill 内部核心清单路径。
迁移
- Skill Evolve 不再使用
~/.claude/core_skills.yaml或~/.claude/skill-evolve/;~/.claude/settings.json仅用于注册 Claude Code 的SessionEndhook。
[0.3.9] - 2026-06-12
改进
- 将运行状态、hook 触发记录、评估日志、库存缓存和 headless 日志默认迁入本 Skill 目录的
runtime/。 ~/.claude/仅保留 Claude Code 必需的settings.jsonhook 配置和core_skills.yaml核心清单,不再新建~/.claude/skill-evolve/状态目录。refresh_skill_inventory.py默认输出到<skill-evolve-root>/runtime/skill-inventory.json和skill-inventory.md。
迁移
- 已将现有运行状态文件从
~/.claude/skill-evolve/移入runtime/,并清理旧状态目录。
[0.3.8] - 2026-06-12
改进
- 移除脚本中的本机固定路径优先逻辑,默认从
scripts/sediment_guard.py所在位置推导 Skill 根目录。 install_session_end_hook.py默认从自身所在目录推导 hook 脚本路径,便于其他用户安装到不同目录。- 支持通过
SKILL_EVOLVE_SKILL_ROOT、SKILL_EVOLVE_SEDIMENT_ROOT、SKILL_EVOLVE_STATE_ROOT覆盖路径。
文档完善
references/01-hook-config.md增加路径可迁移性说明。templates/core_skills.yaml使用<skill-evolve-root>占位,不再写死本机路径。
[0.3.7] - 2026-06-12
改进
- 将人工审沉淀材料输出目录迁移到本 Skill 目录:
learning-candidates/、upgrade-direction/、articles/、review-log.md。 ~/.claude/skill-evolve/仅保留运行状态、hook 触发记录、评估日志、库存缓存和 headless 日志。- Headless prompt 新增
{{SEDIMENT_ROOT}},明确区分运行时目录与沉淀输出目录。
迁移
- 已将现有候选记录、升级建议、文章草稿和
review-log.md从~/.claude/skill-evolve/移入本 Skill 目录。
[0.3.6] - 2026-06-12
修复
- 修复符号链接目录下 hook 与 headless prompt 的路径解析问题。
- 对外 Skill 路径随实际安装位置解析。
改进
install_session_end_hook.py默认使用统一路径;发现旧路径 hook 时会原地更新,不重复追加。sediment_guard.py区分执行路径、对外 Skill 路径和备用资源路径,资源读取兼容符号链接与真实目录。
[0.3.5] - 2026-06-12
改进
- 将 headless 分析 prompt 改为短启动器:只传 Skill 路径、本次 transcript、核心清单、库存清单、门控结果和候选记录,由独立 session 先读取
SKILL.md再按 reference 执行。 - Headless prompt 继续保留
SE_EXTRACTION标记,便于 transcript 侧识别总结 session。
技术优化
- 新增
SKILL_EVOLVE_HEADLESS=1环境标记,作为 prompt 标记之外的第二层反递归防护。 - 扩大 transcript 头部标记扫描范围,降低 headless 总结会话未被识别的风险。
[0.3.4] - 2026-06-12
新增
- 新增
scripts/refresh_skill_inventory.py,自动扫描用户常用的两套 Skill 来源目录。 - 新增运行时库存文件:
~/.claude/skill-evolve/skill-inventory.json与~/.claude/skill-evolve/skill-inventory.md。 - 新增
references/10-skill-inventory.md,说明核心清单与库存清单的分工。
改进
sediment_guard.py在非排除目录的SessionEnd中最多每 1 小时自动刷新一次 Skill 库存。- Headless 分析 prompt 增加
{{SKILL_INVENTORY}},使独立分析 session 能读取当前 Skill 库存。 ~/.claude/core_skills.yaml与模板增加两套常用 Skill source,并保留旧litigation-skills键用于兼容。
技术优化
- 明确库存清单只用于介绍、检索和候选判断,不替代人工维护的核心清单,也不自动触发成熟 Skill 修改。
[0.3.3] - 2026-06-12
新增
- 新增文章机会门控:
article_opportunity单独计算文章评分、素材信号和是否应生成文章草稿。 - 新增文章素材信号识别:录屏、截图、视频证据、抽帧、多模态、能力边界、失败模式、可迁移场景等。
改进
- Headless prompt 明确文章不是升级建议的附属品;当文章机会明确时,即使 Skill 升级价值较弱,也可以生成文章草稿。
references/04-article-template.md和templates/article.md改为“实战复盘型文章”结构,贴近“从具体材料规模到结果”的写法。- 候选记录和评估日志增加文章机会评分,便于后续人工审。
修复
- 修复 headless prompt 模板读取时被内层 Markdown 代码块截断的问题,确保
article_opportunity等评估摘要能完整传给独立分析 session。
[0.3.2] - 2026-06-12
新增
- 新增
~/.claude/skill-evolve/hook-runs.jsonl,记录每次SessionEndhook 调用状态。 - hook 触发记录包含跳过原因,如
missing_session_id、transcript_not_found、excluded_project_path、core_skills_unavailable、no_text_extracted、not_considered。
改进
- 区分 hook 触发记录与沉淀评估记录:
hook-runs.jsonl记录每次调用,evaluation-log.jsonl只记录进入程序化评估的会话。 - 更新
SKILL.md、references/01-hook-config.md、references/08-evaluation-loop.md和核心清单版本到 v0.3.2。
[0.3.1] - 2026-06-12
新增
- 新增
scripts/install_session_end_hook.py,用于把 Skill Evolve 的SessionEndhook 安装到~/.claude/settings.json。 - 安装器支持
--dry-run、重复安装检测、写入前备份、保留已有 hook。
改进
references/01-hook-config.md增加 hook 稳健性说明,并将安装脚本作为推荐安装方式。SKILL.md增加内置安装器说明。- 同步
core_skills.yaml模板与运行时清单中的skill-evolve版本到 v0.3.1。
[0.3.0] - 2026-06-12
新增
- 新增程序化沉淀门控:根据核心关键词、候选 Skill、用户显式沉淀信号、方法论信号、敏感信息、历史重复和拒绝记录计算评分。
- 新增三档动作:
skip、candidate_only、generate_upgrade,避免一命中关键词就启动独立分析。 - 新增评估日志:
~/.claude/skill-evolve/evaluation-log.jsonl。 - 新增候选记录目录:
~/.claude/skill-evolve/learning-candidates/,用于人工审前排队。 - 新增
references/08-evaluation-loop.md、references/09-programmatic-gates.md和templates/evaluation-record.md。
改进
scripts/sediment_guard.py只在高置信或用户明确要求沉淀时启动 headless Claude;中置信只写候选记录。- 候选记录只保存脱敏片段,不复制 transcript 原文。
- 将“不要直接改成熟 Skill”识别为人工审边界,而不是负向沉淀意图。
- Headless prompt 现在接收程序化评估摘要和候选记录路径,输出更保守。
技术优化
- 修正历史升级建议去重目录,从 Skill 源目录改为运行时目录
~/.claude/skill-evolve/upgrade-direction/。 - 同步
SKILL.md、core_skills.yaml模板和运行时~/.claude/core_skills.yaml到 v0.3.0。
[0.2.2] - 2026-06-12
改进
- 新增
references/07-headless-analysis-prompt.md,将启动独立 headless 分析 session 的完整提示词模板从脚本中外置。 scripts/sediment_guard.py改为读取 prompt reference,并替换日期、transcript 路径、核心清单路径、输出目录和模板路径等占位符。SKILL.md与references/05-agent-prompt.md增加对 headless prompt reference 的说明。
技术优化
- 降低后续调 prompt 的成本:修改分析策略时优先改 reference,不需要改 Python 逻辑。
- 保留脚本内 fallback prompt,避免 reference 缺失时完全无法启动。
[0.2.1] - 2026-06-12
修复
- 统一 hook 事件为
SessionEnd,删除Stop hook作为主流程的口径。 - 统一 Skill 目录名与 frontmatter
name为skill-evolve,显示名保留Skill Evolve。 - 统一
core_skills.yamlschema:文档和模板改为实际使用的skill_sources、core_skills[].id、source、references[].file、upgrade_target、priority。 - 修正模板路径,移除错误的
~/.claude/Library/...路径。 - 将
sediment_guard.py纳入本 Skill 的scripts/目录,运行时输出仍写入~/.claude/skill-evolve/。 - 脱敏示例中的具体案件线索、TSA 编号和账号。
改进
- 精简
SKILL.md,删除重复工作流,明确“只生成建议和草稿,不直接修改其他 Skill”。 - 保留 ClawHub 所需 frontmatter 字段:
version、license、author、homepage。 sediment_guard.py支持优先读取 hook 输入中的transcript_path,并兼容紧凑版核心清单 schema。
待办
- 端到端启用
SessionEndhook 后,用真实会话验证沉淀质量。 - v0.3 再推进历史 session 扫描、用户配置和 Recurrence-Count 规则算法。
[0.2.0] - 2026-06-12
新增
- 约束门控(sediment_guard.py 升级):借鉴 Hermes
skills_guard.py安全扫描 + self-improving-agent 质量门控设计- 文件大小检查:升级目标文件 ≤ 100KB(与 Hermes 一致)
- 命名规范检查:references/ 文件名符合
^\d{2}-[\w-]+\.md$ - 案件特定数据黑名单:升级内容不写案号/品牌名/原被告/具体产品名
- 门控失败降级:输出 systemMessage 提示而不阻塞对话结束
- 纠正面板(review-log.md 模板 + sediment_guard.py 辅助函数):借鉴 self-improving-agent 严重程度分级
- 3 档严重程度:Critical(⚠)/ Major(✦)/ Minor(·)
- 关键词自动检测("caught me" / "gotcha" / "doesn't work" 等)
- 历史去重:agent 生成建议前先读 review-log.md 避免重复
- 历史去重(agent prompt 升级):先读
~/.claude/skill-evolve/review-log.md+ 各 skill 的DECISIONS.md+archive/避免重复建议 - 创建新 skill 建议(新增能力):当优化超出当前 core_skills.yaml 范围时(如跨领域/跨类型),agent 应建议新建 skill 而非硬塞
- 改造版"定期自省"(Hermes 借鉴):Hermes 原本每 10 轮触发,我们改为 SessionEnd 一次性自省整个会话
~/.claude/skill-evolve/review-log.md初始化(纠正面板模板)- TASKS.md(v0.2 增量任务 + v0.3+ 远期任务)
- ChatGPT DR 研究的抽取算法借鉴(写进 references/05-agent-prompt.md §v0.2 重要约束 5)
改进
SKILL.mdversion 0.1.0 → 0.2.0SKILL.mddescription 强调 v0.2 借鉴 Hermes + 新增约束门控/纠正面板/创建新 skill 建议等SKILL.md工作流加"约束门控"步骤SKILL.md加"依赖"章节(PyYAML 硬依赖)SKILL.md加"v0.3 远期规划"(扫描本地 session + 个性化上下文 + 自进化规则算法)LICENSE.txt: CC-BY-NC-SA-4.0 → CC BY-NC(按 AGENTS.md 法律专业应用规范)
待办
- agent hook 尚未在
~/.claude/settings.json启用——本版本先提供文档 + 模板 - 缺真实案件端到端测试——agent 输出质量需根据第一次实际跑动调优
- 扫描本地 Codex/Claude Code 历史 session 能力(v0.3 远期)
- 个性化上下文驱动(v0.3 远期,需
user-config.yaml) - Auto Evolve / Self-Improving Agents 规则引擎集成(v0.3 远期)
[0.1.0] - 2026-06-11
新增
Skill EvolveSkill v0.1.0 首次发布。- 主文档
SKILL.md:定位"Skill 自迭代的执行者",在每次 Claude Code 对话结束时(SessionEnd hook 触发)调用 agent 分析 transcript,输出两类产出(不直接修改 skill 内部)。 references/01-hook-config.md:SessionEnd hook 配置示例。references/02-core-skills-yaml.md:核心 skill 清单 schema(~/.claude/core_skills.yaml)。references/03-sediment-template.md:升级方向清单 Markdown 模板。references/04-article-template.md:文章草稿 Markdown 模板。references/05-agent-prompt.md:agent prompt 模板(完整版 + 缩短版)。references/06-review-workflow.md:人工审工作流。templates/core_skills.yaml:核心 skill 清单 YAML 模板。templates/upgrade-direction.md:升级方向清单 Markdown 模板。templates/article.md:文章草稿 Markdown 模板。examples/2026-06-11_video-infringement-comparator_v0.5_升级建议.md:基于某著作权案的脱敏手动示例。
文档完善
- 文档总数 8 份(SKILL.md + 6 references + 3 templates + 1 example)。
- 设计灵感:
legal-knowledge-engine的"主动识别 + 检索 archive"机制。 - 飞轮结构:工作 → 优化工作(迭代 skill)→ 附带产出(写文章)→ 行业传播 → 反馈回流。
已知缺口
- agent hook 尚未在
~/.claude/settings.json启用 - 缺真实案件端到端测试