用途：confluence-axi 用于通过命令行操作 Confluence Cloud，适合智能体或脚本执行页面读取、创建、更新、删除，以及查询页面子页、附件、标签、空间和 CQL 搜索等任务。
主要能力：可直接调用 Confluence Cloud REST API（OAuth 模式下经 api.atlassian.com）。命令分为 dashboard、auth、page、space、search、setup 六组。page 支持 get（--full 完整正文、--format storage|adf）、create、update、delete、attachments、labels、children；space 支持 list；search 使用 v1 CQL 查找页面 id。变更操作是幂等的，并会报告更改内容；分页查询支持 --limit 与 --fields 调整字段。
使用方式：通常无需安装，直接运行 npx -y confluence-axi@latest <command>；全局安装 npm i -g confluence-axi 是次要选项，用于 SessionStart hook，setup hooks 需要它。认证有两种模式：auth login 走 OAuth 浏览器流程（适合人工交互终端，token 自动刷新）；auth login --token --site <site> --email <email> 由 stdin 接收 API token（适合智能体/CI）。凭证解析顺序为 ATLASSIAN_API_TOKEN 环境变量、OAuth 会话、存储的 API token。OAuth 需自备已注册的 3LO 应用，设置 ATLASSIAN_AXI_OAUTH_CLIENT_ID 及客户端密钥。标志须放在命令之后，如 confluence-axi search "space = ENG" --limit 5。
适用场景与限制：适用于读取页面正文、在空间或父页面下创建页面、更新标题或正文、删除页面、列出子页面或附件、管理标签、列出可达空间、用 CQL 搜索页面 id 以及认证管理。注意：page create/update 接受的是存储格式 XHTML 正文，不是 Markdown，--format adf 仅用于读取；page update 是全文替换，默认在新正文丢弃现有宏/嵌入时拒绝执行，可用 --allow-macro-loss 有意丢弃；附件为只读，需在 Confluence UI 上传；裸 404 不等于页面不存在，可能是权限不足；标签的 --add/--remove 仅管理 global 前缀标签且互斥。具体功能完整性与后续变更以官方资料为准。