@cliven/mddocx 1.0.1 → 1.0.3

package/.claude-plugin/plugin.json

@@ -1,8 +1,8 @@
 {
   "name": "mddocx",
-  "version": "1.0.1",
+  "version": "1.0.3",
   "description": "Markdown 转学术格式 Word 文档 (DOCX)。支持三线表、图题/表题自动编号、页码、页眉等学术论文排版规范。",
-  "author": "Quan Guanyu",
+  "author": { "name": "Quan Guanyu" },
   "keywords": ["markdown", "docx", "word", "academic", "论文", "学术", "转换"],
   "skills": "./skills/"
 }

package/.codex-plugin/plugin.json

@@ -1,6 +1,6 @@
 {
   "name": "mddocx",
-  "version": "1.0.0",
+  "version": "1.0.3",
   "description": "Markdown 转学术格式 Word 文档 (DOCX)。支持三线表、图题/表题自动编号、页码、页眉等学术论文排版规范。",
   "author": "Quan Guanyu",
   "homepage": "https://github.com/Trisia/mddocx",

package/.cursor-plugin/plugin.json

@@ -1,6 +1,6 @@
 {
   "name": "mddocx",
-  "version": "1.0.1",
+  "version": "1.0.3",
   "description": "Markdown 转学术格式 Word 文档 (DOCX)。支持三线表、图题/表题自动编号、页码、页眉等学术论文排版规范。",
   "author": "Quan Guanyu",
   "homepage": "https://github.com/Trisia/mddocx",

package/README.md

@@ -1,9 +1,10 @@
 # mddocx — Markdown 转学术格式 DOCX
 
-[![Claude Code](https://img.shields.io/badge/Agent-Claude%20Code-orange?logo=claude)](https://claude.com/code)
+[![Claude Code](https://img.shields.io/badge/Agent-Claude%20Code-orange?logo=claude)](https://www.claudepluginhub.com/plugins/trisia-mddocx)
 [![Codex](https://img.shields.io/badge/Agent-Codex-blue?logo=openai)](https://github.com/openai/codex)
 [![Cursor](https://img.shields.io/badge/Agent-Cursor-6c47ff?logo=cursor)](https://cursor.com)
 [![OpenCode](https://img.shields.io/badge/Agent-OpenCode-teal)](https://opencode.ai)
+[![npm](https://img.shields.io/npm/v/@cliven/mddocx?color=red)](https://www.npmjs.com/package/@cliven/mddocx)
 [![Version](https://img.shields.io/github/v/release/Trisia/mddocx)](https://github.com/Trisia/mddocx/releases)
 [![License](https://img.shields.io/badge/license-MIT-green)](LICENSE)
 [![Python](https://img.shields.io/badge/python-3.9%2B-blue?logo=python)](https://python.org)
@@ -18,24 +19,14 @@
 
 ### 🤖 一键安装
 
-复制粘贴给任意智能体即可安装：
+将以下内容复制粘贴给任意智能体（Claude Code / Codex / OpenCode / Cursor）即可安装。
 
-```copy
-请帮我安装 mddocx 插件：
-
-git clone https://github.com/Trisia/mddocx /tmp/mddocx
-mkdir -p ~/.claude/skills/mddoc
-cp -r /tmp/mddocx/skills/mddoc/* ~/.claude/skills/mddoc/
-rm -rf /tmp/mddocx
+> 各平台专属安装说明详见 **[INSTALL.md](INSTALL.md)**。
 
-python3 -m venv ~/.claude/venvs/mddocx
-~/.claude/venvs/mddocx/bin/pip install python-docx Pillow requests mistune
+```copy
+请根据 https://github.com/Trisia/mddocx/blob/main/INSTALL.md 中对应平台的说明，帮我安装 mddocx
 ```
 
-### 📖 完整安装指南
-
-支持 **Claude Code** / **Codex** / **OpenCode** / **Cursor** / **通用** 等多种方式，详见 **[INSTALL.md](INSTALL.md)**。
-
 ### 依赖
 
 ```bash

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@cliven/mddocx",
-  "version": "1.0.1",
+  "version": "1.0.3",
   "description": "Markdown 转学术格式 DOCX",
   "type": "module",
   "main": ".opencode/plugins/mddocx.js",

package/skills/mddoc/SKILL.md

@@ -28,7 +28,7 @@ python <skill-path>/scripts/md2docx.py --text "# 标题\n\n正文内容" -o out.
 1. **读取输入** — 若用户粘贴 Markdown 文本则直接读取；若用户提供文件路径（含 `@` 引用）则读取该文件
 2. **安装依赖**（如未安装）— `pip install python-docx Pillow requests mistune`
 3. **执行转换** — 优先使用内置脚本 `scripts/md2docx.py`；若 Markdown 结构特殊则参照下方格式规范编写自定义脚本
-4. **确定输出** — 文件路径输入→同目录；粘贴内容→当前目录；文件名=「题目.docx」，题目从第一个 `# 标题` 提取
+4. **确定输出** — 文件路径输入→同目录；粘贴内容→当前目录；文件名=「题目.docx」（题目从第一个 `# 标题` 提取；若无 `#` 标题则使用输入文件名，`--text` 模式为「未命名文档.docx」）
 5. **验证** — 检查 outline level、图片嵌入、页眉、分页符
 
 ---
@@ -118,6 +118,14 @@ set_cn_font(run, '黑体', size_pt=16)
 add_empty(doc)
 ```
 
+### 无标题文档
+
+当输入 Markdown 没有 `#` 标题时：
+- 跳过标题页，文档从第一个内容节点开始排版
+- 页眉右侧显示「未命名文档」代替标题
+- 页眉左侧「xxxxx」保持不变
+- 输出文件名：文件输入使用输入文件名（如 `paper.md` → `paper.docx`），`--text` 模式使用「未命名文档.docx」
+
 ### 一级标题（后续 `#`）
 
 三号黑体(16pt)、居中、上下各空一行、outline_level=1、**前加分页符**。
@@ -205,7 +213,7 @@ p.add_run().add_picture(img_path, width=img_width(img_path))
 
 ### 图题
 
-图片下方(不空行)、小五(9pt)宋体加粗居中、格式 `图<章>-<序号> <alt>`、逐章编号。
+图片下方(不空行)、小五(9pt)宋体加粗居中、逐章编号。有章标题时格式 `图<章>-<序号> <alt>`，无章标题时格式 `图<序号> <alt>`。若 alt 为空，自动使用图片文件名（不含扩展名）作为图题。
 
 ```python
 p = doc.add_paragraph()
@@ -217,7 +225,7 @@ add_empty(doc)  # 图题下方空一行
 
 ### 表格 + 表题
 
-**三线表**(顶线1.5pt/表头底线0.75pt/底线1.5pt粗，无竖线)。表题在上方(不空行)、五号(10.5pt)宋体加粗居中、格式`表<章>-<序号> <描述>`。
+**三线表**(顶线1.5pt/表头底线0.75pt/底线1.5pt粗，无竖线)。表题在上方(不空行)、五号(10.5pt)宋体加粗居中。有章标题时格式`表<章>-<序号> <描述>`，无章标题时格式`表<序号> <描述>`。
 
 ```python
 # 表题
@@ -462,6 +470,7 @@ set_cn_font(run_cont, '宋体', size_pt=10.5)
 ## 生成后自检清单
 
 - [ ] 题目：16pt黑体、居中、无outline、上下各空一行
+- [ ] 无标题文档：跳过标题页、页眉显示「未命名文档」
 - [ ] 一级标题：16pt黑体、outline_level=1、前有分页符、上下各空一行
 - [ ] 二级标题：14pt黑体、顶格、outline_level=2、不加粗、**上下不空行**
 - [ ] 三级标题：12pt宋体、首行缩进Pt(21)、outline_level=3、不加粗、**上下不空行**
@@ -482,7 +491,7 @@ set_cn_font(run_cont, '宋体', size_pt=10.5)
 
 ## 注意事项
 
-- **第一个 `#` 是题目**（不设 outline），后续 `#` 是一级标题（outline_level=1）
+- **第一个 `#` 是题目**（不设 outline），后续 `#` 是一级标题（outline_level=1）；若无 `#` 标题仍可正常生成文档
 - **图片尺寸用 `Cm()`，不手算 EMU** — `add_picture(width=Cm(x))` 自动转换
 - **图片下载必设 User-Agent** — 否则 CDN/Wikipedia 返回 400
 - **图题编号自动生成** — alt text 作为描述文字，图/表编号独立逐章编序

package/skills/mddoc/scripts/md2docx.py

@@ -838,7 +838,7 @@ def extract_title_text(title_node):
     return text.strip()
 
 
-def generate_docx(nodes, output_path, title_text):
+def generate_docx(nodes, output_path, title_text=None):
     """根据节点列表生成 docx 文件"""
     doc = Document()
 
@@ -869,7 +869,7 @@ def generate_docx(nodes, output_path, title_text):
     hp_right = header.add_paragraph()
     hp_right.alignment = WD_ALIGN_PARAGRAPH.RIGHT
     hp_right.paragraph_format.space_before = Pt(0)
-    run_r = hp_right.add_run(title_text)
+    run_r = hp_right.add_run(title_text or '未命名文档')
     set_run_font(run_r, '黑体', size_pt=9)
 
     # --- 页脚/页码设置 ---
@@ -906,6 +906,7 @@ def generate_docx(nodes, output_path, title_text):
 
     # --- 计数器 ---
     chapter_path = [1]  # 一级标题序号
+    has_chapter = False  # 是否遇到章标题（# 一级标题）
     fig_counter = {}  # key: chapter index tuple, value: counter
     tab_counter = {}
     eq_counter = {}
@@ -929,10 +930,14 @@ def generate_docx(nodes, output_path, title_text):
         return eq_counter[key]
 
     def make_fig_label():
-        return f"图{chapter_path[0]}-{incr_fig()}"
+        if has_chapter:
+            return f"图{chapter_path[0]}-{incr_fig()}"
+        return f"图{incr_fig()}"
 
     def make_tab_label():
-        return f"表{chapter_path[0]}-{incr_tab()}"
+        if has_chapter:
+            return f"表{chapter_path[0]}-{incr_tab()}"
+        return f"表{incr_tab()}"
 
     # --- 遍历节点生成内容 ---
     for node in nodes:
@@ -950,6 +955,7 @@ def generate_docx(nodes, output_path, title_text):
             lv = node['level']
             if lv == 1:
                 # 一级标题：新页 + 三号黑体居中
+                has_chapter = True
                 chapter_path[0] += 1
                 chapter_path[1:] = [0]  # reset sub-levels
 
@@ -1017,6 +1023,9 @@ def generate_docx(nodes, output_path, title_text):
             run_img.add_picture(img_path, width=w)
 
             # 图题：小五宋体加粗居中
+            # alt 为空时，使用图片文件名（不含扩展名）作为默认图题
+            if not alt:
+                alt = os.path.splitext(os.path.basename(url))[0]
             p_cap = doc.add_paragraph()
             p_cap.alignment = WD_ALIGN_PARAGRAPH.CENTER
             run_cap = p_cap.add_run(f'{make_fig_label()} {alt}')
@@ -1177,19 +1186,21 @@ def main():
     # 解析
     nodes = parse_markdown(md_content)
 
-    # 提取题目
+    # 提取题目（可选）
     title_node = next((n for n in nodes if n['type'] == 'title'), None)
-    if title_node is None:
-        print("错误：未找到文档标题（第一个 # 标题）", file=sys.stderr)
-        sys.exit(1)
-    title_text = extract_title_text(title_node)
+    title_text = extract_title_text(title_node) if title_node else None
 
     # 确定输出路径
     if args.output:
         output_path = args.output
-    else:
+    elif title_text:
         safe_name = re.sub(r'[\\/*?:"<>|]', '', title_text)
         output_path = os.path.join(source_dir, f'{safe_name}.docx')
+    elif args.text:
+        output_path = os.path.join(source_dir, '未命名文档.docx')
+    else:
+        stem = os.path.splitext(os.path.basename(args.input))[0]
+        output_path = os.path.join(source_dir, f'{stem}.docx')
 
     # 生成
     generate_docx(nodes, output_path, title_text)