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

17 Commits

Author SHA1 Message Date
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
476bb71da4 框架: 去AI味与人感资产层入库——humanization 规则库（26 条 active，其中 16 条经所有者留痕豁免 holdout 激活）与五技能先行验证副本 2026-08-16 03:04:12 +08:00
zizi
b0bc7a8745 框架: 技能按动作-对象重组 + 先审后入创作闭环 
一、技能重组（动作-对象命名）
- 旧目录 clean/confirm/continuation/db/detect/embed/… 重组为
  clean-book-text/decide-candidate/write-next-chapter/access-database/
  check-content-consistency/embed-knowledge/…（git 识别为 rename，内容保持）
- agents/*.md、AGENTS.md/CLAUDE.md 收编、example_skill 登记表同步新名

二、先审后入创作闭环（本次核心）
正文接受从"机械门一过就写正典"改为"机械门+语义审查双通过+用户批准+单事务原子提交"，
DB 级兜底，编排层跳步即被硬拒。
- candidate_cas.py + example_candidate_cas(109)：持久化 CAS 状态链
- fact_delta.py + example_fact_delta/example_fact_ledger(106)：结构化事实增量，
  模型只提六型闭集增量+正文证据引文，仅用户批准的增量随正文同事务入账本
- projection_registry.py + example_projection_run(107)：投影登记与恢复
- acceptance_state.py：接受前置实时状态重读
- lesson_registry.py + example_lesson(108)：经验升格链，禁止自动升格
- DDL 105：example_candidate 增 semantic_status/semantic_report_sha256
- write_canonical.accept：语义兜底+同事务合并增量+登记投影；
  run_writer_pipeline/persist_writer_run/run_writer_semantic_detector/step2 接入全链
- claude_runtime：兼容新 CLI modelUsage 信息字段

三、审查修复（独立子代理四维审查后）
- 事实增量 propose→approve 翻态正道，不撞唯一键
- 冻结配置探针重刷（CLI 2.1.211→2.1.231 漂移），profileSha256/adapterVersion 再登记
- 可视化合同悬空路径/五六空间矛盾、 SoT 旧技能名漂移、行尾空白清理

测试：离线 65 套 + 真实库集成 5 套（CAS/接受故障注入/事实增量/投影/经验升格）+ 回放 79 项全绿。
创作内容（docs/design、生成正文 artifacts）按"框架与创作分开"未入本提交。
 2026-08-14 10:24:08 +08:00
zizi
c501a4a5cb 框架(评测隔离): 实现六原则的引擎强制层 
- DDL 103：run_type 插入后不可变触发器(评测性锚点钉死)；生产只读角色 muse_read + RLS(评测候选对生产读默认不可见，app.eval_visible opt-in 才可见)；已验证 root可见/muse_read不可见/opt-in可见
- invariant_checks.py：常设不变量(从靠预防迁到靠发现)——I1评测候选未接受/I2正文来源不追溯评测候选/I3评测质量结果可过滤/I4 oracle红线/I5 COMPLETED轮次封存(声明==实际落库)，已跑通全PASS
- 原则1/2(口号升级/代价明账)已落 SoT；原则3/4/5/6 实现层完成
 2026-08-01 01:24:43 +08:00
zizi
98355893ab 框架(数据库+运行时): 落库 101 raw 两表，建 raw 落库机制 persist_raw，raw 合同改写 
- example_raw_lease(元数据) + example_raw_content(全文)，访问控制+append-only，
  (lease_id,content_sha256) 幂等、kind 拒 candidate(候选不进 raw)、密钥列级 CHECK
- persist_raw.py：租约+全文落库，写入前密钥标记过滤(实测拒 api_key)，dry-run 已验证
- runtime SKILL.md raw 合同改写：落库为主、仓外 vault 降为可选备份、废时效语义、密钥双禁；
  评测 harness COMPLETED 判据改造记为重活后续
 2026-07-31 22:56:57 +08:00
zizi
96aa1e61a3 框架(数据库+读取器): 落库 100 规划+冻结表，建冻结落库模块 
- example_planning_section(规划/细纲/设定，书级/章级双部分唯一索引，shadow→confirmed)
  + example_context_freeze(冻结清单，append-only，manifestSha256 幂等)
- persist_context_freeze.py：assemble_context 之后由调用方落冻结(manifest/context哈希+纳入来源+省略项+预算)，
  组装器保持不碰库(合同如此)；dry-run 已验证
- read-context SKILL.md 增冻结落库挂点说明
 2026-07-31 22:29:55 +08:00
zizi
aa82445ec7 框架(数据库+确认通道): 落库 99 候选+决策，建正文 Canonical 写入层，confirm 改 DB 语义 
- example_candidate(七态状态机，DB 级评测候选禁接受硬拒 05§8.4) + example_user_decision(append-only+理据)
- write_canonical.py：accept/discard 单事务(写正文块CAS revision+1→来源归因落块→命令幂等→决策归档→翻候选态)，
  任一失败整体回滚；dry-run + eval/draft 守卫已验证；复用 db skill DSN
- confirm/SKILL.md 从 git commit 语义改为写库语义(正文走 write_canonical；知识卡走双轨；规划暂 git)
 2026-07-31 11:02:16 +08:00
zizi
6728815174 框架(数据库): 落库 102 智能体/技能登记表 + 登记脚本（看板智能体空间数据源） 
- example_agent_role（5 角色）+ example_skill（24 技能），可变表带公共列
- 登记表是 Git 侧配置权威的库内影子（类比 meta_function_chain），Git 仍是权威
- sync_agent_registry.py：从 .claude/agents/*.md、.claude/skills/*/SKILL.md 抽 frontmatter
  + 尽力抽取涉及表名，upsert 入库，幂等可重跑；已登记 5 角色 + 24 技能
 2026-07-31 01:03:22 +08:00
zizi
bb1dcc1a58 框架(数据库): 落库 97/98 运行级账本四表并加固，db skill 增参数化通道与只读 query 
- 新增 example_llm_call(97)、example_run/example_run_receipt/example_quality_result(98)
- 加固：全对象幂等(IF NOT EXISTS/OR REPLACE)、append-only 表加 TRUNCATE 防护、
  运行终态闭合约束、token/成本非负与 model_match 一致性 CHECK（已 DROP 空表重 apply 验证）
- db.py：新增 execparams 参数化写（%s 服务端绑定+语句白名单+stdin 大对象）；
  query 改只读连接(拒 INSERT...RETURNING)；tables 用 sql.Identifier 安全拼接；connect() 统一入口
- 表映射登记 97/98、96 标不启用（仅本轮改动，未含他处未提交内容）
 2026-07-31 00:30:54 +08:00
zizi
2666d50a8e 修复: 收紧授权用途与导入任务匹配 
阻断允许用途与禁止用途冲突，并让授权快照外层与内层保持一致。
导入任务按参考作品原文件唯一匹配，避免无关成功任务误阻断回放。
 2026-07-19 22:19:47 +08:00
zizi
40c1fa4864 框架: 建立参考作品授权快照与原文件版本 
新增 append-only 授权快照 DDL，并以原文件 SHA-256 固定参考作品来源版本。收紧 loader 唯一来源证明链、授权用途和时效失败关闭，保持数据库待 apply、真实记录未写。
 2026-07-19 21:53:50 +08:00
zizi
9a513e79b8 feat(llm): 全局额度治理chat_governed——5h窗计钱计次/超$10自动切链/满4000次跳窗/共享账本,四调用方降级链上收 
额度系统(item4,创始人2026-07-16拍板):llm.py 新增 chat_governed 统一入口——按5小时窗(00/05/10/15/20,末窗20-24)计钱计次;MiniMax(M3/M2.7)超$10/窗自动切 glm-5.2→deepseek-v4-flash;满4000次/窗自动睡到下一窗续跑;共享账本 example_llm_quota 原子累加,多分片共用一本;连接短开短关(LLM/睡眠期不持DB连接,治Tailscale空转)。parse_llm/parse_outline/parse_ingest/review_cards 各自的降级链上收复用统一路由,保各自异常契约(SensitiveHardStop/SensitiveError/判重保守keep)。新增离线单测 test_quota.py(9例:窗口归窗/计价缓存折扣/六条路由)+DDL db/ddl/95。

主代理亲验上线:9条离线单测亲跑全过;真调用对账端到端闭合(算11.04配额单位≈服务端实扣11);账本两笔原子累加正确;校准噪音已清空、额度从零起。

review_cards.py 一并携带批9c崩溃修复(连接读/算/写三段拆分+分片--shard+敏感降级),五书全量重审赖此收官。批9c收官锚点入 README§九+docs方案doc;深空升格样张入档。
 2026-07-16 23:49:04 +08:00
zizi
4369984c9c 框架: 作品面入库方案v6定稿(创始人认可+四轮评审)+升格5工作表建表 2026-07-14 21:54:05 +08:00
zizi
c3f9688ccb 框架: B4-S3 出卡权上移窗级——章级候选线索+窗级聚类母卡+间隔机械计算+嵌入判重 
- parse_llm 拆 chapters/cards 两命令:章级一遍正文产细纲+实体+范式候选线索;窗级按大纲窗行聚类归并出母卡+多实例章号
- parse_ingest 新增 cards 窗级入库:实例域校验/间隔章号差机械追加(伪精确灭绝)/嵌入判重0.85归并终判/越合同字段裁剪降级/占位符机械检测
- parse_outline 幂等键改 from_order(流水号重跑漂移)+书末残窗必成窗+--to 限域
- 出卡环加拒卡带因重试+0卡可疑重试(M3 输出方差实测)
- review_cards CRITERIA 补实测间隔可信例外+溯源豁免区说明(防审核假阳)
- 章级判重名录随窗级聚类废除(重跑自噬两补丁退役)
 2026-07-13 21:22:11 +08:00
zizi
1e15b05ff7 框架: 窗级大纲聚合落地(创始人拍板)——93表+parse_outline(5-10万字窗细纲+正文→阶段大纲;终检=逐窗细纲对账+跨段纵览);表映射补登92/93 2026-07-13 17:37:42 +08:00
zizi
11cdf93347 框架: 基础面验收轮——import解析器补双章区间号/分页尾巴/残破实体三规则(机战无限2901章找回巨章内71双章,超神机械师1455章清11分页空章);quality_report交付(字数/分章/章题/段落/垃圾嫌疑五面);clean skill交付(LLM探测+代码精确删除+守卫规则+审计表92);parse_ingest键名归一(StructuredOutput仅ASCII键教训);README§九刷2026-07-13快照(compact锚点) 2026-07-13 11:44:11 +08:00
zizi
ce1ab01b6d 框架: A2收口——三域20表按主仓DDL原样建成(V1/V3/V5全文+V9V10V14V26V30触表ALTER摘录)+example_*四表(嵌入边表vector1024+HNSW);db skill交付(psycopg直连/卡片打印/文件事务);表映射与暂缓登记落档;README拍板台账①-④全拍+基座状态刷新 2026-07-13 10:23:41 +08:00