zagens-office 快速开始

zagens-office 是本机 Office 结构化引擎：用一份 JSON 生成或编辑 Word / Excel / PowerPoint / PDF，无需安装 Microsoft Office。

适合：人用 CLI / GUI 出稿；Agent / Cursor Skills 调用同一命令行。

若你要找的是桌面 Agent「办公模式」工作流（会话、技能卡片），见 Agent 办公模式。

三步跑通

  1. 安装 CLI（及可选 GUI）。
  2. 查契约：zagens-office schema write pptx
  3. 生成并校验：
zagens-office write pptx --path deliverables/intro.pptx --input-file deck.json
zagens-office edit --path deliverables/intro.pptx --op validate --input '{}'

最小 deck.json：

{
  "title": "公司简介",
  "slides": [
    { "title": "关于我们", "bullets": ["要点一", "要点二"] }
  ]
}

核心习惯

习惯 做法
先契约后动手 schema write <format> 或 schema edit
复杂 JSON 用 --input-file，少用 shell 内联
长 PPT 逐页 骨架 write → edit --op upsert_slide
多步修改 edit --op batch + "atomic": true
交付前 edit --op validate，确认 ok=true

所有命令输出一行 JSON 信封：{"ok":true,...} 或 {"ok":false,"code":...,"error":...,"suggestion":...}。失败时按 suggestion 修正，不要盲目重试同一请求。

升级后若宿主仍读旧技能，见 更新 的技能同步说明。

下一步