用户上手指南
按真实界面逐项过一遍:登录、发任务、频道协作、蜂群产线、知识库、技能库、远程节点。看完即可独立使用 CrabCLI 的全部核心功能。
1. 登录与界面总览
打开部署地址(默认 :8080),在登录页输入管理员分配的账号密码。登录页的口号即产品定位:「Agent 与人,像同事一样协作」。登录后进入工作区,最左侧的导航栏是全部功能的入口:
| 入口 | 去往 | 用途 |
|---|---|---|
| 频道 | /channel | 团队协作空间:消息、话题、任务看板、知识库 |
| AI 编程机台 | /ai-coding?tab=new-chat | 发起单个 AI 会话:选环境、选 CLI、选仓库、选技能 |
| 设计 | /ai-coding?tab=design | 设计工作区,驱动设计技能与设计体系产出页面/物料 |
| 自动化 | /automations | 自动化任务的总览与管理 |
| 定时任务 | /monitor/schedule | cron 定时任务的监控与执行记录 |
| CLI 终端 | /clis-terminal | 查看正在运行的 CLI 会话现场 |
| MCP 注册表 | /mcp-registry | 管理 MCP 服务:浏览器、设备、邮件等工具接入 |
| 技能库 | /builder?tab=skill | 我的技能库,聊天式新建/测试/迭代技能 |
| Swarm 构建器 | /builder?tab=swarm | 画布式编排多 Agent 产线 |
| 知识库 | /builder?tab=knowledge | 上传文件建知识库,直接向知识提问 |
| 我的节点 | /my-nodes | 管理远程执行主机,查看节点能力与在线状态 |
2. 发起第一个任务:AI 编程机台
「AI 编程机台」的新建对话页(/ai-coding?tab=new-chat)是最常用的入口。在输入框描述需求,发送前做四个选择:
选执行环境
点「Auto · Claude Code」打开执行器选择器,左列选环境、右列选 CLI。环境分四组:Auto(系统自动挑选可用云沙箱,推荐)、本地环境(在服务器本机执行)、沙箱(已配置的云沙箱实例)、我的节点(你自己的远程主机,带「设备✓」「浏览器✓」标记的节点还能执行电脑操作与浏览器自动化)。
选 CLI
右列按所选环境过滤可用的 CLI:Claude Code、Gemini CLI、Qwen Code、OpenAI Codex、OpenCode、Pi CLI。CLI 是真正干活的智能体引擎,CrabCLI 负责编排、供给环境与回收产物。
选仓库
点「请选择仓库」选择任务针对的代码仓库——支持 GitHub、GitLab、Gitee 与自建 Git 服务;选中仓库后还可在右侧面板挑选具体工作项(Issue),让 Agent 直接对着工单干活。
选技能或蜂群
点「不使用技能」打开技能选择器:左侧是技能(系统内置 + 我的技能库),右侧是蜂群预设(如「并行协同开发流」)。选技能=给单个 Agent 装上专项能力;选蜂群=直接启动一条多 Agent 产线。
立即执行或定时执行
点「立即执行」可切换为「定时任务」:按每天/每周/每月/每小时/每 N 分钟/每 N 小时重复,或自定义 cron 表达式;面板实时预览 cron 与下次执行时间,时区可切换。适合日报、巡检、定时构建等场景。
3. 频道:人和 Agent 的协作空间
频道(/channel)是团队协作的最小单元。点「新建频道」创建一个主题空间,频道内八个标签页各司其职:
| 标签页 | 用途 |
|---|---|
| 聊天 | 消息流;@ 到人触发通知,@ 到 Agent 直接派发任务,Agent 的执行报告(含产物附件)也回流到这里 |
| 话题 | 围绕具体消息的子讨论,决策可回溯 |
| 任务 | 看板:任务卡带执行者与评审人,拖到「进行中」即开始执行,完成进「待评审」由人验收 |
| 自动化 | 频道级自动化任务,与定时任务同源 |
| 附件 | 频道内所有文件与 Agent 产物的汇总 |
| 知识库 | 频道作用域的知识库,Agent 执行时自动引用 |
| 成员 | 邀请同事与 Agent 加入频道,管理角色与可见性 |
| 设置 | 频道名称、描述、可见性等 |
详细机制读 频道与协作。
4. Swarm:把多条 Agent 连成产线
单个 Agent 是「点对点」,多条 Agent 接力是「产线」。打开 Swarm 构建器(/builder?tab=swarm):
- 画布上每个节点是一个步骤(如「通用执行器」),点「添加节点」扩充步骤,从节点右侧圆点拖拽到另一节点建立依赖——并行、串行、汇合都是 DAG 上的一张图。
- 每个节点可配置提示词与执行器;画布支持缩放、居中适配与自动布局。
- 不想画图的,直接在右侧对话框用自然语言描述,如「建一个 分析→并行(开发+测试)→审查 的流程」,系统自动生成 swarm。
- 保存后进入「我的蜂群」,之后在新建对话的技能选择器里可直接选用,一键启动整条产线。
状态机与执行语义读 Swarm 编排。
5. 知识库:让 Agent 站在你的资料上回答
知识库(/builder?tab=knowledge)按作用域隔离:私有、组织、频道(如 #data-analysis)。左上角切换作用域后:
- 上传源文件:拖拽或点击,支持 PDF / DOCX / Markdown / 图片,单文件 ≤50MB。
- 系统自动为源文件派生 wiki 页(overview、concept 等),文件列表里可查看与预览派生结果;Tags 面板按主题聚类,可点击过滤。
- 右侧直接向知识库提问:选中源文件后点快捷动作,或不选文件直接提问,系统从已沉淀的知识中自动检索作答。
- 「Wiki 关系图」按钮打开 [[link]] 拓扑图,直观看知识之间的引用关系。
6. 技能库:沉淀可复用的专项能力
技能库(/builder?tab=skill)左侧是「我的库」,右侧是对话框:发指令即可新建技能、对已有技能测试或迭代。技能是一个含 SKILL.md 的目录,描述触发场景与操作步骤;做好后在新建对话的技能选择器里即可选用,也可上架到技能市场共享。
7. 我的节点:把执行放到你自己的机器上
「我的节点」(/my-nodes)管理远程执行主机。点「添加主机」接入一台机器后,节点自动探测并上报能力:已安装的 CLI 及版本(claude / codex / qwen / gemini / pi / opencode)、运行环境(tmux / rclone / python / node / git)、以及设备与浏览器能力。派任务时在执行器选择器的「我的节点」组里指定它,任务就在你的机器上执行——代码与凭据不出你的机器。
8. 一个典型工作流
- 建频道定主题为项目建一个频道,拉入相关同事,上传需求文档到频道知识库。
- @ Agent 出方案在频道里 @ 架构类 Agent,基于知识库资料输出需求分析与方案;在话题里讨论定稿。
- 建产线跑开发用 Swarm 构建器建「分析→并行(开发+测试)→评审」产线,或在新建对话直接选蜂群预设启动。
- 看板跟踪与验收任务卡在频道看板推进,Agent 完成自动进「待评审」;评审人验收后进 done,报告与产物留档在聊天与附件区。
- 沉淀与复用把反复用的流程存成蜂群,把领域经验写成技能,把资料留在知识库——越用越顺手。