# JS-Slash-Runner

**Repository Path**: CAP_LEE/JS-Slash-Runner

## Basic Information

- **Project Name**: JS-Slash-Runner
- **Description**: No description available
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: main
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-01-22
- **Last Updated**: 2026-01-22

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# Tavern-Helper

> [!Warning]
> 执行自定义 JavaScript 代码, 可能会带来安全风险:
>
> - 恶意脚本可能会窃取你的 API 密钥、聊天记录等敏感信息; 修改或破坏你的 SillyTavern 设置
> - 某些脚本可能会执行危险操作, 如发送未经授权的请求
>
> 请在执行任何脚本前:
>
> 1. 仔细检查脚本内容, 确保其来源可信
> 2. 理解脚本的功能和可能的影响
> 3. 如有疑问, 请勿执行来源不明的脚本
>
> 我们不为第三方脚本造成的任何损失负责.

此扩展允许你在 SillyTavern 中运行外部 JavaScript 代码

由于 SillyTavern 默认不支持直接执行 JavaScript 代码, 这个扩展通过使用 iframe 来隔离和执行脚本, 从而让你在某些受限的上下文中运行外部脚本.

## 文档

- [文档](https://n0vi028.github.io/JS-Slash-Runner-Doc/)

## 参与贡献提示

### 项目结构

基于酒馆 UI 插件的项目结构要求, 本项目直接打包源代码在 `dist/` 文件夹中并随仓库上传, 而这会让开发时经常出现分支冲突.

为了解决这一点, 仓库在 `.gitattribute` 中设置了对于 `dist/` 文件夹中的冲突总是使用当前版本. 这不会有什么问题: 在上传后, ci 会将 `dist/` 文件夹重新打包成最新版本, 因而你上传的 `dist/` 文件夹内容如何无关紧要.

为了启用这个功能, 请执行一次以下命令:

```bash
git config --global merge.ours.driver true
```

### 手动编译

你可以参考 [参与前端插件开发的 VSCode 环境配置](https://sillytavern-stage-girls-dog.readthedocs.io/tool_and_experience/js_slash_runner/index.html) 来得到 VSCode 上更详细的配置和使用教程.

你需要先安装有 node 22+ 和 pnpm. 如果已经安装有 node 22+, 则 pnpm 可以按以下步骤安装:

```bash
npm install -g pnpm
```

然后, 用 pnpm 安装本项目的所有依赖:

```bash
pnpm install
```

之后你就可以对本项目进行编译:

```bash
pnpm build
```

或者, 你可以用 `pnpm watch` 来持续监听代码变动. 这样只需刷新酒馆网页, 酒馆就会使用最新的插件代码.

## 许可证

- [Aladdin](LICENSE)

## 参考

见于[文档](https://n0vi028.github.io/JS-Slash-Runner-Doc/)对应部分