专家的name和displayName一旦保存即不可更改,因name是系统唯一标识,涉及文件路径、插件注册等底层逻辑;displayName在注册后也被客户端锁定,双击重命名仅临时生效。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜

WorkBuddy自定义专家创建完成后,显示名称在界面上可临时修改,但【专家的唯一标识符(name)和初始设定的显示名称(displayName)一旦保存就无法更改】,这是系统级硬性限制,不是界面操作遗漏导致的。
为什么名字不能改
专家的 name 是整个系统识别该专家的唯一键值,用于文件路径、插件注册、技能绑定、团队共享及专家市场分发等所有底层逻辑。若允许随意修改,会导致已配置的 Skill 调用失败、历史对话上下文错乱、团队成员调用中断,甚至触发校验报错。
displayDescription、quickPrompts 等字段虽可在 YAML 或 MD 文件中手动编辑,但 displayName(中英文展示名)一旦写入 agents/my-expert.md 或 plugin.json 并完成注册,WorkBuddy 客户端即锁定该字段——你点进“我的专家”列表里双击重命名,实际只是修改当前会话的临时标签,刷新后恢复原名。
当前能做的补救操作
方法一:重新创建专家(推荐)
1. 进入「专家·技能·连接器」→「我的专家」→ 找到目标专家 → 点击右侧「…」→ 选择「导出配置」,保存为 backup-expert.yaml;
2. 返回「我的专家」页面,点击「创建专家」;
3. 在引导对话中,直接粘贴导出的配置内容,仅修改 displayName 字段为你想要的新名称;
4. 完成创建后,旧专家可手动归档或删除。
WorkBuddy 桌宠工厂 —— 给一张角色图、一个 codex.pet 链接、一条 codex-pets.net 下载 URL、或一份现成的精灵表,就能自动创建一只可联动 WorkBuddy 状态的桌面宠物。当用户说"创建桌宠"、"做一只桌宠"、"用这张图做桌宠"、"从 codex.pet 安装桌宠"、"导入 codex 桌宠 XX"、"装一下 codex-pets.net 上的 XX&quo
方法二:仅改头像与描述(不改名但增强辨识度)
替换 avatars/expert.png 为新设计头像,同步更新 displayDescription 为更精准的职能说明,比如把“文档助手”改为“合同审查专员(专注SaaS类服务协议)”,用户召唤时仍用原名,但一眼能区分用途。
【注意:导出的 YAML 配置中 name 字段必须保持 kebab-case 格式且全局唯一,重复命名会导致注册失败】
创建前的关键确认步骤
第一步:在创建对话刚开始时,系统会先问“请为这位专家起一个简短、易记、能体现职能的名称”,此时输入的名称将直接写入 name 和 displayName;
第二步:输入后,系统会弹出二次确认框:“确认使用【XX-legal-reviewer】作为专家唯一标识?此名称创建后不可修改。”
第三步:只有点击【确认】才进入后续人设填写。这一步没跳过、没误点,就能彻底避开改名困境。

















