@ljwei-stak/dsh-model-router 0.14.0 → 0.15.0

package/.dsh-plugin/index.mjs

@@ -331,9 +331,9 @@ function budgetSettings(config) {
   }
 }
 
-function budgetFor(config, runs, estimateUsd) {
+function budgetFor(config, saved, estimateUsd) {
   const settings = budgetSettings(config)
-  const spent = spending(runs)
+  const spent = spending(saved.runs, undefined, saved.archivedSpending)
   return { ...budgetCheck({ estimateUsd, spent, ...settings }), spent, ...settings }
 }
 
@@ -386,7 +386,7 @@ export async function createRoutePlan(ctx, task, config = {}, options = {}) {
     preset: routingPresetOf(config, options.preset),
     loggedOutToolIds: loggedOut,
   })
-  return { ...plan, budgetStatus: budgetFor(config, saved.runs, plan.estimatedCost) }
+  return { ...plan, budgetStatus: budgetFor(config, saved, plan.estimatedCost) }
 }
 
 /** One bounded, independent call through the same official LLM service. */
@@ -626,10 +626,10 @@ export async function planAssignment(ctx, task, config = {}, options = {}) {
       budgetUsd, installedToolIds: installed, runnableToolIds, preset: presetId, loggedOutToolIds: loggedOut,
     })
   let plan = planWith(preset, options.budgetUsd)
-  let budget = budgetFor(config, saved.runs, plan.estimatedCost)
+  let budget = budgetFor(config, saved, plan.estimatedCost)
   if (budget.exceeded && budget.action === 'downgrade' && !direct) {
     const cheaper = planWith('economy', budget.remainingUsd > 0 ? budget.remainingUsd : options.budgetUsd)
-    const recheck = budgetFor(config, saved.runs, cheaper.estimatedCost)
+    const recheck = budgetFor(config, saved, cheaper.estimatedCost)
     if (!recheck.exceeded) {
       budget = { ...recheck, downgraded: true, downgradedFrom: preset,
         message: `原方案${budget.message} 已自动降级为“省钱优先”方案（预估 ${cheaper.estimatedCost === null ? '价格待配置' : formatUsd(cheaper.estimatedCost)}）。` }
@@ -768,7 +768,7 @@ export async function rerunRecordedStep(ctx, config = {}, { runId, packageId, pr
       budget: null, message: '续跑可编辑团队步骤会在新的独立 Git 工作树中套用之前的改动并修改文件，需要先确认。' }
   }
   const sameRoute = !override || (override.provider === target.recommendedProvider && override.model === target.recommendedModel)
-  const budget = budgetFor(config, saved.runs, sameRoute ? target.estimatedCost : null)
+  const budget = budgetFor(config, saved, sameRoute ? target.estimatedCost : null)
   if (budget.exceeded && confirmOverBudget !== true) {
     return { paused: true, budget: { ...budget, paused: true, message: `${budget.message} 已暂停重跑，请确认后再试。` }, run }
   }
@@ -967,7 +967,7 @@ export async function planToolRun(ctx, config, args = {}, { signal } = {}) {
     modelId = text(args.cliModel)
   }
   const estimate = route ? createPlanFromRoutes(taskText, routes, { mode: 'direct', directProvider: route.provider, directModel: route.model }).estimatedCost : null
-  const budget = budgetFor(config, (await savedState()).runs, Number.isFinite(estimate) ? estimate : null)
+  const budget = budgetFor(config, await savedState(), Number.isFinite(estimate) ? estimate : null)
   return { toolId, tool, taskText, mode, modelId, route, routes, estimate: Number.isFinite(estimate) ? estimate : null, budget,
     provider: route?.provider ?? '', model: route?.model ?? '', cliModel: text(args.cliModel) || null }
 }
@@ -1013,7 +1013,7 @@ export async function rateRecordedResult({ runId, packageId, rating } = {}) {
 /** Everything the workbench shows: recent runs, spending, budget, learned biases and settings. */
 export async function ledgerSummary(config = {}, { limit = 30 } = {}) {
   const saved = await savedState()
-  const spent = spending(saved.runs)
+  const spent = spending(saved.runs, undefined, saved.archivedSpending)
   const settings = budgetSettings(config)
   return {
     runs: saved.runs.slice(-limit).reverse().map(run => ({
@@ -1692,7 +1692,7 @@ function registerOfficialToolModels(ctx, config) {
         runnableToolIds: installed.filter(id => supported.has(id)),
         preset: routingPresetOf(config),
       })
-      const budget = budgetFor(config, (await savedState()).runs, plan.estimatedCost)
+      const budget = budgetFor(config, await savedState(), plan.estimatedCost)
       if (budget.exceeded && args.confirmOverBudget !== true) {
         return jsonValue({ status: 'paused-budget', budget, plan,
           notice: `${budget.message} 已暂停团队执行。请向用户确认后以 confirmOverBudget: true 重新调用。` })

package/.dsh-plugin/shared/router-state.mjs

@@ -14,6 +14,7 @@
 import { mkdir, open, readFile, rename, stat, unlink, writeFile } from 'node:fs/promises'
 import { homedir } from 'node:os'
 import { dirname, isAbsolute, join, resolve } from 'node:path'
+import { archiveSpending, sanitizeArchivedSpending } from './run-ledger.mjs'
 
 export const MAX_RUNS = 200
 const STATE_VERSION = 1
@@ -38,7 +39,7 @@ const LOCK_STALE_MS = 15_000
 const LOCK_TIMEOUT_MS = 10_000
 
 function emptyState() {
-  return { version: STATE_VERSION, onboarding: { completedAt: null }, health: null, quota: {}, authFailures: {}, runs: [], notices: [], terminalSessions: [] }
+  return { version: STATE_VERSION, onboarding: { completedAt: null }, health: null, quota: {}, authFailures: {}, runs: [], archivedSpending: sanitizeArchivedSpending(), notices: [], terminalSessions: [] }
 }
 
 function sanitizeNotices(value) {
@@ -47,19 +48,27 @@ function sanitizeNotices(value) {
     : []
 }
 
-function sanitize(value) {
+function retainRuns(state, maxRuns) {
+  const removed = Math.max(0, state.runs.length - maxRuns)
+  state.archivedSpending = archiveSpending(state.runs.slice(0, removed), state.archivedSpending)
+  state.runs = state.runs.slice(removed)
+  return state
+}
+
+function sanitize(value, maxRuns) {
   if (!value || typeof value !== 'object' || value.version !== STATE_VERSION) return emptyState()
-  return {
+  return retainRuns({
     version: STATE_VERSION,
     onboarding: { completedAt: Number.isFinite(value.onboarding?.completedAt) ? value.onboarding.completedAt : null },
     health: value.health && Array.isArray(value.health.tools) ? value.health : null,
     quota: value.quota && typeof value.quota === 'object' && !Array.isArray(value.quota) ? value.quota : {},
     authFailures: Object.fromEntries(Object.entries(value.authFailures && typeof value.authFailures === 'object' && !Array.isArray(value.authFailures) ? value.authFailures : {})
       .filter(([, entry]) => Number.isFinite(entry?.at))),
-    runs: Array.isArray(value.runs) ? value.runs.filter(run => run && typeof run.id === 'string').slice(-MAX_RUNS) : [],
+    runs: Array.isArray(value.runs) ? value.runs.filter(run => run && typeof run.id === 'string') : [],
+    archivedSpending: sanitizeArchivedSpending(value.archivedSpending),
     notices: sanitizeNotices(value.notices),
     terminalSessions: sanitizeTerminalSessions(value.terminalSessions),
-  }
+  }, maxRuns)
 }
 
 function sanitizeTerminalSessions(value) {
@@ -110,6 +119,7 @@ async function acquireLock(lockFile, { staleMs = LOCK_STALE_MS, timeoutMs = LOCK
 }
 
 export function createRouterState({ file = defaultStatePath(), maxRuns = MAX_RUNS, now = Date.now } = {}) {
+  const historyLimit = Number.isInteger(maxRuns) && maxRuns > 0 ? Math.min(maxRuns, MAX_RUNS) : MAX_RUNS
   let cache = null
   let cacheKey = ''
   let chain = Promise.resolve()
@@ -127,7 +137,7 @@ export function createRouterState({ file = defaultStatePath(), maxRuns = MAX_RUN
       if (error?.code === 'ENOENT') return { state: emptyState(), corrupt: false }
       throw error
     }
-    try { return { state: sanitize(JSON.parse(raw)), corrupt: false } }
+    try { return { state: sanitize(JSON.parse(raw), historyLimit), corrupt: false } }
     catch {
       const at = now()
       const backup = `${file}.corrupt-${stamp(at)}`
@@ -171,7 +181,7 @@ export function createRouterState({ file = defaultStatePath(), maxRuns = MAX_RUN
         const state = await load()
         if (pendingNotices.length) { state.notices.push(...pendingNotices); pendingNotices = [] }
         const result = await change(state)
-        state.runs = state.runs.slice(-maxRuns)
+        retainRuns(state, historyLimit)
         state.notices = sanitizeNotices(state.notices)
         state.terminalSessions = sanitizeTerminalSessions(state.terminalSessions)
         await persist(state)

package/.dsh-plugin/shared/run-ledger.mjs

@@ -63,34 +63,94 @@ const pad = value => String(value).padStart(2, '0')
 export const dayKey = at => { const date = new Date(at); return `${date.getFullYear()}-${pad(date.getMonth() + 1)}-${pad(date.getDate())}` }
 export const monthKey = at => { const date = new Date(at); return `${date.getFullYear()}-${pad(date.getMonth() + 1)}` }
 
-/** Recorded spending for today and this month, plus packages whose cost is unknown. */
-export function spending(runs, at = Date.now()) {
-  const today = dayKey(at)
-  const month = monthKey(at)
-  const total = { today: 0, month: 0, unknownToday: 0, unknownMonth: 0, subscriptionToday: 0, subscriptionMonth: 0, subscriptionRunsToday: 0, subscriptionRunsMonth: 0 }
+/** Detailed history can be evicted without losing the current budget totals. */
+export const MAX_SPENDING_DAYS = 90
+export const MAX_SPENDING_MONTHS = 24
+const emptyPeriodSpending = () => ({ costUsd: 0, unknown: 0, subscriptionUsd: 0, subscriptionRuns: 0 })
+
+function periodSpending(value) {
+  const amount = field => finite(value?.[field]) && value[field] >= 0 ? value[field] : 0
+  return { costUsd: amount('costUsd'), unknown: Math.floor(amount('unknown')),
+    subscriptionUsd: amount('subscriptionUsd'), subscriptionRuns: Math.floor(amount('subscriptionRuns')) }
+}
+
+/** Bounded calendar aggregates contain amounts and counts, never tasks or answers. */
+export function sanitizeArchivedSpending(value) {
+  const periods = (entries, pattern, limit) => Object.fromEntries(Object.entries(entries && typeof entries === 'object' && !Array.isArray(entries) ? entries : {})
+    .filter(([key, entry]) => pattern.test(key) && entry && typeof entry === 'object' && !Array.isArray(entry))
+    .sort(([left], [right]) => left.localeCompare(right)).slice(-limit)
+    .map(([key, entry]) => [key, periodSpending(entry)]))
+  return {
+    days: periods(value?.days, /^\d{4}-(?:0[1-9]|1[0-2])-(?:0[1-9]|[12]\d|3[01])$/, MAX_SPENDING_DAYS),
+    months: periods(value?.months, /^\d{4}-(?:0[1-9]|1[0-2])$/, MAX_SPENDING_MONTHS),
+  }
+}
+
+function addArchivedSpending(target, source) {
+  const archive = sanitizeArchivedSpending(source)
+  for (const period of ['days', 'months']) {
+    for (const [key, amount] of Object.entries(archive[period])) {
+      const total = target[period][key] ??= emptyPeriodSpending()
+      for (const field of Object.keys(amount)) total[field] += amount[field]
+    }
+  }
+}
+
+function* spendingEntries(runs) {
   for (const run of Array.isArray(runs) ? runs : []) {
-    for (const item of [...(run.packages ?? []), ...(run.reviews ?? [])]) {
+    for (const item of [...(Array.isArray(run?.packages) ? run.packages : []), ...(Array.isArray(run?.reviews) ? run.reviews : [])]) {
+      if (!item || typeof item !== 'object') continue
       const when = item.finishedAt ?? run.createdAt
-      if (!finite(when)) continue
-      const inMonth = monthKey(when) === month
-      if (!inMonth) continue
-      const inDay = dayKey(when) === today
+      if (!finite(when) || !finite(new Date(when).getTime())) continue
+      const amount = emptyPeriodSpending()
       if (item.billing === 'subscription') {
-        // API-equivalent reference only; a subscription login is not budget spend.
+        // A subscription login is reference cost only, never budget spend.
         if (item.ran !== true) continue
-        total.subscriptionRunsMonth += 1
-        if (inDay) total.subscriptionRunsToday += 1
-        if (finite(item.referenceCostUsd)) {
-          total.subscriptionMonth += item.referenceCostUsd
-          if (inDay) total.subscriptionToday += item.referenceCostUsd
-        }
-      } else if (finite(item.costUsd)) {
-        total.month += item.costUsd
-        if (inDay) total.today += item.costUsd
-      } else if (item.ran === true) {
-        total.unknownMonth += 1
-        if (inDay) total.unknownToday += 1
-      }
+        amount.subscriptionRuns = 1
+        if (finite(item.referenceCostUsd) && item.referenceCostUsd >= 0) amount.subscriptionUsd = item.referenceCostUsd
+      } else if (finite(item.costUsd) && item.costUsd >= 0) amount.costUsd = item.costUsd
+      else if (item.ran === true) amount.unknown = 1
+      else continue
+      yield { when, amount }
+    }
+  }
+}
+
+/** Fold only evicted records into the archive; retained records are counted live. */
+export function archiveSpending(runs, archivedSpending) {
+  const archive = sanitizeArchivedSpending(archivedSpending)
+  for (const run of Array.isArray(runs) ? runs : []) addArchivedSpending(archive, run?.priorAttemptSpending)
+  for (const { when, amount } of spendingEntries(runs)) {
+    for (const [periods, key] of [[archive.days, dayKey(when)], [archive.months, monthKey(when)]]) {
+      const total = periods[key] ??= emptyPeriodSpending()
+      for (const field of Object.keys(amount)) total[field] += amount[field]
+    }
+  }
+  return sanitizeArchivedSpending(archive)
+}
+
+/** Recorded spending, including evicted history, for the local day and month. */
+export function spending(runs, at = Date.now(), archivedSpending = null) {
+  const today = dayKey(at)
+  const month = monthKey(at)
+  const archive = sanitizeArchivedSpending(archivedSpending)
+  for (const run of Array.isArray(runs) ? runs : []) addArchivedSpending(archive, run?.priorAttemptSpending)
+  const daily = periodSpending(archive.days[today])
+  const monthly = periodSpending(archive.months[month])
+  const total = { today: daily.costUsd, month: monthly.costUsd, unknownToday: daily.unknown, unknownMonth: monthly.unknown,
+    subscriptionToday: daily.subscriptionUsd, subscriptionMonth: monthly.subscriptionUsd,
+    subscriptionRunsToday: daily.subscriptionRuns, subscriptionRunsMonth: monthly.subscriptionRuns }
+  for (const { when, amount } of spendingEntries(runs)) {
+    if (monthKey(when) !== month) continue
+    total.month += amount.costUsd
+    total.unknownMonth += amount.unknown
+    total.subscriptionMonth += amount.subscriptionUsd
+    total.subscriptionRunsMonth += amount.subscriptionRuns
+    if (dayKey(when) === today) {
+      total.today += amount.costUsd
+      total.unknownToday += amount.unknown
+      total.subscriptionToday += amount.subscriptionUsd
+      total.subscriptionRunsToday += amount.subscriptionRuns
     }
   }
   return total
@@ -248,6 +308,10 @@ export function buildRunRecord({ id, createdAt, task, plan, execution, preset =
 export function mergeRerun(run, execution, { rerunIds = [], pricingFor = () => null, billingFor = billingOf, finishedAt = Date.now() } = {}) {
   const results = Array.isArray(execution?.packages) ? execution.packages : []
   const retried = new Set(rerunIds)
+  // Retrying replaces the visible result, but earlier attempts still incurred
+  // charges (or unknown usage). Keep their calendar totals before replacement.
+  const replaced = run.packages.filter(stored => retried.has(stored.id) && results.some(item => item.id === stored.id))
+  run.priorAttemptSpending = archiveSpending([{ createdAt: run.createdAt, packages: replaced }], run.priorAttemptSpending)
   run.packages = run.packages.map(stored => {
     const result = results.find(item => item.id === stored.id)
     if (!result || !retried.has(stored.id)) return stored

package/CHANGELOG.md

@@ -1,5 +1,16 @@
 # Changelog
 
+## 0.15.0 — 2026-10-03
+
+- Reorganize the workbench into task/execution, model configuration, official tools, and budget/security pages. Keep panels mounted so drafts, installation polling, and terminal sessions survive navigation; add keyboard tab navigation and panel-width responsive layouts.
+- Show local routing results immediately after task planning, with expandable work-package details and human-readable dependency names.
+- Discard pending execution previews when their inputs change, and confirm only the request that was actually previewed. Invalidate local plans when model profiles or routing settings change externally.
+- Preserve API spending, unknown-call counts, and subscription reference costs when detailed history is pruned or a step is retried. Retain 200 detailed runs plus bounded calendar aggregates; previously discarded costs cannot be recovered.
+- Add `npm run preview:ui`: a localhost-only preview of the actual client with in-memory fixtures, five normal/error/empty/onboarding/delayed scenarios, and no real model calls or terminal processes.
+- Rewrite the English/Chinese README, installation instructions, and workbench guide around the current capabilities, source setup, execution boundaries, and local-data behavior. Include the guide and a clearly labeled simulated UI screenshot in the package.
+
+Validation: 220 tests passed, with 3 existing Windows-specific skips; the generated client and packaged file bytes were checked. Browser preview checks cover navigation, narrow panels, validation, draft persistence, and stale-preview rejection. Real vendor accounts, paid CLI calls, and Harness Desktop end-to-end execution were not exercised in this release's validation.
+
 ## 0.14.0 — 2026-10-03
 
 Stable release under the npm `latest` tag. It folds in the 0.14.0-beta.1 – beta.4 prereleases (published under `next` only). **After updating, quit Harness completely (including the tray icon) and start it again**: Harness serves the new workbench UI at once, but the running Host keeps the plugin code it already imported, so the new Host methods are missing until a full restart. The workbench now warns when the Host and client versions differ.

package/INSTALLATION_GUIDE.zh.md

@@ -2,17 +2,19 @@
 
 模型路由从 **0.12.0** 起独立发布；GAL 是新的 **0.1.0** 插件。两者均声明支持官方 **DeepSeek Harness Desktop 0.2.0-rc.1 / 0.2.0-rc.2**，可分别安装和更新。
 
+当前路由版本为 **0.15.0**。本版包括四页工作台、规划后直接展示路由建议、执行输入变化后丢弃旧预览，以及历史裁剪和重试后的费用累计保留。源码开发可使用独立模拟 UI 预览；安装时选择下方精确版本。
+
 [路由 README](README.zh.md) · [迁移说明](MIGRATION.md) · [独立 GAL README](https://github.com/Alice-Marx/deepseek-harness-galgame#readme)
 
 ## 1. 选择需要的插件
 
 | 需求 | 添加插件输入框 | 安装后的入口 |
 | --- | --- | --- |
-| 分析复杂度、按质量和费用选模型、调用官方工具 | `@ljwei-stak/dsh-model-router@0.14.0` | 模型路由 |
+| 分析复杂度、按质量和费用选模型、调用官方工具 | `@ljwei-stak/dsh-model-router@0.15.0` | 模型路由 |
 | 剧情、立绘、音乐、存档、自由对话 | `@ljwei-stak/dsh-galgame@0.1.0` | Gal 模块 |
 | 两者都要 | 分别安装上面两个包 | 模型路由 + Gal 模块 |
 
-路由保留旧 npm 包名供原用户升级，包名中的 `galgame` 是历史名称；**路由 0.12.0 不含 GAL 入口或剧情美术**。GAL 不依赖路由，路由也不依赖 GAL。
+旧 npm 包名 `@ljwei-stak/model-router-galgame` 最后版本为 0.13.0，之后不再更新；新安装使用 `@ljwei-stak/dsh-model-router`。自 0.12.0 起路由不含 GAL 入口或剧情美术。GAL 不依赖路由，路由也不依赖 GAL。
 
 路由正式版发布在 npm **`latest`** 标签，预发布版在 `next`。推荐填写精确版本。不要省略版本号：`latest` 或镜像状态可能选择与当前宿主不兼容的旧包。
 
@@ -22,7 +24,7 @@
 2. 在“包名、GitHub 仓库地址或本地目录路径”输入框填一个完整包名，例如：
 
    ```text
-   @ljwei-stak/dsh-model-router@0.14.0
+   @ljwei-stak/dsh-model-router@0.15.0
    ```
 
    只想安装 GAL 时填写：
@@ -37,8 +39,8 @@
    https://registry.npmjs.org/
    ```
 
-4. 核对预览的包名、版本和宿主兼容信息，安装并启用。有重启提示时重启桌面程序。
-5. 检查插件详情与侧边栏：路由应为 **0.14.0 / 模型路由**；GAL 应为 **0.1.0 / Gal 模块**。仅装路由时没有 GAL 入口是预期行为。
+4. 核对预览的包名、版本和宿主兼容信息，安装并启用。完全退出 Harness（包括托盘进程）再启动，确保 Host 加载新代码。
+5. 检查插件详情与侧边栏：路由应为 **0.15.0 / 模型路由**；GAL 应为 **0.1.0 / Gal 模块**。仅装路由时没有 GAL 入口是预期行为。
 
 普通用户无需 `npm install -g`，该命令不会把插件注册到当前 Harness profile。
 
@@ -46,13 +48,13 @@
 
 进入对应 Release 下载 `.tgz`：
 
-- [模型路由 Releases](https://github.com/Alice-Marx/dsh-model-router/releases)（也可运行 `npm pack @ljwei-stak/dsh-model-router@0.14.0` 获取同一安装包）
+- [模型路由 Releases](https://github.com/Alice-Marx/dsh-model-router/releases)（也可运行 `npm pack @ljwei-stak/dsh-model-router@0.15.0` 获取同一安装包）
 - [独立 GAL v0.1.0](https://github.com/Alice-Marx/deepseek-harness-galgame/releases/tag/v0.1.0)
 
 在“添加插件”填写下载文件的**绝对路径**，例如：
 
 ```text
-D:\Plugins\ljwei-stak-dsh-model-router-0.14.0.tgz
+D:\Plugins\ljwei-stak-dsh-model-router-0.15.0.tgz
 ```
 
 ```text
@@ -62,7 +64,7 @@ D:\Plugins\ljwei-stak-dsh-galgame-0.1.0.tgz
 如附有 `.sha256` 文件，用 PowerShell 计算并比较摘要：
 
 ```powershell
-Get-FileHash -Algorithm SHA256 -LiteralPath 'D:\Plugins\ljwei-stak-dsh-model-router-0.14.0.tgz'
+Get-FileHash -Algorithm SHA256 -LiteralPath 'D:\Plugins\ljwei-stak-dsh-model-router-0.15.0.tgz'
 Get-FileHash -Algorithm SHA256 -LiteralPath 'D:\Plugins\ljwei-stak-dsh-galgame-0.1.0.tgz'
 ```
 
@@ -72,7 +74,7 @@ Get-FileHash -Algorithm SHA256 -LiteralPath 'D:\Plugins\ljwei-stak-dsh-galgame-0
 
 1. 在旧合并插件的 GAL 播放器导出需要保留的剧情进度，并备份整个 Harness profile。每份 JSON 仅保存**当前剧情状态**，不含所有手动槽、设置、已读记录或本地音乐；重要槽位可依次读档再导出。
 2. 在**同一个 profile**安装独立 `@ljwei-stak/dsh-galgame@0.1.0`。
-3. 0.13.0 起包名改为 `@ljwei-stak/dsh-model-router`（旧包名最后版本为 0.13.0，内容相同，之后不再更新）：在插件管理器卸载原 `@ljwei-stak/model-router-galgame`（保留 profile 与应用数据），再添加 `@ljwei-stak/dsh-model-router@0.14.0`。不要两个同时安装（条目 id 与工具名相同）；条目 id 未变，路由设置与执行记录会保留。完成两项更新后再玩剧情，避免同时操作旧合并入口和新入口。
+3. 0.13.0 起包名改为 `@ljwei-stak/dsh-model-router`（旧包名最后版本为 0.13.0，内容相同，之后不再更新）：在插件管理器卸载原 `@ljwei-stak/model-router-galgame`（保留 profile 与应用数据），再添加 `@ljwei-stak/dsh-model-router@0.15.0`。不要两个同时安装（条目 id 与工具名相同）；条目 id 未变，路由设置与执行记录会保留。完成两项更新后再玩剧情，避免同时操作旧合并入口和新入口。
 4. 现在路由与 GAL 各有一个入口。独立 GAL 沿用旧存档 localStorage 键，核对当前进度和三槽；更换 profile 或进度未恢复时，先切换到匹配剧目，再导入 JSON 备份。
 5. 后续分别更新需要的插件；只用路由可以不启用或不安装 GAL。保留 profile 与应用数据，卸载插件时不要清理故事数据。
 
@@ -80,18 +82,22 @@ GAL 核心只包含**《回声之城·正篇》**与**《旧城迁移篇：未
 
 ## 5. 模型路由第一次使用
 
-1. 在 Harness 官方**模型**页配置供应商、模型与凭据。插件只读取准确的 `provider/model` 目录，不另存 API Key。
-2. 打开**模型路由 → 逐模型价格与能力**，逐条填写自报质量评分、核对过的输入/输出单价（USD / 百万 token）、擅长方向；缺价留空。厂商 CLI 模型名 `cliModel` 可选，必须是该 CLI 接受的名字。
-3. 在**任务规划**输入目标、步骤与验收标准。单任务给一项建议，团队分工把复合任务拆成有依赖的工作包。预算是本地估价目标，0 表示不设估价约束，不限制实际厂商账单。
-4. 点**生成路由建议**，向下滚过模型档案编辑区，查看**路由建议**和各工作包。规划不启动模型。
-5. 在**官方工具**卡片检测、安装或修复可信执行入口；ZCode 使用原厂安装窗口，用户选择安装目录后重新检测。就绪只证明本地入口通过检查。
-6. 实际执行时进入官方会话、选工作区，明确请求 `model_router_consult`、`model_router_tool_run` 或 `model_router_team_execute`。可编辑运行需要干净 Git 仓库与宿主工具审批。
+0.15.0 工作台分成**任务与执行、模型配置、官方工具、预算与安全**四页。切换页面保留安装任务、终端会话和未完成的输入。
+
+1. 在 Harness 官方**模型**页配置供应商、模型与凭据。插件读取准确的 `provider/model` 目录，模型档案不保存 API Key。
+2. 在**模型配置**刷新目录，逐条填写自报质量评分、核对过的输入/输出单价（USD / 百万 token）和擅长方向；缺价留空。可选 `cliModel` 必须是该厂商 CLI 已验证接受的名字。
+3. 在**任务与执行 → 任务规划**输入目标、步骤和验收标准。单任务推荐一条路线，团队模式为足够复杂的任务拆依赖工作包，指定模型跳过其他路线比较。预算是本地估价目标，`0` 表示不设本次估价约束，不限制厂商账单。
+4. 点**生成路由建议**。建议直接显示在规划之后；生成建议在本机完成，不启动模型或 CLI。
+5. 需要真实只读执行时，使用**在工作台执行**，填写存在的工作区绝对路径（留空沿用上次运行）。先**预览执行计划**、核对路线/费用和全部确认原因，再明确确认执行。宿主启动前会重查；确认后才发生真实调用，结果写入执行记录。
+6. 在**官方工具**检测、安装/更新工具并核对入口与登录。ZCode 打开原厂安装窗口后仍需用户选择目录并完成安装，再体检。可信入口就绪不等于账号和模型有权限。
+7. 在**预算与安全**查看每日/月度预算、订阅失败策略及可读/写边界。官方工具终端不经过 Harness 沙箱，继承用户登录环境，需单独确认启动。
+8. 需要 CLI 修改文件时进入官方会话、选择工作区，明确请求 `model_router_tool_run` 或 `model_router_team_execute` 的 `workspace-write` 模式。可编辑托管执行要求干净 Git 仓库、宿主审批和进程沙箱。`model_router_execute` 用于只读路由执行，`model_router_consult` 用于模型 API 意见。
 
-完整页面教程、参数和结果位置见[工作台使用指南](docs/WORKBENCH_USER_GUIDE.zh.md)，算法推导见[README](README.zh.md#路由算法从输入到分配)。
+完整教程见[工作台使用指南](docs/WORKBENCH_USER_GUIDE.zh.md)；路线算法、订阅与数据保存说明见[README](README.zh.md)。
 
-Claude、Codex、MiMo、Grok 支持只读或可编辑；Kimi、MiniMax、ZCode 无界面模式仅在获批的隔离可编辑工作区运行。CLI 模型名可能不同于 Harness 目录；多数 CLI 不提供可核验的实际模型 ID，要看厂商记录与账单。
+注册表包含 Kimi、Claude、Codex、MiniMax、MiMo、Grok、Gemini 和 ZCode。Claude、Codex、MiMo、Grok 支持单工具/团队只读或可编辑执行；Kimi、MiniMax、ZCode 仅支持获批的可编辑托管执行。Gemini 有路由无界面适配器，不进入单工具/团队托管执行器。详见[官方工具与托管模式](README.zh.md#官方工具与托管模式)。CLI 模型名可能不同于 Harness 目录；多数 CLI 不提供可核验的实际模型 ID，要看厂商记录与账单。
 
-希望官方 CLI 尽量装在非 C 盘时，先按自己的空间规划配置 npm 全局前缀。MiniMax Windows npm 原生依赖失败时使用锁定哈希的官方安装脚本兜底，内容变化会拒绝执行；Grok 非 C 盘 npm 安装的数据目录与登录须使用一致的 `GROK_HOME`。
+安装使用固定官方 npm 包的 `@latest` 或 ZCode 签名安装器。希望 npm 工具安装在非 C 盘时，先按自己的空间规划配置全局前缀；Grok 数据目录与登录应使用一致的 `GROK_HOME`。MiniMax Windows 原生依赖失败时，从固定官方 HTTPS 来源下载最新版安装脚本，仅检查大小和基本内容结构后原样执行，**没有锁定该安装脚本的哈希**。安装后的 MiniMax CLI 代码另按已安装版本的官方 npm tarball 摘要核验。MiMo/Grok 同样使用官方 npm 内容证明；适用的 Claude/Codex/ZCode Windows 入口验证发布者签名，ZCode 内置脚本还有每个签名构建的首次信任摘要检查。具体规则见[执行器](.dsh-plugin/shared/official-tool-executor.mjs)和[npm 内容核验](.dsh-plugin/shared/npm-attestation.mjs)。
 
 ## 6. GAL 第一次使用
 
@@ -104,31 +110,33 @@ Claude、Codex、MiMo、Grok 支持只读或可编辑；Kimi、MiniMax、ZCode
 | 检查 | 预期 |
 | --- | --- |
 | 宿主版本 | 0.2.0-rc.1 或 0.2.0-rc.2；包括 `rc` 后缀。 |
-| 路由独立安装 | 0.14.0 详情、模型路由入口、目录和模型档案可用；不出现旧合并 GAL 入口。 |
+| 路由独立安装 | 0.15.0 详情、模型路由入口、目录和模型档案可用；不出现旧合并 GAL 入口。 |
 | GAL 独立安装 | 0.1.0 详情、Gal 模块入口、标题与两部核心剧情可用；不要求安装路由。 |
 | 共同安装 | 两个入口各一份，路由工具和 GAL 播放器均能使用。 |
 | 存档迁移 | 同 profile 可读旧键；跨 profile 用匹配剧目 JSON 导入；旧篇目的数据不覆盖。 |
 | 本地规划 | 简单与复杂工作包分配可解释；价格未知保持未知；生成计划不调用模型。 |
 | 官方工具 | 探测、固定来源安装、修复、取消和日志可检查；登录另验。 |
-| 真实执行 | 在测试仓库核对审批、隔离工作区、补丁整合、厂商实际模型与计费。 |
+| 工作台只读执行 | 预览不启动模型，明确确认后执行；核对记录中的渠道、错误与费用。 |
+| 可编辑执行 | 在干净测试仓库核对审批、隔离工作区、补丁整合、厂商实际模型与计费。 |
 
-构建、自动测试、包内容和发布校验由本次总项目报告记录。真实账号调用与用户现用 profile 的验收仍需账号持有人进行。
+0.15.0 的自动测试验证为 220 项通过、3 项 Windows 平台跳过；组件 UI 预览检查使用模拟数据。本次验证未覆盖真实 CLI/账号调用或 Harness Desktop 端到端操作，上表中的安装后验收仍需在实际环境中完成。
 
 ## 8. 开发者从完整源码构建
 
-路由仓库检出 `v0.14.0`；GAL 仓库检出 `v0.1.0`。使用 Node.js **22.19+** 与 pnpm，各自在根目录运行：
+路由需要 Node.js **22.19+** 与 **pnpm 10.34.6**。从完整源码仓库根目录构建；复现 0.15.0 时检出对应发布标签，旧标签保留其当时内容。运行：
 
 ```powershell
-pnpm install --frozen-lockfile
+pnpm install --frozen-lockfile --strict-peer-dependencies
 npm run build:client
 npm test
 npm run check:client
-pnpm peers check
-npm pack --pack-destination dist
+npm run pack:local
 ```
 
-两项目的生成包互相独立。客户端有修改时必须重建，再将包绝对路径填入插件管理器验证。
+pnpm 10 没有 `pnpm peers check`；使用严格依赖安装。客户端修改后必须重建，通过 `check:client` 再打包。将 `dist` 中本地包的绝对路径填入插件管理器，在测试 profile 验证；本地开发改动需独立验证，不能仅凭版本号判断包内容相同。
+
+仅查看 UI 可运行 `npm run preview:ui` 并打开[本地预览](http://127.0.0.1:4173)。这是模拟目录、工具和执行记录，不启动 Harness Host、真实 CLI 或付费模型；不能代替桌面集成验收。GAL 独立仓库的开发与验证步骤以其自身 README 为准。
 
 ## 历史兼容提醒
 
-合并版 **0.11.1 / 0.11.0** 声明 rc.1 与 rc.2；**0.10.2** 是未发布的本地兼容修复。已发布 **0.10.1** 仅声明 rc.1，rc.2 拒绝安装是 peer 依赖问题，换镜像不能修复；**0.8.0** 使用 0.1.7-rc.2 依赖，不用于当前宿主。历史 Git 标签和安装包保留，详见 [README 版本表](README.zh.md#历史版本)。
+合并版 **0.11.1 / 0.11.0** 声明 rc.1 与 rc.2；**0.10.2** 是未发布的本地兼容修复。已发布 **0.10.1** 仅声明 rc.1，rc.2 拒绝安装是 peer 依赖问题，换镜像不能修复；**0.8.0** 使用 0.1.7-rc.2 依赖，不用于当前宿主。历史 Git 标签和安装包保留，详见[更新记录](CHANGELOG.md)和[迁移说明](MIGRATION.md)。