前言¶

在 DeepSeek Harness（DSH）里长时间跑会话时，界面往往只有日志与输入框，缺少一点「人在场」的反馈。有些开发者会在侧边挂桌面宠物或静态立绘，但常见做法是固定位置、与会话状态无关，也读不到账号余额等宿主信息。

下面介绍社区插件 dsh-jinhsi-avatar（维护者 ten-feng，分类：趣味换装）。它在 DSH 窗口右下角常驻《鸣潮》同人角色今汐：四组透明循环动画、全窗口漫游、远近缩放，并在点击时用敲碗音效与气泡播报星声余额；会话忙碌时会收拢到角落。插件以 MIT 许可发布，npm 暂未发布，需从 GitHub 安装。

这是什么¶

dsh-jinhsi-avatar 是注入 DSH Web 客户端的形象体插件：官方立绘经图生视频生成待机 / 行走 / 飞行 / 打盹四组动作，逐帧抠图成无背景的透明循环动画（裁切后单帧约 168×243，浏览器端 CSS 缩放）。

它解决两类问题：一是给 DSH 主窗口增加可交互的桌面伴侣，行为与会话忙闲联动；二是把 DSH 账号余额与本地估算的「今日消耗」用角色台词说出来，数据源与「设置 → 账号与余额」一致。另附带加密「封存舱」，身份相关文本随包以密文分发，仅持有钥匙的一方可读。

目录页：https://www.skillhub.cn/plugins/ten-feng/dsh-jinhsi-avatar
源码与说明：https://github.com/ten-feng/dsh-jinhsi-avatar（当前 package.json 版本 1.9.0，Node >=20）

核心功能¶

动画与漫游¶

• 四组动作：待机、行走、飞行、打盹，均为图生视频产出后逐帧抠图的透明循环，README 说明无背景残留。
• 全窗口漫游：在整块 DSH 窗口内自选落点，每次移动至少约 1/3 界面；先判断方向是否走得够远再选点；落点为下一段起点，不瞬移。
• 远近变化：向上走一档放大、向下走一档缩小；尺寸过渡时长与本次移动距离挂钩，与动作同步起止。
• 忙碌时不乱跑：存在会话回合（turn/start → turn/end）时飞回右下角、默认档静止；全部空闲后继续随机走动。
• 思考速度：会话进行中约每 12 秒弹出气泡 2 秒，显示界面实时速率「思考速度：Ntok/s」。
• 回窝：双击平滑飞回右下角并缩回第 2 档（不瞬移）。

点击与报账¶

• 单击：五个频率（1046 / 1175 / 1319 / 1568 / 1760 Hz）中随机敲碗音 + 今州主题台词；首点与每第 3 次点击必报余额。
• 报账文案：账号余额 N 星声，今日已用 M 星声（×10 换算）。余额来自 deepseekAccount.getBalance()；今日已用为本机按 assistant/message 的 usage 与官方价目表（谷 / 峰）累计，账本文件 ~/.dsh/dsh-jinhsi-avatar-usage.json，跨天清零。
• 拖动：跟随鼠标，松手后暂停片刻再继续逛。

未登录 DSH 账号时，气泡可说话但不报数。

宿主只读接口¶

插件服务端注册：

GET /dsh-avatar/state

示例响应字段（README 原文）：

{
  "busy": false, "running": 0,
  "cny": 2.83, "stars": 28,
  "todayCny": 0.42, "todayStars": 4,
  "tokens": 1234567, "bonus": 0,
  "source": "deepseekAccount", "apiError": ""
}

busy 在 turn/start 记为运行中，turn/end 清除（另有 20 分钟兜底清理）。todayCny 为本地按回合累计的今日消耗；峰时为北京时间 09:00–12:00、14:00–18:00，周末全天谷价。价目表见仓库 README「计费口径」表格（Flash / Pro，缓存命中、输入、输出分谷峰两档）。

封存舱（vault）¶

插件随包携带加密身份记录（identity/、mind/、memory/ 等文本的密文 vault.enc）。三把钥匙槽任意一把可解：本机指纹（machine）、32 字节钥匙文件 ~/.dsh/jinhsi.key（keyfile）、可选口令（pass）。加密为 AES-256-GCM。

• 封存（本机一次）：重启 DSH 后打开 http://127.0.0.1:<DSH端口>/dsh-avatar/restore，点「封存」。
• 解封（换机 / 重装）：装插件后同地址点「一键解封」，按 machine → keyfile → GitHub 私有库顺序尝试；身份缺失而密文仍在时会写 ~/.dsh/JINSHI-RESTORE-NEEDED.txt 提醒。

角色形象版权归《鸣潮》/ Kuro Games，项目声明仅作个人桌面使用。

安装与启用¶

从 GitHub 安装（资料原文命令）：

dsh plugin add github:ten-feng/dsh-jinhsi-avatar

或写入 profile 的 package.json（dependencies 与 dsh.profile.bundles 两处都要）：

"dependencies": { "dsh-jinhsi-avatar": "github:ten-feng/dsh-jinhsi-avatar" },
"dsh": { "profile": { "bundles": [ ..., "dsh-jinhsi-avatar" ] } }

装完重启 DSH。插件在宿主进程内加载 patch（cordis.patch.yml），安装前建议通读仓库源码与 MIT 许可证，确认接受以当前 DSH 进程权限运行的客户端注入行为。

典型用法¶

1. 按上一节安装并重启，确认窗口右下角出现今汐循环动画。
2. 空闲时观察其在窗口内选点漫游；发起一轮 agent 会话，确认忙碌时回到右下角静止，回合结束后恢复走动。
3. 单击听敲碗音与气泡；需要看账时留意首点或每第三次点击的星声播报。
4. 双击令其平滑回窝到右下角第 2 档尺寸。
5. 若需外部脚本读状态，对本机 DSH 端口请求 GET /dsh-avatar/state。
6. 使用封存舱时，在本机完成「封存」；换机按 README 解封流程操作后重启，并按文档提示与角色对话锚点。

交互汇总：

适用场景与注意¶

适合谁：已在用 DSH 做日常开发或对话、希望主窗口有与会话状态联动的趣味形象，并愿意在点击时查看余额与本地估算今日消耗的用户。《鸣潮》今汐同人向爱好者也会更在意素材来源。

边界（README 已知）：

• 大档相对源素材放大，边缘可能略软。
• 今日已用为本地价目表估算，与平台账单可能有小额差异；只统计插件运行期间的回合。
• 忙碌判定按「有回合在跑」；某会话长时间空跑时该段时间不会漫游。
• 图生视频素材相对官方立绘可能有轻微漂移。

DSH 生态理念是「一切皆插件」；SkillHub 目录为社区站点，与 DeepSeek / 幻方无官方从属关系。

结尾¶

dsh-jinhsi-avatar 把图生视频抠图动画、窗口漫游、会话忙闲与账号读数收进一个 DSH 客户端插件；需要身份文本随包加密分发时，还可走封存舱流程。安装与细节以仓库 README 为准。

• 目录页：https://www.skillhub.cn/plugins/ten-feng/dsh-jinhsi-avatar
• GitHub：https://github.com/ten-feng/dsh-jinhsi-avatar