qoderwake安装后必须完成10个初始化设置：一、授予文件与文件夹访问权限；二、绑定github/google账户并启用长期记忆；三、配置github/slack/notion connector；四、加载并启用主干分支修改、删库、客户群发信三项权限红线；五、导入官方skills vault知识库；六、校准vs code/git/python等本地开发环境；七、启用审计日志并指定存储路径；八、在web端查看credits余额后，客户端设20%预警阈值；九、设定数字程序员或数字流程专员角色并绑定对应技能子目录；十、执行git仓库分析quest任务闭环验证全部模块。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
如果您已完成QoderWake的安装，但尚未配置关键运行环境，则可能面临权限缺失、技能失效、记忆丢失或操作被拦截等问题。以下是QoderWake安装后必须完成的10个初始化设置：
一、授予系统级文件与文件夹访问权限
QoderWake需读取项目源码、日志、配置文件及本地文档才能执行分析与修复任务，未授权将导致“Permission denied”错误或空结果返回。
1、打开系统设置→隐私与安全性→文件与文件夹
2、在应用列表中找到QoderWake，点击右侧「详细信息」
3、勾选所有文件夹，并额外启用下载文件夹与桌面
二、绑定主身份账户并启用长期记忆
QoderWake的身份与记忆模块依赖统一账户体系，脱离账户将导致历史会话、任务上下文、技能偏好全部重置。
1、启动QoderWake，点击右上角用户图标→选择「登录账户」
2、优先使用GitHub账号（推荐），其次为Google；不支持邮箱密码直登
3、登录后进入「设置→记忆管理」，开启跨会话持久化记忆开关
三、配置默认Connector接入企业工具链
QoderWake需通过Connector连接外部系统以执行真实动作，如读GitHub PR、查Slack消息、写Notion文档，未配置则仅能模拟输出。
1、进入「设置→Connectors」页面
2、依次点击「+ 添加」，按提示完成GitHub、Slack、Notion三项基础接入（OAuth授权流程）
3、对每项Connector，确认已勾选读取全部仓库/频道/工作区权限
四、初始化权限红线策略集
权限红线是QoderWake进入生产环境的核心安全机制，用于定义哪些操作必须暂停并请求人工确认，避免误删库、误发邮件等高危行为。
1、进入「设置→权限红线」→点击「加载默认策略集」
2、在策略列表中，确保以下三项处于启用状态：修改主干分支（main/master）、删除数据库表或记录、向客户群发送未经审核的消息
3、点击「保存并激活策略」，系统将自动重启Agent沙盒环境
五、导入或创建首个Skill Vault知识库
Skills Vault是QoderWake执行专业任务的知识中枢，无有效Vault时，其仅能调用通用模型能力，无法体现岗位特性。
1、访问官方Skills Vault仓库：https://github.com/qoder/skills_vault
2、克隆该仓库至本地任意路径，例如：~/qoder/skills_vault
3、在QoderWake设置中进入「技能管理→导入Vault路径」，粘贴上述完整路径并点击「验证并加载」
代码编辑 CLI 工具集合：Cursor CLI（agent）和 Qoder CLI（qodercli），用于代码修改、重构、Code Review 及自动化代码任务。
六、校准本地开发环境检测器
QoderWake需准确识别本机已安装的IDE、CLI工具、版本控制客户端等，否则无法触发代码生成、Git提交、终端执行等关键动作。
1、进入「设置→环境检测」→点击「重新扫描」
2、等待扫描完成，检查列表中是否包含：VS Code（含Shell插件）、Git（≥2.35）、Python（≥3.9）
3、若任一工具显示「未检测到」，请手动点击「添加路径」并指定其可执行文件位置
七、启用审计日志并设置本地存储路径
所有QoderWake的操作均需记录于审计日志，供事后追溯、合规审查与根因复盘，日志未启用将导致行为不可见、不可验。
1、进入「设置→审计日志」→开启记录全部操作事件
2、点击「设置存储路径」，指定一个独立目录，例如：~/qoder/logs/audit
3、确认该路径具备写入权限，且磁盘剩余空间≥500MB
八、配置Credits消耗预警阈值
QoderWake调用大模型服务受Credits余额约束，余额耗尽将导致任务中断；未设预警将无法提前干预。
1、登录Qoder Web端：https://qoder.com/usercenter/credits
2、查看当前可用Credits数量，记下该数值
3、回到QoderWake客户端「设置→用量管理」，将预警阈值设为当前余额的20%，并开启桌面通知
九、设定默认角色与岗位技能包
QoderWake按岗位角色加载不同技能组合，未指定角色将默认启用通用助理模式，无法调用数字程序员、数字分析师等专业能力。
1、进入「设置→岗位角色」→点击「新建角色」
2、从模板中选择数字程序员（适用于开发者）或数字流程专员（适用于运营/产品）
3、确认该角色已绑定对应Skills Vault子目录（如skills_vault/02_Development/）并设为默认
十、执行首次端到端Quest验证任务
该步骤用于闭环检验前述全部设置是否生效，涵盖权限、记忆、Connector、红线、技能、环境、日志七大模块联动。
1、新建一个空文件夹，命名为qoder-test-quest，进入其中并执行git init
2、在QoderWake中点击「+ 新建Quest」，输入指令：分析当前Git仓库结构，列出所有未提交变更，并预览README.md修改建议
3、观察任务流：是否自动识别Git环境、是否调用skills_vault/02_Development/技能、是否在涉及文件写入前触发红线确认、是否将完整过程写入审计日志
