# vibe-coding-project-manager **Repository Path**: yzj-developer/vibe-coding-project-manager ## Basic Information - **Project Name**: vibe-coding-project-manager - **Description**: No description available - **Primary Language**: Unknown - **License**: Not specified - **Default Branch**: main - **Homepage**: None - **GVP Project**: No ## Statistics - **Stars**: 0 - **Forks**: 0 - **Created**: 2026-05-27 - **Last Updated**: 2026-05-29 ## Categories & Tags **Categories**: Uncategorized **Tags**: None ## README # Vibe Coding Project Manager 按「项目」维度管理全栈 Vibe Coding 开发:一个项目 = 多个代码仓库(web / server)+ `design` 仓库里的 common 子树。一键完成一次迭代——跨仓库 **commit + push**,并把项目内的 `.document` 与根目录规则/SKILL(common 内容)**单向镜像迁移**到 design 仓库后提交。 形态:**本地 Spring Boot 服务 + 浏览器**(不分发原生二进制,规避企业 AV 对未签名 exe 的拦截)。 ## 运行 前置:**Java 21、Node + pnpm、git**(均需在 PATH 中)。 一次性构建: ``` build.bat REM pnpm install + 前端构建 -> server/static + 打包 jar ``` 启动(生产,单服务 + Edge app 窗口): ``` start.bat REM 起 javaw 后台进程(无窗口),就绪后用 Edge app 模式打开 http://127.0.0.1:7456 ``` 启动脚本的 cmd 窗口跑完即关;Java 后端进程在后台,任务栏看不到。**关闭浏览器后约 60 秒后端自动退出**(HeartbeatService 心跳超时),不需要手工停。 紧急停止(很少需要): ``` stop.bat REM 按 7456 端口找 PID 强杀;只影响 Vibe PM,不波及其它 Java 进程 ``` 开发模式(前端热更新,双服务): > ⚠️ **`pnpm dev` 需要 Node ≥ 20.19**(Vite 7 要求)。Node 18 会报 `crypto.hash is not a function` 而无法启动 dev server;`pnpm build` 不受影响,但热更新调试须先升级 Node(推荐用 nvm-windows 装 Node 22)。 ``` REM 终端 1:后端 cd server && mvn spring-boot:run REM 终端 2:前端(热更新 + /api 代理到 7456) pnpm dev REM http://localhost:5173 ``` 浏览器开 http://localhost:5173 调试:改 `.tsx` 即时热更新(HMR),用 F12 DevTools 看 Console / Network,源码带 sourcemap 可断点。 不便升级 Node 时(**无热更新**):`pnpm build` → `mvn spring-boot:run`(或 `start.bat`)同源托管,浏览器开 http://127.0.0.1:7456,每次改前端后需重新 `pnpm build` 刷新。 ## 配置 项目配置存于 `~/.vibe-pm/projects.json`,在「项目」页注册(输入根目录 → 扫描探测仓库 → 填 design 仓库与目标子树)。 ## 资源占用 紧凑档默认:JVM heap `-Xmx128m`(start.bat 生产 / pom.xml 开发两处一致)+ Tomcat 线程砍到 20。进程 RSS 稳态约 200–260MB。需要承载 MB 级 git diff 或超大仓库扫描时,把两处 `-Xmx128m` 调到 `-Xmx192m` 更安全。 ## 后端自动退出 前端每 20 秒发一次心跳给后端;后端 `HeartbeatService` 启动 60 秒宽限后,连续 60 秒没收到心跳就 `System.exit(0)`。所以**关浏览器约 1 分钟后后端进程消失**,不需要手工停。心跳与超时参数在 `server/src/main/resources/application.yml` 的 `vibe.heartbeat.*` 可调。 ## 结构 - `server/` — Spring Boot(Java 21):`ConfigService` / `GitService` / `MigrationService` / `OrchestratorService` / `FsService` + REST 接口(系统 git via ProcessBuilder) - `src/` — React + Vite + Ant Design:`Projects` / `Dashboard` / `IterationWizard` + `components/DirectoryPicker`(目录浏览弹窗) - `docs/superpowers/` — 设计规格与实现计划 权威设计见 `docs/superpowers/specs/2026-05-27-vibe-coding-project-manager-design.md`。