@ljwei-stak/model-router-galgame 0.4.22 → 0.4.24

package/.dsh-plugin/index.mjs

@@ -28,6 +28,7 @@ import {
 } from './shared/web-routing.mjs'
 import { registerNpmUpdateRoute } from './shared/npm-update.mjs'
 import { registerGalGameRoutes } from './shared/gal-game-service.mjs'
+import { watcherStatus } from './shared/watcher.mjs'
 
 let settingsRuntimePromise
 let routerSettings = { ...DEFAULT_ROUTER_SETTINGS }
@@ -496,7 +497,7 @@ export function apply(ctx) {
     // the whole composer submission; the GAL client sends this command
     // without image bytes so the attachment remains available for the next
     // user turn.
-    input: { hint: 'mode collective|single | plan | safety', images: true },
+    input: { hint: 'mode collective|single | plan | safety | watcher', images: true },
     recordInput: true,
     handler: ({ agent, rawInput }) => {
       const state = stateFor(agent)
@@ -517,10 +518,17 @@ export function apply(ctx) {
       if (value === 'safety' || value === 'approval') {
         return { kind: 'success', text: JSON.stringify({ ...approvalGateStatus(ctx), context: approvalSafetyContext(state, state.lastStep) }) }
       }
+      if (value === 'watcher') {
+        const watcher = watcherStatus(ctx, agent)
+        return { kind: 'success', text: JSON.stringify({
+          ...watcher,
+          router: { mode: state.mode, lastRoute: watcher.insights?.turn?.route ?? null },
+        }) }
+      }
       if (value === 'web' || value === 'network') {
         return { kind: 'success', text: JSON.stringify({ ...webCapabilityStatus(ctx), context: webCapabilityForPlan(state.taskText, state.plan) }) }
       }
-      return { kind: 'error', text: '用法：/router mode collective、/router mode single、/router plan、/router safety 或 /router web' }
+      return { kind: 'error', text: '用法：/router mode collective、/router mode single、/router plan、/router safety、/router web 或 /router watcher' }
     },
   })
 

package/.dsh-plugin/shared/watcher.mjs

@@ -0,0 +1,29 @@
+/** Read the current agent's native Watcher projection without changing its session. */
+export const WATCHER_PACKAGE = '@ljwei-stak/dsh-watcher-for-mrg'
+export const WATCHER_VERSION = '0.4.0'
+export const WATCHER_PROJECTION = 'watcherInsights'
+
+export function watcherStatus(ctx, agent) {
+  const status = {
+    package: WATCHER_PACKAGE,
+    version: WATCHER_VERSION,
+    bundled: true,
+    readOnly: true,
+    projection: WATCHER_PROJECTION,
+    sessionId: agent?.session?.id ?? null,
+  }
+  let projections
+  try { projections = ctx.get?.('sessionProjections') ?? ctx.sessionProjections } catch {}
+  if (typeof projections?.snapshot !== 'function') return { ...status, status: 'unavailable' }
+  if (!agent?.session) return { ...status, status: 'no-session' }
+  try {
+    const snapshot = projections.snapshot(agent.session, [WATCHER_PROJECTION])
+    const insights = snapshot?.values?.[WATCHER_PROJECTION]
+    if (!insights) return { ...status, status: 'not-loaded' }
+    if (insights.sessionId !== status.sessionId) return { ...status, status: 'session-mismatch' }
+    return { ...status, status: 'ready', asOfSeq: snapshot.asOfSeq, insights: structuredClone(insights) }
+  } catch (error) {
+    ctx.logger?.warn?.(`model-router: Watcher projection failed: ${String(error)}`)
+    return { ...status, status: 'error' }
+  }
+}

package/INSTALLATION_GUIDE.zh.md

@@ -16,14 +16,27 @@
 
 ---
 
+## Watcher 工作路径与用量统计
+
+0.4.24 聚合包自动安装 `@ljwei-stak/dsh-watcher-for-mrg@0.4.0`。重启后，在普通
+对话或 GAL 工作会话的原生标题栏点击眼睛按钮，可查看工作路径、工具执行和模型用量；
+设置中的 Watcher 页面提供本地会话汇总。`/router watcher` 可检查当前会话投影是否
+加载。此功能不改变模型路由和审批规则，也不额外发起模型请求。
+
+同一配置只保留一个 Watcher 实例。安装 Router 前先执行 `dsh plugin list`；若列表中
+有独立安装的上游 `dsh-watcher` 或 `@ljwei-stak/dsh-watcher-for-mrg`，按实际包名执行
+`dsh plugin remove dsh-watcher` 或
+`dsh plugin remove @ljwei-stak/dsh-watcher-for-mrg`。然后再安装 Router 聚合包，避免
+重复 loader ID。详情见 [Watcher 项目](https://github.com/ljwei-stak/dsh-watcher-For_MRG)。
+
 ## PPT 生成扩展
 
-从 0.4.22 起，Router 聚合包自动安装并加载 `@ljwei-stak/ppt-master-for-mgr@6.3.1`。制作 PPT 时使用普通工作会话或 GAL 工作会话，在代理预设中启用 DSH 原生 `skill`、文件和终端工具，并在实际执行环境中安装 Python 3.10+。
+从 0.4.22 起，Router 聚合包自动安装并加载 PPT Master；当前 0.4.24 固定使用 `@ljwei-stak/ppt-master-for-mgr@6.3.2`，修复 Python 3.13 及更新版本在 Windows DSH 沙箱中导出 PPTX 时的临时目录权限错误。制作 PPT 时使用普通工作会话或 GAL 工作会话，在代理预设中启用 DSH 原生 `skill`、文件和终端工具，并在实际执行环境中安装 Python 3.10+；继续保留宿主沙箱和审批设置。
 
 ```sh
-npx --yes --package=@ljwei-stak/ppt-master-for-mgr@6.3.1 ppt-master-for-mgr doctor
-npx --yes --package=@ljwei-stak/ppt-master-for-mgr@6.3.1 ppt-master-for-mgr setup
-npx --yes --package=@ljwei-stak/ppt-master-for-mgr@6.3.1 ppt-master-for-mgr doctor
+npx --yes --package=@ljwei-stak/ppt-master-for-mgr@6.3.2 ppt-master-for-mgr doctor
+npx --yes --package=@ljwei-stak/ppt-master-for-mgr@6.3.2 ppt-master-for-mgr setup
+npx --yes --package=@ljwei-stak/ppt-master-for-mgr@6.3.2 ppt-master-for-mgr doctor
 ```
 
 `setup` 主动运行 pip 安装依赖，npm 安装本身不会安装 Python 依赖。指定解释器时为命令添加 `--python <解释器绝对路径>`，也可使用 `PPT_MASTER_PYTHON`；工作代理需使用相同解释器。随后在可写工作目录中请求“使用 ppt-master 生成 PPTX”，确认模型通过原生 `skill` 加载 `ppt-master` 后生成并检查文件。剧情模式和自由模式的角色对话不承担 PPT 工作流。完整配置与可选功能要求见 [README 的 PPT 安装步骤](README.zh.md#4-准备-ppt-生成环境) 和 [PPT Master 项目](https://github.com/ljwei-stak/ppt-master-for-MGR)。
@@ -98,8 +111,8 @@ sudo mv dsh /usr/local/bin/
 
 ```powershell
 pnpm config set registry https://registry.npmjs.org/
-pnpm dsh plugin --profile web add @ljwei-stak/model-router-galgame@0.4.22
-pnpm dsh plugin --profile desktop add @ljwei-stak/model-router-galgame@0.4.22
+pnpm dsh plugin --profile web add @ljwei-stak/model-router-galgame@0.4.24
+pnpm dsh plugin --profile desktop add @ljwei-stak/model-router-galgame@0.4.24
 ```
 
 ### 方法2: Git 克隆（仅源码开发）
@@ -163,11 +176,11 @@ model-router-galgame/
 
 ```powershell
 pnpm config set registry https://registry.npmjs.org/
-pnpm dsh plugin --profile web add @ljwei-stak/model-router-galgame@0.4.22
-pnpm dsh plugin --profile desktop add @ljwei-stak/model-router-galgame@0.4.22
+pnpm dsh plugin --profile web add @ljwei-stak/model-router-galgame@0.4.24
+pnpm dsh plugin --profile desktop add @ljwei-stak/model-router-galgame@0.4.24
 ```
 
-其中 `@0.4.22` 可以替换为通过 `npm view @ljwei-stak/model-router-galgame version --registry=https://registry.npmjs.org/` 查询到的版本号。官方 ModLens、审批门控、ModSearch、Ego Browser 和 PPT Master 依赖会自动解析；PPT 的 Python 依赖另按本指南开头步骤配置。
+其中 `@0.4.24` 可以替换为通过 `npm view @ljwei-stak/model-router-galgame version --registry=https://registry.npmjs.org/` 查询到的版本号。官方 ModLens、审批门控、ModSearch、Ego Browser、PPT Master 和 Watcher 依赖会自动解析；PPT 的 Python 依赖另按本指南开头步骤配置。
 
 如果正在本地开发，再使用目录安装：
 
@@ -194,7 +207,7 @@ dsh plugin --profile web add /path/to/model-router-galgame
 dsh plugin --profile web list
 
 # 预期输出包含：
-# @ljwei-stak/model-router-galgame@0.4.22
+# @ljwei-stak/model-router-galgame@0.4.24
 ```
 
 ### 步骤4: 重启 Harness
@@ -801,5 +814,5 @@ dsh restart
 
 **文档版本**: 1.0  
 **更新日期**: 2026-09-01  
-**适用插件版本**: 0.4.22
+**适用插件版本**: 0.4.24
 **已验证宿主版本**: DSH Desktop 2.0.5 / `@deepseek-ai/dsh@0.1.2-rc.1`

package/README.md

@@ -4,7 +4,7 @@ English | [中文](README.zh.md)
 
 A model-routing and GAL conversation plugin for DeepSeek Harness / DSH Desktop. It combines task assignment, cost estimates, model-character dialogue, web tools, PPT generation skills, and approval integration in one npm package, and runs inside an existing DSH host.
 
-**Current release: 0.4.22** · [npm package](https://www.npmjs.com/package/@ljwei-stak/model-router-galgame) · [GitHub Releases](https://github.com/ljwei-stak/model-router-galgame/releases) · [DSH Desktop](https://github.com/anywhere-labs/dsh-desktop/releases)
+**Current release: 0.4.24** · [npm package](https://www.npmjs.com/package/@ljwei-stak/model-router-galgame) · [GitHub Releases](https://github.com/ljwei-stak/model-router-galgame/releases) · [DSH Desktop](https://github.com/anywhere-labs/dsh-desktop/releases)
 
 ## Features
 
@@ -48,12 +48,34 @@ Story mode does not require provider credentials. Free mode requires a working m
 - **PPT Master** is bundled as a native DSH skill. In a normal work conversation, a PowerPoint/PPT/PPTX request can load `ppt-master` through the host's `skill` tool and follow its planning, SVG, validation, and PPTX export workflow.
 - Model Router keeps the host's skill catalog, loaded skill instructions, and file/terminal tools available when it chooses a model or advances a work stage. Use ordinary chat or the GAL conversation view for presentation work; story mode does not run tools, and free-play character dialogue is not the work agent.
 - The package includes the skill, Python scripts, and templates. Python dependencies require the explicit setup below; npm installation does not install Python or run pip. Generated presentations belong in the conversation's writable workspace.
+- Router 0.4.24 bundles PPT Master 6.3.2, which fixes PPTX staging-directory permissions under the Windows DSH sandbox with Python 3.13 or newer. Host sandbox and approval settings remain in effect.
+
+### Watcher work paths and model usage
+
+Router 0.4.24 includes [`@ljwei-stak/dsh-watcher-for-mrg@0.4.0`](https://github.com/ljwei-stak/dsh-watcher-For_MRG).
+Open the eye button in the native session header from Chat or the GAL work view
+to inspect turns, parallel tools, retries, timing, and recorded token usage.
+The Watcher settings section summarizes local session usage; provider and model
+identities stay separate when Router switches models. Only reasoning already
+recorded by the provider is shown. Story and free-play dialogue are outside the
+native work-session statistics.
+
+`/router watcher` reads the current session's `watcherInsights` projection and
+reports whether it is loaded, together with Router's latest route. Watcher does
+not alter routing, prompts, tools, approvals, or model requests.
+
+Install the Router aggregate package once. Before installing it, check `dsh plugin list`
+in the same profile. If either upstream `dsh-watcher` or the scoped
+`@ljwei-stak/dsh-watcher-for-mrg` is listed as a standalone plugin, remove the listed
+package with `dsh plugin remove dsh-watcher` or
+`dsh plugin remove @ljwei-stak/dsh-watcher-for-mrg`. Router supplies its own pinned
+Watcher entry, and retaining either standalone entry would duplicate the loader ID.
 
 ### Separate plugin and desktop updates
 
 "GAL 视窗 → 项目更新" (GAL view → Project updates) checks the plugin's npm version and the official DSH Desktop version separately. It offers "仅更新 npm 插件" (Update only the npm plugin), "仅更新完整客户端" (Update only the full client), and "一键更新插件与客户端" (Update plugin and client). Desktop plugin installation runs through the authenticated host connection. Fully exit and restart DSH Desktop after a successful installation.
 
-A page opened in a regular browser can check the plugin version and open download pages, but cannot install the desktop client or change its profile directly. The plugin's `0.4.22` version and DSH Desktop's version are independent.
+A page opened in a regular browser can check the plugin version and open download pages, but cannot install the desktop client or change its profile directly. The plugin's `0.4.24` version and DSH Desktop's version are independent.
 
 ## Installation
 
@@ -75,7 +97,7 @@ Installing this npm package does not install DSH Desktop, model services, or a b
 
 ```sh
 dsh --version
-dsh plugin add --save-exact --registry=https://registry.npmjs.org/ @ljwei-stak/model-router-galgame@0.4.22
+dsh plugin add --save-exact --registry=https://registry.npmjs.org/ @ljwei-stak/model-router-galgame@0.4.24
 ```
 
 3. After installation succeeds, use the desktop restart control, or explicitly quit from the system tray and reopen the app. Select the same profile. Closing the window may only hide the application.
@@ -90,7 +112,7 @@ If you do not have a global `dsh` but already have Node.js/npm and pnpm, replace
 
 ```sh
 dsh --version
-dsh plugin --profile web add --save-exact --registry=https://registry.npmjs.org/ @ljwei-stak/model-router-galgame@0.4.22
+dsh plugin --profile web add --save-exact --registry=https://registry.npmjs.org/ @ljwei-stak/model-router-galgame@0.4.24
 dsh --profile web --dump-config
 ```
 
@@ -112,16 +134,17 @@ For desktop, run this in the DSH terminal opened by the app:
 dsh --dump-config
 ```
 
-For Web / CLI, use `dsh --profile web --dump-config`. The combined configuration should include all six plugins below, with no duplicate loader IDs. A configuration dump does not replace checking that the host starts successfully. Install only the Router aggregate package; its dependencies and bundle entries are added automatically.
+For Web / CLI, use `dsh --profile web --dump-config`. The combined configuration should include all seven plugins below, with no duplicate loader IDs. A configuration dump does not replace checking that the host starts successfully. Install only the Router aggregate package; its dependencies and bundle entries are added automatically.
 
-| Plugin | Pinned version for 0.4.22 | Purpose |
+| Plugin | Pinned version for 0.4.24 | Purpose |
 | --- | --- | --- |
-| `@ljwei-stak/model-router-galgame` | `0.4.22` | Routing, GAL view, story/free modes, and update controls |
+| `@ljwei-stak/model-router-galgame` | `0.4.24` | Routing, GAL view, story/free modes, and update controls |
 | `@liustack/modlens` | `3.25.4` | Image understanding through compatible routes |
 | `@liustack/modsearch` | `5.10.1` | Search and page reading |
 | `@ljwei-stak/dsh-ego-browser` | `0.8.3` | Visible browser tools |
 | `@ljwei-stak/dsh-approval-gate` | `0.5.3` | Approval policies and auditing |
-| `@ljwei-stak/ppt-master-for-mgr` | `6.3.1` | Native PPT skill, scripts, and templates |
+| `@ljwei-stak/ppt-master-for-mgr` | `6.3.2` | Native PPT skill, scripts, and templates |
+| `@ljwei-stak/dsh-watcher-for-mrg` | `0.4.0` | Read-only work paths and actual model usage |
 
 `schemastery@3.18.0` and PPT Master's native skill provider are also installed automatically as runtime dependencies. These dependencies are pinned: updating Router uses the dependency combination declared by the new Router package, rather than updating every dependency to its own `latest`.
 
@@ -134,9 +157,9 @@ Install Python 3.10 or newer in the environment where the DSH work agent execute
 Run in the DSH terminal or the same execution environment as the work agent:
 
 ```sh
-npx --yes --package=@ljwei-stak/ppt-master-for-mgr@6.3.1 ppt-master-for-mgr doctor
-npx --yes --package=@ljwei-stak/ppt-master-for-mgr@6.3.1 ppt-master-for-mgr setup
-npx --yes --package=@ljwei-stak/ppt-master-for-mgr@6.3.1 ppt-master-for-mgr doctor
+npx --yes --package=@ljwei-stak/ppt-master-for-mgr@6.3.2 ppt-master-for-mgr doctor
+npx --yes --package=@ljwei-stak/ppt-master-for-mgr@6.3.2 ppt-master-for-mgr setup
+npx --yes --package=@ljwei-stak/ppt-master-for-mgr@6.3.2 ppt-master-for-mgr doctor
 ```
 
 `setup` explicitly runs pip for the bundled requirements. Use a dedicated Python virtual environment when appropriate, then add `--python /absolute/path/to/python` to each command, or set `PPT_MASTER_PYTHON` to that interpreter. On Windows, quote interpreter paths containing spaces. Configure the work agent to use that same interpreter. `doctor` checks core Python imports; it is not a visual quality or complete optional-service check. Some conversion, rendering, speech, or image features need additional software or credentials described in [PPT Master](https://github.com/ljwei-stak/ppt-master-for-MGR).
@@ -160,6 +183,7 @@ To play without a model API, open **"GAL视窗 → GAL游戏 → 剧情模式" (
 | `/router plan` | Show the latest routing plan for the current conversation |
 | `/router safety` | Show approval bridge status and the current stage context |
 | `/router web` | Show declared web capabilities, host service detection, and task strategy |
+| `/router watcher` | Read Watcher statistics and loading status for the current session |
 
 The default mode is `collective`. `/router safety` and `/router web` are status summaries; they do not certify that end-to-end approval or browser diagnostics have passed. Routing summaries do not expose private model chain-of-thought.
 
@@ -213,7 +237,7 @@ For example, only after confirming that ModLens is a duplicate standalone depend
 
 ```sh
 dsh plugin remove @liustack/modlens
-dsh plugin add --save-exact --registry=https://registry.npmjs.org/ @ljwei-stak/model-router-galgame@0.4.22
+dsh plugin add --save-exact --registry=https://registry.npmjs.org/ @ljwei-stak/model-router-galgame@0.4.24
 ```
 
 For Web / CLI, add `--profile web` after `plugin` in both commands. Handle other duplicate dependencies according to the actual error; do not remove all plugins at once. These removal commands are unnecessary when no duplicate entry exists.
@@ -229,7 +253,7 @@ dsh plugin add /absolute/path/to/model-router-galgame
 
 Replace the path with the actual absolute path and quote it if it contains spaces. For Web / CLI, use `dsh plugin --profile web add <actual-path>`. The npm package includes ready-to-load build output, but excludes the full client source, tests, and original assets.
 
-After modifying client source, run `npm test`, `npm run build:client`, and `npm run check:client` in the plugin repository. The current build script depends on build output from an adjacent `DSH-Desktop` source checkout and on esbuild. Installing this plugin's npm dependencies alone is not enough to set up the complete build environment. A `SKIP` result does not count as successful build verification.
+After cloning, run `pnpm install --frozen-lockfile`. The lockfile pins the DSH SDK used to build the browser client, so an adjacent DSH Desktop source checkout is not required. After modifying client source, run `npm test`, `npm run build:client`, `npm run check:client`, and `pnpm peers check`. A `SKIP` result does not count as successful build verification.
 
 ## Mathematical routing model
 

package/README.zh.md

@@ -4,7 +4,7 @@
 
 适用于 DeepSeek Harness / DSH Desktop 的模型路由与 GAL 对话插件。它把任务分配、费用估算、模型角色对话、联网工具、PPT 生成技能和审批适配整合为一个 npm 插件包，需要在已有的 DSH 宿主中使用。
 
-**当前发布版本：0.4.22** · [npm 包](https://www.npmjs.com/package/@ljwei-stak/model-router-galgame) · [GitHub Releases](https://github.com/ljwei-stak/model-router-galgame/releases) · [DSH Desktop](https://github.com/anywhere-labs/dsh-desktop/releases)
+**当前发布版本：0.4.24** · [npm 包](https://www.npmjs.com/package/@ljwei-stak/model-router-galgame) · [GitHub Releases](https://github.com/ljwei-stak/model-router-galgame/releases) · [DSH Desktop](https://github.com/anywhere-labs/dsh-desktop/releases)
 
 ## 功能介绍
 
@@ -48,12 +48,30 @@
 - **PPT Master** 以 DSH 原生 skill 随包加载。在普通工作会话中收到 PowerPoint/PPT/PPTX 需求后，模型可通过宿主 `skill` 工具加载 `ppt-master`，按规划、SVG 制作、检查和 PPTX 导出的流程执行。
 - Model Router 在选择模型和推进工作阶段时保留宿主技能目录、已加载的技能指令及文件/终端工具。制作 PPT 应使用普通聊天或 GAL 工作会话；剧情模式不调用工具，自由模式的角色对话也不是工作代理。
 - 包内包含技能、Python 脚本和模板。Python 依赖需按下方步骤主动安装，npm 安装不会自动安装 Python 或运行 pip。生成的演示文稿保存在会话可写工作目录中。
+- Router 0.4.24 随包加载 PPT Master 6.3.2，修复 Python 3.13 及更新版本在 Windows DSH 沙箱中导出 PPTX 时的临时目录权限错误，宿主沙箱和审批设置仍然生效。
+
+### Watcher 工作路径与模型用量
+
+Router 0.4.24 聚合 [`@ljwei-stak/dsh-watcher-for-mrg@0.4.0`](https://github.com/ljwei-stak/dsh-watcher-For_MRG)。
+在普通对话或 GAL 工作视图中，点击原生会话标题栏的眼睛按钮，可查看轮次、并行工具、
+重试、耗时和已记录的 token 用量。设置中的 Watcher 页面汇总本地会话用量；Router
+切换模型时按供应商和模型分别统计。推理记录只显示供应商已写入会话的内容。
+剧情模式和自由模式的独立角色对话不计入原生工作会话统计。
+
+`/router watcher` 只读查询当前会话的 `watcherInsights`，报告加载状态、统计和
+Router 最近使用的路由。Watcher 不修改模型路由、提示词、工具、审批或模型请求。
+
+只需安装 Router 聚合包。安装前先在同一 profile 执行 `dsh plugin list`。如果列表中
+存在独立安装的上游 `dsh-watcher` 或 `@ljwei-stak/dsh-watcher-for-mrg`，按列表中的包名
+执行 `dsh plugin remove dsh-watcher` 或
+`dsh plugin remove @ljwei-stak/dsh-watcher-for-mrg`。Router 会加载其固定版本的 Watcher；
+保留任一独立条目都会形成重复的 loader ID。
 
 ### 插件与桌面端分别更新
 
 “GAL 视窗 → 项目更新”分别检查插件 npm 版本和官方 DSH Desktop 版本。支持“仅更新 npm 插件”“仅更新完整客户端”和“一键更新插件与客户端”。桌面端插件安装通过已认证的宿主连接执行，成功后需要完全退出并重启 DSH Desktop。
 
-普通浏览器中的页面可以查询插件版本、打开下载页面，但不能直接安装桌面端或修改其 profile。插件的 `0.4.22` 与 DSH Desktop 的版本号相互独立。
+普通浏览器中的页面可以查询插件版本、打开下载页面，但不能直接安装桌面端或修改其 profile。插件的 `0.4.24` 与 DSH Desktop 的版本号相互独立。
 
 ## 安装
 
@@ -75,7 +93,7 @@
 
 ```sh
 dsh --version
-dsh plugin add --save-exact --registry=https://registry.npmjs.org/ @ljwei-stak/model-router-galgame@0.4.22
+dsh plugin add --save-exact --registry=https://registry.npmjs.org/ @ljwei-stak/model-router-galgame@0.4.24
 ```
 
 3. 安装成功后，使用桌面端的重启入口，或从托盘明确退出后重新打开，仍选择刚才的 profile。仅关闭窗口可能只是隐藏应用。
@@ -90,7 +108,7 @@ dsh plugin add --save-exact --registry=https://registry.npmjs.org/ @ljwei-stak/m
 
 ```sh
 dsh --version
-dsh plugin --profile web add --save-exact --registry=https://registry.npmjs.org/ @ljwei-stak/model-router-galgame@0.4.22
+dsh plugin --profile web add --save-exact --registry=https://registry.npmjs.org/ @ljwei-stak/model-router-galgame@0.4.24
 dsh --profile web --dump-config
 ```
 
@@ -112,16 +130,17 @@ dsh web
 dsh --dump-config
 ```
 
-Web / CLI 使用 `dsh --profile web --dump-config`。组合后的配置应包含以下六个插件，且没有重复 loader ID。配置导出不能替代实际启动验证；只需安装 Router 聚合包，依赖和 bundle 条目会自动加入。
+Web / CLI 使用 `dsh --profile web --dump-config`。组合后的配置应包含以下七个插件，且没有重复 loader ID。配置导出不能替代实际启动验证；只需安装 Router 聚合包，依赖和 bundle 条目会自动加入。
 
-| 插件 | 0.4.22 固定依赖版本 | 用途 |
+| 插件 | 0.4.24 固定依赖版本 | 用途 |
 | --- | --- | --- |
-| `@ljwei-stak/model-router-galgame` | `0.4.22` | 路由、GAL 视窗、剧情/自由模式和更新入口 |
+| `@ljwei-stak/model-router-galgame` | `0.4.24` | 路由、GAL 视窗、剧情/自由模式和更新入口 |
 | `@liustack/modlens` | `3.25.4` | 兼容路由的图片理解 |
 | `@liustack/modsearch` | `5.10.1` | 搜索与页面读取 |
 | `@ljwei-stak/dsh-ego-browser` | `0.8.3` | 可见浏览器工具 |
 | `@ljwei-stak/dsh-approval-gate` | `0.5.3` | 审批策略与审计 |
-| `@ljwei-stak/ppt-master-for-mgr` | `6.3.1` | 原生 PPT 技能、脚本和模板 |
+| `@ljwei-stak/ppt-master-for-mgr` | `6.3.2` | 原生 PPT 技能、脚本和模板 |
+| `@ljwei-stak/dsh-watcher-for-mrg` | `0.4.0` | 只读工作路径与实际模型用量 |
 
 `schemastery@3.18.0` 和 PPT Master 的原生技能提供器也会作为运行依赖自动安装。上述依赖采用固定版本；更新 Router 时使用新 Router 包声明的依赖组合，而不是自动升级每个依赖到各自的 `latest`。
 
@@ -134,9 +153,9 @@ Web / CLI 使用 `dsh --profile web --dump-config`。组合后的配置应包含
 在 DSH 终端或与工作代理相同的执行环境中运行：
 
 ```sh
-npx --yes --package=@ljwei-stak/ppt-master-for-mgr@6.3.1 ppt-master-for-mgr doctor
-npx --yes --package=@ljwei-stak/ppt-master-for-mgr@6.3.1 ppt-master-for-mgr setup
-npx --yes --package=@ljwei-stak/ppt-master-for-mgr@6.3.1 ppt-master-for-mgr doctor
+npx --yes --package=@ljwei-stak/ppt-master-for-mgr@6.3.2 ppt-master-for-mgr doctor
+npx --yes --package=@ljwei-stak/ppt-master-for-mgr@6.3.2 ppt-master-for-mgr setup
+npx --yes --package=@ljwei-stak/ppt-master-for-mgr@6.3.2 ppt-master-for-mgr doctor
 ```
 
 `setup` 会明确运行 pip 安装包内 requirements。可以先创建专用 Python 虚拟环境，再为每条命令添加 `--python /absolute/path/to/python`，或将环境变量 `PPT_MASTER_PYTHON` 设置为该解释器；Windows 路径包含空格时需加引号。工作代理也应使用同一个解释器。`doctor` 检查核心 Python 模块，不代表视觉质量或全部可选服务已通过检查。部分转换、渲染、配音和生图功能还需要 [PPT Master 文档](https://github.com/ljwei-stak/ppt-master-for-MGR) 中说明的额外软件或凭据。
@@ -160,6 +179,7 @@ npx --yes --package=@ljwei-stak/ppt-master-for-mgr@6.3.1 ppt-master-for-mgr doct
 | `/router plan` | 查看当前会话最近一次路由方案 |
 | `/router safety` | 查看审批桥接状态和当前阶段上下文 |
 | `/router web` | 查看联网能力声明、宿主服务探测和任务策略 |
+| `/router watcher` | 只读查看当前会话的 Watcher 统计和加载状态 |
 
 默认模式为 `collective`。`/router safety` 和 `/router web` 是状态摘要，不代表审批服务或浏览器端到端诊断已通过；路由摘要不展示模型私有思维链。
 
@@ -213,7 +233,7 @@ Web / CLI 使用 `dsh plugin --profile web remove @ljwei-stak/model-router-galga
 
 ```sh
 dsh plugin remove @liustack/modlens
-dsh plugin add --save-exact --registry=https://registry.npmjs.org/ @ljwei-stak/model-router-galgame@0.4.22
+dsh plugin add --save-exact --registry=https://registry.npmjs.org/ @ljwei-stak/model-router-galgame@0.4.24
 ```
 
 Web / CLI 在两条命令的 `plugin` 后加 `--profile web`。其他重复依赖按实际报错处理，不要一次删除全部插件。没有重复条目时不需要执行这些移除命令。
@@ -229,7 +249,7 @@ dsh plugin add /absolute/path/to/model-router-galgame
 
 把路径替换为实际绝对路径，含空格时加引号；Web / CLI 使用 `dsh plugin --profile web add <实际路径>`。npm 包含可直接加载的构建产物，但不包含完整客户端源码、测试和原始素材。
 
-修改客户端源码后，在插件仓库运行 `npm test`、`npm run build:client` 和 `npm run check:client`。当前构建脚本依赖相邻的 `DSH-Desktop` 源码构建产物及 esbuild；仅安装本插件的 npm 依赖不足以建立完整构建环境。出现 `SKIP` 不算构建校验通过。
+克隆后先执行 `pnpm install --frozen-lockfile`。锁文件固定了构建浏览器客户端所需的 DSH SDK，不再要求相邻的 DSH Desktop 源码目录。修改客户端源码后，运行 `npm test`、`npm run build:client`、`npm run check:client` 和 `pnpm peers check`。出现 `SKIP` 不算构建校验通过。
 
 ## 数学路由模型
 

package/cordis.patch.yml

@@ -12,6 +12,9 @@
     # Register PPT Master in the host's native skill catalog.
     - id: ppt-master-for-mgr
       name: '@ljwei-stak/ppt-master-for-mgr'
+    # Watcher observes the native session log in Chat and GAL work views.
+    - id: dsh-watcher
+      name: '@ljwei-stak/dsh-watcher-for-mrg'
     # The router annotates multi-task approval requests; dsh-approval-gate
     # owns the Flash decision, human handoff, audit and snapshot UI.
     - id: dsh-approval-gate

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ljwei-stak/model-router-galgame",
-  "version": "0.4.22",
+  "version": "0.4.24",
   "type": "module",
   "description": "DeepSeek Harness plugin: adaptive model routing, cost analysis and GAL view",
   "repository": {
@@ -67,13 +67,31 @@
     "@ljwei-stak/dsh-approval-gate": "0.5.3",
     "schemastery": "3.18.0",
     "@ljwei-stak/dsh-ego-browser": "0.8.3",
-    "@ljwei-stak/ppt-master-for-mgr": "6.3.1"
+    "@ljwei-stak/ppt-master-for-mgr": "6.3.2",
+    "@ljwei-stak/dsh-watcher-for-mrg": "0.4.0"
   },
   "peerDependencies": {
-    "@deepseek-ai/dsh-settings": "^0.1.1-rc.1",
+    "@deepseek-ai/dsh-settings": "^0.1.1-rc.1 || ^0.1.2-rc.1",
     "@deepseek-ai/schemastery": "^3.18.1"
   },
   "devDependencies": {
+    "@deepseek-ai/cordis": "4.0.2",
+    "@deepseek-ai/dsh-api-remotes": "0.1.2-rc.1",
+    "@deepseek-ai/dsh-api-session-controller": "0.1.2-rc.1",
+    "@deepseek-ai/dsh-client-store": "0.1.2-rc.1",
+    "@deepseek-ai/dsh-client-ui-chat": "0.1.2-rc.1",
+    "@deepseek-ai/dsh-client-ui-conversation": "0.1.2-rc.1",
+    "@deepseek-ai/dsh-client-ui-primitives": "0.1.2-rc.1",
+    "@deepseek-ai/dsh-client-ui-renderer": "0.1.2-rc.1",
+    "@deepseek-ai/dsh-client-ui-session": "0.1.2-rc.1",
+    "@deepseek-ai/dsh-client-ui-settings": "0.1.2-rc.1",
+    "@deepseek-ai/dsh-client-ui-slots": "0.1.2-rc.1",
+    "@deepseek-ai/dsh-invariants": "0.1.2-rc.1",
+    "@deepseek-ai/dsh-scope": "0.1.2-rc.1",
+    "@deepseek-ai/dsh-session": "0.1.2-rc.1",
+    "@deepseek-ai/dsh-session-projection": "0.1.2-rc.1",
+    "@deepseek-ai/dsh-session-stats": "0.1.2-rc.1",
+    "@deepseek-ai/dsh-settings": "0.1.2-rc.1",
     "esbuild": "0.28.2",
     "lucide-react": "1.41.0",
     "playwright": "1.63.0",