Near 桌面
本地优先工作区:Electron 界面连本机 agx serve。
Near 是桌面工作区。技术栈是 Electron + React + Zustand + Vite。它不是第二套智能体运行时。默认路径会拉起本机 agx serve / agx-server,用 REST + SSE 通信。
要在本机用多窗格聊天、分身、群聊、工作区、终端、自动化和语音焦点时用 Near。不要把它当托管多租户门户 —— 那是 Enterprise。

启动链路
桌面端硬绑本机后端。连接远程 agx serve 不是默认产品路径。启动成功后,真实端口和 AGX_DESKTOP_TOKEN 会写到 ~/.agenticx/。
当前已落地
- 窗格:一窗格一会话;模型按窗格选,不覆盖全局
- Meta-Agent:没 @ 时由 Meta 接;
@名字路由到对应分身 - 群聊:默认包含 Meta;智能路由,不必先选编排器
- 工作区:目录按分身 / Meta 隔离;
@file插入带绝对sourcePath的 token - 工具:MCP、Skills、Hooks、Computer Use、本地知识脑
- 自动化:定时运行的
avatar_id形如automation:<task_id>,不得串进 Meta 历史 - 语音焦点:280×280 胶囊;由 Meta 回答;摘要写入当前元智能体会话
会话恢复
关掉窗格再打开同一分身,应回到最近会话,而不是新建。合盖 / 重启后应恢复窗格和上次会话。
实践案例:双窗格 + @file
场景。 先让 Meta 定评审提纲,再把一个仓库文件交给「研究员」分身。
- 打开 Near,确认
~/.agenticx/serve.port对应进程还在听。 - 第一窗格留 Meta,让它出提纲。
- 第二窗格打开研究员分身(或在群里 @ 他)。模型 pill 只属于这个窗格。
- 工作区把仓库绑到这个分身。点选文件,输入区插入
@file[显示名](绝对路径),sourcePath必须是绝对路径。 - 发送。分身应走
file_read/liteparse读真实路径,而不是只在~/.agenticx/avatars/<id>/workspace里找。
你会看到。 两个窗格、各自的模型选择、输入区里的文件 token、一张默认折叠的工具卡,然后是回答。关掉分身窗格再打开,应回到这个会话,而不是空白新会话。
