AI 入门指南
四步从零到一个了解您服务器内外的 AI 助手。
第 1 步:购买 AI 积分
导航至 sh0.dev/account/ai 并购买积分包。提供五种面额:
| 积分包 | 大约对话数 (Sonnet) |
|---|---|
| $5 | ~1,000 |
| $10 | ~2,000 |
| $25 | ~5,000 |
| $50 | ~10,000 |
| $100 | ~20,000 |
三个 Claude 模型(Haiku、Sonnet、Opus)在所有计划中均可用。积分永不过期——随时使用。
第 2 步:创建 AI API 密钥
在同一账户页面的 AI API 密钥中,为密钥命名并点击创建密钥。密钥以 sh0_ai_ 开头,只显示一次。
Warning
生成后立即复制您的 API 密钥。之后无法再次获取。如果丢失,请撤销并生成新的。
该密钥用于为助手付费,本身不带任何权限级别。助手在你服务器上能做的事,就是你能做的事:它的工具在你的控制台会话中、以你的角色运行。viewer 得到的是只读助手。如需让外部 MCP 客户端获得受限访问,请改用服务器上带权限范围的 API 密钥(见 MCP 服务器)。
第 3 步:配置您的控制台
打开您的 sh0 控制台并导航至 Settings。在 AI 部分,粘贴您的 sh0_ai_ 密钥。
密钥保存在浏览器的 localStorage 中。控制台会随每条消息把它发送到 sh0 AI 网关(https://sh0.dev/api/ai),网关核对你的额度后把对话转发给模型。
Note
对话的去向:每条消息及其上下文都会经过 sh0 AI 网关再到达模型;网关会把每次回答的文本保留最多 24 小时,以便连接中断后仍能取回回答。对话历史保存在你自己的 sh0 服务器(以及浏览器)中,你可以在那里归档或删除。
第 4 步:开始聊天
在控制台中打开 /ai。AI 自动检测您的服务器上下文——运行中的应用、资源指标、sh0 版本和配置。无需手动设置。
用自然语言输入问题或命令。助手将确定要调用哪些工具,在您的服务器上执行它们,并返回结果和分析。
选择模型
从聊天界面的下拉菜单中选择模型。每个模型有不同的优势:
| 模型 | 速度 | 每次对话成本 | 推荐用途 |
|---|---|---|---|
| Haiku | 约 1-2 秒 | 约 $0.002 | 快速状态检查、列出应用、简单问题 |
| Sonnet | 约 3-5 秒 | 约 $0.005 | 调试失败部署、多步操作、日常使用 |
| Opus | 约 8-15 秒 | 约 $0.009 | 复杂根因分析、架构审查、沙箱代码分析 |
Tip
大多数任务使用 Sonnet。速度优先于深度的快速查询使用 Haiku,需要深入分析复杂问题时使用 Opus。
示例对话
以下是您可以问 AI 助手的一些问题:
- "为什么我的上次部署失败了?"——AI 获取部署日志,识别错误,并建议修复方案。
- "列出我所有的应用及其状态"——调用
list_apps并展示汇总表。 - "为我的 Node.js 项目生成 sh0.yaml"——基于最佳实践创建部署配置。
- "检查我的数据库是否可以从 my-app 访问"——使用沙箱测试容器间的网络连通性。
- "我的应用占用太多内存。帮我调试。"——检查指标,检查日志,可能在沙箱中分析代码。
- "重启 my-api 并监控日志"——重启应用并流式传输启动日志以验证恢复正常。
- "frontend 最后一次部署改了什么?"——查看部署历史和构建日志以汇总变更。
BYOK(自带密钥)
Business 计划用户可以通过提供自己的 LLM API 密钥完全绕过积分系统。这提供零加价定价——您直接按提供商的公开费率付费。
支持的密钥格式:
- Anthropic——以
sk-ant-开头的密钥。直接访问 Claude 模型。 - OpenRouter——以
sk-or-开头的密钥。通过 OpenRouter 的统一 API 访问 Claude 和其他模型。
配置 BYOK:打开 sh0.dev 账户页面的 自带密钥 (BYOK) 部分,粘贴服务商密钥并点击保存。
Note
你的服务商密钥以加密形式(AES-256-GCM)保存在 sh0.dev 账户中。sh0 AI 网关会解密后代你调用服务商:请求仍经过网关,由网关附加服务器上下文和工具定义。在同一页面删除密钥即可停止使用。