WPS 纯COM 直连编辑
将以下提示词粘贴到你的 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本地文档自动化方案。
- 合同审核人员:需要对长篇商务合同进行程序化批注与修订,并在批量修改后一键清理冗余记录以顺利交付客户。
- 技术文档撰写者:需要在长文中特定关键词锚点后精准插入版本说明,诉求是插入过程必须保留原有的段落格式和空格。