更新日志

v1.4.10

芋道移动端入口 · 环境分册

本版概要（2026-09-20）：

芋道运行环境迁到 docs/environment/，并拆成开发 / 测试 / 生产子页。
应用访问与顶栏增加开发环境移动管理、商城 H5 入口；部署架构同步。

🚀 新增

【新增】芋道开发移动管理 http://192.168.31.103:8081、商城 http://192.168.31.103:8082
【新增】芋道环境子页：/environment/yudao/dev/ · /test/ · /prod/
【新增】网站链接 · Marvis 马维斯

🔨 优化

【优化】运行环境正文迁出 portal/environment；门户短路径侧栏用 portalSidebarPaths 挂载
【优化】芋道部署架构图改为管理后台 / 移动管理 / 商城分别进 API
【优化】站点约定补充项目环境可再分开发 / 测试 / 生产

v1.4.9

芋道开发环境访问说明

本版概要（2026-09-19）：

芋道运行环境页按访问清单整理开发环境（SSH、MySQL、Redis、管理后台、接口）。

🔨 优化

【优化】/environment/yudao/：开发环境改为地址清单；口令不写入公开页

v1.4.8

WireGuard 创建文档

本版概要（2026-09-18）：

运维新增 PVE TurnKey WireGuard 创建与联调排障文档。
同步家庭网络节点、基建顺序与侧栏入口。

🚀 新增

【新增】/ops/proxmox/wireguard/：TurnKey CT 创建、客户端、UDP 51820、DDNS 仅 IPv4 与排障

🔨 优化

【优化】Proxmox 客户机一览与基建顺序备忘；家庭网络 / VPN 目录交叉链接

v1.4.7

OpenClaw 快捷入口 · Karing 链接

本版概要（2026-09-17）：

快捷入口增加飞牛 OpenClaw 聊天。
网站链接「运维安全」增加 Karing Releases。

🚀 新增

【新增】快捷入口：OpenClaw（192.168.31.186:5666 · trim-openclaw）
【新增】网站链接：Karing → GitHub Releases

v1.4.6

运行环境对齐 SER6 实装

本版概要（2026-09-16）：

按 PVE 实装刷新运行环境 / 芋道地址 / 家庭网络节点；LXC 末段 = VMID。
补全开发 / 测试入口与模板克隆说明。

🚀 新增

【新增】芋道开发 / 测试访问地址（.103 / .104 · :8080 / :48080）
【新增】tpl-yudao / test-yudao 实装记录与链接克隆说明

🔨 优化

【优化】Proxmox 客户机一览：VMID + 实装 IP；KVM 仍记 DHCP 地址并标注对齐目标
【优化】运行环境主机表、应用访问、家庭网络交叉链接

v1.4.5

Proxmox 创建文档 · 运行环境 · 入口补全

本版概要（2026-09-16）：

运维新增 PVE 客户机创建文档（飞牛 fnOS / Ubuntu Server / dev-yudao）。
补全 Ubuntu Server 运行环境页，以及快捷入口、网站链接与家庭网络节点交叉链接。

🚀 新增

【新增】/ops/proxmox/：总览 + 创建飞牛 fnOS、Ubuntu Server、dev-yudao（LXC）
【新增】运行环境：Ubuntu Server 26.04（192.168.31.129）；口令仅占位
【新增】快捷入口：Proxmox VE、飞牛fnOS；网站链接：清华开源镜像站

🔨 优化

【优化】家庭网络关键节点补 .101 / 创建文档链接；芋道环境页挂开发 LXC
【优化】运维侧栏「主机运维」下增加 Proxmox VE 分组

v1.4.4

架构图 · 链接 · 首页 hero

本版概要（2026-09-14）：

新增家庭网络拓扑与芋道 / WordPress 部署、模块架构图；统一 Mermaid flowchart 配色与自适应。
网站链接补充浪浪云、Matomo、Navicat；首页 hero 修复标题裁切并取消头像偏移。

🚀 新增

【新增】家庭网络 /ops/network/：工作室拓扑总览，链设备资产 / 快捷入口
【新增】芋道 / WordPress 环境页部署架构、芋道介绍页模块架构（Mermaid）
【新增】网站链接：浪浪云、Matomo、Navicat Premium Lite

🔨 优化

【优化】Mermaid：useMaxWidth + 黑白灰 theme: base；mermaid.css 约束 SVG 宽度
【优化】首页 hero：实色品牌名防裁切；取消主题头像 translate(-32px,-32px)
【优化】设备资产表格去掉重复 title= 文案；约定页补充架构图落点

🐞 修复

【修复】architecture 短语法易 Syntax error，改回 flowchart 同款写法

v1.4.3

补全 package-lock peer 依赖

本版概要（2026-09-13）：

修复 Actions npm ci 报 Missing markdown-it@15 / entities@8 等（lock 不完整）。

🐞 修复

【修复】完整重生成 package-lock.json，写入 peer 所需嵌套依赖后再供 npm ci

v1.4.2

文档凭据脱敏 · CI 装包

本版概要（2026-09-13）：

响应 GitGuardian 告警：文档与 SQL 样例去掉真实库主机/口令；补充禁止真实凭据约定。
修复 Actions npm install 因 lock 指向 npmmirror/CDN 而失败。

🚀 新增

【新增】约定与规则：文档禁止真实 JDBC/Redis/口令（no-secrets-in-docs）

🐞 修复

【修复】公开仓中的数据库连接示例与积木报表外网数据源记录（改为占位主机与 <your-password>）
【修复】package-lock / .npmrc 统一 registry.npmjs.org；CI 改用 npm ci

v1.4.1

发版顺序钉死 · 样式入口修复

本版概要（2026-09-13）：

约定发版必须先检查再提交；修复 CSS @import 导致开发服 ENOENT。

🚀 新增

【新增】站点约定「分支与发版」：先 docs:check:build → plume 提交 → 合 main → 再 push

🔨 优化

【优化】client.ts 直接引入样式片段，去掉 CSS 内 @import

🐞 修复

【修复】postcss 将 ./brand.css 解析到仓库根导致本地打开报错

v1.4.0

资源与首页收口 · 构建加固

本版概要（2026-09-13）：

修复 CI 裸相对图片导致的 Vite 构建失败；压缩站点大图并去重音乐封面。
首页精简；样式拆分；PMP 侧栏与配图引用整理；开发分支约定为 plume。

🚀 新增

【新增】静态资源双轨约定（public 跨页 / 文旁 ./ 配图）写入 /conventions/
【新增】docs:check 拦截裸相对资源路径，并对过大图片告警 / 超限失败
【新增】样式拆分：brand.css / home-hero.css / dark-button.css

🔨 优化

【优化】首页去掉日常入口与套话，知识入口补齐 8 项（含音乐）
【优化】首页 hero 与顶栏间距（--home-doc-hero-offset）
【优化】大批量压缩 PMP / DSM / OpenWrt / 音乐等图片；音乐封面只保留 public
【优化】PMP 侧栏：ITTO 按 4–13 排序；章节练习题显式三项（去掉 junk auto）
【优化】日常开发在 plume，push 前再合并 main

🐞 修复

【修复】DSM 等 ![…](image.png) 被 Rolldown 当包解析导致 CI docs:build 失败
【修复】光环课程笔记等含空格文件名的图片引用（URL 编码）

v1.3.0

约定上站 · 以 main 发布

本版概要（2026-09-13）：

站点约定页与 Cursor 规则双写；commit/push 时同步写更新日志。
发布分支改为 main；GitHub Actions 仅在 main 推送时构建部署。

🚀 新增

【新增】站点约定 /conventions/（顶栏版本下拉与更新日志同级）
【新增】.cursor/rules/：Plume 优先、忌套话、自动重启、信息架构、规则双写、commit 写日志
【新增】push 前门禁：npm run docs:check / docs:check:build（死链与缺资源扫描 + 完整构建）；CI 同步先 check 再 build
【新增】Git tag 与更新日志版本统一（v1.0.0 … v1.3.0）

🔨 优化

【优化】门户页去掉实现说明类套话
【优化】更新日志拆为 v1.2.0 / v1.1.0 / v1.0.0，标题不用 【】
【优化】CI：on.push.branches: [main]，产物目录 docs/.vuepress/dist

🐞 修复

【修复】避免 base / 其它分支 push 误触发线上部署

v1.2.0

体验打磨 · Plume 约定收口

本版概要（2026-09-13）：

深色主题、首页、LinkCard 使用范围与配置拆分收口。
补齐更新日志页与顶栏版本入口。

🚀 新增

【新增】更新日志 /changelog/（本页）；顶栏版本号 + badge「新」
【新增】首页两组 features（日常入口 / 知识文档），Iconify 与顶栏同系

🔨 优化

【优化】LinkCard 仅用于网站链接与音乐曲目；应用访问 / 快捷入口改为 Markdown 列表；站点导航只留 Markmap
【优化】自定义样式只保留品牌色等 CSS 变量；去掉首页布局硬改
【优化】markdown 只写在 config.ts；bilibili / table 双写 markdownPower
【优化】ai、operation 侧栏 auto；文章正文从 ## 起、去掉重复 H1
【优化】logo + logoDark；深色 brand 按钮黑字

🐞 修复

【修复】深色主题字色被 :root 覆盖、首页 brand 按钮看不清
【修复】运维页残留 <BilibiliPlayer>、无效 aside: 'right'
【修复】@[bilibili] / Markmap 缓存导致不渲染（清缓存并重启）

v1.1.0

门户与日常入口

本版概要（2026-09-13）：

顶栏改为日常入口，知识库从站点导航进入。
补齐链接、资产、相册、应用 / 快捷拆分等门户能力。

🚀 新增

【新增】顶栏：站点导航 · 运行环境 · 应用访问 · 快捷入口 · 网站链接 · 设备资产
【新增】站点导航 /map/：Plume Markmap
【新增】网站链接 /links/：LinkCard + VPCardGrid（3 列）及收藏录入
【新增】设备资产 /assets/：总表 + 明细，::: table full-width
【新增】相册 /photos/：::: card-masonry
【新增】应用访问 BERNSINE；快捷入口 Fast-Note-Sync、ImmortalWrt
【新增】运行环境占位：芋道 / WordPress（地址待补）

🔨 优化

【优化】应用访问与快捷入口拆成两个一级顶栏
【优化】日常浏览页统一左侧侧栏 + 右侧 outline
【优化】音乐页艺人 ImageCard、曲目 LinkCard；视频 @[bilibili]
【优化】门户收拢 docs/portal/，对外短 permalink
【优化】去掉运营「水印」空壳；关于不进顶栏

🐞 修复

【修复】permalink / 顶栏变更后 HMR 不刷新导致 /map/ 等 404
【修复】链接页图标与收藏 URL 录入问题

v1.0.0

VuePress 2 + Plume 迁移

本版概要（2026-09-12）：

文档站从 VitePress 迁到 VuePress 2 + vuepress-theme-plume。
文档源仍为 docs/，开发分支 plume。

🚀 新增

【新增】主题切换为 vuepress-theme-plume；Node ≥ 22.18
【新增】启用 Mermaid、Bilibili 等 Plume markdown 能力
【新增】首页 doc-hero + features 基础结构

🔨 优化

【优化】运维侧栏按主机 / 容器 / 网络 / 存储等场景重梳（正文路径未大挪，避免断链）
【优化】删除无用 npm 文档壳、.vitepress 残留目录

🐞 修复

【修复】构建与 Vite 8 / rolldown 下主题 SFC 需传入 script.fs