象牙主题 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。主主题默认启用；可选的专注模式要等你主动选择才会开启。

在 macOS 桌面端，从 Plugins → Add plugin 安装 dsh-ivory。升级会保留已保存的主题偏好；如果界面看起来还是没变，检查 Settings → Ivory Theme → Enable Ivory theme。

固定某个版本或卸载

不用 npm，直接安装 GitHub 上指定的 release。

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

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

dsh plugin --profile web remove dsh-ivory

为日常使用 DSH 而做

| 区域 | Ivory 改了什么 |
| 外观 | 分层的中性导航、更柔和的正文墨色、带细描边的输入框，两套主题下的间距与交互保持一致。 |
| 文件与附件 | 统一的预览标签页、易读的文件卡片、自适应的文件工具栏；文档滚动、代码换行、图片缩放保持原生行为。 |
| 插件管理 | 紧凑的分隔列表、易读的组件说明、清晰的开关、自适应的包与来源详情，安装字段风格统一。 |
| 响应式布局 | 首页随窗口高度和可用写作空间自适应；会话保留随宿主调整的尺寸，窄窗口、分屏窗口、矮窗口下都能拖动宽度。 |
| 阅读与复制 | 正文、用户气泡、代码块各有独立控件，另有一个小的回复结束标记。 |
| Markdown 文档 | 为 .md 输出提供有边界的 DOM 构建预览，源码视图始终可用，链接仅限 HTTP(S)。 |
| 无障碍 | 键盘焦点、减少动态效果、强制颜色回退，弱化文字对比度达到 WCAG AA。 |
| 兼容性 | 已验证的 DSH 选择器契约发生变化时，结构性样式回退到稳定的主题 token。 |

细看

Focused desktop conversation
390 px mobile layout

两套主题下的插件管理（合成包数据）

Light plugin manager
Dark plugin manager

安静，是设计出来的

Ivory 是纯浏览器端视觉插件。它的宿主入口有意保持惰性。

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

npm 包只含八个列入白名单的文件，每次 CI 运行都会检查。阅读完整的安全策略、架构边界和第三方声明。

[!NOTE]
DeepSeek Harness 目前处于开发者预览阶段，UI 可能发生破坏性变更。
Ivory 0.2.17 已针对 DSH Web 0.2.1-rc.1 和桌面端 0.2.1-rc.2 验证通过。其他宿主构建可能回退到 token 级主题。当 Ivory 无法确认当前的结构契约时，会保留 token 级主题，并把宿主布局交还给 DSH。

0.2.1 移植版重新验证了每个带别名的 CSS 模块类，新增了账户菜单的设置入口和运行态文本接缝，并为宿主新增的 deep-diving 别名 token 重新调色；验证过的映射见 src/host-selectors.json。运行 npm run build && npm run test:desktop 可执行隔离回归测试，样式读取自已安装的应用（不涉及账户或模型调用）。在其他系统上，DSH_DESKTOP_CLIENT_DIR 可以指向解包后的客户端 bundle 以及前端的 index-.css。DSH_WEB_PACKAGE_DIR 用于选择已安装的 @deepseek-ai/dsh 包，供单独的 Web 样式表测试使用。

质量与发布检查

npm ci
npm test # renderer/host-contract unit tests, build, release gates, publint, and package checks
npm run test:desktop # 512 checks with installed desktop and Web styles
npm run qa:r2 # browser regressions; missing optional-plugin targets report skips
npm run qa:adversarial # 34 stress checks: reconciliation safety, toggle/resize storms, degraded mode
npm run qa:activity # 26 checks for thinking/tool-call rows, icons, and terminal polish
npm run qa:micro # 28 Vision Toolkit/Ivory micro-component checks; set DVT_CLIENT_JS if the toolkit is not installed in the DSH web profile
npm run qa:host # 13 checks against the live host: contract health, sidebar/composer/settings surfaces, both themes
npm run qa:contract # diagnostic probe (no pass/fail): self-diagnosis channel plus a live selector inventory
npm run derive:host # re-derive the desktop CSS-module alias table from the installed DSH; run after every host upgrade
npm run snapshot:host # compare committed module snapshots with both installed hosts
npm run test:runtime # isolated browser regressions; no DSH server or token required

derive:host 会预览一份映射，按包、CSS 模块和成员名解析。用 npm run derive:host -- --check 可在出现漂移时失败，用 npm run derive:host -- --write 可保存完整结果。模块缺失或存在歧义时会失败，不会写入残缺的表。适配新的宿主版本时，要更新记录的宿主版本、peer 范围以及所有桌面端专属选择器。然后运行 npm run snapshot:host -- --write，从两个已安装的宿主中提取对应的模块导出。默认测试和发布门禁会把实际的别名表与这些带版本的快照比对，包括组件标识。

npm test 包含隔离的浏览器检查，覆盖内容替换、有界 Markdown 渲染、复制按钮归属、存储失败和漂移诊断。
先用 npx --no-install playwright-core install chromium 安装一次浏览器，或者把 DSH_QA_CHROMIUM 指向已有的浏览器。CI 会自动安装 Chromium。
Markdown 太复杂、超出渲染预算时，保留完整源码。
存储不可用时，偏好设置的改动在当前会话内仍然生效。

实时浏览器相关条目需要 DSH_QA_TOKEN，从 dsh web 的 URL 中获取。
每个 qa: 入口都在这里有文档说明，并由发布门禁检查。

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

发布使用 npm Trusted Publisher 配合 GitHub OIDC。仓库不保存长期有效的 npm 发布 token，后续 CI 发布会自动获得 npm provenance。

开发

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 安装时不需要构建权限。

src/skin.css theme and compatibility styles
src/client.template.js client lifecycle and optional enhancements
src/markdown.js capped DOM-built Markdown preview renderer
scripts/test-markdown.mjs renderer unit tests (node --test)
lib/client.js deterministic generated browser bundle
lib/index.js inert host entry point
cordis.patch.yml DSH bundle registration
scripts/ build and verification gates

提交 pull request 之前，先看 CONTRIBUTING.md。

独立社区项目

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

基于 MIT License 发布。