CLI 参考
推荐通过 设置 → AI 管理 安装匹配版本的 CLI。以下内容用于需要直接执行命令的用户。CLI 和桌面共用真实技能库；示例中的写操作不是演练环境。
独立安装
不使用桌面安装入口时，可用官方脚本安装最新正式版。桌面 v1.0.0 已发布；脚本根据正式发布的清单选择对应系统与架构的 CLI。
macOS / Linux：
curl -fsSL https://raw.githubusercontent.com/qufei1993/skills-hub/main/scripts/install-cli.sh | bash
Windows x64 PowerShell：
irm https://raw.githubusercontent.com/qufei1993/skills-hub/main/scripts/install-cli.ps1 | iex
脚本校验 SHA-256，并配置用户级命令目录。macOS/Linux 为 ~/.local/bin，Windows 为 %LOCALAPPDATA%\SkillsHub\bin。无需 Node.js 或 npm。Linux 仍需 glibc 2.39 或以上。
安装后重开终端，并验证：
skillshub-cli version --json
skillshub-cli --help
独立安装不会自动安装官方 AI 管理 Skill。升级可重新执行安装脚本；它与桌面管理的 CLI 分开维护。卸载独立 CLI 时删除其安装目录中的可执行文件，技能库保留。
查询与安装
下面的只读命令可先运行：
skillshub-cli --json agents list
skillshub-cli --json skills list
skillshub-cli --json skills search "testing"
skillshub-cli --json doctor
后续示例中，SKILL_ID 替换为列表返回的真实 ID，SOURCE 替换为 Git 地址或本地路径，SKILL_PATH 替换为仓库内 Skill 目录。不要原样执行占位参数。
skillshub-cli --json skills show SKILL_ID
skillshub-cli --json skills status SKILL_ID
skillshub-cli --json skills install SOURCE
skillshub-cli --json skills install SOURCE --subpath SKILL_PATH
skills install 安装到技能库。分发使用单独命令；官方 AI Skill 会按你的意图组合这些操作。
CLI 没有 collections install 等合集子命令。安装官网合集时，官方管理 Skill 按清单逐项调用现有安装、标签和分发命令，并保留清单中的精确提交。详见 AI 管理。
分发与更新
先预览分发，再执行：
skillshub-cli --json skills deploy SKILL_ID --agent codex --dry-run
skillshub-cli --json skills deploy SKILL_ID --agent codex
可以重复 --agent 指定多个目标。在 macOS/Linux 上，兼容工具可加 --project /absolute/project/path。用 skills undeploy 和相同选择参数取消对应分发；中心库条目保留。
skillshub-cli --json skills check SKILL_ID
skillshub-cli --json skills update SKILL_ID
skillshub-cli --json skills check --all
查看整批检查结果并决定执行后，才运行 skills update --all。更新命令不接受 --dry-run 或 --yes；不要自行添加 --force。
接管、标签与删除
接管已有目录和删除条目先使用预览：
skillshub-cli --json skills adopt /absolute/agent/skills --dry-run
skillshub-cli --json skills remove SKILL_ID --dry-run
查看影响范围并确认后，用相同命令的 --yes 替换 --dry-run 执行。删除进入本机回收站。
skillshub-cli --json skills tag add SKILL_ID testing
skillshub-cli --json skills tag list SKILL_ID
skillshub-cli --json skills tag remove SKILL_ID testing
标签还支持 set、rename 和 delete，用子命令 --help 查看参数。删除标签也支持先 --dry-run 再 --yes。配置官方管理 Skill 可用 setup --agent codex；移除其工具分发使用 setup --agent codex --remove --dry-run 先预览。
错误与边界
OPERATION_BUSY 表示另一个写操作尚未完成；等待后重试。TARGET_CONFLICT 需要检查工具目标冲突与本地内容。CONFIRMATION_REQUIRED 需要先查看计划；PLAN_STALE 需要重新预览。不要删锁文件、直接修改数据库或绕过目录保护。
设备同步、授权、定时任务、设置、应用更新和回收站恢复仍在桌面端完成。命令参数中不要包含 Token 或私钥。具体功能列表可运行 skillshub-cli skills --help 查看。