平台秘钥配置（只需一次）
- 打开 x.10knet.com，进入个人中心；在资料选项卡下的【开发秘钥】点击生成并复制秘钥。
- 在 WorkBuddy 新开对话，点击加号添加【全能页面应用开发器】，输入“请帮我配置秘钥”，再输入秘钥并发送。
- 稍后输入“请列出我创建的服务号”。WorkBuddy 能列出你上一步在平台绑定的微信服务号，即表示已经完全连通。
A Real App, Not A Mockup
先区分开发、预览与发布
“创建 XApp”的完成物是平台里的真实应用、真实 app_key 和远端 workspace，不是宿主电脑上的本地文件。应用可以调用当前绑定或明确公开可调用的智能体；每位用户的对话上下文由平台身份与 subthread 隔离。
状态读取内容可以证明什么
已保存开发源文件已写入 workspace。不能证明页面、数据或发布状态。
Preview 已验证私有 workspace，经平台父容器打开。开发版本可用于验证，不等于用户看到新版本。
Run 已发布已发布 release。当前发布版本可被运行态用户访问。
Install & Enter
加载全能页面应用开发器
Codex、WorkBuddy 和网页开发工作台三种入口都使用同一个平台边界；选择适合自己的入口即可开始。
安装全能页面应用开发器
- 左侧进入【专家·技能·连接器】，选择【技能】。
- 在右上角输入搜索【10knet】并确认。
- 在【SkillHub】下找到【全能页面应用开发器（xapp dev）】，点击加号安装。
- 安装完成即可；不需要再单独配置连接器。
让 Codex 按公开安装说明接入
请读取并严格执行 https://x.10knet.com/mcp/install/codex，
为当前 Codex 安装 XAgent 插件和 xagent、xagent-files 两个 MCP 服务。
需要开发秘钥时请提醒我到 10knet 个人中心的【设置 -> 开发秘钥】生成，
安装完成后运行 doctor，确认两个 MCP 服务均可用，并提醒我重启 Codex 或新建任务。
完成后由本教程的第一步加载服务端动态 skill xapp_dev。
在 webchat 右侧开发工作台完成
网页端不需要安装插件。进入 webchat，右侧依次使用应用列表、文件管理、数据管理、Preview / Run 和应用配置抽屉；左侧对话可协助编码，所有代码和 admin 操作都应经过明确确认。
打开 webchat 开发工作台 →First Success
按六步做出第一个可运行应用
加载 Skill，先列出权限
先确认自己能开发或代管哪些 XApp；此时不创建、不修改。
请加载 xapp-dev（服务端 skill：xapp_dev），
列出我可开发或代管的 XApp；先不要创建或修改。
用一句清晰需求先生成计划
先约定移动端布局、真实数据表、字段、权限与交互，再确认创建。
请创建一个“客户需求登记”XApp：
手机竖屏，包含姓名、联系方式、需求描述和提交按钮；
数据写入平台逻辑表，不使用 localStorage 作为主存储；
先给出应用结构、数据表字段和权限计划，确认后再创建。
确认后创建真实应用和 workspace
创建后请宿主报告应用名、app_key、目标文件与逻辑表；不要把本地 HTML 当成已创建的平台应用。
通过平台容器打开 Preview
使用平台父容器，而不是 localhost、文件地址或私有 OSS 地址。
/page/xapp/xapp.html?xapp_key=<app_key>&surface=preview
修正失败状态与数据边界
至少检查无权限、网络失败、空状态、刷新恢复与用户数据访问范围。运行态使用现有逻辑表读写；表结构和权限配置由开发者 / 管理员侧完成。
确认后发布 Run
发布是高影响动作。宿主应先报告目标应用、变更文件和发布方式，再由你确认。Run 读取 release，不会因保存代码自动更新。
/page/xapp/xapp.html?xapp_key=<app_key>&surface=run
Build With Boundaries
按需要接入应用能力
Preview 与 Run
Preview 读取私有 workspace；Run 读取已发布 release。验收必须分开写“代码已保存 / Preview 已验证 / Run 已发布”。一键发布更新 latest；新版发布会生成不可变版本快照。
公开素材与收费资源
asset 是公开素材，可通过 pub:/ 或公开 URL 使用，本身不代表收费；resource 是私有资源，需要 gateway 授权。收费还要经过资源对象、商品、发布与用户 grant。
收费资源商品
先准备私有资源，再创建或复用精确资源对象、商品草稿，核对价格、时长与资源后由用户确认发布。服务号绑定常是支付与权益闭环的重要前提，但不等于自动具备支付能力。
查看商品与运营入口 →用户数据记录
使用平台逻辑表，不用 localStorage 作为主存储。运行态只操作已存在表与记录；字段、public_read、rpm_limit 等由管理员侧设计，避免误公开用户数据。
应用 Admin 页面
管理入口是 admin/index.html，仍是 XApp iframe 页面，使用 XAUI、bridge 和 admin capability。仅展示管理任务必要信息，不能把 runtime 可见数据冒充全量数据。
把数据发送到对话
xapp.thread.entry.insert 是用户同意后的静默记录；xapp.webchat.send 向主 webchat 发消息并触发回复；xapp.charagent.chat 在 XApp 内以隔离 subthread 获取智能体回复。
AI 多模态（aicore）
通过 xapp.ai.* 异步 job 使用 chat、ASR、AIR、AVR、TTS、图片或视频生成；轮询 job 状态并展示进度、超时、错误和可取消状态。私有上传须使用受控短期访问，不直接交给 provider。
调用智能体
使用 xapp.charagent.chat 与 xapp.charagent.job_get。目标必须是已有 wxoa/wxcw 绑定智能体并允许公开调用；共享 URL 不能携带他人的私有 thread_key。
微信分享卡片图标
应用图标使用 settings.icon_url（公开 HTTPS 或 pub:/）；微信分享标题、描述和图片通过 share metadata 配置。二者不是同一字段，只有实际微信链路测试才能确认分享卡片显示。
移动端界面
XApp 运行态使用 XAUI，优先面向手机竖屏。先把输入、加载、错误、取消和成功状态设计完整，再添加视觉细节；不要让慢网络阻塞基础交互反馈。
Before You Release
发布前，用这张清单确认真实状态
检查项应确认不能替代
保存目标文件已写 workspace，平台记录已提交。不代表 Preview / Run 可用。
Preview在平台 Preview 检查交互、数据与失败状态。不代表 Run 已更新。
发布已确认文件变更后生成 / 更新 release。不代表微信分享或支付已验收。
Run用 Run 地址确认发布版本。不代表所有外部依赖均成功。
下一步：用运营中心接住用户与经营
应用上线后，在运营中心查看资产、用户、订单和业务后台入口；财务归属与代管权限需要分开理解。