配置入口与必填项

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

TinyTale 的配置分为编译配置、站点配置和读者偏好。先确认要修改哪一层，可以避免“后台已经保存，小程序却没有变化”的误判。

首次安装需要填写什么

以下两个参数分别配置在源码根目录的 .env.development 与 .env.production 中；修改后需要重新编译。

AppSecret 是微信应用密钥，只保存在 Halo 后台。不要写入 VITE_ 环境变量，小程序端环境变量会参与客户端构建。

可以稍后配置的内容

轮播图、公告、热门分类、社交链接、二维码、随机图片 API、文章占位图片、图库与瞬间密码、Tools 集成均按需求配置。开启某个功能后，补齐该功能表单要求的字段，例如开启访问密码后必须填写密码。

“其他设置 → 自定义设置”用于自定义键值扩展。填写一个键不会自动创建页面或业务功能，需要对应源码或扩展读取并使用它。

旧版字段怎么处理

“小程序认证”中仍保留 OpenID 和个人 Token 字段，用于兼容或服务端扩展。3.x 的账号登录、微信登录及发布功能使用用户会话和角色权限，新安装无需照旧教程生成共享管理员 Token。

“文章页设置”的“是否开启图片懒加载”对应历史字段名 enableReward。当前文章页未读取这一开关，渲染组件默认开启懒加载；它不是打赏或广告开关。加载占位图和错误占位图则已接入，详见主题与列表布局。

保存后没有变化

先确认保存的是小程序实际连接的网站，再重新进入小程序。用户已经选择的列表偏好可能覆盖站点默认布局，可在应用设置中恢复“跟随”。正式包使用 .env.production，修改开发环境文件不会影响已发布版本。

继续阅读：首页与分类、主题与列表布局、上传与媒体缓存。