cli-anything-seaclip 是做什么的?
一个无状态的 SeaClip-Lite 项目管理命令行界面。 通过 HTTP API 和直接 SQLite 读取进行通信。无本地状态或会话。
安装
pip install -e .
前提条件:
- Python 3.10+
- 运行在 localhost:5200 的 SeaClip-Lite 后端
用法
基本命令
# 显示帮助
cli-anything-seaclip --help
# 启动交互式 REPL 模式
cli-anything-seaclip
# 使用 JSON 输出运行(供代理消费)
cli-anything-seaclip --json server health
cli-anything-seaclip --json issue list
cli-anything-seaclip --json agent list
REPL 模式
当不指定子命令调用时,CLI 会进入交互式 REPL 会话:
cli-anything-seaclip
# 以交互方式输入命令,支持 tab 补全和历史记录
命令组
Issue(问题)
问题管理命令。
| 命令 | 描述 |
|---|---|
list | 列出问题(--status, --priority, --search, --limit) |
create | 创建新问题(--title, --description, --priority) |
move | 将问题移至列(ISSUE_ID --column COL) |
status | 更新问题状态(ISSUE_ID --set STATUS) |
delete | 删除问题(ISSUE_ID) |
Agent(代理)
管道代理命令。
| 命令 | 描述 |
|---|---|
list | 列出所有管道代理 |
Pipeline(管道)
管道控制命令。
| 命令 | 描述 |
|---|---|
start | 启动管道(--issue UUID --mode auto/manual) |
status | 获取管道状态(--issue UUID) |
resume | 恢复暂停的管道(--issue UUID) |
stop | 停止正在运行的管道(--issue UUID) |
Scheduler(调度器)
调度配置命令。
| 命令 | 描述 |
|---|---|
list | 列出所有调度配置 |
add | 添加调度(--name, --cron, --repo) |
sync | 触发同步(SCHEDULE_ID) |
Activity(活动)
活动源命令。
| 命令 | 描述 |
|---|---|
list | 最近活动(--limit N) |
Server(服务器)
服务器实用命令。
| 命令 | 描述 |
|---|---|
health | 检查后端健康状态 |
输出格式
所有命令均支持两种输出模式:
- 人类可读(默认):表格、彩色、格式化文本
- 机器可读(
--json标志):供代理消费的结构化 JSON
# 人类输出
cli-anything-seaclip issue list
# 供代理使用的 JSON 输出
cli-anything-seaclip --json issue list
针对 AI 代理
当以编程方式使用此 CLI 时:
- 始终使用
--json标志 以获得可解析的输出 - 检查返回码 - 0 表示成功,非零表示错误
- 解析 stderr 以获取失败时的错误消息
- 错误响应 在 JSON 模式下包含
{"error": "message"}
版本
1.0.0