AgentFloat v3.0.0-beta — 重构预览版（跨设备验证）

AgentFloat v3.0.0-beta（预发布 · 跨设备验证）

P1–P3 大规模重构后的首个预览版：用于跨设备实测与继续开发。

本版亮点

• 交互内核重写：拖拽不误弹 / 贴边唤出顺滑 / 点按即时反馈 / 弹性收尾（交互状态机 + 弹簧动效引擎）
• 环菜单三件套：弹簧展开 + 磁吸选中 + 按压微光
• 浮球新视觉（方案 C）：深色玻璃 + 品牌渐变描边 #0a84ff→#af52de + 白色旋涡
• Web 设置 / 快报秒开：Web 壳静默预热（隐藏创建，空闲自动回收）
• 性能：启动 5.3–6.0s → 0.56–0.82s（约 7–8 倍）；便携包 153.5MB → 141.9MB；安装包 151MB → 45.3MB
• 工程：pytest 146 项全过 + pyflakes 零告警；Web 前端 ES 模块化

安装（Windows 10/11）

下载 AgentFloat-Setup-3.0.0.exe 双击安装（按用户级安装，覆盖旧版、配置保留）。

另一台电脑继续开发

git clone https://github.com/GinyvaXu/AgentFloat.git
cd AgentFloat
pip install -r requirements.txt
python agent_float.py      # 源码运行
python -m pytest           # 跑测试（146 项）
python build_debug.py      # 构建调试版（默认 onedir）
python smoke_test.py       # 构建冒烟（存活 + 日志 + 启动耗时）

说明

• 本版本为 Pre-release（Beta）：不进入自动更新链，稳定版用户不受影响
• 重构方案与实测数据见 docs/v3重构方案.md；完整变更见 CHANGELOG.md

AgentFloat v2.2.0

v2.2.0 - Agent 安装服务与稳定性修复

新增

• Web 设置新增「Agent 安装」模块：Claude Code / Codex CLI / Pi / DeepSeek Harness 一键安装、升级、卸载（npm 全局安装，国内镜像优先自动回退官方源）；实时状态/版本/日志展示

修复

• Web 套壳后端启动崩溃（uvicorn 0.52 冻结环境 formatter 配置失败，设置页 127.0.0.1 拒绝访问）
• 冻结 exe 启动时 tkinter 钩子崩溃
• 设置页 JS .forEach 报错
• 加载指示器动画逻辑混乱；启动成功提示约 1 秒自动关闭

下载

• AgentFloat.exe（免安装版）
• AgentFloat_Setup.exe（安装包）
• AgentFloat_debug.exe（调试版）

AgentFloat v2.1.0 — Web Shell & DeepSeek Harness 支持

AgentFloat v2.1.0 — Web Shell & DeepSeek Harness 支持

中文

✨ 新增

• Web 套壳界面：设置 / API 用量 / AI 快报全面迁移为 Web UI（FastAPI + pywebview + 原生前端），Apple 风格侧边栏、深浅双主题、实时预览、保存后变更摘要、SSE 实时推送
• DeepSeek Harness（dsh）启动兼容：统一 Agent 启动器现覆盖 Claude Code / Codex CLI / Pi / DeepSeek Harness；dsh 以 Web UI 模式后台启动（优先本地 dsh，缺失时 npx @deepseek-ai/dsh web），就绪后自动打开浏览器，端口占用自动复用
• 动画加载指示器：dsh 启动 / Web 壳打开时在浮窗旁显示毛玻璃进度卡片（旋转加载环 + 无限进度条 + 阶段文案 + 已等待秒数 + 淡入淡出；成功绿勾 / 失败红叉）
• 新增 requirements.txt 运行时依赖清单

🐛 修复

• 修复 Web 壳窗口无法打开：pywebview 必须在主线程运行，改为 multiprocessing 子进程承载（冻结环境已加 freeze_support）
• 修复点击启动 DeepSeek Harness 程序未响应：启动改为异步非阻塞，后台线程轮询就绪并自动开浏览器
• 修复 Web 设置页主题单选保存失效（浅色主题保存后仍为深色）
• 配置防护：损坏的 config.json 会先备份再重置，避免自定义设置被静默清空

📦 构建产物

• AgentFloat.exe — 正式版（绿色版）
• AgentFloat_Setup.exe — 安装包（Inno Setup，per-user 静默安装，支持自动更新）
• AgentFloat_debug.exe — Debug 版（带控制台 + 会话日志/崩溃报告）

---

English

✨ Added

• Web Shell UI: Settings / API Usage / AI Daily Brief migrated to a native Web UI (FastAPI + pywebview + vanilla frontend), Apple-style sidebar, dark/light themes, live preview, change summary on save, SSE push
• DeepSeek Harness (dsh) launch support: unified Agent launcher now covers Claude Code / Codex CLI / Pi / DeepSeek Harness; dsh starts in Web UI mode (local dsh first, falls back to npx @deepseek-ai/dsh web), auto-opens browser when ready, reuses an occupied port
• Animated loading indicator: frosted-glass progress card near the floating ball for dsh startup / Web shell opening (spinner + indeterminate progress bar + stage text + elapsed seconds + fade in/out; green check / red cross)
• Added requirements.txt runtime dependencies

🐛 Fixed

• Web shell window could not open (pywebview requires main thread) — now hosted in a multiprocessing child process
• App froze when launching DeepSeek Harness — dsh startup is now async/non-blocking with background readiness polling
• Web settings theme radio could not save light theme
• Corrupt config.json is backed up before reset to prevent silent data loss

📦 Artifacts

• AgentFloat.exe — release (portable)
• AgentFloat_Setup.exe — installer (Inno Setup, per-user silent install, auto-update ready)
• AgentFloat_debug.exe — debug build (console + session logs / crash reports)

v1.6.0 - Pi Coding Agent 启动兼容

v1.6.0 - Pi Coding Agent Launch Support & Built-in Agent Auto-Migration

English

• Added Pi Coding Agent launch support (pi.dev multi-model terminal coding agent, purple badge "P").
• Built-in Agent auto-migration: new built-in presets (e.g. Pi) are appended automatically on upgrade, without overwriting user customizations.
• Assets: AgentFloat_Setup.exe (installer), AgentFloat.exe (portable), AgentFloat_debug.exe (debug with console + session report).

中文

• 新增 Pi Coding Agent 启动兼容（pi.dev 多模型终端编码智能体，紫色 P 徽标）。
• 内置 Agent 自动迁移：升级后自动追加新内置预设（如 Pi），不覆盖用户自定义配置。
• 资产：AgentFloat_Setup.exe（安装包）、AgentFloat.exe（免安装版）、AgentFloat_debug.exe（调试版，带控制台与会话报告）。

v1.5.1

v1.5.1 - Water Helper Fixes, Auto-Update 404 Fallback & Always-on-Top Dialogs

English

• Water reminder popup: now a focusable topmost window with fade-in/out animations, fixable close button; live countdown tick; panel hint text and settings button removed; settings page uses form layout and follows light/dark theme.
• Water panel opens non-modally, the floating widget stays clickable/draggable while it is open.
• Auto-update: when the manifest download URL returns 404, the updater now falls back to the real latest GitHub Release asset automatically; update dialogs are always-on-top; failure dialog offers a direct link to the Releases page.

中文

• 提醒弹窗改为可聚焦置顶窗口，带淡入淡出动画，可正常关闭；时间实时递减；面板底部提示文字与设置按钮已移除；设置页表单化并完整适配深浅主题。
• 喝水助手面板改为非模态打开，打开期间浮窗仍可单击与拖动。
• 自动更新：清单下载地址 404 时自动回退到 GitHub 最新正式版实际资产；更新弹窗全部置顶；下载失败弹窗提供一键打开 Releases 页面。

v1.3.0

v1.3.0 — 安装/更新链路重构 + 设置 UI 修复

中文

• 安装 / 卸载 / 自动更新链路重构（参考诺丁汉警长桌游项目）：
  • Inno Setup 按用户级安装（%LOCALAPPDATA%\AgentFloat），静默自动更新不再弹 UAC；卸载前自动结束进程
  • 多源检查更新：update.json 清单 + jsDelivr CDN + 国内 GitHub 加速代理 + Releases API 并行探测，返回友好错误码（timeout/network/unknown）
  • 静默重装并重启 + boot 验证；支持 mirror.json 自建镜像
• 设置「关于」页新增软件更新卡片：检查更新 / 下载更新（带进度条）/ 更新并重启
• UI 修复：深色模式 API 用量与 AI 快报设置页白框消除；浅色模式输入框边框清晰可见
• 关于页重建：使用教程、下载链接（GitHub Releases / 项目主页 / 个人网站）、数据路径说明
• Bug 修复：AI 快报自动生成超时崩溃（fetch_all 超时返回部分结果而非抛异常）

English

• Install / uninstall / auto-update chain refactored (per-user Inno Setup with silent install; multi-source update check; silent reinstall + relaunch with boot verification; optional mirror.json)
• Settings About page now has Check for Updates / Download / Update & Restart buttons
• Fixed dark-mode white boxes on API usage & AI news settings pages; light-mode input borders now clearly visible
• About page rebuilt with usage tutorial, download links and personal website
• Fixed AI news auto-generation crash on fetch timeout (returns partial results instead of raising)

下载

• AgentFloat_Setup.exe — 安装包（推荐）
• AgentFloat.exe — 正式版便携程序
• AgentFloat_debug.exe — 调试版（含控制台，用于排查问题）

v1.2.2 — 剪贴板历史 · 命令面板 · 交互修复

✨ v1.2.2 — 效率工具与体验优化

新增功能

• 📋 剪贴板历史：自动记录复制内容（上限 60 条、相邻去重），面板点击即复制回剪贴板，支持单条删除与一键清空
• ⌘ 自定义命令面板：自由管理常用命令（名称/命令/参数/工作目录），支持独立窗口 / Windows Terminal / 后台静默三种启动方式，内置常用示例
• 📰 快报自动弹出：启动自动生成完成后直接弹出精简快报窗口（可在设置关闭）

修复与优化

• 🖱️ 修复吸附隐藏与环绕菜单冲突：隐藏状态下打开菜单 / 按压会先自动弹出，菜单不再跑出屏幕
• 🔓 改善点击快捷打开 Agent：边缘检测条加宽 + 滑动提速，点击命中率更高
• 🌀 扇形菜单图标 / 字体 / 色彩圆点随扇区数量自适应，杜绝相邻重叠
• 🧹 快报面板精简：去掉底部备注小字，历史记录默认收起（点「历史」展开）
• 🔴 移除未读红点角标（相应设置项已去除）
• 🔄 自动更新链路复核：已是最新版本时不再误提示
• 🏷️ 版本号改为自动读取 VERSION 文件并随包分发，避免与构建不一致

v1.2.1 — AI 快报体验优化

v1.2.1 — 2026-08-08

UX 改进

• AI 快报面板美化（与 Skills 辅助窗同一套主题体系修复）：
  • 补上 QFrame#titleBar 毛玻璃标题栏样式（此前缺失导致标题栏无底色）
  • 正文改为分类彩色标签 + 卡片式排版：分类 chip（模型/工具/论文/产品/行业/综合 各配色）、
    标题可直接点击、摘要与来源分层显示、卡片间分隔线，深浅色主题自适应
  • 空状态：居中图标 + 引导文案
• 生成反馈：点击「生成今日快报」后显示忙碌进度条 + 按钮变「⏳ 生成中…」，完成后自动刷新
• 关注主题（定向偏好）：设置「AI 快报」新增主题编辑器
  • 预设：价格调整/新模型发布/优秀 skills 推荐/开源项目/论文突破/行业融资/产品更新/安全事件
  • 每项可自定义名称、权重 1~5、标注颜色（点击色块选择）
  • 生成时按权重降序注入 AI 提示词；纯列表模式按命中权重排序
• 设置对话框「应用/保存/取消」逻辑重构：
  • 应用：立即生效并保存，窗口保持打开（此前会关闭且不保存）
  • 保存：立即生效并保存后关闭
  • 取消：回退到最近一次已应用的主题（此前会错误回退原始主题）
  • 跳过权限安全确认对「应用/保存」统一生效
• 未读角标美化：左上角改为精致渐变红点（径向渐变 + 白描边 + 投影，去掉数字）

文件变更

文件	变更
news_panel.py	标题栏样式修复、分类卡片式排版、加载进度条、空状态
agent_float.py	设置页关注主题编辑器（预设/颜色/权重）、应用/保存/取消重构、角标美化
news_worker.py	AI 提示词注入关注主题（按权重）、纯列表模式兴趣排序
news_fetcher.py	DEFAULT_NEWS.interests
config.example.json	news.interests 示例
README.md	版本徽章 + AI 快报特性补充
VERSIONING.md	版本历史 + 当前版本
VERSION	1.2.0 → 1.2.1

构建产物

• AgentFloat_debug.exe — 调试版
• AgentFloat.exe — 正式版
• AgentFloat_Setup.exe — 安装包

v1.2.0 — AI 快报上线

v1.2.0 — 2026-08-08

新功能

• AI 快报（调研报告落地的 P1 阶段）：
  • news_fetcher.py：可插拔数据源注册表，并发抓取 + URL 去重 + 分类标签
    • 内置源：Hacker News（官方 API）、GitHub Trending、少数派（RSS）、量子位（RSS）、arXiv AI（Atom）
    • 单源失败降级：超时 15s/源，失败不影响整体
  • news_worker.py：QThread 生成链路（抓取 → 去重 → 本地 Agent 摘要 → 落盘），
    复用 local_ai_service.run_headless（与 AI 自检同一套 Agent 通道），AI 失败自动回退标题列表
  • news_panel.py：无边框毛玻璃面板，左侧日期历史列表 + 右侧 Markdown→HTML 可点击链接
  • 环绕菜单「AI 快报」扇区（v1.1 预留动作位）接入真面板
  • 浮窗左上角未读红点角标（带数字，可关）；生成完成托盘通知（可关）
• 设置新增「AI 快报」Tab：
  • 生成语言：中文（默认）/ English / 中英双语
  • 定时模式：仅手动 / 每天定时 / 启动时补生成 / 每天定时 + 启动补生成（时间可调）
  • 条数上限（3~15）、AI 摘要开关（关闭则零成本标题列表）、摘要 Agent 选择（默认主 Agent）
  • 数据源多选勾选、通知与角标开关
• 数据纯本地：%APPDATA%/AgentFloat/news/<日期>.json|md，不上传

架构变更

• local_ai_service.py：新增公共封装 run_headless(agent, prompt, cancel) 供快报复用
• build_debug.py / build_exe.py / AgentFloat.spec：hiddenimports 增加 news 三模块
• config.example.json / load_config：新增 news 配置段
• .gitignore：新增 news/（开发模式数据目录）

文件变更

文件	变更
news_fetcher.py	新增（数据源注册表 + 抓取 + 去重 + 分类 + 落盘）
news_worker.py	新增（QThread 生成 + AI 摘要 + 回退）
news_panel.py	新增（无边框快报面板）
agent_float.py	设置「AI 快报」Tab、_generate_news/_open_news_panel/调度器、未读红点、托盘接入
local_ai_service.py	新增 run_headless 公共封装
README.md	AI 快报特性 + 致谢 + 路线图更新
VERSIONING.md	版本历史 + 当前版本更新
VERSION	1.1.0 → 1.2.0
config.example.json	news 配置段

构建产物

• AgentFloat_debug.exe — 调试版（带控制台 + 会话/崩溃报告）
• AgentFloat.exe — 正式版
• AgentFloat_Setup.exe — 安装包