# wps-document-agent（wps-skills 统一仓库）

> **WPS Office 智能助手 + 文档智能写作代理** 统一仓库。
> 融合了 [wps-skills](https://github.com/lc2panda/wps-skills)（在线操控 WPS）与 [document-agent](https://github.com/l0s3r-Q/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](document-agent/docs/wps-office-integration.md)。

## 部署（Reasonix / Claude Code）

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

```json
{
  "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](WINDOWS-JS-BRIDGE.md)

## 测试

```bash
# 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）