Miyu

一个活在终端里的二次元少女。开箱即用的开源 AI 助手，支持接入通讯平台。

暂时

谁是 Miyu？

Miyu 是从我曾经很喜欢的动画中的角色身上汲取灵感制作的虚构角色。

有什么功能？

miyu 由大模型驱动，默认接入了 opencode 的公共模型服务，你也可以配置自己的大模型服务。比起Coding，她更偏向聊天日常、游戏娱乐、系统排障等日用场景。

miyu 可以与 fish、zsh、bash 集成，终端打字直接无缝对话！

有终端交互模式

自带了 TUI 方便修改配置。

miyu config

还有 WebUI

还可以通过 NapCat 接入 QQ，远程操作电脑；亦或是加入群聊，陪网友吹水，帮助你管理群聊。

如何安装？

• Arch Linux

  yay -S miyu
  

• 从源码构建

  git clone https://github.com/SHORiN-KiWATA/Miyu.git
  cd Miyu
  cargo build --release
  

安装完成后可以运行 miyu init 初始化配置和状态文件；也可以直接运行 miyu daemon start，首次启动会自动初始化。

如何使用？

与 miyu 运行最适配的是 kitty终端

• REPL TUI 交互模式

  miyu
  

• webui 局域网网页

  miyu web
  

• shell hook 终端集成

  最好的集成效果要求使用 fish，zsh 和bash 只能做到单行对话，fish 可以完整无缝集成。

  miyu fish-init
  

重要配置调整

运行 miyu config 命令打开配置 TUI。

• 供应商和模型

  miyu 默认使用 opencode 的公共 API，推荐配置自己的 API。

• 自定义提示词

  miyu的默认提示词是无法修改的。你可以在自定义提示词中新建属于自己的 AI 人格，还可以配置 用户身份 让对话更加沉浸。

用户资源与 Skill

Miyu 将配置与用户资源分开保存：~/.miyu/config 存放 config.jsonc、主题和 shell 集成；~/.miyu/data 存放 prompts、identities、persona-avatars、scripts 和 skills；运行状态与 Skill 草稿位于 ~/.miyu/state。

内置插件

[展开/收起] 具体介绍

• 表情包

  表情包毫无疑问是聊天时最重要的部分，在对话时，Miyu 会根据情景自主发送符合情境的表情包。除了自主发送，设置里还可以设置概率、置信度和冷却时间。

  

  Miyu 自带了一些表情，存放在/usr/share/miyu，对应的用户空间目录位于~/.miyu/data。表情库是跟随人格的，如果你在设置里新建了自己的人格，那么就无法使用 Miyu 的默认表情。你可以准备一些图片，把路径给 Ai，让其保存到表情库。届时会自动调用识图模型对图片进行分析并保存。Miyu 默认使用 opencode 公共模型服务中的多模态模型进行识图，所以即使不配置自己的多模态模型也可以看图片。

• 玄学算命

  心理学。

  算命就像看天气预报一般稀松平常。Miyu 自带了周易六十四卦、吉凶占、塔罗牌抽取等玄学功能。

  

  

• 投骰子

  赌！

  闲来无事可以和 AI 比比大小。

  

• 闹钟

  要我说，这比GNOME时钟的闹钟好用多了

  Miyu 自带了闹钟，日常泡泡面、番茄钟学习、计时任务什么的都很实用。内置了闹钟音频，你还可以通过路径传入你想要在到点后播放的“闹钟”。

  

• 知识库

  Miyu 自带了 ShorinWiki 中的内容和一些日用 Linux 会遇到的问题作为默认知识库。

  当然，你也可以通过 miyu kb 命令，或者通过跟 AI 的自然语言交互管理属于你自己的知识库。

  

• ProtonDB 查询

  可以查询 ProtonDB 上的游戏信息和相应的评论，为 Linux 玩游戏提供参考建议。

• Linux 游戏兼容性调查

  这个游戏 Linux 能玩吗？

  这是桌面端使用 Linux 的日经问题，Miyu 会去 ProtonDB、Are We Anti-Cheat Yet?、Can I Play On Linux等 Linux游戏兼容性资讯网站获取主要信息，辅以社区玩家的声音，综合判断一款游戏的兼容性并提出建议和注意事项。

  

• 网络搜索

  即使不配置网络搜索 API，Miyu 也仍然拥有基础的网络搜索和网页读取能力。可以在插件配置中设置 Tavily、Firecrawl 、AnySearch、SearXNG 等网络搜索 API 以获得更佳的搜索效果。

  

• 搜图

  Miyu 还能帮你找图片喔！搜图会根据网络环境并行使用多个来源，并通过视觉模型筛选相关且安全的结果。图片会默认保存至~/.miyu/data/pictures/web-images。

  NSFW 禁止！

  

• 生图

  支持 OpenAI 的画图服务喔。图片会默认保存至~/.miyu/data/pictures/generated-images。

  这个功能默认用不了，要自己在插件设置里开启并配置 API

  

• 天气查询

  查询天气是每天的必做活动，当然少不了。

  

• 汇率查询

  国际社会，查个汇率也很合理吧？

  

• Man 手册查询

  Man！

  专门的手册查询工具，虽然网络搜索也能做到，但这值得做成单独的插件。

  

• Arch Linux相关

  Arch Linux 是桌面 Linux 的热门之选，Miyu 有一系列插件可以帮助提高 Arch Linux 的日用体验。

  • AUR 状态查询

    AUR 还在被 DDos 吗！

    AUR 的状态是日用 Arch 时的重要信息之一，不访问网站就能查询的话，在 AUR 安装出现异常时查起来会方便很多。

    

  • AUR 包查询

    可以查询 AUR 上的包的具体信息

  • Arch Wiki 查询

    作为 “Linux 圣经”，查询 Arch Wiki 不仅能提高日用 Arch 的体验，对其他发行版也大有裨益。

    

  • PKGBUILD 审查

    AUR 投毒的事件搞得人心惶惶，但现在，Miyu 可以帮忙审查 PKGBUILD 啦！

    

• 文件操作

  自不必说。

  Miyu 支持读写文件、搜索内容、查找文件、删除文件等。

• 计算器和哈希编解码

  为了计算结果的准确性，Miyu 自带了科学计算器和哈希编解码的能力。

  

• 记忆系统

  Miyu 的记忆分为短期日记、长期日记和知识点。每个成功完成的对话轮次会立即写入短期日记；同一人格累计 14 条未整理日记后，由独立后台线程并行提炼长期知识点和有回溯价值的长期经历，不会阻塞正常回复。成功整理的短期日记默认保留 14 天，每次有效联想会刷新保留时间；召回达到 3 次时会立即进入长期化整理。尚未成功整理的原文超期后会退出自动联想但不会丢失，后台仍可继续整理；整理成功后再物理清理。已经长期化的日记不再刷新短期原文的清理时间。

  联想会同时检索三类记忆，并使用 jieba-rs 中文分词进行低成本匹配。Embedding 后续可以作为可选辅助接入，但不是记忆系统运行的前提。长期知识点和长期日记会随时间衰减为“已遗忘”，不物理删除；显式搜索仍可找回。

  /reset 只清理当前会话，不删除人格记忆；终端或 WebUI 的 /reset all 会清空当前人格的短期日记、长期日记、知识点、修订记录和待整理状态。主体记忆在一个事务中清理，淘汰上下文随后独立清理。即使后台模型当时正在整理，旧结果也会因数据库身份或记忆代数变化而被拒绝，不能在清理后重新写回；重置前已经启动的其他会话也不能再写入旧日记。

  

• 深度研究

  Token 燃烧警告

  重量级插件。对于一个命题，Miyu 可以引经据典，有理有据地进行深度研究并写出研究报告。

  

• Linux 输入法问题诊断

  从 Linux 输入法实现原理出发，对软件输入法问题进行深度诊断。

• Fcitx5 wiki 查询

  阅读 Fcitx5 wiki，为输入法问题提供参考。

致谢

功能参考

• Opencode
• Claude Code
• Pi
• Deepseek-Reasonix
• Astrbot
• NapCatQQ

插件设计参考

• Yue-bin/astrbot_plugin_maskoff
• nuomicici/astrbot_plugin_GroupMemberQuery
• advent259141/Astrbot_plugin_Heartflow
• Railgun19457/astrbot_plugin_image_generation
• xiewoc/astrbot_plugin_weather_wttr_in
• muyouzhi6/astrbot_plugin_recall_cancel

许可

Miyu 使用 MIT License 发布，见 LICENSE。