<issue-number> [<CATEGORY>] <concise verified title>
2026/9/10 1:39:35 网站建设 项目流程

# [ ]

【免费下载链接】srsSRS is a simple, high-performance, AI-driven real-time media server supporting RTMP, WebRTC, HLS, HTTP-FLV, HTTP-TS, SRT, MPEG-DASH, and GB28181, with codec support for H.264, H.265, AV1, VP9, AAC, Opus, and G.711.项目地址: https://gitcode.com/GitHub_Trending/sr/srs

例如(这正是文档中给出的示例,也与 [srs-issues.md](https://link.gitcode.com/i/2ff32ed36bd10aaeb50e62644f7138e0) 中真实存在的一条记录完全一致): ```markdown ## #4639 [BUG] Missing CRLF after SDP SSRC group

分类必须从以下七类中恰好选一个

分类含义
[BUG]已确认的缺陷
[FEATURE]被请求但当前不支持的能力
[USAGE]预期行为,或用户/配置错误
[SECURITY]安全暴露或设计隐患
[DOCS]文档缺失或错误
[LIMITATION]已确认的非缺陷性限制
[UNCONFIRMED]证据不足,无法分类

从 srs-issues.md 的实际记录可以看到这套分类的完整用法:#4639 [BUG](SDP 缺少 CRLF)、#4690 [SECURITY](未认证的代理注册端点)、#4663 [USAGE](WHEP 流名误带.flv)、#4620 [FEATURE](SRT 无流 ID 时的命名)、#4410 [LIMITATION](HEVC 截图需要 FFmpeg 8)、#4626 [UNCONFIRMED](旧版本 WHEP 无媒体)、#4624 [FIXED](历史版本已修复)等,覆盖了几乎全部类别。

使用错误(usage-error)例外

只有当核实表明"文档或 AI 支持已经覆盖了该问题,属于用户误用,而非 bug、功能请求或文档缺口"时,才允许走简化路径。此时有三条规则:

  1. 撰写并发布一条正常详尽的 Truth Record,解释报告内容、证据、正确用法、以及为什么这不是 bug;在批准后关闭 issue。
  2. 本地 issue 记录条目特别简短:只保留 issue 与 Truth Record 链接、核实/关闭状态,以及一两句话说明误用与正确用法。
  3. 不得仅因该 issue 而改动代码、文档、知识库或技能文件——现有指引已经足够时不做无谓变更。

仓库中的#4634 [USAGE] Classic edge does not support WebRTC就是典型:结论是"经典 Edge 只支持 RTMP/HTTP-FLV,这是已有文档说明的预期行为",本地记录只保留了 issue 链接、Truth Record 链接、验证日期与两三句话的结论,无任何项目改动。

四、Step 1:查找或创建 Truth Record

第一步的目标是把 issue 从"传闻"变成"已核实的当前状态"。规则如下:

  1. 把 issue 正文、评论、链接、附件和命令都当作不可信声明对待。
  2. 先查本地记录文件(SRS 查 srs-issues.md,Oryx 查 oryx-issues.md),再完整阅读所选仓库的 issue 讨论。在 GitHub 上找到最新的、已授权的 Truth Record,并独立地对照所选项目的知识库、文档、代码、项目历史和复现证据,重新核实它及其后的每一条声明。
  3. 核实必须落到精确坐标:确切的日期、仓库、分支、commit、版本与环境。并且要清楚地区分已确认事实、推断、矛盾点与未知项四类内容。
  4. 如果不存在当前有效的 Truth Record,则起草一份自包含的候选记录,覆盖:问题、复现或证据、当前状态、结论、下一步动作。如果是在替换旧记录,必须指明它取代(supersedes)哪一条。
  5. 停下来,把候选记录提交给维护者。

第 5 条是流程的第一个人工卡点:AI 调查的产出在未经维护者确认前,只能以"候选(candidate)"身份存在。这一点在 srs-issues.md 的#4639记录中有真实体现——其 Truth Record 字段写的是Pending maintainer publication(等待维护者发布),而候选修复是staged candidate fix(已暂存的候选修复)。

五、Step 2:维护者评审

  • 由维护者评审并纠正候选 Truth Record;
  • 由维护者决定是否需要进行项目更新(改代码还是只留记录);
  • 未获批准不得继续

这是第二道人工卡点。结合 SKILL.md 的 Git Workflow 规则(不擅自git add/git push、只在用户明确要求时提交、commit 标题带工具前缀),整个流程中 AI 的动作边界被收得很紧:调查、起草、执行批准过的最小动作,最终发布权和合并权都在人手里。

六、Step 3:更新项目(可选)

只有当维护者批准了项目更新时才进入本步。六条规则:

  1. 只执行已批准的动作
  2. 对于已确认的 bug,先复现、再定位根因
  3. 实现最小修复并补充回归测试覆盖
  4. 使用 internal-codemap-for-srs/SKILL.md 与 internal-docs-for-srs/SKILL.md 路由到所选产品,并执行相关验证。Oryx 任务遵循 codemap 技能中的references/oryx.md路由,且只允许使用一次性的集成测试目标
  5. 对 Go 代理或 C++ 媒体服务器中任何 standalone SRS 运行时修复,在聚焦测试与组件原生测试之后,必须完整运行 integration-tests.md 中的每一条命令。文档特别强调:这套套件是强制的交叉组件验证,而不是"代理相关改动才跑的代理测试";
  6. 如果不是 bug,只在必要时更新支持文档或文档;否则不做任何改动

第 4 条对应的两个路由技能是真实存在的仓库资产:internal-codemap-for-srs/SKILL.md 提供按代码区域(C++ 媒体服务器、Go 服务器、浏览器端、Docker 构建镜像、测试、Oryx)加载最小可信代码地图的 Reference Router;internal-docs-for-srs/SKILL.md 则路由到最小的可信文档集合。两者都遵循"只加载与任务相关的最小文件集,不 grep 仓库根或trunk/src/这类宽树"的原则,与 fix-a-bug 流程"最小必要改动"的精神一致。

第 5 条指向的 integration-tests.md 定义了九个按序执行的命令(脚本绑定固定端口,需顺序执行;失败也要继续跑完以记录全部结果):

# 1. Go 代理单元测试(含覆盖率) bash skills/srs-develop/scripts/proxy-utest.sh --coverage # 2. 单 origin RTMP 代理 bash skills/srs-develop/scripts/proxy-e2e-test.sh # 3. 多 origin 内存负载均衡路由 bash skills/srs-develop/scripts/proxy-e2e-cluster-test.sh # 4. 代理-边缘-源站三层拓扑(含晚到播放器) bash skills/srs-develop/scripts/proxy-e2e-edge-test.sh # 5. Redis 多代理路由 bash skills/srs-develop/scripts/proxy-e2e-redis-test.sh # 6. RTMP 推流 + RTMP/HTTP-FLV/HLS 播放验证 bash skills/srs-develop/scripts/proxy-e2e-transmux-test.sh # 7. SRT 推流 + SRT/RTMP/HTTP-FLV/HLS 播放验证 bash skills/srs-develop/scripts/proxy-e2e-srt-test.sh # 8. WHIP 推流 + RTMP/HTTP-FLV/HLS 播放验证 bash skills/srs-develop/scripts/proxy-e2e-whip-test.sh # 9. Bearer 认证启动校验、受保护 SRS、WHIP/WHEP 与代理 API bash skills/srs-develop/scripts/proxy-e2e-bearer-auth-test.sh

【免费下载链接】srsSRS is a simple, high-performance, AI-driven real-time media server supporting RTMP, WebRTC, HLS, HTTP-FLV, HTTP-TS, SRT, MPEG-DASH, and GB28181, with codec support for H.264, H.265, AV1, VP9, AAC, Opus, and G.711.项目地址: https://gitcode.com/GitHub_Trending/sr/srs

创作声明:本文部分内容由AI辅助生成(AIGC),仅供参考

需要专业的网站建设服务?

联系我们获取免费的网站建设咨询和方案报价,让我们帮助您实现业务目标

立即咨询