App 资产参考
App 是 Theseus 的独立工程和交付单元。通常应通过 Resources、Settings 和 AI 维护它；只有在 Git 审查、导入导出或排错时，才需要关心下面的文件名。
何时查这页
- 需要判断某项配置是否会随 App 一起导出或提交 Git；
- Git diff 中出现不熟悉的 App 文件；
- 导入后页面、对象、Graph、用户或模块配置不完整；
- 需要区分源 App、runtime package、运行状态和 Runtime target 设置。
App 包含什么
| 使用者看到的资源 | 排错或 Git 审查时对应的资产 |
|---|---|
| App 名称、首页和模块开关 | manifest.json |
| Page | **/*.qxpage |
| Component | **/*.qxcomponent |
| Graph | **/*.qxgraph |
| Object tree | objects.json |
| App / Saved Variable 定义 | variables.json |
| Recipe、HTTP Query、运行页翻译 | recipes.json、queries.json、i18n.json |
| App user 和 role | users.json |
| 自定义 Object、方法和数据类型 | **/*.cs，新文件通常放在 scripts/ |
| 图片、模型和其他资源 | assets/** |
| Pulsar、轴、IO 和工程联锁 | pulsar.json |
| Vision camera、inspection 和样本引用 | vision/project.json 与 vision/inspections/** |
| PLC 工程 | plc/plc.qxplc、plc/pous/** 和 plc/io-map.json |
目录名称是创建约定；Page、Component、Graph 和 C# Script 可以位于 App 中的受管路径。请优先从 Resources 新建、移动和重命名，让引用检查与诊断同步工作。
哪些内容会一起移动
| 内容 | Git / 源 ZIP | runtime package | Runtime target / 本机状态 |
|---|---|---|---|
| Page、Graph、Object、设置和 Asset | 是 | 只包含运行所需版本 | 否 |
| App user 和 role | 是 | 是 | 登录会话不随包移动 |
| 构建产物 | 不应作为源文件维护 | 是 | 目标加载已部署版本 |
| Saved Variable 当前值 | 否 | 否 | 属于该 target 的 App 运行状态 |
| Console、故障记录和 Vision run detail | 否 | 否 | 属于运行状态 |
| Runtime target 账户、License 和 endpoint | 否 | 否 | 属于每个 target |
| 编辑器 Tab 布局和本机偏好 | 否 | 否 | 属于当前桌面用户 |
| AI 会话历史 | 不在 App 工作区 | 否 | 由桌面端按 App 分开保存 |
源 ZIP 用于备份和迁移设计，不包含 Git 历史或当前运行状态。runtime package 用于部署执行，不能替代源 App 备份。
关键规则
- App 必须设置首页，运行页和 Player 才能稳定进入默认 Page。
.qxcomponent是独立的 App 级 Component，不保存在某个 Page 内。- Query 是 App 级 HTTP 调用合同；不要在多个 Page 中复制请求配置。
variables.json保存 Variable 定义和初始值，不保存 Saved Variable 的当前运行值。- App user 随 App 移动；Editor Qixin 和 Runtime target 账户不会随 App 移动。
- Runtime target、Vision Engine endpoint 等机器设置不属于 App。迁移到新机器后需要重新连接和检查。
- Graph、C# Script 和 PLC 的运行产物由 Build 生成。不要把派生产物当作唯一源文件。
- 不要在 Page、Graph、普通对话或 Git 中保存密码和 API Key。使用项目认可的凭据流程，并在导出前检查 Query 认证配置。
如何验证一个 App
- 在 App Hub 打开 App；无法通过 schema 检查时先按错误定位源资产。
- 在 Resources 确认 Page、Object、Graph、Script 和启用模块是否齐全。
- 在 Settings 确认首页、Variable、Recipe、Query、i18n 和 App user。
- 打开 Problems，修复阻止保存或构建的问题。
- 对 Graph、Script 或 PLC 修改执行 Build。
- 选择正确 Runtime target，Run 或 Debug 并从运行页验收。
- 需要交付源工程时，再通过 Git 或源 ZIP 验证可恢复性。