AgentDock 0.1.47

AgentDock 0.1.47

中文

本版本合并 PR #6，改进 Windows 桌面客户端识别与启动，并将 Codex CLI 和 Codex Desktop 分开展示。两者继续共享供应商、MCP 和配置文件，同时修复客户端排序迁移覆盖用户设置的问题。

新增功能

• 新增独立的 Codex Desktop 客户端入口和软件目录条目，与 Codex CLI 共享供应商及 MCP 配置；升级时自动将新入口放在 Codex CLI 后方。
• 支持通过 Windows 开始菜单注册信息识别 Microsoft Store/AppX 客户端，并通过应用身份启动；手动选择应用包内的桌面程序时也会转换为对应的应用启动入口。
• Windows 未检测到独立 Codex CLI 时，可识别 Codex Desktop 附带的公开 CLI，并在终端中启动。

Bug 修复

• 修复 Windows 应用包实体路径或执行别名优先于应用身份，导致桌面客户端无法正确启动或被误认为 CLI 的问题。
• 修复仅安装 Codex Desktop 时，Codex 就绪检查、供应商诊断和 MCP 同步未正确识别其安装状态的问题。
• 修复 Codex Desktop 供应商编辑、激活和配置导入未统一使用 Codex 共享配置的问题。
• 修复读取设置时反复将 Codex Desktop 移回默认位置的问题；排序迁移仅在添加新入口时执行，之后保留用户自定义顺序和可见性。

English

This release merges PR #6 to improve Windows desktop client detection and launching, and lists Codex CLI and Codex Desktop separately. Both clients share providers, MCP settings, and configuration files. It also fixes a client-order migration that could overwrite user preferences.

New Features

• Added a separate Codex Desktop client entry and software catalog item, sharing provider and MCP configuration with Codex CLI. Upgrades place the new entry immediately after Codex CLI.
• Added Microsoft Store/AppX client detection through Windows Start menu registrations and launching through application identities. Manually selecting a desktop executable inside an app package also resolves its registered launch target.
• Added detection of the public CLI bundled with Codex Desktop on Windows as a terminal-launch fallback when no standalone Codex CLI is detected.

Bug Fixes

• Fixed Windows package executable paths or execution aliases taking precedence over application identities, which could prevent desktop clients from launching correctly or misidentify them as CLI clients.
• Fixed Codex readiness checks, provider diagnostics, and MCP synchronization when only Codex Desktop is installed.
• Fixed Codex Desktop provider editing, activation, and configuration imports to consistently use shared Codex configuration.
• Fixed settings reads repeatedly moving Codex Desktop back to its default position. Ordering is migrated only when the new entry is added, preserving subsequent custom order and visibility.

AgentDock 0.1.43

AgentDock 0.1.43

中文

本版本修复 AgentDock 在 Windows 上安装 Codex 后可能启动到内部辅助程序的问题。新版会稳定选择公开的 codex.exe 入口，并自动纠正受影响用户已有的托管客户端记录。

新增功能

• 新增托管 Codex 启动路径自动修复：检测到已有记录指向内部 runner 时，会从原安装目录重新定位公开 CLI 并更新记录，无需卸载或重新安装 Codex。
• 新增确定性的安装包入口排序，精确命名的客户端主程序会优先于带前缀的候选文件。

Bug 修复

• 修复 Windows Codex 安装包中的 codex-command-runner.exe 可能被误判为主程序，导致从 AgentDock 启动时出现 Error: runner: no pipe-in provided 的问题。
• 修复文件系统遍历顺序不同导致 Codex 启动入口选择结果不稳定的问题。
• 排除 codex-command-runner、codex-code-mode-host 和 codex-windows-sandbox-setup 等仅供 Codex 内部使用的辅助程序。

English

This release fixes an issue where AgentDock-managed Codex installations on Windows could launch an internal helper instead of the public CLI. AgentDock now selects the public codex.exe entry point deterministically and repairs affected managed-client records automatically.

New Features

• Added automatic repair for managed Codex launcher paths. When an existing record points to an internal runner, AgentDock locates the public CLI in the original installation directory and updates the record without requiring Codex to be uninstalled or reinstalled.
• Added deterministic package-entry ranking so exact client executable names take priority over prefixed fallback candidates.

Bug Fixes

• Fixed codex-command-runner.exe from the Windows Codex package being mistaken for the main executable, which caused Error: runner: no pipe-in provided when launching Codex from AgentDock.
• Fixed Codex launcher selection varying with filesystem traversal order.
• Excluded internal-only helpers including codex-command-runner, codex-code-mode-host, and codex-windows-sandbox-setup from managed-client executable discovery.

AgentDock 0.1.42

AgentDock 0.1.42

中文

本版本重点改善 Windows 上已安装 AI 客户端的发现能力，覆盖图形界面应用无法继承最新 PATH、包管理器安装目录未进入当前进程环境，以及桌面应用仅注册在系统中的常见情况。检测失败时，用户也可以直接关联现有可执行文件。

新增功能

• 新增 Windows“定位现有安装”入口，可手动选择 Codex、Grok、Claude Code、OpenCode 等客户端的 .exe、.cmd、.bat 或 .com 文件，并可随时取消关联。
• 新增 Windows 用户与系统注册表环境读取，合并最新 PATH，并展开路径中的环境变量。
• 新增 npm、pnpm、Yarn、WinGet、WindowsApps、Scoop、Chocolatey、Volta、Bun、NVM 和 fnm 等常见安装位置扫描。
• 新增 Windows App Paths、卸载信息、常见安装目录和 AppX 包发现，支持直接启动已识别的桌面应用。
• 客户端状态现在会记录手动关联、桌面应用类型和检测来源，便于界面选择正确的启动方式。

Bug 修复

• 修复 AgentDock 从开始菜单启动后因继承的 PATH 过期或不完整，导致已经安装的 Codex、Grok 等命令行客户端显示为“未检测到”的问题。
• 修复仅通过 Windows 注册表或 AppX 安装的客户端无法被识别和启动的问题。
• 修复桌面应用被当作命令行程序在终端中启动的问题，并避免把 .ico 显示图标误判为客户端可执行文件。
• 修复手动选择无效路径或不匹配文件名时仍可能保存关联的问题，现在会先验证绝对路径、文件存在性和客户端名称。

English

This release substantially improves discovery of installed AI clients on Windows. It covers stale or incomplete PATH values inherited by desktop applications, package-manager locations missing from the current process environment, and desktop applications registered only with Windows. Users can also link an existing executable when automatic discovery is insufficient.

New Features

• Added a Windows-only “Locate existing installation” action for manually selecting .exe, .cmd, .bat, or .com files for Codex, Grok, Claude Code, OpenCode, and other supported clients, with an option to remove the link later.
• Added fresh user and machine environment reads from the Windows registry, including PATH merging and environment-variable expansion.
• Added discovery across common npm, pnpm, Yarn, WinGet, WindowsApps, Scoop, Chocolatey, Volta, Bun, NVM, and fnm installation locations.
• Added Windows App Paths, uninstall metadata, common installation-directory, and AppX package discovery with direct desktop-application launching.
• Client status now records manual links, desktop-application type, and detection source so the interface can select the correct launch behavior.

Bug Fixes

• Fixed installed Codex, Grok, and other CLI clients appearing as undetected when AgentDock was launched from the Start menu with a stale or incomplete PATH.
• Fixed clients installed only through Windows registry entries or AppX packages not being detected or launched.
• Fixed desktop applications being launched as terminal commands and prevented .ico display icons from being mistaken for client executables.
• Fixed invalid paths or mismatched executable names being persisted through manual linking by validating absolute paths, file existence, and client names first.

AgentDock 0.1.41

AgentDock 0.1.41

中文

本版本优化左下角当前版本信息的展示，使版本标签更紧凑、格式更明确，并完善发布流程中的版本递增约束。

新增功能

• 当前版本号统一增加 v 前缀，例如 v0.1.41；即使底层版本已经包含前缀，也不会重复显示。
• 开发规范明确要求每次仓库修改都递增应用补丁版本，并同步所有版本文件后再验证和部署。

Bug 修复

• 修复“当前版本”和版本号分别贴近左右两侧、视觉距离过大的问题，现在二者会紧凑居中展示。

English

This release refines the current-version display in the lower-left corner with tighter spacing and clearer formatting, and formalizes version increments in the release workflow.

New Features

• Added a consistent v prefix to the current version, such as v0.1.41, while preventing duplicate prefixes when the underlying value already includes one.
• Documented that every repository modification must increment the application patch version and synchronize all version files before verification and deployment.

Bug Fixes

• Fixed excessive spacing between the “Current version” label and its value; both now appear together in a compact centered row.

AgentDock 0.1.40

AgentDock 0.1.40

中文

本版本新增面向用户的异常上报和 AgentDock 手动更新入口。遇到问题时可以从主界面提交完整执行记录，左下角则会显示当前版本并允许立即检查新版本，同时保留每小时自动检查。

新增功能

• 右上角新增“上报异常”按钮，可一次提交所有尚未上报的执行记录，包括操作步骤、命令参数、标准输出、标准错误和本地动作日志。
• 左下角新增“检测最新版”按钮和当前安装版本展示；检测到新版本后，同一按钮会切换为升级并自动重启入口。
• 为异常上报和手动更新补充处理中、成功、失败和无可用更新反馈，并支持简体中文、繁体中文、英文、日文和德文界面。
• 保留启动时检查和每小时定期检查 AgentDock 更新的原有逻辑。

Bug 修复

• 移除右上角“本机服务已连接”和左下角平台连接状态，避免瞬时连接文案长期显示并占用操作区域。
• 批量上报后会连续清空待上传执行记录，不再每 30 秒只处理一条，减少多条日志等待分析的时间。
• 已成功上报的执行记录不会重复提交；仍在运行的记录会等待完整结束后再上报，避免上传不完整日志。

English

This release adds user-facing issue reporting and a manual AgentDock update entry point. Users can submit complete execution records when troubleshooting, while the lower-left area now shows the installed version and can check for updates immediately without removing the existing hourly checks.

New Features

• Added a “Report issue” button in the upper-right corner that submits every execution record not yet uploaded, including operation steps, command arguments, stdout, stderr, and local action logs.
• Added a “Check latest version” button and installed-version display in the lower-left corner; when an update is available, the same button switches to the update-and-restart action.
• Added in-progress, success, failure, and up-to-date feedback for issue reporting and manual update checks across Simplified Chinese, Traditional Chinese, English, Japanese, and German.
• Preserved the existing startup check and hourly AgentDock update schedule.

Bug Fixes

• Removed the upper-right local-service connection badge and lower-left platform connection status so stale connection text no longer occupies command areas.
• Changed batch reporting to drain queued execution records continuously instead of uploading only one record every 30 seconds, reducing delays when several logs need analysis.
• Prevented successful records from being uploaded again and deferred running records until completion so partial logs are never submitted.

AgentDock 0.1.39

AgentDock 0.1.39

中文

本版本修复 0.1.38 发布包未读取 GitHub Environment 中遥测配置的问题，使执行记录上报和异常重试队列可以连接到已配置的 SkyWalking 服务。

新增功能

• GitHub 三平台发布构建现在关联受管的 APPLE_CERTIFICATE Environment，可读取其中的 OTLP endpoint、secret token 和 service name。
• 新增本机 .env.example，明确 Mac mini 和本地安装包构建所需的三项遥测配置。
• GitHub 标签构建与本地 Universal macOS 构建会在打包前验证遥测配置，缺少任何一项都会立即停止发布。

Bug 修复

• 修复 Environment 级变量未进入构建 job，导致 0.1.38 安装包点击“上报所选”时提示配置未写入的问题。
• 修复 OTLP token 已保存为 Environment secret，但发布工作流因未关联 Environment 而读取到空值的问题。
• 防止遥测配置全部为空时仍成功生成正式发布包，避免执行记录持续留在本地重试队列。

English

This release fixes the 0.1.38 packages not receiving telemetry configuration from the GitHub Environment, allowing operation reports and the exception retry queue to connect to the configured SkyWalking service.

New Features

• GitHub release builds on all three platforms now use the managed APPLE_CERTIFICATE Environment and can access its OTLP endpoint, secret token, and service name.
• Added a local .env.example documenting the three telemetry values required for Mac mini and local installer builds.
• GitHub tag builds and local universal macOS builds now validate telemetry configuration before packaging and stop immediately if any value is missing.

Bug Fixes

• Fixed Environment-scoped variables not reaching the build job, which caused 0.1.38 packages to show a configuration-not-packaged message when reporting a selected operation.
• Fixed the release workflow reading an empty OTLP token even after it was stored as an Environment secret because the job was not associated with that Environment.
• Prevented official packages from being produced with all telemetry values empty, avoiding operation records remaining indefinitely in the local retry queue.

AgentDock 0.1.38

AgentDock 0.1.38

中文

本版本新增基于 OpenTelemetry 数据模型的本地操作记录和异常诊断能力，让客户端安装、Skills 管理等关键流程更容易排查，并支持在明确配置或用户主动操作时上报诊断数据。

新增功能

• 为客户端检测与安装、Skills 安装、启用和卸载等关键工作流记录本地操作、跨度、状态、耗时、命令参数和原始输出。
• 重构诊断页面，支持按分类和状态筛选操作记录，查看追踪详情、合并日志、跨度以及分页命令输出。
• 捕获前端未处理错误、Promise 拒绝和 Rust panic，并以标准 OpenTelemetry 异常字段写入本地诊断数据库。
• 支持从诊断详情手动上报单条操作记录；只有构建时提供完整 OTLP 配置的发布包才会自动上报异常。
• 为 GitHub Actions 发布构建接入可选的 OTLP 端点、令牌和服务名配置，同时保持普通开发构建不携带上报配置。

Bug 修复

• 为重复前端异常增加时间窗口去重，并限制异常消息与堆栈大小，避免错误风暴和超大数据持续占用本地空间。
• 为异常与操作上报增加精确确认、失败重试和退避机制，应用重启后可恢复未完成的上报状态。
• 对上报失败信息进行脱敏，避免认证头、令牌或服务端响应正文写入本地错误记录。
• 数据库写入繁忙时，Rust panic 记录改为非阻塞处理，避免异常捕获路径引发二次卡死。

English

This release adds local operation records and exception diagnostics based on the OpenTelemetry data model, making key workflows such as client installation and Skills management easier to troubleshoot while supporting diagnostic uploads only when explicitly configured or initiated by the user.

New Features

• Added local operations, spans, status, duration, command arguments, and raw output for key workflows including client detection and installation plus Skill installation, enablement, and removal.
• Reworked Diagnostics with operation filtering, trace details, merged logs, spans, and paginated command output.
• Added capture of unhandled frontend errors, rejected promises, and Rust panics using standard OpenTelemetry exception fields in the local diagnostics database.
• Added manual reporting for an individual operation from its diagnostic details. Automatic exception reporting is enabled only in builds with a complete packaged OTLP configuration.
• Added optional OTLP endpoint, token, and service-name configuration to GitHub Actions release builds while keeping normal development builds free of reporting configuration.

Bug Fixes

• Deduplicated repeated frontend exceptions within a time window and bounded exception messages and stack traces to prevent error storms and oversized records from consuming local storage.
• Added exact acknowledgement, retry, and backoff handling for exception and operation uploads, including recovery of unfinished upload state after restart.
• Sanitized upload failures so authorization headers, tokens, and server response bodies are not persisted in local error records.
• Made Rust panic recording non-blocking while the diagnostics database is busy, preventing secondary hangs in the exception path.

AgentDock 0.1.37

AgentDock 0.1.37

中文

本版本将 Skills 管理统一到全局安装模型，新增按安装位置查看、启用和安全卸载的完整工作流，同时修复客户端启动目录回归问题。

新增功能

• 统一扫描 ~/.agents/skills 以及 Claude Code、Grok、OpenClaw、Hermes、OpenCode 和 Antigravity 等客户端的标准 Skills 目录，并将同名 Skill 的多个安装位置合并展示。
• Skills 页面改为探索与详情工作区；详情中可查看已启用客户端、可启用目标、各安装位置以及只读文件列表和文本内容。
• 新安装的 Skill 默认写入全局 ~/.agents/skills，并可在安装时选择同时启用到其他已安装客户端。
• 已安装 Skill 可继续启用到其他客户端；Skills CLI 不可用或未生成目标文件时，会回退为安全的本地目录复制。
• 支持卸载单个安装位置或全部安装位置，并在执行前展示受影响客户端、路径和依赖链接。
• 从 Skills 锁文件读取可信的 GitHub 来源信息，可从详情页直接打开对应仓库。

Bug 修复

• 恢复命令行客户端的项目目录选择器、最近项目菜单和首次启动时的目录弹窗；不再默认使用 AgentDock 数据目录启动客户端。
• 卸载真实目录前会把仍依赖该目录的其他 Skill 符号链接转换为独立副本，避免破坏其余客户端安装。
• 增强 Skill 文件读取和卸载路径校验，拒绝父目录穿越、目录外链接、未知安装位置以及非预期 Agent Skills 目录。
• 修复 macOS 上 /var 与 /private/var 路径别名导致的 Skills 测试误报。

English

This release unifies Skills management around global installations, adds complete per-installation inspection, enablement, and safe removal workflows, and fixes the client launch-directory regression.

New Features

• Unified discovery across ~/.agents/skills and the standard Skills directories used by Claude Code, Grok, OpenClaw, Hermes, OpenCode, and Antigravity, with duplicate installations of the same Skill grouped together.
• Reworked the Skills page into discovery and detail workspaces. Details now show enabled clients, available targets, every installation location, and read-only file listings and text previews.
• New Skills are installed globally in ~/.agents/skills by default and can be enabled for additional installed clients during setup.
• Installed Skills can be enabled for more clients later. If the skills CLI fails or does not create the target, AgentDock falls back to a safe local directory copy.
• Added removal of one installation or all installations, with a confirmation preview of affected clients, paths, and dependent links.
• Trusted GitHub source metadata is read from the Skills lock file so the corresponding repository can be opened from the detail view.

Bug Fixes

• Restored the project-folder picker, recent-project menu, and first-launch folder prompt for command-line clients; clients no longer default to AgentDock's data directory.
• Before removing a real directory, dependent Skill symlinks are converted into independent copies so other client installations remain usable.
• Hardened Skill file and uninstall path validation against parent traversal, links outside the Skill root, unknown installations, and unexpected Agent Skills directories.
• Fixed false Skills test failures on macOS caused by the /var and /private/var path alias.