适用版本：TinyTale 小程序 3.0.0 / TinyTale 配置插件 2.1.2。
前提：Halo 端已完成安装与授权，并能正常读取配置接口。
打开源码根目录
使用你习惯的编辑器打开 TinyTale Next。在终端进入包含 package.json 与 pnpm-workspace.yaml 的目录，再运行后续命令。不要在生成的 dist 目录中安装依赖。
配置环境文件
开发预览使用源码根目录的 .env.development，正式构建使用 .env.production。分别设置自己的站点和小程序 AppID：
VITE_HALO_BASE_URL=https://blog.example.com
VITE_WECHAT_APPID=你的小程序AppID
VITE_HALO_BASE_URL 填 Halo 根地址，不带末尾 /，也不带 /console 或 /apis。这里应当是提供 TinyTale 接口的网站。
VITE_WECHAT_APPID 必须与 Halo 插件“小程序认证”中的 AppID 一致。AppSecret 只保存在 Halo 插件设置中。
修改环境文件后重新启动编译进程；微信开发者工具里也要使用同一个 AppID。不要继续使用旧文档的 VITE_WX_APPID、VITE_SERVER_BASEURL 或 src/config/base.ts 配置方式。
安装与启动
pnpm install
pnpm dev:mp-weixin
首次安装应在完整源码目录进行。项目使用 pnpm workspace 连接富文本包，建议统一使用 pnpm，保留锁文件。
编译成功后生成 dist/dev/mp-weixin。保持开发命令运行，源码修改会触发重新编译。
导入微信开发者工具
打开微信开发者工具，选择导入项目。
目录选择
dist/dev/mp-weixin。核对 AppID，使用自己的小程序账号。
打开项目，查看首页是否能加载配置、文章和图片。
测试号无法完整验证真实 AppID 对应的登录、绑定及服务端 AppSecret 配置。最终必须使用实际小程序账号测试。
检查是否成功
首页可加载已发布文章。
分类、图库和瞬间可打开；没有内容时显示空状态。
关于页显示你设置的站点资料。
账号登录能读取当前用户资料；微信登录在实际微信环境测试。
若提示域名不合法，检查微信公众平台对应合法域名；若请求成功但无内容，检查 Halo 中的发布、可见性及访问限制。故障处理见安装与连接问题。
日常安装不必手动构建富文本包。只有修改其源码、主题、插件或高亮配置后，才执行 pnpm mp-html:build。