异界拾光：7天从想法到上线的开发日记

7天，从零到上线。这不是标题党，是「异界拾光」小程序的真实开发记录。

本文记录了MVP版本7天开发的关键决策和踩坑过程，希望能给独立开发者一些参考。

Day 1：项目骨架 + 核心功能

决策：技术栈选择

• 后端：微信云开发CloudBase（Serverless，免运维）
• 前端：微信小程序原生开发（非框架，性能优先）
• AI：混元多模态模型（图片理解+文本生成+图片生成）

为什么不用Uni-app/Taro？因为MVP阶段只需要微信一个端，原生开发性能最好，且能直接使用微信云开发的所有能力。

完成

• 3个tabBar页面（首页/拍照/图鉴）
• recognizeSpecies云函数（拍照→识别→物种卡）
• spiritChat云函数（星灵对话，带人格+记忆）
• 5个数据库集合设计

第一个坑：cloud.ai()在云函数端不可用，报错cloud.ai is not a function。

Day 2：修复tabBar + 物种详情页

决策：tabBar图标

微信小程序的tabBar图标必须是本地PNG（不支持SVG/网络图），尺寸81x81px。用AI生成了5个紫色系图标。

完成

• 物种详情页（大图+设定+用途+星灵反应）
• generateShareCard云函数（生成分享卡片图）
• sendSpiritReminder云函数（订阅消息定时推送）

Day 3：AI调用架构重构（最大坑）

问题爆发

Day 1-2的代码用了cloud.ai()，但部署后发现全部不可用：

1. cloud.ai is not a function
2. cloud.extend.AI is not a function
3. 云函数默认3秒超时，AI调用不够
4. Token额度用完（EXCEED_TOKEN_QUOTA_LIMIT）

决策：混合AI调用架构

不同功能走不同API通道：

功能	通道	模型
图片审核	微信官方	-
图片识别	TokenHub API	hunyuan-vision
星灵对话	TokenHub API	hunyuan-turbos-latest
文生图	TokenHub API	hy-vision-2.0-instruct

完成

• 三个云函数统一改为TokenHub API调用
• 新增图片内容审核（security.imgSecCheck）
• 新增AI插画生成（文生图）
• 云函数超时配置改为60秒

最大的坑：@cloudbase/node-sdk不认识cloud.DYNAMIC_CURRENT_ENV，必须传具体环境ID字符串。

Day 4：异世界地图 + 星灵自定义

决策：地图系统设计

6大区域对应species.category的6个值，收集达标后解锁：

区域	category	解锁阈值
晨雾森林	plant	3
风语草原	animal	3
星辉湖泊	scenery	3
熔岩山脉	object	3
烟火集市	food	3
神秘遗迹	other	3

完成

• 异世界地图页（scroll-view + absolute定位）
• 区域详情页（按category查询物种）
• 星灵自定义系统（5形象×6色×3人格，纯CSS实现）
• 等级系统（经验/升级/成长阶段）
• 个人中心页

Day 5：头像昵称改造 + 主题切换

决策：微信API变更适配

wx.getUserProfile已废弃，改用官方推荐方案：

• 头像：<button open-type="chooseAvatar">
• 昵称：<input type="nickname">

完成

• 头像昵称获取改造
• 6主题切换系统（CSS变量+持久化）
• 世界地图物种悬浮+详情弹窗
• 星灵动作动画（6种CSS动画）

Day 6：TokenHub迁移 + Bug修复

决策：视觉模型迁移

从混元官方API迁移到TokenHub API（统一端点），简化调用逻辑。

完成

• TokenHub双端点简化为单端点
• spirit→assistant role兼容（TokenHub严格校验）
• 聚合查询改where兜底（修复_openid Bug）
• 图鉴删除功能

Day 7：多世界观全链路实现

决策：世界观系统设计

6种世界观，每种有独立主题、设定和视觉风格：

1. 星之谣（默认）→ 2. 仙侠 → 3. 玄幻 → 4. 魔法 → 5. 废土 → 6. 机甲

解锁链：收集阈值线性解锁（15→30→50→80→120）

完成

• 6世界观全链路实现
• 皮肤系统（themeVars + bgImage + tabBarIcons）
• 自定义tabBar组件
• 世界观切换页面

总结

7天完成的功能

• 3个tabBar页面 + 6个子页面
• 12个云函数
• AI识别 + AI生图 + AI对话 + AI剧情
• 6世界观切换 + 皮肤系统
• 星灵自定义 + 等级系统 + 地图系统
• 图片审核 + 订阅消息 + 分享卡片

关键经验

1. MVP聚焦：7天能做完这些，是因为砍掉了所有非核心功能（社交/支付/后台）
2. 云开发真香：免运维，不用管服务器，专心写业务逻辑
3. AI调用要异步：生图/剧情耗时长，必须异步生成，否则用户体验极差
4. 提示词是核心：同样的模型，提示词差一点，效果差很多
5. 踩坑是常态：7天里至少有3天在踩坑，但每个坑都是成长

给独立开发者的建议

• 先跑通最小闭环，再迭代
• 云开发适合个人开发者，省心
• AI能力要用对地方，不是所有功能都需要AI
• 留好日志，方便排查问题