> 当前实现/验收状态以 [2026-10-08 报告](verification/implementation-2026-10-08.md) 和 project-status.json 为准；下文保留早期架构/候选说明。

# 输入身份与执行回执

`commands.py run` 支持重复的 `--input <文件或目录>`，登记调用者要求保全的输入；DesignCraft的--source及LightCraft的--import自动登记。目录最多100000条目，拒绝缺失输入、链接和特殊条目。

仅藏在原生命令参数中的路径不自动登记；本功能不限制原生工具的文件访问，不是沙箱。需要保全的PDF、原图、字体或原工程应显式登记，写入目标应另选新文件。

## 执行顺序

1. 校验计划结构、领域和显式输入，记录当前技能资源及运行时锁摘要。
2. 从固定原生CLI查询实际命令目录；此阶段可能按已有授权安装依赖。
3. 校验实际命令与受支持参数约束，再次核对输入和技能资源。变化时阻止编辑，不创建输出目录。
4. 在新输出目录写入原生计划，并以暂存、文件刷盘、原子替换方式保存STARTED回执。
5. 在一个原生会话中执行计划；保存退出状态、日志和执行后的输入/技能资源摘要。

## 状态解释

- NATIVE_EXIT_ZERO_REVIEW_REQUIRED：命令零退出且登记输入/技能资源未变，仍需检查实际产物、工程重开及创作质量。
- FAILED_OR_PARTIAL：原生非零退出，可能已有部分编辑，不自动重放。
- UNKNOWN：超时、启动异常或用户中断，保留可获得的部分日志；子进程/写入结果未完全核实时不能重放。
- INPUT_CHANGED_REVIEW_REQUIRED／SKILL_CHANGED_REVIEW_REQUIRED：原生零退出但登记输入或技能资源改变，返回失败并要求复核。缺失等检查错误保留INPUT_OR_SKILL_CHANGED_REVIEW_REQUIRED。

事后摘要检查不回滚写入，也不能证明原生子进程组都已停止。该入口尚不提供未知任务自动接管、分布式并发占用或完整事务恢复。需要修改源工程时先建立明确的工作副本，登记要保全的原始输入，输出另存。

## 开发快照同步

scripts/sync_local_snapshot.py只同步当前领域的未发布本地插件。先验证旧快照完整摘要，用户改动、其他领域、已发布来源或源文件删除都拒绝，不强制覆盖。它不产生公开发行身份，不初始化Git、规格或安装工具。

此行为已用模拟子进程、独立技能副本和临时插件副本验证；真实原生、宿主、模型与创作验收继续开放。

## 原生参数Schema支持边界

PrintCraft 的参数检查先遍历完整Schema定义，再验证实际参数。未选择的anyOf/oneOf/allOf分支、未提供的可选属性和items/additionalProperties中的未知约束也会拒绝；错误定义不会被当作参数不匹配而吞掉。支持布尔Schema；enum/const按JSON数字值比较1与1.0，始终区分true与1。正则使用Python语义，不宣称完整JSON Schema支持。

JSON读取同时拒绝显式NaN/Infinity和溢出为无穷的指数（如1e10000），包括LightCraft/DesignCraft的原生文本参数计划。LightCraft/DesignCraft仍不推断文本参数的Schema；参数与状态验收由真实原生程序完成。