penecho/penecho

PenEcho – AI 增強的視覺畫布

是什麼 – PenEcho 是一個開源的桌面/網頁應用程式，將巨大的無限尺寸繪圖區域（20,000 × 20,000 幀）轉換為互動式工作區，您可以在其中書寫、繪圖、貼上文件，並讓大型語言模型（LLM）在筆跡旁直接生成解釋、公式、圖表、圖示或其他視覺元件。AI 以「代理」形式運作，能讀取檔案、瀏覽網頁，並在不離開畫布的情況下迭代優化視覺輸出。

核心功能

• PenEcho 代理 – 多階段工作流程，可匯入 PDF、Word、PowerPoint、Excel、影像、程式碼或只讀資料夾，結合網路搜尋與目前畫布內容，產生並編輯視覺草稿。
• 視覺探索器 – 將密集的研究資料轉換為響應式、分層的視覺地圖，包含概覽、細節與證據面板，減少複製貼上與工具切換。
• 空間式 AI 互動 – 您可在畫布任意位置寫下問題、方程式或圖示；模型讀取周圍標記後，在其旁邊回應。
• 可編輯的 AI 元件 – 生成的 HTML、專業圖表、動畫或即時資料外掛以可移動物件形式出現，可透過增量差異編輯在原地優化。
• 多模型後端支援 – 支援最多十個連接（Kimi、Claude、OpenAI、DeepSeek、GLM 等），每個請求可選擇不同模型；設定透過 penecho configure 或簡單的 env 檔案完成。
• PenEcho 雲端服務（可選） – 在裝置間同步私人專案，分享公開的「作品」（稱為 Echoes），並取得遠端 LAN 存取中繼，同時將 API 金鑰保留在主機上。
• 安全優先設計 – API 金鑰從不離開伺服器程序；每個會話由六位數 LAN 代碼保護；除非使用者選擇啟用雲端同步，否則所有資料均留在使用者裝置上。

如何運作

1. 瀏覽器僅傳送使用者選擇的筆跡裁剪區域及幾何元資料。
2. 本地 Node.js 伺服器驗證請求，轉送至所選執行器（API 呼叫或本地 CLI），接收結構化草稿。
3. 草稿以可移動元件形式返回；使用者可在其變為永久筆跡前接受、捨棄或編輯。
4. 畫布將筆跡儲存為稀疏的 512 × 512 瓦片，因此即使邏輯畫布龐大，仍保持輕量。

快速上手

• 桌面二進位檔 – 從 GitHub Releases 頁面下載最新版本並執行。
• npm 安裝 – npm install -g penecho，然後執行 penecho configure 選擇模型來源（API 金鑰或已認證的 Kimi/Codex/Claude CLI）。使用 penecho 啟動，並開啟 http://localhost:3888。
• 從原始碼建置 – git clone https://github.com/penecho/penecho.git && npm install && npm start。

模型推薦（來自 README） – Claude Opus 4.8/5.0、Kimi K3、gpt-5.6 系列、DeepSeek-v4-flash-vision-exp、GLM-5.3-flash 均針對畫布工作負載進行優化。README 中的表格列出努力等級（低/中/高/X高）與典型 Token 使用量。

授權 – AGPL-v3（閉源分發可選商業授權）。所有程式碼、資產及名稱/Logo 均受專案商標與貢獻者協議保護。

適用對象 – 研究人員、教育工作者、工程師，或任何希望在不頻繁切換聊天視窗與繪圖工具的情況下，融合手寫筆記與 AI 生成視覺內容的人。