d-ouyang/dsh-plugin-ascension

🇨🇳 简体中文 | 🇬🇧 English

dsh-plugin-ascension

一个悬浮在 dsh web 界面里的《仙逆》王林修炼伙伴。它实时监控 LLM 会话状态并驱动动画（思考 = 掐诀推演，工具调用 = 施展神通，回复 = 凝神书字，完成 = 突破飞跃，失败 = 反噬受伤），并且随你的使用一路修炼升境（凝气 → 筑基 → 结丹 → 元婴 → 化神 → 婴变 → 问鼎），境界越高皮肤越华丽。

状态监控、状态机、亲和力/修为经济三个纯逻辑模块，移植并重新主题化自 @linxin666/dsh-pet（MIT）。

安装

# 方式一（推荐）：从 npm 安装
dsh plugin --profile web add dsh-plugin-ascension

# 方式二：从 GitHub 安装
dsh plugin --profile web add github:d-ouyang/dsh-plugin-ascension

# 本地开发：dsh plugin --profile web add ./dsh-plugin-ascension

安装后重启 web 服务（:3080）。

功能

状态监控（宠物把 LLM 正在做什么"演"出来）

宿主订阅官方会话事件流（ctx.on('session/event')），映射为 7 个相位、驱动 9 条动画轨道：

相位	触发	气泡文案	动画轨道	雪碧图行号	帧
idle	停止 / 无会话	停止修炼	stand	6	雪碧图（站姿占位）
waiting	开始/入定/等待输入/被阻断	凝神入定 · 静待机缘	meditation	—	meditation.webp（✅ 真实）
thinking	LLM 推理	掐诀推演 · 参悟神通结果	running	7	雪碧图（✅ 真实）
tool	工具调用	正在施展神通 · 还有 N 道神通未了	running	7	雪碧图（占位）
review	流式回复	凝神书字 · 整理心得	running	8	雪碧图（占位）
done	一轮完成	圆满出关！	running-right	—	dragon.webp（✅ 真实，雷龙庆祝）
failed	工具报错 / 中断 / token 耗尽	神通反噬 · 心魔反噬 · 灵力枯竭	stand	6	雪碧图（站姿占位）

• 相位持续期间动画乒乓循环（0→1→…→n→…→1→0）
• done 庆祝窗口：普通完成 3 秒、突破境界 6 秒（celebrateMs，由 onStatus 的 opts 传入）

修为与境界

• 每完成一轮对话 +1（修炼）；点击宠物 +1（论道，3 分钟冷却）；喂丹药 +1（30 秒冷却）
• 7 重境界（凝气 → 筑基 → 结丹 → 元婴 → 化神 → 婴变 → 问鼎），阈值在 ascension-core.js 的 REALMS 里可配
• 升境触发突破动画并自动切换到下一境皮肤；缺皮肤的境回退到上一境皮肤

交互与效果

交互	效果
点击宠物	论道（+修为，上方或左侧弹出反馈气泡）
拖拽宠物	移动位置（持久化到配置）
悬停宠物	古风面板：境界徽章 + 修为进度条 + 丹药/隐藏按钮
点击隐藏	王林缩入天逆珠（右下角）；珠子循环播放金木水火土旋转渐变
点击珠子	王林从珠中重新现身（先播动画，配置异步同步）

• 悬停时气泡移到宠物左侧，不与面板重叠
• 所有过渡乐观渲染，不等待 API 返回

设置分区（设置 → 渡劫飞升）

底部带保存 / 取消的整宽表单（保存时生效）：

• 启动：总开关，关闭后停止监控与动画
• 隐藏宠物：显示/隐藏宠物本体
• 称呼、皮肤、尺寸（60–400 px）、距右侧 / 距底部

工具

在对话里问："王林现在什么境界？" → ascension_status 返回境界 / 修为 / 距下一境 / 论道与丹药次数 / 当前动画。

制作皮肤（重要）

一套皮肤 = 一个目录（pet.json + 一张雪碧图），固定 9 行动作顺序：

行	动作	帧	王林姿态
0	idle	6	垂手站立（占位）
1	sword	4	御剑
2	running-left	8	御剑向左
3	waving	4	抱拳行礼
4	jumping	5	突破飞跃
5	failed	8	受伤姿态（占位）
6	stand	6	静立凝神（idle/failed 站姿）
7	running	6	掐诀
8	review	6	以气书字

• 格子尺寸：当前皮肤为 768×832（4× 高清），由 pet.json 的 cell 字段声明——任意尺寸皆可
• 推荐流程：用即梦生成一段循环动作视频，逐帧拆分（同一视频拆帧能保证人物位置稳定），导出逐帧 PNG
• 抠图：纯色背景用色度键 + 补洞 + 边缘羽化（保留灵光特效、去灰边）；银白发丝自动提亮以消除灰色闪烁
• 打包（需要 sharp）：

  cd dsh-plugin-ascension
  pnpm install
  node skin-pack.js <skin-id> --name "王林·凝气期"
  

  → 输出 assets/<id>/（spritesheet.webp + pet.json + previews/）
• 免改代码热插拔：把打包好的皮肤目录拷到 ~/.dsh/ascension/skins/<id>/（用户目录皮肤优先）
• 境界 ↔ 皮肤 id：wang-lin-1..wang-lin-7 对应 7 重境界

数据与 API

• 持久化：~/.dsh/ascension/（state.json / settings.json）
• RPC：/api/ascension/{state, interact, set-enabled, set-visible, set-config, set-skin}、/api/ascension/skins/<id>/*（皮肤资源）、/api/ascension/tiannizhu/*（天逆珠动画）

开发

dsh-plugin-ascension/
├── index.js           # 宿主：会话事件订阅 + 修为服务 + RPC + 皮肤注册表
├── ascension-core.js  # 纯逻辑：境界 / 修为 / 事件投影 / 状态机
├── client/client.js   # 客户端：设置分区 + 悬浮宠物 + 天逆珠（手写 bundle）
├── skin-pack.js       # 皮肤打包器：帧 → 雪碧图 + pet.json + previews
├── assets/            # 内置皮肤（wang-lin-1）+ 天逆珠动画
└── cordis.patch.yml / package.json

注：npm 包与 git 仓库只收录运行时必需资源。皮肤源帧（skins/）、天逆珠源视频与源 PNG 属制作素材，未纳入分发。

致谢

状态监控 / 状态机 / 修为经济移植自 @linxin666/dsh-pet（MIT License）。

许可

MIT © ouyangding