docs: 核对任务书 01 后修正结构.md 与方法.md

- 结构.md:vocab 上限 1100;依赖图重画,使同一行确实互不依赖(flow 依赖 config,原图把它们放在同一行)。
- 方法.md 第五部分:入口编号由程序分配;实现与消融实现不设代码字段。4.3 ⑨ 补回设计-16 原文:因子与保障同行时核验员只写一句提醒、不判越界。
用户同意执行者的第 1、3–7 条("同意 A,vocab 上限改为 1100 行"等,见 97a4359 说明)。

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
This commit is contained in:
2026-10-01 23:59:35 -04:00
parent 97a43591a3
commit 20fca73847
3 changed files with 13 additions and 12 deletions
+7 -6
View File
@@ -4,7 +4,7 @@
来源:
- 用户 2026-10-01 认可"按负责一件事来切"、下面这套模块与可替换点,以及步骤清单和账本记录种类。
- 用户 2026-10-01 同意:提交的字段定义放 vocab,submissions 只判收不收;vocab 可放规范序列化和哈希两个函数,上限调到 600 行。
- 用户 2026-10-01 同意:提交的字段定义放 vocab,submissions 只判收不收;vocab 可放规范序列化和哈希两个函数,上限调到 600 行;执行后实际 1030 行,用户同意上限改为 1100 行。
- 依据是两次开发调研。一次是模块切分,参考了 Parnas 1972 与 1979、Ousterhout、Cockburn 和同类项目的源码;一次是同类研究的实验设计。
---
@@ -43,18 +43,19 @@
| 外部 | jev(Jev 判别) | 问法、阈值、校准 | 无 |
| 纯计算 | rules(研究规则) | 全部公式和常数;信念本、战绩、余额的计算 | 无 |
另有一个 **vocab**(共用词汇),所有模块都可以引用,上限 600 行。一样东西要有两个互相不能引用的模块都用到,才放进 vocab;只有一个模块用的,放在那个模块里。它放:
另有一个 **vocab**(共用词汇),所有模块都可以引用,上限 1100 行(多出来的主要是发给模型的字段说明)。一样东西要有两个互相不能引用的模块都用到,才放进 vocab;只有一个模块用的,放在那个模块里。它放:
- 共用的类型和名单:角色、研究者阶段、提交种类、指标定义、运行定义与运行结果、模型用量;
- 每种提交的字段定义(用 TypeBox 写,同一份定义既是类型,也用来检查收到的数据,也是发给模型的提交工具参数);
- 只有两个函数:规范序列化和哈希,保证"内容相同就得到同一个指纹"只有一种算法。
依赖只能往下,同一层之间不互相依赖:
依赖只能往下,图中同一行的模块之间不互相依赖。谁具体能依赖谁,以上面的模块表为准,`npm run check` 按那张表检查。
```
入口 plugin
组织 flow export config
materials submissions
组织 flow
export
materials submissions config
外部 ledger agents runner tasks workspace jev
纯计算 rules vocab(谁都能用)
```
@@ -189,7 +190,7 @@
| runner | 500–900 |
| tasks | 契约 150–300;填圆 600–1000,另有 Python 文件 |
| export | 500–900 |
| vocab | 450–600 |
| vocab | 上限 1100 |
---