QoderWake核心数据备份需五步：一、备份用户配置目录；二、导出记忆快照与技能状态；三、保存身份凭证与权限红线；四、备份Connector绑定元数据；五、创建全量恢复校验清单。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
如果您使用QoderWake数字员工并依赖其记忆、技能与个性化配置开展日常任务，则系统崩溃或重装可能导致所有身份设定、上下文记忆、Connector绑定状态及自定义偏好永久丢失。以下是针对QoderWake核心数据的完整备份操作路径：
一、备份QoderWake用户目录下的全部配置数据
QoderWake将全部用户级数据（含身份凭证、长期记忆索引、技能配置、权限红线策略）统一存储于操作系统用户目录下的隐藏配置文件夹中，该路径不随程序重装而保留，必须单独提取。
1、确认当前QoderWake运行状态，执行qoderwake status确保服务已停止。
2、在Windows系统中，打开文件资源管理器，地址栏输入：%APPDATA%\QoderWake\config，全选该目录下所有子文件夹与文件。
3、在macOS系统中，打开终端，执行：cp -r ~/Library/Application\ Support/QoderWake/config /backup/qoderwake_config_$(date +%Y%m%d)。
4、在Linux系统中，执行：tar -czf qoderwake_config_$(date +%Y%m%d).tgz ~/.config/QoderWake/config。
5、将生成的压缩包或文件夹复制至外部存储设备或企业NAS的WORM不可变文件夹中。
二、导出QoderWake内置记忆快照与技能状态
QoderWake的记忆模块采用分层存储架构，仅备份配置目录无法还原对话历史与技能调用上下文。必须通过CLI触发结构化导出，生成可验证、可回滚的快照文件。
1、启动QoderWake CLI终端，执行：qoderwake memory export --format jsonl --output /backup/memory_{{now|strftime:%Y%m%d_%H%M%S}}.jsonl。
2、等待命令返回“Export completed: X records”后，执行：qoderwake skill list --export /backup/skills_state_{{now|strftime:%Y%m%d}}.yaml。
3、检查输出文件中是否包含last_used_at、binding_status、connector_id三项字段，缺失则需重新执行导出。
4、对两个文件执行SHA256校验并记录哈希值：sha256sum /backup/memory_*.jsonl /backup/skills_state_*.yaml > /backup/integrity_checksums_$(date +%Y%m%d).txt。
三、保存QoderWake身份凭证与权限红线配置
QoderWake的身份体系（含角色定义、分工策略、权限红线）以加密凭证形式驻留在本地密钥环中，未同步至云端。若密钥环损坏，数字员工将失去岗位职责边界与安全约束能力。
1、在Windows上，打开Windows凭证管理器，查找名称为QoderWake-Identity和QoderWake-Redline的通用凭证，点击“编辑”，复制“密码”字段全部内容至文本文件。
代码编辑 CLI 工具集合：Cursor CLI（agent）和 Qoder CLI（qodercli），用于代码修改、重构、Code Review 及自动化代码任务。
2、在macOS上，打开钥匙串访问应用，筛选“登录”钥匙串，搜索关键词qoderwake_identity与qoderwake_redline，右键选择“显示密码”，输入系统密码后复制明文内容。
3、在Linux上，执行：secret-tool lookup --all --label "QoderWake Identity"与secret-tool lookup --all --label "QoderWake Redline"，分别保存输出结果。
4、将四组凭证明文内容保存为AES-256加密文件：gpg --cipher-algo AES256 --symmetric --armor identity_and_redline_$(date +%Y%m%d).asc。
四、备份QoderWake Connector绑定元数据
QoderWake通过Connector接入GitHub、Slack、CRM等外部系统，其绑定状态（含OAuth令牌、Webhook签名密钥、API endpoint映射）独立存储于运行时数据库，不包含在常规配置目录中，必须单独提取。
1、停止QoderWake服务后，定位其SQLite数据库文件：Windows为%LOCALAPPDATA%\QoderWake\qoderwake.db，macOS为~/Library/Application Support/QoderWake/qoderwake.db，Linux为~/.local/share/QoderWake/qoderwake.db。
2、执行SQL导出命令：sqlite3 qoderwake.db ".dump connectors binding_metadata" > connectors_backup_$(date +%Y%m%d).sql。
3、验证导出文件首行是否为PRAGMA foreign_keys=OFF;，末行是否含COMMIT;，否则需重新执行。
4、将.sql文件与原始.db文件一同归档，并标注对应QoderWake版本号：QoderWake v2.8.3 — connectors_backup_20260524.sql。
五、创建QoderWake全量恢复校验清单
备份本身无法保证可恢复性，必须建立与生产环境完全一致的离线校验机制，防止因路径变更、权限错误或版本不兼容导致恢复失败。
1、准备一台隔离测试机，安装与生产环境完全相同的QoderWake版本（含补丁号），不启动服务。
2、将步骤一至四中生成的所有备份文件复制至测试机对应路径，执行文件权限修复：chmod 600 *.asc && chmod 644 *.jsonl *.yaml *.sql。
3、运行恢复前置检查脚本：qoderwake backup verify --config-path /backup/qoderwake_config_20260524 --memory-dump /backup/memory_20260524.jsonl。
4、观察输出中是否包含[PASS] Identity signature valid、[PASS] Connector binding schema match、[PASS] Memory record count > 0三项校验通过标识。
