# Lightcraft 本地实现架构

技能库维护公共运行资源，生成六份可单独安装的技能；插件消费受摘要保护的候选快照，额外提供任务和审阅控制器。开发版本 0.1.0-dev.1 与固定原生 0.2.1 分别核验，未发布候选不伪造 tag/commit。

```mermaid
flowchart LR
 R[技能库 runtime 唯一维护源] --> G[确定性生成六份自包含技能]
 G --> S[来源锁与同步预检]
 S --> P[插件快照与最小 Codex 清单]
 P --> T[显式任务控制器与 flock 锁]
 T --> Q[上游网关: 输入与输出预检]
 Q --> C[cli.py 唯一进程监督]
 C --> N[固定 Lightcraft CLI: 原生验收待运行]
 N --> J[逐步骤 JSONL / 有界日志 / 回执 v1]
 J --> U[UNKNOWN: 只读核对 不自动重放]
 J --> V[实际文件解码与目标校验]
 V --> W[内容绑定的人工或宿主审阅]
 W --> O[独立会话重开证据]
 O --> D[分层交付回执]
```

```mermaid
stateDiagram-v2
 [*] --> PLANNED
 PLANNED --> RUNNING
 RUNNING --> UNKNOWN: 超时或回执不足
 RUNNING --> FAILED_OR_PARTIAL: 已确认普通失败
 RUNNING --> VERIFYING: 步骤协议完整且退出零
 VERIFYING --> AWAITING_REVIEW: 文件与身份检查通过
 AWAITING_REVIEW --> PLANNED: 失败审阅后显式有界修订
 AWAITING_REVIEW --> COMPLETED: 视觉通过且独立重开一致
 UNKNOWN --> UNKNOWN: 只读核对 不自动重放
```

直接 argv 接口仍保留；完整逐步骤审计通过 domain/steps 计划入口。能力目录绑定二进制/版本/Headless 模式，离线目录不能授权执行。日志落盘与解析均有预算，超限保留未知和完整性事实；进程停止不证明所有后代终止。写入预检针对已知命令，不宣称通用沙箱或自动回滚。

文件可解码、格式/尺寸/位深/色彩符合、原片未变、独立重开和视觉判断分别记录；没有色彩证据时不宣称符合。任务与审阅 Schema 随插件分发，旧回执只读，修订次数不因重启重置。

详见 [实施证据与未完成门禁](verification/implementation-evidence.md)。已完成隔离原生安装、PNG/JPEG 验收、宿主六技能发现和合成图独立视觉审阅；自然语言模型分派受宿主兼容性阻塞，Canon sRAW 预览回退已验收，其他型号未据此扩展；Python 3.11/3.12/3.13 远端离线 CI 已通过，main 已推送，开发版发行仍为草稿。Connect/MCP、扩展照片能力、跨平台/ArtCraft/移动交付为独立 OPEN 变更，不由基础检查关闭。