Repository navigation
AI Helper v1.0.60
🚀💡✨ AI Helper v1.0.60 —— 主动交互保存引导 · 令牌绑定精准解绑重配 · 步骤条实时动态微摘要 · 终审清单层级分化美化 🛡️🔐🎨🎯💎
📅 发布日期：2026-10-13 🗓️
🏷️ 版本标签：v1.0.60 🎯
🧭 更新类型：💡 主动交互式保存引导（告别死锁 Disabled 按钮） · 🔐 令牌绑定精准失效与自动重配（Stale Token 解绑与重连） · 📍 步骤条实时动态微摘要（即输即显，Active 状态实时渲染） · 🎨 终审清单状态分级与未配置弱化展示 · 🌐 全平台安装矩阵与官网双源同步升级 🚀✨
🌟 欢迎使用 AI Helper v1.0.60 丝滑交互与体验极致打磨版本！ 🎉🥳🍾
继 v1.0.59 重磅推出「配置确认终审关卡」与「云端分组智能透视」后，开发团队收到了大量开发者的热烈反馈！💬❤️
v1.0.60 紧接着将体验细节打磨到极致！ 针对用户在配置向导中遇到的真实痛点进行了全方位深度重构：
1️⃣ 彻底告别冰冷死锁的 Disabled 按钮 🚫🔒➡️💡✨：保存按钮全面升级为「主动交互式引导」，未勾选确认时以温润的半透色等待，点击不再静默装死，而是主动弹出温馨 Toast 并一键平滑跳转至终审卡片！
2️⃣ 彻底解决修改 API Key 时的幽灵旧绑定残留 👻🧹➡️🔐⚡：智能识别输入框 Key 变更，若与本地绑定的旧 Token 不匹配则果断清空缓存解绑，并即时重新向下进行精准匹配与前后缀智能识别！
3️⃣ 步骤条微摘要所填即所见 📍📝👀：哪怕正停留在当前步骤编辑，指示条下方也能实时渲染关键微摘要，配置进度心中有数！
4️⃣ 终审卡片视觉精细分层 🎨💎✨：未配置的可选字段优雅降级为柔和浅灰，已配置核心参数高亮聚焦，整个确认面板层次分明、赏心悦目！
快来升级體驗更加灵动、体贴、高效的 AI Helper v1.0.60 吧！💻👾🚀✨🎉
🗺️ 架构与交互升级全景图 (Architecture & Interaction Overview) 🖼️⚡🎨
+---------------------------------------------------------------------------------------------------------+
| 🚀 AI Helper v1.0.60 交互打磨与精准绑定全景图 |
+---------------------------------------------------------------------------------------------------------+
| |
| 💡 [主动交互式保存引导链路 (Interactive Save Guidance)] |
| ├── 🔘 状态呈现：已确认 ──> 饱和主题色 (高亮聚焦) 🌟 |
| │ 未确认 ──> 80% 柔和微透态 (随时可交互响应) 💧 |
| └── 🖱️ 用户点击：已确认 ──> 顺畅唤起连通性测试与配置落盘 ✅ |
| 未确认 ──> 🚨 友好 Toast：「请先勾选确认配置无误」 |
| └─> 🔄 若不在终审页，自动平滑 jumpToStep(终审步) 🎯 |
| |
| 🔐 [ApiKeyInput 绑定智能失效与自动重配 (Smart Bound Token Invalidation)] |
| ├── 1️⃣ 校验当前 boundToken 是否依然与输入框中的 Key 明文 / 前后缀精确吻合 |
| ├── 2️⃣ 仍吻合 ──> 保持绑定，仅同步云端最新的 Group 分组信息 🔄 |
| └── 3️⃣ 已不吻合 (用户换了 Key 或云端已删除) ──> |
| ├── 🧹 立即 setBoundToken(null) 并抹除 localStorage 幽灵缓存 🗑️ |
| └── 🔍 立即触发明文精确比对与 7+4 前后缀启发式匹配，重新锚定新分组 🏷️ |
| |
| 📍 [StepIndicator 步骤条实时动态微摘要 (Live Micro-Summary)] |
| ├── 过去：仅 isDone || canClick 才展示微摘要 (当前编辑步显示为空白) ⚪ |
| └── 现在：(isDone || canClick || isActive) && step.summary ──> 实时录入即时渲染 🟢 |
| |
| 🎨 [ConfigConfirmStep 终审清单层级分化 (Visual Hierarchy)] |
| ├── 有效配置值 ──> font-medium + 专属品牌强调色 (Blue / Purple / Emerald / Orange) 🌈 |
| └── 未配置项 ──> font-normal + text-slate-400 / dark:text-gray-500 柔和灰 (弱化聚焦) 🌫️ |
+---------------------------------------------------------------------------------------------------------+
🌟 核心升级亮点 (Core Highlights) 💡✨💎
1. 💡 主动交互式保存引导：告别冰冷死锁 · 视觉温润感知 · 智能 Toast 提醒 · 自动回跳终审 🎯✨🚀
在以往的软件交互中，最让用户抓狂的莫过于**「一个灰色的、点上去毫无反应的 Disabled 按钮」** 😫。在 v1.0.59 引入配置确认门禁后，若用户未在终审页勾选「我已核对以上配置」，保存按钮会被 disabled={!configConfirmed} 锁死，新手用户容易困惑：「我该怎么继续？为什么保存按钮点不动？」
v1.0.60 彻底打破这一交互困局，实现从「死锁拦截」到「主动智能引导」的华丽蜕变！ 🌟🎉
+-----------------------------------------------------------------------------------+
| 💡 主动交互引导 vs 过去传统死锁对比 |
+-----------------------------------------------------------------------------------+
| 【v1.0.59 过去模式】 |
| 未勾选确认 ──> 🔘 按钮 disabled 灰色死锁 ──> 🖱️ 点击 0 响应 ──> 😫 用户困惑懵圈 |
| |
| 【v1.0.60 全新模式】 |
| 未勾选确认 ──> 🔘 按钮 80% 柔和呼吸态 ──> 🖱️ 允许点击 |
| │ |
| ▼ |
| 🚨 触发友好 Toast 提醒：「请先勾选确认配置无误」 |
| │ |
| ▼ |
| 🎯 若不在末步，自动平滑跳转至「确认配置」终审卡片！ |
| │ |
| ▼ |
| ☑️ 用户点击勾选 ──> 🔘 按钮瞬间点亮饱满高光 ──> 🚀 顺畅落盘保存！ |
+-----------------------------------------------------------------------------------+
🌈 1. 双态视觉设计：既有辨识度，又保留交互张力
- 已勾选确认态：呈现饱满且鲜活的主题色品牌高光（Codex 经典蓝 💙 / Claude 科技紫 💜 / Workbuddy 极客绿 💚 / Accio 活力橙 🧡），传递「一切就绪，随时起飞」的明确信号！🚀
- 未勾选准备态：采用
bg-*-600/80 hover:bg-*-600柔和状态，既在视觉上传达「尚有步骤待确认」，又保持按钮可点击的交互生命力！🌿
🤖 2. 覆盖四大 Agent 面板全场景
ChatGPTPanel.tsx(Codex 配置面板) 🪟ClaudePanel.tsx(Claude Code 面板) 🟣WorkbuddyPanel.tsx(Workbuddy 面板) 💚AccioWorkPanel.tsx(Accio Work 面板) 🧡- 统一交互范式，用户无论配置哪款 Agent，都能获得一致、愉悦的操作反馈！🤝✨
2. 🔐 令牌绑定精准失效与自动重配：根治旧 Key 幽灵残留 · 智能解绑清缓存 · 瞬时重匹新分组 🛡️🔄⚡
在多 Token、多工具混合使用的场景中，用户经常会手动更换输入框中的 API Key，或在云端后台删除过期 Token。
在过去，本地一旦缓存了 bound_token_*，即使输入框中换成了完全不一样的 Key，逻辑仍然以为「该输入框属于旧 Token」，导致界面显示了错误的旧 Token 名字与旧通道分组！👻🤦♂️
v1.0.60 在 ApiKeyInput.tsx 中构建了坚不可摧的绑定自愈核对机制！ 🛡️💎
+-----------------------------------------------------------------------------------+
| 🔐 ApiKeyInput 智能解绑与自愈重配逻辑 (v1.0.60) |
+-----------------------------------------------------------------------------------+
| 输入框值变更或拉取云端令牌列表 |
| │ |
| ▼ |
| 本地是否存在 boundToken 缓存？ |
| ├─ [否] ──────────────────────────────────────────┐ |
| │ │ |
| └─ [是] │ |
| │ │ |
| ▼ │ |
| 核对该 Token 是否依然匹配当前输入框的 Key？ │ |
| (明文全等 OR 长度>=12 前7位+后4位匹配) │ |
| │ │ |
| ├─【依然匹配】──> 同步云端最新 Group ──> 完成 ✅ │ |
| │ │ |
| └─【已不匹配 / 云端已删】 │ |
| │ │ |
| ▼ │ |
| 🧹 立即解除旧绑定 (setBoundToken(null)) │ |
| 🗑️ 清除 localStorage 幽灵持久化数据 │ |
| │ │ |
| ▼ ▼ |
| 🔍 重新向下比对当前输入框 Key |
| ├── 1️⃣ 令牌列表精确明文比对 |
| └── 2️⃣ 前 7 后 4 启发式智能匹配 |
| │ |
| ▼ |
| 🏷️ 重新锚定新 Token ID、名称与所属通道分组！ 🎉 |
+-----------------------------------------------------------------------------------+
🛡️ 1. 深度比对算法：兼顾明文全等与脱敏匹配
- 无论是刚从剪贴板粘贴的完整明文 Key，还是部分脱敏保存的 Key，算法通过
val.startsWith(prefix) && val.endsWith(suffix)双重特征校验，确保绑定的准确度达到 100%！🎯
🧹 2. 干净利落的缓存清理
- 只要检测到用户手动变更了 Key 且不属于原绑定，毫秒级清理
localStorage中的残留碎片，彻底终结「换了 Key 分组却还是老分组」的历史顽疾！🚫👻✨
3. 📍 步骤条实时动态微摘要：所填即所见 · Active 状态同步渲染 · 编辑过程全程透明 📝⚡👀
在向导式配置界面中，顶部 StepIndicator 是开发者掌控全局进度的方向盘。
在 v1.0.59 中，步骤条下方的微摘要（如节点域名、脱敏 Key、当前模型等）仅在步骤处于 isDone（已完成）或 canClick（可点击）时显示；一旦当前正停留在该步骤进行输入（isActive），微摘要就会突然消失隐藏！ 这种断续感降低了界面的沉浸度。
v1.0.60 优化 StepIndicator.tsx 显示逻辑： 🌟
// 🚀 v1.0.60 核心升级：增加 isActive 实时渲染
- {(isDone || canClick) && step.summary && (
+ {(isDone || canClick || isActive) && step.summary && (
<div className={cn("text-[10px] font-mono truncate mt-0.5 max-w-full px-0.5", ...)}>
{step.summary}
</div>
)}✨ 实时微摘要带来的绝佳体验：
- 🌐 接入节点：输入或切换 URL 的瞬间，下方立即动态提炼出主机域名（如
bob-api.com）； - 🔑 API 凭据：选择或填入 Key 时，下方立即呈现脱敏字样与状态；
- 🤖 模型选择：在模型下拉列表中点选时，步骤条下方立刻跟随跳动所选模型名称；
- 📊 随时可见：不再需要切换到下一步才能回看当前步的配置摘要，边填边看，行云流水！🌊🚀
4. 🎨 终审清单层级分明与美化：「未配置」柔和弱化 · 关键参数聚焦高亮 · 视觉质感跃升 💎🏷️🌈
在 ConfigConfirmStep.tsx 终审卡片中，配置汇总包含了必须项（节点、Key、模型）与多项可选项（自定义协议、思考强度、高级参数、Bridge 网关等）。
过去当某项为空或显示为「未配置」时，依然套用了加粗 font-medium 与主题强调色，使得整个清单视觉焦点杂乱，用户一眼望去分不清哪些配了、哪些没配。
+-----------------------------------------------------------------------------------+
| 🎨 终审清单视觉分层改造对比 (Visual Refinement) |
+-----------------------------------------------------------------------------------+
| 【过去样式】 |
| • 接入节点 ： https://api.openai.com/v1 [亮蓝加粗] |
| • API Key ： sk-ant-api03-xxxx... (svip) [亮蓝加粗] |
| • 自定义协议 ： 未配置 [亮蓝加粗 ⚠️ 容易误认已配] |
| |
| 【v1.0.60 升级样式】 |
| • 接入节点 ： https://api.openai.com/v1 [🌟 亮蓝加粗 font-medium] |
| • API Key ： sk-ant-api03-xxxx... (svip) [🌟 亮蓝加粗 font-medium] |
| • 自定义协议 ： 未配置 [🌫️ 柔和中性灰 font-normal] |
+-----------------------------------------------------------------------------------+
💎 视觉雕琢细节：
- 🎯 信息层级分明：真实有效的参数高亮夺目，缺省或未配置项低调沉静；
- 🌓 暗黑模式友好：
text-slate-400 dark:text-gray-500在浅色与深色模式下都具备极佳的对比度与呼吸感； - 🃏 SpotlightCard 质感融合：搭配 React-Bits 聚光流光特效，确认卡片科技感满满！✨
5. 📦 工程版本跃迁与全平台官网对齐：四大分发包 · 官方直链与加速镜像全面同步 🌐🍏🪟🚀
全栈工程版本号协同升级至 v1.0.60，官方网站及下载索引全量同步！
| 客户端平台 / 架构 | 产物文件名 | 打包格式 | 官方直链 / OSS 极速 / 镜像 |
|---|---|---|---|
| 🪟 Windows x64 (安装版) | AI-Helper-v1.0.60-Windows-x64-Setup.exe |
NSIS 自动安装包 | 阿里云 OSS ⚡ · 官方直连 🚀 · ghfast 镜像 🏎️ |
| 🪟 Windows x64 (绿色版) | AI-Helper-v1.0.60-Windows-x64-Standalone.zip |
免安装 Zip 归档 | 官方直连高速源 📦 |
| 🍏 macOS Apple Silicon (M系列) | AI-Helper-v1.0.60-macOS-aarch64.dmg |
原生 DMG 镜像 | 阿里云 OSS ⚡ · 官方直连 🚀 · ghfast 镜像 🏎️ |
| 🍏 macOS Intel (x86_64) | AI-Helper-v1.0.60-macOS-x64.dmg |
兼容 DMG 镜像 | 阿里云 OSS ⚡ · 官方直连 🚀 · ghfast 镜像 🏎️ |
- 🔖
package.json、Cargo.toml、Cargo.lock、tauri.conf.json版本一致收敛至1.0.60； - 🌐
website/version.json、website/download-config.json、website/index.html官网下载矩阵与浮动下载条全面更新！
📊 版本前后核心体验对比 (Before vs. After) 🔄💡
| 体验维度 | 🔴 v1.0.59 及更早版本 | 🟢 v1.0.60 最新版本 |
|---|---|---|
| 保存按钮交互 🖱️ | 未勾选确认时按钮死锁 Disabled，点击毫无反应，用户不明所以 ❌ | 按钮采用 80% 柔和微透态，点击触发 Toast 提示并自动平滑跳转至终审卡片 ✅ |
| API Key 变更自愈 🔐 | 修改输入框 Key 后，本地残留旧 Token 绑定，导致显示错误名称与旧分组 ❌ | 严格核对匹配性，一旦不匹配自动清空旧绑定与缓存，即时重新精确/模糊重配新分组 ✅ |
| 步骤条微摘要 📍 | 当前正处于该步骤编辑时（isActive），微摘要被隐藏 ❌ |
`(isDone |
| 终审项未配置状态 🎨 | 「未配置」依然显示为主题亮色加粗，视觉杂乱且易误导 ❌ | 「未配置」自动降级为柔和中性灰，已配置核心参数突出，层级清晰 ✅ |
| 工作流连续性 ⚡ | 必须手动一层层点击向导，稍有遗漏不知如何修复 ❌ | 任意步骤点击「确认并保存」皆有明确路径指引，一键直达断点 ✅ |
📋 详细更新日志 (Changelog) 📑✨🎉
💡 核心交互与引导升级 (Interactive & Guidance)
- 重构 四大 Agent 面板主保存按钮交互：解除
disabled={!configConfirmed}死锁，改用bg-*-600/80柔和状态，点击主动弹出引导 Toast。🖱️✨ - 新增 保存按钮跨步骤智能跳转：在任意非终审步骤点击保存时，自动调用
goToStep(TOTAL_STEPS - 1)引导用户核对终审配置。🎯🔄 - 优化 Codex (
ChatGPTPanel)、Claude Code (ClaudePanel)、Workbuddy (WorkbuddyPanel)、Accio Work (AccioWorkPanel) 保存按钮视觉与禁用逻辑。🤖🌈
🔐 令牌管理与分组重配 (Tokens & Grouping)
- 新增
ApiKeyInput本地绑定自愈检测：核对当前绑定的 Token 是否依然与输入框中的 Key 匹配（全等匹配或长度 >= 12 时的前 7 后 4 位匹配）。🔐⚡ - 优化 Key 失效与变更处理：若输入框 Key 改变或云端 Token 已删除，立即清除
boundToken状态与localStorage缓存，防止幽灵分组残留。🧹🗑️ - 优化 自动穿透重新比对：解绑后即时向下触发明文精准匹配与前后缀启发式匹配，无缝切换新分组徽标。🏷️🔄
🎨 界面视觉与细节雕琢 (UI & Visual Design)
- 优化
StepIndicator微摘要展示条件：由(isDone || canClick)扩充为(isDone || canClick || isActive)，当前激活步骤也能实时呈现微摘要。📍👀 - 优化
ConfigConfirmStep终审卡片视觉分层：对未配置项采用柔和灰text-slate-400 dark:text-gray-500 font-normal，与已配置的鲜艳参数形成清晰对比。🎨💎 - 优化 Workbuddy 面板高级参数微摘要换行与间距排版，视觉更协调。💚📐
📦 工程构建与官网同步 (Engineering & Releases)
- 升级 应用版本号全面提升至
v1.0.60（package.json、Cargo.toml、Cargo.lock、tauri.conf.json）。🔖🚀 - 同步 官方发布网站全部下载入口与配置（
website/index.html、website/version.json、website/download-config.json）。🌐📦 - 对齐 Windows（Setup 安装包 / Standalone 绿色版）与 macOS（Apple Silicon 原生 / Intel 兼容）全架构镜像地址。🪟🍏⚡
🚀 升级与下载方式 (Downloads & Upgrade) 📥💻✨
🪟 Windows 用户通道
- 应用内热更新：启动现有版本 AI Helper，应用将自动检测并推送
v1.0.60升级提醒，点击即可一键升级！🔄✨ - Setup 自动安装包：
- 阿里云 OSS 极速直连：下载 Windows Setup (OSS 镜像) ⚡
- 官方直链高速源：下载 Windows Setup (直链) 🚀
- 国内加速反代镜像：下载 Windows Setup (ghfast 镜像) 🏎️
- 免安装绿色便携版：
- 便携 Zip 压缩包：下载 Windows Standalone 便携版 📦
🍏 macOS 用户通道
- Apple Silicon 原生版 (M1/M2/M3/M4 芯片，强烈推荐)：
- 阿里云 OSS 极速直连：下载 macOS Apple Silicon DMG (OSS 镜像) 🍏⚡
- 官方直链高速源：下载 macOS Apple Silicon DMG (直链) 🚀
- 国内加速反代镜像：下载 macOS Apple Silicon DMG (ghfast 镜像) 🏎️
- Intel 处理器版 (x86_64 架构)：
- 阿里云 OSS 极速直连：下载 macOS Intel DMG (OSS 镜像) 💻⚡
- 官方直链高速源：下载 macOS Intel DMG (直链) 🚀
- 国内加速反代镜像：下载 macOS Intel DMG (ghfast 镜像) 🏎️
💬 遇到任何疑问或需要帮助？
欢迎访问 Bob API 官方交流社区与技术支持 与我们一同探讨！💬🤝
如果你喜欢 AI Helper，欢迎前往 GitHub 项目主页 为我们点亮一颗闪耀的 ⭐️ Star！🌟
祝愿大家的 AI 编程之旅配置安心、交互丝滑、开发高效、灵感满满！🎉🥳💻👾🚀✨🔐💡