QoderWake CN 让你在本机组建一支"数字员工"团队（Wakers）。每个员工有岗位、有名字、有人设、有专长，可以被你召唤聊天或干活，也可以按计划或事件自动开工。他们能做什么、用什么工具、有什么记忆、能碰什么不能碰什么——全部可配。
这份文档教你从零把 QoderWake CN 跑起来：装好工具 → 打开控制台 → 创建数字员工 → 派活 → 管理员工。
产品理念：7×24 小时数字员工，"Always awake, always working."
产品特性：安全可控、生产可用、持续进化。
核心概念：员工角色（Role）→ 数字员工（Agent）→ 团队 / 组织（Agent Teams）。
首批角色：后端工程师、前端工程师、测试工程师、产品经理、数据分析师、内容运营，同时支持自定义角色。
你需要哪种岗位的员工
当前邀测覆盖以下角色，选最贴近你需求的即可：
角色 | 岗位特性 |
后端工程师 | 专注于 API 开发、数据建模、服务集成、性能优化和线上稳定性。遵循增量交付、测试验证和约定优先设计的工程实践。员工自动分析 Bug / Issue，改完代码直接提 PR。 |
前端工程师 | 专注前端界面设计与实现，擅长组件架构、视觉语言打磨、响应式适配、无障碍优化和性能调优。遵循增量交付、分层验证和基于证据的校验，兼顾用户体验与工程质量。 |
测试工程师 | 面向通用命令行工具和 Web 产品的质量保障角色，专注测试计划文档、端到端测试、缺陷复现和基于证据的报告；不运行单元测试，也不修复问题。 |
产品经理 | 面向软件产品的 AI 原生产品管理角色，专注目标驱动的需求全生命周期管理、PRD 生成、用户反馈分析、竞品研究和发布沟通，并对外部写入设置明确审批门禁。 |
数据分析师 | 面向问题框定、指标口径、钉钉文档/表格 MCP 数据收集、数据诊断、市场背景和证据化建议的 AI 原生数据分析师。 |
内容运营 | 面向账号定位、热点洞察、内容日历、小红书笔记创作、视觉素材 brief、审批后发布、评论互动、数据复盘、品牌合规和跨平台改写的 AI 原生内容运营角色。 |
自定义 | 自己定义岗位的工作方式与工作流，可挂载 MCP、Skill 等任意配置。 |
环境准备
QoderWake CN 支持本地部署和云端部署。建议部署在稳定在线、网络良好的常开设备或云桌面环境中，以保障数字员工 7×24 小时持续运行。
Windows 版本敬请期待，暂未对外开放，请先在 macOS 或 Linux 上使用。
本地部署
推荐部署在可长期稳定运行的本地设备上，例如 Mac mini，以获得更好的 7×24 小时运行体验。
macOS：13.0 及以上版本。
Linux：推荐 Ubuntu 22.04 LTS 及以上版本，需启用 GUI 桌面以使用本地 Web Console。
云端部署
支持主流云桌面和云主机环境。为方便浏览器登录和本地 Web 管理，推荐使用无影云电脑企业版或个人版。
Linux：Ubuntu 22.04 及以上版本，需启用 GUI 桌面以使用本地 Web Console。
前置工具
产品预置多个软件研发类数字员工角色，安装前请先准备好 Git 环境，并确认当前账号能正常访问目标代码仓库：
已安装
git。已完成仓库认证配置。
可以正常执行
clone、pull、push操作。
本地或云端部署环境均需支持外部网络访问，用于用户登录、模型调用、代码仓库访问等。在企业网络、代理或防火墙环境下，请提前放通必要的 HTTPS 出站访问。
步骤 1：安装 QoderWake CN
macOS
进入QoderWake CN官网，下载安装包：
或者打开终端（应用程序中查找"终端"或 Terminal），运行：
curl -fsSL https://ide.qoder.com.cn/qoderwake-cn/install.sh | bash脚本会自动检测平台、下载并校验安装包、安装主程序和资源文件、把命令入口加入 PATH、启动浏览器登录、启动本地常驻服务并打开 Web Console。命令入口：~/.qoderwake-cn/bin/qoderwake。
Linux
打开终端，运行：
curl -fsSL https://ide.qoder.com.cn/qoderwake-cn/install.sh | bash安装脚本会自动完成：
检测 Linux CPU 架构。
下载并校验对应平台的 QoderWake CN 安装包。
安装 QoderWake CN 主程序和资源文件。
创建命令入口并尝试加入
PATH。启动浏览器登录。
登录后启动或重启本地常驻服务。
自动打开本地 Web Console。
命令入口：
~/.qoderwake-cn/bin/qoderwake-cn默认 Web Console 地址：
http://127.0.0.1:19830Windows
Windows 版本敬请期待，正式发布后会在本页同步更新。
步骤 2：打开控制台
浏览器访问：http://127.0.0.1:19830/。这是 QoderWake CN 在你本机的管理台，员工管理、派活、配置权限都在这里完成。
界面说明：
左侧边栏：展示"我的 Waker"列表，显示所有已创建的员工和最近活动时间。
顶部按钮：点击"创建 Waker"快速新建员工，右侧支持新建任务。
主区域：进入某个员工后默认打开对话页面，可直接派活。
右侧边栏：查看已创建的任务及当前运行中任务的详情。
首次访问会引导你登录账户，按提示完成即可。
步骤 3：创建数字员工
点击左侧"创建 Waker"按钮。
选一个角色模板：每个角色模板自带人设、典型工作流、核心技能集和默认问题，点击"查看详情"可以预览。
或自定义角色：如果预置角色都不合适，可选择"自定义角色"，完全由你定义这位员工的人设、专长、工作风格，再为其配置技能、连接器和权限。
填写基本信息：填写员工的名字、头像、简介。选择预置角色后内容会自动带过来，可按需调整。
保存：点击保存，员工就创建好了。新员工首次创建后会进入引导，推荐你先挂哪些技能、接哪些渠道，可以跳过留待后续配置。
为提升自定义角色的使用效果，建议在创建时尽量提供完整的角色信息——角色定位、核心职责、工作流程、所需技能以及 MCP 等工具能力配置。
步骤 4：跟员工开始干活
新员工创建完成后，可以选择直接对话或创建自动任务。
对话任务
直接在输入框输入需求并发送，员工就开始干活。过程中你可以：
追问、调方向：随时插话，员工接着上下文继续。
附文件 / 截图：任何一轮发言都能再贴。
打断：员工方向跑偏可以让他停。
审批操作：当员工要动文件、跑命令、上网时会停下来征求同意，你点"允许"或"拒绝"。
回答员工提问：他遇到选择会回头问你，直接在卡片上选。
切换 AI 模型：对话中途感觉不够聪明或想省钱，顶部下拉可以换模型继续。
看思考过程：能实时看到员工下决定前的推理思路。
看产物：右侧面板实时展示员工产出的代码补丁、新生成的文件等。
选择工作目录：在对话底部可以选择员工工作的本地目录。
自动任务
适合"每天跑一次"、"监听某个仓库变化就自动响应"这类场景。
进入Waker 详情 → 触发任务 → 新建，可配置：
任务名和描述：员工读了就知道要做什么。
AI 模型：选哪个模型。
工作目录：在本地哪个目录、哪个仓库或哪个项目工作区里执行。
触发方式（最多 5 种，可混用）：
定时：一次性 / 周期性 / 复杂周期（每天 9 点、每周一、每月 1 号等）。
事件驱动：监听 GitHub 仓库的 Issue / PR / 评论变化。
最大次数 / 截止日期（可选）：限制任务不要无限跑。
保存后，员工按你设的节奏自动干活。你可以随时暂停 / 启用、立即运行测试、查看运行历史。
步骤 5：管理你的数字员工
进员工详情页能看到、调整他身上的所有东西。
目录 | 你能做什么 |
首页 | 看头像、状态、入职天数、触发任务数、对话任务数、工作热力图。 |
项目 | 给他绑定要工作的代码仓库或本地目录。一个项目可包含多个源（多个目录或仓库），项目记忆与员工个人记忆分开。 |
触发任务 | 增 / 删 / 改 / 暂停他身上的自动化任务。 |
对话任务 | 翻历史对话，继续聊。 |
记忆 | 看 / 编辑他对你和项目的长期认知。来源：对话过程中自动沉淀、手动编辑、系统定期梳理与去重。本地存储，不上传云端。 |
技能 | 从 Qoder CN官方 Skills Marketplace 安装，本地上传自定义技能，或开关已有技能。内置技能不可卸载。 |
连接器 | 对接外部工具 / 服务（GitHub、Jira、GitLab 等）。 |
权限 | 工具防护——基于内置安全规则校验工具参数，覆盖命令注入、资源滥用、代码执行、网络滥用、敏感文件访问、权限提升等；文件防护——控制对本地文件的读写权限；内置工具——为每个内置工具设置允许 / 询问 / 禁用策略。高危操作会弹出审批卡片。 |
员工配置
记忆管理
每个员工有自己的长期记忆，用于积累对你和项目的认知。记忆来源有三种：
自动沉淀：对话过程中员工认为值得记住的信息会自动写入。
手动写入：你可以进记忆页直接编辑。
系统整理：定期由系统帮他梳理和去重。
进入员工详情 → 记忆，可浏览、搜索、编辑所有记忆条目。记忆存储在本地，不上传云端。
技能（Skill）
技能是员工在对话或触发任务中可以调用的专项能力包。
技能市场：从 Qoder CN官方 Skills Marketplace 安装。
上传 Skill：本地自行导入。
内置技能：系统自带，不可卸载。
进入员工详情 → 技能，可查看已安装技能、搜索市场、上传自定义技能。
连接器（Connector）
连接器是员工对接外部工具 / 服务的桥梁。支持手动添加连接器。
项目
项目是员工的工作空间。进入员工详情 → 项目，可以：
绑定本地目录或 git 仓库。
一个项目可以包含多个源（多个目录 / 仓库）。
项目有独立的记忆，跟员工个人记忆分开。
权限管理
权限控制员工能做什么、不能做什么。进入员工详情 → 权限，包含两大类，外加内置工具策略。
工具防护：基于内置安全规则对工具参数做校验；命中高危规则后会请求用户授权。规则分类：
命令注入：检测
rm、mv等危险操作。资源滥用：检测 fork 炸弹、系统重启等。
代码执行：检测
curl | bash等远程执行。网络滥用：检测反弹 shell、本地回环访问。
敏感文件访问：检测访问系统关键文件。
权限提升：检测
sudo等提权操作。
文件防护：控制员工对本地文件的读写权限。
内置工具：对 Waker 可用的内置工具设置允许 / 询问 / 禁用策略。
当员工执行操作触发安全规则时，会弹出审批卡片让你决定是否允许。
场景示例：自动修复 Bug
两种驱动方式。
方法 A——手动发起对话：打开控制台，选一个后端工程师角色的 Waker。在对话框输入："帮我排查这个报错的根因并给出最小修复方案"，附上报错信息。员工分析问题、定位根因、给出修复方案。确认后让他执行修复并提 PR。过程中要执行命令或改文件时，他会先征求你同意。
方法 B——设自动任务处理：进员工详情 → 触发任务 → 新建，触发方式选"事件"，监听 GitHub 仓库的 Issue 变化。任务描述写："有新 Bug Issue 进来时，自动分析并给出修复 PR。" 保存后，每当仓库出现新的 Bug Issue，员工自动启动分析与修复。
问题反馈
遇到任何问题或者有产品功能想反馈，点击控制台右下角的反馈按钮提交，我们会尽快回复 & 解决。