内容
# ARONA Agent
[English](https://github.com/SRC114514/arona-agent/blob/main/README_en.md)
> 谁不想在电脑上养一只 ~~香香软软~~ 可可爱爱的阿洛娜呢？
基于 [Pi SDK](https://www.npmjs.com/package/@earendil-works/pi-coding-agent) 构建的终端对话式 AI Agent，集成 Computer Use、TTS / STT、桌面宠物与持久记忆。
---
## 安装
```bash
npm i -g arona-agent
# 首次运行自动进入初始化向导
arona
# 或着如果想先上手玩玩
npx arona-agent
```
---
## 扩展指令
```bash
# 重新初始化（可选）
arona setup
# 更新
npm u -g arona-agent
# 禁用TTS+STT并启动
arona --no-voice
# 以命令行启动
arona --cli
# 补全/重新克隆某角色音色
arona voice add [<角色名>] # 不带角色名则进入 TUI 选择未补全的角色
# 环境自检
arona doctor
```
---
## 核心特性
- **Computer Use**：基于 [cua](https://pypi.org/project/cua/) 。
- **语音**：非流式 TTS + STT。
- **桌宠**：透明无边框置顶 Electron 窗口 + 情绪切换 + 瞳孔跟随鼠标 + 头部摇动摸头彩蛋 + 全屏点击/拖尾特效；
- **多角色群聊**：主 Agent 单窗口、子 Agent 同屏；每轮主 Agent 回复完后子 Agent 依次接话。
---
## 环境要求
- **Node.js >= 22.19.0**
- **Python 3.12 / 3.13**
---
## 配置
全部配置写在 JSON 文件 `~/.arona/settings.json`，大部分由 `arona setup` 交互式生成，少数高级参数需自行填充。
| 字段 | 说明 | 默认值 |
|---|---|---|
| `apiKey` | API Key | — |
| `apiBaseUrl` | API地址 | — |
| `model` | 模型名 | `openai/gpt-4o` |
| `thinkingLevel` | 思考等级 | `medium` |
| `contextWindow` | 上下文窗口 | `1000000` |
| `language` | 界面语言（`auto`/`zh`/`en`） | `auto` |
| `mainAgent` | 主 Agent（`arona`/`plana`） | `arona` |
| `subAgents` | 启用的子 Agent 数组 | `[]` |
| `ttsEnabled` | 启用 TTS | `true` |
| `sttEnabled` | 启用 STT | `true` |
| `workspaceId` | 阿里云百炼业务空间 ID | — |
| `ttsApiKey` | 百炼 API Key | — |
| `ttsModel` | TTS 模型 | `qwen-audio-3.0-tts-plus` |
| `ttsProvider` | TTS 后端（`aliyun`/`gpt-sovits`） | `aliyun` |
| `ttsConfig` | 各 Provider 配置 | `{}` |
| `sttApiKey` | 百炼 API Key | — |
| `sttModel` | STT 模型 | `qwen-audio-3.0-asr-flash-streaming` |
| `sttFormat` | STT 音频格式 | `pcm` |
| `sttSampleRate` | STT 采样率 | `16000` |
| `cuaApiKey` | Cua API Key | — |
| `tavilyApiKey` | Tavily API Key | — |
| `pythonPath` | Python 路径 | `python3` |
| `autoLoadSkills` | 启动时自动从 `~/.agents` 补全缺失的Skill | `true` |
| `CLIEnabled` | 裸 `arona` 启动时进入命令行 | `false` |
| `mcpServers` | MCP 服务器 JSON | `{}` |
模型名前缀自动检测：若 `model` 不含 `/`，按模型名前缀或 `apiBaseUrl` 域名自动补 `provider/`。
---
## 数据路径（`~/.arona/`）
| 路径 | 说明 |
|---|---|
| `settings.json` | 本地总配置文件，字段见 [配置](#配置) |
| `voices.json` | TTS音色配置文件 |
| `MEMORY.md` | 持久记忆 |
| `sessions/` | 已保存会话 |
| `skills/` | 自定义 Skill |
| `undo/` | undo/redo 快照 |
| `pet.json` | 桌宠窗口位置持久化 |
---
## 桌宠与 STT 热键
- **桌宠**：透明无边框置顶窗口；拖动窗口可移动，在头部区域左右摇晃可触发"摸头"彩蛋；点击/拖拽还会触发特效
- **STT 热键**：macOS 为右 Cmd 键，Windows/Linux 为右 Ctrl 键，长按 ≥ 2 秒触发一次性录音。
> MacOS下，全局键盘监听需「系统设置 → 隐私与安全性 → 辅助功能」为Python授权；
> Computer Use 截图需授予终端「屏幕录制」权限。
---
## 斜杠命令
| 分类 | 命令 |
|---|---|
| 会话 | `/new` `/clear` · `/resume` · `/exit` · `/export` · `/compact` |
| 显示 | `/thinking` · `/details` |
| 语音 | `/tts` · `/stt` |
| 扩展 | `/skill`· `/mcp` |
| 其他 | `/change-agent`· `/undo` · `/redo` · `/help` |
---
## 扩展
- **自定义 Skill**：在 `~/.arona/skills/<名称>/` 放 `SKILL.md`，用 `/skill <名称>` 调用。
- **MCP 服务器**：在 `~/.arona/settings.json` 的 `mcpServers` 字段配置 JSON，工具自动注册。
---
## 都看到这里了
> 窝不是萝莉控别电我啊啊啊！
> 绝对不是因为 ~~她是我妈妈~~ 才做这个的
---
## License
本项目基于 [MIT License](LICENSE) 开源。
---
## 版权声明
本项目为独立开发的非官方项目，与Nexon Games Co., Ltd.、YOSTAR LIMITED及《蔚蓝档案》游戏官方团队无任何直接关联、授权关系。
- 项目主体代码采用MIT许可证发布，但本项目未就assets/blue-archive/目录下的所有文件（涉及《蔚蓝档案》游戏知识产权的内容，包括但不限于角色立绘、美术素材、音频文件、文本内容及相关衍生素材）向本项目/任何第三方授予任何许可，也不对其合法性、可用性做任何担保。
- 此类内容的使用、复制、分发需严格遵循Nexon Games Co., Ltd.及YOSTAR LIMITED发布的 [《蔚蓝档案官方同人创作守则》](https://weibo.com/ttarticle/p/show?id=2309404920534935929304) 及适用法律法规
- 本项目不附带此类第三方文件的获取渠道，用户需自行从权利方官方渠道获取合法副本，并自行承担使用责任；
- 本项目不得用于影响版权方权益之分发，否则自行承担相关侵权责任。
此类内容的知识产权归Nexon Games Co., Ltd.及YOSTAR LIMITED所有，其使用、复制及分发规则应严格遵循上述权利方的官方条款及适用法律法规。
若相关权利人认为本声明或项目使用方式存在不当，可与我联系，将在核实后第一时间调整或移除相关内容。
MCP 市场