前言¶

dsh-custom-workspace 是面向 DeepSeek Harness（DSH）Web 的插件。它让每个工作区单独配置背景、聊天字号、Markdown 行高、Markdown 块间距和 Retina 字体渲染，并把设置按工作区保存到本地配置中。下面介绍它的功能、安装方式和典型用法。

这是什么¶

dsh-custom-workspace 的仓库 owner 为 JeremyGuo，许可证为 MIT。它解决的问题是：在 DSH Web 中，不同工作区可能需要不同的阅读密度和外观，而插件可以把这些外观设置按工作区保留。

核心功能¶

• 主工作区背景颜色或图片 URL。
• 独立 Markdown 正文字号和行高。
• 段落、列表、标题、引用、代码块的 Markdown 块间距。
• Retina 显示器灰度抗锯齿开关。
• 按工作区持久化到 $DSH_HOME/settings.yaml。

安装与启用¶

安装前建议先检查源码与 MIT 许可；插件以当前 dsh 进程权限运行。

环境要求：

• DeepSeek Harness 0.1.0-rc.6。
• Node.js ^22.19.0 或 >=24.0.0。
• loopback DSH Web 会话；settings RPC 会拒绝非 loopback 浏览器。

安装命令：

dsh plugin --profile web add dsh-custom-workspace

安装后打开 Settings → General Settings → Workspace Appearance，配置所选工作区。修改会立即保存。

典型用法¶

下面两种配置可以按阅读习惯选择：

• 紧凑阅读：13px 字号、20px 行高、4px 块间距、#eef4ff 背景。
• 宽松阅读：20px 字号、38px 行高、28px 块间距、#fff3e8 背景。

背景可以配置颜色，也可以配置图片 URL。图片 URL 会直接使用，加载结果依赖浏览器网络和浏览器内容安全策略。

本地开发流程：

pnpm install
pnpm run verify
dsh plugin --profile web add link:$PWD
pnpm run watch

先安装依赖并执行校验，再用本地路径加载插件，最后启动 watch 流程。

持久化与安全¶

设置保存在 $DSH_HOME/settings.yaml。Host 端拥有 custom-workspace 设置命名空间，并注册专用 /custom-workspace Connection RPC 通道。该通道只接受 loopback 请求，也不暴露其他设置命名空间。

浏览器端会验证响应；写入失败时重新加载 Host 值；断开或非 loopback 浏览器会把范围标记为不可用。通过 LAN 主机名访问的浏览器不可用设置，即使 DSH Web 服务器信任该主机名。

适用场景与注意¶

适合需要在 loopback DSH Web 会话中调整阅读密度、背景、字号、行高、块间距和 Retina 字体渲染的用户。工作区外观只影响浏览器呈现，不进入模型请求或会话日志。

使用注意：

• 仅支持 loopback DSH Web 会话。
• 背景图片直接使用配置 URL，依赖浏览器网络和内容安全策略。
• 本版本面向 DSH 0.1.0-rc.6；预发布 DSH API 可能变化且不提供兼容垫片。
• 安装前应检查源码与许可证。

链接¶

dsh-custom-workspace 的价值是提供按工作区保留的 DSH Web 外观设置，不改变模型体验。

• GitHub：https://github.com/JeremyGuo/dsh-custom-workspace
• 目录页：未提供 URL