dsh-dock 0.13.0 → 0.14.0

package/README.md

@@ -17,7 +17,7 @@
 | 功能 | 说明 |
 |---|---|
 | **用量记录** | 记录全部 LLM API 调用：秒级时间筛选、Token/费用统计（**可配置各模型单价、持久保存并按自填单价计费**，支持多段分时价与周末/节假日谷价，内置峰谷计价 + 官网价目自动同步作兜底）、分组汇总、明细检索与 CSV 导出 |
-| **模型设置** | 编辑各 Provider 模型目录：输入类型（文本/图片 + 标注）与思考强度档位；图片能力可由你手动声明，新增 Provider 自动刷新加载，写回官方配置热生效 |
+| **模型设置** | 编辑各 Provider 模型目录：输入类型（文本/图片 + 标注）与思考强度档位；自定义 Provider 的增删改在「模型提供商」子页面（排版同官方模型管理），图片能力可由你手动声明，新增 Provider 自动刷新加载，写回官方配置热生效 |
 | **模型余额** | 展示所有模型 Provider 账户余额（5 分钟自动刷新） |
 | **任务动画** | 19 种任务运行动画（含星际远征、星云潮汐、曲速航道、量子雷达、星座网络、深海脉动、神经电路等），速度随任务活动联动，配置全部持久化 |
 | **任务通知** | 任务完成 / 异常 / 需确认通知：页内卡片、6 种提示音、浏览器系统通知、钉钉/飞书群机器人推送（宿主直发，浏览器关着也能推）；与动画互相独立、各自启停 |
@@ -25,8 +25,8 @@
 
 | **趣味游戏** | 任务等待时消磨时间的十款小游戏（五子棋、中国象棋、俄罗斯方块、推箱子、贪吃蛇、打砖块、极速赛车、坦克大战、星际躲避、反应堆解谜）；浮动窗口可拖动/缩放/最小化，不遮挡会话，靠屏幕侧边隐藏 |
 | **图片理解代理** | 图片识别等（visionproxy）；原图候选默认折叠展示，图片能力以你的声明为准 |
-| **远程访问** | 账号密码登录的远程入口：网关监听 `0.0.0.0` 独立端口，手机/平板/局域网设备访问同一实例，会话与任务进度实时一致；主实例保持仅监听 `127.0.0.1`，结构上不存在绕开登录的直连路径。手机端有专属体验：底部 Tab 栏（会话/任务/功能坞/设置，等待确认角标红色脉冲）、PWA 添加到主屏幕全屏打开、断线重连提示 |
-| **手机适配** | 手机/窄屏排版与触控兜底：输入类控件 16px 防 iOS 聚焦缩放、纯图标按钮触控面积兜底 ≥36px、代码块横向滚动、viewport-fit=cover 安全区；附 44px 浮动侧栏开关（调用 dsh 官方 `toggleSidebar`，与远程访问的手机 chrome 自动互斥让位） |
+| **远程访问** | 账号密码登录的远程入口：网关监听 `0.0.0.0` 独立端口，手机/平板/局域网设备访问同一实例，会话与任务进度实时一致；主实例保持仅监听 `127.0.0.1`，结构上不存在绕开登录的直连路径；LAN 非安全上下文自动补 crypto.randomUUID。手机端排版不在此列——统一归「手机适配」。 |
+| **手机适配** | 手机/窄屏排版与触控兜底：输入类控件 16px 防 iOS 聚焦缩放、纯图标按钮触控面积兜底 ≥36px、代码块横向滚动、viewport-fit=cover 安全区、滚动体 touch-action:pan-y + iOS 惯性滚动、设置弹层 min-height:0 滚动兜底；手机端 chrome 含底部 Tab 栏（会话/插件/设置，等待确认角标红色脉冲）+ 侧栏抽屉遮罩 + 软键盘让位 + 设置弹层纵排（宿主经 tapIndex 注入，客户端自建同款互斥） |
 | **心跳监视 / 主题信息** | 示例功能（纯 Client） |
 
 **会话区随身小控件**：启用后，在会话输入区工具行（模型选择器左侧）显示——
@@ -207,12 +207,29 @@ dsh plugin --profile web add dsh-dock     # 换回 npm 版
 
 **模型设置**
 
-![模型设置：Provider 自动刷新、原图候选折叠与用户声明图片能力](screenshots/dock-modelconfig.png)
+![模型设置：模型提供商入口卡 + 各 Provider 模型目录编辑器（输入类型 / 思考强度 / 图片能力声明）](screenshots/dock-modelconfig.png)
 
 1. 打开功能坞 → 模型设置
 2. 编辑各 Provider 的模型目录：输入类型（文本 / 图片）、思考强度档位；新建 Provider 后进入页面会自动重读目录，顶部和底部都可手动刷新
 3. 是否可直接识图以你勾选的「图片」能力为准；运行时候选仅作辅助提示
 4. 保存后写回官方配置，即时生效（无需重启）
+5. **模型提供商**：主页「模型提供商」卡片点右侧「管理」进入子页面（见下）
+
+**模型提供商（模型设置的子页面）**
+
+主页不再挤着长长的 Provider 列表——「模型提供商」是一张入口卡（自定义路由数 + 密钥状态圆点 + 「管理」），点进去的子页面排版与官方「设置 → 模型」一致：
+
+![模型提供商子页面：每个 Provider 一行卡片（显示名称 / 路由 key / 模型数 / 密钥状态徽标 + 编辑 / 删除），底部虚线新增](screenshots/dock-modelconfig-providers.png)
+
+![编辑 Provider：一行一字段（路由 key / 显示名称 / baseURL / API 协议 / API Key），模型清单沿用官方模型行样式](screenshots/dock-modelconfig-provider-edit.png)
+
+![新增 Provider：底部虚线入口展开的创建卡片，可「获取模型列表」勾选上游模型后批量加入](screenshots/dock-modelconfig-provider-create.png)
+
+- **新增 / 编辑 / 删除**自定义模型 Provider（OpenAI 兼容、Anthropic Messages 等），写入官方配置并热生效；内置 DeepSeek 官方 Provider 在该页只读，其模型目录仍在主页编辑
+- **API Key** 存本机凭据库（文件仅 root 可读），输入框永不回显；留空则不改动已存密钥
+- **获取模型列表**：宿主代打 `GET {baseURL}/models`，结果按可勾选清单展示（全选 / 清空 / 已选计数），勾上哪个加哪个
+- 删除仍是两段式确认（点一次变「确认删除？」，再点才真删）；编辑/新增卡片都是行内展开，返回主页即卸载、草稿不留后台
+- 深链 `params.page === "providers"` 或 `params.openProviderForm`（后者直接展开新增表单）可直达该页
 
 **图片理解代理（visionproxy）**
 - 用于图片内容识别等场景。原图直发候选默认折叠，模型设置中勾选「图片」输入类型的模型即可走该通道；请按实际 Provider 能力选择，端点不支持时取消该标记即可恢复代理识别。
@@ -226,14 +243,16 @@ dsh plugin --profile web add dsh-dock     # 换回 npm 版
    - **重启自动拉起**：开启状态与端口会被记住，重启 `dsh web` 后插件加载时网关按上次端口自动重新监听，不必进面板再点一次；账号密码同样保持。历史升级中若账号等配置滞留在 `~/.dsh/settings.yaml.imported`（dsh 升级改名旧配置时官方导入 dsh-dock 段失败），下次启动会一次性自动恢复——现网已有改动的段不会被覆盖。
    - **异地组网**：Tailscale/ZeroTier 等虚拟组网内直接用组网 IP 访问同一入口，效果与局域网相同。
    - 旧版「服务器模式（0.0.0.0）」与「扫码令牌接力」已被此方案取代：前者把无认证的 DSH 裸露给局域网，后者双实例任务状态不同步。开启远程访问时会自动清理旧的 0.0.0.0 webserver 补丁行（提示重启后回到仅本机）。
-2. **手机端接力体验（窄屏自动生效）**：
+2. **手机端接力体验（窄屏自动生效；由「手机适配」提供）**：
    - **底部 Tab 栏**：会话（拉出会话抽屉）/ **插件** / 设置。任务状态以角标显示在「插件」页签上：有任务进行中显示蓝色数量；**任务等待你确认工具调用时角标变红并脉冲**——公司电脑上跑着的任务停住等人，手机上一眼可见；此时点「插件」直达「运行状态」页处理，没有任务时进插件面板首页。
    - **PWA 添加到主屏幕**：网关自带 manifest 与图标（品牌渐变 + 白色气泡，零依赖生成），手机浏览器「添加到主屏幕」后像 App 一样全屏打开，无地址栏；未登录也能先装，打开后自然进登录页。
    - **断线提示**：换网 / 锁屏久置导致连接中断时，页面顶部出现「连接已断开，正在重连…」胶囊，恢复后自动消失（连续 2 次探测失败才提示，不闪报）。
    - **软键盘适配**：键盘弹出时底部 Tab 栏自动让位，不再挤占键盘上方空间。
-   - 会话入口统一在底部 Tab 栏「会话」页签（左缘浮动抽屉把手已移除，避免悬浮遮挡内容）。
+   - 会话入口统一在底部 Tab 栏「会话」页签（左缘浮动抽屉把手与浮动侧栏按钮均已移除，避免悬浮遮挡内容）。
    - 面板「远程访问」页与首页总揽会显示当前**在线设备数**；登录页支持密码明文切换。
 
+**不开「远程访问」的直连形态**：也可以不经网关、自行经 patch 层把主实例绑 `0.0.0.0` 直连（安全自担，浏览器表层没有登录认证）。这种形态下「远程访问」功能可以整个停用，dsh-dock 仍兜住两件与功能开关无关的事：**非回环浏览器的「预览版说明」自动确认**（dsh 对远程浏览器的确认不持久化，每次刷新都会重弹；插件级注入，回环地址不介入、保留原生的一次性持久确认）与**「手机适配」的整套窄屏排版**（与远程访问完全解耦，见下）。
+
 **趣味游戏**
 
 ![趣味游戏：十款小游戏在浮动窗口里运行（棋盘对战 / 经典机台 / 街机动作），不占满屏、不遮挡会话](screenshots/dock-games.png)