Skill v1.0.0

currentAutomated scan100/100

lewis-hui1202/wps-ai/hermes-skill

──Details

PublishedOctober 25, 2026 at 09:10 PM

Content Hashsha256:e854919ebad89583...

Git SHA8e6cee8ae84d

──Files

Files (1 file, 5.2 KB)

SKILL.md5.2 KBactive

SKILL.md · 167 lines · 5.2 KB

name: wps-ai description: "通过 WPS-AI MCP 服务操控 WPS Office 文档——读取、写入、格式化、公文排版。在 Windows Hermes 上配置后，可从 NAS 远程操控 WPS 处理文档。" version: 1.0.0 author: "天启造价 × 灵犀AI"

WPS-AI Hermes Skill

本技能将灵犀AI WPS 插件的 MCP 服务接入 Hermes Agent，实现远程操控 WPS Office 文档。

架构

Hermes Agent (NAS/本地)
  └── MCP Client (stdio)
      └── mcp-server.js (WPS-AI plugin)
          └── HTTP → proxy-server.js :3890
              └── WPS Plugin (TaskPane)
                  └── WPS JSAPI → 文档读写

安装

1. 安装灵犀AI WPS 插件

从 https://github.com/lewis-hui1202/WPS-AI/releases 下载安装包，或：

bash

git clone https://github.com/lewis-hui1202/WPS-AI.git
cd WPS-AI
npm install

2. 配置 WPS 插件

打开 WPS，启用插件
设置 → MCP 服务 → 开启
设置 → API Key → 填入 DeepSeek / Claude 等

3. 启动 proxy server

bash

cd WPS-AI/plugin
node tools/proxy-server.js

4. Hermes MCP 配置

在 Hermes 配置文件 config.yaml 中添加：

yaml

mcp:
  servers:
    wps-ai:
      command: node
      args:
        - "C:/path/to/WPS-AI/plugin/tools/mcp-server.js"
      env:
        WPS_PROXY_PORT: "3890"

可用工具

工具名以插件实际注册为准（plugin/js/tools/*.js）。下表为常用子集，完整清单可在 Hermes 里列出 MCP 工具查看。

文字处理 (WPS Writer)

工具	说明
`wps_read_selection`	读取当前选区文本
`wps_read_document`	读取文档内容（`mode`：text 全文 / structured 结构化 / outline 大纲；可按段落/标题区间分页）
`wps_insert_text`	在光标处插入内容（`text` 纯文本，或 `blocks` 结构化排版；不接受内联格式，格式另调 format 工具）
`wps_replace_selection`	替换选中内容（`text` / `blocks`）
`wps_format_selection`	字符格式（`bold`/`italic`/`underline`/`fontName`/`fontSize`/`color`/`highlight`）
`wps_format_paragraph`	段落格式（`alignment`/`leftIndent`/`rightIndent`/`firstLineIndent`/`lineSpacing`+`lineSpacingRule`/`spaceBefore`/`spaceAfter`；`scope`=selection/document）
`wps_apply_paragraph_style`	套用命名段落样式（配合 `wps_list_styles`）
`wps_save_as`	另存为 PDF/DOCX（导出 PDF 也可用 `wps_export_pdf`）

表格处理 (WPS ET)

工具	说明
`et_read_range`	读取指定区域数据
`et_write_range`	写入数据到指定区域
`et_insert_chart`	插入图表（`dataRange` 含表头 + `chartType`：column/bar/line/pie/…）

公文排版 (政府文档)

灵犀AI 没有 “一键公文预设” 参数；公文格式通过“插入文本 + 分别设置字符/段落格式”组合完成。示例（Hermes 调用）：

python

# 1) 插入标题文本（不带格式）
mcp.invoke("wps_insert_text", {
    "text": "关于XX专项整治自查报告"
})
# 2) 选中标题后设字符格式：方正小标宋简体、二号(22磅)
mcp.invoke("wps_format_selection", {
    "fontName": "方正小标宋简体",
    "fontSize": 22
})
# 3) 标题段落居中
mcp.invoke("wps_format_paragraph", {
    "alignment": "center"
})
# 正文：仿宋_GB2312 三号(16磅)、28 磅固定行距、首行缩进 2 字符(≈32磅)
mcp.invoke("wps_format_selection", { "fontName": "仿宋_GB2312", "fontSize": 16 })
mcp.invoke("wps_format_paragraph", {
    "scope": "selection",
    "lineSpacing": 28, "lineSpacingRule": "exactly",
    "firstLineIndent": 32
})
# 一级标题：黑体 三号
mcp.invoke("wps_format_selection", { "fontName": "黑体", "fontSize": 16 })

使用示例

从 Hermes 写入 Word 文档

用户: 把以下公文按国标格式写入 WPS：
标题：关于XXX的自查报告
一级标题：一、工作情况
正文：根据XXXX...
 
Hermes → wps-ai MCP:
  1. wps_insert_text(标题) → wps_format_selection(方正小标宋简体,22) + wps_format_paragraph(居中)
  2. wps_insert_text(一级标题) → wps_format_selection(黑体,16)
  3. wps_insert_text(正文) → wps_format_selection(仿宋_GB2312,16)
  4. wps_format_paragraph(lineSpacing:28/exactly, firstLineIndent:32)
  5. wps_save_as(PDF)

提示：正文若一次性排版整篇，也可用 wps_insert_text 传结构化 blocks（标题/段落/列表由插件按 Word 原生格式渲染），再对需要的段落补调 format 工具。

从 Hermes 读取 WPS 文档

用户: 读一下当前WPS打开的文档内容
 
Hermes → wps-ai MCP:
  1. wps_read_document(mode="text")
  → 返回全文，供 AI 分析/改写/提取

从 NAS 远程操控

如果需要在 NAS 上的 Hermes 操控 Windows 上的 WPS：

1. Windows 上启动 proxy-server.js
2. NAS Hermes 通过 SSH 隧道连到 Windows 的 3890 端口
3. mcp-server.js 在 NAS 本地运行，HTTP 请求转发到 Windows

注意事项

WPS 必须保持打开状态
MCP 服务开关需在插件设置中开启
首次使用需生成 MCP token（插件自动处理）
支持的 WPS 版本：≥ 2023 冬季更新

All versions