你的 Vibe Coding 灵动岛
中转站余额 · 缓存命中 · 首字延迟 · 模型核验，悬浮一眼看清，数据只留在本机
功能 · 下载安装 · 开始使用 · 模型核验 · 常见问题 · 文档
各工具的支持程度不同，分级见 支持的工具。
Modivue 是一个运行在 macOS 和 Windows 上的本机悬浮窗，面向通过 API 中转站使用 Claude Code、Codex 等 coding agent 的开发者。它读取中转站余额，记录请求的缓存命中和首字延迟，并能按需发起模型核验，保存"这个渠道返回的模型是否和参考行为一致"的原始证据。所有数据写入本机 SQLite。
鼠标移入展开，悬停单个环查看详情，移开自动收回。
| 你想知道 | Modivue 怎么给出答案 |
|---|---|
| 中转站还剩多少钱？ | 读取 OpenRouter、New API / Sub API、CC Switch 或自定义 JSON 字段映射的余额，显示为余额环和历史曲线 |
| 提示词缓存到底生效没有？ | 只采用提供方明确返回的缓存字段计算命中率；没有返回字段时显示缺失，不按 0 计 |
| 为什么今天首字这么慢？ | 从请求发出到首个有效文本或工具事件计算 TTFT，按渠道分开看趋势 |
| 这个"模型"的行为和它自称的一致吗？ | 按需运行 11 种核验方法，保存原始回答和判定依据。结果是行为证据，不是身份认证 |
所有指标按 模型 × 渠道 × Key 分组 × 推理档位 分开统计。同一个模型经过两个中转站调用，或者同一中转站用两组 Key 调用，都会分成独立的记录，不会混在一起取平均。
交互总览。实际界面以各功能文档中的截图为准。
 概览与指标趋势 按模型、渠道、Key 分组和推理档位筛选，查看核验、Cache、TTFT 与余额的趋势。 |
 灵动岛悬浮面板 贴在屏幕边缘，极简、普通、专注三种形态；悬停单个环看数值与最近曲线。 |
 Agent 状态 发现本机 Claude Code、Codex 等会话，区分"配置存在"和"正在运行"。 |
 模型核验 11 种方法按需运行，逐方法保留原始回答和判定依据。 |
 费用与余额 各中转站的余额历史，逐请求记录核验花费，未知费用不记为 0。 |
 可信参考与校准 在可信渠道采集同条件分布，导出为档案，供其他渠道比对。 |
 设置与通知 检测间隔与每日上限、分类音效、主题、文字大小和显示项。 |
 自定义布局 长按区块拖动排序，保存自己的布局。 |
 CLI 与状态栏 在终端或 Claude Code 状态栏读取同一份本地数据，不触发付费请求。 |
| 平台 | 下载包 | 安装 |
|---|---|---|
| macOS Apple Silicon | Modivue-macos-arm64.zip |
解压，把 Modivue.app 拖进"应用程序"。暂无 Intel 版 |
| Windows 10/11 x64（预览） | Modivue-windows-x64-setup.exe |
解压后运行 Modivue.exe。需要 Microsoft Edge WebView2 Runtime |
| 命令行 | 源码 cli/ |
Node.js 22.5+，读取桌面端共享的本地数据库 |
Warning
当前是预览版。macOS 包使用临时签名，尚未经 Apple 公证；Windows 包尚未签名，多 DPI 实机验收尚未完成。
macOS： 第一次打开会被系统拦截。只对你信任的下载，到"系统设置 → 隐私与安全性"中点"仍要打开"，或者在终端执行一次：
xattr -cr /Applications/Modivue.app首次打开遇到系统拦截时，使用系统设置中的“仍要打开”；命令行清除隔离标记仅适用于你信任的本地包。
Windows： 未签名的程序首次运行时可能出现 SmartScreen 提示。确认来源可信后，点"更多信息 → 仍要运行"。
签名 DMG 和 Windows 安装器已有构建流程，但还没有正式发布，详见 构建与发布。
-
打开 Modivue。 屏幕边缘出现灵动岛。本地服务只监听
127.0.0.1。 -
Agent 自动发现。 Claude Code 通过 statusline / hook 心跳上报会话；Codex 通过本机会话状态识别；其他工具读取其当前选中的 provider 配置。详见 Agent 状态。
-
让真实请求经过 Modivue。 把 Agent 的 Base URL 指向本机代理：
OpenAI 协议 见设置中的「本地代理」地址 + `/proxy/openai/v1` Anthropic 协议 见设置中的「本地代理」地址 + `/proxy/anthropic/v1`设置页会显示当前本地代理地址。请求必须经过该地址，Modivue 才能记录 TTFT、Cache、费用和实际出站渠道。
多渠道路由见 本地代理与 API。
-
需要核验时，在主窗口的"模型核验"里选择方法并开始。核验会消耗 token，花费逐请求记录。
形态名称与入口按当前桌面实现定义如下。
| 形态 | 怎么进入 | 显示什么 |
|---|---|---|
| 极简态 | 默认 | 每个活跃模型一个环，外圈为余额；拖条与设置按钮隐藏 |
| 普通态 | 鼠标移入 | 正在工作及近期活跃的目标，拖条与设置按钮恢复 |
| 专注态 | 悬停单个环 | 核验、Cache、TTFT、余额数值和最近趋势 |
| 主窗口 | 点击模型 | 统计、趋势、告警、日志、核验报告和设置 |
悬浮窗可以拖动并吸附到屏幕左右边缘。任何界面下按 ⌘K / Ctrl+K 都能搜索功能。完整说明见 灵动岛悬浮面板。
核验结果是行为证据：它比较回答与参考分布或参考答案的差异。结果不是人类 IQ，匹配度也不等于身份置信度。原理、版本和局限见 MODEL-VERIFICATION.md，操作说明见 模型核验。
| 你的情况 | 建议方法 | 需要准备 | 请求量参考 |
|---|---|---|---|
| 有一道熟悉的题，想长期盯着看 | 单问题测试 | 题目和参考答案 | 每轮 1 次请求；默认完成后 60 秒再测，可设 5–3600 秒 |
| 没有可信渠道，想快速看"更像哪个模型" | Meow 模型指向 | 无，基准内置 | 预览档 6 次；完整档 GPT 32 / 48 / 96 次，Claude 48 / 72 / 120 次 |
| 想看知识边界是否符合 | KBF 知识边界 | 无，16 个历史模型参考内置 | 可先试采一批，但试采不下完整结论 |
| 有一个可信渠道，想做同条件对照 | HLWY、One Token、Astra、自定义概率探针 | 先在可信渠道采集参考档案，见 可信参考与校准 | One Token / Astra 建议每题至少 10 次；HLWY 少于 50 个有效样本只算预览 |
| 想交给第三方服务检测 | BazaarLink Probe、Ztest 官方检测 | BazaarLink 需逐目标授权；Ztest 在官网完成人机验证后导入报告 | BazaarLink 不另收检测服务费，token 由目标 Key 计费 |
| 只想记录原始观测，不下结论 | Juice、本地多探针 | 无；Juice 的校准模式需要档案 | 本地多探针为五组简单请求 |
- 不把匹配度换算成"智商"或身份置信度。
- 不在后台绕过 Ztest 的人机验证，本地多探针也不冒充 Ztest 的官方评分。
- 不把未知费用记为 0。
- 没有校准档案时不设真伪阈值，只显示距离。
全部 11 种方法的来源与实现
| 方法 | 检查内容 | 来源或实现 | 基准要求 |
|---|---|---|---|
| 单问题测试 | 自定义题目与参考答案的匹配记录 | evaluator-question.mjs | 不需要 |
| Meow 模型指向 | 短答案分布与候选基准的距离 | meow-llm-detector，evaluator-meow.mjs | 内置 |
| HLWY 分布匹配 | 公共整数分布的众数、余弦和 JS 相似度 | hlwy-ai-checker，evaluator-hlwy.mjs | 公共基准或可信 API |
| KBF 知识边界 | 16 个历史模型的参考探针，CP99 / 单侧二项检验 | Ooo0ption/KBF | 内置参考；试采不下完整结论 |
| One Token | 单 token 英文任务的分布差异 | 论文，evaluator-one-token.mjs | 先采集；仅适配英文 10 类任务 |
| Astra | 社区五类任务的适配观测，未复刻作者的精确题库 | 社区原帖，实现 | 自采同条件参考 |
| Juice | 生成答案中的原始整数，不是服务器认证的预算 | 需求参考帖，实现 | 参考帖正文未核实；校准模式需要档案 |
| BazaarLink Probe | 官方异步检测与持续计划 | Probe API | 官方服务 |
| Ztest 官方检测 | 官网浏览器检测流程及报告导入 | Ztest，报告适配 | 第三方服务，人机验证由用户完成 |
| 本地多探针 | 五组简单请求，记录回答、失败及耗时 | 实现 | 不复刻 Ztest 私有探针或评分 |
| 自定义概率探针 | 自定义短答案分布的 JSD 比较 | 参考项目，实现 | 同条件档案；未校准时只显示距离 |
| 支持程度 | 工具 |
|---|---|
| 实时读取会话状态 | Claude Code（statusline / hook 心跳）、Codex（本机会话状态；Windows 上不适用文件锁采集） |
| 本机安装并启动验证 | Gemini CLI、Qwen Code、Pi、OpenCode |
| 可解析 provider 配置，尚未实机验收 | Goose、Continue、Grok Build、Hermes、OpenClaw、GPTMe、Cline、Roo Code、Aider |
各工具的识别方式见 Agent 状态，后续适配计划见 ROADMAP.md，图标来源与许可见 素材归属。
- 本地服务只监听
127.0.0.1。 - 请求记录、核验报告、余额和图表数据写入本机 SQLite。
- 数据库只保存 API Key 的不可逆短指纹。你主动保存的可信渠道凭据会以明文写入本机配置文件，文件权限限制为当前用户，请按本机安全策略保护。
- 主动探测和核验会向你配置的上游发请求并产生费用，可以在设置中关闭、调低频率或限制每日请求数。
- 模型目录、公共基准和版本检查会访问各自的远程来源。启用 BazaarLink 或 Ztest 官方检测时，请求交由对应第三方处理。"数据存在本机"不等于"完全离线"。
会不会把我的 API Key 传出去？ 数据库只保存 Key 的不可逆短指纹。主动核验会用 Key 向你配置的上游发请求；启用 BazaarLink Probe 时，需要逐个目标授权 Key 的发送。
核验要花多少钱？ 取决于方法和模型单价，请求量见上面的选择表。每次核验都逐请求记录花费；拿不到价格时显示"未知"。
核验结果能证明中转站掺水吗？ 不能单独作为证明。核验给出的是与参考分布或参考答案的差异，匹配度不等于身份置信度，每种方法的局限见 MODEL-VERIFICATION.md。
CLI 或状态栏会产生费用吗？ 不会。它们只读取本地已有数据，不发起 API 请求。
macOS 提示无法打开怎么办？ 见首次打开前请读。
有 Intel Mac 版本吗？ 目前没有。当前构建产物为 Apple Silicon。
Windows 上 Agent 状态和 macOS 一样准确吗？ 不完全一样。Windows 通过进程发现和配置解析识别 Agent，进程存在不代表它正在工作；Codex 在 macOS 上的文件锁采集方式不适用于 Windows。
| 我想… | 文档 |
|---|---|
| 了解每个功能怎么用 | 功能文档索引 |
| 了解核验原理与局限 | MODEL-VERIFICATION.md |
| 配置多渠道路由或调用本地 API | docs/proxy.md |
| 在终端或状态栏读取数据 | CLI 与状态栏 |
| 构建、测试与发布 | docs/development.md |
| 替换截图与录屏 | 素材清单 |
| 了解后续计划 | ROADMAP.md |
git clone https://github.com/systemoutprintlnhelloworld/Modivue.git
cd Modivue
npm ci
npm run dev # 浏览器调试 http://127.0.0.1:4173
npm run desktop:build # macOS → dist/Modivue.app
npm run windows:build # Windows，需要 .NET SDK 8环境要求与测试命令见 docs/development.md。
提交 issue 时请附上系统版本、Agent 类型、协议（Chat Completions / Responses / Messages）、中转站类型、相关日志和复现步骤。欢迎提交新中转站的余额适配、核验方法和翻译。
仓库尚未选定开源许可证，请以根目录的 LICENSE 文件和 Release 说明为准。