#SemVer 2.0#Git Commit SHA#Astro 6
#Cloudflare Edge#Edge Native#Zero Uncommitted

版本演进与架构分层规范

EES-004 标准 · 语义化变更、部署追溯、架构分层与授权边界

核心原则 · Principles

版本识别的三重维度

在 EpoCanvas 工程体系中,严禁将未经验证的构建号当作版本。我们严格区分三种互补的标识:

📝
内容语义版本Markdown Frontmatter (SemVer)

描述某篇规范、页面或文章的契约变更,遵循 MAJOR.MINOR.PATCH 语义。

🔀
源码提交标识Git Commit SHA

精确指出本地与远端源文件的完整代码状态,严禁无 commit 交付。

☁️
边缘部署凭证Cloudflare Pages Deployment ID

指出产物在全球边缘节点生效的具体部署记录与时间戳凭证。

SemVer 2.0 · 规则矩阵

何时提升版本号?

根据修改的影响范围,严格执行语义化升级:

MAJORX.0.0

不相容破坏性变更

  • API 接口字段改名或删除
  • 数据库 Migration 结构性重构
  • 核心鉴权或会话机制重构
MINOR0.X.0

向后相容的功能扩展

  • 新增独立页面或展示面板
  • 新增向下兼容的 API 查询参数
  • 社群规则或新协议章节发布
PATCH0.0.X

缺陷修复与排版勘误

  • 样式错位修复与视觉对齐
  • 文章错字修正、链接勘误
  • 不影响公开契约的内部性能优化
⚡ 快速变更判定器
PATCH仅需递增补丁号 (+0.0.1)
架构拓扑 · Architecture Layers

EpoCanvas 4 层工程架构

分层解耦,确保静态生成与边缘动态能力的稳定共存:

L4
全球边缘治理与合规层 (Edge & Compliance)
Cloudflare Pages_headers 安全策略Stripe ElementsTG 异步通知
L3
轻量 Serverless 与数据持久层 (Functions & D1)
Cloudflare FunctionsD1 SQLite 数据库访客会话签权零第三方追踪
L2
岛屿架构与渲染引擎 (Astro Islands & UI)
Astro 6 SSGReact 19 IslandsVanilla TS 高性能交互PWA 离线底座
L1
内容与规范契约层 (Content & Contracts)
Markdown / MDX 规范SemVer 语义化标定Git SHA 绝对追溯多语言规范
工程准则 · Delivery Protocol

严禁未提交/未部署即交付

本仓库遵循最严格的发布工程守则,每一次正式变更均须通过完整流水线:

01
单步提交与 Hash 输出

每项独立改动立即 commit,必须在终端明确打印 7 位 short hash。

02
全量多远端镜像推送

保证 origin (主仓库) 与 cf (部署仓库) 100% 同步推送到远端。

03
Cloudflare 边缘节点编译发布

通过 Wrangler 部署至生产边缘环境,杜绝本地能跑线上跑崩的隐患。

04
无头浏览器线上真机审计

调用 Playwright / Puppeteer 访问真实生产域名,控制台 0 报错验证。

开源授权 · Licensing

资产与授权边界

不同资产遵循清晰的授权划分,保护原创同时拥抱开源:

💻
源代码与主题实现MIT License

完全开放,自由 fork、修改与二次分发,保留署名即可。

✍️
文章、自述与原创文字CC BY-NC-SA 4.0

署名、非商业性使用、相同方式共享,保护原创思想主权。

📦
第三方依赖与字型图标各自原生协议

尊重 upstream 许可,包含 Lucide、Astro、Tailwind 及字体授权。