dsh-doubao-pet
Manifest validA draggable Doubao or SD-chan mascot in the corner of the web shell, with a hover card showing today's image spend and the quota usage of both the Doubao desktop client and the Volcengine Ark plan; it
dsh-doubao-pet
悬浮形象 → 资费与额度气泡;右上角按钮 → 控制台
Web 界面角落的豆包桌宠:悬浮看开销与额度、点击捏一下、可拖动可缩放可贴边。 生图有两条路线——本机豆包工作模式和火山引擎方舟 API——都通过 Agent 工具 + HTTP 接口暴露给 DSH。
形象与交互
| 状态 | 触发 | 表现 |
|---|---|---|
| 默认 | — | 豆包.png / sdniang.png |
| 悬浮 | 鼠标移上去 | 微笑图 + 资费气泡(不缩放、不加边框,避免出现视觉间隙) |
| 点击 | 单击 / 回车 / 空格 | 眯眼微笑图 + 捏捏形变 |
| 设置 | 悬浮后点形象外侧的蓝色调节按钮 | 打开控制台 |
- 可切换角色:豆包、sd娘(各自三态立绘)
- 素材管线:
tools/prepare-assets.ps1(缩 384² + 白底转透明)→tools/trim-assets.ps1(按三张图 alpha 并集紧贴裁剪, 两角色各自裁剪,三态共用同一矩形所以换表情不跳位) - 容器按立绘自身宽高比显示(宽高比由宿主读 PNG 头实时给出),不是正方形居中,所以四边能真正贴齐
位置 / 大小 / 贴边
- 拖动移动,超过 4px 才算拖拽(不会误触捏捏)
- 拖到离边缘 28px 内松手 → 自动贴齐(两轴独立,可贴角落),边缘留白 0
- 右下角把手拖拽缩放 48–240px
- 默认落在左下角:角色默认朝右歪头,站左边正好面向内容区
- 方位判断:盒子中心在屏幕左半边用默认形态,到右半边自动水平镜像(
scaleX(-1)), 脸始终朝内,不会背对内容区;镜像只作用于立绘,齿轮按钮与缩放手柄不跟着翻 - 位置、大小、角色、吸附开关都记在
localStorage(键dsh-doubao-pet:ui:v2); 刷新后按保存的坐标同步还原(首帧就到位,不会先闪到别处再跳回来) - 「复位位置与大小」回到左侧默认位
控制台(三个页签)
豆包本地生图
- 一行状态栏:豆包客户端是否安装 / 是否在运行(真读进程列表,不看窗口标题)
- 未安装 → 「安装」按钮直接打开豆包下载页
- 就绪 → 显示客户端额度(额度/套餐/月费/续费)+ 今日/累计出图开销
- 以调试端口重启豆包:额度自动读取依赖客户端的 CDP 调试端口。如果你是自己正常启动的豆包(没有
--remote-debugging-port),额度会显示「未读取」——点这个按钮会关掉当前豆包并带端口重新拉起。 两步确认(第一次点是提示,第二次点才执行),taskkill→ 重启 → 轮询/json/version直到就绪
火山引擎生图
- 一行状态栏:Ark CLI 版本、是否已配置 Key
- 没装 Ark CLI → 「部署 Ark CLI」(
npm i -g @volcengine/ark-cli@latest,需确认) - 输入
ark-…Key → 「验证」:判定网关(套餐/api/plan/v3/ 按量/api/v3)、探测套餐里真正能调的模型及其单价, 并弹出验证结果卡片(Key 尾号、计费网关、可用模型数、套餐档位、今日消耗) - 验证结果会落盘缓存(
<outDir>/_ark_cache.json):下次打开面板直接显示模型和单价,不再重新探测; 想看实时状态就点「重新探测」 - 没有 Key → 「开通」按钮直达
https://ark.volcengine.com/region:cn-beijing/subscription/agent-plan - 「查套餐」走 Ark CLI(需先在终端
arkcli auth login)
外观设置
- 角色切换(豆包 / sd娘)
- 拖动自动贴边开关
- 形象大小滑杆、放大/缩小、复位位置与大小
资费气泡
鼠标悬浮形象时显示(不打开控制台):
今日消耗
豆包本地 6 张 · ¥0
火山引擎 5 张 · ¥0.78(折算)
额度
火山 5 小时 0/10000 0%
火山 本周 0/35000 0%
火山 本月 510/100000 0.51%
豆包额度 347/24000 1.45%
今日合计 11 张
- 火山额度来自
arkcli usage plan,与控制台「用量」三行一致(5h / 本周 / 本月,含重置时间 tooltip) - 豆包额度自动读取:在客户端页面上下文里直接调它自己的额度接口
POST /alice/commerce/sale/subscription/quota/summary/?aid=582478(页面 cookie 自带登录态,不需要签名参数、不需要打开任何界面、不闪窗口,约 235ms)。 返回used / total / percent,附带套餐名、月费、续费时间。读不到时可在面板里手动覆盖 - 开销:本地读工作区
art/cost/ledger.jsonl,火山读插件_stats.json;套餐模式现金记 0、另记折算值
生图接口(界面不再提供表单)
- 工具
doubao_generate_image——{ prompt, route?, size?, count?, model? }route: "ark"(默认)走火山引擎方舟 APIroute: "local"走本机豆包客户端工作模式(子进程调art/tools/imgforge,¥0、慢、会在豆包项目里建对话)model:省略或"auto"时自动在套餐可用模型里挑(默认优先,UnsupportedModel自动换下一个, 返回autoSelected/tried);传确切 id 则强制使用,不在套餐里直接报错并列出可用项
- 工具
doubao_pet_status—— 环境 + 今日开销 + 额度用量 +ark.models(可用模型 id 与单价,只读) - HTTP:
POST /doubao-pet/api/generate、GET /doubao-pet/api/status、GET /doubao-pet/api/usage - 文档:
docs/IMAGE_GEN.md(DSH 需要图时先读它)
安装
dsh plugin --profile web add link:D:\_\文档\三国弹射物语\plugins\dsh-doubao-pet
配置项(bundle 行 config,可选)
| 键 | 默认 | 说明 |
|---|---|---|
outDir | <工作区>/art/ai/doubao_plugin | 生图落盘 + 统计文件目录 |
model | doubao-seedream-5-0-flash-260915 | 默认生图模型 |
size | 2K | 默认尺寸 |
API Key 只存在于 credentials(记录键 DOUBAO_ARK_API_KEY),不写配置文件、不进日志。
安全 / 访问控制
/doubao-pet/* 的所有路由(API、素材、出图结果)只允许 DSH 界面自己调用:
- 宿主启动时生成一次性随机 token(24 字节),通过
webServer.tapIndex注入到 DSH 已完成鉴权的index.html里的<meta name="dsh-doubao-pet-token">。 根页面无凭据访问返回 401,所以这段 HTML 只有拿到 DSH 凭据的浏览器能读到 - 客户端插件从
<meta>取出 token,API 请求带x-doubao-pet-token头,<img src>这类不能带头的 URL 追加?t=<token> - 校验失败一律 401,连素材图都不返回
- 浏览器里的其它网页拿不到这个 token(跨域读不到 DSH 的 HTML),因此无法调用; 本地其它程序也猜不出来
- POST 路由仍保留同源校验(
Origin/Host一致)作为第二道门 - 老版本 DSH 不支持
tapIndex时退化为同源校验,并在宿主日志里告警
工具返回的 /doubao-pet/out/<name> 链接同样受保护:它在 DSH 页面内可直接打开,
单独复制到别的浏览器窗口会 401;拿文件请用返回值里的 path。
市场上架时维护者在描述里加了「HTTP 路由没有 DSH 访问检查」的提醒,0.2.0 起这条已不成立。
缓存与性能
面板打开不再被额度查询拖慢:状态与额度拆成两个接口。
| 接口 | 内容 | 耗时 |
|---|---|---|
GET /api/status | 环境、角色、今日统计、上次额度缓存、生图偏好 | 冷 730ms / 热 3–5ms(环境探测有 15s 内存 TTL) |
GET /api/usage | 火山 arkcli usage plan + 豆包静默扫描(并发) | 首次 1.8s,之后 5 分钟内 3ms(磁盘缓存) |
GET /api/prefs / POST /api/prefs | 生图偏好(ark / local) | <5ms |
额度结果落盘到 <outDir>/_usage_cache.json,重启后仍能先显示上次值再后台刷新。
生图偏好
「外观设置」页有两项偏好,都持久化在 <outDir>/_prefs.json:
| 偏好 | 取值 | 作用 |
|---|---|---|
| 生图通道 | 火山引擎 API / 豆包本地工作模式 | 调用时没给 route 就按它走 |
| Ark 模型偏好 | 速度 / 经济优先、质量优先 | 调用时没给 model 就按它排序挑模型 |
模型偏好只是排序:先按偏好选最合适的一个,遇到 UnsupportedModel 仍会自动回落到下一个,
不会因为偏好导致失败。单次调用可以用 prefer: "fast" | "quality" 覆盖。
实测(套餐内两个模型 flash ¥0.12 / pro ¥0.30):
| 设置 | 不指定 model 的结果 |
|---|---|
| 速度 / 经济优先 | doubao-seedream-5-0-flash-260915 |
| 质量优先 | doubao-seedream-5-0-pro-260628 |
prefer: "fast"(quality 前提下按次覆盖) | doubao-seedream-5-0-flash-260915 |
| 缓存 | 位置 | 内容 |
|---|---|---|
| API Key | DSH credentials | 持久,重启不丢 |
| 验证结果 | <outDir>/_ark_cache.json | 网关、模式、模型清单(含可达性/单价)、可用模型、套餐、验证时间 |
| 环境探测 | 内存 15s | arkcli 版本、豆包是否运行(避免每次打开都 spawn 一次 arkcli) |
| 出图统计 | <outDir>/_stats.json | 按天累计张数与现金/折算金额 |
缓存按 Key 指纹(长度 + 末 6 位)校验:换 Key 会自动失效并重新探测。
已知边界
- 额度:方舟数据面 API 不返回额度,只能得到逐模型可达性和
429状态;套餐档位要用 Ark CLI(控制面)。 - 本地豆包只做探测与统计,不驱动客户端出图(驱动方式见工作区
art/tools/imgforge)。 - 角色宽高比随素材变化,宿主实时读 PNG 头,不需要手动改常数。
Comments
Loading…
Similar plugins
by nszm
Floating desktop companion for DSH: a draggable character on the overlay — tap to charge energy, blinking and emotes, naps, synthesized WebAudio sounds and particle effects. Bring your own: any photo
★ 0
BSD-3-Clause
TypeScript
Oct 27, 2026
dsh plugin --profile web add dsh-pet-lingchongby wawo77
Plan-usage pet for the DSH web GUI: a floating skeletal-animated character reports quota in a speech bubble, auto-matching the configured provider (OpenCode Go, Command Code, DeepSeek) to show a plan
★ 4
↓ 167/wk
MIT
JavaScript
Sep 16, 2026
dsh plugin --profile web add dsh-opencode-go-usageMarkdown display enhancements for the DSH Web chat, applied on top of the host renderer rather than replacing it: code blocks become cards with a language label and icon-only wrap and copy buttons, lo
★ 1
MIT
JavaScript
dsh plugin --profile web add dsh-md-plusby Jiazliang
DSH 插件:用本机浏览器(ego lite 优先 / Chrome 回落)操控豆包网页版生成 AI 图片,落盘高清原图并注入对话附件
★ 0
JavaScript
Nov 15, 2026
dsh plugin --profile web add dsh-doubao-paintA desktop pet in the DSH web GUI: floating, draggable sprite pet that animates with agent activity (thinking, idle, error, done, awaiting approval), with a settings page for size, switching, gallery s
★ 0
dsh plugin --profile web add @dsh-external/dsh-petdex-petby hunyu-feng
Vision for DSH agents and MCP clients: analyze_image over local files or URLs using Doubao models on Volcano Ark, with model fallback.
★ 0
MIT
JavaScript
Oct 22, 2026
dsh plugin --profile web add dsh-vision