sublime text 无内置ai能力，所有ai功能依赖第三方插件+外部服务，需手动配置后端（api或本地模型）；盲目安装插件将报错connection refused或no api key configured。
Sublime Text 本身不内置 AI 能力，所有“AI 助手”功能都依赖第三方插件 + 外部服务，且必须手动配置后端（API 或本地模型）才能工作。 没有开箱即用的“一键智能”，盲目安装插件只会看到 Connection refused 或 No API key configured 报错。
sublime-nano-bots 需要你先跑起来一个兼容的 AI 后端
这个插件不是独立运行的 AI 客户端，它只负责转发请求和渲染结果。如果你直接安装 sublime-nano-bots，启动后调用任何命令都会失败。
- 它默认尝试连接本地
http://localhost:5000上的 JSON-RPC 服务，但这个地址什么都没有——除非你手动部署了支持它的后端 - 可选后端包括：
ollama（需启用ollama serve并配置 model alias）、llama.cpp的 server 模式、或自建的 FastAPI/Flask 接口，必须严格遵循其定义的prompt和response字段结构 - 不支持直接填 OpenAI API key；想用 GPT，得自己写个中间层把 OpenAI 的 REST 响应转成 nano-bots 认的 JSON-RPC 格式
OpenAI-sublime-text 插件更直白，但密钥和模型选型极易踩坑
它直接调用 OpenAI 官方 API，省去协议转换，但对配置项极其敏感：
-
openai_api_key必须放在Preferences.sublime-settings里，不能放系统环境变量，也不能藏在插件 settings 文件夹中——否则会报Invalid API key -
model参数必须是 OpenAI 当前支持的正式名称，比如gpt-4o或gpt-3.5-turbo；填gpt4或chatgpt会返回404 Not Found - 国内用户常因网络问题卡在
TimeoutError: [Errno 110] Connection timed out，这不是插件问题，而是请求根本没发出去——建议搭配稳定代理，并在插件设置里显式配置http_proxy和https_proxy
Pieces OS 集成插件依赖桌面客户端持续运行
pieces-app/plugin_sublime 看似“本地化”，实则依赖 Pieces OS 桌面应用作为中间服务：
- 必须先下载并运行 Pieces OS 客户端（macOS/Windows/Linux），它会在后台启动一个本地 HTTP 服务（默认
http://localhost:5173） - 插件只是个 thin client，所有上下文提取、片段索引、AI 推理都由 Pieces OS 承担；关掉客户端，插件所有功能立即失效，状态栏显示
Pieces: Offline - 首次启动 Pieces OS 时会自动下载模型（如
codellama），耗时较长且占用数 GB 磁盘空间——这点容易被忽略，直到看到磁盘告警才反应过来
真正麻烦的从来不是插件装不上，而是搞不清“AI 能力”究竟落在哪一层：是插件里？是本地进程里？还是远端 API 里？一旦出错，得先定位故障域——网络、认证、协议、模型服务，漏掉任何一个环节，AI 就只是个摆设。
