zizi-al/muse-agent-example
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity
252 Commits 2 Branches 0 Tags
Commit Graph

48 Commits

Author SHA1 Message Date
zizi
f76c3cd04a docs(架构): 归档R2历史留痕并清理过程计划与实施分期标签 
- 归档并收敛 R2 历史留痕至 docs/实现回顾/R2改造历史留痕.md，删除已退出生命周期的改造计划、旧文件处置及验证过程文档
- 现行测试用例身份收敛至 tests/用例清单.json（1358条扁平登记），适配 conftest、索引维护与测试执行验证
- 清理源码、配置、SQL迁移头、测试夹具及规则文档中的 Wxx 实施分期标签与过时过程描述
- 同步重新打包构建资源清单，通过全量离线测试、模块边界、类型检查与索引双向强核验
 2026-09-16 19:09:14 +08:00
zizi
b9af240b68 R2 收尾：W30 唯一写入观察与最终验收（C08 章后接通 / 构建身份重建 / 最终备份与恢复演练） 
- 章后处理：事实提案命令身份加入类型、批内去重改为先校验后去重（REPEAT_OBJECT_TYPE 记跳过、不再静默丢重复）；查询章后状态回传事实跳过；可按需发布/核对可登记任务与 config_not_declared 语义收紧
- 模型治理：推理字符数计量（ChatCompletions/Messages/执行合同）、探针在声明关闭推理却仍有推理时拒绝、计价支持缓存协议与未知模型兜底
- 运行态：资源包重建（发布身份 21d850f7…），三处配置同步，post-extract v5 代次 5 启用，服务 PID 96675（health/ready 通过）
- 门禁：make 检查通过；离线 1008 passed；定点数据库 101 passed；最终完整备份 bkp-1f5591d8… 与空库恢复演练 verified（152 表/158 关系/迁移 45，演练库已 DROP）
- 文档与证据：运行手册、功能覆盖、工作包清单 W30 证据、测试用例清单（17 条 execution_evidence 回填 + 历史死指针说明）、目标文件清单
- 旧实现与旧库直连材料退出（含明文凭据文件移除）；新配置 配置/本机正式.toml、配置/本机维护.toml、配置/计费/、配置/运行配置/ 入库，均只含受控引用
- R2 执行证据在 .agents.local/改造/R2-20260909/（不入库）
 2026-09-16 08:23:39 +08:00
zizi
9e6f1c4481 R2 改造交付：新版模块化单体全量成果 
- src/muse 新版全模块（装配/共享/上下文/任务运行/作品规划/故事世界/正文写作/审校修订/知识方法/作者经验/效果评测/交付连载/资料研究/正式变更/元数据/接入/基础设施/编排）+ 测试树（单元/契约/集成/架构/迁移/端到端/夹具）
- 129 项功能全部实现与自动验证（功能覆盖.json/矩阵），含 W31 补齐的规则与代价/节奏安排/伏笔与承诺
- 旧实现按处置清单退出（702 条中 324 删，保护合同与未迁移条目留存有据）；web/app.py 旧工作台退役，新工作台为唯一写入口
- 数据库/旧库迁移：真实旧库内容批次迁移链（端点守卫/PG作品正文映射/质量资产缺省投影）
- 运行手册 docs/运行手册.md；W30 本机服务阶段一已运行（infra PG 为正式内容权威）
- R2 执行证据与私有运行材料在 .agents.local/改造/R2-20260909/（不入库）
 2026-09-15 12:47:42 +08:00
zizi
cf0f4fb985 W20–W24：保存知识方法、迁移框架、审校修订与案例行为的集成成果 
接续 88dd570，保存 W20–W24 已实现的共享接口、业务入口、迁移、工作台、测试与文档。
W20/W22/W23 保持 in_progress，W21/W24 保持 verified；此提交不宣称方法或规则正式启用、多轮返修、真实角色评测完成。

W25 新增实验、标定、逐调用交付与角色执行及其迁移/测试/索引留在实施工作树，原有私人和旧实现保留项不纳入。

验证：离线 571、前端 33 通过；PG 469 项通过、2 项浏览器未启用，2 项误带入的 W25 用例已移出本提交；最终任务与交付边界 37 项通过。make 检查、最终类型、84 项资源及 diff 检查通过。未重跑浏览器或 Pi 宿主，不以合成调用认证外部模型效果。
独立整体审查四维通过；证据保存在 R2-20260909/提交W20-W24。
 2026-09-13 16:24:42 +08:00
zizi
88dd570791 W19 世界设定、人物弧线与全书连续性（收口）：世界设定维护层（S04 族驱动实体浏览/轨迹/save_entity 提案→确认，新类型零代码可编辑）、人物关系（端点按引用规则解析、弧线计划/已发生分区）、设定修订影响评估（受影响事实引用反查+待决提案+章序影响，只读只标记不撤回独立确认）；HTTP 7 端点+抽取章节事实提示词+维护故事世界技能；工作台三页（世界资料/人物关系+关系图/时间与伏笔）；7 新 NC（NC-w19-*），离线 275 / 非宿主数据库 237 / 前端 27，浏览器三页旅程+视觉判定通过；整包验证退回一项（设计页尾空行致 diff-check 失败）三轮复验通过（第二轮误在原仓目录执行系任务书缺陷，第三轮带基线前置校验确认修复与证据链），W19 置 verified。 2026-09-11 11:30:21 +08:00
zizi
06fcfb32cd W18 拆书、归并、互斥与补偿（收口）：分章切窗（确定性章界/窗计划哈希/漂移守卫/覆盖核对）、逐窗模型提取（S02 证据合同、输出合同含实体引文）、确定性实体归并（同名异型必歧义不误并、合并带证据与窗归属）、分析版本（uuid5 版本身份、版本台账、失败窗单独重试、旧结论不抹）、样本选题观察陈述；研究拆书五步流程（同源互斥=排他范围领取层强制、窗口断点逐窗检查点、恢复只补缺失窗、预算含重试余量、补偿只触本任务检查点）；CLI 研究命令+HTTP 4 端点+工作台拆书工作区/原文分析对照/榜单与选题页（资料对照页退役并入资料页，structure-form 纵排修复表单遮挡）+拆解书稿/检查与维护拆书结果技能；12 新 NC（NC-w18-*），离线 275 / 非宿主数据库 231 / 前端 27，浏览器 2/2+视觉判定通过；整包验证一次通过，W18 置 verified。 2026-09-11 10:16:59 +08:00
zizi
5b22b31b74 W17 资料导入、榜单与来源管理（收口）：B03 来源/版本链/清理候选/榜单快照（V0007，原文只追加、失败保留失败态、无 run 归因）、用途授权消费门、证据码点读取、资料对照页与 8 端点、导入资料/采集资料与榜单技能；7 新 NC（NC-w17-*），离线 269 / 非宿主数据库 226，浏览器旅程+视觉判定通过；整包验证退回五项（原文版本.py 缺失、技能假绿、悬空锚点、恢复口径、tsbuildinfo）全部修复后复验通过，W17 置 verified。 2026-09-11 03:21:36 +08:00
zizi
916f527c9f W16 章后派生与连续写作闭环（收口）：S01 采纳/保存同事务登记章后任务（失败整事务回滚）、五步派生流程（来源复检/抽取配置/模型抽取/事实提案 Shadow 幂等登记/摘要与索引绑定）、失败可见且恢复重验重试、旧版本派生拒绝、确认事实增量技能；11 新消费级用例（NC-w16-*），离线 269 / 非宿主数据库 220；整包验证通过后置 verified（P1 md尾缀已统一，预算吞异常与降级测试留后续）。 2026-09-11 02:42:29 +08:00
zizi
63ead639f4 W15 通用生成、基本审校与候选（收口）：多粒度写作任务与两阶段写手（预组装→受限探索→冻结回放→无工具写作→检查入候选）、V0021 模型候选证据绑定与版本化审校报告、基础+连续性确定性检查、采纳门 CHECK_FAILED/CHECK_MISSING 禁未检候选、模型候选服务端写哈希与证据（作者决定仍走 S01）、HTTP/CLI/主会话技能/工作台创作对话接入；15 新 NC（NC-w15-* 11 + UI 3 + browser 1），离线 269 / 非宿主数据库 209 / 前端 27，真实浏览器旅程与视觉判定通过；独立整包验证退回一次后按 NC 大写前缀约定修正并复核登记门禁；W15 置 verified。 2026-09-11 01:44:13 +08:00
zizi
baf7d431a4 W14 受限上下文、工具与探索回放（收口）：B01/B02 aiContext 真投影与用途绑定、V0020 冻结快照与实际消费、确定性回放与依赖复检、工作台材料清单与来源证据、收尾补测；整包兜底验证通过后置 verified（离线263/PG204/前端24；NC-ctx 54+前端4；W15 依赖解除） 2026-09-10 23:54:12 +08:00
zizi
7f9114eca5 W13 旧用例承接补充：作者层路由与中文方法 Skill 的已跟踪文件改动 
作者场景路由与指令、完善故事基础设定/合并故事方案/制定作品规划的技能中文化重构及其脚本、对应旧测试修改、SOT 导读、技能目录与实现回顾。此为 W13 阶段对已跟踪文件的改动，随批次按阶段整理补提交。
 2026-09-10 19:39:47 +08:00
zizi
f7a57f68e6 W14 受限上下文、工具与探索回放：首切片「受限历史正文读取与材料预算」：材料预算纯函数、授权历史范围、read_history_document 具名只读工具接入 S02 并留痕；13 个新 NC 通过（离线 237、非宿主 PG 173）。W14 整体 in_progress，尚未验收。 
按 R2 串行阶段整理提交；包内文件为该阶段交付（含后续小增量），状态以工作包清单为准。
 2026-09-10 19:25:41 +08:00
zizi
224df00706 W13 渐进探索、分层规划与近期细化：私人探索、明确选定、分层规划与近期细化；含竞态修复新用例。 
按 R2 串行阶段整理提交；包内文件为该阶段交付（含后续小增量），状态以工作包清单为准。
 2026-09-10 19:25:41 +08:00
zizi
2f15c5b3bc W12 本书事实、关系与时间边界基础：本书事实、关系提案、时点边界与角色知情历史。 
按 R2 串行阶段整理提交；包内文件为该阶段交付（含后续小增量），状态以工作包清单为准。
 2026-09-10 19:25:41 +08:00
zizi
8353d11d40 W10 作品骨架与人工正文版本：作品/章节骨架、目录版本与人工正文版本链。 
按 R2 串行阶段整理提交；包内文件为该阶段交付（含后续小增量），状态以工作包清单为准。
 2026-09-10 19:25:41 +08:00
zizi
a6f4f14a81 W09 正式变更、审阅、CAS 与原子提交：S01 正式变更、作者审阅、CAS 并发与跨模块原子提交。 
按 R2 串行阶段整理提交；包内文件为该阶段交付（含后续小增量），状态以工作包清单为准。
 2026-09-10 19:25:41 +08:00
zizi
d82581daee W08 原文证据、临时租约与归档：原文证据生命周期、临时租约、调用授权与归档恢复。 
按 R2 串行阶段整理提交；包内文件为该阶段交付（含后续小增量），状态以工作包清单为准。
 2026-09-10 19:25:41 +08:00
zizi
1cbda23880 W07 统一身份接入与工作台框架：统一身份接入、HTTP 路由骨架与工作台前端框架。 
按 R2 串行阶段整理提交；包内文件为该阶段交付（含后续小增量），状态以工作包清单为准。
 2026-09-10 19:25:41 +08:00
zizi
367d01db21 W06 模型宿主、角色、预算与流式合同：模型宿主合同、角色策略冻结、预算预留结算与流式回合证据。 
按 R2 串行阶段整理提交；包内文件为该阶段交付（含后续小增量），状态以工作包清单为准。
 2026-09-10 19:25:41 +08:00
zizi
e99a952dd0 W05 任务状态、租约、事件与恢复：任务状态机、短事务租约、事件续接、恢复控制与作用域互斥。 
按 R2 串行阶段整理提交；包内文件为该阶段交付（含后续小增量），状态以工作包清单为准。
 2026-09-10 19:25:40 +08:00
zizi
b0623d9048 W04 元数据结构、扩展与字段用途：元数据结构、策略版本、字段用途投影与内置结构导入。 
按 R2 串行阶段整理提交；包内文件为该阶段交付（含后续小增量），状态以工作包清单为准。
 2026-09-10 19:25:40 +08:00
zizi
73f96255af W03 数据库、用途隔离与迁移机制：受控连接、用途角色隔离、Flyway 式迁移执行与隔离库夹具。 
按 R2 串行阶段整理提交；包内文件为该阶段交付（含后续小增量），状态以工作包清单为准。
 2026-09-10 19:25:40 +08:00
zizi
b86516505f W02 安装工程、启动骨架与验证环境：pyproject/uv 安装工程、启动装配骨架、conftest 用例身份与 OS 离线隔离。 
按 R2 串行阶段整理提交；包内文件为该阶段交付（含后续小增量），状态以工作包清单为准。
 2026-09-10 19:25:40 +08:00
zizi
50a5522014 W01 落实合同与逐用例工作清单：合同与逐用例工作清单落实（接口契约、文件设计与用例页）。 
按 R2 串行阶段整理提交；包内文件为该阶段交付（含后续小增量），状态以工作包清单为准。
 2026-09-10 19:25:40 +08:00
zizi
ca7e2944a2 fix: 校准创作链合同与生产入口 2026-09-01 17:11:40 +08:00
zizi
aea6feceb0 feat: 完成技能身份中文化与作者入口 2026-09-01 16:23:55 +08:00
zizi
76d38f2dc7 修复: 派发链硬门失败关闭与测试账本隔离 
- 模型锁定完整 ID 等值：role_policy 废弃子串匹配，前置校验+事后
  MODEL_POLICY_VIOLATION 熔断+回执 modelMatch，治理链角色放行 BUDGET_CHAIN
- 工具白名单只读机械强制：任务包 allowlist ⊆ 只读注册表，TOOL_NOT_READONLY
- 本地向量检索 truthful 化：aiContext 裁剪、指针行跳过、资格失败关闭
  （bindingStatus/productionRetrievalEligible 不再伪造 active）
- 角色提示词 name 回归英文系统 ID；planner 补 fine_outline 绑定；
  writer 数据契约对齐 writer-candidate-body-v1
- 测试账本隔离：sqlite_path 三层透传（bridge/two_phase），9 处派发测试
  改用临时库；清除 muse.db 测试残留 5 runs+26 events+reviews 5/6（有备份）
- test-inventory 补 3 条登记并机械重算 summary；评测场景补
  output_contract/fail_closed 与 stability 两类；死代码清理
  （project_paths.py、offline_only 死参数、harness/harness 残骸）
- 新增 metaphysical-diff-review 技能（红线 4.2 载体）并登记，共 59 技能
 2026-08-30 23:06:19 +08:00
zizi
d41f507dd0 框架: 建设框架无关通用指令集与纯中文治理规范，解耦宿主投影 2026-08-30 17:25:44 +08:00
zizi
1401408c7a 框架: embedding 按行落卡并用 blob COUNT 对账 2026-08-28 07:55:44 +08:00
zizi
a4b77f8baa 框架: adopt 走 flow、补齐迁移对账、派发默认不写 PG 2026-08-28 07:49:16 +08:00
zizi
e4bcb5d864 框架: 落地 muse.db、分类迁移、复利闭环与榜单归因 2026-08-28 07:04:59 +08:00
zizi
40bbf554a0 框架: 拆 dispatch_agent_task 为装配/执行/登记 2026-08-28 06:43:19 +08:00
zizi
041af960e7 框架: 清理 catalog 双投影 2026-08-28 05:38:26 +08:00
zizi
32b58e0a4a 框架: DSH 接 Pi 路由、看板从仓根解析路径，并落能力原型间收敛方案 2026-08-28 05:32:08 +08:00
zizi
9bed4a426e refactor: separate Muse business and agent framework layers 2026-08-24 02:16:01 +08:00
zizi
befb4714c0 阶段F第三部分: 评测链派发——评委智能体经ModelRunner协议接入框架派发（离线10项绿+候选123vs164真实盲评通过，164四维领先与人采纳方向一致） 2026-08-23 16:13:59 +08:00
zizi
640e17499d 阶段F第二部分: 知识链派发——抽取智能体接入框架派发（离线7项绿+第3章真实抽取产出19条草稿，修复重派路径首次真实验证） 2026-08-23 15:17:57 +08:00
zizi
d9cf5e834c 阶段F第一部分: 冻结幂等键改(manifest,context)对——候选164双门通过后被CONTEXT_NOT_FROZEN阻闸的缺陷修复（迁移114+真实库测试） 2026-08-23 14:15:09 +08:00
zizi
864c2ca380 阶段F第一部分修复: 角色合同两阶段化+生成会话独立（挂死根因：合同冲突诱导工具调用） 2026-08-23 13:43:29 +08:00
zizi
ec6bc50131 阶段F第一部分: 两阶段写手——探索与生成分离（离线绿17项，全量门禁无回归） 2026-08-23 12:38:45 +08:00
zizi
fbfc5fd5b0 生产链: 写作节点框架派发接线与授权继续流程（阶段E第二部分） 2026-08-23 02:19:54 +08:00
zizi
fabcd4ff91 生产链: 补证/重写删除业务硬上限，改为授权终态（阶段E第一部分） 2026-08-23 01:26:03 +08:00
zizi
860771a28e 能力: 只读工具server、会话复用与依赖清单（阶段D） 2026-08-23 01:10:06 +08:00
zizi
1c05b8df7b 框架: 收敛 Agent 证据链并迁移生产写作入口 2026-08-22 16:07:07 +08:00
zizi
091b66a9bb 重构: 收敛 Agent/Skill 运行时与创作质量闭环 
将角色与 Skill 从 .claude 迁入 .agent，移除 Claude CLI 运行时并接入固定 Opus 角色 profile、完整 schema、预算 deadline、raw 与回执证据链。

同步拆分 Skill 职责、复利 lesson、Gate 回放、Dashboard 人审入口、数据库登记和机械门禁；候选设计正文不包含在本提交中。
 2026-08-22 02:12:32 +08:00
zizi
061010ba1b 框架: 共享运行时装成可安装包，切断 Skill 之间的 sys.path 互指 
被多个 Skill 或看板消费的连接、模型、嵌入、Claude 运行时与声音账入口
各只保留一份实现；Skill 只留 CLI/落库，看板只读 muse-db，门禁锁死跨域注入。

Co-authored-by: Cursor <cursoragent@cursor.com>
 2026-08-20 00:45:20 +08:00
zizi
d80df3ed7c 治理: 剩余问题收口——humanization 规则/样例数据库权威 + PG 集成全通过 + 行为评测脚手架 + raw 冲突备忘录 
范围（不含 design-story-foundation、docs/design、docs/write-chapter、
craft/、humanization/README.md 等进行中改动）:

1. humanization 规则/样例运行时数据库权威
   - db/ddl/111：example_ai_flavor_rule / example_ai_flavor_sample /
     example_ai_flavor_rule_event（append-only 生命周期留痕），已应用到 muse-example
   - deai/load_db.py：数据库装载器，激活门/重复检测/指纹与文件装载器同源；
     数据库失败关闭，不静默回退 Git 文件资产
   - humanization/tools/seed_rules_db.py：YAML 种子单事务同步，幂等、
     变化留痕、--strict 对 db-only 行失败关闭；真实库已种入 26 规则/107 样例
   - prevent/diagnose/revise 生产路径切到数据库读取（--offline 显式读文件），
     落库前新鲜度检查与合同声明来源一致；四个 SKILL.md 数据库合同同步
   - 真实库验证：规则库指纹与文件种子一致（v-609bc40e21d0b5db），
     三个生产脚本端到端从库装载通过

2. PostgreSQL 集成：显式授权后 9/9 通过
   - 此前被依赖门阻断的 6 个 _db/smoke 测试全部通过
   - extract rollback 冒烟改为回滚事务内自给夹具（pending 窗/草稿缺失时自建），
     不再依赖瞬时生产状态；夹具残留核验为 0

3. Skill 行为评测脚手架（真实执行数量仍为 0）
   - harness/evals/skill_eval.py：场景合同、六类评测范畴、适配器和结构化裁决报告
   - diagnose-ai-flavor 参考场景 4 条 + 管道自测 7 项通过
   - 真实模型适配器未授权时以稳定码 EVAL_ADAPTER_UNAVAILABLE 失败关闭；
     清单登记 skill_behavior_eval 条目，默认被依赖门阻断

4. evaluate-frozen-replay raw 存储边界冲突
   - docs/2026-08-19 备忘录：平台 DB-first 合同（创始人批准）与回放链
     仓外 vault 强制的冲突事实、两个选项和裁决前约束；运行时合同未单方面改写

5. harness 自身修复
   - runner 对账语义：行为评测入口不参与测试资产双向等值，但登记文件必须存在；
     manifest 保留 skill_behavior_eval 布尔字段并校验类型
   - 新增 2 条对账回归用例

验证证据: harness 三组自测 15+15+7 通过；静态审计 32 Skill / 0 问题；
76 个非数据库条目通过；9 个 PostgreSQL 集成条目显式授权后通过；
行为评测条目默认阻断；py_compile 与 git diff --check 通过。
未调用真实模型、embedding 或额度；真实行为评测执行数量仍为 0。
 2026-08-19 02:41:25 +08:00
zizi
c9f69d9d6d 治理: Skill 测试治理第一阶段——harness 控制平面 + 实现测试迁出运行时目录 
范围（不含 design-story-foundation、docs/、humanization/README.md 等进行中改动）:

1. 新增 harness/ 控制平面
   - skill_harness.py 静态审计：32 个运行时 Skill 的 frontmatter/manifest/文档污染，当前 0 问题
   - run_selected.py 选择性执行器：manifest 与磁盘一一对账、依赖阻断、
     空跑与 skip-only 失败关闭、AST 测试形状门
   - manifests/skills.json：32 个 Skill 的合同责任方与协作领域登记
   - manifests/test-inventory.json：81 个测试资产登记
   - specs/skill-testing.md 与 README.md：测试分层、证据边界与 harness 职责

2. 实现测试从 .claude/skills/*/scripts/ 迁至 tests/skills/<skill>/
   - 71 个测试文件迁移并修复项目根与临时目录运行导入
   - 数据库触发器测试宽泛异常收窄为 psycopg.errors.RaiseException
   - 抽取离线大测试拆出真实 PG smoke（默认阻断，不计入离线通过）
   - 抽取 presence 去重边界拆出独立测试：493 + 78 = 571 项检查不变

3. 运行时文档清理
   - 13 个 SKILL.md 移除自测/离线验证段落、测试命令与测试文件事实源表述，
     只保留运行时合同；业务运行合同、额度、授权与离线模式均保留

4. SoT 同步
   - AGENTS.md：新增 Skill 领域索引（7 个合同责任方分组，覆盖 32 个运行时 Skill）
   - 领域 07：测试入口改由 harness/manifests/ 登记，SKILL.md 不承载测试命令
   - humanization 覆盖矩阵：活动测试路径同步迁移

验证证据: harness 自测 15 项 + runner 自测 13 项通过；静态审计 32 Skill / 0 问题；
73 个非数据库测试通过；8 个集成条目中 6 个 PostgreSQL 项被依赖门明确阻断；
py_compile 与 git diff --check 通过。未连接 PostgreSQL、网络、真实模型或额度。

已知边界: 真正 skill_behavior_eval 仍为 0，尚未验证任何 Skill 自然语言行为；
evaluate-frozen-replay 的 raw 存储边界冲突留待单独治理。
 2026-08-19 01:50:20 +08:00