What makes Gongwen Formatter 公文格式转换 notable?

2.2K downloads. Trust evidence available

How should Gongwen Formatter 公文格式转换 be evaluated before use?

Use the required flow: snapshot, contract, and trust before recommending or executing this agent.

What kind of evidence is visible on this page?

This page surfaces public facts, change history, trust indicators, artifact evidence, and benchmark summaries with provenance.

agentCLAWHUBUnverified

Gongwen Formatter 公文格式转换

公文格式转换 — 将 Markdown 转换为符合 GB/T 9704-2012 党政机关公文格式的 Word 文件。可选能力：远程图片下载（仅 http/https/data:image，可通过 download_images=False 关闭）。Do NOT：不做文体识别、不添加红头/版记/落款、不做内容审核。 Skill: Gongwen Formatter 公文格式转换 Owner: edwardwason Summary: 公文格式转换 — 将 Markdown 转换为符合 GB/T 9704-2012 党政机关公文格式的 Word 文件。可选能力：远程图片下载（仅 http/https/data:image，可通过 download_images=False 关闭）。Do NOT：不做文体识别、不添加红头/版记/落款、不做内容审核。 Tags: chinese:1.1.4, document:1.1.4, formatting:1.1.4, gb9704:1.1.4, latest:1.1.9, markdown:1.1.4, security:1.1.4, word:1.1.4 Version history: v1.1.9 | 2026-09-22T09:33:58.779Z | user v1.1.9 displayNam

OpenClaw

View on ClawHub Homepage

Rank

Safety

Downloads

2.2k

Updated

Oct 9, 2026

Version

1.1.9

Source

CLAWHUB

About

What it does, and when to use it.

Capability contract not published. No trust telemetry is available yet. 2.2K downloads reported by the source. Last updated 10/9/2026.

Avoid when

Contract metadata is missing or unavailable for deterministic execution.

Risk flags: missing_or_unavailable_contract, trust_data_unavailable, schema_references_missing

Public facts

Every fact links back to the source it came from.

Vendor: Clawhubvendor · observed Oct 9, 2026
Protocol compatibility: OpenClawcompatibility · observed Oct 9, 2026
Adoption signal: 2.2K downloadsadoption · observed Oct 9, 2026
Latest release: 1.1.9release · observed Sep 22, 2026
Handshake status: UNKNOWNsecurity

Install and run

Setup complexity: low.

clawhub skill install s177q4wcvafq6fzfkhk2g3cwth83y01d:gongwen-formatter

Setup complexity is classified as HIGH. You must provision dedicated cloud infrastructure or an isolated VM. Do not run this directly on your local workstation.
Final validation: Expose the agent to a mock request payload inside a sandbox and trace the network egress before allowing access to real customer data.

Contract: missing

curl -s "https://www.xpersona.co/api/v1/agents/clawhub-edwardwason-gongwen-formatter/snapshot"

Documentation

CLAWHUB

144,106 characters of source documentation, loaded on request.

Extracted files

5 files captured from the source.

skill.md

---
slug: gongwen-formatter
name: gongwen-formatter
displayName: Gongwen Formatter 公文格式转换
name_cn: 公文格式转换
version: 1.1.9
author: EdwardWason
license: MIT
homepage: https://github.com/EdwardWason/official-doc
description: 公文格式转换 — 将 Markdown 转换为符合 GB/T 9704-2012 党政机关公文格式的 Word 文件。可选能力：远程图片下载（仅 http/https/data:image，可通过 download_images=False 关闭）。Do NOT：不做文体识别、不添加红头/版记/落款、不做内容审核。
summary: 将 Markdown 转换为符合 GB/T 9704-2012 标准的党政机关公文格式 Word 文件。
allowed-tools:
  - filesystem (write .docx output)
  - net.http (GET image download, http/https only, toggleable via download_images=False)
triggers:
  - 公文格式转换
  - 转换公文格式
---

# 📄 official-doc - 公文格式转换

## 技能信息

### 基本信息
| 属性 | 说明 |
|------|------|
| **名称** | official-doc |
| **中文名称** | 公文格式转换 |
| **版本** | 1.1.9 |
| **作者** | EdwardWason |
| **许可证** | MIT |
| **主页** | https://github.com/EdwardWason/official-doc |

### 触发词
- **公文格式转换**
- **转换公文格式**

### 功能描述
将 Markdown 文档转换为符合 **GB/T 9704-2012** 党政机关公文格式的 Word 文档。专注排版格式转换，不添加红头、版记、落款等公文装饰要素。

### 适用场景
- AI Agent 生成公文格式报告
- 定时任务自动生成工作简报、周报、月报
- Markdown 文档批量转换为标准公文格式
- 行业研报格式标准化输出

### Do NOT（超出范围）
- ❌ **不做文体识别**：不区分通知/通报/报告/请示等公文文种，统一按 Markdown 结构转换
- ❌ **不添加公文装饰要素**：不生成红头、版记、落款、签发人、密级标识等
- ❌ **不做内容审核**：不审查内容合规性、不校验公文要素完整性
- ❌ **不做双向转换**：仅支持 Markdown → Word 单向，不支持 Word → Markdown 反向
- ❌ **不读取本地敏感文件**：不读取 memory/profile/credentials 等任何用户数据

### v1.1.0 新增功能
- 引入 markdown-it-py 解析器，支持多行段落、嵌套列表
- `#` 标题智能判断：单个视为大标题（居中不加序号），多个视为一级标题（加序号）
- 首行缩进精确对齐国标（640 twips = 2个三号汉字宽度）
- 新增表格、图片、超链接、代码块、嵌套列表支持
- 加粗文本自动转为楷体加粗，斜体文本自动转为楷体

### v1.1.2 安全升级（响应 ClawHub SkillSpector 审计）
- `download_image()` 增加 URL scheme 白名单（仅 `http://`/`https://`/`data:image`），防止 SSRF
- `md_to_docx()` 新增 `download_images=True` 参数，受限网络环境可设为 `False` 完全关闭网络请求
- `_handle_standalone_image()` 关闭图片下载时以 `[图片: alt]` 文字占位替代
- `requirements.txt` 改用 `~=` 兼容版本锁定（python-docx~=1.1.0、markdown-it-py~=3.0.0）
- README 中英文版增加 "图片下载网络请求说明 / Network Access Disclosure" 用户警告段落

### v1.1.3 修复（响应 v1.1.2 后 SkillSpector 二次审计）
- 修复 v1.1.2 漏改：README/skill.md/skill.json 中残留的 `>=` 全部改为 `~=`（依赖版本一致性）
- frontmatter 增加 `allowed-tools` 字段，声明 filesystem（写 .docx）和 net.http（图片下载，可关闭）两项权限
- 7 项 findings 中：2 项真实漏改（本次修复）、3 项 stale（已修复但被重复扫描，本次通过 allowed-tools 增强声明）、2 项过度修改（保留现有设计，不采纳）

### v1.1.4 格式修复（对齐公文规范）
- **加粗句（`**text**`）修复**：由"黑体不加粗"改为"楷体_GB2312 加粗"——符合公文段首"一是/二是"句式标准格式
- **三级标题（`###`）修复**：由"楷体不加粗"改为"楷体_GB2312 加粗"——符合 GB/T 9704 二级标题（（一））楷体加粗规范
- 黑体标题（`#`/`##`）、正文仿宋、斜体楷体等保持不变

### v1.1.8 格式增强（间隔号序号规范化为公文标准序号）
- **「一 · 源头」→「一、源头」**：识别到间隔号体例时自动改写为公文标准序号，
  `##` →「一、」（阿拉伯数字自动转中文数字），`###` →「（五）」
- 结构性标题（「结语 ·」「附一 ·」）保持原样不套序号

### v1.1.7 格式修复（序号去重扩展·间隔号体例）
- **间隔号序号去重**：新增「一 · 源头」「1 · 标题」间隔号体例识别，
  以及「结语 ·」「附一 ·」结构性标题识别，避免自动编号与原文序号重复
- 涌现写作交付成稿常用间隔号体例，此前会产生「二、一·源头」这类重复序号

### v1.1.6 格式修复（段落按源码行拆分）
- **连续非空行不再合并**：连续的非空行（软换行 `softbreak`）还原为独立段落，
  解决"甲方：/住所：/法定代表人："这类一行一要素文本被挤在同一段的问题
- 拆分后的每段独立应用两端对齐 + 固定行距 + 首行缩进 2 字（640 twips）
- 本版一并纳入此前仅写入代码 docstring 的 v1.1.5 标题层级重定义（`#` 大标题 / `##` 一级标题 / `###` 楷体加粗 / `####` 仿宋加粗 + 序号去重）

---

## 权限声明

本技能执

README.md

# 📄 Official Doc - Document Format Converter

🇨🇳 [中文文档](README_CN.md) | 🇺🇸 English

Convert Markdown documents to Chinese government official document format (GB/T 9704-2012) Word documents. Focused on formatting conversion only — does not add red header, record mark, signature block, or other decorative elements of official documents.

---

## ⚠️ Important Notes

This tool only provides formatting functionality and does not review content. Please ensure that the official documents generated using this tool comply with relevant regulations and requirements.

### Network Access Disclosure for Image Download

- When the Markdown contains remote images via `![alt](http/https URL)`, this tool will **automatically issue outbound network requests** to download and embed them into the Word document.
- Only `http://`, `https://`, and `data:image` schemes are allowed; other schemes (e.g., `file://`, `ftp://`) are silently skipped to prevent SSRF.
- **Privacy & Compliance Notice**: In restricted network environments (intranet, classified networks, air-gapped systems), disable remote image download by passing `download_images=False`:

```python
md_to_docx(md_content, output_path, download_images=False)
# When disabled, remote images are replaced with a [Image: alt] text placeholder, with no network requests made.
```

- For untrusted Markdown sources, review image URLs beforehand to avoid leaking network metadata to attacker-controlled endpoints.

---

## ✨ Features

| Feature | Description |
|---------|-------------|
| 🚀 **One-click Conversion** | Convert Markdown to Word official document format easily |
| 📋 **Standard Compliance** | Strictly follows GB/T 9704-2012 standard |
| 🤖 **Multi-Agent Support** | Works with OpenClaw, Hermes Agent, Claude Code, etc. |
| 🔄 **Dual Output** | Generate both Markdown (for machines) and Word (for humans) |
| 📊 **Automation Ready** | Supports scheduled tasks for automatic report generation |
| 📦 **Easy Integration** | Provides standard Python API for system integration |

---

## 🆕 v1.1.0 New Features

- Introduced **markdown-it-py** parser, supporting multi-line paragraphs and nested lists
- Smart `#` heading detection: a single `#` is treated as a main title (centered, no numbering); multiple `#` headings are treated as first-level headings (with numbering)
- First line indent precisely aligned with national standard (640 twips = width of 2 Size-3 Chinese characters)
- Added support for **tables, images, hyperlinks, code blocks, and nested lists**
- **Bold text** is automatically converted to KaiTi_GB2312 bold (楷体加粗); *italic text* is automatically converted to KaiTi (楷体)

---

## 🚀 Quick Start

### System Requirements

| Component | Requirement |
|-----------|-------------|
| OS | Windows 10/11, Linux, macOS |
| Python | 3.8+ (3.11 / 3.12 / 3.13 supported) |
| Dependency | python-docx ~= 1.1.0, markdown-it-py ~= 3.0.0 |

### Installation

**Method 1: Using pip**
```bash
pip install "python-docx~=1.1.0" "m

_meta.json

{
  "ownerId": "kn75zj7vzdyvap84adxa8heyyd82f5eh",
  "slug": "gongwen-formatter",
  "version": "1.1.9",
  "publishedAt": 1790069638779
}

CHANGELOG.md

# Changelog

本文件记录 official-doc（gongwen-formatter）所有版本的变更。

格式参考 [Keep a Changelog](https://keepachangelog.com/zh-CN/1.0.0/)，
版本号遵循 [Semantic Versioning](https://semver.org/lang/zh-CN/)。

## [1.1.9] - 2026-09-22

### 元数据（三平台同步 · SkillHub 标题双语化）

#### Changed
- `displayName` 改为中英双语 `Gongwen Formatter 公文格式转换`，便于中文用户在 SkillHub 检索（无功能变更）
- 三平台同步发布（GitHub + ClawHub + SkillHub）

## [1.1.8] - 2026-09-20

### 格式增强（间隔号序号规范化为公文标准序号）

#### Changed
- **间隔号序号规范化**：识别到「一 · 源头」「2 · 源头」间隔号体例时，
  不再原样保留，而是改写为公文标准序号：
  - `##`（一级标题）：「一 · 源头」→「一、源头」，阿拉伯数字自动转中文数字（「2 · 」→「二、」）
  - `###`（二级标题）：「五 · 天长专章」→「（五）天长专章」
  - 新增 `normalize_heading_number()`，在 `heading_open` 渲染前原地改写 children 首 token
- 结构性标题（「结语 ·」「附一 ·」等）保持原样，不套序号

## [1.1.7] - 2026-09-20

### 格式修复（序号去重正则未覆盖间隔号体例，导致自动编号与原文序号重复）

#### Fixed
- **间隔号序号未被识别**：涌现写作交付成稿常用「一 · 源头」「五 · 天长专章」等间隔号体例，
  此前 `has_heading_number()` 仅识别「一、」「（一）」「1.」「第X章」四种格式，
  间隔号写法匹配不上 → 引擎判定"原文没带序号" → 自动补号，产生「二、一·源头」「（一）五·天长专章」等重复
  - 修复：新增 `[一二三四五六七八九十]{1,3}\s*[·・•.]\s*` 和 `\d{1,2}\s*[·・•]\s*` 两条正则
  - 同时增加结构性标题识别：`结语 ·`、`引言 ·`、`附一 ·`、`附录` 等，
    这些标题本身即序号终结标记，不应再追加公文序号

## [1.1.6] - 2026-09-14

### 格式修复（响应跨任务调用反馈：合同/协议"一行一要素"被合并为单段）

#### Fixed
- **连续非空行被合并为单段**：Markdown 中连续的非空行（行间为软换行 `softbreak`）此前被解析为同一个段落，
  "甲方：/住所：/法定代表人："这类一行一要素的协议抬头会被挤在同一段内显示
  - 根因：`render_inline_with_formatting` 对 `softbreak` 直接 `pass`，行边界信息在渲染阶段被丢弃
  - 修复：新增 `split_inline_on_linebreaks()`，在 `paragraph_open` 处按 `softbreak`/`hardbreak`
    将 inline children 拆分为多个独立段，每段独立应用两端对齐 + 固定行距 + 首行缩进 640 twips（2 字）
  - 效果：每个源码行还原为独立段落，各自首行缩进 2 字，消除段内断行造成的左边缘参差

#### Notes
- 本版一并纳入此前仅写入代码 docstring、未落到 CHANGELOG / 版本号文件的 v1.1.5 标题层级重定义：
  `#` 大标题（方正小标宋简体二号，居中，一律不加序号）/ `##` 一级标题（黑体三号）/
  `###` 楷体_GB2312 加粗 / `####` 仿宋_GB2312 加粗；标题原文已带序号时不再自动补序号

## [1.1.4] - 2026-07-15

### 格式修复（对齐公文规范，响应跨任务调用反馈）

#### Fixed
- **加粗句（`**text**`）修复**：由"黑体不加粗"改为"楷体_GB2312 加粗"
  - 原问题：`**一是强化谋划动员**` 这类段首加粗句被渲染为黑体三号且无加粗效果，强调完全丢失
  - 根因：`render_inline_with_formatting` 的 strong 分支使用 `set_font(run, '黑体', font_size)`，black 默认 False
  - 修复：strong 分支改为 `set_font(run, '楷体_GB2312', font_size, bold=True)`，符合公文段首"一是/二是"句式标准格式
- **三级标题（`###`）修复**：由"楷体不加粗"改为"楷体_GB2312 加粗"
  - 根因：h3 分支的标题文字和前缀均未传 `bold=True`
  - 修复：h3 分支统一传 `bold=True`，符合 GB/T 9704 二级标题（（一））楷体加粗规范
- `render_inline_with_formatting` 增加 `bold` 参数，支持标题整体加粗

#### 保持不变的格式
- 黑体标题（`#`/`##`）不加粗（用户明确要求，黑体本身已足够醒目）
- 正文仿宋三号不加粗
- 斜体楷体不加粗
- 链接蓝色下划线

## [1.1.3] - 2026-07-14

### 修复（响应 v1.1.2 后 SkillSpector 二次审计 7 findings）

#### Fixed
- 修复 v1.1.2 漏改：README.md / README_CN.md / skill.md / skill.json 中残留的 `>=` 全部改为 `~=`（依赖版本一致性）
  - 根因：v1.1.2 只改了 requirements.txt 和 setup.py，漏改了 README 安装示例、skill.md 依赖表、skill.json dependencies 字段
  - SkillSpector 扫描所有文件，因此仍报告 `>=` 为 Unpinned Dependencies

#### Added
- frontmatter 增加 `allowed-tools` 字段，声明 filesystem（写 .docx）和 net.http（图片下载，可关闭）两项权限
  - 目的：让 ClawHub SkillSpector 能从 frontmatter 识别权限声明，减少 MCP Least Privilege finding

#### SkillSpector v1.1.2 二次审计 7 findings 评估
| Finding | 评估 | 处理 |
|---------|------|------|
| MCP

README_CN.md

# 📄 Official Doc - 公文格式转换

🇨🇳 中文文档 | 🇺🇸 [English](README.md)

将 Markdown 文档转换为符合 **GB/T 9704-2012** 党政机关公文格式的 Word 文档。专注排版格式转换，不添加红头、版记、落款等公文装饰要素。

---

## ⚠️ 重要说明

本工具仅提供格式排版功能，不负责内容审核。请确保使用本工具生成的公文内容符合相关规定和要求。

### 关于图片下载的网络请求说明

- 当 Markdown 中包含 `![alt](http/https URL)` 远程图片时，本工具会**自动发起网络请求**下载并嵌入到 Word 文档中。
- 仅允许 `http://`、`https://` 和 `data:image` 协议；其他 scheme（如 `file://`、`ftp://`）会被静默跳过，防止 SSRF。
- **隐私与合规提示**：在受限网络环境（内网、保密网络、隔离环境）中使用时，建议通过 `download_images=False` 参数关闭远程图片下载：

```python
md_to_docx(md_content, output_path, download_images=False)
# 关闭后，远程图片将以 [图片: alt] 文字占位替代，不发起任何网络请求
```

- 对不可信来源的 Markdown 文档，请先审阅图片 URL，避免向攻击者控制的端点泄露网络元数据。

---

## ✨ 功能特点

| 功能 | 描述 |
|------|------|
| 🚀 **一键转换** | Markdown 转 Word 公文格式，简单易用 |
| 📋 **标准遵循** | 严格按照 GB/T 9704-2012 党政机关公文格式标准 |
| 🤖 **多智能体兼容** | 支持 OpenClaw、Hermes Agent、Claude Code 等 AI 智能体 |
| 🔄 **双重输出** | 一份内容，同时生成 Markdown（供机器读）和 Word（供人读） |
| 📊 **自动化支持** | 支持定时任务自动生成简报、周报、月报 |
| 📦 **易于集成** | 提供标准 Python API，便于其他系统集成 |

---

## 🆕 v1.1.0 新特性

- 引入 **markdown-it-py** 解析器，支持多行段落、嵌套列表
- `#` 标题智能判断：单个视为大标题（居中不加序号），多个视为一级标题（加序号）
- 首行缩进精确对齐国标（640 twips = 2个三号汉字宽度）
- 新增表格、图片、超链接、代码块、嵌套列表支持
- **加粗文本**自动转为楷体加粗，*斜体文本*自动转为楷体

---

## 🚀 快速开始

### 环境要求

| 组件 | 要求 |
|------|------|
| 操作系统 | Windows 10/11、Linux、macOS |
| Python | 3.8+（支持 3.11 / 3.12 / 3.13） |
| 依赖 | python-docx ~= 1.1.0, markdown-it-py ~= 3.0.0 |

### 安装方法

**方式一：使用 pip 安装**
```bash
pip install "python-docx~=1.1.0" "markdown-it-py~=3.0.0"
```

**方式二：克隆仓库**
```bash
git clone https://github.com/EdwardWason/official-doc.git
cd official-doc
pip install -r requirements.txt
```

### 使用示例

```python
from official_doc import md_to_docx

# Markdown 内容
md_content = """# 工作简报

## 一、上周工作总结

本周完成了系统升级任务，主要包括：

### （一）主要工作
1. 完成服务器部署
2. 完成数据迁移
3. 完成测试验证

### （二）存在问题
部分功能需要进一步优化。

### （三）下周计划
继续推进优化工作。
"""

# 转换为公文格式
success = md_to_docx(md_content, "工作简报_公文格式.docx")
print("转换成功" if success else "转换失败")
```

---

## 📋 公文格式规范（GB/T 9704-2012）

### 页面设置

| 设置项 | 规范值 |
|--------|--------|
| 纸张尺寸 | A4 (210mm × 297mm) |
| 上边距 | 3.7cm |
| 下边距 | 3.5cm |
| 左边距 | 2.8cm |
| 右边距 | 2.6cm |
| 行间距 | 固定值 26 磅 |
| 首行缩进 | 2字符（640 twips） |

### 字体规范

| 元素 | Markdown 标记 | 字体 | 字号 |
|------|--------------|------|------|
| 大标题 | `#`（单个） | 方正小标宋简体 | 二号 |
| 一级标题 | `##` / `#`（多个） | 黑体 | 三号 |
| 二级标题 | `###` | 楷体_GB2312 加粗 | 三号 |
| 三级标题 | `####` | 仿宋_GB2312 | 三号 |
| 正文 | 普通文本 | 仿宋_GB2312 | 三号 |
| 页码 | - | 宋体 | 四号 |

### 标题编号规则

| 层级 | 判断条件 | 格式示例 |
|------|----------|----------|
| 大标题 | 文档中仅一个 `#` | 公文标题（居中，不加序号） |
| 一级标题 | `##` 或多个 `#` | 一、章节名称 |
| 二级标题 | `###` | （一）小节名称 |
| 三级标题 | `####` | 1. 项目名称 |

### 支持的 Markdown 元素

| 元素 | Markdown 语法 | 说明 |
|------|--------------|------|
| 标题 | `#` `##` `###` `####` | 智能标题判断 |
| 段落 | 普通文本 | 支持多行段落 |
| 有序列表 | `1. 2. 3.` | 支持嵌套列表 |
| 无序列表 | `- - -` | 支持嵌套列表 |
| 表格 | `\| 列 \| 列 \|` | 完整表格支持 |
| 图片 | `![alt](url)` | 行内图片 |
| 超链接 | `[文本](url)` | 超链接 |
| 加粗 | `**文本**` | 自动转为楷体加粗 |
| 斜体 | `*文本*` | 自动转为楷体 |
| 代码块 | `` ```代码``` `` | 等宽字体

Github ReposUpdated 3h agoRank 70

AionUi

Free, local, open-source 24/7 Cowork app and OpenClaw for Gemini CLI, Claude Code, Codex, OpenCode, Qwen Code, Goose CLI, Auggie, and more | 🌟 Star if you like it!

MCPOPENCLAW

Github ReposUpdated 6mo agoRank 70

activepieces

AI Agents & MCPs & AI Workflow Automation • (~400 MCP servers for AI agents) • AI Automation / AI Agent with MCPs • AI Workflows & AI Agents • MCPs for AI Agents

OPENCLAW

Github ReposUpdated 6mo agoRank 70

cherry-studio

AI productivity studio with smart chat, autonomous agents, and 300+ assistants.