Servify DocsServify Docs
首页
架构
实施计划
  • WeKnora 集成
  • CI / Runner
  • 版本发布
  • 测试金字塔
  • Mermaid 兼容性
GitHub
首页
架构
实施计划
  • WeKnora 集成
  • CI / Runner
  • 版本发布
  • 测试金字塔
  • Mermaid 兼容性
GitHub
  • 站点导航

    • Servify Docs
    • 架构总览
    • WeKnora 集成完整指南
    • GitHub Hosted CI
    • Release Versioning
    • Testing Pyramid
    • Mermaid 兼容性
  • 实施计划

    • Servify Implementation Backlogs
    • 01 Platform And Runtime
    • 02 AI And Knowledge
    • 03 Business Modules
    • 04 SDK And Channel Adapters
    • 05 Engineering Hardening
    • 06 Voice And Protocol Expansion
    • 07 SDK Multi Surface
    • 08 AI Provider Expansion

Release Versioning

Server version injection

  • Single source of truth: apps/server/internal/version
  • Build metadata is injected with -ldflags from the root Makefile
  • Injected fields:
    • Version
    • Commit
    • BuildTime
  • servify server handlers and servify-cli version both read the same package

SDK workspace version strategy

  • sdk/package.json is the workspace version source of truth
  • Publishable packages share the exact same version as the workspace root:
    • @servify/core
    • @servify/react
    • @servify/vue
    • @servify/vanilla
  • Internal cross-package dependencies are pinned to the exact same version, not a loose range
  • Reserved packages stay private and 0.0.0 until they become a supported surface:
    • @servify/api-client
    • @servify/app-core
  • Use:
    • npm -C sdk run version:sync
    • npm -C sdk run version:check

Changelog and release flow

  • Draft changelog generation is provided by scripts/generate-changelog.sh
  • Local draft file generation is provided by make release-changelog
  • Local release draft output defaults to ./.runtime/release/RELEASE_CHANGELOG.md
  • Manual release preparation is reserved in .github/workflows/release.yml
  • Current release workflow prepares metadata and artifacts; it does not publish packages automatically
  • RELEASE_CHANGELOG.md is treated as a release artifact, not a committed generated asset
Edit this page
最近更新: 2026/3/22 16:20
Contributors: cuihairu
Prev
GitHub Hosted CI
Next
Testing Pyramid