diff --git a/knowledge/CLAUDE.md b/knowledge/CLAUDE.md index 57df6e5..35854d1 100644 --- a/knowledge/CLAUDE.md +++ b/knowledge/CLAUDE.md @@ -52,6 +52,7 @@ | 写文档、RFC 和用户可见说明 | [general/docs](general/docs/_index.md) | `repos/<仓库>/docs/_index.md` | | Git、commit、rebase 和 PR | [general/git](general/git/_index.md) | `repos/<仓库>/git/_index.md` | | 调试和根因收敛 | [general/debug](general/debug/_index.md) | `repos/<仓库>/debug/_index.md` | +| Bug 定级与 DI / SLO 计算 | [general/bug](general/bug/_index.md) | 通常没有仓库补充 | | benchmark 和性能证据 | [general/benchmark](general/benchmark/_index.md) | `repos/<仓库>/benchmark/_index.md` | | Windows、WSL、编码和本地工具 | [general/environment](general/environment/_index.md) | 通常没有仓库补充 | | SSH、容器、GPU 和远端长跑 | [general/remote](general/remote/_index.md) | `repos/<仓库>/remote/_index.md` | diff --git a/knowledge/SCHEMA.md b/knowledge/SCHEMA.md index 11b724f..9257bcd 100644 --- a/knowledge/SCHEMA.md +++ b/knowledge/SCHEMA.md @@ -36,7 +36,7 @@ contradictions: [相对路径] # 可选：与本页冲突的页面 新标签必须先加入此表再使用（防止标签蔓延）： - 归属：`general`、`vllm-omni`、`afd-plugin` -- 工作主题：`review`、`ci`、`docs`、`git`、`debug`、`benchmark`、`environment`、 +- 工作主题：`review`、`ci`、`docs`、`git`、`debug`、`bug`、`benchmark`、`environment`、 `remote`、`agents`、`planning`、`dev`、`rebase` - 代码/模型轴：`components`、`models`、`diffusion`、`model-executor`、`serving`、 `scheduler`、`distributed`、`config`、`hunyuan-image3`、`ltx2`、`qwen-omni`、 diff --git a/knowledge/general/_index.md b/knowledge/general/_index.md index e6b5660..bfb5444 100644 --- a/knowledge/general/_index.md +++ b/knowledge/general/_index.md @@ -1,7 +1,7 @@ --- title: "通用经验入口" created: 2026-07-10 -updated: 2026-07-16 +updated: 2026-08-07 type: index tags: [general] sources: [] @@ -28,6 +28,7 @@ sources: [] | 编写和维护文档 | [docs](docs/_index.md) | 文档来源、链接和验收 | | Git 分支、提交和变基 | [git](git/_index.md) | 通用 Git 工作方法 | | 定位问题和收敛原因 | [debug](debug/_index.md) | 通用调试方法 | +| Bug 定级与 DI / SLO 计算 | [bug](bug/_index.md) | 通用缺陷强度计算 | | 设计或核验性能测试 | [benchmark](benchmark/_index.md) | 通用 benchmark 方法 | | Windows、WSL、编码和本地工具 | [environment](environment/_index.md) | 开发环境问题 | | SSH、容器和远端长跑任务 | [remote](remote/_index.md) | 通用远端操作方法 | diff --git a/knowledge/general/bug/_index.md b/knowledge/general/bug/_index.md new file mode 100644 index 0000000..56e9d2f --- /dev/null +++ b/knowledge/general/bug/_index.md @@ -0,0 +1,26 @@ +--- +title: "Bug" +created: 2026-08-07 +updated: 2026-08-07 +type: index +tags: [general, bug] +sources: [] +--- + +# Bug + +## 什么时候查这里 + +- 需要按统一标准给 Bug 定级，或计算 DI / SLO。 + +## 不放什么 + +- 某个仓库专属的缺陷跟踪字段、看板流程或自动化脚本。 +- 具体 issue 的调查时间线与根因结论（调试方法见 [debug](../debug/_index.md)）。 + +## 目录内容 + +| 遇到什么 | 查看哪里 | 说明 | +|---|---|---| +| 按优先级与 SLO 计算 DI | [DI 计算说明](guides/di-calculation.md) | 分级表、偶现降级、按 SLO 累加 | +| 查找其他 Bug 专项 | [guides 索引](guides/_index.md) | 当前有效的 Bug 方法入口 | diff --git a/knowledge/general/bug/guides/_index.md b/knowledge/general/bug/guides/_index.md new file mode 100644 index 0000000..36e824a --- /dev/null +++ b/knowledge/general/bug/guides/_index.md @@ -0,0 +1,14 @@ +--- +title: "Bug 指南" +created: 2026-08-07 +updated: 2026-08-07 +type: index +tags: [general, bug] +sources: [] +--- + +# Bug 指南 + +| 遇到什么 | 查看哪里 | +|---|---| +| 按优先级与 SLO 计算 DI | [DI 计算说明](di-calculation.md) | diff --git a/knowledge/general/bug/guides/di-calculation.md b/knowledge/general/bug/guides/di-calculation.md new file mode 100644 index 0000000..79acaf5 --- /dev/null +++ b/knowledge/general/bug/guides/di-calculation.md @@ -0,0 +1,40 @@ +--- +title: "DI 计算说明" +created: 2026-08-07 +updated: 2026-08-07 +type: guide +tags: [general, bug] +sources: [] +--- + +# DI 计算说明 + +按 Bug 优先级给出基础 DI（Defect Intensity）与 SLO，并说明偶现降级与按 SLO 累加的计算方式。 +相关入口：[bug 主题](../_index.md)、[调试](../../debug/_index.md)、[测试与 CI](../../ci/_index.md)。 + +## Bug 分级标准 + +| Bug 优先级分类 | 划分标准 | DI 值 | SLO | +|---|---|---|---| +| critical | 高优先级 | 10 | 1 天 | +| high priority | CI Failure | 3 | 3 天 | +| medium priority | 中优先级 | 1 | 5 天 | +| low priority | 低优先级 | 0.1 | 10 天 | +| invalid | 非问题 | 0 | / | + +## 其他规则 + +1. **偶现降级**：若为偶现问题，分类等级自动降低一级。 +2. **按 SLO 累加**：每达到一次 SLO，DI 值累加一次。 + +### 累加示例 + +critical 等级 bug（基础 DI = 10，SLO = 1 天）： + +| 未关闭天数 | 达到的 SLO 次数 | DI | +|---|---|---| +| 第 1 天 | 1 | 10 | +| 第 2 天 | 2 | 20 | +| 第 3 天 | 3 | 30 | + +通式：`DI = 基础 DI × ⌈未关闭天数 / SLO 天数⌉`（`invalid` 始终为 0）。