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

    • 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

09 Runtime And Repo Hygiene

范围:

  • 仓库卫生
  • 运行时产物边界
  • ignore 策略
  • 本地开发环境一致性
  • 生成物与缓存治理

R1 tracked-runtime-artifacts-cleanup

  • [x] 盘点误提交的二进制、上传目录、测试残留、缓存文件
  • [x] 清理 server、server.exe、运行时 upload 样本等非源码产物
  • [x] 为测试中需要的样本文件建立明确 fixture 目录
  • [x] 将运行时输出目录迁出源码树或改为临时目录
  • [x] 补充清理脚本或测试 teardown,避免再次污染工作区

验收:

  • 仓库中不再长期保留运行时脏产物
  • 测试样本与真实运行时输出边界清晰

R2 ignore-and-boundary-policy

  • [x] 统一根目录、sdk/、docs/、apps/* 的 ignore 策略
  • [x] 区分必须提交的 generated assets 与禁止提交的 build/runtime/cache 文件
  • [x] 为二进制、日志、覆盖率、临时数据库、上传目录建立规则
  • [x] 为 generated assets manifest 增加文档说明和维护规则
  • [x] 为新增目录定义默认 ignore 约定

验收:

  • 新人可以快速判断“哪些文件该提交,哪些不该提交”
  • CI 与本地不会因边界不清反复漂移

R3 local-dev-environment-convergence

  • [x] 盘点 Windows PowerShell、WSL、Linux、CI 的命令差异
  • [x] 为常用流程提供统一入口,例如 make / npm scripts / shell wrappers
  • [x] 解决 Git safe directory、换行符、权限位、Node/Go 路径差异
  • [x] 补充 WSL 与 Ubuntu 初始化文档
  • [x] 为跨平台开发建立最小验证清单

验收:

  • 同一套开发流程可以在 Windows + WSL + Linux 下稳定执行
  • 常见环境问题有明确文档和修复路径

R4 generated-assets-governance

  • [x] 盘点所有需要提交的生成物与对应生成入口
  • [x] 盘点所有不应提交的构建产物与缓存产物
  • [x] 为 demo SDK、docs API、release/changelog 统一生成规则
  • [x] 为生成物增加一键重建入口
  • [x] 为 CI 增加边界漂移说明输出,降低排障成本

验收:

  • 生成物治理不再是零散脚本集合,而是统一规则
  • 任何一类生成物都可以快速重建和验证

R5 repo-hygiene-guardrails

  • [x] 增加仓库卫生检查,例如禁止提交二进制、运行时目录、超大文件
  • [x] 增加 fixture / testdata / generated 目录命名约定
  • [x] 为 PR 模板或贡献文档补充提交前自检规则
  • [x] 为根目录文件增加职责说明,避免继续堆杂项文件

验收:

  • 仓库结构长期可维护,不会因临时文件逐步劣化
Edit this page
最近更新: 2026/3/22 16:20
Contributors: cuihairu