适用版本:TinyTale 小程序 3.0.0 / TinyTale 配置插件 2.1.2。
开始前,准备可正常访问的 Halo 网站、微信小程序账号,以及能够运行 Node.js 的电脑。你需要有 Halo 插件安装、设置和用户角色管理权限,并能进入微信公众平台管理自己的小程序。
版本配套
TinyTale Next
支持小程序源码。本文对应微信小程序 3.0.0,与下方配置插件配套使用。
TinyTale 配置插件
支持提供配置与认证接口,安装在 Halo 网站系统中。还需满足下表的依赖插件要求。
前三个依赖插件由 TinyTale 的插件描述文件声明。即使暂时不展示图库或瞬间,也应满足当前配置插件的依赖要求。安装依赖插件时,还要核对该插件自身要求的 Halo 版本。
Halo MCP Server 用于 AI 管理网站,与读者使用 TinyTale 无关;它的版本要求不应当作 TinyTale 的最低要求。
本地开发环境
建议使用 Node.js 24 和 pnpm 10.34.5,与当前项目说明保持一致。源码声明支持 Node.js >=20.19.0、>=22.12.0 或 >=24.0.0 对应范围;新安装优先统一使用推荐版本。
在终端检查:
node --version
pnpm --version
若没有 pnpm,可在已有 Node.js 的电脑上安装指定版本:
npm install -g pnpm@10.34.5
同时安装微信官方的微信开发者工具。普通站长安装 JAR 即可,不需要 Java 开发环境;自行构建后端插件才需要 Java 21 等工具。
站点与域名
准备一个手机可以访问的 HTTPS Halo 地址,例如 https://blog.example.com。确认浏览器能够打开网站和后台,证书正常,反向代理能转发 /apis/ 请求。
在微信公众平台按实际请求用途设置合法域名:网站接口、附件上传、图片下载可能使用不同的域名。使用对象存储或 CDN 时,应一并核对其域名。具体平台限制以微信小程序网络文档和后台提示为准。
开发者工具中临时关闭域名校验不能代表正式版配置正确。
准备好这些信息
Halo 的 HTTPS 地址和管理账号。
微信小程序 AppID 与 AppSecret。
TinyTale 购买账号、下载入口及对应域名授权。
一个正常可用的 Halo 附件存储策略。
AppSecret 只填写在 Halo 插件的服务端设置中。小程序源码只需要 AppID 和站点地址。
准备完成后,进入获取源码与安装包。