#!/usr/bin/env python3 # -*- coding: utf-8 -*- """ docs 文档渲染器(零依赖 Markdown → HTML) ======================================== 背景 ---- `docs/` 里有全套技术文档(benchmark 分数表、验证 harness、雷达 shadow gate、 情报简报……),但它们此前**没有任何对外通道**:GitHub Pages 的 `lm203688.github.io/aishield` 被 CNAME 重定向到 `aishield.tools`,Jekyll 构建 产物从未被任何人访问过;而 `aishield.tools` 由 `api/server.py` 托管,它只有 逐页硬编码的静态路由,没有 `docs/` 挂载点。 于是 benchmark 的 96% 召回 / 0% 误报、harness 的复现方法,全部只存在于 git 仓库里 —— 外部用户看不到,等于不存在。 本模块补上这个通道:`/docs/<相对路径>` → 读 `docs/` 下对应文件 → 渲染成 HTML 返回。这样 `https://aishield.tools/docs/benchmark/v1.html` 直接可达。 设计约束 -------- * **零依赖**:项目铁律是不引入任何第三方包,所以这里手写一个覆盖常见 Markdown 子集(标题 / 表格 / 代码块 / 列表 / 引用 / 粗体 / 行内代码 / 链接) 的渲染器,而不是 import markdown。 * **先转义后转换**:文档内容来自 git,理论上可信,但它会被渲染进网页。 渲染顺序必须先把 `<` `>` `&` 转义,再叠加 Markdown 语法,否则文档里 出现的 `` `