Skip to content

Make Codex and Claude Code subscriptions go further: a local model router that gives routine agent work to economical models and keeps your strongest model for the hard parts.

docs: use native Desktop screenshots for homepage performance (#23)

澄潭bf350c73806f
diff --git a/README.md b/README.md
index 0fcc90ab..746b36ed 100644
--- a/README.md
+++ b/README.md
@@ -85,12 +85,12 @@ Continue with [model routing](https://hiroute.ai/en/docs/model-routing/),
## See routing performance
<p align="center">
- <img src="decision-extensions/assets/quality-en.png" alt="HiRoute runtime performance showing rated, unrated, and partial model stages" width="100%">
+ <img src="decision-extensions/assets/quality-native-en.png" alt="HiRoute Desktop session showing two model-stage assessments and user feedback" width="100%">
</p>
-The performance view follows the models selected by the active routing-plan revision; users do
-not need to enter internal model IDs. The screenshot uses realistic synthetic data rendered by
-real product components. It demonstrates the UI states and is not a model benchmark.
+Review model performance within a task, alongside execution records and user feedback, to inform
+the next model choice and task delegation. This is an actual Desktop screenshot with illustrative
+data, not a model benchmark.
## How routing works
diff --git a/README.zh-CN.md b/README.zh-CN.md
index 37bd7064..237bd4f3 100644
--- a/README.zh-CN.md
+++ b/README.zh-CN.md
@@ -80,11 +80,11 @@ hiroute system status --output json
## 查看真实产品中的运行表现
<p align="center">
- <img src="decision-extensions/assets/quality-zh-CN.png" alt="HiRoute 运行表现,展示已评分、未评分和部分证据阶段" width="100%">
+ <img src="decision-extensions/assets/quality-native-zh-CN.png" alt="HiRoute Desktop 会话,展示两个模型阶段的评分与用户反馈" width="100%">
</p>
-运行表现会自动展示当前路由计划生效版本中的模型,用户无需填写内部模型 ID。截图由真实产品组件
-配合贴近实际的模拟数据生成,用于说明界面状态,不代表模型能力评测。
+查看模型在具体任务中的阶段评分,结合执行记录与用户反馈,为下一次模型选择和任务委派提供依据。
+截图来自真实 Desktop 界面,使用演示数据,不代表模型能力评测。
## 路由机制
diff --git a/apps/website/scripts/validate-build.mjs b/apps/website/scripts/validate-build.mjs
index 4b591a45..033c8850 100644
--- a/apps/website/scripts/validate-build.mjs
+++ b/apps/website/scripts/validate-build.mjs
@@ -20,6 +20,15 @@ const required = [
for (const relative of required) {
if (!fs.existsSync(path.join(dist, relative))) throw new Error(`missing website output: ${relative}`);
}
+for (const [page, language] of [['index.html', 'zh-CN'], ['en/index.html', 'en']]) {
+ const html = fs.readFileSync(path.join(dist, page), 'utf8');
+ const performance = html.match(/<section\b[^>]*id="performance"[^>]*>[\s\S]*?<\/section>/)?.[0];
+ if (!performance?.includes(`src="/decision-assets/quality-native-${language}.png"`)) {
+ throw new Error(`missing localized native Desktop screenshot: ${page}`);
+ }
+ const disclaimer = language === 'en' ? 'not a model benchmark' : '非模型评测';
+ if (!performance.includes(disclaimer)) throw new Error(`missing screenshot disclaimer: ${page}`);
+}
const htmlFiles = [];
for (const entry of fs.readdirSync(dist, { recursive: true, withFileTypes: true })) {
if (entry.isFile() && entry.name.endsWith('.html')) htmlFiles.push(path.join(entry.parentPath, entry.name));
diff --git a/apps/website/src/components/HomePage.astro b/apps/website/src/components/HomePage.astro
index 4ffb914b..e68f3622 100644
--- a/apps/website/src/components/HomePage.astro
+++ b/apps/website/src/components/HomePage.astro
@@ -60,9 +60,9 @@ const releaseKinds = [preferredArtifact && t('macOS 桌面应用', 'macOS Deskto
</div></section>
<section class="section wrap" id="performance">
- <div class="section-title"><div><div class="eyebrow section-label">{t('为下一次决策保留证据', 'Evidence for the next decision')}</div><h2>{t('不只知道选了谁,', 'See more than who was chosen.')}<br>{t('也看得见做得怎样。', 'See how the work went.')}</h2></div><p>{t('查看当前计划所选模型一段时间内的阶段胜任度,无需输入内部模型 ID。', 'Review stage competence over time for models selected by the current plan—without typing internal model IDs.')}</p></div>
- <figure class="product-shot"><img src={`/decision-assets/quality-${en ? 'en' : 'zh-CN'}.png`} alt={t('HiRoute 运行表现界面,包含阶段评分、未评分和部分历史', 'HiRoute runtime performance with stage scores, unrated work, and partial history')} loading="lazy"></figure>
- <p class="caption">{t('真实产品组件 · 演示数据,非模型评测。保留未评分、部分历史和评分尚未覆盖最新轮次等实际状态。', 'Real product components · Illustrative data, not a model benchmark. Unrated, partial, and not-yet-covered turns remain explicit.')}</p>
+ <div class="section-title"><div><div class="eyebrow section-label">{t('为下一次决策保留证据', 'Evidence for the next decision')}</div><h2>{t('不只知道选了谁,', 'See more than who was chosen.')}<br>{t('也看得见做得怎样。', 'See how the work went.')}</h2></div><p>{t('查看模型在具体任务中的阶段评分,结合执行记录与用户反馈,为下一次模型选择和任务委派提供依据。', 'Review model performance within a task, alongside execution records and user feedback, to inform the next model choice and task delegation.')}</p></div>
+ <figure class="product-shot"><img src={`/decision-assets/quality-native-${en ? 'en' : 'zh-CN'}.png`} alt={t('HiRoute Desktop 会话页面,展示同一任务的两段模型评分与用户复查反馈', 'HiRoute Desktop session showing two model-stage assessments and the user’s follow-up feedback for one task')} width="1200" height="813" loading="lazy"></figure>
+ <p class="caption">{t('真实 Desktop 界面 · 演示数据,非模型评测。', 'Actual Desktop interface · Illustrative data, not a model benchmark.')}</p>
<div class="proof-bottom"><article><h3>{t('分数始终带着范围', 'A score keeps its scope')}</h3><p>{t('评分属于具体计划、版本、模型和执行阶段;旧评分不会假装覆盖新增轮次。', 'A score belongs to a plan, revision, model, and execution stage; new turns are not silently covered by an older assessment.')}</p></article><article><h3>{t('证据可以帮助细分计划', 'Evidence can refine work plans')}</h3><p>{t('主 Agent 可查询高低分任务,结合证据判断是否需要建立更聚焦的工作场景。', 'A main agent can query high- and low-scoring tasks, inspect evidence, and propose a narrower work plan.')}</p></article></div>
</section>
diff --git a/apps/website/tests/decision-docs.test.mjs b/apps/website/tests/decision-docs.test.mjs
index 46a473c6..5de32c84 100644
--- a/apps/website/tests/decision-docs.test.mjs
+++ b/apps/website/tests/decision-docs.test.mjs
@@ -25,3 +25,17 @@ test('prepared OpenAPI is byte-identical to the one repository contract', () =>
const parsed = JSON.parse(prepared);
assert(parsed.paths['/v1/decisions']);
});
+
+test('native homepage screenshots are distinct, correctly sized and copied unchanged', () => {
+ const captures = ['en', 'zh-CN'].map(language => {
+ const name = `quality-native-${language}.png`;
+ const source = fs.readFileSync(new URL(`../../../decision-extensions/assets/${name}`, import.meta.url));
+ const prepared = fs.readFileSync(new URL(`../public/decision-assets/${name}`, import.meta.url));
+ assert.deepEqual(prepared, source);
+ assert.equal(source.subarray(1, 4).toString(), 'PNG');
+ assert.equal(source.readUInt32BE(16), 1200);
+ assert.equal(source.readUInt32BE(20), 813);
+ return source;
+ });
+ assert.notDeepEqual(captures[0], captures[1]);
+});
diff --git a/decision-extensions/assets/README.md b/decision-extensions/assets/README.md
index f8bf9fec..88bc076b 100644
--- a/decision-extensions/assets/README.md
+++ b/decision-extensions/assets/README.md
@@ -1,5 +1,28 @@
# Decision documentation illustrations
+## Native Desktop homepage screenshots
+
+`quality-native-en.png` and `quality-native-zh-CN.png` are unmodified screenshots
+of the running macOS Desktop WebView (1200 × 813), not a browser composition.
+Both show the Sessions page with Model performance expanded and the latest
+stage's Assessment feedback selected. The app reads the records through its
+real daemon. No CSS changes, simulated IPC, rearranged components or image
+retouching were used.
+
+The isolated observation store was populated with a synthetic order-reconciliation
+conversation, two scored stages and the corresponding feedback. The conversation
+is marked as a demonstration. Model scores, execution outcomes and user feedback
+are illustrative, not measurements of model quality. These captures establish
+the displayed UI and evidence navigation only, not end-to-end classification,
+score production, persistence ingestion or live provider execution.
+
+To reproduce the view, use an isolated Desktop instance with matching-language
+demonstration records, open Sessions, expand Model performance and select the
+latest stage's Assessment feedback. Capture the whole WebView with no layout
+overrides. The website selects the corresponding screenshot for each language.
+
+## Component-based documentation previews
+
These documentation previews use HiRoute's real `HomeNavigation`, `RoutingPage`,
`PlanEditor` and `PlanQuality` components and shared product styles. They were
captured in Chromium on the configured macOS workbench, not from a native Desktop
diff --git a/decision-extensions/assets/quality-native-en.png b/decision-extensions/assets/quality-native-en.png
new file mode 100644
index 00000000..b6046646
Binary files /dev/null and b/decision-extensions/assets/quality-native-en.png differ
diff --git a/decision-extensions/assets/quality-native-zh-CN.png b/decision-extensions/assets/quality-native-zh-CN.png
new file mode 100644
index 00000000..cb4a29e5
Binary files /dev/null and b/decision-extensions/assets/quality-native-zh-CN.png differ