安装、授权与连接问题

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

排查顺序建议为：插件可用 → 配置接口正确 → 小程序连接正确站点 → 微信域名与真机环境正常。每次只修改有证据的问题，避免同时替换多个配置后无法判断原因。

插件安装失败或无法启用

确认上传的是 TinyTale 配置插件 JAR，检查 Halo 版本和茶狗核心插件、Moments、Photos 的版本与启用状态。查看 Halo 的具体错误日志；缺少依赖与授权失败不是同一种问题。

安装要求见准备工作，操作见安装与授权。

小程序提示“应用未授权”

当前客户端依赖返回的页面配置判断配置是否可用。缺少有效的 basic、home、about、article 配置时也可能出现未授权提示，因此不能只凭这一弹窗认定订单已过期。

依次检查核心插件账号绑定、TinyTale 域名授权、插件启用状态和配置接口实际响应。配置接口应返回 JSON；代理错误页、登录页面或空结构都不等于正常配置。

请求返回 404 或 HTML

核对 VITE_HALO_BASE_URL 是否为正确 Halo 根地址，未附加 /console、/apis 或多余路径。再检查 /apis/tool.jiewen.run/v1alpha1/options 是否能到达插件，以及反向代理是否错误重写请求。

新版前端配旧版 JAR 时，新会话或文章接口也可能返回 404，应核对前后端版本组合。

开发工具正常，手机不正常

先取消开发者工具中临时忽略域名检查的设置，再核对微信公众平台的接口、上传、下载等合法域名，以及 CDN 和对象存储域名。检查证书、HTTPS 跳转、手机网络和防盗链规则。

H5 的跨域问题与微信小程序域名校验属于不同环境限制。H5 可用不能证明微信配置正确，微信可用也不能证明浏览器跨域设置正确。

修改配置没有生效

依赖安装或编译失败

核对 Node.js、pnpm 和完整源码目录，确认工作区中的 packages 没有缺失。保留首次报错的完整上下文，不要只截最后一行；不要通过删除锁文件、混用包管理器或任意升级所有依赖来掩盖问题。

仍无法定位时，按反馈清单提供版本、错误信息和复现步骤。