zizi-al/muse-agent-example
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity
muse-agent-example/db/表映射.md

10 KiB
Raw Blame History

muse-example 表 ↔ 主仓迁移来源映射（A2 审查面）

口径（创始人拍板③ 2026-07-10）：主仓表原样不改列；实验私货全进 example_* 前缀。 建表方式：db/ddl/ 下文件经 access-database skill apply，主仓部分为 muse-cloud/sql/muse/ 原文拷贝或逐字摘录。 已应用顺序：V1 → V3 → V5 → 90-ALTER摘录 → V26 → 91-example（2026-07-13）→ 97/98（2026-07-30）→ 104 AI 味案例（2026-08-14）→ 105/106/107/108/109 先审后入与复利闭环（2026-08-14）→ 110 声音账（2026-08-15）-> 112 角色模型策略（2026-08-21）-> 113 代理事件账本（2026-08-22）。库内表现状以 access-database skill tables 实时输出为准。 96 不启用：96-example参考作品授权快照.sql 已实现但决定不 apply（单用户本地不做多租户授权机制，2026-07-30 拍板，见领域索引 §9）；库内无该表。

主仓一致表（20 张）

表 来源迁移 叠加的 ALTER 实验角色
muse_content_work V1 — 参考书/未来新作的作品行（B1 导入）
muse_content_chapter V1 V26（order 唯一键改 partial） 分章行（B1 导入）
muse_content_block V1 V26（同上） 章正文载体（一章一 block，content_text）
muse_content_block_source_attribution V1 V30（authorization_snapshot_id→varchar(128)） 暂空置；C 线来源归因
muse_content_import_task V1 — B1 导入任务审计
muse_content_export_task V1 V9（+4 列） 暂空置；C9 导出
muse_content_command_log V1 — 写命令幂等审计（import-book/decide-candidate 用）
muse_meta_schema V3 — 23 型结构本体行（A3 入库）
muse_meta_schema_version V3 V10（active 唯一索引） 型版本（A3：每型 v1 active）
muse_meta_field V3 — 逐型字段合同行（A3 入库）
muse_meta_visibility_policy V3 — aiContext 控制项落点（A3 入库）
muse_meta_protection_node V3 V10（+6 列） 保护节点登记（assemble-context/decide-candidate/judge）
muse_meta_function_chain V3 — 功能链登记（meta/chains 的库内影子，随需入库）
muse_knowledge_base V5 — 私有参考书库 + 公共范式库（kb 行）
muse_knowledge_document V5 — 参考书原文档案指针（storage_ref 指仓内路径）
muse_knowledge_document_version V5 — 暂空置
muse_knowledge_entity V5 — 已确认知识行（B5 确认后落此）
muse_knowledge_relation V5 — 知识行间关系（二轮再启用）
muse_knowledge_draft V5 V14（两快照列→varchar(128)） 草稿知识行（B2 拆书产出落此）
muse_knowledge_binding V5 V14（同上） 作品↔库绑定（C3 起用）

实验私货表（db/ddl/91 + 92 + 93 + 97 + 98 + 104 + 110；94/95 见库内现状）

表 用途
example_reference_work 参考书档案（reference_work 型的库内实例载体）：作者/章数对账/拆书范围与状态
example_parse_task 拆书任务状态机（一章一行，scaffold/pattern 两阶段状态）——workflow 断点续跑与幂等
example_parse_scaffold 逐章脚手架：逆推细纲（3–5%）+ 实体清单 JSONB
example_knowledge_embedding 知识行嵌入边表：vector(1024)+HNSW（余弦），content_hash 幂等，挂 draft 或 entity
example_clean_log 清洗审计（92）：每次删除一行（原文/理由/模型/批次），源 txt 不动可回放
example_parse_outline 窗级大纲聚合（93）：5–10万字窗（细纲+正文）→阶段大纲；终检=细纲对账+跨段纵览
example_llm_call 逐次模型调用明细（97）：模型/token/成本/提示词哈希/raw 指针；运行态设施、append-only，不带业务公共列
example_run 运行注册（98）：一次运行一行（run_id 自然键 + 作品/触发/终态），运行级子表挂它
example_run_receipt 运行身份回执（98）：字段平移 runtime ExecutionReceipt ⊕ CAS 身份；append-only；唯一键 (run_id, sample_id, revision)
example_quality_result 质量评判账本（98）：检测/评分/审核/实验，绑候选哈希 + 量表版本；append-only；有评判就记录就可见
example_ai_flavor_case AI 味案例卡当前投影（104）：检测命中与创作反馈自动入库；shadow/canonical/rejected/archived 状态；研究限定来源只存 hash/位置/观察
example_ai_flavor_revalidation_batch AI 味来源重验证批次（104）：一次检测/重验证运行的报告哈希、日期、汇总与可用性；append-only
example_ai_flavor_revalidation AI 味逐卡重验证回执（104）：verified/stale/unavailable/card_mismatch；append-only，按批次和卡片幂等
example_candidate（105 加列） 候选表补 semantic_status/semantic_report_sha256：语义审查结果固化，接受通道 DB 兜底复检（先审后入）
example_fact_delta 事实增量提案（106）：六型闭集 DeltaProposal，绑候选哈希 + 正文证据引文；proposed/accepted/rejected/superseded；抽取结果不自动升格
example_fact_ledger 正典事实账本（106）：已批准增量随正文同事务入账，绑正文块 revision 与 command_id；append-only
example_projection_run 投影登记（107）：摘要/抽取/embedding 等派生物绑 source_revision+文本哈希；pending/completed/failed/stale；幂等键防重放，失败不冒充完成
example_lesson 经验升格登记（108）：lesson/win 证据绑 run_id+候选哈希；proposed→reviewing→promoted/rejected，DB 触发器禁止跳过评审的自动升格
example_candidate_cas 候选 CAS 状态链（109）：一次运行一条链（DRAFT/CHECKING/PASSED/REJECTED），revision 单调 +1，触发器锁方向闭集与身份不可变
example_voice_baseline 声音账（110）：技能 1 定基线产物，一作品一版本 append + supersede；grounding 门由 establish-voice-baseline 脚本强制；修订门禁与前置预防机械消费
example_agent_event 代理事件账本（113）：框架适配器归一后的子代理执行事件流（run/agent/model/tool 九类闭集），append-only；prompt/正文原文在 raw 表

暂缓建表登记（主仓有、实验现阶段未建；需要时按原样加建）

迁移 表 暂缓原因
V9 muse_content_planning_section / governance_action C2 规划确认时加建 planning_section
V10 meta 治理 8 表（command/audit/validation/impact/gray/chain_version/chain_slot/chain_node） 治理命令流实验不镜像；装配入库随阶段二
V14 knowledge RAGFlow/治理 14 表 实验用 pgvector 自持嵌入，不接 RAGFlow
V18/V21 两张 event_publish_outbox 事件出箱不镜像
V25/V28/V32/V36/V37 field_snapshot / asset_use_precheck / block_revision_snapshot / ai_generated_fulltext / task 批次列 对应场景（用量投影/市场/版本快照/SSE 瞬态）不在实验闭环内

实验写入约定

  • tenant_id=1、creator='1'、owner_user_id=1（系统主账号）——写入层统一给值；列默认仍照主仓（0/''），不改列。
  • 公共范式的全局知识行：work_id=0 + scope='global' + 挂 kb_type='global' 的库；参考书私有库 kb_type='user'。
  • 软删照主仓：deleted=TRUE，不物理删。例外：meta 种子行（muse_meta_field）幂等重跑=删旧插新（种子演练场景，豁免软删）。
  • meta 字段行 sort_order 段位约定：1–9 基础字段，11 起特有字段。
  • 双轨对应：B2 产出全落 muse_knowledge_draft(status='pending')；B5 管理员确认（仅创始人触发）= draft 翻 confirmed + 落 muse_knowledge_entity(status='active')；丢弃= draft 翻 ignored。

知识卡查询速查（实际数据约定）

本节是「现在库里实际长什么样、怎么查」，与上节「应该怎么建」互补。数字快照 2026-07-27。

  1. 查公共范式卡，型藏在中文键里。 公共范式的型不在 draft_type 列，而在 draft_payload->>'型'（中文键「型」）。查某型：

    SELECT count(*) FROM muse_knowledge_draft
WHERE work_id=0 AND deleted=false AND draft_payload->>'型'='craft';

    五型分布（共 9269 张）：trope 2300 / scene_pattern 2217 / craft 1892 / emotion 1549 / combat 1311。

  2. draft_type 列无区分力。 全部活卡（19291 张）draft_type 恒为 entity，不能拿它筛型、也不能筛公共/作品。

  3. 公共 vs 作品，看 work_id + payload「目标库」。 work_id=0 + 目标库="公共范式库" = 公共；work_id=具体书（深空之影=8）+ 目标库="本书作品库" = 作品级。注意 work_id=0 是数字 0，不是 NULL。

  4. payload 型键有两套约定（坑）。 公共范式卡用中文键 型（trope/craft…）；作品级卡用英文键 type（character/item/faction…）。查作品卡型分布要用 draft_payload->>'type'。深空之影 991 张作品卡：character 527 / item 181 / character_relation 145 / location 89 / faction 42 / event 5 / power_system 2。

  5. style（文风画像）/pacing（节奏画像）已注册但 0 张卡。 23 型 schema 全部入库且有激活版本，但拆书只抽五型（deconstruct-book 的 PATTERN_TYPES 写死）。style/pacing 是书级画像（整本书出一张），不属窗级范式五型管线，接入需另做书级画像抽取步骤，不要在五型枚举里硬加。

    • 作品级画像存储约定（创始人 2026-07-27 拍板）：work_id=8 + 目标库="本书作品库" + 型键用英文 type（与作品卡一致，不用公共卡的中文 型），借此与 work_id=0 公共范式库隔离，并把两套键约定往统一靠。

  6. 双轨后半段未跑：entity 表、binding 表当前都是空的。 muse_knowledge_entity、muse_knowledge_binding 均 0 行，所有卡 status='pending'。因此检索的「作品面」（仅已确认+已绑定）当前召不回东西，只有「管理面 admin」（含草稿）可用。公共卡与深空作品卡均已 100% 嵌入（9269/9269、991/991），嵌入不是瓶颈。

待应用实验表

DDL 表 用途 当前状态
96 example_reference_authorization_snapshot 参考作品原文件版本对应的不可变用途授权快照；同作品快照版本唯一，禁止 UPDATE/DELETE 不启用（单用户本地不做多租户授权，2026-07-30 拍板，见领域索引 §9）；DDL 留存不 apply