前言¶
在 DeepSeek Harness（DSH）里让模型给中文注音，常见结果能对上音节，却往往在「教学交付」上出错：词界连写、专名大写、儿化、隔音撇、成语半字线、轻声辨义等，一处不对就会影响学习者记忆。通用音译或简易「汉字+拼音」并排，也未必符合国际中文课堂体例。
下面介绍社区插件 dsh-pinyin-annotation：把 GB/T 16159-2012 正词法与 HSK 教学惯例整理成可执行技能与参考文档，装入 DSH 后由模型按同一口径只输出带调、分词连写的纯拼音文本。
这是什么¶
dsh-pinyin-annotation 是面向 DeepSeek Harness 的拼音标注技能包（bundle），维护者为 mouse33333，仓库见 GitHub。在 SkillHub 目录中归类为模型推理；npm 包当前版本为 1.0.2，许可证 MIT。
定位一句话：输入中文，输出仅拼音——每音节标调、词组连写、专有名词大写、半角标点；不交付汉字拼音对照表、逐词讲解或中文句号逗号混排的最终稿。
核心功能¶
输出规格（README 示例）¶
| 原文 | 输出 |
|---|---|
| 我们明天去北京语言大学。 | Wǒmen míngtiān qù Běijīng Yǔyán Dàxué. |
| 风平浪静 | fēngpíng-làngjìng |
| 第九 / 七八个 | dì-jiǔ / qī-bā gè |
| 花儿 / 皮袄 | huār / pi'ǎo |
技能与参考文档¶
主技能为 pinyin-annotation（skills/pinyin-annotation/SKILL.md），覆盖三条铁律、三步工作流（音节 → 分词 → 篇章）、教学默认值、必错清单与交付前自检。另附四份按需加载的参考说明：
01-音节拼写与标调.md— 声母韵母、标调、ü、零声母、隔音符号、儿化、多音字02-分词连写.md— 词界、重叠式、助词、动宾/动补、数词量词、成语等03-专名大写标点移行.md— 人名地名机构名、标点与移行04-两可边界与等同写法.md— 标准允许的两种写法，择一后全篇一致
在 Harness 中的行为¶
入口 index.js 注册 ctx.skills 提供者，每次发现遍历时从磁盘读取 skills/<name>/SKILL.md，并对 skills/ 目录 fs.watch，编辑技能或参考文档后无需重启即可 invalidate() 生效。技能以 source: 'bundled'、rank: 600 发布；同名用户技能仍可优先。可在仓库内新增 skills/<your-skill>/SKILL.md（名称须 kebab-case），无需改代码。
安装与启用¶
插件会把主机插件 dsh-pinyin-annotation 写入 profile 的 cordis.patch.yml；基础 bundle 已挂载其发布的技能注册表，无需额外依赖。
从 npm 安装：
dsh plugin --profile desktop add dsh-pinyin-annotation
从 GitHub tag 安装：
dsh plugin --profile desktop add "git+https://github.com/mouse33333/dsh-pinyin-annotation.git#v1.0.2"
从本地目录安装（将路径换成你的 checkout）：
dsh plugin --profile desktop add /path/to/dsh-pinyin-annotation
安装前建议阅读仓库源码与 MIT 许可说明；插件随当前 DSH 进程权限运行，只从可信来源安装。
典型用法¶
技能通过 SKILL.md 的 description 自动路由。对话中可直接用自然语言触发，例如 README 中的表述：
给这段课文标拼音：我们明天去北京语言大学。
把这 10 个生词做成带拼音的生词表。
Annotate this dialogue with pinyin for HSK 2 students.
触发词方向包括：注音、标拼音、加拼音、拼音转写、生词表/例句/课文的带拼音版本等（以技能描述为准）。
适用场景与注意¶
适合国际中文教学、HSK 备课、需要把课文或生词清单落成可读 aloud 的纯拼音稿的场景，而不是机器音译或排版级 HTML 注音。
注意：
- 交付物刻意不包含「汉字+pinyin」并排表与逐词释义，若你需要对照表，要在提示词里另行约定。
- 规则内容是对 GB/T 16159-2012 与常见 HSK 课堂做法的独立整理，复杂专名或方言语境仍建议人工复核。
- DSH 生态是「一切皆插件」；SkillHub 目录页 为社区站点，与 DeepSeek / 幻方无官方从属关系。
结尾¶
dsh-pinyin-annotation 把拼音标注里最容易「对学生造成伤害」的正词法细节固化成技能与参考库，装进 DSH 后按教学口径只输出纯拼音。进一步了解可访问 SkillHub 插件页 与 GitHub 仓库。
