前言¶
DeepSeek Harness（dsh）的理念是「一切皆插件」，Web 客户端的外观和交互都可以由插件扩展。默认界面稳定够用，但如果你每天要在浏览器里长时间使用它，难免想换一套更合自己口味的视觉；另外 API 余额信息也不在客户端界面里，想确认余额通常得另开页面。
这类需求可以自己写插件解决，但要同时处理主题注入、交互状态和主机端 RPC，细节不少。下面介绍的 dsh-blue-archive-shiroko 把这些做成了现成的安装包：装上就能得到一套蔚蓝档案风格的主题、一个可互动的白子桌宠，以及顺手可查的 DeepSeek API 余额。
这是什么¶
dsh-blue-archive-shiroko 是由 mldhao 维护的 DSH Web 客户端主题插件，当前版本 0.6.0，源代码采用 MIT 许可证。一句话定位：面向 DeepSeek Harness（dsh）Web 客户端的蔚蓝档案风格非官方同人主题插件，含白子桌宠、Codex 风格短句气泡、抚摸互动与 DeepSeek API 余额查询。
需要先说明的是，这是非官方同人作品，与 NEXON Games、NEXON、Yostar、《蔚蓝档案 / Blue Archive》或 OpenAI 无隶属、授权或合作关系。角色名称、角色形象及用户提供的图片不包含在 MIT 授权范围内，发布或再分发前请确认素材使用权，细节见仓库中的 ASSET_NOTICE.md。
核心功能¶
蔚蓝档案风格 UI¶
主题以学院蓝和青色高光为主，配白色磨砂面板与战术网格背景，适配 DSH 的侧栏、消息、输入区、按钮、代码块和设置界面。也就是说装完后整个客户端是同一套视觉，而不是只有聊天区换色。
白子桌宠¶
桌宠支持拖动、缩放、隐藏、位置复位和动画开关。空闲时会自主切换打招呼、观察、伸展、好奇等互动，默认开启，页面空闲约 12–25 秒后触发；任务执行、菜单打开或页面隐藏时会暂停。各项设置保存在当前浏览器的 localStorage 中。
安全余额查询¶
短按桌宠即可查询余额。实现方式是插件主机端读取 DSH 已配置的 DEEPSEEK_API_KEY，调用 DeepSeek 官方 https://api.deepseek.com/user/balance 接口，显示币种与可用余额，低余额警告阈值可在设置中调整。
密钥不会进入浏览器或 localStorage；余额 RPC 仅允许运行 DSH 的本机（回环地址）页面调用，局域网远程页面会被拒绝。另外，自定义 OpenAI 兼容代理通常不提供 DeepSeek 官方余额接口，余额查询默认仅支持 DeepSeek 官方 API。
Codex 风格短句气泡¶
插件读取当前对话中的助手输出并拆分为短句，支持流式同步、逐字显示、闪动光标和完成后轮播，最多保留最近 8 个短句。「Codex 风格」指的只是短句、逐字显示与状态提示的交互方式，没有复制官方宠物图片、语音或音效。
抚摸互动、音效与设置界面¶
按住角色头部约 420ms 触发抚摸互动，包含点头、粉色光圈、上浮爱心和专属台词；拖动超过 8px 会取消，避免误触。音效包含角色点击音、助手回复完成音和低余额警告音，警告音有 60 秒冷却，可在设置中关闭。设置界面在桌面端完整居中显示，窄屏自动切换横向标签布局，并尊重 prefers-reduced-motion。
安装与启用¶
环境要求：已安装并可正常运行的 DeepSeek Harness / dsh，已启用 DSH Web 客户端；查询余额需配置有效的 DEEPSEEK_API_KEY；浏览器使用 Chromium、Chrome、Edge 等现代浏览器。
推荐从 GitHub 的 Releases 页面下载 dsh-blue-archive-shiroko-0.6.0.tgz，然后执行安装命令，路径替换为你的实际下载位置：
dsh plugin --profile web add "C:\path\to\dsh-blue-archive-shiroko-0.6.0.tgz"
安装完成后需要完全重启 DSH Web，再按 Ctrl+F5 强制刷新。仅刷新页面不够，0.6.0 的主机端 RPC 需要重启才能生效。
如果想直接在源码上调试，可以从源码目录安装：
git clone https://github.com/mldhao/dsh-blue-archive-shiroko.git
cd dsh-blue-archive-shiroko
dsh plugin --profile web add "$PWD"
重启 DSH Web 后刷新页面即可，目录里的修改通常可在重启或刷新后直接验证。安装后用下面的命令确认插件已出现在 web profile 的插件列表中：
dsh plugin --profile web list
日常使用¶
交互都集中在桌宠身上：
1、短按角色：播放点击音并查询 DeepSeek API 余额。
2、按住头部：约 420ms 后触发抚摸效果。
3、拖动角色：移动超过 8px 进入拖动，不会误触余额查询或抚摸，位置自动保存。
4、点击齿轮按钮：打开或关闭快速面板，面板里可立即触发一次自主互动。
5、桌宠离开可视区域时，在设置中点击「恢复桌宠位置」。
白子主题设置里可以控制桌宠显示、对话同步、桌宠音效、低余额阈值、动画、自主互动和缩放，也可以手动查询余额。想自定义外观的话，主题色与 DSH token 在 lib/client.js 的 TOKENS；桌宠图片是 assets/shiroko-custom.webp，更换后需同步更新 lib/client.js 中的 PET_IMAGE，否则运行中的插件仍会显示旧图。
本地预览与开发¶
仓库提供不依赖 DSH 的静态视觉预览。在仓库目录下启动一个本地静态服务：
cd dsh-blue-archive-shiroko
python -m http.server 4173
浏览器访问 http://127.0.0.1:4173/preview/，预览页面可以切换桌宠状态并拖动角色。
开发和打包用三个命令：npm run check 做语法检查，npm test 跑余额解析和凭据边界测试，npm run pack:release 生成安装包到 dist/。
npm run check
npm test
npm run pack:release
适用场景与注意事项¶
适合想要个性化 DSH Web 客户端、喜欢蔚蓝档案题材，同时希望顺手看到 DeepSeek API 余额的个人用户。使用前有几点需要留意：
1、插件以当前 dsh 进程的权限运行，主机端可以读取 DSH 已配置的 DEEPSEEK_API_KEY。安装前建议检查源码与许可证：源代码是 MIT，但角色名称与形象素材不在 MIT 授权范围内。
2、对话同步依赖 DSH 当前的 DOM 结构，例如 [data-chat-flow-kind="assistant-step"] 和停止按钮的 aria-label，DSH 大幅更新后可能需要调整选择器。
3、浏览器未授权音频播放、页面处于后台或系统限制 Web Audio 时，点击、完成和警告音可能静默跳过。
4、卸载相关的移除命令在不同 DSH 版本间可能有差异，执行 dsh plugin --help 和 dsh plugin --profile web --help 可以查看当前 CLI 支持的参数。
小结¶
这个插件把换肤和实用功能放在了一起：主题负责视觉，桌宠负责互动，余额查询解决实际的信息需求，安全边界（密钥不进浏览器、RPC 限回环）也有明确设计。如果你在用 DSH Web 客户端，装上试一试的成本不高，不合口味卸掉即可。项目主页与收录页面：
- GitHub：https://github.com/mldhao/dsh-blue-archive-shiroko
- 社区目录：https://www.skillhub.cn/plugins/mldhao/dsh-blue-archive-shiroko
