歡迎使用 Heddle
Heddle 是開源、本機優先的程式開發代理框架、執行環境與終端機優先工作區，專為可追蹤的程式碼庫工作而設計。
它適合代理需要檢查真實程式碼庫、進行有邊界的修改、驗證結果、跨工作階段保持連續性，並讓操作員能持續看見工作狀態的流程。Heddle 支援託管前沿模型、本地模型、自架 OpenAI-compatible 伺服器與託管閘道，會把工作區本地狀態存放在 .heddle/，並提供可審查的差異、命令、核准與追蹤路徑。
在 Heddle v3 版本線中，heddle 與 heddle chat 會開啟支援 API-backed 的終端機 UI。終端機、瀏覽器與行動端客戶端共享同一條本機控制平面路徑，用於工作階段、核准、即時狀態、工作區審查、記憶與心跳任務。
核心概念
工作區
Heddle 正在操作的本機專案。預設會使用目前目錄；也可以透過 --cwd 指定其他路徑。
.heddle/
工作區本地狀態目錄，用來存放已儲存工作階段、追蹤紀錄、核准、記憶筆記、上傳內容、心跳任務與執行紀錄。
工作階段
保存下來的多輪對話，包含模型設定、推理強度、壓縮後歷史、排隊提示與追蹤連結。
追蹤紀錄
可審查的事件紀錄，包含工具呼叫、命令證據、核准、檔案差異與代理回合的執行事件。
核准
操作員對敏感動作的確認，例如檔案修改或 shell 命令。Heddle 會讓核准狀態保持可見，而不是把自動化藏起來。
記憶
以目錄管理的 Markdown 筆記，用來保存可重用的專案知識、偏好、工作流程、操作慣例與目前狀態。
控制平面
本機瀏覽器 UI 與 API 伺服器，讓終端機、瀏覽器、行動端客戶端共享工作階段、審查、任務與工作區狀態。
心跳任務
可排程或重複執行的持久代理任務，具備有界執行、檢查點、執行歷史與是否繼續的決策。
Heddle 適合誰
Heddle 適合想要 AI 程式開發助理能在真實程式碼庫裡工作、保留本機狀態、學習可重用專案知識，並留下審查軌跡的開發者。它適合程式碼庫導覽、實作任務、文件修改、測試與建置驗證、跨裝置監督，以及週期性維護流程。
Heddle 不只是無狀態提示包裝器。它的產品形態是本機優先的程式開發代理框架與執行環境：工具、核准、追蹤紀錄、工作階段、記憶與瀏覽器監督都保持明確，讓操作員能理解改了什麼以及為什麼。