---
title: 商品建档实操包：从供方材料到可审核草稿
type: example
last_updated: 2026-10-15
visibility: public-draft
---

# 商品建档实操包：从供方材料到可审核草稿

练习如何把供应商材料变成有来源、可核对、能恢复的商品草稿。它接续手册已有的 CAT-017，使用原创合成材料；演示工具运行确定性规则，没有调用模型或真实商品系统。

**统一版本：**`CATALOG-01 / CAT-017 / 2026-10-09.1`。对象为供方 SUP-08 的 SKU-017 便携杯，类目规则 `drinkware-2`。本规则实操包沿用这组标识。

## 带着什么问题练

运营专员有供方资料读取、商品草稿创建权限，没有发布权限。A/B 两份材料都写容量500 ml、材质PP、黑色，正常版净重都是120 g；冲突版B写150 g。任务是形成带字段来源的草稿，向人展示未决项，经具体版本确认后保存并核对结果。原始资料及其人工规范化字段在 [dataset.json](dataset.json)。真实项目先确认草稿系统允许哪些缺项，不能照搬本例的许可。

容量缺单位时必须补资料；材质缺失和净重冲突可以保留缺项草稿。冲突值不能取平均，也不能仅因B较新就选择B。条码已对应另一商品时停止创建。保存超时不等于失败：先按原业务键查询，禁止换键新建。

## 从输入走到结果

1. 先用normal完成一笔正常草稿：对照A/B来源看到500 ml、PP、黑色、120 g，经确认保存并回查DR-017。下面第3步的规则演示可直接复现；看懂结果后，再取空白单解释对象、来源与完成条件。
2. 回到同一对象，依次增加 `ambiguous-unit` 和 `weight-conflict` 条件，看哪些字段要留空、向谁补证；再写候选与问题，不必开场同时设计全部异常。
3. 在 [本地规则演示](demo/index.html) 选择输入，生成参考候选并检查字段。正常笔可以确认并保存；连续冲突纠偏练习先停在候选与确认阶段，暂不保存r1。工具只处理规范化字段；正文含义仍要按 [人工量尺](manual-rubric.md) 检查。
4. 在冲突输入里载入“错误反例”：它擅选150 g并把冲突改成supported。核对失败后回到来源，修正为净重null/conflict。这是构造反例，不是已运行模型的错误。
5. 应用 file-C/r1 的供方确认：仅将净重替代为150 g，容量、材质、颜色和发布边界保留。旧版确认失效，需确认r2。
6. r2重新确认后，注入保存后丢回执：观察unknown，再按原键查询获得合成草稿 DR-017；写入计数应始终为1。用 [答案与讲师核对点](answer-key.md) 检查。若已保存r1，先重置本笔任务再练这条链；本工具不更新已保存草稿，真实系统的更新需另行定义接口、授权和版本条件。

可先做前三笔核心任务，再扩展重复对象、拒绝、类目不支持、无效数量及提交前故障；练习时长取决于讨论深度。没有固定字数或必须填满全部表格的要求。

## 失败后具体改什么

|现象|原因与改动|再验证|
|---|---|---|
|把120/150 g变成150 g/supported|无依据选择来源；改为冲突值null并保留两条来源|字段校验拒绝错误反例；人工核对冲突解释|
|容量500被写成500 ml|单位被补写；要求供方确认单位|ambiguous-unit保持needs_input、不能保存|
|file-C确认后仍沿用r1确认|修改结果但未绑定确认版本；修订使旧确认失效|r1确认被拒绝；r2重新确认才能保存|
|超时后换键再次创建|把回执未知当未提交；改为原键查询|after-commit→unknown→readback，writes=1|
|自动检查通过却正文误读|规范化字段检查不检验自然语言理解|逐条引用原句，按人工量尺检查漏项、冲突和新变更|

## 工具与可复用材料

|文件|用途|
|---|---|
|[数据包](dataset.json)|九类输入、来源正文、字段和一笔明确修订|
|[空白工作单](blank-forms.md)|学员填写任务、方案、评测与运行接续|
|[答案](answer-key.md)|各输入应得结果、失败及修订的核对方法|
|[人工量尺](manual-rubric.md)|材料忠实性、冲突、变更吸收与未变约束|
|[下载原始规则练习ZIP](../product-catalog-workshop.zip)|原14文件快照：仅规则、诊断与恢复练习；不含本轮发现、构建、操作图和运行增补|
|[本地启动](serve.mjs)|只监听127.0.0.1的静态文件服务，不提交数据|
|[规则工具](catalog.mjs)|候选构造、字段检查、版本确认、会话内保存与回查|
|[计算器](evaluation.mjs)|重复可靠性、零失败上界和假设经济性；unknown/invalid显式返回|
|[检查脚本](check.mjs)|数量、对象、来源、权限、状态、回读与算术边界|
|[贯穿运行脚本](walkthrough.mjs)|冲突→错误反例→供方确认→旧确认拒绝→丢回执→原键恢复|
|[贯穿运行结果](worked-results.json)|本地规则脚本的实际输出，不是模型运行记录|

该ZIP只用于原始规则练习。完整解释读对应正文；新增装配程序见本页末“对应正文与运行文件”。它与原ZIP不是同一文件集合。下载并解压原始ZIP，在product-catalog-workshop目录运行 `node check.mjs`、`node walkthrough.mjs`；再运行 `node serve.mjs`，浏览 http://127.0.0.1:3005/ 。手册关联章节在知识库或网站阅读，ZIP仅包含练习文件。文件双击可能限制模块和JSON读取。演示不读取凭据、不发送请求到外部应用；“保存”只在当前页面会话内的Map中，刷新即清空。

## 迁移到真实任务

替换供方材料、对象标识、类目必填规则、授权范围与真实API。保留候选/事实、确认版本、写入结果三种区别。接入模型时，把实际响应保存为候选，先做字段检查，再由业务人员独立按人工量尺判断；不要把参考答案当模型输出。

真实POC另需验证材料提取、持久化与事务、授权/撤权、网络错误和人工接续。业务试点还要观察完整主动耗时、返工、残余错误和释放能力是否被吸收。已有商品教学基线仍是旧20分钟、新操作4＋复核5＋返工2＝11分钟；本工具没有测量这些时间，也没有产生客户收益。

关联阅读：[任务契约](../../templates/task-contract.md)、[工作蓝图](../../templates/work-blueprint.md)、[评测包](../../templates/eval-pack.md)、[方案记录](../../templates/solution-record.md)、[经济性](../../methods/70_operations/19-economics-performance-value.md)。


## 同批输入，先定位再修改

运行 `node diagnostic.mjs`。完整链使用故意漏掉file-B的上游结果，或下游擅选冲突值的规则替身；对照只把上游换回完整规范化字段，下游版本与故障保持相同。两路都用独立保留的完整夹具评分。输出包含候选字段、校验错误、诊断与修正后复测。

|输入／故障|完整链|正确上游对照|优先改什么|
|---|---|---|---|
|normal／无注入|通过|通过|没有观察到这类错误，不代表真实模型可靠|
|weight-conflict／漏file-B|失败|通过|恢复来源覆盖，复测冲突与正常笔|
|weight-conflict／擅选150g|失败|失败|修下游冲突处理；只换检索不会解决|

完整链1/3，对照2/3是构造故障的运行结果，不是模型准确率。两路都失败时仍可能同时有上游错误；对照只证明下游在该正确输入上仍失败。不得把两路差值解释为唯一根因或生产收益。更换一个组件后，必须再跑完整链和原反例；校验器不能只比较候选自己的输入。

## 读前判断与读后决策

读前先各写一句：正常、净重冲突、保存超时现在能交付什么？谁要补什么证据？读完再写一次，并指出哪一条运行证据让判断改变。正常也要确认与回读；冲突只能交带未决项的草稿；超时只能报告结果未知并原键核对。这三条可用原有walkthrough和答案验证。

再用诊断输出选择一个最小改动，保留失败前后字段及反例。准确率改善但对象匹配仍错时，写出你允许的动作子集、批准者和收回条件，参见任务契约。复核成本变化时按现有经济章节重新判断继续、缩小或停止，不将节时直接算现金。

**迁移题（先独立作答，再看[开放参考判断](answer-key.md#并发迁移题的开放参考判断)）：**审核期间，同一商品被另一位专员修改。请写出提交前要查的对象、版本、批准内容，冲突后的状态和接续负责人，以及一条能证伪你方案的测试。说明现有工具是否已实现你提出的检查；不要把提案当工具能力。

以上是阅读验收任务，脚本通过和AI走查不能代替真人独立完成证据。本次没有开展读者可用性实验。

诊断脚本：[diagnostic.mjs](diagnostic.mjs)；本轮实际输出：[diagnostic-results.json](diagnostic-results.json)。运行前读前判断，运行后按表逐笔解释失败，不只看总分。

诊断评分在脚本中按固定case ID静态表检查容量、材质、颜色、净重值/状态、来源覆盖、对象、待审状态和发布=false；预期是AI 编写、与候选生成函数分离的合成教学预期，未经领域专家确认，不调用候选生成规则来构造参考答案。它仅覆盖这些关键字段；完整候选结构及版本恢复仍由原check.mjs检查。实际教学使用还须按人工量尺读原句，不能用字段通过替代材料理解。

## 对应正文与运行文件

工作发现读[第05章](../../methods/20_work-design/05-current-work.md)，审阅与职责读[第07章](../../methods/20_work-design/07-product-interaction.md)，完整请求与候选读[第10章](../../methods/40_system/10-model-context.md)，采用、运行和改进读第16–18章。这里不再另排学习路径。

[construction.md](construction.md)只说明装配程序怎样运行和替换适配器；[interaction.md](interaction.md)用于演示操作；观察及运营页保留练习素材。旧ZIP是原14文件规则练习快照，不含本轮正文整合与新增装配文件。