Kazakh-Convert - 哈萨克文转换技能
版本: 2.0 (OpenClaw 适配版) 创建: 2026-04-05 来源: D:\PROJECT\WEB\kazakh-convert 功能: 哈萨克文在西里尔文和阿拉伯文之间双向转换
📋 技能描述
哈萨克文转换工具，支持在西里尔文（哈萨克斯坦官方文字）和阿拉伯文（中国哈萨克族传统文字）之间相互转换。
核心功能:
- ✅ 西里尔文 → 阿拉伯文
- ✅ 阿拉伯文 → 西里尔文
- ✅ 词库管理（添加/删除/查询自定义词汇）
- ✅ 文件批量转换
- ✅ 语法自动修正
🎯 触发规则
自动触发
当用户消息包含以下关键词时自动调用此技能：
triggers:
- "哈萨克文转换"
- "西里尔文转阿拉伯文"
- "阿拉伯文转西里尔文"
- "kazakh convert"
- "kazakh-convert"
- "转成阿拉伯文"
- "转成西里尔文"
- "哈萨克语转换"手动调用
# 直接调用技能
kazakh-convert convert --mode cyrillic --text "Қазақ тілі"🛠️ 工具定义
转换工具 (convert)
功能: 执行哈萨克文转换
参数:
--mode(必需): 转换模式
- cyrillic: 西里尔文转阿拉伯文 - arabic: 阿拉伯文转西里尔文
--text, -t: 直接输入文本（与--input二选一）--input, -i: 输入文件路径（与--text二选一）--output, -o: 输出文件路径（可选，默认输出到终端）--dict, -d: 用户词库文件路径（默认：skills/kazakh-convert/user.dic）
示例:
# 西里尔文转阿拉伯文
kazakh-convert convert --mode cyrillic --text "Сәлем, қалың қалай?"
# 阿拉伯文转西里尔文
kazakh-convert convert --mode arabic --text "سەلەم، قالىڭ قالاي؟"
# 从文件读取并输出到文件
kazakh-convert convert --mode cyrillic --input input.txt --output output.txt词库管理工具 (dict)
功能: 管理自定义词库
子命令:
列出词库
kazakh-convert dict list --section arabic
kazakh-convert dict list --section cyrillic添加词条
# 添加到阿拉伯文词库（用于西里尔文转阿拉伯文后的修正）
kazakh-convert dict add --section arabic --key "тест" --value "تست"
# 添加到西里尔文词库（用于阿拉伯文转西里尔文后的修正）
kazakh-convert dict add --section cyrillic --key "көмсөмөл" --value "комсомол"删除词条
kazakh-convert dict delete --section arabic --key "тест"📁 文件结构
skills/kazakh-convert/
├── SKILL.md # 技能定义（本文件）
├── kazConvert.py # 转换脚本
├── user.dic # 用户词库
├── README.md # 详细文档（可选）
└── scripts/ # 辅助脚本（可选）
└── convert.bat # Windows 批处理快捷方式🔧 执行脚本
Python 脚本调用
import sys
sys.path.insert(0, 'skills/kazakh-convert')
from kazConvert import convert_text, load_user_dict
# 加载词库
user_dict = load_user_dict('skills/kazakh-convert/user.dic')
# 西里尔文转阿拉伯文
result = convert_text("Қазақ тілі", 'cyrillic', user_dict)
print(result)
# 阿拉伯文转西里尔文
result = convert_text("قازاق ءتىلى", 'arabic', user_dict)
print(result)命令行调用
# 设置 UTF-8 编码
$env:PYTHONIOENCODING="utf-8"
# 执行转换
python skills/kazakh-convert/kazConvert.py convert --mode cyrillic --text "Сәлем"📝 使用场景
场景 1: 日常对话转换
用户: "把这句话转成阿拉伯文：Сәлем, қалың қалай?"
伽马: 调用 kazakh-convert → 返回 "سەلەم، قالىڭ قالاي؟"场景 2: 文件批量转换
用户: "把这个哈萨克语文档转成阿拉伯文"
伽马:
1. 读取文件内容
2. 调用 kazakh-convert convert --mode cyrillic --input file.txt --output output.txt
3. 返回转换后的文件路径场景 3: 词库管理
用户: "添加一个词，'تەكس' 转成 'تەكست'"
用户：转换错误 تەكس应该是تەكست
伽马: 调用 kazakh-convert dict add --section arabic --key "تەكس" --value "تەكست"⚠️ 注意事项
- UTF-8 编码: 所有文件操作必须使用 UTF-8 编码
- 词库优先级: 用户词库优先于内置映射表
- 长词优先: 转换时优先匹配较长的词语
- 语法修正: 转换后自动应用语法规则修正
🧪 测试用例
# 测试 1: 基本西里尔文转阿拉伯文
python kazConvert.py A "сэнің атың кім болады?"
# 预期输出：سەنىڭ اتىڭ كىم بولادى؟
# 测试 2: 基本阿拉伯文转西里尔文
python kazConvert.py C "سەنىڭ اتىڭ كىم بولادى؟"
# 预期输出：сенің атың кім болады?
# 测试 3: 2.0 版本命令
python kazConvert.py convert --mode cyrillic --text "Қазақ тілі"
# 预期输出：قازاق ءتىلى
# 测试 4: 词库管理
python kazConvert.py dict list --section arabic📚 参考资料
- 原版项目：D:\PROJECT\WEB\kazakh-convert
- 哈萨克文西里尔字母：33 个字母（9 个特有：ә, і, ү, ө, ң, ғ, ұ, қ, һ）
- 哈萨克文阿拉伯字母：32 个字母（基于波斯 - 阿拉伯字母表）
🔄 版本历史
- 2.0 (2026-04-05): OpenClaw 技能适配版
- 添加 SKILL.md 触发规则 - 集成到 OpenClaw 技能系统 - 支持自动触发和手动调用
- 2.0 (原版): Python 命令行工具
- 词库管理功能 - 文件输入输出 - 兼容 1.0 语法
- 1.0 (原版): Web 应用版本
*最后更新：2026-04-05*