<!-- gitea-wiki-mirror:start -->
generated: true (请先修改 Gitea Wiki，禁止直接编辑本文件)
wiki_page: Common-Changes
wiki_url: https://git.ilapage.cn/OPC/mediamtx/wiki/Common-Changes.-
wiki_revision: 17db8cd186ac676dd3c58c114751fc4f19483cfe
synchronized_at: 2026-08-28T02:10:42Z
<!-- gitea-wiki-mirror:end -->

# 常见修改

## 增加管理页字段

1. 先核对 `api/openapi.yaml` 和 `internal/conf/` 中的真实字段。
2. 更新已确认的页面状态和验证范围。
3. 修改原生表单及请求体。
4. 增加前端输入校验和 Go 路由/响应测试。
5. 验证新增、读取、编辑、删除及错误提示。

## 调整 Control API

API 属于中风险变更。必须先建工单并确认兼容性，不得只改前端假定接口。实现后更新 OpenAPI、处理器测试和相关长期文档。

## 更新上游

1. 记录目标上游完整提交。
2. 获取 `upstream`。
3. 检查定制文件和 API 契约变化。
4. 合并时保留用户未提交改动。
5. 运行受影响测试和构建。
6. 更新项目档案中的上游基线并回写工单证据。

## 修改文档

定制版长期事实先改 Gitea Wiki，回读 revision 后运行同步；不要直接编辑 `docs/maintainer/`。MediaMTX 官方功能文档继续按上游方式修改，不通过定制 Wiki 覆盖。