AI 客户端 ──MCP 协议──▶ 本 Server ──▶ wps_controller 核心库 ──▶ WPS COM

pip install -r requirements.txt
# 或
pip install .

{
  "mcpServers": {
    "wps-office": {
      "command": "python",
      "args": ["-m", "wps_controller.mcp_server"]
    }
  }
}

# 创建文档（--json 输出结构化结果）
python -m wps_controller.wps_cli --json document new --type writer --name 报告 -o report.json

# 添加内容
python -m wps_controller.wps_cli --json --project report.json writer add-heading -t 前言 -l 1
python -m wps_controller.wps_cli --json --project report.json writer add-paragraph -t 正文 --bold

# 导出（调用 WPS COM 生成真实文件）
python -m wps_controller.wps_cli --json --project report.json export render output.docx -p docx --overwrite

# 实时打字导出
python -m wps_controller.wps_cli --json --project report.json export render output.docx -p docx --live --speed slow

wps_cli
├── document new|open|save|info|profiles|json
├── writer  add-paragraph|add-heading|add-list|add-table|add-image|add-page-break|remove|list|set-text|find-replace
├── calc    add-sheet|remove-sheet|rename-sheet|set-cell|get-cell|set-range|merge-cells|list-sheets
├── impress add-slide|remove-slide|set-content|list-slides|add-element|move-slide|duplicate-slide
├── style   create|modify|list|apply|remove
├── export  presets|preset-info|render
└── session status|undo|redo|history

CLI / MCP Server
    │
    ▼
Session 层 —— 撤销/重做/持久化（纯 Python，不需要 WPS）
    │
    ▼
Core 模块 —— writer.py / calc.py / impress.py / styles.py（操作 JSON 项目字典）
    │
    ▼
export.py —— 只在导出时调用 WPS COM
    │
    ▼
wps_backend.py —— COM 接口封装（KWPS / KET / KWPP.Application）
    │
    ▼
WPS Office

{
  "version": "1.0",
  "name": "报告",
  "type": "writer",
  "settings": {},
  "styles": {},
  "content": [
    { "type": "heading", "level": 1, "text": "前言", "style": {} },
    { "type": "paragraph", "text": "正文", "style": { "bold": true } },
    { "type": "table", "rows": 3, "cols": 3, "data": [["A1","B1","C1"]] }
  ]
}

python e2e_test.py    # CLI 端到端（44 用例）
python test_mcp.py    # MCP 工具层（45 用例，含 live 模式）
python full_test.py   # 全量回归（35 用例，live 三档速度）