命令面板是一个由键盘驱动的面板,无需离开应用即可从命令行运行 Ceum。它运行的命令与独立终端客户端(@ceum/cli,可用 npm 安装)完全相同,基于 MCP 集成向外部工具开放的同一套工具——一套语法,三种入口。
区别在于它对你的要求。外部工具使用你创建并限定范围的 MCP 令牌进行身份验证;命令面板不需要:它以你的身份、用你自己的权限运行,因此没有令牌要创建,也没有令牌要轮换。它所做的更改会记录在工具操作中,与触及你工作区的其他一切并列。
开启面板
在任何文本字段之外按下反引号(`)。面板会从底部向上滑出,覆盖在导航栏之上。按 Escape 即可关闭。
面板内你会看到:
- 带有 Tab 补全的命令输入框。
- 你近期命令及其输出的记录稿(最后 100 条)。
- 用于调整面板高度的把手。
命令
命令读作 <资源> <操作>,选项为长参数:
tasks list --status doing
tasks create --title "Ship v1"
clients get C-7
invoices list --columns id,client,amount,status
完整命令集由服务器生成,因此始终与实际存在的内容一致——参见下方语法,或输入 help。API 能做的,命令面板都能做:不仅是列出,还包括创建与更新、批量操作、时间记录、看板以及关联。
有几个选项对任何命令都有效:
--columns——选择表格显示哪些列。-o json(或csv、ndjson)——输出原始数据而非表格。--all——遍历长列表的第一页之后的内容。--dry-run——显示某个命令将要发出的调用,但并不执行。--yes——跳过删除类命令的确认提示。
表格中的行可点击:每行链接到对应的条目,因此命令面板也是快速深入工作区的方式。点击链接会跳转并关闭面板。
删除内容
执行删除的命令会先询问。它会打印即将执行的操作并等待——输入 y 继续,输入其他内容取消。确定时可加 --yes 跳过询问。
命令面板做不到的事
有两件终端客户端能做的事,此处是有意省略的:
- 没有文件。 此处不存在
--file、--input-file和--stdin——浏览器面板没有文件系统。需要嵌套值时请使用--input '<json>',从电子表格批量导入则请使用终端客户端。 - 没有凭据需要配置。
--token、--url和--profile同样不存在,因为你的登录就是凭据。
输入其中任意一个,命令面板会指名说明,而不是当作拼写错误处理。
获取帮助
help 会根据你的具体程度调整:
help——列出所有资源,以及面板自身的内置命令。help <资源>——该资源的操作,每项附一行说明(例如help invoices)。help <资源> <操作>——单条命令的完整细节:每个选项、其数据类型,以及是否必填(例如help tasks create)。
帮助文本来自服务器自身的工具说明,因此即使应用其余部分不是英文,它也是英文——并且与终端中 ceum --help 打印的文本相同。
命令语法
由实时命令集生成,因此始终与命令面板和终端客户端实际接受的内容一致。每个资源一行,列出其操作;运行 help <资源> <操作> 查看选项。
assistant-config get
calendar-items list
client-statuses create, delete, list, update
clients bulk-create, bulk-delete, bulk-update, create, delete, get, list, update
combined-views create, delete, get, list, resolve, update
document-versions delete, get, list, restore
documents bulk-create, bulk-delete, bulk-update, create, delete, get, list, update
events create, delete, get, list, update
invoice-statuses create, delete, list, update
invoices bulk-create, bulk-delete, bulk-update, create, delete, flag, get, list, update
kanban-boards create, delete, get, list, update
profile get
project-relationship-types create, list
project-relationships create, list
project-statuses create, delete, list, update
projects bulk-create, bulk-delete, bulk-update, create, delete, get, link-clients, list, unlink-clients, update
relationship-types delete, get, update
relationships delete, update
settings get
subscriptions bulk-create, bulk-delete, bulk-update, create, delete, get, list, list-due, pause, unpause, update
tags bulk-delete, bulk-update, create, delete, list, update
task-comments create, delete, list, update
task-relationship-types create, list
task-relationships create, list
task-statuses create, delete, list, update
task-types create, delete, get, list, update
tasks bulk-delete, bulk-update, create, delete, duplicate, flag, get, link-projects, list, unlink-projects, update
time-entries aggregate, bulk-delete, bulk-update, create, delete, get, link-tasks, list, unlink-tasks, update
time-goals create, delete, get, list, pause, unpause, update
time-sessions resume, start
transactions bulk-create, bulk-delete, bulk-update, create, delete, get, list, update
workspace search
命令执行期间
需要连接服务器的命令会显示实时指示——一个小型旋转图标与以秒计的经过时间——直到完成为止,据此可分辨请求是慢还是卡住了。
Tab 补全
补全的运作方式与 shell 中相同:
- 按一次 Tab——填入最长的共同前缀。
- 按两次 Tab——显示所有候选项。
- 它会补全资源、操作、参数名,以及选项具有固定取值时的参数值——因此
tasks list --status <Tab>会给出可选状态。
提示与特殊情况
- 点击以聚焦。 点击面板空白处的任何位置都会聚焦命令输入框,因此你无需瞄准输入行即可开始输入。
- 觉得反引号别扭? 若你的键盘布局让反引号难以按到,你仍可通过键盘快捷键中的组合键链来切换 CLI。
- 快速清单就在附近。 CLI 面板从底部升起,而快速清单面板则从侧边滑入——两者不会重叠。
- 管道。 表格的行可以用
|就地过滤:tasks list | grep -E urgent,另有head、tail、sort和uniq。它们作用于已返回的内容,绝不会发起第二次请求。 - 记录稿是临时的。 关闭面板会保留记录稿;重新加载页面则会清除它。
在移动设备上
移动应用程序不提供此功能——请从网页应用程序管理。