拔刀斩文件删除 88514205-oss/dsh-ryoshu-slash

天殺拔刀斬 · dsh-ryoshu-slash

良秀「天殺拔刀斬」：带斩击特效的文件删除工具，替代 bot 原本的删除方式，强制审查确认防误删。

灵感来源与致谢

「天殺拔刀斬」的创意与特效灵感来自 RyoshuSlashDeleter（作者 B 站：真夜中のloop，UID 478832252），已获原作者在 B 站评论区的明确授权（"当然可以，随便你"）。本项目在原作趣味删除插件的基础上重构为 DSH 插件形态，并加入强制审查等防误删机制；实现代码为独立编写，仅参考其创意与特效思路。

「良秀（Ryoshu）」及招式「天殺拔刀斬」为 Project Moon《边狱巴士》（Limbus Company）中的角色与 E.G.O 设定，版权归 Project Moon 所有。本项目为其同人致敬作品，与 Project Moon 无隶属关系；相关语音/音效素材仅供学习交流使用，请勿用于商业用途。

删除文件不再只是冷冰冰的 Remove-Item——天殺拔刀斬 把删除变成一场演出：文件从屏幕下方弹入、聚拢摆好姿势，逐刀斩下带刀光与音效，两截分离、变白、淡出。每个 exe 显示它自己的真实图标，语音与 BGM 烘托氛围。

核心原则：强制审查，防 bot 乱删——requireReview 默认开启：即使模型请求 auto/delay 也会被强制转为审查确认，标记后必须用户在界面点「确认出刀」才真删。用户可在设置页关闭此开关。

平台支持

| 平台 | 删除 | 图标/缩略图 | 说明 |
| Windows | ✅ PowerShell Remove-Item | ✅ 真实缩略图（WPF）+ 系统关联图标（System.Drawing） | 完整特效体验 |
| macOS / Linux | ✅ Node 原生 fs.rm 永久删除（不经过回收站） | ⚠️ 内置静态图标（host 无系统图标 API，自动降级） | 核心功能完整，审查/动画/音效不受影响 |

非 Windows 平台无需 PowerShell 或任何 .NET 组件，仅依赖 Node.js 内置能力；删除逻辑与 Windows 同样为永久删除（不经回收站）。

安装

官方 bundle 插件，git 源一行安装（产物已入库，无需构建）：

dsh plugin --profile web add github:88514205-oss/dsh-ryoshu-slash#main

--profile web 表示安装到 web 配置档；headless 等其他档改成对应 profile 名即可。

前提：安装 pnpm

dsh plugin 是 DSH 原生命令，本质是 pnpm 转发器（在 profile 目录执行 pnpm add 并自动把声明了 dsh.bundle 的包加入层栈）。需要先安装 pnpm 并确保在 PATH 中：

npm install -g pnpm

如果 dsh plugin 报 pnpm not found on PATH，就是 pnpm 没装好。git 源插件在 pnpm ≥10 下若被阻止构建，按提示在 profile 的 pnpm-workspace.yaml 中 allowBuilds 放行即可。

装完重启 web

bundle 层栈在 boot 合成，装完必须重启 web：

dsh web

重启后：
- 设置 → 插件 → 可配置 tab 出现「天殺拔刀斬」卡片
- 设置侧边栏出现「天殺拔刀斬」配置分组
- 对话中删除文件自动走 ryoshu_slash（带斩击特效）

其他安装方式

本地开发安装（在插件仓库目录内）
cd dsh-ryoshu-slash && dsh plugin --profile web add .

查看已装插件
dsh plugin --profile web list

能力面

Tools

| 工具 | 说明 |
| ryoshu_slash | 良秀「天殺拔刀斬」：斩击并永久删除文件/文件夹。强制审查开启时（默认）一律 review——界面确认才删，模型无法用 auto 绕过；用户关闭后可 auto/delay。 |

Browser UI

| 部件 | 说明 |
| 斩击特效层 | 全屏动画：文件弹入→网格聚拢→逐刀斩→刀光→音效→变白→淡出 |
| 审查确认面板 | review 模式下弹出的确认/取消对话框 |
| 工具卡片 | 对话流中 ryoshu_slash 调用的状态卡片 |
| 设置分组 | 文件排列 / 斩杀方式 / 每行文件数 / 音量 / 强制审查开关（全部持久化） |
| 插件管理卡片 | 设置 → 插件列表中的插件介绍卡片 |

行为细节

- 永久删除：Windows 用 Remove-Item -Force -Recurse；macOS/Linux 用 Node fs.rm({ recursive, force })——均不经过回收站。
- 强制审查：requireReview 默认 true——无视模型传入的 mode，一律标记→界面确认→才删；用户可在设置页关闭。
- exe 真实图标 / 图片缩略图（仅 Windows）：运行时经 PowerShell ExtractAssociatedIcon（系统图标）与 WPF BitmapDecoder（图片缩略图，最长边 96px）提取，HTTP 路由返回 PNG，按路径缓存；其他平台自动使用内置静态图标。
- 语音/BGM：标记时播放一句语音（文件名含 拇指/食指/中指/环指 触发对应语音），BGM 淡入，斩完淡出。
- 多文件布局：网格矩阵排列，多行自动缩小图标防重叠（每行文件数可配置）。

配置

设置 → 天殺拔刀斬（持久化到 DSH settings，刷新/重启不丢）：

| 配置项 | 默认 | 说明 |
| 文件排列 | 堆叠(抽卡) | 网格堆叠 / 排列一排 |
| 斩杀方式 | 逐个砍 | 一起砍 / 逐个砍 |
| 每行最多文件数 | 6 | 多文件分行的列数上限 |
| 音效音量 | 1 | 语音/音效/BGM 音量 |
| 强制审查（防 bot 乱删） | 开 | 关闭后 auto/delay 才生效 |
| 接管默认删除方式 | 开 | 开启后 bot 删除文件一律走天杀；大型项目开发可关闭，恢复默认删除方式提效 |

插件管理

已装插件用 plugin-registry 的薄控制台管理（浏览器面板）：管理 profile 插件安装态（bundle 层栈 + insert 行 + 启停），无需手改配置。安装：

dsh plugin --profile web add github:vlln/plugin-registry#main&path:/packages/plugin/console

开发

node scripts/build-client.mjs # 构建 client bundle（__ModuleLoader__.load 包装）
node scripts/build-client.mjs --check # 门禁：client.js 新鲜度
node scripts/gates/run.mjs # 完整门禁（10+ 项）

- index.mjs — Node half：工具注册、webServer 资源/API 路由、settings 注册、systemPrompt 引导
- client/src.js — Client half 源码（React + canvas 动画，HTTP fetch 通信）
- client/client.js — 构建产物（勿手改，由 build-client.mjs 生成）
- assets/ — 图标 / 音效 / 语音 / BGM
- scripts/ — 构建 / 门禁 / 同步脚本

改 Node half 需重启 web（ESM 缓存）；改 client 源码重建 + 刷新页面即可。