dsh-reasoning-ruler

Readme

# dsh-reasoning-ruler

[**English**](README.en.md) | 简体中文

[![License: MIT](https://img.shields.io/badge/license-MIT-blue.svg)](LICENSE)
[![npm version](https://img.shields.io/npm/v/dsh-reasoning-ruler.svg)](https://www.npmjs.com/package/dsh-reasoning-ruler)

DeepSeek Harness (DSH) Web 插件：把思考强度（reasoning effort）选择器从模型弹层里移出来，变成 composer 里一条**极简横线**——选中的档位是一道竖线，档位名显示在横线左边；档位**按模型记忆**，切换**乐观即时**（UI 先动，后台异步收敛）。顺带把模型选择器打磨成：打开直达完整模型列表、无滚轮、无"刷新中"闪现、选中即关。

> 非 DeepSeek 官方出品，与 DeepSeek 无任何关联。
> ⚠️ **实验性**：部分体验优化依赖 DSH Web 的 DOM 细节（hashed class 后缀、文案匹配），DSH 升级后可能失效；核心的档位选择走官方 slot / ModelDirectory API，不受影响。失效时提 issue 即可。

## 预览

<div align="center">
  <img src="assets/composer.png" alt="composer 里的极简 ruler 与仅显模型名的座位" width="70%"/>
  <img src="assets/model-list.png" alt="打开选择器直达完整模型列表" width="30%"/>
</div>

## 功能

- **极简横线 ruler**：一条 2px 横线，左低右高；选中档位为滑动竖线，hover 有幽灵竖线预览与 tooltip
- **档位按模型记忆**：每个模型记住你上次选的档位（localStorage），切回时自动恢复
- **乐观切换**：点档位/选模型 UI 立即响应，后台 RPC 异步收敛，失败自动回滚
- **模型选择器打磨**：打开直达完整模型列表（免根面板一跳）、列表全展开免滚轮、隐藏"Refreshing model list"闪现、选中即关
- **座位去重**：模型座位仅显示模型名（档位由 ruler 承担），弹层内原生"推理等级"行隐藏

## 安装

### 方式一：DSH 一键安装（推荐）

```bash
dsh plugin --profile web add dsh-reasoning-ruler
```

安装后等待 hot reload、刷新浏览器即可，无需重启 DSH。

### 方式二：交给 AI

```text
请安装这个 DSH Web 插件：https://github.com/zisen123/dsh-reasoning-ruler 。安装步骤请严格阅读并执行仓库中的 INSTALL.md。
```

## 工作原理

Host 侧为空实现；客户端通过官方 `conversation.input.right` slot 挂载 Ruler 组件，与原生 ModelSelect 共用 `modelDirectories` 的 SnapshotStore（双向同步）。体验优化层在绘制前的 MutationObserver 微任务里对弹层 DOM 做零闪现处理。

## 许可

MIT