行业痛点切入
当前AI Agent领域的产品，大多面向开发者群体设计，功能入口集中在命令行终端，普通用户需要完成复杂的环境配置、理解晦涩的技术术语才能使用。多数产品仅支持单会话运行，AI无法跨会话保留用户的个性化信息与历史需求。
普通办公用户需要的AI工具，应当像身边的助理一样，能记住日常工作安排，能理解个人的沟通习惯，能直接操作电脑完成文件处理、信息搜索等具体事务，而不是仅能生成通用文本内容。
部分图形化AI Agent产品采用云服务架构，所有数据需要上传到第三方服务器，存在隐私泄露风险，同时功能定制成本高，用户无法自由调整AI的行为逻辑，也无法创建多个助理分工处理不同事务。
项目概述
该项目由一名文职工作者发起开发，核心定位是面向普通电脑用户的易用型AI Agent框架，支持全本地运行，提供完整图形操作界面。项目采用Apache 2.0开源许可证，兼容Windows、macOS、Linux三大桌面平台。
该项目的核心设计目标是降低普通用户使用AI Agent的门槛，在满足日常办公场景需求的基础上，强化AI的拟人化属性，让用户可以通过自然沟通完成工作，无需学习复杂的操作规则。
技术架构深度分析
该项目整体采用客户端-服务器架构，后端提供Agent运行核心能力与工具调用支持，前端基于Web技术实现完整图形界面，用户可以通过浏览器直接访问操作，也可以打包为桌面客户端运行。该架构兼顾了跨平台兼容性与访问灵活性，普通用户可以下载预编译客户端直接使用，开发者也可以基于核心服务二次开发。
核心模块分为四个独立部分：Agent运行管理模块、记忆存储模块、工具调用模块、技能生态模块。每个模块之间通过标准接口通信，降低了模块耦合度，方便后续功能扩展。Agent运行管理模块负责处理多Agent实例的隔离与调度，每个Agent拥有独立的运行空间，互不干扰。
记忆系统采用分层存储设计，结合主流向量数据库与会话快照存储方案，优先保留近期交互信息，保证AI能够准确回忆最近沟通的内容，降低长会话的信息丢失概率。该设计平衡了存储资源占用与记忆准确性，避免了全量存储导致的响应速度下降问题。
工具与技能系统采用松耦合设计，所有技能以独立文件形式存储，支持动态加载与卸载。平台提供技能审核机制，默认开启严格权限控制，避免未知技能执行危险操作，高级用户可以根据需求关闭审核，获得完整的技能自定义能力。
核心功能详解
分层记忆系统
该项目结合主流记忆方案设计了分层存储的记忆系统，对近期交互内容做了重点存储优化，保证AI对近期事务的记忆准确性。所有记忆与特定Agent绑定，不同Agent之间记忆完全隔离，不会出现信息混淆。该设计解决了长会话上下文丢失的问题，适合需要跨多天处理的连贯事务，不需要用户每次重复说明需求背景。
自定义人格塑造
该项目支持通过人格模板和自定义人格文件定义AI的说话方式与行为逻辑，每个Agent的人格独立存储，备份与迁移仅需复制对应文件夹。用户可以根据使用场景创建不同性格的助理，比如处理正式文档的严谨型助理，或是提供创意灵感的发散型助理。该设计打破了通用AI助手千篇一律的交互体验，满足不同用户的沟通习惯偏好。
全场景桌面工具支持
该项目内置覆盖日常办公需求的工具集，支持读写本地文件、执行终端命令、打开浏览器浏览网页、搜索互联网信息、截图与长截图分割、媒体文件预览等功能。支持通过server-first CLI连接后端服务，用户可以在终端查看Agent运行状态、列出历史会话、继续中断的对话任务。工具能力覆盖从信息收集到本地操作的完整流程，不需要用户在AI工具和本地应用之间反复切换。
自主技能学习与生态兼容
该项目兼容现有SKILLS社区生态，支持AI在执行任务前自动从代码仓库安装所需的社区技能，也允许AI自主编写新技能并导入运行。默认开启严格的技能审核机制，避免未知技能执行高危操作，用户可以根据自身需求关闭审核开关。该设计在保证安全性的前提下，赋予了AI扩展能力的自主性，能够应对不断变化的新需求。
角色卡与技能包导入导出
该项目支持将单个Agent导出为本地优先的角色卡压缩包，打包内容包含人格配置、头像、可选记忆与对应技能，也支持导入外部分享的角色卡。Skill Bundle提供独立的技能包管理能力，支持在技能管理页对技能分组、拖拽排序、批量启用，也可以将分组技能单独导出为压缩包。该设计方便用户迁移自己的配置，也降低了自定义配置的分享门槛。
多Agent协作体系
该项目支持创建多个独立Agent实例，每个实例拥有独立的记忆、人格与定时任务。支持创建公共频道，多个Agent可以在频道内群聊协作，也支持Agent之间互相委派任务处理。该设计适合处理复杂的复合型任务，不同Agent可以分工负责信息收集、内容编写、结果校验等不同环节，提升任务完成质量。
异步协作书桌空间
每个Agent配备独立的书桌空间，支持用户拖拽上传文件、添加文字便签，Agent会主动读取书桌内容并执行对应任务。支持监听工作台文件树变更，本地新增或修改文件后，Agent会自动获取最新内容。书桌作为用户与Agent的异步协作空间，适合用户提前整理任务材料，不需要实时在线等待AI响应。
全屏媒体查看器
聊天记录与书桌中的图片、SVG、视频文件支持点击打开全屏预览，预览采用暗色遮罩设计，避免其他元素干扰查看。支持滚轮缩放、拖拽平移，提供+、-、0键盘快捷键调整视图大小，支持左右箭头切换同一会话或同一目录下的相邻媒体文件。该优化提升了多媒体内容的查看体验，不需要下载文件到本地再打开查看。
项目地址：https://github.com/liliMozi/openhanako
⭐ Stars：6535
🔍 来源：GitHub
A personal AI agent with memory, personality, and autonomy.
微信扫一扫，打赏作者吧～
