gongwen-skill 2.9.0 → 2.11.0

package/CHANGELOG.md

@@ -4,6 +4,49 @@
   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
+- **测试补强（整改 A / P1-1）**：新增 `tests/test_checker.py`/`test_optimize.py`/`test_content_cmds.py`/`test_json_output.py` 26 用例，覆盖 check/optimize/content 核心路径与 `--json` 输出（tests/ 本地-only，不同步仓库）
+- **`parse`/`md2docx`/`rule-export` 统一 `--json`（整改 B / P1-2）**：Agent 高频命令补齐结构化输出，向后兼容（不带 `--json` 保持原行为）
+- **CHK-L003 语义类规则静默跳过**：`language.*` 字段不再刷「未支持检查字段」告警（语言规范类由人工/LLM 审校覆盖，规则定义保留）
+- **`optimize --json` 新增 `verify_executed`/`verify_passed` 明确字段（P2-3）**：`verify_passed = (verify_p0 == 0)` 与退出码语义一致，消除旧 `verified` 字段命名歧义（旧字段保留向后兼容）
+- **README 新增 Windows 控制台编码说明（P2-5）**：原生 cmd GBK 乱码排查（chcp 65001 / Windows Terminal / PYTHONIOENCODING=utf-8）
+
+### Changed
+- **`main()`/命令注册迁出 `_legacy.py`（整改 C / P0-1）**：29 个 add_parser 注册 + 命令分组/格式化器迁至 `gongwen/cli/app.py`；`_legacy.py` 1320→936 行，仅保留 10 个核心命令实现与兼容转发；入口 `from gongwen.cli.app import main`；迁移前后 29 命令 help/version 快照零差异
+
+### Fixed
+- `tests/test_netcheck.py` 既有 F841（未使用变量）清理
+- **8 处静默降级 pass 补日志（P2-4）**：md2docx_render 3 处 / draft_cmds 1 处 / wizard_cmds 1 处 / font_cmds 3 处，异常不再无声吞掉（新增 3 个模块 logger）
+- **清理本地 dist/ 与 build/ 残留（P2-2）**：删除 2.7.0/2.8.0 旧构建产物（gitignore 忽略，不影响发布流程）
+
+### Notes
+- 审计整改 D 决策（2026-09-04）：remote token 保持现状（已查证未进入 git 历史，风险记录在本地审计报告）；CI 接受现状（本地跑测试作发布门禁），详见 `docs/design/2026-09-04-project-audit-report.md` §6（本地存档）
+
+---
+
 ## v2.9.0 (2026-09-04)
 
 ### Added
@@ -28,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` 的庄重严谨风格
@@ -174,6 +174,17 @@ python -m gongwen style-learn 标准公文.docx -n 模板名
 python -m gongwen style-list            # 列出已学习的模板
 ```
 
+### 🖥️ Windows 控制台编码（GBK 乱码排查）
+
+工具内部已统一按 UTF-8 输出（`gongwen/_bootstrap.py` 强制 stdout/stderr/stdin 重配置为 UTF-8，
+保证管道/Agent 调用无编码问题）。若在原生 `cmd`（默认 GBK 代码页 936）看到中文乱码，任选其一：
+
+- **推荐**：改用 Windows Terminal / VS Code 终端（默认 UTF-8，无乱码）
+- 在 cmd 中先执行 `chcp 65001` 切换 UTF-8 代码页，再运行命令
+- 或设置环境变量 `PYTHONIOENCODING=utf-8`（与工具内部行为一致）
+
+> 说明：GBK 乱码仅影响原生 cmd 的**交互显示**，不影响文件内容与 `--json` 的机器可解析性。
+
 ### 🔤 字体管理
 
 公文标准字体是 GB/T 9704 排版的关键。项目内置 3 个标准字体文件（`assets/fonts/`），支持自动安装：
@@ -181,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/` 中，直接安装
@@ -286,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 标准格式
 
@@ -299,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 朗读件）
+页边距为国标默认（上3.7/下3.5/左2.8/右2.6 cm）；标题方正小标宋简体 24pt 居中、行距 35pt；一级标题黑体 18pt、二级标题楷体_GB2312 18pt；署名/日期楷体_GB2312 18pt 居中、行距 35pt；正文仿宋_GB2312 18pt 不加粗、行距 30pt exact、首行缩进 2 字符；跳过版头/版记/发文字号/密级检查。（样式以筹委会最终版定稿为准）
 
-标题方正小标宋简体 24pt 居中、主持人信息/日期楷体_GB2312 18pt 居中、正文仿宋_GB2312 18pt 加粗、正文行距 33pt exact、标题行距 35pt；跳过版头/版记/发文字号/密级检查。
+### 主持词（host_speech 朗读件）
 
-## 📚 支持的 24 种公文类型
+页边距与普通公文一致（上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 全链路。
 
@@ -321,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
 ```
 
 ## ⚠️ 使用红线
@@ -366,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.9.0
+python -m gongwen --version       # 检验：gongwen-skill v2.11.0
 ```
 
 ### 方式一：作为 DSH Skill 注册（基于本地文件系统）
@@ -422,7 +437,7 @@ pnpm add -w gongwen-skill
   "dependencies": {
     "@deepseek-ai/dsh-base": "...",
     "@deepseek-ai/dsh-web-app": "...",
-    "gongwen-skill": "^2.9.0"
+    "gongwen-skill": "^2.11.0"
   },
   "dsh": {
     "profile": {
@@ -438,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 直接加载仓库源码：
@@ -458,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 服务
 
@@ -482,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） | ✅ |
@@ -491,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`
 
 **初始化配置**（从默认模板创建）：
@@ -611,7 +643,7 @@ pip install -r requirements.txt
 用户：帮我优化这份会议通知的第二章节措辞
 
 Agent：📋 合规自检报告
-Skill 版本: v2.9.0（版本自检已确认最新）
+Skill 版本: v2.11.0（版本自检已确认最新）
 路径判定: B（内容优化）
 依据: 用户指定了已有文档，且要求"优化措辞"
 命令调用: 1. python -m gongwen optimize-content 会议通知.docx --changes changes.json --apply --paragraphs "5-8"
@@ -655,7 +687,7 @@ Skill 定位为**工具层**，默认不依赖 LLM（确定性工作全自包含
 
 **原理**：安全 DNS（DoH，DNS over HTTPS）通过加密 HTTP 查询 DNS，避免中间设备篡改解析结果，可拿到域名的真实 IP。本工具内置阿里（dns.alidns.com）、腾讯（doh.pub / 1.12.12.12）等国内公共 DoH 端点，多端点自动降级；可通过环境变量 GONGWEN_DOH 覆盖为自定义端点（如自建的 DoH 服务）。
 
-**自动兜底（v2.9.0）**：`font install` 下载字体、`check-update` 查 PyPI 时若常规请求失败（疑似 DNS 污染），自动用 DoH 真实 IP + TLS SNI 直连重试——TLS 证书仍按真实域名校验，安全不降级，用户零操作。
+**自动兜底（v2.10.0）**：`font install` 下载字体、`check-update` 查 PyPI 时若常规请求失败（疑似 DNS 污染），自动用 DoH 真实 IP + TLS SNI 直连重试——TLS 证书仍按真实域名校验，安全不降级，用户零操作。
 
 **处置建议**（按推荐度）：
 1. 若使用了代理工具（Clash/V2Ray 等）且系统解析命中 198.18.x Fake-IP，优先检查其 DNS 模式的 fake-ip-filter 是否漏掉 GitHub 域名（比改 hosts 更治本）

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 字）。标题支持两种模式：专题会议式（`{部门/工作}+{会议类型}+在{地点}+召开`）与常规会议式（`{机构}+{部门}+第{序次}次+{会议类型}+召开`）。不检查主送机关/落款/附件说明等法定要素；必检：人名/职务/机构名准确性、时间一致性、逻辑闭环（听取→指出→强调→要求）、稿源/编辑信息。