跳转到主要内容
Jiewen’blog
快速开始

准备工作与版本要求

适用版本:TinyTale 小程序 3.0.0 / TinyTale 配置插件 2.1.2。

开始前,准备可正常访问的 Halo 网站、微信小程序账号,以及能够运行 Node.js 的电脑。你需要有 Halo 插件安装、设置和用户角色管理权限,并能进入微信公众平台管理自己的小程序。

版本配套

TinyTale Next

支持
适用版本
3.0.0(版本码 300)

小程序源码。本文对应微信小程序 3.0.0,与下方配置插件配套使用。

TinyTale 配置插件

支持
适用版本
2.1.2
最低 Halo 版本
2.25.0

提供配置与认证接口,安装在 Halo 网站系统中。还需满足下表的依赖插件要求。

项目

本文档对应要求

用途

茶狗核心插件 PluginTeaGo

2.1.0 及以上

授权依赖

Moments

1.16.0 及以上

瞬间依赖

Photos

2.1.1 及以上

图库依赖

Tools 工具箱

可选,须支持 TinyTale 内部集成

受限文章阅读

友链服务

可选,申请功能须提供对应 API

友链与友链申请

前三个依赖插件由 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 和站点地址。

准备完成后,进入获取源码与安装包。

文档导航