【免费下载链接】nimbalystNimbalyst - The open-source visual workspace for Claude Code, Codex, and OpenCode. Run multiple coding agents in parallel, edit their work visually in markdown, mockups, and diagrams, and track tasks. Free, MIT-licensed desktop app for macOS, Windows, Linux, with mobile companion for iOS and Android.项目地址https://gitcode.com/gh_mirrors/ni/nimbalyst点击查看免费下载Nimbalyst 是一个免费开源MIT 协议的可视化工作区专为 Claude Code、Codex、OpenCode 等编码 Agent 打造你可以并行运行多个编码 Agent用富文本界面直观地审阅、编辑它们的产出并跟踪任务。本文带你一张图看懂 Nimbalyst 的架构全景——Electron 负责桌面应用骨架、Lexical 驱动可视化编辑器、PGLite 提供内置数据库三者如何协同工作新手也能轻松读懂。一、先认识整体一个 pnpm 单仓MonorepoNimbalyst 采用 pnpm workspaces 组织代码所有能力拆成职责清晰的包。核心包一览包职责一句话理解packages/electron/桌面应用外壳主进程、预加载、渲染进程应用的骨架packages/runtime/跨端核心编辑器、AI 会话、同步桌面和移动端共用的大脑packages/tracker-core/ 等任务跟踪tracker三件套任务管理引擎packages/collab-client/ 等实时协作协议与客户端多人/多端同步packages/extension-sdk/扩展开发工具包让别人给 Nimbalyst 造插件packages/ios/、packages/android/移动端伴侣应用手机上指挥你的 Agent完整的包清单可以直接看 pnpm-workspace.yaml里面还藏着架构彩蛋allowBuilds列表里出现了electron、node-pty内置终端、better-sqlite3等原生依赖说明桌面端是重 Node.js 能力的应用patchedDependencies中专门打了lexical/table与lexical/yjs的补丁——这正暗示了 Lexical Yjs 协作是核心路径。 对新手最有用的记忆点electron 包管壳runtime 包管核其余包各管一摊。二、Electron 三层架构主进程、预加载、渲染进程Nimbalyst 是标准的安全型 Electron 应用严格遵循三进程隔离官方文档见 docs/IPC_GUIDE.md主进程Node.js 环境入口在 packages/electron/src/main/index.ts管理文件系统、Git、文件监听、AI Provider 等有特权的能力预加载脚本packages/electron/src/preload/index.ts 通过contextBridge暴露一个精心挑选的window.electronAPI渲染进程从不直接接触 Node渲染进程React 应用位于 packages/electron/src/renderer/只消费安全的 API 表面。三条值得记住的设计约定细节见 docs/IPC_GUIDE.md 与 packages/electron/MAIN_PROCESS_INIT.mdIPC 通道命名遵循namespace:action模式如history:create-snapshot避免通道冲突、方便调试事件流单向主进程事件 → 集中的 IPC 监听器 →Jotai 原子atoms→ React 组件组件里绝不直接订阅 IPC见 docs/JOTAI.md状态管理采用 Jotai 的单一事实来源原则每个状态只有一个权威来源派生值只计算、不另存。并行 Agent 会话的看板界面就是这套架构的成果每个会话隔离在独立 git worktree 中由主进程统一管理渲染进程只是纯视图三、Lexical可视化编辑器的心脏Nimbalyst 的 WYSIWYG 编辑器构建在LexicalMeta 开源的富文本框架之上核心代码集中在 packages/runtime/src/editor/其中NimbalystEditor.tsx 与 Editor.tsx 是编辑器的装配入口编辑器通过LexicalExtensionComposer组合而成每个插件都是一个 LexicalExtension统一在 NimbalystEditorExtensions.ts 的依赖数组中登记内置扩展图片、表格、Mermaid、折叠块、看板、Diff 等各自独立成文件放在 builtin/ 目录。这种一切皆插件的设计带来了两个关键收益红/绿 Diff 审批AI 的每处修改都以可视化 diff 呈现你可以逐块接受或拒绝Diff 插件位于 DiffPlugin/配套视觉指南见 VISUAL_DIFF_GUIDE.md扩展即一等公民第三方扩展通过 packages/extension-sdk/ 贡献LexicalExtension与内置编辑器走同一套EditorHost契约。插件如何接入的完整说明在 packages/runtime/src/editor/extensions/README.md。 官方文档 docs/ARCHITECTURE_DIAGRAMS.md 里甚至约定架构决策一律画 Excalidraw 图因为 Lexical 现在能内联实时渲染自定义编辑器链接——编辑器本身就是架构沟通工具。四、PGLite把 PostgreSQL 装进桌面应用桌面应用的数据持久化是 docs/DATABASE_SCHEMA.md 的重点Nimbalyst 使用 PGLiteWebAssembly 版 PostgreSQL无需安装任何数据库服务即可获得 ACID 事务级别的可靠存储。它的运行方式很有讲究PGLite 运行在一个Node.js worker 线程里主线程通过 PGLiteDatabaseWorker.ts 这个封装类与它通信——数据库再重也不阻塞 UI数据库文件默认存放在用户数据目录macOS 为~/Library/Application Support/nimbalyst/electron/pglite-db/天然支持备份与恢复文档 docs/DATABASE_SCHEMA.md 警告了一条铁律切勿在 Nimbalyst 运行时用 Node 或 CLI 直接打开 PGLite 文件必须走应用内暴露的数据库工具比如开发模式下的database_query见 docs/DEVELOPING_NIMBALYST.md。核心表结构一览ai_sessions存会话、session_files关联会话与文件、document_history记录文档历史版本、tracker_items驱动任务跟踪而 UI 布局、编辑器标签页这类轻量状态则走另一条路每个项目下的.nimbalyst/workspace-state.jsonelectron-store与 PGLite 形成重数据进数据库、轻状态进 JSON的分工完整数据流图见 docs/JOTAI.md。五、协同收束三者如何合力支撑一个会话把三层串起来一个典型场景的数据流就清晰了你启动一个 Agent 会话→ 渲染进程经window.electronAPI发 IPC 到主进程主进程在 PGLite 中落库会话记录在独立 git worktree 里拉起 Agent文件变更由文件监听器捕获事件回流主进程 → 集中监听器 → Jotai atoms → React 视图会话看板、文件树、任务状态实时刷新Agent 改文件→ Lexical 编辑器渲染红/绿 diff你逐块审批接受的改动写回磁盘 markdown 文件历史版本存入 PGLite 的document_history。值得强调的是 packages/runtime/CLAUDE.md 的定位说明runtime 包里放的是**可能被移动端复用**的组件Electron 专属逻辑留在 electron 包——这正是 iOS/Android 伴侣应用能与桌面端无缝对齐的原因。六、新手阅读路线5 分钟上手源码想理解什么从哪读起应用如何启动与进程分工packages/electron/MAIN_PROCESS_INIT.md、docs/IPC_GUIDE.md状态管理与数据流docs/JOTAI.md编辑器插件机制packages/runtime/src/editor/extensions/README.md数据库与表结构docs/DATABASE_SCHEMA.mdAI ProviderAgent/Chat 两类docs/AI_PROVIDER_TYPES.md自己跑起开发副本docs/DEVELOPING_NIMBALYST.md总结一下Nimbalyst 的架构精髓在于职责分层——Electron 提供安全的桌面外壳与系统能力Lexical 把 Agent 的文本产出变成可审阅、可协作的可视化界面PGLite 则以零部署的内置数据库保证数据可靠。三者在 pnpm 单仓中各守其位共同撑起这个免费开源的可视化 Agent 工作区。如果你想动手实践克隆仓库后从packages/electron目录运行pnpm run dev即可启动开发模式。赞分享【免费下载链接】nimbalystNimbalyst - The open-source visual workspace for Claude Code, Codex, and OpenCode. Run multiple coding agents in parallel, edit their work visually in markdown, mockups, and diagrams, and track tasks. Free, MIT-licensed desktop app for macOS, Windows, Linux, with mobile companion for iOS and Android.项目地址https://gitcode.com/gh_mirrors/ni/nimbalyst点击查看免费下载相关推荐Kedro 架构全景解析项目、框架、库与扩展如何协同支撑生产级数据管线Kedro 架构全景解析项目、框架、库与扩展如何协同支撑生产级数据管线 本篇文章以 docs/getting started/architecture_ove数据工程工作流自动化WSL 架构全景解析Windows 与 Linux 组件如何协同工作WSL 架构全景解析Windows 与 Linux 组件如何协同工作 导读 Windows Subsystem for LinuxWSL并非单一程序而是操作系统虚拟化系统编程网络3 分钟生成完整可用的黑苹果 EFIOpCore Simplify 自动配置 OpenCore 实操手册3 分钟生成完整可用的黑苹果 EFIOpCore Simplify 自动配置 OpenCore 实操手册 OpCore Simplify 是一个黑苹果 EFI开发工具CLI创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考