更新记录

v1.0.0（2026-08-24）

v1.0.0 更新日志

架构升级：Cloudflare Worker 全面迁移至 uniCloud 云端一体方案

本次核心改动

• 新增 stroke-data 云函数：内置 9574 个常用汉字 SVG 笔画数据，替代原 Worker /stroke-data/:char.json 静态资源；同时聚合 /api/toolbox 工具箱数据，前端一键调用。
• 新增 char-api 云函数：聚合 getChar / getGradeChars / getErrorProneChars / search 四组接口，补齐单字详情（五笔、释义、例词、易错提示等）。
• 前端调用层重构：统一封装 utils/cloudApi.js + utils/charApi.js，实现「本地缓存 → 远程云函数 API」两级加载，避免重复请求。
• 详情页远程补齐：pages/detail/detail.vue 本地渲染拼音/笔画数/部首后，异步调用 char-api 补齐扩展字段，首屏不阻塞。

功能亮点

• 田字格书写练习 + Canvas 2D 笔顺动画（零 npm 依赖）
• TTS 拼音朗读（前端直连有道免费接口）
• 生字收藏、搜索历史、易错字归纳、年级生字表
• 统一浅青蓝教育 UI，适配个人主体微信小程序
• 全端本地优先 + 云端兜底，低延迟、可离线

兼容性

• 支持 uni-app 编译至微信小程序
• 需 HBuilderX 关联 uniCloud 服务空间并上传 stroke-data、char-api 两个云函数

平台兼容性

云端兼容性

云函数类插件通用教程

使用云函数类插件的前提是：使用HBuilderX 2.9+

适配个人主体微信小程序、流量主广告变现、统一浅青蓝教育 UI 规范，全页面视觉统一，无 UGC、无社交违规功能，全年稳定搜一搜流量赛道

一、项目基础信息

1. 项目定位

面向小学生、家长、小学语文老师的轻量化汉字学习工具，核心提供汉字笔顺动画演示、手写跟写练习、生字查询、易错字汇总功能；纯工具查询类产品，无用户投稿、评论、社区，仅依靠微信流量主广告合规变现。

2. 主体与服务类目

• 主体类型：个人主体小程序
• 微信服务类目：工具 - 效率工具、工具 - 信息查询
• 合规红线（全程强制执行）
  1. 无登录、注册、用户账号体系，所有数据本地缓存
  2. 无评论、打卡、用户上传、UGC 分享功能
  3. 无课程售卖、付费练字、私域引流、外链跳转
  4. 不做姓名打分、命理测算、医疗养生建议，仅汉字科普工具

3. 小程序基础 SEO 信息（直接提交审核）

1. 小程序名称：汉字笔顺笔画查询
2. 小程序简介：免费查询汉字标准笔顺、笔画数量、偏旁部首、读音，支持笔顺动画演示、手写跟写练字、小学生 1-6 年级生字汇总、易错汉字查询，辅助孩子规范书写汉字。
3. 核心搜索关键词：汉字笔顺、笔画查询、生字笔画、标准书写顺序、偏旁部首、易错笔顺、小学生练字、笔顺动画、手写跟写、一年级生字

二、uniCloud 后端（云端一体项目模板）

uniCloud，发布为「uni-app 前端模板 → uniCloud 云端一体项目模板」。

2. 目录结构

hanzibihuabishunsucha-uni/
├── pages/                    # 前端页面
├── utils/
│   ├── cloudApi.js           # uniCloud.callFunction 封装层（callStrokeData / callCharApi）
│   ├── strokeData.js         # 笔画加载（改为 call stroke-data 云函数）
│   └── charApi.js            # 汉字详情查询（本地缓存 -> char-api 云函数）
├── uniCloud/
│   ├── cloudfunctions/
│   │   ├── stroke-data/      # 笔画数据 + 工具箱云函数
│   │   └── char-api/         # 汉字详情聚合云函数（getChar/getGradeChars/getErrorProneChars/search）
│   │       ├── index.js
│   │       ├── package.json
│   │       ├── toolbox.json
│   │       └── data/         # 9574 个汉字笔画 JSON
│   └── database/
│       └── strokes.schema.json  # 可选：导入数据库的 schema
├── manifest.json
└── pages.json

3. 部署步骤

1. HBuilderX 打开本项目 → 右键 uniCloud 目录 → 关联服务空间（需自建或开通 uniCloud 空间）
2. 右键 uniCloud/cloudfunctions/stroke-data → 上传部署（笔画数据 + 工具箱）
3. 右键 uniCloud/cloudfunctions/char-api → 上传部署（汉字详情聚合接口）
4. 小程序前端直接运行：笔画数据走 stroke-data 云函数，详情页异步走 char-api 云函数补齐扩展字段
5. 如需将笔画数据导入数据库：右键 uniCloud/database/strokes.schema.json → 上传 schema，再用脚本导入 data/*.json

4. 隐私与合规

• 笔画查询为只读公开数据，不收集任何用户信息
• TTS 调用有道公共接口，仅传输单个汉字文本
• 符合个人主体小程序「工具-信息查询」类目合规要求