bb1dcc1a58
- 新增 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 标不启用（仅本轮改动，未含他处未提交内容）
3.3 KiB
3.3 KiB
name, description
| name | description |
|---|---|
| db | muse-example 实验库的唯一数据库通道——查询/DML/DDL/SQL 文件应用全走 scripts/db.py（psycopg 直连），SELECT 结果卡片式打印即审查面。主会话与智能体要读写 PG 一律经此，不得裸连或散写一次性脚本。 |
db —— muse-example 唯一数据库通道
对应 muse API 面：数据访问层。连接事实与凭据见 db/连接信息.md（DSN 已锁死在脚本内，只连 muse-example）。
用法（仓库根目录执行，python 一律用 .venv/bin/python）
# 查询：卡片式打印（默认最多 50 行、长值截 160 字）
.venv/bin/python .claude/skills/db/scripts/db.py query "SELECT id,title FROM muse_content_work"
.venv/bin/python .claude/skills/db/scripts/db.py query "SELECT ..." --json # JSON 数组输出（给脚本消费）
.venv/bin/python .claude/skills/db/scripts/db.py query "SELECT ..." --full # 长值不截断
.venv/bin/python .claude/skills/db/scripts/db.py query "SELECT ..." --max 200 # 放宽行数
# 单条写操作（INSERT/UPDATE/DELETE/DDL）：报影响行数
.venv/bin/python .claude/skills/db/scripts/db.py exec "UPDATE ... WHERE ..."
# 参数化写操作：SQL 用 %s 占位，参数走服务端绑定（防注入；大内容不拼命令行）
.venv/bin/python .claude/skills/db/scripts/db.py execparams "INSERT INTO example_raw_content(kind,content_sha256,content) VALUES (%s,%s,%s)" --param response --param <sha> --param "短文本"
# 大对象（raw 全文）经 stdin 传 JSON 数组（避开 shell 转义 / ARG_MAX）：
.venv/bin/python .claude/skills/db/scripts/db.py execparams "INSERT ... VALUES (%s,%s)" --stdin < params.json # params.json = ["<sha>", "<完整全文>"]
# execparams 参数装载逻辑离线自测（不连库）
.venv/bin/python .claude/skills/db/scripts/test_db_params.py
# SQL 文件应用：整文件一个事务，失败全回滚
.venv/bin/python .claude/skills/db/scripts/db.py apply db/ddl/91-example实验私货.sql
# 表清单+活行数（deleted=FALSE 计数，无 deleted 列的表计全行）
.venv/bin/python .claude/skills/db/scripts/db.py tables
# A3 种子：23 型 YAML → meta 表行（幂等可重跑；字段改动=改 YAML 后重跑）
.venv/bin/python .claude/skills/db/scripts/seed_schemas.py
红线
- 只连
muse-example：DSN 硬编码锁库；严禁改造脚本去碰共享 PG 上的 muse_local / muse_slice_live / *_test。 - 软删约定照主仓：删除=UPDATE
deleted=TRUE，不物理删（example_* 表同样遵守）。 - 批量导入/嵌入等专用写路径由 import/embed skill 封装（内部同走 psycopg 直连），本 skill 承担通用查改与 DDL 应用。
- 建表/改表先落
db/ddl/文件再apply，不敲一次性 DDL——文件即审计。 - 大对象写入（raw 全文等）走
execparams参数化通道（大内容经 stdin JSON），不得把大内容拼进exec的 SQL 字符串（shell 转义 + ARG_MAX）；参数化绑定同时防 SQL 注入。
元数据驱动
库内 muse_meta_schema / muse_meta_field / muse_meta_visibility_policy 是 23 型结构本体的权威行（A3 起）；拆书与抽取的字段合同一律 query 读库取，不再读 meta/schemas/ YAML（YAML 退为设计稿与种子来源）。