Repository navigation
Releases
DevNook v0.1.2
DevNook v0.1.2
本次新增 macOS 菜单栏快捷面板,集中查看服务状态、实际端口与必要操作,并修正浏览器入口的显示依据。
更新内容
- 菜单栏快捷入口:点击 N 图标查看运行中、需关注及收藏项目的服务。单服务项目合并一行,多服务才分组;340 逻辑单位宽、22px 服务行,内容过多时限高滚动,底部入口固定。
- 搜索与键盘操作:超过 12 条自动显示搜索,也可用 ⌘F 按项目、服务或实际端口查找;方向键选择、Enter 进入详情、Escape 收起,上下箭头提示剩余内容。
- 减少刷新干扰:同次展开保持高度、顺序、焦点与滚动位置。消失的条目立即禁用并保留原位置,下次展开重新计算。
- 准确的浏览器按钮:仅复用近期在服务详情确认过、且当前监听与进程身份仍匹配的单一网页入口。API、未知或多入口不显示菜单栏地球图标,可进入详情读取或选择;不会因有端口就显示网页按钮,也不会展开时批量探测。
- 保留确认与控制边界:启动 / 重启进入主窗口既有确认;托管服务可正常停止。外部与未知实例没有快捷停止,不增加强停或整项目启停。
- 窗口与主题:关闭主窗口后保留菜单栏,可从 Dock 或面板恢复;退出 GUI 后已运行服务继续。隐藏窗口暂停轮询,面板与主窗口同步中英和浅暗偏好。
- 官网与文档:增加中英文菜单栏介绍及四张使用虚构项目的实际界面演示图。
安装与升级
macOS 12+,根据芯片选择 Apple Silicon 或 Intel Mac DMG,打开后将 DevNook 拖入 Applications。更新前正常退出旧 GUI,避免出现多个菜单栏图标;不要覆盖仍在运行的应用文件。
本次保持 UDS v10 与 SQLite v3,不自动退出旧 Core、停止服务、安装 LaunchAgent 或修改 MCP 客户端。后台和服务生命周期独立于 GUI。
两个安装包均采用 ad-hoc 签名,尚未完成 Developer ID 签名或 Apple 公证。macOS 可能阻止首次打开;核对来源与 SHA-256 后参阅 Apple 的应用安全打开说明。
English
This release adds a compact macOS menu bar panel for service status, actual ports, and everyday actions.
- Single-service projects use one row; multiple services receive project headings. The panel is 340 logical units wide with 22px rows, a bounded scrolling list, and a fixed footer.
- Search appears above 12 services, or with ⌘F. Match projects, services, or actual ports; use arrow keys, Enter for details, and Escape to close.
- Refreshes keep the current opening's height, order, focus, and scroll position. Missing entries immediately lose their controls while retaining their slot until the next opening.
- Browser icons require a recently confirmed single web entry from the service detail view, rechecked against current listener and process identity. APIs, unknown endpoints, and multiple entries stay in details. Opening the panel never probes every port.
- Start and restart retain the existing main-window confirmation. Managed services support graceful stop; external and unknown instances have no stop shortcut.
- Closing the main window keeps menu bar access; the Dock or panel restores it. Quitting the GUI leaves running services active. Hidden windows pause polling, and both windows share language and appearance preferences.
Choose the DMG for your Mac, quit the old GUI normally, then drag the new app into Applications. UDS v10 and SQLite v3 remain unchanged. The update does not terminate Core or services, install a LaunchAgent, or configure an MCP client.
Both installers target macOS 12+ and are ad-hoc signed, without Developer ID signing or Apple notarization. Check the source and checksum, then consult Apple's guidance.
下载与校验 / Downloads and checksums
| 架构 / Architecture | DMG | 字节 / Bytes |
|---|---|---|
| Apple Silicon | DevNook_0.1.2_aarch64.dmg |
4,874,171 |
| Intel Mac | DevNook_0.1.2_x64.dmg |
5,386,514 |
将 DMG 与对应校验文件放在同一目录。Download the DMG and its matching checksum file into the same directory.
# Apple Silicon
shasum -a 256 -c SHA256SUMS
# Intel Mac
shasum -a 256 -c SHA256SUMS-x86_64f8f51cc8a215a61a9f99697c34b5ffe6d9b769fbec17a4122df5393e05b35e2b DevNook_0.1.2_aarch64.dmg
1442dea91316b1d9d18a6c1572a97311e657c501f6d592408128868645450d38 DevNook_0.1.2_x64.dmg
验证范围 / Validation scope
- Apple Silicon 与 x86_64 / Rosetta 的 Release workspace 各 97 项测试通过,5 个既有内部 fixture 忽略;38 项界面测试通过。两份 DMG 均通过架构、版本、最低系统、签名完整性、镜像完整性与只读挂载后的逐文件一致性校验。两个测试矩阵均使用 Apple Python 3.9.6,不放宽就绪期限。
- 菜单栏界面通过隔离浏览器的真实 React 组件验证,包括长列表、搜索、键盘、状态变化与错误路径。本机锁屏阻断了本轮原生界面检查,未据此声称已完成原生菜单点击 / 失焦、多显示器或全屏 Space 验收;Intel 硬件与 macOS 12 真机仍需补充验证。
- Both Release workspaces passed 97 tests with 5 existing internal fixtures ignored; 38 UI tests passed. Both disk images passed architecture, version, minimum-system, signature-integrity, image-integrity, and mounted-content checks. Both test matrices used Apple Python 3.9.6 without relaxing readiness deadlines.
- The real React menu panel was checked with isolated browser fixtures, including long lists, search, keyboard interaction, state changes, and errors. A locked Mac prevented this round's native UI check. Native menu clicks / blur, multiple displays, full-screen Spaces, Intel hardware, and macOS 12 devices remain outside the completed validation.
DevNook v0.1.1
DevNook v0.1.1
本次更新补齐外部服务切换托管、AI 交接和服务入口展示,修复旧 Core 的配置预览兼容及自定义 Node 服务命令自动填充。
更新内容
- 已有配置切换托管:选择已保存的服务配置与当前外部实例,先查看独立预览;PID 只读展示,点击“停止旧实例并以托管方式重启”才执行。Core 保留进程身份、配置版本、依赖及端口核验。
- 清楚区分配置与运行:没有运行记录显示“未启动”;外部监听单独展示。保存配置与普通启动不会自动停止外部服务,端口冲突仍阻断启动。
- AI 继续管理:从服务详情复制当前服务的 CLI / MCP 交接指引,并前往设置完成接入。MCP 默认只读,控制服务需范围授权与对应确认;不会自动修改 AI 客户端配置,结束聊天不默认停止服务。
- 可靠的配置建议:兼容缺少配置预览接口的旧 v10 Core;对有清单与入口证据的 Node 自定义脚本自动填充启动命令,不复制旧环境或重放观察到的命令。
- 服务与网页入口:全局优先展示项目名,项目内优先展示服务名;从核验过的实际监听选择 HTTP / HTTPS 地址。自定义网页服务器可直接打开,明确无根页面的 API 展示监听,未知入口仍保留尝试打开。
- 文档与官网:更新中英文指引及演示截图,区分服务配置、外部运行、网页入口与日志。
安装与升级
macOS 12+,按芯片选择下方 DMG,打开后拖入 Applications。已有配置和运行仍由本机 Core / runner 维护;升级 GUI 不会自动退出旧 Core 或停止服务。若旧后台缺少切换能力,界面会提示限制,不绕过核验。
切换托管会短暂中断被选中的服务:正常停止旧 PID,等待退出与相关端口释放,再启动新的托管实例。失败保留配置,不自动强杀或恢复旧实例;旧进程环境、历史日志及 IDE 调试会话不迁移。请先让原 Codex / IDE 会话改用 DevNook CLI / MCP,避免重复拉起。
两个包均为 ad-hoc 签名,未完成 Developer ID 签名或 Apple 公证。macOS 可能阻止首次打开;核对来源与 SHA-256 后,可参阅 Apple 的应用安全打开说明。不提供 Windows / Linux 安装包。
English
This release completes external-to-managed service handoff, AI handoff instructions, and clearer service and browser entry presentation.
- Reuse a saved configuration, select the external instance, and review a separate preview. The PID is read-only. Only Stop old instance and restart under DevNook executes the switch; Core still checks identity, configuration revisions, dependencies, and ports.
- Distinguish unstarted configurations from stopped runs and external listeners. Saving configuration and ordinary start never stop external instances automatically; port conflicts still block startup.
- Copy service-specific CLI / MCP instructions so an AI assistant can continue using the same configuration. MCP is read-only by default; control requires scoped authorization and confirmation. Client setup is explicit, and ending a chat does not stop the service automatically.
- Preview configuration with older v10 Core versions, and autofill custom Node scripts when supported by manifest and entry evidence. No environment copying or replaying observed process commands.
- Display project names globally and service names within projects. Custom web servers get a verified HTTP entry; API roots without a page show listeners, while unknown entries retain a browser attempt.
Choose the DMG for your Mac and drag DevNook into Applications. Both builds target macOS 12+ and are ad-hoc signed, without Developer ID signing or Apple notarization. See Apple’s guidance after checking the source and checksum.
Upgrading the GUI does not automatically terminate the existing Core or services. An explicitly confirmed switch briefly interrupts the selected service: gracefully stop the old PID, wait for exit and released ports, then start a managed instance. Failure keeps configuration without force-killing or automatically restoring the old instance. Existing environment, historical logs, and IDE debugging sessions do not migrate. Tell the original assistant or IDE session to use DevNook CLI / MCP to avoid duplicate starts.
下载与校验 / Downloads and checksums
| 架构 / Architecture | DMG | 字节 / Bytes |
|---|---|---|
| Apple Silicon | DevNook_0.1.1_aarch64.dmg |
4,730,761 (4.73 MB) |
| Intel Mac | DevNook_0.1.1_x64.dmg |
5,221,961 (5.22 MB) |
将所选 DMG 与对应校验文件放在同一目录。Apple Silicon 使用 SHA256SUMS,Intel 使用 SHA256SUMS-x86_64。
Download the DMG and its matching checksum file into the same directory.
# Apple Silicon
shasum -a 256 -c SHA256SUMS
# Intel Mac
shasum -a 256 -c SHA256SUMS-x86_647b9ca4b2183571a9841a64cc131129167b251cc814534e394ec6ff8d055b6764 DevNook_0.1.1_aarch64.dmg
76394a2e1d27f361f1c9241f525cc6f01b6a2d4ff6b48d959116e10742a3b07e DevNook_0.1.1_x64.dmg
使用说明 / Guides: 中文 · English · CLI / MCP
验证范围 / Validation scope
- Apple Silicon 与 x86_64 / Rosetta 的 Release workspace 各 92 项测试通过,5 个内部 fixture 按原有标记忽略;27 项界面测试通过。两个 DMG 已核对签名、架构、版本、最低系统、镜像完整性与包内应用一致性,两架构原生窗口均显示 v0.1.1 并连接既有 Core。
- Intel 完整矩阵使用 Apple Python 3.9.6。本机 Python 3.14 下,配置为 4 秒就绪期限的 Python 测试在整套执行中超时,单项执行通过;未放宽测试或产品的就绪检查,产品默认期限仍为 30 秒。Intel 与 macOS 12 真机仍需补充验证。
- Both Release workspaces passed 92 tests with 5 existing internal fixtures ignored; 27 UI tests passed. Both disk images passed signature, architecture, version, minimum-system and mounted-content checks. Both native windows displayed v0.1.1 and connected to the existing Core.
- The Intel matrix used Apple Python 3.9.6 under Rosetta. With local Python 3.14, the Python fixture’s four-second readiness deadline timed out in full-suite runs while its standalone run passed. No test or product readiness deadline was relaxed; the product default remains 30 seconds. Intel hardware and macOS 12 devices still need verification.
DevNook v0.1.0
DevNook v0.1.0
DevNook 的首个公开版本:在 macOS 上集中整理本地项目、启动开发服务、查看日志,并从占用端口定位进程和项目。
主要功能
- 项目库:扫描后预览候选再导入,按分类、收藏、技术栈和监听状态查找项目,用常用编辑器打开工程。
- 服务与日志:保存并复用启动配置,确认启动、停止或重启;查看就绪状态、实际监听端口和 stdout / stderr 历史日志。
- 端口排查:搜索 TCP 端口、PID、命令或目录,区分托管服务与外部进程。外部停止需要身份核验和单独确认。
- 启动方案:按依赖顺序等待服务就绪,复用已有运行;回滚或停止方案时只处理本次创建的实例。
- 桌面体验:默认窗口 1280×800,支持浅色 / 暗色和简体中文 / English;首次按系统首选语言选择,支持手动切换。
- CLI / MCP:终端和可选 MCP 接入共用本机后台。MCP 默认只读,服务控制需要范围授权与对应确认。
关闭桌面窗口后,已经启动的服务与日志仍由独立本机后台维护。扫描、导入和保存配置都不会自动执行项目命令。
下载与安装
| 项目 | 要求 / 文件 |
|---|---|
| 系统 | macOS 12 或更高版本 |
| Apple Silicon | DevNook_0.1.0_aarch64.dmg,4,695,106 字节(4.70 MB) |
| Intel Mac | DevNook_0.1.0_x64.dmg,5,182,582 字节(5.18 MB) |
| 校验文件 | Apple Silicon:SHA256SUMS;Intel:SHA256SUMS-x86_64 |
| 许可 | MIT |
- 从本 Release 的 Assets 按芯片选择 DMG,打开后将 DevNook 拖入 Applications。
- 打开应用,扫描并预览已有工程,再选择导入。
- 进入项目服务页,核对启动建议或填写自己的命令,保存配置后确认执行。
签名状态:两个构建均采用 ad-hoc 签名,尚未完成 Developer ID 签名或 Apple 公证。macOS 可能阻止首次打开;核对下载来源与校验和后,可参阅 Apple 的应用安全打开说明。Intel 构建已通过 Apple Silicon 主机上的 x86_64 / Rosetta 隔离测试与真实窗口启动检查,Intel 与旧 macOS 真机仍需补充验证。本次没有 Windows 或 Linux 安装包。
SHA-256
将所选 DMG 与对应校验文件放在同一目录,按架构执行:
shasum -a 256 -c SHA256SUMS
# Intel Mac
shasum -a 256 -c SHA256SUMS-x86_64307618b4cdc418ab43d8dd818eb1205c8d69d25d6cce397e430f0e15ed9a2cc7 DevNook_0.1.0_aarch64.dmg
f1a31777918ed089878d95c13909e05bbe3f08e6e10389ca797ff2fb60c136ad DevNook_0.1.0_x64.dmg
使用说明:中文指南 · English README · 反馈问题
English
The first public DevNook release brings local projects, development services, logs, and TCP port inspection into one macOS desktop workspace.
- Preview scanned projects before importing, organize them with categories and favorites, and open them in installed editors.
- Save launch configurations, confirm service actions, inspect readiness and actual listeners, and search stdout / stderr by run.
- Trace occupied ports to process commands, directories, and projects. External processes remain separate and require identity checks and confirmation before stopping.
- Prepare multiple services in dependency order, reuse existing runs, and roll back only instances created by the current startup plan.
- Use a 1280×800 default window, light / dark themes, and Simplified Chinese / English with system-language detection and manual switching.
- Query the same local backend through the CLI or optional MCP integration. MCP is read-only by default; control requires scoped authorization and confirmation.
Started services and logs continue after the desktop window closes. Scanning, importing, and saving configuration do not execute project commands.
Download: choose DevNook_0.1.0_aarch64.dmg (4.70 MB) for Apple Silicon or DevNook_0.1.0_x64.dmg (5.18 MB) for Intel Macs, both targeting macOS 12 or later. Open the DMG and drag DevNook into Applications. Download the matching SHA256SUMS (Apple Silicon) or SHA256SUMS-x86_64 (Intel) and use its verification command above.
Signing and validation: both builds are ad-hoc signed and have not completed Developer ID signing or Apple notarization. macOS may block the first launch; see Apple's guidance after verifying the source and checksum. The Intel build has passed x86_64 / Rosetta integration tests and native window startup checks on an Apple Silicon host; Intel hardware and older macOS devices still need verification. Windows and Linux installers are not included.