PolyLoop

iomgaa/PolyLoop

Fork 0

Commit Graph

Author	SHA1	Message	Date
iomgaa	c5c1e68706	docs(design): 按两轮硕士生冷读改 0009 与 0010 0009 最实的一条是文档与代码对不上：文档说那条扫描测试断言 __dataclass_params__.kw_only，而代码实际查的是构造签名。冷读的人正确地指出前者守的范围更窄——哨兵写法 KW_ONLY 达成了同样的效果但那个标志是假（会误杀），而 kw_only=True 的类里用 field(kw_only=False) 开口子那个标志仍然是真（会漏掉）。文档改成描述实际做法并写清楚这条理由。另修：「长六个字符」实际是五个；补上两种写法的区别、Pydantic AI 那条「超过一个位置参数」与本文「一个都不许」的差别来自处境不同、规则作用域只管数据类（NamedTuple 与 pydantic 绕得过，是已知边界）、以及 §1.3「新增字段必带默认值」为什么不受影响。 0010 最实的一条是论据自相矛盾：决策二拿「跑通了的下游逐字一致」当段序依据，决策三又说那个槽位在那边至今没实现、收到非空注入直接抛错。改成说准——它证明的是有人设计装配顺序时把槽位放在了这里，不是这个位置在真实提示词里验证过。另补一节「读本文需要的几个名字」（注入/通道/ 解释器/合成观察/四者同源/pi 全是首次出现即使用，而且「Skill 条目」「工件」「Injection」三个说法指同一样东西却没有一处对上）；承认库实际还定了消息边界的粒度，超出了「只管顺序槽位规模」那句话，并给出这条线画在哪的判据；说明「变化频率」指的是跨运行而不是一次运行内部；补上规模量出来给谁用、模板为什么在构造请求时就校验、以及为什么不回填解释出来的动作。	2026-08-10 03:15:46 -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

Author

SHA1

Message

Date

iomgaa

c5c1e68706

docs(design): 按两轮硕士生冷读改 0009 与 0010

0009 最实的一条是文档与代码对不上：文档说那条扫描测试断言 __dataclass_params__.kw_only，
而代码实际查的是构造签名。冷读的人正确地指出前者守的范围更窄——哨兵写法 KW_ONLY 达成了同样
的效果但那个标志是假（会误杀），而 kw_only=True 的类里用 field(kw_only=False) 开口子那个
标志仍然是真（会漏掉）。文档改成描述实际做法并写清楚这条理由。另修：「长六个字符」实际是
五个；补上两种写法的区别、Pydantic AI 那条「超过一个位置参数」与本文「一个都不许」的差别
来自处境不同、规则作用域只管数据类（NamedTuple 与 pydantic 绕得过，是已知边界）、
以及 §1.3「新增字段必带默认值」为什么不受影响。

0010 最实的一条是论据自相矛盾：决策二拿「跑通了的下游逐字一致」当段序依据，决策三又说那个
槽位在那边至今没实现、收到非空注入直接抛错。改成说准——它证明的是有人设计装配顺序时把槽位
放在了这里，不是这个位置在真实提示词里验证过。另补一节「读本文需要的几个名字」（注入/通道/
解释器/合成观察/四者同源/pi 全是首次出现即使用，而且「Skill 条目」「工件」「Injection」三个
说法指同一样东西却没有一处对上）；承认库实际还定了消息边界的粒度，超出了「只管顺序槽位规模」
那句话，并给出这条线画在哪的判据；说明「变化频率」指的是跨运行而不是一次运行内部；补上规模
量出来给谁用、模板为什么在构造请求时就校验、以及为什么不回填解释出来的动作。

2026-08-10 03:15:46 -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

2 Commits