前言¶
在 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 倉庫。
