Wps Skills

WPS Office 智能助手 + 文档智能写作代理 统一仓库。 融合了 wps-skills（在线操控 WPS）与 document-agent（离线文档生成）两大能力，形成"生成 → 打开 → 编辑 → 导出"完整文档工作流。

仓库结构

wps-skills/                      # 统一仓库根
├── wps-office-mcp/             # MCP Server A：在线操控 WPS（Excel82/Word32/PPT115/通用）
├── wps-claude-assistant/       # WPS 加载项（JS 宏桥，轮询模式）
├── wps-claude-addon/           # 旧 COM 加载项（macOS/COM 环境用）
├── document-agent/             # MCP Server B：离线文档生成（31 工具，18 类模板）
│   ├── mcp/document-toolkit/   #   document-toolkit MCP server
│   ├── docs/                   #   wps-office 集成文档等
│   └── tests/                  #   84 项 pytest
├── skills/                     # 统一 Skills（5 个）
│   ├── document-intelligence/  #   文档智能写作（离线生成入口）
│   ├── wps-excel/              #   WPS 表格
│   ├── wps-word/               #   WPS 文字
│   ├── wps-ppt/                #   WPS 演示
│   └── wps-office/             #   WPS 跨应用
├── scripts/                    # 安装/工具文档生成脚本
├── .github/workflows/ci.yml    # CI（tsc + jest）
└── WINDOWS-JS-BRIDGE.md        # Windows JS 宏桥部署说明

两大能力

能力	模块	工具	场景
离线文档生成	document-agent（Python）	31 个（build_docx/excel/pptx、AI 生成、PDF 提取、批量、质量检查）	从零生成规范文档、AI 写作、批量产出
在线操控 WPS	wps-office-mcp（Node）	250 个（Excel/Word/PPT 读写、格式、图表）	打开/编辑/美化 WPS 中已打开的文档

融合工作流

用户："写一份安全生产检查通知，生成 docx 并转 PDF 打开给我"
1. document-intelligence skill 识别需求
2. document-toolkit.build_docx  → AI 生成内容 → 构建 docx（防 AI 味自检）
3. document-toolkit.quality_check → 质量检查（AIGC 痕迹/占位符）
4. document-toolkit.convert_to_pdf → 转 PDF
5. wps-office.wps_word_open_document → 在 WPS 中打开供预览/编辑

详见 document-agent/docs/wps-office-integration.md。

部署（Reasonix / Claude Code）

两个 MCP 独立注册、独立运行：

{
  "mcpServers": {
    "document-toolkit": {
      "command": "python",
      "args": ["<路径>/document-agent/mcp/document-toolkit/server.py"]
    },
    "wps-office": {
      "command": "node",
      "args": ["<路径>/wps-office-mcp/dist/index.js"],
      "env": { "WPS_USE_POLL": "1" }
    }
  }
}

• document-toolkit：Python 3.10+，pip install -r document-agent/mcp/document-toolkit/requirements.txt
• wps-office：Node 18+，cd wps-office-mcp && npm install && npm run build
• Skills：skills/ 下 5 个 skill 放入工具的 skills 目录
• WPS 加载项（Windows JS 宏桥）：见 WINDOWS-JS-BRIDGE.md

测试

# document-agent（84 项）
cd document-agent && python -m pytest tests/ -q

# wps-office-mcp（jest 单元测试）
cd wps-office-mcp && npx jest src/tests --setupFilesAfterEnv=

许可证

MIT（两项目均为 MIT）