前言¶
在 DeepSeek Harness (DSH) 的开发中，文件删除通常是后台静默执行的命令，缺乏反馈且容易因模型误判导致误删。良秀「天殺拔刀斬」将删除操作转化为一个带审查机制的视觉事件，通过强制确认和全屏特效，在保证文件永久删除的同时提供防误删的安全保障。
插件介绍¶
本插件属于 DSH 生态的「趣味换装」类别，旨在为文件管理操作增加趣味性与安全性。
- 名称：dsh-ryoshu-slash
- 所有者：88514205-oss
- 许可证：MIT
- 核心定位：带斩击特效的文件删除工具，替代 bot 原本的删除方式，强制审查防误删。
安装步骤¶
安装该插件需要执行 DSH 原生命令，并确保环境依赖满足要求。
官方安装¶
通过 bundle 层栈安装，无需本地构建：
dsh plugin --profile web add github:88514205-oss/dsh-ryoshu-slash#main
前提条件¶
DSH 的 plugin 命令本质是 pnpm 转发器。安装前需确保 pnpm 已安装在 PATH 中：
npm install -g pnpm
生效方式¶
安装完成后必须重启 web 进程才能生效：
dsh web
核心功能¶
该插件在 Windows 平台提供完整的特效体验，并在 macOS/Linux 平台提供核心删除功能。
删除机制¶
- 永久删除：不经过回收站。Windows 使用 PowerShell
Remove-Item，macOS/Linux 使用 Node 原生fs.rm。 - 强制审查：默认开启。无论模型传入
auto或delay，都会强制转为审查确认模式，必须在界面点击「确认出刀」后才会执行删除。
视觉与交互特效¶
- 全屏斩击动画：文件从屏幕下方弹入、聚拢成网格、逐刀斩下、刀光闪烁、音效配合、变白淡出。
- 真实图标支持：仅 Windows 平台。支持显示 exe 的真实图标和图片缩略图（最长边 96px），通过 HTTP 路由返回 PNG 缓存。
- 语音触发：支持拇指/食指/中指/环指四种语音触发。
- 多文件布局：支持网格矩阵排列，可配置每行文件数。
使用方式¶
安装并重启 web 后，在对话中调用工具 ryoshu_slash 即可使用。
配置项¶
设置页面提供以下持久化配置：
| 配置项 | 默认值 | 说明 |
|---|---|---|
| 文件排列 | 堆叠(抽卡) | 网格堆叠 / 排列一排 |
| 斩杀方式 | 逐个砍 | 一起砍 / 逐个砍 |
| 每行最多文件数 | 6 | 多文件分行的列数上限 |
| 音效音量 | 1 | 语音/音效/BGM 音量 |
| 强制审查 | 开 | 关闭后 auto/delay 才生效 |
| 接管默认删除方式 | 开 | 开启后 bot 删除文件一律走天杀 |
平台差异¶
- Windows：支持完整的特效、真实系统图标、图片缩略图。
- macOS / Linux：核心功能完整（删除、审查、动画、音效），但无系统图标 API，自动降级为内置静态图标。
注意事项¶
- 永久删除文件，不经过回收站。
- 需要 pnpm ≥10，安装过程可能需要允许构建（如遇到构建错误，需在 profile 的
pnpm-workspace.yaml中 allowBuilds 放行）。 - 许可证为 MIT，为同人作品，仅供学习交流。
- 安装后必须重启 web 才能生效。
