From c0ca1c819ef34754c3bef7c42d064d0bcc39c407 Mon Sep 17 00:00:00 2001
From: kevisual <xiongxiao@xiongxiao.me>
Date: Sat, 17 Jan 2026 00:04:10 +0800
Subject: [PATCH] update

---
 .cnb/scripts/init-cube.sh |  5 ++++-
 .cnb/template.yml         | 38 ++++++++++++++++++++++++++++++++++++--
 docs/skill/split/SKILL.md | 10 ++++++++++
 3 files changed, 50 insertions(+), 3 deletions(-)
 create mode 100644 docs/skill/split/SKILL.md

diff --git a/.cnb/scripts/init-cube.sh b/.cnb/scripts/init-cube.sh
index c6552cd..bb62e5b 100644
--- a/.cnb/scripts/init-cube.sh
+++ b/.cnb/scripts/init-cube.sh
@@ -1,2 +1,5 @@
 echo "${KUBECONFIG_DATA}" | base64 -d > ~/.kube/config
-chmod 600 ~/.kube/config
\ No newline at end of file
+chmod 600 ~/.kube/config
+
+# 把 kube 配置转为 base64 编码输出，方便后续使用
+# cat ~/.kube/config | base64 -w 0
\ No newline at end of file
diff --git a/.cnb/template.yml b/.cnb/template.yml
index 92a5531..e4d16e3 100644
--- a/.cnb/template.yml
+++ b/.cnb/template.yml
@@ -1,3 +1,4 @@
+# 同步代码到gitea模板
 .common_sync_to_gitea_template: &common_sync_to_gitea_template
   services:
     - docker
@@ -21,6 +22,7 @@
         sync_mode: rebase
         branch: main
 
+# 同步gitea代码到当前仓库
 .common_sync_from_gitea_template: &common_sync_from_gitea_template
   services:
     - docker
@@ -48,6 +50,7 @@
 #   api_trigger_sync_from_gitea:
 #     - <<: *common_sync_from_gitea_template
 
+# kubectl 部署模版
 .kubectl_deploy_template: &kubectl_deploy_template
   services:
     - docker
@@ -68,6 +71,7 @@
         export NAMESPACE=${KUBE_NAMESPACE:-default}
         kubectl rollout restart deployment/${KUBE_DEPLOYMENT} -n ${NAMESPACE}
 
+# 打包并发布镜像
 .build_images_app_template: &build_images_app_template
   services:
     - docker
@@ -90,7 +94,7 @@
       script: docker push ${CNB_DOCKER_REGISTRY}/${CNB_REPO_SLUG_LOWERCASE}:latest
 
 
-
+# 开发环境模版
 .dev_tempalte: &dev_tempalte
   services:
     - vscode
@@ -115,7 +119,37 @@
             echo "文件不存在"
         fi
 
+# 结束状态模版
 .end_state_template: &end_state_template
   endStages:
     - name: '结束'
-      script: echo "流水线执行完毕，当前状态：${CNB_PIPELINE_STATUS}"
\ No newline at end of file
+      script: echo "流水线执行完毕，当前状态：${CNB_PIPELINE_STATUS}"
+
+
+# 预览模板
+.preview_template: &preview_template
+  services:
+    - name: vscode
+      options:
+        # 启用预览模式
+        onlyPreview: true
+        # 启动业务端口的命令，端口必须启动在 8686
+        launch: node index.js
+        # 保活时间，单位毫秒，不设置默认 10 分钟没有心跳（检测不到开发环境内的 http 连接）即关闭开发环境
+        keepAliveTimeout: 3600000
+        # 是否守护进程模式，默认为 false，非守护进程模式
+        # true：以守护进程模式启动，即 launch 启动预览业务服务时，会直接运行在后台
+        # false：非守护进程模式启动，执行 launch 启动预览业务服务时，可以看到日志，且需要等待 launch 启动完成并主动退出，才会继续执行后续流程
+        # 推荐设置为 false，由用户自己实现业务启动成功后退出进程并后台运行，这样可以看到业务启动日志，方便定位问题
+        daemon: true
+    - docker
+
+# 构建知识库模版
+.knowledge_template: &knowledge_template
+  stages:
+    - name: 搭建知识库
+      image: cnbcool/knowledge-base
+      settings:
+        include:
+          - "docs/**.md"
+          - "blogs/**.md"
\ No newline at end of file
diff --git a/docs/skill/split/SKILL.md b/docs/skill/split/SKILL.md
new file mode 100644
index 0000000..e669dc5
--- /dev/null
+++ b/docs/skill/split/SKILL.md
@@ -0,0 +1,10 @@
+---
+name: split-cnb-openapi
+description: 拆分 OpenAPI 文档
+---
+
+使用 bun 执行 docs/split.ts 脚本，拆分 OpenAPI 文档为多个小文件。
+
+```bash
+bun docs/split.ts
+```
\ No newline at end of file