Skip to content

docs(models): 新建候选模型台账 models/ + 门禁(今日记入 3 条) - #531

Merged
belliedmonkey merged 1 commit into
mainfrom
feat/models-ledger
Sep 30, 2026
Merged

belliedmonkey merged 1 commit into
mainfrom
feat/models-ledger

Conversation

@belliedmonkey

Copy link
Copy Markdown
Owner

新建候选模型台账:仓库原来只有「已出货的 config 注册表」和「生成的翻译推荐单」两层,没有「候选」这一层 —— 今天一次来了三条无处安放的模型。跟踪 issue:#530。

变更

  • models/README.md —— 入选判据(前两条是否决项:不依赖我们的服务端 · 许可能自托管/分发)+ 状态图例(candidate / spike / watch / adopted / parked / rejected)+ 索引 + 九项必备字段
  • models/audio8-asr-infinite.md 〈spike〉 — 最值钱的是 semantic VAD(對話模式的转场判断);spike = NAS 上官方 docker 跑起来,喂我们自己的中英素材
  • models/confucius4-r2t2.md 〈watch〉 — 主战场(实时转写)被 domain-design §2.4/§7 挡着,现在不动产品代码;触发条件写清
  • models/confucius4-t3po.md 〈spike〉 — 离用户痛点最近:我们的译文今天会回头改写,它从设计上就是 append-only
  • test/models-index.test.js —— 4 条断言:索引齐全 · 链接可达 · 字段非空 · 「结论」的状态与索引表那一格一致

门禁为什么必要

台账不进构建、不被运行时读 ⇒ 没有任何东西会因为「一条候选烂在那儿」而变红,只有这道门禁会。最后一条断言是真的会漂的那项(台账与索引各说各话)。写完当场就被它抓到一次:我用了 watch 但图例里没有 —— 于是补了 watch(与 parked 的区别:外部条件没到 vs 我们自己判断不值)。

记进去的坑(不是套话,是采用前必须过的)

  • R2T2 的权重是《网易模型使用许可协议》(非 OSI),与代码的 Apache-2.0 分开;
  • T3PO 的权重许可在仓库里没有单独文件 —— 记入时未核实,采用前先确认;
  • R2T2 自带 WS 服务的 secret_key 是硬编码开发占位符(上游 README 自己警告 test0102),自托管到局域网/公网前必须改掉。

边界

本目录不参与构建、不被运行时读:它是台账,不是注册表。晋升到出货 = docs/domain-design.md 意义上的领域设计变更,每条自己「治理」一行里写清改哪个 config、要先过哪条。

验证

npm test → 2317 passed, 0 failed(含台账 4 条)。README 的结构树没动 —— 那是一份 extension/ + app/ 的布局说明,顶层目录(build/ docs/ scripts/)本来也不在里面。

仓库原有三层「引擎/模型」的账(已出货的 config 注册表、生成的翻译推荐单),
唯独没有「候选」这一层 —— 今天一次来了三条(Audio8-ASR-Infinite、
Confucius4-R2T2、Confucius4-T3PO),全部无处安放,写在会话里就丢了。

- models/README.md:入选判据(前两条是否决项)+ 状态图例 + 索引 + 九项必备字段
- models/<slug>.md:一条一个文件。音频那两条 = spike(T3PO 离痛点最近:append-only
  治我们最刺眼的「译文回头改写」);R2T2 = watch(主战场被 domain-design §2.4/§7
  挡着,等 T3PO 的结论)。许可/安全坑逐条记档(R2T2 权重是自定义许可;它自带 WS
  服务的 secret_key 是硬编码占位符)
- test/models-index.test.js:台账不进构建、不被运行时读 ⇒ 只有这道门禁会红。
  查索引齐全、链接可达、九项字段非空、以及「结论」的状态与索引表那一格一致
- 新增 `watch` 状态:与 parked 的区别是「外部条件没到」而非「我们判断不值」

npm test 2317 绿。

(#530)

Co-Authored-By: opencode <noreply@opencode.ai>
Co-Authored-By: DeepSeek V4.1 Flash <noreply@deepseek.com>
Co-Authored-By: GLM 5.3 <noreply@zhipuai.cn>
@belliedmonkey
belliedmonkey merged commit dc5b4bf into main Sep 30, 2026
5 checks passed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant