源码系统概览
文章正文
coucou 是一套桌面宠物小助手工具源码，它住在 MacBook 的刘海区域或 Windows 屏幕顶部，随时关注 Claude Code 会话动态。用户可以批准权限请求、观察 Agent 工作进度、拖入文件与 Claude 对话，全程不必切换窗口。
这套源码工程基于 Tauri 2 构建，桌面壳使用 Rust 与 Swift，前端使用 TypeScript 与 Vite，支持 macOS 15 与 Windows 10 以上系统。项目遵循 MIT 开源协议，适合 AI 工具使用者与桌面应用开发者参考。
源码简介
coucou 是一个跨平台桌面小助手工程，包含刘海区域窗口渲染、Claude Code 会话桥接、权限批准与文件拖放交互等模块。仓库内包含 macOS 与 Windows 双平台工程与共享前端代码。
项目的核心是让 AI 开发助手的状态始终可见，同时提供快速操作入口，减少多窗口切换带来的注意力损耗。
项目的核心是让 AI 开发助手的状态始终可见，同时提供快速操作入口，减少多窗口切换带来的注意力损耗。
窗口渲染与系统集成分离设计，刘海区域的特殊形状由原生层适配完成。
适用场景
这套源码工程主要适用于以下场景。
- AI 开发者: 边写代码边观察 Claude Code 会话进度
- 多任务办公: 在不离开当前窗口的情况下批准工具权限
- 桌面应用研究: 参考 Tauri 2 跨平台实现的工程结构
- 效率工具爱好者: 体验刘海区域的创新交互形态
技术栈与运行环境
压缩包大小: 12.1M
解压后大小: 13.5M
前端语言: TypeScript + Vite（桌面前端）
后端语言: Rust + Swift（Tauri 2 桌面壳）
项目使用 Tauri 2 作为桌面容器，macOS 端包含 Swift 原生组件用于刘海区域适配，Windows 端提供顶部悬浮窗口。前端通过 Vite 构建，与 Claude Code 的通信走本地会话桥接。
功能亮点
coucou 当前版本为 v0.1.1，仓库获得 157 个 star，最后更新于 2026 年，更新日志记录在仓库内。作者 Louis-CFM 持续维护，
- 刘海驻留: 在 MacBook 刘海区域显示状态，不遮挡内容
- 会话监控: 实时查看 Claude Code 的思考与执行状态
- 权限批准: 一键同意工具调用，减少打断
- 文件拖放: 直接拖文件进入对话上下文
- 跨平台: 同时支持 macOS 与 Windows
- 本地优先: 数据与配置均保存在本机
技术架构与部署指南
功能对比:
| 对比项 | 本项目 | Raycast |
|---|---|---|
| 形态 | 刘海/顶部宠物 | 菜单栏工具 |
| 核心场景 | Claude Code 会话监控 | 系统操作面板 |
| 技术栈 | Tauri 2 | 原生 Swift |
对比 coucou 与 Raycast 的区别，前者围绕 AI 会话做沉浸监控，后者偏重系统命令面板，使用场景明显不同。
安装与部署提示
用户可直接获取预构建安装包，macOS 版本通过应用包安装，Windows 版本提供安装程序。安装后登录 Claude Code 会话即可自动接入监控。
它们在形态和设计上各有取舍，与 Raycast 相比，核心区别集中在表格所列维度，选型时可按实际场景判断。
开发者构建需要 Rust、Node 与各平台原生工具链，项目文档提供 macOS 与 Windows 两套构建说明，产物为平台安装包。
截图与演示说明
项目 README 提供刘海窗口与设置界面截图，封面图为本站在原版基础上制作的项目宣传图。
实际使用效果为刘海区域显示小宠物动画，点击展开会话面板，可查看进度、批准权限并发送消息。
实际使用效果为刘海区域显示小宠物动画，点击展开会话面板，可查看进度、批准权限并发送消息。
设置界面提供会话列表与通知偏好，用户可按工作习惯调整展示方式。
常见问题
问. coucou 支持哪些系统版本
支持 macOS 15 及以上与 Windows 10 及以上，刘海功能仅 macOS 可用。
问. 是否必须安装 Claude Code
是，监控与交互功能依赖本地 Claude Code 会话，未安装时仅显示桌面宠物。
问. 会收集用户数据吗
不会，项目本地优先，会话状态与配置均保存在本机。
问. Windows 上如何展示
Windows 版本以屏幕顶部悬浮条形式展示，功能与 macOS 版本一致。
问. 如何安装部署这套源码
按下载说明解压后参照 README 完成环境准备，不同平台的安装命令文档中均有详细示例。
问. 项目是否免费开源
是，项目以开源协议发布，源码与文档均免费提供，可自由用于学习与二次开发。
安全风险提示
安全审查未发现后门、加密混淆或硬编码凭据，代码无异常外联，依赖均为公开框架组件。
应用可代表用户批准工具权限，请确认本机 Claude Code 会话由本人操作，避免在共享设备上长期保持自动批准。
下载说明
源码已打包为 zip 提供下载，压缩包内含 macOS 与 Windows 双平台工程，解压后按 README 指引构建安装即可。
GitHub项目开源地址 https://github.com/Louis-CFM/coucou
GitHub项目开源地址 https://github.com/Louis-CFM/coucou
压缩包内含双平台工程与资源文件，按各自构建文档即可生成平台安装包。