在新疆的许多学校里，有这样一群孩子——他们的母语是维吾尔语或哈萨克语，却需要用汉语完成汉字书写学习。教学资源的分散、家庭辅导时的语言障碍、教师批改作业的繁重负担……这些现实中的困难，催生了丝路书韵的诞生。
我们相信，好的教育工具应该让学习变得简单，让每一位老师都能轻松教学，让每一个孩子都能在纸笔间感受汉字的美。
- 🔍 智能搜字：输入拼音即可查找 9500 多个汉字，支持拍照识字、语音搜字
- 🎬 笔画动画演示：每一笔的顺序、方向都以动画形式展示，就像老师在黑板上板书一样
- ✍️ 田字格书写练习：孩子在屏幕上跟写，系统实时渲染笔锋效果，写完自动评分
- 🎮 汉字闯关游戏：以游戏化方式巩固学习，获得积分，激发学习兴趣
- 🗣️ 语音造句练习：孩子朗读造句，系统自动识别并纠正发音
- 📚 练字档案：自动记录每次练习的分数和错误，孩子可以随时回顾改进
- 📊 学情仪表盘：全班平均分、及格率、易错字排行，一目了然
- 🔎 易错字分析：自动统计学生错误率最高的汉字，帮助老师精准定位教学难点
- 📝 作业布置：在线选择生字下发练习，设置练习次数和截止时间
- 📽️ 一键生成课件：自动提取当日高频错字，生成可交互的教学幻灯片，直接用于课堂演示
- 📅 成长日报：直观展示孩子当天的练习成果和进步曲线
- 💬 双语辅导卡片：维吾尔语、哈萨克语双语对照，帮助家长理解孩子的学习内容
- 📈 每周学习报告：自动生成包含积分、排名、图表的学情报告
平台自主研发了书写引擎，采用贝塞尔曲线平滑算法和动力学笔锋算法。简单来说：
- ⚡ 孩子写得快，笔画就细而飘逸
- 🐢 写得慢，笔画就粗而顿挫
就像真正的毛笔书法一样，让数字书写也有"温度"。
孩子写完字后，系统会从多个维度进行评分：
- ✅ 笔画数是否正确
- 🔄 笔顺是否正确（能识别"倒插笔"等常见错误）
- 📐 笔画位置和方向
- 📏 笔画长度比例
评分结果精确到 0-100 分，并给出具体的改进建议，比如"第三笔方向偏差较大"。
全平台支持简体中文、维吾尔语、哈萨克语三种语言的一键切换。无论是界面文字、教学提示还是语音朗读，都能根据选择自动切换，真正实现多语言教学。
平台基于 UniApp 框架开发，同一套代码可以运行在：
- 🌏 手机浏览器（H5 网页）
- 💬 微信小程序
- 🤖 安卓手机
- 🍎 苹果手机
学校可以根据自己的条件灵活选择使用方式。
核心的识字、书写、评分功能完全可以在没有网络的情况下正常使用。9500 多个汉字的笔画数据全部内置在应用中，不需要联网下载。
┌─────────────────────────────────────────────┐
│ 丝路书韵 跨平台应用 │
│ H5 │ 微信小程序 │ App(iOS/Android) │
└─────────────────────┬───────────────────────┘
│
┌─────────────┼─────────────┐
▼ ▼ ▼
┌───────┐ ┌───────┐ ┌───────┐
│学生端 │ │教师端 │ │家长端 │
└───┬───┘ └───┬───┘ └───┬───┘
│ │ │
└───────────┼───────────┘
│
┌───────────────▼───────────────┐
│ 核心引擎层 │
│ 笔画引擎 │ 书写引擎 │ 评分引擎 │
└───────────────┬───────────────┘
│
┌───────────────▼───────────────┐
│ 服务层 │
│ AI服务 │ 词典服务 │ 数据服务 │
└───────────────────────────────┘
| 引擎 | 功能说明 |
|---|---|
| 🎬 笔画引擎 | 解析汉字的笔画数据，以动画形式展示每一笔的书写顺序 |
| ✏️ 书写引擎 | 采集触控坐标，平滑处理笔迹，实时渲染笔锋效果 |
| 📊 评分引擎 | 对比标准笔顺与用户书写，多维度评分并给出改进建议 |
| 技术领域 | 使用技术 |
|---|---|
| 🖼️ 核心框架 | Vue 3.4（Composition API） + TypeScript 4.9 |
| 📦 跨平台方案 | UniApp 3.0（基于 Vite 5.2） |
| ⚙️ 构建工具 | Vite 5.2 + @dcloudio/vite-plugin-uni |
| 🗃️ 状态管理 | Pinia 2.1 |
| 🌍 多语言 | Vue I18n 9.14 |
| 📷 文字识别 | Tesseract.js 7.0（WebAssembly） |
| 🎙️ 语音识别 | Web Speech API + 百度语音 STT/TTS |
| 📖 中文处理 | cnchar 3.2（含 words / idiom / explain 插件） |
| 🔤 拼音转换 | pinyin-pro 3.28 |
| 🈲 汉字数据 | Hanzi Writer 2.0（9575 字 SVG + 中线数据） |
| 🎨 图形渲染 | Canvas 2D API（DPR 自适应） |
| 📐 代码规范 | ESLint 10 + Prettier 3 + vue-eslint-parser |
| ✅ 类型检查 | vue-tsc 1.0 + @vue/tsconfig |
- 🟢 Node.js 16 或以上版本
- 🟢 npm 7 或以上版本
# 安装依赖
npm install
# 启动开发环境（H5 网页版）
npm run dev:h5启动后，浏览器会自动打开平台首页，选择身份（学生/教师/家长）即可进入相应界面。
# 编译为 H5 网页（用于部署到服务器）
npm run build:h5
# 编译为微信小程序
npm run build:mp-weixin微信小程序编译完成后，使用微信开发者工具打开 dist/build/mp-weixin 目录即可预览。
平台内置了多个数据处理脚本，用于管理汉字库和索引：
| 命令 | 说明 |
|---|---|
npm run data:sync |
📥 同步基础汉字数据 |
npm run data:index |
🗂️ 生成汉字索引 |
npm run data:search-index |
🔍 生成搜索索引 |
npm run data:enrich |
📚 丰富汉字详细信息（笔顺、拼音、释义） |
npm run data:words |
💬 生成词语数据（两字词、四字成语） |
平台内置三种语言，用户可以在应用内一键切换：
| 语言 | 说明 |
|---|---|
| 🇨🇳 简体中文 | 界面文字、教学提示、语音朗读 |
| 🇺🇾 维吾尔语（ئۇيغۇرچە） | 界面文字、辅导卡片 |
| 🇰🇿 哈萨克语（Қазақша） | 界面文字、辅导卡片 |
语言偏好会自动保存，下次打开应用时保持上次的选择。
| 指标 | 数值 | 说明 |
|---|---|---|
| 📚 汉字库规模 | 9,500+ | 覆盖小学全部常用汉字 |
| ⚡ 离线评分速度 | < 50 毫秒 | 纯前端计算，无需联网 |
| 🔍 拼音搜索响应 | < 10 毫秒 | 高效缓存机制 |
| 📱 小程序包大小 | < 2 MB | 字体通过 CDN 动态加载 |
如果您是技术老师或开发者，想要深入了解平台的实现细节，可以查看以下关键文件：
- 🎬 笔画动画实现：
src/engine/strokeEngine.ts - ✏️ 书写采集逻辑：
src/engine/writeEngine.ts - 📊 评分算法实现：
src/engine/evaluateEngine.ts - 🤖 AI 服务集成：
src/services/aiService.ts - 🎨 田字格组件：
src/components/TianGridCanvas.vue
本项目采用 PolyForm Noncommercial License 1.0.0。
简要说明：
| 行为 | 原作者 | 其他使用者 |
|---|---|---|
| 复制、分发、修改 | ✅ | ✅（须保留署名） |
| 用于学习、研究、非营利 | ✅ | ✅ |
| 🔞 用于商业目的 | ✅ 保留全部权利 | ❌ 禁止 |
如需商业使用，请联系原作者获取授权。
🖌️ Strokes · 丝路书韵 —— 用数字技术传承中华文化，让丝路书香浸润童心
为新疆小学汉字教学而生 ❤️