前言¶

DeepSeek Harness（dsh）默认是 React 官方前端：功能完整，但界面风格固定。若你希望在不改宿主核心逻辑的前提下，把「AI 编码代理控制台」换成一套自包含的像素风 UI，并在桌面与浏览器两条路径上都能用，社区插件 dsh_theme_terraria（npm 包名 dsh-theme-terraria）提供了一条标准插件路径：用约 230 KB、零外部 JS 依赖的单文件 index.html 替换或接管前端，同时仍通过 JSON-RPC（HTTP）与 WebSocket 对接宿主，会话、流式输出、工具审批、模型切换等能力保持可用。

下面介绍该插件的定位、能力与安装方式。事实以 GitHub 仓库 README 为准；维护者为 jiabei20031104，SkillHub 分类为「趣味换装」，当前 README 标注版本 0.3.0，许可证 MIT。

这是什么¶

dsh_theme_terraria 是 dsh 的泰拉瑞亚主题插件。它不是一个只改 CSS 的纯皮肤：主题前端直连宿主协议，填入 DeepSeek API 密钥即可与模型真实对话。

实现方式符合 dsh 插件包规范：入口 index.js 导出 apply(ctx)，cordis.patch.yml 声明 dsh.bundle 补丁层；桌面版装入 desktop profile，浏览器版装入 web profile，不直接改动 dsh 安装目录里的文件。插件已发布到 npm，推荐按包名 dsh-theme-terraria 安装。

README 标明兼容 DeepSeek Harness Desktop 0.2.0-rc.2 量级；浏览器路径需本机可用的 dsh CLI（桌面应用自带的 dsh.cmd 主要用于 desktop profile 的插件管理，不负责 dsh web）。

核心功能¶

界面与协议¶

• 单文件交付：整块 UI 内联在 web/index.html，由插件伺服，无运行时框架、无构建步骤。
• 真实宿主能力：会话创建、消息发送、流式输出、工具审批、模型切换、工作空间管理与官方前端同一套传输层。
• 概念映射：官方 Agent Preset 对应「难度档」（旅途 / 软核 / 中核 / 硬核）；会话称「旅途 / 冒险」，工具审批称「审批石板」，API 密钥状态以「生命水晶」等形式呈现（详见 README 对照表）。

桌面与浏览器两条路径¶

桌面应用只读 desktop profile；主题装进 web profile 不会让桌面窗口换肤，这是 README 强调的常见问题。两条路径互不影响。

桌面端：接管与兜底¶

桌面窗口对内置官方前端路径有硬映射。主题默认通过注入行设置 __TERRARIA_THEME__，预检 /terraria/theme.html 成功后 location.replace 到与浏览器相同的 UI。若主题页不可用或关闭接管，可回退为「官方 UI + 注入式像素皮肤」（skin/terraria.css），避免白屏。

环境变量（须在启动宿主前设置，运行中修改无效）：

桌面窗口可用标题屏「切回官方界面」或 Alt+O 写 localStorage['terraria.takeover']='0'；浏览器路径没有可切回的官方 React 前端，需卸载插件后重启 dsh web。

共存与限制¶

• 主题页为自包含前端，接管期间不加载 /plugins/*/client.js，部分客户端插件界面在接管时不可见；需要并存时可设 DSH_TERRARIA_STANDALONE=0。
• 同一 profile 不宜装多个「换 dist」主题；本插件检测到已有 webRuntime 时会跳过委托并 warn。
• 安装主题等于允许约 4 KB 注入脚本与约 230 KB 主题页在 operator 身份的桌面窗口执行；README 说明其不读取/打印 API 密钥，账号快照经同源 /terraria/account 与 cookie 栅栏。

安装与启用¶

环境要求¶

• 已安装 DeepSeek Harness（桌面应用或 dsh CLI）
• Node.js ^22.19 || >=24 与 pnpm（dsh plugin 内部使用 pnpm；桌面应用自带运行时时可不另装 Node）
• DeepSeek API 密钥（对话必需；无密钥也可浏览部分界面）

安装或升级插件后，须完全退出桌面应用再启动：注入行是宿主启动时的一次性快照，仅刷新窗口无效。

桌面版（desktop profile）¶

先完全退出应用（含托盘），再执行安装。README 以 Windows 为例，使用应用内置 CLI（将 <DSH 安装目录> 换成实际路径；dsh 已在 PATH 时也可直接用 dsh）：

& '<DSH 安装目录>\resources\runtime\cli\bin\dsh.cmd' plugin --profile desktop add dsh-theme-terraria

也可在应用内 Plugin Hub 搜索 dsh-theme-terraria 安装。有 git 时 README 另给出 github:jiabei20031104/dsh_theme_terraria 来源；无 git 时从 GitHub 安装可能报错，应优先用 npm 包名或本地仓库绝对路径。

安装后正常双击启动，窗口应导航到带 host 查询参数的 terraria/theme.html 路由。卸载回到官方 UI：

& '<DSH 安装目录>\resources\runtime\cli\bin\dsh.cmd' plugin --profile desktop remove dsh-theme-terraria

卸载后同样建议完整退出并重启。

浏览器版（web profile）¶

需本机可执行 dsh web 的 CLI：

dsh plugin --profile web add dsh-theme-terraria
dsh web

默认地址为 http://127.0.0.1:3080/。在 deepseek-harness 源码树内开发时，README 建议命令前加 pnpm 前缀（如 pnpm dsh plugin ...、pnpm dsh web）。

恢复官方 Web 前端：

dsh plugin --profile web remove dsh-theme-terraria

然后重启 dsh web。

典型用法¶

1. 按上节将插件装入对应 profile，重启宿主或执行 dsh web。
2. 打开主题界面，点击「新的会话」；首次进入会弹出设置，在「DeepSeek API 密钥」填入 sk-... 并保存。密钥经 credentials.set 写入宿主机 .dsh-home/.credentials.yaml，页面不持久保存明文。
3. HUD 显示 API 密钥已配置后，在对话框输入指令即可开始对话。
4. 通过「难度档」切换 Agent 预设：旅途（standard）、软核（code）、中核（minimal）、硬核（cordis），插件组合随难度变化。

README 还单独描述了视觉设计、8-bit 音效、隐藏彩蛋、性能与可访问性护栏等章节，需要细节时可直接查阅仓库文档。

适用场景与注意¶

适合谁：已在用 dsh 做编码代理、希望桌面或浏览器界面换成泰拉瑞亚像素风，且接受「换前端 dist / 桌面接管」这一信任边界的开发者。

使用前请知悉：

• 插件以当前 dsh 进程权限运行；安装前建议阅读源码与 MIT 许可证，并理解注入脚本与主题页的执行范围。
• desktop 与 web 的 profile 必须配对，否则会出现「插件已安装但界面未变」。
• 社区目录 SkillHub 插件页 与 GitHub 由社区维护，与 DeepSeek / 幻方无官方从属关系；星标等元数据以各站点当时展示为准。

结尾¶

dsh-theme-terraria 把 dsh 的 Web UI 做成可安装的泰拉瑞亚像素主题：标准 bundle 补丁、npm 包名安装、桌面接管与浏览器换 dist 双路径，并在失败时保留官方 UI 像素皮肤兜底。若你要在 Harness 里用向导陪写代码，可从 desktop 或 web profile 安装 dsh-theme-terraria，配置 API 密钥后按难度档切换预设即可开工。

• 目录页：https://www.skillhub.cn/plugins/jiabei20031104/dsh_theme_terraria
• 源码与文档：https://github.com/jiabei20031104/dsh_theme_terraria