[{"data":1,"prerenderedAt":605},["ShallowReactive",2],{"doc-\u002Fdocs\u002Fguides\u002Fterminal":3,"doc-surround-\u002Fdocs\u002Fguides\u002Fterminal":507,"doc-nav-zh":516},{"id":4,"title":5,"body":6,"description":497,"extension":498,"meta":499,"navigation":500,"order":501,"path":502,"section":503,"seo":504,"stem":505,"__hash__":506},"docs_zh\u002Fdocs\u002F02.guides\u002F11.terminal.md","集成终端",{"type":7,"value":8,"toc":492},"minimark",[9,12,25,29,51,54,57,147,164,167,178,423,426,471,488],[10,11,5],"h1",{"id":5},[13,14,15,16,20,21,24],"p",{},"灵犀指内置基于 PTY 的集成终端，并为 AI 发起的命令提供",[17,18,19],"strong",{},"风险分级拦截","与",[17,22,23],{},"沙箱隔离","两道防线。",[26,27,5],"h2",{"id":28},"集成终端-1",[30,31,32,36,48],"ul",{},[33,34,35],"li",{},"支持多会话并行，每个会话拥有独立的工作目录与窗口尺寸。",[33,37,38,39,43,44,47],{},"默认 shell：Windows 为 PowerShell；macOS \u002F Linux 读取 ",[40,41,42],"code",{},"$SHELL"," 环境变量，缺省回退 ",[40,45,46],{},"\u002Fbin\u002Fbash","。",[33,49,50],{},"命令执行带超时控制，超时自动终止并返回已有输出。",[26,52,53],{"id":53},"危险命令拦截",[13,55,56],{},"所有命令（包括 AI 发起的）都会按五级风险分类处理：",[58,59,60,76],"table",{},[61,62,63],"thead",{},[64,65,66,70,73],"tr",{},[67,68,69],"th",{},"风险等级",[67,71,72],{},"示例",[67,74,75],{},"处理方式",[77,78,79,94,105,119,133],"tbody",{},[64,80,81,85,91],{},[82,83,84],"td",{},"Safe",[82,86,87,88],{},"读取文件、",[40,89,90],{},"git status",[82,92,93],{},"自动放行",[64,95,96,99,102],{},[82,97,98],{},"Low",[82,100,101],{},"列表查询、搜索",[82,103,104],{},"自动放行并记录",[64,106,107,110,116],{},[82,108,109],{},"Medium",[82,111,112,113],{},"写入文件、",[40,114,115],{},"git add",[82,117,118],{},"默认放行，可配置",[64,120,121,124,130],{},[82,122,123],{},"High",[82,125,126,127],{},"执行命令、",[40,128,129],{},"git push",[82,131,132],{},"需用户确认",[64,134,135,138,144],{},[82,136,137],{},"Critical",[82,139,140,141],{},"删除目录、",[40,142,143],{},"rm -rf",[82,145,146],{},"强制人工审批",[13,148,149,150,153,154,153,157,153,160,163],{},"命令字符串同时经过 shell 元字符过滤，阻断 ",[40,151,152],{},";"," ",[40,155,156],{},"|",[40,158,159],{},"&",[40,161,162],{},"$"," 等注入风险。",[26,165,166],{"id":166},"沙箱执行",[13,168,169,170,173,174,177],{},"在 ",[40,171,172],{},"lxz.config.json"," 的 ",[40,175,176],{},"sandbox"," 段开启并配置沙箱：",[179,180,181,341],"code-group",{},[182,183,189],"pre",{"className":184,"code":185,"filename":186,"language":187,"meta":188,"style":188},"language-json shiki shiki-themes tokyo-night","{\n  \"sandbox\": {\n    \"enabled\": true,\n    \"type\": \"process\",\n    \"max_memory_mb\": 512,\n    \"max_cpu_percent\": 80,\n    \"timeout_sec\": 300,\n    \"network_enabled\": false\n  }\n}\n","进程沙箱","json","",[40,190,191,200,219,240,263,280,297,314,329,335],{"__ignoreMap":188},[192,193,196],"span",{"class":194,"line":195},"line",1,[192,197,199],{"class":198},"sgJMe","{\n",[192,201,203,207,210,213,216],{"class":194,"line":202},2,[192,204,206],{"class":205},"sAklC","  \"",[192,208,176],{"class":209},"s3R4Z",[192,211,212],{"class":205},"\"",[192,214,215],{"class":205},":",[192,217,218],{"class":198}," {\n",[192,220,222,225,229,231,233,237],{"class":194,"line":221},3,[192,223,224],{"class":205},"    \"",[192,226,228],{"class":227},"sySf4","enabled",[192,230,212],{"class":205},[192,232,215],{"class":205},[192,234,236],{"class":235},"sOJ5S"," true",[192,238,239],{"class":205},",\n",[192,241,243,245,248,250,252,255,259,261],{"class":194,"line":242},4,[192,244,224],{"class":205},[192,246,247],{"class":227},"type",[192,249,212],{"class":205},[192,251,215],{"class":205},[192,253,254],{"class":205}," \"",[192,256,258],{"class":257},"sPY7s","process",[192,260,212],{"class":205},[192,262,239],{"class":205},[192,264,266,268,271,273,275,278],{"class":194,"line":265},5,[192,267,224],{"class":205},[192,269,270],{"class":227},"max_memory_mb",[192,272,212],{"class":205},[192,274,215],{"class":205},[192,276,277],{"class":235}," 512",[192,279,239],{"class":205},[192,281,283,285,288,290,292,295],{"class":194,"line":282},6,[192,284,224],{"class":205},[192,286,287],{"class":227},"max_cpu_percent",[192,289,212],{"class":205},[192,291,215],{"class":205},[192,293,294],{"class":235}," 80",[192,296,239],{"class":205},[192,298,300,302,305,307,309,312],{"class":194,"line":299},7,[192,301,224],{"class":205},[192,303,304],{"class":227},"timeout_sec",[192,306,212],{"class":205},[192,308,215],{"class":205},[192,310,311],{"class":235}," 300",[192,313,239],{"class":205},[192,315,317,319,322,324,326],{"class":194,"line":316},8,[192,318,224],{"class":205},[192,320,321],{"class":227},"network_enabled",[192,323,212],{"class":205},[192,325,215],{"class":205},[192,327,328],{"class":235}," false\n",[192,330,332],{"class":194,"line":331},9,[192,333,334],{"class":198},"  }\n",[192,336,338],{"class":194,"line":337},10,[192,339,340],{"class":198},"}\n",[182,342,345],{"className":184,"code":343,"filename":344,"language":187,"meta":188,"style":188},"{\n  \"sandbox\": {\n    \"enabled\": true,\n    \"type\": \"docker\",\n    \"docker_image\": \"lingxizhi\u002Fsandbox:latest\"\n  }\n}\n","Docker 沙箱",[40,346,347,351,363,377,396,415,419],{"__ignoreMap":188},[192,348,349],{"class":194,"line":195},[192,350,199],{"class":198},[192,352,353,355,357,359,361],{"class":194,"line":202},[192,354,206],{"class":205},[192,356,176],{"class":209},[192,358,212],{"class":205},[192,360,215],{"class":205},[192,362,218],{"class":198},[192,364,365,367,369,371,373,375],{"class":194,"line":221},[192,366,224],{"class":205},[192,368,228],{"class":227},[192,370,212],{"class":205},[192,372,215],{"class":205},[192,374,236],{"class":235},[192,376,239],{"class":205},[192,378,379,381,383,385,387,389,392,394],{"class":194,"line":242},[192,380,224],{"class":205},[192,382,247],{"class":227},[192,384,212],{"class":205},[192,386,215],{"class":205},[192,388,254],{"class":205},[192,390,391],{"class":257},"docker",[192,393,212],{"class":205},[192,395,239],{"class":205},[192,397,398,400,403,405,407,409,412],{"class":194,"line":265},[192,399,224],{"class":205},[192,401,402],{"class":227},"docker_image",[192,404,212],{"class":205},[192,406,215],{"class":205},[192,408,254],{"class":205},[192,410,411],{"class":257},"lingxizhi\u002Fsandbox:latest",[192,413,414],{"class":205},"\"\n",[192,416,417],{"class":194,"line":282},[192,418,334],{"class":198},[192,420,421],{"class":194,"line":299},[192,422,340],{"class":198},[13,424,425],{},"三种隔离模式：",[30,427,428,451,465],{},[33,429,430,433,434,437,438,437,441,437,444,437,447,450],{},[17,431,432],{},"Process","：进程级隔离。Linux 使用 seccomp + namespaces + rlimits，Windows 使用 Job Object；支持命令白名单\u002F黑名单，以及网络访问白名单（默认放行 ",[40,435,436],{},"curl","、",[40,439,440],{},"git",[40,442,443],{},"npm",[40,445,446],{},"pip",[40,448,449],{},"cargo"," 等需要联网的命令）。",[33,452,453,456,457,460,461,464],{},[17,454,455],{},"Docker","：容器级隔离，默认开启 ",[40,458,459],{},"cap-drop ALL"," 与 ",[40,462,463],{},"no-new-privileges"," 安全加固。",[33,466,467,470],{},[17,468,469],{},"Cloud","：将任务提交到云端沙箱执行，本地零资源占用。",[472,473,475],"callout",{"type":474},"warn",[13,476,477,478,481,482,484,485,47],{},"沙箱默认关闭（",[40,479,480],{},"enabled: false","）。处理不受信任的代码、或让 AI 自由执行命令时，建议开启沙箱并将 ",[40,483,321],{}," 保持为 ",[40,486,487],{},"false",[489,490,491],"style",{},"html pre.shiki code .sgJMe, html code.shiki .sgJMe{--shiki-default:#9ABDF5}html pre.shiki code .sAklC, html code.shiki .sAklC{--shiki-default:#89DDFF}html pre.shiki code .s3R4Z, html code.shiki .s3R4Z{--shiki-default:#7AA2F7}html pre.shiki code .sySf4, html code.shiki .sySf4{--shiki-default:#0DB9D7}html pre.shiki code .sOJ5S, html code.shiki .sOJ5S{--shiki-default:#FF9E64}html pre.shiki code .sPY7s, html code.shiki .sPY7s{--shiki-default:#9ECE6A}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);}",{"title":188,"searchDepth":202,"depth":202,"links":493},[494,495,496],{"id":28,"depth":202,"text":5},{"id":53,"depth":202,"text":53},{"id":166,"depth":202,"text":166},"多会话 PTY 集成终端，内置危险命令五级拦截与进程\u002FDocker\u002F云端三级沙箱","md",{},true,11,"\u002Fdocs\u002Fguides\u002Fterminal","功能指南",{"title":5,"description":497},"docs\u002F02.guides\u002F11.terminal","DomPUIrLveEVRJKIIQR2N9B2_M_HN9KmOv4CTFCh0zE",[508,512],{"title":509,"path":510,"stem":511,"children":-1},"调试与 DAP","\u002Fdocs\u002Fguides\u002Fdebugging","docs\u002F02.guides\u002F10.debugging",{"title":513,"path":514,"stem":515,"children":-1},"支持的模型","\u002Fdocs\u002Fmodels-billing\u002Fmodels","docs\u002F03.models-billing\u002F12.models",[517],{"title":518,"path":519,"stem":520,"children":521,"page":543},"Docs","\u002Fdocs","docs",[522,544,570,584],{"title":523,"path":524,"stem":525,"children":526,"page":543},"快速上手","\u002Fdocs\u002Fgetting-started","docs\u002F01.getting-started",[527,531,535,539],{"title":528,"path":529,"stem":530},"安装与下载","\u002Fdocs\u002Fgetting-started\u002Finstallation","docs\u002F01.getting-started\u002F01.installation",{"title":532,"path":533,"stem":534},"注册与登录","\u002Fdocs\u002Fgetting-started\u002Fregister-login","docs\u002F01.getting-started\u002F02.register-login",{"title":536,"path":537,"stem":538},"首次配置","\u002Fdocs\u002Fgetting-started\u002Ffirst-setup","docs\u002F01.getting-started\u002F03.first-setup",{"title":540,"path":541,"stem":542},"从 VS Code 迁移","\u002Fdocs\u002Fgetting-started\u002Fmigrate-from-vscode","docs\u002F01.getting-started\u002F04.migrate-from-vscode",false,{"title":503,"path":545,"stem":546,"children":547,"page":543},"\u002Fdocs\u002Fguides","docs\u002F02.guides",[548,552,556,560,564,568,569],{"title":549,"path":550,"stem":551},"AI 对话与内联编辑","\u002Fdocs\u002Fguides\u002Fai-chat","docs\u002F02.guides\u002F05.ai-chat",{"title":553,"path":554,"stem":555},"RUSH 深度任务","\u002Fdocs\u002Fguides\u002Frush","docs\u002F02.guides\u002F06.rush",{"title":557,"path":558,"stem":559},"FIM 代码补全","\u002Fdocs\u002Fguides\u002Ffim-completion","docs\u002F02.guides\u002F07.fim-completion",{"title":561,"path":562,"stem":563},"语义代码图谱","\u002Fdocs\u002Fguides\u002Fcode-graph","docs\u002F02.guides\u002F08.code-graph",{"title":565,"path":566,"stem":567},"MCP 工具与市场","\u002Fdocs\u002Fguides\u002Fmcp","docs\u002F02.guides\u002F09.mcp",{"title":509,"path":510,"stem":511},{"title":5,"path":502,"stem":505},{"title":571,"path":572,"stem":573,"children":574,"page":543},"模型与计费","\u002Fdocs\u002Fmodels-billing","docs\u002F03.models-billing",[575,576,580],{"title":513,"path":514,"stem":515},{"title":577,"path":578,"stem":579},"套餐与配额","\u002Fdocs\u002Fmodels-billing\u002Fplans-quota","docs\u002F03.models-billing\u002F13.plans-quota",{"title":581,"path":582,"stem":583},"自带 API Key（BYOK）","\u002Fdocs\u002Fmodels-billing\u002Fbyok","docs\u002F03.models-billing\u002F14.byok",{"title":585,"path":586,"stem":587,"children":588,"page":543},"参考与 FAQ","\u002Fdocs\u002Freference","docs\u002F04.reference",[589,593,597,601],{"title":590,"path":591,"stem":592},"快捷键","\u002Fdocs\u002Freference\u002Fshortcuts","docs\u002F04.reference\u002F15.shortcuts",{"title":594,"path":595,"stem":596},"配置项","\u002Fdocs\u002Freference\u002Fconfiguration","docs\u002F04.reference\u002F16.configuration",{"title":598,"path":599,"stem":600},"内核 API","\u002Fdocs\u002Freference\u002Fkernel-api","docs\u002F04.reference\u002F17.kernel-api",{"title":602,"path":603,"stem":604},"常见问题","\u002Fdocs\u002Freference\u002Ffaq","docs\u002F04.reference\u002F18.faq",1786077825607]