@cliven/mddocx 1.0.1

package/.claude-plugin/plugin.json

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

package/.codex-plugin/plugin.json

@@ -0,0 +1,16 @@
+{
+  "name": "mddocx",
+  "version": "1.0.0",
+  "description": "Markdown 转学术格式 Word 文档 (DOCX)。支持三线表、图题/表题自动编号、页码、页眉等学术论文排版规范。",
+  "author": "Quan Guanyu",
+  "homepage": "https://github.com/Trisia/mddocx",
+  "keywords": ["markdown", "docx", "word", "academic", "paper"],
+  "skills": "./skills/",
+  "hooks": {},
+  "interface": {
+    "displayName": "mddocx",
+    "shortDescription": "Markdown → 学术格式 DOCX",
+    "brandColor": "#0984e3",
+    "logo": ""
+  }
+}

package/.cursor-plugin/plugin.json

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

package/.opencode/INSTALL.md

@@ -0,0 +1,31 @@
+# mddocx — OpenCode 安装
+
+## 安装
+
+1. 在 OpenCode 配置 (`opencode.json`) 中添加插件：
+
+```json
+{
+  "plugins": [
+    "git:https://github.com/Trisia/mddocx"
+  ]
+}
+```
+
+2. 重启 OpenCode，插件自动加载。
+
+3. 确保已安装 Python 依赖：
+
+```bash
+pip install python-docx Pillow requests mistune
+```
+
+## 使用
+
+在 OpenCode 对话中输入：
+
+```
+/mddoc paper.md
+```
+
+或直接粘贴 Markdown 内容要求转换为 Word 文档。

package/.opencode/plugins/mddocx.js

@@ -0,0 +1,41 @@
+// mddocx — Markdown 转学术格式 DOCX
+// OpenCode 插件：注册 mddoc 技能并在会话启动时注入引导
+
+import { readFileSync } from 'node:fs';
+import { join, dirname } from 'node:path';
+import { fileURLToPath } from 'node:url';
+
+const __dirname = dirname(fileURLToPath(import.meta.url));
+const PLUGIN_ROOT = join(__dirname, '..', '..');
+const SKILL_MD_PATH = join(PLUGIN_ROOT, 'skills', 'mddoc', 'SKILL.md');
+
+/** @param {import('opencode').Plugin} plugin */
+export default async function mddocx(plugin) {
+  // 注册技能目录
+  plugin.config({
+    skills: [join(PLUGIN_ROOT, 'skills')],
+  });
+
+  // 会话启动时注入 mddoc 技能引导
+  plugin.hook('experimental.chat.messages.transform', async (messages) => {
+    try {
+      const skillContent = readFileSync(SKILL_MD_PATH, 'utf-8');
+      const bootstrap = `<EXTREMELY_IMPORTANT>
+本会话已安装 mddocx 插件。以下是 mddoc 技能：
+
+${skillContent}
+</EXTREMELY_IMPORTANT>`;
+
+      // 注入到第一条用户消息之前
+      const systemMsg = messages.find(m => m.role === 'system');
+      if (systemMsg) {
+        systemMsg.content = bootstrap + '\n\n' + (systemMsg.content || '');
+      } else {
+        messages.unshift({ role: 'system', content: bootstrap });
+      }
+    } catch (e) {
+      console.warn('[mddocx] 无法注入技能引导:', e.message);
+    }
+    return messages;
+  });
+}

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Quan Guanyu
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,95 @@
+# mddocx — Markdown 转学术格式 DOCX
+
+[![Claude Code](https://img.shields.io/badge/Agent-Claude%20Code-orange?logo=claude)](https://claude.com/code)
+[![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)
+[![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)
+[![CI](https://github.com/Trisia/mddocx/actions/workflows/release.yml/badge.svg)](https://github.com/Trisia/mddocx/actions/workflows/release.yml)
+[![Clawhub](https://img.shields.io/badge/Clawhub-mddocx-8b5cf6)](https://clawhub.ai/Trisia/mddoc)
+
+将 Markdown 转换为符合学术规范的 Word 文档的Agent Skill，支持 LaTeX 公式（OMML）、三线表、图题/表题自动编号、页码、页眉等学术论文排版规范。
+
+![MD与DOCX生成效果](./examples/demo.png)
+
+## 安装
+
+### 🤖 一键安装
+
+复制粘贴给任意智能体即可安装：
+
+```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
+
+python3 -m venv ~/.claude/venvs/mddocx
+~/.claude/venvs/mddocx/bin/pip install python-docx Pillow requests mistune
+```
+
+### 📖 完整安装指南
+
+支持 **Claude Code** / **Codex** / **OpenCode** / **Cursor** / **通用** 等多种方式，详见 **[INSTALL.md](INSTALL.md)**。
+
+### 依赖
+
+```bash
+pip install python-docx Pillow requests mistune
+```
+
+## 使用
+
+### npx（无需安装）
+
+```bash
+npx @cliven/mddocx paper.md                    # 转换文件
+npx @cliven/mddocx paper.md -o output.docx     # 指定输出
+npx @cliven/mddocx --text "# 标题" -o out.docx # 转换文本
+```
+
+### Claude Code 中
+
+```
+/mddoc paper.md                    # 转换 Markdown 文件
+/mddoc @paper.md                   # @引用文件
+/mddoc 把这段内容转成Word         # 粘贴 Markdown 文本
+```
+
+### 命令行直接使用
+
+```bash
+# 转换文件（输出到同目录）
+python skills/mddoc/scripts/md2docx.py paper.md
+
+# 指定输出路径
+python skills/mddoc/scripts/md2docx.py paper.md -o output.docx
+
+# 直接转换文本
+python skills/mddoc/scripts/md2docx.py --text "# 标题\n\n正文" -o out.docx
+```
+
+## 格式规范
+
+生成的文档自动应用以下学术排版规范：
+
+| 元素 | 格式 |
+|------|------|
+| 题目 | 三号黑体(16pt)、居中、上下空一行 |
+| 一级标题 | 三号黑体、居中、前加分页符、outline_level=1 |
+| 二级标题 | 四号黑体(14pt)、顶格、不加粗、outline_level=2 |
+| 三级标题 | 小四宋体(12pt)、首行缩进、不加粗、outline_level=3 |
+| 正文 | 五号(10.5pt)、首行缩进2字符、1.3倍行距 |
+| 表格 | 三线表(顶线粗/表头底线细/底线粗)、表头重复 |
+| 图题 | 小五(9pt)宋体加粗居中、"图1-1 xxx"格式 |
+| 表题 | 五号(10.5pt)宋体加粗居中、"表1-1 xxx"格式 |
+| 页码 | "第×页 共×页"、页脚边距1cm |
+| 列表 | 有序列表用（1）（2）（3）序号 |
+| 行内公式 | $...$ 转 OMML、嵌于段落、WPS/Word 可渲染 |
+| 行间公式 | $$...$$ 转 OMML 居中、编号(章-序号)右对齐 |
+| 页边距 | 左3cm 右2cm 上2cm 下2cm |
+

package/bin/mddocx.js

@@ -0,0 +1,29 @@
+#!/usr/bin/env node
+// mddocx CLI — 调用 Python 转换脚本
+
+import { spawn } from 'node:child_process';
+import { fileURLToPath } from 'node:url';
+import { dirname, join } from 'node:path';
+import { existsSync } from 'node:fs';
+
+const __dirname = dirname(fileURLToPath(import.meta.url));
+const script = join(__dirname, '..', 'skills', 'mddoc', 'scripts', 'md2docx.py');
+
+if (!existsSync(script)) {
+  console.error('错误: 找不到转换脚本', script);
+  process.exit(1);
+}
+
+// 优先找 venv python，否则用系统 python3
+const pythonCmd = process.env.MDDOCX_PYTHON || 'python3';
+
+const args = [script, ...process.argv.slice(2)];
+
+const child = spawn(pythonCmd, args, { stdio: 'inherit' });
+
+child.on('close', (code) => {
+  if (code !== 0) {
+    console.error(`\n提示: 确认已安装依赖: pip install python-docx Pillow requests mistune`);
+  }
+  process.exit(code);
+});

package/hooks/hooks.json

@@ -0,0 +1,12 @@
+{
+  "hooks": {
+    "SessionStart": [{
+      "matcher": "startup|clear|compact",
+      "hooks": [{
+        "type": "command",
+        "command": "\"${CLAUDE_PLUGIN_ROOT}/hooks/session-start\"",
+        "async": false
+      }]
+    }]
+  }
+}

package/hooks/session-start

@@ -0,0 +1,29 @@
+#!/usr/bin/env bash
+# mddocx session-start hook — 在每个会话开始时注入 mddoc 技能
+# 参考 superpowers hooks/session-start 实现
+
+set -euo pipefail
+
+SKILL_DIR="${CLAUDE_PLUGIN_ROOT:-$(dirname "$(dirname "$0")")}"
+SKILL_MD="$SKILL_DIR/skills/mddoc/SKILL.md"
+
+if [ ! -f "$SKILL_MD" ]; then
+  echo '{"additionalContext":"[mddocx] mddoc skill not found at '"$SKILL_MD"'"}'
+  exit 0
+fi
+
+# 读取 SKILL.md 内容
+CONTENT=$(cat "$SKILL_MD")
+
+# 构建注入内容
+INJECT="<EXTREMELY_IMPORTANT>
+本会话已安装 mddocx 插件。以下是 mddoc 技能——当用户要求将 Markdown 转换为 Word 文档时自动触发。
+
+$CONTENT
+</EXTREMELY_IMPORTANT>"
+
+# 输出为 JSON（Claude Code SessionStart 格式）
+python3 -c "
+import json, sys
+print(json.dumps({'additionalContext': open('$SKILL_MD').read()}))
+"

package/package.json

@@ -0,0 +1,25 @@
+{
+  "name": "@cliven/mddocx",
+  "version": "1.0.1",
+  "description": "Markdown 转学术格式 DOCX",
+  "type": "module",
+  "main": ".opencode/plugins/mddocx.js",
+  "bin": {
+    "mddocx": "./bin/mddocx.js"
+  },
+  "files": [
+    "skills/",
+    "bin/",
+    ".opencode/",
+    ".claude-plugin/",
+    ".codex-plugin/",
+    ".cursor-plugin/",
+    "hooks/"
+  ],
+  "keywords": ["markdown", "docx", "academic", "claude-code", "codex", "opencode", "skill"],
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/Trisia/mddocx"
+  },
+  "license": "MIT"
+}