DSH Plugins Marketplace

DSH Plugins

Plugins

/

UI & Experience

/

dsh-doubao-pet

a

dsh-doubao-pet

Manifest valid

A 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

UI (client)hasBundlePatch

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"(默认)走火山引擎方舟 API
    • route: "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生图落盘 + 统计文件目录
modeldoubao-seedream-5-0-flash-260915默认生图模型
size2K默认尺寸

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 KeyDSH credentials持久,重启不丢
验证结果<outDir>/_ark_cache.json网关、模式、模型清单(含可达性/单价)、可用模型、套餐、验证时间
环境探测内存 15sarkcli 版本、豆包是否运行(避免每次打开都 spawn 一次 arkcli)
出图统计<outDir>/_stats.json按天累计张数与现金/折算金额

缓存按 Key 指纹(长度 + 末 6 位)校验:换 Key 会自动失效并重新探测。

已知边界

  • 额度:方舟数据面 API 不返回额度,只能得到逐模型可达性和 429 状态;套餐档位要用 Ark CLI(控制面)。
  • 本地豆包只做探测与统计,不驱动客户端出图(驱动方式见工作区 art/tools/imgforge)。
  • 角色宽高比随素材变化,宿主实时读 PNG 头,不需要手动改常数。

Comments

Loading…

Similar plugins

dsh-pet-lingchong

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

Just for FunManifest valid

★ 0

BSD-3-Clause

TypeScript

Oct 27, 2026

dsh plugin --profile web add dsh-pet-lingchong

by 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

Tools & CapabilitiesManifest valid

★ 4

↓ 167/wk

MIT

JavaScript

Sep 16, 2026

dsh plugin --profile web add dsh-opencode-go-usage

Markdown 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

UI & ExperienceManifest valid

★ 1

MIT

JavaScript

dsh plugin --profile web add dsh-md-plus

by Jiazliang

DSH 插件:用本机浏览器(ego lite 优先 / Chrome 回落)操控豆包网页版生成 AI 图片,落盘高清原图并注入对话附件

Manifest valid

★ 0

JavaScript

Nov 15, 2026

dsh plugin --profile web add dsh-doubao-paint

A 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

Just for FunManifest valid

★ 0

dsh plugin --profile web add @dsh-external/dsh-petdex-pet

by 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.

Manifest valid

★ 0

MIT

JavaScript

Oct 22, 2026

dsh plugin --profile web add dsh-vision