gongwen-skill 2.10.0 → 2.11.0

package/CHANGELOG.md

@@ -4,6 +4,27 @@
   Licensed under the MIT License. See the LICENSE file for details.
 -->
 
+## v2.11.0 (2026-09-06)
+
+### Added
+- **区分主持词/讲话稿两种朗读件类型**：新增 `host_speech`（主持词）规则文件 `rules/official/host_speech.yaml`；`list-types` 现支持 25 种类型；`-t` 类型识别：`主持词` → `host_speech`、`讲话稿` → `speech`
+- **GitHub Packages scoped 发布**：publish-npm 发布 `@linhut/gongwen-skill` 到 `npm.pkg.github.com`（GitHub Packages 仅支持 scoped 包；原非 scoped 名 E404）
+
+### Changed
+- **针对 DSH 新版本（官方最新版 DeepSeek Harness / Bluebook · Developer Guide）进行 DSH 插件优化整改**（仅 DSH 部分，skill 功能不变）：
+  - `dsh/index.js`：修复 ESM 环境下 `require("schemastery")` 导致的设置面板注册静默失败（改为官方 `import Schema from "@deepseek-ai/schemastery"`）；新增官方模型工具注册 `ctx.tools.register(defineTool({...}))`（工具名 `gongwen`，schema 自动流入系统提示词）；settings 改用官方 `ctx.settings.register("gongwen-skill", schema)` + `scope.watch` 回写 `~/.gongwen-skill/dsh-config.json`（保留 CLI 兼容，首次加载自动迁移旧配置）；移除自建 REST API 路由（WebRoute 官方定义无 `method` 字段，配置读写改由官方 settings 桥承担）；`inject: ["tools"]` 硬依赖 + systemPrompt/settings/skills 可选服务容错
+  - `dsh/client.js`：配置面板迁移至官方 `settings.plugin.item` keyed slot（命名空间 `gongwen-skill`），经 `ctx.settingsScope` 读写官方 settings 文档（revision 设栅）；样式改用 `--dsw-alias-*` 语义 token，去除硬编码颜色
+  - `package.json`：`dsh.client.inject` 收敛为官方 `@deepseek-ai/dsh-client-ui-settings-plugins`（提供 `settings.plugin.item` slot 声明）；新增 peerDependencies（`@deepseek-ai/cordis`/`@deepseek-ai/dsh-tools`/`@deepseek-ai/schemastery`/`@deepseek-ai/dsh-client-ui-settings-plugins`）
+  - README DSH 章节同步（兼容性自查表新增官方 API 对照行、架构边界补充模型工具与设置卡片说明、配置化章节说明双向同步）
+- **讲话稿（speech）规则按筹委会最终版定稿更新**：页边距改国标默认（上3.7/下3.5/左2.8/右2.6cm）；正文改为仿宋_GB2312 18pt 不加粗、行距 30pt；一级标题黑体 18pt、二级标题楷体_GB2312 18pt；署名/日期改楷体_GB2312 18pt 居中、行距 35pt
+- **主持词（host_speech）新增独立样式**：页边距沿用普通公文（2.8/2.8/2.7/2.7cm）；标题 24pt/35pt；主持人信息/日期楷体_GB2312 18pt 居中、行距 30pt；正文 18pt 不加粗、行距 30pt，议程引导句可局部加粗
+- **README/SKILL 同步**：类型数 24→25、讲话稿/主持词分别列出样式说明与差异
+
+### Fixed
+- **GitHub Packages E404**：非 scoped 包名无法发布到 GitHub Packages（v2.1.0~v2.10.0 均受影响）；现发布前 `npm pkg set name="@linhut/gongwen-skill"` 再 publish，并关联回本仓库
+
+---
+
 ## v2.10.0 (2026-09-04)
 
 ### Added
@@ -50,7 +71,6 @@
 
 ### Notes
 - 工具链仅支持 OOXML .docx；旧版 .doc（OLE2/WPS）需经 WPS COM `SaveAs(dst, 12)` 转换后使用（README/SKILL 已注明）
-- 正式发布流程：见 RELEASE.md（一键 bump + 三 remote 推送触发 CI 自动发布）
 
 ## v2.8.0 (2026-09-03)
 

package/README.md

@@ -28,7 +28,7 @@ Licensed under the MIT License. See the LICENSE file for details.
 
 | 能力 | 命令 | 说明 |
 |------|------|------|
-| 📋 列类型 | `list-types` | 列出 24 种支持的公文类型（含新闻稿/讲话稿主持词） |
+| 📋 列类型 | `list-types` | 列出 25 种支持的公文类型（新增主持词 host_speech；含新闻稿/讲话稿） |
 | 🏗️ 模板生成 | `template` | 按类型生成 GB/T 9704 标准空白模板 |
 | 🔍 解析 | `parse` | `.docx` → 结构化 DocumentModel |
 | ✅ 格式检查 | `check` | 按国标检查，分级 P0/P1/P2（只读） |
@@ -102,13 +102,13 @@ Licensed under the MIT License. See the LICENSE file for details.
 
 项目内置以下文字性资源，纯对话 AI 可以直接读取，用作**公文写作指导的知识库**：
 
-| 资源 | 位置 | 内容 | 行数 |
-|:-----|:-----|:------|:----:|
-| **公文语言风格提示词库** | `prompts/style-prompts.md` | 6 套风格（庄重严谨/平实简洁/宏观概括/请示商洽/法规条文/讲话稿），每套含用词规范、句式和语气指导 | 205 |
-| **使用指引与决策速查** | `prompts/usage-prompts.md` | 最小可用指引、决策速查、每种公文类型的用法模板、常见问题解答 | 381 |
-| **公文类型规则库** | `rules/official/*.yaml`（25 个文件） | 每种公文类型的格式规范 + 内容层定义（如"请示应以'妥否，请批示'结尾""通知应以'特此通知'结尾"） | 25 文件 |
-| **通用格式标准** | `rules/official/_common.yaml` | GB/T 9704 国标全文参数：字体/字号/行距/页边距等 | 836 |
-| **技能完整指令** | `SKILL.md` | 路径路由、执行标准、质量评审、禁令清单、审稿机制 | 2854 |
+| 资源 | 位置 | 内容 |
+|:-----|:-----|:------|
+| **公文语言风格提示词库** | `prompts/style-prompts.md` | 6 套风格（庄重严谨/平实简洁/宏观概括/请示商洽/法规条文/讲话稿），每套含用词规范、句式和语气指导 |
+| **使用指引与决策速查** | `prompts/usage-prompts.md` | 最小可用指引、决策速查、每种公文类型的用法模板、常见问题解答 |
+| **公文类型规则库** | `rules/official/*.yaml`（25 个文件） | 每种公文类型的格式规范 + 内容层定义（如"请示应以'妥否，请批示'结尾""通知应以'特此通知'结尾"） |
+| **通用格式标准** | `rules/official/_common.yaml` | GB/T 9704 国标全文参数：字体/字号/行距/页边距等 |
+| **技能完整指令** | `SKILL.md` | 路径路由、执行标准、质量评审、禁令清单、审稿机制 |
 
 **使用方式**：纯对话 AI 在回答用户关于公文写作的问题时，可直接引用上述资源中的内容，例如：
 - 用户问"通知怎么写" → 引用 `rules/official/notice.yaml` 的结语规范和 `style-prompts.md` 的庄重严谨风格
@@ -192,8 +192,8 @@ python -m gongwen style-list            # 列出已学习的模板
 | 字体 | 用途 | TTF 大小 |
 |:-----|:-----|:---------|
 | 方正小标宋简体 | 公文大标题 | 3.7 MB |
-| 仿宋_GB2312 | 正文 | 3.9 MB |
-| 楷体_GB2312 | 二级标题 | 4.0 MB |
+| 仿宋_GB2312 | 正文 | 3.8 MB |
+| 楷体_GB2312 | 二级标题 | 3.9 MB |
 
 **安装方式**：
 - **git clone 用户**：字体文件在 `assets/fonts/` 中，直接安装
@@ -297,7 +297,7 @@ python -m gongwen wizard --answers 答案.json --dry-run  # 只打印将执行
 {"path": "A", "input": "原文.docx", "doc_type": "notice", "output": "成品.docx", "apply": true}
 ```
 
-路径：A 格式优化（`optimize`）｜B 内容优化（`optimize-content`）｜C 生成模板（`template`）｜D 一键格式修复（`fix-common`）。A/B/D 默认先预览再 y/n 确认；不写 `apply` 时非交互模式仅预览不执行（安全默认）。
+路径：A 格式优化（`optimize`）｜B 内容优化（`optimize-content`）｜C 生成模板（`template`）｜D 一键格式修复（`fix-common`）｜E 样式学习（`style-learn`）。A/B/D 默认先预览再 y/n 确认；不写 `apply` 时非交互模式仅预览不执行（安全默认）。
 
 ## 📐 GB/T 9704 标准格式
 
@@ -310,15 +310,19 @@ python -m gongwen wizard --answers 答案.json --dry-run  # 只打印将执行
 | **正文** | 仿宋_GB2312 | 三号（16pt） | 首行缩进2字符 |
 | **西文/数字** | Times New Roman | 与中文字号一致 | — |
 | **页码** | 宋体（4号半角） | 四号（14pt） | 单页右/双页左（双面打印） |
-| **页边距** | — | — | 上3.7/下3.5/左2.8/右2.6 cm |
+| **页边距** | — | — | 上2.8/下2.8/左2.7/右2.7 cm（工具实际采用值，见 `_common.yaml`） |
 
-### 讲话稿/主持词（speech 朗读件）
+### 讲话稿（speech 朗读件）
 
-标题方正小标宋简体 24pt 居中、主持人信息/日期楷体_GB2312 18pt 居中、正文仿宋_GB2312 18pt 加粗、正文行距 33pt exact、标题行距 35pt；跳过版头/版记/发文字号/密级检查。
+页边距为国标默认（上3.7/下3.5/左2.8/右2.6 cm）；标题方正小标宋简体 24pt 居中、行距 35pt；一级标题黑体 18pt、二级标题楷体_GB2312 18pt；署名/日期楷体_GB2312 18pt 居中、行距 35pt；正文仿宋_GB2312 18pt 不加粗、行距 30pt exact、首行缩进 2 字符；跳过版头/版记/发文字号/密级检查。（样式以筹委会最终版定稿为准）
 
-## 📚 支持的 24 种公文类型
+### 主持词（host_speech 朗读件）
 
-通知 · 请示 · 报告 · 函 · 会议纪要 · 纪要 · 决定 · 通告 · 公告 · 命令 · 通报 · 议案 · 批复 · 指示 · 制度 · 公报 · 意见 · 总结 · 方案/计划 · 桌签 · 技术方案 · 决议 · **新闻稿/简报** · **讲话稿/主持词**
+页边距与普通公文一致（上2.8/下2.8/左2.7/右2.7 cm）；标题方正小标宋简体 24pt 居中、行距 35pt；主持人信息/日期楷体_GB2312 18pt 居中、行距 30pt；正文仿宋_GB2312 18pt 不加粗、行距 30pt exact、首行缩进 2 字符，议程引导句（"下面，进行第X项议程…"）可局部加粗；跳过版头/版记/发文字号/密级检查。（样式以筹委会最终版定稿为准）
+
+## 📚 支持的 25 种公文类型
+
+通知 · 请示 · 报告 · 函 · 会议纪要 · 纪要 · 决定 · 通告 · 公告 · 命令 · 通报 · 议案 · 批复 · 指示 · 制度 · 公报 · 意见 · 总结 · 方案/计划 · 桌签 · 技术方案 · 决议 · **新闻稿/简报** · **讲话稿** · **主持词**
 
 > 每种类型对应 `rules/official/*.yaml`，含格式规则 + 内容层定义（structure/focus_checks/title 等），驱动 check/optimize/optimize-content 全链路。
 
@@ -332,7 +336,7 @@ python -m gongwen wizard --answers 答案.json --dry-run  # 只打印将执行
 ```bash
 python -m gongwen rule-export notice -o notice_rules.yaml
 python -m gongwen rule-import my_company -f 公司规范.yaml
-python -m gongwen rule-list notice
+python -m gongwen rule-list --source all
 ```
 
 ## ⚠️ 使用红线
@@ -377,7 +381,7 @@ DSH 采用 **Cordis 模块化微内核架构**：技能体系基于本地文件
 git clone https://github.com/linhut/gongwen-skill.git
 cd gongwen-skill
 pip install -r requirements.txt   # 或 pip install gongwen-skill（已上 PyPI）
-python -m gongwen --version       # 检验：gongwen-skill v2.10.0
+python -m gongwen --version       # 检验：gongwen-skill v2.11.0
 ```
 
 ### 方式一：作为 DSH Skill 注册（基于本地文件系统）
@@ -433,7 +437,7 @@ pnpm add -w gongwen-skill
   "dependencies": {
     "@deepseek-ai/dsh-base": "...",
     "@deepseek-ai/dsh-web-app": "...",
-    "gongwen-skill": "^2.10.0"
+    "gongwen-skill": "^2.11.0"
   },
   "dsh": {
     "profile": {
@@ -449,6 +453,8 @@ pnpm add -w gongwen-skill
 
 > **注意**：若 `add` 启动报错提示子包重复声明，请检查 `dsh.profile.bundles` 数组中**仅包含根包 `gongwen-skill`**，避免同时列入 `engine` 或 `gongwen` 等子目录。
 
+> **DSH 版本要求**：插件按 DeepSeek Harness 官方最新开发文档（Bluebook · Developer Guide）实现——`ctx.tools.register(defineTool(...))`（模型工具）、`ctx.settings.register` + `settings.plugin.item` 卡片（配置）、`ctx.systemPrompt.section`、`ctx.skills.register`。需要承载这些 API 的 DSH 组合（`@deepseek-ai/dsh-base` 等），peerDependencies 已声明 `@deepseek-ai/cordis`、`@deepseek-ai/dsh-tools`、`@deepseek-ai/schemastery` 与 `@deepseek-ai/dsh-client-ui-settings-plugins`。在旧版 DSH（无上述包）上安装会得到 pnpm peer 缺失警告，插件可能无法加载，请升级 DSH 或改用方式一（Skill 文件系统）。
+
 ### 方式三：本地源码链接（用于插件开发）
 
 如果你在本地开发 gongwen-skill 插件，可以用 link 方式让 DSH 直接加载仓库源码：
@@ -469,6 +475,8 @@ dsh plugin --profile web add -w "link:/path/to/gongwen-skill"
 - 插件通过 `spawn("python", ["-m", "gongwen", ...])` 子进程转发命令，**不直接 import 引擎、不操作 docx**，避免双入口行为分裂
 - `dsh/index.js` 的 `POSITIONAL_ARGS` 声明各命令的位置参数（如 `draft: ["input"]`）；新增/调整 CLI 命令位置参数时**必须同步更新该表**，否则插件转发会构造出 `--input` 而 CLI 只接受位置参数
 - 插件保持薄层：业务逻辑全在 CLI / engine，改动引擎不影响插件；改动 CLI 参数形态时需同步检查 `dsh/index.js` 转发（doctor 自检覆盖 DSH 文件存在性）
+- **模型工具注册**：插件通过官方 `ctx.tools.register(defineTool({...}))` 注册名为 `gongwen` 的模型工具，工具 schema 自动流入 DSH 系统提示词组装；`defineTool` 校验模型生成的参数后调用 `runCli()` 透传 Python CLI（详见上方「DSH 插件配置化」）
+- **客户端配置卡片**：`dsh/client.js` 注册进官方 `settings.plugin.item` keyed slot（以命名空间 `gongwen-skill` 为键），经 `ctx.settingsScope` 读写官方 settings 文档，UI 样式使用 `--dsw-alias-*` 语义 token（官方 Client UI & Slots 规范）
 
 ### 🚀 启动 DSH Web 服务
 
@@ -493,6 +501,12 @@ dsh --profile web
 | 目录技能格式 (`.dsh/skills/gongwen-skill/SKILL.md`) | ✅ |
 | 单文件技能格式 (`.dsh/skills/gongwen-skill.md`) | ✅ 双格式兼容 |
 | Cordis 插件包：`package.json` + `dsh/` + `cordis.patch.yml` | ✅ |
+| 插件 bundle 声明：`dsh.bundle.patch`（官方「第三方插件」规范） | ✅ |
+| 客户端半侧声明：`dsh.client` + `exports["./client"]`（官方 Client 模块系统） | ✅ |
+| 模型工具注册：`ctx.tools.register(defineTool(...))`（官方 Registering Tools 规范） | ✅ `gongwen` 工具 |
+| 配置面板：官方 `settings.plugin.item` 卡片 + `ctx.settingsScope`（官方 Client UI & Slots） | ✅ |
+| 系统提示注入：`ctx.systemPrompt.section`（官方 Host Services & Events） | ✅ |
+| 运行时技能：`ctx.skills.register`（官方 Skills 注册表） | ✅ |
 | CLI 独立可执行（`python -m gongwen <命令>`） | ✅ |
 | PyPI 上架（`pip install gongwen-skill`） | ✅ |
 | 零外部运行时依赖（仅 python-docx/pydantic/pyyaml） | ✅ |
@@ -502,6 +516,13 @@ dsh --profile web
 
 DSH 插件支持通过配置文件管理排版参数，Agent 调用时自动注入，纯 CLI 用户不受影响。
 
+**两种配置入口（同一数据，双向同步）**：
+
+1. **DSH Web 设置面板（推荐）**：系统设置 → 插件配置 → **gongwen-skill** 卡片，按官方 `settings.plugin.item` 卡片规范渲染；保存后写入 DSH 官方 settings 文档，并由插件 Host 的 `scope.watch` 自动同步到 `~/.gongwen-skill/dsh-config.json`
+2. **CLI / 配置文件**：直接编辑 `~/.gongwen-skill/dsh-config.json`，或通过插件 `config` 命令管理
+
+> **兼容性**：插件首次在带 settings provider 的 DSH 部署中加载时，会把已存在的 `~/.gongwen-skill/dsh-config.json` 一次性迁移进官方 settings 命名空间（仅当设置面板尚无用户覆盖时），之后以设置面板 / settings 文档为权威源，双向同步。
+
 **配置文件**：`~/.gongwen-skill/dsh-config.json`
 
 **初始化配置**（从默认模板创建）：
@@ -622,7 +643,7 @@ pip install -r requirements.txt
 用户：帮我优化这份会议通知的第二章节措辞
 
 Agent：📋 合规自检报告
-Skill 版本: v2.10.0（版本自检已确认最新）
+Skill 版本: v2.11.0（版本自检已确认最新）
 路径判定: B（内容优化）
 依据: 用户指定了已有文档，且要求"优化措辞"
 命令调用: 1. python -m gongwen optimize-content 会议通知.docx --changes changes.json --apply --paragraphs "5-8"

package/SKILL.md

@@ -888,7 +888,7 @@ python -m gongwen fix-common 文件.docx -o 成品.docx
 
 | 命令 | 用途 | 最小用法 |
 |------|------|---------|
-| `list-types` | 列出 24 种支持的公文类型 | `python -m gongwen list-types` |
+| `list-types` | 列出 25 种支持的公文类型 | `python -m gongwen list-types` |
 | `template` | 按类型生成 GB/T 9704 空白模板 | `python -m gongwen template notice -o 通知.docx` |
 | `generate` | 从 DocumentModel JSON 生成 .docx | `python -m gongwen generate 模型.json -o 公文.docx` |
 | `md2docx` | Markdown 草稿 → 格式化公文（初稿） | `python -m gongwen md2docx 草稿.md -o 公文.docx -t notice` |
@@ -2659,9 +2659,15 @@ python -m gongwen check 成品.docx -t <类型> --json
 | 时间 | 楷体_GB2312 | 18pt | 居中 | "2026年7月X日" 单独一行 |
 | 称谓（同志们） | 仿宋_GB2312 | 18pt | 两端对齐 | 顶格书写 |
 | 正文 | 仿宋_GB2312 | 18pt | 两端对齐，首行缩进2字符 | |
-| 讲话要点标题 | 黑体 | 18pt | 顶格 | 第一、第二、第三等层次标题 |
+| 讲话要点标题 | 黑体 | 18pt | 首行缩进2字 | 一、二、三 等层次标题 |
 | 议程导引 | 仿宋_GB2312 | 18pt | 两端对齐 | "首先""下面""现在"等过渡语 |
 
+> **讲话稿（speech）与主持词（host_speech）格式差异**（以筹委会最终版定稿为准）：
+> - 页边距：讲话稿用国标默认（上3.7/下3.5/左2.8/右2.6cm）；主持词与普通公文一致（上2.8/下2.8/左2.7/右2.7cm）。
+> - 署名/日期行距：讲话稿 35pt；主持词 30pt（均楷体_GB2312 18pt 居中）。
+> - 正文：均为仿宋_GB2312 18pt 不加粗、行距 30pt exact、首行缩进 2 字；主持词议程引导句可局部加粗。
+> - 一级标题（一、…）黑体 18pt；二级标题（第一…/一是…）楷体_GB2312 18pt，均为行距 30pt、首行缩进 2 字。
+
 ---
 
 #### C8. 调研函 / 征求意见函（高频文种）
@@ -2868,7 +2874,7 @@ XX处                                                 ← 华文楷体 16pt 居
 
 ---
 
-## 附录一：24 种公文类型（`-t` 参数）
+## 附录一：25 种公文类型（`-t` 参数）
 |--------|--------|--------|--------|
 | `notice` | 通知 | `request` | 请示 |
 | `report` | 报告 | `letter` | 函 |
@@ -2881,7 +2887,8 @@ XX处                                                 ← 华文楷体 16pt 居
 | `opinion` | 意见 | `summary` | 总结 |
 | `work_plan` | 方案/计划 | `table_sign` | 桌签 |
 | `technical_proposal` | 技术方案 | `resolution` | 决议 |
-| `speech` | **讲话稿/主持词** | `news` | **新闻稿/简报** |
+| `speech` | **讲话稿** | `news` | **新闻稿/简报** |
+| `host_speech` | **主持词** | | |
 
 > **news（新闻稿/简报）特殊规则**（提质方案 v2.1 问题一）：标题为**事件陈述式**（≤35 字，含时间/地点/事件三要素，不做精简），非法定公文"事由+文种式"（≤20 字）。标题支持两种模式：专题会议式（`{部门/工作}+{会议类型}+在{地点}+召开`）与常规会议式（`{机构}+{部门}+第{序次}次+{会议类型}+召开`）。不检查主送机关/落款/附件说明等法定要素；必检：人名/职务/机构名准确性、时间一致性、逻辑闭环（听取→指出→强调→要求）、稿源/编辑信息。