应用包结构（必须有什么）

读者：要从零手工搭一个可运行工作区应用的人。 运行时根目录：{RUNTIME_DIR}/workspaces/{workspaceId}/apps/{appSlug}/

---

1. 完整目录一览

{appSlug}/
├── app.json                 # 界面与数据模型（作者主改）
├── manifest.json            # 清单（平台写入：显示名、程序集、intents…）
├── data/
│   └── app.db               # 业务 SQLite（平台按 entities 建表）
├── schema/
│   └── 001_init.sql         # 由 entities 生成的 DDL
├── logic/
│   ├── handlers.py          # 自定义动作入口（有 script 动作时必须可执行）
│   └── *.py                 # 可选：业务辅助模块（如 generate_profile.py）
├── scripts/                 # 可选：组装/工具脚本（invoke 时拷入沙箱）
├── assets/                  # 可选：HTML 模板、静态资源
├── references/              # 可选：pipeline.json、field-mapping.json 等
└── skills/
    └── SKILL.md             # 供智能体对话调用的说明（常由平台生成）

---

2. 必选 vs 可选

2.1 最小可用应用（仅本地登记 + 列表）

例如「记事本」：只有 form + list，走内置 CRUD。

2.2 带「一键办事」的应用（动作 + 可选取数）

例如「员工画像」：action_form + 历史列表 + 脚本取数出 HTML。

---

3. 调用时哪些目录会进沙箱

执行自定义动作时，平台把下列目录拷到临时工作目录（不会把整个应用目录原样挂载）：

• logic/（必须有 handlers.py）
• scripts/
• assets/
• references/

不拷贝：data/、schema/、skills/、app.json、manifest.json。 业务库路径通过环境/ctx["app_db"] 注入。

因此：业务脚本要用的模板、流水线、辅助 py，必须放在上述四个目录之一。

---

4.1 产品内「应用包」面板

打开轻量应用后，顶栏「应用包」可浏览上述目录中的文本文件，并对白名单路径编辑保存（与应用开发助手可写范围一致）。app.json / manifest.json 为只读预览。详见 取数与流水线 §8。

---

5. 各文件职责（速查）

---

6. 与「界面增加功能」的对应关系

详细步骤：动作与handlers · 取数与流水线 · 手工搭建指南。