先讲一个关键点:在QoderWake系统中,为数字员工(Waker)设定角色名称时,一旦绑定并启用任务流,后续就无法通过界面直接修改了。这绝非小事——角色名称一旦固定,权限策略错配、Connector白名单失效、审计日志归属混乱等一系列连锁问题就会接连出现。因此,发现名称不规范,必须立即纠正。

具体怎么操作?分两种情况来处理:
方法一:通过员工管理页重命名(仅限未启用任务的Waker)
这个方法只适用于刚完成初始化、尚未触发任何事件、没有关联Connector、也未生成记忆快照的Waker。简单说,就是还没正式投入使用的实例。
操作流程如下:
1. 进入QoderWake主界面,点击左上角「员工管理」,找到目标Waker卡片。
2. 将鼠标悬停在Waker头像右上角,会出现铅笔图标,点击后弹出「重命名」输入框。
3. 输入新名称(支持中文、英文、数字及下划线,长度限制在6–24个字符之间),按回车确认。
4. 系统会自动校验唯一性:如果名称已存在,会提示“名称冲突”,需要更换名称;如果校验通过,名称会立即更新,并同步到所有Agent会话的标题栏中。
方法二:删除重建并迁移关键配置(已启用Waker的唯一可行路径)
如果Waker已经开始处理Issue、提交PR、调用Slack或Notion Connector,那么界面上的重命名功能会变成灰色禁用状态。此时只能走重建路线,但核心资产可以保留下来。
第一步:导出当前Waker的身份与技能配置
进入「设置→员工详情→导出配置」,勾选「长期记忆锚点」「已启用Connector白名单」「权限红线策略集」这三项,然后点击「生成备份包」。备份文件是一个加密的ZIP压缩包,解压后包含settings.yaml、connectors.json、policy.redline三个文件。
第二步:停用原Waker并创建新实例
在员工管理页,点击原Waker卡片右下角的「停用」→ 确认后该实例进入休眠状态。然后点击「+ 新增Waker」→ 选择相同角色(比如“前端工程师”)→ 在「基础信息」页填写新角色名称(例如“前端架构师-张工”)→ 完成初始化流程。
第三步:注入备份配置并验证
启动新Waker → 进入「设置→高级配置→导入配置」→ 上传刚才导出的ZIP包 → 系统会自动匹配并覆盖对应字段 → 重启Waker服务进程 → 检查「Connectors」页,确认GitHub、Slack等是否已显示已授权状态。需要注意的是,如果显示“未连接”,说明导入失败,需要手动重新进行OAuth授权。
