2 Commits

Author	SHA1	Message	Date
iomgaa	3492a2994a	feat(session): 参数快照补上配方指纹与注入通道，并写定执行器抛异常的契约 ... 四件事，都来自第一个下游的 issue。 **RunRequest 新增 fingerprints。** 上下文与注入内容刻意不进快照（它们是数据不是参数）， 而这条规则把生成它们的提示词模板也一起挡在外面了。具体的失败场景：换一份模板续跑不报错， 前几步用 A 模板、后几步用 B，那次运行的数据已经废了却没有任何提示。键形状 request.fingerprint.<name>，和 model_binding 那个坐标分开——一个是「这次运行属于哪一格」， 一个是「用的配方是哪一版」，混在一个字段里事后分不开。默认空映射时一个键都不写，所以已有 配置算出来的快照逐字节不变。 **注入的通道维度不再拍平。** 一通道一键，于是「声明了通道但一条都没选中」和「压根没有这个 通道」分得开：前者是值为空串的键，后者是键不存在。有一档实验要比较的正是这两种情形。 **ActionExecutor 的 docstring 写定抛异常时会怎样**：环境故障走 ENV_ERROR 返回值，实现方真 抛了库不接管、异常原样穿出。理由在 design 0016；简言之库替它编一个结算结果就是在编造，而 副作用状态在那一刻是未知的。 **三个映射字段在构造期冻成只读。** 对抗审查发现 frozen=True 不禁止改字段里那个 dict，于是 构造期那道「快照取值必须是字符串」的校验能被绕过去：构造完往 fingerprints 里塞一个整数， 它一路进日志，要到续跑读日志时才炸——而那时这次运行已经完整跑过一遍。复用 tools 里已有的 _frozen，没另写一套。	2026-08-27 03:58:49 -04:00
iomgaa	2367d3afbc	feat(_assembly): 落成段序与注入槽；design 0010 删掉工具段模板 ... 0010 取代 0006 决策三里 tool_section_template 那一行。三条理由：两个真实消费者都是项目侧 自己把工具清单拼进上下文的（一个塞在 run 级模板里伪装成示例演示的一次执行输出，另一个的 render_tool_docs 全仓零生产调用方）；留着它的话迁移的人会去填，填完提示词里有两份工具清单， 而那个下游的验收标准是轨迹逐字段可比、变了还不报错；参考框架 pi 的内核同样不渲染，它的应用层 虽有 Available tools 段，但每行来自与 description 分开的 promptSnippet 字段——说明就算要渲染， 那段文字也不该是从校验用的 schema 生成的。四者同源不受影响，schema_for_model() 还在。 段序照唯一跑通了的下游：run 级片段 → 注入槽 → 目标级片段 → 逐步的模型输出/观察交替， 按变化频率从低到高排（供应商按前缀缓存计费）。库不合成任何 system 消息——有一个下游全程 没有 system 消息，加一条它的提示词会凭空多出一段。 注入槽每条一条 USER 消息、正文原样、不加任何分隔符（分隔符是渲染格式，归项目侧），通道按 名字排序（映射的迭代顺序取决于调用方怎么构造，用集合建出来的每进程都不同）。空注入等同有 测试守着。观察模板必须含占位符，缺了就报错——不校验的话每一步的观察会整个消失，而模型收到 的是一段看起来完全正常的固定文本。规模度量逐块问，认不得的块类型直接失败而不是当成 0。 零业务假设扫描第三次抓到我自己（模块 docstring 里写了「实验因子」），已改成中性说法。 migrations/govdoc-saas.md 登记了「模型原生工具调用没有路」这个缺口。	2026-08-10 02:48:56 -04:00