generated: true (请先修改 Gitea Wiki，禁止直接编辑本文件) wiki_page: Development-Workflow wiki_url: https://git.ilapage.cn/OPC/mediamtx/wiki/Development-Workflow.- wiki_revision: 68377a272a565ae9377322ead7b8c73ebb7d354d synchronized_at: 2026-08-28T02:10:12Z # 开发工作流 ## 事实来源 - Gitea 单元工单：一次任务的需求、方案、实施、测试和验收。 - Gitea Wiki：定制版长期有效事实。 - `docs/maintainer/`：Wiki 的只读镜像。 - Git：代码及版本绑定资料。 - MediaMTX `docs/`：上游产品文档，不作为 DevHarness 镜像重写。 ## 工作闭环 1. 只读检查代码、当前工单、工作区和相关 Wiki。 2. 写明目标、非目标、方案、风险、回退、验证和文档影响。 3. 用户确认方案后建立一个可独立验证和回退的单元工单。 4. 检查前置依赖和现有工作区改动，仅修改工单范围。 5. 执行与风险相称的格式、单元、集成和构建验证。 6. 把最终差异、测试、未验证项、提交哈希和文档影响集中回写工单。 7. 保持工单“待验收”；只有用户明确验收后关闭。 8. 只有长期事实变化时更新 Wiki，再同步本地镜像。 ## 上游边界 - 不覆盖 MediaMTX 官方 `docs/`、`.github/`、发布流程和协议实现。 - 上游文件发生冲突时，先区分上游变化、现有用户改动和当前工单改动。 - 自定义代码应集中、命名清楚、测试独立，降低后续合并成本。 - 合并上游前记录目标提交并运行受影响测试。 ## UI 设计门禁 新增页面或重大交互必须先提供可审阅原型，确认页面、状态、权限、错误处理和验收范围后再实现。简单文案调整可以使用最小截图或文字证据。 ## 安全门禁 凭据、权限、认证、外网暴露和删除操作属于高风险。涉及这些内容时必须停止实施，先让负责人确认安全边界。 ## 快捷指令 - `只分析`：只读检查并给方案。 - `建工单`：创建已确认方案的单元工单，不改代码。 - `执行工单 #N`：实施、测试、提交并回写证据，停在待验收。 - `检查工单 #N`：只读核对范围和证据。 - `同步文档`：从 Wiki 单向更新 `docs/maintainer/`。 - `#N 验收通过`：记录验收并关闭工单。