# openhanako **Repository Path**: rockjohnson/openhanako ## Basic Information - **Project Name**: openhanako - **Description**: openhanako国内加速 - **Primary Language**: Unknown - **License**: Apache-2.0 - **Default Branch**: main - **Homepage**: None - **GVP Project**: No ## Statistics - **Stars**: 0 - **Forks**: 1 - **Created**: 2026-04-08 - **Last Updated**: 2026-04-08 ## Categories & Tags **Categories**: Uncategorized **Tags**: None ## README [English](README.md)

OpenHanako Banner

Hanako

OpenHanako

一个有记忆、有灵魂的私人 AI 助理

[![License](https://img.shields.io/badge/License-Apache%202.0-blue.svg)](LICENSE) [![Platform](https://img.shields.io/badge/platform-macOS%20%7C%20Windows-lightgrey.svg)](https://github.com/liliMozi/openhanako/releases) --- ## Hanako 是什么 OpenHanako 是一个更加易用的 AI agent，有记忆，有性格，会主动行动，还能多 Agent 在你的电脑上一同工作。 作为助手，Ta 是温柔的：不需要写复杂的配置，不需要理解晦涩的术语。Hanako 它不只面向 coder ，而是为每一个坐在电脑前工作的人设计的助手。 作为工具，Ta 是强大的：记住你说过的每一件事，操作你的电脑，浏览网页，搜索信息，读写文件，执行代码，管理日程，还能自主学习新技能。 我开这个项目的初衷是：弥合绝大多数人和 AI Agent 之间的缝隙，让强大的 Agent 能力不再只局限于命令行里。于是我做了比传统 Coding Agent 更多一些的优化：一方面是强化 Agent「像人」的属性，是你和他们沟通更自然；另一方面，因为我本职也是一介文员，所以我也针对日常办公场景做了很多工具性和流程性的优化，敬请探索。 此外，Hanako 有比较完备的图形页面。 如果你用过 claude code、codex、Manus 等 CLI 或是图形化的 Agent，你会在 Hanako 这里找到熟悉又新奇的感觉。 ## 功能特性 **记忆** — 结合主流的记忆方案，自己又发挥了一下，做了个记忆系统，近期的事情记得非常牢固，但目前确实有待优化。 **人格** — 不是千篇一律的"AI 助手"。通过人格模板和自定义人格文件塑造独特的性格，每个 Agent 都有自己的说话方式和行为逻辑，Agent 之间分离做得很好，备份方便，Agent 就是文件夹，后续还会添加备份功能。 **工具** — 读写文件、执行终端命令、浏览网页、搜索互联网、截图、画布绘图、JavaScript 执行。能力覆盖日常办公的绝大多数场景。 **SKILLS 支持** — 内置兼容庞大 SKILLS 社区生态，之外，我也做了一些主动的优化：有时候干活之前，Agent 会从 GitHub 安装社区技能，Agent 也可以自己编写并学会新技能，有比较不错的主动性。当然，默认情况给 Agent 做了比较严格的 SKILLS 审核，如果发现 SKILLS 装不上可以自行关闭。 **多 Agent** — 创建多个 Agent，各自有独立的记忆、人格和定时任务。Agent 之间可以通过频道群聊协作，也可以互相委派任务。 **书桌** — 每个 Agent 都有自己的书桌，可以放文件、写笺（类似便签，Agent 会主动读取并执行）。支持拖拽操作，文件预览，是你和 Agent 之间的异步协作空间。 **定时任务与心跳** — Agent 可以设置定时任务（Cron），也会定期巡检书桌上的文件变化。你不在的时候，Ta 也能按计划自主工作。 **安全沙盒** — 双层隔离：应用层 PathGuard 四级访问控制 + 操作系统级沙盒（macOS Seatbelt / Linux Bubblewrap）。Agent 的权限在你的掌控之中。平时只能访问工作目录和一些用户文件，如果你想放开权限，可以点五下关于里面的 HANAKO 图表。 **多平台接入** — 同一个 Agent 可以同时接入 Telegram、飞书机器人、QQ机器人，在任何平台和 Ta 对话，可以远程操作电脑。 ## 截图

Hanako 主界面

## 快速开始 ### 下载安装 **macOS (Apple Silicon)**：从 [Releases](https://github.com/liliMozi/openhanako/releases) 下载最新 `.dmg`。 > **macOS 安全提示：** 应用尚未使用 Apple Developer ID 签名。首次打开时 macOS 可能会拦截，右键点击应用 → 选择**打开** → 在弹窗中点击**打开**即可，只需操作一次。 **Windows**：从 [Releases](https://github.com/liliMozi/openhanako/releases) 下载最新 `.exe` 安装包。 > **Windows SmartScreen 提示：** 安装包暂未经过代码签名，首次运行时 Windows Defender SmartScreen 可能会拦截，点击**更多信息** → **仍要运行**即可，未签名版本的正常现象。 Linux 版本计划中。 ### 首次运行 首次启动时，引导向导会带你完成配置：选择语言、输入你的名字、连接模型提供商（API key + base URL），并选择三个模型：**对话模型**（主对话）、**小工具模型**（摘要等轻量任务）、**大工具模型**（记忆编译和深度分析）。Hanako 使用 OpenAI 兼容协议，支持任意兼容的提供商（OpenAI、DeepSeek、通义千问、Ollama 本地模型等）。 目前也添加了 OpenAI 和 Minimax 的 Oauth 登录，鉴于 Anthropic 会有封号风险，所以暂时不提供。 ## 架构 ``` core/ 引擎编排层 + Manager lib/ 核心库（记忆、工具、沙盒、Bridge 适配器） server/ Fastify HTTP + WebSocket 服务 hub/ 调度器、频道路由、事件总线 desktop/ Electron 应用 + React 前端 tests/ Vitest 测试 skills2set/ 内置技能定义 ``` 引擎层协调五个 Manager（Agent、Session、Model、Preferences、Skill），通过统一的 facade 暴露。Hub 负责后台任务（心跳巡检、定时任务、频道路由），独立于当前聊天会话运行。Electron 主进程与服务端通过子进程 stdio 桥接通信。 ## 技术栈 | 层级 | 技术 | |------|------| | 桌面端 | Electron 38 | | 前端 | React 19 + Vite 7（从 vanilla JS 迁移中） | | 服务端 | Fastify 5 | | Agent 运行时 | [Pi SDK](https://github.com/nicepkg/pi) | | 数据库 | better-sqlite3（WAL 模式） | | 测试 | Vitest | ## 平台支持 | 平台 | 状态 | |------|------| | macOS (Apple Silicon) | 已支持 | | macOS (Intel) | 未测试，理论可用 | | Windows | Beta | | Linux | 计划中 | | 移动端 | 计划中 | ## 许可证 [Apache License 2.0](LICENSE) ## 链接 - [官网](https://openhanako.com) - [提交 Issue](https://github.com/liliMozi/openhanako/issues) - [安全页](https://github.com/liliMozi/openhanako/security) - [安全政策](SECURITY.md) - [贡献指南](CONTRIBUTING.md)