dsh-plugin-waves

XutheringWavesUID 的 DeepSeek Harness 版本 · v0.0.2

这是 XutheringWavesUID 的 dsh 版：同一套鸣潮查询、 面板、伤害计算与评分、排行，由 DeepSeek Harness 提供原生渲染能力。

已内置 RoverSign（签到）与 ScoreEcho（声骸识图评分）。

图文结果直接以 HTML 卡片呈现；卡片里的角色可以点击，其余命令、算法、素材、模板全部与 XutheringWavesUID 一致。

为模型提供了原生数据接口，模型完全可读用户数据。可自行搭配其他工具使用，比如让AI将数据自行填入其他排轴/伤害计算等网页工具（需对应工具支持）。

开新会话首次发送指令将同时发送你好，此为dsh目前固有限制，否则无法显示指令结果。

用例

TODO

• 修修补补，完成迁移
• 补充游戏常识库：挑战规则、矩阵挑战的模板声骸配置、模态规则等（缺少尝试胡言乱语为已知问题，可以通过鼓励搜索解决，但不如固化常识知识）
• 补充库街区wiki文字攻略接口，注入常规配队知识
• 尝试寻找文字轴数据源
• 提供更多接口工具，便于在此之上自行搭建其他项目

本仓库仅迁移 XutheringWavesUID 内置方法和接口，以及处理通用知识，使用本插件数据接口继续开发应新建插件以实现功能解耦。

安装

Linux / macOS：

mkdir -p ~/dsh-plugins && cd ~/dsh-plugins         # 放哪都行, 换成你自己的目录
git clone https://github.com/Loping151/dsh-plugin-waves.git && cd dsh-plugin-waves
dsh plugin --profile web add file:.
dsh web

Windows（PowerShell）：

mkdir -Force ~\dsh-plugins; cd ~\dsh-plugins
git clone https://github.com/Loping151/dsh-plugin-waves.git; cd dsh-plugin-waves
dsh plugin --profile web add file:.
dsh web

第一次启动时插件会自己把环境装好（一般来说）：建虚拟环境、装依赖、拉取三个上游插件、生成数据目录， 几分钟后服务就绪，不需要手动跑任何脚本。之后在对话里绑定账号即可用： ww登录 保存登录态，与库街区登录冲突，同时登录办法需自行查找，ww绑定<特征码> 需要自行提供有效库街区token才可使用，原理为：街区点击他人主页查看信息，故至少需要一个登录态。

安装若卡住或失败，直接问 dsh 里的模型——插件会把完整排障步骤转交给它。

缺什么会尽量自己装：uv、Python 3.10–3.13（uv 拉官方构建，计算内核按版本分发）、 以及 git（Linux 走发行版包管理器，Windows 走 winget/choco/scoop）。装不上会说明要手工补什么，也可以直接问 dsh 里的模型。

./install.sh          # 等价于自动安装

# 从聊天机器人版迁过来: 指向那边 gsuid_core 的 data 目录,
# 会迁入绑定关系、登录态、WavesToken、面板与抽卡记录、自定义素材,
# 并把归属改写到本地使用者名下(源库只读取快照, 不会改动)
./install.sh --src ~/gsuid_core/data

powershell -ExecutionPolicy Bypass -File .\install.ps1
powershell -ExecutionPolicy Bypass -File .\install.ps1 -Src C:\gsuid_core\data

用法

两种用法：

• /ww 深塔、/ww 椿面板——斜杠命令，host 直接执行，不经过模型，最快。
• 直接说话——「看下我的深塔」「椿的面板怎么样」，模型理解后调用工具。 注意不带斜杠时哪怕原样打 ww深塔 也会先经过模型，慢一些但同样能用。

ww帮助 出全量命令图，本机的运维命令并在同一张图里。下表命令都可以放在 /ww 后面用：

只有单人使用，没有用户身份概念：签到覆盖全部已登录账号、不筛活跃。 群成员管理、群排行、公告订阅、订阅签到结果、联系主人这类只在群聊里成立的命令不注册。 内置 HTTP 接口见 docs/api.md。

带截图的命令（ww评分、ww分析）走模型时直接把图和话一起发即可：图片不会进模型 （DeepSeek 文本路由不吃图），host 会暂存并在模型调用工具时随命令转交服务。 模型还可以用 waves_panel 工具按自定义数据（跨角色借声骸、手填词条）渲一张假设面板—— 只在本地渲染，不写用户数据、不上传总排行。

图片卡（评分/面板等）会经本地轻量 OCR（RapidOCR）把文字抽进给模型的摘要， 纯文本模型也能读到卡上数值；设置里"图片文字摘要（OCR）"可关。

内置游戏知识库（service/knowledge/）：库洛 wiki 全站文本按小节整理（图鉴/攻略/百科等 5000+ 节，图片以原 URL 内嵌）+ 人工补充的机制常识（挑战周期、换期语义、配队细则）。 用户话里首次提到角色名/机制词时自动附带对应条目（每会话每条只注入一次），模型也可主动检索。 设置里"内置知识增强（测试）"可关掉自动注入，主动检索不受影响。

Token

伤害计算、评分与排行都要 WavesToken，评分与排行是同一个 token，只填一处： service/data/XutheringWavesUID/config.json 的 WavesToken。

token 的申请方式与使用条件与本体一致，请阅读：

• XutheringWavesUID 本体仓库——申请入口与条件都在它的 README
• 0428 声明——本插件相关的重要声明

没有 token 时查询类功能照常可用，适合单人使用。

更新

service/plugins/ 是三个上游仓库的原样克隆，本地差异全部写在运行时里，所以上游更新不会冲突。 在对话里发 ww更新插件，完成后 ww重启服务；或者：

cd service && .venv/bin/python tools/update_plugins.py

默认从 GitHub 拉；连不上时自动改用 cnb.cool/gscore-mirror，反过来镜像不通也会切回 GitHub（已有仓库会把 origin 一并改掉）。 只有网络类错误才切源，仓库不存在、认证失败、无法快进这些会照原样报出来。

上游若用到了本运行时还没提供的接口，不会静默失败：更新命令会把缺失的模块和适配步骤 直接交给 dsh 里的模型，让它改好运行时再让你重启。

配置

这些也可以在 dsh 的设置 → 鸣潮里直接改，共 60 余项（只留下本地场景用得上的），敏感项显示为掩码。 数据目录首次运行自动生成，不需要预先准备。

结构

assets/          README 用例图
docs/            人读文档（内置 HTTP 接口）
lib/             dsh 侧：斜杠命令、模型工具、反代 /waves-api、托管服务、浏览器卡片
service/ai/      给模型读的数据/脚本指南
service/knowledge/ 内置游戏知识库（wiki 文本 + 人工补充，AI 检索与自动注入）
service/rover/   运行时：命令分发、数据库、配置、调度、渲染、接口
service/plugins/ 上游插件原样克隆（勿手改，改动请写进 hooks）
service/tools/   安装、迁移、更新与自检脚本

本地与上游的全部差异集中在 service/rover/hooks.py。

自检

cd service
.venv/bin/python tools/regression.py                    # 批量跑只读命令
.venv/bin/python tools/verify_actions.py                # 校验卡片点击与角色对应
.venv/bin/python tools/verify_card.py                   # 真实浏览器验证渲染与点击
.venv/bin/python tools/update_plugins.py --check-only    # 上游更新后的兼容性自检

许可

GPL-3.0，与上游 XutheringWavesUID 一致。 service/plugins/ 安装时克隆的其它上游仓库遵循各自许可。使用前请阅读上游说明与声明。