mediamtx/docs/maintainer/2-development-workflow.md

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 验收通过：记录验收并关闭工单。