从零编译CoucoumacOS XcodeGen与Windows Tauri 2双平台构建教程【免费下载链接】coucouA tiny friend that lives in your notch (macOS) or at the top of your screen (Windows, Linux) and keeps an eye on your coding agents: Claude Code, Gemini CLI, Antigravity and more.项目地址: https://gitcode.com/gh_mirrors/co/coucouCoucou是一款开源的桌面伙伴应用用于实时盯着你的 Claude Code 会话一个叫 Mochi 的小家伙住在 MacBook 刘海里Windows 上则趴在屏幕顶部帮你批准权限、查看进度、聊天和拖入文件。本文是一份面向新手的完整构建指南带你从零在 macOSXcode XcodeGen和 WindowsTauri 2 Rust双平台编译 Coucou全程只需几条命令。构建前先了解Coucou 的双平台架构在动手之前先花 1 分钟搞清楚两个平台的构建工具链后面就不会迷路平台技术栈构建工具源码位置 macOSSwift 6 SwiftUI AppKit零第三方依赖Xcode XcodeGenNotchBuddy/Sources/App/ WindowsTauri 2Rust 后端 TypeScript 前端Cargo Node NSISwindows/src/ 与 windows/src-tauri/两个平台共用同一套 28 个音效文件全部存放在 NotchBuddy/Resources/sounds/Windows 端通过 windows/vite.config.ts 里的SOUNDS_DIR引用不会重复拷贝。macOS 构建一键安装 XcodeGen环境要求macOS 15、Xcode 16建议装最新版以及 XcodeGen。为什么需要 XcodeGen因为 Coucou 遵循「project.yml 为唯一事实来源」的规则——永远不要手动编辑.xcodeproj所有工程配置签名、部署目标、双 Target都声明在这个 YAML 文件里由 XcodeGen 生成。# 安装 XcodeGen 并克隆仓库 brew install xcodegen git clone https://gitcode.com/gh_mirrors/co/coucoumacOS 编译三步生成工程并构建 Debug 版进入项目目录一条命令生成 Xcode 工程cd coucou/NotchBuddy xcodegen # 从 project.yml 生成 NotchBuddy.xcodeproj open NotchBuddy.xcodeproj # 然后按 ⌘R 运行如果你更喜欢纯命令行官方推荐的构建命令是见 CLAUDE.mdxcodebuild -scheme NotchBuddy -configuration Debug build为什么 Debug 构建零配置就能跑打开 project.yml 可以看到Debug 配置下CODE_SIGNING_REQUIRED: NO即本地调试完全不需要 Apple 开发者账号只有 Release 配置才启用 Developer ID 签名。工程里还定义了第二个 schemeCoucouAppStoreApp Store 分发版沙盒签名新手开发阶段用不到它。 小技巧改动工程结构后比如新增 Swift 文件所在目录重新运行xcodegen即可这是仓库约定的工作流详见 CONTRIBUTING.md。macOS 进阶一条脚本完成 Release 打包与公证如果想产出可分发的正式版本仓库提供了完整的发布脚本 scripts/release.sh它会自动完成六件事查找本机Developer ID Application签名证书xcodegen generate重新生成工程xcodebuild以 Release 配置构建并签名压缩为 Coucou.zip 并提交 Apple 公证notarytoolstapler装订公证票据打 git tag 并创建 Release用法./scripts/release.sh 0.2.0版本号参数必填。Windows 构建安装 Rust、Node 与 MSVC环境要求三项缺一不可Rust 工具链通过 rustup 安装Node 20负责前端构建Vite TypeScriptMSVC 构建工具Visual Studio Build Tools勾选「使用 C 的桌面开发」组件WebView2 在 Windows 10/11 上已预装无需处理与 macOS 版不同Windows 版没有刘海Mochi 会收进屏幕顶边、随时探出头细节差异可参考 windows/README.md。Windows 编译最快打包安装器的方法cd coucou/windows npm install npm run tauri dev # 开发模式热重载屏幕顶部立刻出现 Mochi npm run pack # 正式构建产出 NSIS 安装器几个值得知道的细节都能从 windows/package.json 里对应上predev/prebuild钩子会自动先编译 windows/hook/ 里的coucou-hook.exe——这是 Claude Code 钩子的中转可执行文件负责通过命名管道把会话事件转给主程序pack脚本tauri build windows/scripts/pack.mjs先构建安装器再把它从target/release/bundle/nsis/复制到windows/release/产出同名的Coucou-Windows-X.Y.Z-setup.exe和滚动名Coucou-Windows-setup.exe那个 240×6、透明、置顶、不进任务栏的「岛屿窗口」全部配置在 windows/src-tauri/tauri.conf.json 中。不装也能跑构建完成后直接运行target/release/coucou.exe即可没有任务栏图标、没有控制台窗口——屏幕顶部的小岛和托盘里的 Mochi 就是整个应用。构建后第一次运行与常见问题排查两个平台构建完成后第一次运行都需要做同一件事安装 Claude Code 钩子。点菜单/托盘图标 →Settings… → Claude Code → Install hooks…Coucou 会先备份~/.claude/settings.jsonWindows 为%USERPROFILE%\.claude\settings.json展示精确的 diff你确认点击后才会写入。密钥统一存入 macOS 钥匙串或 Windows 凭据管理器永不落盘。常见问题速查表症状原因解决xcodegen: command not found未安装 XcodeGenbrew install xcodegenmacOS 首次启动提示「无法验证开发者」本地构建未公证系统设置 → 隐私与安全性 → 仍要打开仅一次Windows 构建卡在 MSVC 检查缺 C 构建工具重装 Build Tools 并勾选「使用 C 的桌面开发」改了源码后 Mochi 动画没变化前端未重新构建重新npm run tauri dev开发模式支持热重载总结双平台构建路线一图流macOSbrew install xcodegen→cd NotchBuddy xcodegen→ ⌘R 或xcodebuild要发版就跑scripts/release.shWindows装好 Rust / Node 20 / MSVC →cd windows npm install→npm run tauri dev尝鲜、npm run pack打包 想深入原理推荐按顺序阅读docs/SPEC.md行为与状态机说明→ windows/README.mdWindows 版差异→ CONTRIBUTING.md贡献规则从克隆到 Mochi 在屏幕顶部向你挥手macOS 端约 5 分钟、Windows 端约 10 分钟。现在就动手试试吧——Mochi 正在等它的第一位造访者。【免费下载链接】coucouA tiny friend that lives in your notch (macOS) or at the top of your screen (Windows, Linux) and keeps an eye on your coding agents: Claude Code, Gemini CLI, Antigravity and more.项目地址: https://gitcode.com/gh_mirrors/co/coucou创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考