概覽

一個面向本機儲存庫的生產級編碼 TUI。終端機是唯一的操作者介面。它執行串流模型與工具迴圈，支援 Plan/Work 模式、風險感知核准、自動上下文壓縮，操作者資料位於 ~/.crystal。crystal run 在沒有終端機的情況下執行一個任務；任何需要詢問操作者的操作都會被拒絕。

CrystalCode 使用 Crystal 程式庫。它不修改 Crystal。它不是 Crystal 的示範，也不是 Crystal 的替代品。

它能做什麼

在你希望代理檢查或修改的工作區中，CrystalCode 可以：

• 串流輸出帶工具呼叫的模型回合，並在回合執行時排入後續請求；
• 在限流、伺服器錯誤、逾時、網路故障和不完整串流上重試失敗的模型回合，並依退避等待；
• 使用 /model 切換已設定的提供商和模型；
• 在 Plan（內建讀取；不允許編輯、寫入或 bash）和 Work（編輯、寫入、shell）之間切換；
• 根據風險和權限，手動核准副作用、由審查模型核准，或完全放行；
• 當用量接近所選模型的視窗時壓縮對話上下文；
• 在 ~/.crystal 下持久化設定、權限和工作階段；
• 連接 DeepSeek 和 OpenAI 相容的 Chat Completions、OpenAI Responses 和 Anthropic Messages 端點，包括操作者加入的閘道。

內建工具和所有提供商配接器都透過同一張行程內外掛表註冊。操作者可以向 ~/.crystal/tools 和 <workspace>/.crystal/tools 下的工具集加入額外的目錄工具。操作者可以在 ~/.crystal/plugins 和 <workspace>/.crystal/plugins 下加入外掛。

尚未實作

以下計畫中的能力尚未在目前建置中實作：MCP 伺服器、作業系統沙箱、父/子代理、音訊和視訊輸入、非文字模型輸出、在 TUI 中編輯提供商定義，以及自動取得提供商模型清單。內建提供商協定包括 DeepSeek、OpenAI 相容 Chat Completions、OpenAI Responses、Anthropic Messages、Gemini 和 Ollama。外掛可以加入另一種協定。支援的模型和提供商可以使用影像輸入。