owo_terminal_public
a super cute AI terminal. 一个超级可爱的终端软件.
Links
README
From the repo.
宅喵终端 (owo_terminal) ฅ^•ﻌ•^ฅ
English Edition | 简体中文版
QQ群:604927876 喵宅苑: https://iw-i.com https://o-o.zone https://o-o.space
一直以来,我用了市面上的很多 AI 软件,都一直不太满意。 这些软件包括 Trae、codeX、antigravity……各类主流 AI IDE。
我期待我的 AI 助理像个伙伴,有形象,有表情,要能动。 我期待它有二次元的活泼界面。 我期待它足够万能,能够帮我管理电脑,能接管我的浏览器,或者让我一边开着浏览器,一边和它互动; 能帮我接管 Linux 服务器,一键部署生产内容,调试和日常运维; 以及,能和我玩游戏。
以上这些需求,现有的软件都不能满足我。
最重要的是,在 AI 时代,我必须拥有一个我能够完全掌控所有通信交互流程的 AI 程序。
所以我设计和制作了 宅喵终端。
设计语言
它继承了 喵宅苑 的设计风格,使用了几乎一致的设计语言。 App 部分由 AI 自行发挥,是个例外。
架构设计
它的架构设计是一个 系统核心 + App系统。
- 系统核心:我完全负责这部分,核心的每一部分我都了如指掌。
- App系统:旗下的 App 程序我交由 AI 来全部负责编写、审查。这部分对我是个“盲盒”,我不管具体的实现细节,只要保证功能不出问题即可。部分基础核心 App 我也会参与设计。目前这部分还在完善中。
存档
软件的行为逻辑和 Word、记事本等软件一致:
- 所有的聊天记录都需要存档到外部位置,且每一份存档对应一次聊天会话。
- 要开启新聊天,请新建存档。
- 存档的格式
.owo实际上是一个zip压缩包,你可以解压其中的内容,或者让 AI 读取其中的聊天记录。之所以设计成压缩包而不是文本,是因为聊天过程中可能会涉及到图片等媒体文件的存储。
角色设计
你可以设计二次元角色包、导入角色包来自由更换软件里的角色。角色包为一个 zip 压缩包,目录规范为:
测试角色包.zip
├── pet/
│ └── 表情名.png # 2048*2048px,透明背景(静态表情)
└── pet2/
└── 视频名.webm # 1920*1440,带透明通道的 WebM 格式(动态视频表情,如站在旁边活动的角色)
[!TIP] 角色视频制作流程建议:
- 让 AI 制作好绿色背景的角色图片。
- 让 AI 转成绿幕视频,尽可能使用首尾帧 + 拼接 2 个视频来让角色归位。或者自行设计。
- 使用剪映等视频剪辑软件的抠像功能把背景抠掉,去掉声音轨道,导出成带 alpha 通道的格式,最后使用
ffmpeg转成webm格式。
系统设置
系统设置不会被保存到普通存档中,因为其中包含了敏感的 API 密钥。
系统设置需要使用菜单单独导入和导出,格式为 sqlite。
App 的导入导出
部分 App 的设置也需要导入导出成独立存档,和主程序会话存档分开,以确保配置隔离。
如何创建模型
宅喵终端为纯本地软件,本身没有提供模型服务,你需要自己寻找大模型服务商来接入模型。
常见的模型服务商推荐如下:
- Ollama (https://ollama.com):本地大模型运行框架。无需 API 密钥,完全免费且支持断网离线使用,是宅喵终端强力推荐的真·本地隐私伴侣。
- DeepSeek (https://platform.deepseek.com):高性价比的明星大模型,其 Reasoning 深度思考模型能提供极其卓越的逻辑推理,且宅喵终端对深度思考回传有专门的完美 UI 渲染适配。
- OpenAI (https://platform.openai.com):业界风向标,提供 GPT-4o、o1 等顶级闭源大模型,支持前缀缓存与原生工具调用(Function Calling)。
- Anthropic (https://console.anthropic.com):提供 Claude 3.5 Sonnet 等业界公认代码能力最强的模型,极其适合复杂的编程和连续工作流。
- SiliconFlow (硅基流动) (https://siliconflow.cn):国内优秀的模型 API 聚合与托管平台,提供了极速且低成本的 DeepSeek、Qwen、Llama 等多模态与推理模型的 API 服务。
接入步骤:
- 前往模型服务商的官网阅读说明,获取
apiKey、与 OpenAI 兼容的接口地址(Base URL)以及模型id(通常你可以切换选择多个模型,你需要复制对应模型的模型 ID)。 - 模型别名(Alias)可以任意取,但是不能重名。
- 打开设置面板 -> 「人工智能」 -> 「添加新模型」,填入相应配置即可。
终端说明
宅喵终端使用 node-pty 配合 xterm.js 来和你的系统命令行终端交互。
[!WARNING] 请注意:内部没有使用虚拟环境,一切操作命令都会执行在你的真实电脑上。
- AI 试图执行的所有命令都会经过系统的安全拦截,询问你是否允许执行,并附带上一段 AI 编写的命令说明。若要拒绝,你可以写上备注信息驳回。
- 特别警惕删除文件的命令! 尽量不要让 AI 去自动删除文件。因为有时可能由于转义符号写错、带空格的目录解析有误等,导致非预期目录被误删。删除文件最好由你人工手动处理。
模型缓存和撤回
与主流大模型对话通常会使用**前缀缓存(Prefix Caching)**来大幅节约 Token 消耗。
- 系统提供了撤回消息功能,但请注意,撤回中间的历史消息会直接导致大模型端的缓存失效(缓存穿透),使用前请充分考虑。
- 更多的时候,推荐使用**【撤到本条】**功能。这只会删除最末尾的局部对话,不会破坏前面已有的前缀缓存。
对话回复和引用
- 终端锁定:在终端模式下,向文本框发送消息时,会自动锁定回复给某个指定的终端。再次点击该锁定按钮可以取消锁定。此时发送新消息可以新建一个终端窗口。
- 消息引用与回复:在大模型模式下,你可以引用过去的某个会话,或者指定回复某个会话,类似聊天软件里的引用和回复。
- AI 的反向引用:AI 也可以引用或回复你的对话,在 UI 上会有精美的特殊呈现,如图所示:
工作目录和时光机
若选定了工作目录,系统将会强制开启时光机功能,否则将无法选定该工作目录。 时光机备份是一个基于 Git 机制但独立于你项目里已有 Git 仓库的独立备份系统。
- 备份存放:启用时光机后,会在项目根目录下创建
.owoTimeMachine文件夹用来存放备份,请勿删除该文件夹,否则将无法恢复备份。 - 自动还原点:启用了时光机后,在对话过程中系统会自动创建还原点快照。你可以随时点击按钮还原文件状态(注意:还原模式是用快照存档覆盖,对话中新增的文件不会被自动删除)。
- 精确还原:你也可以在时光机 App 里,手动拖拽时间快照中需要还原的文件到资源管理器 App 进行覆盖,以实现精确的文件级还原。系统会挨个弹窗询问你对每个文件是要覆盖还是跳过。
-
设计解耦(开发特别注意):
[!IMPORTANT] 如果你打开了时间机器 App 本身,使用「打开备份目录」按钮时,请选择一个类似
.owoTimeMachine的备份文件夹,而不是项目根文件夹。时间机器 App 只对备份文件负责,它可以预览备份文件的内容。理论上时间机器 App 不绑定任何项目,它只管备份文件本身。你可以把备份文件复制到任何地方,随便重命名,都可以用时间机器 App 打开。 备份和项目的绑定逻辑是由主系统借助时间机器 App 来实现的,和 App 本身无关(开发时候特别注意,这部分没有任何耦合,App 就是纯粹独立的 App)。
-
Git 兼容性: 时间机器的备份允许你的项目本身存在一个
.git仓库,且项目里的.git仓库内容不会被备份到时间机器里。同时,在创建.owoTimeMachine文件的同时,主系统会自动编辑已有的.gitignore文件,把该备份目录加入排除列表,保证二者不会发生冲突。
浏览器App
浏览器 App 允许你登录一些网站并与 AI 交互,AI 也可以在获得授权后调用浏览器来完成某些自动化操作。 这实现了极佳的人机互补行为——例如某些需要人机验证(CAPTCHA)或复杂安全登录的操作必须由你来完成,你操作完成后,再将控制权交还给 AI 继续剩下的自动化流程。
RPG游戏
系统自带一个可以被 AI 编辑的小型 RPG 游戏,你可以和 AI 一起玩 RPG 游戏。AI 可以自主设计游戏场景并生成交互事件来与你进行妙趣横生的剧情互动。
编程功能
程序内置了完整的程序设计工作流,且所有的步骤皆可审批 和主流ai编程IDE不同的是,审批流程为:
- 写入前审批,你必须依次审阅所有的文件,文件才会被真正写入
备注:你可以在【更多】菜单里将某些工具设置为白名单以便跳过审批
如果你在审批面板使用编辑器app打开,可以配置将审批结果的diff发送给ai,同时配置审批后是否用编辑器app打开该文件
如果你不使用编辑器app审批,而是直接在快捷面板内确认,将不会发送diff
-
写入后复审+还原 开启了时光机备份后,每条对话都会创建一个还原点 你可以在对话处的【还原文件变动】,查看最新的文件变动相对于这个还原点发生了哪些修改 点击【查看】按钮,可以在编辑器内查看diff 你可以逐个审查这些变动 你可以勾选需要还原的文件
-
直接使用时光机app 此外 你还可以在时光机app里查找到这个备份点,并预览这个备份点内的所有文件 你可以在时光机app里拖拽这个备份点的文件到资源管理器app覆盖文件,这个操作也能够触发还原 使用逻辑和mac的时间机器软件逻辑类似
快速打开app
使用快捷键ctrl+p或者cmd+p,可以快速打开工作目录内的文件 你可以使用全文搜索来快速定位文件
全局缩放
使用快键键ctrl/cmd + 加号/减号/零 可以缩放主界面UI
绘图器app
程序内置了相对全功能的svg编辑器,该编辑器的使用逻辑和flash软件的矢量绘制功能类似 它能够自动切割相交的线条和填充,并具备图层功能 你可以对他们编组或者双击进入组来进行快速编辑操作 ai可以调用这个绘图器app画画,你也可以用它来制作矢量图
授权协议
本项目使用自定义的 “非商业、源码可见” 授权协议。详情请参阅 LICENSE.md。
[ 可以这样做 ] 免费学习、个人研究、和小伙伴一起玩、自由修改源码。 [ 不可以这样做 ] 未经授权用于商业牟利、拆解核心逻辑用于无关项目、隐藏版权声明。
Collected info
- ★ 24 stars
- Language: JavaScript
- Source updated: 7/30/2026
Config for your environment
Replace {MCP_ENDPOINT_URL} with this MCP’s endpoint URL (from its repo or docs above). No API key — you connect directly.
Tool
OS
Config file: ~/.cursor/mcp.json
{
"mcpServers": {
"mcp-server": {
"url": "{MCP_ENDPOINT_URL}"
}
}
}Paste into mcpServers in the config file. Restart Cursor after saving.
If this MCP is also published on mcpchannel.ai, you can subscribe from Browse and use the gateway config there instead.