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 及链接文档。