Skillget

arona-agent

agent
Security Audit
Fail
Health Warn
  • License — License: MIT
  • Description — Repository has a description
  • Active repo — Last push 0 days ago
  • Low visibility — Only 5 GitHub stars
Code Fail
  • process.env — Environment variable access in bin/arona.mjs
  • os.homedir — User home directory access in pet/main.cjs
  • process.env — Environment variable access in pet/main.cjs
  • fs module — File system access in pet/main.cjs
  • process.env — Environment variable access in pet/tools/gallery_capture.cjs
  • fs module — File system access in pet/tools/gallery_capture.cjs
  • process.env — Environment variable access in pet/tools/visual_test.cjs
  • fs module — File system access in pet/tools/visual_test.cjs
Permissions Pass
  • Permissions — No dangerous permissions requested

No AI report is available for this listing yet.

SUMMARY

Terminal AI Agent with desktop pet Arona — eye-tracking pupils, voice cloning, Computer Use, TTS/STT, MCP. Built on Pi SDK. TypeScript + Python + Electron.

README.md

ARONA Agent

English | 简体中文

License: MIT

谁不想在电脑上养一只 香香软软 可可爱爱的阿洛娜呢？

示意图

基于 Pi SDK 构建的终端对话式 AI Agent，集成 Computer Use、语音（TTS/STT）、桌面宠物、持久记忆与会话管理。

安装

npm install -g git+https://github.com/SRC114514/arona-agent.git

# 初始化配置文件
arona setup

# 初始化后可直接启动
arona

# 禁用TTS+STT并启动
arona --no-voice

# 补全/重新克隆某角色音色
arona voice add [<角色名>]   # 不带角色名则进入 TUI 选择未补全的角色

核心特性

  • Computer Use：基于 cua 。
  • 语音：实时流式 TTS + STT。
  • 桌面宠物：透明无边框置顶 Electron 窗口，Spine 骨骼动画待机 + 情绪切换 + 瞳孔跟随鼠标 + 头部摇动摸头彩蛋 + 全屏点击/拖尾特效。

环境要求

  • Node.js >= 22.19.0
  • Python 3.12 / 3.13

配置

全部配置写在 JSON 文件 ~/.arona/settings.json，大部分由 arona setup 交互式生成，少数高级参数需自行填充。

字段 说明 默认值
apiKey API Key —
apiBaseUrl API地址（留空则按模型名自动匹配） —
model 模型名（provider/model-id，裸名自动补前缀） openai/gpt-4o
thinkingLevel 思考等级 medium
language 界面语言（auto/zh/en） auto
mainAgent 主 Agent（arona/plana） arona
ttsEnabled 启用 TTS true
sttEnabled 启用 STT true
workspaceId 阿里云百炼业务空间 ID —
ttsApiKey 百炼 API Key —
ttsModel TTS 模型 qwen-audio-3.0-tts-plus
ttsVoice （旧版字段）音色克隆 voice_id，已迁移至 ~/.arona/voices.json —
ttsSampleRate TTS 采样率 22050
sttApiKey 百炼 API Key —
sttModel STT 模型 qwen-audio-3.0-asr-flash-streaming
sttFormat STT 音频格式 pcm
sttSampleRate STT 采样率 16000
cuaApiKey Cua API Key —
pythonPath Python 路径 python3
mcpServers MCP 服务器 JSON {}

模型名前缀自动检测：若 model 不含 /，按模型名前缀或 apiBaseUrl 域名自动补 provider/。

数据路径（~/.arona/）

路径 说明
settings.json 本地总配置文件，字段见 配置
voices.json 每角色音色克隆 voice_id（{ "arona": ..., "plana": ... }）
MEMORY.md 持久记忆
sessions/ 已保存会话
skills/ 自定义 Skill
undo/ undo/redo 快照（按工作目录分桶）
pet.json 桌宠窗口位置持久化

桌宠与 STT 热键

  • 桌宠：透明无边框置顶窗口，以 Spine 骨骼动画 Idle_01 作为待机基底循环播放；Agent 每段发言前调用 change_emotion 切换情绪；拖动窗口可移动，在头部区域左右摇晃可触发"摸头"彩蛋；点击/拖拽还会触发全屏点击与拖尾特效；TTS 逐句播放，情绪保持到 TTS 播完自动恢复默认。

    内置双角色：arona（阿洛娜）与 plana（普拉娜），用 /change-agent 或 settings.json 的 mainAgent 字段切换

    切换前会自动保存当前会话。

  • STT 热键：右 Cmd 键，长按 ≥ 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 开源。

版权声明

本项目为独立开发的非官方项目，与Nexon Games Co., Ltd.、YOSTAR LIMITED及《蔚蓝档案》游戏官方团队无任何直接关联、授权关系。

  • 项目主体代码采用MIT许可证发布，但本项目未就assets/blue-archive/目录下的所有文件（涉及《蔚蓝档案》游戏知识产权的内容，包括但不限于角色立绘、美术素材、音频文件、文本内容及相关衍生素材）向本项目/任何第三方授予任何许可，也不对其合法性、可用性做任何担保。
  • 此类内容的使用、复制、分发需严格遵循Nexon Games Co., Ltd.及YOSTAR LIMITED发布的 《蔚蓝档案官方同人创作守则》 及适用法律法规
  • 本项目不附带此类第三方文件的获取渠道，用户需自行从权利方官方渠道获取合法副本，并自行承担使用责任；
  • 本项目不得用于影响版权方权益之分发，否则自行承担相关侵权责任。

此类内容的知识产权归Nexon Games Co., Ltd.及YOSTAR LIMITED所有，其使用、复制及分发规则应严格遵循上述权利方的官方条款及适用法律法规。
若相关权利人认为本声明或项目使用方式存在不当，可与我联系，将在核实后第一时间调整或移除相关内容。

Reviews (0)

No results found