01 / 项目发现与整理
先找到项目,
再决定导入哪些。
选择一个存放代码的目录,查看扫描候选与内部组件,再勾选导入。前后端和共享库可以归到同一个工程,独立仓库也能单独保留。
- 导入后按名称、路径、技术栈或监听状态查找,支持收藏、分类与批量分类。
- 紧凑列表、卡片、表格按习惯切换;用 VS Code、Cursor、JetBrains 等已安装应用打开。
扫描与导入都不会执行项目命令;非标准目录可以选择深度补扫。

macOS 本地项目与服务管理器
DevNook 把代码目录、常用编辑器和正在运行的服务放进一个桌面工作台。导入项目后,确认启动前后端,在同一处看日志、找端口占用。
功能与实际界面
下面用同一组演示项目,查看当前源码界面的项目、服务与端口功能。截图使用演示数据,安装包功能以对应版本的发布说明为准。
第一次使用
无需先配置 AI 助手。桌面应用就能完成项目导入与服务管理。
选择代码目录,核对候选项目和内部组件,勾选需要的工程后导入。
选目录 → 预览候选 → 导入项目
进入项目服务页,采用识别到的启动建议,或补充命令。高级参数按需展开,确认后再执行。
打开项目 → 保存配置 → 确认启动
在服务详情查看输出与运行记录,打开可用地址。遇到端口占用,就去端口管理查看对应进程。
查看运行 → 打开浏览器 / 排查端口
扫描不执行命令,不读取 .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 后运行;也可使用可执行文件的绝对路径。
{
"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 复核身份后正常停止旧实例,等待退出及端口释放,再启动托管实例。切换会短暂中断服务;失败保留配置,不自动强杀或恢复旧实例。
可以。从服务详情复制交接指引,让原会话改用 DevNook CLI / MCP,避免重复执行旧启动命令。AI 与桌面使用同一份配置,控制操作遵循现有授权和确认规则;结束聊天不会自动停止服务。
支持。应用首次按系统首选语言选择:中文使用中文,其余语言使用英文;设置里可随时切换并记住手动选择。此官网也提供独立英文页面。
端口状态只描述实际 TCP 监听快照。Worker、CLI 和其他后台任务可能不监听端口,读取失败也不会被显示为已停止。
GET DEVNOOK
导入一个正在开发的项目,先从一个服务开始。
macOS 12+ · Apple Silicon / Intel Mac · 简体中文 / English
macOS v0.1.2
Release 安装包
当前构建尚未完成 Developer ID 签名与 Apple 公证。
f8f51cc8a215a61a9f99697c34b5ffe6d9b769fbec17a4122df5393e05b35e2bRelease 安装包
当前构建尚未完成 Developer ID 签名与 Apple 公证。
1442dea91316b1d9d18a6c1572a97311e657c501f6d592408128868645450d38