Table of Contents

开发工作流

事实来源
工作闭环
上游边界
UI 设计门禁
安全门禁
快捷指令

This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.

开发工作流

事实来源

Gitea 单元工单：一次任务的需求、方案、实施、测试和验收。
Gitea Wiki：定制版长期有效事实。
docs/maintainer/：Wiki 的只读镜像。
Git：代码及版本绑定资料。
MediaMTX docs/：上游产品文档，不作为 DevHarness 镜像重写。

工作闭环

只读检查代码、当前工单、工作区和相关 Wiki。
写明目标、非目标、方案、风险、回退、验证和文档影响。
用户确认方案后建立一个可独立验证和回退的单元工单。
检查前置依赖和现有工作区改动，仅修改工单范围。
执行与风险相称的格式、单元、集成和构建验证。
把最终差异、测试、未验证项、提交哈希和文档影响集中回写工单。
保持工单“待验收”；只有用户明确验收后关闭。
只有长期事实变化时更新 Wiki，再同步本地镜像。

上游边界

不覆盖 MediaMTX 官方 docs/、.github/、发布流程和协议实现。
上游文件发生冲突时，先区分上游变化、现有用户改动和当前工单改动。
自定义代码应集中、命名清楚、测试独立，降低后续合并成本。
合并上游前记录目标提交并运行受影响测试。

UI 设计门禁

新增页面或重大交互必须先提供可审阅原型，确认页面、状态、权限、错误处理和验收范围后再实现。简单文案调整可以使用最小截图或文字证据。

安全门禁

凭据、权限、认证、外网暴露和删除操作属于高风险。涉及这些内容时必须停止实施，先让负责人确认安全边界。

快捷指令

只分析：只读检查并给方案。
建工单：创建已确认方案的单元工单，不改代码。
执行工单 #N：实施、测试、提交并回写证据，停在待验收。
检查工单 #N：只读核对范围和证据。
同步文档：从 Wiki 单向更新 docs/maintainer/。
#N 验收通过：记录验收并关闭工单。