Compare commits

...

1 Commits

Author SHA1 Message Date
diegosouzapw
793bba6db2 docs(diagrams): rename number-carrying diagram files to stable names
mcp-tools-107.{mmd,svg} -> mcp-tools.{mmd,svg} and
auto-combo-12factor.{mmd,svg} -> auto-combo-scoring.{mmd,svg}: filenames that
embed a canonical count fossilize the moment the count moves (107 -> 110,
12 -> 15 factors already happened). All referencers updated — diagrams index,
AUTO-COMBO.md (+ its pl/zh-CN/zh-TW mirrors' links) and the check:docs-counts
file list.
2026-08-31 14:12:27 -03:00
11 changed files with 12 additions and 12 deletions

View File

@@ -13,10 +13,10 @@ Mermaid sources (`.mmd`) and exported SVGs for OmniRoute v3.8.0 architecture flo
| Source | Exported | Used in |
| ---------------------------------------------------- | ----------------------------------------- | ------------------------------------------------------------------------------ |
| [request-pipeline.mmd](./request-pipeline.mmd) | [SVG](./exported/request-pipeline.svg) | docs/architecture/ARCHITECTURE.md, docs/architecture/CODEBASE_DOCUMENTATION.md |
| [auto-combo-12factor.mmd](./auto-combo-12factor.mmd) | [SVG](./exported/auto-combo-12factor.svg) | docs/routing/AUTO-COMBO.md |
| [auto-combo-scoring.mmd](./auto-combo-scoring.mmd) | [SVG](./exported/auto-combo-scoring.svg) | docs/routing/AUTO-COMBO.md |
| [resilience-3layers.mmd](./resilience-3layers.mmd) | [SVG](./exported/resilience-3layers.svg) | docs/architecture/RESILIENCE_GUIDE.md, CLAUDE.md |
| [i18n-flow.mmd](./i18n-flow.mmd) | [SVG](./exported/i18n-flow.svg) | docs/guides/I18N.md |
| [mcp-tools-107.mmd](./mcp-tools-107.mmd) | [SVG](./exported/mcp-tools-107.svg) | docs/frameworks/MCP-SERVER.md |
| [mcp-tools.mmd](./mcp-tools.mmd) | [SVG](./exported/mcp-tools.svg) | docs/frameworks/MCP-SERVER.md |
| [cloud-agent-flow.mmd](./cloud-agent-flow.mmd) | [SVG](./exported/cloud-agent-flow.svg) | docs/frameworks/CLOUD_AGENT.md |
| [authz-pipeline.mmd](./authz-pipeline.mmd) | [SVG](./exported/authz-pipeline.svg) | docs/architecture/AUTHZ_GUIDE.md |
| [db-schema-overview.mmd](./db-schema-overview.mmd) | [SVG](./exported/db-schema-overview.svg) | docs/architecture/CODEBASE_DOCUMENTATION.md |

File diff suppressed because one or more lines are too long

Before

Width:  |  Height:  |  Size: 26 KiB

File diff suppressed because one or more lines are too long

After

Width:  |  Height:  |  Size: 26 KiB

View File

Before

Width:  |  Height:  |  Size: 25 KiB

After

Width:  |  Height:  |  Size: 25 KiB

View File

@@ -163,9 +163,9 @@ Helper detekcji żyje w `src/lib/combos/modelNameCollision.ts`.
Silnik Auto-Combo dynamicznie wybiera najlepszego providera/model dla każdego żądania przy użyciu **13-czynnikowej funkcji scoringu** (zdefiniowanej w `open-sse/services/autoCombo/scoring.ts``DEFAULT_WEIGHTS`). Wszystkie wagi sumują się do **1.0**.
![Auto-Combo 13-factor scoring](../diagrams/exported/auto-combo-12factor.svg)
![Auto-Combo 13-factor scoring](../diagrams/exported/auto-combo-scoring.svg)
> Źródło: [diagrams/auto-combo-12factor.mmd](../diagrams/auto-combo-12factor.mmd) (regeneruj przez `npm run docs:render-diagrams`). Historyczna nazwa pliku pochodzi sprzed dodania kolejnych czynników; bieżący diagram pokazuje wszystkie 13.
> Źródło: [diagrams/auto-combo-scoring.mmd](../diagrams/auto-combo-scoring.mmd) (regeneruj przez `npm run docs:render-diagrams`). Historyczna nazwa pliku pochodzi sprzed dodania kolejnych czynników; bieżący diagram pokazuje wszystkie 13.
| Czynnik | Domyślna waga | Opis |
| :-------------------- | :------------ | :------------------------------------------------------------------------------------------------------- |

View File

@@ -104,9 +104,9 @@ handleComboChat与持久化 Combo 相同的引擎)
Auto-Combo 引擎使用**13 因子评分函数**(定义在 `open-sse/services/autoCombo/scoring.ts``DEFAULT_WEIGHTS`)为每次请求动态选择最佳服务商/模型。所有权重之和为 **1.0**
![Auto-Combo 13-factor scoring](../diagrams/exported/auto-combo-12factor.svg)
![Auto-Combo 13-factor scoring](../diagrams/exported/auto-combo-scoring.svg)
> 来源:[diagrams/auto-combo-12factor.mmd](../diagrams/auto-combo-12factor.mmd)(通过 `npm run docs:render-diagrams` 重新生成)。文件名为历史名称;当前图表包含全部 13 个因子。
> 来源:[diagrams/auto-combo-scoring.mmd](../diagrams/auto-combo-scoring.mmd)(通过 `npm run docs:render-diagrams` 重新生成)。文件名为历史名称;当前图表包含全部 13 个因子。
| 因子 | 默认权重 | 描述 |
| :---------------------- | :------- | :--------------------------------------------------------------------------------------------- |

View File

@@ -116,9 +116,9 @@ handleComboChat與持久化組合使用相同引擎
自動組合引擎使用**13 因子評分函數**(定義於 `open-sse/services/autoCombo/scoring.ts``DEFAULT_WEIGHTS`)為每個請求動態選擇最佳的提供者/模型。所有權重合計為 **1.0**
![自動組合 13 因子評分](../diagrams/exported/auto-combo-12factor.svg)
![自動組合 13 因子評分](../diagrams/exported/auto-combo-scoring.svg)
> 來源:[diagrams/auto-combo-12factor.mmd](../diagrams/auto-combo-12factor.mmd)(可透過 `npm run docs:render-diagrams` 重新生成)。檔名是歷史名稱;目前圖表包含全部 13 個因子。
> 來源:[diagrams/auto-combo-scoring.mmd](../diagrams/auto-combo-scoring.mmd)(可透過 `npm run docs:render-diagrams` 重新生成)。檔名是歷史名稱;目前圖表包含全部 13 個因子。
| 因子 | 預設權重 | 說明 |
| :-------------------------------------- | :------- | :--------------------------------------------------------------------------- |

View File

@@ -186,9 +186,9 @@ See [#7992](https://github.com/diegosouzapw/OmniRoute/issues/7992) and [#7111](h
The Auto-Combo Engine dynamically selects the best provider/model for each request using a **15-factor scoring function** (defined in `open-sse/services/autoCombo/scoring.ts``DEFAULT_WEIGHTS`). The default weights sum to `1.0`; custom weights are renormalized by `normalizeScoringWeights()`. Two of the fifteen — `cacheAffinity` and `resetWindowAffinity` — carry a default weight of `0`: they are still computed for every candidate, and `cacheAffinity` gates prompt-cache deduplication outside the score, so they are declared factors that simply do not vote by default.
![Auto-Combo 15-factor scoring](../diagrams/exported/auto-combo-12factor.svg)
![Auto-Combo 15-factor scoring](../diagrams/exported/auto-combo-scoring.svg)
> Source: [diagrams/auto-combo-12factor.mmd](../diagrams/auto-combo-12factor.mmd) (regenerate via `npm run docs:render-diagrams`). The filename is historical; the source and rendered diagram show all 15 factors declared in `DEFAULT_WEIGHTS`.
> Source: [diagrams/auto-combo-scoring.mmd](../diagrams/auto-combo-scoring.mmd) (regenerate via `npm run docs:render-diagrams`). The filename is historical; the source and rendered diagram show all 15 factors declared in `DEFAULT_WEIGHTS`.
| Factor | Default Weight | Description |
| :-------------------- | :------------- | :------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |

View File

@@ -598,7 +598,7 @@ export function buildChecks() {
"docs/guides/FEATURES.md",
"docs/guides/FREE_PROVIDER_RANKINGS.md",
"docs/diagrams/strategies-grid.svg",
"docs/diagrams/auto-combo-12factor.mmd",
"docs/diagrams/auto-combo-scoring.mmd",
"llm.txt",
"open-sse/services/autoCombo/routerStrategy.ts",
"open-sse/services/taskAwareRouter.ts",