AI 助手 (Claude Code / Cursor / WorkBuddy / 等)
    │
    │  MCP 协议 (stdio)
    ▼
┌──────────────────────────────────┐
│  wps-mcp-server (node 子进程)     │
│  安装时 git clone + npm build     │
│  ┌────────────────────────────┐  │
│  │  wps-mcp-addon (WPS 加载项) │  │
│  └────────────────────────────┘  │
└──────────────┬───────────────────┘
               │ PowerShell COM 自动化
               ▼
┌──────────────────────────────────┐
│  WPS Office 进程                  │
│  (Writer / ET / WPP)             │
└──────────────────────────────────┘

wps-office-mcp/
├── README.md                   ← 本文件：安装使用说明
├── package.json                ← npm 脚本入口
├── install-wps-mcp.ps1         ← 一键安装/卸载脚本
├── start-wps-mcp-server.ps1    ← MCP Server 启动脚本（前台/后台/停止）
└── wps-addin/                  ← WPS 加载项文件（wps-mcp-addon）
    ├── manifest.xml            ← 加载项注册清单（wps/et/wpp 三端注册）
    ├── ribbon.xml              ← WPS 功能区按钮布局
    ├── index.html              ← 加载项入口页面
    └── js/
        └── main.js             ← 核心脚本（COM 桥接模式）

cd <本包目录>

# 安装全部组件（WPS 加载项 + 从 GitHub 下载并编译 MCP Server）
.\install-wps-mcp.ps1 -Action Install -InstallServer

npm run install:all

.\start-wps-mcp-server.ps1               # 前台运行（测试用，Ctrl+C 停止）
.\start-wps-mcp-server.ps1 -Mode background  # 后台运行
.\start-wps-mcp-server.ps1 -Stop            # 停止后台进程

.\start-wps-mcp-server.ps1 -HTTP                        # 前台，端口 18000
.\start-wps-mcp-server.ps1 -HTTP -Mode background        # 后台
.\start-wps-mcp-server.ps1 -HTTP -Mode background -Port 8080  # 自定义端口

{
  "mcpServers": {
    "wps-office": {
      "command": "node",
      "args": ["<本包绝对路径>/wps-mcp-server/wps-office-mcp/dist/index.js"]
    }
  }
}

{
  "mcpServers": {
    "wps-office": {
      "url": "http://localhost:18000/sse",
      "transport": "http"
    }
  }
}

# 卸载 WPS 加载项
.\install-wps-mcp.ps1 -Action Delete

# 卸载加载项 + 删除 MCP Server 目录
.\install-wps-mcp.ps1 -Action Delete -InstallServer

# 静默卸载
.\install-wps-mcp.ps1 -Action Delete -Force

"在 WPS 中新建一个空白文档"
"在当前文档中插入文字：xxxx"
"保存文档到桌面，文件名：xxx.docx"
"把文档中所有的 'abc' 替换为 'xyz'"
"读取当前文档内容"
"插入一个 3x5 的表格"

# 安装全部
.\install-wps-mcp.ps1 -Action Install -InstallServer

# 仅安装加载项
.\install-wps-mcp.ps1 -Action Install

# 自定义加载项名称
.\install-wps-mcp.ps1 -Action Install -AddonName "my-addon"

# 指定源文件夹
.\install-wps-mcp.ps1 -Action Install -SourcePath "D:\my-addon"

# 卸载
.\install-wps-mcp.ps1 -Action Delete [-Force]

# 启动 MCP Server（前台）
.\start-wps-mcp-server.ps1

# 启动 MCP Server（后台）
.\start-wps-mcp-server.ps1 -Mode background

# 停止后台 MCP Server
.\start-wps-mcp-server.ps1 -Stop

# 启动 HTTP SSE 服务（前台）
.\start-wps-mcp-server.ps1 -HTTP

# 启动 HTTP SSE 服务（后台，自定义端口）
.\start-wps-mcp-server.ps1 -HTTP -Mode background -Port 8080

# npm 快捷方式
npm run install:all        # 安装全部
npm run install:addon      # 仅安装加载项
npm run install:server     # 仅编译 MCP Server（stdio）
npm run start:http         # 启动 HTTP SSE 桥接服务