npm - @myagentroam/server - Versions diffs - 0.13.4 → 0.13.6 - Mend

@myagentroam/server 0.13.4 → 0.13.6

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (358) hide show

package/web/docs/deployment/node-installation.html CHANGED Viewed

@@ -9,9 +9,9 @@
     <link rel="preload stylesheet" href="/docs/assets/style.B3QdEOQQ.css" as="style">
     <link rel="preload stylesheet" href="/docs/vp-icons.css" as="style">
-    <script type="module" src="/docs/assets/app.DQ73g8Ca.js"></script>
+    <script type="module" src="/docs/assets/app.DFdypnML.js"></script>
     <link rel="preload" href="/docs/assets/inter-roman-latin.Di8DUHzh.woff2" as="font" type="font/woff2" crossorigin="">
-    <link rel="modulepreload" href="/docs/assets/chunks/theme.CES2lSYr.js">
+    <link rel="modulepreload" href="/docs/assets/chunks/theme.DLnKtfGY.js">
     <link rel="modulepreload" href="/docs/assets/chunks/framework.BHjrhdiC.js">
     <link rel="modulepreload" href="/docs/assets/deployment_node-installation.md.BhsVg-7E.lean.js">
     <script id="check-dark-mode">(()=>{const e=localStorage.getItem("vitepress-theme-appearance")||"auto",a=window.matchMedia("(prefers-color-scheme: dark)").matches;(!e||e==="auto"?a:e==="dark")&&document.documentElement.classList.add("dark")})();</script>
@@ -53,7 +53,7 @@
 <span class="line"><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">  },</span></span>
 <span class="line"><span style="--shiki-light:#005CC5;--shiki-dark:#79B8FF;">  &quot;registrationToken&quot;</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">: </span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;">&quot;从节点注册页复制的注册密钥&quot;</span></span>
 <span class="line"><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">}</span></span></code></pre></div></li><li><p>限制配置与整个 <code>dataDirectory</code> 只能由运行账号读取；SQLite 位于其根目录，结构化日志位于其 <code>logs/</code>，都不能放在 npm 包目录、Git 或聊天中。</p></li><li><p>前台验证：</p><div class="language-bash vp-adaptive-theme"><button title="Copy Code" class="copy"></button><span class="lang">bash</span><pre class="shiki shiki-themes github-light github-dark vp-code" tabindex="0"><code><span class="line"><span style="--shiki-light:#6F42C1;--shiki-dark:#B392F0;">mar-node</span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;"> run</span><span style="--shiki-light:#005CC5;--shiki-dark:#79B8FF;"> --config</span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;"> /path/to/mar-node.json</span></span></code></pre></div></li></ol><p>首次连接成功后，Node 会将 Node ID 和凭据写回配置，后续用凭据重连；可移除已使用的 <code>registrationToken</code>。</p><p>从使用 <code>databasePath</code> 的旧版 Node 升级时，必须先把该字段改为 SQLite 所在目录对应的 <code>dataDirectory</code>，并确认数据库文件名为 <code>node-runtime.sqlite</code>；新版本会拒绝旧字段，不自动搬迁数据。</p><p>自定义 Claude Code 上下文窗口时，可在 Node 服务环境设正整数 <code>MAR_CLAUDE_CONTEXT_WINDOW_TOKENS</code>（例如 <code>256000</code>）；未设置时默认按 200000 tokens，并可读取该服务账号 Claude 配置中的同名环境值。</p><p><strong>成功标志：</strong> 注册页显示节点在线、正确的平台/Node.js 版本和支持 Agent。此时按平台配置自启动：<a href="./node-linux">Linux systemd</a>、<a href="./node-windows">Windows 任务计划</a>或<a href="./node-macos">macOS launchd</a>。</p><p>完成自启动后必须再检查一次远程升级前置状态：重启主机或服务后 Node 自动上线，节点详情中的“升级状态”显示“当前无需升级”或“可升级到 …”，而不是“需手工启用 Supervisor”。不支持 Supervisor 的旧版需要先手工安装符合当前业务基线的版本并改好自启动入口；旧 Node 无法通过未知操作自举 Supervisor。</p><h2 id="接入后检查与失败排查" tabindex="-1">接入后检查与失败排查 <a class="header-anchor" href="#接入后检查与失败排查" aria-label="Permalink to &quot;接入后检查与失败排查&quot;"></a></h2><ol><li>在 <code>allowedRoots</code> 下登记 Workspace，确认文件、终端和 Agent 会话均可打开。</li><li>重启 Node 服务后，确认它自动重连；不要开放 Node 公网入站端口。需要局域网直连时，只允许 Browser 所在局域网访问配置的 UDP 范围，默认 <code>49152-49215</code>。同主机多个 Node 可共享默认池并自动选择空闲端口；需要独立容量时，为各配置文件设置互不重叠的范围。</li><li>Node 在线但 Agent 不可用时，先以服务账号检查 CLI、<code>PATH</code>、用户目录、认证和工作区权限。</li><li>MCP 启动失败时，在节点详情确认 <code>npx</code> 是否可用；Python Skill 失败时确认页面显示的实际 Python/pip 命令，并在同一服务账号下复现。</li><li>Node 完全离线时，检查 Server URL、HTTPS/WSS 出站网络、配置权限与服务日志。</li></ol><p>安全提示：注册密钥、Node 凭据和 Agent 登录状态都不可提交 Git 或发送给 Agent。下一步：<a href="./../getting-started/register-workspace">登记第一个 Workspace</a>。</p><h2 id="web-fetch-浏览器准备" tabindex="-1">Web Fetch 浏览器准备 <a class="header-anchor" href="#web-fetch-浏览器准备" aria-label="Permalink to &quot;Web Fetch 浏览器准备&quot;"></a></h2><p>Node npm 包的 <code>postinstall</code> 自动准备其固定 Playwright 版本对应的 Chromium；已有匹配缓存时直接复用。受管升级即使禁用 npm lifecycle scripts，也在切换版本前显式准备浏览器，失败时保留旧版本；<code>mar-node install</code> / <code>upgrade</code> 也会执行准备。普通启动和工具调用不会下载浏览器。</p><p>请在最终服务账号下安装。默认缓存属于安装账号；若安装与运行账号不同，须在安装和服务环境设置相同的 <code>PLAYWRIGHT_BROWSERS_PATH</code>，并确保服务账号可读取及执行。离线部署可预置匹配平台和 Playwright 版本的 Chromium，再设置 <code>PLAYWRIGHT_SKIP_BROWSER_DOWNLOAD=1</code> 跳过下载；跳过不代表浏览器已可用。手动准备可运行安装包内 <code>scripts/install-web-browser.mjs</code>。</p><p>npm 安装控制库不等于安装浏览器二进制或 Linux 系统库。Node 自动下载浏览器，但不会执行 sudo、UAC 或自动安装系统包。<code>MAR_AGENT_WEB_FETCH_BROWSER_UNAVAILABLE</code> 表示浏览器无法启动：先检查匹配缓存、服务账号和路径；Linux 精简环境还可能缺少 Chromium 系统库，由管理员按需安装。HTTP 模式不依赖浏览器，失败不会自动切换模式。</p><p>生成的服务默认把浏览器缓存放在 Node 数据目录的 <code>web-browsers/</code>，准备步骤与服务启动使用同一路径；显式的 <code>PLAYWRIGHT_BROWSERS_PATH</code> 会被保留。Linux unit 保持 <code>ProtectSystem=strict</code> 并允许该缓存路径写入，受管升级复用服务环境。首次采用此流程的旧服务需按平台指南重新生成并应用服务定义；Node 不自行修改已部署服务或账号。仍须确保最终服务账号能读取、执行缓存。</p></div></div></main><footer class="VPDocFooter" data-v-cd08f8de data-v-579b47ad><!--[--><!--]--><!----><nav class="prev-next" aria-labelledby="doc-footer-aria-label" data-v-579b47ad><span class="visually-hidden" id="doc-footer-aria-label" data-v-579b47ad>Pager</span><div class="pager" data-v-579b47ad><a class="VPLink link pager-link prev" href="/docs/deployment/production" data-v-579b47ad><!--[--><span class="desc" data-v-579b47ad>上一篇</span><span class="title" data-v-579b47ad>生产部署与反向代理</span><!--]--></a></div><div class="pager" data-v-579b47ad><a class="VPLink link pager-link next" href="/docs/deployment/node-linux" data-v-579b47ad><!--[--><span class="desc" data-v-579b47ad>下一篇</span><span class="title" data-v-579b47ad>Linux Node 与 systemd</span><!--]--></a></div></nav></footer><!--[--><!--]--></div></div></div><!--[--><!--]--></div></div><!----><!--[--><!--]--></div></div>
-    <script>window.__VP_HASH_MAP__=JSON.parse("{\"administration_account.md\":\"BDxiZLcI\",\"administration_audit.md\":\"CPGsRZCt\",\"administration_conversation-templates.md\":\"DR-Q8ZJH\",\"administration_email-notifications.md\":\"CcYZiN4h\",\"administration_license.md\":\"CdgtKnVd\",\"administration_nodes-workspaces.md\":\"CMGc1EC3\",\"administration_oauth.md\":\"DVrr-ce3\",\"administration_secrets.md\":\"BVsK96Ny\",\"administration_template-workspace-maintenance.md\":\"ic3SEbkM\",\"administration_users-organizations.md\":\"CInTvyvp\",\"concepts_architecture.md\":\"CWYNi_YX\",\"concepts_data-and-security.md\":\"DvabQ2zO\",\"concepts_files-git-terminal.md\":\"DR-aSOLY\",\"concepts_node-and-workspace.md\":\"D4tWJ_5A\",\"concepts_permissions-and-sharing.md\":\"BGQlim_y\",\"concepts_runner-control.md\":\"Bkd1fXLk\",\"concepts_secrets.md\":\"DRt04t7A\",\"concepts_session-run-turn.md\":\"Crte1ZI0\",\"deployment_backup-restore.md\":\"fZtPK3bl\",\"deployment_network.md\":\"BarghfLt\",\"deployment_node-installation.md\":\"BhsVg-7E\",\"deployment_node-linux.md\":\"ayZjBc-g\",\"deployment_node-macos.md\":\"DRV9KDoO\",\"deployment_node-windows.md\":\"gpTo69VQ\",\"deployment_production.md\":\"83mdKwsb\",\"deployment_security-checklist.md\":\"CxWdJ9xO\",\"deployment_upgrade.md\":\"BESOToM5\",\"en-us_administration_account.md\":\"q4dfxq-Y\",\"en-us_administration_audit.md\":\"7tn6Eg6i\",\"en-us_administration_conversation-templates.md\":\"D7eekprK\",\"en-us_administration_email-notifications.md\":\"DvyUIBNy\",\"en-us_administration_license.md\":\"jmAMVJjC\",\"en-us_administration_nodes-workspaces.md\":\"BOA5ixAC\",\"en-us_administration_oauth.md\":\"DwEfTIEs\",\"en-us_administration_secrets.md\":\"DOlPJy7O\",\"en-us_administration_template-workspace-maintenance.md\":\"B1Dys0Xw\",\"en-us_administration_users-organizations.md\":\"CkX2sOqa\",\"en-us_concepts_architecture.md\":\"DUoUKxu0\",\"en-us_concepts_data-and-security.md\":\"DpXrCSPO\",\"en-us_concepts_files-git-terminal.md\":\"BK81hAoC\",\"en-us_concepts_node-and-workspace.md\":\"Bm7rEIAI\",\"en-us_concepts_permissions-and-sharing.md\":\"DiEopkbD\",\"en-us_concepts_runner-control.md\":\"CcrdYOTx\",\"en-us_concepts_secrets.md\":\"CPhBggXB\",\"en-us_concepts_session-run-turn.md\":\"CIfewRkn\",\"en-us_deployment_backup-restore.md\":\"DQUtQ5Yt\",\"en-us_deployment_network.md\":\"DdOgOLns\",\"en-us_deployment_node-installation.md\":\"DDQ4RdWI\",\"en-us_deployment_node-linux.md\":\"BXhYZ6de\",\"en-us_deployment_node-macos.md\":\"D26h7wJ1\",\"en-us_deployment_node-windows.md\":\"Bp-sytL8\",\"en-us_deployment_production.md\":\"Drc4IHoD\",\"en-us_deployment_security-checklist.md\":\"Dh3cWem6\",\"en-us_deployment_upgrade.md\":\"DZiDDiLn\",\"en-us_getting-started_connect-node.md\":\"DKLHaKuL\",\"en-us_getting-started_first-agent-session.md\":\"CN2rWPq7\",\"en-us_getting-started_first-login.md\":\"DQnGKeN2\",\"en-us_getting-started_next-steps.md\":\"D2UXmW2q\",\"en-us_getting-started_npm-quick-start.md\":\"CLCHq7k_\",\"en-us_getting-started_overview.md\":\"Bug5sh21\",\"en-us_getting-started_prerequisites.md\":\"Bpx_AQD1\",\"en-us_getting-started_register-workspace.md\":\"D3j75IC2\",\"en-us_getting-started_server-installation.md\":\"_k2XGM85\",\"en-us_operations_marctl.md\":\"CJYpPahB\",\"en-us_reference_configuration.md\":\"Ca2_G45i\",\"en-us_reference_keyboard-shortcuts.md\":\"BHIlAzih\",\"en-us_reference_limits.md\":\"BQahQvRI\",\"en-us_reference_ports-paths-data.md\":\"DckuEN9-\",\"en-us_reference_status-and-errors.md\":\"cq1A6JOM\",\"en-us_runners_claude-code.md\":\"BZp77nTJ\",\"en-us_runners_codex.md\":\"C8aQ3lj4\",\"en-us_runners_mar-agent.md\":\"DjryPiTL\",\"en-us_runners_opencode.md\":\"DAnPpdjG\",\"en-us_runners_overview.md\":\"n8off-KX\",\"en-us_runners_runner-troubleshooting.md\":\"BvJ6yGrw\",\"en-us_troubleshooting_node-offline.md\":\"BS2cHLeq\",\"en-us_troubleshooting_quick-diagnosis.md\":\"CPWX9djq\",\"en-us_troubleshooting_session-run.md\":\"o9ty9dWk\",\"en-us_troubleshooting_terminal.md\":\"Ce3H_Cq3\",\"en-us_troubleshooting_workspace-files.md\":\"I66m4D0K\",\"en-us_workbench_composer.md\":\"CCnbitB3\",\"en-us_workbench_context-and-plan.md\":\"E9yFtLaR\",\"en-us_workbench_conversation.md\":\"DWFI4rSa\",\"en-us_workbench_file-reference-and-attachment.md\":\"Xzbr8MRS\",\"en-us_workbench_files.md\":\"C5byBZOZ\",\"en-us_workbench_git-changes.md\":\"CgzmFd8l\",\"en-us_workbench_git-history.md\":\"CcKXv4NB\",\"en-us_workbench_hosted-conversations.md\":\"hxgo3oRa\",\"en-us_workbench_mobile.md\":\"C3A2Sq-s\",\"en-us_workbench_navigation.md\":\"BXLJsQMY\",\"en-us_workbench_sessions.md\":\"tSnti1TK\",\"en-us_workbench_skills.md\":\"C4xlXyjC\",\"en-us_workbench_terminal.md\":\"B23OFnB3\",\"getting-started_connect-node.md\":\"B9kKn-7y\",\"getting-started_first-agent-session.md\":\"D-uls92b\",\"getting-started_first-login.md\":\"DVWDKgMU\",\"getting-started_next-steps.md\":\"CjwJgSAt\",\"getting-started_npm-quick-start.md\":\"B9varoSe\",\"getting-started_overview.md\":\"CA1CCOBc\",\"getting-started_prerequisites.md\":\"D26KU42D\",\"getting-started_register-workspace.md\":\"BW-xjHjl\",\"getting-started_server-installation.md\":\"D3P3Lmc2\",\"operations_marctl.md\":\"BW9barpn\",\"reference_configuration.md\":\"CvHKh-kv\",\"reference_keyboard-shortcuts.md\":\"DOivSxmM\",\"reference_limits.md\":\"17DNV05j\",\"reference_ports-paths-data.md\":\"RqYAhrgF\",\"reference_status-and-errors.md\":\"BwpSR6nH\",\"runners_claude-code.md\":\"DSGRX72-\",\"runners_codex.md\":\"CDGNsFMp\",\"runners_mar-agent.md\":\"DjuqySh9\",\"runners_opencode.md\":\"DSvXW8Sv\",\"runners_overview.md\":\"CHK7UvIl\",\"runners_runner-troubleshooting.md\":\"CIWCfGkf\",\"troubleshooting_node-offline.md\":\"BQ-5_Xyu\",\"troubleshooting_quick-diagnosis.md\":\"fq0U5Cg7\",\"troubleshooting_session-run.md\":\"Cny0YwSq\",\"troubleshooting_terminal.md\":\"DB0zc8sK\",\"troubleshooting_workspace-files.md\":\"BEFLZu54\",\"workbench_composer.md\":\"DlU35VaN\",\"workbench_context-and-plan.md\":\"CzRACFjQ\",\"workbench_conversation.md\":\"Ib2W7CCX\",\"workbench_file-reference-and-attachment.md\":\"CSLMm-nL\",\"workbench_files.md\":\"B5xE7YGc\",\"workbench_git-changes.md\":\"C7xvpMwy\",\"workbench_git-history.md\":\"Ckvhp8Y3\",\"workbench_hosted-conversations.md\":\"C0YVmf0T\",\"workbench_mobile.md\":\"3NSNZGu8\",\"workbench_navigation.md\":\"B8UD4qpB\",\"workbench_sessions.md\":\"DHPI_apA\",\"workbench_skills.md\":\"rWZ_VuoB\",\"workbench_terminal.md\":\"YzgZvVcu\"}");window.__VP_SITE_DATA__=JSON.parse("{\"lang\":\"zh-CN\",\"dir\":\"ltr\",\"title\":\"MyAgentRoam Documentation\",\"description\":\"MyAgentRoam 部署、配置与使用文档\",\"base\":\"/docs/\",\"head\":[],\"router\":{\"prefetchLinks\":true},\"appearance\":true,\"themeConfig\":{\"logo\":\"/logo.png?v=logo-20261011\",\"logoLink\":\"/\",\"siteTitle\":\"Documentation\",\"langMenuLabel\":\"切换语言\",\"outline\":{\"label\":\"本页内容\",\"level\":[2,3]},\"returnToTopLabel\":\"返回顶部\",\"sidebarMenuLabel\":\"文档目录\",\"darkModeSwitchLabel\":\"外观\",\"lightModeSwitchTitle\":\"切换至浅色模式\",\"darkModeSwitchTitle\":\"切换至深色模式\",\"docFooter\":{\"prev\":\"上一篇\",\"next\":\"下一篇\"},\"search\":{\"provider\":\"local\",\"options\":{\"translations\":{\"button\":{\"buttonText\":\"搜索文档\",\"buttonAriaLabel\":\"搜索文档\"}}}},\"sidebar\":{\"/en-US/\":[{\"text\":\"Getting Started\",\"items\":[{\"text\":\"What Is MyAgentRoam?\",\"link\":\"/en-US/getting-started/overview\"},{\"text\":\"Local npm Quick Start\",\"link\":\"/en-US/getting-started/npm-quick-start\"},{\"text\":\"Before You Deploy\",\"link\":\"/en-US/getting-started/prerequisites\"},{\"text\":\"Deploy Server and Web\",\"link\":\"/en-US/getting-started/server-installation\"},{\"text\":\"First Sign-in and Password Change\",\"link\":\"/en-US/getting-started/first-login\"},{\"text\":\"Connect Your First Node\",\"link\":\"/en-US/getting-started/connect-node\"},{\"text\":\"Register Your First Workspace\",\"link\":\"/en-US/getting-started/register-workspace\"},{\"text\":\"Start Your First Agent Session\",\"link\":\"/en-US/getting-started/first-agent-session\"},{\"text\":\"Next Steps\",\"link\":\"/en-US/getting-started/next-steps\"}]},{\"text\":\"Core Concepts\",\"items\":[{\"text\":\"Server, Node, Web, and Runner\",\"link\":\"/en-US/concepts/architecture\"},{\"text\":\"Nodes and Workspaces\",\"link\":\"/en-US/concepts/node-and-workspace\"},{\"text\":\"Sessions, Runs, and Message Queues\",\"link\":\"/en-US/concepts/session-run-turn\"},{\"text\":\"Runners and Session Control\",\"link\":\"/en-US/concepts/runner-control\"},{\"text\":\"Files, Git, and Terminals\",\"link\":\"/en-US/concepts/files-git-terminal\"},{\"text\":\"Users, Organizations, and Access\",\"link\":\"/en-US/concepts/permissions-and-sharing\"},{\"text\":\"Secrets and Injection Order\",\"link\":\"/en-US/concepts/secrets\"},{\"text\":\"Data, Credentials, and Security\",\"link\":\"/en-US/concepts/data-and-security\"}]},{\"text\":\"Work / Conversation Guide\",\"items\":[{\"text\":\"Work Mode, Nodes, and Workspaces\",\"link\":\"/en-US/workbench/navigation\"},{\"text\":\"Favorite and Install Skills\",\"link\":\"/en-US/workbench/skills\"},{\"text\":\"Create and Manage Sessions\",\"link\":\"/en-US/workbench/sessions\"},{\"text\":\"Messages and Composer\",\"link\":\"/en-US/workbench/composer\"},{\"text\":\"Context, Compact, and Plan\",\"link\":\"/en-US/workbench/context-and-plan\"},{\"text\":\"References, Folders, and Attachments\",\"link\":\"/en-US/workbench/file-reference-and-attachment\"},{\"text\":\"Conversations, Tools, and Notifications\",\"link\":\"/en-US/workbench/conversation\"},{\"text\":\"Start a Template Conversation in Conversation Mode\",\"link\":\"/en-US/workbench/hosted-conversations\"},{\"text\":\"Browse, Search, and Manage Files\",\"link\":\"/en-US/workbench/files\"},{\"text\":\"Git Changes and Diff\",\"link\":\"/en-US/workbench/git-changes\"},{\"text\":\"Git History\",\"link\":\"/en-US/workbench/git-history\"},{\"text\":\"Workspace Terminals\",\"link\":\"/en-US/workbench/terminal\"},{\"text\":\"Continue on Mobile\",\"link\":\"/en-US/workbench/mobile\"}]},{\"text\":\"Agent Guide\",\"items\":[{\"text\":\"Choose an Agent\",\"link\":\"/en-US/runners/overview\"},{\"text\":\"OpenCode\",\"link\":\"/en-US/runners/opencode\"},{\"text\":\"Codex\",\"link\":\"/en-US/runners/codex\"},{\"text\":\"Claude Code\",\"link\":\"/en-US/runners/claude-code\"},{\"text\":\"Built-in MAR Agent\",\"link\":\"/en-US/runners/mar-agent\"},{\"text\":\"Runner Troubleshooting\",\"link\":\"/en-US/runners/runner-troubleshooting\"}]},{\"text\":\"Deployment and Operations\",\"items\":[{\"text\":\"Production Deployment and Reverse Proxy\",\"link\":\"/en-US/deployment/production\"},{\"text\":\"Install and Register a Node\",\"link\":\"/en-US/deployment/node-installation\"},{\"text\":\"Linux Node and systemd\",\"link\":\"/en-US/deployment/node-linux\"},{\"text\":\"Windows Node and Task Scheduler\",\"link\":\"/en-US/deployment/node-windows\"},{\"text\":\"macOS Node and launchd\",\"link\":\"/en-US/deployment/node-macos\"},{\"text\":\"Upgrade MyAgentRoam\",\"link\":\"/en-US/deployment/upgrade\"},{\"text\":\"Backup and Restore\",\"link\":\"/en-US/deployment/backup-restore\"},{\"text\":\"Network, TLS, and WebSocket\",\"link\":\"/en-US/deployment/network\"},{\"text\":\"Production Security Checklist\",\"link\":\"/en-US/deployment/security-checklist\"}]},{\"text\":\"Node Operations Tools\",\"items\":[{\"text\":\"Manage Nodes with marctl\",\"link\":\"/en-US/operations/marctl\"}]},{\"text\":\"Administration Guide\",\"items\":[{\"text\":\"Account Security and Sign-in Sessions\",\"link\":\"/en-US/administration/account\"},{\"text\":\"Manage Nodes and Workspaces\",\"link\":\"/en-US/administration/nodes-workspaces\"},{\"text\":\"Manage Conversation Templates\",\"link\":\"/en-US/administration/conversation-templates\"},{\"text\":\"Maintain a Conversation Template Workspace\",\"link\":\"/en-US/administration/template-workspace-maintenance\"},{\"text\":\"Manage Secrets\",\"link\":\"/en-US/administration/secrets\"},{\"text\":\"Configure SMTP Email and Notification Templates\",\"link\":\"/en-US/administration/email-notifications\"},{\"text\":\"Manage Users, Organizations, and Roles\",\"link\":\"/en-US/administration/users-organizations\"},{\"text\":\"Configure OAuth 2.0 SSO\",\"link\":\"/en-US/administration/oauth\"},{\"text\":\"Audit Events and Export\",\"link\":\"/en-US/administration/audit\"},{\"text\":\"Personal and Enterprise Licenses\",\"link\":\"/en-US/administration/license\"}]},{\"text\":\"Troubleshooting and Reference\",\"items\":[{\"text\":\"Quick Diagnosis\",\"link\":\"/en-US/troubleshooting/quick-diagnosis\"},{\"text\":\"Node Registration or Offline Issues\",\"link\":\"/en-US/troubleshooting/node-offline\"},{\"text\":\"Workspace, File, or Git Issues\",\"link\":\"/en-US/troubleshooting/workspace-files\"},{\"text\":\"Session Stuck or Read-only\",\"link\":\"/en-US/troubleshooting/session-run\"},{\"text\":\"Terminal Connection Issues\",\"link\":\"/en-US/troubleshooting/terminal\"},{\"text\":\"Keyboard Shortcuts\",\"link\":\"/en-US/reference/keyboard-shortcuts\"},{\"text\":\"Statuses and Common Errors\",\"link\":\"/en-US/reference/status-and-errors\"},{\"text\":\"Configuration Reference\",\"link\":\"/en-US/reference/configuration\"},{\"text\":\"Ports, Paths, and Data\",\"link\":\"/en-US/reference/ports-paths-data\"},{\"text\":\"Versions, Capacity, and Limits\",\"link\":\"/en-US/reference/limits\"}]}],\"/\":[{\"text\":\"开始使用\",\"items\":[{\"text\":\"MyAgentRoam 是什么\",\"link\":\"/getting-started/overview\"},{\"text\":\"本机 npm 快速开始\",\"link\":\"/getting-started/npm-quick-start\"},{\"text\":\"部署前准备\",\"link\":\"/getting-started/prerequisites\"},{\"text\":\"部署 Server 与 Web\",\"link\":\"/getting-started/server-installation\"},{\"text\":\"首次登录与修改密码\",\"link\":\"/getting-started/first-login\"},{\"text\":\"接入第一台 Node\",\"link\":\"/getting-started/connect-node\"},{\"text\":\"登记第一个 Workspace\",\"link\":\"/getting-started/register-workspace\"},{\"text\":\"开始第一次 Agent 对话\",\"link\":\"/getting-started/first-agent-session\"},{\"text\":\"接下来可以做什么\",\"link\":\"/getting-started/next-steps\"}]},{\"text\":\"核心概念\",\"items\":[{\"text\":\"Server、Node、Web 与 Runner\",\"link\":\"/concepts/architecture\"},{\"text\":\"Node 与 Workspace\",\"link\":\"/concepts/node-and-workspace\"},{\"text\":\"会话、运行与消息队列\",\"link\":\"/concepts/session-run-turn\"},{\"text\":\"Runner 与会话控制状态\",\"link\":\"/concepts/runner-control\"},{\"text\":\"文件、Git 与终端\",\"link\":\"/concepts/files-git-terminal\"},{\"text\":\"用户、组织与资源权限\",\"link\":\"/concepts/permissions-and-sharing\"},{\"text\":\"环境变量密钥与注入顺序\",\"link\":\"/concepts/secrets\"},{\"text\":\"数据归属、凭据与安全边界\",\"link\":\"/concepts/data-and-security\"}]},{\"text\":\"工作 / 对话使用指南\",\"items\":[{\"text\":\"工作模式、Node 与 Workspace\",\"link\":\"/workbench/navigation\"},{\"text\":\"收藏与安装 Skill\",\"link\":\"/workbench/skills\"},{\"text\":\"创建、查找与管理会话\",\"link\":\"/workbench/sessions\"},{\"text\":\"发送消息与使用 Composer\",\"link\":\"/workbench/composer\"},{\"text\":\"上下文用量、Compact 与 Plan\",\"link\":\"/workbench/context-and-plan\"},{\"text\":\"@ 引用、文件夹与附件\",\"link\":\"/workbench/file-reference-and-attachment\"},{\"text\":\"阅读对话、工具调用与通知\",\"link\":\"/workbench/conversation\"},{\"text\":\"在对话模式从模板新建对话\",\"link\":\"/workbench/hosted-conversations\"},{\"text\":\"浏览、搜索与管理文件\",\"link\":\"/workbench/files\"},{\"text\":\"查看 Git Changes 与 Diff\",\"link\":\"/workbench/git-changes\"},{\"text\":\"查看 Git 历史\",\"link\":\"/workbench/git-history\"},{\"text\":\"使用 Workspace 终端\",\"link\":\"/workbench/terminal\"},{\"text\":\"在移动端继续工作\",\"link\":\"/workbench/mobile\"}]},{\"text\":\"Agent 指南\",\"items\":[{\"text\":\"选择 Agent\",\"link\":\"/runners/overview\"},{\"text\":\"安装、配置和使用 OpenCode\",\"link\":\"/runners/opencode\"},{\"text\":\"安装、配置和使用 Codex\",\"link\":\"/runners/codex\"},{\"text\":\"安装、配置和使用 Claude Code\",\"link\":\"/runners/claude-code\"},{\"text\":\"配置和使用内置 MAR Agent\",\"link\":\"/runners/mar-agent\"},{\"text\":\"Agent 不可用或模型缺失\",\"link\":\"/runners/runner-troubleshooting\"}]},{\"text\":\"部署与运维\",\"items\":[{\"text\":\"生产部署与反向代理\",\"link\":\"/deployment/production\"},{\"text\":\"安装与注册 Node\",\"link\":\"/deployment/node-installation\"},{\"text\":\"Linux Node 与 systemd\",\"link\":\"/deployment/node-linux\"},{\"text\":\"Windows Node 与任务计划\",\"link\":\"/deployment/node-windows\"},{\"text\":\"macOS Node 与 launchd\",\"link\":\"/deployment/node-macos\"},{\"text\":\"升级 MyAgentRoam\",\"link\":\"/deployment/upgrade\"},{\"text\":\"备份与恢复\",\"link\":\"/deployment/backup-restore\"},{\"text\":\"网络、TLS 与 WebSocket\",\"link\":\"/deployment/network\"},{\"text\":\"上线安全检查清单\",\"link\":\"/deployment/security-checklist\"}]},{\"text\":\"节点运维工具\",\"items\":[{\"text\":\"使用 marctl 管理节点\",\"link\":\"/operations/marctl\"}]},{\"text\":\"管理指南\",\"items\":[{\"text\":\"账户安全与登录会话\",\"link\":\"/administration/account\"},{\"text\":\"管理 Node 与 Workspace\",\"link\":\"/administration/nodes-workspaces\"},{\"text\":\"管理对话模板\",\"link\":\"/administration/conversation-templates\"},{\"text\":\"维护对话模板 Workspace\",\"link\":\"/administration/template-workspace-maintenance\"},{\"text\":\"管理环境变量密钥\",\"link\":\"/administration/secrets\"},{\"text\":\"配置 SMTP 邮件与通知模板\",\"link\":\"/administration/email-notifications\"},{\"text\":\"管理用户、组织与角色\",\"link\":\"/administration/users-organizations\"},{\"text\":\"配置 OAuth 2.0 SSO\",\"link\":\"/administration/oauth\"},{\"text\":\"查询与导出操作审计\",\"link\":\"/administration/audit\"},{\"text\":\"社区版、企业 License 与冻结态\",\"link\":\"/administration/license\"}]},{\"text\":\"故障排查与参考\",\"items\":[{\"text\":\"从现象开始排查\",\"link\":\"/troubleshooting/quick-diagnosis\"},{\"text\":\"Node 注册失败或离线\",\"link\":\"/troubleshooting/node-offline\"},{\"text\":\"Workspace、文件或 Git 不可用\",\"link\":\"/troubleshooting/workspace-files\"},{\"text\":\"会话卡在 Working、Idle 或只读\",\"link\":\"/troubleshooting/session-run\"},{\"text\":\"终端无法打开或频繁断线\",\"link\":\"/troubleshooting/terminal\"},{\"text\":\"键盘快捷键\",\"link\":\"/reference/keyboard-shortcuts\"},{\"text\":\"状态、提示与常见错误\",\"link\":\"/reference/status-and-errors\"},{\"text\":\"配置项参考\",\"link\":\"/reference/configuration\"},{\"text\":\"端口、配置目录与数据位置\",\"link\":\"/reference/ports-paths-data\"},{\"text\":\"版本、容量与已知限制\",\"link\":\"/reference/limits\"}]}]}},\"locales\":{\"root\":{\"label\":\"简体中文\",\"lang\":\"zh-CN\"},\"en-US\":{\"label\":\"English\",\"lang\":\"en-US\",\"title\":\"MyAgentRoam Documentation\",\"description\":\"Deployment, configuration, and usage documentation for MyAgentRoam\",\"themeConfig\":{\"siteTitle\":\"Documentation\",\"langMenuLabel\":\"Switch language\",\"outline\":{\"label\":\"On This Page\",\"level\":[2,3]},\"returnToTopLabel\":\"Return to Top\",\"sidebarMenuLabel\":\"Menu\",\"darkModeSwitchLabel\":\"Appearance\",\"lightModeSwitchTitle\":\"Switch to Light Theme\",\"darkModeSwitchTitle\":\"Switch to Dark Theme\",\"docFooter\":{\"prev\":\"Previous\",\"next\":\"Next\"},\"search\":{\"provider\":\"local\",\"options\":{\"translations\":{\"button\":{\"buttonText\":\"Search Documentation\",\"buttonAriaLabel\":\"Search Documentation\"}}}}}}},\"scrollOffset\":134,\"cleanUrls\":true}");</script>
+    <script>window.__VP_HASH_MAP__=JSON.parse("{\"administration_account.md\":\"BDxiZLcI\",\"administration_audit.md\":\"CPGsRZCt\",\"administration_conversation-templates.md\":\"DR-Q8ZJH\",\"administration_email-notifications.md\":\"CcYZiN4h\",\"administration_license.md\":\"Bf1iyuKG\",\"administration_nodes-workspaces.md\":\"CMGc1EC3\",\"administration_oauth.md\":\"DVrr-ce3\",\"administration_secrets.md\":\"BVsK96Ny\",\"administration_template-workspace-maintenance.md\":\"ic3SEbkM\",\"administration_users-organizations.md\":\"CInTvyvp\",\"concepts_architecture.md\":\"CWYNi_YX\",\"concepts_data-and-security.md\":\"DvabQ2zO\",\"concepts_files-git-terminal.md\":\"DR-aSOLY\",\"concepts_node-and-workspace.md\":\"D4tWJ_5A\",\"concepts_permissions-and-sharing.md\":\"BGQlim_y\",\"concepts_runner-control.md\":\"Bkd1fXLk\",\"concepts_secrets.md\":\"DRt04t7A\",\"concepts_session-run-turn.md\":\"Crte1ZI0\",\"deployment_backup-restore.md\":\"fZtPK3bl\",\"deployment_network.md\":\"BarghfLt\",\"deployment_node-installation.md\":\"BhsVg-7E\",\"deployment_node-linux.md\":\"ayZjBc-g\",\"deployment_node-macos.md\":\"DRV9KDoO\",\"deployment_node-windows.md\":\"gpTo69VQ\",\"deployment_production.md\":\"83mdKwsb\",\"deployment_security-checklist.md\":\"CxWdJ9xO\",\"deployment_upgrade.md\":\"BESOToM5\",\"en-us_administration_account.md\":\"q4dfxq-Y\",\"en-us_administration_audit.md\":\"7tn6Eg6i\",\"en-us_administration_conversation-templates.md\":\"D7eekprK\",\"en-us_administration_email-notifications.md\":\"DvyUIBNy\",\"en-us_administration_license.md\":\"Dmg8rNEl\",\"en-us_administration_nodes-workspaces.md\":\"BOA5ixAC\",\"en-us_administration_oauth.md\":\"DwEfTIEs\",\"en-us_administration_secrets.md\":\"DOlPJy7O\",\"en-us_administration_template-workspace-maintenance.md\":\"B1Dys0Xw\",\"en-us_administration_users-organizations.md\":\"CkX2sOqa\",\"en-us_concepts_architecture.md\":\"DUoUKxu0\",\"en-us_concepts_data-and-security.md\":\"DpXrCSPO\",\"en-us_concepts_files-git-terminal.md\":\"BK81hAoC\",\"en-us_concepts_node-and-workspace.md\":\"Bm7rEIAI\",\"en-us_concepts_permissions-and-sharing.md\":\"DiEopkbD\",\"en-us_concepts_runner-control.md\":\"CcrdYOTx\",\"en-us_concepts_secrets.md\":\"CPhBggXB\",\"en-us_concepts_session-run-turn.md\":\"CIfewRkn\",\"en-us_deployment_backup-restore.md\":\"DQUtQ5Yt\",\"en-us_deployment_network.md\":\"DdOgOLns\",\"en-us_deployment_node-installation.md\":\"DDQ4RdWI\",\"en-us_deployment_node-linux.md\":\"BXhYZ6de\",\"en-us_deployment_node-macos.md\":\"D26h7wJ1\",\"en-us_deployment_node-windows.md\":\"Bp-sytL8\",\"en-us_deployment_production.md\":\"Drc4IHoD\",\"en-us_deployment_security-checklist.md\":\"Dh3cWem6\",\"en-us_deployment_upgrade.md\":\"DZiDDiLn\",\"en-us_getting-started_connect-node.md\":\"DKLHaKuL\",\"en-us_getting-started_first-agent-session.md\":\"CN2rWPq7\",\"en-us_getting-started_first-login.md\":\"DQnGKeN2\",\"en-us_getting-started_next-steps.md\":\"D2UXmW2q\",\"en-us_getting-started_npm-quick-start.md\":\"Dwsi-ffA\",\"en-us_getting-started_overview.md\":\"Bug5sh21\",\"en-us_getting-started_prerequisites.md\":\"Bpx_AQD1\",\"en-us_getting-started_register-workspace.md\":\"D3j75IC2\",\"en-us_getting-started_server-installation.md\":\"_k2XGM85\",\"en-us_operations_marctl.md\":\"CJYpPahB\",\"en-us_reference_configuration.md\":\"Ca2_G45i\",\"en-us_reference_keyboard-shortcuts.md\":\"BHIlAzih\",\"en-us_reference_limits.md\":\"BQahQvRI\",\"en-us_reference_ports-paths-data.md\":\"DckuEN9-\",\"en-us_reference_status-and-errors.md\":\"cq1A6JOM\",\"en-us_runners_claude-code.md\":\"BZp77nTJ\",\"en-us_runners_codex.md\":\"C8aQ3lj4\",\"en-us_runners_mar-agent.md\":\"DjryPiTL\",\"en-us_runners_opencode.md\":\"DAnPpdjG\",\"en-us_runners_overview.md\":\"n8off-KX\",\"en-us_runners_runner-troubleshooting.md\":\"BvJ6yGrw\",\"en-us_troubleshooting_node-offline.md\":\"BS2cHLeq\",\"en-us_troubleshooting_quick-diagnosis.md\":\"CPWX9djq\",\"en-us_troubleshooting_session-run.md\":\"o9ty9dWk\",\"en-us_troubleshooting_terminal.md\":\"Ce3H_Cq3\",\"en-us_troubleshooting_workspace-files.md\":\"I66m4D0K\",\"en-us_workbench_composer.md\":\"CCnbitB3\",\"en-us_workbench_context-and-plan.md\":\"E9yFtLaR\",\"en-us_workbench_conversation.md\":\"DWFI4rSa\",\"en-us_workbench_file-reference-and-attachment.md\":\"Xzbr8MRS\",\"en-us_workbench_files.md\":\"C5byBZOZ\",\"en-us_workbench_git-changes.md\":\"CgzmFd8l\",\"en-us_workbench_git-history.md\":\"CcKXv4NB\",\"en-us_workbench_hosted-conversations.md\":\"hxgo3oRa\",\"en-us_workbench_mobile.md\":\"C3A2Sq-s\",\"en-us_workbench_navigation.md\":\"BXLJsQMY\",\"en-us_workbench_sessions.md\":\"tSnti1TK\",\"en-us_workbench_skills.md\":\"xchi27R9\",\"en-us_workbench_terminal.md\":\"B23OFnB3\",\"getting-started_connect-node.md\":\"B9kKn-7y\",\"getting-started_first-agent-session.md\":\"D-uls92b\",\"getting-started_first-login.md\":\"DVWDKgMU\",\"getting-started_next-steps.md\":\"CjwJgSAt\",\"getting-started_npm-quick-start.md\":\"CcxMwUgz\",\"getting-started_overview.md\":\"CA1CCOBc\",\"getting-started_prerequisites.md\":\"D26KU42D\",\"getting-started_register-workspace.md\":\"BW-xjHjl\",\"getting-started_server-installation.md\":\"D3P3Lmc2\",\"operations_marctl.md\":\"BW9barpn\",\"reference_configuration.md\":\"CvHKh-kv\",\"reference_keyboard-shortcuts.md\":\"DOivSxmM\",\"reference_limits.md\":\"17DNV05j\",\"reference_ports-paths-data.md\":\"RqYAhrgF\",\"reference_status-and-errors.md\":\"BwpSR6nH\",\"runners_claude-code.md\":\"DSGRX72-\",\"runners_codex.md\":\"CDGNsFMp\",\"runners_mar-agent.md\":\"DjuqySh9\",\"runners_opencode.md\":\"DSvXW8Sv\",\"runners_overview.md\":\"CHK7UvIl\",\"runners_runner-troubleshooting.md\":\"CIWCfGkf\",\"troubleshooting_node-offline.md\":\"BQ-5_Xyu\",\"troubleshooting_quick-diagnosis.md\":\"fq0U5Cg7\",\"troubleshooting_session-run.md\":\"Cny0YwSq\",\"troubleshooting_terminal.md\":\"DB0zc8sK\",\"troubleshooting_workspace-files.md\":\"BEFLZu54\",\"workbench_composer.md\":\"DlU35VaN\",\"workbench_context-and-plan.md\":\"CzRACFjQ\",\"workbench_conversation.md\":\"Ib2W7CCX\",\"workbench_file-reference-and-attachment.md\":\"CSLMm-nL\",\"workbench_files.md\":\"B5xE7YGc\",\"workbench_git-changes.md\":\"C7xvpMwy\",\"workbench_git-history.md\":\"Ckvhp8Y3\",\"workbench_hosted-conversations.md\":\"C0YVmf0T\",\"workbench_mobile.md\":\"3NSNZGu8\",\"workbench_navigation.md\":\"B8UD4qpB\",\"workbench_sessions.md\":\"DHPI_apA\",\"workbench_skills.md\":\"BQw1Wuiy\",\"workbench_terminal.md\":\"YzgZvVcu\"}");window.__VP_SITE_DATA__=JSON.parse("{\"lang\":\"zh-CN\",\"dir\":\"ltr\",\"title\":\"MyAgentRoam Documentation\",\"description\":\"MyAgentRoam 部署、配置与使用文档\",\"base\":\"/docs/\",\"head\":[],\"router\":{\"prefetchLinks\":true},\"appearance\":true,\"themeConfig\":{\"logo\":\"/logo.png?v=logo-20261011\",\"logoLink\":\"/\",\"siteTitle\":\"Documentation\",\"langMenuLabel\":\"切换语言\",\"outline\":{\"label\":\"本页内容\",\"level\":[2,3]},\"returnToTopLabel\":\"返回顶部\",\"sidebarMenuLabel\":\"文档目录\",\"darkModeSwitchLabel\":\"外观\",\"lightModeSwitchTitle\":\"切换至浅色模式\",\"darkModeSwitchTitle\":\"切换至深色模式\",\"docFooter\":{\"prev\":\"上一篇\",\"next\":\"下一篇\"},\"search\":{\"provider\":\"local\",\"options\":{\"translations\":{\"button\":{\"buttonText\":\"搜索文档\",\"buttonAriaLabel\":\"搜索文档\"}}}},\"sidebar\":{\"/en-US/\":[{\"text\":\"Getting Started\",\"items\":[{\"text\":\"What Is MyAgentRoam?\",\"link\":\"/en-US/getting-started/overview\"},{\"text\":\"Local npm Quick Start\",\"link\":\"/en-US/getting-started/npm-quick-start\"},{\"text\":\"Before You Deploy\",\"link\":\"/en-US/getting-started/prerequisites\"},{\"text\":\"Deploy Server and Web\",\"link\":\"/en-US/getting-started/server-installation\"},{\"text\":\"First Sign-in and Password Change\",\"link\":\"/en-US/getting-started/first-login\"},{\"text\":\"Connect Your First Node\",\"link\":\"/en-US/getting-started/connect-node\"},{\"text\":\"Register Your First Workspace\",\"link\":\"/en-US/getting-started/register-workspace\"},{\"text\":\"Start Your First Agent Session\",\"link\":\"/en-US/getting-started/first-agent-session\"},{\"text\":\"Next Steps\",\"link\":\"/en-US/getting-started/next-steps\"}]},{\"text\":\"Core Concepts\",\"items\":[{\"text\":\"Server, Node, Web, and Runner\",\"link\":\"/en-US/concepts/architecture\"},{\"text\":\"Nodes and Workspaces\",\"link\":\"/en-US/concepts/node-and-workspace\"},{\"text\":\"Sessions, Runs, and Message Queues\",\"link\":\"/en-US/concepts/session-run-turn\"},{\"text\":\"Runners and Session Control\",\"link\":\"/en-US/concepts/runner-control\"},{\"text\":\"Files, Git, and Terminals\",\"link\":\"/en-US/concepts/files-git-terminal\"},{\"text\":\"Users, Organizations, and Access\",\"link\":\"/en-US/concepts/permissions-and-sharing\"},{\"text\":\"Secrets and Injection Order\",\"link\":\"/en-US/concepts/secrets\"},{\"text\":\"Data, Credentials, and Security\",\"link\":\"/en-US/concepts/data-and-security\"}]},{\"text\":\"Work / Conversation Guide\",\"items\":[{\"text\":\"Work Mode, Nodes, and Workspaces\",\"link\":\"/en-US/workbench/navigation\"},{\"text\":\"Favorite and Install Skills\",\"link\":\"/en-US/workbench/skills\"},{\"text\":\"Create and Manage Sessions\",\"link\":\"/en-US/workbench/sessions\"},{\"text\":\"Messages and Composer\",\"link\":\"/en-US/workbench/composer\"},{\"text\":\"Context, Compact, and Plan\",\"link\":\"/en-US/workbench/context-and-plan\"},{\"text\":\"References, Folders, and Attachments\",\"link\":\"/en-US/workbench/file-reference-and-attachment\"},{\"text\":\"Conversations, Tools, and Notifications\",\"link\":\"/en-US/workbench/conversation\"},{\"text\":\"Start a Template Conversation in Conversation Mode\",\"link\":\"/en-US/workbench/hosted-conversations\"},{\"text\":\"Browse, Search, and Manage Files\",\"link\":\"/en-US/workbench/files\"},{\"text\":\"Git Changes and Diff\",\"link\":\"/en-US/workbench/git-changes\"},{\"text\":\"Git History\",\"link\":\"/en-US/workbench/git-history\"},{\"text\":\"Workspace Terminals\",\"link\":\"/en-US/workbench/terminal\"},{\"text\":\"Continue on Mobile\",\"link\":\"/en-US/workbench/mobile\"}]},{\"text\":\"Agent Guide\",\"items\":[{\"text\":\"Choose an Agent\",\"link\":\"/en-US/runners/overview\"},{\"text\":\"OpenCode\",\"link\":\"/en-US/runners/opencode\"},{\"text\":\"Codex\",\"link\":\"/en-US/runners/codex\"},{\"text\":\"Claude Code\",\"link\":\"/en-US/runners/claude-code\"},{\"text\":\"Built-in MAR Agent\",\"link\":\"/en-US/runners/mar-agent\"},{\"text\":\"Runner Troubleshooting\",\"link\":\"/en-US/runners/runner-troubleshooting\"}]},{\"text\":\"Deployment and Operations\",\"items\":[{\"text\":\"Production Deployment and Reverse Proxy\",\"link\":\"/en-US/deployment/production\"},{\"text\":\"Install and Register a Node\",\"link\":\"/en-US/deployment/node-installation\"},{\"text\":\"Linux Node and systemd\",\"link\":\"/en-US/deployment/node-linux\"},{\"text\":\"Windows Node and Task Scheduler\",\"link\":\"/en-US/deployment/node-windows\"},{\"text\":\"macOS Node and launchd\",\"link\":\"/en-US/deployment/node-macos\"},{\"text\":\"Upgrade MyAgentRoam\",\"link\":\"/en-US/deployment/upgrade\"},{\"text\":\"Backup and Restore\",\"link\":\"/en-US/deployment/backup-restore\"},{\"text\":\"Network, TLS, and WebSocket\",\"link\":\"/en-US/deployment/network\"},{\"text\":\"Production Security Checklist\",\"link\":\"/en-US/deployment/security-checklist\"}]},{\"text\":\"Node Operations Tools\",\"items\":[{\"text\":\"Manage Nodes with marctl\",\"link\":\"/en-US/operations/marctl\"}]},{\"text\":\"Administration Guide\",\"items\":[{\"text\":\"Account Security and Sign-in Sessions\",\"link\":\"/en-US/administration/account\"},{\"text\":\"Manage Nodes and Workspaces\",\"link\":\"/en-US/administration/nodes-workspaces\"},{\"text\":\"Manage Conversation Templates\",\"link\":\"/en-US/administration/conversation-templates\"},{\"text\":\"Maintain a Conversation Template Workspace\",\"link\":\"/en-US/administration/template-workspace-maintenance\"},{\"text\":\"Manage Secrets\",\"link\":\"/en-US/administration/secrets\"},{\"text\":\"Configure SMTP Email and Notification Templates\",\"link\":\"/en-US/administration/email-notifications\"},{\"text\":\"Manage Users, Organizations, and Roles\",\"link\":\"/en-US/administration/users-organizations\"},{\"text\":\"Configure OAuth 2.0 SSO\",\"link\":\"/en-US/administration/oauth\"},{\"text\":\"Audit Events and Export\",\"link\":\"/en-US/administration/audit\"},{\"text\":\"Personal and Enterprise Licenses\",\"link\":\"/en-US/administration/license\"}]},{\"text\":\"Troubleshooting and Reference\",\"items\":[{\"text\":\"Quick Diagnosis\",\"link\":\"/en-US/troubleshooting/quick-diagnosis\"},{\"text\":\"Node Registration or Offline Issues\",\"link\":\"/en-US/troubleshooting/node-offline\"},{\"text\":\"Workspace, File, or Git Issues\",\"link\":\"/en-US/troubleshooting/workspace-files\"},{\"text\":\"Session Stuck or Read-only\",\"link\":\"/en-US/troubleshooting/session-run\"},{\"text\":\"Terminal Connection Issues\",\"link\":\"/en-US/troubleshooting/terminal\"},{\"text\":\"Keyboard Shortcuts\",\"link\":\"/en-US/reference/keyboard-shortcuts\"},{\"text\":\"Statuses and Common Errors\",\"link\":\"/en-US/reference/status-and-errors\"},{\"text\":\"Configuration Reference\",\"link\":\"/en-US/reference/configuration\"},{\"text\":\"Ports, Paths, and Data\",\"link\":\"/en-US/reference/ports-paths-data\"},{\"text\":\"Versions, Capacity, and Limits\",\"link\":\"/en-US/reference/limits\"}]}],\"/\":[{\"text\":\"开始使用\",\"items\":[{\"text\":\"MyAgentRoam 是什么\",\"link\":\"/getting-started/overview\"},{\"text\":\"本机 npm 快速开始\",\"link\":\"/getting-started/npm-quick-start\"},{\"text\":\"部署前准备\",\"link\":\"/getting-started/prerequisites\"},{\"text\":\"部署 Server 与 Web\",\"link\":\"/getting-started/server-installation\"},{\"text\":\"首次登录与修改密码\",\"link\":\"/getting-started/first-login\"},{\"text\":\"接入第一台 Node\",\"link\":\"/getting-started/connect-node\"},{\"text\":\"登记第一个 Workspace\",\"link\":\"/getting-started/register-workspace\"},{\"text\":\"开始第一次 Agent 对话\",\"link\":\"/getting-started/first-agent-session\"},{\"text\":\"接下来可以做什么\",\"link\":\"/getting-started/next-steps\"}]},{\"text\":\"核心概念\",\"items\":[{\"text\":\"Server、Node、Web 与 Runner\",\"link\":\"/concepts/architecture\"},{\"text\":\"Node 与 Workspace\",\"link\":\"/concepts/node-and-workspace\"},{\"text\":\"会话、运行与消息队列\",\"link\":\"/concepts/session-run-turn\"},{\"text\":\"Runner 与会话控制状态\",\"link\":\"/concepts/runner-control\"},{\"text\":\"文件、Git 与终端\",\"link\":\"/concepts/files-git-terminal\"},{\"text\":\"用户、组织与资源权限\",\"link\":\"/concepts/permissions-and-sharing\"},{\"text\":\"环境变量密钥与注入顺序\",\"link\":\"/concepts/secrets\"},{\"text\":\"数据归属、凭据与安全边界\",\"link\":\"/concepts/data-and-security\"}]},{\"text\":\"工作 / 对话使用指南\",\"items\":[{\"text\":\"工作模式、Node 与 Workspace\",\"link\":\"/workbench/navigation\"},{\"text\":\"收藏与安装 Skill\",\"link\":\"/workbench/skills\"},{\"text\":\"创建、查找与管理会话\",\"link\":\"/workbench/sessions\"},{\"text\":\"发送消息与使用 Composer\",\"link\":\"/workbench/composer\"},{\"text\":\"上下文用量、Compact 与 Plan\",\"link\":\"/workbench/context-and-plan\"},{\"text\":\"@ 引用、文件夹与附件\",\"link\":\"/workbench/file-reference-and-attachment\"},{\"text\":\"阅读对话、工具调用与通知\",\"link\":\"/workbench/conversation\"},{\"text\":\"在对话模式从模板新建对话\",\"link\":\"/workbench/hosted-conversations\"},{\"text\":\"浏览、搜索与管理文件\",\"link\":\"/workbench/files\"},{\"text\":\"查看 Git Changes 与 Diff\",\"link\":\"/workbench/git-changes\"},{\"text\":\"查看 Git 历史\",\"link\":\"/workbench/git-history\"},{\"text\":\"使用 Workspace 终端\",\"link\":\"/workbench/terminal\"},{\"text\":\"在移动端继续工作\",\"link\":\"/workbench/mobile\"}]},{\"text\":\"Agent 指南\",\"items\":[{\"text\":\"选择 Agent\",\"link\":\"/runners/overview\"},{\"text\":\"安装、配置和使用 OpenCode\",\"link\":\"/runners/opencode\"},{\"text\":\"安装、配置和使用 Codex\",\"link\":\"/runners/codex\"},{\"text\":\"安装、配置和使用 Claude Code\",\"link\":\"/runners/claude-code\"},{\"text\":\"配置和使用内置 MAR Agent\",\"link\":\"/runners/mar-agent\"},{\"text\":\"Agent 不可用或模型缺失\",\"link\":\"/runners/runner-troubleshooting\"}]},{\"text\":\"部署与运维\",\"items\":[{\"text\":\"生产部署与反向代理\",\"link\":\"/deployment/production\"},{\"text\":\"安装与注册 Node\",\"link\":\"/deployment/node-installation\"},{\"text\":\"Linux Node 与 systemd\",\"link\":\"/deployment/node-linux\"},{\"text\":\"Windows Node 与任务计划\",\"link\":\"/deployment/node-windows\"},{\"text\":\"macOS Node 与 launchd\",\"link\":\"/deployment/node-macos\"},{\"text\":\"升级 MyAgentRoam\",\"link\":\"/deployment/upgrade\"},{\"text\":\"备份与恢复\",\"link\":\"/deployment/backup-restore\"},{\"text\":\"网络、TLS 与 WebSocket\",\"link\":\"/deployment/network\"},{\"text\":\"上线安全检查清单\",\"link\":\"/deployment/security-checklist\"}]},{\"text\":\"节点运维工具\",\"items\":[{\"text\":\"使用 marctl 管理节点\",\"link\":\"/operations/marctl\"}]},{\"text\":\"管理指南\",\"items\":[{\"text\":\"账户安全与登录会话\",\"link\":\"/administration/account\"},{\"text\":\"管理 Node 与 Workspace\",\"link\":\"/administration/nodes-workspaces\"},{\"text\":\"管理对话模板\",\"link\":\"/administration/conversation-templates\"},{\"text\":\"维护对话模板 Workspace\",\"link\":\"/administration/template-workspace-maintenance\"},{\"text\":\"管理环境变量密钥\",\"link\":\"/administration/secrets\"},{\"text\":\"配置 SMTP 邮件与通知模板\",\"link\":\"/administration/email-notifications\"},{\"text\":\"管理用户、组织与角色\",\"link\":\"/administration/users-organizations\"},{\"text\":\"配置 OAuth 2.0 SSO\",\"link\":\"/administration/oauth\"},{\"text\":\"查询与导出操作审计\",\"link\":\"/administration/audit\"},{\"text\":\"社区版、企业 License 与冻结态\",\"link\":\"/administration/license\"}]},{\"text\":\"故障排查与参考\",\"items\":[{\"text\":\"从现象开始排查\",\"link\":\"/troubleshooting/quick-diagnosis\"},{\"text\":\"Node 注册失败或离线\",\"link\":\"/troubleshooting/node-offline\"},{\"text\":\"Workspace、文件或 Git 不可用\",\"link\":\"/troubleshooting/workspace-files\"},{\"text\":\"会话卡在 Working、Idle 或只读\",\"link\":\"/troubleshooting/session-run\"},{\"text\":\"终端无法打开或频繁断线\",\"link\":\"/troubleshooting/terminal\"},{\"text\":\"键盘快捷键\",\"link\":\"/reference/keyboard-shortcuts\"},{\"text\":\"状态、提示与常见错误\",\"link\":\"/reference/status-and-errors\"},{\"text\":\"配置项参考\",\"link\":\"/reference/configuration\"},{\"text\":\"端口、配置目录与数据位置\",\"link\":\"/reference/ports-paths-data\"},{\"text\":\"版本、容量与已知限制\",\"link\":\"/reference/limits\"}]}]}},\"locales\":{\"root\":{\"label\":\"简体中文\",\"lang\":\"zh-CN\"},\"en-US\":{\"label\":\"English\",\"lang\":\"en-US\",\"title\":\"MyAgentRoam Documentation\",\"description\":\"Deployment, configuration, and usage documentation for MyAgentRoam\",\"themeConfig\":{\"siteTitle\":\"Documentation\",\"langMenuLabel\":\"Switch language\",\"outline\":{\"label\":\"On This Page\",\"level\":[2,3]},\"returnToTopLabel\":\"Return to Top\",\"sidebarMenuLabel\":\"Menu\",\"darkModeSwitchLabel\":\"Appearance\",\"lightModeSwitchTitle\":\"Switch to Light Theme\",\"darkModeSwitchTitle\":\"Switch to Dark Theme\",\"docFooter\":{\"prev\":\"Previous\",\"next\":\"Next\"},\"search\":{\"provider\":\"local\",\"options\":{\"translations\":{\"button\":{\"buttonText\":\"Search Documentation\",\"buttonAriaLabel\":\"Search Documentation\"}}}}}}},\"scrollOffset\":134,\"cleanUrls\":true}");</script>
   </body>
 </html>

package/web/docs/deployment/node-linux.html CHANGED Viewed

@@ -9,9 +9,9 @@
     <link rel="preload stylesheet" href="/docs/assets/style.B3QdEOQQ.css" as="style">
     <link rel="preload stylesheet" href="/docs/vp-icons.css" as="style">
-    <script type="module" src="/docs/assets/app.DQ73g8Ca.js"></script>
+    <script type="module" src="/docs/assets/app.DFdypnML.js"></script>
     <link rel="preload" href="/docs/assets/inter-roman-latin.Di8DUHzh.woff2" as="font" type="font/woff2" crossorigin="">
-    <link rel="modulepreload" href="/docs/assets/chunks/theme.CES2lSYr.js">
+    <link rel="modulepreload" href="/docs/assets/chunks/theme.DLnKtfGY.js">
     <link rel="modulepreload" href="/docs/assets/chunks/framework.BHjrhdiC.js">
     <link rel="modulepreload" href="/docs/assets/deployment_node-linux.md.ayZjBc-g.lean.js">
     <script id="check-dark-mode">(()=>{const e=localStorage.getItem("vitepress-theme-appearance")||"auto",a=window.matchMedia("(prefers-color-scheme: dark)").matches;(!e||e==="auto"?a:e==="dark")&&document.documentElement.classList.add("dark")})();</script>
@@ -43,7 +43,7 @@ npm view &quot;@myagentroam/node@${server_version}&quot; version</code></pre></d
 <span class="line"><span style="--shiki-light:#6F42C1;--shiki-dark:#B392F0;">sudo</span><span style="--shiki-light:#005CC5;--shiki-dark:#79B8FF;"> -u</span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;"> ubuntu</span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;"> env</span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;"> HOME=/home/ubuntu</span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;"> PATH=&quot;${</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">node_bin_dir</span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;">}:/home/ubuntu/.local/bin:/usr/local/bin:/usr/bin:/bin&quot;</span><span style="--shiki-light:#005CC5;--shiki-dark:#79B8FF;"> \</span></span>
 <span class="line"><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;">  node</span><span style="--shiki-light:#005CC5;--shiki-dark:#79B8FF;"> --version</span></span></code></pre></div><p>验收结果必须同时满足：</p><ul><li><code>ExecStart</code> 包含 <code>supervise --config</code>，不能仍是 <code>run --config</code>；</li><li><code>User</code> 是拥有 Node 配置、Agent 登录状态和 Workspace 权限的账号；</li><li><code>ReadWritePaths</code> 包含 Node <code>dataDirectory</code> 和需要写入的 Workspace/Agent 配置目录；</li><li>服务账号能在 unit 的 <code>HOME</code>、<code>PATH</code> 下执行 <code>node</code>、<code>npm</code> 并使用该账号的 npm 配置查询精确版本；</li><li>服务账号能在同一环境解析并执行所使用的 <code>mar-node</code>、<code>opencode</code>、<code>codex</code>、<code>claude</code>；不使用的 Agent 可忽略；</li><li>需要 npm 类型 MCP 时能解析 <code>npx</code>，需要 Git Workspace/技能源时能解析 <code>git</code>，需要 Python 工具时能解析 <code>python3</code>/<code>python</code> 与 <code>pip3</code>/<code>pip</code>；</li><li><code>sudo systemctl restart myagentroam-node.service</code> 后节点自动重连，节点详情不显示“需手工启用 Supervisor”。</li></ul><p>例如，按服务账号环境检查 CLI：</p><div class="language-bash vp-adaptive-theme"><button title="Copy Code" class="copy"></button><span class="lang">bash</span><pre class="shiki shiki-themes github-light github-dark vp-code" tabindex="0"><code><span class="line"><span style="--shiki-light:#6F42C1;--shiki-dark:#B392F0;">sudo</span><span style="--shiki-light:#005CC5;--shiki-dark:#79B8FF;"> -u</span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;"> ubuntu</span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;"> env</span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;"> HOME=/home/ubuntu</span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;"> PATH=&quot;${</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">node_bin_dir</span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;">}:/home/ubuntu/.local/bin:/usr/local/bin:/usr/bin:/bin&quot;</span><span style="--shiki-light:#005CC5;--shiki-dark:#79B8FF;"> \</span></span>
 <span class="line"><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;">  sh</span><span style="--shiki-light:#005CC5;--shiki-dark:#79B8FF;"> -c</span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;"> &#39;command -v node npm mar-node; command -v npx git python3 python pip3 pip; opencode --version; codex --version; claude --version&#39;</span></span></code></pre></div><p>上面的按需命令允许按实际用途缺失；命令返回非零时应逐项运行，不要把未安装的可选 Agent 与工具误判为 Node 故障。如果工具在交互 Shell 可执行、节点详情仍显示“未发现”，先执行 <code>sudo systemctl restart myagentroam-node.service</code>，再检查 <code>systemctl cat</code> 中是否保留独立的 <code>Environment=HOME=...</code>、<code>Environment=PATH=...</code> 和 <code>SetLoginEnvironment=false</code>。不要只依据 <code>systemctl show</code> 的配置值判断，必须以节点详情上报的 Agent 与工具环境为准。</p><p>随后可先更新 Server，再按<a href="./upgrade">升级 MyAgentRoam</a>从管理页向旧版 Node 推送已发布且符合业务基线、不超过 Server 版本的最高稳定版本。安装目录位于 <code>dataDirectory/node-versions/&lt;版本&gt;/</code>；不要把该目录加入 <code>ReadOnlyPaths</code>，也不要由其他账号预创建。管理端推送不会执行 sudo，不会修改 systemd unit，也不会自动升级到高于 Server 的版本。</p><p><strong>成功标志：</strong> <code>systemctl status</code> 为 running，节点页在线，重启服务后自动重连，详情显示已启用 Supervisor 升级能力。</p><p>失败时不要改用 root 来绕过 Agent 问题。检查 unit 中的 <code>User</code>、<code>HOME</code>、<code>PATH</code>、配置权限、工作区权限以及该账号的 Agent 登录状态。</p></div></div></main><footer class="VPDocFooter" data-v-cd08f8de data-v-579b47ad><!--[--><!--]--><!----><nav class="prev-next" aria-labelledby="doc-footer-aria-label" data-v-579b47ad><span class="visually-hidden" id="doc-footer-aria-label" data-v-579b47ad>Pager</span><div class="pager" data-v-579b47ad><a class="VPLink link pager-link prev" href="/docs/deployment/node-installation" data-v-579b47ad><!--[--><span class="desc" data-v-579b47ad>上一篇</span><span class="title" data-v-579b47ad>安装与注册 Node</span><!--]--></a></div><div class="pager" data-v-579b47ad><a class="VPLink link pager-link next" href="/docs/deployment/node-windows" data-v-579b47ad><!--[--><span class="desc" data-v-579b47ad>下一篇</span><span class="title" data-v-579b47ad>Windows Node 与任务计划</span><!--]--></a></div></nav></footer><!--[--><!--]--></div></div></div><!--[--><!--]--></div></div><!----><!--[--><!--]--></div></div>
-    <script>window.__VP_HASH_MAP__=JSON.parse("{\"administration_account.md\":\"BDxiZLcI\",\"administration_audit.md\":\"CPGsRZCt\",\"administration_conversation-templates.md\":\"DR-Q8ZJH\",\"administration_email-notifications.md\":\"CcYZiN4h\",\"administration_license.md\":\"CdgtKnVd\",\"administration_nodes-workspaces.md\":\"CMGc1EC3\",\"administration_oauth.md\":\"DVrr-ce3\",\"administration_secrets.md\":\"BVsK96Ny\",\"administration_template-workspace-maintenance.md\":\"ic3SEbkM\",\"administration_users-organizations.md\":\"CInTvyvp\",\"concepts_architecture.md\":\"CWYNi_YX\",\"concepts_data-and-security.md\":\"DvabQ2zO\",\"concepts_files-git-terminal.md\":\"DR-aSOLY\",\"concepts_node-and-workspace.md\":\"D4tWJ_5A\",\"concepts_permissions-and-sharing.md\":\"BGQlim_y\",\"concepts_runner-control.md\":\"Bkd1fXLk\",\"concepts_secrets.md\":\"DRt04t7A\",\"concepts_session-run-turn.md\":\"Crte1ZI0\",\"deployment_backup-restore.md\":\"fZtPK3bl\",\"deployment_network.md\":\"BarghfLt\",\"deployment_node-installation.md\":\"BhsVg-7E\",\"deployment_node-linux.md\":\"ayZjBc-g\",\"deployment_node-macos.md\":\"DRV9KDoO\",\"deployment_node-windows.md\":\"gpTo69VQ\",\"deployment_production.md\":\"83mdKwsb\",\"deployment_security-checklist.md\":\"CxWdJ9xO\",\"deployment_upgrade.md\":\"BESOToM5\",\"en-us_administration_account.md\":\"q4dfxq-Y\",\"en-us_administration_audit.md\":\"7tn6Eg6i\",\"en-us_administration_conversation-templates.md\":\"D7eekprK\",\"en-us_administration_email-notifications.md\":\"DvyUIBNy\",\"en-us_administration_license.md\":\"jmAMVJjC\",\"en-us_administration_nodes-workspaces.md\":\"BOA5ixAC\",\"en-us_administration_oauth.md\":\"DwEfTIEs\",\"en-us_administration_secrets.md\":\"DOlPJy7O\",\"en-us_administration_template-workspace-maintenance.md\":\"B1Dys0Xw\",\"en-us_administration_users-organizations.md\":\"CkX2sOqa\",\"en-us_concepts_architecture.md\":\"DUoUKxu0\",\"en-us_concepts_data-and-security.md\":\"DpXrCSPO\",\"en-us_concepts_files-git-terminal.md\":\"BK81hAoC\",\"en-us_concepts_node-and-workspace.md\":\"Bm7rEIAI\",\"en-us_concepts_permissions-and-sharing.md\":\"DiEopkbD\",\"en-us_concepts_runner-control.md\":\"CcrdYOTx\",\"en-us_concepts_secrets.md\":\"CPhBggXB\",\"en-us_concepts_session-run-turn.md\":\"CIfewRkn\",\"en-us_deployment_backup-restore.md\":\"DQUtQ5Yt\",\"en-us_deployment_network.md\":\"DdOgOLns\",\"en-us_deployment_node-installation.md\":\"DDQ4RdWI\",\"en-us_deployment_node-linux.md\":\"BXhYZ6de\",\"en-us_deployment_node-macos.md\":\"D26h7wJ1\",\"en-us_deployment_node-windows.md\":\"Bp-sytL8\",\"en-us_deployment_production.md\":\"Drc4IHoD\",\"en-us_deployment_security-checklist.md\":\"Dh3cWem6\",\"en-us_deployment_upgrade.md\":\"DZiDDiLn\",\"en-us_getting-started_connect-node.md\":\"DKLHaKuL\",\"en-us_getting-started_first-agent-session.md\":\"CN2rWPq7\",\"en-us_getting-started_first-login.md\":\"DQnGKeN2\",\"en-us_getting-started_next-steps.md\":\"D2UXmW2q\",\"en-us_getting-started_npm-quick-start.md\":\"CLCHq7k_\",\"en-us_getting-started_overview.md\":\"Bug5sh21\",\"en-us_getting-started_prerequisites.md\":\"Bpx_AQD1\",\"en-us_getting-started_register-workspace.md\":\"D3j75IC2\",\"en-us_getting-started_server-installation.md\":\"_k2XGM85\",\"en-us_operations_marctl.md\":\"CJYpPahB\",\"en-us_reference_configuration.md\":\"Ca2_G45i\",\"en-us_reference_keyboard-shortcuts.md\":\"BHIlAzih\",\"en-us_reference_limits.md\":\"BQahQvRI\",\"en-us_reference_ports-paths-data.md\":\"DckuEN9-\",\"en-us_reference_status-and-errors.md\":\"cq1A6JOM\",\"en-us_runners_claude-code.md\":\"BZp77nTJ\",\"en-us_runners_codex.md\":\"C8aQ3lj4\",\"en-us_runners_mar-agent.md\":\"DjryPiTL\",\"en-us_runners_opencode.md\":\"DAnPpdjG\",\"en-us_runners_overview.md\":\"n8off-KX\",\"en-us_runners_runner-troubleshooting.md\":\"BvJ6yGrw\",\"en-us_troubleshooting_node-offline.md\":\"BS2cHLeq\",\"en-us_troubleshooting_quick-diagnosis.md\":\"CPWX9djq\",\"en-us_troubleshooting_session-run.md\":\"o9ty9dWk\",\"en-us_troubleshooting_terminal.md\":\"Ce3H_Cq3\",\"en-us_troubleshooting_workspace-files.md\":\"I66m4D0K\",\"en-us_workbench_composer.md\":\"CCnbitB3\",\"en-us_workbench_context-and-plan.md\":\"E9yFtLaR\",\"en-us_workbench_conversation.md\":\"DWFI4rSa\",\"en-us_workbench_file-reference-and-attachment.md\":\"Xzbr8MRS\",\"en-us_workbench_files.md\":\"C5byBZOZ\",\"en-us_workbench_git-changes.md\":\"CgzmFd8l\",\"en-us_workbench_git-history.md\":\"CcKXv4NB\",\"en-us_workbench_hosted-conversations.md\":\"hxgo3oRa\",\"en-us_workbench_mobile.md\":\"C3A2Sq-s\",\"en-us_workbench_navigation.md\":\"BXLJsQMY\",\"en-us_workbench_sessions.md\":\"tSnti1TK\",\"en-us_workbench_skills.md\":\"C4xlXyjC\",\"en-us_workbench_terminal.md\":\"B23OFnB3\",\"getting-started_connect-node.md\":\"B9kKn-7y\",\"getting-started_first-agent-session.md\":\"D-uls92b\",\"getting-started_first-login.md\":\"DVWDKgMU\",\"getting-started_next-steps.md\":\"CjwJgSAt\",\"getting-started_npm-quick-start.md\":\"B9varoSe\",\"getting-started_overview.md\":\"CA1CCOBc\",\"getting-started_prerequisites.md\":\"D26KU42D\",\"getting-started_register-workspace.md\":\"BW-xjHjl\",\"getting-started_server-installation.md\":\"D3P3Lmc2\",\"operations_marctl.md\":\"BW9barpn\",\"reference_configuration.md\":\"CvHKh-kv\",\"reference_keyboard-shortcuts.md\":\"DOivSxmM\",\"reference_limits.md\":\"17DNV05j\",\"reference_ports-paths-data.md\":\"RqYAhrgF\",\"reference_status-and-errors.md\":\"BwpSR6nH\",\"runners_claude-code.md\":\"DSGRX72-\",\"runners_codex.md\":\"CDGNsFMp\",\"runners_mar-agent.md\":\"DjuqySh9\",\"runners_opencode.md\":\"DSvXW8Sv\",\"runners_overview.md\":\"CHK7UvIl\",\"runners_runner-troubleshooting.md\":\"CIWCfGkf\",\"troubleshooting_node-offline.md\":\"BQ-5_Xyu\",\"troubleshooting_quick-diagnosis.md\":\"fq0U5Cg7\",\"troubleshooting_session-run.md\":\"Cny0YwSq\",\"troubleshooting_terminal.md\":\"DB0zc8sK\",\"troubleshooting_workspace-files.md\":\"BEFLZu54\",\"workbench_composer.md\":\"DlU35VaN\",\"workbench_context-and-plan.md\":\"CzRACFjQ\",\"workbench_conversation.md\":\"Ib2W7CCX\",\"workbench_file-reference-and-attachment.md\":\"CSLMm-nL\",\"workbench_files.md\":\"B5xE7YGc\",\"workbench_git-changes.md\":\"C7xvpMwy\",\"workbench_git-history.md\":\"Ckvhp8Y3\",\"workbench_hosted-conversations.md\":\"C0YVmf0T\",\"workbench_mobile.md\":\"3NSNZGu8\",\"workbench_navigation.md\":\"B8UD4qpB\",\"workbench_sessions.md\":\"DHPI_apA\",\"workbench_skills.md\":\"rWZ_VuoB\",\"workbench_terminal.md\":\"YzgZvVcu\"}");window.__VP_SITE_DATA__=JSON.parse("{\"lang\":\"zh-CN\",\"dir\":\"ltr\",\"title\":\"MyAgentRoam Documentation\",\"description\":\"MyAgentRoam 部署、配置与使用文档\",\"base\":\"/docs/\",\"head\":[],\"router\":{\"prefetchLinks\":true},\"appearance\":true,\"themeConfig\":{\"logo\":\"/logo.png?v=logo-20261011\",\"logoLink\":\"/\",\"siteTitle\":\"Documentation\",\"langMenuLabel\":\"切换语言\",\"outline\":{\"label\":\"本页内容\",\"level\":[2,3]},\"returnToTopLabel\":\"返回顶部\",\"sidebarMenuLabel\":\"文档目录\",\"darkModeSwitchLabel\":\"外观\",\"lightModeSwitchTitle\":\"切换至浅色模式\",\"darkModeSwitchTitle\":\"切换至深色模式\",\"docFooter\":{\"prev\":\"上一篇\",\"next\":\"下一篇\"},\"search\":{\"provider\":\"local\",\"options\":{\"translations\":{\"button\":{\"buttonText\":\"搜索文档\",\"buttonAriaLabel\":\"搜索文档\"}}}},\"sidebar\":{\"/en-US/\":[{\"text\":\"Getting Started\",\"items\":[{\"text\":\"What Is MyAgentRoam?\",\"link\":\"/en-US/getting-started/overview\"},{\"text\":\"Local npm Quick Start\",\"link\":\"/en-US/getting-started/npm-quick-start\"},{\"text\":\"Before You Deploy\",\"link\":\"/en-US/getting-started/prerequisites\"},{\"text\":\"Deploy Server and Web\",\"link\":\"/en-US/getting-started/server-installation\"},{\"text\":\"First Sign-in and Password Change\",\"link\":\"/en-US/getting-started/first-login\"},{\"text\":\"Connect Your First Node\",\"link\":\"/en-US/getting-started/connect-node\"},{\"text\":\"Register Your First Workspace\",\"link\":\"/en-US/getting-started/register-workspace\"},{\"text\":\"Start Your First Agent Session\",\"link\":\"/en-US/getting-started/first-agent-session\"},{\"text\":\"Next Steps\",\"link\":\"/en-US/getting-started/next-steps\"}]},{\"text\":\"Core Concepts\",\"items\":[{\"text\":\"Server, Node, Web, and Runner\",\"link\":\"/en-US/concepts/architecture\"},{\"text\":\"Nodes and Workspaces\",\"link\":\"/en-US/concepts/node-and-workspace\"},{\"text\":\"Sessions, Runs, and Message Queues\",\"link\":\"/en-US/concepts/session-run-turn\"},{\"text\":\"Runners and Session Control\",\"link\":\"/en-US/concepts/runner-control\"},{\"text\":\"Files, Git, and Terminals\",\"link\":\"/en-US/concepts/files-git-terminal\"},{\"text\":\"Users, Organizations, and Access\",\"link\":\"/en-US/concepts/permissions-and-sharing\"},{\"text\":\"Secrets and Injection Order\",\"link\":\"/en-US/concepts/secrets\"},{\"text\":\"Data, Credentials, and Security\",\"link\":\"/en-US/concepts/data-and-security\"}]},{\"text\":\"Work / Conversation Guide\",\"items\":[{\"text\":\"Work Mode, Nodes, and Workspaces\",\"link\":\"/en-US/workbench/navigation\"},{\"text\":\"Favorite and Install Skills\",\"link\":\"/en-US/workbench/skills\"},{\"text\":\"Create and Manage Sessions\",\"link\":\"/en-US/workbench/sessions\"},{\"text\":\"Messages and Composer\",\"link\":\"/en-US/workbench/composer\"},{\"text\":\"Context, Compact, and Plan\",\"link\":\"/en-US/workbench/context-and-plan\"},{\"text\":\"References, Folders, and Attachments\",\"link\":\"/en-US/workbench/file-reference-and-attachment\"},{\"text\":\"Conversations, Tools, and Notifications\",\"link\":\"/en-US/workbench/conversation\"},{\"text\":\"Start a Template Conversation in Conversation Mode\",\"link\":\"/en-US/workbench/hosted-conversations\"},{\"text\":\"Browse, Search, and Manage Files\",\"link\":\"/en-US/workbench/files\"},{\"text\":\"Git Changes and Diff\",\"link\":\"/en-US/workbench/git-changes\"},{\"text\":\"Git History\",\"link\":\"/en-US/workbench/git-history\"},{\"text\":\"Workspace Terminals\",\"link\":\"/en-US/workbench/terminal\"},{\"text\":\"Continue on Mobile\",\"link\":\"/en-US/workbench/mobile\"}]},{\"text\":\"Agent Guide\",\"items\":[{\"text\":\"Choose an Agent\",\"link\":\"/en-US/runners/overview\"},{\"text\":\"OpenCode\",\"link\":\"/en-US/runners/opencode\"},{\"text\":\"Codex\",\"link\":\"/en-US/runners/codex\"},{\"text\":\"Claude Code\",\"link\":\"/en-US/runners/claude-code\"},{\"text\":\"Built-in MAR Agent\",\"link\":\"/en-US/runners/mar-agent\"},{\"text\":\"Runner Troubleshooting\",\"link\":\"/en-US/runners/runner-troubleshooting\"}]},{\"text\":\"Deployment and Operations\",\"items\":[{\"text\":\"Production Deployment and Reverse Proxy\",\"link\":\"/en-US/deployment/production\"},{\"text\":\"Install and Register a Node\",\"link\":\"/en-US/deployment/node-installation\"},{\"text\":\"Linux Node and systemd\",\"link\":\"/en-US/deployment/node-linux\"},{\"text\":\"Windows Node and Task Scheduler\",\"link\":\"/en-US/deployment/node-windows\"},{\"text\":\"macOS Node and launchd\",\"link\":\"/en-US/deployment/node-macos\"},{\"text\":\"Upgrade MyAgentRoam\",\"link\":\"/en-US/deployment/upgrade\"},{\"text\":\"Backup and Restore\",\"link\":\"/en-US/deployment/backup-restore\"},{\"text\":\"Network, TLS, and WebSocket\",\"link\":\"/en-US/deployment/network\"},{\"text\":\"Production Security Checklist\",\"link\":\"/en-US/deployment/security-checklist\"}]},{\"text\":\"Node Operations Tools\",\"items\":[{\"text\":\"Manage Nodes with marctl\",\"link\":\"/en-US/operations/marctl\"}]},{\"text\":\"Administration Guide\",\"items\":[{\"text\":\"Account Security and Sign-in Sessions\",\"link\":\"/en-US/administration/account\"},{\"text\":\"Manage Nodes and Workspaces\",\"link\":\"/en-US/administration/nodes-workspaces\"},{\"text\":\"Manage Conversation Templates\",\"link\":\"/en-US/administration/conversation-templates\"},{\"text\":\"Maintain a Conversation Template Workspace\",\"link\":\"/en-US/administration/template-workspace-maintenance\"},{\"text\":\"Manage Secrets\",\"link\":\"/en-US/administration/secrets\"},{\"text\":\"Configure SMTP Email and Notification Templates\",\"link\":\"/en-US/administration/email-notifications\"},{\"text\":\"Manage Users, Organizations, and Roles\",\"link\":\"/en-US/administration/users-organizations\"},{\"text\":\"Configure OAuth 2.0 SSO\",\"link\":\"/en-US/administration/oauth\"},{\"text\":\"Audit Events and Export\",\"link\":\"/en-US/administration/audit\"},{\"text\":\"Personal and Enterprise Licenses\",\"link\":\"/en-US/administration/license\"}]},{\"text\":\"Troubleshooting and Reference\",\"items\":[{\"text\":\"Quick Diagnosis\",\"link\":\"/en-US/troubleshooting/quick-diagnosis\"},{\"text\":\"Node Registration or Offline Issues\",\"link\":\"/en-US/troubleshooting/node-offline\"},{\"text\":\"Workspace, File, or Git Issues\",\"link\":\"/en-US/troubleshooting/workspace-files\"},{\"text\":\"Session Stuck or Read-only\",\"link\":\"/en-US/troubleshooting/session-run\"},{\"text\":\"Terminal Connection Issues\",\"link\":\"/en-US/troubleshooting/terminal\"},{\"text\":\"Keyboard Shortcuts\",\"link\":\"/en-US/reference/keyboard-shortcuts\"},{\"text\":\"Statuses and Common Errors\",\"link\":\"/en-US/reference/status-and-errors\"},{\"text\":\"Configuration Reference\",\"link\":\"/en-US/reference/configuration\"},{\"text\":\"Ports, Paths, and Data\",\"link\":\"/en-US/reference/ports-paths-data\"},{\"text\":\"Versions, Capacity, and Limits\",\"link\":\"/en-US/reference/limits\"}]}],\"/\":[{\"text\":\"开始使用\",\"items\":[{\"text\":\"MyAgentRoam 是什么\",\"link\":\"/getting-started/overview\"},{\"text\":\"本机 npm 快速开始\",\"link\":\"/getting-started/npm-quick-start\"},{\"text\":\"部署前准备\",\"link\":\"/getting-started/prerequisites\"},{\"text\":\"部署 Server 与 Web\",\"link\":\"/getting-started/server-installation\"},{\"text\":\"首次登录与修改密码\",\"link\":\"/getting-started/first-login\"},{\"text\":\"接入第一台 Node\",\"link\":\"/getting-started/connect-node\"},{\"text\":\"登记第一个 Workspace\",\"link\":\"/getting-started/register-workspace\"},{\"text\":\"开始第一次 Agent 对话\",\"link\":\"/getting-started/first-agent-session\"},{\"text\":\"接下来可以做什么\",\"link\":\"/getting-started/next-steps\"}]},{\"text\":\"核心概念\",\"items\":[{\"text\":\"Server、Node、Web 与 Runner\",\"link\":\"/concepts/architecture\"},{\"text\":\"Node 与 Workspace\",\"link\":\"/concepts/node-and-workspace\"},{\"text\":\"会话、运行与消息队列\",\"link\":\"/concepts/session-run-turn\"},{\"text\":\"Runner 与会话控制状态\",\"link\":\"/concepts/runner-control\"},{\"text\":\"文件、Git 与终端\",\"link\":\"/concepts/files-git-terminal\"},{\"text\":\"用户、组织与资源权限\",\"link\":\"/concepts/permissions-and-sharing\"},{\"text\":\"环境变量密钥与注入顺序\",\"link\":\"/concepts/secrets\"},{\"text\":\"数据归属、凭据与安全边界\",\"link\":\"/concepts/data-and-security\"}]},{\"text\":\"工作 / 对话使用指南\",\"items\":[{\"text\":\"工作模式、Node 与 Workspace\",\"link\":\"/workbench/navigation\"},{\"text\":\"收藏与安装 Skill\",\"link\":\"/workbench/skills\"},{\"text\":\"创建、查找与管理会话\",\"link\":\"/workbench/sessions\"},{\"text\":\"发送消息与使用 Composer\",\"link\":\"/workbench/composer\"},{\"text\":\"上下文用量、Compact 与 Plan\",\"link\":\"/workbench/context-and-plan\"},{\"text\":\"@ 引用、文件夹与附件\",\"link\":\"/workbench/file-reference-and-attachment\"},{\"text\":\"阅读对话、工具调用与通知\",\"link\":\"/workbench/conversation\"},{\"text\":\"在对话模式从模板新建对话\",\"link\":\"/workbench/hosted-conversations\"},{\"text\":\"浏览、搜索与管理文件\",\"link\":\"/workbench/files\"},{\"text\":\"查看 Git Changes 与 Diff\",\"link\":\"/workbench/git-changes\"},{\"text\":\"查看 Git 历史\",\"link\":\"/workbench/git-history\"},{\"text\":\"使用 Workspace 终端\",\"link\":\"/workbench/terminal\"},{\"text\":\"在移动端继续工作\",\"link\":\"/workbench/mobile\"}]},{\"text\":\"Agent 指南\",\"items\":[{\"text\":\"选择 Agent\",\"link\":\"/runners/overview\"},{\"text\":\"安装、配置和使用 OpenCode\",\"link\":\"/runners/opencode\"},{\"text\":\"安装、配置和使用 Codex\",\"link\":\"/runners/codex\"},{\"text\":\"安装、配置和使用 Claude Code\",\"link\":\"/runners/claude-code\"},{\"text\":\"配置和使用内置 MAR Agent\",\"link\":\"/runners/mar-agent\"},{\"text\":\"Agent 不可用或模型缺失\",\"link\":\"/runners/runner-troubleshooting\"}]},{\"text\":\"部署与运维\",\"items\":[{\"text\":\"生产部署与反向代理\",\"link\":\"/deployment/production\"},{\"text\":\"安装与注册 Node\",\"link\":\"/deployment/node-installation\"},{\"text\":\"Linux Node 与 systemd\",\"link\":\"/deployment/node-linux\"},{\"text\":\"Windows Node 与任务计划\",\"link\":\"/deployment/node-windows\"},{\"text\":\"macOS Node 与 launchd\",\"link\":\"/deployment/node-macos\"},{\"text\":\"升级 MyAgentRoam\",\"link\":\"/deployment/upgrade\"},{\"text\":\"备份与恢复\",\"link\":\"/deployment/backup-restore\"},{\"text\":\"网络、TLS 与 WebSocket\",\"link\":\"/deployment/network\"},{\"text\":\"上线安全检查清单\",\"link\":\"/deployment/security-checklist\"}]},{\"text\":\"节点运维工具\",\"items\":[{\"text\":\"使用 marctl 管理节点\",\"link\":\"/operations/marctl\"}]},{\"text\":\"管理指南\",\"items\":[{\"text\":\"账户安全与登录会话\",\"link\":\"/administration/account\"},{\"text\":\"管理 Node 与 Workspace\",\"link\":\"/administration/nodes-workspaces\"},{\"text\":\"管理对话模板\",\"link\":\"/administration/conversation-templates\"},{\"text\":\"维护对话模板 Workspace\",\"link\":\"/administration/template-workspace-maintenance\"},{\"text\":\"管理环境变量密钥\",\"link\":\"/administration/secrets\"},{\"text\":\"配置 SMTP 邮件与通知模板\",\"link\":\"/administration/email-notifications\"},{\"text\":\"管理用户、组织与角色\",\"link\":\"/administration/users-organizations\"},{\"text\":\"配置 OAuth 2.0 SSO\",\"link\":\"/administration/oauth\"},{\"text\":\"查询与导出操作审计\",\"link\":\"/administration/audit\"},{\"text\":\"社区版、企业 License 与冻结态\",\"link\":\"/administration/license\"}]},{\"text\":\"故障排查与参考\",\"items\":[{\"text\":\"从现象开始排查\",\"link\":\"/troubleshooting/quick-diagnosis\"},{\"text\":\"Node 注册失败或离线\",\"link\":\"/troubleshooting/node-offline\"},{\"text\":\"Workspace、文件或 Git 不可用\",\"link\":\"/troubleshooting/workspace-files\"},{\"text\":\"会话卡在 Working、Idle 或只读\",\"link\":\"/troubleshooting/session-run\"},{\"text\":\"终端无法打开或频繁断线\",\"link\":\"/troubleshooting/terminal\"},{\"text\":\"键盘快捷键\",\"link\":\"/reference/keyboard-shortcuts\"},{\"text\":\"状态、提示与常见错误\",\"link\":\"/reference/status-and-errors\"},{\"text\":\"配置项参考\",\"link\":\"/reference/configuration\"},{\"text\":\"端口、配置目录与数据位置\",\"link\":\"/reference/ports-paths-data\"},{\"text\":\"版本、容量与已知限制\",\"link\":\"/reference/limits\"}]}]}},\"locales\":{\"root\":{\"label\":\"简体中文\",\"lang\":\"zh-CN\"},\"en-US\":{\"label\":\"English\",\"lang\":\"en-US\",\"title\":\"MyAgentRoam Documentation\",\"description\":\"Deployment, configuration, and usage documentation for MyAgentRoam\",\"themeConfig\":{\"siteTitle\":\"Documentation\",\"langMenuLabel\":\"Switch language\",\"outline\":{\"label\":\"On This Page\",\"level\":[2,3]},\"returnToTopLabel\":\"Return to Top\",\"sidebarMenuLabel\":\"Menu\",\"darkModeSwitchLabel\":\"Appearance\",\"lightModeSwitchTitle\":\"Switch to Light Theme\",\"darkModeSwitchTitle\":\"Switch to Dark Theme\",\"docFooter\":{\"prev\":\"Previous\",\"next\":\"Next\"},\"search\":{\"provider\":\"local\",\"options\":{\"translations\":{\"button\":{\"buttonText\":\"Search Documentation\",\"buttonAriaLabel\":\"Search Documentation\"}}}}}}},\"scrollOffset\":134,\"cleanUrls\":true}");</script>
+    <script>window.__VP_HASH_MAP__=JSON.parse("{\"administration_account.md\":\"BDxiZLcI\",\"administration_audit.md\":\"CPGsRZCt\",\"administration_conversation-templates.md\":\"DR-Q8ZJH\",\"administration_email-notifications.md\":\"CcYZiN4h\",\"administration_license.md\":\"Bf1iyuKG\",\"administration_nodes-workspaces.md\":\"CMGc1EC3\",\"administration_oauth.md\":\"DVrr-ce3\",\"administration_secrets.md\":\"BVsK96Ny\",\"administration_template-workspace-maintenance.md\":\"ic3SEbkM\",\"administration_users-organizations.md\":\"CInTvyvp\",\"concepts_architecture.md\":\"CWYNi_YX\",\"concepts_data-and-security.md\":\"DvabQ2zO\",\"concepts_files-git-terminal.md\":\"DR-aSOLY\",\"concepts_node-and-workspace.md\":\"D4tWJ_5A\",\"concepts_permissions-and-sharing.md\":\"BGQlim_y\",\"concepts_runner-control.md\":\"Bkd1fXLk\",\"concepts_secrets.md\":\"DRt04t7A\",\"concepts_session-run-turn.md\":\"Crte1ZI0\",\"deployment_backup-restore.md\":\"fZtPK3bl\",\"deployment_network.md\":\"BarghfLt\",\"deployment_node-installation.md\":\"BhsVg-7E\",\"deployment_node-linux.md\":\"ayZjBc-g\",\"deployment_node-macos.md\":\"DRV9KDoO\",\"deployment_node-windows.md\":\"gpTo69VQ\",\"deployment_production.md\":\"83mdKwsb\",\"deployment_security-checklist.md\":\"CxWdJ9xO\",\"deployment_upgrade.md\":\"BESOToM5\",\"en-us_administration_account.md\":\"q4dfxq-Y\",\"en-us_administration_audit.md\":\"7tn6Eg6i\",\"en-us_administration_conversation-templates.md\":\"D7eekprK\",\"en-us_administration_email-notifications.md\":\"DvyUIBNy\",\"en-us_administration_license.md\":\"Dmg8rNEl\",\"en-us_administration_nodes-workspaces.md\":\"BOA5ixAC\",\"en-us_administration_oauth.md\":\"DwEfTIEs\",\"en-us_administration_secrets.md\":\"DOlPJy7O\",\"en-us_administration_template-workspace-maintenance.md\":\"B1Dys0Xw\",\"en-us_administration_users-organizations.md\":\"CkX2sOqa\",\"en-us_concepts_architecture.md\":\"DUoUKxu0\",\"en-us_concepts_data-and-security.md\":\"DpXrCSPO\",\"en-us_concepts_files-git-terminal.md\":\"BK81hAoC\",\"en-us_concepts_node-and-workspace.md\":\"Bm7rEIAI\",\"en-us_concepts_permissions-and-sharing.md\":\"DiEopkbD\",\"en-us_concepts_runner-control.md\":\"CcrdYOTx\",\"en-us_concepts_secrets.md\":\"CPhBggXB\",\"en-us_concepts_session-run-turn.md\":\"CIfewRkn\",\"en-us_deployment_backup-restore.md\":\"DQUtQ5Yt\",\"en-us_deployment_network.md\":\"DdOgOLns\",\"en-us_deployment_node-installation.md\":\"DDQ4RdWI\",\"en-us_deployment_node-linux.md\":\"BXhYZ6de\",\"en-us_deployment_node-macos.md\":\"D26h7wJ1\",\"en-us_deployment_node-windows.md\":\"Bp-sytL8\",\"en-us_deployment_production.md\":\"Drc4IHoD\",\"en-us_deployment_security-checklist.md\":\"Dh3cWem6\",\"en-us_deployment_upgrade.md\":\"DZiDDiLn\",\"en-us_getting-started_connect-node.md\":\"DKLHaKuL\",\"en-us_getting-started_first-agent-session.md\":\"CN2rWPq7\",\"en-us_getting-started_first-login.md\":\"DQnGKeN2\",\"en-us_getting-started_next-steps.md\":\"D2UXmW2q\",\"en-us_getting-started_npm-quick-start.md\":\"Dwsi-ffA\",\"en-us_getting-started_overview.md\":\"Bug5sh21\",\"en-us_getting-started_prerequisites.md\":\"Bpx_AQD1\",\"en-us_getting-started_register-workspace.md\":\"D3j75IC2\",\"en-us_getting-started_server-installation.md\":\"_k2XGM85\",\"en-us_operations_marctl.md\":\"CJYpPahB\",\"en-us_reference_configuration.md\":\"Ca2_G45i\",\"en-us_reference_keyboard-shortcuts.md\":\"BHIlAzih\",\"en-us_reference_limits.md\":\"BQahQvRI\",\"en-us_reference_ports-paths-data.md\":\"DckuEN9-\",\"en-us_reference_status-and-errors.md\":\"cq1A6JOM\",\"en-us_runners_claude-code.md\":\"BZp77nTJ\",\"en-us_runners_codex.md\":\"C8aQ3lj4\",\"en-us_runners_mar-agent.md\":\"DjryPiTL\",\"en-us_runners_opencode.md\":\"DAnPpdjG\",\"en-us_runners_overview.md\":\"n8off-KX\",\"en-us_runners_runner-troubleshooting.md\":\"BvJ6yGrw\",\"en-us_troubleshooting_node-offline.md\":\"BS2cHLeq\",\"en-us_troubleshooting_quick-diagnosis.md\":\"CPWX9djq\",\"en-us_troubleshooting_session-run.md\":\"o9ty9dWk\",\"en-us_troubleshooting_terminal.md\":\"Ce3H_Cq3\",\"en-us_troubleshooting_workspace-files.md\":\"I66m4D0K\",\"en-us_workbench_composer.md\":\"CCnbitB3\",\"en-us_workbench_context-and-plan.md\":\"E9yFtLaR\",\"en-us_workbench_conversation.md\":\"DWFI4rSa\",\"en-us_workbench_file-reference-and-attachment.md\":\"Xzbr8MRS\",\"en-us_workbench_files.md\":\"C5byBZOZ\",\"en-us_workbench_git-changes.md\":\"CgzmFd8l\",\"en-us_workbench_git-history.md\":\"CcKXv4NB\",\"en-us_workbench_hosted-conversations.md\":\"hxgo3oRa\",\"en-us_workbench_mobile.md\":\"C3A2Sq-s\",\"en-us_workbench_navigation.md\":\"BXLJsQMY\",\"en-us_workbench_sessions.md\":\"tSnti1TK\",\"en-us_workbench_skills.md\":\"xchi27R9\",\"en-us_workbench_terminal.md\":\"B23OFnB3\",\"getting-started_connect-node.md\":\"B9kKn-7y\",\"getting-started_first-agent-session.md\":\"D-uls92b\",\"getting-started_first-login.md\":\"DVWDKgMU\",\"getting-started_next-steps.md\":\"CjwJgSAt\",\"getting-started_npm-quick-start.md\":\"CcxMwUgz\",\"getting-started_overview.md\":\"CA1CCOBc\",\"getting-started_prerequisites.md\":\"D26KU42D\",\"getting-started_register-workspace.md\":\"BW-xjHjl\",\"getting-started_server-installation.md\":\"D3P3Lmc2\",\"operations_marctl.md\":\"BW9barpn\",\"reference_configuration.md\":\"CvHKh-kv\",\"reference_keyboard-shortcuts.md\":\"DOivSxmM\",\"reference_limits.md\":\"17DNV05j\",\"reference_ports-paths-data.md\":\"RqYAhrgF\",\"reference_status-and-errors.md\":\"BwpSR6nH\",\"runners_claude-code.md\":\"DSGRX72-\",\"runners_codex.md\":\"CDGNsFMp\",\"runners_mar-agent.md\":\"DjuqySh9\",\"runners_opencode.md\":\"DSvXW8Sv\",\"runners_overview.md\":\"CHK7UvIl\",\"runners_runner-troubleshooting.md\":\"CIWCfGkf\",\"troubleshooting_node-offline.md\":\"BQ-5_Xyu\",\"troubleshooting_quick-diagnosis.md\":\"fq0U5Cg7\",\"troubleshooting_session-run.md\":\"Cny0YwSq\",\"troubleshooting_terminal.md\":\"DB0zc8sK\",\"troubleshooting_workspace-files.md\":\"BEFLZu54\",\"workbench_composer.md\":\"DlU35VaN\",\"workbench_context-and-plan.md\":\"CzRACFjQ\",\"workbench_conversation.md\":\"Ib2W7CCX\",\"workbench_file-reference-and-attachment.md\":\"CSLMm-nL\",\"workbench_files.md\":\"B5xE7YGc\",\"workbench_git-changes.md\":\"C7xvpMwy\",\"workbench_git-history.md\":\"Ckvhp8Y3\",\"workbench_hosted-conversations.md\":\"C0YVmf0T\",\"workbench_mobile.md\":\"3NSNZGu8\",\"workbench_navigation.md\":\"B8UD4qpB\",\"workbench_sessions.md\":\"DHPI_apA\",\"workbench_skills.md\":\"BQw1Wuiy\",\"workbench_terminal.md\":\"YzgZvVcu\"}");window.__VP_SITE_DATA__=JSON.parse("{\"lang\":\"zh-CN\",\"dir\":\"ltr\",\"title\":\"MyAgentRoam Documentation\",\"description\":\"MyAgentRoam 部署、配置与使用文档\",\"base\":\"/docs/\",\"head\":[],\"router\":{\"prefetchLinks\":true},\"appearance\":true,\"themeConfig\":{\"logo\":\"/logo.png?v=logo-20261011\",\"logoLink\":\"/\",\"siteTitle\":\"Documentation\",\"langMenuLabel\":\"切换语言\",\"outline\":{\"label\":\"本页内容\",\"level\":[2,3]},\"returnToTopLabel\":\"返回顶部\",\"sidebarMenuLabel\":\"文档目录\",\"darkModeSwitchLabel\":\"外观\",\"lightModeSwitchTitle\":\"切换至浅色模式\",\"darkModeSwitchTitle\":\"切换至深色模式\",\"docFooter\":{\"prev\":\"上一篇\",\"next\":\"下一篇\"},\"search\":{\"provider\":\"local\",\"options\":{\"translations\":{\"button\":{\"buttonText\":\"搜索文档\",\"buttonAriaLabel\":\"搜索文档\"}}}},\"sidebar\":{\"/en-US/\":[{\"text\":\"Getting Started\",\"items\":[{\"text\":\"What Is MyAgentRoam?\",\"link\":\"/en-US/getting-started/overview\"},{\"text\":\"Local npm Quick Start\",\"link\":\"/en-US/getting-started/npm-quick-start\"},{\"text\":\"Before You Deploy\",\"link\":\"/en-US/getting-started/prerequisites\"},{\"text\":\"Deploy Server and Web\",\"link\":\"/en-US/getting-started/server-installation\"},{\"text\":\"First Sign-in and Password Change\",\"link\":\"/en-US/getting-started/first-login\"},{\"text\":\"Connect Your First Node\",\"link\":\"/en-US/getting-started/connect-node\"},{\"text\":\"Register Your First Workspace\",\"link\":\"/en-US/getting-started/register-workspace\"},{\"text\":\"Start Your First Agent Session\",\"link\":\"/en-US/getting-started/first-agent-session\"},{\"text\":\"Next Steps\",\"link\":\"/en-US/getting-started/next-steps\"}]},{\"text\":\"Core Concepts\",\"items\":[{\"text\":\"Server, Node, Web, and Runner\",\"link\":\"/en-US/concepts/architecture\"},{\"text\":\"Nodes and Workspaces\",\"link\":\"/en-US/concepts/node-and-workspace\"},{\"text\":\"Sessions, Runs, and Message Queues\",\"link\":\"/en-US/concepts/session-run-turn\"},{\"text\":\"Runners and Session Control\",\"link\":\"/en-US/concepts/runner-control\"},{\"text\":\"Files, Git, and Terminals\",\"link\":\"/en-US/concepts/files-git-terminal\"},{\"text\":\"Users, Organizations, and Access\",\"link\":\"/en-US/concepts/permissions-and-sharing\"},{\"text\":\"Secrets and Injection Order\",\"link\":\"/en-US/concepts/secrets\"},{\"text\":\"Data, Credentials, and Security\",\"link\":\"/en-US/concepts/data-and-security\"}]},{\"text\":\"Work / Conversation Guide\",\"items\":[{\"text\":\"Work Mode, Nodes, and Workspaces\",\"link\":\"/en-US/workbench/navigation\"},{\"text\":\"Favorite and Install Skills\",\"link\":\"/en-US/workbench/skills\"},{\"text\":\"Create and Manage Sessions\",\"link\":\"/en-US/workbench/sessions\"},{\"text\":\"Messages and Composer\",\"link\":\"/en-US/workbench/composer\"},{\"text\":\"Context, Compact, and Plan\",\"link\":\"/en-US/workbench/context-and-plan\"},{\"text\":\"References, Folders, and Attachments\",\"link\":\"/en-US/workbench/file-reference-and-attachment\"},{\"text\":\"Conversations, Tools, and Notifications\",\"link\":\"/en-US/workbench/conversation\"},{\"text\":\"Start a Template Conversation in Conversation Mode\",\"link\":\"/en-US/workbench/hosted-conversations\"},{\"text\":\"Browse, Search, and Manage Files\",\"link\":\"/en-US/workbench/files\"},{\"text\":\"Git Changes and Diff\",\"link\":\"/en-US/workbench/git-changes\"},{\"text\":\"Git History\",\"link\":\"/en-US/workbench/git-history\"},{\"text\":\"Workspace Terminals\",\"link\":\"/en-US/workbench/terminal\"},{\"text\":\"Continue on Mobile\",\"link\":\"/en-US/workbench/mobile\"}]},{\"text\":\"Agent Guide\",\"items\":[{\"text\":\"Choose an Agent\",\"link\":\"/en-US/runners/overview\"},{\"text\":\"OpenCode\",\"link\":\"/en-US/runners/opencode\"},{\"text\":\"Codex\",\"link\":\"/en-US/runners/codex\"},{\"text\":\"Claude Code\",\"link\":\"/en-US/runners/claude-code\"},{\"text\":\"Built-in MAR Agent\",\"link\":\"/en-US/runners/mar-agent\"},{\"text\":\"Runner Troubleshooting\",\"link\":\"/en-US/runners/runner-troubleshooting\"}]},{\"text\":\"Deployment and Operations\",\"items\":[{\"text\":\"Production Deployment and Reverse Proxy\",\"link\":\"/en-US/deployment/production\"},{\"text\":\"Install and Register a Node\",\"link\":\"/en-US/deployment/node-installation\"},{\"text\":\"Linux Node and systemd\",\"link\":\"/en-US/deployment/node-linux\"},{\"text\":\"Windows Node and Task Scheduler\",\"link\":\"/en-US/deployment/node-windows\"},{\"text\":\"macOS Node and launchd\",\"link\":\"/en-US/deployment/node-macos\"},{\"text\":\"Upgrade MyAgentRoam\",\"link\":\"/en-US/deployment/upgrade\"},{\"text\":\"Backup and Restore\",\"link\":\"/en-US/deployment/backup-restore\"},{\"text\":\"Network, TLS, and WebSocket\",\"link\":\"/en-US/deployment/network\"},{\"text\":\"Production Security Checklist\",\"link\":\"/en-US/deployment/security-checklist\"}]},{\"text\":\"Node Operations Tools\",\"items\":[{\"text\":\"Manage Nodes with marctl\",\"link\":\"/en-US/operations/marctl\"}]},{\"text\":\"Administration Guide\",\"items\":[{\"text\":\"Account Security and Sign-in Sessions\",\"link\":\"/en-US/administration/account\"},{\"text\":\"Manage Nodes and Workspaces\",\"link\":\"/en-US/administration/nodes-workspaces\"},{\"text\":\"Manage Conversation Templates\",\"link\":\"/en-US/administration/conversation-templates\"},{\"text\":\"Maintain a Conversation Template Workspace\",\"link\":\"/en-US/administration/template-workspace-maintenance\"},{\"text\":\"Manage Secrets\",\"link\":\"/en-US/administration/secrets\"},{\"text\":\"Configure SMTP Email and Notification Templates\",\"link\":\"/en-US/administration/email-notifications\"},{\"text\":\"Manage Users, Organizations, and Roles\",\"link\":\"/en-US/administration/users-organizations\"},{\"text\":\"Configure OAuth 2.0 SSO\",\"link\":\"/en-US/administration/oauth\"},{\"text\":\"Audit Events and Export\",\"link\":\"/en-US/administration/audit\"},{\"text\":\"Personal and Enterprise Licenses\",\"link\":\"/en-US/administration/license\"}]},{\"text\":\"Troubleshooting and Reference\",\"items\":[{\"text\":\"Quick Diagnosis\",\"link\":\"/en-US/troubleshooting/quick-diagnosis\"},{\"text\":\"Node Registration or Offline Issues\",\"link\":\"/en-US/troubleshooting/node-offline\"},{\"text\":\"Workspace, File, or Git Issues\",\"link\":\"/en-US/troubleshooting/workspace-files\"},{\"text\":\"Session Stuck or Read-only\",\"link\":\"/en-US/troubleshooting/session-run\"},{\"text\":\"Terminal Connection Issues\",\"link\":\"/en-US/troubleshooting/terminal\"},{\"text\":\"Keyboard Shortcuts\",\"link\":\"/en-US/reference/keyboard-shortcuts\"},{\"text\":\"Statuses and Common Errors\",\"link\":\"/en-US/reference/status-and-errors\"},{\"text\":\"Configuration Reference\",\"link\":\"/en-US/reference/configuration\"},{\"text\":\"Ports, Paths, and Data\",\"link\":\"/en-US/reference/ports-paths-data\"},{\"text\":\"Versions, Capacity, and Limits\",\"link\":\"/en-US/reference/limits\"}]}],\"/\":[{\"text\":\"开始使用\",\"items\":[{\"text\":\"MyAgentRoam 是什么\",\"link\":\"/getting-started/overview\"},{\"text\":\"本机 npm 快速开始\",\"link\":\"/getting-started/npm-quick-start\"},{\"text\":\"部署前准备\",\"link\":\"/getting-started/prerequisites\"},{\"text\":\"部署 Server 与 Web\",\"link\":\"/getting-started/server-installation\"},{\"text\":\"首次登录与修改密码\",\"link\":\"/getting-started/first-login\"},{\"text\":\"接入第一台 Node\",\"link\":\"/getting-started/connect-node\"},{\"text\":\"登记第一个 Workspace\",\"link\":\"/getting-started/register-workspace\"},{\"text\":\"开始第一次 Agent 对话\",\"link\":\"/getting-started/first-agent-session\"},{\"text\":\"接下来可以做什么\",\"link\":\"/getting-started/next-steps\"}]},{\"text\":\"核心概念\",\"items\":[{\"text\":\"Server、Node、Web 与 Runner\",\"link\":\"/concepts/architecture\"},{\"text\":\"Node 与 Workspace\",\"link\":\"/concepts/node-and-workspace\"},{\"text\":\"会话、运行与消息队列\",\"link\":\"/concepts/session-run-turn\"},{\"text\":\"Runner 与会话控制状态\",\"link\":\"/concepts/runner-control\"},{\"text\":\"文件、Git 与终端\",\"link\":\"/concepts/files-git-terminal\"},{\"text\":\"用户、组织与资源权限\",\"link\":\"/concepts/permissions-and-sharing\"},{\"text\":\"环境变量密钥与注入顺序\",\"link\":\"/concepts/secrets\"},{\"text\":\"数据归属、凭据与安全边界\",\"link\":\"/concepts/data-and-security\"}]},{\"text\":\"工作 / 对话使用指南\",\"items\":[{\"text\":\"工作模式、Node 与 Workspace\",\"link\":\"/workbench/navigation\"},{\"text\":\"收藏与安装 Skill\",\"link\":\"/workbench/skills\"},{\"text\":\"创建、查找与管理会话\",\"link\":\"/workbench/sessions\"},{\"text\":\"发送消息与使用 Composer\",\"link\":\"/workbench/composer\"},{\"text\":\"上下文用量、Compact 与 Plan\",\"link\":\"/workbench/context-and-plan\"},{\"text\":\"@ 引用、文件夹与附件\",\"link\":\"/workbench/file-reference-and-attachment\"},{\"text\":\"阅读对话、工具调用与通知\",\"link\":\"/workbench/conversation\"},{\"text\":\"在对话模式从模板新建对话\",\"link\":\"/workbench/hosted-conversations\"},{\"text\":\"浏览、搜索与管理文件\",\"link\":\"/workbench/files\"},{\"text\":\"查看 Git Changes 与 Diff\",\"link\":\"/workbench/git-changes\"},{\"text\":\"查看 Git 历史\",\"link\":\"/workbench/git-history\"},{\"text\":\"使用 Workspace 终端\",\"link\":\"/workbench/terminal\"},{\"text\":\"在移动端继续工作\",\"link\":\"/workbench/mobile\"}]},{\"text\":\"Agent 指南\",\"items\":[{\"text\":\"选择 Agent\",\"link\":\"/runners/overview\"},{\"text\":\"安装、配置和使用 OpenCode\",\"link\":\"/runners/opencode\"},{\"text\":\"安装、配置和使用 Codex\",\"link\":\"/runners/codex\"},{\"text\":\"安装、配置和使用 Claude Code\",\"link\":\"/runners/claude-code\"},{\"text\":\"配置和使用内置 MAR Agent\",\"link\":\"/runners/mar-agent\"},{\"text\":\"Agent 不可用或模型缺失\",\"link\":\"/runners/runner-troubleshooting\"}]},{\"text\":\"部署与运维\",\"items\":[{\"text\":\"生产部署与反向代理\",\"link\":\"/deployment/production\"},{\"text\":\"安装与注册 Node\",\"link\":\"/deployment/node-installation\"},{\"text\":\"Linux Node 与 systemd\",\"link\":\"/deployment/node-linux\"},{\"text\":\"Windows Node 与任务计划\",\"link\":\"/deployment/node-windows\"},{\"text\":\"macOS Node 与 launchd\",\"link\":\"/deployment/node-macos\"},{\"text\":\"升级 MyAgentRoam\",\"link\":\"/deployment/upgrade\"},{\"text\":\"备份与恢复\",\"link\":\"/deployment/backup-restore\"},{\"text\":\"网络、TLS 与 WebSocket\",\"link\":\"/deployment/network\"},{\"text\":\"上线安全检查清单\",\"link\":\"/deployment/security-checklist\"}]},{\"text\":\"节点运维工具\",\"items\":[{\"text\":\"使用 marctl 管理节点\",\"link\":\"/operations/marctl\"}]},{\"text\":\"管理指南\",\"items\":[{\"text\":\"账户安全与登录会话\",\"link\":\"/administration/account\"},{\"text\":\"管理 Node 与 Workspace\",\"link\":\"/administration/nodes-workspaces\"},{\"text\":\"管理对话模板\",\"link\":\"/administration/conversation-templates\"},{\"text\":\"维护对话模板 Workspace\",\"link\":\"/administration/template-workspace-maintenance\"},{\"text\":\"管理环境变量密钥\",\"link\":\"/administration/secrets\"},{\"text\":\"配置 SMTP 邮件与通知模板\",\"link\":\"/administration/email-notifications\"},{\"text\":\"管理用户、组织与角色\",\"link\":\"/administration/users-organizations\"},{\"text\":\"配置 OAuth 2.0 SSO\",\"link\":\"/administration/oauth\"},{\"text\":\"查询与导出操作审计\",\"link\":\"/administration/audit\"},{\"text\":\"社区版、企业 License 与冻结态\",\"link\":\"/administration/license\"}]},{\"text\":\"故障排查与参考\",\"items\":[{\"text\":\"从现象开始排查\",\"link\":\"/troubleshooting/quick-diagnosis\"},{\"text\":\"Node 注册失败或离线\",\"link\":\"/troubleshooting/node-offline\"},{\"text\":\"Workspace、文件或 Git 不可用\",\"link\":\"/troubleshooting/workspace-files\"},{\"text\":\"会话卡在 Working、Idle 或只读\",\"link\":\"/troubleshooting/session-run\"},{\"text\":\"终端无法打开或频繁断线\",\"link\":\"/troubleshooting/terminal\"},{\"text\":\"键盘快捷键\",\"link\":\"/reference/keyboard-shortcuts\"},{\"text\":\"状态、提示与常见错误\",\"link\":\"/reference/status-and-errors\"},{\"text\":\"配置项参考\",\"link\":\"/reference/configuration\"},{\"text\":\"端口、配置目录与数据位置\",\"link\":\"/reference/ports-paths-data\"},{\"text\":\"版本、容量与已知限制\",\"link\":\"/reference/limits\"}]}]}},\"locales\":{\"root\":{\"label\":\"简体中文\",\"lang\":\"zh-CN\"},\"en-US\":{\"label\":\"English\",\"lang\":\"en-US\",\"title\":\"MyAgentRoam Documentation\",\"description\":\"Deployment, configuration, and usage documentation for MyAgentRoam\",\"themeConfig\":{\"siteTitle\":\"Documentation\",\"langMenuLabel\":\"Switch language\",\"outline\":{\"label\":\"On This Page\",\"level\":[2,3]},\"returnToTopLabel\":\"Return to Top\",\"sidebarMenuLabel\":\"Menu\",\"darkModeSwitchLabel\":\"Appearance\",\"lightModeSwitchTitle\":\"Switch to Light Theme\",\"darkModeSwitchTitle\":\"Switch to Dark Theme\",\"docFooter\":{\"prev\":\"Previous\",\"next\":\"Next\"},\"search\":{\"provider\":\"local\",\"options\":{\"translations\":{\"button\":{\"buttonText\":\"Search Documentation\",\"buttonAriaLabel\":\"Search Documentation\"}}}}}}},\"scrollOffset\":134,\"cleanUrls\":true}");</script>
   </body>
 </html>

package/web/docs/deployment/node-macos.html CHANGED Viewed

@@ -9,9 +9,9 @@
     <link rel="preload stylesheet" href="/docs/assets/style.B3QdEOQQ.css" as="style">
     <link rel="preload stylesheet" href="/docs/vp-icons.css" as="style">
-    <script type="module" src="/docs/assets/app.DQ73g8Ca.js"></script>
+    <script type="module" src="/docs/assets/app.DFdypnML.js"></script>
     <link rel="preload" href="/docs/assets/inter-roman-latin.Di8DUHzh.woff2" as="font" type="font/woff2" crossorigin="">
-    <link rel="modulepreload" href="/docs/assets/chunks/theme.CES2lSYr.js">
+    <link rel="modulepreload" href="/docs/assets/chunks/theme.DLnKtfGY.js">
     <link rel="modulepreload" href="/docs/assets/chunks/framework.BHjrhdiC.js">
     <link rel="modulepreload" href="/docs/assets/deployment_node-macos.md.DRV9KDoO.lean.js">
     <script id="check-dark-mode">(()=>{const e=localStorage.getItem("vitepress-theme-appearance")||"auto",a=window.matchMedia("(prefers-color-scheme: dark)").matches;(!e||e==="auto"?a:e==="dark")&&document.documentElement.classList.add("dark")})();</script>
@@ -31,7 +31,7 @@
 <span class="line"><span style="--shiki-light:#6F42C1;--shiki-dark:#B392F0;">launchctl</span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;"> bootstrap</span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;"> &quot;gui/$(</span><span style="--shiki-light:#6F42C1;--shiki-dark:#B392F0;">id</span><span style="--shiki-light:#005CC5;--shiki-dark:#79B8FF;"> -u</span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;">)&quot;</span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;"> &quot;</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">$plist</span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;">&quot;</span></span>
 <span class="line"><span style="--shiki-light:#6F42C1;--shiki-dark:#B392F0;">launchctl</span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;"> kickstart</span><span style="--shiki-light:#005CC5;--shiki-dark:#79B8FF;"> -k</span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;"> &quot;gui/$(</span><span style="--shiki-light:#6F42C1;--shiki-dark:#B392F0;">id</span><span style="--shiki-light:#005CC5;--shiki-dark:#79B8FF;"> -u</span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;">)/com.myagentroam.node&quot;</span></span>
 <span class="line"><span style="--shiki-light:#6F42C1;--shiki-dark:#B392F0;">launchctl</span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;"> print</span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;"> &quot;gui/$(</span><span style="--shiki-light:#6F42C1;--shiki-dark:#B392F0;">id</span><span style="--shiki-light:#005CC5;--shiki-dark:#79B8FF;"> -u</span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;">)/com.myagentroam.node&quot;</span></span></code></pre></div><p><code>mar-node install</code> 生成的 LaunchAgent 以 <code>mar-node supervise --config</code> 启动 Node；<code>launchctl bootstrap</code> 才会登记并启动它。生成文件包含 Homebrew 和系统常用目录的 <code>PATH</code>。如果 <code>node</code>、<code>npm</code>、<code>mar-node</code> 或外部 Agent CLI 通过 nvm、Volta 或其他自定义目录安装，先编辑 plist 中 <code>EnvironmentVariables.PATH</code>，再重新执行 <code>bootout</code>、<code>bootstrap</code> 和 <code>kickstart</code>；不要依赖交互式 shell 初始化文件。</p><h2 id="自启动与远程升级验收" tabindex="-1">自启动与远程升级验收 <a class="header-anchor" href="#自启动与远程升级验收" aria-label="Permalink to &quot;自启动与远程升级验收&quot;"></a></h2><p>确认以下条件：</p><ul><li><code>launchctl print</code> 显示 <code>com.myagentroam.node</code> 已加载，且 <code>ProgramArguments</code> 包含 <code>supervise --config</code>，而不是 <code>run --config</code>；</li><li>目标用户可读写配置、<code>dataDirectory</code>、Workspace，并可读取该用户自己的 Agent 登录与 npm 配置；</li><li>在该用户的非交互环境中，<code>node</code>、<code>npm</code>、<code>mar-node</code> 可解析；按实际用途再检查 <code>npx</code>、<code>git</code>、<code>python3</code>/<code>python</code>、<code>pip3</code>/<code>pip</code>、<code>opencode</code>、<code>codex</code> 和 <code>claude</code>；</li><li>重新登录该用户或执行 <code>launchctl kickstart -k &quot;gui/$(id -u)/com.myagentroam.node&quot;</code> 后，Node 以原有身份自动上线，节点详情不显示“需手工启用 Supervisor”。</li></ul><p>Supervisor 会将远程升级版本安装到 <code>dataDirectory/node-versions/&lt;版本&gt;/</code>，并在 LaunchAgent 进程中切换 Node 子进程。管理端推送不会创建或修改 LaunchAgent，也不会提升权限；首次自启动配置必须在 macOS 主机上完成。</p><p><strong>成功标志：</strong> 节点页显示在线，重启 LaunchAgent 或重新登录用户后自动重连，详情显示已启用 Supervisor 升级能力，并且可打开 Workspace、终端和已配置的 Agent。</p><p>如果 Node 未启动，先检查 <code>launchctl print</code> 的退出状态、plist 的 <code>ProgramArguments</code> 和 <code>PATH</code>、配置路径、目标用户的用户目录与 Workspace 权限。不要切换为 root 来绕过 Agent 登录或路径问题。</p></div></div></main><footer class="VPDocFooter" data-v-cd08f8de data-v-579b47ad><!--[--><!--]--><!----><nav class="prev-next" aria-labelledby="doc-footer-aria-label" data-v-579b47ad><span class="visually-hidden" id="doc-footer-aria-label" data-v-579b47ad>Pager</span><div class="pager" data-v-579b47ad><a class="VPLink link pager-link prev" href="/docs/deployment/node-windows" data-v-579b47ad><!--[--><span class="desc" data-v-579b47ad>上一篇</span><span class="title" data-v-579b47ad>Windows Node 与任务计划</span><!--]--></a></div><div class="pager" data-v-579b47ad><a class="VPLink link pager-link next" href="/docs/deployment/upgrade" data-v-579b47ad><!--[--><span class="desc" data-v-579b47ad>下一篇</span><span class="title" data-v-579b47ad>升级 MyAgentRoam</span><!--]--></a></div></nav></footer><!--[--><!--]--></div></div></div><!--[--><!--]--></div></div><!----><!--[--><!--]--></div></div>
-    <script>window.__VP_HASH_MAP__=JSON.parse("{\"administration_account.md\":\"BDxiZLcI\",\"administration_audit.md\":\"CPGsRZCt\",\"administration_conversation-templates.md\":\"DR-Q8ZJH\",\"administration_email-notifications.md\":\"CcYZiN4h\",\"administration_license.md\":\"CdgtKnVd\",\"administration_nodes-workspaces.md\":\"CMGc1EC3\",\"administration_oauth.md\":\"DVrr-ce3\",\"administration_secrets.md\":\"BVsK96Ny\",\"administration_template-workspace-maintenance.md\":\"ic3SEbkM\",\"administration_users-organizations.md\":\"CInTvyvp\",\"concepts_architecture.md\":\"CWYNi_YX\",\"concepts_data-and-security.md\":\"DvabQ2zO\",\"concepts_files-git-terminal.md\":\"DR-aSOLY\",\"concepts_node-and-workspace.md\":\"D4tWJ_5A\",\"concepts_permissions-and-sharing.md\":\"BGQlim_y\",\"concepts_runner-control.md\":\"Bkd1fXLk\",\"concepts_secrets.md\":\"DRt04t7A\",\"concepts_session-run-turn.md\":\"Crte1ZI0\",\"deployment_backup-restore.md\":\"fZtPK3bl\",\"deployment_network.md\":\"BarghfLt\",\"deployment_node-installation.md\":\"BhsVg-7E\",\"deployment_node-linux.md\":\"ayZjBc-g\",\"deployment_node-macos.md\":\"DRV9KDoO\",\"deployment_node-windows.md\":\"gpTo69VQ\",\"deployment_production.md\":\"83mdKwsb\",\"deployment_security-checklist.md\":\"CxWdJ9xO\",\"deployment_upgrade.md\":\"BESOToM5\",\"en-us_administration_account.md\":\"q4dfxq-Y\",\"en-us_administration_audit.md\":\"7tn6Eg6i\",\"en-us_administration_conversation-templates.md\":\"D7eekprK\",\"en-us_administration_email-notifications.md\":\"DvyUIBNy\",\"en-us_administration_license.md\":\"jmAMVJjC\",\"en-us_administration_nodes-workspaces.md\":\"BOA5ixAC\",\"en-us_administration_oauth.md\":\"DwEfTIEs\",\"en-us_administration_secrets.md\":\"DOlPJy7O\",\"en-us_administration_template-workspace-maintenance.md\":\"B1Dys0Xw\",\"en-us_administration_users-organizations.md\":\"CkX2sOqa\",\"en-us_concepts_architecture.md\":\"DUoUKxu0\",\"en-us_concepts_data-and-security.md\":\"DpXrCSPO\",\"en-us_concepts_files-git-terminal.md\":\"BK81hAoC\",\"en-us_concepts_node-and-workspace.md\":\"Bm7rEIAI\",\"en-us_concepts_permissions-and-sharing.md\":\"DiEopkbD\",\"en-us_concepts_runner-control.md\":\"CcrdYOTx\",\"en-us_concepts_secrets.md\":\"CPhBggXB\",\"en-us_concepts_session-run-turn.md\":\"CIfewRkn\",\"en-us_deployment_backup-restore.md\":\"DQUtQ5Yt\",\"en-us_deployment_network.md\":\"DdOgOLns\",\"en-us_deployment_node-installation.md\":\"DDQ4RdWI\",\"en-us_deployment_node-linux.md\":\"BXhYZ6de\",\"en-us_deployment_node-macos.md\":\"D26h7wJ1\",\"en-us_deployment_node-windows.md\":\"Bp-sytL8\",\"en-us_deployment_production.md\":\"Drc4IHoD\",\"en-us_deployment_security-checklist.md\":\"Dh3cWem6\",\"en-us_deployment_upgrade.md\":\"DZiDDiLn\",\"en-us_getting-started_connect-node.md\":\"DKLHaKuL\",\"en-us_getting-started_first-agent-session.md\":\"CN2rWPq7\",\"en-us_getting-started_first-login.md\":\"DQnGKeN2\",\"en-us_getting-started_next-steps.md\":\"D2UXmW2q\",\"en-us_getting-started_npm-quick-start.md\":\"CLCHq7k_\",\"en-us_getting-started_overview.md\":\"Bug5sh21\",\"en-us_getting-started_prerequisites.md\":\"Bpx_AQD1\",\"en-us_getting-started_register-workspace.md\":\"D3j75IC2\",\"en-us_getting-started_server-installation.md\":\"_k2XGM85\",\"en-us_operations_marctl.md\":\"CJYpPahB\",\"en-us_reference_configuration.md\":\"Ca2_G45i\",\"en-us_reference_keyboard-shortcuts.md\":\"BHIlAzih\",\"en-us_reference_limits.md\":\"BQahQvRI\",\"en-us_reference_ports-paths-data.md\":\"DckuEN9-\",\"en-us_reference_status-and-errors.md\":\"cq1A6JOM\",\"en-us_runners_claude-code.md\":\"BZp77nTJ\",\"en-us_runners_codex.md\":\"C8aQ3lj4\",\"en-us_runners_mar-agent.md\":\"DjryPiTL\",\"en-us_runners_opencode.md\":\"DAnPpdjG\",\"en-us_runners_overview.md\":\"n8off-KX\",\"en-us_runners_runner-troubleshooting.md\":\"BvJ6yGrw\",\"en-us_troubleshooting_node-offline.md\":\"BS2cHLeq\",\"en-us_troubleshooting_quick-diagnosis.md\":\"CPWX9djq\",\"en-us_troubleshooting_session-run.md\":\"o9ty9dWk\",\"en-us_troubleshooting_terminal.md\":\"Ce3H_Cq3\",\"en-us_troubleshooting_workspace-files.md\":\"I66m4D0K\",\"en-us_workbench_composer.md\":\"CCnbitB3\",\"en-us_workbench_context-and-plan.md\":\"E9yFtLaR\",\"en-us_workbench_conversation.md\":\"DWFI4rSa\",\"en-us_workbench_file-reference-and-attachment.md\":\"Xzbr8MRS\",\"en-us_workbench_files.md\":\"C5byBZOZ\",\"en-us_workbench_git-changes.md\":\"CgzmFd8l\",\"en-us_workbench_git-history.md\":\"CcKXv4NB\",\"en-us_workbench_hosted-conversations.md\":\"hxgo3oRa\",\"en-us_workbench_mobile.md\":\"C3A2Sq-s\",\"en-us_workbench_navigation.md\":\"BXLJsQMY\",\"en-us_workbench_sessions.md\":\"tSnti1TK\",\"en-us_workbench_skills.md\":\"C4xlXyjC\",\"en-us_workbench_terminal.md\":\"B23OFnB3\",\"getting-started_connect-node.md\":\"B9kKn-7y\",\"getting-started_first-agent-session.md\":\"D-uls92b\",\"getting-started_first-login.md\":\"DVWDKgMU\",\"getting-started_next-steps.md\":\"CjwJgSAt\",\"getting-started_npm-quick-start.md\":\"B9varoSe\",\"getting-started_overview.md\":\"CA1CCOBc\",\"getting-started_prerequisites.md\":\"D26KU42D\",\"getting-started_register-workspace.md\":\"BW-xjHjl\",\"getting-started_server-installation.md\":\"D3P3Lmc2\",\"operations_marctl.md\":\"BW9barpn\",\"reference_configuration.md\":\"CvHKh-kv\",\"reference_keyboard-shortcuts.md\":\"DOivSxmM\",\"reference_limits.md\":\"17DNV05j\",\"reference_ports-paths-data.md\":\"RqYAhrgF\",\"reference_status-and-errors.md\":\"BwpSR6nH\",\"runners_claude-code.md\":\"DSGRX72-\",\"runners_codex.md\":\"CDGNsFMp\",\"runners_mar-agent.md\":\"DjuqySh9\",\"runners_opencode.md\":\"DSvXW8Sv\",\"runners_overview.md\":\"CHK7UvIl\",\"runners_runner-troubleshooting.md\":\"CIWCfGkf\",\"troubleshooting_node-offline.md\":\"BQ-5_Xyu\",\"troubleshooting_quick-diagnosis.md\":\"fq0U5Cg7\",\"troubleshooting_session-run.md\":\"Cny0YwSq\",\"troubleshooting_terminal.md\":\"DB0zc8sK\",\"troubleshooting_workspace-files.md\":\"BEFLZu54\",\"workbench_composer.md\":\"DlU35VaN\",\"workbench_context-and-plan.md\":\"CzRACFjQ\",\"workbench_conversation.md\":\"Ib2W7CCX\",\"workbench_file-reference-and-attachment.md\":\"CSLMm-nL\",\"workbench_files.md\":\"B5xE7YGc\",\"workbench_git-changes.md\":\"C7xvpMwy\",\"workbench_git-history.md\":\"Ckvhp8Y3\",\"workbench_hosted-conversations.md\":\"C0YVmf0T\",\"workbench_mobile.md\":\"3NSNZGu8\",\"workbench_navigation.md\":\"B8UD4qpB\",\"workbench_sessions.md\":\"DHPI_apA\",\"workbench_skills.md\":\"rWZ_VuoB\",\"workbench_terminal.md\":\"YzgZvVcu\"}");window.__VP_SITE_DATA__=JSON.parse("{\"lang\":\"zh-CN\",\"dir\":\"ltr\",\"title\":\"MyAgentRoam Documentation\",\"description\":\"MyAgentRoam 部署、配置与使用文档\",\"base\":\"/docs/\",\"head\":[],\"router\":{\"prefetchLinks\":true},\"appearance\":true,\"themeConfig\":{\"logo\":\"/logo.png?v=logo-20261011\",\"logoLink\":\"/\",\"siteTitle\":\"Documentation\",\"langMenuLabel\":\"切换语言\",\"outline\":{\"label\":\"本页内容\",\"level\":[2,3]},\"returnToTopLabel\":\"返回顶部\",\"sidebarMenuLabel\":\"文档目录\",\"darkModeSwitchLabel\":\"外观\",\"lightModeSwitchTitle\":\"切换至浅色模式\",\"darkModeSwitchTitle\":\"切换至深色模式\",\"docFooter\":{\"prev\":\"上一篇\",\"next\":\"下一篇\"},\"search\":{\"provider\":\"local\",\"options\":{\"translations\":{\"button\":{\"buttonText\":\"搜索文档\",\"buttonAriaLabel\":\"搜索文档\"}}}},\"sidebar\":{\"/en-US/\":[{\"text\":\"Getting Started\",\"items\":[{\"text\":\"What Is MyAgentRoam?\",\"link\":\"/en-US/getting-started/overview\"},{\"text\":\"Local npm Quick Start\",\"link\":\"/en-US/getting-started/npm-quick-start\"},{\"text\":\"Before You Deploy\",\"link\":\"/en-US/getting-started/prerequisites\"},{\"text\":\"Deploy Server and Web\",\"link\":\"/en-US/getting-started/server-installation\"},{\"text\":\"First Sign-in and Password Change\",\"link\":\"/en-US/getting-started/first-login\"},{\"text\":\"Connect Your First Node\",\"link\":\"/en-US/getting-started/connect-node\"},{\"text\":\"Register Your First Workspace\",\"link\":\"/en-US/getting-started/register-workspace\"},{\"text\":\"Start Your First Agent Session\",\"link\":\"/en-US/getting-started/first-agent-session\"},{\"text\":\"Next Steps\",\"link\":\"/en-US/getting-started/next-steps\"}]},{\"text\":\"Core Concepts\",\"items\":[{\"text\":\"Server, Node, Web, and Runner\",\"link\":\"/en-US/concepts/architecture\"},{\"text\":\"Nodes and Workspaces\",\"link\":\"/en-US/concepts/node-and-workspace\"},{\"text\":\"Sessions, Runs, and Message Queues\",\"link\":\"/en-US/concepts/session-run-turn\"},{\"text\":\"Runners and Session Control\",\"link\":\"/en-US/concepts/runner-control\"},{\"text\":\"Files, Git, and Terminals\",\"link\":\"/en-US/concepts/files-git-terminal\"},{\"text\":\"Users, Organizations, and Access\",\"link\":\"/en-US/concepts/permissions-and-sharing\"},{\"text\":\"Secrets and Injection Order\",\"link\":\"/en-US/concepts/secrets\"},{\"text\":\"Data, Credentials, and Security\",\"link\":\"/en-US/concepts/data-and-security\"}]},{\"text\":\"Work / Conversation Guide\",\"items\":[{\"text\":\"Work Mode, Nodes, and Workspaces\",\"link\":\"/en-US/workbench/navigation\"},{\"text\":\"Favorite and Install Skills\",\"link\":\"/en-US/workbench/skills\"},{\"text\":\"Create and Manage Sessions\",\"link\":\"/en-US/workbench/sessions\"},{\"text\":\"Messages and Composer\",\"link\":\"/en-US/workbench/composer\"},{\"text\":\"Context, Compact, and Plan\",\"link\":\"/en-US/workbench/context-and-plan\"},{\"text\":\"References, Folders, and Attachments\",\"link\":\"/en-US/workbench/file-reference-and-attachment\"},{\"text\":\"Conversations, Tools, and Notifications\",\"link\":\"/en-US/workbench/conversation\"},{\"text\":\"Start a Template Conversation in Conversation Mode\",\"link\":\"/en-US/workbench/hosted-conversations\"},{\"text\":\"Browse, Search, and Manage Files\",\"link\":\"/en-US/workbench/files\"},{\"text\":\"Git Changes and Diff\",\"link\":\"/en-US/workbench/git-changes\"},{\"text\":\"Git History\",\"link\":\"/en-US/workbench/git-history\"},{\"text\":\"Workspace Terminals\",\"link\":\"/en-US/workbench/terminal\"},{\"text\":\"Continue on Mobile\",\"link\":\"/en-US/workbench/mobile\"}]},{\"text\":\"Agent Guide\",\"items\":[{\"text\":\"Choose an Agent\",\"link\":\"/en-US/runners/overview\"},{\"text\":\"OpenCode\",\"link\":\"/en-US/runners/opencode\"},{\"text\":\"Codex\",\"link\":\"/en-US/runners/codex\"},{\"text\":\"Claude Code\",\"link\":\"/en-US/runners/claude-code\"},{\"text\":\"Built-in MAR Agent\",\"link\":\"/en-US/runners/mar-agent\"},{\"text\":\"Runner Troubleshooting\",\"link\":\"/en-US/runners/runner-troubleshooting\"}]},{\"text\":\"Deployment and Operations\",\"items\":[{\"text\":\"Production Deployment and Reverse Proxy\",\"link\":\"/en-US/deployment/production\"},{\"text\":\"Install and Register a Node\",\"link\":\"/en-US/deployment/node-installation\"},{\"text\":\"Linux Node and systemd\",\"link\":\"/en-US/deployment/node-linux\"},{\"text\":\"Windows Node and Task Scheduler\",\"link\":\"/en-US/deployment/node-windows\"},{\"text\":\"macOS Node and launchd\",\"link\":\"/en-US/deployment/node-macos\"},{\"text\":\"Upgrade MyAgentRoam\",\"link\":\"/en-US/deployment/upgrade\"},{\"text\":\"Backup and Restore\",\"link\":\"/en-US/deployment/backup-restore\"},{\"text\":\"Network, TLS, and WebSocket\",\"link\":\"/en-US/deployment/network\"},{\"text\":\"Production Security Checklist\",\"link\":\"/en-US/deployment/security-checklist\"}]},{\"text\":\"Node Operations Tools\",\"items\":[{\"text\":\"Manage Nodes with marctl\",\"link\":\"/en-US/operations/marctl\"}]},{\"text\":\"Administration Guide\",\"items\":[{\"text\":\"Account Security and Sign-in Sessions\",\"link\":\"/en-US/administration/account\"},{\"text\":\"Manage Nodes and Workspaces\",\"link\":\"/en-US/administration/nodes-workspaces\"},{\"text\":\"Manage Conversation Templates\",\"link\":\"/en-US/administration/conversation-templates\"},{\"text\":\"Maintain a Conversation Template Workspace\",\"link\":\"/en-US/administration/template-workspace-maintenance\"},{\"text\":\"Manage Secrets\",\"link\":\"/en-US/administration/secrets\"},{\"text\":\"Configure SMTP Email and Notification Templates\",\"link\":\"/en-US/administration/email-notifications\"},{\"text\":\"Manage Users, Organizations, and Roles\",\"link\":\"/en-US/administration/users-organizations\"},{\"text\":\"Configure OAuth 2.0 SSO\",\"link\":\"/en-US/administration/oauth\"},{\"text\":\"Audit Events and Export\",\"link\":\"/en-US/administration/audit\"},{\"text\":\"Personal and Enterprise Licenses\",\"link\":\"/en-US/administration/license\"}]},{\"text\":\"Troubleshooting and Reference\",\"items\":[{\"text\":\"Quick Diagnosis\",\"link\":\"/en-US/troubleshooting/quick-diagnosis\"},{\"text\":\"Node Registration or Offline Issues\",\"link\":\"/en-US/troubleshooting/node-offline\"},{\"text\":\"Workspace, File, or Git Issues\",\"link\":\"/en-US/troubleshooting/workspace-files\"},{\"text\":\"Session Stuck or Read-only\",\"link\":\"/en-US/troubleshooting/session-run\"},{\"text\":\"Terminal Connection Issues\",\"link\":\"/en-US/troubleshooting/terminal\"},{\"text\":\"Keyboard Shortcuts\",\"link\":\"/en-US/reference/keyboard-shortcuts\"},{\"text\":\"Statuses and Common Errors\",\"link\":\"/en-US/reference/status-and-errors\"},{\"text\":\"Configuration Reference\",\"link\":\"/en-US/reference/configuration\"},{\"text\":\"Ports, Paths, and Data\",\"link\":\"/en-US/reference/ports-paths-data\"},{\"text\":\"Versions, Capacity, and Limits\",\"link\":\"/en-US/reference/limits\"}]}],\"/\":[{\"text\":\"开始使用\",\"items\":[{\"text\":\"MyAgentRoam 是什么\",\"link\":\"/getting-started/overview\"},{\"text\":\"本机 npm 快速开始\",\"link\":\"/getting-started/npm-quick-start\"},{\"text\":\"部署前准备\",\"link\":\"/getting-started/prerequisites\"},{\"text\":\"部署 Server 与 Web\",\"link\":\"/getting-started/server-installation\"},{\"text\":\"首次登录与修改密码\",\"link\":\"/getting-started/first-login\"},{\"text\":\"接入第一台 Node\",\"link\":\"/getting-started/connect-node\"},{\"text\":\"登记第一个 Workspace\",\"link\":\"/getting-started/register-workspace\"},{\"text\":\"开始第一次 Agent 对话\",\"link\":\"/getting-started/first-agent-session\"},{\"text\":\"接下来可以做什么\",\"link\":\"/getting-started/next-steps\"}]},{\"text\":\"核心概念\",\"items\":[{\"text\":\"Server、Node、Web 与 Runner\",\"link\":\"/concepts/architecture\"},{\"text\":\"Node 与 Workspace\",\"link\":\"/concepts/node-and-workspace\"},{\"text\":\"会话、运行与消息队列\",\"link\":\"/concepts/session-run-turn\"},{\"text\":\"Runner 与会话控制状态\",\"link\":\"/concepts/runner-control\"},{\"text\":\"文件、Git 与终端\",\"link\":\"/concepts/files-git-terminal\"},{\"text\":\"用户、组织与资源权限\",\"link\":\"/concepts/permissions-and-sharing\"},{\"text\":\"环境变量密钥与注入顺序\",\"link\":\"/concepts/secrets\"},{\"text\":\"数据归属、凭据与安全边界\",\"link\":\"/concepts/data-and-security\"}]},{\"text\":\"工作 / 对话使用指南\",\"items\":[{\"text\":\"工作模式、Node 与 Workspace\",\"link\":\"/workbench/navigation\"},{\"text\":\"收藏与安装 Skill\",\"link\":\"/workbench/skills\"},{\"text\":\"创建、查找与管理会话\",\"link\":\"/workbench/sessions\"},{\"text\":\"发送消息与使用 Composer\",\"link\":\"/workbench/composer\"},{\"text\":\"上下文用量、Compact 与 Plan\",\"link\":\"/workbench/context-and-plan\"},{\"text\":\"@ 引用、文件夹与附件\",\"link\":\"/workbench/file-reference-and-attachment\"},{\"text\":\"阅读对话、工具调用与通知\",\"link\":\"/workbench/conversation\"},{\"text\":\"在对话模式从模板新建对话\",\"link\":\"/workbench/hosted-conversations\"},{\"text\":\"浏览、搜索与管理文件\",\"link\":\"/workbench/files\"},{\"text\":\"查看 Git Changes 与 Diff\",\"link\":\"/workbench/git-changes\"},{\"text\":\"查看 Git 历史\",\"link\":\"/workbench/git-history\"},{\"text\":\"使用 Workspace 终端\",\"link\":\"/workbench/terminal\"},{\"text\":\"在移动端继续工作\",\"link\":\"/workbench/mobile\"}]},{\"text\":\"Agent 指南\",\"items\":[{\"text\":\"选择 Agent\",\"link\":\"/runners/overview\"},{\"text\":\"安装、配置和使用 OpenCode\",\"link\":\"/runners/opencode\"},{\"text\":\"安装、配置和使用 Codex\",\"link\":\"/runners/codex\"},{\"text\":\"安装、配置和使用 Claude Code\",\"link\":\"/runners/claude-code\"},{\"text\":\"配置和使用内置 MAR Agent\",\"link\":\"/runners/mar-agent\"},{\"text\":\"Agent 不可用或模型缺失\",\"link\":\"/runners/runner-troubleshooting\"}]},{\"text\":\"部署与运维\",\"items\":[{\"text\":\"生产部署与反向代理\",\"link\":\"/deployment/production\"},{\"text\":\"安装与注册 Node\",\"link\":\"/deployment/node-installation\"},{\"text\":\"Linux Node 与 systemd\",\"link\":\"/deployment/node-linux\"},{\"text\":\"Windows Node 与任务计划\",\"link\":\"/deployment/node-windows\"},{\"text\":\"macOS Node 与 launchd\",\"link\":\"/deployment/node-macos\"},{\"text\":\"升级 MyAgentRoam\",\"link\":\"/deployment/upgrade\"},{\"text\":\"备份与恢复\",\"link\":\"/deployment/backup-restore\"},{\"text\":\"网络、TLS 与 WebSocket\",\"link\":\"/deployment/network\"},{\"text\":\"上线安全检查清单\",\"link\":\"/deployment/security-checklist\"}]},{\"text\":\"节点运维工具\",\"items\":[{\"text\":\"使用 marctl 管理节点\",\"link\":\"/operations/marctl\"}]},{\"text\":\"管理指南\",\"items\":[{\"text\":\"账户安全与登录会话\",\"link\":\"/administration/account\"},{\"text\":\"管理 Node 与 Workspace\",\"link\":\"/administration/nodes-workspaces\"},{\"text\":\"管理对话模板\",\"link\":\"/administration/conversation-templates\"},{\"text\":\"维护对话模板 Workspace\",\"link\":\"/administration/template-workspace-maintenance\"},{\"text\":\"管理环境变量密钥\",\"link\":\"/administration/secrets\"},{\"text\":\"配置 SMTP 邮件与通知模板\",\"link\":\"/administration/email-notifications\"},{\"text\":\"管理用户、组织与角色\",\"link\":\"/administration/users-organizations\"},{\"text\":\"配置 OAuth 2.0 SSO\",\"link\":\"/administration/oauth\"},{\"text\":\"查询与导出操作审计\",\"link\":\"/administration/audit\"},{\"text\":\"社区版、企业 License 与冻结态\",\"link\":\"/administration/license\"}]},{\"text\":\"故障排查与参考\",\"items\":[{\"text\":\"从现象开始排查\",\"link\":\"/troubleshooting/quick-diagnosis\"},{\"text\":\"Node 注册失败或离线\",\"link\":\"/troubleshooting/node-offline\"},{\"text\":\"Workspace、文件或 Git 不可用\",\"link\":\"/troubleshooting/workspace-files\"},{\"text\":\"会话卡在 Working、Idle 或只读\",\"link\":\"/troubleshooting/session-run\"},{\"text\":\"终端无法打开或频繁断线\",\"link\":\"/troubleshooting/terminal\"},{\"text\":\"键盘快捷键\",\"link\":\"/reference/keyboard-shortcuts\"},{\"text\":\"状态、提示与常见错误\",\"link\":\"/reference/status-and-errors\"},{\"text\":\"配置项参考\",\"link\":\"/reference/configuration\"},{\"text\":\"端口、配置目录与数据位置\",\"link\":\"/reference/ports-paths-data\"},{\"text\":\"版本、容量与已知限制\",\"link\":\"/reference/limits\"}]}]}},\"locales\":{\"root\":{\"label\":\"简体中文\",\"lang\":\"zh-CN\"},\"en-US\":{\"label\":\"English\",\"lang\":\"en-US\",\"title\":\"MyAgentRoam Documentation\",\"description\":\"Deployment, configuration, and usage documentation for MyAgentRoam\",\"themeConfig\":{\"siteTitle\":\"Documentation\",\"langMenuLabel\":\"Switch language\",\"outline\":{\"label\":\"On This Page\",\"level\":[2,3]},\"returnToTopLabel\":\"Return to Top\",\"sidebarMenuLabel\":\"Menu\",\"darkModeSwitchLabel\":\"Appearance\",\"lightModeSwitchTitle\":\"Switch to Light Theme\",\"darkModeSwitchTitle\":\"Switch to Dark Theme\",\"docFooter\":{\"prev\":\"Previous\",\"next\":\"Next\"},\"search\":{\"provider\":\"local\",\"options\":{\"translations\":{\"button\":{\"buttonText\":\"Search Documentation\",\"buttonAriaLabel\":\"Search Documentation\"}}}}}}},\"scrollOffset\":134,\"cleanUrls\":true}");</script>
+    <script>window.__VP_HASH_MAP__=JSON.parse("{\"administration_account.md\":\"BDxiZLcI\",\"administration_audit.md\":\"CPGsRZCt\",\"administration_conversation-templates.md\":\"DR-Q8ZJH\",\"administration_email-notifications.md\":\"CcYZiN4h\",\"administration_license.md\":\"Bf1iyuKG\",\"administration_nodes-workspaces.md\":\"CMGc1EC3\",\"administration_oauth.md\":\"DVrr-ce3\",\"administration_secrets.md\":\"BVsK96Ny\",\"administration_template-workspace-maintenance.md\":\"ic3SEbkM\",\"administration_users-organizations.md\":\"CInTvyvp\",\"concepts_architecture.md\":\"CWYNi_YX\",\"concepts_data-and-security.md\":\"DvabQ2zO\",\"concepts_files-git-terminal.md\":\"DR-aSOLY\",\"concepts_node-and-workspace.md\":\"D4tWJ_5A\",\"concepts_permissions-and-sharing.md\":\"BGQlim_y\",\"concepts_runner-control.md\":\"Bkd1fXLk\",\"concepts_secrets.md\":\"DRt04t7A\",\"concepts_session-run-turn.md\":\"Crte1ZI0\",\"deployment_backup-restore.md\":\"fZtPK3bl\",\"deployment_network.md\":\"BarghfLt\",\"deployment_node-installation.md\":\"BhsVg-7E\",\"deployment_node-linux.md\":\"ayZjBc-g\",\"deployment_node-macos.md\":\"DRV9KDoO\",\"deployment_node-windows.md\":\"gpTo69VQ\",\"deployment_production.md\":\"83mdKwsb\",\"deployment_security-checklist.md\":\"CxWdJ9xO\",\"deployment_upgrade.md\":\"BESOToM5\",\"en-us_administration_account.md\":\"q4dfxq-Y\",\"en-us_administration_audit.md\":\"7tn6Eg6i\",\"en-us_administration_conversation-templates.md\":\"D7eekprK\",\"en-us_administration_email-notifications.md\":\"DvyUIBNy\",\"en-us_administration_license.md\":\"Dmg8rNEl\",\"en-us_administration_nodes-workspaces.md\":\"BOA5ixAC\",\"en-us_administration_oauth.md\":\"DwEfTIEs\",\"en-us_administration_secrets.md\":\"DOlPJy7O\",\"en-us_administration_template-workspace-maintenance.md\":\"B1Dys0Xw\",\"en-us_administration_users-organizations.md\":\"CkX2sOqa\",\"en-us_concepts_architecture.md\":\"DUoUKxu0\",\"en-us_concepts_data-and-security.md\":\"DpXrCSPO\",\"en-us_concepts_files-git-terminal.md\":\"BK81hAoC\",\"en-us_concepts_node-and-workspace.md\":\"Bm7rEIAI\",\"en-us_concepts_permissions-and-sharing.md\":\"DiEopkbD\",\"en-us_concepts_runner-control.md\":\"CcrdYOTx\",\"en-us_concepts_secrets.md\":\"CPhBggXB\",\"en-us_concepts_session-run-turn.md\":\"CIfewRkn\",\"en-us_deployment_backup-restore.md\":\"DQUtQ5Yt\",\"en-us_deployment_network.md\":\"DdOgOLns\",\"en-us_deployment_node-installation.md\":\"DDQ4RdWI\",\"en-us_deployment_node-linux.md\":\"BXhYZ6de\",\"en-us_deployment_node-macos.md\":\"D26h7wJ1\",\"en-us_deployment_node-windows.md\":\"Bp-sytL8\",\"en-us_deployment_production.md\":\"Drc4IHoD\",\"en-us_deployment_security-checklist.md\":\"Dh3cWem6\",\"en-us_deployment_upgrade.md\":\"DZiDDiLn\",\"en-us_getting-started_connect-node.md\":\"DKLHaKuL\",\"en-us_getting-started_first-agent-session.md\":\"CN2rWPq7\",\"en-us_getting-started_first-login.md\":\"DQnGKeN2\",\"en-us_getting-started_next-steps.md\":\"D2UXmW2q\",\"en-us_getting-started_npm-quick-start.md\":\"Dwsi-ffA\",\"en-us_getting-started_overview.md\":\"Bug5sh21\",\"en-us_getting-started_prerequisites.md\":\"Bpx_AQD1\",\"en-us_getting-started_register-workspace.md\":\"D3j75IC2\",\"en-us_getting-started_server-installation.md\":\"_k2XGM85\",\"en-us_operations_marctl.md\":\"CJYpPahB\",\"en-us_reference_configuration.md\":\"Ca2_G45i\",\"en-us_reference_keyboard-shortcuts.md\":\"BHIlAzih\",\"en-us_reference_limits.md\":\"BQahQvRI\",\"en-us_reference_ports-paths-data.md\":\"DckuEN9-\",\"en-us_reference_status-and-errors.md\":\"cq1A6JOM\",\"en-us_runners_claude-code.md\":\"BZp77nTJ\",\"en-us_runners_codex.md\":\"C8aQ3lj4\",\"en-us_runners_mar-agent.md\":\"DjryPiTL\",\"en-us_runners_opencode.md\":\"DAnPpdjG\",\"en-us_runners_overview.md\":\"n8off-KX\",\"en-us_runners_runner-troubleshooting.md\":\"BvJ6yGrw\",\"en-us_troubleshooting_node-offline.md\":\"BS2cHLeq\",\"en-us_troubleshooting_quick-diagnosis.md\":\"CPWX9djq\",\"en-us_troubleshooting_session-run.md\":\"o9ty9dWk\",\"en-us_troubleshooting_terminal.md\":\"Ce3H_Cq3\",\"en-us_troubleshooting_workspace-files.md\":\"I66m4D0K\",\"en-us_workbench_composer.md\":\"CCnbitB3\",\"en-us_workbench_context-and-plan.md\":\"E9yFtLaR\",\"en-us_workbench_conversation.md\":\"DWFI4rSa\",\"en-us_workbench_file-reference-and-attachment.md\":\"Xzbr8MRS\",\"en-us_workbench_files.md\":\"C5byBZOZ\",\"en-us_workbench_git-changes.md\":\"CgzmFd8l\",\"en-us_workbench_git-history.md\":\"CcKXv4NB\",\"en-us_workbench_hosted-conversations.md\":\"hxgo3oRa\",\"en-us_workbench_mobile.md\":\"C3A2Sq-s\",\"en-us_workbench_navigation.md\":\"BXLJsQMY\",\"en-us_workbench_sessions.md\":\"tSnti1TK\",\"en-us_workbench_skills.md\":\"xchi27R9\",\"en-us_workbench_terminal.md\":\"B23OFnB3\",\"getting-started_connect-node.md\":\"B9kKn-7y\",\"getting-started_first-agent-session.md\":\"D-uls92b\",\"getting-started_first-login.md\":\"DVWDKgMU\",\"getting-started_next-steps.md\":\"CjwJgSAt\",\"getting-started_npm-quick-start.md\":\"CcxMwUgz\",\"getting-started_overview.md\":\"CA1CCOBc\",\"getting-started_prerequisites.md\":\"D26KU42D\",\"getting-started_register-workspace.md\":\"BW-xjHjl\",\"getting-started_server-installation.md\":\"D3P3Lmc2\",\"operations_marctl.md\":\"BW9barpn\",\"reference_configuration.md\":\"CvHKh-kv\",\"reference_keyboard-shortcuts.md\":\"DOivSxmM\",\"reference_limits.md\":\"17DNV05j\",\"reference_ports-paths-data.md\":\"RqYAhrgF\",\"reference_status-and-errors.md\":\"BwpSR6nH\",\"runners_claude-code.md\":\"DSGRX72-\",\"runners_codex.md\":\"CDGNsFMp\",\"runners_mar-agent.md\":\"DjuqySh9\",\"runners_opencode.md\":\"DSvXW8Sv\",\"runners_overview.md\":\"CHK7UvIl\",\"runners_runner-troubleshooting.md\":\"CIWCfGkf\",\"troubleshooting_node-offline.md\":\"BQ-5_Xyu\",\"troubleshooting_quick-diagnosis.md\":\"fq0U5Cg7\",\"troubleshooting_session-run.md\":\"Cny0YwSq\",\"troubleshooting_terminal.md\":\"DB0zc8sK\",\"troubleshooting_workspace-files.md\":\"BEFLZu54\",\"workbench_composer.md\":\"DlU35VaN\",\"workbench_context-and-plan.md\":\"CzRACFjQ\",\"workbench_conversation.md\":\"Ib2W7CCX\",\"workbench_file-reference-and-attachment.md\":\"CSLMm-nL\",\"workbench_files.md\":\"B5xE7YGc\",\"workbench_git-changes.md\":\"C7xvpMwy\",\"workbench_git-history.md\":\"Ckvhp8Y3\",\"workbench_hosted-conversations.md\":\"C0YVmf0T\",\"workbench_mobile.md\":\"3NSNZGu8\",\"workbench_navigation.md\":\"B8UD4qpB\",\"workbench_sessions.md\":\"DHPI_apA\",\"workbench_skills.md\":\"BQw1Wuiy\",\"workbench_terminal.md\":\"YzgZvVcu\"}");window.__VP_SITE_DATA__=JSON.parse("{\"lang\":\"zh-CN\",\"dir\":\"ltr\",\"title\":\"MyAgentRoam Documentation\",\"description\":\"MyAgentRoam 部署、配置与使用文档\",\"base\":\"/docs/\",\"head\":[],\"router\":{\"prefetchLinks\":true},\"appearance\":true,\"themeConfig\":{\"logo\":\"/logo.png?v=logo-20261011\",\"logoLink\":\"/\",\"siteTitle\":\"Documentation\",\"langMenuLabel\":\"切换语言\",\"outline\":{\"label\":\"本页内容\",\"level\":[2,3]},\"returnToTopLabel\":\"返回顶部\",\"sidebarMenuLabel\":\"文档目录\",\"darkModeSwitchLabel\":\"外观\",\"lightModeSwitchTitle\":\"切换至浅色模式\",\"darkModeSwitchTitle\":\"切换至深色模式\",\"docFooter\":{\"prev\":\"上一篇\",\"next\":\"下一篇\"},\"search\":{\"provider\":\"local\",\"options\":{\"translations\":{\"button\":{\"buttonText\":\"搜索文档\",\"buttonAriaLabel\":\"搜索文档\"}}}},\"sidebar\":{\"/en-US/\":[{\"text\":\"Getting Started\",\"items\":[{\"text\":\"What Is MyAgentRoam?\",\"link\":\"/en-US/getting-started/overview\"},{\"text\":\"Local npm Quick Start\",\"link\":\"/en-US/getting-started/npm-quick-start\"},{\"text\":\"Before You Deploy\",\"link\":\"/en-US/getting-started/prerequisites\"},{\"text\":\"Deploy Server and Web\",\"link\":\"/en-US/getting-started/server-installation\"},{\"text\":\"First Sign-in and Password Change\",\"link\":\"/en-US/getting-started/first-login\"},{\"text\":\"Connect Your First Node\",\"link\":\"/en-US/getting-started/connect-node\"},{\"text\":\"Register Your First Workspace\",\"link\":\"/en-US/getting-started/register-workspace\"},{\"text\":\"Start Your First Agent Session\",\"link\":\"/en-US/getting-started/first-agent-session\"},{\"text\":\"Next Steps\",\"link\":\"/en-US/getting-started/next-steps\"}]},{\"text\":\"Core Concepts\",\"items\":[{\"text\":\"Server, Node, Web, and Runner\",\"link\":\"/en-US/concepts/architecture\"},{\"text\":\"Nodes and Workspaces\",\"link\":\"/en-US/concepts/node-and-workspace\"},{\"text\":\"Sessions, Runs, and Message Queues\",\"link\":\"/en-US/concepts/session-run-turn\"},{\"text\":\"Runners and Session Control\",\"link\":\"/en-US/concepts/runner-control\"},{\"text\":\"Files, Git, and Terminals\",\"link\":\"/en-US/concepts/files-git-terminal\"},{\"text\":\"Users, Organizations, and Access\",\"link\":\"/en-US/concepts/permissions-and-sharing\"},{\"text\":\"Secrets and Injection Order\",\"link\":\"/en-US/concepts/secrets\"},{\"text\":\"Data, Credentials, and Security\",\"link\":\"/en-US/concepts/data-and-security\"}]},{\"text\":\"Work / Conversation Guide\",\"items\":[{\"text\":\"Work Mode, Nodes, and Workspaces\",\"link\":\"/en-US/workbench/navigation\"},{\"text\":\"Favorite and Install Skills\",\"link\":\"/en-US/workbench/skills\"},{\"text\":\"Create and Manage Sessions\",\"link\":\"/en-US/workbench/sessions\"},{\"text\":\"Messages and Composer\",\"link\":\"/en-US/workbench/composer\"},{\"text\":\"Context, Compact, and Plan\",\"link\":\"/en-US/workbench/context-and-plan\"},{\"text\":\"References, Folders, and Attachments\",\"link\":\"/en-US/workbench/file-reference-and-attachment\"},{\"text\":\"Conversations, Tools, and Notifications\",\"link\":\"/en-US/workbench/conversation\"},{\"text\":\"Start a Template Conversation in Conversation Mode\",\"link\":\"/en-US/workbench/hosted-conversations\"},{\"text\":\"Browse, Search, and Manage Files\",\"link\":\"/en-US/workbench/files\"},{\"text\":\"Git Changes and Diff\",\"link\":\"/en-US/workbench/git-changes\"},{\"text\":\"Git History\",\"link\":\"/en-US/workbench/git-history\"},{\"text\":\"Workspace Terminals\",\"link\":\"/en-US/workbench/terminal\"},{\"text\":\"Continue on Mobile\",\"link\":\"/en-US/workbench/mobile\"}]},{\"text\":\"Agent Guide\",\"items\":[{\"text\":\"Choose an Agent\",\"link\":\"/en-US/runners/overview\"},{\"text\":\"OpenCode\",\"link\":\"/en-US/runners/opencode\"},{\"text\":\"Codex\",\"link\":\"/en-US/runners/codex\"},{\"text\":\"Claude Code\",\"link\":\"/en-US/runners/claude-code\"},{\"text\":\"Built-in MAR Agent\",\"link\":\"/en-US/runners/mar-agent\"},{\"text\":\"Runner Troubleshooting\",\"link\":\"/en-US/runners/runner-troubleshooting\"}]},{\"text\":\"Deployment and Operations\",\"items\":[{\"text\":\"Production Deployment and Reverse Proxy\",\"link\":\"/en-US/deployment/production\"},{\"text\":\"Install and Register a Node\",\"link\":\"/en-US/deployment/node-installation\"},{\"text\":\"Linux Node and systemd\",\"link\":\"/en-US/deployment/node-linux\"},{\"text\":\"Windows Node and Task Scheduler\",\"link\":\"/en-US/deployment/node-windows\"},{\"text\":\"macOS Node and launchd\",\"link\":\"/en-US/deployment/node-macos\"},{\"text\":\"Upgrade MyAgentRoam\",\"link\":\"/en-US/deployment/upgrade\"},{\"text\":\"Backup and Restore\",\"link\":\"/en-US/deployment/backup-restore\"},{\"text\":\"Network, TLS, and WebSocket\",\"link\":\"/en-US/deployment/network\"},{\"text\":\"Production Security Checklist\",\"link\":\"/en-US/deployment/security-checklist\"}]},{\"text\":\"Node Operations Tools\",\"items\":[{\"text\":\"Manage Nodes with marctl\",\"link\":\"/en-US/operations/marctl\"}]},{\"text\":\"Administration Guide\",\"items\":[{\"text\":\"Account Security and Sign-in Sessions\",\"link\":\"/en-US/administration/account\"},{\"text\":\"Manage Nodes and Workspaces\",\"link\":\"/en-US/administration/nodes-workspaces\"},{\"text\":\"Manage Conversation Templates\",\"link\":\"/en-US/administration/conversation-templates\"},{\"text\":\"Maintain a Conversation Template Workspace\",\"link\":\"/en-US/administration/template-workspace-maintenance\"},{\"text\":\"Manage Secrets\",\"link\":\"/en-US/administration/secrets\"},{\"text\":\"Configure SMTP Email and Notification Templates\",\"link\":\"/en-US/administration/email-notifications\"},{\"text\":\"Manage Users, Organizations, and Roles\",\"link\":\"/en-US/administration/users-organizations\"},{\"text\":\"Configure OAuth 2.0 SSO\",\"link\":\"/en-US/administration/oauth\"},{\"text\":\"Audit Events and Export\",\"link\":\"/en-US/administration/audit\"},{\"text\":\"Personal and Enterprise Licenses\",\"link\":\"/en-US/administration/license\"}]},{\"text\":\"Troubleshooting and Reference\",\"items\":[{\"text\":\"Quick Diagnosis\",\"link\":\"/en-US/troubleshooting/quick-diagnosis\"},{\"text\":\"Node Registration or Offline Issues\",\"link\":\"/en-US/troubleshooting/node-offline\"},{\"text\":\"Workspace, File, or Git Issues\",\"link\":\"/en-US/troubleshooting/workspace-files\"},{\"text\":\"Session Stuck or Read-only\",\"link\":\"/en-US/troubleshooting/session-run\"},{\"text\":\"Terminal Connection Issues\",\"link\":\"/en-US/troubleshooting/terminal\"},{\"text\":\"Keyboard Shortcuts\",\"link\":\"/en-US/reference/keyboard-shortcuts\"},{\"text\":\"Statuses and Common Errors\",\"link\":\"/en-US/reference/status-and-errors\"},{\"text\":\"Configuration Reference\",\"link\":\"/en-US/reference/configuration\"},{\"text\":\"Ports, Paths, and Data\",\"link\":\"/en-US/reference/ports-paths-data\"},{\"text\":\"Versions, Capacity, and Limits\",\"link\":\"/en-US/reference/limits\"}]}],\"/\":[{\"text\":\"开始使用\",\"items\":[{\"text\":\"MyAgentRoam 是什么\",\"link\":\"/getting-started/overview\"},{\"text\":\"本机 npm 快速开始\",\"link\":\"/getting-started/npm-quick-start\"},{\"text\":\"部署前准备\",\"link\":\"/getting-started/prerequisites\"},{\"text\":\"部署 Server 与 Web\",\"link\":\"/getting-started/server-installation\"},{\"text\":\"首次登录与修改密码\",\"link\":\"/getting-started/first-login\"},{\"text\":\"接入第一台 Node\",\"link\":\"/getting-started/connect-node\"},{\"text\":\"登记第一个 Workspace\",\"link\":\"/getting-started/register-workspace\"},{\"text\":\"开始第一次 Agent 对话\",\"link\":\"/getting-started/first-agent-session\"},{\"text\":\"接下来可以做什么\",\"link\":\"/getting-started/next-steps\"}]},{\"text\":\"核心概念\",\"items\":[{\"text\":\"Server、Node、Web 与 Runner\",\"link\":\"/concepts/architecture\"},{\"text\":\"Node 与 Workspace\",\"link\":\"/concepts/node-and-workspace\"},{\"text\":\"会话、运行与消息队列\",\"link\":\"/concepts/session-run-turn\"},{\"text\":\"Runner 与会话控制状态\",\"link\":\"/concepts/runner-control\"},{\"text\":\"文件、Git 与终端\",\"link\":\"/concepts/files-git-terminal\"},{\"text\":\"用户、组织与资源权限\",\"link\":\"/concepts/permissions-and-sharing\"},{\"text\":\"环境变量密钥与注入顺序\",\"link\":\"/concepts/secrets\"},{\"text\":\"数据归属、凭据与安全边界\",\"link\":\"/concepts/data-and-security\"}]},{\"text\":\"工作 / 对话使用指南\",\"items\":[{\"text\":\"工作模式、Node 与 Workspace\",\"link\":\"/workbench/navigation\"},{\"text\":\"收藏与安装 Skill\",\"link\":\"/workbench/skills\"},{\"text\":\"创建、查找与管理会话\",\"link\":\"/workbench/sessions\"},{\"text\":\"发送消息与使用 Composer\",\"link\":\"/workbench/composer\"},{\"text\":\"上下文用量、Compact 与 Plan\",\"link\":\"/workbench/context-and-plan\"},{\"text\":\"@ 引用、文件夹与附件\",\"link\":\"/workbench/file-reference-and-attachment\"},{\"text\":\"阅读对话、工具调用与通知\",\"link\":\"/workbench/conversation\"},{\"text\":\"在对话模式从模板新建对话\",\"link\":\"/workbench/hosted-conversations\"},{\"text\":\"浏览、搜索与管理文件\",\"link\":\"/workbench/files\"},{\"text\":\"查看 Git Changes 与 Diff\",\"link\":\"/workbench/git-changes\"},{\"text\":\"查看 Git 历史\",\"link\":\"/workbench/git-history\"},{\"text\":\"使用 Workspace 终端\",\"link\":\"/workbench/terminal\"},{\"text\":\"在移动端继续工作\",\"link\":\"/workbench/mobile\"}]},{\"text\":\"Agent 指南\",\"items\":[{\"text\":\"选择 Agent\",\"link\":\"/runners/overview\"},{\"text\":\"安装、配置和使用 OpenCode\",\"link\":\"/runners/opencode\"},{\"text\":\"安装、配置和使用 Codex\",\"link\":\"/runners/codex\"},{\"text\":\"安装、配置和使用 Claude Code\",\"link\":\"/runners/claude-code\"},{\"text\":\"配置和使用内置 MAR Agent\",\"link\":\"/runners/mar-agent\"},{\"text\":\"Agent 不可用或模型缺失\",\"link\":\"/runners/runner-troubleshooting\"}]},{\"text\":\"部署与运维\",\"items\":[{\"text\":\"生产部署与反向代理\",\"link\":\"/deployment/production\"},{\"text\":\"安装与注册 Node\",\"link\":\"/deployment/node-installation\"},{\"text\":\"Linux Node 与 systemd\",\"link\":\"/deployment/node-linux\"},{\"text\":\"Windows Node 与任务计划\",\"link\":\"/deployment/node-windows\"},{\"text\":\"macOS Node 与 launchd\",\"link\":\"/deployment/node-macos\"},{\"text\":\"升级 MyAgentRoam\",\"link\":\"/deployment/upgrade\"},{\"text\":\"备份与恢复\",\"link\":\"/deployment/backup-restore\"},{\"text\":\"网络、TLS 与 WebSocket\",\"link\":\"/deployment/network\"},{\"text\":\"上线安全检查清单\",\"link\":\"/deployment/security-checklist\"}]},{\"text\":\"节点运维工具\",\"items\":[{\"text\":\"使用 marctl 管理节点\",\"link\":\"/operations/marctl\"}]},{\"text\":\"管理指南\",\"items\":[{\"text\":\"账户安全与登录会话\",\"link\":\"/administration/account\"},{\"text\":\"管理 Node 与 Workspace\",\"link\":\"/administration/nodes-workspaces\"},{\"text\":\"管理对话模板\",\"link\":\"/administration/conversation-templates\"},{\"text\":\"维护对话模板 Workspace\",\"link\":\"/administration/template-workspace-maintenance\"},{\"text\":\"管理环境变量密钥\",\"link\":\"/administration/secrets\"},{\"text\":\"配置 SMTP 邮件与通知模板\",\"link\":\"/administration/email-notifications\"},{\"text\":\"管理用户、组织与角色\",\"link\":\"/administration/users-organizations\"},{\"text\":\"配置 OAuth 2.0 SSO\",\"link\":\"/administration/oauth\"},{\"text\":\"查询与导出操作审计\",\"link\":\"/administration/audit\"},{\"text\":\"社区版、企业 License 与冻结态\",\"link\":\"/administration/license\"}]},{\"text\":\"故障排查与参考\",\"items\":[{\"text\":\"从现象开始排查\",\"link\":\"/troubleshooting/quick-diagnosis\"},{\"text\":\"Node 注册失败或离线\",\"link\":\"/troubleshooting/node-offline\"},{\"text\":\"Workspace、文件或 Git 不可用\",\"link\":\"/troubleshooting/workspace-files\"},{\"text\":\"会话卡在 Working、Idle 或只读\",\"link\":\"/troubleshooting/session-run\"},{\"text\":\"终端无法打开或频繁断线\",\"link\":\"/troubleshooting/terminal\"},{\"text\":\"键盘快捷键\",\"link\":\"/reference/keyboard-shortcuts\"},{\"text\":\"状态、提示与常见错误\",\"link\":\"/reference/status-and-errors\"},{\"text\":\"配置项参考\",\"link\":\"/reference/configuration\"},{\"text\":\"端口、配置目录与数据位置\",\"link\":\"/reference/ports-paths-data\"},{\"text\":\"版本、容量与已知限制\",\"link\":\"/reference/limits\"}]}]}},\"locales\":{\"root\":{\"label\":\"简体中文\",\"lang\":\"zh-CN\"},\"en-US\":{\"label\":\"English\",\"lang\":\"en-US\",\"title\":\"MyAgentRoam Documentation\",\"description\":\"Deployment, configuration, and usage documentation for MyAgentRoam\",\"themeConfig\":{\"siteTitle\":\"Documentation\",\"langMenuLabel\":\"Switch language\",\"outline\":{\"label\":\"On This Page\",\"level\":[2,3]},\"returnToTopLabel\":\"Return to Top\",\"sidebarMenuLabel\":\"Menu\",\"darkModeSwitchLabel\":\"Appearance\",\"lightModeSwitchTitle\":\"Switch to Light Theme\",\"darkModeSwitchTitle\":\"Switch to Dark Theme\",\"docFooter\":{\"prev\":\"Previous\",\"next\":\"Next\"},\"search\":{\"provider\":\"local\",\"options\":{\"translations\":{\"button\":{\"buttonText\":\"Search Documentation\",\"buttonAriaLabel\":\"Search Documentation\"}}}}}}},\"scrollOffset\":134,\"cleanUrls\":true}");</script>
   </body>
 </html>