首次配置qoderwake需依次完成五步：一、授权麦克风与文件访问、设为开机自启、校准系统时间；二、绑定qoder账号并生成唯一设备码；三、开启本地唤醒并完成声纹校准；四、安装helloqoder skill并验证连通性；五、设置含.git的默认上下文锚点。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
如果您已安装 QoderWake 应用但尚未完成初始配置，可能无法触发本地唤醒、调用 Skill 或执行 Quest 任务。以下是完成首次配置的具体步骤：
一、检查系统权限与基础环境
QoderWake 需要访问麦克风、文件系统及后台持续运行能力，缺失任一权限将导致唤醒失败或功能受限。请确保系统已完成最低环境准备。
1、打开系统设置 → 隐私与安全性 → 检查并开启「麦克风」权限
2、在相同设置页中，启用「文件和文件夹」访问权限，并勾选 QoderWake 所需目录（如桌面、文档、项目根目录）
3、进入「登录项」或「启动项」设置，将 QoderWake 设为开机自启应用
4、确认系统时间与网络时间同步，时区偏差超过5分钟会导致 MCP 协议握手失败
二、绑定主控账户与设备指纹
QoderWake 采用设备级身份绑定机制，首次运行需将本地硬件特征与 Qoder 账户关联，该过程仅执行一次且不可跨设备复用。
1、启动 QoderWake 应用，点击右上角用户图标 → 选择「绑定新设备」
2、使用已注册的 Qoder 账号登录（支持 GitHub / Google 快捷登录）
3、等待约8秒，界面显示「设备指纹生成中…」，此时勿关闭窗口或切换应用
4、成功后弹出提示框，显示形如 QW-7X9F-M2T4-B8KZ 的唯一设备码，该码将用于后续 Skill 权限授权
三、启用本地唤醒引擎
QoderWake 默认禁用语音唤醒以保障隐私，必须手动开启并完成声纹校准，方可响应“Hey Qoder”等指令。
1、进入「设置」→「语音与唤醒」→ 开启「本地唤醒」开关
代码编辑 CLI 工具集合：Cursor CLI（agent）和 Qoder CLI（qodercli），用于代码修改、重构、Code Review 及自动化代码任务。
2、点击「开始声纹训练」，按提示朗读屏幕上随机生成的3组4字短语（如“云启代码”“智构模块”“速验逻辑”）
3、每组朗读需保持环境安静，麦克风距离口部15–25cm，避免佩戴耳机进行校准
4、全部完成后点击「保存并验证」，系统将播放一段测试音频并静默监听10秒，绿色指示灯常亮即表示唤醒就绪
四、加载首个 Skill 并验证连通性
Skill 是 QoderWake 的功能扩展单元，首次配置必须至少启用一个基础 Skill，否则无法调用任何外部工具或执行自动化任务。
1、返回主界面，点击底部导航栏「Skill 市场」
2、搜索关键词 “HelloQoder”，安装官方提供的入门级 Skill（体积＜120KB，无需额外依赖）
3、安装完毕后，在「已启用」列表中找到该项，点击右侧「调试」按钮
4、在调试面板输入指令：/run hello --device QW-7X9F-M2T4-B8KZ，若返回 JSON 格式响应且含字段 "status": "ok"，则 Skill 连通性验证通过
五、配置默认上下文锚点
QoderWake 依赖上下文锚点定位当前工作场景，未设置锚点将导致 AI 无法识别项目结构、文件引用失效、Repo Wiki 无法生成。
1、点击左上角「+ 新建上下文」→ 选择「本地文件夹」
2、浏览并选中一个含 .git 文件夹的代码目录（如 ~/projects/my-first-react-app）
3、在锚点名称栏输入 default-workspace，勾选「设为默认」
4、点击「确认添加」，等待右下角通知显示「索引完成：XX 文件，YY 行代码」，索引状态必须为「完成」而非「进行中」才可进入下一步
