@ljwei-stak/dsh-model-router 0.13.0

package/.dsh-plugin/shared/zcode-installer.mjs

@@ -0,0 +1,247 @@
+/**
+ * Fetch and open the pinned official ZCode Windows installer.
+ *
+ * This module does not perform an unattended install. The visible vendor
+ * installer owns the destination picker and any UAC prompt. A successful
+ * return means only that the verified installer process was opened.
+ */
+import { spawn, execFile } from 'node:child_process'
+import { createHash, randomUUID } from 'node:crypto'
+import { createReadStream, createWriteStream } from 'node:fs'
+import { mkdir, realpath, rename, stat, unlink } from 'node:fs/promises'
+import { tmpdir } from 'node:os'
+import { dirname, isAbsolute, join, relative, sep } from 'node:path'
+import { Readable, Transform } from 'node:stream'
+import { pipeline } from 'node:stream/promises'
+import { promisify } from 'node:util'
+import {
+  ZCODE_SIGNER, ZCODE_SUPPORTED_VERSION,
+  ZCODE_WINDOWS_INSTALLER_SHA256, ZCODE_WINDOWS_INSTALLER_URL,
+} from './zcode-bundle.mjs'
+
+const execFileAsync = promisify(execFile)
+const INSTALLER_NAME = `ZCode-${ZCODE_SUPPORTED_VERSION}-win-x64.exe`
+const DOWNLOAD_ENV_VAR = 'MODEL_ROUTER_ZCODE_DOWNLOAD_DIR'
+const MAX_DOWNLOAD_BYTES = 2_000_000_000
+const MAX_REDIRECTS = 4
+
+function drive(path) {
+  if (typeof path !== 'string' || path.includes('\0')) return null
+  const local = path.startsWith('\\\\?\\') ? path.slice(4) : path
+  const match = /^([A-Za-z]):[\\/]/.exec(local)
+  return match ? match[1].toUpperCase() : null
+}
+
+function nonCAbsolute(path) {
+  return typeof path === 'string' && isAbsolute(path)
+    && drive(path) !== null && drive(path) !== 'C'
+}
+
+function inside(root, child) {
+  const part = relative(root, child)
+  return part !== '' && part !== '..' && !part.startsWith(`..${sep}`) && !isAbsolute(part)
+}
+
+/**
+ * Select a cache on a non-C local drive. The explicit download directory wins;
+ * otherwise the caller's npm prefix drive is preferred, then a non-C TEMP.
+ */
+export async function resolveZCodeDownloadDirectory({
+  downloadDir, npmPrefix, env = process.env,
+} = {}) {
+  if (process.platform !== 'win32') throw new Error('ZCode 安装器仅支持 Windows。')
+  const explicit = downloadDir ?? env[DOWNLOAD_ENV_VAR]
+  if (explicit != null && !nonCAbsolute(explicit)) {
+    throw new TypeError(`${DOWNLOAD_ENV_VAR} 必须是非 C 盘的本地绝对目录。`)
+  }
+  const candidates = explicit != null
+    ? [{ path: explicit, source: 'operator-selected' }]
+    : [
+      { path: npmPrefix, source: 'npm-prefix' },
+      { path: env.npm_config_prefix ?? env.NPM_CONFIG_PREFIX, source: 'npm-prefix-env' },
+      { path: env.TEMP, source: 'system-temp' },
+      { path: env.TMP, source: 'system-temp' },
+      { path: tmpdir(), source: 'system-temp' },
+    ].filter(candidate => nonCAbsolute(candidate.path))
+  for (const candidate of candidates) {
+    try {
+      let ancestor = candidate.path
+      for (;;) {
+        try { await stat(ancestor); break } catch (error) {
+          if (error?.code !== 'ENOENT') throw error
+          const next = dirname(ancestor)
+          if (next === ancestor) throw error
+          ancestor = next
+        }
+      }
+      if (!nonCAbsolute(await realpath(ancestor))) continue
+      await mkdir(candidate.path, { recursive: true })
+      const parent = await realpath(candidate.path)
+      if (!nonCAbsolute(parent)) continue
+      const cache = join(parent, 'model-router-zcode', ZCODE_SUPPORTED_VERSION)
+      await mkdir(cache, { recursive: true })
+      const canonical = await realpath(cache)
+      if (!nonCAbsolute(canonical) || !inside(parent, canonical)) continue
+      return { directory: canonical, source: candidate.source }
+    } catch {
+      // An unavailable prefix can fall back to another non-C directory.
+    }
+  }
+  throw new Error(`没有可写的非 C 盘下载目录；请设置 ${DOWNLOAD_ENV_VAR}。`)
+}
+
+async function sha256File(path) {
+  const hash = createHash('sha256')
+  for await (const chunk of createReadStream(path)) hash.update(chunk)
+  return hash.digest('hex').toUpperCase()
+}
+
+async function verifyInstallerSignature(path, env) {
+  const systemRoot = env.SystemRoot || env.windir || 'C:\\Windows'
+  const powershell = join(systemRoot, 'System32', 'WindowsPowerShell', 'v1.0', 'powershell.exe')
+  const script = '[Console]::OutputEncoding=[System.Text.UTF8Encoding]::new($false); '
+    + '$s=Get-AuthenticodeSignature -LiteralPath $env:MODEL_ROUTER_ZCODE_INSTALLER_PATH; '
+    + '@{status=[string]$s.Status;subject=[string]$s.SignerCertificate.Subject} '
+    + '| ConvertTo-Json -Compress'
+  const encoded = Buffer.from(script, 'utf16le').toString('base64')
+  try {
+    const { stdout } = await execFileAsync(powershell, [
+      '-NoLogo', '-NoProfile', '-NonInteractive', '-EncodedCommand', encoded,
+    ], {
+      shell: false,
+      windowsHide: true,
+      encoding: 'utf8',
+      timeout: 120_000,
+      maxBuffer: 16_384,
+      env: { ...env, MODEL_ROUTER_ZCODE_INSTALLER_PATH: path },
+    })
+    const signature = JSON.parse(stdout.trim().replace(/^\uFEFF/, ''))
+    return signature.status === 'Valid'
+      && typeof signature.subject === 'string'
+      && signature.subject.includes(ZCODE_SIGNER)
+  } catch { return false }
+}
+
+async function boundedResponse(url, signal) {
+  let current = new URL(url)
+  for (let redirects = 0; redirects <= MAX_REDIRECTS; redirects += 1) {
+    if (current.protocol !== 'https:') throw new Error('ZCode 下载地址必须使用 HTTPS。')
+    const response = await fetch(current, { redirect: 'manual', signal })
+    if ([301, 302, 303, 307, 308].includes(response.status)) {
+      const location = response.headers.get('location')
+      await response.body?.cancel()
+      if (!location || redirects === MAX_REDIRECTS) throw new Error('ZCode 安装器重定向过多。')
+      current = new URL(location, current)
+      continue
+    }
+    if (!response.ok || !response.body) {
+      throw new Error(`ZCode 官方安装器下载失败：HTTP ${response.status}。`)
+    }
+    const length = Number(response.headers.get('content-length'))
+    if (Number.isFinite(length) && length > MAX_DOWNLOAD_BYTES) {
+      await response.body.cancel()
+      throw new Error('ZCode 安装器超出下载大小限制。')
+    }
+    return response
+  }
+  throw new Error('ZCode 安装器重定向过多。')
+}
+
+async function fetchVerifiedInstaller(path, { env, signal, onProgress } = {}) {
+  const expected = ZCODE_WINDOWS_INSTALLER_SHA256.toUpperCase()
+  try {
+    const info = await stat(path)
+    const canonical = await realpath(path)
+    if (info.isFile() && info.size <= MAX_DOWNLOAD_BYTES
+      && nonCAbsolute(canonical) && inside(dirname(path), canonical)
+      && await sha256File(path) === expected
+      && await verifyInstallerSignature(path, env)) return { path, reused: true }
+    throw new Error('已有 ZCode 安装器缓存未通过 SHA-256 或签名校验；请处理该缓存文件后重试。')
+  } catch (error) {
+    if (error?.code !== 'ENOENT') throw error
+  }
+  // Authenticode's PE SIP is selected by the .exe extension on Windows.
+  const temporary = join(dirname(path), `.download-${randomUUID()}.exe`)
+  let created = false
+  try {
+    const response = await boundedResponse(ZCODE_WINDOWS_INSTALLER_URL, signal)
+    const hash = createHash('sha256')
+    let receivedBytes = 0
+    const declaredBytes = Number(response.headers.get('content-length')) || null
+    const meter = new Transform({
+      transform(chunk, encoding, callback) {
+        receivedBytes += chunk.length
+        if (receivedBytes > MAX_DOWNLOAD_BYTES) {
+          callback(new Error('ZCode 安装器超出下载大小限制。'))
+          return
+        }
+        hash.update(chunk)
+        try { onProgress?.({ receivedBytes, declaredBytes }) } catch { /* progress is advisory */ }
+        callback(null, chunk)
+      },
+    })
+    const output = createWriteStream(temporary, { flags: 'wx', mode: 0o600 })
+    output.once('open', () => { created = true })
+    await pipeline(Readable.fromWeb(response.body), meter,
+      output, { signal })
+    const actual = hash.digest('hex').toUpperCase()
+    if (actual !== expected) throw new Error('ZCode 安装器 SHA-256 与官方固定值不符。')
+    if (!(await verifyInstallerSignature(temporary, env))) {
+      throw new Error('ZCode 安装器未通过官方发布者 Authenticode 签名校验。')
+    }
+    const canonical = await realpath(temporary)
+    if (!nonCAbsolute(canonical) || !inside(dirname(path), canonical)) {
+      throw new Error('ZCode 安装器下载路径离开了非 C 盘缓存目录。')
+    }
+    await rename(temporary, path)
+    created = false
+    return { path, reused: false }
+  } finally {
+    if (created) await unlink(temporary).catch(() => {})
+  }
+}
+
+function openVisibleInstaller(path) {
+  return new Promise((resolve, reject) => {
+    let child
+    try {
+      child = spawn(path, [], {
+        shell: false,
+        windowsHide: false,
+        detached: true,
+        stdio: 'ignore',
+      })
+    } catch (error) { reject(error); return }
+    child.once('error', reject)
+    child.once('spawn', () => {
+      child.unref()
+      resolve(child.pid ?? null)
+    })
+  })
+}
+
+/**
+ * Download, verify, and visibly open the vendor installer. The return value
+ * intentionally does not claim that installation or sign-in has completed.
+ */
+export async function openZCodeInstaller({
+  downloadDir, npmPrefix, env = process.env, signal, onProgress,
+} = {}) {
+  if (process.platform !== 'win32' || process.arch !== 'x64') {
+    throw new Error('此固定安装包仅适用于 Windows x64。')
+  }
+  const cache = await resolveZCodeDownloadDirectory({ downloadDir, npmPrefix, env })
+  const installerPath = join(cache.directory, INSTALLER_NAME)
+  const verified = await fetchVerifiedInstaller(installerPath, { env, signal, onProgress })
+  const pid = await openVisibleInstaller(verified.path)
+  return {
+    status: 'installer-opened',
+    version: ZCODE_SUPPORTED_VERSION,
+    installerPath: verified.path,
+    sha256: ZCODE_WINDOWS_INSTALLER_SHA256,
+    cacheSource: cache.source,
+    reusedDownload: verified.reused,
+    installerPid: pid,
+    destinationSelection: 'visible-vendor-installer',
+  }
+}

package/CHANGELOG.md

@@ -0,0 +1,36 @@
+# Changelog
+
+## 0.13.0 — 2026-10-03
+
+Prerelease for DeepSeek Harness Desktop 0.2.0-rc.1 / 0.2.0-rc.2, published under the npm `next` tag. Merges PR #1 and PR #2.
+
+### Package renamed
+- The npm package is now **`@ljwei-stak/dsh-model-router`**. `@ljwei-stak/model-router-galgame` stops at 0.12.0 and is no longer updated. Upgrade by removing the old plugin and adding the new one; do not install both.
+- The profile entry id, panel id, settings namespace and Cordis plugin name stay `model-router-galgame`, and state stays in `~/.dsh/model-router/`, so saved settings and run history carry over. See [MIGRATION.md](MIGRATION.md).
+
+### Official CLI execution (PR #1)
+- Assigned work packages run through the official vendor CLIs (Claude Code, Codex, Gemini CLI, Kimi Code, MiniMax Code, MiMo Code, Grok Build) with headless adapters; failures fall back to the Harness model catalog API.
+- `model_router_execute` can pin a single `provider`/`model` (direct mode) instead of comparing routes.
+- Claude instructions stay positional; Codex reconnect notices are no longer treated as failures.
+
+### Health check, routing visibility and cost control (PR #2)
+- **Health check** (`model_router_health`, onboarding banner): install state, pinned version and login state per CLI. Uses read-only status commands (`claude auth status`, `codex login status`) or the presence of credential/state files (Gemini, Kimi, MiMo, Grok, MiniMax `auth-state.json`); credentials are never read. Logged-out CLIs are skipped immediately.
+- **Routing decisions** carry the vendor's sanitized error, difficulty, estimated cost and channel per package; manual reassignment.
+- **Cost control**: daily/monthly budgets, pre-run estimates (also for `model_router_tool_run`), actual cost from CLI-reported cost or token usage × configured price (Claude, Codex, Gemini, Grok, MiMo, MiniMax), auto-downgrade or pause when over budget.
+- **Presets**: cheapest / balanced / best quality.
+- **Subscription-first billing** for every vendor: CLI account logins and coding-plan key routes are used first; quota exhaustion or rate limits switch to the API key until the vendor's reset time; other subscription failures pause and ask (retry subscription / use API / cancel). Only API-billed spend counts toward budgets.
+- **Run history and DAG**: every execute / team / tool run is recorded locally with status per step; single-step rerun (read-only teams), continuation of a failed editable team run in a fresh worktree seeded with earlier changes, and rerun of failed tool calls.
+- **Workbench run launcher**: start a read-only run from the workbench with plan preview, cost estimate and one confirmation listing every reason.
+- **Security boundaries**: per-route read/write scope and sandbox status; one combined approval prompt for file writes, API-key fallback, over-budget and unsandboxed CLI starts.
+- **Quality loop**: optional stronger-model review (off / sample / always) and 👍/👎 ratings with bounded influence.
+- Multi-process safe state (`state.json.lock`, merged writes); quota and auth marks from other processes apply without restart; corrupted state is backed up and reported.
+- Windows: CRLF-safe client build check, Grok `GROK_HOME` login hint, ZCode unverified-version notice.
+
+### Known limitations
+- The workbench launcher starts read-only runs only; editable runs start from a session.
+- Kimi and ZCode headless output reports no token usage; ZCode login state stays unknown; only ZCode 3.14.3 is verified.
+- Not yet verified end to end inside the Harness Desktop UI.
+
+## 0.12.0
+
+First independent router release; GAL moved to `@ljwei-stak/dsh-galgame`.

package/INSTALLATION_GUIDE.zh.md

@@ -0,0 +1,134 @@
+# DeepSeek Harness Desktop · 独立插件安装与验证
+
+模型路由从 **0.12.0** 起独立发布；GAL 是新的 **0.1.0** 插件。两者均声明支持官方 **DeepSeek Harness Desktop 0.2.0-rc.1 / 0.2.0-rc.2**，可分别安装和更新。
+
+[路由 README](README.zh.md) · [迁移说明](MIGRATION.md) · [独立 GAL README](https://github.com/Alice-Marx/deepseek-harness-galgame#readme)
+
+## 1. 选择需要的插件
+
+| 需求 | 添加插件输入框 | 安装后的入口 |
+| --- | --- | --- |
+| 分析复杂度、按质量和费用选模型、调用官方工具 | `@ljwei-stak/dsh-model-router@0.13.0` | 模型路由 |
+| 剧情、立绘、音乐、存档、自由对话 | `@ljwei-stak/dsh-galgame@0.1.0` | Gal 模块 |
+| 两者都要 | 分别安装上面两个包 | 模型路由 + Gal 模块 |
+
+路由保留旧 npm 包名供原用户升级，包名中的 `galgame` 是历史名称；**路由 0.12.0 不含 GAL 入口或剧情美术**。GAL 不依赖路由，路由也不依赖 GAL。
+
+本轮采用 npm **`next`** 标签发布。推荐填写精确版本，`@next` 会跟随后续预发布更新。不要省略版本号：`latest` 或镜像状态可能选择与当前宿主不兼容的旧包。
+
+## 2. 从 npm 安装
+
+1. 打开 **DeepSeek Harness Desktop → 插件 → 添加插件**。
+2. 在“包名、GitHub 仓库地址或本地目录路径”输入框填一个完整包名，例如：
+
+   ```text
+   @ljwei-stak/dsh-model-router@0.13.0
+   ```
+
+   只想安装 GAL 时填写：
+
+   ```text
+   @ljwei-stak/dsh-galgame@0.1.0
+   ```
+
+3. 安装源选可连接的 **HTTPS** npm 源。新版本尚未同步到镜像时，选“自定义地址”并填官方源：
+
+   ```text
+   https://registry.npmjs.org/
+   ```
+
+4. 核对预览的包名、版本和宿主兼容信息，安装并启用。有重启提示时重启桌面程序。
+5. 检查插件详情与侧边栏：路由应为 **0.13.0 / 模型路由**；GAL 应为 **0.1.0 / Gal 模块**。仅装路由时没有 GAL 入口是预期行为。
+
+普通用户无需 `npm install -g`，该命令不会把插件注册到当前 Harness profile。
+
+## 3. 从 GitHub 版本化安装包安装
+
+进入对应 Release 下载 `.tgz`：
+
+- [模型路由 v0.13.0](https://github.com/Alice-Marx/dsh-model-router/releases/tag/v0.13.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.13.0.tgz
+```
+
+```text
+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.13.0.tgz'
+Get-FileHash -Algorithm SHA256 -LiteralPath 'D:\Plugins\ljwei-stak-dsh-galgame-0.1.0.tgz'
+```
+
+也可解压后填内层含 `package.json` 和 `.dsh-plugin` 的 `package` 目录。下载文件可放在 D 盘等自选位置，运行时数据目录由宿主 profile 决定。通过插件管理器更新，不修改 `app.asar` 或绕过版本检查。
+
+## 4. 从合并版迁移：先备份，再拆分安装
+
+1. 在旧合并插件的 GAL 播放器导出需要保留的剧情进度，并备份整个 Harness profile。每份 JSON 仅保存**当前剧情状态**，不含所有手动槽、设置、已读记录或本地音乐；重要槽位可依次读档再导出。
+2. 在**同一个 profile**安装独立 `@ljwei-stak/dsh-galgame@0.1.0`。
+3. 0.13.0 起包名改为 `@ljwei-stak/dsh-model-router`：在插件管理器卸载原 `@ljwei-stak/model-router-galgame`（保留 profile 与应用数据），再添加 `@ljwei-stak/dsh-model-router@0.13.0`。不要两个同时安装（条目 id 与工具名相同）；条目 id 未变，路由设置与执行记录会保留。完成两项更新后再玩剧情，避免同时操作旧合并入口和新入口。
+4. 现在路由与 GAL 各有一个入口。独立 GAL 沿用旧存档 localStorage 键，核对当前进度和三槽；更换 profile 或进度未恢复时，先切换到匹配剧目，再导入 JSON 备份。
+5. 后续分别更新需要的插件；只用路由可以不启用或不安装 GAL。保留 profile 与应用数据，卸载插件时不要清理故事数据。
+
+GAL 核心只包含**《回声之城·正篇》**与**《旧城迁移篇：未写完的约定》**。已分出的其他篇目保存在源代码归档，不在任一核心包里。其旧存档字节保留，但独立 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 仓库与宿主工具审批。
+
+完整页面教程、参数和结果位置见[工作台使用指南](docs/WORKBENCH_USER_GUIDE.zh.md)，算法推导见[README](README.zh.md#路由算法从输入到分配)。
+
+Claude、Codex、MiMo、Grok 支持只读或可编辑；Kimi、MiniMax、ZCode 无界面模式仅在获批的隔离可编辑工作区运行。CLI 模型名可能不同于 Harness 目录；多数 CLI 不提供可核验的实际模型 ID，要看厂商记录与账单。
+
+希望官方 CLI 尽量装在非 C 盘时，先按自己的空间规划配置 npm 全局前缀。MiniMax Windows npm 原生依赖失败时使用锁定哈希的官方安装脚本兜底，内容变化会拒绝执行；Grok 非 C 盘 npm 安装的数据目录与登录须使用一致的 `GROK_HOME`。
+
+## 6. GAL 第一次使用
+
+安装独立 GAL 后，从**Gal 模块**打开标题画面，选择正篇或旧城迁移篇；**Gal 设置**可调整完整立绘/半身表情、主角色与同伴大小位置、音乐与文字阅读。音乐首次播放需用户点击；剧情模式离线可玩。自由模式发送消息是真实模型调用，需宿主官方模型凭据，可能计费。
+
+剧目章节、存档、快捷键、自动阅读、素材鉴赏与故障处理由[独立 GAL 仓库](https://github.com/Alice-Marx/deepseek-harness-galgame#readme)的教程维护。
+
+## 7. 安装后验收
+
+| 检查 | 预期 |
+| --- | --- |
+| 宿主版本 | 0.2.0-rc.1 或 0.2.0-rc.2；包括 `rc` 后缀。 |
+| 路由独立安装 | 0.13.0 详情、模型路由入口、目录和模型档案可用；不出现旧合并 GAL 入口。 |
+| GAL 独立安装 | 0.1.0 详情、Gal 模块入口、标题与两部核心剧情可用；不要求安装路由。 |
+| 共同安装 | 两个入口各一份，路由工具和 GAL 播放器均能使用。 |
+| 存档迁移 | 同 profile 可读旧键；跨 profile 用匹配剧目 JSON 导入；旧篇目的数据不覆盖。 |
+| 本地规划 | 简单与复杂工作包分配可解释；价格未知保持未知；生成计划不调用模型。 |
+| 官方工具 | 探测、固定来源安装、修复、取消和日志可检查；登录另验。 |
+| 真实执行 | 在测试仓库核对审批、隔离工作区、补丁整合、厂商实际模型与计费。 |
+
+构建、自动测试、包内容和发布校验由本次总项目报告记录。真实账号调用与用户现用 profile 的验收仍需账号持有人进行。
+
+## 8. 开发者从完整源码构建
+
+路由仓库检出 `v0.13.0`；GAL 仓库检出 `v0.1.0`。使用 Node.js **22.19+** 与 pnpm，各自在根目录运行：
+
+```powershell
+pnpm install --frozen-lockfile
+npm run build:client
+npm test
+npm run check:client
+pnpm peers check
+npm pack --pack-destination dist
+```
+
+两项目的生成包互相独立。客户端有修改时必须重建，再将包绝对路径填入插件管理器验证。
+
+## 历史兼容提醒
+
+合并版 **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#历史版本)。

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 ljwei-stak
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/MIGRATION.md

@@ -0,0 +1,53 @@
+# 迁移到独立模型路由与 GAL 插件
+
+从模型路由 **0.12.0** 开始，原合并插件拆成两份，均面向官方 **DeepSeek Harness Desktop 0.2.0-rc.1 / 0.2.0-rc.2**。
+
+| 插件 | 安装输入 | 所属项目 |
+| --- | --- | --- |
+| 模型路由 | `@ljwei-stak/dsh-model-router@0.13.0`（0.12.0 起独立；0.13.0 起改名） | [路由仓库](https://github.com/Alice-Marx/dsh-model-router)；旧包名 `@ljwei-stak/model-router-galgame` 停在 0.12.0，不再更新。 |
+| GAL | `@ljwei-stak/dsh-galgame@0.1.0` | [新 GAL 仓库](https://github.com/Alice-Marx/deepseek-harness-galgame)；独立安装与更新。 |
+
+路由 0.12.0 只注册**模型路由**侧边栏入口。剧情引擎、角色美术、音乐、存档与自由模式全部归独立 GAL；两个插件互不依赖。
+
+## 0.13.0 包名变更
+
+0.13.0 起 npm 包名由 `@ljwei-stak/model-router-galgame` 改为 **`@ljwei-stak/dsh-model-router`**。旧包名停在 0.12.0（`next`）与 0.4.32（`latest`），不再更新，也不会被弃用或删除。
+
+- 插件管理器把两者视为不同的包，不能原地“更新”：先卸载旧包（保留 profile 与应用数据），再添加新包。
+- 不要同时安装：二者使用同一个 profile 条目 id `model-router-galgame` 和相同的 `model_router_*` 工具名。
+- 保留的标识：profile 条目 id、侧边栏面板 id、设置命名空间与 Cordis 插件名仍为 `model-router-galgame`，执行记录仍在 `~/.dsh/model-router/state.json`，因此已保存的路由设置和执行记录继续生效。
+- 改变的标识：npm 包名、`cordis.patch.yml` 中被加载的模块名、插件管理器设置卡识别的包名、宿主 Remote（typert）包键和更新检查查询的包名。
+
+## 从合并版 0.11.x 迁移
+
+1. **升级前备份**：旧 GAL 播放器导出需要保留的进度 JSON，并备份 Harness profile。JSON 保存当前剧情状态，不包含全部槽位、设置、已读记录或音乐；重要手动槽可依次读取后导出。
+2. 在**同一个 Harness profile**安装 `@ljwei-stak/dsh-galgame@0.1.0`。
+3. 在官方插件管理器卸载原包 `@ljwei-stak/model-router-galgame`，再添加 `@ljwei-stak/dsh-model-router@0.13.0`。完成两项安装后再打开剧情，避免并行使用旧合并 GAL 与新 GAL 入口。
+4. 核对只有一个**模型路由**和一个**Gal 模块**入口。打开独立 GAL 检查当前进度、三槽及设置；同 profile 继续使用原 localStorage 键。
+5. 若使用不同 profile 或没有读到进度，在 GAL 选择匹配剧目，再导入保存的 JSON。导入上限 **2 MB**，确认后替换当前剧情进度。
+
+独立 GAL 保留 `model-router:gal-story:v1` 等既有存档命名空间，不因包名改变而主动清理旧数据。旧城迁移篇保留历史基础键，正篇使用其独立剧目键；其他已分出的故事存档字节不清理，但不能在仅有两部核心剧目的新播放器里运行。旧版所有故事的代码与专属素材保存在源代码归档。
+
+两部核心剧目是**《回声之城·正篇》**和**《旧城迁移篇：未写完的约定》**。需要继续扩展正篇时只更新 GAL，路由功能调整只更新路由。只用路由无需安装 GAL。
+
+## 从旧桌面适配迁移到官方 Harness
+
+历史 **0.8.0** 声明 0.1.7-rc.2 依赖，当前官方桌面会拒绝它。历史 **0.10.1** 只接受 0.2.0-rc.1；rc.2 用户应安装上表精确版本，不修改 `app.asar` 或绕过版本检查。
+
+1. 备份原 profile 与需要的故事状态。在官方插件管理器按升级流程替换重复旧实例，不清理应用数据。
+2. 在 Harness 官方**模型**页核对供应商、模型与凭据。旧插件凭据不由本插件迁移或保存。
+3. 打开**模型路由**核对模型目录、档案、建议、官方工具卡和设置。需要 GAL 时再单独安装其插件。
+4. 真实模型意见使用 `model_router_consult`；单 CLI 任务使用 `model_router_tool_run`；依赖工作包使用 `model_router_team_execute`。可编辑执行需要干净 Git 仓库与官方工具审批。
+
+## 功能归属与差异
+
+| 功能 | 独立插件的行为 |
+| --- | --- |
+| 模型配置 | 在宿主官方“模型”页完成，两个插件都不保存 API Key。 |
+| 路由规划 | 路由插件从官方目录与用户档案估算难度、质量、费用和工作包。 |
+| 官方工具 | 路由插件维护七家固定来源安装与执行入口；ZCode 原厂安装器由用户选目录。 |
+| 执行团队 | 路由插件的 CLI 团队执行器按依赖顺序运行；官方 Harness Agent Teams 的成员、消息与生命周期由宿主管理。 |
+| 剧情与自由对话 | 独立 GAL 管理故事、立绘、音乐、设置和存档；自由模式经宿主模型服务调用，可能计费。 |
+| 更新 | 通过官方插件管理器分别安装各自的新版本；发布使用 npm `next`，推荐精确版本。 |
+
+登录、厂商实际模型和账单仍由账号持有人验收。完整步骤与安装后的检查见 [INSTALLATION_GUIDE.zh.md](INSTALLATION_GUIDE.zh.md)，GAL 播放器教程见[独立仓库](https://github.com/Alice-Marx/deepseek-harness-galgame#readme)。

package/README.i18n.yaml

@@ -0,0 +1,3 @@
+# README translation pairing for this repository.
+README.md: 4d820ba4402b344268124315ba74228dc6c2e79f
+README.zh.md: f00ed637e2f3a22b28cf7f5e4a4015f9c09eba0c