版本演进与架构分层规范
EES-004 标准 · 语义化变更、部署追溯、架构分层与授权边界
版本识别的三重维度
在 EpoCanvas 工程体系中,严禁将未经验证的构建号当作版本。我们严格区分三种互补的标识:
描述某篇规范、页面或文章的契约变更,遵循 MAJOR.MINOR.PATCH 语义。
精确指出本地与远端源文件的完整代码状态,严禁无 commit 交付。
指出产物在全球边缘节点生效的具体部署记录与时间戳凭证。
何时提升版本号?
根据修改的影响范围,严格执行语义化升级:
不相容破坏性变更
- API 接口字段改名或删除
- 数据库 Migration 结构性重构
- 核心鉴权或会话机制重构
向后相容的功能扩展
- 新增独立页面或展示面板
- 新增向下兼容的 API 查询参数
- 社群规则或新协议章节发布
缺陷修复与排版勘误
- 样式错位修复与视觉对齐
- 文章错字修正、链接勘误
- 不影响公开契约的内部性能优化
EpoCanvas 4 层工程架构
分层解耦,确保静态生成与边缘动态能力的稳定共存:
严禁未提交/未部署即交付
本仓库遵循最严格的发布工程守则,每一次正式变更均须通过完整流水线:
每项独立改动立即 commit,必须在终端明确打印 7 位 short hash。
保证 origin (主仓库) 与 cf (部署仓库) 100% 同步推送到远端。
通过 Wrangler 部署至生产边缘环境,杜绝本地能跑线上跑崩的隐患。
调用 Playwright / Puppeteer 访问真实生产域名,控制台 0 报错验证。
资产与授权边界
不同资产遵循清晰的授权划分,保护原创同时拥抱开源:
完全开放,自由 fork、修改与二次分发,保留署名即可。
署名、非商业性使用、相同方式共享,保护原创思想主权。
尊重 upstream 许可,包含 Lucide、Astro、Tailwind 及字体授权。
查阅完整 EES-004 工程规范标准
若需查看完整的 SemVer 文本说明、API 破坏性变更细则与详细算法公式,请移步官方工程标准文档。




