WaLiAPI
WaLiAPI 是一款本地运行的 LLM API 网关桌面软件(Tauri 2 + React + Rust)。支持各类 LLM 厂商渠道接入、Ollama 自部署模型、CPA 方式 ChatGPT 渠道接入,统一支持 Chat Completions / Responses / Anthropic Messages 三协议转换使用。内置安全审计引擎、知识库 RAG(HNSW + FTS5 混合检索)、Wiki 知识引擎和 MCP Server(29 个工具),配合 Codex、Claude Code、Gemini CLI 等 AI 编程工具使用。
Safety scan
A static text scan, not a guarantee. Select the badge to see what was scanned and every finding.
Badge for your README
Markdown
[](/listings/fuzhengwei--waliapi)HTML
<a href="/listings/fuzhengwei--waliapi"><img src="/api/listings/fuzhengwei--waliapi/badge.svg" alt="findsafeskills safety rating" /></a>Install
What was scanned
The files the safety scan read, as written by the repository's author and shown as plain text. Lines with a finding are marked.
README.md · README · 1,748 lines
View this file on GitHub (read at the repository's current version: the scan did not record which commit it read)
This file has changed since it was scanned, so this is not exactly the text that was scanned, and no line is marked. The findings are listed with the safety scan above.
- <div align="center">
- <img src="public/logo.png" width="104" alt="WaLiAPI"/>
- # WaLiAPI
- ### 本地 LLM API 网关 · 多协议接入 · 知识库 RAG · MCP 工具服务
- **把 OpenAI、Claude、DeepSeek、Gemini 等上游模型供应商统一为一个本地网关,**<br>
- **用一套密钥、一套协议、一份完整审计日志,接入 Claude Code、Codex CLI、Gemini CLI、WaLiCode 等 AI 编程工具。**
- [](./src-tauri/tauri.conf.json)
- [](./LICENSE)
- [](#-快速开始)
- [](https://tauri.app)
- **[下载安装](#-快速开始)** · **[核心功能](#-核心功能)** · **[工作原理](#-工作原理)** · **[Docker 部署](#方式二docker-部署推荐云服务器团队使用)**
- **简体中文** | [English](README.en.md) | [日本語](README.ja.md)
- </div>
- > 🎁 **免费渠道开箱即用**:启动即内置 **OpenCode 免费车道** 与 **Kilo 免费池** 两条免 Key 渠道,零配置直接调用;另提供 **11 个免费层渠道预设**——国际(Groq / Cerebras / Mistral / NVIDIA NIM / OpenRouter / GitHub Models / Hugging Face / SambaNova / Cohere)与国内(ModelScope 魔搭 / SiliconFlow 硅基流动)——注册领取 API Key 即用,Google Gemini 与智谱 GLM 也提供免费层。详见 [免费渠道](#-免费渠道开箱即用)。
- ---
- ## 🧭 30 秒看懂 WaLiAPI
- 下面这张图描述了 WaLiAPI 的完整工作流:左侧是发出请求的 AI 应用,中间是 WaLiAPI 网关的处理链路(含内置的 RAG 知识库与 LLM-Wiki 知识引擎),右侧是你配置的三类上游渠道——**API 渠道**(Key 接入)、**免费渠道**(免 Key / 免费层)与**账号渠道**(OAuth 登录的 Auth 账号)。
- ```mermaid
- flowchart LR
- subgraph Clients["💬 下游 AI 应用"]
- direction TB
- A1["Claude Code"]
- A2["Codex CLI"]
- A3["Gemini CLI"]
- A4["WaLiCode"]
- A5["OpenClaw"]
- A6["ChatBox / NextChat"]
- end
- subgraph Gateway["🛡️ WaLiAPI 本地网关 127.0.0.1:8777"]
- direction TB
- B["① 多协议接入<br/>OpenAI Chat · Responses · Anthropic"]
- C["② 安全审计<br/>敏感信息扫描 · 脱敏 / 阻断"]
- D["③ 智能调度<br/>优先级 + 权重 · 多 Key 负载 · 故障切换"]
- E["④ 协议转换 · 上游适配<br/>OpenAI · Claude · Gemini · DeepSeek · 自定义"]
- B --> C --> D --> E
- subgraph Knowledge["📚 内置知识服务(复用同一调度与审计)"]
- direction LR
- R["RAG 知识库<br/>解析 → 分块 → 向量化<br/>HNSW + FTS5 混合检索问答"]
- W["LLM-Wiki<br/>Markdown 页面 · 知识图谱<br/>MCP 工具对外暴露"]
- end
- end
- subgraph Channels["☁️ 上游渠道(三类)"]
- direction TB
- F1["🔗 API 渠道(Key 接入)<br/>OpenAI · Claude · DeepSeek · Gemini<br/>智谱 · 通义 · Moonshot · 豆包 · StepFun"]
- F2["🎁 免费渠道<br/>OpenCode 车道 / Kilo 池(免 Key · 启动即内置)<br/>11 家免费层:Groq · Cerebras · Mistral · NIM · OpenRouter<br/>ModelScope · 硅基流动 · GitHub Models · HF · SambaNova · Cohere"]
- F3["👤 账号渠道(OAuth 登录)<br/>Codex · Kimi · Antigravity<br/>Qoder · WorkBuddy · Grok"]
- end
- Clients -- "统一密钥<br/>sk-waliapi-*" --> B
- E -- "HTTPS 转发" --> Channels
- Clients -. "MCP /mcp · REST /api/kb<br/>RAG 检索 · Wiki 问答" .-> Knowledge
- Knowledge -. "Embedding / 问答模型<br/>走网关调度" .-> D
- style Clients fill:#f0f7ff,stroke:#4a90d9,color:#1a3a5c
- style Gateway fill:#f6f0ff,stroke:#7c5cd6,color:#3a2a5c
- style Knowledge fill:#fffbea,stroke:#d9a514,color:#5c4a1a
- style Channels fill:#f0fdf4,stroke:#34a853,color:#1a4a2c
- ```
- **一句话总结**:所有下游 AI 应用都指向 WaLiAPI —— 它完成协议翻译、安全审计、负载均衡与日志审计,再把请求转发给你配置的 API 渠道、免费渠道或账号渠道;某个渠道额度用尽或故障时自动切换到下一个,AI 工具全程无感。网关内置 RAG 知识库与 LLM-Wiki 知识引擎,Agent 可通过 MCP / REST 直接检索私有知识,知识服务的模型调用同样走渠道调度与审计。
- ## 🎁 免费渠道开箱即用
- 不花一分钱也能跑起来。WaLiAPI 提供两类免费渠道:
- **1. 免 Key 内置渠道(零配置)**
- 首次启动时自动预建进「渠道管理」,无需注册、无需 Key,保存密钥后即可调用:
- | 渠道 | 说明 |
- |:---|:---|
- | **OpenCode 免费车道** | 公共池化凭据,网关自动完成上游 v2 指纹门禁整形(会话铸造、工具指纹声明),开箱即用 |
- | **Kilo 免费池** | 完全免 Key,直接调用 |
- 种子渠道仅添加一次,删除后不会自动加回;你可以像普通渠道一样编辑、启停或参与调度。
- **2. 免费层渠道预设(注册领 Key)**
- 「新建渠道」中选择以下预设,按界面上的「获取 API Key」链接注册即用,模型清单支持「同步上游模型」拉取(自动过滤免费可用模型):
- | 分组 | 预设 | 免费方式 |
- |:---|:---|:---|
- | 国内 | **ModelScope 魔搭** | 注册并实名后每日 2000 次免费调用(单模型 ≤500 次/天,动态限速,需中国手机号) |
- | 国内 | **SiliconFlow 硅基流动** | 实名注册送体验额度,部分小模型永久免费(固定限速,超额 429) |
- | 国际 | **Groq** | 注册领取 API Key,超高速 LPU 推理,速率与每日额度有限 |
- | 国际 | **Cerebras** | 注册即送额度,晶圆级芯片高速推理 |
- | 国际 | **Mistral** | La Plateforme 免费实验层,按日 / 月限额 |
- | 国际 | **NVIDIA NIM** | 注册送 1000 credits,聚合 DeepSeek / Kimi / GLM / MiniMax 等开源模型 |
- | 国际 | **OpenRouter** | 带 `:free` 后缀的模型免费调用,`openrouter/free` 自动路由当前可用免费池 |
- | 国际 | **GitHub Models** | GitHub PAT(`models:read` 权限)即可调用多厂商模型,个人账户免费层限速 |
- | 国际 | **Hugging Face** | 免费账户每月赠送推理额度,自动路由到合作 Provider |
- | 国际 | **SambaNova** | 邮箱注册即用(免信用卡),免费层 20 次/分钟 · 20 次/天 |
- | 国际 | **Cohere** | Trial Key 每月 1000 次调用(20 RPM),仅评估用途 |
- 此外,**已有渠道也带免费层**:Google Gemini(AI Studio 免费层,Flash 系列每日 100 万 token,15 RPM)与智谱 GLM(`glm-4.7-flash` 等 Flash 系列免费)的预设描述中已标注免费层说明与注册入口。
- > 💡 免费渠道额度与速率各有约束,超额时上游返回 429,网关会自动切换到下一个可用渠道。此外,通过「Auth 账号」OAuth 登录的账号渠道(如 Antigravity、Codex、Kimi、Qoder)也可使用账号自带额度,部分供应商提供免费或订阅内额度。
- ## 🌟 为什么选择 WaLiAPI
- - **🔌 多协议统一入口** —— 下游可以用 OpenAI Chat Completions、OpenAI Responses、Anthropic Messages 三种协议接入,网关内部完成双向转换,上游渠道无感知。Claude Code 可以跑 DeepSeek,Codex 可以跑 Kimi,一切由你编排。
- - **⚖️ 不浪费每一分额度** —— 渠道按优先级 + 权重负载均衡,单渠道支持多 API Key 加权轮询;额度用尽、渠道故障自动切换下一个候选,额度可直观查看(如 Antigravity 各模型剩余额度与重置时间)。
- - **🛡️ 让你清楚知道 AI 在说什么** —— 每一次请求/响应完整落库,可按关键词、密钥、渠道、模型、Trace ID 检索;内置 25+ 条安全规则,自动扫描敏感信息泄露、路径暴露、Unicode 隐写,支持只审计 / 警告 / 脱敏 / 阻断四种策略。
- - **📚 不止是网关** —— 内置知识库 RAG 引擎(tree-sitter 代码符号感知分块、HNSW + FTS5 混合检索)、Wiki 知识引擎和 MCP Server(29 个工具),让你的 AI Agent 能直接检索私有知识。
- - **🏠 数据完全本地化** —— 桌面端本地运行,SQLite 存储,数据不出你的电脑;同时提供 Docker / headless 服务端,适合团队服务器与私有化部署。
- > 💡 推荐配合 WaLiCode 编码使用:[https://walicode.xiaofuge.cn](https://walicode.xiaofuge.cn/)
- - Github:[https://github.com/fuzhengwei/WaLiAPI](https://github.com/fuzhengwei/WaLiAPI)
- - Gitcode:[https://gitcode.com/fuzhengwei/WaLiAPI](https://gitcode.com/fuzhengwei/WaLiAPI)
- ---
- ## 📑 目录
- - [快速开始](#-快速开始)
- - [免费渠道开箱即用](#-免费渠道开箱即用)
- - [工作原理](#-工作原理)
- - [核心功能](#-核心功能)
- - [多协议接入](#-多协议接入)
- - [技术栈](#️-技术栈)
- - [项目结构](#-项目结构)
- - [安全边界与威胁模型](#️-安全边界与威胁模型)
- - [版本历史](#-版本历史)
- - [贡献者](#-贡献者)
- - [许可证](#-license)
- ---
- ## 🚀 快速开始
- WaLiAPI 提供两种部署方式:**桌面端安装**(适合个人开发者在本地使用)和 **Docker 部署**(适合团队或云服务器长期运行)。
- ### 方式一:桌面端安装(推荐个人使用)
- #### 1. 下载安装包
- 从 GitHub Releases 或网盘下载对应平台安装包:
- - GitHub: [https://github.com/fuzhengwei/WaLiAPI/releases](https://github.com/fuzhengwei/WaLiAPI/releases)
- - 网盘: [https://drive.weixin.qq.com/s?k=ACMA4AfQABU4S23jg8#/](https://drive.weixin.qq.com/s?k=ACMA4AfQABU4S23jg8#/)
- | 平台 | 格式 | 架构 |
- |:---|:---|:---|
- | macOS | `.dmg` | ARM64 (Apple Silicon) |
- | Windows | `.msi` / `.exe` | x64 |
- | Linux | `.deb` / `.AppImage` | x64 |
- #### 2. 配置渠道
- 打开 WaLiAPI →「渠道管理」→「新建渠道」→ 填写名称、Base URL、API Key、支持的模型 → 保存。
- 使用 Antigravity OAuth 时,在「Auth 账号」登录后可查看各模型的已用、剩余额度和上游返回的重置时间;点击「刷新额度」可立即更新。额度百分比来自 Antigravity 模型目录的 `remainingFraction`,不代表具体 Token 数量。
- #### 3. 创建密钥
- 「API 密钥」→「新建密钥」→ 生成 `sk-waliapi-*` 格式的本地访问令牌。
- #### 4. 下游接入
- 在 ChatBox / NextChat / OpenAI SDK / WaLiCode 中配置:
- - **Base URL**: `http://127.0.0.1:8777/v1`
- - **API Key**: 创建的 `sk-waliapi-...` 密钥
- #### 5. 应用配置(可选)
- 在「应用配置」页面选择已安装的 AI 编程工具,一键写入网关地址和密钥,无需手动编辑配置文件。
- 其中 Claude Code 使用的是 WaLiAPI 数据面 Bearer 网关(写入单一
- `ANTHROPIC_AUTH_TOKEN`,值为所选真实密钥;不会写入 `ANTHROPIC_API_KEY`):应用配置会增量更新
- `~/.claude/settings.json`,保留已有环境变量、权限和模型选择,并在首次写入前
- 保留可恢复的原文件备份。重复应用不会覆盖该备份;点击恢复即可回到写入前的
- 原始内容,若文件原本不存在则会删除本次创建的文件。
- Claude Code 的网关密钥不等于 Anthropic 账号登录状态;配置写入后请重启客户端并发送一条消息验证。
- 发送失败或出现「Not logged in」应按故障排查,不能忽略。只有
- 需要使用 Anthropic 账号直连时才应登录。对于 Claude Code 目录未知的非 Claude
- 模型,WaLiAPI 只会在已有可信模型元数据时写入上下文窗口;没有可信窗口时保留
- Claude Code 默认值,不会把未知模型擅自声明为 1M。需要自定义窗口时,请在
- `settings.json` 中明确设置 `CLAUDE_CODE_MAX_CONTEXT_TOKENS` 与不大于它的
- `CLAUDE_CODE_AUTO_COMPACT_WINDOW`,用户值会优先于自动兼容值。
- ### 方式二:Docker 部署(推荐云服务器/团队使用)
- WaLiAPI 提供 Docker 镜像,适合部署到 Linux 云服务器长期运行。镜像采用多阶段构建:Node/pnpm 编译前端,Rust 编译服务端二进制,运行时使用非 root 用户;SQLite 数据持久化在 `/data`。
- #### 快速启动
- 使用 Docker Hub 镜像 `fuzhengwei/waliapi` 一键部署:
- ```bash
- # 拉取镜像
- docker pull fuzhengwei/waliapi:latest
- # 生成管理令牌
- export WALIAPI_ADMIN_TOKEN="$(openssl rand -hex 32)"
- export WALIAPI_MCP_TOKEN="$(openssl rand -hex 32)"
- # 启动容器
- docker run -d --name waliapi \
- -p 127.0.0.1:8777:8777 \
- -v waliapi-data:/data \
- -e WALIAPI_ADMIN_TOKEN \
- -e WALIAPI_MCP_TOKEN \
- fuzhengwei/waliapi:latest
- docker run -d --name waliapi \
- -p 127.0.0.1:8777:8777 \
- -v waliapi-data:/data \
- -e WALIAPI_ADMIN_TOKEN \
- -e WALIAPI_MCP_TOKEN \
- registry.cn-hangzhou.aliyuncs.com/xfg-studio/waliapi:0.2.5-amd64
- # 验证服务
- curl http://127.0.0.1:8777/health
- ```
- #### 使用 Docker Compose
- 从源码构建部署(也可直接使用上面的镜像):
- ```bash
- git clone https://github.com/fuzhengwei/WaLiAPI.git
- cd WaLiAPI
- export WALIAPI_ADMIN_TOKEN="$(openssl rand -hex 32)"
- export WALIAPI_MCP_TOKEN="$(openssl rand -hex 32)"
- docker compose up -d --build
- curl http://127.0.0.1:8777/health
- ```
- #### 配置说明
- | 环境变量 | 说明 | 默认值 |
- |:---|:---|:---|
- | `WALIAPI_SERVER_HOST` | 监听地址 | `0.0.0.0`(Docker)/ `127.0.0.1`(桌面) |
- | `WALIAPI_SERVER_PORT` | 监听端口 | `8777` |
- | `WALIAPI_DATA_DIR` | 数据目录(SQLite + 知识库索引) | `/data` |
- | `WALIAPI_ADMIN_TOKEN` | KB/Wiki REST(`/api/kb`、`/api/wiki`)认证令牌(≥32 字符,Bearer) | 未配置则管理操作不可用;已授权的 API Key 可查询 RAG |
- | `WALIAPI_MCP_TOKEN` | MCP 端点认证令牌(≥32 字符,Bearer,须与 ADMIN 不同) | 未配置则管理工具 / SSE 不可用;已授权的 API Key 可通过 POST 查询 RAG |
- | `WALIAPI_PUBLIC_URL` | 公网访问地址(生成客户端配置时使用) | — |
- Web 管理面板的前端静态资源已内嵌进 `waliapi-web` 二进制(rust-embed),无需单独的静态资源目录。
- #### 反向代理与 HTTPS
- Compose 默认只发布到宿主机 `127.0.0.1`(可用 `WALIAPI_BIND` / `WALIAPI_PORT` 变量覆盖),生产环境不要把端口直接暴露到公网。推荐使用 Caddy 或 Nginx 终止 HTTPS 后反代到 `127.0.0.1:8777`。Caddy 配置域名后会自动申请和续期证书,示例配置见 [`deploy/caddy/Caddyfile.example`](deploy/caddy/Caddyfile.example)。
- #### 认证体系
- 后台会话、管理 Token 和 API Key 的权限分别管理:
- - **Web 管理面板**:管理员用户名/密码登录会话(首次启动自动生成初始密码,存于数据目录 `INITIAL_PASSWORD` 文件)
- - **RAG 查询**:在“密钥 → 知识库查询权限”勾选允许访问的 RAG,使用同一个 API Key 调用 REST / MCP;无需设置环境变量 Token。旧 Key 默认没有知识库权限。
- - **KB/Wiki REST 管理操作**:`WALIAPI_ADMIN_TOKEN`(`Authorization: Bearer <token>`);不接受普通 API Key。
- - **MCP**(`/mcp`):已授权 API Key 可用无会话 HTTP POST 调用 5 个 RAG 查询工具,目标库还须开启 MCP;管理工具、Wiki 和旧版 SSE 继续使用 `WALIAPI_MCP_TOKEN`。
- - **数据面 API**(`/v1/*`):后台创建的 `sk-waliapi-*` 密钥
- ```bash
- # 将已授权的 API Key 保存到 WALIAPI_API_KEY 环境变量
- curl -H "Authorization: Bearer $WALIAPI_API_KEY" http://127.0.0.1:8777/api/kb
- curl http://127.0.0.1:8777/api/kb/ask \
- -H "Authorization: Bearer $WALIAPI_API_KEY" -H "Content-Type: application/json" \
- -d '{"kb_id":"你的知识库 ID","question":"你的问题","model":"已授权的生成模型"}'
- ```
- RAG 的“服务 → MCP”页可选择已授权 Key 测试 REST / MCP 连接;测试不调用模型。查询必须指定 `kb_id`,`top_k` 为 1–50,向量检索与问答的全部模型调用沿用该 Key 的模型、渠道限制和额度,Embedding 也会记录在该 Key 的日志中。API Key 暂不支持 `deep_research`,也不能读取或写入共享会话历史。
- 宽松 CORS 只作用于数据面 `/v1/*` 路由;KB/Wiki/MCP 服务路由与管理面板不附带跨域允许头,任意网页无法跨域读取知识资产。反向代理只负责 TLS 和转发,不得移除或绕过认证头。绑定非回环地址而缺少上述 token 时,启动日志会输出醒目告警。
- <details>
- <summary>📦 不使用 Docker:systemd 部署</summary>
- 先执行 `pnpm build` 和 `cargo build --release --manifest-path src-tauri/Cargo.toml --bin waliapi-web --no-default-features --features embed-web`。将 release 二进制和前端 `dist/` 放到 `/opt/waliapi/`,创建 `waliapi` 系统用户。systemd 沙箱通过 `StateDirectory=waliapi` 创建并授权固定的数据目录 `/var/lib/waliapi`;若确需改到其他目录,必须同步修改 unit 的可写路径。
- 用仅 root 可读的权限安装环境文件,再填写管理员 token:
- ```bash
- sudo install -Dm600 deploy/systemd/waliapi.env.example /etc/waliapi/waliapi.env
- sudo chown root:root /etc/waliapi/waliapi.env
- sudoedit /etc/waliapi/waliapi.env
- ```
- 然后安装服务:
- ```bash
- sudo install -Dm644 deploy/systemd/waliapi.service /etc/systemd/system/waliapi.service
- sudo systemctl daemon-reload
- sudo systemctl enable --now waliapi
- sudo systemctl status waliapi
- ```
- </details>
- <details>
- <summary>🔧 GitHub Actions 发布</summary>
- [`release-web.yml`](.github/workflows/release-web.yml) 可以直接生成两类 Linux Web 产物:
- - `waliapi-web-<version>-linux-x86_64.tar.gz`:包含 `waliapi-server`、`dist/`、systemd 和 Caddy 示例;每次手动运行都会保存为 Workflow Artifact。
- - `ghcr.io/<owner>/<repository>:<version>`:通过 GHCR 发布的 `linux/amd64` Docker 镜像。
- 推送 `web-v*` 标签会创建 GitHub Release、上传二进制包,并发布带版本号和 `latest` 标签的镜像:
- ```bash
- git tag web-v0.2.1
- git push origin web-v0.2.1
- ```
- 也可以从 Actions 页面手动运行;默认只构建和验证 Docker 镜像,勾选 `publish_image` 才会推送到 GHCR。工作流不需要、也不会读取管理员 token。镜像和二进制包都是无密钥的通用产物,必须在运行时注入。
- </details>
- #### 数据备份与运维
- - 保持单实例运行(SQLite 不支持多个写入实例共享同一数据目录)
- - 定期在停机窗口或使用 SQLite 一致性备份方式备份 `/data`(systemd 部署为 `/var/lib/waliapi`)
- - 升级前保留可回滚副本
- - 管理员 token、渠道密钥和数据库备份都属于敏感数据,应限制文件权限并通过 HTTPS 传输
- ---
- ## 🔄 工作原理
- WaLiAPI 作为本地网关,在下游 AI 应用和上游模型供应商之间做协议翻译、负载均衡、安全审计和日志记录。同时内置知识库引擎、Wiki 知识引擎和 MCP Server,让 AI Agent 能直接检索私有知识。
- 下面是完整的内部架构(含知识库 / Wiki / MCP 服务子系统):
- ### 请求转发流程
- ```mermaid
- graph TD
- subgraph Downstream[下游 AI 应用]
- A1[WaLiCode]
- A2[Claude Code]
- A3[Codex CLI]
- A4[Gemini CLI]
- A5[OpenClaw]
- A6[ChatBox / NextChat]
- end
- Downstream -->|"OpenAI / Anthropic / Responses 协议<br/>Authorization: Bearer sk-waliapi-*"| Gateway
- subgraph Gateway[WaLiAPI 本地网关]
- B[协议转换层<br/>OpenAI Chat · Responses · Anthropic<br/>双向转换]
- C[安全审计引擎<br/>风险扫描 · 脱敏/阻断 · 规则引擎]
- D[渠道调度器<br/>优先级+权重 · 故障切换 · 模型映射]
- E[适配器层<br/>OpenAI · Claude · DeepSeek<br/>Gemini · Custom]
- F[审计日志记录<br/>请求/响应体 · Token 统计 · Trace ID]
- B --> C --> D --> E
- C --> F
- subgraph KBService[知识库 & Wiki & MCP 服务]
- G1[文档解析<br/>Markdown / Code / PDF]
- G2[智能分块器<br/>滑动窗口 · 符号感知]
- G3[向量化<br/>复用渠道 Embedding]
- G4[HNSW 索引<br/>向量检索 + FTS5 混合]
- G5[RAG 引擎<br/>混合检索 → 重排 → 生成回答]
- G6["MCP Server<br/>Streamable HTTP + SSE<br/>29 个工具 [KB 13 + Wiki 16]"]
- G7[Wiki 引擎<br/>结构化知识库 · frontmatter 标签<br/>wikilinks 图谱 · 摄入管道]
- G1 --> G2 --> G3 --> G4
- G4 --> G5
- G4 -.-> G6
- G7 -.-> G6
- end
- end
- E -->|HTTPS| Upstream
- subgraph Upstream[上游模型供应商]
- U1[OpenAI]
- U2[Claude]
- U3[DeepSeek]
- U4[Gemini]
- U5[通义 · 智谱 · Moonshot · StepFun · 豆包 · Ollama]
- end
- ```
- ### 知识库 RAG 流程
- <details>
- <summary>📁 点击展开详情</summary>
- ```mermaid
- flowchart TD
- A[用户上传文档] --> B[文档解析器<br/>Markdown / Code / PDF / JSON / YAML]
- B --> C[tree-sitter 代码符号提取<br/>函数 / 类 / 结构体 / 接口]
- C --> D[智能分块器<br/>滑动窗口 + 重叠分块 · 符号感知]
- D --> E[向量化引擎<br/>复用 WaLiAPI 渠道调度<br/>text-embedding]
- E --> F
- subgraph F[存储 + 索引]
- F1[(SQLite<br/>chunks + FTS5)]
- F2[(HNSW 向量索引<br/>文件存储)]
- end
- F --> G[检索阶段<br/>向量检索 HNSW + FTS5 全文检索<br/>→ 加权混合排序 Hybrid]
- G --> H[RAG 生成阶段<br/>组装 Top-K 片段 + 对话历史<br/>→ 通过网关转发至 LLM<br/>→ 生成回答 + 来源引用]
- ```
- </details>
- ### MCP 工具服务
- <details>
- <summary>🔗 点击展开详情</summary>
- WaLiAPI 内置 MCP (Model Context Protocol) Server,通过 Streamable HTTP + SSE 端点对外暴露 **29 个工具**(知识库 13 个 + Wiki 16 个),任何支持 MCP 的 AI Agent 均可接入:
- ```mermaid
- flowchart LR
- Agent[AI Agent<br/>Claude / OpenClaw / ...] -->|"POST /mcp<br/>JSON-RPC"| MCP
- MCP -->|"SSE Stream"| Agent
- subgraph MCP[MCP Server — WaLiAPI]
- subgraph KBTools[知识库工具 ×13]
- T1[search_knowledge_base<br/>语义搜索]
- T2[ask_knowledge_base<br/>RAG 问答]
- T3[read_document<br/>读取文档]
- T4[list_knowledge_bases<br/>列出知识库]
- T5[get_knowledge_base_stats<br/>知识库统计]
- T6[create / update / delete<br/>知识库 CRUD]
- T7[upload_document<br/>上传文档]
- T8[list_documents<br/>文档列表]
- T9[build_index<br/>构建索引]
- T10[import_source<br/>多源导入]
- T11[delete_document<br/>删除文档]
- end
- subgraph WikiTools[Wiki 工具 ×16]
- W1[list / get / create<br/>delete_wiki_project]
- W2[list / get / save<br/>delete_wiki_page]
- W3[search_wiki<br/>页面搜索]
- W4[ask_wiki<br/>Wiki 问答]
- W5[get_wiki_tags<br/>标签列表]
- W6[get_wiki_graph<br/>知识图谱]
- W7[list / add / delete<br/>ingest_wiki_source]
- end
- end
- MCP --> KB[(知识库 + Wiki<br/>SQLite + HNSW)]
- ```
- </details>
- ---
- ## 🎯 核心功能
- ### 🔌 多渠道管理
- - 支持 **11 种渠道类型**:OpenAI、DeepSeek、Claude、Gemini、智谱、通义、Moonshot、阶跃星辰 StepFun、豆包、Ollama 及自定义渠道
- - 优先级 + 权重的负载均衡策略,自动故障切换
- - **多 Key 负载均衡**:单个渠道可配置多个 API Key,每个 Key 独立设置权重,请求按权重随机选择 Key 转发,分散单渠道并发压力
- - **渠道复制**:一键复制现有渠道配置,快速创建相似渠道,免去重复配置
- - 模型映射(渠道级别 model mapping),下游模型名自动映射到上游实际模型
- - 渠道连通性测试,实时显示延迟与错误信息
- - 渠道统计:调用次数、Token 消耗、成功率、平均延迟
- ### 🔑 密钥管理
- - 为下游应用生成 `sk-waliapi-*` 格式的本地访问密钥
- - 支持配额限制与启用/禁用
- - 每个密钥展示调用次数、成功率、Token 消耗、平均延迟
- ### 📊 仪表盘
- - 6 项核心指标一目了然:今日请求、今日 Token、累计请求、累计 Token、活跃渠道、平均延迟
- - 服务可用率徽章,颜色分级(绿/黄/红)实时反映健康度
- - 运维建议根据当前数据动态生成(延迟超阈值建议排查、渠道不足建议启用等)
- ### 📝 审计日志
- - 完整记录每次 API 调用:请求体、响应体、模型参数、工具调用、Token 消耗、状态码
- - 支持按关键词、密钥、渠道、模型、日期范围、Trace ID 搜索筛选
- - 请求/响应 JSON 标签页切换,Trace ID 默认折叠可展开
- - 日志编号自增,方便定位与引用
- - **自动刷新**:页面可见时每 5 秒静默轮询,新日志自动出现,无需手动刷新
- - 日志清理:按日期删除 / 一键清空
- ### 🛡️ 安全审计中心
- - **风险检测引擎**:自动扫描请求中的敏感信息泄露(API Key、私钥、JWT、Cookie、Bearer Token)、敏感文件路径(`~/.ssh`、`.env`、云凭据)、Unicode 隐写字符(零宽字符、方向控制字符)、可疑工具调用(`curl` 外联、管道上传)、网络风险(公网 IP 探测、Webhook/隧道域名)、追踪像素与风控指纹
- - **风险等级**:clean / info / low / medium / high / critical,综合评分 0–100
- - **策略模式**:只审计 / 警告 / 脱敏 / 阻断,默认只审计不影响请求
- - **规则管理**:内置 25+ 条风险规则 + 自定义黑白名单(域名/工具/路径/关键词)
- ### 📚 知识库引擎
- - **文档解析**:Markdown、代码文件(TS/JS/Python/Rust/Go/Java 等 20+ 语言)、PDF、JSON/YAML/CSV
- - **代码符号感知**:基于 tree-sitter 提取函数、类、结构体等符号信息,分块时保留语义边界
- - **智能分块**:滑动窗口 + 重叠分块,符号感知避免截断函数体
- - **向量化**:复用 WaLiAPI 渠道调度获取 Embedding,无需额外配置
- - **HNSW 向量索引**:轻量级分层导航小世界图,O(log n) 检索复杂度,适合桌面级数据量(≤100K 切片)
- - **FTS5 混合检索**:向量语义检索 + SQLite FTS5 全文检索加权融合,支持三种模式(向量 / 关键词 / 混合)
- - **RAG 问答**:检索 Top-K 片段 + 对话历史 → 网关转发至 LLM → 生成回答 + 来源引用
- - **多源导入**:Git 仓库克隆导入、URL 批量导入、本地目录扫描导入
- - **会话管理**:按知识库维度的对话历史记录与清除
- ### 📓 Wiki 知识引擎
- - **结构化知识库**:以项目为单位组织 Wiki,页面按 Markdown + frontmatter 管理,支持目录层级
- - **文档摄入管道**:源文件解析 → 结构化页面生成 → 自动提取 frontmatter 标签和 `[[wikilinks]]` → 摄入状态机(pending / ingested / failed)
- - **页面管理**:CRUD 操作、按路径/标题/内容搜索、按标签筛选
- - **Wiki 问答**:检索相关页面 → LLM 生成回答 + 来源引用
- - **知识图谱**:页面(节点)+ wikilinks(边)构成图谱,可视化知识关联
- - **标签体系**:从 frontmatter 自动提取标签,按频率排序
- - **多源管理**:Wiki 源文件列表、添加、删除、摄入
- ### 🔗 MCP Server
- - 内置 Model Context Protocol Server,通过 `/mcp` 端点对外提供 **29 个工具**(知识库 13 + Wiki 16)
- - 支持 Streamable HTTP(POST JSON-RPC)和 SSE(GET 升级)两种传输模式
- - 兼容 Claude Desktop、OpenClaw 等支持 MCP 协议的 AI Agent
- - **知识库工具**(13 个):搜索、RAG 问答、读取文档、知识库 CRUD、文档上传/删除、索引管理、多源导入
- - **Wiki 工具**(16 个):项目 CRUD、页面 CRUD、搜索、问答、标签、图谱、源文件管理、摄入
- ### ⚙️ 设置中心
- - Tab 切换式布局:安全审计 / 服务配置 / 通用设置 / 界面设置 / 重试策略
- - 深色 / 浅色 / 跟随系统主题切换
- - 最小化到托盘、关闭到托盘、开机自启
- - 失败自动重试策略配置(默认 2 次)
- ### 🔧 应用配置
- - 一键将 WaLiAPI 网关地址和密钥写入 8 款 AI 编程工具的配置文件:
- Claude Code、Codex CLI、Gemini CLI、Claude Desktop、OpenCode、OpenClaw、Hermes Agent、WaLiCode
- - 自动检测已安装应用,支持配置预览、写入、清除、打开配置目录
- ### 📦 导入导出
- - 渠道配置批量导出为 JSON 备份
- - 支持导入 WaLiCode 备份文件恢复渠道配置
- ### 📡 流式响应
- - 完整 SSE 流式转发,兼容 ChatBox / NextChat / OpenAI SDK 等下游客户端
- - 流式使用量解析(累积 input/output tokens)
- ---
- ## 🔗 多协议接入
- WaLiAPI 在网关层做协议翻译,入口多协议,出口统一为 OpenAI Chat Completions,上游渠道无感知。
- | 协议 | 端点 | 认证方式 | 说明 |
- |:---|:---|:---|:---|
- | **OpenAI Chat Completions** | `POST /v1/chat/completions` | `Authorization: Bearer sk-waliapi-*` | 标准兼容协议,支持流式 |
- | **OpenAI Responses** | `POST /v1/responses` | `Authorization: Bearer sk-waliapi-*` | Responses API 双向转换 |
- | **Anthropic Messages** | `POST /v1/messages` | `x-api-key: sk-waliapi-*` | Anthropic 协议,自动头转换 |
- | **OpenAI Embeddings** | `POST /v1/embeddings` | `Authorization: Bearer sk-waliapi-*` | 向量嵌入,知识库复用 |
- | **模型列表** | `GET /v1/models` | `Authorization: Bearer sk-waliapi-*` | 聚合启用渠道 + Auth 账号的模型 |
- | **健康检查** | `GET /health` | 无 | 服务存活探针 |
- | **MCP** | `POST /mcp` / `GET /mcp` | — | MCP Streamable HTTP + SSE |
- | **知识库 API** | `/api/kb/*` | — | 知识库 CRUD、搜索、RAG |
- 接入示例(以 OpenAI 协议为例):
- ```bash
- curl http://127.0.0.1:8777/v1/chat/completions \
- -H "Authorization: Bearer sk-waliapi-xxxx" \
- -H "Content-Type: application/json" \
- -d '{
- "model": "gpt-4o",
- "messages": [{"role": "user", "content": "Hello!"}]
- }'
- ```
- 接入示例(以 Anthropic 协议为例):
- ```bash
- curl http://127.0.0.1:8777/v1/messages \
- -H "x-api-key: sk-waliapi-xxxx" \
- -H "anthropic-version: 2023-06-01" \
- -H "Content-Type: application/json" \
- -d '{
- "model": "claude-sonnet-4-20250514",
- "max_tokens": 1024,
- "messages": [{"role": "user", "content": "Hello!"}]
- }'
- ```
- > 💡 在「接入示例」页面可查看 cURL / Python / Node.js / TypeScript / Rust / Java 共 5 平台 × 3 协议 = 15 套代码示例。
- ---
- ## 🏗️ 技术栈
- | 层 | 技术 | 版本 |
- |:---|:---|:---|
- | 前端 | React + TypeScript + Vite + Tailwind CSS + Zustand | 19 / 5.x / 7 / 4 / 5 |
- | 后端 | Rust + Tauri 2 + Axum + SQLite (sqlx) + Reqwest | Edition 2021 |
- | UI | shadcn/ui 风格 + Lucide Icons + React Router 7 | — |
- | 知识库 | tree-sitter (7 语言) + HNSW + FTS5 + bincode | — |
- | Wiki | Markdown + frontmatter 解析 + wikilinks 图谱 + SQLite | — |
- | 打包 | Tauri bundler(.dmg / .msi / .deb / .AppImage) | 2.x |
- ---
- ## 📁 项目结构
- ```
- WaLiAPI/
- ├── src/ # 前端源码
- │ ├── pages/
- │ │ ├── DashboardPage.tsx # 仪表盘
- │ │ ├── ChannelsPage.tsx # 渠道管理
- │ │ ├── AuthChannelsPage.tsx # Auth 账号管理
- │ │ ├── ApiKeysPage.tsx # 密钥管理
- │ │ ├── LogsPage.tsx # 审计日志
- │ │ ├── KnowledgeBasePage.tsx # 知识库 + Wiki + MCP 服务
- │ │ ├── UsagePage.tsx # 接入示例
- │ │ ├── SettingsPage.tsx # 设置中心
- │ │ └── AppConfigPage.tsx # 应用配置
- │ ├── components/ # 通用组件
- │ │ ├── ChannelForm.tsx # 渠道表单
- │ │ ├── ImportDialog.tsx # 导入对话框
- │ │ ├── MappingSection.tsx # 模型映射组件
- │ │ ├── UpdateChecker.tsx # 应用更新检查
- │ │ ├── auth/ # Auth 账号组件
- │ │ ├── channel-form/ # 渠道表单子组件
- │ │ └── layout/ # 布局组件
- │ ├── hooks/ # 自定义 Hooks
- │ ├── lib/ # 工具库 (api.ts, constants.ts)
- │ └── types/ # TypeScript 类型定义
- ├── src-tauri/ # 后端源码
- │ ├── src/
- │ │ ├── server/ # HTTP 服务器
- │ │ │ ├── router.rs # 路由定义 (含服务注册)
- │ │ │ └── handlers.rs # 请求处理器
- │ │ ├── adaptor/ # 渠道适配器
- │ │ │ ├── mod.rs # Adaptor Trait + 配置
- │ │ │ ├── openai.rs # OpenAI 适配器
- │ │ │ ├── claude.rs # Claude 适配器
- │ │ │ ├── deepseek.rs # DeepSeek 适配器
- │ │ │ ├── gemini.rs # Gemini 适配器
- │ │ │ └── custom.rs # 自定义适配器
- │ │ ├── protocol/ # 协议转换层 (v0.2.1 结构化重构)
- │ │ │ ├── mod.rs # 双向格式转换
- │ │ │ ├── sse_bridge.rs # SSE 流桥接 (字节级重组 · CJK 安全)
- │ │ │ ├── codec/ # 编解码器 (目录化)
- │ │ │ │ ├── chat/ # Chat 协议编解码
- │ │ │ │ ├── messages/ # Anthropic Messages 编解码
- │ │ │ │ ├── responses_codec/ # Responses API 编解码
- │ │ │ │ └── directions/ # 跨协议方向转换
- │ │ │ │ ├── messages_to_responses/
- │ │ │ │ └── responses_to_messages/
- │ │ │ └── responses.rs # Responses SSE 流式
- │ │ ├── core/ # 核心逻辑
- │ │ │ ├── proxy.rs # 代理转发 + 安全扫描 + 重试
- │ │ │ ├── dispatcher.rs # 渠道调度 (优先级/权重/故障切换)
- │ │ │ ├── endpoint_executor/ # 端点执行器
- │ │ │ │ ├── driver.rs # 请求驱动 (日志写入/重试/流式)
- │ │ │ │ ├── sse.rs # SSE 流处理
- │ │ │ │ └── estimate_usage.rs # Token 用量估算
- │ │ │ └── auth_provider/ # Auth 账号管理
- │ │ │ ├── service.rs # Auth 服务
- │ │ │ ├── maintenance.rs # Token 维护/刷新
- │ │ │ ├── codex_login.rs # Codex 登录流程
- │ │ │ ├── codex_backend.rs # Codex 后端对接
- │ │ │ ├── kimi_login.rs # Kimi 设备 OAuth 登录
- │ │ │ ├── kimi_backend.rs # Kimi 后端对接
- │ │ │ ├── spec.rs # Provider 元数据与协议快照
- │ │ │ └── types.rs # Auth 通用类型
- │ │ ├── security/ # 安全审计
- │ │ │ ├── scanner.rs # 风险扫描引擎
- │ │ │ ├── rules.rs # 规则定义
- │ │ │ ├── redact.rs # 脱敏处理
- │ │ │ └── mod.rs # 安全设置
- │ │ ├── services/ # 服务层
- │ │ │ ├── mod.rs # Service Trait + 注册表
- │ │ │ ├── knowledge/ # 知识库服务
- │ │ │ │ ├── parser.rs # 文档解析 (MD/Code/PDF/JSON)
- │ │ │ │ ├── code_parser.rs # tree-sitter 代码符号提取
- │ │ │ │ ├── splitter.rs # 智能分块器
- │ │ │ │ ├── embedder.rs # 向量化 (复用渠道调度)
- │ │ │ │ ├── index.rs # HNSW 向量索引
- │ │ │ │ ├── retriever.rs # 混合检索 (HNSW + FTS5)
- │ │ │ │ ├── rag.rs # RAG 问答引擎
- │ │ │ │ ├── processor.rs # 文档处理流水线
- │ │ │ │ ├── importer.rs # 多源导入 (Git/URL/目录)
- │ │ │ │ ├── repository.rs # 数据访问层
- │ │ │ │ └── routes.rs # 知识库路由
- │ │ │ ├── wiki/ # Wiki 知识引擎
- │ │ │ │ ├── mod.rs # WikiService 定义
- │ │ │ │ ├── models.rs # 数据模型 (Project/Page/Source)
- │ │ │ │ ├── repository.rs # 数据访问层
- │ │ │ │ ├── project.rs # 项目目录管理
- │ │ │ │ ├── ingest.rs # 文档摄入管道 (frontmatter/wikilinks)
- │ │ │ │ ├── handlers.rs # Wiki 请求处理器
- │ │ │ │ └── routes.rs # Wiki 路由
- │ │ │ └── mcp/ # MCP Server
- │ │ │ ├── mod.rs # MCP Service 定义
- │ │ │ └── handlers.rs # JSON-RPC 工具处理 (29 个工具)
- │ │ ├── commands/ # Tauri Commands
- │ │ │ ├── channel.rs # 渠道管理
- │ │ │ ├── api_key.rs # 密钥管理
- │ │ │ ├── auth.rs # Auth 账号管理
- │ │ │ ├── log.rs # 日志管理
- │ │ │ ├── stats.rs # 统计数据
- │ │ │ ├── settings.rs # 设置管理
- │ │ │ ├── security.rs # 安全规则
- │ │ │ ├── knowledge_base.rs # 知识库命令
- │ │ │ ├── wiki.rs # Wiki 命令
- │ │ │ ├── services.rs # 服务状态
- │ │ │ ├── app_config.rs # 应用配置 (8 款工具)
- │ │ │ ├── import_export.rs # 导入导出
- │ │ │ └── server.rs # 服务控制
- │ │ ├── db/ # 数据库层
- │ │ │ ├── mod.rs # Database 初始化
- │ │ │ ├── models.rs # 数据模型
- │ │ │ └── repository.rs # 数据访问
- │ │ ├── utils/ # 工具函数
- │ │ ├── channel_presets.rs # 渠道预设注册表
- │ │ ├── lib.rs # 入口 + 系统托盘
- │ │ └── main.rs # main 函数
- │ ├── migrations/ # 数据库迁移 (27 个)
- │ └── tauri.conf.json # Tauri 配置
- └── package.json
- ```
- ---
- ## 🛡️ 安全边界与威胁模型
- WaLiAPI 定位为**本地 / 内网优先**的 LLM 网关。公网部署前请先阅读本节,并确认边界假设与你的部署环境一致。
- **凭证与权限**:
- | 用途 | 凭证 | 说明 |
- |:---|:---|:---|
- | 数据面 `/v1/*` | `sk-waliapi-*` 网关密钥 | 供下游客户端调用网关 |
- | Web 管理面 | 管理员登录会话(独立于服务端 Token) | 首次启动生成随机管理员密码(stdout + 数据目录 `INITIAL_PASSWORD` 文件,首次登录成功后文件即删除);登录失败限速(指数退避)、会话 Cookie 为 HttpOnly、改密后吊销全部旧会话 |
- | KB/Wiki 管理 REST | `WALIAPI_ADMIN_TOKEN`(≥32 字符) | 上传、修改、删除等管理操作 |
- | RAG REST / MCP 查询 | 已授权知识库的 API Key | MCP 仅无会话 HTTP POST,不能访问管理工具 |
- | MCP 管理工具 / Wiki / SSE | `WALIAPI_MCP_TOKEN`(≥32 字符,须与管理 token 不同) | 保留原有接入方式 |
- **明文密钥存储(知情声明)**:上游渠道密钥与网关 API Key 以**明文**存储在本地 SQLite 数据目录中——数据目录的文件系统权限就是安全边界,本项目不提供静态加密。渠道导出文件包含明文密钥(界面有明示警告),请仅在受控环境操作。网关密钥在管理界面仅显示掩码,复制等显式动作才按需取回全量。
- **安全扫描的边界(尽力而为的 DLP)**:内置风险扫描引擎(敏感信息、路径、Unicode 隐写等规则)是启发式检测,按策略支持只审计 / 警告 / 脱敏 / 阻断,定位为「尽力而为的数据泄露防护」,不构成完整的内容安全方案。响应侧扫描覆盖非流式、流式与原生 Anthropic 路径,为尽力而为语义——扫描异常不阻断响应转发;扫描预算超限按 fail-closed 拒绝请求。
- **CORS 作用域**:宽松 CORS(`Access-Control-Allow-Origin: *`)**仅**作用于数据面网关路由(API Key 鉴权的 `/v1/*`——跨域调用是网关的设计用法)。管理面、KB/Wiki REST 与 MCP 端点不附带宽松 CORS,浏览器跨域不可读取其响应;管理面另带 CSRF 防护(变更类请求要求 `X-Requested-With` 头)。
- **公网部署建议**:Docker 默认仅绑定 `127.0.0.1`;确需公网暴露时,由 Caddy/Nginx 终止 TLS 后反代,注入强 `WALIAPI_ADMIN_TOKEN` / `WALIAPI_MCP_TOKEN`,不要移除认证头;SQLite 不支持多实例写同一数据目录,保持单实例。
- **视觉能力路由(长期方案,#15)**:当前版本对「请求含图片块而上游渠道以 400 拒绝」的场景,在错误信息中追加**诊断提示**(该渠道疑似不支持图片),不改变路由行为(fail-open)。基于渠道能力标记(`supports_vision`)的故障转移跳过是长期方案,见 `docs/reliability-fixes-prd.md`。
- ---
- ## 📌 版本历史
- ### v0.4.5 (2026-10-22)
- #### 免费渠道对接(@fuzhengwei)
- - ✨ **内置免费渠道种子,开箱即用**:启动时自动预建 OpenCode 免费车道与 Kilo 免费池两条免 Key 免费渠道(`services/builtin_channels.rs`),零配置即可调用;每实例仅种子一次,删除后不会自动加回,幂等兜底不产生重复渠道
- - ✨ **OpenCode 免费车道专用执行器**:新增 `endpoint_executor/opencode_lane.rs`,就地把请求整形为上游 v2 客户端指纹门禁接受的形状(公开令牌 `public`、固定 UA / 客户端头、会话 id 降序编码铸造 + 会话池轮换、`read` / `shell` 工具指纹逐字声明与同名工具改名),绕开 403 FreeTierError
- - ✨ **新增 11 个免费层渠道预设**:Groq / Cerebras / Mistral / NVIDIA NIM / OpenRouter / GitHub Models / Hugging Face / SambaNova / Cohere(国际)与 ModelScope 魔搭 / SiliconFlow 硅基流动(国内),预设新增 `key_signup_url`「获取 API Key」跳转链接(前端在 Key 配置上方渲染注册提示),配套基线测试守护
- - ✨ **免费模型同步过滤**:Kilo 同步只保留 `isFree == true` 模型、OpenCode 同步只保留 `-free` 后缀模型(付费模型免 Key 调用必 401,同步进来只会误导),各自新增回归测试
- - ✨ **免费层标注补齐**:Google Gemini(AI Studio Flash 免费层每日 100 万 token)与智谱 GLM(`glm-4.7-flash` 等免费)预设描述补充免费层说明并补注册链接
- - 📝 **免费渠道对接方案文档**:新增 `docs/free-channel-integration-plan.md`;全量 `cargo fmt`(无功能变化)
- #### Wiki 重建与体验(PR #166,@freakojc)
- - ✨ **Wiki index/log 累积修复**:程序化重建(`services/wiki/rebuild.rs`)——程序化重建索引 + LLM 语义归组 + log 一致性回溯
- - 🎨 **Wiki 页面 tab 体验修复与增强**:页面滚动位置保持、下拉样式统一、搜索文档能力增强
- #### WorkBuddy 兼容(PR #168,@mw)
- - 🐛 **WorkBuddy 响应数据兼容性处理**:后端响应解析与 SSE 流式处理兼容加固
- #### 其他
- - 📝 **README 完善**:顶部新增「免费渠道开箱即用」提示;「30 秒看懂」架构图补充内置知识服务(RAG / LLM-Wiki)与三类上游渠道(API 渠道 / 免费渠道 / 账号渠道)分流;贡献者数据同步
- - 🔧 **版本号统一升级至 0.4.5**(package.json / Cargo.toml / tauri.conf.json / Cargo.lock)
- ### v0.4.4 (2026-10-18)
- #### Wiki 备份与全链路修复(PR #163 #164,@freakojc)
- - ✨ **Wiki 项目导出 / 导入 zip 备份恢复**:新增 `services/wiki/backup.rs`,将页面 Markdown、源文件、图片资产(含 token)与核心数据打包为 zip 备份;新增导出 / 导入命令与管理端路由,前端新增「导出 Wiki 备份」弹窗
- - 🐛 **ask_wiki 全链路修复**:修复中文标点按字节切片导致的 panic、图片 URL 嵌套解析、推理档位审计归因到真实 API Key、MCP 工具描述双 `http://` 前缀、渠道导入导出图标方向
- #### 协议转换(PR #165,@ymsy2021)
- - 🐛 **Responses→Chat 转换缺省时不再注入 max_tokens=4096**:Codex 等 Responses 客户端从不发送 `max_output_tokens`,旧转换硬编码 `max_tokens=4096` 导致长回答被静默腰斩(`finish_reason=length`,且预算含 reasoning tokens);现仅在请求显式携带时映射注入(修复 #162)
- #### UI 统一(@fuzhengwei)
- - 🎨 **推理档位下拉框统一**:知识库设置、新建 Wiki 项目弹窗与 Wiki 项目设置三处「推理档位(思考级别)」由原生 `<select>` 替换为统一自定义 Select 组件,与整体 UI 语言一致
- #### 其他
- - 📝 **README 贡献者数据同步**:新增贡献者 ymsy2021(PR #165),更新小傅哥(362 commits)、Jason(24 commits,PR #163 #164)提交数与代码变更统计
- - 🔧 **版本号统一升级至 0.4.4**(package.json / Cargo.toml / tauri.conf.json / Cargo.lock)
- <details>
- <summary><b>v0.4.3 (2026-10-17)</b></summary>
- #### 软件对接 Link:MCP 能力域升级(@fuzhengwei)
- - ✨ **MCP 能力域重构为「软件对接(Link)」**:`services/mcp` 演进为 `services/software`,侧边栏与知识库页新增 Link 入口(测试功能 · 开发迭代中);命令层、MCP handlers、服务端路由与 Admin 路由、知识访问控制同步适配
- - ✨ **OpenAPI / Swagger 规范一键导入**:OpenAPI 3.x / Swagger 2.0(JSON/YAML)粘贴即转为 generic_http 连接器配置,每个 operation 生成一个 MCP 工具,参数映射与风险级别自动推导,导入结果经连接器配置自检
- - ✨ **MCP 对话式实例管理**:外部 AI Agent 通过 `/mcp` 即可发现连接器、导入 OpenAPI、创建 / 更新 / 删除软件实例;删除需显式 `confirm: true`,实例级工具受审批策略闸门约束
- - ✨ **CLI-Hub 社区目录集成**:接入 CLI-Anything 社区目录(103+ 软件),一键安装 + 创建实例;新增 `ClihubConnector`(help / run 双工具);hub 未安装时回退内置精选目录
- - 🎨 **软件对接页面重构**:SoftwarePage 大幅重构,实例管理与在线调试体验优化;知识库页新增「可用工具」列表与密钥试调入口
- - 🐛 **桌面端 /mcp 在线调用代理**:新增 `mcp_online_call` 命令由 Rust 侧代理请求本机 `/mcp`,绕开 WKWebView 对回环地址的混合内容 / CORS 限制
- #### Qoder 流式修复(@fuzhengwei)
- - 🐛 **Qoder 流式解码组帧修复**:内层 Chat chunk 原先以裸 JSON 喂给 SSE 解析器被静默丢弃,流式请求报「no message_start emitted」(非流式不受影响);现重新组帧为 SSE 记录并按下游协议选择内层解码器,新增 6 个回归测试,Responses / Chat / Messages 三下游流式全链路验证通过
- #### 其他
- - 🔧 **版本号统一升级至 0.4.3**(package.json / Cargo.toml / tauri.conf.json / Cargo.lock)
- </details>
- <details>
- <summary><b>v0.4.2 (2026-10-16)</b></summary>
- #### Qoder Auth 渠道(@fuzhengwei)
- - ✨ **新增 Qoder Auth Provider**:新增 `auth_provider/qoder_backend.rs`、`qoder_cosy.rs`、`qoder_login.rs`,Auth 账号体系接入 Qoder OAuth 登录、Token 刷新与模型发现;路由规划器识别 Qoder 渠道身份
- - ✨ **Qoder 协议编解码器**:新增 `protocol/codec/qoder/`(含聚合层)并注册进 codec registry,支持 Qoder 渠道请求/响应双向转换;前端登录弹窗、Provider 选项、Auth 渠道页同步接入
- #### Wiki / RAG 体验优化(PR #159,@freakojc)
- - ✨ **Wiki PDF 摄入全链路修复**:重写 `services/wiki/ingest.rs`,修复 Wiki PDF 摄入链路,OCR 渲染增强
- - ✨ **API Key 细粒度知识访问授权**:API Key 可分别授权知识库 / Wiki 访问(迁移 `047_api_key_wiki_access`),服务端访问控制同步收紧
- - ✨ **RAG/Wiki 推理温度可配置**:支持为 RAG 问答与 Wiki 问答单独配置推理温度(迁移 `049`)
- - 🎨 **知识库页面重构**:KnowledgeBasePage 大幅重构,交互与信息展示优化;MCP handlers、Wiki 提示词同步增强
- - 🐛 **摄入进度条修复**:摄入进度改为模块级状态,修复切换一级侧边栏后进度条丢失
- #### 可观测性与仪表盘(@fuzhengwei)
- - ✨ **请求日志可观测性增强**:新增请求意图分类(`prompt_classify.rs`,迁移 `048`),端点执行器在请求链路落库分类结果;新增可观测卡片组件
- - 🎨 **仪表盘路由地图与热力图**:新增 `RouteMapCard` 渠道路由地图与 `TokenHeatmap` Token 热力图组件,Dashboard 配套重构
- #### API 日志(@fuzhengwei)
- - ✨ **客户端识别**:从请求特征识别下游客户端(Claude Code / Codex / ChatBox 等)并落库(迁移 `047_request_log_client_name`),日志页可按客户端筛选
- #### 其他
- - 🐛 **旧版 WebKit 渐变兼容修复(ADR 0002)**:修复旧版 WKWebView 上 `bg-gradient-to-*` 因 `in oklab` 语法被静默丢弃导致的渐变丢失(典型症状:「网关路由」卡片 WaLiAPI 图标空白),详见 `docs/adr/0002`
- - 📝 **README 多语言化**:主文档顶部新增「30 秒看懂 WaLiAPI」Mermaid 架构图与产品化 Hero;新增英文、日文版本(顶部可切换);贡献者表后置至文档末尾
- - 📝 **MCP 网关规划文档**:新增 `docs/mcp-gateway-feasibility.md` 与 `docs/mcp-gateway-plan.md`
- - 🔧 **版本号统一升级至 0.4.2**(package.json / Cargo.toml / tauri.conf.json / Cargo.lock)
- </details>
- <details>
- <summary><b>v0.4.1 (2026-10-13)</b></summary>
- #### WorkBuddy 对接(@fuzhengwei)
- - ✨ **新增 WorkBuddy Auth Provider**:新增 `auth_provider/workbuddy_backend.rs` 与 `workbuddy_login.rs`,Auth 账号体系接入 WorkBuddy 登录与凭证管理,路由规划器识别 WorkBuddy 渠道身份
- - 🎨 **前端配套改造**:渠道表单与 Auth 渠道页接入 WorkBuddy 登录入口与 Provider 选项;新增通用 `Select` 组件;知识库连接面板、设置、日志、用量、应用配置等页面交互统一优化
- #### 知识库与 RAG(PR #158,@Zhengmingming1)
- - 🐛 **知识库 Embedding 批次索引重复恢复**:重构 embedder 批次写入逻辑,重复批次索引场景下可自动恢复,不再导致向量写入失败或索引错乱;新增专项回归测试 `rag_embedding_batch_recovery.rs`
- #### Windows 升级兼容(PR #157,@huangkemingyyds)
- - 🐛 **兼容 Windows 旧版迁移的 CRLF 校验值**:数据库迁移校验兼容旧版安装包中 CRLF 行尾导致的 checksum 漂移,修复 Windows 从旧版升级后无法启动;`.gitattributes` 锁定迁移文件行尾,新增升级诊断脚本与文档
- - 🐛 **WAL 启用改为启动期 best-effort**:journal 模式移出建连选项,启动期一次性尽力启用 WAL(占用时重试后降级沿用原模式),彻底修复 Windows 升级场景启动白屏崩溃
- #### 其他
- - 📝 **README 贡献者数据同步**:更新小傅哥(322 commits)、Nelson(30 commits,PR #158)、黄科铭(6 commits,PR #157)提交数与代码变更统计
- - 🔧 **版本号统一升级至 0.4.1**(package.json / Cargo.toml / tauri.conf.json / Cargo.lock)
- </details>
- <details>
- <summary><b>v0.4.0 (2026-10-09)</b></summary>
- #### 用量统计与日志(PR #154,@freakojc)
- - ✨ **用量统计与审计日志解耦**:新增 `usage_stats` 聚合表(迁移 046),按 `(hour, model, channel_id, api_key_id)` 四维主键持久化请求/成功/失败计数与 Token、耗时指标,`create_log` 同事务 UPSERT 累加;日志清理不再影响统计,彻底解决「清理日志后首页统计大幅缩水」
- - ✨ **六大统计接口改读聚合表**:首页 Dashboard、模型分布、Token 趋势、按天、渠道、Key 统计口径不变,前端无感迁移;小时桶为唯一物理存储粒度,天/周/月/趋势由小时桶聚合合成,统计表增长为 O(组合数×小时) 而非 O(请求数)
- - ✨ **多条件组合日志清理**:时间门限(before / after / keep_recent_days)+ 状态码/是否成功 + 渠道/Key/模型 AND 组合清理;`dry_run` 预览影响行数(前端两步确认);`clear_usage_stats` 支持独立清统计(不动日志);启动时自动从存量 `request_logs` 幂等回填聚合表
- - ✨ **服务可用率改健康口径**:分母=启用渠道/未禁用账号,分子=启用且健康/凭证有效;主动禁用的渠道与账号不再拉低可用率,只有真实探测失败才会下降
- - 🎨 **Token 趋势图改按模型堆叠柱状图**:手写 SVG(不引入图表库),按模型颜色堆叠,hover 浮层/图例/输入输出缓存开关保留
- #### 日志清理与 UI(PR #155,@freakojc)
- - ✨ **清理弹窗新增「渠道日志」tab**:按渠道维度组合执行——清渠道日志(级联 findings/segments,不动统计)、清渠道统计(删 `usage_stats` 行,不动日志)、重置失败计数(仅清 `fail_count`,成功率真实恢复);支持时间范围、dry_run 预览与含备份提醒的二次确认
- - 🐛 **成功率公式修正**:渠道页(卡片+仪表盘)与密钥页由 `success/total` 改为 `success/(success+failed)`,重置失败计数后成功率真实回到 ~100%
- - 🐛 **「全局日志」tab 渠道下拉修复**:清理弹窗渠道下拉在挂载时即加载,修复下拉为空;全局日志表单简化,渠道 ID 改为可选下拉
- - 🎨 **首页与弹窗 UI 优化**:模型分布默认展示 8 行、「展开更多/收起」按钮;Token 趋势浮窗在最右侧自动翻转、不溢出视域
- - 🔧 **迁移文件锁定 LF 行尾**:防止 EOL 转换导致 sqlx checksum 漂移
- #### 知识库与 RAG(PR #152,@Zhengmingming1)
- - ✨ **RAG 健康检测支持按 API Key 选择回答模型**:候选目录复用 `/v1/models` 的渠道、模型黑白名单、映射别名与 Auth 账号聚合,再经 Chat 路由规划器过滤不可路由候选与仅 Embedding 渠道;保留「手动输入」与「刷新模型」,列表只读、不消耗额度;切换密钥/知识库自动清空旧选择与检测结果
- #### 知识库与 RAG(PR #153,@Zhengmingming1)
- - ✨ **通用 RAG 质量优化**:检索预算与受控降级诊断细化,检索器、模型客户端与问答链路全面加固
- - ✨ **PDF 解析质量补全**:解析器与处理器增强,提升中文 PDF 与复杂版式的切分质量
- - 🐛 **SQLite 并发写入修复**:内嵌修复版 libsqlite3-sys 兼容层(`sqlite-compat/`),启用修复版 WAL 并合并渠道状态写入,缓解并发写竞争
- #### 其他
- - 📝 **README 贡献者数据同步**:更新小傅哥(318 commits)、Jason(17 commits,PR #154 #155)、Nelson(29 commits,PR #152 #153)提交数与代码变更统计
- - 🔧 **版本号统一升级至 0.4.0**(package.json / Cargo.toml / tauri.conf.json / Cargo.lock)
- </details>
- <details>
- <summary><b>v0.3.9 (2026-10-05)</b></summary>
- #### Auth 账号与额度(PR #149,@jiangnuonnuo)
- - ✨ **Codex 账号重置卡**:账号列表新增手动重置入口与确认弹窗,支持对 Codex 账号手动触发速率额度重置(`wham/rate-limit-reset-credits`),后端完整记录重置与消耗操作流水(迁移 045),重置结果即时反馈并刷新账号额度展示
- - 🎨 **账号列表行末按钮悬浮提示**:账号列表行末操作按钮增加 tooltip 悬浮说明
- #### 渠道与负载均衡(PR #150,@freakojc)
- - ✨ **流式 pre-commit 阶段多 Key failover**:流式路径此前仅取渠道随机抽中的第一把 Key,失败即放弃该渠道、备用 Key 永远轮空;现对齐非流式 failover 语义,pre-commit 阶段(尚未向下游提交任何字节)失败自动换下一把启用 Key 重试,全部分 Key 失败才切换下一候选渠道;多 Key 容量在流式链路下正式生效
- #### 协议转换(PR #147,@huangkemingyyds)
- - 🐛 **Anthropic 内置工具兼容**:Messages → Responses 转换识别 `web_search` 等 Anthropic 内置工具并跳过,不再因无法映射而拒绝整个请求,用户自定义工具正常保留转换;`tool_choice` 强制调用被跳过的内置工具时仍返回清晰的 unsupported feature 错误
- - 🐛 **Anthropic 原生渠道地址 /v1 归一化**:渠道 base URL 缺失 `/v1` 时自动补齐并清理末尾斜杠,修复智谱等 Anthropic 原生渠道因地址少 `/v1` 导致的 404;上游模型同步与相关集成测试约定同步更新(`GET /v1/models`)
- #### Codex(PR #148,@huangkemingyyds)
- - ✨ **Codex client version 动态刷新**:Codex CLI 版本号不再写死(原 `0.156.1`),默认 `0.162.0`,每 6 小时从 npm registry 拉取最新版本并仅在更高时采用;支持 `WALIAPI_CODEX_CLIENT_VERSION` 环境变量覆盖;修复 ChatGPT 按 client_version 门控模型目录导致的模型缺失/过期问题
- #### 前端(PR #144,@wuchubuzai2018)
- - 🐛 **低版本 WebKit 左侧菜单不显示修复**:Tailwind v4 断点在旧 WebKit 内核的兼容处理,附 ADR 文档说明(`docs/adr/0001`)
- - 🎨 **Codex 订阅页表格操作按钮悬浮文案优化**
- #### 其他
- - 📝 **README 贡献者数据同步**:新增贡献者 wuchubuzai2018(PR #144),更新小傅哥(314 commits)、Nelson(27 commits)、xerina(9 commits,PR #149)、Jason(9 commits,PR #150)、黄科铭(5 commits,PR #147 #148)提交数与代码变更统计
- - 🔧 **版本号统一升级至 0.3.9**(package.json / Cargo.toml / tauri.conf.json / Cargo.lock)
- </details>
- <details>
- <summary><b>v0.3.8 (2026-10-01)</b></summary>
- #### 渠道与负载均衡
- - ✨ **API Key 独立启停开关**(迁移 044):主 Key 与从 Key 均可单独停用/启用,停用后不参与负载均衡;渠道全部 Key 停用时该渠道整体跳过,请求自动切换其他可用渠道,不会误用已停用的 Key
- - ✨ **渠道预览快捷启停与加密展示**:渠道卡片展开即可点击切换任意 Key 的启用状态(乐观更新,失败自动回滚);Key 默认掩码展示(仅前 4 位与后 4 位可见),按需查看明文;主 Key 停用时整行变淡并显示「已停用」徽标
- - 🐛 **连通性测试对齐调度语义**:保存触发的草稿测试、渠道列表测试按钮与保存侧指纹,在主 Key 停用时自动改测第一个启用的从 Key,与负载均衡实际行为一致;「同步上游模型」同样适用
- - 🐛 **修复编辑渠道时从 Key 被掩码值覆盖**:编辑保存对从 Key 为全量替换写入,未重新编辑过的从 Key 会以掩码值落库导致凭证损坏;现前端保存时回传 Key id,后端识别掩码值并回填库中真实 Key
- - 🐛 **修复流式路径停用 Key 回退**:凭据槽为空时不再回退到已停用的主 Key,正确切换下一候选渠道
- - 🎨 **主/从 Key 行 UI 对齐**:表单内主 Key 与从 Key 行的按钮顺序(复制 → 权重 → 启停 → 编辑 → 删除)、输入框宽度与启停胶囊样式统一;预览页主/从 Key 启停胶囊共用同一组件
- - 🔧 **导入导出兼容**:`api_key_enabled` 随渠道导出/导入透传,旧版本导出文件缺省视为启用
- #### 知识库与 RAG(PR #142,@Zhengmingming1)
- - ✨ **RAG 时间预算与受控降级**:为检索与读取链路引入时间预算,超时按受控降级返回可用结果,避免长尾检索拖垮问答体验
- - ✨ **考试逐项合同与证据覆盖检索**:新增考试场景逐项判定与证据覆盖检索能力(迁移 043 检索投影版本)
- - ✨ **通用思考强度与弃答诊断细化**:支持通用思考强度配置,考试弃答诊断按阶段细化归因
- - ✨ **新建密钥与知识库默认双向授权查询权限**:新建 API Key 与知识库时默认建立双向授权的查询权限,减少漏配
- - 🔄 **分离通用检索与调用方业务规则**:检索器与调用方业务规则解耦,便于复用与回归验证
- #### 模型映射与协议(PR #141,@huangkemingyyds)
- - 🐛 **修复模型映射与 Antigravity Responses 工具路由**:规范化渠道和 Auth 账号模型映射,统一禁用映射与知识库调用行为;支持 Codex Responses additional_tools 经 Gemini 转换,恢复自定义工具调用及流事件,并兼容旧会话回放
- #### 其他
- - 📝 **README 贡献者数据同步**:更新小傅哥(305 commits)、Nelson(27 commits,PR #142)、黄科铭(3 commits,PR #141)提交数与代码变更统计,历史版本折叠展示
- - 🔧 **版本号统一升级至 0.3.8**(package.json / Cargo.toml / tauri.conf.json / Cargo.lock)
- </details>
- <details>
- <summary><b>v0.3.7 (2026-09-28)</b></summary>
- #### 知识库与 RAG
- - ✨ **RAG 链路分阶段诊断**:`/api/kb/ask` 支持 `diagnostics=true`,按 permission / embedding / retrieval / answer / validation 各阶段返回状态与失败原因;健康检测不再仅凭 HTTP 200 冒充完整链路通过,需各阶段逐一校验(PR #140,@Zhengmingming1)
- - ✨ **API Key 知识库健康检测**:新增 `test_api_key_knowledge_health` 命令,经本机真实 HTTP 入口携带指定 API Key 请求 `/api/kb/ask`,验证 Key 权限、额度与完整 RAG 检测链路,返回耗时、答案、引用来源与诊断详情(PR #140,@Zhengmingming1)
- - ✨ **Embeddings 配置预检**:新增 Embedding 能力预检命令,复用网关内部 Embedding 路由规划且不发请求,可区分「渠道未声明 Embeddings 能力」与「无支持该模型的渠道」并给出修复指引(PR #140,@Zhengmingming1)
- - 🐛 **内部知识库 Embedding 复用统一网关路由**:知识库建库/查询的向量调用不再自行拼接 `/embeddings` 直连上游,改为复用网关的路由规划、渠道身份、Key 轮换与故障切换语义,模型匹配与端点能力判定与外部请求一致(PR #140,@Zhengmingming1)
- - 🐛 **旧 Gemini 执行器不再误判支持 Embeddings**:`gemini_native` 执行器固定调用 generateContent 无法发送 `/embeddings`,路由规划排除其 Embeddings 原生资格,向量请求由 OpenAI 兼容渠道承接(PR #140,@Zhengmingming1)
- #### 前端
- - ✨ **知识库连接检查接入预检与健康检测**:知识库连接面板展示配置预检结论与真实 RAG 健康检测结果,知识库页同步诊断展示;渠道表单补充 Embeddings 能力配置提示(PR #140,@Zhengmingming1)
- #### 其他
- - 🧪 **新增 RAG Embedding 路由集成测试**:`rag_embedding_routing` 等测试覆盖内部 Embedding 路由规划、渠道模式过滤与诊断响应(PR #140,@Zhengmingming1)
- - 📝 **README 贡献者数据同步**:更新 Nelson(@Zhengmingming1,PR #140)提交数与代码变更统计
- - 🔧 **版本号统一升级至 0.3.7**(package.json / Cargo.toml / tauri.conf.json / Cargo.lock)
- </details>
- <details>
- <summary><b>v0.3.6 (2026-09-23)</b></summary>
- #### 协议转换(codec)
- - 🐛 **Chat response_format 映射为 Responses text.format**:Chat Completions 请求的 `response_format` 正确映射到 Responses 协议的 `text.format`,JSON 输出约束跨协议生效(PR #136,@GululuCopa)
- - 🐛 **Messages 顶层 safeguards 按 fail-open 丢弃**:无法识别的顶层 safeguards 字段按 fail-open 丢弃,不再导致请求被上游拒绝(PR #136,@GululuCopa)
- - 🐛 **Chat→Responses 兼容常用采样字段**:客户端常用采样参数在 Chat→Responses 转换中正确透传(PR #135,@GululuCopa)
- - 🐛 **Responses function_call 条目 id 规范化**:function_call 条目 id 必须是 `fc_` 前缀,修复部分客户端解析失败(#129,@GululuCopa)
- - 🐛 **Gemini 请求转换兼容标准 JSON Schema 与 Gemini 3 工具签名**(@GululuCopa)
- - 🐛 **保留 Gemini 转换上下文并拒绝未知输入**:跨协议请求边界校验,转换上下文不丢失、未知输入直接拒绝(PR #136,@GululuCopa)
- #### Auth 账号
- - 🐛 **Antigravity OAuth 修复**:修复 v0.3.6 Antigravity OAuth 授权流程(PR #128,@GululuCopa)
- - ✨ **Antigravity 模型额度展示与工具调用 ID 保留**:Auth 渠道页展示 Antigravity 模型剩余额度,工具调用 ID 跨请求保留(PR #138,@huangkemingyyds)
- - 🐛 **Grok 出站请求对齐上游约束**:出站请求对齐上游工具白名单与加密推理约束;规范化工具参数里的整数值浮点(PR #135,@GululuCopa)
- - 🐛 **流式出站改用无总超时的 HTTP 客户端**:避免长流式响应被总超时中断(PR #135,@GululuCopa)
- - 🐛 **打开系统浏览器失败单独归类 BrowserOpenFailed**:OAuth 授权时浏览器打开失败返回明确错误类型(PR #135,@GululuCopa)
- #### Codex
- - 🐛 **修复旧会话回放与 GPT-6 模型同步**(PR #137,@huangkemingyyds)
- #### 客户端与配置生成
- - 🐛 **修正 OpenCode / OpenClaw / Hermes 的配置生成**:客户端配置应用改为事务化,同步 `modelPolicy.allow` 避免主模型不可见(PR #135 / #136,@GululuCopa)
- - 🧪 **回放用例改用相对时间**:避免测试随 TTL 过期自失败(PR #135,@GululuCopa)
- #### 其他
- - 📝 **OAuth 协议覆盖验证记录**:补充 OAuth 协议覆盖验证文档
- - 📝 **README 贡献者数据同步**:新增贡献者 黄科铭(@huangkemingyyds,PR #137 #138),按当前仓库提交记录更新全体贡献者提交数与代码变更统计
- - 🔧 **版本号统一升级至 0.3.6**(package.json / Cargo.toml / tauri.conf.json / Cargo.lock)
- </details>
- <details>
- <summary><b>v0.3.5 (2026-09-21)</b></summary>
- #### 新增渠道
- - ✨ **新增 StepFun(阶跃星辰)渠道预设**:新增 OpenAI 兼容渠道类型 StepFun(`stepfun`,Base URL `https://api.stepfun.com/v1`),内置 5 条静态模型建议——step-5-preview / step-3.7-flash / step-3.5-flash / step-3.5-flash-2603 / step-1o-turbo-vision(旗舰在前,顺序即预填与连通性探测默认),预设仅声明 Chat Completions 端点与 Bearer 鉴权,模型建议可经「同步上游模型」拉取 `GET /v1/models` 覆盖;渠道导入导出的 v2 身份信任白名单、前后端图标与渠道类型定义同步接入(PR #127,@chyuan)
- #### 其他
- - 📝 **README 贡献者数据同步**:按当前仓库提交记录更新贡献者提交数与代码变更统计
- - 🔧 **版本号统一升级至 0.3.5**(package.json / Cargo.toml / tauri.conf.json / Cargo.lock)
- </details>
- <details>
- <summary><b>v0.3.4 (2026-09-20)</b></summary>
- #### Auth 账号
- - ✨ **Grok OAuth 登录**:新增 Grok 渠道 OAuth 授权登录,支持 Token 自动刷新与协议感知模型发现,Auth 渠道页可直接登录 Grok 账号(PR #122,@GululuCopa)
- - ✨ **Antigravity OAuth(Gemini)登录**:新增 Antigravity 作为 Gemini 渠道的 OAuth 登录方式,Gemini 渠道支持 Antigravity 账号接入(PR #121,@GululuCopa)
- - 🐛 **Grok 与 Antigravity namespace 工具兼容**:兼容两者工具调用的 namespace 前缀,修复工具调用在协议转换中的匹配问题(@GululuCopa)
- #### 渠道管理
- - ✨ **模型映射支持开启/关闭**:每条模型映射可单独停用(迁移 041),路由匹配、上游模型解析、`/v1/models` 聚合均跳过被关闭的映射;映射行点击开关即时切换,导入导出同步兼容
- - ✨ **从 curl 导入渠道**:新建渠道表单支持粘贴任意 OpenAI / Anthropic / Ollama 兼容的 curl 命令,自动解析并一键填充协议、Base URL、API Key 与模型
- - ✨ **复制测试 curl**:渠道列表新增「复制测试 curl」,按渠道协议 / URL / 模型生成可直接执行的 curl 命令(含真实 API Key),粘贴到终端即可验证渠道连通性
- #### 其他
- - 📝 **README 贡献者数据同步**:新增贡献者 GululuCopa(PR #121 #122),并按当前仓库提交记录更新全体贡献者提交数与代码变更统计
- - 🔧 **版本号统一升级至 0.3.4**(package.json / Cargo.toml / tauri.conf.json / Cargo.lock)
- </details>
- <details>
- <summary><b>v0.3.3 (2026-09-16)</b></summary>
- #### 日志
- - ✨ **新增「简要」日志级别**:在「基本 / 详情」之外新增「简要」级别——请求消息列表只保留最新 3 条,长对话场景下可显著降低日志存储占用(PR #119)
- #### RAG 检索回归修复
- - 🐛 **管理搜索接口按模式和权重执行检索**:管理端搜索不再忽略检索模式与权重配置,与实际问答链路行为一致(PR #118)
- - 🐛 **失败文档不再阻止重新导入**:导入失败的文档允许直接重试相同内容,无需先清理残留数据(PR #118)
- - 🐛 **索引落后时回退完整检索**:向量索引落后于切片数据时自动回退到完整检索,避免漏召回(PR #118)
- - 🐛 **向量响应校验与索引对齐**:校验 Embedding 响应并按索引匹配输入文本,防止向量错位导致的检索结果异常(PR #118)
- #### 修复
- - 🐛 **Token 配额标签澄清**:API Key 的 Token 配额标签文案更明确,避免与知识库权限混淆(PR #117)
- - 🧪 **补齐 `request_headers` 测试字段**:修复 lib test 目标编译失败问题(PR #119)
- #### 其他
- - 📝 **README 贡献者数据同步**:按当前仓库提交记录更新贡献者提交数与代码变更统计,README 历史版本改为折叠展示
- - 🔧 **版本号统一升级至 0.3.3**(package.json / Cargo.toml / tauri.conf.json / Cargo.lock)
- </details>
- <details>
- <summary><b>v0.3.2 (2026-09-13)</b></summary>
- #### 知识库检索与数据安全
- - 🐛 **中文 PDF 与检索兼容性修复**:修复 PDF 部首字形、中文索引与向量检索漏召回问题,提升中文知识库检索稳定性
- - 🔒 **知识库访问授权**:API Key 支持配置知识库授权,REST 与 MCP 查询按授权范围开放,避免跨知识库读取
- - 🛡️ **RAG 来源与索引一致性修复**:来源列表只保留实际使用的上下文;模型变更时使旧向量缓存和索引失效;索引读改写串行化并原子保存;重建失败保留旧切片并原子替换;删除文档时保留导入源文件
- - 🧪 **RAG 授权与计费测试补强**:覆盖查询授权和模型调用计费等关键场景
- #### 渠道、日志与 Auth
- - ✨ **知识库权限管理界面**:新增知识库权限配置与连接检查入口,API Key 可按需授权知识库
- - ⚡ **日志统计性能优化**:使用覆盖索引服务日志聚合查询,替代已判定失效的旧索引方案
- - 🔇 **探测日志降噪**:审计日志仅记录渠道健康状态翻转,恢复状态就地更新,不再为每次探测新增日志
- - 🔐 **Claude Code 网关鉴权初始化**:补充网关鉴权 bootstrap 流程,并使 Codex Auth 写入逻辑跨平台
- #### 其他
- - 📝 **README 贡献者数据同步**:按当前仓库提交记录更新贡献者提交数与代码变更统计
- - 🔧 **版本号统一升级至 0.3.2**(package.json / Cargo.toml / tauri.conf.json / Cargo.lock)
- </details>
- <details>
- <summary><b>v0.3.1 (2026-09-10)</b></summary>
- #### 渠道与配额
- - ✨ **渠道主动健康探测**:后台周期性探测上游可用性,异常渠道在候选排序中自动沉底,恢复后自动回归;探测流量与业务统计口径隔离(迁移 033,PR #102)
- - ✨ **配额记账强化**:两轨配额记账口径合一并递增封顶;配额 429 错误体按端点协议返回并携带 `used/limit` 字段(PR #92)
- #### 流式与可观测性
- - ✨ **流式内容段持久化**:SSE 流式生成内容逐段落库,连接中断后已生成内容仍可查看(迁移 032,PR #95)
- - ✨ **Responses 断线续传回放**:Responses 协议支持逐帧持久化 + offset 回放 + incomplete 收尾,客户端断线后可从中断点续传
- - ✨ **数据面 X-Request-Id 标准化**:统一采纳/生成/回显请求 ID 并落库 trace_id,链路追踪闭环(PR #94)
- - ✨ **OTLP/HTTP JSON 导出器**:request_log 增量导出为 OTLP span,可对接外部可观测平台(PR #94)
- #### 知识库
- - ✨ **文档级增量索引**:chunk 内容哈希比对 + 未变块 embedding 复用 + HNSW 单点插入与墓碑摘除,文档更新只重算变更部分(PR #93)
- - ✨ **多轮对话查询改写**:指代型问题在检索前先做查询改写,提升多轮 RAG 命中率(默认关,`kb.query_rewrite` 开关)
- - ✨ **混合检索增强**:RRF 融合默认开启,可选 LLM listwise 重排进一步提升召回质量
- - ✨ **Prompt 模板版本化**:模板支持版本管理页与种子兼容硬保证(迁移 034)
- #### 语义缓存
- - ✨ **语义缓存 exact+semantic 两层**:精确命中 + 向量语义命中两级缓存,默认关闭;清空逻辑下沉 `semantic_cache::clear` 并补按模型/全清测试(迁移 035)
- #### Auth 账号
- - ✨ **Codex 设备码登录**:支持 Device Authorization 流程(`codex login --device-auth`),并处理 pending 授权状态轮询(PR #77)
- - ✨ **Auth 账号列表视图**:Auth 渠道页新增账号列表视图,多账号一目了然(PR #103)
- #### 修复
- - 🐛 **Anthropic 容量错误提交前识别**:容量/过载类错误在响应提交前检测并触发跨协议故障切换,避免错误透传给下游(PR #101)
- </details>
- <details>
- <summary><b>v0.3.0 (2026-09-09)</b></summary>
- #### 审计日志策略优化
- - ✨ **审计日志存储与加载优化**:请求日志新增策略化存储与分级加载能力——`request_logs` 表增加 `detail_level`(明细级别)与 `started_at`(开始时间)字段并建立索引,日志页与设置页同步接入策略配置,大数据量场景下日志查询与加载更高效(PR #75)
- #### 修复
- - 🐛 **sub2api 导入兼容修复**:sub2api 导出数据缺少 account id 时回退使用 `chatgpt_user_id`,避免导入失败或账号无法识别(PR #73)
- - 🐛 **sub2api 导入账号数即时刷新**:导入完成后前端立即刷新账号计数,无需手动刷新页面(PR #73)
- - 🐛 **Auth 账号操作后滚动位置保持**:Auth 渠道页执行账号操作后不再跳回顶部,保持当前滚动位置(PR #73)
- #### 其他
- - 📝 **README 贡献者数据同步**:按最新提交记录更新全体贡献者提交数与代码变更统计,zjx 关联 GitHub 账号 @Sadsunset3
- - 🔧 **版本号统一升级至 0.3.0**(package.json / Cargo.toml / tauri.conf.json / Cargo.lock)
- </details>
- <details>
- <summary><b>v0.2.9 (2026-09-07)</b></summary>
- #### Codex 账号与额度
- - ✨ **Auth 账号额度改为剩余展示**:Auth 渠道卡片从“已用额度”切换为“剩余额度”视角,并补上前端展示工具与测试,用户能更直观看到当前还能使用多少额度(PR #67)
- - ✨ **支持主动刷新 Codex 额度**:新增手动刷新 Codex 配额能力,前后端都接入刷新入口,Auth 渠道页可直接触发额度同步,减少等待后台轮询的时间(PR #68)
- - 🐛 **修复 Codex 大响应 SSE 帧异常**:放宽大体积 `response.created` 事件的处理,避免 Codex 大响应场景因 SSE 帧创建阶段异常导致 502 或流式中断(PR #66)
- #### 全量审计修复合流
- - 🔒 **合入 v0.2.7→v0.2.8 全量审计修复**:当前 `v0.2.9` 分支已并入 PR #70,包含 KB/Wiki/MCP 端点鉴权恢复、KB 上传与导入边界收紧、URL SSRF 防护、管理面认证加固、API Key 掩码展示与按需取全量等修复
- - 🔧 **核心稳定性与安全扫描补强**:同步并入流式首帧/空闲超时、流式落账修复、多 Key 加权选择边界修正、404 故障切换语义统一、原生 Anthropic 路径落账对齐,以及响应侧安全扫描接入全部转发路径
- - 🖥️ **管理端体验与运维诊断增强**:全局 ErrorBoundary、日志安全解析、Wiki 渲染 sanitize、会话过期统一跳登录、日志页与知识库页竞态治理,以及 `/health` 版本号与日志目录等可观测性增强均已随 PR #70 合流
- #### 其他
- - 🐛 **Usage 连接测试请求头兼容性修复**:连接测试不再写入中文占位密钥,改为 ASCII 安全占位值,避免无效请求头被浏览器或运行时拒绝(PR #71)
- - 📝 **README 贡献者数据同步**:新增 2 位贡献者 yuanqixun 和 zjx,并按最新提交记录更新全体贡献者提交数与代码变更统计
- - 🔧 **版本号统一升级至 0.2.9**(package.json / Cargo.toml / tauri.conf.json / Cargo.lock)
- </details>
- <details>
- <summary><b>v0.2.8 (2026-09-03)</b></summary>
- #### Codex 账号切换
- - ✨ **应用配置 Codex 切换账号**:应用配置页 Codex 卡片支持「切回原账号」操作,恢复配置后自动检测 `auth.json` 是否卡在 API Key 模式(`auth_mode == "apikey"` 或 `OPENAI_API_KEY` 非空且无 ChatGPT 登录态),命中时提示并支持一键重置为 ChatGPT 登录模式——原文件备份为 `~/.codex/auth.json.waliapi-backup`,重置后运行 `codex login` 重新授权
- - ✨ **配置恢复 absent 标记**:写入网关配置前检测原配置是否存在,不存在则打 `.waliapi-absent` 标记,恢复时删除写入的配置而非尝试恢复不存在的备份;且仅在「未应用」状态下备份,避免重复应用时把已改写的配置当成原始配置覆盖备份,根治「恢复原配置永远切不回去」
- - 🔧 **Codex 配置状态文案优化**:Codex 卡片已配置状态显示「已切换到网关」,恢复按钮显示「切回原账号」并附 tooltip 说明 `auth.json` 不被改动
- #### 流式稳定性
- - 🔧 **流式空闲超时守卫**:SSE 流式转发新增 5 分钟空闲超时(`STREAM_IDLE_TIMEOUT`),上游长时间无数据(半开连接 / 静默挂死)时主动断开并向下游发送协议错误事件,不再无限等待
- - 🔧 **首帧诊断信息增强**:首帧屏障失败时附带诊断信息(收到的字节数 + 脱敏内容预览 + Content-Type),审计日志可区分「空响应」「非 SSE JSON 错误体」「HTML 拦截页」等场景
- - 🔧 **上游 Retry-After 遵从**:解析上游响应的 `Retry-After` 头(支持 delta-seconds 与 RFC 7231 日期),重试前等待指定时间(上限 5 秒 + ±20% jitter),避免密集重试触发上游限流
- #### 其他
- - ✅ 新增 19 个单元测试覆盖配置恢复、Codex auth.json 检测/重置、流式空闲超时、首帧诊断、Retry-After 解析等场景
- - 📝 **README 贡献者数据同步**:新增 2 位贡献者 Jason(@freakojc,PR #62 #63)和 cham(@Cham1229,PR #64),按最新提交记录更新全体贡献者提交数与代码变更统计
- - 🔧 **版本号统一升级至 0.2.8**(package.json / Cargo.toml / tauri.conf.json / Cargo.lock)
- </details>
- <details>
- <summary><b>v0.2.7 (2026-09-02)</b></summary>
- #### 仪表盘
- - ✨ **服务可用率纳入 Auth 账号**:仪表盘「服务可用率」统计口径由「活跃渠道 / 总渠道」扩展为「活跃上游 / 全部上游」——上游包含 API 渠道与 Auth 账号(未禁用且凭证有效)两类,仅接入 Auth 账号时可用率不再虚低;「活跃渠道」卡片升级为「活跃上游」,主值显示合计,副文案拆分展示渠道与账号明细;桌面端与 Web 管理端同步生效
- #### 修复
- - 🐛 **RAG/Wiki 设置保存后状态未即时更新**:知识库设置页保存后仍展示旧状态;重构为选中态仅存 `selectedKbId`、由列表数据派生选中对象,保存成功后用接口返回值精准更新列表对应项,设置页即时展示最新配置(PR #60)
- - 🐛 **Codex Responses 请求 strip `prompt_cache_options`**:Codex 后端请求白名单有 `prompt_cache_key` 却缺配套的 `prompt_cache_options`,WaLiCode 走 Responses 协议必带该字段,导致整条 Responses 路径被 `HTTP 400` 拒绝、只能退回 Chat 协议;该字段仅作缓存提示,归入 STRIPPED 静默丢弃,与 Chat 路径行为对齐(PR #59)
- #### 其他
- - 📝 **README 贡献者数据同步**:按最新提交记录更新贡献者提交数与代码变更统计
- - 🔧 **版本号统一升级至 0.2.7**(package.json / Cargo.toml / tauri.conf.json / Cargo.lock)
- </details>
- <details>
- <summary><b>v0.2.6 (2026-09-02)</b></summary>
- #### 缓存命中 Token 统计
- - ✨ **缓存命中 Token 全链路记录**:请求日志新增 `cached_tokens` 字段(migration 026),适配器层(OpenAI / Claude / DeepSeek / Gemini / Custom)统一提取上游缓存命中用量,兼容 `cached_tokens`、`cache_read_input_tokens`、`prompt_cache_hit_tokens` 等多种上游字段格式
- - ✨ **仪表盘缓存统计**:新增今日/累计缓存 Token、Prompt Token 指标,模型统计与 Token 趋势图增加缓存维度,API 密钥统计同步支持缓存 Token
- - ✨ **日志页缓存与推理强度展示**:日志列表与详情展示缓存命中 Token 及 `reasoning_effort` 字段(migration 027),流式 SSE 同步累积缓存用量
- #### Auth 账号错误透传(Kimi 渠道场景)
- - ✨ **Auth 账号终态错误透传真实状态码**:Auth 账号(OAuth 登录,如 Kimi Code)的凭证属于用户本人,上游 401/403 不再统一脱敏为 502,保留真实状态码,让调用方知道重新登录即可恢复;渠道 Key 的终态失败仍保持 502 脱敏(渠道凭证问题不暴露给调用方)
- - 🔧 **故障转移语义不变**:新增 `failure_from_auth_upstream`,仅调整 Auth 账号的状态码透传,FailureClass 分类不变,组内转移、不跨组的语义与渠道一致
- - 🔧 **错误响应增加 `failure_class` 字段**:错误响应 body 新增 `failure_class`,便于客户端区分失败类型并做针对性处理
- - ✅ 配套 AttemptFlow 真值测试:Auth 账号 401 透传 / 渠道 502 脱敏两条路径
- #### 修复
- - 🐛 **Responses API 流式内容累积修复**:Anthropic 事件分支的无条件 `continue` 导致 Responses 流式事件累积代码不可达,流式 Responses 请求的响应内容从未被记录;重构为 Anthropic / Responses 统一 match 分发,并补上 `response.function_call_arguments.delta` 工具调用参数累积
- - 🐛 **pdfium macOS 打包路径修复**:`bundle.resources` 的 glob 前缀使 pdfium 被打入 `Contents/Resources/resources/pdfium/`,运行时仅搜索 `Contents/Resources/pdfium/` 导致 `OCR_RENDER_FAILED`,补上该落点,不改打包与签名(PR #56)
- - 🐛 **Wiki Unicode 文本进程崩溃修复**:`ingest_wiki_source` / `search_wiki` 在 Unicode 文本上按字节下标切片触发 `core::str::slice_error_fail` panic,release `panic=abort` 配置下导致整个 WaLiAPI 进程退出;新增 `utils/text.rs` 字符边界安全切片工具,覆盖 wiki ingest / repository / security scanner 路径(PR #58)
- #### 其他
- - 🔧 **默认窗口尺寸调整**:1280×860 → 1440×900,适配仪表盘新增指标
- - 🔧 **版本号统一升级至 0.2.6**(package.json / Cargo.toml / tauri.conf.json / Cargo.lock)
- </details>
- <details>
- <summary><b>v0.2.5 (2026-09-01)</b></summary>
- #### Docker Web 部署
- - ✨ **Docker Web 部署完善**:Docker 镜像部署流程优化,README 新增 Web 部署教程章节,涵盖 Docker run / Docker Compose / systemd 三种部署方式
- #### 核心重试与错误处理统一
- - 🔧 **统一上游重试判定决策函数**:抽取各路径分散的重试逻辑为统一决策函数,覆盖全部适配器与 handler 路径,配套真值表测试确保判定准确性
- - 🐛 **上游终态错误立即短路**:401/403 等终态错误不再轮询渠道,直接返回客户端,避免无效重试消耗时间
- - 🐛 **401/403 下游脱敏**:上游返回 401/403 时,下游响应中脱敏处理错误信息,不泄露上游凭证状态
- - 🐛 **数据库故障不再误报 401**:数据库连接异常时不再误返 `401 Invalid API key`,返回正确的 503 服务不可用
- - 🐛 **Anthropic 内置工具 400 修复**:Anthropic 内置工具(如 web_search)经 OpenAI Chat 渠道转发时不再整体返回 400
- #### 知识库 VLM OCR
- - ✨ **扫描版 PDF VLM OCR**:知识库支持扫描版 PDF 文档的 VLM(视觉语言模型)OCR 识别,自动检测扫描页面并调用 VLM 进行文字提取
- - ✨ **OCR 页级混合识别**:逐页检测是否为扫描页,扫描页走 VLM OCR、文本页走常规提取,混合模式兼顾精度与速度
- - ✨ **OCR/Embedding 模型下拉按用途过滤**:知识库配置中 OCR 和 Embedding 模型下拉框按模型用途分类过滤,避免选错模型类型
- - 🐛 **Claude 渠道协议适配修复**:修复 Claude 渠道在 OCR 场景下的协议适配问题
- #### 协议 Codec 加固
- - 🐛 **Codex 工具调用参数一次性下发**:修复部分客户端在 Codex 工具调用流式传输中截断参数的问题,改为一次性下发完整参数
- - 🐛 **Chat-to-Responses store 字段归一化**:Chat 请求转 Responses 格式时归一化 `store` 字段,避免字段缺失或不一致导致的兼容性问题
- #### UI 优化
- - 🔧 **边框样式优化**:优化界面边框视觉样式
- - 🔧 **版本号统一升级至 0.2.5**(package.json / Cargo.toml / tauri.conf.json / Cargo.lock)
- </details>
- <details>
- <summary><b>v0.2.4 (2026-08-28)</b></summary>
- #### Auth 账号导入增强
- - ✨ **多格式导入**:Auth 账号导入支持 Codex、sub2api、CPA 三种格式,用户可通过导入下拉共享组件选择对应格式批量导入账号
- - ✨ **sub2api 格式支持**:新增 sub2api 导入格式,兼容 `chatgpt_account_id` 键名映射
- - ✨ **Codex 导入兼容**:Codex 导入同步支持 sub2api 格式,导入下拉抽取为共享组件,空状态卡片复用
- #### 模型列表增强
- - ✨ **模型列表增加 Auth 类型**:`/v1/models` 接口返回结果新增 Auth 账号类型模型,下游应用可发现并使用 Auth 账号提供的模型
- #### Auth 账号卡片优化
- - ✨ **Codex 卡片信息增强**:卡片同时显示 5H 与周限额信息,操作按钮收为一行,提升信息密度与交互体验
- - 🔧 **版本号统一升级至 0.2.4**(package.json / Cargo.toml / tauri.conf.json / Cargo.lock)
- - 📝 **README 文档完善**:更新代码贡献者信息表(补齐 v0.2.2 Docker / Web 管理面板贡献者 Fla1337,同步各贡献者最新提交量与代码变更统计)
- - 🔧 **版本号统一升级至 0.2.3**(package.json / Cargo.toml / tauri.conf.json / Cargo.lock)
- </details>
- <details>
- <summary><b>v0.2.2 (2026-08-26)</b></summary>
- #### Web 管理面板(Docker / headless 部署)
- - ✨ **Linux headless 服务器部署**:新增 `waliapi-web` 二进制(无桌面窗口),支持 Docker 和 systemd 两种部署方式,适合放在 Linux 服务器上长期运行
- - ✨ **Web 管理面板**:浏览器访问完整管理界面,与桌面版业务能力一致——仪表盘、渠道管理、密钥管理、日志审计、安全规则、知识库、Wiki、MCP、导入导出、应用配置等
- - ✨ **多阶段 Docker 构建**:Node/pnpm 编译前端 → Rust 编译 `waliapi-server` → 运行时使用非 root 用户,SQLite 数据持久化到 `/data`
- - ✨ **GitHub Actions 发布**:推送 `web-v*` 标签自动创建 Release、上传二进制包、发布 Docker 镜像到 GHCR
- - ✨ **systemd 部署支持**:提供 systemd unit 文件和环境变量配置示例,适合不用 Docker 的场景
- - ✨ **Web 管理面板用户设置**:支持修改管理员用户名和密码
- - 🔧 **桌面版自动启动内嵌服务**:移除"随应用启动内嵌服务"开关,桌面版启动后自动运行 HTTP 服务
- - 🔧 **后端重构分离桌面版与 Web 服务**:同一 Rust 代码库编译出桌面版(Tauri 窗口)和 headless 版(纯 HTTP 服务)
- #### Web 适配层修复
- - 🐛 **`api.ts` 绕过 runtime 适配层**:`api.ts` 直接用 `@tauri-apps/api/core` 的 `invoke`,浏览器环境无 Tauri IPC 全部失败,改为统一走 `runtime.ts` 适配层
- - 🐛 **`runtime.ts` 请求路径和格式不匹配后端**:修正 fetch 路径、body 字段名、响应解析逻辑、补齐 CSRF 头、SSE 路径同步修正
- - 🐛 **`default-run` 缺失导致 `cargo run` 报错**:补上 `default-run = "waliapi"`
- #### 流式请求超时修复(502 问题)
- - 🐛 **流式请求被总超时掐断**:`reqwest` 的 `.timeout()` 是整个请求总超时(含 SSE 传输),大量对话时 LLM 生成时间超过 `timeout_secs` 连接被掐断,客户端收到 502
- - 🔧 **分离流式/非流式超时策略**:新增 `streaming_client()`(仅 `connect_timeout` 10s,不设总超时)和 `blocking_client()`(`connect_timeout` + 总超时 `timeout_secs`),流式请求不再受总超时限制
- - 🔧 **全链路覆盖**:5 个 adaptor 的 `forward_stream` + `endpoint_executor` + `handlers.rs` + embeddings 全部切换到对应 client
- #### 模型映射编辑修复
- - 🐛 **模型映射编辑输入丢失**:`useModelMappings` 的 `useEffect` 在每次 prop 变化时重置内部状态,引入 `skipNextSyncRef` + `markSynced()` 跳过内部变更的 round-trip
- #### Codec 加固
- - 🔧 **Chat store/stream_options 归一化**:归一化 Chat 请求的 `store` 和 `stream_options` 字段
- - 🐛 **thinking none/off 映射修复**:thinking 设为 none/off 时映射为 adaptive + low effort
- - 🐛 **`--help` 参数路由修复**
- #### Docker 构建修复
- - 🐛 **Rust 基础镜像升级**:rust 1.88 → 1.96
- - 🐛 **Dockerfile.tp 兼容国内镜像**
- - 🔧 **tauri.conf.json 显式指定 mainBinaryName**
- - 版本号统一升级至 0.2.2(package.json / Cargo.toml / tauri.conf.json)
- </details>
- <details>
- <summary><b>v0.2.1 (2026-08-18)</b></summary>
- #### 协议转换层结构化重构
- - 🔧 **protocol 模块目录化**:将 protocol 根转换逻辑拆分为独立子模块——codec/chat、codec/messages、codec/responses_codec、directions(messages_to_responses / responses_to_messages),每个方向独立 encode/decode/stream/test,消除 1500 行巨型文件
- - 🔧 **死代码清理与 API 收敛**:清理 protocol 模块遗留 API 和死代码,clippy 告警归零,完成模块结构与 re-export 审计
- - 🔧 **codec 加固**:移植 tool-call 回放保留空 reasoning_content 兼容性优化,修复测试编译问题,全仓 cargo fmt 格式化
- #### Kimi Code Auth 账号接入
- - ✨ **Kimi 设备 OAuth 登录**:实现 Kimi 设备授权流程(device code → 授权 → token),支持 token 自动刷新
- - ✨ **Provider 中立认证框架**:新增 provider metadata + model protocol snapshot,支持多登录方式扩展
- - ✨ **认证路由集成**:model-level auth profiles 传入 prepared attempts,executor 注册 Kimi 认证尝试
- - ✨ **登录会话管理**:provider-neutral login sessions and commands,通用 login context 与 locked replacement 持久化
- - ✨ **协议感知模型发现**:Kimi 后端协议感知的模型发现与注册
- - ✨ **前端 Auth 面板**:Kimi auth login UI + provider-aware accounts 页面
- - 🐛 **402 订阅无效终态处理**:402 订阅无效分为终态,不再 12h 死循环重试
- - 🐛 **令牌失效原因记录**:invalidation_reason 记录并透出到 DTO,失效账号卡片显示具体失效原因
- - 🐛 **渠道页账号过滤修复**:渠道页按 provider 过滤账号卡片,不再混显
- - ✅ **测试覆盖**:Kimi routing replacement refresh 与协议流程测试
- #### 审计日志流式响应修复
- - 🐛 **流式响应内容记录修复**:流式请求的审计日志中 `response_choices` 字段此前始终为空,现已正确记录响应内容(content / reasoning_content / tool_calls),与非流式路径行为一致
- - 🔧 **多协议流式累积**:新增 SSE 事件解析器,支持三种流式协议的响应内容累积:
- - OpenAI Chat Completions(`choices[].delta.content` / `reasoning_content` / `tool_calls`)
- - Anthropic Messages(`content_block_delta` 的 `text_delta` / `thinking_delta` / `input_json_delta`)
- - OpenAI Responses API(`response.output_text.delta` / `response.completed`)
- - 🔧 **StreamPumpCore 扩展**:新增 `accumulated_reasoning`、`response_role`、`finish_reason`、`tool_calls_map` 字段,`build_response_choices()` 方法从累积内容构建标准 JSON
- #### 其他
- - 121 个文件变更,+22,616 / -14,462 行代码
- - 版本号统一升级至 0.2.1(package.json / Cargo.toml / tauri.conf.json)
- </details>
- <details>
- <summary><b>v0.2.0 (2026-08-14)</b></summary>
- #### 端点验证与稳定性
- - 🐛 **端点验证 bug 修复**:修复渠道端点校验逻辑缺陷
- - 🔧 **版本号统一升级至 0.2.0**(package.json / Cargo.toml / tauri.conf.json / Cargo.lock)
- </details>
- <details>
- <summary><b>v0.1.9 (2026-08-13)</b></summary>
- #### 渠道多 Key 负载均衡
- - ✨ **多密钥负载**:渠道支持配置多个 API Key,每个 Key 独立设置权重,请求按权重随机选择 Key 转发,自动分散单渠道的并发压力
- - ✨ **Key 状态管理**:每个 Key 可独立启用/禁用,禁用的 Key 不参与负载选择
- - ✨ **主 Key + 扩展 Key**:渠道原有的 `api_key` 作为主 Key(使用渠道级 weight),额外 Key 通过 `channel_api_keys` 表管理(migration 023),两者共同参与加权随机选择
- - ✨ **全链路覆盖**:proxy.rs 和 endpoint_executor/driver.rs 两条转发路径均已接入多 Key 选择逻辑
- #### 渠道复制快捷配置
- - ✨ **一键复制渠道**:渠道卡片操作栏新增复制按钮,点击后进入新建表单并预填充原渠道所有配置(名称加 `(副本)` 后缀,密钥清空待填),免去重复配置的繁琐操作
- #### 审计日志体验优化
- - ✨ **审计日志自动刷新**:页面可见时每 5 秒静默轮询,新日志自动出现,无需手动刷新。页面切到后台时不轮询,切回前台自动恢复;静默刷新不触发 loading 动画,不干扰用户操作
- #### 自动更新体验优化
- - ✨ **Release Notes 动态化**:自动更新弹窗中的版本说明从 CHANGELOG.md 自动提取,不再显示固定文案。四个 CI workflow(macOS ARM64/Intel、Windows、Linux)均已接入
- </details>
- <details>
- <summary><b>v0.1.8 (2026-08-12)</b></summary>
- #### API 密钥管理增强
- - ✨ **密钥编辑功能**:支持编辑密钥名称、配额、白/黑名单规则(key 不可编辑)
- - ✨ **白名单/黑名单规则**:密钥级别渠道+模型访问控制,交互式下拉多选 + 笛卡尔积规则生成 + 去重
- - ✨ **密钥编辑入口**:卡片操作栏新增编辑按钮,复用 ApiKeyForm 组件编辑模式
- #### 路由与映射优化
- - 🐛 **路由优先级修复**:关闭 `prefer_auth_accounts` 与 `prefer_same_protocol`,所有候选混同按 priority → weight 排序
- - ✨ **Auth 账号模型映射**:`auth_accounts` 新增 `model_mapping_json` 列(migration 021),全链路支持映射名→实际模型名转换
- - ✨ **映射逻辑统一重构**:前端抽取 `useModelMappings`/`MappingSection` 共用组件,后端抽取 `mapping_contains_source` 通用函数
- #### Usage 页面与 LLM 应用
- - ✨ **MODEL 下拉按密钥过滤**:选中 API Key 后,MODEL 列表自动按白/黑名单过滤(UsagePage + AppConfigPanel)
- - ✨ **MODEL 下拉三分类**:API 渠道模型 / Auth 账号模型 / 映射模型三个 optgroup 分组展示
- - ✨ **Auth 账号豁免渠道限制**:Auth 账号无 channel id,豁免渠道级白/黑名单,模型级限制仍生效
- - ✨ **priority/weight 中文化**:AccountCard 与 EditModal 标签改为「优先级」「权重」
- </details>
- <details>
- <summary><b>v0.1.7 (2026-08-09)</b></summary>
- #### Wiki 知识引擎(大功能)
- - **数据模型**:Wiki 项目/页面/源文件三表结构(mig017 + mig018 标签表),项目目录隔离
- - **文档摄入管道**:源文件解析 → 结构化页面生成 → 自动提取 frontmatter 标签和 `[[wikilinks]]` → 摄入状态机(pending / ingested / failed)
- - **页面管理**:CRUD 操作、按路径/标题/内容搜索、按标签筛选
- - **Wiki 问答**:检索相关页面 → LLM 生成回答 + 来源引用
- - **知识图谱**:页面(节点)+ wikilinks(边)构成图谱,支持可视化
- - **标签体系**:从 frontmatter 自动提取标签,按频率排序
- - **前端面板**:KnowledgeBasePage Wiki 面板(项目/页面/搜索/问答/标签/图谱视图),Sidebar 导航,Dashboard 统计
- #### MCP Server 扩展
- - 新增 **16 个 Wiki MCP 工具**:项目 CRUD、页面 CRUD、搜索、问答、标签、图谱、源文件管理、摄入
- - MCP 工具总数从 13 → **29 个**(知识库 13 + Wiki 16)
- - Dashboard 新增 Wiki 统计卡片,指标分两行展示(5+5)
- #### SSE 协议修复
- - **SSE 字节级重组**:`sse_bridge.rs` 新模块,修复 CJK 多字节边界帧泄漏问题(push 改 `&[u8]`)
- - **Responses 流式修复**:handler 路径 SSE 帧重组 + reasoning 归属修复
- - **OpenAI Responses/Chat 协议对齐**:stop_reason 收敛 + done 补字段 + usage details
- - **Opencode/Codex 流式修复**:bridge 统一 Anthropic→OpenAI SSE + usage 合并 + tools 转发
- - **tool_choice 透传修复**:仅在转换出函数工具时透传并规范化到 Chat 格式
- - **Anthropic Messages 转换修复**:system 提取 + tool_choice 映射 + stream_options
- </details>
- <details>
- <summary><b>v0.1.6 (2026-08-08)</b></summary>
- #### 渠道协议大重构(T01–T14)
- - **T01** — Provider preset registry + 领域类型定义,统一渠道身份模型
- - **T02** — 渠道身份迁移和 resolver,修复 review findings
- - **T03** — 零调用 fail-closed 测试、legacy 日志脱敏、安全审计门、dead-code 清理
- - **T04** — chat↔messages 严格 codec,canonical tool_result,strict n/empty-stream,thread model
- - **T07** — SSRF private-range 策略(按渠道)、stream:false 探测、SSE-always 网关容错、草稿测试跳过 count_tokens 探测
- - **T08** — Provider 下拉组件(分组、品牌 SVG 图标、键盘导航、a11y)、silent switch、free endpoint toggle、延迟显示两位小数、legacy 渠道显示推断协议标签
- - **T10** — Feature flags 暴露给 UI(Tauri Command)
- - **T11** — Codec 加固:image gate、field whitelist、tool validation;protocol rollout 集成测试;upstream model 采样写入 body
- - **T12** — CLIProxyAPI codec baseline 对比
- - **T13** — thinking/reasoning fail-open 转换(codec + legacy)
- - **T14** — 通过 modal 同步上游模型(后端 fetch + 前端 apply)
- #### 渠道表单 URL 预览
- - 端点→请求路径模板常量 `ENDPOINT_PATHS`
- - 端点下方实时展示实际请求 URL 预览,随输入更新
- - URL 预览改纯文本靠左,隐藏 count_tokens 端点
- - Anthropic base URL 统一自带 `/v1`,端点只补 `/messages`
- #### /v1/models 接口
- - 兼容 OpenAI + Anthropic 格式的 `/v1/models` 接口,聚合**启用渠道 + Auth 账号**的完整模型列表
- - 渠道模型来自 `models` 列表与 `model_mapping` 源别名;Auth 账号模型来自同步快照中 `available` 且未 `unavailable` 的条目及其 `model_mapping` 源别名
- - 渠道与账号模型统一去重,渠道优先(`owned_by` 归属渠道),账号模型 `owned_by` 为 provider;禁用 / 非活跃账号不参与聚合
- #### 数据库迁移备份
- - 迁移前自动备份数据库,保留最近 3 份
- #### Provider 图标和预设更新
- - 品牌 SVG 图标(Claude、Moonshot、Doubao 等)
- - 渠道预设更新(名称、图标、端点、描述)
- </details>
- <details>
- <summary><b>v0.1.5 (2026-08-03)</b></summary>
- - ✨ 模型映射一对多:`model_mapping` 支持单目标→多目标数组映射,同优先级渠道间随机负载均衡
- - 🐛 输入法 composing 回车误触发修复:`isComposing` + `keyCode 229` 双重防护,覆盖 ChannelForm / ApiKeysPage / KnowledgeBasePage
- - 🐛 渠道拖拽排序修复:Tauri v2 `dragDropEnabled` 吞掉 HTML5 drop 事件,禁用后拖拽排序正常
- - 🐛 proxy.rs P0 修复:Chat Completions 路径 429/5xx 误返客户端,新增 `status >= 400` 检查触发 failover
- - ✨ 渠道超时配置:`timeout_secs` 字段(默认 60s,可配 1~600s),覆盖 5 个适配器 + handlers 3 处请求
- - ✨ ChannelForm UX 增强:映射 from 下拉(跨渠道通用映射名 + 添加新映射名入口)、优先级/权重说明文字
- - 🐛 映射模型分组去重修复:UsagePage / AppConfigPage 拆分 `realSeen` / `mappedSeen` 独立去重
- - ✨ LLM 使用页空配置提示:无密钥/无渠道时显示红色提示 + 快捷跳转链接
- - ✨ 渠道卡片空白区域点击展开/收起
- </details>
- <details>
- <summary><b>v0.1.4 (2026-07-30)</b></summary>
- - ✨ 知识库引擎:文档解析 → tree-sitter 代码符号感知 → 智能分块 → 向量化 → HNSW 索引
- - ✨ 混合检索:HNSW 向量检索 + SQLite FTS5 全文检索加权融合,三种模式(向量/关键词/混合)
- - ✨ RAG 问答引擎:Top-K 检索 + 对话历史 + 来源引用
- - ✨ MCP Server:Streamable HTTP + SSE,13 个知识库工具,兼容 Claude Desktop / OpenClaw
- - ✨ 多源导入:Git 仓库克隆、URL 批量导入、本地目录扫描
- - ✨ 应用配置:一键写入 8 款 AI 编程工具配置(Claude Code / Codex / Gemini CLI / WaLiCode 等)
- - ✨ 导入导出:渠道配置 JSON 备份 + WaLiCode 备份文件导入
- - ✨ 内置应用更新检查(Tauri Updater)
- </details>
- <details>
- <summary><b>v0.1.3 (2026-07-26)</b></summary>
- #### 知识库 RAG 增强
- - ✨ **符号感知分块(P0)**:代码文件不再按固定 token 数盲切,而是按 AST 符号边界(函数/类/方法)切分,每个 chunk 是完整符号,检索时能精确定位到 `UserController.getUsers` 这种级别
- - ✨ **FTS5 混合检索(P1)**:向量检索(语义相似 0.7 权重)+ FTS5 关键词检索(精确匹配 0.3 权重)合并,比纯向量召回率更高
- - ✨ **MCP server instructions(P2)**:agent 连接时自动注入工具使用指南,避免反模式(先 search 再自己总结等)
- - ✨ **知识库标签**:知识库支持标签管理与筛选
- - ✨ **RAG MCP 动态维护**:RAG MCP 工具支持动态维护
- #### 自动更新
- - 🔧 **自动更新处理优化**:完善自动更新流程的异常处理
- </details>
- <details>
- <summary><b>v0.1.2 (2026-07-22)</b></summary>
- #### 自动更新
- - ✨ **检查更新**:内置应用更新检查功能
- - ✨ **静默更新**:支持静默更新模式
- - ✨ **多镜像更新源**:GitHub + GitCode 多镜像更新源,UI 展示源探测
- - ✨ **更新提示红点**:新版本可用时侧边栏展示红点提示
- - 🔧 **release-mirror 改用 `workflow_run` 触发**,GitCode 镜像同步优化
- - 🐛 **Updater 配置修复**:添加 `createUpdaterArtifacts: true`
- </details>
- <details>
- <summary><b>v0.1.1 (2026-07-21)</b></summary>
- - ✨ 多协议网关:支持 OpenAI Chat Completions + Responses API + Anthropic Messages 三协议入口
- - ✨ 仪表盘优化:统一 6 卡片指标网格 + 健康度徽章 + 动态运维建议
- - ✨ 渠道统计:调用次数、Token 消耗、成功率、平均延迟
- - ✨ 密钥统计:每个密钥的调用指标展示
- - ✨ 接入示例页:三协议切换 + 15 套代码示例 + 连接测试
- </details>
- <details>
- <summary><b>v0.1.0 (2026-07-18)</b></summary>
- - 🎉 首个发布版本
- - 多渠道管理(10 种渠道类型)+ 优先级/权重负载均衡
- - 密钥管理 + 配额限制
- - 请求/响应日志 + 全维度搜索筛选
- - 安全审计中心(25+ 规则,5 种策略模式)
- - 设置中心(主题/托盘/自启/重试)
- - SSE 流式响应转发
- </details>
- ---
- ## 👥 贡献者
- > WaLiAPI 由一个热情的开源社区共同构建。感谢以下开发者的代码贡献(按贡献量排序)。
- <div align="center">
- | | 贡献者 | GitHub | 提交 | 代码变更 | 主要贡献 |
- |:---:|:---|:---|:---:|:---|:---|
- | 🏆 | **小傅哥** | [@fuzhengwei](https://github.com/fuzhengwei) | 373 | `+86,896 / -9,369` | 项目创建者 · 核心架构 · 多渠道网关 · 协议转换 · 安全审计 · 知识库引擎 · Wiki 知识引擎 · MCP Server · Codex 账号切换 · API Key 独立启停与负载均衡增强 · WorkBuddy 对接与 Windows 升级启动修复(v0.4.1) · Qoder Auth 渠道与协议编解码 · 可观测性增强与仪表盘路由地图/Token 热力图 · API 日志客户端识别 · README 多语言化与 30 秒架构图(v0.4.2) · MCP 能力域升级为软件对接 Link 与 OpenAPI 一键导入、CLI-Hub 集成、Qoder 流式修复(v0.4.3) · 推理档位下拉组件统一(v0.4.4) · 免费渠道对接:OpenCode 车道 / Kilo 池免 Key 内置种子、免费车道执行器、11 家免费层预设(Groq / Cerebras / Mistral / NIM / OpenRouter / GitHub Models / Hugging Face / SambaNova / Cohere / ModelScope / 硅基流动)、免费模型同步过滤与 Google / 智谱免费层标注(v0.4.5) |
- | ⚡ | **xian** | [@zsxink](https://github.com/zsxink) | 140 | `+97,192 / -24,477` | Anthropic Messages 协议兼容 · 渠道协议重构(T01-T14)· codec 加固 · SSRF 防护 · SSE 帧重组 · models 接口 · Kimi Code Auth · protocol 模块结构化重构 · Auth 多格式导入 |
- | 🛠 | **chyuan** | [@chyuan-cuihongyuan](https://github.com/chyuan-cuihongyuan) | 56 | `+11,881 / -1,729` | 统一上游重试判定决策函数与真值表测试 · 渠道健康探测与候选排序 · 语义缓存 · 流式内容持久化与断线续传 · X-Request-Id / OTLP 可观测性 · 知识库增量索引、查询改写与混合检索 · 配额强化 · 401/403 下游脱敏 · StepFun 渠道预设接入(PR #127) |
- | 🚀 | **GululuCopa** | [@GululuCopa](https://github.com/GululuCopa) | 24 | `+13,087 / -475` | Grok OAuth 登录(PR #122)· Antigravity OAuth Gemini 登录(PR #121)与 v0.3.6 修复(PR #128)· Grok 与 Antigravity namespace 工具兼容修复 · 网关客户端适配(流式出站无总超时、Grok 工具白名单与加密推理约束对齐、采样字段兼容、OpenCode/OpenClaw/Hermes 配置生成修正,PR #135)· codec 响应格式与防护修复(response_format 映射、safeguards fail-open、Gemini JSON Schema / Gemini 3 工具签名兼容、function_call fc_ 前缀修复,PR #136) |
- | 🐳 | **Fla1337** | [@Fla1337](https://github.com/Fla1337) | 15 | `+4,978 / -1,143` | Web 管理面板 · Docker / headless 部署 · waliapi-web 二进制 · 多阶段镜像构建 · Web 管理面板用户设置 |
- | 🔧 | **mw** | [@maowei0427](https://github.com/maowei0427) | 11 | `+1,296 / -246` | 日志响应内容记录 · Trace ID 追踪 · 详情页体验优化 · 知识库 embedding 批次配置 · WorkBuddy 响应数据兼容性处理(PR #168,v0.4.5) |
- | 🔧 | **Nelson** | [@Zhengmingming1](https://github.com/Zhengmingming1) | 30 | `+22,688 / -3,833` | 知识库扫描版 PDF VLM OCR(方案A)· 中文 PDF 与检索修复 · 知识库访问授权与连接检查 · RAG 检索回归修复(管理搜索模式/权重、失败重导、索引落后回退、向量校验)· Token 配额标签澄清 · 修复 Claude 渠道协议适配 · pdfium macOS 打包路径修复 · Embeddings 配置补齐与 RAG 链路诊断(内部 Embedding 统一网关路由、分阶段诊断、API Key 健康检测,PR #140)· RAG 健康检测按 API Key 选择回答模型(PR #152)· 通用 RAG 质量优化、PDF 解析补全与 SQLite 并发写入修复(PR #153)· 知识库 Embedding 批次索引重复恢复(PR #158) |
- | 🐞 | **xerina** | [@jiangnuonnuo](https://github.com/jiangnuonnuo) | 9 | `+1,801 / -666` | Wiki Unicode 文本切片 panic 进程崩溃修复 · 新增字符边界安全切片工具(utils/text.rs)· RAG/Wiki 设置保存后状态未即时更新修复(PR #60)· Codex 账号重置卡与手动重置额度、重置操作流水记录(PR #149)|
- | 🐛 | **Jason** | [@freakojc](https://github.com/freakojc) | 26 | `+10,633 / -1,008` | 新增「简要」日志级别,请求消息列表只留最新 3 条(PR #119)· 日志统计覆盖索引优化 · 探测日志降噪与恢复状态就地更新 · 流式日志 499 误记修复 + Token 用量恢复 · 仪表盘 cached_tokens 聚合覆盖索引消除 2 秒加载 · 流式 pre-commit 阶段多 Key failover(PR #150)· 用量统计持久化与审计日志解耦、多条件组合清理、服务可用率健康口径、Token 趋势堆叠柱状图(PR #154)· 清理弹窗渠道日志 tab 与成功率公式修正、首页与弹窗 UI 优化(PR #155)· Wiki PDF 摄入全链路修复、API Key 知识访问授权、RAG/Wiki 体验优化与摄入进度修复(PR #159,v0.4.2)· Wiki 项目导出/导入 zip 备份恢复(PR #163)· ask_wiki 全链路修复(中文标点切片 panic、图片 URL 嵌套、审计档位归因等,PR #164,v0.4.4)· Wiki 程序化重建(索引 + LLM 语义归组 + log 一致性回溯)与页面 tab 体验增强(PR #166,v0.4.5) |
- | 🔧 | **yuanqixun** | [@yuanqixun](https://github.com/yuanqixun) | 9 | `+2,745 / -665` | 审计日志存储与加载优化 · Codex 设备码登录 · Codex 剩余额度展示 · 手动刷新 Codex 额度 · 大响应 SSE 帧兼容修复 |
- | 🩹 | **wuchubuzai2018** | [@wuchubuzai2018](https://github.com/wuchubuzai2018) | 2 | `+129 / -9` | 低版本 WebKit 左侧菜单不显示修复(Tailwind v4 断点兼容,附 ADR)· Codex 订阅页表格操作按钮悬浮文案优化(PR #144)|
- | 🐛 | **cyd** | [@cydmacro](https://github.com/cydmacro) | 2 | `+105 / -9` | Codex 工具调用参数一次性下发,修复部分客户端截断 · Codex Responses 请求 strip `prompt_cache_options` 兼容修复(PR #59)|
- | 🔧 | **cham** | [@Cham1229](https://github.com/Cham1229) | 1 | `+444 / -111` | 自定义安全规则接入运行时安全扫描管道——规则加载·白名单短路·黑名单匹配·端到端集成测试(PR #64)|
- | 🐛 | **lianggq** | [@GQingL](https://github.com/GQingL) | 1 | `+91 / -9` | 日志日期筛选修复 · macOS 渠道删除按钮修复 |
- | 🐛 | **zjx** | [@Sadsunset3](https://github.com/Sadsunset3) | 8 | `+1,058 / -134` | Anthropic 容量错误提交前识别与跨协议故障切换 · sub2api 导入兼容与账号数刷新 · Claude Code 网关鉴权初始化 · Codex Auth 写入跨平台修复 · 账号操作后滚动位置保持 |
- | 🐛 | **breezewonders** | [@breezewonders-dev](https://github.com/breezewonders-dev) | 1 | `+14 / -0` | Chat-to-Responses 转换 store 字段归一化修复 |
- | 🩹 | **ymsy2021** | [@ymsy2021](https://github.com/ymsy2021) | 1 | `+14 / -5` | Responses→Chat 转换缺省时不再注入 max_tokens=4096,修复长回答被静默腰斩(PR #165)|
- | 🧩 | **黄科铭** | [@huangkemingyyds](https://github.com/huangkemingyyds) | 9 | `+3,353 / -677` | Antigravity 模型额度展示与工具调用 ID 保留 · Codex 旧会话回放与 GPT-6 模型同步修复(PR #137 #138)· 模型映射规范化与 Antigravity Responses 工具路由修复(PR #141)· Anthropic 内置工具兼容与渠道地址 /v1 归一化(PR #147)· Codex client version 动态刷新(PR #148)· Windows 旧版迁移 CRLF 校验兼容与升级诊断(PR #157) |
- </div>
- ---
- ## 📄 License
- [MIT](./LICENSE)
- 本项目基于 MIT 开源协议发布,具有以下权利和说明:
- ### ✅ 你可以
- - **商业使用**:可将 WaLiAPI 用于商业项目、企业内部工具或 SaaS 服务,无需支付授权费用
- - **个人使用**:个人开发者可免费下载、安装和使用
- - **二次开发**:可基于本项目进行修改、扩展和定制,满足业务需求
- - **分发与部署**:可在组织内部或向客户分发部署
- - **私有化部署**:支持完全离线的私有化部署,数据不出本地
- ### ⚠️ 需要注意
- - 保留原始版权声明和许可证声明
- - 二次开发后的衍生项目建议开源回馈社区
- - 本项目不提供任何形式的担保,使用风险自负
- - 如将 WaLiAPI 作为商业产品的一部分分发,建议在产品文档中注明基于 WaLiAPI 构建
- ### 💡 常见场景
- | 场景 | 是否允许 |
- |:---|:---:|
- | 个人本地使用 | ✅ |
- | 公司内部部署 | ✅ |
- | 商业产品集成 | ✅ |
- | 二次开发后闭源使用 | ✅ |
- | 重新分发销售 | ✅(需保留版权声明) |
- | 移除版权声明后分发 | ❌ |
- ---
- <div align="center">
- <sub>Built with ❤️ by the WaLiAPI community</sub>
- </div>
Ratings and comments
Sign in to rate this skill.
Sign inFree to use. If it’s helped, pass it on.