terminalManage

kuyep · WEBNSNM.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 运行时显示）