@model-go/docs-core 0.1.0

package/dist/index.js

@@ -0,0 +1,625 @@
+/**
+ * @model-go/docs-core —— 文档内容与渲染的单一真源（SSOT）
+ *
+ * 内容（content/**）与渲染器（本文件）同源发布，消费方只负责调用：
+ *   - docs.modelgo.com（modelgo-doc-web）：linkBase = ''，assetBase = ''
+ *   - modelgo.ai/docs（modelgo-global-web）：linkBase = '/docs' | '/zh/docs'，assetBase = '/docs'
+ *
+ * 本文件是从 modelgo-doc-web 的 .vitepress/theme/composables/docs.ts 抽出的纯渲染部分：
+ * 不含任何浏览器 API（location / navigator / localStorage / sessionStorage），
+ * 可在 Node 服务端直接执行，因此官网能把它渲染成爬虫可抓的服务端 HTML。
+ */
+import { renderCodeBlock } from './code-highlight.js';
+import { DOCS_PAGES, DOCS_METAS, DOCS_CHANGELOG } from './content.generated.js';
+// ── 导航装配 ────────────────────────────────────────────────────────
+function navItemId(item) {
+    return item.slug || item.path || item.title;
+}
+function adaptSectionChildren(children) {
+    const pages = [];
+    const subsections = [];
+    for (const child of children) {
+        if (child.type === 'page') {
+            pages.push({
+                id: navItemId(child),
+                title: child.title,
+                slug: child.slug,
+                description: child.description,
+            });
+        }
+        else if (child.type === 'section') {
+            const { pages: childPages, subsections: childSubs } = adaptSectionChildren(child.children ?? []);
+            if (childPages.length > 0 || childSubs.length > 0) {
+                subsections.push({
+                    id: navItemId(child),
+                    title: child.title,
+                    pages: childPages,
+                    children: childSubs.length > 0 ? childSubs : undefined,
+                });
+            }
+        }
+    }
+    return { pages, subsections };
+}
+function adaptNav(nav) {
+    const sections = [];
+    for (const item of nav.items) {
+        if (item.type === 'page') {
+            sections.push({
+                id: navItemId(item),
+                title: null,
+                pages: [{
+                        id: navItemId(item),
+                        title: item.title,
+                        slug: item.slug,
+                        description: item.description,
+                    }],
+            });
+        }
+        else if (item.type === 'section') {
+            const { pages, subsections } = adaptSectionChildren(item.children ?? []);
+            if (pages.length > 0 || subsections.length > 0) {
+                sections.push({
+                    id: navItemId(item),
+                    title: item.title,
+                    pages,
+                    children: subsections.length > 0 ? subsections : undefined,
+                });
+            }
+        }
+    }
+    return { title: nav.title, description: nav.description, sections };
+}
+const PAGES = new Map(Object.entries(DOCS_PAGES));
+const METAS = new Map(Object.entries(DOCS_METAS));
+// 站点目录映射：cn → china, global → international
+function getDocsContentDirectory(profile) {
+    return profile === 'cn' ? 'china' : 'international';
+}
+// ── HTML 转义 ─────────────────────────────────────────────────────
+function escapeHtml(value) {
+    return value
+        .replaceAll('&', '&')
+        .replaceAll('<', '&lt;')
+        .replaceAll('>', '&gt;')
+        .replaceAll('"', '&quot;')
+        .replaceAll("'", '&#39;');
+}
+// 把「当前页所在目录」与 markdown 里写的相对路径（如 ../models/text/generation、errors）
+// 解析成站内 slug（如 models/text/generation、quickstart/errors）——slug 规则与 meta.json
+// 里手写的 slug 字段、以及 getDocsPage 的查找 key 完全一致，都是「相对 lang 目录的文件路径，无扩展名」。
+function resolveRelativeSlug(currentSlug, relative) {
+    const source = relative.startsWith('/') ? relative : dirOf(currentSlug) + relative;
+    const stack = source.split('/');
+    const resolved = [];
+    for (const seg of stack) {
+        if (seg === '' || seg === '.')
+            continue;
+        if (seg === '..')
+            resolved.pop();
+        else
+            resolved.push(seg);
+    }
+    return resolved.join('/');
+}
+const EXTERNAL_LINK_RE = /^([a-z][a-z0-9+.-]*:|\/\/)/i;
+// 渲染单个 [label](target) 为 <a>：
+// - 外链 / mailto / 协议相对：新标签页打开
+// - #anchor：页内锚点，标记 data-doc-link 交给统一路由同步 URL 与滚动位置
+// - 站内相对路径：解析成 slug，若确实存在对应页面，标记 data-doc-link 交给
+//   DocsApp.vue 的点击委托做 SPA 内跳转；
+//   若解析不到页面（如手滑打错路径），退化成纯文本，不渲染成一个点了没反应的死链接。
+function renderLink(label, target, ctx) {
+    if (/^(?:javascript|data|vbscript):/i.test(target))
+        return label;
+    if (EXTERNAL_LINK_RE.test(target) || target.startsWith('mailto:')) {
+        return `<a href="${target}" target="_blank" rel="noreferrer">${label}</a>`;
+    }
+    if (target.startsWith('#')) {
+        return `<a href="${target}" data-doc-link>${label}</a>`;
+    }
+    const [path, hash] = target.split('#', 2);
+    const slug = resolveRelativeSlug(ctx.currentSlug, path.replace(/\.md$/, ''));
+    const exists = PAGES.has(`${ctx.siteDir}/${ctx.lang}/${slug}.md`);
+    if (!exists)
+        return label;
+    const href = `${ctx.linkBase}/${slug}${hash ? `#${hash}` : ''}`;
+    return `<a href="${href}" class="docs-inline-link" data-doc-link>${label}</a>`;
+}
+function inlineMarkdown(value, ctx) {
+    return escapeHtml(value)
+        .replace(/!\[([^\]]*)\]\(([^)\s]+)\)/g, (_all, alt, target) => {
+        // Images are rendered from local public assets or explicit http(s) URLs only;
+        // reject executable/data schemes before placing the escaped URL in markup.
+        if (!/^(?:https?:|\/|\.\.?\/)/i.test(target))
+            return alt;
+        // 站内图片走 assetBase，避免挂到官网后 /images/... 落到官网根路径
+        const src = target.startsWith('/') ? `${ctx.assetBase}${target}` : target;
+        return `<figure class="docs-image"><img src="${src}" alt="${alt}" loading="lazy" decoding="async"></figure>`;
+    })
+        .replace(/`([^`]+)`/g, '<code>$1</code>')
+        .replace(/\*\*([^*]+)\*\*/g, '<strong>$1</strong>')
+        .replace(/(?<!!)\[([^\]]+)\]\(([^)\s]+)\)/g, (_all, label, target) => renderLink(label, target, ctx));
+}
+function stripFrontmatter(content) {
+    return content.replace(/^---\r?\n[\s\S]*?\r?\n---\r?\n?/, '');
+}
+// ── Markdown 块级渲染 ───────────────────────────────────────────────
+function renderMarkdown(content, ctx) {
+    const stripped = stripFrontmatter(content);
+    const lines = stripped.replace(/\r\n/g, '\n').split('\n');
+    let firstH1Skipped = false;
+    const html = [];
+    const toc = [];
+    const paragraph = [];
+    const tableRows = [];
+    const codeLines = [];
+    let listOpen = false;
+    let listType = null;
+    let codeOpen = false;
+    let codeLang = '';
+    let customBlock = null;
+    const closeParagraph = () => {
+        if (!paragraph.length)
+            return;
+        html.push(`<p>${inlineMarkdown(paragraph.join(' '), ctx)}</p>`);
+        paragraph.length = 0;
+    };
+    const closeList = () => {
+        if (!listOpen)
+            return;
+        html.push(`</${listType ?? 'ul'}>`);
+        listOpen = false;
+        listType = null;
+    };
+    const closeTable = () => {
+        if (!tableRows.length)
+            return;
+        const rows = tableRows
+            .map((row) => row
+            .replace(/^\|/, '')
+            .replace(/\|$/, '')
+            .split('|')
+            .map((cell) => cell.trim()))
+            .filter((cells) => !cells.every((cell) => /^:?-{3,}:?$/.test(cell)));
+        const [head, ...body] = rows;
+        if (head) {
+            html.push('<table>');
+            html.push(`<thead><tr>${head.map((cell) => `<th>${inlineMarkdown(cell, ctx)}</th>`).join('')}</tr></thead>`);
+            if (body.length) {
+                html.push('<tbody>');
+                body.forEach((row) => {
+                    html.push(`<tr>${row.map((cell) => `<td>${inlineMarkdown(cell, ctx)}</td>`).join('')}</tr>`);
+                });
+                html.push('</tbody>');
+            }
+            html.push('</table>');
+        }
+        tableRows.length = 0;
+    };
+    const closeCode = () => {
+        html.push(renderCodeBlock(codeLines.join('\n'), codeLang));
+        codeLines.length = 0;
+        codeOpen = false;
+        codeLang = '';
+    };
+    const closeCustomBlock = () => {
+        if (!customBlock)
+            return;
+        const block = customBlock;
+        if (block.type === 'agent-tools') {
+            const rows = block.lines
+                .map((line) => line.trim())
+                .filter((line) => line.startsWith('|') && line.endsWith('|'))
+                .map((line) => line.replace(/^\|/, '').replace(/\|$/, '').split('|').map((cell) => cell.trim()))
+                .filter((cells) => cells.length === 3 && !cells.every((cell) => /^:?-{3,}:?$/.test(cell)));
+            const [head, ...body] = rows;
+            if (head) {
+                html.push('<table class="docs-agent-tools-table">');
+                html.push(`<thead><tr>${head.map((cell) => `<th>${inlineMarkdown(cell, ctx)}</th>`).join('')}</tr></thead>`);
+                if (body.length) {
+                    html.push('<tbody>');
+                    body.forEach(([tool, status, manualDocs]) => {
+                        const statusKind = /^(支持|Supported)$/i.test(status) ? 'supported' : 'unavailable';
+                        html.push('<tr>' +
+                            `<td>${inlineMarkdown(tool, ctx)}</td>` +
+                            `<td><span class="docs-agent-status-tag docs-agent-status-tag--${statusKind}">${inlineMarkdown(status, ctx)}</span></td>` +
+                            `<td>${inlineMarkdown(manualDocs, ctx)}</td>` +
+                            '</tr>');
+                    });
+                    html.push('</tbody>');
+                }
+                html.push('</table>');
+            }
+        }
+        else if (block.type === 'endpoints') {
+            const rows = block.lines
+                .map((line) => line.trim())
+                .filter(Boolean)
+                .map((line) => {
+                const separator = line.indexOf('|');
+                if (separator < 0)
+                    return null;
+                return {
+                    label: line.slice(0, separator).trim(),
+                    value: line.slice(separator + 1).trim(),
+                };
+            })
+                .filter((row) => row !== null);
+            html.push('<div class="docs-endpoint-grid">');
+            rows.forEach(({ label, value }) => {
+                html.push('<div class="docs-endpoint-card">' +
+                    `<span class="docs-endpoint-protocol">${inlineMarkdown(label, ctx)}</span>` +
+                    `<code>${escapeHtml(value)}</code>` +
+                    `<button class="code-copy-btn" type="button" title="Copy" aria-label="Copy ${escapeHtml(label)} Base URL">` +
+                    '<svg width="16" height="16" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2" stroke-linecap="round" stroke-linejoin="round"><rect x="9" y="9" width="13" height="13" rx="2"/><path d="M5 15H4a2 2 0 0 1-2-2V4a2 2 0 0 1 2-2h9a2 2 0 0 1 2 2v1"/></svg>' +
+                    '</button></div>');
+            });
+            html.push('</div>');
+        }
+        else if (block.type === 'clients') {
+            const clients = block.lines
+                .map((line) => line.trim())
+                .filter(Boolean);
+            const columns = Array.from({ length: 3 }, () => []);
+            clients.forEach((client, index) => columns[index % columns.length].push(client));
+            html.push('<div class="docs-client-grid">');
+            columns.forEach((column) => {
+                html.push('<div class="docs-client-column">');
+                column.forEach((client) => html.push(`<span class="docs-client-item">${escapeHtml(client)}</span>`));
+                html.push('</div>');
+            });
+            html.push('</div>');
+        }
+        else if (block.type === 'tools') {
+            const tools = block.lines
+                .map((line) => line.trim())
+                .filter(Boolean)
+                .map((line) => {
+                const [packageName, title, description, command, linkLabel, linkTarget] = line
+                    .split('|')
+                    .map((part) => part.trim());
+                if (!packageName || !title || !description || !command || !linkLabel || !linkTarget)
+                    return null;
+                return { packageName, title, description, command, linkLabel, linkTarget };
+            })
+                .filter((tool) => tool !== null);
+            html.push('<div class="docs-tool-overview">');
+            tools.forEach(({ packageName, title, description, command, linkLabel, linkTarget }) => {
+                const sectionTarget = packageName === '@model-go/config' ? 'connect-ai-clients' : 'install-agent-tools';
+                html.push(`<section class="docs-tool-card" role="link" tabindex="0" data-doc-heading="${sectionTarget}" aria-label="${escapeHtml(title)}">` +
+                    `<span class="docs-tool-package">${escapeHtml(packageName)}</span>` +
+                    `<h3>${inlineMarkdown(title, ctx)}</h3>` +
+                    `<p>${inlineMarkdown(description, ctx)}</p>` +
+                    `<div class="docs-tool-command">${renderCodeBlock(command, 'bash')}</div>` +
+                    `<div class="docs-tool-link">${renderLink(`${linkLabel} ↗`, linkTarget, ctx)}</div>` +
+                    '</section>');
+            });
+            html.push('</div>');
+        }
+        else {
+            const items = block.lines
+                .map((line) => line.trim().match(/^[-*]\s+(.+)$/)?.[1])
+                .filter((item) => Boolean(item));
+            html.push('<aside class="docs-note">');
+            html.push('<div class="docs-note-title">' +
+                '<svg width="18" height="18" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2" stroke-linecap="round" stroke-linejoin="round"><circle cx="12" cy="12" r="9"/><path d="M12 11v5"/><path d="M12 8h.01"/></svg>' +
+                `<span>${inlineMarkdown(block.title || 'Note', ctx)}</span></div>`);
+            if (items.length) {
+                html.push('<ul>');
+                items.forEach((item) => html.push(`<li>${inlineMarkdown(item, ctx)}</li>`));
+                html.push('</ul>');
+            }
+            html.push('</aside>');
+        }
+        customBlock = null;
+    };
+    lines.forEach((line) => {
+        const trimmed = line.trim();
+        if (customBlock) {
+            if (trimmed === ':::')
+                closeCustomBlock();
+            else
+                customBlock.lines.push(line);
+            return;
+        }
+        const customFence = trimmed.match(/^:::(agent-tools|clients|endpoints|note|tools)(?:\s+(.+))?$/);
+        if (customFence) {
+            closeParagraph();
+            closeList();
+            closeTable();
+            customBlock = {
+                type: customFence[1],
+                title: customFence[2]?.trim() ?? '',
+                lines: [],
+            };
+            return;
+        }
+        const codeFence = line.match(/^```(\w+)?\s*$/);
+        if (codeFence) {
+            closeParagraph();
+            closeList();
+            closeTable();
+            if (codeOpen) {
+                closeCode();
+            }
+            else {
+                codeOpen = true;
+                codeLang = codeFence[1] ?? '';
+            }
+            return;
+        }
+        if (codeOpen) {
+            codeLines.push(line);
+            return;
+        }
+        if (!trimmed) {
+            closeParagraph();
+            closeList();
+            closeTable();
+            return;
+        }
+        if (trimmed.startsWith('|') && trimmed.endsWith('|')) {
+            closeParagraph();
+            closeList();
+            tableRows.push(trimmed);
+            return;
+        }
+        const heading = trimmed.match(/^(#{1,6})\s+(.+)$/);
+        if (heading) {
+            closeParagraph();
+            closeList();
+            closeTable();
+            const level = heading[1].length;
+            const rawTitle = heading[2].trim();
+            const explicitAnchor = rawTitle.match(/\s+\{#([A-Za-z][\w-]*)\}$/);
+            const title = explicitAnchor ? rawTitle.slice(0, explicitAnchor.index).trim() : rawTitle;
+            const id = explicitAnchor?.[1] ?? `heading-${toc.length + 1}`;
+            toc.push({ id, title, level });
+            if (level === 1 && !firstH1Skipped) {
+                firstH1Skipped = true;
+                return;
+            }
+            html.push(`<h${level} id="${id}">${inlineMarkdown(title, ctx)}</h${level}>`);
+            return;
+        }
+        const unorderedItem = trimmed.match(/^[-*]\s+(.+)$/);
+        const orderedItem = trimmed.match(/^\d+[.)]\s+(.+)$/);
+        const listItem = unorderedItem ?? orderedItem;
+        if (listItem) {
+            closeParagraph();
+            closeTable();
+            const nextListType = orderedItem ? 'ol' : 'ul';
+            if (listOpen && listType !== nextListType)
+                closeList();
+            if (!listOpen) {
+                listType = nextListType;
+                html.push(`<${listType}>`);
+                listOpen = true;
+            }
+            html.push(`<li>${inlineMarkdown(listItem[1], ctx)}</li>`);
+            return;
+        }
+        const quote = trimmed.match(/^>\s+(.+)$/);
+        if (quote) {
+            closeParagraph();
+            closeList();
+            closeTable();
+            html.push(`<blockquote><p>${inlineMarkdown(quote[1], ctx)}</p></blockquote>`);
+            return;
+        }
+        const imageOnly = trimmed.match(/^!\[[^\]]*\]\(([^)\s]+)\)$/);
+        if (imageOnly) {
+            closeParagraph();
+            closeList();
+            closeTable();
+            html.push(inlineMarkdown(trimmed, ctx));
+            return;
+        }
+        closeTable();
+        paragraph.push(trimmed);
+    });
+    closeParagraph();
+    closeList();
+    closeTable();
+    closeCustomBlock();
+    if (codeOpen)
+        closeCode();
+    return { html: html.join('\n'), toc };
+}
+// ── 站点目录 ────────────────────────────────────────────────────────
+// 站点目录映射：cn → china, global → international
+function getDocsDir(profile) {
+    return getDocsContentDirectory(profile);
+}
+// ── 站点变量 ────────────────────────────────────────────────────────
+const SITE_VARS = {
+    cn: {
+        platform_name: 'ModelGo',
+        site_endpoint: 'https://modelgo.com',
+        console_endpoint: 'https://console.modelgo.com',
+        api_endpoint: 'https://api.modelgo.com',
+        region_flag: 'domestic',
+    },
+    global: {
+        platform_name: 'ModelGo',
+        site_endpoint: 'https://modelgo.ai',
+        console_endpoint: 'https://console.modelgo.ai',
+        api_endpoint: 'https://api.modelgo.ai',
+        region_flag: 'global',
+    },
+};
+function substituteVars(text, profile) {
+    const vars = SITE_VARS[profile];
+    return text.replace(/\{\{\s*(\w+)\s*\}\}/g, (whole, key) => key in vars ? vars[key] : whole);
+}
+// ── 站点 API 地址 ───────────────────────────────────────────────────
+/**
+ * 站点的模型调用网关地址（正文里的 `{{ api_endpoint }}` 用的同一个值）。
+ *
+ * 首页 hero 的「Base URL」卡片过去写死成 `/api/v1`——相对路径对用户毫无意义（他们要的是
+ * 能直接粘进 SDK 的完整地址），而且国内/国际两站显示同一个值。这里导出真源给它复用，
+ * 避免再各写一份（需求方 shared/modelgo_prd#376「文档内也需要更新」）。
+ */
+export function siteApiEndpoint(profile) {
+    return SITE_VARS[profile].api_endpoint;
+}
+// ── 路径工具 ────────────────────────────────────────────────────────
+function dirOf(path) {
+    const i = path.lastIndexOf('/');
+    return i >= 0 ? path.slice(0, i + 1) : '';
+}
+function normalizeContentPath(path) {
+    const parts = [];
+    path.split('/').forEach((part) => {
+        if (!part || part === '.')
+            return;
+        if (part === '..')
+            parts.pop();
+        else
+            parts.push(part);
+    });
+    return parts.join('/');
+}
+// ── 导航解析 ────────────────────────────────────────────────────────
+function resolveNavItem(item, dir, lang, profile) {
+    const siteDir = getDocsDir(profile);
+    const relPath = normalizeContentPath(dir + item.file);
+    if (item.type === 'page') {
+        const raw = PAGES.get(`${siteDir}/${lang}/${relPath}`);
+        if (!raw)
+            return null;
+        const { meta } = parseFrontmatter(raw);
+        return { type: 'page', slug: item.slug, title: meta.title || item.slug, description: meta.description };
+    }
+    const meta = METAS.get(`${siteDir}/${lang}/${relPath}`);
+    if (!meta)
+        return null;
+    const children = (meta.items ?? [])
+        .map((child) => resolveNavItem(child, dirOf(relPath), lang, profile))
+        .filter((child) => child !== null);
+    return { type: 'section', slug: item.slug, title: meta.title, children };
+}
+export async function getDocsNav(lang, profile) {
+    const siteDir = getDocsDir(profile);
+    const top = METAS.get(`${siteDir}/${lang}/meta.json`);
+    if (!top)
+        throw new Error(`文档导航缺失：${siteDir}/${lang}/meta.json`);
+    const items = (top.items ?? [])
+        .map((item) => resolveNavItem(item, '', lang, profile))
+        .filter((item) => item !== null);
+    return adaptNav({ lang, title: top.title, description: top.description ?? '', items });
+}
+// ── frontmatter ─────────────────────────────────────────────────
+function parseFrontmatter(content) {
+    const match = content.match(/^---\r?\n([\s\S]*?)\r?\n---\r?\n?/);
+    if (!match)
+        return { meta: {}, body: content };
+    const meta = {};
+    match[1].split('\n').forEach((line) => {
+        const i = line.indexOf(':');
+        if (i > 0)
+            meta[line.slice(0, i).trim()] = line.slice(i + 1).trim();
+    });
+    return { meta, body: content.slice(match[0].length) };
+}
+export async function getDocsPage(slug, lang, profile, render) {
+    const siteDir = getDocsDir(profile);
+    const clean = slug.replace(/^\/+/, '');
+    const raw = PAGES.get(`${siteDir}/${lang}/${clean}.md`);
+    if (!raw)
+        throw new Error(`文档页面不存在：${siteDir}/${lang}/${clean}`);
+    const { meta, body } = parseFrontmatter(substituteVars(raw, profile));
+    const rendered = renderMarkdown(body, {
+        siteDir,
+        lang,
+        currentSlug: clean,
+        linkBase: render?.linkBase ?? '',
+        assetBase: render?.assetBase ?? '',
+    });
+    return {
+        slug: clean,
+        title: meta.title || rendered.toc[0]?.title || clean,
+        html: rendered.html,
+        markdown: body,
+        toc: rendered.toc,
+    };
+}
+// 极简 markdown → 纯文本（用于全文检索与摘要，无外部依赖）
+function toPlainText(markdown) {
+    return markdown
+        .replace(/^:::[^\n]*$/gm, ' ') // 自定义提示卡 / 地址卡片边界
+        .replace(/```[\s\S]*?```/g, ' ') // 代码块
+        .replace(/`([^`]+)`/g, '$1') // 行内 code
+        .replace(/!\[[^\]]*\]\([^)]*\)/g, ' ') // 图片
+        .replace(/\[([^\]]+)\]\([^)]*\)/g, '$1') // 链接保留文字
+        .replace(/^\s*[#>|]+/gm, ' ') // 标题 / 引用 / 表格分隔符
+        .replace(/^\s*[-*]\s+/gm, ' ') // 列表符号
+        .replace(/[*_~]/g, '') // 强调符号
+        .replace(/\s+/g, ' ')
+        .trim();
+}
+// 对已打包进内存的本地内容做客户端全文检索（标题命中优先）
+export function searchDocs(query, lang, profile, limit = 20) {
+    const q = query.trim().toLowerCase();
+    if (!q)
+        return [];
+    const siteDir = getDocsDir(profile);
+    const prefix = `${siteDir}/${lang}/`;
+    const hits = [];
+    for (const [key, raw] of PAGES) {
+        if (!key.startsWith(prefix) || !key.endsWith('.md'))
+            continue;
+        const slug = key.slice(prefix.length, -3); // 去 `${siteDir}/${lang}/` 前缀与 `.md` 后缀 = slug
+        const { meta, body } = parseFrontmatter(substituteVars(raw, profile));
+        const title = meta.title || slug;
+        const text = toPlainText(body);
+        const titleHit = title.toLowerCase().includes(q);
+        const bodyIdx = text.toLowerCase().indexOf(q);
+        if (!titleHit && bodyIdx === -1)
+            continue;
+        let excerpt;
+        if (bodyIdx !== -1) {
+            const start = Math.max(0, bodyIdx - 40);
+            excerpt = `${start > 0 ? '…' : ''}${text.slice(start, bodyIdx + q.length + 80).trim()}…`;
+        }
+        else {
+            excerpt = `${text.slice(0, 120).trim()}…`;
+        }
+        hits.push({ slug, title, excerpt, score: titleHit ? 0 : 1 });
+    }
+    return hits
+        .sort((a, b) => a.score - b.score || a.title.localeCompare(b.title))
+        .slice(0, limit)
+        .map((r) => ({ slug: r.slug, title: r.title, excerpt: r.excerpt }));
+}
+/**
+ * 某站点 + 语言下的全部文档 slug（相对 <profile>/<lang>/ 的文件路径，无扩展名）。
+ * 官网构建期用它生成静态路由（getStaticPaths）。
+ */
+export function getDocSlugs(lang, profile) {
+    const siteDir = getDocsContentDirectory(profile);
+    const prefix = `${siteDir}/${lang}/`;
+    const slugs = [];
+    for (const key of PAGES.keys()) {
+        if (!key.startsWith(prefix) || !key.endsWith('.md'))
+            continue;
+        slugs.push(key.slice(prefix.length, -3));
+    }
+    return slugs.sort();
+}
+/**
+ * 更新日志（仓库根 changelog.md）：不分市场/语言，只有一份。
+ * 它原来走 VitePress 自己的页面渲染（客户端再渲染），并入官网后同样要吃服务端 HTML。
+ */
+export function getChangelog(profile, render) {
+    const { meta, body } = parseFrontmatter(substituteVars(DOCS_CHANGELOG, profile));
+    const rendered = renderMarkdown(body, {
+        siteDir: getDocsContentDirectory(profile),
+        lang: 'en',
+        currentSlug: 'changelog',
+        linkBase: render?.linkBase ?? '',
+        assetBase: render?.assetBase ?? '',
+    });
+    return { title: meta.title || 'Changelog', html: rendered.html, toc: rendered.toc };
+}

package/package.json

@@ -0,0 +1,39 @@
+{
+  "name": "@model-go/docs-core",
+  "version": "0.1.0",
+  "description": "ModelGo 文档内容与渲染器的单一真源（SSOT）：内容 + 纯渲染器，供文档站与官网共用",
+  "type": "module",
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    },
+    "./content": {
+      "types": "./dist/content.generated.d.ts",
+      "import": "./dist/content.generated.js"
+    },
+    "./styles/*": "./styles/*",
+    "./assets/*": "./assets/*"
+  },
+  "files": [
+    "dist",
+    "styles",
+    "assets",
+    "README.md"
+  ],
+  "publishConfig": {
+    "access": "public"
+  },
+  "devDependencies": {
+    "typescript": "^5.9.3"
+  },
+  "scripts": {
+    "build": "tsc -p tsconfig.json && node scripts/build-content.mjs",
+    "sync:assets": "node scripts/sync-assets.mjs",
+    "typecheck": "tsc -p tsconfig.json --noEmit",
+    "gate:prepublish": "node scripts/prepublish-gate.mjs",
+    "gate:readme": "node scripts/readme-gate.mjs"
+  }
+}