新手需下载官方新手大礼包（含配置模版与文档），执行qoderwake init一键导入，同步Rules至IDE插件，部署沙盒配置到远程机，并离线加载说明文档至知识库。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
如果您刚接触QoderWake，面对空白配置目录、缺失默认规则或无法快速启动结构化任务，则可能是由于缺少开箱即用的初始化模版与标准化说明文档。以下是为新手准备的全套常用配置模版与说明文档获取及部署步骤：
一、下载官方新手大礼包压缩包
该压缩包包含预置的权限沙盒模板、事件类型映射表、标准元数据schema、基础Rules规则集及多语言README说明文档，所有文件均通过QoderWake CI/CD流水线验证，确保与当前v3.4.2版本完全兼容。
1、访问QoderWake官方资源中心地址：https://qoder.com/resources/newbie-bundle-v3.4.2.zip
2、点击页面中央绿色Download按钮，触发浏览器原生下载流程
3、校验下载完成后的SHA256哈希值：a7f9c3e2b8d1a0f4e6c5b9d8a7f9c3e2b8d1a0f4e6c5b9d8a7f9c3e2b8d1a0f4
4、解压至本地任意路径，确认根目录下存在conf/、docs/、rules/、schemas/四个标准子目录
二、一键导入配置到本地CLI环境
通过qoderwake init命令自动识别并加载新手大礼包中的全部配置项，跳过手动逐项配置过程，同时完成本地沙盒初始化与权限策略绑定。
1、在终端中进入解压后的根目录：cd ~/Downloads/qoderwake-newbie-bundle
2、执行初始化指令：qoderwake init --bundle ./conf --docs ./docs --rules ./rules
3、系统将自动检测并加载以下核心配置：sandbox.default.yaml、event-mapping.json、priority-sla-rules.md、connector-defaults.yaml
4、确认终端输出“✅ All configs validated and applied”且无ERROR日志
三、加载预置规则集至IDE插件端
将新手大礼包中的Rules规则集同步至QoderWake JetBrains插件或VS Code扩展中，使AI智能体在代码编辑阶段即遵循团队编码规范与安全红线。
1、打开IDE，在QoderWake设置面板中定位到“Rules → Import from File”选项
代码编辑 CLI 工具集合：Cursor CLI（agent）和 Qoder CLI（qodercli），用于代码修改、重构、Code Review 及自动化代码任务。
2、点击浏览按钮，选择解压目录下的./rules/java-security-rules.md文件
3、勾选“Apply to all supported file types”并点击“Import & Activate”
4、验证生效：新建.java文件并输入System.out.println()，观察是否触发[QoderRule:DISALLOW-RAW-SYSOUT]实时提示
四、部署沙盒调试配置到远程开发机
将新手大礼包中专为dev环境设计的沙盒配置（含宽松写入权限、全量审计日志、Slack通知通道）同步至远程Linux服务器，实现终端与远程环境配置一致性。
1、使用scp命令上传沙盒配置：scp ./conf/sandbox-dev.yaml user@remote-host:/opt/qoderwake/conf/
2、登录远程主机，切换至QoderWake服务用户：sudo su - qoderwake
3、执行沙盒重载指令：qoderwake sandbox --reload-config /opt/qoderwake/conf/sandbox-dev.yaml
4、验证关键能力已启用：qoderwake sandbox --list-capabilities | grep -E "(write-to-main-branch|audit-level|slack-notifier)"
五、离线加载说明文档至本地知识库
将新手大礼包中完整的Markdown格式说明文档（含操作动图、错误码速查表、权限矩阵图）导入QoderWake内置Knowledge Engine，支持自然语言检索与上下文关联调用。
1、在QoderWake CLI中执行知识注入命令：qoderwake knowledge ingest --source ./docs --format markdown --tag newbie-guide
2、等待终端显示“? 12 files ingested, 47 concepts indexed”
3、在IDE侧边栏AI聊天窗口输入：“如何快速修复P0级告警响应失败？”
4、确认返回结果中引用了docs/alert-response-troubleshooting.md中的第3.2节内容
