# 琉璃 · dsh-liuli-ui-enhance

<div align="center">

[GitHub](https://github.com/LilycleHeart/dsh-liuli-ui-enhance) ｜ [简体中文](README.md) ｜ [English](README_EN.md)

<br>

<img src="https://img.shields.io/npm/v/dsh-liuli-ui-enhance.svg" alt="npm version">
<img src="https://img.shields.io/badge/license-MIT-green.svg" alt="license">
<img src="https://img.shields.io/badge/TypeScript-strict-3178c6.svg" alt="TypeScript">
<img src="https://img.shields.io/badge/React-18-61dafb.svg" alt="React">
<img src="https://img.shields.io/badge/ESM-yes-yellow.svg" alt="ESM">

<br>
<br>

DeepSeek Harness 的 **Material Design 3 × Fluent 2 融合主题**插件：动态取色、壁纸磨砂、声纹可视化。

</div>

## 截图

![开始页亮色预览](docs/preview-start-light.png)

## 特性

- 🎨 M3 动态取色
- 🖼️ 壁纸与磨砂材质
- 🔊 声纹可视化（总开关可一键关闭监听并隐藏页头波形；参数收进「高级设置」折叠区，展开后调节）
- 🌗 日/夜切换
- 🖥️ 右侧边栏
- ⚡ 详细页自动展开（模型写文件/git 操作时自动展示审查面板）
- 🌐 内嵌浏览器
- 🚀 侧边栏浏览器自动驱动（模型启动 dev server / 写前端文件时自动展示页面；agent `open --show` 驱动即可见）
- 🎛️ 无边框窗口按钮
- 🧩 适配官方右侧栏：新版客户端保留官方侧栏服务和文件打开入口；默认使用琉璃经典按钮与整窗四向拖拽。设置中可切换右栏内部的分栏按钮与边缘拆格；旧版客户端沿用自研详细页
- 🎯 元素选择器 / 元素检查（悬浮球：拾取元素插入聊天；「检查」模式点击元素弹出元素检查卡——computed styles + outerHTML，宿主支持定位时同时在 DevTools Elements 面板定位；DSH Desktop 2.0.9 起宿主跑在 utility process，定位降级、卡片与「切换开发者工具」可用）
- 🔍 开发者工具（悬浮球，Electron 侧边 DevTools）
- ⚙️ 设置「外观」「功能」两个分区（外观：取色/背景/材质/圆角/泛光/壁纸等；功能：宽边/动画/侧边栏默认终端/声纹（总开关 + 高级设置折叠）/模型重试/历史加载/思考等级自动补全/非官方增强开关）
- ⚙️ 设置页原生下拉升级（「模型服务商」卡片的 API 协议 / 新增提供商等原生 select 换成琉璃自定义下拉组件，选择经 change 事件写回宿主表单）
- 🧠 思考等级自动补全（自定义提供商添加后一键在配置中声明思考等级：模型 reasoningEfforts + 提供商 compat，避免手工补声明）
- 🧭 侧栏「DeepSeek logo」点击后右侧详细页自动收回（从会话回开始页时不再让详情面板占据空间）
- 🤝 非官方增强兼容开关（与其它插件冲突时一键关闭侵入式/观察式功能，保留官方扩展点上的主题能力）

完整功能见 [docs/features.md](docs/features.md)。

## 安装

DSH 0.2.0-rc.2 用户可在官方「插件」页面输入 `dsh-liuli-ui-enhance@0.1.2` 安装。
官方安装器会管理依赖和 bundle 注册，无需运行本地安装脚本。也可使用官方 CLI：

```bash
dsh plugin --profile desktop add dsh-liuli-ui-enhance@0.1.2
```

本地开发/调试时，需安装 [Node.js](https://nodejs.org) 20+ 与 [pnpm](https://pnpm.io/installation)，
并启动过一次 DSH Desktop（首次启动会生成 `~/.dsh/profiles/desktop`）：

```bash
pnpm install            # 首次：安装依赖并构建 lib/（install:desktop 也会自动补这步）
pnpm install:desktop
pnpm patch:desktop      # 推荐：win32 无边框补丁（自动补丁失败不阻断插件）
```

详见 [docs/install.md](docs/install.md)。

## 文档

- [功能详解](docs/features.md)
- [并入官方右侧栏：迁移说明与自研 dock 外壳退役范围](docs/official-sidebar-migration.md)
- [样式规范](docs/style-guide.md)
- [安装与构建](docs/install.md)
- [版本发布与分支约定](docs/release.md)
- [浏览器自动化](docs/browser-use.md)

## License

MIT