QoderWake多版本并行运行需五重隔离：一、独立安装路径与二进制重命名；二、配置与数据目录分离；三、网络端口及监听地址唯一分配；四、Connector凭证按命名空间隔离；五、环境变量限定于启动脚本作用域。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
如果您在开发或运维QoderWake相关系统时，需同时运行多个版本（如v1.0.2与v1.2.7）以验证策略兼容性、Connector行为差异或数字员工上下文迁移效果，但发现版本间出现命令冲突、配置覆盖、端口抢占或Agent实例混杂，则说明多版本共存环境未做隔离。以下是实现QoderWake多版本并行运行且互不干扰的配置方法：
一、独立安装路径与二进制命名隔离
通过物理路径分离与可执行文件重命名，确保各版本启动入口唯一，避免PATH中同名qoderwake命令被覆盖或误调用。
1、为v1.0.2创建专用安装目录：C:\qoderwake\v1.0.2\，解压或安装时指定该路径，不勾选“添加至系统PATH”。
2、进入该目录，将主程序重命名为qoderwake-v102.exe；同理，为v1.2.7创建C:\qoderwake\v1.2.7\并重命名为qoderwake-v127.exe。
3、在PowerShell中分别测试：执行C:\qoderwake\v1.0.2\qoderwake-v102.exe --version与C:\qoderwake\v1.2.7\qoderwake-v127.exe --version，确认输出版本号无误且互不影响。
4、如需全局调用，可为每个版本单独添加对应路径至用户级PATH（非系统级），例如追加C:\qoderwake\v1.0.2\与C:\qoderwake\v1.2.7\，但绝不添加公共bin目录。
二、配置目录与运行时数据空间隔离
不同版本必须使用完全独立的配置、日志与缓存目录，防止策略快照、本地凭证或沙盒状态交叉污染。
1、为v1.0.2创建专属配置根目录：C:\qoderwake\config-v102\，并在首次启动时通过命令行参数指定：qoderwake-v102.exe --config-dir C:\qoderwake\config-v102\。
2、为v1.2.7创建对应目录：C:\qoderwake\config-v127\，启动时传入--config-dir C:\qoderwake\config-v127\。
3、检查各自配置目录下是否生成独立的config.yaml、policy-snapshot.json与logs\子目录，确认无文件共享或硬链接。
4、若使用服务模式，须为每个版本注册独立Windows服务名，例如QoderWake-Agent-v102与QoderWake-Agent-v127，并分别绑定不同HTTP管理端口（如8443与8444）。
三、网络端口与进程监听地址分离
默认情况下，QoderWake各版本均尝试监听8443端口，导致后启动版本因端口占用而失败。必须显式分配唯一监听地址与端口组合。
1、编辑v1.0.2的config-v102\config.yaml，设置：server: { host: "127.0.0.1", port: 8443 }。
代码编辑 CLI 工具集合：Cursor CLI（agent）和 Qoder CLI（qodercli），用于代码修改、重构、Code Review 及自动化代码任务。
2、编辑v1.2.7的config-v127\config.yaml，设置：server: { host: "127.0.0.1", port: 8444 }。
3、启动后分别访问https://127.0.0.1:8443/ui与https://127.0.0.1:8444/ui，确认两套Web控制台均可独立加载且显示对应版本号。
4、检查任务管理器中两个进程的命令行参数，确认各自监听端口未被覆盖或继承自环境变量。
四、Connector凭证与策略快照逻辑隔离
即使服务端策略回滚至旧版，若客户端本地缓存了新版本的Connector OAuth Token或API Key，仍可能触发越权调用或认证失败。需强制区分凭证存储域。
1、在v1.0.2配置中，于config-v102\config.yaml内添加字段：connector_storage_namespace: "v102-production"。
2、在v1.2.7配置中，设置对应字段为：connector_storage_namespace: "v127-staging"。
3、执行一次完整凭证刷新：对v1.0.2运行qoderwake-v102.exe connector auth --force，对v1.2.7运行qoderwake-v127.exe connector auth --force。
4、检查各自配置目录下的credentials/子目录，确认生成的token文件名包含对应命名空间前缀，且内容不可互通读取。
五、环境变量作用域限定与启动脚本封装
避免全局环境变量（如QODERWAKE_HOME、NODE_OPTIONS）被多版本共享导致行为漂移，应通过启动脚本限定变量生效范围。
1、为v1.0.2创建批处理文件launch-v102.bat，内容为：set QODERWAKE_HOME=C:\qoderwake\v1.0.2 & set NODE_OPTIONS=--max-old-space-size=2048 & C:\qoderwake\v1.0.2\qoderwake-v102.exe --config-dir C:\qoderwake\config-v102\。
2、为v1.2.7创建launch-v127.bat，其中QODERWAKE_HOME与内存参数按需调整，并指向对应二进制与配置路径。
3、双击运行各自批处理文件，观察终端输出中是否显示已加载的环境变量值，确认无跨版本泄漏。
4、禁止在系统属性→高级→环境变量中设置任何QoderWake相关变量，所有变量仅存在于批处理会话生命周期内。
