CF FIELDBOOK/资料维护

六张图,六个问题

这些是同一份设计的分视图,不是截图、图片生成或互不相干的手绘示意。每张图由本目录 .mmd 通过 Mermaid 渲染,正文中另有等价说明。候选架构不等于所有目标机制已经实现。

图 看什么 可编辑源 阅读图
架构 材料、编辑源、检查与输出 Mermaid SVG
更新影响 依赖、相关、历史勘误 Mermaid SVG
内容生命周期 修订、取代、归档、撤下 Mermaid SVG
出版 只读构建、版次与勘误 Mermaid SVG
资料架更新与撤下 新原件、当前指针、读取资格与后续清理;是扩展设计 Mermaid SVG
示例执行 离线默认、云端授权、清理 Mermaid SVG

青色边框表示编辑对象或阅读输出,橙色表示核查/判断位置,浅灰表示外部材料或历史路径。所有状态仍有文字;虚线表示旁路或辅助关系,含义由边上的标签决定。图不使用产品商标、猫脸节点或背景纹样。

重建#

当前渲染引擎由 package.json 精确指定为 Mermaid 11.17.2,完整依赖树锁在 package-lock.json。本地 Chromium 运行 Mermaid 的 render API。实际引擎、模块依赖、源、配置与 SVG 摘要保存在 manifest,用于检查源与产物是否配套。

npm ci --ignore-scripts
.venv/bin/python -m pip install -r requirements-design.txt
.venv/bin/python -m playwright install chromium
.venv/bin/python tools/render_diagrams.py
.venv/bin/python tools/render_diagrams.py --check

依赖和浏览器安装会访问软件源;渲染只读本地模块。已有兼容 Playwright Chromium 时不必重新下载,可通过 --browser 指定。当前只维护 npm 锁定依赖路径。更换 Mermaid 版本先改 package/lock,再重新渲染、检查配套并看图,不只刷新摘要。

导出做两项统一兼容处理:添加真正的白底矩形;把 Mermaid 生成的同样式词级 tspan 合成单个行级 tspan,避免某些 SVG 打印引擎错误分配词位置。文字、行坐标、节点、边来自 Mermaid;未手改图意或移动节点。

跨字体/浏览器环境可能产生几何差异。本包的 --check 比较当前环境的重新渲染结果,不宣称跨平台像素完全相同。任何引擎升级或版面变化都要看实际图。

阅读尺度#

架构图为横向概览;另外几张以纵向流程为主。网页为宽图保留局部横向滚动,旁边提供完整解释;打印时按实际图宽分配页面。不要把六张拼成一页后再要求读者放大猜文字。

架构:材料、编辑源与阅读出口

架构:材料、编辑源与阅读出口
架构:材料、编辑源与阅读出口 · 打开全尺寸 SVG

Mermaid 源码

更新影响:相关,不等于依赖

更新影响:相关,不等于依赖
更新影响:相关,不等于依赖 · 打开全尺寸 SVG

Mermaid 源码

内容生命周期:修订不抹掉上一版

内容生命周期:修订不抹掉上一版
内容生命周期:修订不抹掉上一版 · 打开全尺寸 SVG

Mermaid 源码

出版流程:源码向产物流动

出版流程:源码向产物流动
出版流程:源码向产物流动 · 打开全尺寸 SVG

Mermaid 源码

实验生命周期:运行完还要收得回来

实验生命周期:运行完还要收得回来
实验生命周期:运行完还要收得回来 · 打开全尺寸 SVG

Mermaid 源码

资料架:更新与撤下怎样分工

资料架:更新与撤下怎样分工
资料架:更新与撤下怎样分工 · 打开全尺寸 SVG

Mermaid 源码

术语 / FIELD NOTES

在词表中继续阅读