学中文引擎

技能简介

xuezh 是一个基于命令行的普通话学习引擎，支持学习进度快照、到期项目复习、语音处理与学习事件记录。

业务背景

学中文引擎为语言学习者提供结构化的普通话训练闭环，通过进度快照与到期复习机制确保知识巩固，结合语音分析功能实现发音纠偏。该工具将分散的学习记录集中管理，帮助学习者建立可持续的自主学习习惯，降低因缺乏反馈而中断学习的风险。

落地案例：某企业员工计划三个月内通过普通话水平测试，使用学中文引擎配置个人学习档案后，每日执行快照命令查看当日待复习条目，系统按优先级推送到期项目。员工录制朗读音频上传至引擎，获取发音准确度分析结果，针对性强化薄弱环节。所有学习事件自动记录至本地目录，便于周末复盘调整下周计划。

能做什么

• 获取学习者当前状态快照
• 按优先级复习到期学习项目
• 处理语音文件进行发音分析
• 管理学习内容条目
• 记录学习活动日志

使用说明

安装要求

需配置 Azure 语音服务密钥与区域：

# 环境变量
XUEZH_AZURE_SPEECH_KEY_FILE=/path/to/key
XUEZH_AZURE_SPEECH_REGION=westeurope

基础用法

1. 查看学习状态：xuezh snapshot --profile default
2. 复习到期项目：xuezh review next --limit 10
3. 处理语音文件：xuezh audio process-voice --file ./utterance.wav
4. 输出 JSON 格式：加 --json 参数

默认循环模式

1. 调用 xuezh snapshot 获取状态
2. 制定简短学习计划（1-2项）
3. 执行学习活动
4. 记录学习结果

输入与输出

见下方输入与输出表格。

风险提示

• 必须严格按 CLI 规范调用，缺失命令时需请求实现而非猜测
• 依赖 Azure 语音服务，需提前配置有效密钥
• 语音处理需本地音频文件支持
• 学习数据存储于本地 .config/xuezh 目录

来源信息

原始链接：https://github.com/openclaw/skills/tree/main/skills/local/xuezh/SKILL.md
来源类型：GitHub 仓库