通过 osascript 直接控制本地 Microsoft Word 实例,实现实时文档操控、批注管理、修订审阅及导出等自动化流程,适合需要与 Word 应用状态深度交互的场景。
说明:
## 核心用法
本 skill 专为**实时控制 Microsoft Word 应用程序**设计,区别于静态 `.docx` 文件处理。通过 macOS 原生的 `osascript` 调用 Word 的 AppleScript 字典,实现对活动文档、选区状态、批注、修订追踪、导出等功能的精确操控。
**关键工作流包括:**
– **会话管理**:连接现有 Word 实例或按需启动,明确标记文档来源(用户已打开 vs. 脚本新建)
– **状态感知操作**:每次写入前预读文档名称、当前选区、视图模式、修订状态;操作后验证变更并报告
– **选区锚定**:优先通过文档对象(段落、章节、批注范围)定位,避免依赖易漂移的光标位置
– **审阅动作分级**:将添加批注、切换视图、导出标记为可逆操作;接受/拒绝全部修订、删除批注、覆盖导出、关闭不保存等需显式确认
– **清洁退出**:仅关闭脚本创建的文档,保留用户原有工作会话,失败时记录具体阻塞原因(受保护文档、模态对话框、权限缺失等)
## 显著优点
1. **实时交互能力**:直接操作 Word 应用状态,支持修订模式、批注气泡、字段更新等 DOCX 库无法触及的功能
2. **防御性设计**:强制”先读后写”模式,配合双重验证防止误操作;显式区分可逆与不可逆动作
3. **会话隔离**:清晰的”附件归属”策略,避免自动化意外中断用户正在进行的写作工作
4. **故障可恢复**:`incidents.md` 记录已知失败模式与验证恢复步骤,支持问题快速定位
## 潜在局限
– **平台锁定**:仅支持 macOS,依赖本地 Word 安装与 `osascript` 环境
– **UI 依赖**:受 Word 前端状态影响(模态对话框、受保护视图、兼容模式)可能阻塞脚本执行
– **无云能力**:不涉及 Microsoft Graph 或云端文档 API,无法处理基于云的协作场景
– **学习成本**:需理解 Word AppleScript 字典的对象模型(document/selection/story range/comments 等层级)
## 适合人群
– 需要自动化处理含修订追踪、批注的正式文档的编辑/法务/出版工作者
– 需在导出前强制更新域、目录、引用的技术文档撰写者
– 希望将 Word 集成至本地 macOS 工作流(如结合 Shortcuts、Alfred 等)的效率用户
– 不适合:仅需批量生成静态 DOCX 的开发者(应选用 `word-docx` skill)
## 常规风险
| 风险场景 | 缓解机制 |
|———|———|
| 选区漂移导致文本写入错误位置 | 强制对象锚定,禁止纯光标相对写入 |
| 全局接受/拒绝修订造成不可逆编辑损失 | 显式确认+范围限定双重检查 |
| 导出前未更新字段导致内容过时 | 预检查 TOC/引用状态,强制更新后导出 |
| 误关用户原有 Word 会话 | 文档归属标记,仅清理脚本创建的资源 |
| 受保护文档或模态对话框阻塞 | 失败时记录具体状态,不自动重试或绕过 |







