Nbility Blog

Nbility 博客

AI Agent、模型 API、开发工具接入和 Nbility 使用教程。

精选文章

2026年5月25日精选文章OpenClawAI AgentVPS

OpenClaw 小龙虾部署教程：把 24 小时在线的 AI Agent 跑到服务器上

第五篇 AI Agent 上手系列：从 VPS、Node/npm、OpenClaw 安装、onboard 配置、模型 API、Web UI、Telegram/群聊入口到 systemd 常驻运行，完整梳理一个会持续消耗 token 的 Agent 应用部署流程。

全部文章

2026年7月21日429Retry

一次 429 如何拖垮整条 Agent 链路：重试、退避与故障切换复盘

用固定种子的离线模拟拆解 429 重试风暴，比较立即重试、指数退避和带抖动总预算策略，并给出网关与 Agent 的安全状态机。

2026年7月20日多模型路由LLM Router

多模型路由不是随机切换：质量、成本和延迟怎么一起决策

用三个任务和一份可运行的离线路由实验，拆解能力硬约束、质量门槛、成本、TTFT、健康度、缓存亲和与故障回退。

2026年7月19日LLM GatewayAPI Gateway

LLM Gateway 和普通 API Gateway 差在哪？拆开一次模型请求就明白了

从认证、模型映射、协议转换、SSE 流式、重试、Token 计费和观测十个阶段，解释 LLM Gateway 比普通 API Gateway 多理解了什么。

2026年7月19日Prompt CachingOpenAI

Prompt Caching 真的省钱吗？同一份 12K 上下文算三家缓存账单

用 12,000 Token 固定前缀和 10 次请求，按 OpenAI、Claude 与 Gemini 官方缓存价格回放账单，拆解写入、命中、TTL、失效和盈亏平衡点。

2026年7月19日Agent SkillsSKILL.md

Agent Skills 为什么突然火了？CLAUDE.md、AGENTS.md 和 SKILL.md 怎么分工

Agent Skills 不只是把 Prompt 存成文件。本文拆解 CLAUDE.md、AGENTS.md 与 SKILL.md 的作用域和加载机制，并用两次真实模型调用对比指令命中与 Token 成本。

2026年7月19日MCPA2A

MCP 和 A2A 有什么区别？一个连工具，一个连接 Agent

MCP 与 A2A 都是 Agent 协议，但解决的问题不同。本文用同一个退款业务对照工具调用与 Agent 委派，并拆解 Agent Card、Task、Artifact、传输和安全边界。

2026年7月19日MCPModel Context Protocol

MCP 到底是什么？用一次真实工具调用讲清 Host、Client 和 Server

MCP 不是模型 API，也不只是插件协议。本文通过一个真实订单查询工具，拆解 MCP Host、Client、Server、JSON-RPC、stdio 与 Streamable HTTP 的完整调用链。

2026年7月18日Structured OutputJSON Schema

结构化输出与 JSON Schema：如何让模型稳定返回 JSON

模型返回的 JSON 经常少字段、类型错误或夹带 Markdown？本文解释 JSON Mode 与结构化输出的区别，并给出 OpenAI、Claude、Gemini 配置、Schema 设计、校验与重试方案。

2026年7月18日OpenAI APIClaude API

OpenAI、Claude 和 Gemini API 格式有什么区别？

对比 OpenAI Responses 与 Chat Completions、Claude Messages、Gemini GenerateContent 的认证、消息、系统指令、流式输出、工具调用、多模态和结构化输出格式。

2026年7月18日API KeyGitHub

如何安全保存 API Key，避免意外上传到 GitHub

API Key 应该放在哪里？本文介绍环境变量、.env 与 .gitignore、Secret Manager、CI/CD Secrets、最小权限，以及密钥误传 GitHub 后的撤销和历史清理流程。

2026年7月17日Context Length Exceeded上下文窗口

Context Length Exceeded 怎么解决：上下文超限与裁剪策略

AI API 提示 context length exceeded？本文解释输入、输出、工具结果和图片如何占用上下文，并给出 Token 预估、消息裁剪、摘要、RAG 与 Agent 压缩方案。

2026年7月17日AI API空响应

AI API 返回空内容：content、reasoning 与响应格式排查

AI API 请求成功却没有文本？本文从 content、tool_calls、reasoning、finish_reason、流式响应和多协议解析入手，定位空字符串、null 与候选结果缺失。

2026年7月17日WindsurfDevin Desktop

Windsurf 能否使用第三方 API？支持范围与替代方案

Windsurf 是否支持自定义 Base URL、OpenAI 兼容 API 或 BYOK？本文结合当前官方文档说明 Cascade 的模型范围、代理设置边界，并给出可行替代方案。

2026年7月17日ContinueVS Code

Continue 接入 OpenAI 兼容 API：VS Code 编程助手教程

在 VS Code 的 Continue 2.0 中通过 config.yaml 配置 OpenAI 兼容 API，设置 apiBase、API Key、模型角色，并排查 Chat、Edit、Autocomplete 与 Responses API 问题。

2026年7月17日ClineOpenAI 兼容 API

Cline 接入自定义 API：模型配置、权限与成本控制

在 Cline 中配置 OpenAI 兼容 API、Base URL、API Key 和模型参数，并用 Auto Approve、Checkpoints、.clineignore 与模型分层控制风险和成本。

2026年7月17日Claude CodeCodex

Claude Code、Codex、Cursor 和 OpenCode 有什么区别？

从使用界面、模型与 API、自动化、权限、成本和适用人群比较 Claude Code、Codex、Cursor 与 OpenCode，帮你选对 AI 编程工具。

2026年7月17日Qwen CodeOpenAI 兼容 API

Qwen Code 接入 OpenAI 兼容 API：从安装到首次调用

安装 Qwen Code，使用 settings.json 或环境变量连接 OpenAI 兼容 API，并完成模型切换、首次调用、安全配置与常见错误排查。

2026年7月17日Roo CodeOpenAI 兼容 API

Roo Code 接入自定义 API：Claude、GPT 和 Gemini 怎么选

在 Roo Code 中配置 OpenAI 兼容 API、Base URL、API Key 和模型 ID，并按编程任务选择 Claude、GPT 或 Gemini。

2026年7月16日OpenCodeOpenAI 兼容 API

OpenCode 接入第三方 API：自定义 Provider、多模型与常见报错

用 OpenCode 的 /connect、opencode.json 和 OpenAI 兼容 Provider 接入第三方 API，配置多个模型、默认模型、密钥和排错方法。

2026年7月16日CursorOpenAI 兼容 API

Cursor 使用自定义 OpenAI API：配置方法、限制与排错

介绍 Cursor 自带 BYOK 的配置步骤，并说明自定义 OpenAI 兼容 Base URL 的适用边界、隐私影响以及 401、404、模型不可用等问题。