hhzz-inventory-trace

库存异动追溯

开始前必须阅读 ../hhzz-shared/SKILL.md。本 Skill 只查询，执行前读取 material、label、batch-no、material-inventory、amount-adjust、attr-adjust 和相关单据对象的 --help，不需要查询写入 schema。

适用请求

• “为什么 MAT-001 的库存少了 10 个？”
• “追查这个批次最近一周发生了什么库存变化。”
• “这个二维码是谁调整的，关联哪张单据？”

只查询当前库存余额或物料详情时，不使用本工作流。

必要输入

物料编码、批次号、二维码或相关单据至少提供一个；可以补充仓库、仓位和时间范围。未指定时间时，使用系统当前时间计算最近 7 天的毫秒时间戳，不凭语言模型心算日期。

用户提供名称、片段或含糊的“这批货”时，先通过只读命令解析候选，并要求确认唯一物料、批次、二维码或单据；内部 ID、事件类型和关联对象 ID 由 CLI 查出，不向用户索取。默认最近 7 天属于查询默认值，可以直接说明后执行；扩大范围或改用其他唯一条件前需说明原因。

执行流程

本 Skill 只执行查询，不调用 amount-adjust import 或 material-inventory import 修改库存。授权验收环境如需准备非空事件，必须由测试流程单独执行写命令，并遵守共享规则中的预览、确认和写后回查要求。

1. 使用 material、label 或 batch-no 将外部编码解析为查询所需的唯一 ID 和维度；多条结果先要求确认。
2. 使用 material-inventory list change-log 查询普通库存增减，保留动作、方向、数量、仓储位置、操作人和时间。当前生产返回结构不包含关联单据 ID、类型或编号；请求支持按关联单据筛选，不代表响应会返回这些字段。
3. 使用 amount-adjust list order 与 amount-adjust list record 查询数量调整来源。
4. 使用 attr-adjust list record 查询属性调整；openFlag 是生产服务内部标记，不得作为 CLI 参数发送。
5. 使用 material-inventory list freeze-log 查询冻结和解冻事件。
6. 只有用户已经提供关联单据，或前置查询已确定关联单据类型及唯一 ID/编号时，才选择当前已注册的关联对象命令补全业务来源。不得从普通库存变动记录推断 orderType 或 orderId：
   • 1 生产任务：produce-task detail；3 入库单：inbound-order detail；5 生产工单：work-order detail base。
   • 6 出库单：先用 outbound-order list --code <编号> 取得 ID，再用 outbound-order detail --id <ID>；7 调拨单：先用 transfer-order list --code <编号> 取得 ID，再用 transfer-order detail --id <ID>；这两个详情接口不能直接按编号查询。
   • 8 库存调整单：amount-adjust list order 或 amount-adjust list record；10 库存盘点单：inventory-counting detail。
   • 4 销售订单当前只能用 sales-order list 按返回的唯一编号或 ID 精确筛选，不能伪造详情命令。
   • 2 采购订单、9 质检任务、11 库存转换单、12 称量任务、13 嵌套任务当前没有对应详情 CLI；999 表示未知。保留用户提供或其他来源明确返回的原始类型、ID 和事件证据，并标记“关联对象尚未闭合”，不得猜测其他命令。
   • 数量调整记录返回 amountAdjustOrderCode，属性调整记录可返回 relCode，冻结记录可返回 orderCode；这些来源可以展示原始编号，但只有业务类型也明确时才能继续选择详情命令。普通 change-log 没有这些关联字段，必须标记“关联单据未由当前接口返回”。
7. 合并并按业务发生时间升序生成事件线；重复记录保留来源但只计算一次影响。

归因规则

• 每个结论必须回指至少一条包含时间和业务标识的记录。
• 变化动作只使用 --help 中来自生产 MaterialInventoryActionEnum 的全集：in、out、receive、issue、amount_adjust、attr_adjust、counting、contain、import、label、inventory_conversion、freeze、thaw、weighing；动作和增减方向分别展示，不根据英文动作自行补造业务状态。
• 区分普通库存变化、数量调整、属性调整、冻结、解冻和在途状态，不把属性变化解释为数量变化。
• 关联单据查不到、事件缺少数量或前后记录无法连接时，标记“证据不足”，列出尚未闭合的事件。
• 所有查询均为空时，结论只能是“所选条件和时间范围内未查到库存事件”；可以在用户同意后扩大时间范围或更换唯一条件，不能解释为库存从未变化。
• 认证失败或权限不足时立即停止并按共享规则返回；部分来源查询成功、部分失败时保留已取得证据，并把最终结论标记为“部分完成”。
• 不输出凭证、完整生产响应或无关人员信息。

输出

按共享规则的六部分格式返回，并增加按时间排序的事件表：时间、类型、增减方向、数量或属性、仓库仓位、操作人、关联单据和证据命令。结论说明最可能来源及仍未闭合的部分。

脱敏的非空生产验收结果见 references/verified-result.json。案例编号和 ID 只能用于解释证据，不得复制到其他租户执行。