Agent Skills
返回列表
WPS 纯COM 直连编辑

WPS 纯COM 直连编辑

办公效率 更新于 2026.08.29

将以下提示词粘贴到你的 AI 对话框中:

请根据 https://skillhub.cn/install/skillhub.md,安装 @user_b14ebeb8/wps-com-edit

技能介绍

为什么放弃 MCP 直连 COM

当我们尝试用自动化脚本在本地 Word 或 WPS 里填标书、改文档时,如果中间夹着一层 MCP(如 word-mcp-live),往往会遇到意想不到的麻烦。这类服务底层虽然也是 COM,但额外起了 SSE 服务器。在处理大量数据或批量写入时,这层中间件很容易出现通道堵塞甚至崩溃断连。一旦断连,AI 就失去了对当前活动文档的控制,任务只能停滞。

解决方案很简单:去掉中间商。 本技能包含一套基于 pywin32 的纯 COM 直连方案,不启动任何服务器进程。

工具与工作流

所有脚本都通过 com_insert._get_word_app() 函数统一尝试 KWPS.Application 或 Word.Application 来接管窗口。针对不同类型的修改需求,提供了几个核心工具:

  • 文本操作:com_read_para.py 读段落、com_insert.py 在指定锚点后插入文字,或 com_fill_blanks.py 填充下划线填空题。
  • 表格处理:com_table.py 实现了 get_table_info、set_cell 等函数。相比 MCP 经常出现的丢格问题,本技能采用 (行, 列) 坐标寻址 直接写入 Range.Text。这种方法极其稳定,即使目标单元格是空的也能直接写入,且不会导致文档排版整体位移。
  • 批注与修订:com_comment.py 提供实时加批注能力,com_revision.py 实现了修订模式开关及 accept_all 接受/拒绝修订等操作。

适用边界与安全守则

  • 前置条件:必须先用 WPS/Word 打开目标文档,且该文档必须是活动文档(即光标就在文档窗口内)。连通后若报「无效的类字符串」,请检查 pywin32 环境是否正常。
  • 写入需谨慎确认:所有写操作都是不可逆的,在执行 set_cell 或批量填空之前,AI 必须先向用户确认表格序号、目标坐标及是否会覆盖原有内容。执行 accept_all 之前,请务必先运行 list_revisions() 查看变更列表。
  • 段落与单元格的区别:段落操作请遵循「插入不替换」原则(如 InsertBefore),避免直接覆盖整段从而导致格式丢失;而单元格则可以直接按坐标覆盖写入。请注意,如果开启了 TrackChanges(修订模式)后进行大面积批量填表,会产生海量的修订记录,操作结束后若不想保留痕迹,记得调用 accept_all() 清理。

使用场景

  • 制作长篇投标标书时,需要将几十页WPS文档中的下划线填空题和表格数据批量、准确地填入,并保证原有格式不乱。
  • 客户要求查看修改痕迹时,需要在WPS长文档的指定段落批量加批注、开启修订模式进行修改,并在填完后清理多余修订记录。
  • 处理包含跨页或合并单元格的复杂Word表格时,需要绕过不稳定的文本替换,用坐标寻址直接安全地写入空白单元格。
  • 撰写项目方案时,需要在长段落的特定锚点词汇后精准插入补充说明,同时不能覆盖或破坏原有的段落排版和空格格式。

适合人员

  • 招投标专员:需要将大量参数和表格数据批量填入标准WPS标书模板,且要求脚本绝对稳定、不破坏原排版。
  • Agent应用开发者:受够了MCP与Word交互时的SSE断连问题,急需一套低延迟、高可靠的Windows本地文档自动化方案。
  • 合同审核人员:需要对长篇商务合同进行程序化批注与修订,并在批量修改后一键清理冗余记录以顺利交付客户。
  • 技术文档撰写者:需要在长文中特定关键词锚点后精准插入版本说明,诉求是插入过程必须保留原有的段落格式和空格。