# TRSS Yunzai Plugin

**Repository Path**: fox-glaze/TRSS-Plugin

## Basic Information

- **Project Name**: TRSS Yunzai Plugin
- **Description**: TRSS Yunzai Plugin 云崽机器人插件
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: main
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 1
- **Forks**: 7
- **Created**: 2024-09-15
- **Last Updated**: 2026-09-29

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# TRSS Yunzai Plugin

云崽机器人插件（自用 fork 版）。

> 本版本为自用精简分支，不跟随原库更新，需要完整功能请用
> [原库](https://gitee.com/TimeRainStarSky/TRSS-Plugin)。相比原库去掉了网盘等用不到的功能，
> 并补充了文件取用、文件解压等常用能力。

## 安装

```bash
git clone --depth 1 https://gitee.com/fox-glaze/TRSS-Plugin plugins/TRSS-Plugin
pnpm i
```

## 指令

| 功能 | 指令 | 权限 |
| --- | --- | --- |
| 系统信息 | 系统信息 / 系统信息图片 / 系统测试 | 所有人 |
| 文件操作 | 文件查看 / 文件上传 / 文件下载 / 文件解压 + `路径` | 主人 |
| 文件取用 | 取文件 / 取包 / look一下 + `路径`，hp + `文件`，ly + `命令`，hm + `表达式`，开启私发 / 关闭私发 | 主人 |
| 代码高亮 | sc + `文件` / `URL` | 主人 |
| 远程命令 | rc + `Shell 命令`，rj + `JavaScript`，dm / mm / fm + `表达式`（前加 p 以图片显示输出） | 主人 |

### 文件相关说明

- `文件查看 <路径>` / `look一下 <路径>`：列出目录内容
- `文件上传 <路径>`：把服务器上的文件传到会话（群里会给下载链接）
- `文件下载 <路径>`（发指令后按提示发文件）：把聊天里的文件存到服务器
- `文件解压 <压缩包路径> [新文件夹名]`：解压到与压缩包同名的目录；路径后空一格再写名字可自定义目录名。
  路径本身含空格时先按整条路径判断，不会误拆。支持 zip、tar 系、7z、rar，其中 7z / rar 需要系统装有
  `7z` 或 `unar` / `unrar`；失败会说明原因并清掉半成品目录
- `取包 <目录>`：把目录压缩成 zip 发出来，临时包发完即删
- `开启私发` / `关闭私发`：切换取文件、取包的发送目标是当前会话还是主人私聊
- `hp <文件>`：直接输出文本文件内容
- 上面的路径参数都**支持通配符**（如 `取文件 plugins/trss*`），命中多个会列出来让你回序号选一个
- `ly <命令>`：执行 shell 命令并把输出（含 ANSI 颜色）渲染成图片
- `hm <表达式>`：求值后发送结果，`hmp` 会把过程渲染成图片

`ly` / `hm` 属于高危能力（可执行命令与求值），仅在需要时给主人使用。

## 常见问题

- `ModuleNotFoundError: No module named 'xxx'`：没有正确执行 `poetry install`
- `已杀死` / `Signal 9` / `MemoryError`：发 `清理内存`，或给机器加 SWAP
- `Git Bash` 下 `poetry install` 失败：改用 `命令提示符` 或 `Windows PowerShell`
- `error: Microsoft Visual C++ 14.0 or greater is required.`：安装
  [Microsoft C++ 生成工具](https://visualstudio.microsoft.com/zh-hans/visual-cpp-build-tools)
- `'bash' 不是内部或外部命令` / `无法将“sh”项识别为 cmdlet`：换 `Git Bash` 执行

## 目录结构

```
Apps/      指令入口，一个文件一类功能，导出与文件名同名的类
Model/     业务逻辑（文件选择与匹配、压缩包解压、状态、配置）
Resources/ 渲染模板（Code、SourceCode…）
Picture/   图片素材
index.js   注册全局工具（Bot.exec / Bot.download / Bot.glob…）并加载 Apps
```

渲染模板通过 `puppeteer.screenshot(名称, { tplFile, htmlDir, ... })` 调用，
模板变量用 `{{变量}}`，原始 HTML 用 `{{@变量}}`。