語法
# 開頁(固定崗位:在它自己的資料夾上崗)
herdr tab create --workspace <工作區編號> --cwd "<公司根目錄>/角色/<英文名>" --label <英文名> --no-focus
# 開頁(臨時幫手:在公司根目錄上崗)
herdr tab create --workspace <工作區編號> --cwd "<公司根目錄>" --label tmp-<短名> --no-focus
# 關頁(用回傳的 tab_id)
herdr tab close <tab_id>
參數
| 參數 | 說明 |
|---|---|
--workspace |
工作區編號:herdr workspace list 的 result.workspaces 裡找 label 等於公司名那項的 workspace_id |
--cwd |
這一頁的啟動目錄——決定員工開機讀到哪份說明檔(崗位手冊 vs 總規矩) |
--label |
頁面名;固定崗位用英文名,臨時幫手用 tmp-<短名>(小寫英文、數字、連字符) |
--no-focus |
開頁但不把畫面切過去,開辦時連開多頁不閃屏 |
成功後從回傳 JSON 取 result.tab.tab_id(臨時幫手要記進任務卡)和 result.root_pane.pane_id(下一步 agent start 要用)。
一頁一人、一頁一視窗
視窗 (pane) 可以往右、往下再切子視窗,但不這麼用——越切越亂。左邊點誰、右邊就是誰。
關頁規矩(協作規矩第 5 條)
- 臨時幫手結果讀完馬上關頁:
herdr tab close <tab_id>,成功後herdr agent list裡已經沒有tmp-<短名> - 誰請來的誰關;只關自己開的頁——不關別人開的頁、不動別的工作區
- 固定崗位的頁面一直開著:關終端、關介面都不影響,下次打開還在
- 開之前先
herdr agent list看這個名字在不在線:在線就跳過;不線但已有同名舊頁(上次沒開成或重啟殘留),照常開新頁、上崗成功後再關舊頁
常見錯誤
- 關頁失敗 → 先確認
tab_id沒抄錯;再herdr agent list看那位還在不在 - 舊頁殘留 → 照上面「開新頁、關舊頁」的順序處理,不要直接關舊頁(裡面可能有沒收完的產出)