配置 codewiki 流水线后，可按仓库代码自动生成 Wiki 文档。仓库首页将出现 Wiki 入口，方便快速构建文档中心。

codewiki 入口

使用方法

步骤 1：配置流水线

插件镜像：cnbcool/codewiki

在仓库的 .cnb.yml 中配置 codewiki 插件。建议使用 tag_push 事件触发，避免频繁生成 Wiki。 更多事件类型请参考构建触发规则。

.cnb.yml

$:
  tag_push:
    - docker:
        image: cnbcool/codewiki:latest
      stages:
        - name: generate codewiki
          timeout: 10h
          settings:
            git_doc_dir: /data/codewiki/${CNB_REPO_SLUG}

主要参数说明：

参数名	说明	默认值	是否必填
git_doc_dir	Wiki 文档生成目录	无	是
use_codebuddy	是否使用 CodeBuddy 接入点；1 表示使用 CodeBuddy，0 表示使用 CNB AI	1	否
llm_model_name	指定使用的 LLM 模型名称	deepseek-v3.1	否
knowledge_enabled	是否启用知识库入库	false	否
knowledge_embedding_model	知识库嵌入模型名称	hunyuan	否
knowledge_chunk_size	文本分块大小（token 数）	1500	否
knowledge_chunk_overlap	相邻分块重叠 token 数量	0	否

设为 true 后，生成的 Wiki 文档会自动入库到仓库知识库。

更多参数请参阅 cnbcool/codewiki 插件文档。

步骤 2：访问 CodeWiki

在仓库首页点击 Wiki 入口，进入 CodeWiki 页面。

自动进入知识库

CodeWiki 生成的内容会自动同步到仓库的知识库中。 同步完成后，仓库将被标记为知识库，可在 AI 对话中基于 CodeWiki 内容问答。

如需进一步了解知识库的配置与使用，请参阅知识库。

上一页知识库