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

安装插件与激活授权

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

本页完成 Halo 端安装。小程序源码的编译在下一篇进行。

安装依赖插件

进入 Halo Console 的插件管理页面,安装并启用符合版本要求的茶狗核心插件、Moments 和 Photos。确认依赖处于启用状态,再安装 TinyTale 配置插件。

使用本地安装时上传 .jar 文件。TinyTale 对应 TinyTale-config-2.1.2.jar;源码 ZIP、前端 main.js、构建目录和 sources.jar 都不能作为插件安装包。

Halo 插件安装的一般操作可参考官方说明。

完成授权绑定

  1. 登录购买 TinyTale 的账号,在订单或产品授权管理中添加实际使用的站点域名。

  2. 回到自己网站的茶狗核心插件,进入账号绑定或授权绑定入口,按页面指引前往授权中心获取并绑定 PAT。

  3. 返回 Halo 插件列表,进入 TinyTale 的授权入口完成激活。

  4. 核对页面显示的域名与当前站点一致,并确认授权有效。

核心插件的授权 PAT、微信 AppSecret、Halo 个人令牌和 Tools 集成密钥用途不同,不能互相替代。授权中心的 PAT 只用于对应授权流程。

如果网站通过反向代理运行,还应核对 Halo 配置的外部访问地址与实际授权域名。改变站点域名后,需要重新检查授权和小程序的请求地址。

填写基础配置

打开 TinyTale 插件设置,先完成:

  • 基础设置中的搜索栏旁图标。

  • 关于我的设置中的头像、昵称、个人简介、邮箱和网站地址。

  • 小程序认证中的 AppID、AppSecret。

  • 需要上传时使用的存储策略及附件分组。

按表单标出的必填项保存即可,轮播、公告、二维码、社交链接等可以随后完善。不需要为了“填满配置”随意填写 OpenID、个人 Token 或可选集成密钥。

新版登录使用实际 Halo 用户会话;后台保留的旧 OpenID 与个人 Token 不是新用户安装的必填项。

检查配置接口

在浏览器中打开自己的地址:

https://blog.example.com/apis/tool.jiewen.run/v1alpha1/options

成功时应返回 JSON,并包含基础或页面配置,例如 basic、home、about。不应出现 AppSecret、密码或服务端密钥。

现象

优先检查

404

插件是否启用;是否安装了正确 JAR;反向代理是否转发 /apis/

返回 HTML

请求是否被登录页、代理错误页或其他规则接管

没有有效页面配置、小程序提示未授权

核心插件绑定、TinyTale 授权和域名是否一致

插件无法启用

Halo 版本、依赖插件版本和启用状态

接口正常后,继续配置并运行小程序。

文档导航