SuperAPI AI 工具集

officecli-word-form

办公与效率

查看项目

更新于 10-15 22:38

技能介绍

用途:创建真正可填写的 Word 表单(.docx),而非仅视觉上的下划线填空。表单载荷(w:sdt 内容控件、w:ffData 旧式字段、w:fldChar 邮件合并、documentProtection)与普通 docx 的段落/标题/样式元素不同,QA 关注数据管道而非版式。若文档无可填写字段(报告、信函、备忘录、论文、提案),应改用 officecli-docx。

主要能力:支持 SDT 类型 text/richtext/dropdown/combobox/date/picture/group;旧式 FormField 复选框(SDT 的 checkbox 类型未实现);MERGEFIELD 等复杂域;documentProtection 保护。多数表单可用纯 CLI 的 add 直接完成,含选项、日期格式与锁定。

使用方式:先安装 officecli(macOS/Linux:curl -fsSL https://d.officecli.ai/install.sh | bash;Windows:irm https://d.officecli.ai/install.ps1 | iex),用 officecli --version 验证。属性不确定时先查 officecli help docx [element] [--json],help 为准。三条路径:A 纯 CLI(默认);B CLI + raw-set 桥接(help 未暴露的属性,如显示文本≠存储值的下拉项);C Word 模板(真实 SDT 复选框、占位符部件、自定义外观)。protection=forms 必须最后设置,之后非字段内容编辑需 --force,表单字段仍可编辑。

限制:SDT 不支持 checkbox;每个 SDT 需 alias+tag;下拉/组合框需非空 items;formfield 名称≤20 字符;禁止下划线占位;构建日志不得出现 WARNING: UNSUPPORTED。路径需注意 shell 转义(路径加引号、含 $ 的属性用单引号、--after find: 用外层单引号)。