[{"data":1,"prerenderedAt":891},["ShallowReactive",2],{"navigation":3,"\u002Fzh\u002Fhow-to\u002Fruntimes":129,"\u002Fzh\u002Fhow-to\u002Fruntimes-surround":886},[4,68],{"title":5,"path":6,"stem":7,"children":8,"page":22},"En","\u002Fen","en",[9,13,23],{"title":10,"path":11,"stem":12},"Product Overview","\u002Fen\u002Fintroduction","en\u002F0.introduction",{"title":14,"path":15,"stem":16,"children":17,"page":22},"Tutorials","\u002Fen\u002Ftutorials","en\u002F1.tutorials",[18],{"title":19,"path":20,"stem":21},"Quick Start","\u002Fen\u002Ftutorials\u002Fquickstart","en\u002F1.tutorials\u002Fquickstart",false,{"title":24,"path":25,"stem":26,"children":27,"page":22},"How To","\u002Fen\u002Fhow-to","en\u002F2.how-to",[28,32,36,40,44,48,52,56,60,64],{"title":29,"path":30,"stem":31},"Canvas Workspace","\u002Fen\u002Fhow-to\u002Fcanvas","en\u002F2.how-to\u002Fcanvas",{"title":33,"path":34,"stem":35},"Configuration","\u002Fen\u002Fhow-to\u002Fconfigure","en\u002F2.how-to\u002Fconfigure",{"title":37,"path":38,"stem":39},"Scheduled Tasks","\u002Fen\u002Fhow-to\u002Fcron-jobs","en\u002F2.how-to\u002Fcron-jobs",{"title":41,"path":42,"stem":43},"Configuring System Service","\u002Fen\u002Fhow-to\u002Finstall","en\u002F2.how-to\u002Finstall",{"title":45,"path":46,"stem":47},"Managing Instructions","\u002Fen\u002Fhow-to\u002Finstructions","en\u002F2.how-to\u002Finstructions",{"title":49,"path":50,"stem":51},"MCP Servers","\u002Fen\u002Fhow-to\u002Fmcp-servers","en\u002F2.how-to\u002Fmcp-servers",{"title":53,"path":54,"stem":55},"Managing Profiles","\u002Fen\u002Fhow-to\u002Fprofiles","en\u002F2.how-to\u002Fprofiles",{"title":57,"path":58,"stem":59},"Configuring Runtimes","\u002Fen\u002Fhow-to\u002Fruntimes","en\u002F2.how-to\u002Fruntimes",{"title":61,"path":62,"stem":63},"Managing Skills","\u002Fen\u002Fhow-to\u002Fskills","en\u002F2.how-to\u002Fskills",{"title":65,"path":66,"stem":67},"VS Code Integration","\u002Fen\u002Fhow-to\u002Fvscode","en\u002F2.how-to\u002Fvscode",{"title":69,"path":70,"stem":71,"children":72,"page":22},"Zh","\u002Fzh","zh",[73,77,85],{"title":74,"path":75,"stem":76},"产品概述","\u002Fzh\u002Fintroduction","zh\u002F0.introduction",{"title":14,"path":78,"stem":79,"children":80,"page":22},"\u002Fzh\u002Ftutorials","zh\u002F1.tutorials",[81],{"title":82,"path":83,"stem":84},"快速开始","\u002Fzh\u002Ftutorials\u002Fquickstart","zh\u002F1.tutorials\u002Fquickstart",{"title":24,"path":86,"stem":87,"children":88,"page":22},"\u002Fzh\u002Fhow-to","zh\u002F2.how-to",[89,93,97,101,105,109,113,117,121,125],{"title":90,"path":91,"stem":92},"Canvas 工作区","\u002Fzh\u002Fhow-to\u002Fcanvas","zh\u002F2.how-to\u002Fcanvas",{"title":94,"path":95,"stem":96},"配置","\u002Fzh\u002Fhow-to\u002Fconfigure","zh\u002F2.how-to\u002Fconfigure",{"title":98,"path":99,"stem":100},"定时任务","\u002Fzh\u002Fhow-to\u002Fcron-jobs","zh\u002F2.how-to\u002Fcron-jobs",{"title":102,"path":103,"stem":104},"配置系统服务","\u002Fzh\u002Fhow-to\u002Finstall","zh\u002F2.how-to\u002Finstall",{"title":106,"path":107,"stem":108},"管理指令文件","\u002Fzh\u002Fhow-to\u002Finstructions","zh\u002F2.how-to\u002Finstructions",{"title":110,"path":111,"stem":112},"MCP 服务器","\u002Fzh\u002Fhow-to\u002Fmcp-servers","zh\u002F2.how-to\u002Fmcp-servers",{"title":114,"path":115,"stem":116},"管理 Profile","\u002Fzh\u002Fhow-to\u002Fprofiles","zh\u002F2.how-to\u002Fprofiles",{"title":118,"path":119,"stem":120},"配置 Runtime","\u002Fzh\u002Fhow-to\u002Fruntimes","zh\u002F2.how-to\u002Fruntimes",{"title":122,"path":123,"stem":124},"管理 Skill","\u002Fzh\u002Fhow-to\u002Fskills","zh\u002F2.how-to\u002Fskills",{"title":126,"path":127,"stem":128},"VS Code 集成","\u002Fzh\u002Fhow-to\u002Fvscode","zh\u002F2.how-to\u002Fvscode",{"id":130,"title":118,"body":131,"description":880,"extension":881,"links":882,"meta":883,"navigation":424,"path":119,"seo":884,"stem":120,"__hash__":885},"docs\u002Fzh\u002F2.how-to\u002Fruntimes.md",{"type":132,"value":133,"toc":868},"minimark",[134,138,142,155,159,162,198,205,209,212,216,241,244,259,279,282,512,517,520,524,527,541,544,552,556,570,745,748,751,761,766,780,785,789,808,813,817,842,845,848,864],[135,136,137],"p",{},"本指南介绍如何在 Sink 中配置和管理 Agent Runtime。Runtime\n定义了如何启动和运行 AI Agent（如 Claude Code、Codex 等）。",[139,140,141],"h2",{"id":141},"前置条件",[143,144,145,149,152],"ul",{},[146,147,148],"li",{},"已安装 Sink 二进制文件",[146,150,151],{},"了解 Agent Client Protocol (ACP) 基本概念",[146,153,154],{},"访问互联网以从 ACP 注册中心下载 Runtime",[139,156,158],{"id":157},"什么是-runtime","什么是 Runtime",[135,160,161],{},"Runtime 是一个配置项，定义了如何启动特定 Agent 的流程：",[143,163,164,180,186,192],{},[146,165,166,170,171,175,176,179],{},[167,168,169],"strong",{},"ID",": 唯一标识符（如 ",[172,173,174],"code",{},"claude-code","、",[172,177,178],{},"codex","）",[146,181,182,185],{},[167,183,184],{},"名称与描述",": 可读的 Runtime 信息",[146,187,188,191],{},[167,189,190],{},"分发方式",": 指定如何启动 Agent（通过 npm 包或本地命令）",[146,193,194,197],{},[167,195,196],{},"环境变量",": 启动 Agent 时需要的环境配置",[135,199,200,201,204],{},"所有 Runtime 配置存储在 ",[172,202,203],{},"~\u002F.sink\u002Fruntimes.json","。",[139,206,208],{"id":207},"添加-runtime","添加 Runtime",[135,210,211],{},"最简单的方式是使用交互式命令添加 Runtime：",[213,214,215],"h3",{"id":215},"运行创建命令",[217,218,223],"pre",{"className":219,"code":220,"language":221,"meta":222,"style":222},"language-bash shiki shiki-themes material-theme-lighter material-theme material-theme-palenight","sink runtime create\n","bash","",[172,224,225],{"__ignoreMap":222},[226,227,230,234,238],"span",{"class":228,"line":229},"line",1,[226,231,233],{"class":232},"sBMFI","sink",[226,235,237],{"class":236},"sfazB"," runtime",[226,239,240],{"class":236}," create\n",[135,242,243],{},"此命令会：",[245,246,247,250,256],"ol",{},[146,248,249],{},"提示你选择「从 ACP\n注册中心」（从官方注册中心浏览和安装）或「手动输入」（手动输入\nRuntime 详细信息）",[146,251,252,253],{},"如果使用注册中心：从 ACP 注册中心获取可用的 Agent 列表（仅显示具有\nnpm 包分发方式的 Agent），显示交互式选择菜单，然后将选定的 Runtime\n写入 ",[172,254,255],{},"runtimes.json",[146,257,258],{},"如果手动输入：提示输入 Runtime ID、分发方式（npx 或\nlocal）、包名\u002F命令以及参数",[135,260,261,264,265,268,269,272,273,275,276,278],{},[167,262,263],{},"注意","：",[172,266,267],{},"runtime create"," 的 ACP 注册中心流程仅获取具有 npm\u002Fnpx\n分发方式的 Agent。这与 ",[172,270,271],{},"init"," 不同——",[172,274,271],{},"\n通过探测本地命令来检测已安装的 Builtin Runtime（Claude\nCode、Codex、Factory Droid、OpenCode）。两者都会填充\n",[172,277,255],{},"，但机制不同。",[213,280,281],{"id":281},"注册中心示例",[217,283,285],{"className":219,"code":284,"language":221,"meta":222,"style":222},"$ sink runtime create\n  ✔ Sink — Create Runtime\n  ◆ How would you like to add a runtime?\n  │  ● From ACP registry  \u002F  ○ Manual entry\n  ...\n  ✔ Fetched 5 compatible agents from ACP registry (5 total)\n\n  ✔ Select agent runtimes to install\n  ⊙ agent-x         Agent X (some-agent-x)\n  ◯ agent-y         Agent Y (some-agent-y)\n\n  ✔ Synced 1 runtime (added: 1, replaced: 0)\n",[172,286,287,299,317,347,377,384,419,426,445,463,480,485],{"__ignoreMap":222},[226,288,289,292,295,297],{"class":228,"line":229},[226,290,291],{"class":232},"$",[226,293,294],{"class":236}," sink",[226,296,237],{"class":236},[226,298,240],{"class":236},[226,300,302,305,308,311,314],{"class":228,"line":301},2,[226,303,304],{"class":232},"  ✔",[226,306,307],{"class":236}," Sink",[226,309,310],{"class":236}," —",[226,312,313],{"class":236}," Create",[226,315,316],{"class":236}," Runtime\n",[226,318,320,323,326,329,332,335,338,341,344],{"class":228,"line":319},3,[226,321,322],{"class":232},"  ◆",[226,324,325],{"class":236}," How",[226,327,328],{"class":236}," would",[226,330,331],{"class":236}," you",[226,333,334],{"class":236}," like",[226,336,337],{"class":236}," to",[226,339,340],{"class":236}," add",[226,342,343],{"class":236}," a",[226,345,346],{"class":236}," runtime?\n",[226,348,350,353,356,359,362,365,368,371,374],{"class":228,"line":349},4,[226,351,352],{"class":232},"  │",[226,354,355],{"class":236},"  ●",[226,357,358],{"class":236}," From",[226,360,361],{"class":236}," ACP",[226,363,364],{"class":236}," registry",[226,366,367],{"class":236},"  \u002F",[226,369,370],{"class":236},"  ○",[226,372,373],{"class":236}," Manual",[226,375,376],{"class":236}," entry\n",[226,378,380],{"class":228,"line":379},5,[226,381,383],{"class":382},"s2Zo4","  ...\n",[226,385,387,389,392,396,399,402,405,407,409,413,416],{"class":228,"line":386},6,[226,388,304],{"class":232},[226,390,391],{"class":236}," Fetched",[226,393,395],{"class":394},"sbssI"," 5",[226,397,398],{"class":236}," compatible",[226,400,401],{"class":236}," agents",[226,403,404],{"class":236}," from",[226,406,361],{"class":236},[226,408,364],{"class":236},[226,410,412],{"class":411},"sTEyZ"," (5 ",[226,414,415],{"class":236},"total",[226,417,418],{"class":411},")\n",[226,420,422],{"class":228,"line":421},7,[226,423,425],{"emptyLinePlaceholder":424},true,"\n",[226,427,429,431,434,437,440,442],{"class":228,"line":428},8,[226,430,304],{"class":232},[226,432,433],{"class":236}," Select",[226,435,436],{"class":236}," agent",[226,438,439],{"class":236}," runtimes",[226,441,337],{"class":236},[226,443,444],{"class":236}," install\n",[226,446,448,451,454,457,460],{"class":228,"line":447},9,[226,449,450],{"class":232},"  ⊙",[226,452,453],{"class":236}," agent-x",[226,455,456],{"class":236},"         Agent",[226,458,459],{"class":236}," X",[226,461,462],{"class":411}," (some-agent-x)\n",[226,464,466,469,472,474,477],{"class":228,"line":465},10,[226,467,468],{"class":232},"  ◯",[226,470,471],{"class":236}," agent-y",[226,473,456],{"class":236},[226,475,476],{"class":236}," Y",[226,478,479],{"class":411}," (some-agent-y)\n",[226,481,483],{"class":228,"line":482},11,[226,484,425],{"emptyLinePlaceholder":424},[226,486,488,490,493,496,498,501,504,507,510],{"class":228,"line":487},12,[226,489,304],{"class":232},[226,491,492],{"class":236}," Synced",[226,494,495],{"class":394}," 1",[226,497,237],{"class":236},[226,499,500],{"class":411}," (added: ",[226,502,503],{"class":236},"1,",[226,505,506],{"class":236}," replaced:",[226,508,509],{"class":394}," 0",[226,511,418],{"class":411},[135,513,514,516],{},[167,515,263],{},"：实际显示的 Agent 名称取决于 ACP\n注册中心的内容。以上示例仅供参考。",[135,518,519],{},"添加后，新的 Runtime 立即可用，无需重启 Gateway。",[139,521,523],{"id":522},"查看已安装的-runtime","查看已安装的 Runtime",[135,525,526],{},"查看所有已配置的 Runtime：",[217,528,530],{"className":219,"code":529,"language":221,"meta":222,"style":222},"sink runtime list\n",[172,531,532],{"__ignoreMap":222},[226,533,534,536,538],{"class":228,"line":229},[226,535,233],{"class":232},[226,537,237],{"class":236},[226,539,540],{"class":236}," list\n",[135,542,543],{},"输出示例：",[217,545,550],{"className":546,"code":548,"language":549},[547],"language-text","  ✔ Sink Runtimes\n  ℹ claude-code — Claude Code v1.0.0\n    $ npx -y @anthropic\u002Fclaude-code\n  ℹ codex — Codex v2.1.0\n    $ npx -y @anthropic\u002Fcodex --mode interactive\n  ✔ 2 runtimes installed\n","text",[172,551,548],{"__ignoreMap":222},[139,553,555],{"id":554},"禁用-runtime","禁用 Runtime",[135,557,558,559,562,563,566,567,264],{},"要禁用某个 Runtime 而不删除它，在 ",[172,560,561],{},"metadata"," 中设置 ",[172,564,565],{},"disabled"," 字段为\n",[172,568,569],{},"true",[217,571,575],{"className":572,"code":573,"language":574,"meta":222,"style":222},"language-json shiki shiki-themes material-theme-lighter material-theme material-theme-palenight","{\n  \"agentRuntimes\": {\n    \"old-agent\": {\n      \"description\": \"Old Agent\",\n      \"metadata\": {\n        \"disabled\": true\n      },\n      \"distribution\": {\n        \"npx\": {\n          \"package\": \"@myorg\u002Fold-agent\"\n        }\n      }\n    }\n  }\n}\n","json",[172,576,577,583,601,615,638,650,665,670,683,696,717,722,727,733,739],{"__ignoreMap":222},[226,578,579],{"class":228,"line":229},[226,580,582],{"class":581},"sMK4o","{\n",[226,584,585,588,592,595,598],{"class":228,"line":301},[226,586,587],{"class":581},"  \"",[226,589,591],{"class":590},"spNyl","agentRuntimes",[226,593,594],{"class":581},"\"",[226,596,597],{"class":581},":",[226,599,600],{"class":581}," {\n",[226,602,603,606,609,611,613],{"class":228,"line":319},[226,604,605],{"class":581},"    \"",[226,607,608],{"class":232},"old-agent",[226,610,594],{"class":581},[226,612,597],{"class":581},[226,614,600],{"class":581},[226,616,617,620,623,625,627,630,633,635],{"class":228,"line":349},[226,618,619],{"class":581},"      \"",[226,621,622],{"class":394},"description",[226,624,594],{"class":581},[226,626,597],{"class":581},[226,628,629],{"class":581}," \"",[226,631,632],{"class":236},"Old Agent",[226,634,594],{"class":581},[226,636,637],{"class":581},",\n",[226,639,640,642,644,646,648],{"class":228,"line":379},[226,641,619],{"class":581},[226,643,561],{"class":394},[226,645,594],{"class":581},[226,647,597],{"class":581},[226,649,600],{"class":581},[226,651,652,655,658,660,662],{"class":228,"line":386},[226,653,654],{"class":581},"        \"",[226,656,565],{"class":657},"swJcz",[226,659,594],{"class":581},[226,661,597],{"class":581},[226,663,664],{"class":581}," true\n",[226,666,667],{"class":228,"line":421},[226,668,669],{"class":581},"      },\n",[226,671,672,674,677,679,681],{"class":228,"line":428},[226,673,619],{"class":581},[226,675,676],{"class":394},"distribution",[226,678,594],{"class":581},[226,680,597],{"class":581},[226,682,600],{"class":581},[226,684,685,687,690,692,694],{"class":228,"line":447},[226,686,654],{"class":581},[226,688,689],{"class":657},"npx",[226,691,594],{"class":581},[226,693,597],{"class":581},[226,695,600],{"class":581},[226,697,698,701,705,707,709,711,714],{"class":228,"line":465},[226,699,700],{"class":581},"          \"",[226,702,704],{"class":703},"su27w","package",[226,706,594],{"class":581},[226,708,597],{"class":581},[226,710,629],{"class":581},[226,712,713],{"class":236},"@myorg\u002Fold-agent",[226,715,716],{"class":581},"\"\n",[226,718,719],{"class":228,"line":482},[226,720,721],{"class":581},"        }\n",[226,723,724],{"class":228,"line":487},[226,725,726],{"class":581},"      }\n",[226,728,730],{"class":228,"line":729},13,[226,731,732],{"class":581},"    }\n",[226,734,736],{"class":228,"line":735},14,[226,737,738],{"class":581},"  }\n",[226,740,742],{"class":228,"line":741},15,[226,743,744],{"class":581},"}\n",[135,746,747],{},"禁用的 Runtime 不会出现在 UI 中，但配置仍保留。",[139,749,750],{"id":750},"故障排除",[135,752,753,756,757,760],{},[167,754,755],{},"问题",": 运行 ",[172,758,759],{},"sink runtime create"," 时选择注册中心选项，出现连接错误",[135,762,763,597],{},[167,764,765],{},"解决方案",[143,767,768,771,777],{},[146,769,770],{},"检查网络连接",[146,772,773,774],{},"确认能访问 ACP\n注册中心：",[172,775,776],{},"curl https:\u002F\u002Fcdn.agentclientprotocol.com\u002Fregistry\u002Fv1\u002Flatest\u002Fregistry.json",[146,778,779],{},"尝试手动添加 Runtime",[135,781,782,784],{},[167,783,755],{},": Runtime 启动失败，提示”找不到命令”",[135,786,787,597],{},[167,788,765],{},[143,790,791,802,805],{},[146,792,793,794,797,798,801],{},"检查 ",[172,795,796],{},"distribution.npx.package"," 或 ",[172,799,800],{},"distribution.local.cmd"," 是否正确",[146,803,804],{},"确保 npm 包已发布或本地命令文件存在且可执行",[146,806,807],{},"检查环境变量是否正确设置",[135,809,810,812],{},[167,811,755],{},": Runtime 启动时缺少环境变量",[135,814,815,597],{},[167,816,765],{},[143,818,819,825,832],{},[146,820,821,822],{},"确认环境变量已在系统中设置：",[172,823,824],{},"echo $VAR_NAME",[146,826,827,828,831],{},"检查 Runtime 配置中 ",[172,829,830],{},"env"," 字段中的插值语法是否正确",[146,833,834,835,797,838,841],{},"若在 systemd 服务中运行，检查 ",[172,836,837],{},"EnvironmentFile",[172,839,840],{},"Environment","\n是否包含所需变量",[139,843,844],{"id":844},"后续步骤",[135,846,847],{},"配置完 Runtime 后，你可以：",[245,849,850,858],{},[146,851,852,857],{},[853,854,856],"a",{"href":855},".\u002Fprofiles","创建 Profile"," 将 Runtime 与 Agent 人格配置关联",[146,859,860,863],{},[853,861,82],{"href":862},"..\u002Ftutorials\u002Fquickstart"," 创建第一个 Task",[865,866,867],"style",{},"html pre.shiki code .sBMFI, html code.shiki .sBMFI{--shiki-light:#E2931D;--shiki-default:#FFCB6B;--shiki-dark:#FFCB6B}html pre.shiki code .sfazB, html code.shiki .sfazB{--shiki-light:#91B859;--shiki-default:#C3E88D;--shiki-dark:#C3E88D}html .light .shiki span {color: var(--shiki-light);background: var(--shiki-light-bg);font-style: var(--shiki-light-font-style);font-weight: var(--shiki-light-font-weight);text-decoration: var(--shiki-light-text-decoration);}html.light .shiki span {color: var(--shiki-light);background: var(--shiki-light-bg);font-style: var(--shiki-light-font-style);font-weight: var(--shiki-light-font-weight);text-decoration: var(--shiki-light-text-decoration);}html .default .shiki span {color: var(--shiki-default);background: var(--shiki-default-bg);font-style: var(--shiki-default-font-style);font-weight: var(--shiki-default-font-weight);text-decoration: var(--shiki-default-text-decoration);}html .shiki span {color: var(--shiki-default);background: var(--shiki-default-bg);font-style: var(--shiki-default-font-style);font-weight: var(--shiki-default-font-weight);text-decoration: var(--shiki-default-text-decoration);}html .dark .shiki span {color: var(--shiki-dark);background: var(--shiki-dark-bg);font-style: var(--shiki-dark-font-style);font-weight: var(--shiki-dark-font-weight);text-decoration: var(--shiki-dark-text-decoration);}html.dark .shiki span {color: var(--shiki-dark);background: var(--shiki-dark-bg);font-style: var(--shiki-dark-font-style);font-weight: var(--shiki-dark-font-weight);text-decoration: var(--shiki-dark-text-decoration);}html pre.shiki code .s2Zo4, html code.shiki .s2Zo4{--shiki-light:#6182B8;--shiki-default:#82AAFF;--shiki-dark:#82AAFF}html pre.shiki code .sbssI, html code.shiki .sbssI{--shiki-light:#F76D47;--shiki-default:#F78C6C;--shiki-dark:#F78C6C}html pre.shiki code .sTEyZ, html code.shiki .sTEyZ{--shiki-light:#90A4AE;--shiki-default:#EEFFFF;--shiki-dark:#BABED8}html pre.shiki code .sMK4o, html code.shiki .sMK4o{--shiki-light:#39ADB5;--shiki-default:#89DDFF;--shiki-dark:#89DDFF}html pre.shiki code .spNyl, html code.shiki .spNyl{--shiki-light:#9C3EDA;--shiki-default:#C792EA;--shiki-dark:#C792EA}html pre.shiki code .swJcz, html code.shiki .swJcz{--shiki-light:#E53935;--shiki-default:#F07178;--shiki-dark:#F07178}html pre.shiki code .su27w, html code.shiki .su27w{--shiki-light:#916B53;--shiki-default:#916B53;--shiki-dark:#916B53}",{"title":222,"searchDepth":229,"depth":301,"links":869},[870,871,872,876,877,878,879],{"id":141,"depth":301,"text":141},{"id":157,"depth":301,"text":158},{"id":207,"depth":301,"text":208,"children":873},[874,875],{"id":215,"depth":319,"text":215},{"id":281,"depth":319,"text":281},{"id":522,"depth":301,"text":523},{"id":554,"depth":301,"text":555},{"id":750,"depth":301,"text":750},{"id":844,"depth":301,"text":844},"如何注册和管理 ACP Agent Runtime","md",null,{},{"title":118,"description":880},"lZHAlQdmwuxZg_20JqXQkKT2GtzZw9lW_ZHnXZbPKTI",[887,889],{"title":114,"path":115,"stem":116,"description":888,"children":-1},"创建和配置 Agent Profile，定义 Agent 的工作风格和能力范围",{"title":122,"path":123,"stem":124,"description":890,"children":-1},"学习如何安装、配置和在 Profile 中使用 Agent Skill",1778225993673]