[{"data":1,"prerenderedAt":386},["ShallowReactive",2],{"navigation_docs_zh":3,"-zh-quick-start-macos-install":60,"-zh-quick-start-macos-install-surround":381},[4,26,43],{"title":5,"path":6,"stem":7,"children":8,"page":25},"Quick Start","/zh/quick-start","zh/1.quick-start",[9,13,17,21],{"title":10,"path":11,"stem":12},"快速开始","/zh/quick-start/overview","zh/1.quick-start/0.overview",{"title":14,"path":15,"stem":16},"安装与下载","/zh/quick-start/install","zh/1.quick-start/1.install",{"title":18,"path":19,"stem":20},"首次启动与第一条对话","/zh/quick-start/first-run","zh/1.quick-start/2.first-run",{"title":22,"path":23,"stem":24},"macOS 安装指南","/zh/quick-start/macos-install","zh/1.quick-start/3.macos-install",false,{"title":27,"path":28,"stem":29,"children":30,"page":25},"Manual","/zh/manual","zh/2.manual",[31,35,39],{"title":32,"path":33,"stem":34},"使用手册","/zh/manual/overview","zh/2.manual/0.overview",{"title":36,"path":37,"stem":38},"供应商与模型配置","/zh/manual/providers","zh/2.manual/1.providers",{"title":40,"path":41,"stem":42},"会话与上下文管理","/zh/manual/chat-and-context","zh/2.manual/2.chat-and-context",{"title":44,"path":45,"stem":46,"children":47,"page":25},"Faq","/zh/faq","zh/3.faq",[48,52,56],{"title":49,"path":50,"stem":51},"常见问题（FAQ）","/zh/faq/overview","zh/3.faq/0.overview",{"title":53,"path":54,"stem":55},"隐私政策","/zh/faq/privacy-policy","zh/3.faq/1.privacy-policy",{"title":57,"path":58,"stem":59},"账号删除说明","/zh/faq/account-deletion","zh/3.faq/2.account-deletion",{"id":61,"title":22,"body":62,"description":374,"extension":375,"links":376,"meta":377,"navigation":378,"path":23,"seo":379,"stem":24,"__hash__":380},"docs_zh/zh/1.quick-start/3.macos-install.md",{"type":63,"value":64,"toc":366},"minimark",[65,69,73,79,82,87,94,99,102,151,154,158,165,218,227,230,241,245,248,263,274,281,295,298,305,308,319,322,330,333,337,340,354,362],[66,67,22],"h1",{"id":68},"macos-安装指南",[70,71,72],"p",{},"BotHub 目前尚未完成 Apple 开发者签名，首次在 macOS 打开时系统可能会提示：",[74,75,76],"blockquote",{},[70,77,78],{},"\"BotHub.app\" 已损坏，无法打开。你应该将它移到废纸篓。",[70,80,81],{},"或者：",[74,83,84],{},[70,85,86],{},"无法打开 \"BotHub.app\"，因为 Apple 无法检查其中是否包含恶意软件。",[70,88,89,93],{},[90,91,92],"strong",{},"这并不代表应用真的损坏或有毒","。只是 macOS Gatekeeper 对未签名应用的默认保护机制。BotHub 所有代码开源在仓库可查，可以放心按下面任一方法放行。",[95,96,98],"h2",{"id":97},"方法-a系统设置放行推荐最简单","方法 A：系统设置放行（推荐，最简单）",[70,100,101],{},"适用于 macOS 13 Ventura 及更新版本。",[103,104,105,114,121,127,136,142,145],"ol",{},[106,107,108,109,113],"li",{},"先双击一次 ",[110,111,112],"code",{},"BotHub.app","，让系统拦截并报 \"已损坏\"",[106,115,116,117,120],{},"点对话框上的 ",[90,118,119],{},"取消","（不要点「移到废纸篓」）",[106,122,123,124],{},"打开 ",[90,125,126],{},"系统设置 → 隐私与安全性",[106,128,129,130,133],{},"滚动到底部，应该会看到一行：",[131,132],"br",{},[90,134,135],{},"\"BotHub.app 已被阻止使用，因为它不是来自可识别的开发者\"",[106,137,138,139],{},"点击右侧的 ",[90,140,141],{},"仍要打开",[106,143,144],{},"输入开机密码或 Touch ID 确认",[106,146,147,148,150],{},"再次双击 ",[110,149,112],{}," 启动，这次会正常打开",[70,152,153],{},"之后每次打开都会正常，不需要重复。",[95,155,157],{"id":156},"方法-b终端命令放行方法-a-失败时用","方法 B：终端命令放行（方法 A 失败时用）",[70,159,160,161,164],{},"如果「系统设置」里没有出现「仍要打开」的按钮，或者点了仍然报错，打开 ",[90,162,163],{},"终端","（Terminal.app）执行：",[166,167,172],"pre",{"className":168,"code":169,"language":170,"meta":171,"style":171},"language-bash shiki shiki-themes material-theme-lighter material-theme material-theme-palenight","sudo xattr -rd com.apple.quarantine /Applications/BotHub.app\nsudo codesign --force --deep --sign - /Applications/BotHub.app\n","bash","",[110,173,174,196],{"__ignoreMap":171},[175,176,179,183,187,190,193],"span",{"class":177,"line":178},"line",1,[175,180,182],{"class":181},"sBMFI","sudo",[175,184,186],{"class":185},"sfazB"," xattr",[175,188,189],{"class":185}," -rd",[175,191,192],{"class":185}," com.apple.quarantine",[175,194,195],{"class":185}," /Applications/BotHub.app\n",[175,197,199,201,204,207,210,213,216],{"class":177,"line":198},2,[175,200,182],{"class":181},[175,202,203],{"class":185}," codesign",[175,205,206],{"class":185}," --force",[175,208,209],{"class":185}," --deep",[175,211,212],{"class":185}," --sign",[175,214,215],{"class":185}," -",[175,217,195],{"class":185},[219,220,221,224],"ul",{},[106,222,223],{},"第一行：移除系统对\"下载文件\"的隔离标记",[106,225,226],{},"第二行：给应用打一个本地临时签名（ad-hoc signing），让 Gatekeeper 接受",[70,228,229],{},"需要输入开机密码。执行完再双击打开 BotHub。",[70,231,232,233,236,237,240],{},"如果第一行报 ",[110,234,235],{},"Operation not permitted","，说明你的终端没有「完全磁盘访问权限」。去 ",[90,238,239],{},"系统设置 → 隐私与安全性 → 完全磁盘访问权限"," 把终端加进去，然后重启终端重试。",[95,242,244],{"id":243},"方法-c关闭-gatekeeper终极方案不推荐作为常规手段","方法 C：关闭 Gatekeeper（终极方案，不推荐作为常规手段）",[70,246,247],{},"如果 A 和 B 都失败，或者你经常需要装各种未签名应用，可以在终端执行：",[166,249,251],{"className":168,"code":250,"language":170,"meta":171,"style":171},"sudo spctl --master-disable\n",[110,252,253],{"__ignoreMap":171},[175,254,255,257,260],{"class":177,"line":178},[175,256,182],{"class":181},[175,258,259],{"class":185}," spctl",[175,261,262],{"class":185}," --master-disable\n",[70,264,265,266,269,270,273],{},"然后进 ",[90,267,268],{},"系统设置 → 隐私与安全性 → 允许以下来源的应用程序","，会多出一个 ",[90,271,272],{},"任何来源"," 选项，选它。",[70,275,276,277,280],{},"此后所有未签名应用都能直接双击打开。",[90,278,279],{},"这会降低系统安全性，只在你清楚自己在做什么的前提下使用","。如需恢复：",[166,282,284],{"className":168,"code":283,"language":170,"meta":171,"style":171},"sudo spctl --master-enable\n",[110,285,286],{"__ignoreMap":171},[175,287,288,290,292],{"class":177,"line":178},[175,289,182],{"class":181},[175,291,259],{"class":185},[175,293,294],{"class":185}," --master-enable\n",[95,296,297],{"id":297},"安装位置",[70,299,300,301,304],{},"推荐拖入 ",[90,302,303],{},"Applications","（/应用程序）文件夹。拖入其他目录也能用，但 Finder 里的搜索和 Dock 固定会更方便。",[95,306,307],{"id":307},"卸载",[219,309,310,316],{},[106,311,312,313,315],{},"方法 1：Finder 打开 Applications，把 ",[110,314,112],{}," 拖到废纸篓",[106,317,318],{},"方法 2：用 AppCleaner 之类的卸载工具一并清理偏好设置和数据缓存",[70,320,321],{},"BotHub 的用户数据默认位于：",[166,323,328],{"className":324,"code":326,"language":327},[325],"language-text","~/Library/Application Support/BotHub/\n","text",[110,329,326],{"__ignoreMap":171},[70,331,332],{},"完全卸载时可以连同这个目录一起删除。",[95,334,336],{"id":335},"仍然打不开","仍然打不开？",[70,338,339],{},"如果三个方法都失败，可能是下载文件本身损坏。尝试：",[103,341,342,348,351],{},[106,343,344,345],{},"重新从官网下载 ",[110,346,347],{},".dmg",[106,349,350],{},"对比 SHA256 校验值（如果发布页提供了）",[106,352,353],{},"切换到 arm64 / x86_64 对应的版本（新 Mac 用 arm64，Intel Mac 用 x86_64）",[70,355,356,357,361],{},"仍然有问题请到 ",[358,359,360],"a",{"href":50},"常见问题"," 或提交 issue 反馈。",[363,364,365],"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);}",{"title":171,"searchDepth":198,"depth":198,"links":367},[368,369,370,371,372,373],{"id":97,"depth":198,"text":98},{"id":156,"depth":198,"text":157},{"id":243,"depth":198,"text":244},{"id":297,"depth":198,"text":297},{"id":307,"depth":198,"text":307},{"id":335,"depth":198,"text":336},"在 macOS 上首次启动 BotHub 可能遇到「已损坏」提示，这里给出完整的处理方法。","md",null,{},true,{"title":22,"description":374},"Tds4xXd2evEh5a0FzDbDNqCygSNigICR76EJOsWu6lE",[382,384],{"title":18,"path":19,"stem":20,"description":383,"children":-1},"配置供应商，发出第一条消息。",{"title":32,"path":33,"stem":34,"description":385,"children":-1},"功能说明和配置指南。",1778164843868]