@ljwei-stak/model-router-galgame 0.4.19 → 0.4.20

package/.dsh-plugin/client.js

@@ -61926,10 +61926,7 @@ function createUpdateApi({
       return unknownItem(`GitHub Release \u68C0\u67E5\u5931\u8D25\uFF1A${error instanceof Error ? error.message : String(error)}`, desktopEnvironment.version);
     }
   };
-  const installPlugin = !pluginInstallable ? null : async (item, signal) => {
-    if (item?.known === true && item.available !== true) {
-      return { changed: false, restartRequired: false, message: item.reason || "npm \u63D2\u4EF6\u5DF2\u662F\u6700\u65B0\u7248\u3002" };
-    }
+  const installPlugin = !pluginInstallable ? null : async (_item, signal) => {
     return rpcValue(
       await connectionRpc.call(PLUGIN_UPDATE_CHANNEL, PLUGIN_UPDATE_ENDPOINT, {}, signal),
       "npm \u63D2\u4EF6\u66F4\u65B0"
@@ -61971,7 +61968,7 @@ var gal_scene_default = { version: 1, settings: { stageW: 1920, stageH: 1080, sh
 
 // .dsh-plugin/client/index.mjs
 var name = "gal-view";
-var PLUGIN_VERSION = "0.4.19";
+var PLUGIN_VERSION = "0.4.20";
 function createUpdateApi2(ctx) {
   let connection;
   try {

package/INSTALLATION_GUIDE.zh.md

@@ -0,0 +1,783 @@
+# DeepSeek Harness 插件安装完整教程
+
+> 📦 从零开始，手把手教你安装 Model Router + GALGame 插件
+
+---
+
+## 📋 目录
+
+1. [前置要求](#1-前置要求)
+2. [下载插件](#2-下载插件)
+3. [安装插件](#3-安装插件)
+4. [配置 DeepSeek](#4-配置-deepseek)
+5. [验证安装](#5-验证安装)
+6. [启动使用](#6-启动使用)
+7. [常见问题](#7-常见问题)
+
+---
+
+## 1. 前置要求
+
+### ✅ 确认 DeepSeek Harness 已安装
+
+```bash
+# 检查 Harness 版本
+dsh version
+
+# 预期输出示例：
+# 已验证：@deepseek-ai/dsh 0.1.2-rc.1；桌面端使用 DSH Desktop 2.0.5+
+```
+
+**如果未安装 Harness**，请先安装：
+
+#### Windows 安装
+
+```powershell
+# 方法1: 使用官方安装器
+# 从 DeepSeek 官网下载 Harness 安装包
+# https://platform.deepseek.com/harness
+
+# 方法2: 使用命令行（需要管理员权限）
+winget install DeepSeek.Harness
+```
+
+#### macOS 安装
+
+```bash
+# 方法1: 使用 Homebrew
+brew install deepseek-harness
+
+# 方法2: 手动下载安装包
+# 从官网下载 .dmg 文件并安装
+```
+
+#### Linux 安装
+
+```bash
+# 方法1: 使用包管理器
+curl -fsSL https://platform.deepseek.com/install.sh | sh
+
+# 方法2: 下载二进制文件
+wget https://platform.deepseek.com/releases/harness-linux-x64.tar.gz
+tar -xzf harness-linux-x64.tar.gz
+sudo mv dsh /usr/local/bin/
+```
+
+### ✅ 确认网络连接
+
+插件需要联网获取 LiveBench 评分数据（可选）。
+
+### ✅ 准备 DeepSeek API Key（推荐）
+
+1. 访问 https://platform.deepseek.com
+2. 注册/登录账号
+3. 在"API Keys"页面创建新的 API Key
+4. 复制保存（后续配置时使用）
+
+---
+
+## 2. 下载插件
+
+### 方法1: npm registry 安装（推荐）
+
+插件已经发布为公开 npm 包。直接安装时不需要克隆仓库：
+
+```powershell
+pnpm config set registry https://registry.npmjs.org/
+pnpm dsh plugin --profile web add @ljwei-stak/model-router-galgame@0.4.20
+pnpm dsh plugin --profile desktop add @ljwei-stak/model-router-galgame@0.4.20
+```
+
+### 方法2: Git 克隆（仅源码开发）
+
+```bash
+# 克隆插件仓库
+git clone https://github.com/ljwei-stak/model-router-galgame.git
+
+# 进入插件目录
+cd model-router-galgame
+```
+
+### 方法3: 下载压缩包（仅源码开发）
+
+1. 访问项目 GitHub Release 页面
+2. 下载最新版本的 `model-router-galgame.zip`
+3. 解压到本地目录
+
+```bash
+# Windows (使用 PowerShell)
+Expand-Archive -Path model-router-galgame.zip -DestinationPath C:\harness-plugins\
+
+# macOS/Linux
+unzip model-router-galgame.zip -d ~/harness-plugins/
+cd ~/harness-plugins/model-router-galgame
+```
+
+### 方法4: 直接使用现有目录（仅源码开发）
+
+如果你已经有插件文件（如本次适配工作的目录）：
+
+```bash
+# 假设插件在 F:\DeepSeek_harness\model-router-galgame
+cd F:\DeepSeek_harness\model-router-galgame
+```
+
+---
+
+## 3. 安装插件
+
+### 步骤1: 确认插件目录结构
+
+确保目录包含以下关键文件：
+
+```
+model-router-galgame/
+├── package.json          ✅ 必需
+├── .dsh-plugin/         ✅ 必需
+│   ├── index.mjs
+│   ├── client.js
+│   └── shared/
+├── aipicture/           ✅ 必需（立绘资源）
+├── cordis.patch.yml
+└── README.md
+```
+
+### 步骤2: 执行安装命令
+
+插件已发布到 npm，直接使用公开包名安装（推荐）：
+
+```powershell
+pnpm config set registry https://registry.npmjs.org/
+pnpm dsh plugin --profile web add @ljwei-stak/model-router-galgame@0.4.20
+pnpm dsh plugin --profile desktop add @ljwei-stak/model-router-galgame@0.4.20
+```
+
+其中 `@0.4.20` 可以替换为通过 `npm view @ljwei-stak/model-router-galgame version --registry=https://registry.npmjs.org/` 查询到的版本号。官方 ModLens、审批门控、ModSearch 和 Ego Browser 依赖会自动解析，无需另行安装。
+
+如果正在本地开发，再使用目录安装：
+
+```bash
+# 进入插件目录
+cd /path/to/model-router-galgame
+
+# 安装插件到 Web profile
+dsh plugin --profile web add .
+
+# 如果使用绝对路径
+dsh plugin --profile web add /path/to/model-router-galgame
+```
+
+**预期输出**：
+```
+✓ Plugin '@ljwei-stak/model-router-galgame' added to profile 'web'
+```
+
+### 步骤3: 验证插件已安装
+
+```bash
+# 列出已安装的插件
+dsh plugin --profile web list
+
+# 预期输出包含：
+# @ljwei-stak/model-router-galgame@0.4.20
+```
+
+### 步骤4: 重启 Harness
+
+```bash
+# 停止 Harness
+dsh stop
+
+# 启动 Harness
+dsh start
+
+# 或者一步重启
+dsh restart
+```
+
+**等待启动完成**（约10-30秒）
+
+---
+
+## 4. 配置 DeepSeek
+
+### 步骤1: 打开 Harness 设置
+
+1. 启动 Harness 后，打开浏览器访问 `http://localhost:3000`（默认地址）
+2. 点击右上角 **设置** 图标（齿轮⚙️）
+3. 进入 **LLM** → **Providers** 页面
+
+### 步骤2: 添加 DeepSeek Provider
+
+点击 **Add Provider** 按钮，填写以下信息：
+
+```yaml
+# Provider 配置
+ID: deepseek
+Name: DeepSeek
+Type: openai-compatible  # 或者选择 deepseek
+
+# API 配置
+API Key: sk-your-api-key-here  # 粘贴你的 API Key
+Base URL: https://api.deepseek.com  # 或你的中转地址
+
+# 模型配置（点击 Add Model 添加）
+Models:
+  - ID: deepseek-chat
+    Name: DeepSeek V3
+    Type: chat
+  
+  - ID: deepseek-reasoner
+    Name: DeepSeek R1
+    Type: chat
+```
+
+**配置截图参考**：
+```
+┌──────────────────────────────────────┐
+│ Provider ID: deepseek                │
+│ Provider Name: DeepSeek              │
+│ API Key: sk-*********************    │
+│ Base URL: https://api.deepseek.com  │
+│                                      │
+│ Models:                              │
+│ ┌──────────────────────────────────┐│
+│ │ • deepseek-chat                  ││
+│ │ • deepseek-reasoner              ││
+│ └──────────────────────────────────┘│
+│                                      │
+│ [Save] [Cancel]                      │
+└──────────────────────────────────────┘
+```
+
+### 步骤3: 保存配置
+
+点击 **Save** 按钮保存配置。
+
+### 步骤4: 测试连接
+
+```bash
+# 测试模型是否可用
+dsh model list --provider deepseek
+
+# 预期输出：
+# deepseek/deepseek-chat
+# deepseek/deepseek-reasoner
+```
+
+或者在 Web 界面：
+1. 创建新对话
+2. 模型选择器中应该能看到 DeepSeek 模型
+3. 发送测试消息："你好"
+
+---
+
+## 5. 验证安装
+
+### ✅ 检查1: 插件是否加载
+
+打开浏览器开发者工具（F12），查看 Console：
+
+**预期输出**（无错误）：
+```
+[model-router] Plugin loaded successfully
+[model-router] Discovered 2 models
+```
+
+**如果有错误**：参见[常见问题](#7-常见问题)
+
+### ✅ 检查2: GAL 界面是否显示
+
+创建新对话后，应该看到：
+- ✅ 模型娘立绘（右侧或底部）
+- ✅ 对话框带有模型娘名牌
+- ✅ 打字机效果
+
+**对比截图**：
+
+```
+未安装插件：
+┌─────────────────────────┐
+│ 标准对话框              │
+│ ┌─────────────────────┐ │
+│ │ User: 你好          │ │
+│ │ Assistant: 你好！   │ │
+│ └─────────────────────┘ │
+└─────────────────────────┘
+
+安装插件后：
+┌─────────────────────────┬─────────┐
+│ 对话框                  │ 立绘    │
+│ ┌─────────────────────┐ │ ┌─────┐│
+│ │ 主人: 你好          │ │ │ 🐋  ││
+│ │                     │ │ │     ││
+│ │ DeepSeek·小鲸鱼:    │ │ │     ││
+│ │ 你好！先把问题列... │ │ └─────┘│
+│ └─────────────────────┘ │         │
+└─────────────────────────┴─────────┘
+```
+
+### ✅ 检查3: 路由功能是否正常
+
+在对话框输入命令：
+
+```bash
+/router plan
+```
+
+**预期输出**（JSON格式）：
+```json
+{
+  "mode": "collective",
+  "complexity": { "value": 0, "band": "simple" },
+  "taskType": "general",
+  "candidates": [...],
+  "selected": null
+}
+```
+
+### ✅ 检查4: 运行完整测试
+
+```bash
+# 进入插件目录
+cd /path/to/model-router-galgame
+
+# 安装测试依赖（首次运行）
+npm install
+
+# 运行测试套件
+npm test
+
+# 预期输出：
+# ✓ 21+ tests passed
+```
+
+---
+
+## 6. 启动使用
+
+### 🎮 基础使用
+
+#### 1. 创建新对话
+
+点击 Harness 界面的 **New Chat** 按钮。
+
+#### 2. 选择模式
+
+```bash
+# 集体协作模式（默认，推荐）
+/router mode collective
+
+# 单独会话模式（手动选择模型）
+/router mode single
+```
+
+#### 3. 开始提问
+
+```
+你好！请介绍一下你自己
+```
+
+插件会：
+- 自动分析任务类型
+- 选择最优模型
+- 以模型娘角色回答
+- 显示对应立绘
+
+#### 4. 查看路由分析
+
+```bash
+/router plan
+```
+
+查看插件的路由决策细节。
+
+### 🎯 典型场景示例
+
+#### 场景1: 代码调试
+
+```python
+这段代码有问题，帮我找出来：
+
+def add(a, b):
+    return a + b
+    print("Done")  # 这行永远不会执行
+```
+
+**插件行为**：
+- 任务类型：`code`
+- 复杂度：`simple`
+- 选择模型：DeepSeek（code专长）
+- 表达风格：推理研究员·小鲸鱼
+
+#### 场景2: 系统设计（复杂任务）
+
+```
+设计一个电商网站的后端架构，包括：
+1. 用户系统
+2. 商品管理
+3. 订单处理
+4. 支付集成
+```
+
+**插件行为**：
+- 任务类型：`code`
+- 复杂度：`complex`
+- 启动协作模式：
+  - 阶段1: 问题建模
+  - 阶段2: 架构设计
+  - 阶段3: 风险评估
+  - 阶段4: 方案整合
+
+#### 场景3: 简单翻译
+
+```
+翻译成英文：今天天气真好
+```
+
+**插件行为**：
+- 任务类型：`general`
+- 复杂度：`simple`
+- 选择模型：DeepSeek Flash（低成本）
+- 费用：~$0.00001
+
+---
+
+## 7. 常见问题
+
+### ❌ 问题1: 插件未加载
+
+**症状**：
+- 界面没有变化
+- 没有模型娘立绘
+- `/router` 命令无响应
+
+**排查步骤**：
+
+```bash
+# 1. 确认插件已安装
+dsh plugin --profile web list
+# 应该能看到 model-router-galgame
+
+# 2. 检查 Harness 日志
+dsh logs
+
+# 查找错误信息，例如：
+# [ERROR] Failed to load plugin: model-router-galgame
+
+# 3. 检查插件目录权限
+ls -la /path/to/model-router-galgame
+# 确保文件可读
+
+# 4. 从 npm registry 重新安装插件
+pnpm config set registry https://registry.npmjs.org/
+dsh plugin --profile web remove @ljwei-stak/model-router-galgame
+dsh plugin --profile web add @ljwei-stak/model-router-galgame@latest
+dsh restart
+```
+
+### ❌ 问题2: 立绘不显示
+
+**症状**：
+- 对话框样式正常
+- 但没有模型娘图片
+
+**解决方案**：
+
+```bash
+# 1. 检查图片文件
+ls aipicture/*.png
+# 应该有 DeepSeek1.png, ChatGPT1.png 等14个文件
+
+# 2. 检查浏览器控制台
+# 打开 F12 → Network 标签页
+# 查找图片加载失败的请求（404错误）
+
+# 3. 重新构建客户端
+cd /path/to/model-router-galgame
+npm run build:client
+dsh restart
+
+# 4. 清除浏览器缓存
+# Ctrl+Shift+Delete → 清除缓存
+```
+
+### ❌ 问题3: DeepSeek 模型不可用
+
+**症状**：
+- 插件正常加载
+- 但路由器没有选择 DeepSeek
+
+**排查步骤**：
+
+```bash
+# 1. 验证模型可见
+dsh model list --provider deepseek
+
+# 如果为空，检查 provider 配置
+
+# 2. 测试 API Key
+curl https://api.deepseek.com/v1/models \
+  -H "Authorization: Bearer sk-your-api-key"
+
+# 应该返回模型列表
+
+# 3. 检查 provider 配置
+# 在 Harness 设置中确认：
+# - API Key 正确
+# - Base URL 正确
+# - 模型 ID 正确（deepseek-chat）
+
+# 4. 查看路由日志
+dsh logs | grep "model-router"
+# 查找 "model discovery" 相关消息
+```
+
+### ❌ 问题4: 路由决策异常
+
+**症状**：
+- 简单任务却选择了昂贵模型
+- 或者完全没有选择模型
+
+**排查步骤**：
+
+```bash
+# 1. 查看详细路由方案
+/router plan
+
+# 检查输出：
+# - taskType: 是否正确识别任务类型
+# - complexity: 是否合理评估复杂度
+# - candidates: 是否有可用候选
+# - selected: 是否有选中的模型
+
+# 2. 检查 LiveBench 状态
+# 在路由方案的 optimization.liveBench 字段：
+# - fetchedAt: 是否成功刷新
+# - error: 是否有错误信息
+
+# 3. 手动触发刷新
+# 重启 Harness 会重新获取 LiveBench 数据
+dsh restart
+
+# 4. 使用本地评分
+# 如果 LiveBench 持续失败，插件会自动使用实验基线
+# 这是正常的降级行为
+```
+
+### ❌ 问题5: npm test 失败
+
+**症状**：
+- 运行测试时报错
+
+**解决方案**：
+
+```bash
+# 1. 安装依赖
+npm install
+
+# 2. 检查 Node.js 版本
+node --version
+# 需要 v18.0.0 或更高版本
+
+# 3. 清除缓存重新安装
+rm -rf node_modules package-lock.json
+npm install
+
+# 4. 单独运行测试文件定位问题
+node --test tests/router.test.mjs
+```
+
+### ❌ 问题6: 性能问题
+
+**症状**：
+- 响应缓慢
+- 界面卡顿
+
+**优化方案**：
+
+```bash
+# 1. 降低 LiveBench 刷新频率
+# 在 Model Router 设置中：
+liveBenchTtlMs: 1800000  # 30分钟
+
+# 2. 减少日志输出
+# 在 Harness 配置中：
+logLevel: "warn"  # 只输出警告和错误
+
+# 3. 使用本地 LiveBench 镜像
+# 如果网络慢，使用缓存的快照
+liveBenchEndpoint: "file:///path/to/local-snapshot.json"
+
+# 4. 禁用协作模式（如不需要）
+/router mode single
+```
+
+---
+
+## 8. 高级配置（可选）
+
+### 配置价格与预算
+
+在 Harness 设置 → Model Router：
+
+```yaml
+pricing:
+  deepseek-chat:
+    input: 0.14
+    output: 0.28
+    cacheRead: 0.014
+    cacheWrite: 0.028
+    currency: "USD"
+
+budgetUsd: 0.01  # 单任务预算上限
+cacheReadRatio: 0.3  # 假设30%缓存命中
+cacheWriteRatio: 0.1
+```
+
+### 自定义 LiveBench 端点
+
+```yaml
+# 使用镜像加速
+liveBenchEndpoint: "https://your-mirror.com/livebench.json"
+
+# 或使用本地文件
+liveBenchEndpoint: "file:///path/to/snapshot.json"
+```
+
+### 调整路由权重
+
+编辑 `.dsh-plugin/shared/router.mjs`：
+
+```javascript
+export const OBJECTIVE_WEIGHTS = Object.freeze({
+  simple: { 
+    quality: 0.20,   // 降低质量权重
+    cost: 0.70,      // 提高成本权重
+    latency: 0.06, 
+    specialty: 0.02, 
+    risk: 0.02 
+  },
+  // ... balanced, complex
+})
+```
+
+保存后重启 Harness。
+
+---
+
+## 9. 卸载插件（如需要）
+
+```bash
+# 1. 移除插件
+dsh plugin --profile web remove @ljwei-stak/model-router-galgame
+
+# 2. 重启 Harness
+dsh restart
+
+# 3. 删除插件文件（可选）
+rm -rf /path/to/model-router-galgame
+```
+
+---
+
+## 10. 更新插件与完整客户端
+
+### 设置页更新控件
+
+插件和 DSH Desktop 使用不同的版本号与发布渠道，设置页不再把两者视为同一个 Release：
+
+| 控件 | 更新来源与行为 |
+|------|----------------|
+| **检查更新** | 独立检查 npm 官方 registry 上的 `@ljwei-stak/model-router-galgame` 和 [`anywhere-labs/dsh-desktop` 最新 Release](https://github.com/anywhere-labs/dsh-desktop/releases)。其中一项检查失败时，另一项结果仍然有效。 |
+| **仅从 npm 更新插件** | DSH Desktop 先解析 npm `latest`，再在当前 profile 中以 `--save-exact` 添加解析出的 `@ljwei-stak/model-router-galgame@<确切版本>`，并指定 `https://registry.npmjs.org/`。完成后完全退出并重启 DSH Desktop。 |
+| **仅更新完整客户端** | 调用 DSH Desktop 原生更新器检查并安装官方客户端 Release，不会顺带安装或替代 npm 插件。 |
+| **一键更新插件与客户端** | 按需先安装 npm 插件，再调用完整客户端原生更新；两项都可用时两项都会执行。 |
+| **查看 npm 包 / 客户端 Releases** | 分别打开 [插件 npm 页面](https://www.npmjs.com/package/@ljwei-stak/model-router-galgame) 和 [官方客户端 Releases](https://github.com/anywhere-labs/dsh-desktop/releases)。纯网页环境不能写入本机时也使用这两个入口。 |
+
+`ljwei-stak/deepseek-harness` Release 不再是插件或完整客户端的统一更新源，完整客户端安装包也不代表已经包含同版本插件。
+
+### 命令行从 npm registry 更新插件（推荐）
+
+```powershell
+pnpm config set registry https://registry.npmjs.org/
+pnpm dsh plugin --profile web update @ljwei-stak/model-router-galgame
+pnpm dsh plugin --profile desktop update @ljwei-stak/model-router-galgame
+pnpm dsh --profile web --dump-config | Select-String "model-router-galgame|dsh-approval-gate"
+```
+
+### Git 更新插件（仅源码开发）
+
+```bash
+cd /path/to/model-router-galgame
+git pull origin main
+dsh plugin --profile web add .
+dsh restart
+```
+
+### 手动更新插件
+
+1. 下载新版本
+2. 备份旧版本配置
+3. 卸载旧插件
+4. 安装新插件
+5. 恢复配置
+
+---
+
+## 11. 获取帮助
+
+### 📖 文档资源
+
+- **快速入门**: `QUICK_START.zh.md`
+- **完整报告**: `DEEPSEEK_ADAPTATION_REPORT.md`
+- **优化建议**: `MODEL_OPTIMIZATION.md`
+- **文档索引**: `ADAPTATION_INDEX.md`
+
+### 🐛 问题反馈
+
+- **GitHub Issues**: (项目仓库地址)
+- **DeepSeek 社区**: https://platform.deepseek.com/community
+- **邮件支持**: support@example.com
+
+### 💬 社区讨论
+
+- Discord: (社区链接)
+- QQ群: (群号)
+- 微信群: (添加方式)
+
+---
+
+## 12. 总结
+
+### ✅ 安装完成检查清单
+
+- [ ] 已安装 DSH Desktop 2.0.5+，或已验证的 `@deepseek-ai/dsh@0.1.2-rc.1`
+- [ ] 已从 npm registry 安装 `@ljwei-stak/model-router-galgame`
+- [ ] 插件已通过 `dsh plugin --profile <name> add` 安装
+- [ ] Harness 已重启
+- [ ] DeepSeek provider 已配置
+- [ ] API Key 已添加
+- [ ] 模型已添加（deepseek-chat等）
+- [ ] 浏览器能看到模型娘立绘
+- [ ] `/router plan` 命令有响应
+- [ ] 测试对话正常工作
+
+### 🎉 恭喜！
+
+如果以上清单全部完成，你已经成功安装了 Model Router + GALGame 插件！
+
+**下一步**：
+1. 阅读 `QUICK_START.zh.md` 了解基本用法
+2. 尝试不同的任务场景
+3. 查看 `大模型娘人物设定.md` 了解角色
+4. 探索高级配置选项
+
+**祝你使用愉快！** 🚀
+
+---
+
+**文档版本**: 1.0  
+**更新日期**: 2026-09-01  
+**适用插件版本**: 0.4.20  
+**已验证宿主版本**: DSH Desktop 2.0.5 / `@deepseek-ai/dsh@0.1.2-rc.1`

package/MODLENS_DEPLOYMENT.md

@@ -0,0 +1,72 @@
+# 官方 ModLens 部署与集成指南
+
+> 纠错：ModLens 不是运行在 `localhost:8000` 的 Docker/Python 服务，也没有
+> `/v1/understand` 或 `/v1/understand/batch` 接口。旧的 `modlens-service` 只是本项目
+> 早期创建的关键词测试桩，不能读取图片像素，现已废止。
+
+## 安装到 DeepSeek Harness
+
+ModLens 3.25.4 是原生 DSH bundle。公开的 Model Router npm 包会自动安装它：
+
+```powershell
+pnpm config set registry https://registry.npmjs.org/
+pnpm dsh plugin --profile web add @ljwei-stak/model-router-galgame@0.4.20
+pnpm dsh plugin --profile desktop add @ljwei-stak/model-router-galgame@0.4.20
+```
+
+安装结果位于对应的 `F:\DeepSeek_harness\.dsh\profiles\<profile>` 目录，
+`@ljwei-stak/model-router-galgame` 和 `@liustack/modlens` 会同时出现在依赖闭包和
+`dsh.profile.bundles` 中。安装或更新后请重启对应 profile。
+
+本地开发时可以直接安装源码目录：
+
+```powershell
+pnpm dsh plugin --profile web add F:\DeepSeek_harness\model-router-galgame
+```
+
+## 官方运行方式
+
+官方插件在 DSH 内完成四件事：
+
+1. 注册 `modlens_read_image` 工具。
+2. 自动发现纯文本 DeepSeek、GLM、MiMo Pro 路由，并生成
+   `<原模型> (modlens vision)` 包装条目。
+3. 对包装路由中的图片附件调用 `ctx.attachments.readImage()`，运行同一 npm 包内的
+   ModLens CLI，把图片转换为结构化证据后再交给原纯文本模型。
+4. 在 Web 中提供粘贴转临时路径和“视觉引擎（ModLens）”设置卡。
+
+因此不需要启动额外的 8000 端口服务，也不需要本项目实现
+`ModLensClient`/`ModLensIntegration` HTTP 客户端。
+
+## 配置与检查
+
+视觉引擎配置由官方 CLI 管理，文件为：
+
+```text
+C:\Users\Jianw\.modlens\config.json
+```
+
+也可在 DSH 的“设置 → 插件 → 插件配置 → 视觉引擎（ModLens）”中修改。检查命令：
+
+```powershell
+pnpm exec modlens doctor
+```
+
+当前固定使用 `claude-cli`。它能完成调用链，但本机实测一次读取约 157 秒，而且对
+DSH 截图产生严重误识别，不适合准确率或延迟验收。官方推荐的快速路径是
+`gemini-api`（文档标称约 5–10 秒），也可配置真实的 OpenAI-compatible 多模态端点。
+
+## 与 GAL 路由器的边界
+
+GAL 不实现第二套 ModLens 协议，也不保存视觉引擎密钥。它只做两项协调：
+
+- 模型下拉框读取 DSH 官方 `modelCatalog()`，因此普通、原生视觉和
+  `(modlens vision)` 条目同时可见并通过 `selectModel()` 切换。
+- 集体模式中，如果本轮含图片、算法选中的目标是纯文本模型且存在对应官方包装路由，
+  仅把该次请求的 provider 改为包装 provider；原生视觉模型保持不变。
+
+## 验收口径
+
+插件安装、包装模型出现和 CLI 成功返回，只证明集成链路可执行。代码截图识别、图表
+数据提取、成本节省和端到端延迟必须使用真实视觉引擎逐项测量，不能用测试桩返回值
+或官方宣传值代替实测。

package/README.i18n.yaml

@@ -2,5 +2,5 @@
 # side as of the last confirmed-consistent state. Both languages carry equal authority;
 # after editing either side, bring the other along and re-record with:
 #   pnpm run verify-translation-pairing --write plugins/model-router-galgame/README.md
-README.md: b7d045f1e8adc707ef3ab2e79ef75bbbd8dd8238
-README.zh.md: 586d2533af0bae92b4c9879c1a717bc152067b2e
+README.md: e994858590d5d9b2b34bd2d920bfdb29e2b39104
+README.zh.md: f68c76a54cf2f7a0cbe7edeb42d1112fe32aebad

package/README.md

@@ -24,7 +24,7 @@ This plugin installs on an original DeepSeek Harness checkout. It adds a cost-aw
 
 ### Requirements
 
-- DeepSeek Harness / DSH Desktop 0.4.8 or newer.
+- Verified targets: DSH Desktop 2.0.5 or `@deepseek-ai/dsh@0.1.2-rc.1`. The in-app update controls require DSH Desktop 2.0.5 or newer.
 - Node.js 22.19 or newer (the current DSH Desktop release uses Node 24).
 - At least one LLM provider configured in Harness.
 - A network connection to the npm registry for the first installation.
@@ -164,10 +164,10 @@ pnpm dsh plugin --profile web add "@ljwei-stak/model-router-galgame@$routerVersi
 ```
 
 For a reproducible deployment, replace `$routerVersion` with a concrete version
-that you have verified with `npm view` (for example `0.4.19`):
+that you have verified with `npm view` (for example `0.4.20`):
 
 ```powershell
-pnpm dsh plugin --profile web add @ljwei-stak/model-router-galgame@0.4.19
+pnpm dsh plugin --profile web add @ljwei-stak/model-router-galgame@0.4.20
 ```
 
 You can also ask pnpm to update an already-installed package within its declared

package/README.zh.md

@@ -24,7 +24,7 @@
 
 ### 前置条件
 
-- DeepSeek Harness / DSH Desktop 0.4.8 或更高版本。
+- 已验证目标为 DSH Desktop 2.0.5 或 `@deepseek-ai/dsh@0.1.2-rc.1`；插件内更新控件需要 DSH Desktop 2.0.5 或更高版本。
 - Node.js 22.19 或更高版本（当前 DSH Desktop 使用 Node 24）。
 - Harness 中至少配置一个 LLM provider。
 - 首次安装需要能够访问 npm registry。
@@ -151,10 +151,10 @@ pnpm dsh plugin --profile web add "@ljwei-stak/model-router-galgame@$routerVersi
 ```
 
 如果需要可复现部署，请把 `$routerVersion` 替换为通过 `npm view` 确认过的具体版本号
-（例如 `0.4.19`）：
+（例如 `0.4.20`）：
 
 ```powershell
-pnpm dsh plugin --profile web add @ljwei-stak/model-router-galgame@0.4.19
+pnpm dsh plugin --profile web add @ljwei-stak/model-router-galgame@0.4.20
 ```
 
 已经安装过插件时，也可以让 pnpm 在当前版本范围内更新：
@@ -263,7 +263,7 @@ Harness 原生审批界面处理。路由器不会改变审批结论，只会在
 
 ## 数学路由模型
 
-本节按照 `RESEARCH_PAPER_FRAMEWORK.md` 的论文框架，完整说明当前 `0.4.19`
+本节按照 `RESEARCH_PAPER_FRAMEWORK.md` 的论文框架，完整说明当前 `0.4.20`
 实现。生产路由器与离线实验插件共用质量下限、费用模型、目标函数和回退语义；
 生产实现进一步加入 Pareto 剪枝与有界全局搜索，因此不再是互相独立的逐阶段局部贪心。
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ljwei-stak/model-router-galgame",
-  "version": "0.4.19",
+  "version": "0.4.20",
   "type": "module",
   "description": "DeepSeek Harness plugin: adaptive model routing, cost analysis and GAL view",
   "repository": {
@@ -42,10 +42,12 @@
     ".dsh-plugin/index.mjs",
     ".dsh-plugin/client.js",
     ".dsh-plugin/shared/**/*.mjs",
-    "cordis.patch.yml",
-    "README.md",
-    "README.zh.md",
-    "LICENSE"
+    "cordis.patch.yml",
+    "README.md",
+    "README.zh.md",
+    "INSTALLATION_GUIDE.zh.md",
+    "MODLENS_DEPLOYMENT.md",
+    "LICENSE"
   ],
   "scripts": {
     "build:client": "node scripts/build-client.mjs",