ZJUZhiyuCai/dsh-ivory

Ivory for DSH

为 DeepSeek Harness 打造的沉稳、暖中性界面。
浅色与深色。桌面端与移动端。英文与中文。零遥测。

简体中文
· Security
· Changelog

Ivory 为 DSH 网页界面带来更安静的阅读节奏，同时不改变 harness 的工作方式。暖中性色取代了冷灰色，编辑式排版改善了长回复的阅读体验，从窄小的手机窗口到宽大的桌面端，对话始终保持可用。DeepSeek 品牌标识以及 DSH 的每一项原生功能都原样保留。

快速开始

dsh plugin --profile web add dsh-ivory
dsh web

使用 Cmd/Ctrl + Shift + R 强制刷新页面，然后打开
Settings → Ivory Theme。主主题默认启用；可选的专注模式在你选择之前保持关闭。

固定某个版本或卸载

不使用 npm，直接安装确切的 GitHub 发布版本。

dsh plugin --profile web add github:ZJUZhiyuCai/dsh-ivory#v0.2.12

移除 Ivory，返回原生 DSH 界面。

dsh plugin --profile web remove dsh-ivory

为日常 DSH 使用而打造

| 领域 | Ivory 改变了什么 |
| --- | --- |
| 外观 | 一套完整的暖中性色调色板，适用于浅色和深色模式，配以克制的阴影、圆角和编辑式排版。 |
| 响应式布局 | 自适应宿主、可拖动调整大小的对话几何布局，已在 375、768、1,440 和 1,920 像素下测试。 |
| 阅读与复制 | 针对正文、用户气泡和代码块的独立控件，外加一个小的响应结束标记。 |
| Markdown 文档 | 针对 .md 输出的有界、由 DOM 构建的预览，始终提供源码视图，且仅支持 HTTP(S) 链接。 |
| 无障碍 | 键盘焦点、减少动态效果行为、强制颜色回退，以及符合 WCAG AA 的弱化文本对比度。 |
| 兼容性 | 当经过验证的 DSH 选择器契约发生变化时，结构性样式会降级为稳定的主题令牌。 |

深入了解

专注的桌面端对话
390 px 移动端布局

设计上的克制

Ivory 是一个仅限浏览器的视觉插件。它的宿主入口点被有意设计为
无操作。

| 边界 | Ivory 行为 |
| --- | --- |
| 打包的运行时依赖 | 无。DSH 客户端模块和 React 为对等依赖。 |
| 文件系统和进程访问 | 无。 |
| 网络请求和遥测 | 无。 |
| 持久化数据 | localStorage 中的两个本地偏好标志。 |
| 用户内容 | 在浏览器中呈现；仅在明确点击后才会复制。 |
| 第三方品牌 | 无 Anthropic 字体、徽标、图标或应用程序代码。 |

npm 包包含八个列入允许列表的文件，并在每次 CI
运行时进行检查。阅读完整的安全策略、
架构边界
和第三方声明。

[!NOTE]
DeepSeek Harness 处于开发者预览阶段，可能会做出破坏性的 UI 变更。
Ivory 0.2.12 已针对 DSH 0.1.2-rc.1 至 0.1.5 及其当前
Web 客户端模块进行验证。当 Ivory 无法证明当前的结构契约时，
它会保留令牌级主题化，并将宿主布局交还给 DSH。

质量与发布检查

npm ci
npm test          # 渲染器单元测试，然后是静态发布门禁、构建、publint 和包检查
npm run qa:r2     # 74 项浏览器回归测试；DSH 必须运行在 127.0.0.1:3080
npm run qa:adversarial  # 33 项压力检查：协调安全性、切换/调整大小风暴、降级模式
npm run qa:activity     # 26 项针对思考/工具调用行、图标和终端打磨的检查
npm run qa:micro        # 28 项 Vision Toolkit/Ivory 微组件检查；如果该工具包未安装在 DSH Web 配置文件中，请设置 DVT_CLIENT_JSsh
npm run qa:host         # 针对实时主机运行 10 项检查：契约健康、侧边栏/输入框/设置界面、两种主题
npm run qa:contract     # 诊断探针（无通过/失败）：自诊断通道以及实时选择器清单

最后两项需要从 dsh web URL 获取 DSH_QA_TOKEN。package.json 中的每个 QA 入口点都在此文档中说明，若有遗漏，发布检查将失败。

浏览器测试套件覆盖响应式布局、输入框焦点、深色模式、Markdown 注入尝试、流式状态、生命周期清理、块复制载荷、插件共存、长表格、减弱动效以及强制颜色。

发布使用 npm Trusted Publisher 与 GitHub OIDC。仓库不存储长期有效的 npm 发布令牌，未来的 CI 发布将自动获得 npm 来源证明。

开发
sh
npm ci
npm run build

dsh plugin --profile web add link:$PWD
dsh web

编辑 src/skin.css、src/client.template.js 或 src/markdown.js，然后运行 npm run build。生成的 lib/client.js 会被提交，因此 GitHub 安装无需构建权限。
text
src/skin.css             主题与兼容性样式
src/client.template.js   客户端生命周期与可选增强功能
src/markdown.js          有上限的 DOM 构建 Markdown 预览渲染器
scripts/test-markdown.mjs  渲染器单元测试（node --test）
lib/client.js            确定性生成的浏览器打包文件
lib/index.js             惰性宿主入口点
cordis.patch.yml         DSH 打包注册
scripts/                 构建与验证关卡

在提交拉取请求之前，请参阅 CONTRIBUTING.md。

独立社区项目

Ivory 是非官方项目，与 Anthropic 或 DeepSeek 无关联、未获其认可或赞助。Claude 是 Anthropic PBC 的商标。DeepSeek 和 DeepSeek Harness 可能是其各自所有者的商标。

基于 MIT 许可证发布。