用途:该技能面向当前代码检出(checkout)中的持续开发工作,用于在受跟踪的 Electron 实例里开发、修复和性能分析 Cherry Studio,涵盖日常实现、UI 与交互、缺陷修复和运行时调试。它不用于检出或报告 PR,那类流程应使用 cherry-pr-test。
必要运行时流程:在读取或控制 Electron UI 之前,必须先阅读 Electron Instance Management 并遵循其持久化策略。该参考是实例发现、instance.json、CDP 目标选择、启动、替换、关闭和故障排查的唯一权威,不要在此重复这些步骤,也不要用通用 Electron 应用控制方式替代。
开发循环:先说明期望行为及用于证明它的证据;阅读相关代码和邻近 README;通过运行时参考验证并复用受跟踪实例;编辑前尽量复现或检查当前行为;采集最小可用证据(UI 状态、DOM、控制台/网络输出、主进程日志、持久化状态或性能指标);追踪责任代码路径,只做被请求的改动;保持 Electron 运行,渲染层改动用 HMR 并在同一窗口验证;重复同一场景并对比前后证据。UI 工作需在相关尺寸和主题下检查真实窗口,渲染层故障要同时检查渲染层与主进程证据。仅在不可热重载的层、崩溃、运行时状态不可靠或启动性能分析时重启,并按参考的精确实例替换流程操作,刷新 instance.json 并保持替换实例运行。运行最窄的相关验证,并遵循当前用户与仓库关于 lint、格式化和测试的指示。
性能与 DevTools:遇到卡顿、掉帧、高 CPU、内存增长、泄漏、启动缓慢或明确使用 DevTools 时,阅读 Performance Debugging。临时日志、截图和性能剖析文件存放在 .context/cherry-electron-dev/ 下。修复前后用安静基线与同一受限场景对比。剖析结束后分离剖析会话,但不要关闭 CDP 浏览器、页面或 Electron 进程。
交接:指令结束后,保留复用的用户自有实例和健康的由智能体启动的实例继续运行。仅在用户要求、任务本身需要重启,或实例不健康且阻碍进展时才停止实例。报告需包含已验证的 PID、是否仍在运行、CDP 端口、跟踪文件、证据路径、复现步骤和验证结果。