用途:该技能面向 SiteOS 统一 CLI(@siteoshq/cli),指导安装、升级、诊断以及查找受支持的子命令,也供其他 SiteOS 技能引用确切的 CLI 用法。
主要能力与对应版本:
- 安装与诊断:需要 Node.js 22 或更高版本。使用 npx --yes @siteoshq/cli@latest --help、npm install --global @siteoshq/cli、siteos --version。只读本地诊断:npx --yes @siteoshq/cli@latest health-check --json,不访问产品 API 或读取运行时凭证。
- 托管安装:CLI 1.1.1 及以上默认域名 https://app.siteos.sh。暂存环境需在认证前将 SITEOS_AUTH_BASE_URL、SITEOS_FORMS_PUBLIC_URL、SITEOS_SEARCH_PUBLIC_URL 均设为 https://siteosapp.xui.se。
- 项目与环境:siteos project use 私下选择 Project;siteos project environment use <slug> 统一切换服务环境。
- Storage:siteos storage status --json、siteos storage list --json 起步;CLI 2.24.0 新增批量上传、--dry-run 及 --on-conflict error|skip|replace。
- Search:按 Project 环境独立索引,search index list/create,--index ID;CLI 2.11.0 新增爬取预览、--decisions、--review-token。
- SEO:CLI 2.1.0 新增 seo repair、seo recheck --url(最多 20 个)、--resource;整站审计上限 500 页为服务端策略。
- Trace:CLI 1.8.0 新增 trace 目的地、事件、属性、问题、观察等命令及 tracking-plan publish --expected-draft-version。
- Forms:Zod 项目需 CLI 2.45.0+,forms deploy --source siteos.forms.ts,搭配 @siteoshq/forms 0.2+;发布需 SITEOS_FORMS_DEPLOYMENT_KEY。
- Cookie 与 Mailchimp:cookie services list、cookie discover;集成相关命令需查看 forms --help 与 integrations --help。
使用规则:自动化场景优先使用 --json;退出码 0 表示成功、2 表示用法无效,其余非零视为运行失败并保留安全错误文本;通过 siteos auth 认证一次。切勿打印一次性令牌、会话、服务授权、运行时凭证、授权头、私有绑定文件或 .env 内容。私有状态放于 ${SITEOS_HOME:-~/.siteos} 且不得提交。若命令缺失,用 command -v siteos(PowerShell 为 Get-Command siteos)核对,并运行 npx --yes @siteoshq/cli@latest --version 及所需 --help;避免裸用 npx @siteoshq/cli 以免解析到旧版本;npm 缓存 EACCES 时用 --cache 指定用户自有临时目录,不要用 sudo 或改动共享缓存归属。
限制:部分命令需要特定 CLI 版本和匹配的 SiteOS 服务端版本;未在生成参考中出现的命令应运行相应 --help 确认,不得臆造或调用私有 API。资料未提供收费、价格与具体效果信息,暂未提供。