terminalManage

terminalManage 是一个面向前端开发者的桌面端项目管理工具。当你同时维护十几个甚至几十个本地项目时，terminalManage 让你告别在文件夹和终端之间反复跳转的痛苦——一个界面统一管理所有项目的启动、监控、日志查看、Git 提交和 Node 版本切换。

核心功能

🔍 智能项目扫描

选择一个工作目录，terminalManage 自动递归扫描所有包含 package.json 的项目（深度 4 层），并识别每个项目使用的包管理器（npm / pnpm / yarn）。扫描结果以卡片网格形式展示，支持隐藏不需要关注的项目。

▶️ 一键脚本执行

自动读取每个项目 package.json 中的 scripts，以按钮形式展示。点击即可启动，运行中的脚本以绿色高亮标识，支持一键 KILL 强制终止进程（包含子进程树）。

📊 实时进程监控

脚本启动后，terminalManage 每 2 秒采集一次进程资源数据，聚合父子进程（如 npm → node → vite）的 CPU 和内存占用，以可视化进度条实时展示在项目卡片中。

📟 内嵌终端日志

基于 xterm.js 的终端视图，实时展示脚本输出。支持：

- ANSI 颜色渲染，还原真实终端效果

- 日志复制、一键清空

- 文件路径可点击，直接在 VS Code 中打开对应文件

🤖 AI 智能辅助

集成多模型 AI 能力，提供两个核心场景：

- AI Git 提交：点击项目卡片的 Git 按钮，自动获取 git diff，由 AI 生成符合 Angular 规范的中文 Commit Message，确认后一键提交。

- 日志智能诊断：终端出现错误时，一键将日志上下文发送给 AI 分析，返回错误原因和修复建议（Markdown 渲染展示）。

支持 OpenAI 兼容协议（GPT / DeepSeek / Codex 等）、Anthropic（Claude）、Google Gemini 三种 API 协议，可配置多个模型并随时切换。API Key 仅存储在本地配置文件中，通过后端代理转发请求。

🔄 Node 版本自动切换

解决多项目需要不同 Node 版本的痛点。无需手动 nvm use，terminalManage 在启动脚本时自动使用项目所需的 Node 版本。

工作原理：

1. 自动检测：扫描项目时读取 .nvmrc → .node-version → package.json engines.node，使用 semver 匹配最佳已安装版本

2. 手动覆盖：每个项目卡片上有版本选择下拉框，可手动指定版本，覆盖配置持久化存储

3. 进程级隔离：通过修改子进程环境变量的 PATH，直接调用目标版本的 node + 对应 cli.js，不影响系统全局版本

支持 nvm-windows（Windows）和 nvm（macOS/Linux）两种 nvm 实现。

版本标签颜色含义：

- 🟢 绿色 — 自动检测匹配

- 🟣 紫色 — 手动指定版本

- ⚪ 灰色 — 使用系统默认

🌐 Tunnel 公网访问（Cloudflare）

内置 Tunnel 网关，支持把当前运行中的本地项目通过 Cloudflare Tunnel 暴露到公网，方便联调、演示和真机调试。

- 内置本地网关：127.0.0.1:26324

- 支持配置 cloudflared Token 和公网域名

- 支持一键切换内网穿透目标服务 “运行脚本时自动切换隧道目标项目”

- 项目卡片内可直接显示并点击 Tunnel URL（仅在 cloudflared 运行时显示）