让codex生成真正的word文件,可以安装genoffice应用及其配套skill,由codex编写内容,再通过本地genoffice命令创建.docx、读取结构并渲染检查。skill本身不是office运行时,单独装入一份skill.md不会获得文档引擎;先确认本机genoffice与cli可用,再把任务交给agent。
先确认CLI,再选择一种Skill安装方式
安装官方适合本机系统和处理器的GenOffice版本后,在新终端中执行:
genoffice --version
若找不到命令,先重开终端。应用每次启动会将CLI启动目录写入~/.genoffice/launcher,Windows对应%USERPROFILE%\.genoffice\launcher。按该文件提供的真实目录调用启动器;macOS默认路径为/Applications/GenOffice.app/Contents/Resources/cli/genoffice,路径带空格时加引号。
Skill可从应用的Settings → Integrations安装到检测到的Codex;也可审阅官方仓库后使用Skills兼容安装器:
npx skills add genspark-ai/genoffice
两种方法选一种即可。安装器询问目标Agent与作用范围时,选择实际使用的Codex,完成后新建聊天。应用集成页在新版本附带新Skill时提供更新入口,应同时核对CLI与Skill版本,不把一个系统中旧副本的说明直接套到另一套安装。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
官方README的浏览器翻译视图,列出应用集成页、ZIP和Skills安装器入口。
将任务限定到一个工作目录
在准备好的目录中放入notes.md,使用实际素材而非让Agent编造数据。可给Codex这样的任务:
使用已安装的GenOffice Skill,将当前目录的notes.md生成notes.docx。 保留标题层级和表格,不补没有来源的数据。 创建后读取完整文本,执行docs check,并逐页渲染检查。 修正溢出、缺图或内容遗漏后交付,报告仍未解决的问题。
如需限制CLI可访问范围,在启动Codex之前设置GENOFFICE_ALLOWED_ROOTS。macOS或Linux示例:
export GENOFFICE_ALLOWED_ROOTS="$PWD" codex
该变量限制GenOffice文件读写,不是对整个Codex进程或所有工具的沙箱。Agent需要继承这一环境;目录列表按操作系统的PATH分隔方式书写,符号链接也会解析后检查。
创建、回读与渲染各有用途
对Markdown转Word这一任务,官方命令路径如下。为程序处理输出时加--json,不要只解析自然语言提示:
genoffice create --type docx --from notes.md --out notes.docx --json genoffice docs read notes.docx --full --json genoffice docs check notes.docx --json genoffice render notes.docx --out shots/

官方文档中的创建Office文件、读取内容和逐页渲染命令。
docs read用于核对实际内容;docs check会指出失效引用、缺失图片、占位文字、未决修订等结构问题,但其退出码为0不表示文档完全没有发现项,仍要阅读返回内容。render输出逐页图片,需要检查页面溢出、表格分页、缺字和图片比例。结构检查不能代替视觉审阅,也不能证明事实正确。
根据真实错误处理,不强行覆盖
输出已存在时优先改用新文件名;源文档正在GenOffice中打开时,关闭对应页签或另存副本,不机械加--force。返回outside_allowed_roots时回到许可目录,不通过换路径绕过限制。CLI文档规定退出码1为用法问题、2为文件问题、3为转换失败、4为应用不可用;同时检查JSON中的error、suggestion、detail和成功结果中的warnings。
上述创建和检查由本地引擎完成,但Codex本身使用的模型服务仍可能接收任务内容;GenOffice的搜索、图像生成和媒体分析也可能调用其配置的外部服务。涉及敏感材料时,应分别核对Agent与GenOffice的服务设置,不能把“本地生成文件”理解为整个AI流程绝不离开电脑。


















