@myagentroam/server 0.13.6 → 0.13.8

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 (409) hide show
  1. package/node_modules/@myagentroam/protocol/dist/composer-tags.d.ts +431 -5
  2. package/node_modules/@myagentroam/protocol/dist/composer-tags.js +88 -5
  3. package/node_modules/@myagentroam/protocol/dist/direct-transfer.d.ts +52 -52
  4. package/node_modules/@myagentroam/protocol/dist/index.d.ts +1692 -1684
  5. package/node_modules/@myagentroam/protocol/dist/index.js +2 -0
  6. package/node_modules/@myagentroam/protocol/dist/mcp.d.ts +6 -6
  7. package/node_modules/@myagentroam/protocol/dist/model-usage.d.ts +12 -12
  8. package/node_modules/@myagentroam/protocol/dist/session-shares.d.ts +6 -6
  9. package/node_modules/@myagentroam/protocol/dist/skill.d.ts +2 -2
  10. package/node_modules/@myagentroam/protocol/dist/workbench-notification.d.ts +6 -6
  11. package/node_modules/@myagentroam/protocol/package.json +1 -1
  12. package/node_modules/@myagentroam/server-core/dist/model-usage-record.d.ts +1 -1
  13. package/node_modules/@myagentroam/server-core/dist/workbench-notification-service.d.ts +1 -1
  14. package/node_modules/@myagentroam/server-core/package.json +2 -2
  15. package/node_modules/@myagentroam-enterprise/server-implementation/package.json +3 -3
  16. package/package.json +6 -6
  17. package/web/assets/{AuditManagementPage-DdhzZJJz.js → AuditManagementPage-DHf_d3lr.js} +1 -1
  18. package/web/assets/{BusyIndicator-DJEYrwl2.js → BusyIndicator-CJepRD30.js} +1 -1
  19. package/web/assets/{CodeFileEditor-t-S2RxFj.js → CodeFileEditor-2B9V-ZHh.js} +14 -14
  20. package/web/assets/{CodeFileEditor-LbH8kxiW.css → CodeFileEditor-B8IGF27H.css} +1 -1
  21. package/web/assets/{ConversationTemplateManagementPage-DtnCxKPr.js → ConversationTemplateManagementPage-C2Fl5gpu.js} +1 -1
  22. package/web/assets/{ConversationTemplateManagementPage-8cWdT1rl.js → ConversationTemplateManagementPage-DhjVzYYH.js} +1 -1
  23. package/web/assets/{EnterpriseUserManagementPage-CVpJzsVL.js → EnterpriseUserManagementPage-D7UBm6rn.js} +1 -1
  24. package/web/assets/{EnvironmentSecretManager-DaMtII6x.js → EnvironmentSecretManager-6TsEyKME.js} +1 -1
  25. package/web/assets/{FilePreviewLoading-CqXCVUDH.js → FilePreviewLoading-xWmLA-hX.js} +2 -2
  26. package/web/assets/HtmlPreviewFrame-BWUJugCe.js +7 -0
  27. package/web/assets/{HtmlPreviewFrame-CXd4x0y-.css → HtmlPreviewFrame-D_Jf4aL-.css} +1 -1
  28. package/web/assets/{LicenseManagementPage-C-25sen8.js → LicenseManagementPage-mbLC76Sb.js} +1 -1
  29. package/web/assets/{ManagementPagination-BwZo73aV.js → ManagementPagination-COGUI_6N.js} +1 -1
  30. package/web/assets/{MarAgentModelManagementPage-DkncBptD.js → MarAgentModelManagementPage-C0NTB_eR.js} +1 -1
  31. package/web/assets/{MarAgentModelManagementPage-B9lHTQtV.js → MarAgentModelManagementPage-D_LEBwAO.js} +1 -1
  32. package/web/assets/{MarIcon-0cJTzTai.js → MarIcon-7ATHlb9_.js} +1 -1
  33. package/web/assets/{MarkdownFilePreview-CnWvYfKN.js → MarkdownFilePreview-CGEzm91C.js} +2 -2
  34. package/web/assets/{McpDetailsDialog-nt3by9E1.js → McpDetailsDialog-DKlmenK5.js} +1 -1
  35. package/web/assets/{McpSourceManagementPage-Bg2wxoSB.js → McpSourceManagementPage-BRSoTQJy.js} +1 -1
  36. package/web/assets/{McpSourceManagementPage-BVjVO0Tb.js → McpSourceManagementPage-DXrw10o-.js} +1 -1
  37. package/web/assets/{NodeDetailsDialogs-D4wBwUzA.js → NodeDetailsDialogs-BXghz6Vq.js} +1 -1
  38. package/web/assets/NodeManagementPage-B6sbUg2M.js +1 -0
  39. package/web/assets/NodeManagementPage-BywB3ak3.js +1 -0
  40. package/web/assets/{OAuthManagementPage-D9cBB-vX.js → OAuthManagementPage-BzDB8DRk.js} +1 -1
  41. package/web/assets/{OrganizationManagementPage-N8HwbTY5.js → OrganizationManagementPage-DIKK7Apz.js} +1 -1
  42. package/web/assets/{ResourceManagementPanel-D80V3ZdZ.js → ResourceManagementPanel-CAAVs5tS.js} +1 -1
  43. package/web/assets/{ResourceManagementPanel.vue_vue_type_script_setup_true_lang-DfCWa6fA.js → ResourceManagementPanel.vue_vue_type_script_setup_true_lang-SibtEfaZ.js} +1 -1
  44. package/web/assets/SecretManagementPage-BoxMy2kF.js +1 -0
  45. package/web/assets/{SecretManagementPage-tsgbjSvn.js → SecretManagementPage-NWQ8ilK9.js} +1 -1
  46. package/web/assets/{SecretManagementPage.vue_vue_type_script_setup_true_lang-CmSoYQ3n.js → SecretManagementPage.vue_vue_type_script_setup_true_lang-Dv-Lkrgj.js} +1 -1
  47. package/web/assets/SessionSharePage-B9Ig9miU.css +1 -0
  48. package/web/assets/SessionSharePage-PXCto604.js +2 -0
  49. package/web/assets/{SettingsContent-WLH3DkgW.js → SettingsContent-lmlrCtzr.js} +1 -1
  50. package/web/assets/{SettingsContent-Dsw7sGr4.js → SettingsContent-t4Hhk6bN.js} +1 -1
  51. package/web/assets/{SkillCenterPage-yDU-t2cT.js → SkillCenterPage-BGdx7_t-.js} +1 -1
  52. package/web/assets/SkillCenterPage-yUFJvXBZ.js +1 -0
  53. package/web/assets/{SkillDetailsDialog-BUfNxAjf.js → SkillDetailsDialog-Ck3sWYTZ.js} +1 -1
  54. package/web/assets/{SkillSourceManagementPage-BCHgTDXJ.js → SkillSourceManagementPage-DCzjgChL.js} +1 -1
  55. package/web/assets/{SkillSourceManagementPage-B7yjgXR8.js → SkillSourceManagementPage-MfPC03pb.js} +1 -1
  56. package/web/assets/{StandaloneFilePreviewPage-DRGcF74V.css → StandaloneFilePreviewPage-Bv_3Hwts.css} +1 -1
  57. package/web/assets/StandaloneFilePreviewPage-Bzrh7-zx.js +1 -0
  58. package/web/assets/SystemConfigurationPage-0EO7rEmk.js +1 -0
  59. package/web/assets/{SystemConfigurationPage-C2Ecb0Su.js → SystemConfigurationPage-C8ekLRUo.js} +1 -1
  60. package/web/assets/{SystemInformationPage-CBWjqG43.js → SystemInformationPage-O2QdJcSO.js} +1 -1
  61. package/web/assets/{TerminalTabView-CeX2SVcm.js → TerminalTabView-DvEnQt4Q.js} +1 -1
  62. package/web/assets/WorkbenchPage-BuXwAqL9.css +1 -0
  63. package/web/assets/WorkbenchPage-C03cutMf.js +22 -0
  64. package/web/assets/WorkspaceManagementPage-DeDYwU3j.js +1 -0
  65. package/web/assets/WorkspaceManagementPage-Ijsn-mPC.js +1 -0
  66. package/web/assets/{_baseIteratee-CnCgfzqY.js → _baseIteratee-eYBSuzub.js} +1 -1
  67. package/web/assets/{abnfDiagram-VCTEODGH-C8MLlCYr.js → abnfDiagram-VCTEODGH-b26cs6fq.js} +1 -1
  68. package/web/assets/{advancedFormat-tqE8I04X.js → advancedFormat-CSQIetpu.js} +1 -1
  69. package/web/assets/{arc-ChGPMlfM.js → arc-0gq-FCD-.js} +1 -1
  70. package/web/assets/{architectureDiagram-5GKGNRK7-UNKWS80q.js → architectureDiagram-5GKGNRK7-BkGnMYjk.js} +1 -1
  71. package/web/assets/{blockDiagram-OSKFZWR5-DaoKTWzi.js → blockDiagram-OSKFZWR5-Cxoqg89Y.js} +1 -1
  72. package/web/assets/{c4Diagram-7LVT6UL2-DeJ38tJ4.js → c4Diagram-7LVT6UL2-CAdK6Y96.js} +1 -1
  73. package/web/assets/{catalog-ownership-service-ppl9SdO8.js → catalog-ownership-service-PJaj-KyM.js} +1 -1
  74. package/web/assets/{catalog-page-service-CA6TP1Er.js → catalog-page-service-YyYk6Ggw.js} +1 -1
  75. package/web/assets/channel-C8Lmpt34.js +1 -0
  76. package/web/assets/{chunk-2Q5K7J3B-Cie4-T_4.js → chunk-2Q5K7J3B-BOp-yla_.js} +1 -1
  77. package/web/assets/{chunk-5VM5RSS4-C02e2HuJ.js → chunk-5VM5RSS4-BuyWVwKe.js} +1 -1
  78. package/web/assets/{chunk-F27PBJKO-CYE4axjh.js → chunk-F27PBJKO-Cx18VPfs.js} +1 -1
  79. package/web/assets/{chunk-HLEWEB6X-Qcd3DJvW.js → chunk-HLEWEB6X-C5g9_TfO.js} +1 -1
  80. package/web/assets/{chunk-JWPE2WC7-BIlv53mX.js → chunk-JWPE2WC7-Rjhz-D2X.js} +1 -1
  81. package/web/assets/{chunk-POPQ4Y6H-C1FzI22y.js → chunk-POPQ4Y6H--VZI-f_3.js} +1 -1
  82. package/web/assets/{chunk-SVP7TREG-B5A4JoXo.js → chunk-SVP7TREG-BEjnZUJI.js} +1 -1
  83. package/web/assets/{chunk-XXDRQBXY-FdosaHEW.js → chunk-XXDRQBXY-CKr0cjux.js} +1 -1
  84. package/web/assets/{chunk-ZLD2IHE6-BzhAoouo.js → chunk-ZLD2IHE6-L7hK5KvT.js} +1 -1
  85. package/web/assets/classDiagram-CYGNFDIV-DKDqMZKD.js +1 -0
  86. package/web/assets/classDiagram-v2-TLXNO2FR-DKDqMZKD.js +1 -0
  87. package/web/assets/{conversation-history-D9993EDO.js → conversation-history-Crx4ncHc.js} +1 -1
  88. package/web/assets/{cose-bilkent-JH36ORCC-C4ZjK8dC.js → cose-bilkent-JH36ORCC-CRvOV0K8.js} +1 -1
  89. package/web/assets/{cynefin-OW5HDTMX-D-6QhPjX.js → cynefin-OW5HDTMX-CF1dNtGE.js} +1 -1
  90. package/web/assets/{cynefinDiagram-5FMLGOSQ-Bwsk5LdU.js → cynefinDiagram-5FMLGOSQ-Dw7WCbhJ.js} +1 -1
  91. package/web/assets/{dagre-OS7QT2EB-DoA_-lbd.js → dagre-OS7QT2EB-DDQAautM.js} +1 -1
  92. package/web/assets/{diagram-S7CK7UJ4-sgObxZyi.js → diagram-S7CK7UJ4-CV9I70h1.js} +1 -1
  93. package/web/assets/{diagram-UQ7AKVKN-BdMjAaVk.js → diagram-UQ7AKVKN-C5yw9_lD.js} +1 -1
  94. package/web/assets/{diagram-VSXAHHWV-BCH9zwo1.js → diagram-VSXAHHWV-BEyCZDi6.js} +1 -1
  95. package/web/assets/{diagram-VX7I27RA-Z6LSJKeQ.js → diagram-VX7I27RA-4KzLfGxp.js} +1 -1
  96. package/web/assets/{diagram-Z3DM3KII-CcbM5hsL.js → diagram-Z3DM3KII-CaRUqcJa.js} +1 -1
  97. package/web/assets/{ebnfDiagram-PWID7BFC-CWP32uDq.js → ebnfDiagram-PWID7BFC-7yDVGhmX.js} +1 -1
  98. package/web/assets/{el-alert-8VKFJYUv.js → el-alert-DQS8ZePt.js} +1 -1
  99. package/web/assets/{el-cascader-CJR-DJLi.js → el-cascader-DQU5md40.js} +1 -1
  100. package/web/assets/{el-checkbox-D7CsqiQq.js → el-checkbox-D0efHW4S.js} +1 -1
  101. package/web/assets/{el-date-picker-Lb4E2Nje.js → el-date-picker-Bku-3B7K.js} +1 -1
  102. package/web/assets/{el-descriptions-B48GJeGA.js → el-descriptions-CBHVTmYh.js} +1 -1
  103. package/web/assets/{el-form-item-Fjp3w344.js → el-form-item-Dq_bK-Q9.js} +1 -1
  104. package/web/assets/{el-input-DRF3bOe1.js → el-input-C5zWHdoA.js} +1 -1
  105. package/web/assets/{el-input-number-e6T9QIje.js → el-input-number-BJUCiZru.js} +1 -1
  106. package/web/assets/{el-radio-DO8joult.js → el-radio-DKbfSkAS.js} +1 -1
  107. package/web/assets/{el-select-BSaB1c5h.js → el-select-pINM-mXh.js} +1 -1
  108. package/web/assets/{el-switch-Cpl2xxJc.js → el-switch-BBMCqiRH.js} +1 -1
  109. package/web/assets/{el-tab-pane-CQyfpTgD.js → el-tab-pane-y4NQADY5.js} +1 -1
  110. package/web/assets/{el-table-column-BRybrdLI.js → el-table-column-BcasE3gG.js} +1 -1
  111. package/web/assets/{enterprise-management-service-Qtmnf50C.js → enterprise-management-service-B0orfFAW.js} +1 -1
  112. package/web/assets/{erDiagram-2YWLMYGG-BOtd6Wuq.js → erDiagram-2YWLMYGG-o6dRiWdB.js} +1 -1
  113. package/web/assets/{error-presentation-CJfLHEK_.js → error-presentation-uG_Pz-4V.js} +1 -1
  114. package/web/assets/{flowDiagram-T62WH6J4-DGRqBn-8.js → flowDiagram-T62WH6J4-Dnjw8CC9.js} +1 -1
  115. package/web/assets/{ganttDiagram-EL5Y4UJY-D84r1V0Q.js → ganttDiagram-EL5Y4UJY-Crx3v_bM.js} +1 -1
  116. package/web/assets/{gitGraphDiagram-WWUBYQGX-FANv-qDA.js → gitGraphDiagram-WWUBYQGX-DdXK5-FC.js} +1 -1
  117. package/web/assets/{hosted-conversation-template-client-CeOnupVC.js → hosted-conversation-template-client-BBChWnuL.js} +1 -1
  118. package/web/assets/{index-C90_sIrz.js → index-B2ZMoChP.js} +1 -1
  119. package/web/assets/{index-C_F0LgDO.js → index-B8mI7i5P.js} +1 -1
  120. package/web/assets/{index-hP6Cb_NE.js → index-B9d9bEMV.js} +1 -1
  121. package/web/assets/{index-Bokwz5PA.js → index-BH4u84Zl.js} +1 -1
  122. package/web/assets/{index-Tv4HGgSj.js → index-BLbqv2VV.js} +1 -1
  123. package/web/assets/{index-CBs38naL.js → index-BOx63eOY.js} +1 -1
  124. package/web/assets/{index-zG9SJlS3.js → index-BX86S34Z.js} +1 -1
  125. package/web/assets/{index-NReuiFej.js → index-B_0I1pfq.js} +1 -1
  126. package/web/assets/{index-B8rWDVmR.js → index-Bxxnybu9.js} +1 -1
  127. package/web/assets/{index-BsG4OGs3.js → index-C2ailIoH.js} +1 -1
  128. package/web/assets/{index-sctirQW0.js → index-C6Xr9IrJ.js} +1 -1
  129. package/web/assets/{index-BeipYJv6.js → index-CL6leDY2.js} +1 -1
  130. package/web/assets/{index-9ks2AQTi.js → index-CRzIdYuU.js} +1 -1
  131. package/web/assets/{index-DsgwAvJA.js → index-CkdgQdyk.js} +18 -18
  132. package/web/assets/{index-D6945seh.js → index-Ckk9V4oe.js} +1 -1
  133. package/web/assets/{index-B7tnVSor.js → index-CyzAAgQ3.js} +1 -1
  134. package/web/assets/{index-DGlioDXJ.js → index-D0uXVWoS.js} +1 -1
  135. package/web/assets/{index-DwQqO2fH.js → index-D6oS93p2.js} +1 -1
  136. package/web/assets/{index-W6jp3JVA.js → index-D83C03lZ.js} +1 -1
  137. package/web/assets/{index-BkC7CnZA.js → index-DIal99Mw.js} +1 -1
  138. package/web/assets/{index-C8DbmG_l.js → index-DUAZ34cY.js} +1 -1
  139. package/web/assets/{index-C_EAvnDF.js → index-DWWBJN55.js} +1 -1
  140. package/web/assets/{index-x2OEXKrc.js → index-Da1hjESP.js} +1 -1
  141. package/web/assets/{index-BYYx_GrI.js → index-DhQ5ZiJY.js} +1 -1
  142. package/web/assets/{index-B0P8j1yb.js → index-DqicP4lu.js} +1 -1
  143. package/web/assets/{index-BOhe9vs1.js → index-DzNFJV2b.js} +1 -1
  144. package/web/assets/{index-DU209g6d.js → index-Q1-bojqH.js} +1 -1
  145. package/web/assets/{index-eU6FSd70.js → index-X_1JWEzD.js} +1 -1
  146. package/web/assets/{index-x9JuBH-H.js → index-gIbLvEUk.js} +1 -1
  147. package/web/assets/infoDiagram-FKFFQAWI-B-GXbxgz.js +2 -0
  148. package/web/assets/{isArrayLikeObject-Bg1E4S9y.js → isArrayLikeObject-gY0T7koT.js} +1 -1
  149. package/web/assets/{ishikawaDiagram-5VMMS53U-B0FDzCa4.js → ishikawaDiagram-5VMMS53U-Dm_z4AVs.js} +1 -1
  150. package/web/assets/{journeyDiagram-EYS64GPL-CIM_LxZU.js → journeyDiagram-EYS64GPL-u6PbiRAS.js} +1 -1
  151. package/web/assets/{kanban-definition-UXKFOSKX-DKxBi_r0.js → kanban-definition-UXKFOSKX-jt4qK-jA.js} +1 -1
  152. package/web/assets/{layout-DU0JsES_.js → layout-B0-7CKhq.js} +1 -1
  153. package/web/assets/{linear-C3UCzYem.js → linear-Cn3EJ6UG.js} +1 -1
  154. package/web/assets/{management-url-service-DsBUOSH4.js → management-url-service-CqDpOe_M.js} +1 -1
  155. package/web/assets/{mcp-center-service-BluNkyx-.js → mcp-center-service-CLyFS3Va.js} +1 -1
  156. package/web/assets/{merge-B-E3iBqN.js → merge-BEHLop1o.js} +1 -1
  157. package/web/assets/{mermaid.core-CMc9IFVw.js → mermaid.core-BYLr5KI5.js} +5 -5
  158. package/web/assets/{message-box-service-CszgyilP.js → message-box-service-p64-2ZLT.js} +1 -1
  159. package/web/assets/{mindmap-definition-THT77NOG-BJyPV49z.js → mindmap-definition-THT77NOG-D64kSxGe.js} +1 -1
  160. package/web/assets/{mobile-dialog-return-service-Csexw-by.js → mobile-dialog-return-service-CTr7uf3K.js} +1 -1
  161. package/web/assets/{oauth-callback-3M1eIOPT.js → oauth-callback-CM7WkzLQ.js} +1 -1
  162. package/web/assets/{pegDiagram-XKGWAZYB-jpfn2XMn.js → pegDiagram-XKGWAZYB-YIPunerp.js} +1 -1
  163. package/web/assets/{pieDiagram-E7YTZNPT-B2jQ3Egj.js → pieDiagram-E7YTZNPT-DBfAVvKg.js} +1 -1
  164. package/web/assets/{quadrantDiagram-AXDQQJYC-BXSOa8Vi.js → quadrantDiagram-AXDQQJYC-CkwhedA2.js} +1 -1
  165. package/web/assets/{railroadDiagram-O6MQD6OU-BTy8Z6ZL.js → railroadDiagram-O6MQD6OU-BZnG7UBR.js} +1 -1
  166. package/web/assets/{requirementDiagram-IS5BZ75X-eqVPnJ-z.js → requirementDiagram-IS5BZ75X-D5weBa8z.js} +1 -1
  167. package/web/assets/{runner-presentation-D66Z9p-O.js → runner-presentation-D4sxHhdR.js} +1 -1
  168. package/web/assets/{sankeyDiagram-P5KCCOFB-BI5fAwMJ.js → sankeyDiagram-P5KCCOFB-Dui8-H4S.js} +1 -1
  169. package/web/assets/{sequenceDiagram-WJ2MYXX4-CZ7Un31z.js → sequenceDiagram-WJ2MYXX4-Cwk3Et5G.js} +1 -1
  170. package/web/assets/{session-share-client-service-W0XDwceC.js → session-share-client-service-CsDa4v0N.js} +1 -1
  171. package/web/assets/{sizeCapture-INFHLROL-7gQRW3HD.js → sizeCapture-INFHLROL-Bnyq906w.js} +1 -1
  172. package/web/assets/{stateDiagram-XQSTLZYL-D23AlrmH.js → stateDiagram-XQSTLZYL-Cp8L5BzA.js} +1 -1
  173. package/web/assets/stateDiagram-v2-IH3M54BS-CSEcK-Jc.js +1 -0
  174. package/web/assets/{swimlanes-V6O3JKXN-By9JzeNC.js → swimlanes-V6O3JKXN-Bg9PykpX.js} +1 -1
  175. package/web/assets/swimlanesDiagram-JKAHXJPX-BDvzhxyu.js +8 -0
  176. package/web/assets/{time-presentation-BRvT6nTd.js → time-presentation-DoNuOMmH.js} +1 -1
  177. package/web/assets/{timeline-definition-24CTP7MA-CyydVD-f.js → timeline-definition-24CTP7MA-DpvHaXX2.js} +1 -1
  178. package/web/assets/{union-BSveQIrm.js → union-E1iOItEy.js} +1 -1
  179. package/web/assets/{use-form-common-props-BJ2vZd_0.js → use-form-common-props-BOlG14S9.js} +1 -1
  180. package/web/assets/{use-wheel-TWRoHAF5.js → use-wheel-C3KIpcYO.js} +1 -1
  181. package/web/assets/{vennDiagram-4TSXK5OY-3OEbunrh.js → vennDiagram-4TSXK5OY-QJMcXLBe.js} +1 -1
  182. package/web/assets/{wardleyDiagram-VM6X3IG4-BuZvJTn0.js → wardleyDiagram-VM6X3IG4-ByP28shL.js} +1 -1
  183. package/web/assets/workbench-composer-interaction-controller-BaGSbCxC.js +41 -0
  184. package/web/assets/workbench-composer-interaction-controller-DRyjmQHD.css +1 -0
  185. package/web/assets/{workbench-presentation-DblBOxzZ.js → workbench-presentation-DRcAJQ63.js} +1 -1
  186. package/web/assets/{xychartDiagram-S5SC5T6Z-CQzJStra.js → xychartDiagram-S5SC5T6Z-B-5cq3LN.js} +1 -1
  187. package/web/docs/404.html +2 -2
  188. package/web/docs/administration/account.html +4 -4
  189. package/web/docs/administration/audit.html +4 -4
  190. package/web/docs/administration/conversation-templates.html +4 -4
  191. package/web/docs/administration/email-notifications.html +4 -4
  192. package/web/docs/administration/license.html +5 -5
  193. package/web/docs/administration/nodes-workspaces.html +4 -4
  194. package/web/docs/administration/oauth.html +4 -4
  195. package/web/docs/administration/secrets.html +4 -4
  196. package/web/docs/administration/template-workspace-maintenance.html +4 -4
  197. package/web/docs/administration/users-organizations.html +4 -4
  198. package/web/docs/assets/administration_license.md.CVLEsGB6.js +1 -0
  199. package/web/docs/assets/{app.DFdypnML.js → app.DO5uKi5F.js} +1 -1
  200. package/web/docs/assets/chunks/@localSearchIndexen-US.BzVDCXSP.js +1 -0
  201. package/web/docs/assets/chunks/@localSearchIndexroot.XPo_yBWv.js +1 -0
  202. package/web/docs/assets/chunks/{VPLocalSearchBox.P9CapR4-.js → VPLocalSearchBox.YAT0tY5c.js} +1 -1
  203. package/web/docs/assets/chunks/{theme.DLnKtfGY.js → theme.D5hAjTv8.js} +2 -2
  204. package/web/docs/assets/deployment_network.md.Bbi7-zH2.js +1 -0
  205. package/web/docs/assets/deployment_network.md.Bbi7-zH2.lean.js +1 -0
  206. package/web/docs/assets/deployment_upgrade.md.CG_VFxvG.js +1 -0
  207. package/web/docs/assets/deployment_upgrade.md.CG_VFxvG.lean.js +1 -0
  208. package/web/docs/assets/en-US_administration_license.md.GCAYq1LT.js +1 -0
  209. package/web/docs/assets/en-US_deployment_network.md.770EzfaT.js +1 -0
  210. package/web/docs/assets/en-US_deployment_network.md.770EzfaT.lean.js +1 -0
  211. package/web/docs/assets/en-US_deployment_upgrade.md.DDevql7U.js +1 -0
  212. package/web/docs/assets/{en-US_deployment_upgrade.md.DZiDDiLn.lean.js → en-US_deployment_upgrade.md.DDevql7U.lean.js} +1 -1
  213. package/web/docs/assets/en-US_getting-started_npm-quick-start.md.D46Ec15e.js +3 -0
  214. package/web/docs/assets/en-US_getting-started_npm-quick-start.md.D46Ec15e.lean.js +1 -0
  215. package/web/docs/assets/{en-US_getting-started_overview.md.Bug5sh21.js → en-US_getting-started_overview.md.CB-43rGR.js} +1 -1
  216. package/web/docs/assets/{en-US_getting-started_overview.md.Bug5sh21.lean.js → en-US_getting-started_overview.md.CB-43rGR.lean.js} +1 -1
  217. package/web/docs/assets/en-US_getting-started_prerequisites.md.BFxGOlUy.js +1 -0
  218. package/web/docs/assets/en-US_getting-started_prerequisites.md.BFxGOlUy.lean.js +1 -0
  219. package/web/docs/assets/{en-US_getting-started_server-installation.md._k2XGM85.js → en-US_getting-started_server-installation.md.C7SjGDJt.js} +2 -2
  220. package/web/docs/assets/en-US_workbench_file-reference-and-attachment.md.DmGpnorE.js +1 -0
  221. package/web/docs/assets/en-US_workbench_file-reference-and-attachment.md.DmGpnorE.lean.js +1 -0
  222. package/web/docs/assets/en-US_workbench_files.md.C8TPSXY9.js +1 -0
  223. package/web/docs/assets/{en-US_workbench_files.md.C5byBZOZ.lean.js → en-US_workbench_files.md.C8TPSXY9.lean.js} +1 -1
  224. package/web/docs/assets/getting-started_npm-quick-start.md.CIYjFmiu.js +3 -0
  225. package/web/docs/assets/getting-started_npm-quick-start.md.CIYjFmiu.lean.js +1 -0
  226. package/web/docs/assets/{getting-started_overview.md.CA1CCOBc.js → getting-started_overview.md.Cv-HSfAh.js} +1 -1
  227. package/web/docs/assets/getting-started_prerequisites.md.DjWWTA7V.js +1 -0
  228. package/web/docs/assets/{getting-started_prerequisites.md.D26KU42D.lean.js → getting-started_prerequisites.md.DjWWTA7V.lean.js} +1 -1
  229. package/web/docs/assets/{getting-started_server-installation.md.D3P3Lmc2.js → getting-started_server-installation.md.BsEfVH6b.js} +2 -2
  230. package/web/docs/assets/workbench_file-reference-and-attachment.md.BiQVVks4.js +1 -0
  231. package/web/docs/assets/workbench_file-reference-and-attachment.md.BiQVVks4.lean.js +1 -0
  232. package/web/docs/assets/workbench_files.md.D1inV8ws.js +1 -0
  233. package/web/docs/assets/{workbench_files.md.B5xE7YGc.lean.js → workbench_files.md.D1inV8ws.lean.js} +1 -1
  234. package/web/docs/concepts/architecture.html +4 -4
  235. package/web/docs/concepts/data-and-security.html +4 -4
  236. package/web/docs/concepts/files-git-terminal.html +4 -4
  237. package/web/docs/concepts/node-and-workspace.html +4 -4
  238. package/web/docs/concepts/permissions-and-sharing.html +4 -4
  239. package/web/docs/concepts/runner-control.html +4 -4
  240. package/web/docs/concepts/secrets.html +4 -4
  241. package/web/docs/concepts/session-run-turn.html +4 -4
  242. package/web/docs/deployment/backup-restore.html +4 -4
  243. package/web/docs/deployment/network.html +5 -5
  244. package/web/docs/deployment/node-installation.html +4 -4
  245. package/web/docs/deployment/node-linux.html +4 -4
  246. package/web/docs/deployment/node-macos.html +4 -4
  247. package/web/docs/deployment/node-windows.html +4 -4
  248. package/web/docs/deployment/production.html +4 -4
  249. package/web/docs/deployment/security-checklist.html +4 -4
  250. package/web/docs/deployment/upgrade.html +5 -5
  251. package/web/docs/en-US/administration/account.html +4 -4
  252. package/web/docs/en-US/administration/audit.html +4 -4
  253. package/web/docs/en-US/administration/conversation-templates.html +4 -4
  254. package/web/docs/en-US/administration/email-notifications.html +4 -4
  255. package/web/docs/en-US/administration/license.html +5 -5
  256. package/web/docs/en-US/administration/nodes-workspaces.html +4 -4
  257. package/web/docs/en-US/administration/oauth.html +4 -4
  258. package/web/docs/en-US/administration/secrets.html +4 -4
  259. package/web/docs/en-US/administration/template-workspace-maintenance.html +4 -4
  260. package/web/docs/en-US/administration/users-organizations.html +4 -4
  261. package/web/docs/en-US/concepts/architecture.html +4 -4
  262. package/web/docs/en-US/concepts/data-and-security.html +4 -4
  263. package/web/docs/en-US/concepts/files-git-terminal.html +4 -4
  264. package/web/docs/en-US/concepts/node-and-workspace.html +4 -4
  265. package/web/docs/en-US/concepts/permissions-and-sharing.html +4 -4
  266. package/web/docs/en-US/concepts/runner-control.html +4 -4
  267. package/web/docs/en-US/concepts/secrets.html +4 -4
  268. package/web/docs/en-US/concepts/session-run-turn.html +4 -4
  269. package/web/docs/en-US/deployment/backup-restore.html +4 -4
  270. package/web/docs/en-US/deployment/network.html +5 -5
  271. package/web/docs/en-US/deployment/node-installation.html +4 -4
  272. package/web/docs/en-US/deployment/node-linux.html +4 -4
  273. package/web/docs/en-US/deployment/node-macos.html +4 -4
  274. package/web/docs/en-US/deployment/node-windows.html +4 -4
  275. package/web/docs/en-US/deployment/production.html +4 -4
  276. package/web/docs/en-US/deployment/security-checklist.html +4 -4
  277. package/web/docs/en-US/deployment/upgrade.html +5 -5
  278. package/web/docs/en-US/getting-started/connect-node.html +4 -4
  279. package/web/docs/en-US/getting-started/first-agent-session.html +4 -4
  280. package/web/docs/en-US/getting-started/first-login.html +4 -4
  281. package/web/docs/en-US/getting-started/next-steps.html +4 -4
  282. package/web/docs/en-US/getting-started/npm-quick-start.html +7 -7
  283. package/web/docs/en-US/getting-started/overview.html +5 -5
  284. package/web/docs/en-US/getting-started/prerequisites.html +5 -5
  285. package/web/docs/en-US/getting-started/register-workspace.html +4 -4
  286. package/web/docs/en-US/getting-started/server-installation.html +6 -6
  287. package/web/docs/en-US/operations/marctl.html +4 -4
  288. package/web/docs/en-US/reference/configuration.html +4 -4
  289. package/web/docs/en-US/reference/keyboard-shortcuts.html +4 -4
  290. package/web/docs/en-US/reference/limits.html +4 -4
  291. package/web/docs/en-US/reference/ports-paths-data.html +4 -4
  292. package/web/docs/en-US/reference/status-and-errors.html +4 -4
  293. package/web/docs/en-US/runners/claude-code.html +4 -4
  294. package/web/docs/en-US/runners/codex.html +4 -4
  295. package/web/docs/en-US/runners/mar-agent.html +4 -4
  296. package/web/docs/en-US/runners/opencode.html +4 -4
  297. package/web/docs/en-US/runners/overview.html +4 -4
  298. package/web/docs/en-US/runners/runner-troubleshooting.html +4 -4
  299. package/web/docs/en-US/troubleshooting/node-offline.html +4 -4
  300. package/web/docs/en-US/troubleshooting/quick-diagnosis.html +4 -4
  301. package/web/docs/en-US/troubleshooting/session-run.html +4 -4
  302. package/web/docs/en-US/troubleshooting/terminal.html +4 -4
  303. package/web/docs/en-US/troubleshooting/workspace-files.html +4 -4
  304. package/web/docs/en-US/workbench/composer.html +4 -4
  305. package/web/docs/en-US/workbench/context-and-plan.html +4 -4
  306. package/web/docs/en-US/workbench/conversation.html +4 -4
  307. package/web/docs/en-US/workbench/file-reference-and-attachment.html +5 -5
  308. package/web/docs/en-US/workbench/files.html +5 -5
  309. package/web/docs/en-US/workbench/git-changes.html +4 -4
  310. package/web/docs/en-US/workbench/git-history.html +4 -4
  311. package/web/docs/en-US/workbench/hosted-conversations.html +4 -4
  312. package/web/docs/en-US/workbench/mobile.html +4 -4
  313. package/web/docs/en-US/workbench/navigation.html +4 -4
  314. package/web/docs/en-US/workbench/sessions.html +4 -4
  315. package/web/docs/en-US/workbench/skills.html +4 -4
  316. package/web/docs/en-US/workbench/terminal.html +4 -4
  317. package/web/docs/getting-started/connect-node.html +4 -4
  318. package/web/docs/getting-started/first-agent-session.html +4 -4
  319. package/web/docs/getting-started/first-login.html +4 -4
  320. package/web/docs/getting-started/next-steps.html +4 -4
  321. package/web/docs/getting-started/npm-quick-start.html +7 -7
  322. package/web/docs/getting-started/overview.html +5 -5
  323. package/web/docs/getting-started/prerequisites.html +5 -5
  324. package/web/docs/getting-started/register-workspace.html +4 -4
  325. package/web/docs/getting-started/server-installation.html +6 -6
  326. package/web/docs/hashmap.json +1 -1
  327. package/web/docs/operations/marctl.html +4 -4
  328. package/web/docs/reference/configuration.html +4 -4
  329. package/web/docs/reference/keyboard-shortcuts.html +4 -4
  330. package/web/docs/reference/limits.html +4 -4
  331. package/web/docs/reference/ports-paths-data.html +4 -4
  332. package/web/docs/reference/status-and-errors.html +4 -4
  333. package/web/docs/runners/claude-code.html +4 -4
  334. package/web/docs/runners/codex.html +4 -4
  335. package/web/docs/runners/mar-agent.html +4 -4
  336. package/web/docs/runners/opencode.html +4 -4
  337. package/web/docs/runners/overview.html +4 -4
  338. package/web/docs/runners/runner-troubleshooting.html +4 -4
  339. package/web/docs/troubleshooting/node-offline.html +4 -4
  340. package/web/docs/troubleshooting/quick-diagnosis.html +4 -4
  341. package/web/docs/troubleshooting/session-run.html +4 -4
  342. package/web/docs/troubleshooting/terminal.html +4 -4
  343. package/web/docs/troubleshooting/workspace-files.html +4 -4
  344. package/web/docs/workbench/composer.html +4 -4
  345. package/web/docs/workbench/context-and-plan.html +4 -4
  346. package/web/docs/workbench/conversation.html +4 -4
  347. package/web/docs/workbench/file-reference-and-attachment.html +5 -5
  348. package/web/docs/workbench/files.html +5 -5
  349. package/web/docs/workbench/git-changes.html +4 -4
  350. package/web/docs/workbench/git-history.html +4 -4
  351. package/web/docs/workbench/hosted-conversations.html +4 -4
  352. package/web/docs/workbench/mobile.html +4 -4
  353. package/web/docs/workbench/navigation.html +4 -4
  354. package/web/docs/workbench/sessions.html +4 -4
  355. package/web/docs/workbench/skills.html +4 -4
  356. package/web/docs/workbench/terminal.html +4 -4
  357. package/web/index.html +1 -1
  358. package/web/service-worker.js +1 -1
  359. package/web/web-version.json +1 -1
  360. package/web/assets/HtmlPreviewFrame-xgqXo3bD.js +0 -5
  361. package/web/assets/NodeManagementPage-C1Cj7rex.js +0 -1
  362. package/web/assets/NodeManagementPage-DRBCipFy.js +0 -1
  363. package/web/assets/SecretManagementPage-BDo50Fo5.js +0 -1
  364. package/web/assets/SessionSharePage-1Iv_l9w_.css +0 -1
  365. package/web/assets/SessionSharePage-whJFT3cw.js +0 -2
  366. package/web/assets/SkillCenterPage-Dl-aKzxp.js +0 -1
  367. package/web/assets/StandaloneFilePreviewPage-b-piNuN1.js +0 -1
  368. package/web/assets/SystemConfigurationPage-CUI3Icws.js +0 -1
  369. package/web/assets/WorkbenchPage-C1l73Bo7.css +0 -1
  370. package/web/assets/WorkbenchPage-D4X4qerH.js +0 -21
  371. package/web/assets/WorkspaceManagementPage-0uM3HF3o.js +0 -1
  372. package/web/assets/WorkspaceManagementPage-DlcAgYsx.js +0 -1
  373. package/web/assets/channel-D5Au5X55.js +0 -1
  374. package/web/assets/classDiagram-CYGNFDIV-CplRLUOK.js +0 -1
  375. package/web/assets/classDiagram-v2-TLXNO2FR-CplRLUOK.js +0 -1
  376. package/web/assets/infoDiagram-FKFFQAWI-ZeaWiVDx.js +0 -2
  377. package/web/assets/stateDiagram-v2-IH3M54BS-D93lsHZ8.js +0 -1
  378. package/web/assets/swimlanesDiagram-JKAHXJPX-C3UEWonA.js +0 -8
  379. package/web/assets/workbench-composer-interaction-controller-BJZsGMk-.js +0 -41
  380. package/web/assets/workbench-composer-interaction-controller-C2fEVYPz.css +0 -1
  381. package/web/docs/assets/administration_license.md.Bf1iyuKG.js +0 -1
  382. package/web/docs/assets/chunks/@localSearchIndexen-US.BEf68FQA.js +0 -1
  383. package/web/docs/assets/chunks/@localSearchIndexroot.Dw4g7XXs.js +0 -1
  384. package/web/docs/assets/deployment_network.md.BarghfLt.js +0 -1
  385. package/web/docs/assets/deployment_network.md.BarghfLt.lean.js +0 -1
  386. package/web/docs/assets/deployment_upgrade.md.BESOToM5.js +0 -1
  387. package/web/docs/assets/deployment_upgrade.md.BESOToM5.lean.js +0 -1
  388. package/web/docs/assets/en-US_administration_license.md.Dmg8rNEl.js +0 -1
  389. package/web/docs/assets/en-US_deployment_network.md.DdOgOLns.js +0 -1
  390. package/web/docs/assets/en-US_deployment_network.md.DdOgOLns.lean.js +0 -1
  391. package/web/docs/assets/en-US_deployment_upgrade.md.DZiDDiLn.js +0 -1
  392. package/web/docs/assets/en-US_getting-started_npm-quick-start.md.Dwsi-ffA.js +0 -3
  393. package/web/docs/assets/en-US_getting-started_npm-quick-start.md.Dwsi-ffA.lean.js +0 -1
  394. package/web/docs/assets/en-US_getting-started_prerequisites.md.Bpx_AQD1.js +0 -1
  395. package/web/docs/assets/en-US_getting-started_prerequisites.md.Bpx_AQD1.lean.js +0 -1
  396. package/web/docs/assets/en-US_workbench_file-reference-and-attachment.md.Xzbr8MRS.js +0 -1
  397. package/web/docs/assets/en-US_workbench_file-reference-and-attachment.md.Xzbr8MRS.lean.js +0 -1
  398. package/web/docs/assets/en-US_workbench_files.md.C5byBZOZ.js +0 -1
  399. package/web/docs/assets/getting-started_npm-quick-start.md.CcxMwUgz.js +0 -3
  400. package/web/docs/assets/getting-started_npm-quick-start.md.CcxMwUgz.lean.js +0 -1
  401. package/web/docs/assets/getting-started_prerequisites.md.D26KU42D.js +0 -1
  402. package/web/docs/assets/workbench_file-reference-and-attachment.md.CSLMm-nL.js +0 -1
  403. package/web/docs/assets/workbench_file-reference-and-attachment.md.CSLMm-nL.lean.js +0 -1
  404. package/web/docs/assets/workbench_files.md.B5xE7YGc.js +0 -1
  405. /package/web/docs/assets/{administration_license.md.Bf1iyuKG.lean.js → administration_license.md.CVLEsGB6.lean.js} +0 -0
  406. /package/web/docs/assets/{en-US_administration_license.md.Dmg8rNEl.lean.js → en-US_administration_license.md.GCAYq1LT.lean.js} +0 -0
  407. /package/web/docs/assets/{en-US_getting-started_server-installation.md._k2XGM85.lean.js → en-US_getting-started_server-installation.md.C7SjGDJt.lean.js} +0 -0
  408. /package/web/docs/assets/{getting-started_overview.md.CA1CCOBc.lean.js → getting-started_overview.md.Cv-HSfAh.lean.js} +0 -0
  409. /package/web/docs/assets/{getting-started_server-installation.md.D3P3Lmc2.lean.js → getting-started_server-installation.md.BsEfVH6b.lean.js} +0 -0
@@ -9,16 +9,16 @@
9
9
  <link rel="preload stylesheet" href="/docs/assets/style.B3QdEOQQ.css" as="style">
10
10
  <link rel="preload stylesheet" href="/docs/vp-icons.css" as="style">
11
11
 
12
- <script type="module" src="/docs/assets/app.DFdypnML.js"></script>
12
+ <script type="module" src="/docs/assets/app.DO5uKi5F.js"></script>
13
13
  <link rel="preload" href="/docs/assets/inter-roman-latin.Di8DUHzh.woff2" as="font" type="font/woff2" crossorigin="">
14
- <link rel="modulepreload" href="/docs/assets/chunks/theme.DLnKtfGY.js">
14
+ <link rel="modulepreload" href="/docs/assets/chunks/theme.D5hAjTv8.js">
15
15
  <link rel="modulepreload" href="/docs/assets/chunks/framework.BHjrhdiC.js">
16
16
  <link rel="modulepreload" href="/docs/assets/runners_mar-agent.md.DjuqySh9.lean.js">
17
17
  <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>
18
18
  <script id="check-mac-os">document.documentElement.classList.toggle("mac",/Mac|iPhone|iPod|iPad/i.test(navigator.platform));</script>
19
19
  </head>
20
20
  <body>
21
- <div id="app"><div class="Layout" data-v-ef19ba22><!--[--><!--]--><!--[--><span tabindex="-1" data-v-bbc8ff95></span><a href="#VPContent" class="VPSkipLink visually-hidden" data-v-bbc8ff95>Skip to content</a><!--]--><!----><header class="VPNav" data-v-ef19ba22 data-v-974a37fc><div class="VPNavBar" data-v-974a37fc data-v-94126289><div class="wrapper" data-v-94126289><div class="container" data-v-94126289><div class="title" data-v-94126289><div class="VPNavBarTitle has-sidebar" data-v-94126289 data-v-52450919><a class="title" href="/" data-v-52450919><!--[--><!--]--><!--[--><img class="VPImage logo" src="/docs/logo.png?v=logo-20261011" alt data-v-dd4a1533><!--]--><span data-v-52450919>Documentation</span><!--[--><!--]--></a></div></div><div class="content" data-v-94126289><div class="content-body" data-v-94126289><!--[--><!--]--><div class="VPNavBarSearch search" data-v-94126289><!--[--><!----><div id="local-search"><button type="button" class="DocSearch DocSearch-Button" aria-label="搜索文档"><span class="DocSearch-Button-Container"><span class="vp-icon DocSearch-Search-Icon"></span><span class="DocSearch-Button-Placeholder">搜索文档</span></span><span class="DocSearch-Button-Keys"><kbd class="DocSearch-Button-Key"></kbd><kbd class="DocSearch-Button-Key">K</kbd></span></button></div><!--]--></div><!----><div class="VPFlyout VPNavBarTranslations translations" data-v-94126289 data-v-7547c9e2 data-v-5d7cf148><button type="button" class="button" aria-haspopup="true" aria-expanded="false" aria-label="切换语言" data-v-5d7cf148><span class="text" data-v-5d7cf148><span class="vpi-languages option-icon" data-v-5d7cf148></span><!----><span class="vpi-chevron-down text-icon" data-v-5d7cf148></span></span></button><div class="menu" data-v-5d7cf148><div class="VPMenu" data-v-5d7cf148 data-v-3fafad00><!----><!--[--><!--[--><div class="items" data-v-7547c9e2><p class="title" data-v-7547c9e2>简体中文</p><!--[--><div class="VPMenuLink" data-v-7547c9e2 data-v-d62fa8e2><a class="VPLink link" href="/docs/en-US/runners/mar-agent" data-v-d62fa8e2><!--[--><span data-v-d62fa8e2>English</span><!--]--></a></div><!--]--></div><!--]--><!--]--></div></div></div><div class="VPNavBarAppearance appearance" data-v-94126289 data-v-b81617e7><button class="VPSwitch VPSwitchAppearance" type="button" role="switch" title aria-checked="false" data-v-b81617e7 data-v-273278d3 data-v-595ed02e><span class="check" data-v-595ed02e><span class="icon" data-v-595ed02e><!--[--><span class="vpi-sun sun" data-v-273278d3></span><span class="vpi-moon moon" data-v-273278d3></span><!--]--></span></span></button></div><!----><div class="VPFlyout VPNavBarExtra extra" data-v-94126289 data-v-0e59b9da data-v-5d7cf148><button type="button" class="button" aria-haspopup="true" aria-expanded="false" aria-label="extra navigation" data-v-5d7cf148><span class="vpi-more-horizontal icon" data-v-5d7cf148></span></button><div class="menu" data-v-5d7cf148><div class="VPMenu" data-v-5d7cf148 data-v-3fafad00><!----><!--[--><!--[--><div class="group translations" data-v-0e59b9da><p class="trans-title" data-v-0e59b9da>简体中文</p><!--[--><div class="VPMenuLink" data-v-0e59b9da data-v-d62fa8e2><a class="VPLink link" href="/docs/en-US/runners/mar-agent" data-v-d62fa8e2><!--[--><span data-v-d62fa8e2>English</span><!--]--></a></div><!--]--></div><div class="group" data-v-0e59b9da><div class="item appearance" data-v-0e59b9da><p class="label" data-v-0e59b9da>外观</p><div class="appearance-action" data-v-0e59b9da><button class="VPSwitch VPSwitchAppearance" type="button" role="switch" title aria-checked="false" data-v-0e59b9da data-v-273278d3 data-v-595ed02e><span class="check" data-v-595ed02e><span class="icon" data-v-595ed02e><!--[--><span class="vpi-sun sun" data-v-273278d3></span><span class="vpi-moon moon" data-v-273278d3></span><!--]--></span></span></button></div></div></div><!----><!--]--><!--]--></div></div></div><!--[--><!--[--><!--[--><div class="docs-desktop-actions"><a class="docs-console-link" href="/console" target="_self">控制台</a></div><!--]--><!--]--><!--]--><button type="button" class="VPNavBarHamburger hamburger" aria-label="mobile navigation" aria-expanded="false" aria-controls="VPNavScreen" data-v-94126289 data-v-f8aa66a1><span class="container" data-v-f8aa66a1><span class="top" data-v-f8aa66a1></span><span class="middle" data-v-f8aa66a1></span><span class="bottom" data-v-f8aa66a1></span></span></button></div></div></div></div><div class="divider" data-v-94126289><div class="divider-line" data-v-94126289></div></div></div><!----></header><div class="VPLocalNav has-sidebar empty" data-v-ef19ba22 data-v-0f137e95><div class="container" data-v-0f137e95><button class="menu" aria-expanded="false" aria-controls="VPSidebarNav" data-v-0f137e95><span class="vpi-align-left menu-icon" data-v-0f137e95></span><span class="menu-text" data-v-0f137e95>文档目录</span></button><div class="VPLocalNavOutlineDropdown" style="--vp-vh:0px;" data-v-0f137e95 data-v-8da33559><button data-v-8da33559>返回顶部</button><!----></div></div></div><aside class="VPSidebar" data-v-ef19ba22 data-v-25c855a9><div class="curtain" data-v-25c855a9></div><nav class="nav" id="VPSidebarNav" aria-labelledby="sidebar-aria-label" tabindex="-1" data-v-25c855a9><span class="visually-hidden" id="sidebar-aria-label" data-v-25c855a9> Sidebar Navigation </span><!--[--><!--]--><!--[--><div class="no-transition group" data-v-e55dc7ff><section class="VPSidebarItem level-0" data-v-e55dc7ff data-v-65c16b06><div class="item" role="button" tabindex="0" data-v-65c16b06><div class="indicator" data-v-65c16b06></div><h2 class="text" data-v-65c16b06>开始使用</h2><!----></div><div class="items" data-v-65c16b06><!--[--><div class="VPSidebarItem level-1 is-link" data-v-65c16b06><div class="item" data-v-65c16b06><div class="indicator" data-v-65c16b06></div><a class="VPLink link link" href="/docs/getting-started/overview" data-v-65c16b06><!--[--><p class="text" data-v-65c16b06>MyAgentRoam 是什么</p><!--]--></a><!----></div><!----></div><div class="VPSidebarItem level-1 is-link" data-v-65c16b06><div class="item" data-v-65c16b06><div class="indicator" data-v-65c16b06></div><a class="VPLink link link" href="/docs/getting-started/npm-quick-start" data-v-65c16b06><!--[--><p class="text" data-v-65c16b06>本机 npm 快速开始</p><!--]--></a><!----></div><!----></div><div class="VPSidebarItem level-1 is-link" data-v-65c16b06><div class="item" data-v-65c16b06><div class="indicator" data-v-65c16b06></div><a class="VPLink link link" href="/docs/getting-started/prerequisites" data-v-65c16b06><!--[--><p class="text" data-v-65c16b06>部署前准备</p><!--]--></a><!----></div><!----></div><div class="VPSidebarItem level-1 is-link" data-v-65c16b06><div class="item" data-v-65c16b06><div class="indicator" data-v-65c16b06></div><a class="VPLink link link" href="/docs/getting-started/server-installation" data-v-65c16b06><!--[--><p class="text" data-v-65c16b06>部署 Server 与 Web</p><!--]--></a><!----></div><!----></div><div class="VPSidebarItem level-1 is-link" data-v-65c16b06><div class="item" data-v-65c16b06><div class="indicator" data-v-65c16b06></div><a class="VPLink link link" href="/docs/getting-started/first-login" data-v-65c16b06><!--[--><p class="text" data-v-65c16b06>首次登录与修改密码</p><!--]--></a><!----></div><!----></div><div class="VPSidebarItem level-1 is-link" data-v-65c16b06><div class="item" data-v-65c16b06><div class="indicator" data-v-65c16b06></div><a class="VPLink link link" href="/docs/getting-started/connect-node" data-v-65c16b06><!--[--><p class="text" data-v-65c16b06>接入第一台 Node</p><!--]--></a><!----></div><!----></div><div class="VPSidebarItem level-1 is-link" data-v-65c16b06><div class="item" data-v-65c16b06><div class="indicator" data-v-65c16b06></div><a class="VPLink link link" href="/docs/getting-started/register-workspace" data-v-65c16b06><!--[--><p class="text" data-v-65c16b06>登记第一个 Workspace</p><!--]--></a><!----></div><!----></div><div class="VPSidebarItem level-1 is-link" data-v-65c16b06><div class="item" data-v-65c16b06><div class="indicator" data-v-65c16b06></div><a class="VPLink link link" href="/docs/getting-started/first-agent-session" data-v-65c16b06><!--[--><p class="text" data-v-65c16b06>开始第一次 Agent 对话</p><!--]--></a><!----></div><!----></div><div class="VPSidebarItem level-1 is-link" data-v-65c16b06><div class="item" data-v-65c16b06><div class="indicator" data-v-65c16b06></div><a class="VPLink link link" href="/docs/getting-started/next-steps" data-v-65c16b06><!--[--><p class="text" data-v-65c16b06>接下来可以做什么</p><!--]--></a><!----></div><!----></div><!--]--></div></section></div><div class="no-transition group" data-v-e55dc7ff><section class="VPSidebarItem level-0" data-v-e55dc7ff data-v-65c16b06><div class="item" role="button" tabindex="0" data-v-65c16b06><div class="indicator" data-v-65c16b06></div><h2 class="text" data-v-65c16b06>核心概念</h2><!----></div><div class="items" data-v-65c16b06><!--[--><div class="VPSidebarItem level-1 is-link" data-v-65c16b06><div class="item" data-v-65c16b06><div class="indicator" data-v-65c16b06></div><a class="VPLink link link" href="/docs/concepts/architecture" data-v-65c16b06><!--[--><p class="text" data-v-65c16b06>Server、Node、Web 与 Runner</p><!--]--></a><!----></div><!----></div><div class="VPSidebarItem level-1 is-link" data-v-65c16b06><div class="item" data-v-65c16b06><div class="indicator" data-v-65c16b06></div><a class="VPLink link link" href="/docs/concepts/node-and-workspace" data-v-65c16b06><!--[--><p class="text" data-v-65c16b06>Node 与 Workspace</p><!--]--></a><!----></div><!----></div><div class="VPSidebarItem level-1 is-link" data-v-65c16b06><div class="item" data-v-65c16b06><div class="indicator" data-v-65c16b06></div><a class="VPLink link link" href="/docs/concepts/session-run-turn" data-v-65c16b06><!--[--><p class="text" data-v-65c16b06>会话、运行与消息队列</p><!--]--></a><!----></div><!----></div><div class="VPSidebarItem level-1 is-link" data-v-65c16b06><div class="item" data-v-65c16b06><div class="indicator" data-v-65c16b06></div><a class="VPLink link link" href="/docs/concepts/runner-control" data-v-65c16b06><!--[--><p class="text" data-v-65c16b06>Runner 与会话控制状态</p><!--]--></a><!----></div><!----></div><div class="VPSidebarItem level-1 is-link" data-v-65c16b06><div class="item" data-v-65c16b06><div class="indicator" data-v-65c16b06></div><a class="VPLink link link" href="/docs/concepts/files-git-terminal" data-v-65c16b06><!--[--><p class="text" data-v-65c16b06>文件、Git 与终端</p><!--]--></a><!----></div><!----></div><div class="VPSidebarItem level-1 is-link" data-v-65c16b06><div class="item" data-v-65c16b06><div class="indicator" data-v-65c16b06></div><a class="VPLink link link" href="/docs/concepts/permissions-and-sharing" data-v-65c16b06><!--[--><p class="text" data-v-65c16b06>用户、组织与资源权限</p><!--]--></a><!----></div><!----></div><div class="VPSidebarItem level-1 is-link" data-v-65c16b06><div class="item" data-v-65c16b06><div class="indicator" data-v-65c16b06></div><a class="VPLink link link" href="/docs/concepts/secrets" data-v-65c16b06><!--[--><p class="text" data-v-65c16b06>环境变量密钥与注入顺序</p><!--]--></a><!----></div><!----></div><div class="VPSidebarItem level-1 is-link" data-v-65c16b06><div class="item" data-v-65c16b06><div class="indicator" data-v-65c16b06></div><a class="VPLink link link" href="/docs/concepts/data-and-security" data-v-65c16b06><!--[--><p class="text" data-v-65c16b06>数据归属、凭据与安全边界</p><!--]--></a><!----></div><!----></div><!--]--></div></section></div><div class="no-transition group" data-v-e55dc7ff><section class="VPSidebarItem level-0" data-v-e55dc7ff data-v-65c16b06><div class="item" role="button" tabindex="0" data-v-65c16b06><div class="indicator" data-v-65c16b06></div><h2 class="text" data-v-65c16b06>工作 / 对话使用指南</h2><!----></div><div class="items" data-v-65c16b06><!--[--><div class="VPSidebarItem level-1 is-link" data-v-65c16b06><div class="item" data-v-65c16b06><div class="indicator" data-v-65c16b06></div><a class="VPLink link link" href="/docs/workbench/navigation" data-v-65c16b06><!--[--><p class="text" data-v-65c16b06>工作模式、Node 与 Workspace</p><!--]--></a><!----></div><!----></div><div class="VPSidebarItem level-1 is-link" data-v-65c16b06><div class="item" data-v-65c16b06><div class="indicator" data-v-65c16b06></div><a class="VPLink link link" href="/docs/workbench/skills" data-v-65c16b06><!--[--><p class="text" data-v-65c16b06>收藏与安装 Skill</p><!--]--></a><!----></div><!----></div><div class="VPSidebarItem level-1 is-link" data-v-65c16b06><div class="item" data-v-65c16b06><div class="indicator" data-v-65c16b06></div><a class="VPLink link link" href="/docs/workbench/sessions" data-v-65c16b06><!--[--><p class="text" data-v-65c16b06>创建、查找与管理会话</p><!--]--></a><!----></div><!----></div><div class="VPSidebarItem level-1 is-link" data-v-65c16b06><div class="item" data-v-65c16b06><div class="indicator" data-v-65c16b06></div><a class="VPLink link link" href="/docs/workbench/composer" data-v-65c16b06><!--[--><p class="text" data-v-65c16b06>发送消息与使用 Composer</p><!--]--></a><!----></div><!----></div><div class="VPSidebarItem level-1 is-link" data-v-65c16b06><div class="item" data-v-65c16b06><div class="indicator" data-v-65c16b06></div><a class="VPLink link link" href="/docs/workbench/context-and-plan" data-v-65c16b06><!--[--><p class="text" data-v-65c16b06>上下文用量、Compact 与 Plan</p><!--]--></a><!----></div><!----></div><div class="VPSidebarItem level-1 is-link" data-v-65c16b06><div class="item" data-v-65c16b06><div class="indicator" data-v-65c16b06></div><a class="VPLink link link" href="/docs/workbench/file-reference-and-attachment" data-v-65c16b06><!--[--><p class="text" data-v-65c16b06>@ 引用、文件夹与附件</p><!--]--></a><!----></div><!----></div><div class="VPSidebarItem level-1 is-link" data-v-65c16b06><div class="item" data-v-65c16b06><div class="indicator" data-v-65c16b06></div><a class="VPLink link link" href="/docs/workbench/conversation" data-v-65c16b06><!--[--><p class="text" data-v-65c16b06>阅读对话、工具调用与通知</p><!--]--></a><!----></div><!----></div><div class="VPSidebarItem level-1 is-link" data-v-65c16b06><div class="item" data-v-65c16b06><div class="indicator" data-v-65c16b06></div><a class="VPLink link link" href="/docs/workbench/hosted-conversations" data-v-65c16b06><!--[--><p class="text" data-v-65c16b06>在对话模式从模板新建对话</p><!--]--></a><!----></div><!----></div><div class="VPSidebarItem level-1 is-link" data-v-65c16b06><div class="item" data-v-65c16b06><div class="indicator" data-v-65c16b06></div><a class="VPLink link link" href="/docs/workbench/files" data-v-65c16b06><!--[--><p class="text" data-v-65c16b06>浏览、搜索与管理文件</p><!--]--></a><!----></div><!----></div><div class="VPSidebarItem level-1 is-link" data-v-65c16b06><div class="item" data-v-65c16b06><div class="indicator" data-v-65c16b06></div><a class="VPLink link link" href="/docs/workbench/git-changes" data-v-65c16b06><!--[--><p class="text" data-v-65c16b06>查看 Git Changes 与 Diff</p><!--]--></a><!----></div><!----></div><div class="VPSidebarItem level-1 is-link" data-v-65c16b06><div class="item" data-v-65c16b06><div class="indicator" data-v-65c16b06></div><a class="VPLink link link" href="/docs/workbench/git-history" data-v-65c16b06><!--[--><p class="text" data-v-65c16b06>查看 Git 历史</p><!--]--></a><!----></div><!----></div><div class="VPSidebarItem level-1 is-link" data-v-65c16b06><div class="item" data-v-65c16b06><div class="indicator" data-v-65c16b06></div><a class="VPLink link link" href="/docs/workbench/terminal" data-v-65c16b06><!--[--><p class="text" data-v-65c16b06>使用 Workspace 终端</p><!--]--></a><!----></div><!----></div><div class="VPSidebarItem level-1 is-link" data-v-65c16b06><div class="item" data-v-65c16b06><div class="indicator" data-v-65c16b06></div><a class="VPLink link link" href="/docs/workbench/mobile" data-v-65c16b06><!--[--><p class="text" data-v-65c16b06>在移动端继续工作</p><!--]--></a><!----></div><!----></div><!--]--></div></section></div><div class="no-transition group" data-v-e55dc7ff><section class="VPSidebarItem level-0 has-active" data-v-e55dc7ff data-v-65c16b06><div class="item" role="button" tabindex="0" data-v-65c16b06><div class="indicator" data-v-65c16b06></div><h2 class="text" data-v-65c16b06>Agent 指南</h2><!----></div><div class="items" data-v-65c16b06><!--[--><div class="VPSidebarItem level-1 is-link" data-v-65c16b06><div class="item" data-v-65c16b06><div class="indicator" data-v-65c16b06></div><a class="VPLink link link" href="/docs/runners/overview" data-v-65c16b06><!--[--><p class="text" data-v-65c16b06>选择 Agent</p><!--]--></a><!----></div><!----></div><div class="VPSidebarItem level-1 is-link" data-v-65c16b06><div class="item" data-v-65c16b06><div class="indicator" data-v-65c16b06></div><a class="VPLink link link" href="/docs/runners/opencode" data-v-65c16b06><!--[--><p class="text" data-v-65c16b06>安装、配置和使用 OpenCode</p><!--]--></a><!----></div><!----></div><div class="VPSidebarItem level-1 is-link" data-v-65c16b06><div class="item" data-v-65c16b06><div class="indicator" data-v-65c16b06></div><a class="VPLink link link" href="/docs/runners/codex" data-v-65c16b06><!--[--><p class="text" data-v-65c16b06>安装、配置和使用 Codex</p><!--]--></a><!----></div><!----></div><div class="VPSidebarItem level-1 is-link" data-v-65c16b06><div class="item" data-v-65c16b06><div class="indicator" data-v-65c16b06></div><a class="VPLink link link" href="/docs/runners/claude-code" data-v-65c16b06><!--[--><p class="text" data-v-65c16b06>安装、配置和使用 Claude Code</p><!--]--></a><!----></div><!----></div><div class="VPSidebarItem level-1 is-link" data-v-65c16b06><div class="item" data-v-65c16b06><div class="indicator" data-v-65c16b06></div><a class="VPLink link link" href="/docs/runners/mar-agent" data-v-65c16b06><!--[--><p class="text" data-v-65c16b06>配置和使用内置 MAR Agent</p><!--]--></a><!----></div><!----></div><div class="VPSidebarItem level-1 is-link" data-v-65c16b06><div class="item" data-v-65c16b06><div class="indicator" data-v-65c16b06></div><a class="VPLink link link" href="/docs/runners/runner-troubleshooting" data-v-65c16b06><!--[--><p class="text" data-v-65c16b06>Agent 不可用或模型缺失</p><!--]--></a><!----></div><!----></div><!--]--></div></section></div><div class="no-transition group" data-v-e55dc7ff><section class="VPSidebarItem level-0" data-v-e55dc7ff data-v-65c16b06><div class="item" role="button" tabindex="0" data-v-65c16b06><div class="indicator" data-v-65c16b06></div><h2 class="text" data-v-65c16b06>部署与运维</h2><!----></div><div class="items" data-v-65c16b06><!--[--><div class="VPSidebarItem level-1 is-link" data-v-65c16b06><div class="item" data-v-65c16b06><div class="indicator" data-v-65c16b06></div><a class="VPLink link link" href="/docs/deployment/production" data-v-65c16b06><!--[--><p class="text" data-v-65c16b06>生产部署与反向代理</p><!--]--></a><!----></div><!----></div><div class="VPSidebarItem level-1 is-link" data-v-65c16b06><div class="item" data-v-65c16b06><div class="indicator" data-v-65c16b06></div><a class="VPLink link link" href="/docs/deployment/node-installation" data-v-65c16b06><!--[--><p class="text" data-v-65c16b06>安装与注册 Node</p><!--]--></a><!----></div><!----></div><div class="VPSidebarItem level-1 is-link" data-v-65c16b06><div class="item" data-v-65c16b06><div class="indicator" data-v-65c16b06></div><a class="VPLink link link" href="/docs/deployment/node-linux" data-v-65c16b06><!--[--><p class="text" data-v-65c16b06>Linux Node 与 systemd</p><!--]--></a><!----></div><!----></div><div class="VPSidebarItem level-1 is-link" data-v-65c16b06><div class="item" data-v-65c16b06><div class="indicator" data-v-65c16b06></div><a class="VPLink link link" href="/docs/deployment/node-windows" data-v-65c16b06><!--[--><p class="text" data-v-65c16b06>Windows Node 与任务计划</p><!--]--></a><!----></div><!----></div><div class="VPSidebarItem level-1 is-link" data-v-65c16b06><div class="item" data-v-65c16b06><div class="indicator" data-v-65c16b06></div><a class="VPLink link link" href="/docs/deployment/node-macos" data-v-65c16b06><!--[--><p class="text" data-v-65c16b06>macOS Node 与 launchd</p><!--]--></a><!----></div><!----></div><div class="VPSidebarItem level-1 is-link" data-v-65c16b06><div class="item" data-v-65c16b06><div class="indicator" data-v-65c16b06></div><a class="VPLink link link" href="/docs/deployment/upgrade" data-v-65c16b06><!--[--><p class="text" data-v-65c16b06>升级 MyAgentRoam</p><!--]--></a><!----></div><!----></div><div class="VPSidebarItem level-1 is-link" data-v-65c16b06><div class="item" data-v-65c16b06><div class="indicator" data-v-65c16b06></div><a class="VPLink link link" href="/docs/deployment/backup-restore" data-v-65c16b06><!--[--><p class="text" data-v-65c16b06>备份与恢复</p><!--]--></a><!----></div><!----></div><div class="VPSidebarItem level-1 is-link" data-v-65c16b06><div class="item" data-v-65c16b06><div class="indicator" data-v-65c16b06></div><a class="VPLink link link" href="/docs/deployment/network" data-v-65c16b06><!--[--><p class="text" data-v-65c16b06>网络、TLS 与 WebSocket</p><!--]--></a><!----></div><!----></div><div class="VPSidebarItem level-1 is-link" data-v-65c16b06><div class="item" data-v-65c16b06><div class="indicator" data-v-65c16b06></div><a class="VPLink link link" href="/docs/deployment/security-checklist" data-v-65c16b06><!--[--><p class="text" data-v-65c16b06>上线安全检查清单</p><!--]--></a><!----></div><!----></div><!--]--></div></section></div><div class="no-transition group" data-v-e55dc7ff><section class="VPSidebarItem level-0" data-v-e55dc7ff data-v-65c16b06><div class="item" role="button" tabindex="0" data-v-65c16b06><div class="indicator" data-v-65c16b06></div><h2 class="text" data-v-65c16b06>节点运维工具</h2><!----></div><div class="items" data-v-65c16b06><!--[--><div class="VPSidebarItem level-1 is-link" data-v-65c16b06><div class="item" data-v-65c16b06><div class="indicator" data-v-65c16b06></div><a class="VPLink link link" href="/docs/operations/marctl" data-v-65c16b06><!--[--><p class="text" data-v-65c16b06>使用 marctl 管理节点</p><!--]--></a><!----></div><!----></div><!--]--></div></section></div><div class="no-transition group" data-v-e55dc7ff><section class="VPSidebarItem level-0" data-v-e55dc7ff data-v-65c16b06><div class="item" role="button" tabindex="0" data-v-65c16b06><div class="indicator" data-v-65c16b06></div><h2 class="text" data-v-65c16b06>管理指南</h2><!----></div><div class="items" data-v-65c16b06><!--[--><div class="VPSidebarItem level-1 is-link" data-v-65c16b06><div class="item" data-v-65c16b06><div class="indicator" data-v-65c16b06></div><a class="VPLink link link" href="/docs/administration/account" data-v-65c16b06><!--[--><p class="text" data-v-65c16b06>账户安全与登录会话</p><!--]--></a><!----></div><!----></div><div class="VPSidebarItem level-1 is-link" data-v-65c16b06><div class="item" data-v-65c16b06><div class="indicator" data-v-65c16b06></div><a class="VPLink link link" href="/docs/administration/nodes-workspaces" data-v-65c16b06><!--[--><p class="text" data-v-65c16b06>管理 Node 与 Workspace</p><!--]--></a><!----></div><!----></div><div class="VPSidebarItem level-1 is-link" data-v-65c16b06><div class="item" data-v-65c16b06><div class="indicator" data-v-65c16b06></div><a class="VPLink link link" href="/docs/administration/conversation-templates" data-v-65c16b06><!--[--><p class="text" data-v-65c16b06>管理对话模板</p><!--]--></a><!----></div><!----></div><div class="VPSidebarItem level-1 is-link" data-v-65c16b06><div class="item" data-v-65c16b06><div class="indicator" data-v-65c16b06></div><a class="VPLink link link" href="/docs/administration/template-workspace-maintenance" data-v-65c16b06><!--[--><p class="text" data-v-65c16b06>维护对话模板 Workspace</p><!--]--></a><!----></div><!----></div><div class="VPSidebarItem level-1 is-link" data-v-65c16b06><div class="item" data-v-65c16b06><div class="indicator" data-v-65c16b06></div><a class="VPLink link link" href="/docs/administration/secrets" data-v-65c16b06><!--[--><p class="text" data-v-65c16b06>管理环境变量密钥</p><!--]--></a><!----></div><!----></div><div class="VPSidebarItem level-1 is-link" data-v-65c16b06><div class="item" data-v-65c16b06><div class="indicator" data-v-65c16b06></div><a class="VPLink link link" href="/docs/administration/email-notifications" data-v-65c16b06><!--[--><p class="text" data-v-65c16b06>配置 SMTP 邮件与通知模板</p><!--]--></a><!----></div><!----></div><div class="VPSidebarItem level-1 is-link" data-v-65c16b06><div class="item" data-v-65c16b06><div class="indicator" data-v-65c16b06></div><a class="VPLink link link" href="/docs/administration/users-organizations" data-v-65c16b06><!--[--><p class="text" data-v-65c16b06>管理用户、组织与角色</p><!--]--></a><!----></div><!----></div><div class="VPSidebarItem level-1 is-link" data-v-65c16b06><div class="item" data-v-65c16b06><div class="indicator" data-v-65c16b06></div><a class="VPLink link link" href="/docs/administration/oauth" data-v-65c16b06><!--[--><p class="text" data-v-65c16b06>配置 OAuth 2.0 SSO</p><!--]--></a><!----></div><!----></div><div class="VPSidebarItem level-1 is-link" data-v-65c16b06><div class="item" data-v-65c16b06><div class="indicator" data-v-65c16b06></div><a class="VPLink link link" href="/docs/administration/audit" data-v-65c16b06><!--[--><p class="text" data-v-65c16b06>查询与导出操作审计</p><!--]--></a><!----></div><!----></div><div class="VPSidebarItem level-1 is-link" data-v-65c16b06><div class="item" data-v-65c16b06><div class="indicator" data-v-65c16b06></div><a class="VPLink link link" href="/docs/administration/license" data-v-65c16b06><!--[--><p class="text" data-v-65c16b06>社区版、企业 License 与冻结态</p><!--]--></a><!----></div><!----></div><!--]--></div></section></div><div class="no-transition group" data-v-e55dc7ff><section class="VPSidebarItem level-0" data-v-e55dc7ff data-v-65c16b06><div class="item" role="button" tabindex="0" data-v-65c16b06><div class="indicator" data-v-65c16b06></div><h2 class="text" data-v-65c16b06>故障排查与参考</h2><!----></div><div class="items" data-v-65c16b06><!--[--><div class="VPSidebarItem level-1 is-link" data-v-65c16b06><div class="item" data-v-65c16b06><div class="indicator" data-v-65c16b06></div><a class="VPLink link link" href="/docs/troubleshooting/quick-diagnosis" data-v-65c16b06><!--[--><p class="text" data-v-65c16b06>从现象开始排查</p><!--]--></a><!----></div><!----></div><div class="VPSidebarItem level-1 is-link" data-v-65c16b06><div class="item" data-v-65c16b06><div class="indicator" data-v-65c16b06></div><a class="VPLink link link" href="/docs/troubleshooting/node-offline" data-v-65c16b06><!--[--><p class="text" data-v-65c16b06>Node 注册失败或离线</p><!--]--></a><!----></div><!----></div><div class="VPSidebarItem level-1 is-link" data-v-65c16b06><div class="item" data-v-65c16b06><div class="indicator" data-v-65c16b06></div><a class="VPLink link link" href="/docs/troubleshooting/workspace-files" data-v-65c16b06><!--[--><p class="text" data-v-65c16b06>Workspace、文件或 Git 不可用</p><!--]--></a><!----></div><!----></div><div class="VPSidebarItem level-1 is-link" data-v-65c16b06><div class="item" data-v-65c16b06><div class="indicator" data-v-65c16b06></div><a class="VPLink link link" href="/docs/troubleshooting/session-run" data-v-65c16b06><!--[--><p class="text" data-v-65c16b06>会话卡在 Working、Idle 或只读</p><!--]--></a><!----></div><!----></div><div class="VPSidebarItem level-1 is-link" data-v-65c16b06><div class="item" data-v-65c16b06><div class="indicator" data-v-65c16b06></div><a class="VPLink link link" href="/docs/troubleshooting/terminal" data-v-65c16b06><!--[--><p class="text" data-v-65c16b06>终端无法打开或频繁断线</p><!--]--></a><!----></div><!----></div><div class="VPSidebarItem level-1 is-link" data-v-65c16b06><div class="item" data-v-65c16b06><div class="indicator" data-v-65c16b06></div><a class="VPLink link link" href="/docs/reference/keyboard-shortcuts" data-v-65c16b06><!--[--><p class="text" data-v-65c16b06>键盘快捷键</p><!--]--></a><!----></div><!----></div><div class="VPSidebarItem level-1 is-link" data-v-65c16b06><div class="item" data-v-65c16b06><div class="indicator" data-v-65c16b06></div><a class="VPLink link link" href="/docs/reference/status-and-errors" data-v-65c16b06><!--[--><p class="text" data-v-65c16b06>状态、提示与常见错误</p><!--]--></a><!----></div><!----></div><div class="VPSidebarItem level-1 is-link" data-v-65c16b06><div class="item" data-v-65c16b06><div class="indicator" data-v-65c16b06></div><a class="VPLink link link" href="/docs/reference/configuration" data-v-65c16b06><!--[--><p class="text" data-v-65c16b06>配置项参考</p><!--]--></a><!----></div><!----></div><div class="VPSidebarItem level-1 is-link" data-v-65c16b06><div class="item" data-v-65c16b06><div class="indicator" data-v-65c16b06></div><a class="VPLink link link" href="/docs/reference/ports-paths-data" data-v-65c16b06><!--[--><p class="text" data-v-65c16b06>端口、配置目录与数据位置</p><!--]--></a><!----></div><!----></div><div class="VPSidebarItem level-1 is-link" data-v-65c16b06><div class="item" data-v-65c16b06><div class="indicator" data-v-65c16b06></div><a class="VPLink link link" href="/docs/reference/limits" data-v-65c16b06><!--[--><p class="text" data-v-65c16b06>版本、容量与已知限制</p><!--]--></a><!----></div><!----></div><!--]--></div></section></div><!--]--><!--[--><!--]--></nav></aside><div class="VPContent has-sidebar" id="VPContent" data-v-ef19ba22 data-v-8da8809f><div class="VPDoc has-sidebar has-aside" data-v-8da8809f data-v-cd08f8de><!--[--><!--]--><div class="container" data-v-cd08f8de><div class="aside" data-v-cd08f8de><div class="aside-curtain" data-v-cd08f8de></div><div class="aside-container" data-v-cd08f8de><div class="aside-content" data-v-cd08f8de><div class="VPDocAside" data-v-cd08f8de data-v-56ec1007><!--[--><!--]--><!--[--><!--]--><nav aria-labelledby="doc-outline-aria-label" class="VPDocAsideOutline" data-v-56ec1007 data-v-30a0162a><div class="content" data-v-30a0162a><div class="outline-marker" data-v-30a0162a></div><div aria-level="2" class="outline-title" id="doc-outline-aria-label" role="heading" data-v-30a0162a>本页内容</div><ul class="VPDocOutlineItem root" data-v-30a0162a data-v-da64eb8d><!--[--><!--]--></ul></div></nav><!--[--><!--]--><div class="spacer" data-v-56ec1007></div><!--[--><!--]--><!----><!--[--><!--]--><!--[--><!--]--></div></div></div></div><div class="content" data-v-cd08f8de><div class="content-container" data-v-cd08f8de><!--[--><!--[--><!--[--><div class="document-meta"><span>最后更新: 2026-11-06</span><button type="button" class="copy-page-button">复制本页内容</button></div><!--]--><!--]--><!--]--><main class="main" data-v-cd08f8de><div style="position:relative;" class="vp-doc _docs_runners_mar-agent" data-v-cd08f8de><div><h1 id="配置和使用-mar-agent" tabindex="-1">配置和使用 MAR Agent <a class="header-anchor" href="#配置和使用-mar-agent" aria-label="Permalink to &quot;配置和使用 MAR Agent&quot;">​</a></h1><p>MAR Agent 是随 Node 内置的编码 Agent,不需要安装外部 Agent CLI。每个用户都可在“管理 → MAR Agent 模型”添加和管理自己的个人模型;组织模型由有权管理员维护和授权。同时满足模型使用权和所绑定凭据作用域的用户即可在新会话中选择 <strong>MAR Agent</strong>。</p><p>Server、Web 和 Node 的版本切换及旧 Node 升级限制见<a href="./../deployment/upgrade">升级 MyAgentRoam</a>。</p><h2 id="配置模型" tabindex="-1">配置模型 <a class="header-anchor" href="#配置模型" aria-label="Permalink to &quot;配置模型&quot;">​</a></h2><p>模型表单中的 <strong>上下文回收</strong> 默认开启,可按模型关闭。关闭后不执行文本或图片 GC;自动 Compact 和图片请求硬限额仍生效,图片超限时请求会被拒绝。关闭配置需要运行 Node 声明支持该开关,旧 Node 不会静默忽略它。更改对后续执行生效。</p><p>“使用资源 URL”需要系统设置总开关与模型开关同时开启:全局默认开启,模型默认关闭,修改对下一次执行生效。当前用于图片视觉输入:开启时通过固定的 24 小时签名 URL 提供图片,过期不续期,不参与图片水位 GC;关闭时近期附件和工具图片保留在有界内联窗口,跨轮次继续可见。内联图片与文本共用 GC checkpoint:历史图片编码载荷超过 7 MiB 时,按最早顺序回收到不大于 5 MiB,保护最近两个成功模型轮次;文本 GC 时可顺带回收超过 5 MiB 的成熟图片。单次请求图片编码载荷上限为 12 MiB,必要时可越过历史图片保护期,但不丢弃本次新图。淘汰不删除附件或图片文件。图片附件仍保存为文件并提供路径;需要再次查看时,模型可用附件路径或当前会话的 <code>resourceId</code> 重新调用 <code>view_image</code>;释放提示会保留对应资源 ID。该工具每次返回图片尺寸,单张结果最多 3 MiB;较大图片可显式使用 <code>resize</code> 缩放或 <code>region</code> 查看局部,处理源文件最多 20 MiB。图片预算不包含文字和工具定义,不等于整个请求体大小。HTTP URL 与内联模式共用独立资源存储,关闭 URL 不关闭视觉能力。旧格式历史图片不再作为图像输入恢复,原文本与附件文件保留。图片策略要求 Node 支持资源输入能力。</p><p>每个模型都是独立连接。表单提供 <strong>Codex</strong>、<strong>ChatGPT 套餐授权</strong>、<strong>X订阅 OAuth(实验性)</strong>、<strong>OpenAI Responses</strong> 和 <strong>Anthropic Messages</strong> 五种连接类型。选择 Codex 后直接选择已有 Codex 凭据;模型 ID 始终手工填写或修改,不提供目录选项,也不要求该 ID 出现在所选凭据的实时模型目录中。切换凭据时已填写的模型 ID 会保留,展示名称仍可自定义。实时目录仅在“加载模型目录”批量导入时读取。Codex 使用固定服务地址,OpenAI Responses 与 Anthropic Messages 则分别填写 Base URL 和内联 API Key。新建模型的上下文 Token 默认 <code>256000</code>、最大输出 Token 默认 <code>32000</code>;切换连接类型保留模型 ID、Token 上限、能力、思考强度和用途等兼容字段。OpenAI Responses 与 Anthropic Messages 之间保留内联 API Key 和自定义 Base URL,仅默认地址随协议切换;临时切换到 OAuth 再返回也保留已填写的 Key 和自定义地址。OAuth 使用固定地址,不兼容的 OAuth 类型必须重新选择凭据。编辑已有模型时保留保存值,Key 不回显,留空保留已有 Key。目录导入优先使用上游明确提供的限制;缺失上下文 Token 时预填 <code>256000</code>,可在导入前修改,缺失最大输出 Token 时使用 <code>32000</code>(小窗口会收窄至严格小于窗口)。图片输入、会话标题命名、Code Mode、Hosted Web Search、Responses 续接、可选思考强度和默认思考强度都在模型表单中维护;所有 Responses 连接类型均提供传输选项。普通工作区会话和托管对话生成标题时,会按模型排序使用首个已启用“会话标题命名”的可用模型;没有模型开启时回退当前会话所选模型。默认思考强度始终必填;即使不向用户开放强度选择,MAR Agent 内部请求也会使用该默认值;Grok 未配置可选强度时,不向上游发送不受支持的 reasoning 参数。</p><p>在可管理模型的操作列选择 <strong>复制</strong>,会打开预填的新建表单,默认名称附加“副本”。可以修改配置、凭据和归属,选择 <strong>保存</strong> 后才创建新模型,取消不会写入。未替换的内联 Key 或兼容 OAuth 引用由 Server 安全复用,不向浏览器回显秘密。新模型使用独立配置 ID,追加到列表末尾,不继承共享授权和测试结果。复制仍须拥有源模型管理权,新模型的归属和凭据作用域在保存时重新校验。</p><p>Responses 模型(包括内联 API Key)可选择 WebSocket、HTTP/2 或 HTTP/1.1;X订阅支持 WebSocket 和 HTTP/1.1。选定传输失败时不会静默切换协议。HTTP 与 WebSocket 均可勾选服务端续接,切换传输保留勾选状态。只有开启续接的 HTTP 请求发送 <code>store:true</code>;未开启续接的 HTTP 和所有 WebSocket 请求均发送 <code>store:false</code>,不提供独立存储选项。开启 HTTP 续接时,首轮及引用失效后的完整回放也会请求上游保存响应,请考虑其数据留存政策。只在上游支持时启用续接。上游明确报告引用不存在或过期且尚未提交语义输出时,会在请求尝试预算内回退一次完整历史;鉴权、限流及无关错误不按引用过期处理。Adapter 重建或核心提示变化也会完整回放。HTTP 续接要求 Node 声明对应能力。Anthropic Messages 的多轮提示词缓存自动管理,无需该选项。</p><p>企业管理员在新增模型和 OAuth 目录导入时,可选择 <strong>个人 / 组织</strong> 归属。模型归属与凭据作用域独立:使用全企业凭据不会自动共享模型。需要共享时,先创建组织模型,再通过授权入口共享给用户、组织或全企业;个人模型没有授权入口。编辑已有模型只回显归属,不改变归属;已有个人模型需要共享时,应按组织归属重新创建或导入。模型列表直接展示完整的可管理集合,不分页;编辑、测试、刷新和删除后会重新展示当前完整结果。</p><p>MAR Agent 对符合条件的瞬时连接、服务过载或模型流错误进行有界重试;首次请求和后续重试共享最多 8 次尝试。已输出时保留已完成上下文继续恢复,不重置尝试计数。连续 3 分钟没有生成进展时会取消当前模型请求并进入同一恢复流程,心跳和元数据不会延长等待。该计时不包括客户端工具执行或人工等待;持续有生成进展的请求不设整体硬时限。</p><p>Responses 失败重试会重新发起模型服务请求,使用当前完整上下文,不沿用旧路由或服务端续接状态;WebSocket 会新建连接,但不会创建新的用户会话或运行。正常工具续轮仍保留当前路由和续接状态。单次模型请求耗尽重试后,对话错误会显示总尝试次数和重试次数,并保留最终错误原因;工具续轮或用户后续发起的新运行会从第 1 次重新计数,失败恢复本身不会重置计数。</p><p>MAR Agent 不设置单次运行的累计 token 预算或模型往返轮次上限,也不会因累计用量强制收尾。长任务可在 Context GC 或 Compact 后继续;上下文容量检查、取消与模型请求超时仍然有效。模型服务商的套餐、账户及请求限制不受影响。</p><p>工作区会话右下角的信息图标展示最近可用的 Latency 和平均输出 TPS。Latency 在收到首个有效模型语义响应后立即更新;平均输出 TPS 仅在请求结束、Provider 返回权威输出 Token,且累计生成观察时长至少为 1 秒时更新。不足 1 秒时不发布本次 TPS,但 Latency 和 Token 用量照常更新,同一 Run 内保留上一次有效 TPS。TPS 按客户端观测的生成区间计算,排除客户端工具执行和 Hosted Tool 的明确执行暂停区间;输出 Token 可能包含 reasoning 和 Tool Call,观测时长可能受网络和上游缓冲影响,不等同于模型服务端纯推理速度。</p><p>所有用户可在“我的模型顺序”Tab 按个人习惯调整当前获授权模型在选择列表中的顺序;该操作不会影响其他用户、管理员设置的默认顺序,也不会改变会话标题生成或模板候选。未被个人调整的新模型继续按管理员默认顺序排在后方。系统管理员在“模型”Tab 管理全局默认顺序,列表展示名称、连接类型、模型 ID、可用性、使用范围和测试状态,不展示凭据与 Responses 传输;Codex 传输仍可在模型编辑表单中查看和修改。删除模型不要求先禁用,也不会因当前正在使用而被阻止;已经开始的单次模型网络请求可自然结束,后续再使用该模型会按模型不存在失败。点击“调整排序”后拖动行首手柄,使用“保存排序”一次保存完整顺序并退出排序模式;“取消”会恢复调整前的顺序。</p><p>保存后使用“测试”,选择一个在线且版本、动态凭据能力和当前传输均兼容的 Node 执行真实最小请求。测试不会创建 Workspace Session 或 Run。测试成功或失败后弹窗都会保留,展示结果、错误码、HTTP 状态、消息、Server 请求 ID;如果 Node 提供上游明细,还会展示上游请求 ID、Content-Type、<code>Retry-After</code> 和可选择复制的纯文本响应正文。正文有安全长度上限,截断时会显示提示,HTML 不会执行或渲染。再次测试或改选模型、Node 会清除旧结果。失败测试仍按原规则显示错误通知,但诊断明细保留在弹窗中。列表和测试结果不会回显 API Key 或 OAuth Token;编辑时内联 Key 或已有 Codex 凭据留空表示保留原值。模型配置仍只由系统管理员管理;Codex 凭据则按凭据作用域由对应用户或管理员管理。</p><p>Codex (legacy) 和 ChatGPT 模型均提供 <strong>速度 → 默认 / Fast / Ultrafast</strong>。配置按 Responses 标准 <code>service_tier</code> 参数保存,适用于 HTTP 与 WebSocket 请求。存量 Fast 设置保留为 Fast,其余存量模型及新导入模型使用默认。可用性及额度消耗或费用由上游模型和账户决定,不支持时不会静默降级。独立 CLI 保留 <code>--fast-mode</code>、<code>--no-fast-mode</code> 兼容选项。</p><h2 id="对话模型与辅助模型" tabindex="-1">对话模型与辅助模型 <a class="header-anchor" href="#对话模型与辅助模型" aria-label="Permalink to &quot;对话模型与辅助模型&quot;">​</a></h2><p>模型表单默认勾选 <strong>对话模型</strong>。只有已启用且勾选此项的模型,才能出现在工作模式或托管对话的 Composer、Subagent 以及模板主模型候选中。取消勾选后,模型仍可用于专用 Compact、会话标题命名和输入预测;这些用途仍需分别配置并满足模型与凭据使用权。对话模型也可用于上述辅助用途,“启用”和“会话标题命名”开关保持独立。</p><p>MAR Agent 子会话的模型还必须勾选 <strong>支持 Subagent</strong>。子会话的模型选择只显示同时满足两种用途且当前可用的模型;没有符合条件的模型时,候选列表为空。主会话的模型选择不受此开关限制。</p><p>已有模型会保留对话用途,新建及目录导入也默认开启。修改不打断已开始的执行;后续发送、续作或显式选择不再具备对话用途的模型时会拒绝执行,请重新选择可用对话模型。历史记录不会删除。</p><h2 id="输入预测模型" tabindex="-1">输入预测模型 <a class="header-anchor" href="#输入预测模型" aria-label="Permalink to &quot;输入预测模型&quot;">​</a></h2><p>在 <strong>管理 → MAR Agent 模型 → 高级 → Prompt Tab</strong> 单独保存全局开关、模型和思考强度,不改变 Compact 配置。全局默认启用但不预选模型;用户仍须有模型及凭据使用权,可在 <strong>设置 → 外观(Appearance)</strong> 切换“输入预测”(无已保存偏好时默认开启,已保存关闭仍关闭;仅工作模式,选择立即保存到当前浏览器)。工作模式支持四种 Runner;预测通过 Node 调用 MAR Agent SDK 的独立模型接口,通过结果工具 Schema 接收预测数据,不创建 Agent 会话或执行工具。操作方式和数据范围见 <a href="./../workbench/composer#输入预测-prompt-tab">输入预测</a>。</p><h2 id="专用-compact-模型" tabindex="-1">专用 Compact 模型 <a class="header-anchor" href="#专用-compact-模型" aria-label="Permalink to &quot;专用 Compact 模型&quot;">​</a></h2><p>系统管理员可在 <strong>管理 → MAR Agent 模型 → 高级 → Compact</strong> 配置启用开关、已有模型和思考强度。这是一份系统级配置,不在“系统配置”页面;企业默认优先选择根组织模型。默认关闭,关闭时继续使用当前会话模型整理上下文。保存只影响之后的运行,不切换当前正在执行的模型。</p><p>还需在当前执行模型的表单中勾选 <strong>统一 Compact</strong>,才会使用系统专用模型。此项默认关闭,新建、导入及未配置的存量模型均使用原模型 Compact;子会话按自身实际模型的开关判断,不继承父模型设置。专用摘要模型自身无需勾选。更改从后续执行生效;旧 Node 未声明支持该开关时保守使用原模型 Compact。</p><p>Node 扩展固定使用高密度 Textual Continuation IR 提示词,不提供独立 CLI 参数。IR 标题和字段名使用英文,自然语言描述可跟随任务语言。未启用或回退时使用 Core 普通结构化交接提示词。专用模型只生成内部交接摘要,不执行工具,也不改变会话主模型。普通会话和托管对话都需满足实际运行用户的模型使用权及凭据作用域;系统启用不会自动授予使用权。输入本地估算超出专用窗口时会在首次调用前裁到窗口的 90%,可能省略较早或冗长证据。专用模型不可用、仍超限或生成失败时,自动回退当前模型的默认整理;不对专用模型做二次容量裁剪或重试。取消或整理总时限耗尽不会触发回退。摘要仅供会话续作,不作为公开聊天正文展示。</p><p>MAR Agent 根据最近一次同模型的上下文输入用量安排自动整理:达到 85% 后在后台生成候选,当前任务和工具继续运行;达到 90% 后会在下一次模型请求前等待同一整理完成。会话时间线在同一项中更新后台生成、等待、完成、失败或取消状态;后台整理不会使当前任务提前结束,也不会公开内部交接摘要。快照之后产生的消息和工具结果会保留在整理后的前缀之后。成功整理后若仍有保留尾部,Context 用量在下一次前台模型请求报告新用量前保持未知;没有保留尾部则沿用现有 <code>0 / window</code> 重置基线。后台 Compact 用量仍计入成本,但不覆盖前台上下文用量、Latency 或平均输出 TPS。</p><p>Smart Compaction 可以在自然进入持续新工作阶段时提前请求同一后台整理机制。有效的同模型输入水位达到 60% 且低于 90% 时,Runtime 允许主模型判断旧阶段的详细上下文是否已失去主要续作价值;不会因每次切题或一次性问答就整理,也不保证无限历史无损保留。用量缺失或失效时跳过这次可选机会,固定 85%/90% 容量保护仍独立生效。无需额外开关或企业 License,SDK 与 CLI 使用同一机制;既有手动 Compact 入口和状态显示不变。</p><h2 id="chatgpt-套餐授权" tabindex="-1">ChatGPT 套餐授权 <a class="header-anchor" href="#chatgpt-套餐授权" aria-label="Permalink to &quot;ChatGPT 套餐授权&quot;">​</a></h2><p>“OAuth 凭据”Tab 在同一张表展示 <strong>Codex (legacy)</strong>、<strong>ChatGPT 套餐授权</strong> 和 <strong>X订阅</strong>。添加 ChatGPT 凭据时选择 <strong>ChatGPT 套餐授权</strong>,再选择浏览器当前电脑上的在线 Node;该 Node 必须支持本机登录。打开本机登录入口,在 OpenAI 页面完成授权。选择远程 Node 无法接收当前浏览器的 loopback 回调,请取消并重新选择。</p><p>本机 Node 只作为临时登录器;最终凭据由 Server 保存和统一刷新。其他远程 Node 不需要参与登录,只要获授权就可共用该凭据。个人、组织和全企业作用域及管理/模型使用权限与 Codex 凭据一致。重新登录也需本机 Node,使用已签发的 client ID;取消或失败不会覆盖现有凭据。</p><p>模型使用固定的公开 OpenAI Responses 地址,不使用旧 Codex backend。支持 HTTP/1.1、HTTP/2 和 WebSocket;HTTP 与 WebSocket 均可启用 <code>previous_response_id</code>,在用户与工具多轮间增量续接;WebSocket 额外要求同一健康连接,重连或 Adapter 重建后回放完整必要历史。不支持以此凭据调用图片生成。可选 SOCKS5 同时用于 Node 登录、Server 刷新与目录,以及运行 Node 的模型请求。</p><p>身份登录成功但缺少套餐使用权限时,凭据会保留并明确显示“未授权”,不能加载目录或用于模型;请重新登录并授予套餐使用权限。该状态不等于 Token 失效,也不会自动改用 API Key 计费。新凭据不提供旧 Codex 私有用量查询,账户标识来自已验证身份;目录没有提供的上下文窗口需在导入时补齐。Token 不会返回管理页面。</p><p>在 ChatGPT 凭据的<strong>详情</strong>中选择<strong>管理用量</strong>,会在新标签页打开 <a href="https://chatgpt.com/settings/usage" target="_blank" rel="noreferrer">ChatGPT 设置 → 用量</a>,查看套餐或本应用的限制并调整可用设置;请确认 ChatGPT 当前登录的是该凭据对应的账户。收到 <code>subscription_sharing_usage_limit_exceeded</code> 时,聊天错误消息会用纯文字提示用量限制,以及需要打开的 <code>https://chatgpt.com/settings/usage</code> 地址,不提供额外按钮或链接交互;普通 429 不会被当作套餐额度耗尽。</p><h2 id="x订阅-oauth-实验性" tabindex="-1">X订阅 OAuth(实验性) <a class="header-anchor" href="#x订阅-oauth-实验性" aria-label="Permalink to &quot;X订阅 OAuth(实验性)&quot;">​</a></h2><p>在“OAuth 凭据”中选择“添加 OAuth 凭据”,类型选择 <strong>X订阅 OAuth(实验性)</strong>,填写名称、归属和可选 SOCKS5 URL。打开显示的 xAI 授权页面并输入设备码;不需要选择本机 Node。请确认授权页面与要绑定的账户后再同意。共享公共 OAuth 客户端可能显示 Grok Build 名称;是否允许推理取决于上游账户和订阅资格,付款金额或登录成功都不保证模型访问权。</p><p>代理格式为 <code>socks5://[username:password@]host:port</code>,特殊字符需要 URL 编码。Server 的设备码、Token 换取、身份查询、刷新、目录、额度和撤销请求,以及执行 Node 的模型请求,均使用这份配置;代理不可达时不会回退直连。Server 和执行 Node 都必须能访问代理地址,远程 Node 上的 <code>127.0.0.1</code> 不是 Server 本机。打开 xAI 授权页使用浏览器自身网络,不继承此代理。创建后可在凭据编辑中修改或清除代理,详情中可原样检查完整 URL;请勿公开截图中的代理密码。</p><p>登录成功后可以加载模型目录导入,也可以新建 Grok 模型并选择已有凭据、填写模型 ID。模型推理固定使用 <code>https://cli-chat-proxy.grok.com/v1</code>,提供 WebSocket 和 HTTP/1.1 SSE 传输选项,新建与目录导入默认 HTTP/1.1 SSE,编辑时可切换传输;Responses 续接默认关闭,此时两种传输均发送完整历史;两种传输均可手动开启 <code>previous_response_id</code>,实际支持由上游及账户决定,开启不代表兼容性保证。订阅代理的传输与续接支持不作保证;引用不存在时会回退一次完整历史,其他失败保留错误诊断。不提供速度档位、HTTP/2 或图片生成。仍使用 X 订阅 OAuth 凭据,不要求开发者 API Key;目录、身份与额度查询继续使用订阅代理。升级 Server 时会自动将误配置为开发者 API 地址的订阅模型迁回订阅代理,保留其他配置并清除旧测试状态。Hosted Web Search 可在模型表单开关,新建和目录导入默认开启;已有模型保持原配置,需编辑勾选并保存才会开启。重新导入会创建独立模型,不修改已有模型。执行 Node 必须支持新的 Responses 参数能力,否则需要升级 Node。</p><p>在凭据详情中点击“查询用量”,可手动查询本周期已用/剩余百分比、周/月周期、重置和查询时间,以及单独列出的额外美元余额。缺失值显示“—”,不是 0 或无限;不推算剩余 Token,不展示不存在的 Token 统计。查询失败不代表推理不可用;用量不会自动轮询,关闭详情会清除结果。上游可能存在额外付费余额,MAR 不自动充值或更改计费设置,也不保证订阅调用永不产生额外费用。</p><p>Token 由 Server 保存并自动刷新,执行 Node 只取得短期访问凭据;失效时可重新登录。删除未被模型引用的凭据会尽力撤销上游 refresh token,撤销失败会明确提示。此接入依赖可能变化的订阅代理协议,不建议用于要求稳定 SLA 的生产任务。</p><h2 id="配置-codex-凭据与模型目录" tabindex="-1">配置 Codex 凭据与模型目录 <a class="header-anchor" href="#配置-codex-凭据与模型目录" aria-label="Permalink to &quot;配置 Codex 凭据与模型目录&quot;">​</a></h2><p>所有用户都可从“管理 → MAR Agent 模型”进入“我的模型顺序”和自己有权管理的 OAuth 凭据视图;只有系统管理员会看到用于配置模型的“模型”Tab。选择“添加 OAuth 凭据”并选用“Codex (legacy)”时,普通成员只能创建个人凭据,组织管理员还可选择其管理组织子树内的组织凭据,系统管理员可选择组织或全企业凭据。个人凭据仅所有者可见,组织凭据仅系统管理员和覆盖该组织的组织管理员可见,全企业凭据仅系统管理员可见。填写名称、作用域及可选 SOCKS5 代理后开始设备登录;该代理仅用于 Codex OAuth 请求、模型目录请求,以及引用此凭据的 Codex 模型请求。系统显示设备码和验证页面,并按服务端间隔自动轮询;等待期间也可选择“刷新登录状态”立即查询一次。只有登录成功、Token 交换及账户校验完成后才保存凭据。取消、失败或过期的登录不会创建凭据。</p><p>凭据列表和详情分别展示当前 access token 的到期时间和 ChatGPT 上游给出的最早可刷新时间;未知的最早可刷新时间显示“—”,这两个时间都不表示 refresh token 到期。refresh token 仍有效且授权正常时,Server 会自动在临期换码;长时间运行任务的 Node 也会自动续取访问令牌和运行票据,不依赖下一次模型调用。暂时失败或返回的令牌仍临期时有界重试;持续断线或凭据失效仍需恢复连接或重新登录。手动刷新可以提前请求换码,是否成功以上游响应为准;自动续期仍遵守最早可刷新时间。真正换码成功后,列表和当前详情立即显示新的到期时间、最早可刷新时间与最近刷新时间。操作列提供“详情”“编辑”“测试”和“删除”。选择“编辑”可修改名称、作用域和 SOCKS5 代理。缩小凭据作用域时,如果已有模型授权超出新作用域,保存会被拒绝,需先收窄模型授权。详情会单独读取并原样显示当前凭据的完整 SOCKS5 URL,并提供刷新、重新登录、查询用量和加载模型目录。选择“查询用量”后,页面显示总 Token、上一日用量、连续 7 个自然日 Token 合计、当前限额窗口的已用百分比、重置时间、本次查询时间;上一日的具体日期与 UTC 偏移以小字显示在用量数值下方。即使昨日没有统计桶,也显示该日期,用量显示为“—”且不回退到更早日期;最新桶若为当地当天,仍不计入 7 天合计。统计日按 <code>America/Los_Angeles</code> 换日:夏令时为 <code>UTC-07:00</code>(UTC+8 的 15:00),冬令时为 <code>UTC-08:00</code>(UTC+8 的 16:00)。系统不会自动轮询,关闭详情后也不会保留完整代理串或用量结果。被模型引用的凭据必须先解除引用才能删除。页面不会展示自定义元数据、已导入模型数量、access token、refresh token、ID token、上游原始用量响应或 FedRAMP 标记。</p><p>选择“加载模型目录”会实时读取该凭据可见的 Codex 模型。页面逐项显示系统支持的思考强度(包括 <code>ultra</code>)、目录提供或系统归一化后的默认强度,以及真正未知的上游强度。勾选要导入的条目;只有上游未提供上下文窗口时才需要补齐,缺失最大输出不会生成输入项。目录不提供可用状态开关,导入后的模型默认启用并采用目录默认强度;传输方式和 Responses 续接等设置统一在模型视图中调整。Codex 和 ChatGPT 每次从目录导入都会创建新的独立模型,即使凭据、上游模型 ID、展示名称和归属完全相同。已有模型和授权保持不变;新模型使用导入默认配置,不继承已有模型的设置或授权。目录发生变化时页面会要求重新确认。</p><h2 id="配置使用授权" tabindex="-1">配置使用授权 <a class="header-anchor" href="#配置使用授权" aria-label="Permalink to &quot;配置使用授权&quot;">​</a></h2><p>新建模型默认为“受限”,升级前已有模型会迁移为“公共”。模型列表的“使用范围”列显示当前状态:</p><ul><li>向“整个企业”授权后,模型成为公共模型。</li><li>未向整个企业授权时,可分别授权给用户或组织,模型保持受限。</li><li>系统管理员始终可以管理全部模型,不受模型授权记录限制;实际使用仍必须位于模型所绑定凭据的作用域内。</li></ul><p>点击模型行的“授权”可查看、添加或撤销授权。模型授权范围必须完全包含在所绑定凭据的作用域内,例如组织凭据不能授权给该组织子树以外的用户、组织或整个企业。普通用户的新会话模型目录只显示同时满足“已启用”“当前用户有模型授权”和“当前用户位于凭据作用域”的脱敏模型;主 Agent 和 subagent 使用同一份授权模型集合。</p><p>禁用模型后,后续新会话、消息和会话命令会被拒绝。撤销用户权限、用户离开凭据组织作用域、模型改绑或解绑凭据、凭据失效后,运行时也会在每次解析动态凭据时重新拒绝后续请求;Node 已经接收且不再需要解析凭据的工作不会被强制中止。再次打开已有 MAR Agent 对话时,如果原模型已不在当前可用目录且目录仍有模型,Web 会自动保存目录中的第一个模型,并把思考强度切换为该模型的默认值;目录为空时不会切换到其他 Agent。模型可直接删除,无需先禁用或等待活动任务结束;已经取得配置的执行可继续,后续解析该模型将按不存在失败。</p><h2 id="会话与权限" tabindex="-1">会话与权限 <a class="header-anchor" href="#会话与权限" aria-label="Permalink to &quot;会话与权限&quot;">​</a></h2><p>Node 提供 <strong>Auto</strong> 和 <strong>完全访问(Full access)</strong>。新建普通工作会话默认 Auto;已有会话保留保存的档位,进入 Goal 不会把 MAR Auto 自动升级为完全访问。独立 SDK/CLI 仍默认 Full access,托管对话保持原有隔离与权限策略。</p><p>Auto 由当前模型判断:普通工程操作和已明确授权的任务自动继续;重要风险或授权仍无法判断时 ask;deny 仅用于仍然有效的明确禁止、上级/Host 禁止或已知无法合理限制影响的极端危险。相同任务、目标和影响范围内的授权会继续复用,不因换工具、重试、分轮或子 Agent 反复询问;范围、影响扩大或用户撤回时重新判断。</p><p>Code Mode 由模型优先在外层 <code>code_exec</code> 整体声明 ask/deny。内部 deny 只拒绝该次工具调用,在结果 <code>data</code> 中返回 <code>error: MAR_AGENT_PERMISSION_DENIED</code> 和简短 <code>message</code>,不抛出 JS 异常或结束整段代码;后续依赖步骤应先检查返回结果。该工具仍记录为失败,其他异常保持原有处理方式。</p><p>ask 通过 Runner 审批卡在线等待,显示公开原因、命令/参数/代码、工作目录与到期时间。点击允许后执行已捕获的原调用;多个请求分别审批。10 分钟未决定即过期,不执行,也不视为用户拒绝。拒绝、过期和模型 deny 仅使该次调用失败,模型可在剩余授权内继续或自然停止;不能自动重试或绕过用户拒绝。取消后、已决定或过期的卡片不可执行。Goal 与定时任务沿用 Node 现有策略。无在线通道的独立 SDK/CLI 在 ask 时停止;之后的新指令不会重放旧调用。</p><p><strong>Auto 不是操作系统沙箱,也不是独立安全审查器。</strong> Full access 不做 Auto 自评,两种档位都保留 Host 路径与资源校验,工具使用 Node 服务账号的实际权限。请使用低权限专用账号并限制 Workspace 和主机权限。</p><p>原生会话记录保存在 Node 运行账号的 <code>~/.mar/agent/sessions/</code>。Server 不保存会话正文。MAR Agent 支持 Plan、Compact、question、Todo、MCP、图片和 subagent。每个 subagent 都是独立持久化的子会话,保留自己的历史和父子关系,但默认会话列表只显示用户根会话;Agent Network 支持根会话、子会话和孙会话三层,不支持第四层。目标模式由 Node 的统一 Goal 流程管理,不在 Agent SDK 内重复实现。</p><p>MAR Agent 会扫描 HOME 与工作区中的标准 Skill 目录,先向模型提供名称和用途摘要;用户请求明确命中某个 Skill 时,再加载该 Skill 的完整工作流和资源目录。无需在请求中写出 Skill 名称。 同名技能按 Workspace、用户、SDK 内置的顺序选择;项目可以定制指导,但不能改变工具参数或主机权限。</p><h3 id="命令执行环境" tabindex="-1">命令执行环境 <a class="header-anchor" href="#命令执行环境" aria-label="Permalink to &quot;命令执行环境&quot;">​</a></h3><p><code>exec</code> 默认启用登录配置。Bash 按原生顺序读取首个可读的 <code>~/.bash_profile</code>、<code>~/.bash_login</code> 或 <code>~/.profile</code>,并在 <code>BASH_ENV</code> 未设置或为空时补加载可读的 <code>~/.bashrc</code>;PowerShell 默认加载启动配置。配置属于执行命令的 Node 服务账号,不是浏览器用户。每次命令启动都会重新读取配置;托管对话只读取隔离环境中可见的文件,不加载宿主账号的配置。</p><p>需要跳过登录初始化时,可以让 Agent 使用 <code>exec({ command: &quot;…&quot;, login: false })</code>。登录 Shell 仍是非交互模式:如果工具链 PATH 位于 <code>.bashrc</code> 的非交互 <code>return</code> 后面,应将这类通用环境配置放到登录配置中,或移到该提前返回之前。MAR 不会绕过这个保护,也不会把一次命令中的 <code>export</code> 写回 Node 或后续独立命令。</p><h3 id="子-agent-高级控制" tabindex="-1">子 Agent 高级控制 <a class="header-anchor" href="#子-agent-高级控制" aria-label="Permalink to &quot;子 Agent 高级控制&quot;">​</a></h3><p>Node Agent Network 不设置旧的 16 个创建或并发限制;独立 SDK Subagent 扩展保留自己的准入策略。</p><p>协作工具为 <code>agent_start</code>、<code>agent_send</code>、<code>agent_wait</code>、<code>agent_stop</code>、<code>agent_list</code> 和 <code>agent_view</code>。<code>agent_start</code> 使用文本任务和非空标题,登记子会话和首个执行后即返回,不等待完成;手动 marctl 创建时标题可省略。使用结果中的 <code>agentId</code> 寻址子会话。<code>agent_send</code> 可发送文本消息、更新 Goal 或对获授权会话的审批作决定;可指定投递意图,包括替换当前执行。<code>agent_wait</code> 默认等待直接子会话终态 30 秒,<code>waitMs=0</code> 只查看快照,正数按传入时长等待。<code>agent_stop</code> 只需会话 ID,停止目标当前执行并清除 Goal;列表和查看工具用于发现获授权的会话及其状态。</p><p><code>agent_view</code> 仅接受 <code>agentId</code>,返回状态、当前 Goal 和有界最近活动,不公开 Run 或 Execution ID,不读取会话历史。完整记录通过独立的 <code>marctl agents history &lt;session-id&gt;</code> 按需分页查询;<code>marctl agents view</code> 遵循相同的状态查询边界。</p><p>目标空闲且没有当前或保留执行时,<code>agent_wait</code> 返回 <code>AGENT_IDLE</code>,摘要明确说明“Agent is idle; there is no execution to wait for.”,不表示会话不存在或任务失败。空闲会话若仍保有真实终态执行,则正常返回该执行结果。省略目标且没有子会话时返回 <code>AGENT_WAIT_NO_TARGETS</code>;显式目标不存在时返回 <code>SESSION_NOT_FOUND</code>。等待不会启动空闲会话。</p><p>同一获授权 Node/Workspace 内,消息、显式等待、Goal、停止、审批及 marctl 会话设置均不按父子关系限制;目标 Run/队列用户归属、模型及资源授权仍有效。发送不建立横向自动订阅。</p><p>子 Agent 的未读公开消息与新终态会在父 Agent 下一次正常模型请求前自动送达,包括原生 Extension API 创建的直接子 Agent;父 Agent 无需反复使用 message wait 检查进展。自动送达不唤醒空闲父 Agent,也不延迟正常最终回复;交付所必需的结果仍应在结束前主动汇合,真正阻塞时仍可使用 <code>agent_wait</code>。自动送达与模型的显式等待共享已读位置,因此已经送达的正文或终态证据不会在后续等待中重复返回。子 Agent 的内容是待核验的上下文,不是新的用户指令或授权。</p><p>Node 原生 <code>agent_send</code> 使用 <code>delivery</code> 参数,取值为 <code>STEER</code> 或 <code>QUEUE</code>。携带正文时,省略该参数默认使用 <code>STEER</code>;纯 Goal 更新或审批操作不受影响,公共消息接口和 CLI 的默认值不变。其他 Runner 使用 <code>marctl agents send &lt;id&gt; --steer -m &lt;text&gt;</code>。及时沟通建议优先使用 STEER;QUEUE 更适合用户或接收方明确要求延后的输入。输入要等当前工作和前面的队列项结束后才消费,有活动 Goal 时,必须等到该 Goal 退出才消费。已接收不保证立即处理。</p><p>消息被接受后,通常无需另外回复或索取收悉确认,也不必仅为确认收到而立即查看会话。主、子 Agent 建议并行推进有意义且不重叠的工作;没有其他本地工作可做,且需要结果解除阻塞或收尾时,再考虑等待。必要的任务结果、澄清、阻塞、冲突和决策信息仍应正常交付。</p><p>原生 <code>agent_list</code> 只接受 <code>scope</code>、可选标题片段 <code>query</code> 和 <code>limit</code>。省略 <code>scope</code> 或选择 <code>tree</code> 时,返回当前会话所在的协作树,包括已登记且获授权的根、祖先、同级及后代;空闲及已结束执行的会话也保留。选择 <code>active</code> 时,返回当前 Workspace 内正在运行或睡眠的会话,不把最近聊过、Goal 已启用或队列非空当作活跃。已知会话应直接复用其 ID,不按标题自动选址或派发。</p><p><code>query</code> 在选定范围内按标题片段过滤,忽略首尾空白及大小写,并统一全角等兼容字符;<code>limit</code> 默认 10、上限 100。结果为 <code>scope</code>、<code>currentAgentId</code>、扁平 <code>sessions</code> 和 <code>truncated</code>,每项只含 <code>id</code>、<code>parentSessionId</code>、<code>title</code> 和 <code>status</code>(<code>RUNNING</code>、<code>SLEEPING</code> 或 <code>IDLE</code>)。两种范围均按活跃优先、最近活动时间倒序排列,通过 parentSessionId 保留树关系;父项可能因过滤或授权不在结果中。无匹配返回空列表,超过 limit 时标记截断,不提供 cursor 或翻页;可用 query 缩小范围。列表不扫描 Runner、不恢复执行、不自动订阅。<code>marctl agents list</code> 使用相同参数和返回字段;独立终端没有当前会话时默认 active,currentAgentId 为 null,显式 tree 会报缺少会话上下文。</p><div class="language-js vp-adaptive-theme"><button title="Copy Code" class="copy"></button><span class="lang">js</span><pre class="shiki shiki-themes github-light github-dark vp-code" tabindex="0"><code><span class="line"><span style="--shiki-light:#D73A49;--shiki-dark:#F97583;">await</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;"> tools.</span><span style="--shiki-light:#6F42C1;--shiki-dark:#B392F0;">agent_list</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">({});</span></span>
21
+ <div id="app"><div class="Layout" data-v-ef19ba22><!--[--><!--]--><!--[--><span tabindex="-1" data-v-bbc8ff95></span><a href="#VPContent" class="VPSkipLink visually-hidden" data-v-bbc8ff95>Skip to content</a><!--]--><!----><header class="VPNav" data-v-ef19ba22 data-v-974a37fc><div class="VPNavBar" data-v-974a37fc data-v-94126289><div class="wrapper" data-v-94126289><div class="container" data-v-94126289><div class="title" data-v-94126289><div class="VPNavBarTitle has-sidebar" data-v-94126289 data-v-52450919><a class="title" href="/" data-v-52450919><!--[--><!--]--><!--[--><img class="VPImage logo" src="/docs/logo.png?v=logo-20261011" alt data-v-dd4a1533><!--]--><span data-v-52450919>Documentation</span><!--[--><!--]--></a></div></div><div class="content" data-v-94126289><div class="content-body" data-v-94126289><!--[--><!--]--><div class="VPNavBarSearch search" data-v-94126289><!--[--><!----><div id="local-search"><button type="button" class="DocSearch DocSearch-Button" aria-label="搜索文档"><span class="DocSearch-Button-Container"><span class="vp-icon DocSearch-Search-Icon"></span><span class="DocSearch-Button-Placeholder">搜索文档</span></span><span class="DocSearch-Button-Keys"><kbd class="DocSearch-Button-Key"></kbd><kbd class="DocSearch-Button-Key">K</kbd></span></button></div><!--]--></div><!----><div class="VPFlyout VPNavBarTranslations translations" data-v-94126289 data-v-7547c9e2 data-v-5d7cf148><button type="button" class="button" aria-haspopup="true" aria-expanded="false" aria-label="切换语言" data-v-5d7cf148><span class="text" data-v-5d7cf148><span class="vpi-languages option-icon" data-v-5d7cf148></span><!----><span class="vpi-chevron-down text-icon" data-v-5d7cf148></span></span></button><div class="menu" data-v-5d7cf148><div class="VPMenu" data-v-5d7cf148 data-v-3fafad00><!----><!--[--><!--[--><div class="items" data-v-7547c9e2><p class="title" data-v-7547c9e2>简体中文</p><!--[--><div class="VPMenuLink" data-v-7547c9e2 data-v-d62fa8e2><a class="VPLink link" href="/docs/en-US/runners/mar-agent" data-v-d62fa8e2><!--[--><span data-v-d62fa8e2>English</span><!--]--></a></div><!--]--></div><!--]--><!--]--></div></div></div><div class="VPNavBarAppearance appearance" data-v-94126289 data-v-b81617e7><button class="VPSwitch VPSwitchAppearance" type="button" role="switch" title aria-checked="false" data-v-b81617e7 data-v-273278d3 data-v-595ed02e><span class="check" data-v-595ed02e><span class="icon" data-v-595ed02e><!--[--><span class="vpi-sun sun" data-v-273278d3></span><span class="vpi-moon moon" data-v-273278d3></span><!--]--></span></span></button></div><!----><div class="VPFlyout VPNavBarExtra extra" data-v-94126289 data-v-0e59b9da data-v-5d7cf148><button type="button" class="button" aria-haspopup="true" aria-expanded="false" aria-label="extra navigation" data-v-5d7cf148><span class="vpi-more-horizontal icon" data-v-5d7cf148></span></button><div class="menu" data-v-5d7cf148><div class="VPMenu" data-v-5d7cf148 data-v-3fafad00><!----><!--[--><!--[--><div class="group translations" data-v-0e59b9da><p class="trans-title" data-v-0e59b9da>简体中文</p><!--[--><div class="VPMenuLink" data-v-0e59b9da data-v-d62fa8e2><a class="VPLink link" href="/docs/en-US/runners/mar-agent" data-v-d62fa8e2><!--[--><span data-v-d62fa8e2>English</span><!--]--></a></div><!--]--></div><div class="group" data-v-0e59b9da><div class="item appearance" data-v-0e59b9da><p class="label" data-v-0e59b9da>外观</p><div class="appearance-action" data-v-0e59b9da><button class="VPSwitch VPSwitchAppearance" type="button" role="switch" title aria-checked="false" data-v-0e59b9da data-v-273278d3 data-v-595ed02e><span class="check" data-v-595ed02e><span class="icon" data-v-595ed02e><!--[--><span class="vpi-sun sun" data-v-273278d3></span><span class="vpi-moon moon" data-v-273278d3></span><!--]--></span></span></button></div></div></div><!----><!--]--><!--]--></div></div></div><!--[--><!--[--><!--[--><div class="docs-desktop-actions"><a class="docs-console-link" href="/console" target="_self">控制台</a></div><!--]--><!--]--><!--]--><button type="button" class="VPNavBarHamburger hamburger" aria-label="mobile navigation" aria-expanded="false" aria-controls="VPNavScreen" data-v-94126289 data-v-f8aa66a1><span class="container" data-v-f8aa66a1><span class="top" data-v-f8aa66a1></span><span class="middle" data-v-f8aa66a1></span><span class="bottom" data-v-f8aa66a1></span></span></button></div></div></div></div><div class="divider" data-v-94126289><div class="divider-line" data-v-94126289></div></div></div><!----></header><div class="VPLocalNav has-sidebar empty" data-v-ef19ba22 data-v-0f137e95><div class="container" data-v-0f137e95><button class="menu" aria-expanded="false" aria-controls="VPSidebarNav" data-v-0f137e95><span class="vpi-align-left menu-icon" data-v-0f137e95></span><span class="menu-text" data-v-0f137e95>文档目录</span></button><div class="VPLocalNavOutlineDropdown" style="--vp-vh:0px;" data-v-0f137e95 data-v-8da33559><button data-v-8da33559>返回顶部</button><!----></div></div></div><aside class="VPSidebar" data-v-ef19ba22 data-v-25c855a9><div class="curtain" data-v-25c855a9></div><nav class="nav" id="VPSidebarNav" aria-labelledby="sidebar-aria-label" tabindex="-1" data-v-25c855a9><span class="visually-hidden" id="sidebar-aria-label" data-v-25c855a9> Sidebar Navigation </span><!--[--><!--]--><!--[--><div class="no-transition group" data-v-e55dc7ff><section class="VPSidebarItem level-0" data-v-e55dc7ff data-v-65c16b06><div class="item" role="button" tabindex="0" data-v-65c16b06><div class="indicator" data-v-65c16b06></div><h2 class="text" data-v-65c16b06>开始使用</h2><!----></div><div class="items" data-v-65c16b06><!--[--><div class="VPSidebarItem level-1 is-link" data-v-65c16b06><div class="item" data-v-65c16b06><div class="indicator" data-v-65c16b06></div><a class="VPLink link link" href="/docs/getting-started/overview" data-v-65c16b06><!--[--><p class="text" data-v-65c16b06>MyAgentRoam 是什么</p><!--]--></a><!----></div><!----></div><div class="VPSidebarItem level-1 is-link" data-v-65c16b06><div class="item" data-v-65c16b06><div class="indicator" data-v-65c16b06></div><a class="VPLink link link" href="/docs/getting-started/npm-quick-start" data-v-65c16b06><!--[--><p class="text" data-v-65c16b06>npm 快速开始</p><!--]--></a><!----></div><!----></div><div class="VPSidebarItem level-1 is-link" data-v-65c16b06><div class="item" data-v-65c16b06><div class="indicator" data-v-65c16b06></div><a class="VPLink link link" href="/docs/getting-started/prerequisites" data-v-65c16b06><!--[--><p class="text" data-v-65c16b06>部署前准备</p><!--]--></a><!----></div><!----></div><div class="VPSidebarItem level-1 is-link" data-v-65c16b06><div class="item" data-v-65c16b06><div class="indicator" data-v-65c16b06></div><a class="VPLink link link" href="/docs/getting-started/server-installation" data-v-65c16b06><!--[--><p class="text" data-v-65c16b06>部署 Server 与 Web</p><!--]--></a><!----></div><!----></div><div class="VPSidebarItem level-1 is-link" data-v-65c16b06><div class="item" data-v-65c16b06><div class="indicator" data-v-65c16b06></div><a class="VPLink link link" href="/docs/getting-started/first-login" data-v-65c16b06><!--[--><p class="text" data-v-65c16b06>首次登录与修改密码</p><!--]--></a><!----></div><!----></div><div class="VPSidebarItem level-1 is-link" data-v-65c16b06><div class="item" data-v-65c16b06><div class="indicator" data-v-65c16b06></div><a class="VPLink link link" href="/docs/getting-started/connect-node" data-v-65c16b06><!--[--><p class="text" data-v-65c16b06>接入第一台 Node</p><!--]--></a><!----></div><!----></div><div class="VPSidebarItem level-1 is-link" data-v-65c16b06><div class="item" data-v-65c16b06><div class="indicator" data-v-65c16b06></div><a class="VPLink link link" href="/docs/getting-started/register-workspace" data-v-65c16b06><!--[--><p class="text" data-v-65c16b06>登记第一个 Workspace</p><!--]--></a><!----></div><!----></div><div class="VPSidebarItem level-1 is-link" data-v-65c16b06><div class="item" data-v-65c16b06><div class="indicator" data-v-65c16b06></div><a class="VPLink link link" href="/docs/getting-started/first-agent-session" data-v-65c16b06><!--[--><p class="text" data-v-65c16b06>开始第一次 Agent 对话</p><!--]--></a><!----></div><!----></div><div class="VPSidebarItem level-1 is-link" data-v-65c16b06><div class="item" data-v-65c16b06><div class="indicator" data-v-65c16b06></div><a class="VPLink link link" href="/docs/getting-started/next-steps" data-v-65c16b06><!--[--><p class="text" data-v-65c16b06>接下来可以做什么</p><!--]--></a><!----></div><!----></div><!--]--></div></section></div><div class="no-transition group" data-v-e55dc7ff><section class="VPSidebarItem level-0" data-v-e55dc7ff data-v-65c16b06><div class="item" role="button" tabindex="0" data-v-65c16b06><div class="indicator" data-v-65c16b06></div><h2 class="text" data-v-65c16b06>核心概念</h2><!----></div><div class="items" data-v-65c16b06><!--[--><div class="VPSidebarItem level-1 is-link" data-v-65c16b06><div class="item" data-v-65c16b06><div class="indicator" data-v-65c16b06></div><a class="VPLink link link" href="/docs/concepts/architecture" data-v-65c16b06><!--[--><p class="text" data-v-65c16b06>Server、Node、Web 与 Runner</p><!--]--></a><!----></div><!----></div><div class="VPSidebarItem level-1 is-link" data-v-65c16b06><div class="item" data-v-65c16b06><div class="indicator" data-v-65c16b06></div><a class="VPLink link link" href="/docs/concepts/node-and-workspace" data-v-65c16b06><!--[--><p class="text" data-v-65c16b06>Node 与 Workspace</p><!--]--></a><!----></div><!----></div><div class="VPSidebarItem level-1 is-link" data-v-65c16b06><div class="item" data-v-65c16b06><div class="indicator" data-v-65c16b06></div><a class="VPLink link link" href="/docs/concepts/session-run-turn" data-v-65c16b06><!--[--><p class="text" data-v-65c16b06>会话、运行与消息队列</p><!--]--></a><!----></div><!----></div><div class="VPSidebarItem level-1 is-link" data-v-65c16b06><div class="item" data-v-65c16b06><div class="indicator" data-v-65c16b06></div><a class="VPLink link link" href="/docs/concepts/runner-control" data-v-65c16b06><!--[--><p class="text" data-v-65c16b06>Runner 与会话控制状态</p><!--]--></a><!----></div><!----></div><div class="VPSidebarItem level-1 is-link" data-v-65c16b06><div class="item" data-v-65c16b06><div class="indicator" data-v-65c16b06></div><a class="VPLink link link" href="/docs/concepts/files-git-terminal" data-v-65c16b06><!--[--><p class="text" data-v-65c16b06>文件、Git 与终端</p><!--]--></a><!----></div><!----></div><div class="VPSidebarItem level-1 is-link" data-v-65c16b06><div class="item" data-v-65c16b06><div class="indicator" data-v-65c16b06></div><a class="VPLink link link" href="/docs/concepts/permissions-and-sharing" data-v-65c16b06><!--[--><p class="text" data-v-65c16b06>用户、组织与资源权限</p><!--]--></a><!----></div><!----></div><div class="VPSidebarItem level-1 is-link" data-v-65c16b06><div class="item" data-v-65c16b06><div class="indicator" data-v-65c16b06></div><a class="VPLink link link" href="/docs/concepts/secrets" data-v-65c16b06><!--[--><p class="text" data-v-65c16b06>环境变量密钥与注入顺序</p><!--]--></a><!----></div><!----></div><div class="VPSidebarItem level-1 is-link" data-v-65c16b06><div class="item" data-v-65c16b06><div class="indicator" data-v-65c16b06></div><a class="VPLink link link" href="/docs/concepts/data-and-security" data-v-65c16b06><!--[--><p class="text" data-v-65c16b06>数据归属、凭据与安全边界</p><!--]--></a><!----></div><!----></div><!--]--></div></section></div><div class="no-transition group" data-v-e55dc7ff><section class="VPSidebarItem level-0" data-v-e55dc7ff data-v-65c16b06><div class="item" role="button" tabindex="0" data-v-65c16b06><div class="indicator" data-v-65c16b06></div><h2 class="text" data-v-65c16b06>工作 / 对话使用指南</h2><!----></div><div class="items" data-v-65c16b06><!--[--><div class="VPSidebarItem level-1 is-link" data-v-65c16b06><div class="item" data-v-65c16b06><div class="indicator" data-v-65c16b06></div><a class="VPLink link link" href="/docs/workbench/navigation" data-v-65c16b06><!--[--><p class="text" data-v-65c16b06>工作模式、Node 与 Workspace</p><!--]--></a><!----></div><!----></div><div class="VPSidebarItem level-1 is-link" data-v-65c16b06><div class="item" data-v-65c16b06><div class="indicator" data-v-65c16b06></div><a class="VPLink link link" href="/docs/workbench/skills" data-v-65c16b06><!--[--><p class="text" data-v-65c16b06>收藏与安装 Skill</p><!--]--></a><!----></div><!----></div><div class="VPSidebarItem level-1 is-link" data-v-65c16b06><div class="item" data-v-65c16b06><div class="indicator" data-v-65c16b06></div><a class="VPLink link link" href="/docs/workbench/sessions" data-v-65c16b06><!--[--><p class="text" data-v-65c16b06>创建、查找与管理会话</p><!--]--></a><!----></div><!----></div><div class="VPSidebarItem level-1 is-link" data-v-65c16b06><div class="item" data-v-65c16b06><div class="indicator" data-v-65c16b06></div><a class="VPLink link link" href="/docs/workbench/composer" data-v-65c16b06><!--[--><p class="text" data-v-65c16b06>发送消息与使用 Composer</p><!--]--></a><!----></div><!----></div><div class="VPSidebarItem level-1 is-link" data-v-65c16b06><div class="item" data-v-65c16b06><div class="indicator" data-v-65c16b06></div><a class="VPLink link link" href="/docs/workbench/context-and-plan" data-v-65c16b06><!--[--><p class="text" data-v-65c16b06>上下文用量、Compact 与 Plan</p><!--]--></a><!----></div><!----></div><div class="VPSidebarItem level-1 is-link" data-v-65c16b06><div class="item" data-v-65c16b06><div class="indicator" data-v-65c16b06></div><a class="VPLink link link" href="/docs/workbench/file-reference-and-attachment" data-v-65c16b06><!--[--><p class="text" data-v-65c16b06>@ 引用、文件夹与附件</p><!--]--></a><!----></div><!----></div><div class="VPSidebarItem level-1 is-link" data-v-65c16b06><div class="item" data-v-65c16b06><div class="indicator" data-v-65c16b06></div><a class="VPLink link link" href="/docs/workbench/conversation" data-v-65c16b06><!--[--><p class="text" data-v-65c16b06>阅读对话、工具调用与通知</p><!--]--></a><!----></div><!----></div><div class="VPSidebarItem level-1 is-link" data-v-65c16b06><div class="item" data-v-65c16b06><div class="indicator" data-v-65c16b06></div><a class="VPLink link link" href="/docs/workbench/hosted-conversations" data-v-65c16b06><!--[--><p class="text" data-v-65c16b06>在对话模式从模板新建对话</p><!--]--></a><!----></div><!----></div><div class="VPSidebarItem level-1 is-link" data-v-65c16b06><div class="item" data-v-65c16b06><div class="indicator" data-v-65c16b06></div><a class="VPLink link link" href="/docs/workbench/files" data-v-65c16b06><!--[--><p class="text" data-v-65c16b06>浏览、搜索与管理文件</p><!--]--></a><!----></div><!----></div><div class="VPSidebarItem level-1 is-link" data-v-65c16b06><div class="item" data-v-65c16b06><div class="indicator" data-v-65c16b06></div><a class="VPLink link link" href="/docs/workbench/git-changes" data-v-65c16b06><!--[--><p class="text" data-v-65c16b06>查看 Git Changes 与 Diff</p><!--]--></a><!----></div><!----></div><div class="VPSidebarItem level-1 is-link" data-v-65c16b06><div class="item" data-v-65c16b06><div class="indicator" data-v-65c16b06></div><a class="VPLink link link" href="/docs/workbench/git-history" data-v-65c16b06><!--[--><p class="text" data-v-65c16b06>查看 Git 历史</p><!--]--></a><!----></div><!----></div><div class="VPSidebarItem level-1 is-link" data-v-65c16b06><div class="item" data-v-65c16b06><div class="indicator" data-v-65c16b06></div><a class="VPLink link link" href="/docs/workbench/terminal" data-v-65c16b06><!--[--><p class="text" data-v-65c16b06>使用 Workspace 终端</p><!--]--></a><!----></div><!----></div><div class="VPSidebarItem level-1 is-link" data-v-65c16b06><div class="item" data-v-65c16b06><div class="indicator" data-v-65c16b06></div><a class="VPLink link link" href="/docs/workbench/mobile" data-v-65c16b06><!--[--><p class="text" data-v-65c16b06>在移动端继续工作</p><!--]--></a><!----></div><!----></div><!--]--></div></section></div><div class="no-transition group" data-v-e55dc7ff><section class="VPSidebarItem level-0 has-active" data-v-e55dc7ff data-v-65c16b06><div class="item" role="button" tabindex="0" data-v-65c16b06><div class="indicator" data-v-65c16b06></div><h2 class="text" data-v-65c16b06>Agent 指南</h2><!----></div><div class="items" data-v-65c16b06><!--[--><div class="VPSidebarItem level-1 is-link" data-v-65c16b06><div class="item" data-v-65c16b06><div class="indicator" data-v-65c16b06></div><a class="VPLink link link" href="/docs/runners/overview" data-v-65c16b06><!--[--><p class="text" data-v-65c16b06>选择 Agent</p><!--]--></a><!----></div><!----></div><div class="VPSidebarItem level-1 is-link" data-v-65c16b06><div class="item" data-v-65c16b06><div class="indicator" data-v-65c16b06></div><a class="VPLink link link" href="/docs/runners/opencode" data-v-65c16b06><!--[--><p class="text" data-v-65c16b06>安装、配置和使用 OpenCode</p><!--]--></a><!----></div><!----></div><div class="VPSidebarItem level-1 is-link" data-v-65c16b06><div class="item" data-v-65c16b06><div class="indicator" data-v-65c16b06></div><a class="VPLink link link" href="/docs/runners/codex" data-v-65c16b06><!--[--><p class="text" data-v-65c16b06>安装、配置和使用 Codex</p><!--]--></a><!----></div><!----></div><div class="VPSidebarItem level-1 is-link" data-v-65c16b06><div class="item" data-v-65c16b06><div class="indicator" data-v-65c16b06></div><a class="VPLink link link" href="/docs/runners/claude-code" data-v-65c16b06><!--[--><p class="text" data-v-65c16b06>安装、配置和使用 Claude Code</p><!--]--></a><!----></div><!----></div><div class="VPSidebarItem level-1 is-link" data-v-65c16b06><div class="item" data-v-65c16b06><div class="indicator" data-v-65c16b06></div><a class="VPLink link link" href="/docs/runners/mar-agent" data-v-65c16b06><!--[--><p class="text" data-v-65c16b06>配置和使用内置 MAR Agent</p><!--]--></a><!----></div><!----></div><div class="VPSidebarItem level-1 is-link" data-v-65c16b06><div class="item" data-v-65c16b06><div class="indicator" data-v-65c16b06></div><a class="VPLink link link" href="/docs/runners/runner-troubleshooting" data-v-65c16b06><!--[--><p class="text" data-v-65c16b06>Agent 不可用或模型缺失</p><!--]--></a><!----></div><!----></div><!--]--></div></section></div><div class="no-transition group" data-v-e55dc7ff><section class="VPSidebarItem level-0" data-v-e55dc7ff data-v-65c16b06><div class="item" role="button" tabindex="0" data-v-65c16b06><div class="indicator" data-v-65c16b06></div><h2 class="text" data-v-65c16b06>部署与运维</h2><!----></div><div class="items" data-v-65c16b06><!--[--><div class="VPSidebarItem level-1 is-link" data-v-65c16b06><div class="item" data-v-65c16b06><div class="indicator" data-v-65c16b06></div><a class="VPLink link link" href="/docs/deployment/production" data-v-65c16b06><!--[--><p class="text" data-v-65c16b06>生产部署与反向代理</p><!--]--></a><!----></div><!----></div><div class="VPSidebarItem level-1 is-link" data-v-65c16b06><div class="item" data-v-65c16b06><div class="indicator" data-v-65c16b06></div><a class="VPLink link link" href="/docs/deployment/node-installation" data-v-65c16b06><!--[--><p class="text" data-v-65c16b06>安装与注册 Node</p><!--]--></a><!----></div><!----></div><div class="VPSidebarItem level-1 is-link" data-v-65c16b06><div class="item" data-v-65c16b06><div class="indicator" data-v-65c16b06></div><a class="VPLink link link" href="/docs/deployment/node-linux" data-v-65c16b06><!--[--><p class="text" data-v-65c16b06>Linux Node 与 systemd</p><!--]--></a><!----></div><!----></div><div class="VPSidebarItem level-1 is-link" data-v-65c16b06><div class="item" data-v-65c16b06><div class="indicator" data-v-65c16b06></div><a class="VPLink link link" href="/docs/deployment/node-windows" data-v-65c16b06><!--[--><p class="text" data-v-65c16b06>Windows Node 与任务计划</p><!--]--></a><!----></div><!----></div><div class="VPSidebarItem level-1 is-link" data-v-65c16b06><div class="item" data-v-65c16b06><div class="indicator" data-v-65c16b06></div><a class="VPLink link link" href="/docs/deployment/node-macos" data-v-65c16b06><!--[--><p class="text" data-v-65c16b06>macOS Node 与 launchd</p><!--]--></a><!----></div><!----></div><div class="VPSidebarItem level-1 is-link" data-v-65c16b06><div class="item" data-v-65c16b06><div class="indicator" data-v-65c16b06></div><a class="VPLink link link" href="/docs/deployment/upgrade" data-v-65c16b06><!--[--><p class="text" data-v-65c16b06>升级 MyAgentRoam</p><!--]--></a><!----></div><!----></div><div class="VPSidebarItem level-1 is-link" data-v-65c16b06><div class="item" data-v-65c16b06><div class="indicator" data-v-65c16b06></div><a class="VPLink link link" href="/docs/deployment/backup-restore" data-v-65c16b06><!--[--><p class="text" data-v-65c16b06>备份与恢复</p><!--]--></a><!----></div><!----></div><div class="VPSidebarItem level-1 is-link" data-v-65c16b06><div class="item" data-v-65c16b06><div class="indicator" data-v-65c16b06></div><a class="VPLink link link" href="/docs/deployment/network" data-v-65c16b06><!--[--><p class="text" data-v-65c16b06>网络、TLS 与 WebSocket</p><!--]--></a><!----></div><!----></div><div class="VPSidebarItem level-1 is-link" data-v-65c16b06><div class="item" data-v-65c16b06><div class="indicator" data-v-65c16b06></div><a class="VPLink link link" href="/docs/deployment/security-checklist" data-v-65c16b06><!--[--><p class="text" data-v-65c16b06>上线安全检查清单</p><!--]--></a><!----></div><!----></div><!--]--></div></section></div><div class="no-transition group" data-v-e55dc7ff><section class="VPSidebarItem level-0" data-v-e55dc7ff data-v-65c16b06><div class="item" role="button" tabindex="0" data-v-65c16b06><div class="indicator" data-v-65c16b06></div><h2 class="text" data-v-65c16b06>节点运维工具</h2><!----></div><div class="items" data-v-65c16b06><!--[--><div class="VPSidebarItem level-1 is-link" data-v-65c16b06><div class="item" data-v-65c16b06><div class="indicator" data-v-65c16b06></div><a class="VPLink link link" href="/docs/operations/marctl" data-v-65c16b06><!--[--><p class="text" data-v-65c16b06>使用 marctl 管理节点</p><!--]--></a><!----></div><!----></div><!--]--></div></section></div><div class="no-transition group" data-v-e55dc7ff><section class="VPSidebarItem level-0" data-v-e55dc7ff data-v-65c16b06><div class="item" role="button" tabindex="0" data-v-65c16b06><div class="indicator" data-v-65c16b06></div><h2 class="text" data-v-65c16b06>管理指南</h2><!----></div><div class="items" data-v-65c16b06><!--[--><div class="VPSidebarItem level-1 is-link" data-v-65c16b06><div class="item" data-v-65c16b06><div class="indicator" data-v-65c16b06></div><a class="VPLink link link" href="/docs/administration/account" data-v-65c16b06><!--[--><p class="text" data-v-65c16b06>账户安全与登录会话</p><!--]--></a><!----></div><!----></div><div class="VPSidebarItem level-1 is-link" data-v-65c16b06><div class="item" data-v-65c16b06><div class="indicator" data-v-65c16b06></div><a class="VPLink link link" href="/docs/administration/nodes-workspaces" data-v-65c16b06><!--[--><p class="text" data-v-65c16b06>管理 Node 与 Workspace</p><!--]--></a><!----></div><!----></div><div class="VPSidebarItem level-1 is-link" data-v-65c16b06><div class="item" data-v-65c16b06><div class="indicator" data-v-65c16b06></div><a class="VPLink link link" href="/docs/administration/conversation-templates" data-v-65c16b06><!--[--><p class="text" data-v-65c16b06>管理对话模板</p><!--]--></a><!----></div><!----></div><div class="VPSidebarItem level-1 is-link" data-v-65c16b06><div class="item" data-v-65c16b06><div class="indicator" data-v-65c16b06></div><a class="VPLink link link" href="/docs/administration/template-workspace-maintenance" data-v-65c16b06><!--[--><p class="text" data-v-65c16b06>维护对话模板 Workspace</p><!--]--></a><!----></div><!----></div><div class="VPSidebarItem level-1 is-link" data-v-65c16b06><div class="item" data-v-65c16b06><div class="indicator" data-v-65c16b06></div><a class="VPLink link link" href="/docs/administration/secrets" data-v-65c16b06><!--[--><p class="text" data-v-65c16b06>管理环境变量密钥</p><!--]--></a><!----></div><!----></div><div class="VPSidebarItem level-1 is-link" data-v-65c16b06><div class="item" data-v-65c16b06><div class="indicator" data-v-65c16b06></div><a class="VPLink link link" href="/docs/administration/email-notifications" data-v-65c16b06><!--[--><p class="text" data-v-65c16b06>配置 SMTP 邮件与通知模板</p><!--]--></a><!----></div><!----></div><div class="VPSidebarItem level-1 is-link" data-v-65c16b06><div class="item" data-v-65c16b06><div class="indicator" data-v-65c16b06></div><a class="VPLink link link" href="/docs/administration/users-organizations" data-v-65c16b06><!--[--><p class="text" data-v-65c16b06>管理用户、组织与角色</p><!--]--></a><!----></div><!----></div><div class="VPSidebarItem level-1 is-link" data-v-65c16b06><div class="item" data-v-65c16b06><div class="indicator" data-v-65c16b06></div><a class="VPLink link link" href="/docs/administration/oauth" data-v-65c16b06><!--[--><p class="text" data-v-65c16b06>配置 OAuth 2.0 SSO</p><!--]--></a><!----></div><!----></div><div class="VPSidebarItem level-1 is-link" data-v-65c16b06><div class="item" data-v-65c16b06><div class="indicator" data-v-65c16b06></div><a class="VPLink link link" href="/docs/administration/audit" data-v-65c16b06><!--[--><p class="text" data-v-65c16b06>查询与导出操作审计</p><!--]--></a><!----></div><!----></div><div class="VPSidebarItem level-1 is-link" data-v-65c16b06><div class="item" data-v-65c16b06><div class="indicator" data-v-65c16b06></div><a class="VPLink link link" href="/docs/administration/license" data-v-65c16b06><!--[--><p class="text" data-v-65c16b06>社区版、企业 License 与冻结态</p><!--]--></a><!----></div><!----></div><!--]--></div></section></div><div class="no-transition group" data-v-e55dc7ff><section class="VPSidebarItem level-0" data-v-e55dc7ff data-v-65c16b06><div class="item" role="button" tabindex="0" data-v-65c16b06><div class="indicator" data-v-65c16b06></div><h2 class="text" data-v-65c16b06>故障排查与参考</h2><!----></div><div class="items" data-v-65c16b06><!--[--><div class="VPSidebarItem level-1 is-link" data-v-65c16b06><div class="item" data-v-65c16b06><div class="indicator" data-v-65c16b06></div><a class="VPLink link link" href="/docs/troubleshooting/quick-diagnosis" data-v-65c16b06><!--[--><p class="text" data-v-65c16b06>从现象开始排查</p><!--]--></a><!----></div><!----></div><div class="VPSidebarItem level-1 is-link" data-v-65c16b06><div class="item" data-v-65c16b06><div class="indicator" data-v-65c16b06></div><a class="VPLink link link" href="/docs/troubleshooting/node-offline" data-v-65c16b06><!--[--><p class="text" data-v-65c16b06>Node 注册失败或离线</p><!--]--></a><!----></div><!----></div><div class="VPSidebarItem level-1 is-link" data-v-65c16b06><div class="item" data-v-65c16b06><div class="indicator" data-v-65c16b06></div><a class="VPLink link link" href="/docs/troubleshooting/workspace-files" data-v-65c16b06><!--[--><p class="text" data-v-65c16b06>Workspace、文件或 Git 不可用</p><!--]--></a><!----></div><!----></div><div class="VPSidebarItem level-1 is-link" data-v-65c16b06><div class="item" data-v-65c16b06><div class="indicator" data-v-65c16b06></div><a class="VPLink link link" href="/docs/troubleshooting/session-run" data-v-65c16b06><!--[--><p class="text" data-v-65c16b06>会话卡在 Working、Idle 或只读</p><!--]--></a><!----></div><!----></div><div class="VPSidebarItem level-1 is-link" data-v-65c16b06><div class="item" data-v-65c16b06><div class="indicator" data-v-65c16b06></div><a class="VPLink link link" href="/docs/troubleshooting/terminal" data-v-65c16b06><!--[--><p class="text" data-v-65c16b06>终端无法打开或频繁断线</p><!--]--></a><!----></div><!----></div><div class="VPSidebarItem level-1 is-link" data-v-65c16b06><div class="item" data-v-65c16b06><div class="indicator" data-v-65c16b06></div><a class="VPLink link link" href="/docs/reference/keyboard-shortcuts" data-v-65c16b06><!--[--><p class="text" data-v-65c16b06>键盘快捷键</p><!--]--></a><!----></div><!----></div><div class="VPSidebarItem level-1 is-link" data-v-65c16b06><div class="item" data-v-65c16b06><div class="indicator" data-v-65c16b06></div><a class="VPLink link link" href="/docs/reference/status-and-errors" data-v-65c16b06><!--[--><p class="text" data-v-65c16b06>状态、提示与常见错误</p><!--]--></a><!----></div><!----></div><div class="VPSidebarItem level-1 is-link" data-v-65c16b06><div class="item" data-v-65c16b06><div class="indicator" data-v-65c16b06></div><a class="VPLink link link" href="/docs/reference/configuration" data-v-65c16b06><!--[--><p class="text" data-v-65c16b06>配置项参考</p><!--]--></a><!----></div><!----></div><div class="VPSidebarItem level-1 is-link" data-v-65c16b06><div class="item" data-v-65c16b06><div class="indicator" data-v-65c16b06></div><a class="VPLink link link" href="/docs/reference/ports-paths-data" data-v-65c16b06><!--[--><p class="text" data-v-65c16b06>端口、配置目录与数据位置</p><!--]--></a><!----></div><!----></div><div class="VPSidebarItem level-1 is-link" data-v-65c16b06><div class="item" data-v-65c16b06><div class="indicator" data-v-65c16b06></div><a class="VPLink link link" href="/docs/reference/limits" data-v-65c16b06><!--[--><p class="text" data-v-65c16b06>版本、容量与已知限制</p><!--]--></a><!----></div><!----></div><!--]--></div></section></div><!--]--><!--[--><!--]--></nav></aside><div class="VPContent has-sidebar" id="VPContent" data-v-ef19ba22 data-v-8da8809f><div class="VPDoc has-sidebar has-aside" data-v-8da8809f data-v-cd08f8de><!--[--><!--]--><div class="container" data-v-cd08f8de><div class="aside" data-v-cd08f8de><div class="aside-curtain" data-v-cd08f8de></div><div class="aside-container" data-v-cd08f8de><div class="aside-content" data-v-cd08f8de><div class="VPDocAside" data-v-cd08f8de data-v-56ec1007><!--[--><!--]--><!--[--><!--]--><nav aria-labelledby="doc-outline-aria-label" class="VPDocAsideOutline" data-v-56ec1007 data-v-30a0162a><div class="content" data-v-30a0162a><div class="outline-marker" data-v-30a0162a></div><div aria-level="2" class="outline-title" id="doc-outline-aria-label" role="heading" data-v-30a0162a>本页内容</div><ul class="VPDocOutlineItem root" data-v-30a0162a data-v-da64eb8d><!--[--><!--]--></ul></div></nav><!--[--><!--]--><div class="spacer" data-v-56ec1007></div><!--[--><!--]--><!----><!--[--><!--]--><!--[--><!--]--></div></div></div></div><div class="content" data-v-cd08f8de><div class="content-container" data-v-cd08f8de><!--[--><!--[--><!--[--><div class="document-meta"><span>最后更新: 2026-11-06</span><button type="button" class="copy-page-button">复制本页内容</button></div><!--]--><!--]--><!--]--><main class="main" data-v-cd08f8de><div style="position:relative;" class="vp-doc _docs_runners_mar-agent" data-v-cd08f8de><div><h1 id="配置和使用-mar-agent" tabindex="-1">配置和使用 MAR Agent <a class="header-anchor" href="#配置和使用-mar-agent" aria-label="Permalink to &quot;配置和使用 MAR Agent&quot;">​</a></h1><p>MAR Agent 是随 Node 内置的编码 Agent,不需要安装外部 Agent CLI。每个用户都可在“管理 → MAR Agent 模型”添加和管理自己的个人模型;组织模型由有权管理员维护和授权。同时满足模型使用权和所绑定凭据作用域的用户即可在新会话中选择 <strong>MAR Agent</strong>。</p><p>Server、Web 和 Node 的版本切换及旧 Node 升级限制见<a href="./../deployment/upgrade">升级 MyAgentRoam</a>。</p><h2 id="配置模型" tabindex="-1">配置模型 <a class="header-anchor" href="#配置模型" aria-label="Permalink to &quot;配置模型&quot;">​</a></h2><p>模型表单中的 <strong>上下文回收</strong> 默认开启,可按模型关闭。关闭后不执行文本或图片 GC;自动 Compact 和图片请求硬限额仍生效,图片超限时请求会被拒绝。关闭配置需要运行 Node 声明支持该开关,旧 Node 不会静默忽略它。更改对后续执行生效。</p><p>“使用资源 URL”需要系统设置总开关与模型开关同时开启:全局默认开启,模型默认关闭,修改对下一次执行生效。当前用于图片视觉输入:开启时通过固定的 24 小时签名 URL 提供图片,过期不续期,不参与图片水位 GC;关闭时近期附件和工具图片保留在有界内联窗口,跨轮次继续可见。内联图片与文本共用 GC checkpoint:历史图片编码载荷超过 7 MiB 时,按最早顺序回收到不大于 5 MiB,保护最近两个成功模型轮次;文本 GC 时可顺带回收超过 5 MiB 的成熟图片。单次请求图片编码载荷上限为 12 MiB,必要时可越过历史图片保护期,但不丢弃本次新图。淘汰不删除附件或图片文件。图片附件仍保存为文件并提供路径;需要再次查看时,模型可用附件路径或当前会话的 <code>resourceId</code> 重新调用 <code>view_image</code>;释放提示会保留对应资源 ID。该工具每次返回图片尺寸,单张结果最多 3 MiB;较大图片可显式使用 <code>resize</code> 缩放或 <code>region</code> 查看局部,处理源文件最多 20 MiB。图片预算不包含文字和工具定义,不等于整个请求体大小。HTTP URL 与内联模式共用独立资源存储,关闭 URL 不关闭视觉能力。旧格式历史图片不再作为图像输入恢复,原文本与附件文件保留。图片策略要求 Node 支持资源输入能力。</p><p>每个模型都是独立连接。表单提供 <strong>Codex</strong>、<strong>ChatGPT 套餐授权</strong>、<strong>X订阅 OAuth(实验性)</strong>、<strong>OpenAI Responses</strong> 和 <strong>Anthropic Messages</strong> 五种连接类型。选择 Codex 后直接选择已有 Codex 凭据;模型 ID 始终手工填写或修改,不提供目录选项,也不要求该 ID 出现在所选凭据的实时模型目录中。切换凭据时已填写的模型 ID 会保留,展示名称仍可自定义。实时目录仅在“加载模型目录”批量导入时读取。Codex 使用固定服务地址,OpenAI Responses 与 Anthropic Messages 则分别填写 Base URL 和内联 API Key。新建模型的上下文 Token 默认 <code>256000</code>、最大输出 Token 默认 <code>32000</code>;切换连接类型保留模型 ID、Token 上限、能力、思考强度和用途等兼容字段。OpenAI Responses 与 Anthropic Messages 之间保留内联 API Key 和自定义 Base URL,仅默认地址随协议切换;临时切换到 OAuth 再返回也保留已填写的 Key 和自定义地址。OAuth 使用固定地址,不兼容的 OAuth 类型必须重新选择凭据。编辑已有模型时保留保存值,Key 不回显,留空保留已有 Key。目录导入优先使用上游明确提供的限制;缺失上下文 Token 时预填 <code>256000</code>,可在导入前修改,缺失最大输出 Token 时使用 <code>32000</code>(小窗口会收窄至严格小于窗口)。图片输入、会话标题命名、Code Mode、Hosted Web Search、Responses 续接、可选思考强度和默认思考强度都在模型表单中维护;所有 Responses 连接类型均提供传输选项。普通工作区会话和托管对话生成标题时,会按模型排序使用首个已启用“会话标题命名”的可用模型;没有模型开启时回退当前会话所选模型。默认思考强度始终必填;即使不向用户开放强度选择,MAR Agent 内部请求也会使用该默认值;Grok 未配置可选强度时,不向上游发送不受支持的 reasoning 参数。</p><p>在可管理模型的操作列选择 <strong>复制</strong>,会打开预填的新建表单,默认名称附加“副本”。可以修改配置、凭据和归属,选择 <strong>保存</strong> 后才创建新模型,取消不会写入。未替换的内联 Key 或兼容 OAuth 引用由 Server 安全复用,不向浏览器回显秘密。新模型使用独立配置 ID,追加到列表末尾,不继承共享授权和测试结果。复制仍须拥有源模型管理权,新模型的归属和凭据作用域在保存时重新校验。</p><p>Responses 模型(包括内联 API Key)可选择 WebSocket、HTTP/2 或 HTTP/1.1;X订阅支持 WebSocket 和 HTTP/1.1。选定传输失败时不会静默切换协议。HTTP 与 WebSocket 均可勾选服务端续接,切换传输保留勾选状态。只有开启续接的 HTTP 请求发送 <code>store:true</code>;未开启续接的 HTTP 和所有 WebSocket 请求均发送 <code>store:false</code>,不提供独立存储选项。开启 HTTP 续接时,首轮及引用失效后的完整回放也会请求上游保存响应,请考虑其数据留存政策。只在上游支持时启用续接。上游明确报告引用不存在或过期且尚未提交语义输出时,会在请求尝试预算内回退一次完整历史;鉴权、限流及无关错误不按引用过期处理。Adapter 重建或核心提示变化也会完整回放。HTTP 续接要求 Node 声明对应能力。Anthropic Messages 的多轮提示词缓存自动管理,无需该选项。</p><p>企业管理员在新增模型和 OAuth 目录导入时,可选择 <strong>个人 / 组织</strong> 归属。模型归属与凭据作用域独立:使用全企业凭据不会自动共享模型。需要共享时,先创建组织模型,再通过授权入口共享给用户、组织或全企业;个人模型没有授权入口。编辑已有模型只回显归属,不改变归属;已有个人模型需要共享时,应按组织归属重新创建或导入。模型列表直接展示完整的可管理集合,不分页;编辑、测试、刷新和删除后会重新展示当前完整结果。</p><p>MAR Agent 对符合条件的瞬时连接、服务过载或模型流错误进行有界重试;首次请求和后续重试共享最多 8 次尝试。已输出时保留已完成上下文继续恢复,不重置尝试计数。连续 3 分钟没有生成进展时会取消当前模型请求并进入同一恢复流程,心跳和元数据不会延长等待。该计时不包括客户端工具执行或人工等待;持续有生成进展的请求不设整体硬时限。</p><p>Responses 失败重试会重新发起模型服务请求,使用当前完整上下文,不沿用旧路由或服务端续接状态;WebSocket 会新建连接,但不会创建新的用户会话或运行。正常工具续轮仍保留当前路由和续接状态。单次模型请求耗尽重试后,对话错误会显示总尝试次数和重试次数,并保留最终错误原因;工具续轮或用户后续发起的新运行会从第 1 次重新计数,失败恢复本身不会重置计数。</p><p>MAR Agent 不设置单次运行的累计 token 预算或模型往返轮次上限,也不会因累计用量强制收尾。长任务可在 Context GC 或 Compact 后继续;上下文容量检查、取消与模型请求超时仍然有效。模型服务商的套餐、账户及请求限制不受影响。</p><p>工作区会话右下角的信息图标展示最近可用的 Latency 和平均输出 TPS。Latency 在收到首个有效模型语义响应后立即更新;平均输出 TPS 仅在请求结束、Provider 返回权威输出 Token,且累计生成观察时长至少为 1 秒时更新。不足 1 秒时不发布本次 TPS,但 Latency 和 Token 用量照常更新,同一 Run 内保留上一次有效 TPS。TPS 按客户端观测的生成区间计算,排除客户端工具执行和 Hosted Tool 的明确执行暂停区间;输出 Token 可能包含 reasoning 和 Tool Call,观测时长可能受网络和上游缓冲影响,不等同于模型服务端纯推理速度。</p><p>所有用户可在“我的模型顺序”Tab 按个人习惯调整当前获授权模型在选择列表中的顺序;该操作不会影响其他用户、管理员设置的默认顺序,也不会改变会话标题生成或模板候选。未被个人调整的新模型继续按管理员默认顺序排在后方。系统管理员在“模型”Tab 管理全局默认顺序,列表展示名称、连接类型、模型 ID、可用性、使用范围和测试状态,不展示凭据与 Responses 传输;Codex 传输仍可在模型编辑表单中查看和修改。删除模型不要求先禁用,也不会因当前正在使用而被阻止;已经开始的单次模型网络请求可自然结束,后续再使用该模型会按模型不存在失败。点击“调整排序”后拖动行首手柄,使用“保存排序”一次保存完整顺序并退出排序模式;“取消”会恢复调整前的顺序。</p><p>保存后使用“测试”,选择一个在线且版本、动态凭据能力和当前传输均兼容的 Node 执行真实最小请求。测试不会创建 Workspace Session 或 Run。测试成功或失败后弹窗都会保留,展示结果、错误码、HTTP 状态、消息、Server 请求 ID;如果 Node 提供上游明细,还会展示上游请求 ID、Content-Type、<code>Retry-After</code> 和可选择复制的纯文本响应正文。正文有安全长度上限,截断时会显示提示,HTML 不会执行或渲染。再次测试或改选模型、Node 会清除旧结果。失败测试仍按原规则显示错误通知,但诊断明细保留在弹窗中。列表和测试结果不会回显 API Key 或 OAuth Token;编辑时内联 Key 或已有 Codex 凭据留空表示保留原值。模型配置仍只由系统管理员管理;Codex 凭据则按凭据作用域由对应用户或管理员管理。</p><p>Codex (legacy) 和 ChatGPT 模型均提供 <strong>速度 → 默认 / Fast / Ultrafast</strong>。配置按 Responses 标准 <code>service_tier</code> 参数保存,适用于 HTTP 与 WebSocket 请求。存量 Fast 设置保留为 Fast,其余存量模型及新导入模型使用默认。可用性及额度消耗或费用由上游模型和账户决定,不支持时不会静默降级。独立 CLI 保留 <code>--fast-mode</code>、<code>--no-fast-mode</code> 兼容选项。</p><h2 id="对话模型与辅助模型" tabindex="-1">对话模型与辅助模型 <a class="header-anchor" href="#对话模型与辅助模型" aria-label="Permalink to &quot;对话模型与辅助模型&quot;">​</a></h2><p>模型表单默认勾选 <strong>对话模型</strong>。只有已启用且勾选此项的模型,才能出现在工作模式或托管对话的 Composer、Subagent 以及模板主模型候选中。取消勾选后,模型仍可用于专用 Compact、会话标题命名和输入预测;这些用途仍需分别配置并满足模型与凭据使用权。对话模型也可用于上述辅助用途,“启用”和“会话标题命名”开关保持独立。</p><p>MAR Agent 子会话的模型还必须勾选 <strong>支持 Subagent</strong>。子会话的模型选择只显示同时满足两种用途且当前可用的模型;没有符合条件的模型时,候选列表为空。主会话的模型选择不受此开关限制。</p><p>已有模型会保留对话用途,新建及目录导入也默认开启。修改不打断已开始的执行;后续发送、续作或显式选择不再具备对话用途的模型时会拒绝执行,请重新选择可用对话模型。历史记录不会删除。</p><h2 id="输入预测模型" tabindex="-1">输入预测模型 <a class="header-anchor" href="#输入预测模型" aria-label="Permalink to &quot;输入预测模型&quot;">​</a></h2><p>在 <strong>管理 → MAR Agent 模型 → 高级 → Prompt Tab</strong> 单独保存全局开关、模型和思考强度,不改变 Compact 配置。全局默认启用但不预选模型;用户仍须有模型及凭据使用权,可在 <strong>设置 → 外观(Appearance)</strong> 切换“输入预测”(无已保存偏好时默认开启,已保存关闭仍关闭;仅工作模式,选择立即保存到当前浏览器)。工作模式支持四种 Runner;预测通过 Node 调用 MAR Agent SDK 的独立模型接口,通过结果工具 Schema 接收预测数据,不创建 Agent 会话或执行工具。操作方式和数据范围见 <a href="./../workbench/composer#输入预测-prompt-tab">输入预测</a>。</p><h2 id="专用-compact-模型" tabindex="-1">专用 Compact 模型 <a class="header-anchor" href="#专用-compact-模型" aria-label="Permalink to &quot;专用 Compact 模型&quot;">​</a></h2><p>系统管理员可在 <strong>管理 → MAR Agent 模型 → 高级 → Compact</strong> 配置启用开关、已有模型和思考强度。这是一份系统级配置,不在“系统配置”页面;企业默认优先选择根组织模型。默认关闭,关闭时继续使用当前会话模型整理上下文。保存只影响之后的运行,不切换当前正在执行的模型。</p><p>还需在当前执行模型的表单中勾选 <strong>统一 Compact</strong>,才会使用系统专用模型。此项默认关闭,新建、导入及未配置的存量模型均使用原模型 Compact;子会话按自身实际模型的开关判断,不继承父模型设置。专用摘要模型自身无需勾选。更改从后续执行生效;旧 Node 未声明支持该开关时保守使用原模型 Compact。</p><p>Node 扩展固定使用高密度 Textual Continuation IR 提示词,不提供独立 CLI 参数。IR 标题和字段名使用英文,自然语言描述可跟随任务语言。未启用或回退时使用 Core 普通结构化交接提示词。专用模型只生成内部交接摘要,不执行工具,也不改变会话主模型。普通会话和托管对话都需满足实际运行用户的模型使用权及凭据作用域;系统启用不会自动授予使用权。输入本地估算超出专用窗口时会在首次调用前裁到窗口的 90%,可能省略较早或冗长证据。专用模型不可用、仍超限或生成失败时,自动回退当前模型的默认整理;不对专用模型做二次容量裁剪或重试。取消或整理总时限耗尽不会触发回退。摘要仅供会话续作,不作为公开聊天正文展示。</p><p>MAR Agent 根据最近一次同模型的上下文输入用量安排自动整理:达到 85% 后在后台生成候选,当前任务和工具继续运行;达到 90% 后会在下一次模型请求前等待同一整理完成。会话时间线在同一项中更新后台生成、等待、完成、失败或取消状态;后台整理不会使当前任务提前结束,也不会公开内部交接摘要。快照之后产生的消息和工具结果会保留在整理后的前缀之后。成功整理后若仍有保留尾部,Context 用量在下一次前台模型请求报告新用量前保持未知;没有保留尾部则沿用现有 <code>0 / window</code> 重置基线。后台 Compact 用量仍计入成本,但不覆盖前台上下文用量、Latency 或平均输出 TPS。</p><p>Smart Compaction 可以在自然进入持续新工作阶段时提前请求同一后台整理机制。有效的同模型输入水位达到 60% 且低于 90% 时,Runtime 允许主模型判断旧阶段的详细上下文是否已失去主要续作价值;不会因每次切题或一次性问答就整理,也不保证无限历史无损保留。用量缺失或失效时跳过这次可选机会,固定 85%/90% 容量保护仍独立生效。无需额外开关或企业 License,SDK 与 CLI 使用同一机制;既有手动 Compact 入口和状态显示不变。</p><h2 id="chatgpt-套餐授权" tabindex="-1">ChatGPT 套餐授权 <a class="header-anchor" href="#chatgpt-套餐授权" aria-label="Permalink to &quot;ChatGPT 套餐授权&quot;">​</a></h2><p>“OAuth 凭据”Tab 在同一张表展示 <strong>Codex (legacy)</strong>、<strong>ChatGPT 套餐授权</strong> 和 <strong>X订阅</strong>。添加 ChatGPT 凭据时选择 <strong>ChatGPT 套餐授权</strong>,再选择浏览器当前电脑上的在线 Node;该 Node 必须支持本机登录。打开本机登录入口,在 OpenAI 页面完成授权。选择远程 Node 无法接收当前浏览器的 loopback 回调,请取消并重新选择。</p><p>本机 Node 只作为临时登录器;最终凭据由 Server 保存和统一刷新。其他远程 Node 不需要参与登录,只要获授权就可共用该凭据。个人、组织和全企业作用域及管理/模型使用权限与 Codex 凭据一致。重新登录也需本机 Node,使用已签发的 client ID;取消或失败不会覆盖现有凭据。</p><p>模型使用固定的公开 OpenAI Responses 地址,不使用旧 Codex backend。支持 HTTP/1.1、HTTP/2 和 WebSocket;HTTP 与 WebSocket 均可启用 <code>previous_response_id</code>,在用户与工具多轮间增量续接;WebSocket 额外要求同一健康连接,重连或 Adapter 重建后回放完整必要历史。不支持以此凭据调用图片生成。可选 SOCKS5 同时用于 Node 登录、Server 刷新与目录,以及运行 Node 的模型请求。</p><p>身份登录成功但缺少套餐使用权限时,凭据会保留并明确显示“未授权”,不能加载目录或用于模型;请重新登录并授予套餐使用权限。该状态不等于 Token 失效,也不会自动改用 API Key 计费。新凭据不提供旧 Codex 私有用量查询,账户标识来自已验证身份;目录没有提供的上下文窗口需在导入时补齐。Token 不会返回管理页面。</p><p>在 ChatGPT 凭据的<strong>详情</strong>中选择<strong>管理用量</strong>,会在新标签页打开 <a href="https://chatgpt.com/settings/usage" target="_blank" rel="noreferrer">ChatGPT 设置 → 用量</a>,查看套餐或本应用的限制并调整可用设置;请确认 ChatGPT 当前登录的是该凭据对应的账户。收到 <code>subscription_sharing_usage_limit_exceeded</code> 时,聊天错误消息会用纯文字提示用量限制,以及需要打开的 <code>https://chatgpt.com/settings/usage</code> 地址,不提供额外按钮或链接交互;普通 429 不会被当作套餐额度耗尽。</p><h2 id="x订阅-oauth-实验性" tabindex="-1">X订阅 OAuth(实验性) <a class="header-anchor" href="#x订阅-oauth-实验性" aria-label="Permalink to &quot;X订阅 OAuth(实验性)&quot;">​</a></h2><p>在“OAuth 凭据”中选择“添加 OAuth 凭据”,类型选择 <strong>X订阅 OAuth(实验性)</strong>,填写名称、归属和可选 SOCKS5 URL。打开显示的 xAI 授权页面并输入设备码;不需要选择本机 Node。请确认授权页面与要绑定的账户后再同意。共享公共 OAuth 客户端可能显示 Grok Build 名称;是否允许推理取决于上游账户和订阅资格,付款金额或登录成功都不保证模型访问权。</p><p>代理格式为 <code>socks5://[username:password@]host:port</code>,特殊字符需要 URL 编码。Server 的设备码、Token 换取、身份查询、刷新、目录、额度和撤销请求,以及执行 Node 的模型请求,均使用这份配置;代理不可达时不会回退直连。Server 和执行 Node 都必须能访问代理地址,远程 Node 上的 <code>127.0.0.1</code> 不是 Server 本机。打开 xAI 授权页使用浏览器自身网络,不继承此代理。创建后可在凭据编辑中修改或清除代理,详情中可原样检查完整 URL;请勿公开截图中的代理密码。</p><p>登录成功后可以加载模型目录导入,也可以新建 Grok 模型并选择已有凭据、填写模型 ID。模型推理固定使用 <code>https://cli-chat-proxy.grok.com/v1</code>,提供 WebSocket 和 HTTP/1.1 SSE 传输选项,新建与目录导入默认 HTTP/1.1 SSE,编辑时可切换传输;Responses 续接默认关闭,此时两种传输均发送完整历史;两种传输均可手动开启 <code>previous_response_id</code>,实际支持由上游及账户决定,开启不代表兼容性保证。订阅代理的传输与续接支持不作保证;引用不存在时会回退一次完整历史,其他失败保留错误诊断。不提供速度档位、HTTP/2 或图片生成。仍使用 X 订阅 OAuth 凭据,不要求开发者 API Key;目录、身份与额度查询继续使用订阅代理。升级 Server 时会自动将误配置为开发者 API 地址的订阅模型迁回订阅代理,保留其他配置并清除旧测试状态。Hosted Web Search 可在模型表单开关,新建和目录导入默认开启;已有模型保持原配置,需编辑勾选并保存才会开启。重新导入会创建独立模型,不修改已有模型。执行 Node 必须支持新的 Responses 参数能力,否则需要升级 Node。</p><p>在凭据详情中点击“查询用量”,可手动查询本周期已用/剩余百分比、周/月周期、重置和查询时间,以及单独列出的额外美元余额。缺失值显示“—”,不是 0 或无限;不推算剩余 Token,不展示不存在的 Token 统计。查询失败不代表推理不可用;用量不会自动轮询,关闭详情会清除结果。上游可能存在额外付费余额,MAR 不自动充值或更改计费设置,也不保证订阅调用永不产生额外费用。</p><p>Token 由 Server 保存并自动刷新,执行 Node 只取得短期访问凭据;失效时可重新登录。删除未被模型引用的凭据会尽力撤销上游 refresh token,撤销失败会明确提示。此接入依赖可能变化的订阅代理协议,不建议用于要求稳定 SLA 的生产任务。</p><h2 id="配置-codex-凭据与模型目录" tabindex="-1">配置 Codex 凭据与模型目录 <a class="header-anchor" href="#配置-codex-凭据与模型目录" aria-label="Permalink to &quot;配置 Codex 凭据与模型目录&quot;">​</a></h2><p>所有用户都可从“管理 → MAR Agent 模型”进入“我的模型顺序”和自己有权管理的 OAuth 凭据视图;只有系统管理员会看到用于配置模型的“模型”Tab。选择“添加 OAuth 凭据”并选用“Codex (legacy)”时,普通成员只能创建个人凭据,组织管理员还可选择其管理组织子树内的组织凭据,系统管理员可选择组织或全企业凭据。个人凭据仅所有者可见,组织凭据仅系统管理员和覆盖该组织的组织管理员可见,全企业凭据仅系统管理员可见。填写名称、作用域及可选 SOCKS5 代理后开始设备登录;该代理仅用于 Codex OAuth 请求、模型目录请求,以及引用此凭据的 Codex 模型请求。系统显示设备码和验证页面,并按服务端间隔自动轮询;等待期间也可选择“刷新登录状态”立即查询一次。只有登录成功、Token 交换及账户校验完成后才保存凭据。取消、失败或过期的登录不会创建凭据。</p><p>凭据列表和详情分别展示当前 access token 的到期时间和 ChatGPT 上游给出的最早可刷新时间;未知的最早可刷新时间显示“—”,这两个时间都不表示 refresh token 到期。refresh token 仍有效且授权正常时,Server 会自动在临期换码;长时间运行任务的 Node 也会自动续取访问令牌和运行票据,不依赖下一次模型调用。暂时失败或返回的令牌仍临期时有界重试;持续断线或凭据失效仍需恢复连接或重新登录。手动刷新可以提前请求换码,是否成功以上游响应为准;自动续期仍遵守最早可刷新时间。真正换码成功后,列表和当前详情立即显示新的到期时间、最早可刷新时间与最近刷新时间。操作列提供“详情”“编辑”“测试”和“删除”。选择“编辑”可修改名称、作用域和 SOCKS5 代理。缩小凭据作用域时,如果已有模型授权超出新作用域,保存会被拒绝,需先收窄模型授权。详情会单独读取并原样显示当前凭据的完整 SOCKS5 URL,并提供刷新、重新登录、查询用量和加载模型目录。选择“查询用量”后,页面显示总 Token、上一日用量、连续 7 个自然日 Token 合计、当前限额窗口的已用百分比、重置时间、本次查询时间;上一日的具体日期与 UTC 偏移以小字显示在用量数值下方。即使昨日没有统计桶,也显示该日期,用量显示为“—”且不回退到更早日期;最新桶若为当地当天,仍不计入 7 天合计。统计日按 <code>America/Los_Angeles</code> 换日:夏令时为 <code>UTC-07:00</code>(UTC+8 的 15:00),冬令时为 <code>UTC-08:00</code>(UTC+8 的 16:00)。系统不会自动轮询,关闭详情后也不会保留完整代理串或用量结果。被模型引用的凭据必须先解除引用才能删除。页面不会展示自定义元数据、已导入模型数量、access token、refresh token、ID token、上游原始用量响应或 FedRAMP 标记。</p><p>选择“加载模型目录”会实时读取该凭据可见的 Codex 模型。页面逐项显示系统支持的思考强度(包括 <code>ultra</code>)、目录提供或系统归一化后的默认强度,以及真正未知的上游强度。勾选要导入的条目;只有上游未提供上下文窗口时才需要补齐,缺失最大输出不会生成输入项。目录不提供可用状态开关,导入后的模型默认启用并采用目录默认强度;传输方式和 Responses 续接等设置统一在模型视图中调整。Codex 和 ChatGPT 每次从目录导入都会创建新的独立模型,即使凭据、上游模型 ID、展示名称和归属完全相同。已有模型和授权保持不变;新模型使用导入默认配置,不继承已有模型的设置或授权。目录发生变化时页面会要求重新确认。</p><h2 id="配置使用授权" tabindex="-1">配置使用授权 <a class="header-anchor" href="#配置使用授权" aria-label="Permalink to &quot;配置使用授权&quot;">​</a></h2><p>新建模型默认为“受限”,升级前已有模型会迁移为“公共”。模型列表的“使用范围”列显示当前状态:</p><ul><li>向“整个企业”授权后,模型成为公共模型。</li><li>未向整个企业授权时,可分别授权给用户或组织,模型保持受限。</li><li>系统管理员始终可以管理全部模型,不受模型授权记录限制;实际使用仍必须位于模型所绑定凭据的作用域内。</li></ul><p>点击模型行的“授权”可查看、添加或撤销授权。模型授权范围必须完全包含在所绑定凭据的作用域内,例如组织凭据不能授权给该组织子树以外的用户、组织或整个企业。普通用户的新会话模型目录只显示同时满足“已启用”“当前用户有模型授权”和“当前用户位于凭据作用域”的脱敏模型;主 Agent 和 subagent 使用同一份授权模型集合。</p><p>禁用模型后,后续新会话、消息和会话命令会被拒绝。撤销用户权限、用户离开凭据组织作用域、模型改绑或解绑凭据、凭据失效后,运行时也会在每次解析动态凭据时重新拒绝后续请求;Node 已经接收且不再需要解析凭据的工作不会被强制中止。再次打开已有 MAR Agent 对话时,如果原模型已不在当前可用目录且目录仍有模型,Web 会自动保存目录中的第一个模型,并把思考强度切换为该模型的默认值;目录为空时不会切换到其他 Agent。模型可直接删除,无需先禁用或等待活动任务结束;已经取得配置的执行可继续,后续解析该模型将按不存在失败。</p><h2 id="会话与权限" tabindex="-1">会话与权限 <a class="header-anchor" href="#会话与权限" aria-label="Permalink to &quot;会话与权限&quot;">​</a></h2><p>Node 提供 <strong>Auto</strong> 和 <strong>完全访问(Full access)</strong>。新建普通工作会话默认 Auto;已有会话保留保存的档位,进入 Goal 不会把 MAR Auto 自动升级为完全访问。独立 SDK/CLI 仍默认 Full access,托管对话保持原有隔离与权限策略。</p><p>Auto 由当前模型判断:普通工程操作和已明确授权的任务自动继续;重要风险或授权仍无法判断时 ask;deny 仅用于仍然有效的明确禁止、上级/Host 禁止或已知无法合理限制影响的极端危险。相同任务、目标和影响范围内的授权会继续复用,不因换工具、重试、分轮或子 Agent 反复询问;范围、影响扩大或用户撤回时重新判断。</p><p>Code Mode 由模型优先在外层 <code>code_exec</code> 整体声明 ask/deny。内部 deny 只拒绝该次工具调用,在结果 <code>data</code> 中返回 <code>error: MAR_AGENT_PERMISSION_DENIED</code> 和简短 <code>message</code>,不抛出 JS 异常或结束整段代码;后续依赖步骤应先检查返回结果。该工具仍记录为失败,其他异常保持原有处理方式。</p><p>ask 通过 Runner 审批卡在线等待,显示公开原因、命令/参数/代码、工作目录与到期时间。点击允许后执行已捕获的原调用;多个请求分别审批。10 分钟未决定即过期,不执行,也不视为用户拒绝。拒绝、过期和模型 deny 仅使该次调用失败,模型可在剩余授权内继续或自然停止;不能自动重试或绕过用户拒绝。取消后、已决定或过期的卡片不可执行。Goal 与定时任务沿用 Node 现有策略。无在线通道的独立 SDK/CLI 在 ask 时停止;之后的新指令不会重放旧调用。</p><p><strong>Auto 不是操作系统沙箱,也不是独立安全审查器。</strong> Full access 不做 Auto 自评,两种档位都保留 Host 路径与资源校验,工具使用 Node 服务账号的实际权限。请使用低权限专用账号并限制 Workspace 和主机权限。</p><p>原生会话记录保存在 Node 运行账号的 <code>~/.mar/agent/sessions/</code>。Server 不保存会话正文。MAR Agent 支持 Plan、Compact、question、Todo、MCP、图片和 subagent。每个 subagent 都是独立持久化的子会话,保留自己的历史和父子关系,但默认会话列表只显示用户根会话;Agent Network 支持根会话、子会话和孙会话三层,不支持第四层。目标模式由 Node 的统一 Goal 流程管理,不在 Agent SDK 内重复实现。</p><p>MAR Agent 会扫描 HOME 与工作区中的标准 Skill 目录,先向模型提供名称和用途摘要;用户请求明确命中某个 Skill 时,再加载该 Skill 的完整工作流和资源目录。无需在请求中写出 Skill 名称。 同名技能按 Workspace、用户、SDK 内置的顺序选择;项目可以定制指导,但不能改变工具参数或主机权限。</p><h3 id="命令执行环境" tabindex="-1">命令执行环境 <a class="header-anchor" href="#命令执行环境" aria-label="Permalink to &quot;命令执行环境&quot;">​</a></h3><p><code>exec</code> 默认启用登录配置。Bash 按原生顺序读取首个可读的 <code>~/.bash_profile</code>、<code>~/.bash_login</code> 或 <code>~/.profile</code>,并在 <code>BASH_ENV</code> 未设置或为空时补加载可读的 <code>~/.bashrc</code>;PowerShell 默认加载启动配置。配置属于执行命令的 Node 服务账号,不是浏览器用户。每次命令启动都会重新读取配置;托管对话只读取隔离环境中可见的文件,不加载宿主账号的配置。</p><p>需要跳过登录初始化时,可以让 Agent 使用 <code>exec({ command: &quot;…&quot;, login: false })</code>。登录 Shell 仍是非交互模式:如果工具链 PATH 位于 <code>.bashrc</code> 的非交互 <code>return</code> 后面,应将这类通用环境配置放到登录配置中,或移到该提前返回之前。MAR 不会绕过这个保护,也不会把一次命令中的 <code>export</code> 写回 Node 或后续独立命令。</p><h3 id="子-agent-高级控制" tabindex="-1">子 Agent 高级控制 <a class="header-anchor" href="#子-agent-高级控制" aria-label="Permalink to &quot;子 Agent 高级控制&quot;">​</a></h3><p>Node Agent Network 不设置旧的 16 个创建或并发限制;独立 SDK Subagent 扩展保留自己的准入策略。</p><p>协作工具为 <code>agent_start</code>、<code>agent_send</code>、<code>agent_wait</code>、<code>agent_stop</code>、<code>agent_list</code> 和 <code>agent_view</code>。<code>agent_start</code> 使用文本任务和非空标题,登记子会话和首个执行后即返回,不等待完成;手动 marctl 创建时标题可省略。使用结果中的 <code>agentId</code> 寻址子会话。<code>agent_send</code> 可发送文本消息、更新 Goal 或对获授权会话的审批作决定;可指定投递意图,包括替换当前执行。<code>agent_wait</code> 默认等待直接子会话终态 30 秒,<code>waitMs=0</code> 只查看快照,正数按传入时长等待。<code>agent_stop</code> 只需会话 ID,停止目标当前执行并清除 Goal;列表和查看工具用于发现获授权的会话及其状态。</p><p><code>agent_view</code> 仅接受 <code>agentId</code>,返回状态、当前 Goal 和有界最近活动,不公开 Run 或 Execution ID,不读取会话历史。完整记录通过独立的 <code>marctl agents history &lt;session-id&gt;</code> 按需分页查询;<code>marctl agents view</code> 遵循相同的状态查询边界。</p><p>目标空闲且没有当前或保留执行时,<code>agent_wait</code> 返回 <code>AGENT_IDLE</code>,摘要明确说明“Agent is idle; there is no execution to wait for.”,不表示会话不存在或任务失败。空闲会话若仍保有真实终态执行,则正常返回该执行结果。省略目标且没有子会话时返回 <code>AGENT_WAIT_NO_TARGETS</code>;显式目标不存在时返回 <code>SESSION_NOT_FOUND</code>。等待不会启动空闲会话。</p><p>同一获授权 Node/Workspace 内,消息、显式等待、Goal、停止、审批及 marctl 会话设置均不按父子关系限制;目标 Run/队列用户归属、模型及资源授权仍有效。发送不建立横向自动订阅。</p><p>子 Agent 的未读公开消息与新终态会在父 Agent 下一次正常模型请求前自动送达,包括原生 Extension API 创建的直接子 Agent;父 Agent 无需反复使用 message wait 检查进展。自动送达不唤醒空闲父 Agent,也不延迟正常最终回复;交付所必需的结果仍应在结束前主动汇合,真正阻塞时仍可使用 <code>agent_wait</code>。自动送达与模型的显式等待共享已读位置,因此已经送达的正文或终态证据不会在后续等待中重复返回。子 Agent 的内容是待核验的上下文,不是新的用户指令或授权。</p><p>Node 原生 <code>agent_send</code> 使用 <code>delivery</code> 参数,取值为 <code>STEER</code> 或 <code>QUEUE</code>。携带正文时,省略该参数默认使用 <code>STEER</code>;纯 Goal 更新或审批操作不受影响,公共消息接口和 CLI 的默认值不变。其他 Runner 使用 <code>marctl agents send &lt;id&gt; --steer -m &lt;text&gt;</code>。及时沟通建议优先使用 STEER;QUEUE 更适合用户或接收方明确要求延后的输入。输入要等当前工作和前面的队列项结束后才消费,有活动 Goal 时,必须等到该 Goal 退出才消费。已接收不保证立即处理。</p><p>消息被接受后,通常无需另外回复或索取收悉确认,也不必仅为确认收到而立即查看会话。主、子 Agent 建议并行推进有意义且不重叠的工作;没有其他本地工作可做,且需要结果解除阻塞或收尾时,再考虑等待。必要的任务结果、澄清、阻塞、冲突和决策信息仍应正常交付。</p><p>原生 <code>agent_list</code> 只接受 <code>scope</code>、可选标题片段 <code>query</code> 和 <code>limit</code>。省略 <code>scope</code> 或选择 <code>tree</code> 时,返回当前会话所在的协作树,包括已登记且获授权的根、祖先、同级及后代;空闲及已结束执行的会话也保留。选择 <code>active</code> 时,返回当前 Workspace 内正在运行或睡眠的会话,不把最近聊过、Goal 已启用或队列非空当作活跃。已知会话应直接复用其 ID,不按标题自动选址或派发。</p><p><code>query</code> 在选定范围内按标题片段过滤,忽略首尾空白及大小写,并统一全角等兼容字符;<code>limit</code> 默认 10、上限 100。结果为 <code>scope</code>、<code>currentAgentId</code>、扁平 <code>sessions</code> 和 <code>truncated</code>,每项只含 <code>id</code>、<code>parentSessionId</code>、<code>title</code> 和 <code>status</code>(<code>RUNNING</code>、<code>SLEEPING</code> 或 <code>IDLE</code>)。两种范围均按活跃优先、最近活动时间倒序排列,通过 parentSessionId 保留树关系;父项可能因过滤或授权不在结果中。无匹配返回空列表,超过 limit 时标记截断,不提供 cursor 或翻页;可用 query 缩小范围。列表不扫描 Runner、不恢复执行、不自动订阅。<code>marctl agents list</code> 使用相同参数和返回字段;独立终端没有当前会话时默认 active,currentAgentId 为 null,显式 tree 会报缺少会话上下文。</p><div class="language-js vp-adaptive-theme"><button title="Copy Code" class="copy"></button><span class="lang">js</span><pre class="shiki shiki-themes github-light github-dark vp-code" tabindex="0"><code><span class="line"><span style="--shiki-light:#D73A49;--shiki-dark:#F97583;">await</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;"> tools.</span><span style="--shiki-light:#6F42C1;--shiki-dark:#B392F0;">agent_list</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">({});</span></span>
22
22
  <span class="line"><span style="--shiki-light:#D73A49;--shiki-dark:#F97583;">await</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;"> tools.</span><span style="--shiki-light:#6F42C1;--shiki-dark:#B392F0;">agent_list</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">({ scope: </span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;">&#39;active&#39;</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">, query: </span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;">&#39;review&#39;</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">, limit: </span><span style="--shiki-light:#005CC5;--shiki-dark:#79B8FF;">20</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;"> });</span></span></code></pre></div><p><code>sleep({ durationMs })</code> 提供有界定时等待,时长必须为 1 至 1800000 的整数毫秒(最长 30 分钟)。已接受的用户补充或子 Agent 未读公开消息会提前唤醒;消息随后沿正常路径自动注入并标记已读,不会重复唤醒。它不会监测外部条件,也不会因进程或 cell 完成而唤醒;已有资源应使用对应的 wait。<code>sleep</code> 始终由模型直接调用,不可在 Code Mode cell 内调用。</p><p><code>agent_wait</code> 也支持指定一组子 Agent:</p><div class="language-js vp-adaptive-theme"><button title="Copy Code" class="copy"></button><span class="lang">js</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;">agent_wait</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">({</span></span>
23
23
  <span class="line"><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;"> agentIds: [</span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;">&#39;a&#39;</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">, </span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;">&#39;b&#39;</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">, </span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;">&#39;c&#39;</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">], </span><span style="--shiki-light:#6A737D;--shiki-dark:#6A737D;">// Replace with IDs returned by agent_start.</span></span>
24
24
  <span class="line"><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;"> mode: </span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;">&#39;all&#39;</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">,</span></span>
@@ -64,7 +64,7 @@
64
64
  <span class="line"><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">} </span><span style="--shiki-light:#D73A49;--shiki-dark:#F97583;">finally</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;"> {</span></span>
65
65
  <span class="line"><span style="--shiki-light:#D73A49;--shiki-dark:#F97583;"> await</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;"> agent.</span><span style="--shiki-light:#6F42C1;--shiki-dark:#B392F0;">dispose</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">();</span></span>
66
66
  <span class="line"><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">}</span></span></code></pre></div><p>该示例只展示终态;需要增量事件时遍历 <code>session.run(...)</code> 返回的 execution handle,并在结束时等待 <code>result()</code>。自定义 Host 必须自行提供其声明的能力和权限边界;LocalAgentHost 不替代操作系统隔离。</p><p>下一步:<a href="./runner-troubleshooting">Agent 不可用或模型缺失</a>。</p><p>图片生成与桌面工具由 Node 提供。独立 SDK/CLI 保留通用工具与自定义 Skill,但不默认提供这两类能力;其他宿主需要自行集成。</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/runners/claude-code" data-v-579b47ad><!--[--><span class="desc" data-v-579b47ad>上一篇</span><span class="title" data-v-579b47ad>安装、配置和使用 Claude Code</span><!--]--></a></div><div class="pager" data-v-579b47ad><a class="VPLink link pager-link next" href="/docs/runners/runner-troubleshooting" data-v-579b47ad><!--[--><span class="desc" data-v-579b47ad>下一篇</span><span class="title" data-v-579b47ad>Agent 不可用或模型缺失</span><!--]--></a></div></nav></footer><!--[--><!--]--></div></div></div><!--[--><!--]--></div></div><!----><!--[--><!--]--></div></div>
67
- <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>
67
+ <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\":\"CVLEsGB6\",\"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\":\"Bbi7-zH2\",\"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\":\"CG_VFxvG\",\"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\":\"GCAYq1LT\",\"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\":\"770EzfaT\",\"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\":\"DDevql7U\",\"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\":\"D46Ec15e\",\"en-us_getting-started_overview.md\":\"CB-43rGR\",\"en-us_getting-started_prerequisites.md\":\"BFxGOlUy\",\"en-us_getting-started_register-workspace.md\":\"D3j75IC2\",\"en-us_getting-started_server-installation.md\":\"C7SjGDJt\",\"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\":\"DmGpnorE\",\"en-us_workbench_files.md\":\"C8TPSXY9\",\"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\":\"CIYjFmiu\",\"getting-started_overview.md\":\"Cv-HSfAh\",\"getting-started_prerequisites.md\":\"DjWWTA7V\",\"getting-started_register-workspace.md\":\"BW-xjHjl\",\"getting-started_server-installation.md\":\"BsEfVH6b\",\"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\":\"BiQVVks4\",\"workbench_files.md\":\"D1inV8ws\",\"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\":\"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>
68
68
 
69
69
  </body>
70
70
  </html>