文档
OpenCockpit 的完整使用文档 —— 开源的 Claude Code 图形界面,接任意大模型。第一次来就从「介绍」开始,或者直接跳到某个面板。
第一次使用?从「介绍」开始 →开始使用
Agent 面板
- 消息输入每个 Agent tab 底部的文本框就是消息输入。看起来就一行,但能做几件有意思的事 —— 旁边一排工具按钮、粘图、shell 命令前缀、斜杠菜单。
- 会话管理OpenCockpit 里的会话指一个引擎上的一段连续对话 —— 绑定一个 Agent tab。每个 tab 就是一个会话;整个 UI 围绕"同时跑多个会话还不至于乱"来设计。
- 工具快照AI 每执行一次可能碰文件的工具 —— Edit、Write、Bash 命令、Task 子代理、MCP 工具 —— OpenCockpit 都会给项目拍一张快照。于是每条回复都有一条 git 历史式的时间线:一次工具调用一个条目,每个条目展示这次调用产生的真…
- SkillsSkills 是你在 Agent tab 里用 / 触发的短 prompt —— 每个 Skill 改变 AI 这一次回复的工作方式。OpenCockpit 内置 12 个 Skills(/qa /fx /ex /go /cg /cc /cr 模式,外加 /…
- BotsBot 是有持久上下文、以普通文件保存的子代理。每个 Bot 都是一个普通目录,根目录有
- 工作流一条消息可以不止一个命令。只要你有好几行分别以 /、/@ 或 @ 开头,OpenCockpit 会把每个命令行就地标注成一个紧凑标签(标明在哪执行、用哪个 Skill 或 Bot),并把执行需要的文件路径放到消息末尾 —— 你的原始排版、空行、行文顺序全部保…
- HTML 应用普通的 HTML 预览是纯静态的 —— 页面想拉真实数据,会被同源沙箱用 CORS 拦住。HTML 应用把这层墙拆了:用 /html 让 AI 生成一个 HTML 应用,预览时注入一个 window.cockpit SDK —— 本质就是把 Bash 工具暴…
- AI 引擎用 Claude Code 式的 Agent 驱动任意大模型 —— Claude、Codex、DeepSeek、GLM、Kimi 或本地 Ollama。每个 tab 选一个引擎,不用改环境变量。
- 定时任务定时任务让 OpenCockpit 按计划替你跑一个 AI prompt —— 延迟一次性、每 N 分钟、或按 cron 表达式。给那些你本来要每天早上、每小时、每周五下午记住做的事用。
- 笔记OpenCockpit 的笔记是给那些不该进 commit、也不该进聊天的东西用的草稿本 —— 备忘、todo 列表、常看的网页链接、临时计算,任何你想跨会话留住的常用信息。分两种:
Explorer 面板
- 目录树文件标签是 Explorer 面板的主视图 —— 项目里所有文件的虚拟滚动树,加上每文件查看器,以及 OpenCockpit 把代码片段喂给 AI 的内联评注面。
- 搜索OpenCockpit 提供 4 种相互补充的代码搜索方式,大致按打字速度排序:
- 最近最近 标签是 Explorer 面板的 "我刚才看的是什么" 视图。文件按最后访问时间排序,最新的在最上面。
- 变更变更 标签展示你的 Git 工作树 —— 哪些已 stage、哪些没,以及 OpenCockpit 的并排 diff 查看器。提交前 review 所有改动(你的 + AI 的)就在这里。
- 历史Git 历史 标签加上几个相关视图 —— 分支、worktree、blame —— 让你回溯谁、什么时候、为什么改了什么。
- 技术方案评审技术方案评审 把 OpenCockpit 项目里的 Markdown 文件变成一个 LAN 分享的讨论页:网络里任何人打开 URL,浏览器里读,加行级评论 —— 不用登录、不用装东西。设计目标是方案级评审(这个思路对不对?),不是逐行代码 review。
Console 面板
- 命令输入Console 面板底部有一个命令输入框。每次你回车,OpenCockpit 按一套固定顺序决定开哪种气泡:别名展开 → 插件 match → PTY 命令清单 → 一次性命令。这一页是"什么触发什么"的速查表。
- 终端气泡OpenCockpit 的"终端"其实是两种气泡:跑 ls、pytest 用的一次性命令气泡,和跑 bash、vim、top 用的完整交互式终端气泡。输入栏根据你打的内容自动选对的(详见命令输入)。
- 浏览器气泡浏览器气泡从 OpenCockpit 的 Console 面板里驱动一个真实的 Chrome 标签页。指向一个 URL,页面就加载出来,然后能导航、点击、输入、截图、抓网络流量,最关键的 —— 把整个标签页交给 AI 替你操作。
- 数据库气泡OpenCockpit Console 面板会自动识别数据库连接串,开一个数据库气泡 —— 内置客户端,带表结构浏览 + 数据浏览 + 查询窗口,只针对那一个数据库。不用为了瞄一眼数据再去开 psql / mysql / DataGrip / RedisIn…
- 别名与环境变量两个让 Console 顺手得多的小功能:别名(给长命令起短名)和环境变量(给当前 tab 设值,命令运行时能读到)。
- Chrome 扩展OpenCockpit 的 Chrome 扩展是可选的。Cockpit 的大部分能力 —— Agent、Explorer、终端 / 数据库气泡 —— 不装也能跑。只有当你想让浏览器气泡像真实 Chrome 标签页那样工作(而不是普通 iframe)时才需要它。