AI Shakedown Console 的网页版本是无需构建步骤的多协议 AI 工作台。它既能直接连接 OpenAI Compatible、Anthropic 和 Gemini API,也能通过安全的本机桥接复用已经登录的 Codex、Antigravity、Gemini CLI、Claude Code 与 OpenCode;android/ 另提供需要 Android 工具链的轻量 APK 壳。
v31 是当前版本:提供 Android 7+ 轻量 WebView APK、PWA 启动缓存优化、iPhone 输入字号与底部安全区、可选生成参数和 Windows 启动器。 当前内容修订 v31-r2 修复生成期间上滑查看前文时被强制拉回底部的问题。
| 你想做的事 | AI Shakedown Console 提供的能力 |
|---|---|
| 快速验证 API | 地址、密钥、模型、请求体、SSE 流和错误信息集中在一个页面 |
| 连接不同厂商 | OpenAI Compatible、Anthropic Messages、Google Gemini 三类协议 |
| 使用本机登录 | 复用 5 种本机 CLI 的现有登录,不把 CLI 凭据复制到网页 |
| 管理长期对话 | 多对话、自动恢复、编辑分支、搜索、复制、完整备份和失败重试 |
| 发送本地文件 | 支持图片、文本/代码和可提取文字的 PDF;仅在模型通过图片探测后显示入口 |
| 使用专业角色 | 388 个内置中文智能体、明确取消入口,并支持自建 System 智能体 |
| 像桌面应用运行 | 可安装 PWA,独立窗口启动并离线打开应用外壳 |
| 安装到 Android | 提供只访问正式 HTTPS 站点的轻量 WebView APK,支持系统文件选择器 |
| 排查连接问题 | 脱敏请求检查器、连接测试、模型列表和清晰的错误提示 |
- 打开 在线版本。
- 在左侧选择服务商,填写 API Key 和模型;本机工具则选择对应的“本机登录”预设。
- 点击“检查连接”。成功后页面自动收起设置,进入专注聊天。
- 输入消息,macOS 使用
⌘ + Enter发送,Windows/Linux 使用Ctrl + Enter发送;普通Enter保留换行。
中文输入法组词和选择候选词时不会触发快捷发送。消息框右上角的
?会根据当前系统显示完整操作帮助。
第一次使用本机 Codex 等工具?请直接阅读 本机 AI 连接指南,其中包含 macOS 权限提示、完整命令、Node.js 检查、后台运行、更新、停止和端口冲突处理。
浏览器提示:线上本机桥接请使用 Edge/Chrome。Safari Web App 适合第三方中文输入法与云端 API,但 WebKit 当前会阻止 HTTPS 页面访问
127.0.0.1;页面会直接显示兼容性说明,不再让用户反复检测。
- 多协议连接:内置主流服务商预设,也支持自定义 Base URL、路径、认证、请求头和附加 JSON 参数;生成参数可逐项决定是否发送。
- 专注聊天:连接成功后隐藏配置和检查器;对话超过 4 个后自动切换为持久化左侧列表。
- 贴底输入区:消息区随窗口弹性伸缩,输入框在浏览器和 PWA 窄窗口中都始终停在底部。
- 完整消息操作:单条复制、编辑并重发、自动分支、重新生成、继续生成、从此处删除;支持多选复制、导出和删除。
- 按能力显示附件:检查连接时发送 16×16 测试图片;只有当前协议、地址和模型实际接受图片时才显示附件按钮,避免给纯文本模型展示无效入口。
- 本地附件处理:图片按三种协议映射为多模态输入;文本/代码直接读取;PDF 使用自托管 PDF.js 在浏览器本地提取文字。附件草稿和历史文件保存在 IndexedDB。
- 智能体与 System:268 个上游角色和 120 个事务型项目预设统一管理;聊天区可直接取消当前智能体,System 点击“编辑”后在弹窗中修改。
- 本地记录导入:支持 Codex、Gemini CLI、Claude Code 及通用 JSON/JSONL 文件,可继续使用当前模型对话。
- 跨设备完整备份:设置中可一次导出全部对话、System、智能体状态、草稿和附件,在另一台电脑追加恢复;同一备份重复导入不会生成副本。
- 本机 CLI 桥接:Edge/Chrome 启动器自动检查环境、停止同工具旧桥接、避开被占端口并转入后台;Windows 单文件启动器支持自定义下载目录、空格/中文路径和重复文件名。
- 安全 Markdown:使用 Marked 解析 GitHub Flavored Markdown,再由 DOMPurify 清洗后显示。
- PWA 与离线外壳:可安装到桌面或主屏幕;离线时仍能打开页面和查看浏览器本地数据。
- Android APK:Android 7+ 可侧载轻量 WebView 壳;只申请联网权限,APK 数据与浏览器/PWA 独立。
- Cloudflare Pages Worker:同域代理只允许访问
ALLOWED_UPSTREAMS白名单,避免成为开放代理。
| 协议 | 代表服务 | 流式响应 |
|---|---|---|
| OpenAI Compatible | OpenAI、DeepSeek、千问、豆包、Kimi、OpenRouter、Ollama、LM Studio 等 | ✓ |
| Anthropic Messages | Anthropic 原生 /v1/messages |
✓ |
| Google Gemini | generateContent / streamGenerateContent |
✓ |
| 工具 | 调用方式 | 安全约束 |
|---|---|---|
| Codex | 官方 App Server,保持连续线程 | 默认临时任务;可选保存到 Codex;read-only 沙盒、never 审批 |
| Antigravity | agy -p 单轮调用并重放上下文 |
独立临时目录与对话安全指令,Beta |
| Gemini CLI | 无头 JSON 模式 | plan 审批模式 |
| Claude Code | Print/JSON 模式 | 禁用内置与 MCP 工具,计划模式 |
| OpenCode | JSON 模式 | 运行时注入 permission: deny |
flowchart LR
UI["浏览器 / PWA"] -->|"直连"| API["AI API"]
UI -->|"同域 /api/proxy"| Worker["Cloudflare Pages Worker"]
Worker -->|"白名单校验"| API
UI -->|"随机令牌 + Origin 校验"| Bridge["127.0.0.1 本机桥接"]
Bridge --> CLI["Codex / Antigravity / Gemini / Claude / OpenCode"]
UI --> Store["浏览器本地配置、智能体与对话"]
远程 API、Cloudflare 代理和本机 CLI 是三条独立连接路径。PWA 只负责安装、缓存应用外壳和独立窗口,不会把远程模型变成本地模型。
| 文档 | 适合谁 | 内容 |
|---|---|---|
| 文档首页 | 所有人 | 按任务选择正确文档 |
| 使用指南 | 普通用户 | 连接、聊天、智能体、导入、PWA、快捷键 |
| 本机 AI 指南 | 本机 CLI 用户 | 三系统启动、权限、后台、更新与安全边界 |
| Android APK | Android 用户 | 侧载安装、数据边界、限制与维护者构建流程 |
| 故障排查 | 遇到错误的用户 | 中文输入、Node、端口、权限、CORS、缓存等 |
| 部署与发布 | 部署者 | Cloudflare Pages、环境变量、ZIP 和发布检查 |
| 架构说明 | 维护者 | 模块、数据流、协议适配、存储与缓存 |
| 安全策略 | 用户与维护者 | 凭据、本机桥接、代理边界和漏洞报告 |
| 贡献指南 | 贡献者 | 修改规范、检查清单和 PR 流程 |
| 版本记录 | 所有人 | 重要版本与迁移说明 |
这是纯 HTML/CSS/JavaScript 项目。因为入口使用 ES Module,请通过 HTTP 服务打开:
python3 -m http.server 4173然后访问 http://localhost:4173/。没有 Python 时,macOS 可使用:
ruby -run -e httpd . -p 4173 -b 127.0.0.1普通静态服务器不会执行 _worker.js,本地调试时请关闭“使用同域代理”。完整说明见 部署与发布。
- 配置、API Key、自定义智能体、对话和附件元数据保存在当前站点的
localStorage;附件内容保存在同源IndexedDB。只应在可信部署和个人设备上使用。 - “完整备份”只包含对话相关数据和附件,不包含 API Key、连接配置或本机登录;备份 JSON 没有加密,应像私人对话和原文件一样妥善保管。
- 本机桥接配对令牌只保存在当前标签页的
sessionStorage,桥接仅监听127.0.0.1并检查网页 Origin。 - 不通过关闭 Safari 安全策略、安装自签名根证书或把桥接暴露到局域网来绕过 WebKit 限制;本机 CLI 改用 Edge/Chrome 普通标签页。
- 同域代理只转发到
ALLOWED_UPSTREAMS中列出的上游,不会把密钥写入 Worker 配置。 - 共享设备使用完毕后,请在设置中点击“清除全部本地数据”。
更完整的威胁边界和安全建议见 SECURITY.md。
index.html / style.css / script.js 网页界面与全部前端逻辑
_worker.js Cloudflare Pages Worker 与同域代理
assets/ PWA、本机桥接和三系统启动器
agents/ 388 个中文智能体索引与正文
vendor/ 固定版本的前端依赖与许可证
docs/ 用户、部署、排查和架构文档
scripts/ 智能体角色库导入工具
v31 已完成计划中的网页与 Android 测试版:多协议与多模态连接、可选生成参数、本机登录工具、完整聊天操作、多对话、388 个内置智能体、附件、跨设备备份、PWA 启动缓存优化、三系统启动器和 Android WebView 壳均已落地。
暂不纳入本版本的方向包括:包含连接配置的加密整站迁移、账号云同步、自动化端到端回归,以及由 Tauri 管理本机进程的原生桌面版。详见 架构说明中的演进边界。
| 组件 | 版本 | 许可证 | 用途 |
|---|---|---|---|
| Marked | 15.0.12 | MIT | Markdown 解析 |
| DOMPurify | 3.2.6 | Apache-2.0 OR MPL-2.0 | HTML 清洗 |
| Bootstrap Icons | 1.11.3 | MIT | 界面图标 |
| PDF.js | 5.4.296 | Apache-2.0 | 浏览器本地提取 PDF 文字 |
| agency-agents-zh | 1.2.7 | MIT | 268 个中文智能体 |
| AI Shakedown 事务型预设 | task-presets-r1 | MIT | 项目自带的 120 个办事型智能体 |
依赖全部自托管,不从第三方 CDN 加载。完整许可文本保存在 vendor/ 与 agents/ 对应目录。
项目使用 MIT License,Copyright © 2026 ForceMind。