G1GEO CLI 是面向终端、AI Agent 和 CI 的官方命令行入口；G1GEO Skill 告诉兼容 Agent 怎样把业务目标安全地转换为 CLI 工作流。它们不会使用网页 Cookie，也不应绕过当前身份、产品、套餐或功能权限。
安装 CLI
本机需要 Node.js 22 或更高版本，并能访问 npm 公共包。执行：
npm install --global @g1geo/cli@latest
g1geo --version
g1geo guide
g1geo guide 会输出与已安装版本匹配的操作指南。升级 CLI 后重新阅读 Guide；在 CI 等可重复环境中，建议固定经过验证的具体版本。
完成交互式授权
人类桌面终端使用：
g1geo auth login
g1geo auth status
无图形浏览器的终端或 AI Agent 使用：
g1geo auth login --no-browser
CLI 会给出授权地址和一次性代码，由用户在 G1GEO 页面确认。不要把密码、短信验证码、浏览器 Cookie、访问令牌或刷新令牌交给 Agent。
无人值守 CI 应由管理员通过密钥管理器注入最小权限 Service Token。凭证创建入口是否可见取决于当前账号身份和权限；没有入口时联系管理员，不要复制其他人的凭证文件。
恢复项目上下文
CLI 不会暗中记住产品、发布团队或桌面设备。新会话先查看：
g1geo status
g1geo --product <product-id> capabilities
status 用于发现可访问产品、最近工作和进行中 Job；capabilities 反映当前服务端、身份、凭证与产品真正允许的操作。多个产品都可能匹配时，应由用户选择，不要默认使用最近一个。
业务命令显式携带产品：
g1geo --product <product-id> <business-command>
也可以使用 G1GEO_PRODUCT_ID，但显式参数优先。生产环境无需设置服务地址；测试或私有地址必须经授权并使用 HTTPS，本地开发除外。
常用工作流
检查公司知识与问题
g1geo --product <product-id> knowledge get
g1geo --product <product-id> questions list
g1geo --product <product-id> questions get <question-set-id>
生成文章
g1geo --product <product-id> articles generate \
--question-set <question-set-id> \
--wait
创建并读取 GEO 检测
g1geo --product <product-id> geo detect \
--question-set <question-set-id>
g1geo --product <product-id> geo result <run-or-job-id>
检测可能持续较长时间。保留返回的 job_... 或 grun_... ID，按结果中的建议间隔做有限轮询，不要让 Agent 长时间阻塞，也不要把超时误判为远端任务失败。
异步 Job
问题生成、文章生成、文章裂变、品牌报告、登录检查和发布等操作会返回统一 Job。可使用：
g1geo jobs get <job-id>
g1geo jobs wait <job-id>
g1geo jobs cancel <job-id>
父 Job 完成不代表所有子项成功。检查每个结果项，分别报告成功、失败和部分完成。等待在本地超时后，远端任务可能仍在运行，应保留 Job ID，而不是重复创建。
发布的额外确认
读取、编辑或生成内容不授权对外发布。只有用户明确要求发布时，才选择目标账号或媒体，并使用命令要求的 --yes：
g1geo --product <product-id> --team <team-id> --device <device-id> \
publishing publish \
--article <article-id> \
--account <account-id> \
--yes \
--wait
桌面发布要逐目标检查最终状态、URL 或帖子 ID、审核原因和失败可重试性。GEO 媒体 Job 成功只表示上游投稿流程已接受，最终公开链接可能稍后出现。
安装 Skill
打开G1GEO Skill 页面，按当前页面为兼容的 Agent 环境安装官方 Skill。安装后仍由 CLI 执行操作，实际权限来自当前登录身份和 capabilities。
安全规则
- 不在命令参数、日志、文件、提示词或 Agent 记忆中保存令牌；
- 不向 Agent 提供密码、MFA、Cookie 或操作系统凭证库内容；
- 修改资源前先读取现状，避免用局部输入覆盖其他字段；
- 删除必须由用户明确提出；
- 外部发布必须再次确认目标、内容、费用和时间；
- 报错时保留 CLI 版本、命令名、稳定错误码和
request_id，但删除敏感内容。