qoderwake便携版可免安装运行并支持多设备迁移，需使用官方免安装包、禁用自动更新与后台服务、配置独立数据存储路径、启用离线ai核心加载模式，并创建专用启动脚本锁定配置。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
如果您希望在不安装的前提下直接运行QoderWake，或需在多台设备间快速迁移数字员工能力，则可制作QoderWake便携版（Portable）。该版本不写入系统注册表、不修改全局环境变量、所有配置与缓存均保留在指定文件夹内。以下是具体实现步骤：
一、准备基础运行环境
QoderWake便携版依赖于独立的运行时与配置隔离机制，必须使用官方提供的免安装运行包，并确保其与当前系统架构（x64/ARM64）严格匹配。不可混用在线安装器生成的安装目录，否则将触发路径绑定与服务注册行为，失去便携性。
1、访问Qoder官方便携版发布页：https://qoder.com/download/portable
2、根据操作系统选择对应压缩包：Windows用户下载 QoderWake-Portable-win-x64.zip，macOS用户下载 QoderWake-Portable-macos-arm64.tar.gz
3、解压至一个**不含中文、空格及特殊字符**的纯英文路径，例如：D:\QoderWake-Portable 或 ~/Applications/QoderWake-Portable
二、禁用自动更新与后台服务
便携版的核心要求是零系统侵入，因此必须关闭所有可能触发写入系统盘、注册服务或联网校验的模块。这些设置需在首次启动前通过配置文件硬编码锁定，避免GUI界面误操作恢复默认值。
1、进入解压目录，定位到 config\settings.json 文件
2、用文本编辑器打开，将以下字段值全部设为 false：
"auto_update_enabled": false,
"system_service_enabled": false,
"telemetry_upload_enabled": false,
"startup_on_boot": false
3、保存文件，确认文件权限未被系统设为只读
三、配置独立数据存储路径
所有用户数据（含会话记录、知识库索引、本地模型缓存）必须指向便携目录内的子文件夹，禁止使用系统默认路径（如 %APPDATA%、~/Library/Application Support）。此步骤确保拔出U盘后数据完整保留，且在另一台设备插入后立即可用。
1、在便携根目录下新建文件夹：data
2、编辑 config\settings.json，添加或修改字段：
"data_root_path": "./data"
代码编辑 CLI 工具集合：Cursor CLI（agent）和 Qoder CLI（qodercli），用于代码修改、重构、Code Review 及自动化代码任务。
3、启动前手动创建子目录：data\cache、data\sessions、data\knowledge
四、启用离线AI核心加载模式
QoderWake便携版默认尝试连接云端推理服务，若需完全离线运行，必须强制切换至嵌入式轻量模型并禁用远程调用链路。该模式牺牲部分复杂任务能力，但保障无网络环境下的基础Agent响应能力。
1、下载离线模型包：qoderwake-core-offline-v1.3.0.bin，存放于 runtime\models\ 目录
2、编辑 config\settings.json，设置：
"ai_runtime_mode": "offline",
"fallback_to_cloud": false,
"model_path": "./runtime/models/qoderwake-core-offline-v1.3.0.bin"
3、验证模型文件SHA256校验值是否与官网公告一致：a7f9e2d1b8c4f6e5...（完整值见发布页）
五、生成可执行快捷方式并锁定配置
为防止误点安装版入口或GUI设置覆盖便携配置，需创建专用启动脚本，并对关键配置文件实施只读保护。该步骤确保每次双击启动均为纯净便携态，不依赖任何外部环境变量。
1、在便携根目录新建文本文件，命名为 launch-portable.bat（Windows）或 launch-portable.sh（macOS）
2、写入启动命令（Windows示例）：
@echo off
cd /d "%~dp0"
start "" "QoderWake.exe" --no-sandbox --disable-gpu --portable-mode
3、对 config\settings.json 右键→属性→勾选“只读”
4、双击运行 launch-portable.bat，观察控制台输出中是否出现 [PORTABLE MODE ACTIVE]
