墨白(Inkstone):为 DeepSeek Harness 准备的黑白阅读主题

前言

DeepSeek Harness(DSH)把界面能力拆成插件,主题也可以由社区单独发布。若你更习惯 Obsidian Minimal 那种 E-ink 黑白阅读感,又不想在 DSH 里叠多套互相抢颜色的主题,需要一个只改外观、不碰会话与模型的独立主题包。下面介绍社区维护的「墨白 / Inkstone」(dsh-theme-inkstone)。

这是什么

墨白是适用于 DeepSeek Harness 的独立社区主题,由 fuguang12123 维护,包名为 dsh-theme-inkstone。设计参考 Obsidian Minimal 的 E-ink 风格,针对 DSH 的布局与主题接口重新实现;与 DeepSeek、Obsidian、Minimal 及其作者无官方合作或背书关系。

在 SkillHub 等社区目录中归类为「趣味换装」。当前 GitHub 仓库约 1 star;代码采用 MIT 许可。

核心功能

主题通过 ctx.theme.overrideTokens 注册,并在侧栏与 Markdown 上补充少量样式。README 中列出的能力如下:

  1. 跟随宿主外观:浅色白底墨字、深色黑底浅字,与 DSH 原生外观模式一致。
  2. 侧栏交互:条目默认无框;悬浮与选中时黑白反色,图标与时间一并反转;面板之间用细线分隔。
  3. 字体:优先使用本机已安装的「霞鹜文楷」「霞鹜文楷等宽」;未安装时回退系统字体;仍尊重 DSH 原生自定义字体设置。插件不打包、不下载字体。
  4. Markdown:标题使用红、橙、黄、绿、蓝、紫六级颜色;保留状态提示与代码差异相关颜色。
  5. 可逆:保留原生字号、操作方式与键盘焦点;停用插件后释放样式与 token 覆盖。
  6. 无额外运行时:无第三方运行时依赖,不读取会话,不调用模型。

开发与本地预览需要 Node.js 24+。当前仅声明支持已验证的宿主版本 DSH 0.2.1-rc.2(package.json 中 engines.dsh 同为该版本)。主题实现依赖 DSH 的 CSS Modules 局部类名,宿主大版本更新后可能需要适配;请避免与覆盖相同颜色的其他主题同时启用。

安装与启用

插件市场侧已向 awesome-dsh-plugin 目录 PR #8107 提交收录申请,目前尚未完成收录。等待审核期间,请用 Release 预构建包或 GitHub 源码安装。

推荐:预构建安装包(0.1.4)

从 Releases 下载 dsh-theme-inkstone-0.1.4.tgz。桌面版先完全退出 DSH,再执行:

dsh plugin --profile desktop add ./dsh-theme-inkstone-0.1.4.tgz

重新打开 DSH,在插件列表确认「墨白 / Inkstone」。若你使用 Web 等非桌面 profile,将命令中的 desktop 换成实际 profile。未配置 dsh CLI 时,请先按 DSH 官方文档完成 CLI 配置。Release 页提供 SHA256 校验方式(Windows 可用 Get-FileHash)。

从 GitHub 源码安装

dsh plugin --profile desktop add github:fuguang12123/dsh-theme-inkstone#v0.1.4

包内含 prepare 构建脚本。若 pnpm 阻止 Git 依赖构建,需按安装输出将确切包键加入该 profile 的 pnpm-workspace.yaml 的 allowBuilds 后重试,或改用预构建 tgz。固定来源时可将 tag 换成 Release 对应 commit SHA。

停用与卸载

在插件页停用墨白即可撤销主题。卸载前先退出桌面端:

dsh plugin --profile desktop remove dsh-theme-inkstone

典型用法

安装并启用后,主题随 DSH 浅色/深色外观自动切换,无需额外配置项。侧栏与正文的视觉变化在 README 预览图中有展示(截图环境为 DSH 0.2.1-rc.2 Windows 桌面端,且取图时停用了其他社区插件;实际效果仍取决于你的 DSH 版本与已启用插件)。

若你是主题作者或贡献者,可在克隆仓库后本地构建与预览(不连接模型):

node scripts/build.mjs
node --test tests/theme.test.mjs
node scripts/preview.mjs

浏览器访问 http://127.0.0.1:4318,可切换浅色、深色、字体与字号,并试用会话搜索与示例消息输入;端口可通过 PORT 环境变量修改。修改 src/tokens.mjs 与 src/theme.css 后需重新构建;发布安装包可用 npm pack --pack-destination release(需先 mkdir release)。

适用场景与注意

适合希望在 DSH 中获得接近 Minimal E-ink 的安静黑白排版、并愿意本机安装霞鹜文楷的用户。不适合需要官方插件市场一键安装、或宿主版本远离 0.2.1-rc.2 且未自行验证的场景。

DSH 插件在当前 dsh 进程权限下运行。主题虽声明不读会话、不调模型,安装前仍建议阅读 仓库源码、LICENSE 与 THIRD_PARTY_NOTICES.md,确认设计与第三方引用符合你的要求。

结尾

墨白把 Obsidian Minimal E-ink 式的黑白阅读体验搬到 DSH,用 token 覆盖与少量 CSS 完成侧栏反色与 Markdown 排版,无字体捆绑、无模型请求。收录市场前可直接从 Release 安装 0.1.4 预构建包。

羽毛球分组比赛记分
小程序二维码

欢迎使用《羽毛球分组比赛记分》微信小程序

Xiaoye