Shell Completion zh TW

Shell Completion

English · 繁體中文

taiga completion bash
taiga completion zsh
taiga completion fish
taiga completion powershell

把輸出寫進對應 shell 的 completion 目錄即可啟用；具體路徑見 INSTALL.zh-TW.md。

動態候選

補全不只涵蓋子指令與旗標，也會向 Taiga 查詢實際資料：專案、工作項目 ref、status、成員、Sprint 與 Issue metadata。查詢有 2 秒 timeout，逾時就安靜地退回靜態補全，不會讓你的 shell 卡住。

Metadata 快取

成功的查詢結果會以 0600 權限快取：

• 5 分鐘內視為新鮮，直接使用。
• 超過 5 分鐘會重新查詢；若查詢失敗，可以使用 24 小時內的過期資料（stale-on-error），讓離線或 server 暫時不可用時補全仍然堪用。
• 超過 24 小時的項目會被丟棄並在下次寫入時清理。

快取以 profile、API URL、專案與資料類型的雜湊為 key，因此不同站台與專案不會互相污染。快取中 不儲存 token，而且快取檔損壞時只會讓補全失效，不會影響 shell 或其他指令。