OpenHanako

一个具备记忆、个性和自主能力的个人 AI Agent —— 基于 Electron 构建。

中文版

---

什么是 Hanako

OpenHanako 是一个比传统编程 Agent 更易于使用的个人 AI Agent。它拥有记忆和个性，并能自主行动。你可以在电脑上运行多个 Agent 协同工作。

作为助手，它很温柔：没有复杂的配置文件，没有晦涩的专业术语。Hanako 的设计初衷不仅是为了程序员，而是为了所有在电脑前工作的人。 作为工具，它很强大：它能记住你说过的所有话，操作你的电脑、浏览网页、搜索信息、读写文件、执行代码、管理日程，甚至能自主学习新技能。

功能特性

记忆 (Memory) —— 定制的记忆系统，既能保持对近期事件的敏锐度，又能让陈旧记忆自然淡化。

个性 (Personality) —— 它不是一个通用的“AI 助手”。每个 Agent 通过个性模板拥有自己的语调和行为模式。Agent 是独立的文件夹，易于备份和管理。

工具 (Tools) —— 读写文件、运行终端命令、浏览网页、搜索互联网、截屏、在画布上绘图、执行 JavaScript。涵盖了绝大多数日常工作场景。

技能 (Skills) —— 内置对社区技能生态系统的兼容。Agent 还可以安装来自 GitHub 的技能或编写自己的技能。默认开启严格的安全审查。

多 Agent (Multi-Agent) —— 创建多个 Agent，每个都拥有独立的记忆、个性和定时任务。Agent 可以通过群聊协作，或互相委托任务。

桌面 (Desk) —— 每个 Agent 都有一个用于存放文件和笔记（“笺”）的桌面。支持拖放、文件预览，并作为你与 Agent 之间的异步协作空间。

定时与心跳 (Cron & Heartbeat) —— Agent 可以运行定时任务，并定期检查桌面上的文件变更。即使你不在电脑前，它们也能自主工作。

沙盒 (Sandbox) —— 双层隔离：应用层的 PathGuard（具备四个访问层级）+ 操作系统级的沙盒（macOS Seatbelt / Linux Bubblewrap）。

插件 (Plugins) —— 具有“约定优先”架构的可扩展插件系统。通过拖放即可安装社区插件。插件可以贡献工具、技能、命令、Agent 模板、HTTP 路由和 LLM 提供程序。路由可以直接访问核心服务（PluginContext 注入），并可通过 Session Bus 与 Agent 会话交互（发送消息、获取历史记录、列出会话）。双层权限模型（受限/完全访问）确保系统安全。

多平台桥接 (Multi-Platform Bridge) —— 单个 Agent 可以同时连接 Telegram、飞书、QQ 和微信机器人。从任何平台发起对话，并远程操作你的电脑。

国际化 (i18n) —— 界面支持 5 种语言：简体中文、英语、日语、韩语和繁体中文。

截图

快速开始

下载

macOS (Apple Silicon / Intel): 从 Releases 下载最新的 .dmg 文件。

该应用已通过 Apple Developer ID 签名并公证。macOS 应允许直接启动。

Windows: 从 Releases 下载最新的 .exe 安装程序。

Windows SmartScreen 提示: 安装程序尚未进行代码签名。首次运行时，Windows Defender SmartScreen 可能会弹出警告。请点击 更多信息 (More info) → 仍要运行 (Run anyway)。这是未签名构建的预期表现。

目前正在规划 Linux 构建版本。

首次运行

首次启动时，向导将引导你进行设置：选择语言、输入名称、连接模型提供程序（API Key + Base URL），并选择三个模型 —— 对话模型（主要对话）、通用模型（用于总结等轻量级任务）和 通用大模型（用于记忆总结和深度分析）。Hanako 使用兼容 OpenAI 的协议，因此任何支持该协议的提供商均可使用（如 OpenAI、DeepSeek、Qwen、通过 Ollama 运行的本地模型等）。

架构

core/           引擎编排 + 管理器 (包括 PluginManager)
lib/            核心库 (记忆、工具、沙盒、桥接适配器)
server/         Hono HTTP + WebSocket 服务器 (独立的 Node.js 进程)
hub/            调度器、ChannelRouter、EventBus
desktop/        Electron 应用 + React 前端
plugins/        内置系统插件 (打包在应用内)
tests/          Vitest 测试套件
skills2set/     内置技能定义
scripts/        构建工具 (服务器打包器、启动器、签名)

引擎层协调多个管理器（Agent、Session、Model、Preferences、Skill、Channel、BridgeSession、Plugin 等），并通过统一的门面（Facade）模式暴露它们。Hub 负责处理后台任务（心跳、定时任务、频道路由、Agent 消息传递、私聊路由），独立于当前的聊天会话。