# @blueriverlhr/dsh-better-webui-modelparams

模型采样参数控制（host + client）：输入区（`conversation.input.left`，composer
工具行**左侧**、+命令/访问模式/计划之后）放一个**「超参配置」图标按钮**（滑杆/
调谐图标，幽灵胶囊样式对齐「上下文已用」按钮；hover 与无障碍名称为「超参配置」），
点击弹出面板编辑。语义：**每个新
会话取默认值，会话内固定**。

## 功能

- **温度（temperature）**：可用。**数值留空 = 系统默认（placeholder 直接显示具体
  默认值，如 1.0），填写 = 覆盖**；数值框隐藏上下箭头、仅输入数字。经官方
  `agent/request` 钩子注入（新会话首请求解析「留空 ? 默认 1.0 : 全局温度」，按
  会话钉住并保持固定；`agent/disposed` 清理会话态）。零 dsh 源码修改，与重试/
  推理补齐同层的官方扩展点。
- **logprobs / penalty**：面板中显示「**暂不支持**」——harness 请求词汇表与两个
  adapter 均无这些字段，唯一的出路是 pi-ai 0.84 的 `samplingParams` 透传（等
  `dsh-llm-pi-ai` 升级采用，见 [docs/discussion/design.md](../docs/discussion/design.md) §11）。高级
  设置不逐项加说明，悬停行有原因提示。
- **恢复默认**：**清空已保存的覆盖配置**（温度回到留空/系统默认 1.0）。
- **生效方式**：写入 settings.yaml（持久化，重启仍在）。
- **双语**：zh / en 两套文案，键集一致。

## 机制

- Host（`src/host.js`）：注册 `better-webui-modelparams` 设置命名空间（schema
  `{ temperature? }`，temperature 空 = 不覆盖）+ RPC 通道
  `/better-webui-modelparams`（ping / read / apply / reset，写用 `replace`
  清空）+ `agent/request` 拦截器（会话级钉住温度）+ `agent/disposed` 清理。
- Client（`src/client.bundle.js`）：`conversation.input.left` 单个「超参配置」
  幽灵胶囊图标按钮 + 弹层面板（温度输入框 / 暂不支持行 / 应用·恢复默认），
  经 RPC 与宿主通信。

- 服务依赖（硬）：`connection`、`settings`

独立安装：把 `@blueriverlhr/dsh-better-webui-modelparams` 加进 `dsh.profile.bundles`
并声明依赖（见根 README「按需安装」）。更常见的做法是装根元包一起带上。