GenericAgent Desktop desktop-portable-v0.2.7

GenericAgent Desktop 桌面版 / Desktop

三个平台产物来自同一提交，并在公开发布前统一验证。All three platform artifacts come from one commit and are validated before publication.

安装方法 / Installation

• Windows x64：下载 GenericAgent-Desktop-Windows-Portable.zip，解压后双击 GenericAgent.exe。卸载时运行 uninstall.bat，再删除解压目录。
  Windows x64: extract GenericAgent-Desktop-Windows-Portable.zip, then launch GenericAgent.exe. Run uninstall.bat before deleting the extracted directory.
• Linux x86_64：下载并解压 GenericAgent-Desktop-Linux-Portable.tar.gz，执行 chmod +x GenericAgent.AppImage 后运行它。卸载时运行 uninstall.sh，再删除解压目录。
  Linux x86_64: extract GenericAgent-Desktop-Linux-Portable.tar.gz, run chmod +x GenericAgent.AppImage, then launch it. Run uninstall.sh before deleting the extracted directory.
• macOS Apple silicon (arm64)：打开 GenericAgent-Desktop-macOS-aarch64.dmg，把 GenericAgent.app 拖入 Applications。
  macOS Apple silicon (arm64): open GenericAgent-Desktop-macOS-aarch64.dmg and drag GenericAgent.app to Applications.

签名状态 / Signing status

Windows 便携版尚未使用代码签名证书，SmartScreen 可能显示警告；运行前请核对 SHA256SUMS-windows.txt。
The Windows portable build is not code-signed, so SmartScreen may warn; verify SHA256SUMS-windows.txt before running it.

macOS 应用仅使用 ad-hoc 签名，未使用 Apple Developer ID，也未 notarize。首次打开可能需要右键选择“打开”或在“隐私与安全性”中允许。
The macOS app is ad-hoc signed only. It is neither Developer ID signed nor notarized; first launch may require Open from the context menu or approval in Privacy & Security.

SHA-256 清单与各产物一同发布。SHA-256 manifests are included with the artifacts.

GenericAgent Desktop desktop-portable-v0.2.6

GenericAgent Desktop 桌面版 / Desktop

三个平台产物来自同一提交，并在公开发布前统一验证。All three platform artifacts come from one commit and are validated before publication.

安装方法 / Installation

• Windows x64：下载 GenericAgent-Desktop-Windows-Portable.zip，解压后双击 GenericAgent.exe。卸载时运行 uninstall.bat，再删除解压目录。
  Windows x64: extract GenericAgent-Desktop-Windows-Portable.zip, then launch GenericAgent.exe. Run uninstall.bat before deleting the extracted directory.
• Linux x86_64：下载并解压 GenericAgent-Desktop-Linux-Portable.tar.gz，执行 chmod +x GenericAgent.AppImage 后运行它。卸载时运行 uninstall.sh，再删除解压目录。
  Linux x86_64: extract GenericAgent-Desktop-Linux-Portable.tar.gz, run chmod +x GenericAgent.AppImage, then launch it. Run uninstall.sh before deleting the extracted directory.
• macOS Apple silicon (arm64)：打开 GenericAgent-Desktop-macOS-aarch64.dmg，把 GenericAgent.app 拖入 Applications。
  macOS Apple silicon (arm64): open GenericAgent-Desktop-macOS-aarch64.dmg and drag GenericAgent.app to Applications.

签名状态 / Signing status

Windows 便携版尚未使用代码签名证书，SmartScreen 可能显示警告；运行前请核对 SHA256SUMS-windows.txt。
The Windows portable build is not code-signed, so SmartScreen may warn; verify SHA256SUMS-windows.txt before running it.

macOS 应用仅使用 ad-hoc 签名，未使用 Apple Developer ID，也未 notarize。首次打开可能需要右键选择“打开”或在“隐私与安全性”中允许。
The macOS app is ad-hoc signed only. It is neither Developer ID signed nor notarized; first launch may require Open from the context menu or approval in Privacy & Security.

SHA-256 清单与各产物一同发布。SHA-256 manifests are included with the artifacts.

GenericAgent Desktop desktop-portable-v0.2.5

GenericAgent Desktop 桌面版 / Desktop

三个平台产物来自同一提交，并在公开发布前统一验证。All three platform artifacts come from one commit and are validated before publication.

安装方法 / Installation

• Windows x64：下载 GenericAgent-Desktop-Windows-Portable.zip，解压后双击 GenericAgent.exe。卸载时运行 uninstall.bat，再删除解压目录。
  Windows x64: extract GenericAgent-Desktop-Windows-Portable.zip, then launch GenericAgent.exe. Run uninstall.bat before deleting the extracted directory.
• Linux x86_64：下载并解压 GenericAgent-Desktop-Linux-Portable.tar.gz，执行 chmod +x GenericAgent.AppImage 后运行它。卸载时运行 uninstall.sh，再删除解压目录。
  Linux x86_64: extract GenericAgent-Desktop-Linux-Portable.tar.gz, run chmod +x GenericAgent.AppImage, then launch it. Run uninstall.sh before deleting the extracted directory.
• macOS Apple silicon (arm64)：打开 GenericAgent-Desktop-macOS-aarch64.dmg，把 GenericAgent.app 拖入 Applications。
  macOS Apple silicon (arm64): open GenericAgent-Desktop-macOS-aarch64.dmg and drag GenericAgent.app to Applications.

签名状态 / Signing status

Windows 便携版尚未使用代码签名证书，SmartScreen 可能显示警告；运行前请核对 SHA256SUMS-windows.txt。
The Windows portable build is not code-signed, so SmartScreen may warn; verify SHA256SUMS-windows.txt before running it.

macOS 应用仅使用 ad-hoc 签名，未使用 Apple Developer ID，也未 notarize。首次打开可能需要右键选择“打开”或在“隐私与安全性”中允许。
The macOS app is ad-hoc signed only. It is neither Developer ID signed nor notarized; first launch may require Open from the context menu or approval in Privacy & Security.

SHA-256 清单与各产物一同发布。SHA-256 manifests are included with the artifacts.

GenericAgent Desktop V2.0.0

GenericAgent Desktop V2.0.0

The first complete React Desktop 2.0 release, built from fork main commit
848547af90416f68aebbb998aeaa98680f61e67b.

Highlights

• React + Semi Design desktop experience with the legacy static v1 kept independent.
• Packaged Tauri bootstrap, recovery, diagnostics, foreign-port protection, and external GA_ROOT support.
• Desktop sessions, model selection, uploads, memory import, conductor controls, and persistent usage history.
• Deterministic browser/native/package validation and path-scoped Desktop Quality Gates.
• Restored curated macOS DMG layout and reduced the mounted macOS application by about 28.74 MiB.
• Final macOS runtime excludes installed build tools and Python bytecode caches while retaining offline recovery wheels.

Downloads and SHA-256

• Windows portable ZIP
  b85a27835bb30c4ebaa0e7b40872b9e9fb23e4f16073c02667532c3e2a2de6be
• Linux portable TAR
  69ad10372c48531e964beaf444c15b9fe84b998d21e3d953512e02ac503ab646
• macOS DMG
  ee9448f3ec656e3ce0eaffa0e594d1f96411c329180cea5f8d65e25b8f556f7c

All three artifacts were produced by successful Actions run
32461113572
from the same commit.

Version note

V2.0.0 is the Desktop 2.0 product release identity. These downloads are the exact
accepted build-32 artifacts; their embedded technical package metadata remains 0.2.0.

中文摘要

这是 React Desktop 2.0 的首个完整发布版本，包含 Semi Design 启动/恢复界面、Tauri 真包
bootstrap、会话与模型管理、上传、记忆导入、Conductor、用量记录、三平台打包门禁，以及
修复后的 macOS 双图标 DMG 布局和缩包结果。三个下载产物均来自同一 fork main SHA。

GenericAgent Desktop desktop-portable-v0.2.4

GenericAgent Desktop 桌面版 / Desktop

无需自行安装 Python、无需联网安装依赖、无需源码；首次启动会自动准备内置运行环境。
No separate Python install, no internet for dependencies, no source checkout required; the bundled runtime is prepared on first launch.

安装方法 / Installation

• Windows: 下载 GenericAgent-Desktop-Windows-Portable.zip，解压后双击 GenericAgent.exe 启动。卸载时先退出应用，再双击包内 uninstall.bat，最后删除整个解压目录。
  Download GenericAgent-Desktop-Windows-Portable.zip, extract it, then double-click GenericAgent.exe. To uninstall, quit the app, double-click uninstall.bat, then delete the extracted folder.
• Linux: 下载 GenericAgent-Desktop-Linux-Portable.tar.gz，解压后执行 chmod +x GenericAgent.AppImage，再运行 ./GenericAgent.AppImage。卸载时先退出应用，再运行 ./uninstall.sh，最后删除整个解压目录。
  Download GenericAgent-Desktop-Linux-Portable.tar.gz, extract it, run chmod +x GenericAgent.AppImage, then launch ./GenericAgent.AppImage. To uninstall, quit the app, run ./uninstall.sh, then delete the extracted folder.
• macOS: 下载 GenericAgent-Desktop-macOS.dmg，双击打开 DMG，把 GenericAgent.app 拖入 Applications，之后在“应用程序 / Applications”中启动。若出现“无法验证开发者”等提示，请右键应用选择“打开”，或在“系统设置 → 隐私与安全性”中允许打开。卸载时先退出应用，再从 Applications 删除 GenericAgent.app。
  Download GenericAgent-Desktop-macOS.dmg, open it, drag GenericAgent.app to Applications, then launch it from Applications. If macOS says the developer cannot be verified, right-click the app and choose Open, or allow it in System Settings → Privacy & Security. To uninstall, quit the app, then delete GenericAgent.app from Applications.

首次启动 / First launch

首次启动会自动离线准备运行环境（安装依赖），有进度条，完成后进入主界面；之后启动会更快。
The first launch prepares the runtime offline (installs deps) with a progress bar, then opens the main window; later launches are faster.

说明 / Notes

• 想真正对话需在程序内配置模型 / API Key。Configure a model / API key in-app to start chatting.
• Windows Defender 防火墙可能会拦截 127.0.0.1 / localhost 回环连接，导致程序无法启动或连接本机服务；请允许 GenericAgent.exe 和随包的 python.exe 通过防火墙后重启。Windows Defender Firewall may block the local loopback connection; allow GenericAgent.exe and the bundled python.exe through the firewall, then restart the app.
• Windows/Linux 为便携包，可整体移动到任意目录后继续使用。Windows/Linux packages are portable and can be moved as a whole folder.
• Windows/Linux 包内附 readme.txt（中英）。Windows/Linux packages include a bilingual readme.txt.

GenericAgent Desktop desktop-portable-v0.2.3

GenericAgent Desktop 桌面版 / Desktop

无需自行安装 Python、无需联网安装依赖、无需源码；首次启动会自动准备内置运行环境。
No separate Python install, no internet for dependencies, no source checkout required; the bundled runtime is prepared on first launch.

安装方法 / Installation

• Windows: 下载 GenericAgent-Desktop-Windows-Portable.zip，解压后双击 GenericAgent.exe 启动。卸载时先退出应用，再双击包内 uninstall.bat，最后删除整个解压目录。
  Download GenericAgent-Desktop-Windows-Portable.zip, extract it, then double-click GenericAgent.exe. To uninstall, quit the app, double-click uninstall.bat, then delete the extracted folder.
• Linux: 下载 GenericAgent-Desktop-Linux-Portable.tar.gz，解压后执行 chmod +x GenericAgent.AppImage，再运行 ./GenericAgent.AppImage。卸载时先退出应用，再运行 ./uninstall.sh，最后删除整个解压目录。
  Download GenericAgent-Desktop-Linux-Portable.tar.gz, extract it, run chmod +x GenericAgent.AppImage, then launch ./GenericAgent.AppImage. To uninstall, quit the app, run ./uninstall.sh, then delete the extracted folder.
• macOS: 下载 GenericAgent-Desktop-macOS.dmg，双击打开 DMG，把 GenericAgent.app 拖入 Applications，之后在“应用程序 / Applications”中启动。若出现“无法验证开发者”等提示，请右键应用选择“打开”，或在“系统设置 → 隐私与安全性”中允许打开。卸载时先退出应用，再从 Applications 删除 GenericAgent.app。
  Download GenericAgent-Desktop-macOS.dmg, open it, drag GenericAgent.app to Applications, then launch it from Applications. If macOS says the developer cannot be verified, right-click the app and choose Open, or allow it in System Settings → Privacy & Security. To uninstall, quit the app, then delete GenericAgent.app from Applications.

首次启动 / First launch

首次启动会自动离线准备运行环境（安装依赖），有进度条，完成后进入主界面；之后启动会更快。
The first launch prepares the runtime offline (installs deps) with a progress bar, then opens the main window; later launches are faster.

说明 / Notes

• 想真正对话需在程序内配置模型 / API Key。Configure a model / API key in-app to start chatting.
• Windows Defender 防火墙可能会拦截 127.0.0.1 / localhost 回环连接，导致程序无法启动或连接本机服务；请允许 GenericAgent.exe 和随包的 python.exe 通过防火墙后重启。Windows Defender Firewall may block the local loopback connection; allow GenericAgent.exe and the bundled python.exe through the firewall, then restart the app.
• Windows/Linux 为便携包，可整体移动到任意目录后继续使用。Windows/Linux packages are portable and can be moved as a whole folder.
• Windows/Linux 包内附 readme.txt（中英）。Windows/Linux packages include a bilingual readme.txt.

GenericAgent Desktop desktop-portable-v0.2.2

GenericAgent Desktop 桌面版 / Desktop

无需自行安装 Python、无需联网安装依赖、无需源码；首次启动会自动准备内置运行环境。
No separate Python install, no internet for dependencies, no source checkout required; the bundled runtime is prepared on first launch.

安装方法 / Installation

• Windows: 下载 GenericAgent-Desktop-Windows-Portable.zip，解压后双击 GenericAgent.exe 启动。卸载时先退出应用，再双击包内 uninstall.bat，最后删除整个解压目录。
  Download GenericAgent-Desktop-Windows-Portable.zip, extract it, then double-click GenericAgent.exe. To uninstall, quit the app, double-click uninstall.bat, then delete the extracted folder.
• Linux: 下载 GenericAgent-Desktop-Linux-Portable.tar.gz，解压后执行 chmod +x GenericAgent.AppImage，再运行 ./GenericAgent.AppImage。卸载时先退出应用，再运行 ./uninstall.sh，最后删除整个解压目录。
  Download GenericAgent-Desktop-Linux-Portable.tar.gz, extract it, run chmod +x GenericAgent.AppImage, then launch ./GenericAgent.AppImage. To uninstall, quit the app, run ./uninstall.sh, then delete the extracted folder.
• macOS: 下载 GenericAgent-Desktop-macOS.dmg，双击打开 DMG，把 GenericAgent.app 拖入 Applications，之后在“应用程序 / Applications”中启动。若出现“无法验证开发者”等提示，请右键应用选择“打开”，或在“系统设置 → 隐私与安全性”中允许打开。卸载时先退出应用，再从 Applications 删除 GenericAgent.app。
  Download GenericAgent-Desktop-macOS.dmg, open it, drag GenericAgent.app to Applications, then launch it from Applications. If macOS says the developer cannot be verified, right-click the app and choose Open, or allow it in System Settings → Privacy & Security. To uninstall, quit the app, then delete GenericAgent.app from Applications.

首次启动 / First launch

首次启动会自动离线准备运行环境（安装依赖），有进度条，完成后进入主界面；之后启动会更快。
The first launch prepares the runtime offline (installs deps) with a progress bar, then opens the main window; later launches are faster.

说明 / Notes

• 想真正对话需在程序内配置模型 / API Key。Configure a model / API key in-app to start chatting.
• Windows Defender 防火墙可能会拦截 127.0.0.1 / localhost 回环连接，导致程序无法启动或连接本机服务；请允许 GenericAgent.exe 和随包的 python.exe 通过防火墙后重启。Windows Defender Firewall may block the local loopback connection; allow GenericAgent.exe and the bundled python.exe through the firewall, then restart the app.
• Windows/Linux 为便携包，可整体移动到任意目录后继续使用。Windows/Linux packages are portable and can be moved as a whole folder.
• Windows/Linux 包内附 readme.txt（中英）。Windows/Linux packages include a bilingual readme.txt.

GenericAgent Desktop Portable v0.2.1

本次更新 / What's new

• Token 用量在每次模型调用后立即持久化，桌面桥接进程崩溃或重启后历史记录仍可恢复。

• 空回复现在会显示本地化提示，不再留下难以理解的空白消息。

• 加强桌面恢复能力和跨平台自动化验证，覆盖损坏数据、进程重启和便携包用户旅程。

• Token usage is persisted after every model call and survives desktop bridge crashes and restarts.

• Empty assistant turns now render a localized explanatory message instead of a blank response.

• Desktop recovery and cross-platform automation now cover corrupted data, process restarts, and portable-package journeys.

下载与校验 / Download and verification

每个平台均提供安装包及对应的 .sha256 文件。下载两者后可校验文件完整性：

sha256sum -c <package>.sha256

Each platform includes the package and its matching .sha256 file. Download both and verify the package before installation.

• Windows: 解压 ZIP，运行 GenericAgent.exe。
• Linux: 解压 tar.gz，为 AppImage 添加执行权限后启动。
• macOS: 打开 DMG，将 GenericAgent.app 拖入 Applications；若 Gatekeeper 阻止启动，请使用 DMG 内的 open_anyway.command。

所有包均内置 Python、运行时依赖、桌面桥接服务和静态前端资源，无需另行安装 Python。

v0.2.0 — Desktop Client Stabilization

Desktop Client Stabilization

从 v0.1.0 (scaffold) 到完整可用的桌面客户端。

Features

• 完整 React 前端：Vite + Semi UI + Zustand，4 大功能域（Chat / Services / Collab / Token）
• 跨平台 shell：macOS overlay titlebar + Windows frameless chrome
• Per-session 模型绑定：前后端分离，每个会话独立模型选择
• Conductor 协作页：多代理编排 UI，独立模型配置
• Token 用量统计：历史记录 + 实时追踪
• 日志系统：LogTail/LogView 组件，进程日志标签页

Platform Support

• macOS：系统流量灯集成，原生拖拽
• Windows：自绘标题栏，close-to-tray，portable E2E 测试套件
• Bootstrap 状态机：failure code 分类 + 恢复 UI

Architecture

• Bridge 双通道（HTTP 命令 + WS 事件），session 持久化为独立 JSON
• 模型路由隔离：session / global / conductor 三级绑定
• Upstream sync with GenericAgent core (零冲突合并)

Documentation

• DESIGN.md：产品设计规范（功能分区 / 渐进式披露 / 视觉语言 / 组件规范）
• spec/：microcopy 契约 / 本地仓库连接 / 记忆导入 / 模型选择

360 commits since v0.1.0

GenericAgent Desktop desktop-portable-v0.2.0

GenericAgent Desktop 桌面版 / Desktop

无需自行安装 Python、无需联网安装依赖、无需源码；首次启动会自动准备内置运行环境。
No separate Python install, no internet for dependencies, no source checkout required; the bundled runtime is prepared on first launch.

安装方法 / Installation

• Windows: 下载 GenericAgent-Desktop-Windows-Portable.zip，解压后双击 GenericAgent.exe 启动。卸载时先退出应用，再双击包内 uninstall.bat，最后删除整个解压目录。
  Download GenericAgent-Desktop-Windows-Portable.zip, extract it, then double-click GenericAgent.exe. To uninstall, quit the app, double-click uninstall.bat, then delete the extracted folder.
• Linux: 下载 GenericAgent-Desktop-Linux-Portable.tar.gz，解压后执行 chmod +x GenericAgent.AppImage，再运行 ./GenericAgent.AppImage。卸载时先退出应用，再运行 ./uninstall.sh，最后删除整个解压目录。
  Download GenericAgent-Desktop-Linux-Portable.tar.gz, extract it, run chmod +x GenericAgent.AppImage, then launch ./GenericAgent.AppImage. To uninstall, quit the app, run ./uninstall.sh, then delete the extracted folder.
• macOS: 下载 GenericAgent-Desktop-macOS.dmg，双击打开 DMG，把 GenericAgent.app 拖入 Applications，之后在“应用程序 / Applications”中启动。若出现“无法验证开发者”等提示，先双击 DMG 内的 open_anyway.command，再启动。卸载时先退出应用，再从 Applications 删除 GenericAgent.app。
  Download GenericAgent-Desktop-macOS.dmg, open it, drag GenericAgent.app to Applications, then launch it from Applications. If macOS says the developer cannot be verified, double-click open_anyway.command inside the DMG first, then launch again. To uninstall, quit the app, then delete GenericAgent.app from Applications.

首次启动 / First launch

首次启动会自动离线准备运行环境（安装依赖），有进度条，完成后进入主界面；之后启动会更快。
The first launch prepares the runtime offline (installs deps) with a progress bar, then opens the main window; later launches are faster.

说明 / Notes

• 想真正对话需在程序内配置模型 / API Key。Configure a model / API key in-app to start chatting.
• Windows/Linux 为便携包，可整体移动到任意目录后继续使用。Windows/Linux packages are portable and can be moved as a whole folder.
• Windows/Linux 包内附 readme.txt（中英）。Windows/Linux packages include a bilingual readme.txt.