DSH Blue Archive Shiroko Theme

简体中文 · English

一个面向 DeepSeek Harness（dsh）Web 客户端的非官方同人主题插件。它为 DSH 提供蔚蓝档案风格的学院蓝 UI，并加入一个可拖动、可抚摸、可同步当前助手回复和安全查询 DeepSeek API 余额的白子桌宠。

[!IMPORTANT] 本项目是非官方同人作品，与 NEXON Games、NEXON、Yostar、《蔚蓝档案 / Blue Archive》或 OpenAI 无隶属、授权或合作关系。代码采用 MIT 许可证；角色名称、角色形象及用户提供的图片不包含在 MIT 授权范围内。发布或再分发前请确认你拥有相关素材的使用权。详情见 ASSET_NOTICE.md。

功能亮点

• 蔚蓝档案风格 UI
  • 学院蓝与青色高光、白色磨砂面板、战术网格背景
  • 适配 DSH 的侧栏、消息、输入区、按钮、代码块和设置界面
• 白子桌宠
  • 支持拖动、缩放、隐藏、位置复位和动画开关
  • 空闲时自主切换打招呼、观察、伸展和好奇等互动
  • 短按角色即可查询 DeepSeek API 余额；独立齿轮按钮用于打开快速控制面板
• 安全余额查询
  • 插件主机端读取 DSH 已配置的 DEEPSEEK_API_KEY，密钥不会进入浏览器或 localStorage
  • 调用 DeepSeek 官方 https://api.deepseek.com/user/balance 接口
  • 显示当前币种和可用余额，可在设置中调整低余额警告阈值
  • 专用 RPC 仅允许本机页面调用，降低凭据和账户信息暴露风险
• Codex 风格短句气泡
  • 读取当前对话中的助手输出并拆分为轻量短句
  • 支持流式同步、逐字显示、闪动光标和完成后轮播
  • 最多保留最近 8 个短句，助手输出期间优先显示真实回复
• 抚摸互动
  • 按住角色头部约 420ms 即可触发
  • 包含点头、粉色光圈、上浮爱心和专属台词
  • 拖动超过 8px 会取消抚摸，避免误触
• 桌宠音效
  • 包含角色点击音、助手回复完成音和低余额警告音
  • 低余额警告音有 60 秒冷却，避免连续查询时反复播放
  • 不包含官方语音或官方音效，可在设置中关闭
• 响应式设置界面
  • 桌面端完整居中显示，窄屏自动切换横向标签布局
  • 尊重 prefers-reduced-motion

环境要求

• 已安装并可正常运行的 DeepSeek Harness / dsh
• 已启用 DSH Web 客户端
• 若要查询余额，需要在 DSH 中配置有效的 DEEPSEEK_API_KEY
• Chromium、Chrome、Edge 等现代浏览器

安装

方法一：安装 GitHub Release 压缩包（推荐）

1. 在 GitHub 的 Releases 页面下载：

   dsh-blue-archive-shiroko-0.6.0.tgz
   

2. 执行以下命令，将路径替换为你的实际下载位置：

   dsh plugin --profile web add "C:\path\to\dsh-blue-archive-shiroko-0.6.0.tgz"
   

3. 完全重启 DSH Web，然后在浏览器中按 Ctrl + F5 强制刷新。

方法二：从源码目录安装

git clone https://github.com/mldhao/dsh-blue-archive-shiroko.git
cd dsh-blue-archive-shiroko
dsh plugin --profile web add "$PWD"

重新启动 DSH Web 后刷新页面。源码目录安装适合开发和调试；目录中的修改通常可在重启或刷新后直接验证。

使用方法

• 短按角色：播放点击音并查询 DeepSeek API 余额。
• 按住头部：约 420ms 后触发抚摸效果。
• 拖动角色：移动超过 8px 后进入拖动，不会误触余额查询或抚摸；位置会自动保存。
• 点击齿轮按钮：打开或关闭快速面板。
• 换个动作：在快速面板中立即触发一次自主互动。
• 白子主题设置：控制桌宠显示、对话同步、桌宠音效、低余额阈值、动画、自主互动和缩放，也可手动查询余额。
• 恢复位置：桌宠离开可视区域时，在设置中点击“恢复桌宠位置”。

设置保存在当前浏览器的 localStorage 中。自主互动默认开启，页面空闲约 12–25 秒后触发；任务执行、菜单打开或页面隐藏时会暂停。

卸载与排错

查看已安装插件：

dsh plugin --profile web list

如果安装后网页没有变化：

1. 确认插件出现在 web profile 的插件列表中。
2. 完全停止并重新启动 DSH Web，而不只是刷新网页。
3. 使用 Ctrl + F5 清除页面缓存。
4. 打开 DSH 设置，确认主题或插件已启用。
5. 若曾安装旧版本，先移除旧版本，再安装最新 Release。

如果余额查询失败：

1. 在 DSH 模型设置中确认 DEEPSEEK_API_KEY 已配置且仍然有效。
2. 完全重启 DSH Web，使 0.6.0 的主机端 RPC 生效；只刷新页面不够。
3. 余额查询仅支持从运行 DSH 的本机页面调用，局域网远程页面会被拒绝。
4. 自定义 OpenAI 兼容代理通常不提供 DeepSeek 官方余额接口，此功能默认查询 DeepSeek 官方账户。

不同 DSH 版本的移除命令可能略有差异，请运行以下命令查看当前 CLI 支持的参数：

dsh plugin --help
dsh plugin --profile web --help

本地预览

仓库提供不依赖 DSH 的静态视觉预览：

cd dsh-blue-archive-shiroko
python -m http.server 4173

浏览器访问 http://127.0.0.1:4173/preview/。预览页面可以切换桌宠状态并拖动角色。

开发与打包

检查 JavaScript 语法：

npm run check

运行余额解析和凭据边界测试：

npm test

生成安装包：

npm run pack:release

安装包会输出到 dist/。如果 npm 的全局缓存目录没有写入权限，可临时指定项目内缓存：

$env:npm_config_cache = "$PWD\.npm-cache"
npm run pack:release

文件结构

dsh-blue-archive-shiroko/
├─ package.json
├─ cordis.patch.yml
├─ lib/
│  ├─ index.js
│  └─ client.js
├─ preview/
│  ├─ index.html
│  ├─ preview.css
│  └─ preview.js
├─ tests/
│  └─ balance.test.js
├─ assets/
│  ├─ screenshot.png
│  ├─ screenshot-mobile.png
│  └─ shiroko-custom.webp
├─ README.md
├─ README.en.md
├─ CHANGELOG.md
└─ ASSET_NOTICE.md

自定义

• 主题色与 DSH token：lib/client.js 中的 TOKENS
• 桌宠图片：assets/shiroko-custom.webp
• 插件内嵌图片：lib/client.js 中的 PET_IMAGE
• 状态文案与强调色：lib/client.js 中的 PHASES
• 自主互动动作与台词：lib/client.js 中的 INTERACTIONS
• 视觉样式：lib/client.js 中的 STYLE_TEXT

更换角色图片后，还需要同步更新 lib/client.js 中内嵌的 PET_IMAGE，否则运行中的插件仍会显示旧图片。

已知限制

• “Codex 风格”仅指短句、逐字显示与状态提示的交互方式；本项目没有复制 Codex 官方宠物图片、语音或音效。
• 对话同步依赖 DSH 当前的 DOM 结构，包括 [data-chat-flow-kind="assistant-step"] 和“停止生成 / Stop generating”按钮的 aria-label。DSH 大幅更新后可能需要调整选择器。
• 余额查询默认仅支持 DeepSeek 官方 API 与 DEEPSEEK_API_KEY，不假定第三方兼容代理实现余额接口。
• 出于安全原因，余额 RPC 仅接受回环地址上的 DSH 页面；从其他设备访问 DSH Web 时不能查询余额。
• 浏览器未授权音频播放、页面处于后台或系统限制 Web Audio 时，点击、完成和警告音可能静默跳过。
• 桌宠状态由页面 DOM 推断，不需要后端服务，但第三方主题或 DSH 页面结构变化可能影响状态识别。

版本

当前版本：0.6.0。更新记录见 CHANGELOG.md。

许可证与声明

• 源代码：MIT License，见 LICENSE。
• 角色、名称与图片素材：不属于 MIT 许可范围，见 ASSET_NOTICE.md。
• 本项目仅供学习、个人定制和同人交流使用。