运维123 - API
type: channel
link: https://www.sddts.cn/index.php/tag/API/
items: 微信 iLink Bot SDK 技术文档
items: Squirrel LLM Gateway：企业级 LLM 统一网关发布
items: 202602151030.WebMCP抢先预览版发布Chrome推出AI智能体结构化交互标准
items: ZenMux AI模型聚合平台质量保险机制分析
items: OpenClaw + CherryIN 零基础保姆级教程

微信 iLink Bot SDK 技术文档
type: item
date: 2026-03-22T11:02:11+00:00
description: 微信 iLink Bot SDK 技术文档一、概述1. 项目简介A. 是什么weixin-bot 是一个微信 iLink Bot SDK，支持 Node.js 和 Python 两种语言实现。它为开发者提供了一套简洁的 API，让任何 Agent 可以在 5 分钟内接入微信消息收发功能。B. 为什么需要它传统的微信机器人接入面临以下痛点：协议复杂，需要深入理解微信 iLink Bot APIcontext_token 管理繁琐，处理不当会导致消息投递失败Session 过期需要手动重新登录需要配置 Webhook 接收消息，部署复杂weixin-bot SDK 通过封装底层协议细节，解决了这些问题：零配置，开箱即用凭证自动保存和续期context_token 自动管理长轮询收消息，无需 WebhookC. 应用场景AI Agent 接入微信作为交互渠道客服机器人自动回复群聊助手和消息监听微信消息自动化处理2. 技术背景A. iLink Bot APIiLink Bot API 是微信提供的机器人接口协议，采用 HTTP 长轮询方式接收消息，通过 HTTP POST 发送消息。关键特性包括：扫码登录认证长轮询获取更新context_token 上下文传递机制Typing 状态支持B. 协议关键发现SDK 开发过程中发现的关键协议细节：context_token：回复消息时必须原样传回 APIsendtyping：唯一能触发"对方正在输入中"的方式message_state：GENERATING 状态在 API 层面可用，但微信客户端不渲染Session 过期：errcode 为 -14 时需要重新登录二、系统架构1. 整体架构graph TB Agent[Agent 应用] -->|调用| SDK[weixin-bot SDK] SDK -->|HTTP 长轮询| API[iLink Bot API] SDK -->|HTTP POST| API API -->|推送消息| User[微信用户] User -->|扫码/发消息| API SDK -->|保存凭证| Local[本地存储]2. 组件说明Agent 应用：使用 SDK 的上层应用，如 AI Agent、客服机器人weixin-bot SDK：封装 iLink Bot API 协议的 SDK 库iLink Bot API：微信提供的机器人接口服务本地存储：保存登录凭证，避免重复扫码3. 交互流程sequenceDiagram participant Agent as Agent 应用 participant SDK as weixin-bot SDK participant API as iLink Bot API participant User as 微信用户 Note over Agent,User: 1. 登录阶段 Agent->>SDK: bot.login() SDK->>API: GET /get_bot_qrcode?bot_type=3 API-->>SDK: 返回二维码 URL SDK-->>Agent: 终端显示二维码 User->>API: 微信扫码确认 API-->>SDK: 返回 bot_token + baseurl SDK-->>Agent: 登录成功，凭证已保存 Note over Agent,User: 2. 消息收发循环 Agent->>SDK: bot.run() loop 长轮询循环 SDK->>API: POST /getupdates (最多保持 35 秒) User->>API: 发送消息 "你好" API-->>SDK: 返回消息 + context_token SDK-->>Agent: 触发 onMessage(msg) Agent->>SDK: bot.sendTyping(userId) SDK->>API: POST /sendtyping Note over User: 显示 "对方正在输入中" Agent->>SDK: bot.reply(msg, "Echo: 你好") SDK->>API: POST /sendmessage (带 context_token) API-->>User: 推送回复消息 SDK->>API: POST /sendtyping (取消 typing) end Note over Agent,User: 3. 异常处理 API-->>SDK: 返回 errcode: -14 (Session 过期) SDK->>SDK: 自动触发重新登录 SDK->>API: 重新获取二维码和 token SDK-->>Agent: 自动恢复运行三、安装指南1. 系统要求Node.js：14…

Squirrel LLM Gateway：企业级 LLM 统一网关发布
type: item
date: 2026-02-17T07:56:33+00:00
description: Squirrel LLM Gateway：企业级 LLM 统一网关发布一、新闻概述1. 标题Squirrel LLM Gateway：企业级 LLM 统一网关开源发布2. 发布时间2026 年 2 月（最新提交：2026-02-16）3. 来源GitHub 开源项目二、核心内容1. 事件摘要A. 主要内容开发者 mylxsw 开源了 Squirrel LLM Gateway，这是一个高性能、企业级的 LLM 代理服务，旨在统一和管理对 OpenAI、Anthropic 等大语言模型提供商的访问。B. 核心亮点统一 API 接口：单一接入点访问多个 LLM 提供商零代码变更：完全兼容 OpenAI 和 Anthropic SDK智能路由：支持基于规则、优先级、权重的请求路由协议转换：内置 OpenAI Chat、OpenAI Responses、Anthropic Messages 之间的协议转换全面可观测性：完整的请求/响应日志、Token 计费、延迟监控2. 关键信息A. 版本信息开源协议：MIT License最新提交：4fa62b0（2026-02-16）Python 版本：3.12+前端：Next.js 16 + TypeScript + shadcn/uiB. 重要数据GitHub Stars：20+Forks：4主要编程语言：Python 73.2%、TypeScript 25.8%C. 涉及技术后端：FastAPI、Alembic、SQLite/PostgreSQL前端：Next.js 16、shadcn/ui协议转换：自研 llm_api_converter SDK容器化：Docker、Docker Compose3. 背景介绍A. 项目定位Squirrel LLM Gateway 定位为企业级 LLM 接入中间件，解决企业在使用多个 LLM 提供商时面临的集成复杂、成本控制、故障切换等问题。B. 相关上下文随着 LLM 技术的快速发展，企业往往需要同时接入多个 LLM 提供商以实现成本优化和风险分散。Squirrel 提供了统一的接入层，简化了这一过程。三、详细报道1. 主要功能A. 统一 API 接口Squirrel 提供了统一的 API 接口，支持：OpenAI 兼容：/v1/chat/completions、/v1/completions、/v1/embeddings、/v1/audio/、/v1/images/OpenAI Responses 兼容：/v1/responses（支持流式和工具调用）Anthropic 兼容：/v1/messages 端点协议转换：OpenAI Chat ↔ OpenAI Responses ↔ Anthropic Messages 之间无缝转换B. 智能路由策略系统支持多种路由策略：轮询（Round-Robin）：均匀分配请求优先级（Priority-Based）：优先使用首选提供商权重（Weight-Based）：按自定义权重分配成本（Cost-Based）：自动选择价格最低的模型基于规则：根据模型名称、请求头、消息内容或 Token 数量路由C. 高可用性设计自动重试：可配置的重试次数（默认 3 次）提供商故障转移：无缝切换到备用提供商超时管理：可配置请求超时（默认 30 分钟）D. 全面可观测性完整请求/响应捕获：包括流式响应Token 追踪：使用 tiktoken 自动计数延迟指标：首字节延迟和总响应时间成本分析：按时间、模型、提供商、API Key 汇总统计数据脱敏：自动处理日志中的敏感信息2. 技术架构graph TB Client[客户端应用] --> Gateway[Squirrel LLM Gateway] Gateway --> Router[智能路由引擎] Router -->|基于规则/优先级/权重/成本| Provider1[OpenAI 提供商] Router --> Provider2[Anthropic 提供商] Router --> Provider3[Azure OpenAI] Router --> Provider4[本地模型] Gateway --> Dashboard[管理控制台] Gateway --> Logger[日志记录] Gateway --> Metrics[指标统计] Logger --> DB[(数据库)] Metrics --> DB Dashboard -->|查询| DB Dashboard -->|管理| Router3. 核心组件A. 后端架构（Python/FastAPI）backend/ ├── app/ │ ├── api/ # API 路由（代理、管理） │ ├── services/ # 业务…

202602151030.WebMCP抢先预览版发布Chrome推出AI智能体结构化交互标准
type: item
date: 2026-02-14T23:42:27+00:00
description: WebMCP 抢先预览版发布：Chrome 推出 AI 智能体结构化交互标准一、新闻概述1. 标题WebMCP 现已推出抢先预览版2. 发布时间2026 年 2 月 10 日3. 来源Chrome for Developers 官方博客二、核心内容1. 事件摘要A. 主要内容Google Chrome 团队发布 WebMCP（Web Model Context Protocol）抢先预览版，这是一项旨在为 AI 智能体与网站交互提供标准化方式的新技术。B. 核心亮点提供结构化工具定义 API支持声明性和命令式两种交互模式相比原始 DOM 操作，实现更高可靠性和性能开放抢先预览计划供开发者试用2. 关键信息A. 版本状态抢先预览版（Early Preview Program）B. 涉及产品Chrome 浏览器、WebMCP APIC. 目标用户网站开发者、AI 智能体开发者3. 背景介绍A. 技术背景随着 AI 智能体技术的发展，智能体需要与各种网站进行自动化交互。传统基于 DOM 的自动化方式存在可靠性差、性能低、易受页面结构变化影响等问题。B. 相关上下文WebMCP 旨在建立类似 MCP（Model Context Protocol）的 Web 标准，使网站能够主动向 AI 智能体暴露可用的操作和工具。三、详细报道1. 主要内容A. 技术架构WebMCP 提出两项核心 API：声明性 API：用于可直接在 HTML 表单中定义的标准操作，适合简单的表单提交、查询等场景。命令式 API：用于需要 JavaScript 执行的复杂、动态交互，适合多步骤工作流、实时数据处理等场景。B. 技术特点结构化工具定义：网站开发者可以明确告知智能体可执行的操作消除歧义：通过明确的 API 定义，减少智能体理解错误性能优化：相比 DOM 遍历和操作，直接 API 调用更高效可靠性提升：不依赖页面 DOM 结构，减少因页面变化导致的失效2. 技术细节A. 系统架构graph TB AI[AI 智能体] --> WebMCP[WebMCP API] WebMCP --> Dec{声明性 API} WebMCP --> Imp{命令式 API} Dec --> Form[HTML 表单] Imp --> JS[JavaScript 执行] Form --> Website[网站服务] JS --> WebsiteB. 工作原理工具发现：智能体通过 WebMCP API 发现网站提供的可用工具参数协商：智能体获取工具所需的参数结构和约束执行操作：通过声明性或命令式 API 执行操作结果返回：网站返回结构化的执行结果C. 兼容性说明当前为抢先预览版，需要注册加入预览计划需要 Chrome 浏览器支持API 可能会在正式版中调整3. 使用场景A. 客户支持智能体可以帮助用户自动填写详细的技术支持工单，确保所有必要信息准确无误。B. 电子商务智能体可以执行产品搜索、配置购物选项、完成结账流程等复杂操作。C. 旅游预订智能体使用结构化数据进行航班搜索、结果过滤和预订处理，确保准确结果。四、影响分析1. 行业影响A. 技术趋势WebMCP 代表了 Web 与 AI 智能体交互的标准化方向，可能催生更多类似协议。B. 竞争格局与现有的自动化工具（如 Selenium、Playwright）形成互补可能为其他浏览器厂商提供参考实现推动整个行业向 AI 友好的 Web 标准演进2. 用户影响A. 网站开发者需要学习新的 API 定义方式可以更好地控制 AI 智能体与网站的交互提升网站在 AI 时代的可用性B. AI 智能体开发者获得更可靠的 Web 交互方式减少 DOM 操作的复杂性和不稳定性可以构建更强大的智能体应用C. 终端用户享受更智能、更可靠的 AI 助手服务复杂任务可以被更准确地自动完成3. 技术趋势A. 技术方向Web 标准向 AI 友好方向演进结构化交互成为主流从以人为中心的 UI 向以智能体为中心的 API 扩展B. 生态影响可能催生 WebMCP 工具库和框架促进智能体即服务（Agent as a Service）发展推动 AI 原生应用的出现五、各方反应1. 官方回应Chrome 团队表示，WebMCP 旨在帮助网站在 AI 智能体与其互动的方式中发挥积极作用。2. 业内评价A. 技术意义这是 Web 标准向 AI 时代演进的重要一步，类似于当年 RESTful API 对服务间通信的规范化作用。B. 发展潜力虽然当前只是预览版，但展现了 Google 在 AI 与 Web 融合方向的战略布局。六、相关链接1. 官方资源WebMCP 抢先预览计划注册页面Chrome for Developers 文档2. 技术文档WebMCP API 规范（预…

ZenMux AI模型聚合平台质量保险机制分析
type: item
date: 2026-02-06T07:45:42+00:00
description: ZenMux AI 模型聚合平台质量保险机制分析一、平台概述1. 简介A. 是什么ZenMux 是一个 AI 模型聚合平台，提供统一网关访问全球领先的 AI 模型。其核心创新在于引入"质量保险"机制——当 AI 产生幻觉输出、高延迟或低吞吐时，平台自动对用户进行经济补偿。B. 为什么值得关注首创质量保险：行业内首个承诺"结果不佳，自动赔付"的 AI 平台统一 API 接口：兼容 OpenAI、Anthropic、Google Vertex AI 协议多供应商容灾：自动故障切换确保服务高可用C. 核心价值降低 AI 应用开发门槛保障服务质量和成本透明提供企业级稳定性保证2. 平台定位面向开发者和企业的 AI 模型调用基础设施，解决多模型管理、质量保障和成本优化的痛点。二、核心功能1. 统一模型访问A. 支持的模型提供商平台聚合了全球主流 AI 模型，包括：Anthropic：Claude 系列Google：Gemini 系列OpenAI：GPT 系列DeepSeek、xAI、MiniMax、月之暗面、阿里 Qwen、百度文心、字节豆包等B. 协议兼容性graph LR A[开发者应用] --> B[ZenMux 统一 API] B --> C[OpenAI 协议] B --> D[Anthropic 协议] B --> E[Google Vertex AI 协议] C --> F[GPT 模型] D --> G[Claude 模型] E --> H[Gemini 模型]C. 接入方式API 调用：完全兼容 OpenAI Python/JavaScript SDKGUI 界面：支持聊天、图片生成、视频生成2. 质量保险机制A. 保险触发条件当出现以下情况时，平台自动触发赔付：幻觉输出（Hallucination）过度延迟（Excessive Latency）低吞吐量（Low Throughput）B. 赔付流程graph TD A[API 调用] --> B{质量检测} B -->|正常| C[正常计费] B -->|异常| D[触发保险] D --> E[自动赔付] E --> F[案例匿名化] F --> G[反馈给用户] G --> H[优化模型数据飞轮]C. 数据飞轮效应每个赔付案例都会被匿名化分析并反馈给用户，帮助用户构建数据飞轮优化自身 AI 产品。3. 质量透明度体系A. 人类最后考试（HLE）运行开源、社区可审计的质量基准测试实时发布测试结果支持按需 HLE 测试任何模型通道B. 质量追踪比较不同模型得分追踪质量退化趋势杜绝"降级"模型三、技术架构1. 多供应商容灾A. 高可用架构graph TB A[用户请求] --> B[Cloudflare 边缘节点] B --> C[ZenMux 负载均衡] C --> D{提供商 A} C --> E{提供商 B} C --> F{提供商 C} D -->|故障/限流| G[自动切换] E -->|故障/限流| G F -->|故障/限流| G G --> H[备用通道] D -->|正常| I[模型响应] E -->|正常| I F -->|正常| I H --> IB. 全球加速基于 Cloudflare 全球边缘网络用户请求由最近边缘节点处理显著降低延迟，确保全球一致的高性能2. 模型自动路由A. 智能选择机制分析提示词内容自动选择最佳质量与成本平衡的模型持续学习任务模式和历史表现B. 帕累托最优平衡在质量和价格之间找到最优平衡点，无需手动选择模型。3. 可观测性A. 多维度仪表板每个请求、每个 Token、每分钱都清晰可追溯帮助优化成本，做出更明智的决策B. 计费透明完全的 Token 级别追踪实时成本监控四、开发者体验1. 快速接入A. Python SDK 示例from openai import OpenAI client = OpenAI( base_url="https://zenmux.ai/api/v1", api_key="<ZENMUX_API_KEY>" ) completion = client.chat.completions.create( model="qwen/qwen3-max", messages=[ { "role": "user", "content": "What is the meaning of life?" } ] ) print(completion.choices[0].message.content)B. 兼容性OpenAI 协议：Python SDK、JavaScript SDKAnthropic 协议：Python SDKGoogle Vertex AI 协议2. 使用方式A. 聊天界面支持直接在网页进行对话…

OpenClaw + CherryIN 零基础保姆级教程
type: item
date: 2026-01-31T08:45:13+00:00
description: OpenClaw + CherryIN 零基础保姆级教程一、概述1. 简介A. 是什么OpenClaw 是一个开源的 AI Agent 框架，可以让 AI 模型控制电脑执行各种任务，包括写代码、操作文件、执行命令等。CherryIN 是一个 AI 模型聚合平台，提供多家大模型的统一接入服务。B. 为什么学OpenClaw 开源一周 Stars 数已超过 12 万，生态活跃CherryIN 聚合多家模型，包括 DeepSeek v3.2、Kimi K2.5 等最新模型打造专属 AI Agent，彻底解放生产力C. 学完能做什么独立配置 OpenClaw + CherryIN 环境使用 AI Agent 自动化执行电脑操作任务切换使用多种 AI 模型完成不同场景需求2. 前置知识A. 必备技能基本命令行操作能力了解 JSON 配置文件格式B. 推荐知识虚拟机基础概念（推荐在虚拟机中测试）Node.js 和 npm 基础二、环境准备1. 系统要求操作系统：Windows / macOS / Linux网络环境：稳定的互联网连接Node.js：22 以上版本（推荐 24）时间：约 20 分钟2. 安装 Node.jsmacOS / Linux 用户推荐使用 nvm 安装：# 下载并安装 nvm curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.40.3/install.sh | bash # 加载 nvm（避免重启终端） \. "$HOME/.nvm/nvm.sh" # 安装 Node.js 24 nvm install 24 # 验证安装 node -v npm -vWindows 用户推荐使用 WSL 环境，或直接下载 Node.js 安装包。3. 安装 OpenClawNode.js 装好后，一行命令搞定：npm install -g openclaw@latest或使用 pnpm：pnpm add -g openclaw@latest4. 验证安装node -v openclaw --version能正常显示版本号即说明安装成功。三、核心概念1. 基本术语OpenClaw：AI Agent 框架，提供模型调用和电脑控制能力CherryIN：AI 模型聚合平台，提供统一 API 接口Provider：模型供应商，CherryIN 是其中一个供应商Agent：智能代理，可以理解并执行用户指令2. 工作原理graph LR A[用户] --> B[OpenClaw] B --> C{模型路由} C --> D[CherryIN] D --> E[各大模型] E --> D D --> B B --> F[电脑操作] F --> G[文件/命令/应用]3. 架构图OpenClaw 采用插件化架构，支持多种模型供应商：配置文件：~/.openclaw/openclaw.jsonWebUI：浏览器界面交互Daemon：后台服务进程四、快速上手1. 初始化 OpenClaw执行初始化命令：openclaw onboard --install-daemon安装完成后会自动弹出配置页面。如果没有弹出，可手动执行：openclaw onboard2. 安全风险确认因为 OpenClaw 可以控制电脑，会有安全提示。接受即可。强烈建议：在虚拟机中使用，避免影响主力机。3. 配置向导步骤A. 跳过 Provider 设置暂时不设置 Provider，后续通过配置文件接入 CherryIN。B. 跳过通知设置IM 通知需要额外配置，先确保基础功能可用。C. 选择 WebUI 模式选择 WebUI 模式，方便在浏览器中操作。D. 成功标志控制台输出访问地址，如 http://localhost:30004. 注册 CherryIN访问 CherryIN 官网：https://open.cherryin.ai/建议：使用邮箱登录，比 GitHub 登录更稳定。充值后可体验全部模型，包括免费的 DeepSeek v3.2 和各家最新模型。5. 获取 API 令牌A. 创建令牌进入「令牌管理」，创建新令牌，如 Openclaw-AgentB. 复制令牌保存 sk- 开头的令牌，后续配置需要使用五、配置模型接入1. 找到配置文件OpenClaw 配置文件路径：~/.openclaw/openclaw.json~ 表示用户主目录：Linux：/home/用户名macOS：/Users/用户名Windows：C:\Users\用户名2. 添加 CherryIN 配置打开配置文件，添加以下内容（替换 sk-xxxxx 为自己的令牌）：{ "models": { "mode": "merge", "prov…