小安 Agent（Xiaoan）

主维护仓库：An-an-525/An-Agent · 默认分支 main · 维护者 An-an-525

基于 OpenHanako fork 的通用桌面个人 Agent，运行时底座为 Pi SDK。本仓库是独立产品线的日常开发与发布入口，不接收上游 OpenHanako 自动更新。

不做 PPT 生成线。小安是左聊右看的 AI 副驾驶：对话、工具、记忆、书桌工作区。

维护定位

项	说明
Canonical 仓库	https://github.com/An-an-525/An-Agent
开发分支	main（已合并 xiaoan-console 排版与品牌化）
上游底座	OpenHanako — 仅作源码参考，手动 merge/cherry-pick
配置真源	shared/xiaoan-fork.json
本地数据	生产 ~/.hanako · 开发 HANA_HOME=~/.hanako-dev

新功能、UI、文档、插件改动 一律在本仓库 main 维护；见 docs/FORK-CONFIG.md。

与上游关系

项	说明
上游	liliMozi/openhanako（Apache 2.0）
底座	Pi coding-agent
定制	plugins/xiaoan-core/ — think / brief / ask + 默认「小安」Agent 模板
设计文档	docs/agent-design/

详见 UPSTREAM-NOTICE.md 与 docs/FORK-CONFIG.md。

建议阅读顺序： docs/CODEMAP.md（导航）→ docs/HANAKO-INTERNALIZATION.md（内化底座）→ docs/LOCAL-DEV.md（跑起来）→ docs/XIAOAN-LAYOUT.md（控制台排版）→ docs/agent-design/XIAOAN-METHODOLOGY.md（小安层）。

本地看桌面端 → docs/LOCAL-DEV.md

功能（继承自 OpenHanako）

• 记忆、人格、书桌（工作区）、多 Agent
• Skills、插件、沙盒、Cron / 心跳
• Electron + React 桌面端

开发

需要 Node.js 24.x（与上游一致）。

npm install
npm start              # Electron 桌面端
npm run start:vite     # 开发模式（HMR）
npm test
npm run typecheck

小安定制层（P1）

• 品牌：小安 / Xiaoan（xiaoan-console 主题，樱花粉控制台 UI）
• 排版：desktop/src/design/xiaoan-layout.css — 见 docs/XIAOAN-LAYOUT.md
• 插件：plugins/xiaoan-core/（think / brief / ask / plan / confirm）
• Agent 模板：新建助手时可选「小安」
• 本地开发上下文包：docs/XIAOAN-LOCAL-DEV-CONTEXT.md

文档

从 docs/README.md 进入 — 按角色、任务、层次选读。

类型	文档
跑起来	docs/LOCAL-DEV.md
贡献与工程规范	CONTRIBUTING.md · docs/XIAOAN-ENGINEERING-METHODOLOGY.md
维护者	docs/MAINTAINER.md · docs/FORK-CONFIG.md
代码地图	docs/CODEMAP.md
控制台排版	docs/XIAOAN-LAYOUT.md
Agent 方法论	docs/agent-design/XIAOAN-METHODOLOGY.md
Cursor 上下文	docs/XIAOAN-LOCAL-DEV-CONTEXT.md

路线图

见 docs/agent-design/XIAOAN-ABSORB-ROADMAP.md 与 XIAOAN-SHELL-STRATEGY.md。

许可证

应用主体遵循上游 Apache License 2.0。定制层与文档另附 MIT 说明见 UPSTREAM-NOTICE.md。