QiuSW
ca667251d2
lint / go (push) Canceled after 0s
lint / go_mod (push) Canceled after 0s
lint / conf (push) Canceled after 0s
lint / docslinks (push) Canceled after 0s
lint / docsorder (push) Canceled after 0s
lint / apidocs (push) Canceled after 0s
lint / other (push) Canceled after 0s
test / test_64 (push) Canceled after 0s
test / test_32 (push) Canceled after 0s
test / test_e2e (push) Canceled after 0s
53 lines
2.4 KiB
Markdown
53 lines
2.4 KiB
Markdown
<!-- gitea-wiki-mirror:start -->
|
||
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-wiki-mirror:end -->
|
||
|
||
# 开发工作流
|
||
|
||
## 事实来源
|
||
|
||
- 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 验收通过`：记录验收并关闭工单。
|