更新日志

妙爪有自己的官网了：miao-claw.com。这一版围绕它给桌面端减负，顺手修掉手机上一个打字的老问题。

这次有什么变化

• 官网上线（miao-claw.com）：下载、配真实截图的完整使用说明、每一版的更新日志都在上面；下载慢还有百度网盘备用地址。以后想系统了解某个功能，去官网看图文比翻应用内说明清楚得多。
• 应用内帮助页做了减法：只留「三步上手」和「常见问题」这份最省心的小抄，完整功能说明搬去了官网（帮助页里有直达链接）。离线时小抄照常可用。
• 侧边栏的「迷你浮窗」「桌面宠物」按钮恢复了文字：之前只有图标，容易点错。

修好了什么

• 手机上打字，输入框被输入法挡住：部分手机浏览器上仍会出现的形态这次也覆盖了——九宫格、全键盘、手写，键盘弹出后输入框都稳稳在键盘上方。

你需要做什么

• 要不要重启：需要。请完全退出 Miaoclaw 再打开——点右上角关闭只是缩到托盘，要从托盘图标上退出。
• 手机上要做什么：把手机上的喵喵页面下拉刷新一次就行，不用重新扫码。
• 数据会不会丢：不会。升级不影响你的对话、手帐、记忆、模型配置和全部设置。
• 还不能做什么：与上版相同——手机上不能改模型配置、装东西和执行命令；微信公众号、知乎这类需要登录的网页仍读不到正文。

3.0.1 把手机端做出来之后，这一版专心做两件事：把用起来别扭的地方磨顺，以及让界面说人话。

界面做了一次减法

喵喵的按钮和选项一直在变多，这一版反过来往回收了一遍。目标很简单：每一屏都让人一眼看出该点哪个。

• 模型 API 页：每个服务商那一行原来并排四个按钮，「删除」就挨着「测试连接」，手一抖就删掉了；现在只留「展开」和一个「⋯」，删除收在菜单里单独隔开。模型的看图能力也不再显示「实测/录入/文档/推测」四种标注，就三种说法：会看图 / 没测过 / 不会看图，测出来的详情移到鼠标悬停上。
• 对话界面：喵喵干活时那一条上，原来「引导当前」「停止改向」「停止」三个按钮共用一个输入框，谁也看不出区别。现在写一句话进去就是补充给它（不打断），想让它换个方向做，按钮自己会变成停下改做这个。
• 上下文那个百分比不再一直挂着了 —— 只有这段对话真的快装不下时才出现，并且写成一句人话「这段对话快满了 · 整理一下」。
• 设置页十四个分区分成了「先配好 / 调教它 / 其他」三组，顺序就是上手顺序。
• 桌面宠物原来要同时调「灵敏度」和「每小时最多说几次」才知道会得到什么效果，现在合成一个三选一：安静 / 适中 / 话痨。
• 本领（Skill）页第一次进去不再是几张只有数字的卡片，直接看得到它到底会些什么。
• 侧边栏底部、定时任务、搜索、语音等页面也各收了一轮。功能一个没删，只是不常用的收得更靠里。

界面开始说人话

• 出错时不再甩英文原文。以前弹出来的是「Failed to fetch」这种，现在会告诉你出了什么事、可以做什么：「连不上你的电脑 —— 确认电脑开着、Miaoclaw 正在运行」。余额不足那种还会明说不是 Miaoclaw 的问题，免得你以为是软件坏了。
• 权限三档各自补上了选了会怎样，不用再猜「工作访问」到底能不能帮你改文件。
• 语音识别两个选项改叫「在线识别（更准）」和「本机识别（免费）」；安装时的进度也不再蹦出一串看不懂的英文零件名。

修好了什么

• 画图时报「连接失败」画不出来：某些绘图模型在国内网络下连不上，现在能正常出图了。
• 手机上打字时被输入法挡住输入框：九宫格、全键盘、手写各种输入法都已正常。
• 手机上打不开喵喵做好的网页文件：点开只看到配对页面，现在能正常预览了。
• 手机第一次打开时，历史对话要等很久才出来（新对话都显示了历史还是空的）：现在进去就能看到。
• 长文章出字很慢、越写越卡：现在长回复也能顺畅刷出来。
• 模型自检有时一直卡在「正在测试中」，失败了也不说为什么：现在会正常结束并告诉你哪个模型、什么原因没通过。
• 换 API Key 之后有时没生效：同时改多处设置时，有的改动会被覆盖掉，现在不会了。
• 手机上那些本来就做不了的设置项，不再显示出来给你点了才发现不行。

你需要做什么

• 要不要重启：需要。请完全退出 Miaoclaw 再打开 —— 点右上角关闭只是缩到托盘，不算退出，要从托盘图标上退出。
• 手机上要做什么：把手机上的喵喵页面下拉刷新一次就行，不用重新扫码，也不用重新配对。
• 数据会不会丢：不会。升级不影响你的对话、手帐、记忆、模型配置和全部设置。
• 还不能做什么：手机上仍然不能改模型配置、装东西和执行命令，这些只能在电脑上做；微信公众号、知乎这类需要登录的网页，喵喵仍然读不到正文。

手机来了。 从这一版起，你可以在手机上用喵喵 —— 在外面问一句、看看电脑上的任务跑到哪了、随手记一笔手帐。不需要和电脑在同一个网络。

📱 手机连接（本版核心）

• 扫码即用：设置 → 手机连接 → 打开开关 → 添加一台手机 → 用手机扫二维码，就这四步。手机上打开的是一个网页（app.miao-claw.com），可以「添加到主屏幕」当 App 用。
• 在任何网络下都能用：手机和电脑之间经官方中转服务对话，出门在外照样连得上。电脑需要开着，喵喵才回应得了。
• 内容全程加密，中转服务器看不到：配对时手机和电脑当面交换一把钥匙（就是扫的那个码），之后传输的一切都用这把钥匙加密。中转服务器只知道「把这包转给谁」，看不到里面是什么 —— 那把钥匙从不经过网络。
• 手机能做的事比电脑上少一些，这是有意的：对话、看任务进度、记手帐可以；改模型配置、装东西、执行命令只能在电脑上做。添加手机时可以选权限档位。
• 手机丢了不慌：在电脑上「设置 → 手机连接」把它移除，立刻失效。

🔐 顺带把安全地基整个翻新了

为了让手机安全地连进来，这一版给整个后端加上了完整的权限体系：每个接口逐条声明远程能不能碰、什么档位能碰，默认一律拒绝。远程设备哪怕拿到链接，能做的也只有你授权的那些事。这套体系对只在电脑上用的你完全透明 —— 一切照旧。

🧰 其它修复

• 界面上的连接状态现在只反映「真正通着的那条路」：连上了才说能用，没连上老实说正在连。
• 帮助页补齐了近几个版本的新功能（手机连接、猫猫便利贴、工作台、记忆、Skill）。
• 手机端图片显示、消息状态等一批打磨。

升级方式照旧：应用内提示一键更新，数据不受影响。

给你的硬盘减负。 有用户发现 Miaoclaw 悄悄占了几十 GB —— 查下来确实是我们的问题，这一版根治。

💾 升级备份不再臃肿

每次升级前 Miaoclaw 都会自动备份一份，万一新版本有问题可以回退。但这个备份把不该备份的东西也拷进去了：

• 你产出的文件（图片、文档、上传的附件）—— 升级根本不会动它们，备份它们毫无意义
• 浏览器缓存 —— 纯粹的临时文件，删了会自动重建

结果就是每份备份 2GB，攒了几十份就是几十 GB，而里面真正需要保护的内容其实只有 2MB 左右（配置、对话、记忆、个性化设置）。

这一版起：新的备份只保护真正需要保护的，体积从 GB 级降到 KB 级。回滚能力一点没减 —— 因为被剔除的那些东西，升级本来就不会碰。

升级后旧的臃肿备份会自动瘦身，你什么都不用做，空间自己就回来了。实测一台用了一段时间的机器：74.5 GB → 4.46 GB。

📊 占用了多少，现在你自己看得见

设置 → 用量记录 新增「占用空间」卡片，分两栏摊开讲清楚：

• 你的东西（永远不动）：对话记录、记忆、喵喵手帐、知识库、个性化设置、扩展、产出的文件
• 备份、缓存与离线组件：可以清理的部分，旁边就是「清理可回收空间」按钮

清理只动第二栏，你的对话、记忆、手帐、文件一个字节都不会碰。

🧹 缓存不再无限长大

浏览器缓存类的目录现在有体积上限，超了自动清（会重新生成，你不会有任何感觉）。以前它们只增不减 —— 实测其中一个长到了 432MB。

升级方式

• 2.1.1 及以上版本：应用内提示更新后，点「重启完成更新」即可（轻量更新，几秒完成）。
• 2.1.0 及更早版本：会自动下载完整安装包；如安装时闪退，把安装包复制到桌面再双击运行即可。
• 数据（会话、记忆、手帐、API Key）不受升级影响。

---

（2.1.9 的更新内容：修复把窗口拉小时输入框会整个消失的问题，从大屏到 360×420 各种尺寸都已逐一验证。）

紧急修复版:把窗口拉小时输入框会整个消失,没法打字。2.1.8 用户建议尽快更新。

🐛 修复:小窗口下看不到输入框

把主窗口拉窄到一定程度(大约 720 像素以内)时,界面只剩顶部一条导航栏,下面的聊天区和输入框全都不见了,等于没法用。

原因是侧边栏在窄屏下没有正确让出高度,把聊天区挤到了窗口外面。现在从 1280×800 一直到 360×420 的各种窗口尺寸都已逐一验证:输入框和发送按钮都在窗口里、可以正常打字发送。

如果你习惯把 Miaoclaw 缩成小窗口贴在屏幕角落用,这一版必须更新。

> 顺带一提:如果你想要的是"边写东西边跟猫聊",其实还有更合适的 迷你浮窗——按 `Ctrl+Alt+M`,或点侧边栏的「🐈迷你浮窗」,会开一个半透明置顶的小窗,专为这个场景做的。

升级方式

• 2.1.1 及以上版本:应用内提示更新后,点「重启完成更新」即可(轻量更新,几秒完成)。
• 2.1.0 及更早版本:会自动下载完整安装包;如安装时闪退,把安装包复制到桌面再双击运行即可。
• 数据(会话、记忆、手帐、API Key)不受升级影响。

---

（2.1.8 的更新内容:花费透明与预算上限、断电不再丢对话、长会话摘要不再丢失、装 Skill 更安全、后台更稳。详见 2.1.8 发布说明。）

2.1 系列的收官版。这一版没有新功能,全部力气花在两件事上:让它更稳,让你对花销心里有数。

💰 花了多少钱,一眼看得见

以前用量记录只给 token 数字,大部分人看不出那意味着几毛钱。现在:

• 设置 → 用量记录 把【花费】放到最前面,直接按人民币算给你看,可以按天、按模型看明细。
• 单价用的是各家官方公开价目。个别没有公开单价的模型显示「—」,不瞎猜一个数糊弄你;包月订阅制的端点也会如实标注,不会硬算成按量计费。
• 花费上限(新):可以设每天/每月的钱数上限。到 80% 提醒你,超了就先把定时任务、猫猫便利贴这类自动跑的活儿停下来 —— 你手动发的消息永远不会被拦住。默认关闭,想开去用量记录页。

第一次使用的引导里也补上了这些:钱付给谁(直接付给模型厂商,Miaoclaw 不经手不抽成)、日常大概多少(几分到几毛)、在哪设上限。

🛡️ 对话和文件更不容易丢

• 断电后不再吞掉最后一轮对话:强制关机/断电如果正好写到一半,下一次的对话记录会被粘在坏掉的半行后面,导致那一轮整个消失。已修复。
• 长会话不再"聊着聊着忘了前面":长对话会自动整理成摘要供后续参考,但这份摘要偶尔会被同时进行的对话记录覆盖掉,表现为聊久了它像失忆。已修复。
• 回滚更安全:恢复到旧版本前会先给当前数据留一份副本,不再是先删后拷。
• 对话、手帐现在也进入升级前的自动保护清单。

🔒 装 Skill 更安全

• 压缩包解压增加多道边界检查:防止恶意压缩包把文件写到安装目录之外、防止用一个小文件撑爆内存、拒绝符号链接和加密条目。
• Skill 更新失败会自动还原成更新前的版本,不再留下一个装了一半、之后既不能开也不能删的残缺 Skill。

⚙️ 后台更稳

• 「停止」更干脆:停止任务时残留的子进程会被彻底清理,不再有幽灵进程占着资源。
• 磁盘占用有了上限:更新包、快照、上传文件、生成的图片会按份数和时间自动清理,不再无限增长。
• 长任务被停止后如果下游卡住,不再让整个队列永久挂死。
• 超长消息不再拖慢界面。

🐛 其它修复

• 窄窗口设置入口消失:把窗口拉窄时侧边栏的设置按钮会不见,已修。
• 网络请求增加了同源校验,减少被本机其它网页页面误触发的可能。
• 清理了约 430 行早已无人调用的旧代码,应用更轻快。

升级方式

• 2.1.1 及以上版本:应用内提示更新后,点「重启完成更新」即可(轻量更新,几秒完成)。
• 2.1.0 及更早版本:会自动下载完整安装包;如安装时闪退,把安装包复制到桌面再双击运行即可。
• 数据(会话、记忆、手帐、API Key)不受升级影响。

这一版让模型目录「活」了起来,便利贴也能用嘴贴了:

新功能

🔄 模型目录自动更新:供应商上新,不用等新版本

模型厂商上新模型后,Miaoclaw 会随日常的更新检查自动收到核验过的模型目录(经官方文档核对+真机实测后才下发),新模型直接出现在你的模型列表里——应用本体不用升级。本版随带首份目录:Kimi K3 全系(K3 旗舰 1M 上下文/K3 Coding 端/K2.7 Code 高速版),还在用旧版本的朋友也能直接用上。

🩺 模型目录体检:下线预警,不再突然报错

设置 → 模型 API → 「只查模型目录(几秒)」:一键对照官方最新列表——你配着的模型如果官方已下线会红字预警(避免哪天突然报错才发现),官方新上的模型也会列出来。「一键自检全部模型」末尾会顺带跑一遍。

📝 猫猫便利贴,现在能用嘴贴了

在聊天里(打字或按住🎤说话)直接说「在XX文件夹贴张便利贴:把里面的录音整理成会议纪要」,喵喵就会帮你贴好;「改一下那张便利贴」「现在就照便利贴办」也都听得懂。不用打开工作台。

优化与修复

• 看图窗口滚轮不再带滚背景:对话/手帐里放大看图时,滚轮只缩放图片,底下的页面不会跟着滚动。
• 便利贴编辑保存修复:工作台里编辑便利贴点保存曾会失败,已修复。
• 安装器修复:静默安装指定新位置时不再被旧安装位置"劫持"(迁移安装场景)。
• 清理了一批无效代码,应用更轻快。

升级方式

• 2.1.1 及以上版本:应用内提示更新后,点「重启完成更新」即可(约 20MB 轻量更新,几秒完成)。
• 2.1.0 及更早版本:会自动下载完整安装包;如安装时闪退,把安装包复制到桌面再双击运行即可。
• 数据(会话、记忆、API Key)不受升级影响。

这一版带来三件新玩法和一批贴心打磨：

新功能

📝 猫猫便利贴：把事写在贴纸上，喵喵路过会办

在工作台挂载的文件夹里贴一张「猫猫便利贴」，用大白话写上要交办的事（比如"把这个文件夹里的录音整理成会议纪要"），喵喵每隔一段时间巡看一次——内容变了才执行一次，办完把执行记录写回贴尾。贴与改都在应用内完成（工作台 → 猫猫便利贴 → 贴一张 / 编辑），不用碰任何文件；想让喵喵再办一次，改改内容或点「立即执行」就行。默认关闭，巡看间隔可调（15 分钟～2 小时）。

🗂 Skill 分组：常用扩展一键成组开关

扩展管理页新增「我的分组」：把常一起用的 Skill 编成组（比如"写作三件套"），一个开关整组启停。分组只是"贴标签"，删除分组不影响 Skill 本身；内置能力不参与开关（会如实提示）。

🖼 看图升级：放大、翻页、快捷键

对话里的生成图片和手帐里的图片，点开后现在是完整的看图模式：滚轮指哪放大哪、拖拽平移、双击放大/复位、← → 翻看相邻图片（自动预载不白屏）、Esc 关闭、+ − 0 缩放复位。

🎴 角色卡：自定义 Agent 一键分享

Agent 角色页的自定义 Agent 现在可以「导出」成一张角色卡文件（JSON），换电脑或分享给朋友后一键导入。导入前会先给你看卡里的内容（叫什么、会什么、用什么模型），确认才落地；重名自动改名绝不覆盖；卡里指定的模型本机没有时自动改走智能路由。

优化与修复

• Kimi K3 全系接入：新增 Kimi K3（标准 API，1M 上下文旗舰推理）、K3 Coding 端、K2.7 Code 高速版（实测快 5 倍上下）三个新模型；全部按官方文档核对并经真机实测（对话 / 工具调用 / 看图）后收录。现有 Kimi 模型不受影响，老配置继续可用。注意：Coding 端 K3 与高速版需要相应 Kimi 订阅档位。
• 组件更新进度更清爽：安装/更新语音、文字识别组件时，进度区不再闪过 "False" 之类的底层日志字样（那是组件内部日志，不是出错）。

升级方式

• 2.1.1 及以上版本：应用内提示更新后，点「重启完成更新」即可（约 20MB 轻量更新，几秒完成）。
• 2.1.0 及更早版本：会自动下载完整安装包；如安装时闪退，把安装包复制到桌面再双击运行即可，装完这次以后就都是轻量更新了。
• 数据（会话、记忆、API Key）不受升级影响。