命令面板是一個由鍵盤驅動的面板,無須離開應用程式即可從命令列執行 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。它們作用於已回傳的內容,絕不會發出第二次請求。 - 紀錄稿是暫時的。 關閉面板會保留紀錄稿;重新載入頁面則會清除它。
在行動裝置上
行動應用程式不提供此功能——請從網頁應用程式管理。