starlight如何把md直接存在cnb里

1starlight如何把md直接存在cnb里,这样可以免构建。
2
3astro能实现，md文档存放在cnb仓库，然后编辑md后，可以实现动态更新。 我记得同事好像实现过，利用eo的云函数来实现的。这样的话我有100w  md文档，也会实时动态更新，就会免去构建这个工作，很香哦。

 1import { defineConfig } from 'astro/config';
 2import starlight from '@astrojs/starlight';
 3
 4// 关键：开启 SSR（服务端渲染）
 5export default defineConfig({
 6  output: 'server', // 必须 server，不能 static
 7  adapter: {}, // 后面配 EO 适配器
 8
 9  integrations: [
10    starlight({
11      title: '我的文档',
12      // 关闭本地 content collection（因为我们用远程）
13      // 不要配置 src/content/docs
14    }),
15  ],
16});

1npm install marked gray-matter

 1---
 2import { marked } from 'marked';
 3import matter from 'gray-matter';
 4
 5// 1. 从 URL 取 slug
 6const { slug } = Astro.params;
 7const mdPath = slug ? `${slug}.md` : 'index.md';
 8
 9// 2. CNB 仓库 MD 地址（你自己改成你的）
10const CNB_RAW_URL = `https://cnb.cool/onedayxyy/docs/-/raw/main/${mdPath}`;
11
12try {
13  // 3. 实时拉取 CNB 上的 MD
14  const res = await fetch(CNB_RAW_URL);
15  if (!res.ok) throw new Error('Not found');
16  const mdText = await res.text();
17
18  // 4. 解析 frontmatter + markdown
19  const { data: frontmatter, content } = matter(mdText);
20  const html = marked.parse(content);
21
22  // 5. 用 Starlight 布局渲染
23  const { Layout } = await import('@astrojs/starlight/components');
24---
25  <Layout
26    frontmatter={{
27      title: frontmatter.title || '文档',
28      ...frontmatter,
29    }}
30  >
31    <article set:html={html} />
32  </Layout>
33<% } catch { %>
34  <Layout frontmatter={{ title: '页面不存在' }}>
35    <h1>404</h1>
36    <p>文档未找到</p>
37  </Layout>
38<% } %>

 1import { defineCollection } from 'astro:content';
 2
 3// 从 CNB 拉取 nav.json 控制侧边栏
 4const docs = defineCollection({
 5  loader: async () => {
 6    const res = await fetch('https://cnb.cool/onedayxyy/docs/-/raw/main/nav.json');
 7    const nav = await res.json();
 8    return nav.map(item => ({
 9      id: item.slug,
10      slug: item.slug,
11      data: { title: item.title },
12    }));
13  },
14});
15
16export const collections = { docs };

1starlight({
2  sidebar: [
3    { label: '文档', items: [] }, // 会被动态覆盖
4  ],
5});

1npm install @tencentcloud/astro-adapter-eo

1import eo from '@tencentcloud/astro-adapter-eo';
2
3export default defineConfig({
4  output: 'server',
5  adapter: eo({
6    functionName: 'starlight-docs',
7    region: 'ap-shanghai',
8  }),
9});

1npm run build
2# 生成 .astro-eo 目录，直接用 CNB 部署到 EO

1# CNB 仓库名：docs
2main/
3├─ index.md           # /docs
4├─ guide.md           # /docs/guide
5├─ install.md         # /docs/install
6├─ advanced/
7│  └─ config.md       # /docs/advanced/config
8└─ nav.json           # 侧边栏配置

1[
2  { "slug": "index", "title": "首页" },
3  { "slug": "guide", "title": "指南" },
4  { "slug": "install", "title": "安装" },
5  { "slug": "advanced/config", "title": "高级配置" }
6]

 1master:
 2  push:
 3    - runner:
 4        cpus: 64
 5
 6      imports:
 7        - https://cnb.cool/onedayxyy/secret/-/blob/main/envs.yml
 8
 9      docker:
10        image: docker.cnb.cool/yuwen-gueen/docker-images-chrom/node:20-alpine
11
12      stages:
13        - name: set env
14          script: echo -n $(date +%s)
15          exports:
16            info: CUSTOM_ENV_START_TIME
17
18        # 安装 + 构建 Astro SSR（极快，因为没有 MD）
19        - name: build
20          script: |
21            npm install
22            npm run build
23
24        # 部署到腾讯云 EO 边缘函数
25        - name: deploy to EO
26          image: tencentcloud/cli
27          script: |
28            tccli configure set secretId $COS_SECRET_ID secretKey $COS_SECRET_KEY region ap-shanghai
29            tccli eo DeployFunction \
30              --FunctionName starlight-docs \
31              --Code .astro-eo \
32              --Runtime nodejs20 \
33              --MemorySize 256
34
35        - name: ⏱️ 计算耗时
36          script: |
37            end_time=$(date +%s)
38            duration=$((end_time - $CUSTOM_ENV_START_TIME))
39            echo "${duration}秒"
40          exports:
41            info: CUSTOM_ENV_BUILD_TIME
42
43        - name: 钉钉通知
44          image: docker.cnb.cool/yuwen-gueen/docker-images-chrom/tencentcom-dingtalk-bot-msg:latest_amd64
45          settings:
46            content: "「Starlight 免构建文档」EO部署完成，耗时: ${CUSTOM_ENV_BUILD_TIME}"
47            c_type: "text"
48            secret: $SECRET
49            webhook: $WEBHOOK
50
51include:
52  - .cnb/vscode.yml