企业官网建设流程全解析

1. 模拟器全绿、真机白屏：先把真机路径写成 AI 能核对的验收单

微信开发者工具里页面跑得比德芙还顺，真机预览却只给你一块白屏；模拟器里授权弹窗秒过，手机上点“拒绝”后按钮直接装死；本地 Storage 看着写进去了，杀进程重进数据又没了。你回头问 AI，它说“已经做完了”。问题往往不在功能数量，而在验收标准没有写进真机路径。TaoToken（https://taotoken.net/?utm_source=taotoken_aicg_blog_end&utm_content=miniprogram_device_check）可以把 Key 和模型调用管起来，Base URL 设为https://taotoken.net/api，让 AI 按真机验收单逐条自检，而不是靠一句“做完了”蒙混过关。

很多开发者用 AI 辅助小程序开发时，习惯把提示词写得很全：页面结构、字段、交互、跳转都列了。但 AI 仍然会漏掉真机上的授权、缓存、网络、域名校验、云函数超时、本地存储异步写入这些“模拟器默认帮你兜住”的环节。原因很简单：你说的是“实现什么”，AI 理解的是“代码层面看起来实现了”。你没有告诉它“什么叫过、什么叫不过、不过改哪”。验收标准缺位，AI 的“完成”就没有共同定义。

真机测试开发者尤其容易卡在这一步。模拟器里点一遍，主路径通了，就以为可以提审；真机一摸，授权、弱网、杀进程重进、iOS 和 Android 差异全来了。更麻烦的是，AI 在自检时经常顺手改三个无关页面，或者把一个原本能跑的页面重构到崩溃。要避免这种情况，必须把验收段写进提示词，并且把真机路径拆成 AI 能逐条回复的清单。

先记住三条原则：

1. 先写验收，再让 AI 补代码。不然“做完”没有共同定义。
2. 一次只验一件事。页面、单功能、真机主路径分开验，不要混在一段提示词里。
3. 把真机路径写进清单。模拟器通过不等于你手机能用，授权、缓存、弱网都要单独列。

这一篇不重复讲提示词模板，也不展开修 Bug 问题单。我们只做一件事：用 TaoToken 接入 AI 工具后，让 AI 帮你列“真机主路径验收清单”，并针对本路径给出不超过 3 条“模拟器通过但真机常挂”的提醒。Token 消耗主要发生在你把页面代码、验收项、报错日志一起贴给 AI 的时候，所以后面也会讲怎么用 TaoToken 的模型对话和 Coding Plan 控制成本。

2. TaoToken 接入三件套：Claude Code settings.json、Codex config.toml 与 CC Switch

要让 AI 参与真机验收，先得让工具稳定调用模型。去 TaoToken 官网（https://taotoken.net/?utm_source=taotoken_aicg_blog_end&utm_content=claude_code_config）拿 Key，然后在控制台创建 API Key，把 Base URL 设为：

https://taotoken.net/api

注意，Base URL 是工具配置项，不加 UTM 参数。Key 用占位符YOUR_API_KEY表示，实际使用时替换成你在 TaoToken 控制台生成的 Key。

如果你是 Claude Code 用户，配置走settings.json，使用ANTHROPIC_*环境变量。示例：

{ "env": { "ANTHROPIC_BASE_URL": "https://taotoken.net/api", "ANTHROPIC_AUTH_TOKEN": "YOUR_API_KEY" } }

这段配置的意思是：Claude Code 不再走默认端点，而是把请求发到 TaoToken 的 Base URL，并用你的 API Key 鉴权。改完后重启 Claude Code，确认它能正常对话。如果出现认证失败，先检查 Key 是否复制完整、是否有多余空格，再检查 Base URL 是否误加了路径或 UTM。

如果你是 Codex 用户，配置走config.toml，不要套用ANTHROPIC_*。Codex 的供应商配置通常长这样：

model = "你在 TaoToken 控制台选择的模型" model_provider = "taotoken" [model_providers.taotoken] name = "TaoToken" base_url = "https://taotoken.net/api" env_key = "TAOTOKEN_API_KEY"

然后在环境变量里设置：

export TAOTOKEN_API_KEY="YOUR_API_KEY"

不同版本的 Codex 对字段支持可能略有差异，以你本机版本文档为准。核心是三点：指定自定义供应商、把base_url指向https://taotoken.net/api、用环境变量传 Key。不要把 Claude Code 的ANTHROPIC_*变量写进 Codex 配置里，两者不是一套。

如果你用 CC Switch 做多环境切换，可以把它理解成“三件套”管理：

CC Switch 里新增一个自定义供应商，把这三样填进去，之后在 Claude Code、Codex 或其他兼容工具之间切换时，就不用反复改配置文件。配置完成后，先发一句“请回复 ok”测试连通性，再进入真机验收工作流。这样能把“工具能不能用”和“验收逻辑对不对”分开排查，避免真机白屏时你还得怀疑是不是 Key 配错了。

3. 让 AI 列真机提醒：一份 Token 可复现的提示词与随手记示例

配置好 TaoToken 之后，下一步是让 AI 输出“真机主路径验收清单”。这里的关键不是让 AI 自由发挥，而是给它固定输出结构，并要求它不要假设你已经测过。下面这段可以直接复制到对话里，作为真机验收提示词：

请根据我的描述，整理成「真机验收清单」，并说明每一步期望现象。 我稍后在真机上打勾；你不要假设我已经测过。 项目：[小程序名] 主体：个人 主路径（我口头版）：[打开→…→结果] 请输出： 1. 拆成 5～8 个可点击步骤（每步一句） 2. 每步「期望看到什么」 3. 建议我额外抽测的 2 个异常（如杀进程重进、弱网） 4. 模拟器通过但真机常挂的提醒（针对本路径，不超过 3 条） 约束：不要编造我没提到的页面；不确定标「需我确认」。

这段提示词会消耗输入 Token 和输出 Token。输入部分包括你的主路径描述、页面结构、可能的代码片段；输出部分是 AI 生成的清单。如果你把整个项目源码都贴进去，Token 消耗会明显上升。更省的方式是：只贴主路径涉及的页面文件、app.json中相关配置、以及报错日志，不要一次性塞整个仓库。TaoToken 的模型对话页面（https://taotoken.net/models/detail/chat?utm_source=taotoken_aicg_blog_end&utm_content=miniprogram_chat）可以用来做这类单次验收对话；如果每天都要跑多轮，可以看 Coding Plan（https://taotoken.net/coding-plan?utm_source=taotoken_aicg_blog_end&utm_content=miniprogram_plan），把常用验收提示词和项目上下文固定下来，减少重复输入。

以“随手记一笔”为例，主路径是：打开首页 → 点“记一笔” → 输入 20 和备注“午餐” → 保存 → 回首页看到记录 → 删除该记录。把这段描述丢给 AI，要求它按上面结构输出。一个可复现的产出如下：

项目：随手记一笔 主体：个人 主路径：打开首页 → 点记一笔 → 输入 20 和备注午餐 → 保存 → 回首页看到记录 → 删除该记录 1. 可点击步骤： 1) 在真机桌面点击小程序图标，进入首页 2) 点击底部「记一笔」按钮 3) 在金额输入框输入 20 4) 在备注输入框输入「午餐」 5) 点击保存按钮 6) 观察是否返回首页 7) 在首页最近记录列表中找到该条记录 8) 左滑或点击删除，确认记录消失、汇总更新 2. 每步期望看到什么： 1) 首页正常渲染，无白屏、无报错弹窗 2) 进入新增页，键盘不遮挡保存按钮 3) 金额输入框显示 20，允许小数点或整数 4) 备注输入框显示「午餐」 5) 点击后按钮有 loading 或禁用反馈，不重复提交 6) 返回首页，列表出现新记录 7) 今日或本月汇总数字增加 20 8) 删除后列表移除，汇总数字减少 20 3. 建议额外抽测的 2 个异常： - 杀进程重进：保存后上滑杀掉小程序，重新打开，记录是否仍在 - 弱网或断网：保存时切飞行模式，是否有失败提示，恢复网络后能否重试 4. 模拟器通过但真机常挂的提醒（不超过 3 条）： - 本地存储写入后杀进程重进丢失或被覆盖 - 授权拒绝后页面无兜底，按钮看起来可点但无反馈 - 弱网或云函数超时导致白屏、静默失败或重复提交

这份清单的价值在于：它把“真机验收”变成了可打勾的步骤，而不是一句“你测一下”。同时，它明确列出了不超过 3 条模拟器通过但真机常挂的提醒，正好对应真机测试开发者最常翻车的几个点。AI 替代不了你的拇指，但可以帮你把拇指要点的路径写清楚。

4. 模拟器通过但真机常挂的 3 条提醒：本地存储、授权、弱网

上面给出的 3 条提醒不是泛泛而谈，每一条都能对应到具体自检动作和修复方向。下面展开说明，并给出让 AI 逐条核对的问法。

第一条：本地存储写入后杀进程重进丢失或被覆盖。模拟器里wx.setStorageSync往往立即生效，页面刷新后数据还在，所以看不出问题。真机上，如果你用了异步wx.setStorage但没等回调就跳页，或者多个页面同时写同一个 key，就可能出现覆盖或丢失。让 AI 自检时，不要问“存储有没有问题”，而是问：

请检查 pages/add/add 和 pages/index/index 中所有本地存储调用： 1. 写入后是否在成功回调或 await 之后再跳转/更新 UI？ 2. 是否存在多个页面写同一个 key 且没有合并逻辑？ 3. 杀进程重进后，首页读取数据的兜底逻辑是什么？ 请逐条回复：通过 / 未通过 + 证据，不要改无关页面。

如果 AI 发现写入后立即navigateBack，就应该改成等待写入完成再返回，或者在首页onShow里重新读取。若数据允许丢失，也要在验收标准里写清楚边界：什么情况下会丢、用户会看到什么提示。

第二条：授权拒绝后页面无兜底，按钮看起来可点但无反馈。模拟器默认经常允许授权，或者弹窗一闪而过，真机上用户点“拒绝”后，wx.getUserProfile、wx.authorize、位置权限等会直接进入 fail 分支。如果代码只写了 success，按钮点下去就像没反应。让 AI 自检时，要求它列出所有需要授权的 API，并检查 fail 分支：

请列出本路径涉及的所有授权类 API。 对每一个 API，检查： 1. 用户拒绝后是否有 toast、文案或引导去设置页？ 2. 主按钮是否仍然可点？如果可点，点击后会发生什么？ 3. 是否存在“模拟器默认允许，真机拒绝后白屏”的风险？ 不确定的 API 请标注「需我确认」，不要编造。

修复方向通常是：在 fail 分支里给明确提示，把主按钮置灰或改为“去授权”，并在onShow里重新检查授权状态。不要静默失败，也不要在用户拒绝后反复弹窗。

第三条：弱网或云函数超时导致白屏、静默失败或重复提交。模拟器网络通常很稳，云函数本地调试也可能直接返回。真机弱网下，请求可能超时，云函数可能冷启动，前端如果没做 loading、超时和重试，就会白屏或重复提交。让 AI 自检时：

请检查本路径中所有网络请求和云函数调用： 1. 请求前是否有 loading 或按钮禁用，防止重复提交？ 2. 失败时是否有 toast、错误页或重试入口？ 3. 超时时间是否合理？云函数错误日志能否对应到本次调用？ 请逐条：通过 / 未通过 + 证据。不要建议直连生产数据库，不要生成直接操作生产库的命令。

如果是本地存储方案，弱网主要影响云开发登录态或资源加载；如果是云函数方案，要确保入参校验在云函数侧，密钥和敏感规则不在小程序前端。注意，这里只让 AI 检查代码和日志，不要让它直连生产库执行 SQL 或命令。所有 SQL、命令、部署操作都由你在本地或测试环境执行。

这 3 条提醒覆盖了真机测试最常见的翻车点，但不要贪多。每次只验一条主路径，列不超过 3 条提醒。列多了，AI 会开始编造你没提到的页面和 API，Token 也白烧。

5. 页面 / 单功能 / 数据层验收模板：从开发前贴到自检后

真机主路径验收只是一环。为了让 AI 在开发前就知道“什么叫过”，你还需要页面验收、单功能验收、数据层验收三套模板。它们可以和真机清单串联使用：开发前贴对应验收段，AI 自称做完后再贴一次要求逐条自检，真机翻车时转成修 Bug 问题单。

页面验收适合 AI 刚搭好一个页面结构，或改完一页 UI 之后。不要写“代码优雅”“架构合理”，要写用户能观察到的结果。可以这样给 AI：

【页面验收】 页面路径：pages/index/index 页面目标：用户看到今日/本月支出汇总，并能进入新增 请按下列标准自检，逐条回复：通过 / 未通过 + 原因。 未通过项请最小改动修复，不要顺手改其他页面。 1. 页面能正常打开，无白屏、无报错打断 2. 关键区块齐全：汇总区、最近记录列表、底部「记一笔」按钮 3. 关键文案可读，无「测试」「TODO」「占位」字样 4. 主按钮可点，点击后有明确反馈（跳转/提示/状态变化） 5. 空状态有说明：无记录时提示去记第一笔 6. 不破坏已有页面与全局配置 不确定的 wx API 请标注，不要编造。

单功能验收适合只做了“保存”“删除”“筛选”里的一件事，防止 AI 顺便重构半个项目。示例：

【单功能验收】 功能名称：新增一笔支出 所在页面：pages/add/add 用户操作：输入金额和备注，点击保存 期望结果：返回首页，列表出现新记录，汇总数字更新 请只围绕本功能验收，逐条：通过 / 未通过。 未通过则最小改动修复；不要新增未要求的功能。 1. 主路径可走通 2. 金额为空时有提示，不保存 3. 保存成功后首页列表出现新记录，今日汇总增加 4. 失败时不静默：有 toast 或文案，不是没反应 5. 改动范围尽量小，未改无关页面 完成后请列出：改了哪些文件、我如何 1 分钟复验。

数据层验收适合本地存储或云开发云函数。核心是验“存进去、读得回、密钥没躺在前端”。本地存储版：

【数据层验收 · 本地存储】 相关页面：pages/add/add、pages/index/index 请按方案验收，逐条：通过 / 未通过 + 证据。 1. 写入后杀进程重进，记账列表仍在 2. 关键 key 命名清晰（如 records），无随意覆盖无关数据 3. 无密钥、无鉴权秘密写在前端明文 4. 失败时有提示，不静默

云函数版：

【数据层验收 · 云函数】 相关函数名：[函数名] 请按方案验收，逐条：通过 / 未通过 + 证据。 1. 小程序已 init 正确环境，callFunction 名称与云端一致 2. 入参校验在云函数侧：空值/非法有返回说明 3. 密钥与敏感规则不在小程序前端 4. 失败时前端有提示，云函数日志可对应到本次调用 5. 不要建议直连生产数据库，不要生成直接操作生产库的命令

串联用法可以固定成四步：

1. 写功能时：在提示词末尾粘上页面验收或单功能验收段。
2. AI 自称做完：再发一遍验收段，要求逐条“通过 / 未通过”。
3. 未通过或真机翻车：换成修 Bug 问题单，把报错、真机型号、系统版本、复现步骤贴全。
4. 数据在本地或云函数：用数据层验收段；路径选型回看本地存储与云函数的取舍。

这些模板不依赖特定框架，重点是让 AI 输出可核对的结论。每贴一次验收段都会消耗 Token，所以建议把常用模板保存在 TaoToken 的对话或 Coding Plan 里，避免每次从零复述。

6. 提审前轻量验收与 Token 成本控制：模型对话、Coding Plan 到 Claude Code 文档

功能差不多了，准备上传代码之前，可以再做一轮轻量提审前验收。不是让你保证一定过审，而是先过一遍“像不像能过审的成品”。细项仍以官方当期为准。可以给 AI：

请对当前微信小程序做提审前验收（个人主体），先出报告，不要大改代码。 名称：[小程序名] 简介：[简介] 类目：[类目] 核心路径：[进入→操作→结果] 请逐项：通过 / 风险 / 需修改，并给修改建议： 1. 主功能可用，无死按钮、无「开发中」占位 2. 名称/简介/类目与真实功能一致 3. 隐私与授权说明是否齐全（若用到用户信息） 4. 个人主体明显受限能力是否误用（社交/支付等，以官方当期为准） 5. 真机主路径是否建议再测一遍，列出应测步骤 最后给：提审前 10 分钟行动清单（按顺序）。 不确定请标注「需查官方文档」，不要保证一定过审。

这轮验收同样会消耗 Token，尤其是你把页面代码、截图说明、隐私政策草稿一起贴进去时。控制成本的思路是：

• 能用模型对话单次解决的，就去 TaoToken 模型对话（https://taotoken.net/models/detail/chat?utm_source=taotoken_aicg_blog_end&utm_content=miniprogram_chat）。
• 每天需要反复跑验收、修 Bug、写提示词的，用 Coding Plan（https://taotoken.net/coding-plan?utm_source=taotoken_aicg_blog_end&utm_content=miniprogram_plan）固定上下文。
• 需要创建或轮换 Key 时，去 API Keys 页面（https://taotoken.net/console/api-keys?utm_source=taotoken_aicg_blog_end&utm_content=miniprogram_keys）。
• 配置 Claude Code 时遇到ANTHROPIC_*、settings.json 字段问题，直接看 Claude Code 文档（https://taotoken.net/doc/ClaudeCodeAnthropic?utm_source=taotoken_aicg_blog_end&utm_content=miniprogram_doc）。

官网入口放在这里，方便你一次性拿 Key、看模型、配 Base URL：https://taotoken.net/?utm_source=taotoken_aicg_blog_end&utm_content=miniprogram_final_cta 。记住，Base URL 始终是https://taotoken.net/api，工具配置里不要加 UTM。

最后再强调一遍真机验收的底线：AI 可以帮你列清单、找风险、生成自检问题，但真机上的授权弹窗、杀进程重进、弱网、不同机型渲染，必须由你亲手走。提审前至少完整走 3 遍主路径，每遍都从桌面图标冷启动开始。AI 说“已经做完了”的时候，把真机验收段再丢回去，让它逐条回复“通过 / 未通过 + 原因”。这比再加十个功能更能决定你的小程序能不能稳定上线。