Changelog

文档更新 2026-09-30 —— 值变更表（`gops sys diff` / `gops mod diff`）

命令行工具：cmd/gops.md 新增「展示系统值变更」与「展示模块值变更」两节（列含义、未展开值比对、--json、localize 末尾附带变更表）；gops prj diff 标注暂不提供；mod localize / sys localize 补文件变更表（created/replaced，前后内容指纹比对）；sys diff 补 gxl 系统的模块分组（[mod: <name>]，values/<mod>/mod_value.yml）与 --json 新结构

System 文档：kind: docker-compose 的 compose 文件默认从系统根移至 sys/docker-compose.yaml，并补充查找顺序、compose 项目目录锚定系统根、旧布局仍兼容的说明；同步 operator/sys/structure/directory.md、file-organization.md、naming-conventions.md、operator/sys/README.md、operator/sys/examples/docker-compose.md、operator/sys/troubleshooting/common-issues.md、operator/overview.md、operator/roadmap.md
命令行工具：cmd/gops.md 的系统目录结构与 .env 消费说明改为 sys/docker-compose.yaml

book.toml 的 src 由 ./ 改为 src，站点内容（SUMMARY.md、README.md、CHANGELOG.md、cmd/、gxl/、operator/、config/、buildin.md、work.md、mermaid.min.js、favicon.svg）平移至 src/
原因：站点源为仓库根时，mdBook 会把 .git/（约 5.2MB，含 objects/refs）、.github/、.gitignore 一并拷进 book/ 产物（并且遍历 .git 时会撞上 git 临时 index 文件而偶发构建失败）。移入子目录后这些落在站点源之外
theme/ 保留在 book.toml 同级（mdBook 从 book root 取 theme/，已实测确认）；产物不再包含 book.toml
galaxy-flow 的 scripts/sync-gxl-docs.sh 默认 --dest 与 GXL docs sync check workflow 同步改为 src/gxl

移植 wp-docs 的 VitePress 风格 mdBook 主题：新增 theme/（site.css 与上游一致；site.js 裁掉 wp 专有的顶栏/中英切换/版本横幅，保留侧栏折叠、侧栏宽度持久化、本页目录、mermaid 主题联动），book.toml 设 default-theme / preferred-dark-theme 并指向该目录
favicon 改由 theme/favicon.svg 提供；删除 mermaid.css（其内容是一段报错文本，被误当样式表引用）
mermaid.min.js 改为按需懒加载（站内无 mermaid 图，原先每页白加载 2.9MB）
CI 固定 mdBook 0.5.2：主题依赖 0.5 的 DOM 结构

命令行工具：cmd/gflow.md 重写为 cmd/gx.md（命令表按实机 gx --help 校正）；移除 gmod / gsys 条目，gprj 标注 legacy；cmd/gops.md 按当前实现重写（ops-systems.yml 已并入 ops-prj.yml、sys localize 参数、sys package / prj reimport / sys new --kind）
维护器：operator/sys/* 补齐 kind（gxl / docker-compose）分派、sys-model 字段、GXL 与 docker-compose 两套目录结构、merged_vars.yml / sys_value.yml / .env 与常见问题，并新增 docker-compose 示例；operator/mod/* 与 README 同步 gx 名称
工程：SUMMARY.md 清掉指向不存在文件的条目并注册新页；book.toml 移除非法字段 multilingual（mdbook build 恢复可用）；并入 galaxy-sec → galaxio-labs 署名

从 v0.8.3 升级到 v0.8.6 向后兼容；建议试用新的日志重定向与逻辑表达式功能。

extern mod head { path = "${GXL_START_ROOT}/_gal/"; }