前言¶

DeepSeek Harness (DSH) 的界面主要由插件动态渲染。如果需要对界面样式做精细调整，传统方式往往需要修改源码或重新构建。dsh-custom-css 插件在设置行里提供了一个类似浏览器 DevTools 的 CSS 编辑器，样式表直接对应磁盘上的文件，支持写完即生效，解决了界面定制与开发环境割裂的问题。

是什么¶

这是一个 DSH profile 插件（Host 侧 + 浏览器侧），无构建步骤即可运行。

• 维护者：FOX4096
• 开源协议：MIT
• 兼容版本：DSH 0.1.2-rc.1 ~ 0.1.5-rc.1
• 核心价值：在设置行提供 CSS 编辑入口，文件与磁盘双向同步。

核心功能¶

插件提供了一套完整的样式编写与管理工作流。

DevTools 风格的编辑体验¶

编辑器模仿了浏览器 DevTools 的 Styles 标签页：
* 基础功能：支持行号 gutter、语法高亮（注释、选择器、属性、值）、撤销重做、查找替换（Ctrl+F，支持大小写切换）。
* 智能输入：输入时弹出属性补全列表，补全数据来自浏览器的 CSSStyleDeclaration.prototype。
* 格式校验：支持一键格式化，仅重排行，不修改内容。
* 规则面板：点击左侧选择器可展开右侧面板，支持重命名选择器、添加属性、查看摘要。

文件管理与同步¶

• 多文件管理：样式表保存在 ~/.dsh/custom-css/ 目录。
• 即时生效：编辑器内容会在防抖 400ms 后写入磁盘并重绘页面。
• 双向同步：
  1. 编辑器 -> 磁盘：在编辑器中保存，或使用 Ctrl/Cmd+S 立即写盘。
  2. 磁盘 -> 编辑器：编辑器会监听目录变化（通过文件的修订号 size 和 mtime 判断），当外部修改文件时，编辑器会提示是否重新载入。
• 历史版本：每次覆盖写盘前会生成快照，保存在 .history/ 目录下，最多保留 20 份，支持从「更多操作」中回退。

辅助工具¶

• 元素拾取器：点击界面元素，生成跨版本尽量稳的选择器，并将实际生效的令牌写成声明。
• 属性字典：内置 112 条属性字典，支持中文名值下拉、简写属性（如 margin、padding）的分量输入。
• 明暗自适应：界面支持跟随 DSH 的明暗主题自动调整。

安装与启用¶

插件通过 DSH profile 机制加载。启用后，在 DSH 的「设置 → 通用」界面的「外观」下方，会新增一行「自定义 CSS」。

典型用法¶

1. 在 ~/.dsh/custom-css/ 目录下创建或编辑 .css 文件。
2. 在 DSH 界面找到「自定义 CSS」一行，点击进入编辑器。
3. 编写样式或使用元素拾取器生成规则。
4. 保存后，样式即刻应用到界面。

注意事项¶

• 插件通过 Host 侧读写文件，请确保对该目录有写入权限。
• 查找功能为纯文本匹配，不支持正则表达式。
• 格式化功能仅调整排版，不会修改属性值本身。
• 建议在安装前检查源码与许可证。

结尾¶

对于需要频繁调整 DSH 界面外观的开发者或高级用户，dsh-custom-css 提供了一个低门槛、高效率的定制方案。它将本地开发工具（文本编辑器、版本控制）与运行时调试（实时预览）结合在了一起。