[{"data":1,"prerenderedAt":566},["ShallowReactive",2],{"docs-doc-zh-CN-ai-assistant":3,"docs-list-zh-CN":468},{"doc":4,"locale":465,"available":466},{"id":5,"title":6,"body":7,"description":453,"extension":454,"group":455,"meta":456,"navigation":457,"order":458,"path":459,"section":460,"seo":461,"stem":462,"updated":463,"__hash__":464},"docs_zh\u002Fdocs\u002Fai-assistant.md","智能助手",{"type":8,"value":9,"toc":445},"minimark",[10,14,23,26,29,47,50,53,56,63,71,226,229,232,377,384,387,394,397,400,441],[11,12,13],"h2",{"id":13},"它是什么",[15,16,17,18,22],"p",{},"「星际枢纽」可以启动一个",[19,20,21],"strong",{},"只监听本机回环地址","的 MCP 服务，让你的 AI 客户端（支持 MCP 的桌面工具）查询本地战役、作品、下载任务与每周突变数据，并在你确认后激活或卸载战役。",[15,24,25],{},"服务默认关闭，也不会随应用自动启动，每次都要手动开启。它与账号、官方在线服务无关，不需要登录。",[11,27,28],{"id":28},"开启服务",[30,31,32,36,44],"ol",{},[33,34,35],"li",{},"打开「设置 → 功能管理」，把「智能助手」开关打开，侧栏才会出现「智能助手」。",[33,37,38,39,43],{},"进入「智能助手 → 服务配置」，确认端口（默认 ",[40,41,42],"code",{},"17861","，可用范围 1024–65535）。",[33,45,46],{},"点「启动服务」，状态徽章变为「运行中」。",[15,48,49],{},"停止有三种方式：点「停止服务」、关闭功能管理里的开关、退出应用。",[15,51,52],{},"端口被占用时提示「端口已被占用，请更换端口后重试。」，换一个端口再启动即可。",[11,54,55],{"id":55},"连接客户端",[15,57,58,59,62],{},"服务地址是 ",[40,60,61],{},"http:\u002F\u002F127.0.0.1:\u003C端口>\u002Fmcp","，需要携带令牌访问：",[30,64,65,68],{},[33,66,67],{},"点「显示令牌」查看，或直接「复制令牌」。",[33,69,70],{},"点「复制连接配置」，得到一段可直接粘进客户端配置的 JSON：",[72,73,78],"pre",{"className":74,"code":75,"language":76,"meta":77,"style":77},"language-json shiki shiki-themes material-theme-lighter github-light github-dark","{\n  \"mcpServers\": {\n    \"scnexus\": {\n      \"type\": \"http\",\n      \"url\": \"http:\u002F\u002F127.0.0.1:17861\u002Fmcp\",\n      \"headers\": { \"Authorization\": \"Bearer \u003C令牌>\" }\n    }\n  }\n}\n","json","",[40,79,80,89,109,125,152,173,208,214,220],{"__ignoreMap":77},[81,82,85],"span",{"class":83,"line":84},"line",1,[81,86,88],{"class":87},"sP7_E","{\n",[81,90,92,96,100,103,106],{"class":83,"line":91},2,[81,93,95],{"class":94},"s39Yj","  \"",[81,97,99],{"class":98},"sseR_","mcpServers",[81,101,102],{"class":94},"\"",[81,104,105],{"class":87},":",[81,107,108],{"class":87}," {\n",[81,110,112,115,119,121,123],{"class":83,"line":111},3,[81,113,114],{"class":94},"    \"",[81,116,118],{"class":117},"sZMiF","scnexus",[81,120,102],{"class":94},[81,122,105],{"class":87},[81,124,108],{"class":87},[81,126,128,131,135,137,139,143,147,149],{"class":83,"line":127},4,[81,129,130],{"class":94},"      \"",[81,132,134],{"class":133},"srdBf","type",[81,136,102],{"class":94},[81,138,105],{"class":87},[81,140,142],{"class":141},"sjJ54"," \"",[81,144,146],{"class":145},"s_sjI","http",[81,148,102],{"class":141},[81,150,151],{"class":87},",\n",[81,153,155,157,160,162,164,166,169,171],{"class":83,"line":154},5,[81,156,130],{"class":94},[81,158,159],{"class":133},"url",[81,161,102],{"class":94},[81,163,105],{"class":87},[81,165,142],{"class":141},[81,167,168],{"class":145},"http:\u002F\u002F127.0.0.1:17861\u002Fmcp",[81,170,102],{"class":141},[81,172,151],{"class":87},[81,174,176,178,181,183,185,188,190,194,196,198,200,203,205],{"class":83,"line":175},6,[81,177,130],{"class":94},[81,179,180],{"class":133},"headers",[81,182,102],{"class":94},[81,184,105],{"class":87},[81,186,187],{"class":87}," {",[81,189,142],{"class":94},[81,191,193],{"class":192},"swQdS","Authorization",[81,195,102],{"class":94},[81,197,105],{"class":87},[81,199,142],{"class":141},[81,201,202],{"class":145},"Bearer \u003C令牌>",[81,204,102],{"class":141},[81,206,207],{"class":87}," }\n",[81,209,211],{"class":83,"line":210},7,[81,212,213],{"class":87},"    }\n",[81,215,217],{"class":83,"line":216},8,[81,218,219],{"class":87},"  }\n",[81,221,223],{"class":83,"line":222},9,[81,224,225],{"class":87},"}\n",[15,227,228],{},"令牌在每次启动应用时重新生成，只存在内存里。重启应用或点「重新生成令牌」后，旧配置立即失效，需要重新复制。重新生成会断开所有已连接的客户端。",[11,230,231],{"id":231},"提供的工具",[233,234,235,251],"table",{},[236,237,238],"thead",{},[239,240,241,245,248],"tr",{},[242,243,244],"th",{},"工具",[242,246,247],{},"用途",[242,249,250],{},"权限",[252,253,254,266,276,286,296,306,316,326,336,347,357,367],"tbody",{},[239,255,256,260,263],{},[257,258,259],"td",{},"获取应用状态",[257,261,262],{},"查看应用与游戏配置状态",[257,264,265],{},"只读",[239,267,268,271,274],{},[257,269,270],{},"查询战役列表",[257,272,273],{},"浏览已安装战役",[257,275,265],{},[239,277,278,281,284],{},[257,279,280],{},"查看战役详情",[257,282,283],{},"按本地标识查看单个战役",[257,285,265],{},[239,287,288,291,294],{},[257,289,290],{},"查询自制作品",[257,292,293],{},"浏览已安装的地图与模组",[257,295,265],{},[239,297,298,301,304],{},[257,299,300],{},"查询下载列表",[257,302,303],{},"查看可见的下载任务摘要",[257,305,265],{},[239,307,308,311,314],{},[257,309,310],{},"获取任务状态",[257,312,313],{},"查询单个任务的进度",[257,315,265],{},[239,317,318,321,324],{},[257,319,320],{},"查询突变因子",[257,322,323],{},"搜索并分页查看突变因子",[257,325,265],{},[239,327,328,331,334],{},[257,329,330],{},"查询每周突变",[257,332,333],{},"查看指定地区的本周突变",[257,335,265],{},[239,337,338,341,344],{},[257,339,340],{},"激活战役",[257,342,343],{},"无冲突时直接激活已安装战役",[257,345,346],{},"修改游戏文件",[239,348,349,352,355],{},[257,350,351],{},"切换战役",[257,353,354],{},"先还原当前战役，再激活目标战役",[257,356,346],{},[239,358,359,362,365],{},[257,360,361],{},"还原战役",[257,363,364],{},"停用战役并还原原始文件",[257,366,346],{},[239,368,369,372,375],{},[257,370,371],{},"卸载战役",[257,373,374],{},"卸载已安装战役",[257,376,346],{},[15,378,379,380,383],{},"修改类工具默认每次都要在弹窗里确认。战役激活、切换、还原、卸载四张卡片上可以打开「始终自动批准」，打开时会先弹一次风险确认；即使开启，",[19,381,382],{},"文件冲突仍要回到应用界面手动处理","，自动批准只跳过工具级确认，不会跨工具生效。",[11,385,386],{"id":386},"操作记录",[15,388,389,390,393],{},"「操作记录」页只保留最近 500 条，且仅在内存中：记录工具名、状态（执行中 \u002F 成功 \u002F 失败 \u002F 已取消）、开始时间与耗时，",[19,391,392],{},"不记录请求参数","，应用重启即清空。需要长期日志请到「设置 → 日志与隐私 → 日志目录」。",[11,395,396],{"id":396},"安全边界",[15,398,399],{},"服务在设计上限制得比较死，了解这些能省去排查时间：",[401,402,403,410,417,427,438],"ul",{},[33,404,405,406,409],{},"只监听 ",[40,407,408],{},"127.0.0.1","，不接受外部地址访问。",[33,411,412,413,416],{},"每次请求都校验 ",[40,414,415],{},"Authorization: Bearer \u003C令牌>","，令牌错误直接 401。",[33,418,419,422,423,426],{},[40,420,421],{},"Host"," 必须严格是本机地址，请求带 ",[40,424,425],{},"Origin"," 头会被拒绝（403）——浏览器页面无法调用，只有能自定义请求头的本机客户端才行。",[33,428,429,430,433,434,437],{},"只接受 ",[40,431,432],{},"POST \u002Fmcp","、",[40,435,436],{},"Content-Type: application\u002Fjson","，请求体上限 64 KiB，并发上限 16。",[33,439,440],{},"不提供任意命令执行、任意文件读写或启动下载的能力。",[442,443,444],"style",{},"html pre.shiki code .sP7_E, html code.shiki .sP7_E{--shiki-light:#39ADB5;--shiki-default:#24292E;--shiki-dark:#E1E4E8}html pre.shiki code .s39Yj, html code.shiki .s39Yj{--shiki-light:#39ADB5;--shiki-default:#005CC5;--shiki-dark:#79B8FF}html pre.shiki code .sseR_, html code.shiki .sseR_{--shiki-light:#9C3EDA;--shiki-default:#005CC5;--shiki-dark:#79B8FF}html pre.shiki code .sZMiF, html code.shiki .sZMiF{--shiki-light:#E2931D;--shiki-default:#005CC5;--shiki-dark:#79B8FF}html pre.shiki code .srdBf, html code.shiki .srdBf{--shiki-light:#F76D47;--shiki-default:#005CC5;--shiki-dark:#79B8FF}html pre.shiki code .sjJ54, html code.shiki .sjJ54{--shiki-light:#39ADB5;--shiki-default:#032F62;--shiki-dark:#9ECBFF}html pre.shiki code .s_sjI, html code.shiki .s_sjI{--shiki-light:#91B859;--shiki-default:#032F62;--shiki-dark:#9ECBFF}html pre.shiki code .swQdS, html code.shiki .swQdS{--shiki-light:#E53935;--shiki-default:#005CC5;--shiki-dark:#79B8FF}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);}",{"title":77,"searchDepth":111,"depth":111,"links":446},[447,448,449,450,451,452],{"id":13,"depth":91,"text":13},{"id":28,"depth":91,"text":28},{"id":55,"depth":91,"text":55},{"id":231,"depth":91,"text":231},{"id":386,"depth":91,"text":386},{"id":396,"depth":91,"text":396},"把本地数据与本机 AI 客户端连起来的受控 MCP 服务","md","usage",{},true,90,"\u002Fdocs\u002Fai-assistant","app",{"title":6,"description":453},"docs\u002Fai-assistant","2026-11-01","9HWQohR2RLPElTrJMG0PYOLvk71knSDQUN3_PCvRf-s","zh-CN",[465,467],"en",[469,475,479,484,489,493,497,502,506,510,515,519,524,529,534,539,544,545,550,555,561],{"path":470,"title":471,"description":472,"order":84,"group":473,"section":474,"contentLocale":465},"\u002Fdocs\u002Feditor","创作流程概览","从在《星际争霸II》编辑器中制作，到打包、分发与更新，说明星际枢纽在创作流程里承担的环节。","start","editor",{"path":476,"title":477,"description":478,"order":84,"group":473,"section":460,"contentLocale":465},"\u002Fdocs\u002Foverview","快速开始","「星际枢纽」是一款专为星际社区服务的枢纽应用",{"path":480,"title":481,"description":482,"order":84,"group":483,"section":483,"contentLocale":465},"\u002Fdocs\u002Freference","概述","收录导入、安装与分发内容时依赖的压缩包与安装源约定。","reference",{"path":485,"title":486,"description":487,"order":488,"group":455,"section":460,"contentLocale":465},"\u002Fdocs\u002Fcampaign","战役管理","把自制战役导入战役库、激活到游戏，并随时恢复官方战役",10,{"path":490,"title":491,"description":492,"order":488,"group":455,"section":474,"contentLocale":465},"\u002Fdocs\u002Fpackaging","打包安装包","把编辑器产出的地图、模组与 package.json 组织成一个能被星际枢纽自动识别并安装的压缩包。",{"path":494,"title":495,"description":496,"order":488,"group":483,"section":483,"contentLocale":465},"\u002Fdocs\u002Fscnexus-package","星际枢纽压缩包标准","星际枢纽作品包的目录结构、package.json 清单字段、地图与模组资源声明、启动器与包内资料的写法。",{"path":498,"title":499,"description":500,"order":501,"group":483,"section":483,"contentLocale":465},"\u002Fdocs\u002Fccm-package","CCM 压缩包标准","CCM 用 metadata.txt 描述战役的键值格式、目录布局与安装落点，以及星际枢纽读取这类包时的处理方式。",20,{"path":503,"title":504,"description":505,"order":501,"group":455,"section":460,"contentLocale":465},"\u002Fdocs\u002Fcustomize","自制作品","把地图与模组直接装进游戏，指定启动器地图后一键启动",{"path":507,"title":508,"description":509,"order":501,"group":455,"section":474,"contentLocale":465},"\u002Fdocs\u002Ftoolbox","创作工具 · 编码转换","把中文等非 ASCII 文本转成 Galaxy 代码里可用的转义写法，可选直接转码、字符串、文本与触发调试四种输出。",{"path":511,"title":512,"description":513,"order":514,"group":483,"section":483,"contentLocale":465},"\u002Fdocs\u002Fgithub-source","GitHub 安装源标准","把公开 GitHub 仓库当作安装源时，仓库需要满足的清单与结构要求，以及地址与分支的写法。",30,{"path":516,"title":517,"description":518,"order":514,"group":455,"section":460,"contentLocale":465},"\u002Fdocs\u002Fweekly-mutations","每周突变","查看本周突变的地图、因子与社区评分，并查阅全部突变因子",{"path":520,"title":521,"description":522,"order":523,"group":455,"section":460,"contentLocale":465},"\u002Fdocs\u002Freplays","录像管理","按星际资料与录像类型索引录像，支持去重、批量导出与对局数据查看",40,{"path":525,"title":526,"description":527,"order":528,"group":455,"section":460,"contentLocale":465},"\u002Fdocs\u002Fworkshop","创意工坊","浏览社区作品、查看详情并下载已审核的发布版本",50,{"path":530,"title":531,"description":532,"order":533,"group":455,"section":460,"contentLocale":465},"\u002Fdocs\u002Fcreator","创作者中心与上传管理","创建作品、维护资料、上传新版本并跟踪上传任务",60,{"path":535,"title":536,"description":537,"order":538,"group":455,"section":460,"contentLocale":465},"\u002Fdocs\u002Fdownloads","下载管理","从 GitHub 或创意工坊取回内容，确认后安装到游戏",70,{"path":540,"title":541,"description":542,"order":543,"group":455,"section":460,"contentLocale":465},"\u002Fdocs\u002Ftools","创作工具","编码转换等本地辅助工具，输入不会上传也不会保存",80,{"path":459,"title":6,"description":453,"order":458,"group":455,"section":460,"contentLocale":465},{"path":546,"title":547,"description":548,"order":549,"group":455,"section":460,"contentLocale":465},"\u002Fdocs\u002Faccount","账号与个人中心","登录、资料与等级成长，以及两步验证的开启与维护",100,{"path":551,"title":552,"description":553,"order":554,"group":455,"section":460,"contentLocale":465},"\u002Fdocs\u002Fsettings","设置","语言、游戏目录、功能开关与日志隐私，四个标签页逐项说明",110,{"path":556,"title":557,"description":558,"order":559,"group":560,"section":460,"contentLocale":465},"\u002Fdocs\u002Fcontributing","参与开发","参与「星际枢纽」开发的方式：仓库分工、开发环境、提交前检查、代码与文档约定、行为准则，以及安全问题的报告渠道。",200,"contribute",{"path":562,"title":563,"description":564,"order":565,"group":560,"section":460,"contentLocale":465},"\u002Fdocs\u002Flocalization","贡献翻译","界面翻译文件的位置与键名规则、提交流程、本地验证方法，以及新增一门界面语言需要改动的代码位置。",210,1793550745232]