可检查的恢复包
把选定材料形成恢复包，独立检查完整性与可信来源。恢复前就能识别缺项，凭据仍需重新授权。
IRIS ENGINEERING · CONTROL PLANE
Iris Engineering
让工程推进有据可依
把项目事实、构建产物、试玩诊断与环境恢复连接起来，让一次研发工作能被追踪，也能接续。
WHY IRIS ENGINEERING
把研发事实、显式授权与验证边界组织成可复查的工作流
同时推进多个项目时，最容易丢失的往往是上下文：之前为什么这样决定，工作停在哪里，下一步该做什么。我做 Iris Engineering，是希望把这些信息放在一起，让下一次继续工作时少一点重新寻找。
FROM SOURCE TO PLAYTEST
知道这份构建从哪里来，也知道它运行过什么
Iris Engineering 把源代码、依赖、工具配置、构建产物和试玩结果连起来。为一个问题寻找上下文时，可以沿着同一次构建继续查下去。
确定构建输入
固定源码与依赖，检查工具、场景和所需资源，提前指出不能物化的输入。
记录构建身份
用 BuildID 关联本次构建及其执行记录，保留实际使用的配置与产物信息。
封存并检查产物
将产物整理成可核验的集合，再从封存副本进行有界试玩。
带着上下文诊断
把试玩会话与原构建关联；需要转交问题时，导出经过选择的诊断材料。
当前实际构建与试玩链路以 macOS 本地 Unity 项目为主。签名、跨平台交付与公开分发分别处理。
PICK UP WHERE YOU LEFT OFF
恢复工作环境之前，先知道要恢复什么
Continuity 整理项目档案、工具偏好和恢复材料，让环境迁移与工作接续有明确的输入、计划和检查步骤。
期望配置与实际环境对照
比较工具的期望状态和观察到的环境，列出需要采取的动作；已有目标不会被静默覆盖。
与 Violet 接续
恢复计划包含 Violet 偏好与 Workbench 的精确工具身份。项目资料与桌面创作资料各自保留恢复边界。
目前已形成本地环境中的恢复工具与测试路径；远端备份和全新 Mac 的完整恢复仍待实测。
OBSERVE · AUTHORIZE · EXECUTE · VERIFY
从事实到验证，四段互不越权
-
01
Observe
读取事实
从 Git、Gitea Adapter、本地 Snapshot 与只读报告收集事实，不复制第二套可独立修改的业务真理源。 -
03
Execute
受限执行
TaskEnvelope 与 Runner 权限求交集，AgentRun 通过 claim、lease、heartbeat 与 recovery 管理生命周期。 -
04
Verify
验证与审计
把结果、失败、边界与后续入口分开记录；未知终态不盲目重试，未取得证据就不升级结论。
CORE CAPABILITIES
组织研发工作的四项能力
从 Workflow Core 到只读视图，再到 Research Artifact 与 Agent Execution，连接项目进度、研究提案与任务执行。
01 / WORKFLOW-CORE
Workflow Core
版本化合同、状态与 Flag 规则、幂等 Inbox、Preview、Reconciliation 和 Audit。
- Closed JSON Schema
- Deterministic plan
- Inbox & reconciliation
02 / READ-MODELS
Read Models & Dashboard
Today、Milestone、Quality、Build 与 Operations 的只读投影，固定本地回环、GET/HEAD-only。
- Today / Milestone
- Quality / Build
- Operations health
03 / RESEARCH-INTAKE
Research Artifact & Proposal Ingress
把研究材料或受限 QQ 提案信封固化为不可变 Artifact 和待审批 Proposal，不自动批准、不自动改写目标仓库。
- Immutable artifact
- QQ Research Proposal Ingress
- Pending proposal
04 / AGENT-EXECUTION
Agent Execution Contract
连接授权、上下文、Runner 权限与 AgentRun 状态，保留 claim、lease、恢复和只读检查。
- Task envelope
- Permission intersection
- Claim / lease / recovery
GETTING STARTED
使用说明
先了解项目状态，再选择需要推进的工作。
- 执行任务前需要确认目标与权限。
- 外部服务的连接与操作按项目单独配置。
- 工程进度在 Iris 中组织，游戏运行时与玩法由各自的项目负责。
RESEARCH → CONTROL PLANE → FRAMEWORK → GAME
相关研究与游戏实现
01 · 技能、潜能与祝福
能力门控如何进入可玩的战斗构筑
研究中的能力门控，怎样落到技能、潜能与祝福共享的能力入口？
RESEARCH → CONTROL PLANE研究结论保留公开来源与边界，再进入 Iris Engineering 的工作流判断。
CONTROL PLANE → FRAMEWORKIris Engineering 组织授权与验证边界，SakuraGameFramework 沉淀可复用工程能力。
FRAMEWORK → GAMESakuraGameFramework 的采用映射必须回到《言铸之剑》的实际系统与公开证据。
映射只证明公开游戏实现采用了对应 Framework 包，不把 Preview 能力提升为 Supported。
02 · Run 存档
Run 快照如何获得明确提交边界
跨房间推进时，哪些事实应在明确节点提交，哪些对象不应成为持久化事实源？
RESEARCH正式文章Unity 热更新的事务提交边界：磁盘版本切换、Runtime 提交与失败恢复用热更新提交中的版本切换讨论事务边界与失败回滚。设计索引撤离型搜打撤中的风险携带、不完全信息与跨局循环追踪风险资产、所有权转移与撤离提交的设计范式。
FRAMEWORKSave项目存档测试与 Framework.Save 类型引用
GAME《言铸之剑》Run 存档
RESEARCH → CONTROL PLANE研究结论保留公开来源与边界，再进入 Iris Engineering 的工作流判断。
CONTROL PLANE → FRAMEWORKIris Engineering 组织授权与验证边界，SakuraGameFramework 沉淀可复用工程能力。
FRAMEWORK → GAMESakuraGameFramework 的采用映射必须回到《言铸之剑》的实际系统与公开证据。
研究提供的是事务边界类比；游戏页公开的仍是 Run 快照实现与已知限制，不等同于撤离玩法。
03 · 生成式祝福
生成式祝福如何安全进入能力执行
不稳定的本地模型输出，怎样经过结构化约束、白名单映射与失败回退进入玩法？
RESEARCH → CONTROL PLANE研究结论保留公开来源与边界，再进入 Iris Engineering 的工作流判断。
CONTROL PLANE → FRAMEWORKIris Engineering 组织授权与验证边界，SakuraGameFramework 沉淀可复用工程能力。
FRAMEWORK → GAMESakuraGameFramework 的采用映射必须回到《言铸之剑》的实际系统与公开证据。
当前公开证据只覆盖结构化映射与能力执行；独立 Demo、专门研究文章和外部反馈仍未提供。