MakerHub 开发报告:v1.0.0 → v1.1.0(单日 26 提交,图片渲染、目录跟随与数据真实化)
版本基线 :v1.0.0 → v1.1.0
署名 :Maker × DeepSeek 联合打造
单日提交 :26 个(
5fdd70a→65bb39b)质量状态:171/171 单元与组件测试(37 文件)· E2E 13/13 · lint 0 error · build ✅
一、版本号:为什么是 v1.1.0?
| 版本 | 语义 | 内容 |
|---|---|---|
| v1.0.0 | 首个稳定版 | 代码浏览器(行号/搜索/ZIP)、Git 时间线、分享面板、移动端抽屉、局域网访问 |
| v1.1.0 | 功能增量 | 内容图表能力(图片库 + Mermaid + 灯箱)、目录跟随、站内刷新、表格美化、数据真实化、自举与第三篇心得、白屏修复 |
晚间所有工作为向后兼容的新功能 + 修复 (无破坏性变更、无 API 破坏)→ 语义化版本应升 minor ,即 v1.1.0------这是遵循 SemVer 的自动结论。
二、操作全景(26 提交三大类)
A. 界面与移动端体验(4 个提交)
| 提交 | 内容 |
|---|---|
de4266c |
手机端项目页整体排版:16px 边距、统计卡 3 列一排、模块内边距收紧------标题满、内容也满 |
fb9d592 / 65baa87 |
移动端代码浏览器:文件树改侧滑抽屉(Teleport to body 摆脱 transform 劫持),代码区 267→467px |
c9a89a9 |
Git 时间线统计条两行布局(窄列「N 位贡献者」不再溢出) |
B. 展示与数据真实性(5 个提交)
| 提交 | 内容 |
|---|---|
b1f2e50 |
MakerHub 自举上线:自家项目进自家项目集(69 文件/8207 行/36 提交),快照管线排除 content 目录 |
73c3c71 |
git log 提取后的快照重新生成(RNN/LSTM/MakerHub 三套 code.json) |
c339eba |
版本号统一 0.0.0 → 1.0.0(package.json + lock)+ author/description 元数据 |
74e2eb5 |
项目页介绍渲染异常修复(frontmatter 字段名全错:skills→tags、durationDays→days、features 对象数组→string\[\])+ v1.0.0 版本徽章(插件白名单补 version 映射) |
59abf87 |
数据全面真实化(git 溯源) :RNN 35提交/20天/1500行 → 实测 22/9/451;LSTM 60/15/2200 → 11/2/390;MakerHub 08-08 起/24 天 → 08-31 起/2 天(git log 实锤);里程碑挑真实提交;「学习历程」→「开发历程」;修复里程碑日期 NaN 恶疾(YAML Date 对象未 normalize) |
C. 内容能力(12 个提交)
| 提交 | 内容 |
|---|---|
112fee4 |
文章图片 + Mermaid 流程图渲染:编号图片库(无存储概念,放文件即用);markdown 自定义 image/fence 规则;mermaid.ts 懒加载渲染 + 失败降级源码;Lightbox 灯箱;Pregel 文章加真实流程图示例 |
9ae696c |
文章目录自动跟随:59 项长目录 active 项滚入可视区(scrollIntoView nearest,不干扰页面) |
06e2e82 |
流程图可读性三件套:Mermaid 配置放大(18px/间距 60-70)、点击灯箱 1:1(814→1293px 放大 136%)、超宽不压缩横向滚动兜底 |
5b28394 |
站内刷新入口:顶部刷新按钮(旋转反馈)+ 命令面板 Ctrl+K 搜「刷新」------查看效果不再关窗口重开 |
338f4fc |
第三篇心得上线《实战 03:Workflows 与 Agents》(原文逐字保留 325 行 0 差异);文章表格现代卡片式升级(圆角/表头浅底/行 hover/代码胶囊);修复 Mermaid subgraph 中文名 Lexical error |
65bb39b |
修复白屏 bug:文章页点导航空白(多根组件 + `` = 新页面永不挂载)→ 灯箱全局化(useLightbox + App.vue 单实例),路由恢复 |
小结
v1.1.0 的关键词:真实化 + 内容能力。数据从"宣传值"走向"git 可查证值",文章从纯文本走向"图片 + Mermaid + 灯箱"。质量闸门全绿:171 测试、13 E2E、TS 严格模式、build ✅。
「吃自己的狗粮」------ v1.1.0 的 MakerHub 已经能渲染它自己的开发报告:这篇文章里的表格、版本号、提交记录,都出自真实仓库。