让 WorkBuddy 与 Qoder 的国内版、国际版在同一台电脑上和平共处
🛠️ 一键修复更新后的资源抢占 | 🛡️ 后台守护自动纠回 | 🧹 勾选式缓存清理 | 📦 免安装单文件 exe
Windows 10 / 11 · 免安装 · 无需管理员 · 不联网
同一个软件装两个版本,本来是为了分别登录两个账号;结果每次更新,后更新的那个就把前一个的资源抢走。
双版共存管家 是面向「同一款软件的国内版与国际版共存」场景的修复工具,目前覆盖两套软件:
- WorkBuddy:CN 5.9.3 与 AI 国际版 5.9.4
- Qoder:中国版 0.5.2 与国际版 0.5.7
它做三件事:体检(8 盏灯看清哪里被抢)→ 一键修复(按约定归属写回)→ 后台守护(8 秒轮询,被抢占自动纠回)。另带每日签到、无损迁移、按项勾选的缓存清理等辅助功能。
Note
先说清楚边界:本工具不是让 WorkBuddy 与 Qoder 互相共存 —— 两者本来就互不相干。 它解决的是 WorkBuddy 的国内版 ↔ 国际版、Qoder 的国内版 ↔ 国际版 这两组「同门兄弟」互相抢资源的问题。
| 维度 | 说明 |
|---|---|
| 🎯 只改该改的 | 只写 HKCU 注册表与用户目录,不碰系统目录、不删用户数据;陈旧安装包是移动归档而不是删除 |
| 🔍 先看清再动手 | 启动即体检,8 盏灯分列 WorkBuddy 侧与 Qoder 侧,红灯项一目了然 |
| 🛡️ 守护兜底 | 更新器每次都会重写共享指向,手动修一次不够;开机守护在 8 秒内纠回 |
| 📦 零依赖 | 单文件 exe,自带 Python 与 tcl/tk 运行时,免安装、无需管理员、不联网 |
| ♻️ 可回退 | 归档包与旧 manifest 备份都保留,需要时放回即可 |
两版是同一套代码、不同发行版,但有若干全局资源没有按产品隔离,谁最后写谁生效。
| 资源 | 冲突表现 | 本工具的处理 |
|---|---|---|
更新器缓存%LOCALAPPDATA%\@genieworkbuddy-desktop-updater\installer.exe |
两版共用同一路径,更新时残留另一版安装包 → 竞态 / 装错版本 | 移动归档到程序目录 .updater-archive(不删除,可回退) |
URL 协议buddy-app:// |
两版都注册同名 scheme,后更新者覆盖唤起目标 | 固定回约定版本;守护自动修回 |
| MSIX 分享目标 Identity | 两版同名 WorkBuddyShareTarget,后装覆盖 |
仅影响「分享到」,不在处理范围 |
另有 ~/.workbuddy-key-fallback 共享凭证目录,只读观察,不改动。
| 资源 | 冲突表现 | 本工具的处理 |
|---|---|---|
共享 manifest~/.qoder/browser-connector/com.qoder.app.connector.json |
两版扩展 ID 都指向同一个 host,path 只能写一个 |
指向版本较新那版的 host 副本,同时保留两个 allowed_origins |
host 副本hosts/<启动器 sha256>/ |
两版启动器代际不同(CN 0.5.2 / 国际版 0.5.7),谁最后启动写谁 | 以版本号较大者为基准代际,缺失时自动补建 |
Chrome / EdgeNativeMessagingHosts 注册 |
指向错误 manifest 时浏览器扩展连不上 | 写回 HKCU 正确路径 |
中继记录clients/qoder-<uuid>.json |
进程退出后留下失效记录 | 「清理垃圾」中作为独立一项勾选,连同旧代际 host 一起归档到 qoder-backups |
Tip
两版版本号不同期间,连接器会在两边启动时来回切换,这是提示而不是错误;两边升到同一版本并各启动一次后自然收敛。
8 盏灯分左右两组:左列 WorkBuddy(两个发行版的安装完整性、buddy-app:// 归属、更新器缓存),右列 Qoder(两版版本与运行状态、连接器 host 代际、Chrome / Edge 注册)。全绿即共存正常;图中那条提示是 Qoder 两版版本号不同(0.5.7 / 0.5.2),属信息提示。
| 区域 | 内容 |
|---|---|
| 主按钮 | 一键修复(蓝色)与 WorkBuddy 每日签到(绿色) |
| 功能按钮 | 刷新状态、安装前检查、迁移到其他盘、查看已安装、清理垃圾、账号与 Token —— 每个按钮都有名称与一行说明 |
| 清理窗口 | 扫描后列出全部缓存/日志项:分组显示、逐项显示占用与内容说明,可全选 / 全不选 / 单项勾选;软件运行中的项灰显禁用;Qoder 残留单独一项标注「归档,不删除」 |
| 选项行 | buddy-app:// 归属(CN / AI)、后台守护、开机自启 |
| 日志区 | 每次动作留痕,同时写入 run.log |
「清理垃圾」不再是一键全清:先扫出清单,每项写明是什么内容、删了会怎样,勾选后才清理;正在运行的软件对应项会被禁用,退出后再点一次即可清干净。
| 功能 | 说明 |
|---|---|
| 一键修复 | WorkBuddy 修协议归属 + 归档陈旧缓存;Qoder 修 manifest / host 代际 / 浏览器注册;完成后自动复检并弹结果 |
| 刷新状态 | 重新检测 8 盏状态灯(软件、协议归属、更新缓存、连接器与浏览器注册) |
| WorkBuddy 每日签到 | 独立绿色按钮:自动发现 token → 查今日状态 → 未签到则直接签到,按账号分行汇总;无 token 时弹窗引导手动填写,保存后自动继续 |
| 迁移到其他盘 | 勾选软件本体 / 数据目录 → 校验目标盘与可写性 → 复制 → 校验文件数 → 原目录改名 .bak → 建立目录联接 → 探针验证;进度条显示当前项与阶段,失败自动回滚、不删任何文件。路径全部实测(注册表 / product.json / 特征文件 / 会话 cwd) |
| 查看已安装 | 扫描本机所有 WorkBuddy / Qoder 安装,列出产品名、版本、路径、是否运行;Qoder 还会列出 .qoder-versions 下未在用的历史版本 |
| 安装前检查 | 两套软件一次查完:另一版是否仍在运行、更新器缓存是否残留、Qoder manifest 与 Chrome/Edge 注册、系统盘与软件盘剩余空间、各版当前版本与安装位置;给出「可以安装 / 建议先处理」结论 |
| 清理垃圾 | WorkBuddy 国内/国际版 + Qoder 国内/国际版:日志、渲染缓存、浏览器/GPU/代码缓存(白名单目录内容,保留目录)。先扫出勾选清单,每项标注大小与内容说明,可逐项挑选或全选/全不选,只清选中的;运行中的软件对应项灰显禁用。Qoder 旧代际 host 副本与失效中继记录归档到 qoder-backups(不删除,可找回)。路径按各版本实测发现 |
| buddy-app 协议归属 | 单选国内版 / 国际版,决定 buddy-app:// 由谁接管(默认 CN) |
| 后台守护 | 窗口开着时每 8 秒检测两套软件各自的共享指向,被抢占自动修回(只修指向,不碰缓存、不做清理) |
| 开机自启 | 写 HKCU Run,开机以无窗口守护常驻,更新完不用手动点 |
- 下载:从 Releases 取
WBCoexist-v*.exe(单文件),或WBCoexist-portable-*.zip(便携版) - 运行:双击
双版共存管家.lnk或WBCoexist.exe(GUI 程序,不会弹命令行窗口)。启动即自动体检,看 8 盏灯 - 修复:有红灯就点「一键修复」,完成后自动复检;按钮都带一行说明,看不懂名字时看副标题
- 清理:需要腾空间时点「清理垃圾」,在清单里勾选要清的缓存/日志项再开始;运行中的软件对应项会灰显,退出后再清一次即可
无需安装、无需管理员权限、无需联网。
Note
命令行入口 WBCoexist.bat 只作为脚本调用的备用入口,双击会短暂闪一个 cmd 窗口;日常启动请用快捷方式或 exe 本体。所有耗时操作(迁移、账号/签到、安装前检查、已安装检测、一键修复)都在后台线程执行,按钮会置灰并显示进度,不会卡住界面。
| 版本 | 说明 | 适用 |
|---|---|---|
| 单文件 exe | 约 14 MB,双击即用 | 图省事;个别杀软会误报(见 FAQ) |
| 便携版 zip | 解压后约 33 MB,整个文件夹一起用 | 杀软环境;不自解压,误报明显更少 |
Warning
便携版必须连同 _internal 文件夹一起移动,只拷 exe 会启动失败。
| 适合 | 不适合 |
|---|---|
| 同时装了 WorkBuddy CN + AI 国际版 | 只装了一个版本 |
| 同时装了 Qoder 中国版 + 国际版 | macOS / Linux |
| 更新后扩展连不上、深度链接跳错版本、装错包 | 期望从根上消除冲突(根因在应用内部,本工具是自动纠偏) |
无窗口运行,结果同时写入文本文件:
| 参数 | 作用 |
|---|---|
--selftest |
两套软件的完整体检 + 修复预览(写 selftest.txt) |
--qoder-check |
Qoder 完整诊断 JSON(写 qoder-cli.txt) |
--qoder-fix |
立即修复 Qoder 共享连接器 |
--qoder-clean |
把 Qoder 孤儿 host 副本与失效中继记录归档到 qoder-backups |
--daemon |
无窗口后台守护(开机自启用的就是它) |
--smoke |
构建 GUI 后自动关闭,用于打包后自检 |
--accounts |
列出本机账号与各账号会话数(写 accounts.txt) |
--move-sessions <源> <目标> [--apply] |
跨账号迁移会话归属;不带 --apply 只预演 |
--checkin-status |
自动发现全部账号 token,逐个查询今日签到状态与积分 |
--checkin |
同上,并对未签到的账号执行签到(写 checkin.txt) |
- 安装前:点「安装前检查」—— 查另一版是否还在跑、缓存是否残留、manifest / 浏览器注册是否完好、磁盘够不够,给出「可以安装 / 建议先处理」
- 安装 / 更新:正常走安装器,另一版务必先完全退出
- 安装后:守护在 8 秒内检测到程序被替换,自动全量修复;也可手动点「一键修复」
- Qoder 两版同版本后:各启动一次,让连接器代际收敛
会删我的文件吗?
修复和迁移都不删文件:只写 HKCU 注册表与用户目录;陈旧的更新器安装包移动归档到程序目录 .updater-archive\,Qoder 旧代际 host 与失效中继记录归档到 %LOCALAPPDATA%\WBCoexist\qoder-backups\cleanup-*,需要时可放回。
「清理垃圾」是唯一的删除操作,但有明确边界:
- 只清空白名单缓存/日志目录里面的文件:
logs、cache、Cache、Code Cache、GPUCache、Dawn 缓存、Crashpad;目录本身保留,软件会自动重建; - 配置、会话、数据库与登录态(
Local Storage/IndexedDB/Network)一律不碰; - 清什么由你在清单里勾选决定,不勾就不动;软件运行中的项默认灰显禁用,退出后再清即可。
需要管理员权限吗? 不需要。全部操作在 HKCU 与用户目录内完成。
更新后还要再点一次吗? 开了「开机自启」(后台守护常驻)就不用。否则更新后点一次「一键修复」即可。
为什么不能彻底根治? 共享路径写在应用内部,改不了。本工具做的是「每次被抢走就自动纠正」,属于缓解而非根治。
支持哪些系统? Windows 10 / 11 x64。macOS、Linux 不适用。
杀软报毒怎么办?
展开:为什么会被报,以及三种处理方式
PyInstaller 单文件 exe 运行时会把自身解压到 %TEMP%\_MEIxxxx 再执行,这个行为是国产杀软启发式引擎的高发误报点;文件又没有数字签名,容易被判可疑。
按顺序试:
- 优先用便携版:
portable\WBCoexist\WBCoexist.exe,不再自解压,误报概率显著低于单文件。把整个portable\WBCoexist文件夹加进信任目录,或直接在该目录内双击运行。 - 单文件被拦截时:把
WBCoexist.exe加进「信任区」;若已被隔离,先到「恢复区」恢复再添加。 - 提交误报:说明用途(本机双版本共存修复工具、源码可查、只写 HKCU 与用户目录),附 SHA-256。每次重新打包哈希都会变,需要重新提交。
已做的降低误报措施:嵌入完整版本资源(1.6.0.0)、自定义 manifest(asInvoker,不请求管理员)、--noupx 禁用压缩;
行为侧也不再启动 tasklist(改用 Toolhelp 快照枚举进程)、Qoder 残留改为移动到 qoder-backups 而不是删目录。
实在被拦又不想加白,可直接跑源码(不产生 exe):双击 WBCoexist-FromSource.bat。
| 层 | 选型 |
|---|---|
| GUI | Python 3.10 + Tkinter(无第三方 UI 依赖) |
| 打包 | PyInstaller 6.22.3,onefile + onedir,--noupx,嵌入版本资源与 asInvoker manifest |
| 注册表 | winreg,只写 HKCU |
| 进程检测 | Win32 Toolhelp 快照(ctypes 直接调用,不启动 tasklist) |
| CI | GitHub Actions(windows-latest),tag 触发构建与发版 |
| 凭据解密 | cryptography 的 AES-256-GCM(解 WorkBuddy $wbEncrypted 信封) |
| Qoder 签名 | qosy.py 纯 Python 实现 AES-128-CBC / RSA PKCS#1 v1.5 / md5(零依赖,已通过官方向量,暂未接入运行时) |
WBCoexist/
├── WBCoexist.pyw GUI 主程序(--daemon / --selftest / --qoder-* / --smoke)
├── wbcore.py WorkBuddy 核心逻辑(含 run_hidden 子进程无窗口封装)
├── qoder.py Qoder 核心逻辑(检测 / 修复 / 清理 / 守护)
├── migrate.py 位置探测 + 无损迁移
├── cleaner.py 缓存/日志清理(白名单 + 动态路径 + 逐项勾选 + 每项说明 + 运行中禁用)
├── accounts.py 会话/账号读取与迁移
├── checkin.py 签到状态与签到
├── wbtoken.py WorkBuddy 运行时取钥 + 备份 token 解密
├── qosy.py Qoder COSY 签名(纯 Python AES/RSA/md5;官方向量已通过,暂未接入)
├── wd_key.js 取钥用的内联 JS 源(运行时以 -e 传入,不依赖外部文件)
├── tests/ 6 组 unittest(代际选择 / 安装监控 / 已安装 / 迁移 / 签到 / 清理)
├── CODEGRAPH.md 模块依赖、数据流与红线索引
├── 双版共存管家.lnk 启动快捷方式(双击无黑窗;同时放入开始菜单)
├── WBCoexist.bat 脚本调用备用入口(双击会短暂闪 cmd 窗口)
├── WBCoexist-FromSource.bat 用本机 Python 跑源码(杀软拦截时的备用入口)
├── WBCoexist-Daemon.bat 直接启动无窗口后台守护
├── WBCoexist-SelfTest.bat 命令行自检
├── version_info.txt 打包用版本资源
├── app.manifest 打包用 manifest(asInvoker)
├── app.ico 图标
├── config.json 配置(primary / guard / autostart)
├── CHANGELOG.md 更新日志
├── docs/
│ ├── icon.webp README logo
│ ├── screenshot.webp 主界面截图
│ └── cleanup.webp 清理勾选清单截图
├── tools/
│ ├── verify_build.py CI 产物静态校验
│ └── extract_changelog.py 从 CHANGELOG 提取 Release note
└── .github/workflows/ 自动构建发布流程
在仓库根执行,参数全部相对路径:
python -m PyInstaller --noconsole --onefile --clean --noupx --name WBCoexist ^
--icon app.ico --version-file version_info.txt --manifest app.manifest ^
--paths . --hidden-import wbcore --hidden-import qoder ^
--hidden-import migrate --hidden-import accounts --hidden-import checkin ^
--hidden-import wbtoken --hidden-import cleaner --hidden-import cryptography ^
--distpath dist/onefile --workpath build/onefile --specpath . WBCoexist.pywImportant
--specpath 必须指向仓库根(.)。PyInstaller 按 spec 所在目录解析 --icon / --version-file / --manifest 的相对路径,spec 放进子目录会 FileNotFoundError。
推 v* 标签即触发:构建 onefile + onedir → 打包 zip → tools/verify_build.py 静态校验 → 从 CHANGELOG.md 提取对应版本作为 Release 正文 → 发布。
git tag v1.6.1 && git push origin v1.6.1模块依赖、数据流与改动红线见 CODEGRAPH.md(新增功能前建议先读)。
CI 只构建与静态校验,不跑
--selftest/--smoke—— 源码里的安装路径是本机的,runner 上不存在。
| 计划 | 说明 |
|---|---|
| Qoder 自动签到 | qosy.py 签名已通过官方向量,待接 campaigns/claim 活动 API 与凭据管理器读取 |
| MSIX 分享目标 | 处理 WorkBuddyShareTarget 同名冲突(需动 Appx 包注册,评估中) |
| 英文 README | 公开后补 README.en.md 与语言切换 |
| 配置界面 | 归档目录、检测间隔等在 GUI 内可改 |
Issue 与 PR 都欢迎。提交前请:
- 跑一遍
python tools/verify_build.py dist(如动了打包)或--selftest(如动了检测逻辑) - 改动行为请同步
CHANGELOG.md - 提交信息用
feat:/fix:/docs:/refactor:前缀
本项目尚未附带 LICENSE,即默认保留全部权利:可阅读与运行,但未经授权不得二次分发或商用。若希望允许他人使用与贡献,建议补一份 LICENSE(MIT 与当前用法最匹配)。
本工具会修改 HKCU 注册表并移动用户目录下的文件,虽已做归档而非删除,使用前仍建议自行备份相关配置。所有改动均可手工回退:陈旧安装包归档在程序目录的 .updater-archive\,Qoder 残留归档在 %LOCALAPPDATA%\WBCoexist\qoder-backups\(实际路径以日志为准)。「清理垃圾」删除的只是白名单缓存/日志目录内容,软件会自动重建。因使用本工具造成的任何损失,作者不承担责任。
当前版本 1.6.0。完整记录见 CHANGELOG.md,发版时 CI 自动取对应版本段落作为 Release 正文。
| 版本 | 要点 |
|---|---|
| 1.6.0 | 勾选式缓存清理、一键签到独立按钮、GUI 重做(双栏状态卡 / 两行功能卡 / 后台线程)、子进程无黑窗、启动快捷方式 |
| 1.5.0 | 位置探测(实测证据)+ 无损迁移(零删除、可回滚) |
| 1.4.0 | 已安装检测:扫描本机全部 WorkBuddy / Qoder 安装与历史版本 |
| 1.3.0 | 安装前检查 + 安装完成自动修复(mtime 监控) |
| 1.2.1 | Qoder host 代际选择改为按版本号比较,去掉隐性国别优先 |
| 1.2.0 | 安装位置自动发现,不再绑定本机路径 |
| 1.1.1 | 修复 Qoder 未运行时启动崩溃 |
| 1.1.0 | 新增 Qoder 双版本共存;8 盏灯;CI 自动发版 |
| 1.0.0 | 首次发布:WorkBuddy CN / AI 双版本共存 |
| 版本 | 日期 | 要点 |
|---|---|---|
| 1.6.0 | 2026-11-11 | 新增「清理垃圾」(WorkBuddy/Qoder 双版本缓存日志,勾选清单逐项选择);界面重做(渐变头部 + 双栏状态卡 + 带说明的功能按钮);新增「WorkBuddy 每日签到」按钮;子进程全部隐藏控制台;耗时操作后台化 + 忙碌状态;迁移窗口新增进度条与目标校验;新增快捷方式启动 |
| 1.5.0 | 2026-11-11 | 新增位置探测(实测证据)与无损迁移(零删除 + 可回滚) |
| 1.4.0 | 2026-11-11 | 新增「已安装检测」,列出本机全部安装与 Qoder 历史版本目录 |
| 1.3.0 | 2026-11-11 | 新增安装前检查(6+ 项)与安装完成自动修复(mtime 检测) |
| 1.2.1 | 2026-11-11 | Qoder host 选择改为确定性规则,不再隐性偏向国际版;新增回归测试 |
| 1.2.0 | 2026-11-11 | 安装位置自动发现(配置 → 注册表 → 默认路径),不再绑定本机路径 |
| 1.1.1 | 2026-11-11 | 修复 Qoder 未运行时启动崩溃(KeyError: 'qoder.exe') |
| 1.1.0 | 2026-11-11 | 新增 Qoder 双版本共存;8 盏灯;CI 自动发版;更名「双版共存管家」 |
| 1.0.0 | 2026-11-09 | 首次发布:WorkBuddy CN / AI 双版本共存、一键修复、后台守护 |

