TinyTale 微信小程序

TinyTale 是一款基于 Halo 博客系统的微信小程序，可以展示博客文章、图库、瞬间等内容。简洁、美观、易用，是你的博客的最佳搭档。

预览

注：图中二维码即为演示

TinyTale 3.0：让你的 Halo 博客，在微信里被看见

一篇认真写下的文章，一组旅行中的照片，或是一段想随手记录的日常，都可以成为读者认识你的开始。

TinyTale 是一款基于 Halo 博客系统的微信小程序，将文章、分类、图库和瞬间整合到一个简洁的移动端入口。读者可以在微信里浏览内容、参与评论，并把喜欢的文章分享给朋友；站长也能通过小程序发布瞬间和图片，让记录与分享更贴近日常。

TinyTale 3.0 围绕内容阅读、账号互动和媒体展示完善了产品体验。内容由 Halo 管理，小程序通过配套插件读取站点配置和内容，为你的博客提供一个适合微信访问的展示空间。

从首页出发，发现博客里的内容

首页支持轮播图、公告和热门分类，你可以把近期更新、精选文章或希望读者关注的内容放在显眼的位置。

文章列表提供列表、双栏和大卡片等展示方式。以文字为主的技术博客、图片丰富的生活记录，都能选择适合自己的布局。读者还可以通过分类、搜索和文章归档继续探索，找到感兴趣的主题与过往记录。

为手机阅读整理的文章体验

TinyTale 支持文章中的图文、代码块和表格等内容，提供代码高亮、图片预览与表格横向滚动，让不同类型的文章都能在小屏幕上阅读。

界面支持浅色、深色和跟随系统主题。站长可以设置默认外观，也可以开放主题与展示偏好，让读者按照自己的习惯使用。

文章中的点赞、评论和回复，让阅读之外多一份交流。分享功能则将内容带入微信会话与朋友圈，方便读者把一篇文章推荐给朋友。

用图库收藏照片，用瞬间记录生活

图库适合展示摄影作品、旅行照片和日常收藏。照片可按分组浏览，并提供网格与瀑布流布局。列表优先展示缩略图，打开预览后查看原图；图片尺寸信息用于预留展示空间，减少加载时的布局变化。

瞬间适合记录短一些的内容：一段想法、一次近况，或一组随手拍下的照片。文字、图片与标签可以组合呈现，文章之外的生活片段也有了自己的位置。

具备相应 Halo 权限的用户，可以直接在小程序中发布瞬间、上传图片并选择图库分组。图片发布支持缩略封面处理，部分发布失败后可继续提交尚未完成的内容。

登录、互动与个人资料

TinyTale 支持微信一键登录、Halo 账号密码登录及微信账号绑定。已有 Halo 账号的用户可以使用自己的账号登录，微信用户也可通过主动登录完成账号创建或登录。

登录后，用户可以管理头像、昵称和个人简介。已绑定的微信账号支持静默恢复会话，减少重复登录操作。

发布和上传能力由 Halo 账号权限控制，站长可以按实际需要分配权限。

按内容需要，设置访问方式

图库和瞬间可以分别设置访问密码，适合需要限定访问范围的内容。

搭配可选的 Tools 工具箱集成，TinyTale 还可支持密码、验证码、登录或评论可见等文章阅读方式。具体可用能力由后端配置决定，正文根据服务端的校验结果展示。

把博客的个性带进小程序

除了内容展示，TinyTale 还提供个人介绍、社交联系方式、网站友链和声明页面，让读者了解内容背后的人。

配合支持申请功能的友链服务，读者可以直接在小程序中提交网站信息，通过验证码完成友链申请。

首页轮播、公告、个人介绍、默认主题和列表样式等内容，都可以通过 Halo 后台中的配套插件集中管理。站长也可以决定是否开放部分个性化设置，让读者自行选择展示方式。

功能一览

技术栈

TinyTale 基于 Vue 3 和 uni-app 开发，使用 TypeScript 组织业务代码，以图鸟 UI 构建界面，配合 UnoCSS 管理样式。

• uni-app：应用开发与微信小程序构建。

• Vue 3 与 TypeScript：界面与业务开发。

• Tuniao UI Uniapp V3：界面组件。

• UnoCSS：原子化样式。

• Pinia：状态管理。

• Alova：请求与文件上传。

• mp-html 与 z-paging：富文本渲染和列表分页。

• Vite 与 pnpm：开发构建与依赖管理。

• Iconify：图标资源。

快速开始

1. 准备 Halo 与配套插件

使用 Halo 2.25.0 及以上版本，安装 TinyTale 配置插件 2.1.2，并确保依赖满足要求：

• 茶狗核心插件 PluginTeaGo 2.1.0 及以上。

• Moments 插件 1.16.0 及以上。

• Photos 插件 2.1.1 及以上。

在 Halo 后台完成所需授权，并进入 TinyTale 插件设置，配置微信小程序凭据、首页展示、个人介绍和上传存储策略等内容。需要使用受限文章阅读时，再配置对应的 Tools 集成。

2. 配置小程序

下载 TinyTale Next 源码，准备 Node.js 24 和 pnpm 10.34.5。

在项目对应的环境文件中配置 Halo 地址与微信小程序 AppID。开发预览使用 .env.development，正式构建使用 .env.production：

VITE_HALO_BASE_URL=https://your-halo-site.com
VITE_WECHAT_APPID=你的小程序AppID

Halo 地址不带结尾的 /。同时，在微信公众平台配置实际使用的 request、uploadFile 和 downloadFile 合法域名；使用独立图片或附件域名时，也需要按实际用途配置。

3. 启动与预览

在项目目录中执行：

pnpm install
pnpm dev:mp-weixin

使用微信开发者工具导入 dist/dev/mp-weixin 目录，即可进行开发预览。

正式构建执行：

pnpm build:mp-weixin

构建完成后，将 dist/build/mp-weixin 导入微信开发者工具，完成真机验证，再按微信小程序流程上传、提审和发布。

无论你想分享技术文章、整理摄影作品，还是记录日常生活，TinyTale 都能为 Halo 博客提供一个微信中的入口，让读者更方便地打开内容、参与交流，也让你随时记录新的故事。