Ackem 是一个基于 Electron + TypeScript 的 Windows 本地优先 AI 桌面陪伴应用。它不是普通网页聊天框，而是一个可常驻桌面和系统托盘的 AI 伴侣，支持接入 OpenAI 兼容接口，包括 OpenAI、DeepSeek、Ollama、LM Studio 等。项目重点在于本地保存聊天、记忆、日记、关系状态和 API 配置，提供长期记忆、情绪状态、关系阶段、人格预设、桌面宠物、扩展中心、可选语音和微信桥接等能力。当前版本为 v1.0.0，README 明确说明仍处于活跃测试阶段，由个人维护，可能存在粗糙体验或意外行为。
适用领域
AI 桌面应用 / 本地优先软件 / AI 伴侣 / 情感陪伴 / 大模型应用开发 / Electron 应用 / 个人知识记忆系统 / RAG / 向量检索 / 桌面宠物 / OpenAI 兼容 API 客户端 / 本地 LLM 集成
配置难度
中等偏高。普通用户下载绿色版并配置模型即可使用，难度约为 3/5；开发者若要理解或二次开发，需要掌握 Electron、TypeScript、IPC、LLM API、SQLite、向量检索、记忆系统和插件机制，难度约为 4/5。
商业价值
该项目具有较高的产品原型和技术参考价值，适合用于探索本地优先 AI 伴侣、AI 桌面助手、个人记忆系统、AI 桌宠和本地 LLM 应用。对个人开发者和小团队而言，它可以作为完整的 Electron + LLM 应用案例，帮助快速理解长期记忆、情绪关系状态、扩展系统和本地数据治理。商业化方面，AI 伴侣和隐私优先的个人 AI 助手有明确市场潜力，但需要重点解决稳定性、跨平台、合规、安全、模型成本、用户留存和 AGPL-3.0 授权限制等问题。
01
技术亮点
- 本地优先设计：个人数据默认保存在本机 data/ 目录，不默认上传到 Ackem 服务器。
- 支持 OpenAI 兼容接口：可接入 DeepSeek、OpenAI、Ollama、LM Studio 等。
- 具有长期记忆能力：对话可转化为可搜索记忆，并支持导入 .txt / .md 作为长期上下文。
- 不只是聊天窗口：支持系统托盘、桌面宠物、关系状态、情绪系统、日记和主动消息。
- 文档较完善：包含中英文 README、架构文档、扩展协议、数据目录、隐私、安全、本地模型、Windows 分发等说明。
- 架构划分清晰：README 中定义了 Overall、Brain、Heart、Mouth、Neural、Extension、Time、Data Layer、IPC API 等系统。
- 适合学习 AI 桌面应用架构：涵盖 Electron、IPC、LLM 调用、向量检索、记忆管理、SQLite 数据层和扩展系统。
- 绿色版对普通用户友好：下载解压即可运行，无需 Node.js。
- 国内用户友好：提供 Gitee 镜像和中文文档。
02
目标用户
- 希望拥有本地 AI 桌面伴侣的 Windows 用户
- 重视隐私、不希望聊天和记忆默认上传到第三方服务器的用户
- 使用 DeepSeek、OpenAI、Ollama、LM Studio 等模型服务的 AI 爱好者
- 想研究 AI 长期记忆、情绪状态、关系系统的开发者
- Electron / TypeScript 桌面应用开发者
- 希望构建 AI 助手、AI 伴侣、桌宠或本地知识库产品的团队
- 需要中文文档和可本地运行 AI 应用样例的国内开发者
03
配置要求
- 操作系统：Windows 10/11 64 位。
- 模型要求：需要一个 OpenAI 兼容的 LLM API，或者本地运行 Ollama / LM Studio 等模型服务。
- 核心配置：Base URL、API Key、Model ID。
- 本地模型场景：需要先启动本地模型服务，并确保 Ackem 能访问对应 API 地址。
- 存储位置：绿色版会在 Ackem.exe 旁边创建 data/ 目录，用于保存聊天、记忆、日记等个人数据。
- 隐私注意：不要在重新打包或分享软件时包含自己的 data/ 目录，因为其中可能包含聊天记录、长期记忆和 API Key。
- 开发环境：Windows 10/11、Node.js 20+、npm。
- 开发运行注意：渲染层依赖 window.ackem preload IPC，不应只在浏览器中打开 Vite URL，应使用 npm run dev 启动 Electron 应用。
04
适用场景
- 作为 Windows 桌面 AI 伴侣，进行日常聊天、情绪陪伴和长期互动
- 接入云端或本地大模型，统一管理 Base URL、API Key 和 Model ID
- 将对话内容沉淀为可搜索的长期记忆，并通过时间线、知识关联等方式回顾
- 导入 .txt 或 .md 文件作为长期上下文，让 AI 记住个人资料、笔记或背景信息
- 使用系统托盘和桌面宠物模式，让 AI 伴侣常驻桌面
- 研究 AI 角色关系系统，包括信任、心情、关系阶段、人格预设、日记和主动消息
- 测试本地优先的数据目录设计，包括聊天、记忆、日记、密钥和配置的本地存储
- 作为 Electron + LLM + SQLite + IPC 架构的学习项目
- 扩展插件、技能、游戏模式或 OpenForU 工作区等实验能力
05
部署与配置
- 普通用户无需安装 Node.js，推荐从 GitHub Releases 或 Gitee Releases 下载 Ackem-v1.0.0-win-x64.zip。
- 将 zip 完整解压到 SSD 路径，不要直接在压缩包中运行。
- 运行 Ackem.exe 或 启动 Ackem.bat。
- 首次启动会解压本地 embedding 模型，通常需要约 10 到 30 秒。
- 首次运行时阅读并接受隐私和合规条款。
- 进入 Settings → Model & API，配置 Base URL、API Key 和 Model ID。
- 发送第一条消息开始聊天，也可以导入 .txt 或 .md 文件作为长期记忆。
- 开发者运行方式：在 Windows 10/11 下安装 Node.js 20+，执行 npm install 或 npm ci，然后运行 npm run dev。
- 构建方式：npm run build 生成 out/，npm run dist:green 生成绿色版，npm run dist:setup 可生成 NSIS 安装包。
06
风险与注意事项
- 项目仍处于 active testing 阶段，README 明确提示可能遇到意外行为或粗糙体验。
- 个人维护项目，长期维护稳定性、Issue 响应速度和测试覆盖可能有限。
- GitHub 元数据中 license 为 NOASSERTION，但 README 声称 AGPL-3.0，需要实际检查 LICENSE 文件确认。
- AGPL-3.0 对商业闭源集成有较强传染性要求，企业使用、二次开发或 SaaS 化需要谨慎评估合规风险。
- Windows-only 定位明显，跨平台用户或 macOS/Linux 用户不适合直接使用。
- 需要用户自行配置模型 API，对于非技术用户有一定门槛。
- API Key 和个人数据保存在本地，如果用户误分享 data/ 或配置目录，可能泄露隐私和密钥。
- 涉及情感陪伴、成人模式、微信桥接、主动消息等敏感能力，产品化时需要额外关注伦理、合规和内容安全。
- 本地 embedding 模型、记忆检索和 Electron 运行可能带来一定磁盘、内存和性能开销。
- 桌面宠物、扩展、游戏模式、OpenForU 等部分能力可能仍为实验性质，不宜直接假设生产可用。
2026-07-04
第16名
新收录 · github_search
2026-07-03
第27名
新收录 · github_search
2026-07-02
第29名
新收录 · github_search
