工作区应用 SDK（appsdk）
1. 手工搭建指南.md — 总路线与检查表（先建立全局图）
来源 sdk/appsdk/README.md
目录名：sdk/appsdk 用途：让人读完本目录即可理解并手工搭建工作区轻量应用（界面描述 + 包内脚本 + 可选取数流水线）。
建议阅读顺序
- 手工搭建指南.md — 总路线与检查表（先建立全局图）
- 界面描述规范.md — 手写
app.json（实体 / 视图 / 动作） - 视图与布局.md — 为何只有三种视图；按设计图/截图该怎么做
- 应用包结构.md — 目录里什么必须有、invoke 拷贝哪些
- 动作与handlers.md — 界面加功能后如何写
handlers.py - 取数与流水线.md —
pipeline.json、平台桥、组装报告 - 助手知识摘要.md — 应用开发助手 / 创建向导常驻规则（与嵌入副本同步）
机制总览（HTTP / 对话创建）：工作区应用.md。
文档索引
| 文档 | 内容 |
|---|---|
| 手工搭建指南.md | 从零搭建路径 A/B、验收清单 |
| 界面描述规范.md | app.json 完整字段与校验 |
| 视图与布局.md | 三种视图、无布局模型、扩展方式、按图做界面 |
| 应用包结构.md | 包文件树、必选/可选、沙箱拷贝范围 |
| 动作与handlers.md | handle 契约、平台桥、增动作步骤 |
| 取数与流水线.md | pipeline、编排与组装、与数据连接对齐 |
| 助手知识摘要.md | 对话创建/改进/排错用的运行规则摘要 |
与应用开发助手 / 产品内浏览
创建向导与「对话改进应用」会：
- 每次注入 助手知识摘要.md（嵌入于
backend/internal/appfromchat/appsdk_kb/） - 按用户说法追加最多两章本目录原文（取数 / handlers / 界面 / 视图 / 包结构）
- 改进时再附带当前应用包文件
打开应用后可用「应用包」面板浏览包内文件；白名单路径可编辑保存。详见 应用包结构 §4.1。
改本目录文档后，请同步复制到 appsdk_kb/ 并跑 go test ./internal/appfromchat/。
与并列 SDK
| 目录 | 面向 |
|---|---|
sdk/appsdk（本目录） | 工作区轻量应用 |
sdk/host-embed | 传软嵌入助手 |
sdk/platform-plugin | 插件应用（应用桌面 iframe） |
sdk/agent-capability | 插件工具（消息里调 API） |
| 总览 | sdk/README.md |
真值与实现对照
| 主题 | 位置 |
|---|---|
| 结构与校验 | backend/internal/workspaceapp/spec.go |
| 标准界面渲染 | client/web/src/WorkspaceAppRenderer.tsx |
| invoke / handlers 沙箱 | backend/internal/workspaceapp/invoke.go |
| 平台桥 | backend/internal/workspaceapp/platform_bridge.go |
| 员工画像模板 | backend/internal/workspaceapp/employee_profile_*.go · skillfromchat/bundled/employee-profile/ |
| 运行时包路径 | {RUNTIME_DIR}/workspaces/{workspaceId}/apps/{appSlug}/ |