Qoder项目导出与备份需通过三种方式：一、GUI导出ZIP包，保留文件结构及.git目录；二、CLI命令行打包，支持排除规则；三、手动归档并附加元信息与校验值，确保长期存档完整性。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
如果您已完成Qoder项目开发，需将源码导出用于协作、部署或长期归档，则需通过官方支持的打包机制生成结构完整、可复用的源码包。以下是完成该项目导出与备份任务的具体步骤：
一、使用Qoder内置导出功能生成ZIP源码包
该方式通过Qoder桌面端图形界面直接触发项目根目录的全量压缩，保留原始文件结构、隐藏配置文件（如.qoder/）及版本控制元数据（.git/），适用于快速交付给协作方或上传至私有代码仓库。
1、在Qoder主界面左侧文件资源管理器中，右键点击项目根文件夹名称。
2、从上下文菜单中选择“导出为源码包”选项。
3、在弹出对话框中确认导出路径，文件名默认为项目名_YYYYMMDD_HHMMSS.zip，可手动修改但不建议删除时间戳部分。
4、勾选“包含.git目录”复选框（若项目已初始化Git仓库且需保留提交历史）。
5、点击“开始导出”，等待进度条完成并提示“导出成功”，生成文件将位于指定路径。
二、通过Qoder CLI执行命令行打包
该方式适用于CI/CD流水线集成或批量处理多个项目，支持自定义排除规则与压缩参数，生成结果与GUI导出一致但更可控，需提前完成CLI身份绑定。
1、在终端中进入目标项目根目录，确保当前路径下存在qoder.json或.qoder/config.yaml配置文件。
代码编辑 CLI 工具集合：Cursor CLI（agent）和 Qoder CLI（qodercli），用于代码修改、重构、Code Review 及自动化代码任务。
2、执行打包命令：qoder export --format zip --include-git --output ./dist/myproject-src.zip。
3、若需排除node_modules、.DS_Store等非源码内容，添加--exclude "node_modules|*.log|.DS_Store"参数。
4、运行完成后检查./dist/myproject-src.zip文件大小是否合理（通常大于1KB），避免空包误判。
三、手动归档并附加项目元信息
该方式面向需要长期存档或离线审计的场景，除源码外额外注入项目标识、Qoder版本、依赖快照等不可变元数据，形成具备法律效力的交付物凭证。
1、在项目根目录下新建ARCHIVE_METADATA.md文件，填入以下字段：
Qoder版本：v2026.5.20
项目创建时间：2026-04-12T09:15:22Z
最后修改时间：2026-05-23T16:44:01Z
依赖清单哈希：sha256:8a3f7e2d1b9c...
2、执行系统级压缩命令，强制包含元信息文件：zip -r myproject-archive-20260524.zip . -x "*.git/*" -i "*/" "ARCHIVE_METADATA.md"。
3、对生成ZIP文件计算SHA-256校验值：shasum -a 256 myproject-archive-20260524.zip，结果记录于独立文本文件INTEGRITY_CHECKSUM.txt。
4、将ZIP包与CHECKSUM文件一同保存至归档目录，路径格式为：/archive/qoder-projects/2026/Q5/myproject-archive-20260524.zip。
