dsh-cmtoken-oauth 1.4.0 → 1.5.1

package/README.md

@@ -8,7 +8,8 @@ DeepSeek Harness（DSH）插件：在 **DSH 设置页**内一键认证广东移
 - **内联二维码**：认证流程内置 QR 生成（零依赖），无需额外安装二维码工具。
 - **自动发现模型**：认证成功后自动拉取可用模型列表，写入 `llm-pi-ai` 的 `providers.cmtoken` 配置（merge，不影响其他 provider）。
 - **原生视觉**：视觉模型（Qwen3.8 27B / Qwen3.x / Kimi K2.x 非 code / MiniMax M3）写入配置时自动声明 `input: ["text","image"]` 模态，DSH 直接放行图片输入（经持久附件服务直达模型），粘贴/拖入图片即可用。
-- **粘贴/拖图转路径（普通模型直接收图）**：纯文本模型（如 deepseekv4-flash）贴图/拖图时，client 端拦截并把图片存到 `~/.dsh/cmtoken-pastes/`，`[Image: <路径>]` 直接进入输入框——不再弹「当前模型不支持图片」。识图延迟到模型按需调用 `cmtoken_read_image` 工具时完成，不看图不花识图调用；同一图片按内容哈希缓存路径。视觉模型不接管，保留原生缩略图体验。
+- **粘贴/拖图（普通模型直接收图）**：纯文本模型（如 deepseekv4-flash）贴图/拖图时，client 端拦截并把图片（自动压缩到 ~1080p：长边 ≤1920）存到 `~/.dsh/cmtoken-pastes/`——**输入框和会话气泡不出现路径文本**：输入框上方显示「cmtoken识图」胶囊缩略图条（与输入卡片左对齐，✕ 可撤回），发送时刻由 host 的 `agent/pre-step` 钩子把 `[Image: 路径]` 追加到最后一条用户消息（仅模型上下文可见）。识图延迟到模型按需调用 `cmtoken_read_image` 工具时完成；粘贴后 30 分钟内未随消息发出的图片自动放弃注入。视觉模型不接管，保留原生缩略图体验。
+- **视觉回退模型可选**：设置 → cmtoken 认证页可指定识图引擎（默认「自动」按优先级 qwen38 > qwen3.x > kimi k2.x 非 code > minimax-m3），选择持久化在 `~/.dsh/cmtoken-oauth.json`，工具与判定路由均遵循。
 - **视觉回退工具**：注册 `cmtoken_read_image` 工具——任何模型把图片路径（本地路径或 http(s) URL）交给工具，host 侧自动选用优先级最高的视觉模型识图，返回结构化取证（概述 / 全文转写 / 版面 / 语义 / 不确定项）。无需外部识图服务，凭据与配额都在 cmtoken 体系内。
 - **可选包装路由（默认关闭）**：profile 插件 config 设 `visionRoute: true` 可注册 `cmtoken-vision` 分组——把纯文本模型镜像成声明图片输入的条目，贴图以真实图片气泡进入会话、请求时自动转证据文本。需要图片气泡原样展示的会话可开启。
 - **自动配置上下文**：按模型名称关键词自动匹配各模型的上下文与最大输出长度（DeepSeek V4 / MiniMax M3 / Qwen / GLM / Kimi / MiniMax 2.x / hy 等），无需手动填写。
@@ -42,7 +43,7 @@ dsh plugin --profile web add github:your-username/dsh-cmtoken-oauth
 3. 插件自动完成：发现模型 → 按名称配置各模型上下文 → 写入 `llm-pi-ai.providers.cmtoken` → 保存凭据。
 4. 套餐不足时，点设置页里的「**订购算力豆套餐**」跳转到广东移动 H5 订购页购买。
 5. 在 DSH 的模型选择器中选择 cmtoken 模型即可使用。
-6. 视觉，日常零配置：**任何 cmtoken 模型直接粘贴图片**——视觉模型（Qwen3.8 / Qwen3.x / Kimi K2.x / MiniMax M3）原生收图；纯文本模型贴图时自动经视觉模型识读为文字证据进入输入框（首次粘贴前聚焦一次输入框可预热判定）。也可在任何模型下把图片路径给助手调用 `cmtoken_read_image` 工具。
+6. 视觉，日常零配置：**任何 cmtoken 模型直接粘贴/拖入图片**——视觉模型（Qwen3.8 / Qwen3.x / Kimi K2.x / MiniMax M3）原生收图；纯文本模型贴图时出现「cmtoken识图」胶囊缩略图条，发送后模型自动经视觉模型识读。也可在任何模型下把图片路径给助手调用 `cmtoken_read_image` 工具。
 
 ## 数据与配置
 
@@ -54,7 +55,8 @@ dsh plugin --profile web add github:your-username/dsh-cmtoken-oauth
 | 凭据引用 | `CMTOKEN_API_KEY` / `CMTOKEN_REFRESH_TOKEN` / `CMTOKEN_EXPIRES` |
 | 写配置 | `llm-pi-ai` 设置 namespace 的 `providers.cmtoken`（merge，不覆盖其他 provider） |
 | 视觉模态 | 模型写入时声明 `input`：qwen38 / qwen3.x / kimi k2.x（非 code）/ minimax-m3 → `["text","image"]`，其余 `["text"]` |
-| 粘贴转路径 | `GET/POST /cmtoken-oauth/paste`（client 拦截纯文本模型贴图/拖图，host 落盘 `~/.dsh/cmtoken-pastes/` 返回路径；7 天自动清理） |
+| 粘贴转路径 | `GET/POST /cmtoken-oauth/paste`（client 拦截纯文本模型贴图/拖图，压缩到 ~1080p 后落盘 `~/.dsh/cmtoken-pastes/` 返回路径；7 天自动清理） |
+| 视觉回退模型 | 设置页选择，持久化 `~/.dsh/cmtoken-oauth.json`（`visionModel`，null = 自动） |
 | 视觉优先级 | qwen38 > qwen3.x > kimi k2.x（非 code）> minimax-m3；识图走 `{baseURL}/chat/completions` |
 | 视觉回退工具 | `cmtoken_read_image` 工具；输入本地路径或 http(s) URL |
 | 包装路由（可选） | config `visionRoute: true` 启用 `cmtoken-vision` 分组（默认关闭） |