dsh-pet-ark
v0.1.0
Published
火山AFP桌宠:Live2D 透明置顶桌宠 + 火山方舟配额浮窗(DSH 插件启动器,随 DSH 启停)
Maintainers
Readme
火山AFP桌宠(dsh-pet-ark)
DSH 插件:安装后自动拉起「火山AFP桌宠」——透明置顶 Live2D 桌宠,右侧悬浮火山方舟 Agent Plan 配额卡(5 小时/本周/本月),跟随 DSH Desktop 显示/隐藏。
功能
- 🐱 Live2D 桌宠:Q 版/半身角色 15 个(含黑猫 hijiki、白猫 tororo),支持切换、动作、鼠标穿透
- 📊 配额浮窗:每 5 分钟刷新火山方舟用量(低频率,避免触发 SSO 续期限流)
- 🪟 桌面特性:透明无边框置顶、不进任务栏(仅托盘图标)、隐藏本体后鼠标可穿透点击下方
- 🔌 DSH 集成:插件挂载自动启动、卸载自动停止;
pet-*命令控制
安装
- 准备环境:Python 3.10+(含 pywebview、pystray、psutil、Pillow)
- 生成资源:
npm run assets(从源目录拷贝角色与播放器) - 本地安装插件(二选一):
- DSH 设置页 → 插件 → 安装本地包(选择
dsh-pet-ark目录) - 或命令行
dsh plugin --profile <profile名> add <dsh-pet-ark 绝对路径>
- DSH 设置页 → 插件 → 安装本地包(选择
- 插件通过
dsh.bundle(cordis.patch.yml)注册为 profile 层,重启 DSH 后自动激活: 激活后挂载即拉起桌宠浮窗,对话里可用/pet-*命令,DSH 退出时自动终止浮窗 - 火山方舟凭证:每台设备需单独配置
arkcli并登录(凭证不进插件包)
命令
| 命令 | 作用 |
|---|---|
| pet-show / pet-hide | 显示 / 隐藏浮窗 |
| pet-pass / pet-pass-off | 开启 / 关闭鼠标穿透 |
| pet-card | 显示 / 隐藏额度卡 |
| pet-body | 显示 / 隐藏角色本体 |
| pet-quit | 退出浮窗 |
| pet-status | 查询浮窗状态 |
开发
- 插件入口:
lib/index.js(零第三方依赖,仅 Node 内置模块) - 浮窗本体:
assets/ark-live2d-float.py(pywebview + WebView2) - 本地控制口:
127.0.0.1:47582(show/hide/pass/card/body/status/quit) - 换角色 / 加模型:改
assets/pet/下chars.json与char/,重新拷贝资源即可
上架信息(提交到插件市场时使用)
- 市场网站:https://www.deepseekharnessmarket.site/ (GitHub 登录,README 顶部元数据块即为提交格式参考,以网站「提交插件」页为准)
- 分发渠道:npm(
npm publish)+ GitHub 公开仓库
跨设备
- 插件包自带全部桌宠资源,装到新设备 = 资源即得
- 每台设备仍需:Python + WebView2、
arkcli、登录火山 SSO(每设备约 2~3 天重登一次;额度为账号级)
版权与安全
- 凭证安全:插件不包含任何火山/SSO 密钥;密钥仅存于各设备本地的 arkcli 配置
- 模型素材:Live2D 官方样例模型为免费素材许可;公开分发前请核对再分发条款,建议公开版仅捆绑自有权/许可清晰的模型(如自绘或已授权素材)
