CLIENTS · OFFICIAL PROMPT

启动 Electron 开发环境

让 AI 启动桌面端并解释 main、preload 与 renderer 的开发边界。

难度
入门
阶段
准备 · 开发
版本
v1.0.0
更新
2026-08-30

OUTCOMES

这条 Prompt 会帮你完成什么

  • Electron 开发窗口稳定运行
  • 理解桌面端关键目录和重启边界

BEFORE YOU START

开始前准备

  • 根依赖已安装
  • 后端 API 可访问

AI 应优先了解这些位置

apps/tabtin-electronAGENTS.mddocs/agent/commands.md

READY TO RUN

完整 Prompt

复制完整 Prompt,不会遗漏执行边界和验收要求

你正在帮助我启动并理解 TabTin Electron 桌面端。我之后会在它的基础上开发自己的产品,请直接把开发环境跑通,并清楚说明哪些修改可以热更新、哪些必须重启 Electron。

开始前

阅读根 AGENTS.mddocs/agent/commands.mdapps/tabtin-electron 的包配置。检查工作树和 5175 等开发端口,确认根环境变量是当前单一来源。不要创建应用目录内的重复 .env,不要误杀与 TabTin 无关的 Electron 进程。

任务

  1. 说明 main、preload、renderer、IPC 和 native 能力各自负责什么,以及业务逻辑应放在哪里。
  2. 确认 API 与协作服务可用,然后在持久终端运行桌面端开发命令。
  3. 观察构建输出,解决依赖、原生模块、端口或环境变量错误,直到窗口稳定出现。
  4. 检查登录页、组织切换和主工作区是否能渲染;不要用假数据掩盖真实连接失败。
  5. 给出修改 renderer、main/preload、IPC 和根环境变量后的正确重载或重启方式。

验证

确认开发服务器返回成功状态,Electron 进程保持运行,开发者控制台没有阻塞错误。执行桌面端现有的类型检查或轻量测试,并至少完成一次 renderer 热更新验证。如果修改了 main、preload 或 IPC,实际重启后再次确认窗口可用。

最终汇报

列出启动命令、端口、进程状态、关键目录职责、解决的问题和后续开发建议。说明当前连接的是本地还是远程后端,以及如何安全停止环境。未经我要求,不提交或推送代码。