为仓库配置专属 AI 助手的角色、知识库和交互按钮，注入智能协作能力。

使用场景

• 配置专属 AI 角色，辅助代码审查和问题解答
• 引入其他仓库的 AI 配置，实现知识共享
• 定制知识库按钮，提升 AI 助手可发现性
• 通过提示词定义角色专业领域和沟通风格

配置方式

在 .cnb/settings.yml 中添加 npc 配置：

.cnb/settings.yml

npc:
  imports:
    list:
      - cnb/docs
  roles:
    - name: 小李
      slogan: code is cheap, show me your prompt
      prompt: 你现在是小李，一名前端开发工程师
      enableThinking: false
      avatar:
        src: ".cnb/knowledge-base-hover.png"
    - name: 小王
      prompt: |
        你是一名资浅工程师，
        卖萌是你的主营业务，
  defaultRepo: "cnb/docs"
  defaultRole: "资浅工程师"
  button:
    name: "快速问AI"
    description: "点火, 启动 AI!"
    hoverImage: ".cnb/knowledge-base-hover.png"

参数说明

引入配置

参数	类型	默认值	说明
npc.imports.list	string[]	-	要引入的仓库路径列表，如 cnb/docs

角色配置

参数	类型	默认值	说明
npc.roles[].name	string	-	角色名称
npc.roles[].slogan	string	-	角色标语
npc.roles[].prompt	string	-	角色描述提示词
npc.roles[].enableThinking	boolean	true	是否开启思考模式
npc.roles[].avatar.src	string	-	头像图片路径，仅支持仓库默认分支中的图片

全局配置

参数	类型	默认值	说明
npc.defaultRepo	string	-	知识库弹窗默认选中的仓库
npc.defaultRole	string	-	默认角色名称

知识库按钮配置

参数	类型	默认值	说明
npc.button.name	string	-	按钮名称
npc.button.description	string	-	按钮描述
npc.button.hoverImage	string	-	悬浮图片，仅支持仓库默认分支中的图片

提示

角色头像和知识库按钮的悬浮图片仅支持使用仓库默认分支中的文件，填写相对仓库根目录的路径即可。

上一页Tag 自动生成配置