前言¶
DeepSeek Harness (DSH) 采用插件化架构，允许开发者通过添加插件来扩展功能。dsh-waaagh-ork 是由开发者 oopsylol 维护的一个插件，旨在通过视觉元素增强 DSH 的使用体验。其核心逻辑是将 AI 编码过程中的模型输出遮罩，替换为绿色的 “Waaaaaaagh!!!”，并在界面中注入一个线条画风格的绿皮兽人吉祥物，以此模拟 “WAAAGH!” 的编码氛围。
核心功能¶
该插件主要包含以下功能：
- 界面视觉改造
输入框被改造为漫画对话泡泡样式，主发送按钮变为绿色的 “Waaagh!” 药丸。模型思考或输出时，内容会被绿色的 “Waaaaaaagh!!!” 遮罩替换，点击可查看原文。 - 绿皮吉祥物
界面左侧会显示一个线条画风格的绿皮兽人头像。它具有三种状态：- 等待：坐在地上挠肚子，眨眼频率为 5 秒一轮。
- 干活：蹲在笔记本前敲键盘、甩汗、张嘴吼叫，共 8 帧。
- 失败：两手抱头惊慌，持续 4.2 秒，同时气泡边框变红。
兽人头像的尺寸和位置通过 JS 计算决定，确保不遮挡输入框或侧边栏。
- 氏族配色
支持六种氏族配色方案（Goffs / Bad Moons / Evil Sunz / Deathskulls / Snakebites / Blood Axes），通过色相旋转实现，颜色选择基于实测的色相值（0.299）。 - 标题与进程
模型运行时，任务栏或标签页标题会加上 “WAAAGH! · 前缀”。过程行（如读取文件、写入文件）的图标替换为绿皮头像，文字替换为随机嚎叫。 - 交互细节
点击兽人头像会触发 “喊叫” 动画（纯装饰，不干扰输入框）。插件不修改输入框草稿，发送内容保持原文。
安装与启用¶
安装方式取决于运行 DSH 的环境形态。
Web 环境¶
dsh plugin --profile web add dsh-waaagh-ork
安装后需重启 dsh web 并刷新页面。
Desktop 环境¶
桌面版使用 ~/.dsh/profiles/desktop 配置档。
- 通过界面安装：在桌面版设置中找到插件选项，安装
dsh-waaagh-ork。 - 手动配置：编辑
~/.dsh/profiles/desktop/package.json，添加依赖并指定 bundle：
{
"dependencies": { "dsh-waaagh-ork": "^0.2.0" },
"dsh": { "profile": { "bundles": ["@deepseek-ai/dsh-base", "@deepseek-ai/dsh-web-app", "dsh-waaagh-ork"] } }
}
然后使用桌面版自带的 pnpm 安装并重启。
本地开发¶
dsh plugin --profile web add link:/path/to/dsh-waaagh-ork
桌面版和 CLI 同理。使用 link: 路径时，插件加载的是工作副本的源码。
兼容性与要求¶
该插件对运行环境和 DSH 版本有明确要求：
- DSH 版本：
- Web 环境：0.1.6-alpha.2 及以上
- Desktop 环境：0.2.0-rc.2
- 运行时依赖：
- Node.js >= 20
- 火山方舟凭据（用于生成吉祥物素材）
开发与构建¶
插件源码位于 src/ 目录。构建产物（如精灵图）位于 lib/ 和 src/assets/，这些文件在安装时直接读取，无需构建步骤。
主要开发命令包括：
pnpm install # 安装依赖
pnpm run typecheck # 类型检查
pnpm run check-assets # 校验精灵图尺寸与帧数
pnpm run build # 构建
pnpm run verify # 验证构建产物与源码一致
pnpm run smoke # 回归测试（需运行中的实例）
吉祥物素材通过 scripts/mascot.py 脚本生成，调用火山方舟的 doubao-seedream-4-0 模型，生成纯品红背景的帧图，随后抠图、缩放并合成雪碧图。
结语¶
dsh-waaagh-ork 是一个专注于视觉体验的 DSH 插件，通过将模型输出遮罩和界面元素替换为绿皮兽人主题，为开发者提供了差异化的编码环境。所有功能均基于事实实现，不干扰核心开发流程。如需了解更多细节或查看源码，可访问插件目录或 GitHub 仓库。
- 插件目录：https://www.skillhub.cn/plugins/oopsylol/dsh-waaagh-ork
- 源码地址：https://github.com/oopsylol/dsh-waaagh-ork
