账号关联
用户第一次使用万相能力时，用本人已注册万相账号的手机号验证关联；以后以当前小程序的微信身份登录。沿用既有服务号与 XApp 账号体系。
微信原生小程序把你的智能服务，
把你的智能服务，
做成自己的微信小程序。
在 WorkBuddy 里描述需求，把预约、咨询、报名和会员服务做成原生页面。接入万相大师后，小程序与绑定的 XApp 共用业务账号、数据和智能体能力。
我的服务空间•••
服务，随时可达。从了解服务，到预约登记，再到咨询与资料交付。
预约与报名→
AI 服务助手→
我的会员与资料→
开始使用服务已接通的能力
页面是新的，业务底座继续共用。
在运营中心把小程序绑定到已发布的 XApp，按需开启能力。万相原生 SDK 处理运行会话和接口对接，服务端继续检查实际账号与业务权限。
业务数据库
复用绑定 XApp 的逻辑表，承载预约、报名、记录与查询。数据按原有访问和行权限处理，不把别人的记录开放给当前用户。
文本智能体
接入服务号已绑定的智能体，沿用角色配置、知识能力和额度。小程序与网页分别保留会话上下文，适合咨询与业务问答。
商品与会员查询
展示同一服务号已发布商品，查询当前用户的会员级别与有效期。当前为查询能力，小程序原生支付尚未接通。
授权文件下载
用户只能下载自己有权访问的私有文件。素材和下载域名由接入向导说明；不会把整个 OSS 空间开放给小程序。
代码版本与视觉风格
小程序拥有独立的私有源码空间，支持保存、恢复与固定版本导出。原生样式延续 XAUI 的配色、字号、间距和触控规格。
适合从这些需求开始
先做一条能跑通的服务流程。
下面是可规划的应用场景，不是现成模板或客户上线案例。先明确字段与权限，再逐项开发和真机验收。
预约与活动报名
介绍服务、填写信息、保存记录、查询自己的报名结果；后台和 XApp 继续使用同一张业务表。
专家咨询与门店服务
用原生页面展示服务，通过文本智能体回答问题，再衔接已有的咨询与服务流程。
会员服务与资料领取
查看商品和会员状态，下载已获授权的资料。商品权益仍由万相运营侧维护。
从准备到上线
每一步，去对应的地方完成。
- 微信公众平台
准备自己的小程序账号
完成账号注册，在目标小程序开发设置取得 AppID 和 AppSecret。已有服务号接入万相，不等于已有小程序账号。
- 万相运营中心 → 微信小程序
登记、放行域名、绑定 XApp
选择服务号，按向导验证凭证；在微信后台填写向导显示的 request、downloadFile 合法域名，再选择有权管理的已发布 XApp，启用所需能力。
- 万相开发中心 + WorkBuddy
连接开发器，制作原生页面
取得带相应运营和开发权限的开发密钥，导入小程序开发器。它按工程 AppID 核对绑定，并指导 WorkBuddy 获取 SDK、样式和工具说明。
- WorkBuddy 开发器 → 万相私有 OSS
保存源码，固定准备发布的版本
确认工程与上传范围后保存源码。遇到冲突先拉取比较，发布前固定源码版本和微信版本号，导出到新目录。
- 微信开发者工具 / 受支持的发布渠道 → 微信后台
体验、上传、提审、正式发布
核对 AppID 与域名，做微信真机体验。上传后按微信版本管理流程提审和发布；源码已保存或已导出，不代表小程序已上线。
XApp 与小程序怎么配合
两种前端形态，一套业务关联。
| 对照项 | XApp | 微信原生小程序 |
|---|---|---|
| 页面形式 | 浏览器中的网页应用 | 微信原生页面，需单独编写与适配 |
| 业务接入 | XApp Bridge | 万相原生 SDK；由实际 AppID 确认绑定 |
| 账号与逻辑数据 | 首次手机号关联后，复用同一万相业务账号；绑定后使用同一 XApp 的逻辑表及权限 | |
| 智能体 | 沿用绑定角色与额度；网页和小程序分别保留会话上下文 | |
| 视觉 | XAUI 网页样式 | XAUI 原生 WXSS，统一视觉语言 |
| 代码与发布 | XApp 工作区与网页发布流程 | 独立私有源码空间；运行包经微信上传、审核与分发 |
绑定用于共用业务资源，不会自动把已有 XApp 页面转换成小程序。一个 XApp 当前对应一个小程序；小程序与服务号各有微信身份，平台不依赖 UnionID 作为必需条件。
万相大师微信小程序开发器让 WorkBuddy 清楚地知道，
让 WorkBuddy 清楚地知道，
你的工程该接到哪里。
开发器包含准备指引、案例、MCP 工具说明、固定本地执行器、原生 SDK 和 XAUI 样式。已有工程先核对 AppID 和实际绑定，再围绕你的业务继续开发。
MCP 管开发侧操作
在开发密钥授权范围内查询项目、绑定、数据结构和源码版本，协助完成开发。AppSecret 由管理员在运营中心录入，不放进对话和前端源码。
SDK 管小程序运行
处理微信登录、首次手机号关联与业务请求。运行会话保留在内存，数据库、智能体和文件操作按已开启能力及后端权限执行。
指南与工具可独立更新
联网时获取并校验服务器上的指南、案例、工具说明与工程模板；离线时使用缓存或随包内容。本地执行器变化才需升级安装包。
开发器安装与 WorkBuddy 市场审核是两个状态，以开发中心当前分发版本和开放平台实际状态为准。固定脚本需要 Node.js 18 或以上；日常指南更新不会覆盖你的工程或插件安装文件。
开始前说清楚
先理解边界，开发更省心。
已经绑定服务号，还需要做什么？
另外准备自己的小程序账号，取得小程序 AppID 和 AppSecret，再到万相运营中心「微信小程序」按向导登记、配置域名并绑定 XApp。服务号和小程序的凭证不能混用。
用户会不会要反复绑定账号？
首次使用万相能力时，通过本人已注册万相账号的手机号验证码完成关联。之后当前小程序的微信身份可复用这份关联；会话失效时重新登录，接入或授权变更时按提示处理。
代码到底保存在哪里？
本机保存开发工程，万相私有 OSS 保存小程序源码版本。上传后的编译运行包由微信保存与分发。三个地方的职责不同，固定源码版本不等于已上传微信。
网络请求和文件访问要配置什么？
按运营中心向导显示的地址，在微信后台设置 request 与需要使用的 downloadFile 合法域名；私有文件还需当前用户具有授权。不要用开发工具的「不校验合法域名」替代正式配置。
是不是 XApp 的全部功能都能直接用？
当前支持账号、逻辑表记录、文本智能体、商品与会员查询、授权文件下载。小程序原生支付、运行态用户文件上传和多媒体智能体尚未接通，不能直接照搬网页功能。
费用与上线条件怎么算？
万相服务、短信、智能体、存储及微信侧认证等按各提供方的现行规则和你的套餐处理。查看万相定价；涉及类目、备案、认证、隐私指引等事项，按微信后台实际要求准备，不承诺自动通过审核。
