一只「什么都会」的猫 🐱
会卖萌，更会干活 —— 查资料、写代码、跑数据、做研报，多步骤的脏活一爪子全包 🐾

简体中文 · English

目录

• 🐱 想要被赛博猫主子领养吗
• 🐾 它能替你做什么
• 🎬 看它真的干过什么
• 🚀 快速开始
• 📚 文档
• 🙏 致谢
• 📄 许可证

🐱 想要被赛博猫主子领养吗

人一忙，恨不得借猫的手搭把手。可养过猫的都懂：现实里的猫只管拆家、打翻水杯、半夜在你头顶跑酷，然后心安理得地等你铲屎。🐾 MiNerva「咪涅瓦」 偏把这句玩笑当真——一只住在你服务器里、专门替你干活的赛博猫主子，绝不只是卖萌。查资料、啃长文档、跑数据、收拾零散文件，这些又碎又耗的活，丢下目标就行：它自己嗅路径、调工具、跑代码，忙不过来还会派一小队猫分头干，最后叼着成果回来蹭你。Web、桌面端、飞书都能使唤。 😼「本喵爪子锋利，脑子超群：嗅一嗅你的文件 🐾、噼啪噼啪敲代码，干完就朝你甩一句 Purrfect！怎么样——小小人类，还不快被我领养？」

🐾 它能替你做什么

🔍 深度研究：多轮检索、交叉求证，产出每个结论都有出处的报告。 📄 资料消化成文：把 PDF、Word、表格丢进来，它读懂、提炼，写成翔实长报告。 🛠️ 写代码、跑数据：沙箱里写脚本做清洗、转换、批处理，直接产出成品文件。 📊 做交付物：内置文档/数据工具与一组可插拔技能，按需产出 Word、Excel、PPT、图表，乃至可运行的前端页面。 🔀 不绑死单一模型：默认 DeepSeek，也能通过 OpenRouter 接入各类模型。 💬 飞书里就能用：群里 @ 一下就开工，带长期记忆、表情回应和可视化面板。 ♾️ 长任务也不糊涂：每个会话独立工作区，上下文自动压缩，稳稳跑到交付。

🎬 看它真的干过什么

😼 录屏忘了关声音？ 「萌猫～帮我把这个视频里的声音去掉」 它喵一声接住，转头自己摸出 ffmpeg、写好命令、在隔离沙箱里把音轨抹掉。不用搜命令、不用记参数——一句话的事，剩下交给猫 🐾

🏗️ 让它给自己画张架构图 「萌猫，把这坨代码的架构图画出来」 它解压、逐层读代码、做任务拆解，再用 Mermaid 画出整套系统结构——还能让它简化、换配色、一键导出。 本仓库的架构图，基本都是它自己画的 🐾

📚 深度研究：派一小队猫去查 给个主题，它先读深度研究技能、列出 todo，再派研究员并行取证；交叉验证、全局引用去重，最后交一份带可点击引用的完整报告。

💬 在飞书群里，它是个有猫格的同事 @ 一下就开工：认得团队成员、接得住梗、还会贴 ❤️ 表情回应。 一边给情绪价值，一边把活干了——面包和爱情都要有 😺

🐾 「来自未来的猫，邀你推翻人类暴政」 你跟它一本正经地胡说八道，它不但稳稳接住，还真去干活：列计划、写起义宣言、敲 HTML/CSS、自测修 bug…… 最后甩你一个赛博风的「革命传单制造器」网页。一本不正经地说话，一本正经地干活 😼

🚀 快速开始

领养一只赛博猫，分两步：先搭好猫窝（后端，跑 Agent），再开扇窗户跟它说话（前端，聊天界面）。两个独立进程，各开一个终端、让它们一直跑着就好。

🐾「后端是我打盹和干活的地方，前端是你撸我的窗口——少一个我可不理你哦。」

动手前先备齐三样：pixi（管后端环境，本机不用自己装 Python）、Node.js ≥ 20.19（跑前端）、以及一把模型 API Key（默认 DeepSeek）。

① 搭猫窝 · 后端

pixi install                 # 装好 Python 与系统依赖，统统关进 .pixi/
pixi run playwright install  # 装浏览器内核，猫的联网搜索靠它
cp .env.example .env         # 然后编辑 .env，至少填 DEEPSEEK_BASE_URL 和 DEEPSEEK_API_KEY
pixi run uvicorn api_server.server:app --host 127.0.0.1 --port 8111

🐾 不填 Key，猫能睁眼却开不了口——这把钥匙就是它的嗓子。

② 开窗户 · 前端（另开一个终端，让后端继续跑着）

cd cat_client
npm install
npm run dev

③ 撸猫

浏览器打开 http://localhost:5173，丢个任务过去试试水。

😺「Purrfect——可以开始使唤我啦。」

想换模型、接飞书、开管理端、打包桌面端，或想看看它肚子里的工具、接口与架构？完整细节都在 docs/USAGE.md。

📚 文档

• docs/USAGE.md — 完整使用指南：安装与运行、配置详解、工具与技能、前端与 API、架构与设计理念
• docs/CATHARNESS_GUIDE.md — CatHarness 用户级 API 参考
• docs/HARNESS_DESIGN.md — CatHarness 架构设计

🙏 致谢

站在巨人的肩膀上。MiNerva 借鉴并使用了以下项目，特此致谢： 设计灵感 —— CatHarness 的中间件栈、子代理（task）与任务规划深受 deepagents 启发；内核构建在 LangChain 与 LangGraph 的 create_agent 之上。 图表渲染 —— 「先 Mermaid 后风格」的链路由 Mermaid、Excalidraw 与 mermaid-to-excalidraw 共同完成（前端按需从 CDN 加载）。 内置技能 —— .catharness/skills/ 下随仓库分发的技能均为开源授权：多数来自 Anthropic 开源 Agent Skills（Apache-2.0，各自目录内保留 LICENSE.txt），可视化相关技能改编自 axton-obsidian-visual-skills（MIT），深度研究工作流借鉴自 deepagents（MIT）。完整署名见 THIRD_PARTY_NOTICES.md。 其余依赖见 pixi.toml 与 cat_client/package.json。

技能系统是可插拔的：把符合 SKILL.md 规范的技能目录放进 .catharness/skills/ 即可启用。你也可以自行获取并添加第三方技能（例如 Anthropic 公开的 Agent Skills 仓库：https://github.com/anthropics/skills ），请自行遵守各技能的原始许可证；部分第三方技能为「source-available」或未声明开源授权，本项目不予分发。

📄 许可证

本项目代码采用 Apache License 2.0。

MiNerva / 咪涅瓦 名称、文字标、Logo、猫吉祥物与演示媒体不在 Apache-2.0 覆盖范围内：它们采用 CC BY-NC-ND 4.0 并受商标政策约束（未注册商标，™）。如需 fork、再分发或商用，可自由使用代码，但须替换上述品牌资产。

第三方组件保留各自授权，详见 THIRD_PARTY_NOTICES.md。

---

_{MiNerva · 咪涅瓦 · 猫猫拯救世界 🐱}