1. 项目概述Xylocopa一个为多项目AI编程代理设计的注意力管理系统如果你和我一样同时维护着好几个代码项目每天脑子里塞满了各种待办事项——“给A项目加个新功能”、“B项目的那个bug得修一下”、“C项目的文档还没更新”——那你肯定懂那种感觉注意力像蜜蜂一样在花丛间乱飞最后哪朵花都没采好蜜。传统的待办事项列表To-Do List在这种多项目、高并发的开发场景下很快就失效了因为你很难一眼看清哪个任务最紧急、哪个项目最需要跟进更别提把这些任务交给AI代理去执行了。这就是Xylocopa要解决的问题。它不是一个简单的任务管理器而是一个为AI编程代理特别是Claude Code设计的注意力管理系统。你可以把它想象成一个“数字蜂巢”你就是蜂后负责下达指令和做关键决策而大量的AI代理就是工蜂它们在你的指挥下并行地在不同的项目“花朵”上辛勤工作。Xylocopa的核心价值在于它帮你把“做什么”任务捕获与决策和“怎么做”任务执行与监控分离开来让你能专注于战略层面而把战术执行交给可靠的AI代理。我花了几个月时间深度使用和测试Xylocopa它彻底改变了我管理多个AI辅助编程项目的方式。以前我需要在多个终端窗口、笔记应用和项目管理工具之间来回切换现在所有东西都集中在一个地方一个支持多屏分割的Web界面或者直接在我的手机PWA上。更重要的是它让AI代理的工作变得可追溯、可复用、可积累。一个代理在某次任务中踩过的坑、学到的经验会被系统自动总结并存入项目知识库当下一个代理处理类似任务时就能直接调用这些经验避免重蹈覆辙。这种“经验复利”效应是单个、孤立的Claude Code会话无法实现的。1.1 核心需求解析为什么需要Xylocopa你可能会问Claude Code本身不是挺好用的吗为什么还要套一层Xylocopa这个问题问到了点子上。Claude Code是一个强大的单会话AI编程工具但它生来就不是为管理多代理、多项目、长周期的复杂工作流而设计的。当你尝试用原生Claude Code去管理多个并行任务时很快就会遇到几个天花板注意力涣散你开了五六个Claude Code会话每个都在处理不同项目的问题。你怎么知道哪个会话有新的进展、哪个在等待你的输入、哪个已经卡住了你不得不像玩打地鼠一样在各个终端标签页间疯狂切换效率极低。上下文断裂每个Claude Code会话都是独立的“记忆孤岛”。代理A在项目X中学到的宝贵经验比如“这个库的某个版本有兼容性问题”代理B在项目Y中完全不知道下次遇到同样问题还得从头摸索。知识的传递完全依赖你的人工记忆和转述这违背了使用AI的初衷。状态易失终端会话说没就没。电脑重启、网络波动、甚至不小心关错标签页都可能导致一个进行到一半的、有价值的AI对话丢失。虽然Claude Code有历史记录但找回并恢复到之前的状态非常麻烦。操作繁琐为每个新任务手动创建目录、初始化git、启动Claude会话、复制粘贴上下文……这些重复性劳动占据了大量时间。Xylocopa正是为了解决这些痛点而生。它基于经典的GTDGetting Things Done方法论构建了一个“捕获-分派-监控-回顾-记忆”的闭环但关键创新在于你只负责“捕获”输入想法和“回顾”审核结果而“分派”、“监控”和“记忆”这三个最耗时的环节全部由系统自动化完成。这让你能真正从繁琐的“任务执行管理”中解放出来回归到“创造性决策”的核心角色。2. 架构设计与核心组件拆解Xylocopa的架构设计非常清晰遵循了“前后端分离本地优先”的原则所有组件都运行在你的开发机上数据也完全由你掌控。理解这个架构对于后续的部署、调试和深度定制至关重要。2.1 整体架构一个本地化的AI代理指挥中心整个系统由三个核心部分组成它们协同工作构成了一个稳定的三角结构前端Frontend一个基于React 19构建的渐进式Web应用PWA。这是你和系统交互的主要界面。它的设计是“移动优先”的这意味着即使在手机小屏幕上也能获得完整的功能体验。你可以通过浏览器访问也可以将其“添加到主屏幕”获得一个类似原生App的体验并接收推送通知。后端Orchestrator一个基于Python FastAPI构建的编排器。这是系统的大脑负责所有核心逻辑任务队列管理、AI代理的生命周期调度、与Claude Code CLI的通信、安全钩子Safety Hook的执行、以及数据的持久化使用SQLite。它通过WebSocket与前端保持实时连接推送状态更新。Claude Code CLI Tmux这是实际执行AI代理任务的“肌肉”。Xylocopa并不替代Claude Code而是包装和增强它。每个AI代理任务后端都会在一个独立的tmux会话中启动一个claude进程并且为每个任务创建一个独立的git工作树worktree确保任务间的环境完全隔离互不干扰。它们之间的关系以及数据流向可以概括为你在前端下达指令 - 后端接收指令创建任务和隔离环境 - 后端在tmux中启动Claude进程执行任务 - Claude通过安全钩子与后端通信后端通过WebSocket将实时进度推送到前端。2.2 关键技术栈与选型理由FastAPI (后端)选择FastAPI而非Django或Flask主要看中其异步高性能、自动生成的交互式API文档Swagger UI以及强大的数据验证Pydantic。这对于需要处理大量实时事件如工具调用、消息流的代理编排场景非常合适。SQLite (数据存储)对于个人或小团队使用的工具SQLite是绝佳选择。它无需单独部署数据库服务单文件管理方便备份和迁移在并发读写不是极端高的情况下性能完全足够。Xylocopa的数据模型任务、项目、代理、会话并不复杂SQLite游刃有余。Tmux (会话管理)这是Xylocopa可靠性的基石。Tmux允许进程在后台持续运行即使你关闭了SSH连接或终端窗口。Xylocopa利用这一点确保AI代理任务不会因为前端刷新或网络断开而中止。同时tmux attach命令让你可以随时从命令行切入任何一个正在运行的代理会话进行手动干预实现了Web UI和CLI的无缝双向同步。Git Worktree (环境隔离)为每个代理任务创建独立的git工作树是一个极其巧妙的设计。它保证了隔离性代理A在修改feature-a分支的文件时绝不会影响到代理B正在工作的main分支。原子性任务完成后你可以清晰地在对应工作树中查看所有代码变更git diff并决定是合并、丢弃还是另作处理。零冲突从根本上避免了多个代理同时修改同一分支导致的合并冲突。PWA (前端交付)采用PWA而非开发独立的iOS/Android原生应用极大地降低了开发和维护成本同时实现了“一次编写多处运行”。通过Service Worker实现离线缓存和推送通知用户体验接近原生App。对于这样一个工具属性极强的应用PWA是性价比最高的方案。实操心得Tmux工作树的理解刚开始接触时我对“每个代理一个tmux会话一个git worktree”的设计有点疑惑。直到有一次我同时让两个代理分别修复同一个项目的两个不同bug才体会到这个设计的美妙。两个代理在各自的工作树里噼里啪啦地改代码提交记录清晰独立。我可以在Web UI上同时监控它们的进度最后轻松地将两个修复分别合并回主分支整个过程行云流水完全没有传统多分支开发的切换成本和冲突风险。3. 核心工作流与功能深度解析Xylocopa的价值需要通过其设计精巧的工作流来体现。下面我们深入GTD循环的每一个环节看看它是如何具体运作的。3.1 捕获Capture让灵感无处可逃“捕获”的核心目标是降低记录想法的摩擦。Xylocopa提供了多种低门槛的输入方式收件箱Inbox一个全局的、跨项目的任务队列。任何来不及细想的任务都可以先扔进去。语音输入集成OpenAI Whisper需要API Key。走在路上突然有个灵感直接对着手机说就行语音实时转文字存入收件箱。这个功能对我这种经常在通勤时思考问题的人特别有用。闪电输入Web界面或PWA上有一个常驻的“”按钮。短按直接弹出输入框只需要填写标题和选择关联项目即可快速创建任务适合捕捉那些简单明确的想法。注意事项本地草稿持久化所有文本输入框都集成了本地草稿保存。这意味着即使你正在输入一个很长的任务描述时App崩溃或者网络断开刚才输入的内容也不会丢失。系统会定期每几秒将输入内容缓存到浏览器的localStorage中。恢复后内容会自动填充回来。这个细节极大地提升了使用的安全感。3.2 分派Dispatch从任务到自治代理这是魔法开始的地方。在收件箱里选中一个任务点击“分派”一个AI代理就诞生了。这个过程背后发生了很多事环境初始化系统在后台为你选定的项目目录下创建一个以任务ID命名的git工作树。这相当于为代理开辟了一个独立的沙箱。上下文注入RAG系统会检索该项目下的PROGRESS.md文件项目记忆库以及过往的会话记录找出与当前任务最相关的历史经验和上下文自动附加到给Claude的初始系统提示System Prompt中。这相当于给新代理配了一位“老向导”。代理启动在一个独立的tmux会话中启动Claude Code CLI并附上精心构建的指令和上下文。你可以为代理选择模型Opus, Sonnet, Haiku也可以开启“自动模式”跳过部分权限确认但仍有安全钩子保护。跨会话引用这是非常酷的一个功能。如果任务描述中写着“参考一下xy-session-123的做法”代理可以通过一个内置的MCPModel Context Protocol服务器去读取session-123的“精选显示文件”。这个文件是会话JSONL的精华摘要体积比原始JSONL小约54倍使得这种跨会话的上下文传递变得极其高效不会轻易撑爆模型的上下文窗口。3.3 监控Monitor全景式上帝视角分派出去的任务不是石沉大海。Xylocopa提供了强大的实时监控能力注意力按钮这是UI设计的精髓。一个悬浮的、带有未读计数徽章的按钮。点击它会直接跳转到最旧的需要你关注的会话FIFO队列。长按它则可以打开分屏视图同时监控多个会话。分屏视图支持2、3、4个窗格并排显示每个窗格可以独立浏览不同的项目或代理会话。这对于需要对比代码、或者同时跟进多个相关任务时非常有用。双向CLI同步你在Web UI上启动的代理会生成一个xy-id格式的tmux会话。你可以随时SSH到服务器用tmux attach -t xy-id命令切入这个会话看到AI正在执行的具体命令和输出甚至可以手动输入指令进行交互。反过来如果你直接在终端用claude命令启动了一个会话只要Xylocopa后端在运行这个会话也会自动出现在Web UI的“未关联会话”列表中等待被你“收养”和管理。这种双向自由切换给了你最大的灵活性。智能通知系统通过WebSocket感知你的在线状态。如果你正在Web UI上查看某个代理那么该代理的新消息就不会触发推送通知避免打扰。只有当你离开比如关闭了浏览器标签时重要的状态更新如任务完成、需要权限确认才会通过Web Push或Telegram通知你。3.4 回顾Review与记忆Remember让经验产生复利任务执行完毕工作并未结束。回顾环节是提升AI代理效能的关键。尝试 - 总结 - 重试如果代理跑偏了或者没达到预期你不必从头开始。点击“停止并总结”Xylocopa会自动让AI分析刚才的整个会话生成一份“尝试了什么、结果如何、问题在哪”的摘要。然后你可以基于这个摘要创建一個新的任务分派给下一个代理。新代理会带着这份总结开始工作避免了重复劳动。项目记忆PROGRESS.md这是每个项目根目录下的一个Markdown文件是项目的“集体智慧”。你可以手动编辑它记录重要的架构决策、踩坑记录、最佳实践。更重要的是Xylocopa会自动将那些“尝试-总结”环节产生的有价值经验建议性地添加到这个文件中。未来当新的代理处理类似任务时系统会通过RAG检索将这些经验作为上下文注入形成正向循环。会话归档与全文搜索所有AI对话都被完整保存。你可以给重要的会话加星标也可以通过全文搜索快速找到过去某个关于“数据库连接池”的讨论。这种可追溯性对于知识管理和团队协作如果未来有团队版价值巨大。4. 安全性与可靠性设计剖析让AI代理在本地环境中自动运行代码安全是头等大事。Xylocopa在安全性和可靠性上做了多层设计这也是我敢放心使用它的原因。4.1 确定性的安全护栏Safety Guardrails这是最核心的安全机制。即使你为代理开启了--dangerously-skip-permissions模式即“自动模式”允许代理自动运行一些工具而无需每次确认Xylocopa的后端安全钩子PreToolUse依然会进行最终审查。这个钩子会硬性拦截以下类型的危险操作破坏性文件操作如rm -rf /、rm -rf ..等试图删除项目根目录之外文件的操作。破坏性Git操作如git push --force强制推送、git reset --hard在非工作树内执行、git clean -f强制清理未跟踪文件等可能造成历史丢失的操作。破坏性数据库操作如DROP TABLE、TRUNCATE TABLE等。越界写操作任何试图向项目目录之外的文件路径进行Write或Edit的操作。这个检查是确定性的基于规则列表发生在Claude Code CLI真正执行命令之前。如果命令被拦截你会在前端收到一个清晰的提示告诉你哪个命令因安全原因被阻止了。这相当于在“油门”自动模式和“刹车”安全规则之间取得了平衡。4.2 “默认持久”的可靠性工程Xylocopa的座右铭似乎是“任何工作都不应是临时的”。它在各个层面都设计了持久化和恢复机制会话缓存每30秒系统会将Claude Code生成的JSONL会话文件增量式地缓存到自己的数据库中类似于Git的包文件机制。即使Claude进程意外崩溃也能从缓存中恢复出绝大部分对话。无限期保留它会修改你的Claude Code设置~/.claude/settings.json将cleanupPeriodDays设置为36500约100年防止Claude自动清理历史会话。进程崩溃恢复如果AI代理进程被意外杀死恢复程序_recover_agents()会尝试从系统的/tmp/claude-output-*.log临时文件中抢救出部分标准输出并持久化然后重新排队该任务。Tmux锚定恢复系统重启后Xylocopa会扫描所有tmux会话。如果发现仍有存活的、前缀为xy-或ah-的会话它会自动将这些会话重新链接到管理界面中恢复其状态。这意味着只要tmux会话没死你的代理任务就能在系统重启后“复活”。定期备份数据库、配置文件、会话历史都会按可配置的时间间隔自动备份到backups/目录并按照保留策略清理旧备份。踩坑记录理解“孤儿清理”有一次我手动kill -9了几个卡住的Claude进程然后发现Xylocopa的Web UI里对应代理状态一直异常。后来才明白进程虽然死了但对应的git工作树和tmux会话可能已僵尸化还残留着。这时需要运行系统提供的orphan_cleanup.py脚本或等待其定时任务执行来清理这些“孤儿”资源。理解这一点后在手动干预底层进程时就更谨慎了或者记得事后跑一下清理。5. 实战部署与配置指南理论说再多不如动手装一遍。下面是我在Ubuntu 22.04服务器上从零部署Xylocopa的完整过程包含了一些官方文档没细说的细节和避坑点。5.1 环境准备与依赖安装官方列出了基础依赖但有些细节需要注意# 1. 更新系统并安装基础编译工具 sudo apt update sudo apt upgrade -y sudo apt install -y build-essential curl git tmux # 2. 安装Node.js 18 (推荐使用nvm方便管理版本) curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.39.7/install.sh | bash # 重新打开终端或执行 export NVM_DIR$HOME/.nvm [ -s $NVM_DIR/nvm.sh ] \. $NVM_DIR/nvm.sh [ -s $NVM_DIR/bash_completion ] \. $NVM_DIR/bash_completion nvm install --lts # 安装最新的LTS版本如20.x nvm use --lts node --version # 确认版本 # 3. 安装Python 3.11 sudo apt install -y python3.11 python3.11-venv python3.11-dev # 设置python3.11为默认可选但推荐 sudo update-alternatives --install /usr/bin/python3 python3 /usr/bin/python3.11 1 # 4. 安装Claude Code CLI npm install -g anthropic-ai/claude-code # 首次运行完成认证 claude # 如果是无头服务器没有浏览器使用 # claude setup-token # 按照提示在另一台有浏览器的机器上打开链接完成认证。5.2 使用一键安装脚本这是最推荐的方式脚本会交互式地引导你完成所有配置。curl -fsSL https://raw.githubusercontent.com/jyao97/xylocopa/master/setup.sh | bash脚本执行过程中你会被问到几个关键问题项目目录你的代码项目存放在哪里默认是~/xylocopa-projects。你可以指定一个已存在的目录。默认Claude模型新建代理时默认使用的模型Opus, Sonnet, Haiku。OpenAI API密钥如果你想使用语音输入功能需要提供。这是可选的可以直接跳过。服务端口后端API端口默认3001和前端Web端口默认3000。脚本会自动创建Python虚拟环境、安装依赖、生成自签名SSL证书、创建.env配置文件并启动服务。重要提示SSL证书警告由于使用的是自签名证书首次在浏览器访问https://你的IP:3000时会看到安全警告。这是正常的。你需要点击“高级”-“继续前往”之类的选项。对于将其安装为PWA尤其是iOS设备必须信任这个证书否则PWA无法正常工作。后续的“客户端设置”部分会详细说明。5.3 手动安装与深度配置如果你想更精细地控制安装过程或者脚本安装遇到问题可以手动进行git clone https://github.com/jyao97/xylocopa.git ~/xylocopa-main cd ~/xylocopa-main # 1. 复制环境变量模板并编辑 cp .env.example .env nano .env # 或使用你喜欢的编辑器以下是.env文件中几个关键配置项的解读# 项目目录 - 所有被管理的代码仓库都放在这个目录下 HOST_PROJECTS_DIR/home/yourname/xylocopa-projects # Claude Code 可执行文件路径通常安装后自动找到 CLAUDE_PATH/home/yourname/.nvm/versions/node/v20.x.x/bin/claude # 默认AI模型 DEFAULT_CLAUDE_MODELclaude-3-5-sonnet-20241022 # OpenAI API密钥 (用于语音输入可选) OPENAI_API_KEYsk-... # 后端服务绑定地址和端口 HOST0.0.0.0 # 监听所有网络接口方便远程访问 BACKEND_PORT3001 # 前端服务端口 FRONTEND_PORT3000 # 数据库路径 DATABASE_URLsqlite:///./data/orchestrator.db # 安全相关会话密钥、密码加密盐 SECRET_KEYyour_very_strong_secret_key_here # 务必修改 PASSWORD_SALTanother_strong_salt编辑完成后运行安装脚本./setup.sh # 这会基于你的.env文件进行非交互式安装 ./run.sh start # 启动服务使用./run.sh status检查服务状态./run.sh logs查看日志。5.4 配置系统服务PM2实现开机自启为了让Xylocopa在服务器重启后自动运行并且不受当前终端会话生命周期的影响我们需要用PM2将其托管为系统服务。# 在Xylocopa目录下执行 ./run.sh startup这个命令会做两件事将当前由run.sh管理的进程backend和frontend保存到PM2的应用列表。根据你的操作系统Linux systemd 或 macOS launchd生成并启用开机自启动脚本。在Linux上尤其要注意命令执行后它会打印出一行类似下面的sudo env ...命令。你必须原封不动地复制这行命令并执行它。这一步是将PM2的启动脚本链接到系统服务管理器。# 示例输出你需要执行的命令 sudo env PATH/home/yourname/.nvm/versions/node/v20.x.x/bin:$PATH /home/yourname/.nvm/versions/node/v20.x.x/lib/node_modules/pm2/bin/pm2 startup systemd -u yourname --hp /home/yourname执行后你的Xylocopa服务就变成了系统服务。即使你退出SSH甚至服务器重启它都会自动运行。要停止开机自启pm2 unstartup systemd。5.5 客户端访问与PWA安装服务跑起来后你可以在同一局域网内的任何设备上通过浏览器访问https://服务器IP:3000。首次访问设置密码第一次打开会要求你设置一个管理员密码。请务必使用强密码因为这是保护你所有项目和AI代理访问权限的唯一关卡。远程访问方案如果你想在外网访问家里的Xylocopa强烈不建议直接进行端口转发这有安全风险。推荐使用安全的组网工具Tailscale最推荐基于WireGuard配置极其简单。在服务器和你的手机/电脑上分别安装Tailscale客户端登录同一个账号它们就会在一个安全的虚拟局域网内互通。然后直接用Tailscale分配的IP访问即可。Cloudflare Tunnel如果你有域名和Cloudflare账号也可以使用Cloudflare Tunnel它会创建一个加密隧道无需开放公网端口。iOS/Android PWA安装在手机Safari或Chrome中打开https://你的IP:3000。忽略证书警告高级-继续访问。在登录页面通常会有“安装CA证书”和“添加到主屏幕”的引导。对于iOS必须安装提供的CA证书描述文件否则PWA无法正常工作。按照页面指引操作即可。安装后你手机桌面上就会出现Xylocopa的图标点开就是一个全屏的、支持推送通知的App了。6. 高级使用技巧与问题排查掌握了基础部署我们来看看如何高效使用它以及遇到问题怎么办。6.1 高效使用模式收件箱零库存养成习惯任何想法、任务第一时间用语音或闪电输入扔进收件箱。每天固定时间如早上集中处理收件箱进行分派或细化描述。这符合GTD的“清空大脑”理念。善用项目记忆PROGRESS.md不要把它当成一个自动生成的日志。主动去编辑它把项目的核心设计思路、部署命令、常见错误解决方案写进去。你喂给它的高质量信息越多它反馈给AI代理的上下文就越有价值。分屏监控复杂任务当一个任务涉及多个文件或需要参考其他会话时果断使用分屏功能。左边是代理A在写代码右边是代理B在写测试中间是项目的PROGRESS.md效率倍增。CLI与Web无缝切换当AI代理的推理过程让你困惑或者你想手动执行一些复杂命令时不要犹豫直接用tmux attach切入对应的会话。检查完或操作完后Ctrlb ddetach回来Web UI上的状态依然是同步的。6.2 常见问题与解决方案速查表问题现象可能原因解决方案前端页面无法加载/白屏1. 后端服务未启动。2. SSL证书不受信任。3. 防火墙阻止了3000/3001端口。1. SSH到服务器运行./run.sh status和./run.sh logs查看后端状态和错误日志。2. 在浏览器中手动信任证书高级-继续访问。对于PWA必须安装CA证书。3. 检查服务器防火墙规则sudo ufw status确保3000和3001端口开放。AI代理状态一直显示“IDLE”空闲1. 代理进程可能处于长时间“思考”中没有新的工具调用触发心跳。2. 后端与Claude Code的钩子连接可能有问题。1. 这是正常现象。状态更新依赖于工具调用事件。你可以尝试在聊天框中给代理发送一条消息如“请继续”来触发一次活动状态通常会更新为“EXECUTING”。2. 检查~/.claude/mcp_servers.json文件确保其中有指向Xylocopa后端/mcp端点的正确配置。重启Claude Code进程可能有助于重新建立连接。语音输入功能不工作1. 未在安装时提供OpenAI API Key。2. 提供的API Key无效或余额不足。3. 浏览器未授予麦克风权限。1. 编辑.env文件添加正确的OPENAI_API_KEY然后重启服务./run.sh restart。2. 检查OpenAI账户状态。3. 在浏览器设置中确保该网站有使用麦克风的权限。PWA卡在加载界面Service Worker缓存过期或损坏。在服务器上运行cd ~/xylocopa-main .venv/bin/python tools/push_reset.py。这是一个交互式工具会列出已注册的设备。通常按a重置所有设备的Service Worker缓存然后完全关闭手机上的PWA并重新打开。创建新项目失败1. 项目路径权限不足。2. Git克隆失败网络问题或仓库不存在。3. 项目目录已存在且非空。1. 确保运行Xylocopa的用户对HOST_PROJECTS_DIR有读写权限。2. 检查Git仓库URL是否正确网络是否通畅。可以尝试在服务器上手动git clone一次。3. Xylocopa要求项目目录是空的或不存在。请先清理或选择其他路径。“尝试-总结-重试”生成的总结质量差用于总结的提示词Prompt可能不适合当前任务类型或者会话历史过于混乱。目前这个功能是自动化的。如果总结不佳你可以手动介入在停止代理后不要点“总结”而是直接复制重要的对话片段粘贴到新任务的描述中作为给下一个代理的上下文。这给了你更多的控制权。6.3 性能监控与维护Xylocopa自带一个简单的系统监控面板可以查看服务器的磁盘、内存、GPU和Token使用情况。但对于长期运行建议额外关注磁盘空间~/.claude/projects/目录下会存储所有会话的JSONL文件长期积累可能占用较大空间。虽然Xylocopa设置了超长的保留期但你仍需定期检查。可以考虑写一个定时任务归档超过一定时间的、不重要的会话。进程数每个活跃的AI代理都会对应一个claude进程和一个tmux会话。如果你并行运行大量代理注意服务器的内存和CPU负载。在Web UI的监控面板可以直观看到。日志排查当遇到疑难杂症时日志是你的第一手资料。关键日志位置后端日志在Xylocopa根目录下运行./run.sh logs backend。前端日志运行./run.sh logs frontend。Claude Code日志在对应的tmux会话中查看或者看~/.claude/logs/。PM2日志pm2 logs xylocopa-backend --lines 100。经过几个月的深度使用Xylocopa已经成了我管理多个AI辅助编程项目的核心中枢。它最大的价值不是替代Claude Code而是将Claude Code从一个强大的“对话式编程伙伴”升级为一个可管理、可协作、可积累的“AI代理团队”。它处理了所有让我分心的琐事——状态管理、上下文传递、错误恢复、经验沉淀——让我能更专注于提出正确的问题和做出关键的决策。如果你也在用Claude Code进行严肃的、多项目的开发工作我强烈建议你花点时间部署和尝试一下Xylocopa。最初的配置成本会换来长期巨大的注意力红利和效率提升。