DeepBlueBuilder · 深蓝构建器

深蓝工坊生态 — 静态站点生成器。扫描三个内容仓库（DeepBluePrompt、DeepBlueCase、DeepBlueKit），解析 YAML Frontmatter 元数据，校验格式完整性，生成双索引清单文件和纯静态 HTML 站点。

核心能力

内容仓库 (.md + YAML)  →  扫描解析  →  格式校验  →  双索引生成  →  HTML 渲染
                         scanner    validator   manifestBuilder  htmlBuilder

1. 扫描 — 递归遍历三个仓库，解析每个 .md 文件的 YAML Frontmatter
2. 校验 — 检查必填字段（id/name/type/category/score/summary）+ 死链检测
3. 双索引 — 生成 manifest.json（完整字段，前端面板用）和 manifest.ai.json（精简字段，Token 降低 60%）
4. HTML — 基于 Handlebars 模板渲染列表页、详情页和总览首页

深蓝工坊仓库布局

DeepBlue/
├── DeepBluePrompt/       ← 提示词库（扫描目标）
├── DeepBlueCase/         ← 案例坊（扫描目标）
├── DeepBlueKit/          ← 工具集（扫描目标）
└── DeepBlueBuilder/      ← 本项目
    ├── src/
    │   ├── index.ts           # 主入口，编排全流程
    │   ├── scanner.ts         # 扫描三仓库，提取 YAML
    │   ├── manifestBuilder.ts # 生成 manifest.json + manifest.ai.json
    │   ├── htmlBuilder.ts     # 生成静态 HTML 页面
    │   └── validator.ts       # YAML 格式校验 + 死链检查
    ├── templates/             # Handlebars 模板
    ├── output/                # 生成的 HTML 站点
    └── dist/                  # 编译后的 TypeScript

快速开始

# 安装依赖
npm install

# 编译 TypeScript
npm run build

# 运行完整流水线（扫描→校验→清单→HTML）
npm start

# 仅扫描和校验（不生成文件）
npm run scan

# 仅生成清单文件
npm start -- --manifests-only

# 仅生成 HTML
npm start -- --html-only

命令说明

命令	说明
npm run build	TypeScript → dist/
npm start	完整流水线
npm run scan	扫描 + 校验（YAML 格式 + 死链检测）
npm start -- --manifests-only	仅生成 manifest 文件
npm start -- --html-only	仅生成 HTML 页面

生成物

运行后在三个内容仓库中生成/更新：

文件	用途
manifest.json	完整索引（21 个字段），供前端面板和人类浏览
manifest.ai.json	AI 精简索引（8 个字段），Token 消耗降低 ~60%

output/ 目录生成：

输出	说明
output/index.html	三仓库总览首页
output/{repo}/index.html	单仓库列表页
output/{repo}/{id}/index.html	资源详情页

双索引设计原理

AI 上下文窗口有限且按 Token 计费。manifest.ai.json 比 manifest.json 减少 60% Token 消耗，同时保留检索所需的足够信息。驾驭工程 Agent 检索时先命中 manifest.ai.json，在确定相关后再读取完整 YAML，实现"用最少 Token 找到最准的资源"。

License

MIT