JasonLiu0826/ackem

Ack — Windows 的本地優先 AI 夥伴

簡介 – Ackem (Autonomous Companion Keeping Emotional Memory) 是一款使用 Electron 建構的 Windows 專用桌面應用程式。它讓您可以連接任何相容 OpenAI 的語言模型（如 OpenAI 或 DeepSeek 等雲端服務，或 Ollama/LM Studio 等本地伺服器），並提供一個持久的「朋友」，可以聊天、記憶過去的對話、追蹤簡單的情緒/關係狀態，甚至以系統匣圖示或可選的桌面寵物形式出現。

主要功能

• 聊天 – 將提示詞發送給已設定的 LLM 並在聊天視窗中顯示回覆。
• 結構化記憶 – 每次對話都會儲存在本地，透過嵌入 (embeddings) 進行索引、可搜尋，並可視覺化為時間軸/知識圖譜。您也可以匯入純文字 (.txt) 或 Markdown (.md) 檔案作為長期上下文。
• 夥伴狀態 – 應用程式會維護信任度、心情、關係階段和日記。個性預設和主動訊息讓「夥伴」感覺更有生命力。
• 桌面呈現 – 系統匣圖示、可選的幾何球體/LIVE2D 寵物，以及可選的語音 STT/TTS。
• 擴充功能 – 擴充中心 (Extension Center) 讓開發者可以新增插件（例如：微信橋接、遊戲模式整合、自訂技能）。
• 本地優先資料 – 所有聊天記錄、記憶、API 金鑰和設定都存放在 Ackem.exe 旁邊的 data/ 資料夾中。發布的壓縮檔不包含任何使用者資料，也不會傳送遙測資料。

如何開始（終端使用者）

1. 從 GitHub 或 Gitee 發布頁面下載 green 發布壓縮檔。
2. 將壓縮檔解壓縮到 SSD 上的資料夾（請不要直接在壓縮檔內執行）。
3. 執行 Ackem.exe（或提供的批次檔）。首次啟動會解壓縮嵌入模型，需時約 10-30 秒。
4. 同意隱私/合規性畫面。
5. 開啟 Settings → Model & API 並輸入您想使用的 LLM 的基礎 URL、模型 ID 和 API 金鑰。
6. 開始聊天；透過記憶檢視匯入任何 .txt/.md 檔案，賦予夥伴長期知識。

開發者筆記

• 本專案為 Electron 應用程式，使用基於 Vite 的渲染器。開發環境需要 Windows 上的 Node 20+。
• 核心指令：npm run dev（以開發模式執行應用程式）、npm run build（編譯）、npm run dist:green（產生可攜式版本）、npm run dist:setup（NSIS 安裝程式）。
• 架構分為七個邏輯系統（大腦、心臟、嘴巴、神經、擴充、時間等），詳細記錄在 docs/developer/architecture/ 中。
• 程式碼庫包含 TypeScript 型別檢查、單元測試和基於 SQLite 的資料層。

隱私與資料處理

• 官方發布版本不包含任何使用者資料。首次執行後，所有內容都存放在本地的 data/ 目錄中。
• API 金鑰僅儲存在本地設定檔中；不會向 Ackem 伺服器傳送任何遙測資料。
• 儲存庫包含詳細的隱私權政策 (docs/privacy-and-data.md)。

狀態 – 由單一維護者積極測試中。崩潰和延遲報告較少但仍可能發生；鼓勵使用者針對意外行為開啟 Issue。

授權 – AGPL-3.0。允許個人、研究和開源整合使用。商業或閉源 SaaS 使用需要單獨的商業授權（請參閱 README 中的聯絡資訊）。

---

以上所有資訊均直接取自儲存庫的 README 及連結文件。