macOS 本地项目与服务管理器

找项目。开服务。查端口。

DevNook 把代码目录、常用编辑器和正在运行的服务放进一个桌面工作台。导入项目后,确认启动前后端,在同一处看日志、找端口占用。

macOS 12+ · 本机数据 · MIT 开源

DEVNOOK / 工作台
DevNook 项目库:按分类组织本地工程,显示技术栈、实际服务监听与打开编辑器入口
项目库 / 演示数据1280 × 800查看原图

功能与实际界面

从找到工程,到看清它怎么运行。

下面用同一组演示项目,查看当前源码界面的项目、服务与端口功能。截图使用演示数据,安装包功能以对应版本的发布说明为准。

01 / 项目发现与整理

先找到项目,
再决定导入哪些。

选择一个存放代码的目录,查看扫描候选与内部组件,再勾选导入。前后端和共享库可以归到同一个工程,独立仓库也能单独保留。

  • 导入后按名称、路径、技术栈或监听状态查找,支持收藏、分类与批量分类。
  • 紧凑列表、卡片、表格按习惯切换;用 VS Code、Cursor、JetBrains 等已安装应用打开。

扫描与导入都不会执行项目命令;非标准目录可以选择深度补扫。

扫描预览展示 Meridian Shop 的前端、API 与共享类型,并在导入前提供勾选确认
导入预览 · 项目边界、前后端服务候选与共享组件查看原图

02 / 服务与日志

按项目找到服务,
再看运行与入口。

全局列表先看项目名,项目内先看服务名。名称、相对目录与实际端口区分同一项目的多个服务,右侧详情始终对应当前选择。

  • 启动、停止、重启已登记的服务;未启动配置与外部运行分别展示,端口冲突会先阻断启动。
  • 网页入口默认使用 HTTP,地址可复制;HTTPS 位于更多菜单,自定义 Node 网页服务同样可打开。
  • API 没有根页面时展示监听地址;入口尚未确认时,仍保留尝试打开。
  • 按运行记录回看 stdout / stderr 并搜索日志;关闭窗口后,已启动的服务继续运行。

外部服务可复用已保存配置,预览后单独确认切换;保存配置与普通启动都不会自动停止外部实例。

全局服务列表以项目名为标题,选中的自定义 Node 网页服务显示 HTTP 访问地址与打开浏览器按钮
网页入口 · 项目与组件目录、HTTP 地址、命令与工作目录查看原图

03 / 菜单栏快捷面板

不切回主窗口,
也能核对服务。

点击 macOS 菜单栏的 N 图标,集中查看运行中、异常及收藏项目的服务。单服务项目直接一行,多服务项目才显示分组标题。

  • 核对实际端口,进入服务详情,或正常停止 DevNook 托管的运行。
  • 长列表独立滚动,底部入口固定;按项目、服务或端口搜索,也可用 ⌘F 唤出搜索。
  • 仅近期已确认的单一网页入口显示浏览器图标;API 与未知端口不会出现地球按钮。

启动与重启仍进入主窗口确认。关闭窗口后可从菜单栏恢复,退出应用也不会停止已运行的服务。

紧凑菜单栏面板以七行展示项目、实际端口和状态,仅两个已确认网页入口显示浏览器按钮
菜单栏面板 · 单行服务、实际端口与必要操作 / 演示数据查看原图

04 / 端口与进程

端口被占用时,先看清是谁。

从 TCP 监听端口定位进程,查看命令、工作目录、启动时间与项目归属。区分 DevNook 托管和外部启动,再决定下一步操作。

  • 按端口、PID、命令或项目路径搜索,组合项目、地址族、运行时等筛选。
  • IPv4 / IPv6 与多地址合并展示;项目关联保留本次进程身份。

未检测到监听不等于项目已停止。身份未知或归属无法核验的进程保持只读。

端口管理选中 3001 端口,显示 Node.js 进程、IPv4 和 IPv6 地址以及 Meridian Shop 项目归属
端口详情 · 监听地址、进程命令、目录与项目归属查看原图

05 / 多服务启动方案

数据库就绪,
再启动 API 和前端。

把已登记的服务组成启动方案。入口可以来自多个项目,依赖会自动展开,等待上游就绪后再启动下游。

  • 执行前查看完整计划、命令、目录与就绪条件,再确认启动。
  • 复用原本运行的服务;失败或取消时,仅回滚本次新增的运行。

启动方案位于“服务管理”内。保存方案只保存配置,不会启动服务。

Meridian 全栈启动方案按 PostgreSQL、API、前端顺序展示依赖和就绪状态,并注明保留复用的数据库服务
启动方案 · 依赖顺序、就绪状态与本次运行归属查看原图

第一次使用

从一个代码目录开始。

无需先配置 AI 助手。桌面应用就能完成项目导入与服务管理。

01导入

扫描并选择项目

选择代码目录,核对候选项目和内部组件,勾选需要的工程后导入。

选目录 → 预览候选 → 导入项目

  • 只读扫描
  • 不执行项目命令
02配置

核对启动命令

进入项目服务页,采用识别到的启动建议,或补充命令。高级参数按需展开,确认后再执行。

打开项目 → 保存配置 → 确认启动

  • 配置与执行分开
  • 冲突先阻断
03使用

看日志,查实际监听

在服务详情查看输出与运行记录,打开可用地址。遇到端口占用,就去端口管理查看对应进程。

查看运行 → 打开浏览器 / 排查端口

  • 实际 TCP 监听
  • 历史运行日志

管理本地开发,也保留清楚的操作边界。

只读发现

扫描不执行命令,不读取 .env,也不跟随符号链接。

本机保存

项目与配置留在本机,敏感环境值交给 macOS Keychain。

明确确认

配置保存与执行分开;停止外部服务需要身份核验与 PID 确认。

窗口之外

关闭窗口后,独立后台继续维护已启动的服务与日志。

终端与 AI 助手 · 可选

桌面之外, 也能查询同一套状态。

CLI 与 MCP 让终端和 AI 助手使用桌面中的同一份项目、服务、端口与日志。切换托管后,可从服务详情复制交接指引,让助手继续通过已有配置管理服务。

MCP 默认只读;控制服务需明确创建范围授权并遵循确认流程。接入指引不会自动配置 AI 客户端,聊天结束也不会自动停止服务。

阅读 CLI / MCP 使用说明

终端查询示例

pnpm build:cli
./target/debug/devnook project list
./target/debug/devnook service list
./target/debug/devnook ports

在源码目录构建 CLI 后运行;也可使用可执行文件的绝对路径。

配置 AI 助手接入(MCP)
MCP / READ-ONLY CONFIGURATION
{
  "mcpServers": {
    "devnook": {
      "command": "/absolute/path/to/devnook",
      "args": [
        "mcp",
        "serve"
      ]
    }
  }
}

将 command 替换为本机 DevNook CLI 的绝对路径。

03 / A FEW THINGS TO KNOW

开始之前,你可能想知道。

支持哪些系统?

当前面向 macOS 12+,分别提供 Apple Silicon 与 Intel Mac 安装包。Intel 构建使用 Rosetta 验证;Intel 和 macOS 12 真机仍需补充验证。Windows / Linux 是否推进,将结合社区需求与维护资源评估。

扫描会修改或运行我的项目吗?

不会。扫描只读取工程清单与目录线索,导入前可以核对候选。扫描、导入和保存服务配置都不会执行项目命令。

关闭窗口后,服务还会运行吗?

会。关闭窗口后可从菜单栏 N 图标或 Dock 恢复;退出应用只结束 GUI。独立 Core 与 runner 维持已经启动的服务和日志。DevNook 不安装系统自启动项;没有活动服务且客户端闲置后,后台可自行退出。

可以和现有编辑器、终端一起用吗?

可以。你可以在已安装的编辑器中打开项目,也能查看由终端或 IDE 启动的外部监听。项目关联不代表接管外部进程,相关停止操作仍需核验与确认。

切换托管会关闭原来的外部服务吗?

只有点击“停止旧实例并以托管方式重启”才会执行。确认页只读展示 PID、命令和目录,Core 复核身份后正常停止旧实例,等待退出及端口释放,再启动托管实例。切换会短暂中断服务;失败保留配置,不自动强杀或恢复旧实例。

切换后还能让 Codex 或其他 AI 助手管理吗?

可以。从服务详情复制交接指引,让原会话改用 DevNook CLI / MCP,避免重复执行旧启动命令。AI 与桌面使用同一份配置,控制操作遵循现有授权和确认规则;结束聊天不会自动停止服务。

支持中文和英文吗?

支持。应用首次按系统首选语言选择:中文使用中文,其余语言使用英文;设置里可随时切换并记住手动选择。此官网也提供独立英文页面。

为什么未检测到监听,项目却可能还在运行?

端口状态只描述实际 TCP 监听快照。Worker、CLI 和其他后台任务可能不监听端口,读取失败也不会被显示为已停止。

GET DEVNOOK

把本地开发,
整理成可重复的日常。

导入一个正在开发的项目,先从一个服务开始。

macOS 12+ · Apple Silicon / Intel Mac · 简体中文 / English

macOS v0.1.2

Apple Silicon

Release 安装包

应用
15.33 MB
DMG
4.87 MB
下载 Apple Silicon DMG

当前构建尚未完成 Developer ID 签名与 Apple 公证。

SHA-256 校验值f8f51cc8a215a61a9f99697c34b5ffe6d9b769fbec17a4122df5393e05b35e2b

Intel Mac

Release 安装包

应用
16.45 MB
DMG
5.39 MB
下载 Intel Mac DMG

当前构建尚未完成 Developer ID 签名与 Apple 公证。

SHA-256 校验值1442dea91316b1d9d18a6c1572a97311e657c501f6d592408128868645450d38
查看发布记录