Skip to content

Commit 19a3cd3

Browse files
actions-useractions-user
committed
🔄 Sync from main repo - 2026-01-30 02:02:36
1 parent 46aae49 commit 19a3cd3

File tree

3 files changed

+111
-93
lines changed

3 files changed

+111
-93
lines changed

‎README.md‎

Lines changed: 55 additions & 46 deletions
Original file line numberDiff line numberDiff line change
@@ -23,13 +23,14 @@
2323

2424
## 简介
2525

26-
TrollScript 是一款利用 TrollStore 特权的 iOS JavaScript 脚本执行器。通过内置的 JavaScript 运行时，你可以编写和执行各种自动化脚本，访问系统级 API，实现普通 App 无法完成的功能。
26+
TrollScript 是一款利用 TrollStore 特权的 iOS JavaScript 脚本执行器。通过内置的 JavaScript 运行时，你可以编写和执行各种自动化脚本，访问系统级
27+
API，实现普通 App 无法完成的功能。
2728

2829
## 功能特性
2930

3031
- **脚本管理** - 创建、编辑、删除、导入导出脚本
3132
- **语法高亮** - 内置代码编辑器，支持 JavaScript 语法高亮
32-
- **丰富的 API** - 15+ 原生模块，覆盖网络、位置、通知、媒体等功能
33+
- **丰富的 API** - 15+ 原生模块，覆盖网络、位置、通知等功能
3334
- **通知触发** - 监听指定 App 通知，自动执行脚本
3435
- **iCloud 同步** - 支持 CloudKit 数据库和 iCloud Drive 两种同步模式
3536
- **快捷指令** - 完整 App Intents 支持，可在快捷指令中运行脚本
@@ -42,22 +43,6 @@ TrollScript 是一款利用 TrollStore 特权的 iOS JavaScript 脚本执行器
4243
- iOS 16.0 或更高版本
4344
- 已安装 [TrollStore](https://github.com/opa334/TrollStore)
4445

45-
## 安装方式
46-
47-
### 方式一：直接下载
48-
49-
1. 前往 [Releases](https://github.com/dompling/TrollScript-Release/releases/latest) 页面
50-
2. 下载最新的 `.tipa` 文件
51-
3. 在 TrollStore 中安装
52-
53-
### 方式二：URL Scheme 安装
54-
55-
如果已安装 TrollStore，可以点击以下链接直接安装:
56-
57-
```
58-
apple-magnifier://install?url=https://github.com/dompling/TrollScript-Release/releases/latest/download/TrollScript_latest.tipa
59-
```
60-
6146
## JavaScript API
6247

6348
TrollScript 内置丰富的原生模块，[查看完整中文 API 文档](API.md) [查看完整 English API 文档](API.en.md)。
@@ -66,47 +51,70 @@ TrollScript 内置丰富的原生模块，[查看完整中文 API 文档](API.md
6651
6752
## 触发器
6853

69-
| 类型 | 说明 |
70-
|------|---------------------------------------------------------------------------|
71-
| 定时任务 | Cron 定时执行脚本 |
72-
| 剪切板 | 复制了特定的文字内容之后触发脚本 |
73-
| 文件监控 | 文件变化的时候触发 |
54+
| 类型 | 说明 |
55+
|------|--------------------------------------------|
56+
| 定时任务 | Cron 定时执行脚本 |
57+
| 剪切板 | 复制了特定的文字内容之后触发脚本 |
58+
| 文件监控 | 文件变化的时候触发 |
7459
| 通知监控 | APP 发送通知的时候，触发脚本（兼容性未知 作者的手机系统：IOS 16.3.1） |
7560

7661
> 脚本同时触发，可能会发生崩溃或者其他未知问题，请注意使用。可以反馈修复。
7762
7863
### 全局参数
7964

8065
1. **$triggerInput**
81-
- 通知监控
82-
```
83-
interface $triggerInput {
66+
- 通知监控参数
67+
68+
```typescript
69+
interface $triggerInput {
8470
type: "notification"; // 触发类型
8571
bundleId: string; // 来源 App Bundle ID
8672
title: string; // 通知标题
8773
message: string; // 通知内容
8874
timestamp: number; // 时间戳 (毫秒)
89-
}
75+
}
9076
```
9177

92-
## 高级功能
78+
2. **$args**
79+
- 快捷指令参数
9380

94-
### iCloud 同步
81+
```typescript
82+
interface $args {
83+
text?: string // 输入内容
84+
json?: string // 输入JSON
85+
}
86+
```
9587

96-
TrollScript 支持两种 iCloud 同步模式：
88+
3. **脚本返回值**
89+
- 控制台显示返回值
90+
- 返回给快捷指令
91+
```javascript
92+
const test = "123"
93+
return test;
94+
```
95+
96+
## 安装方式
97+
98+
### 方式一：直接下载
9799

98-
1. **文件目录模式**（推荐）
99-
- 脚本存储在 `iCloud Drive/TrollScript/Scripts/` 目录
100-
- 可在「文件」App 中直接查看和编辑
101-
- 支持 `.trollscript` 和 `.js` 格式
100+
1. 前往 [Releases](https://github.com/dompling/TrollScript-Release/releases/latest) 页面
101+
2. 下载最新的 `.tipa` 文件
102+
3. 在 TrollStore 中安装
102103

103-
2. **数据库模式**
104-
- 使用 CloudKit + CoreData 同步
105-
- 自动后台同步，无需手动操作
104+
### 方式二：URL Scheme 安装
105+
106+
如果已安装 TrollStore，可以点击以下链接直接安装:
107+
108+
```
109+
apple-magnifier://install?url=https://github.com/dompling/TrollScript-Release/releases/latest/download/TrollScript_latest.tipa
110+
```
111+
112+
## 高级功能
106113

107114
### 脚本导入/导出
108115

109116
支持两种导出格式：
117+
110118
- `.trollscript` - 完整格式，包含代码和元数据
111119
- `.js` - 纯 JavaScript 代码
112120

@@ -138,11 +146,11 @@ trollscript://install?url=https://example.com/script.js
138146
trollscript://store?id=脚本ID&name=脚本名称&url=https://example.com/script.js
139147
```
140148

141-
| 参数 | 说明 |
142-
|------|------|
143-
| `id` | 脚本唯一标识（用于版本追踪） |
144-
| `name` | 脚本显示名称 |
145-
| `url` | 脚本下载地址 |
149+
| 参数 | 说明 |
150+
|--------|----------------|
151+
| `id` | 脚本唯一标识（用于版本追踪） |
152+
| `name` | 脚本显示名称 |
153+
| `url` | 脚本下载地址 |
146154

147155
#### 运行脚本
148156

@@ -177,10 +185,10 @@ trollscript://open
177185
trollscript://subscribe?name=订阅源名称&url=https://example.com/store.json
178186
```
179187

180-
| 参数 | 说明 |
181-
|------|------|
182-
| `name` | 订阅源显示名称 |
183-
| `url` | 订阅源 JSON 地址 |
188+
| 参数 | 说明 |
189+
|--------|-------------|
190+
| `name` | 订阅源显示名称 |
191+
| `url` | 订阅源 JSON 地址 |
184192

185193
### NPM 支持
186194

@@ -193,6 +201,7 @@ npm install --save-dev @dompling/trollscript-types
193201
```
194202

195203
## 截图
204+
196205
<p align="center">
197206
<img src="images/2781768272086_.pic_hd-portrait.png" width="35%" alt="Screenshot 3">
198207
<img src="images/2791768272087_.pic_hd-portrait.png" width="35%" alt="Screenshot 4">

‎npm/package.json‎

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -1,6 +1,6 @@
11
{
22
"name": "@dompling/trollscript-types",
3-
"version": "1.0.54",
3+
"version": "1.0.55",
44
"description": "TypeScript definitions for TrollScript",
55
"main": "",
66
"types": "index.d.ts",

‎templates/PUBLIC_README.md‎

Lines changed: 55 additions & 46 deletions
Original file line numberDiff line numberDiff line change
@@ -23,13 +23,14 @@
2323

2424
## 简介
2525

26-
TrollScript 是一款利用 TrollStore 特权的 iOS JavaScript 脚本执行器。通过内置的 JavaScript 运行时，你可以编写和执行各种自动化脚本，访问系统级 API，实现普通 App 无法完成的功能。
26+
TrollScript 是一款利用 TrollStore 特权的 iOS JavaScript 脚本执行器。通过内置的 JavaScript 运行时，你可以编写和执行各种自动化脚本，访问系统级
27+
API，实现普通 App 无法完成的功能。
2728

2829
## 功能特性
2930

3031
- **脚本管理** - 创建、编辑、删除、导入导出脚本
3132
- **语法高亮** - 内置代码编辑器，支持 JavaScript 语法高亮
32-
- **丰富的 API** - 15+ 原生模块，覆盖网络、位置、通知、媒体等功能
33+
- **丰富的 API** - 15+ 原生模块，覆盖网络、位置、通知等功能
3334
- **通知触发** - 监听指定 App 通知，自动执行脚本
3435
- **iCloud 同步** - 支持 CloudKit 数据库和 iCloud Drive 两种同步模式
3536
- **快捷指令** - 完整 App Intents 支持，可在快捷指令中运行脚本
@@ -42,22 +43,6 @@ TrollScript 是一款利用 TrollStore 特权的 iOS JavaScript 脚本执行器
4243
- iOS 16.0 或更高版本
4344
- 已安装 [TrollStore](https://github.com/opa334/TrollStore)
4445

45-
## 安装方式
46-
47-
### 方式一：直接下载
48-
49-
1. 前往 [Releases](https://github.com/dompling/TrollScript-Release/releases/latest) 页面
50-
2. 下载最新的 `.tipa` 文件
51-
3. 在 TrollStore 中安装
52-
53-
### 方式二：URL Scheme 安装
54-
55-
如果已安装 TrollStore，可以点击以下链接直接安装:
56-
57-
```
58-
apple-magnifier://install?url=https://github.com/dompling/TrollScript-Release/releases/latest/download/TrollScript_latest.tipa
59-
```
60-
6146
## JavaScript API
6247

6348
TrollScript 内置丰富的原生模块，[查看完整中文 API 文档](API.md) [查看完整 English API 文档](API.en.md)。
@@ -66,47 +51,70 @@ TrollScript 内置丰富的原生模块，[查看完整中文 API 文档](API.md
6651
6752
## 触发器
6853

69-
| 类型 | 说明 |
70-
|------|---------------------------------------------------------------------------|
71-
| 定时任务 | Cron 定时执行脚本 |
72-
| 剪切板 | 复制了特定的文字内容之后触发脚本 |
73-
| 文件监控 | 文件变化的时候触发 |
54+
| 类型 | 说明 |
55+
|------|--------------------------------------------|
56+
| 定时任务 | Cron 定时执行脚本 |
57+
| 剪切板 | 复制了特定的文字内容之后触发脚本 |
58+
| 文件监控 | 文件变化的时候触发 |
7459
| 通知监控 | APP 发送通知的时候，触发脚本（兼容性未知 作者的手机系统：IOS 16.3.1） |
7560

7661
> 脚本同时触发，可能会发生崩溃或者其他未知问题，请注意使用。可以反馈修复。
7762
7863
### 全局参数
7964

8065
1. **$triggerInput**
81-
- 通知监控
82-
```
83-
interface $triggerInput {
66+
- 通知监控参数
67+
68+
```typescript
69+
interface $triggerInput {
8470
type: "notification"; // 触发类型
8571
bundleId: string; // 来源 App Bundle ID
8672
title: string; // 通知标题
8773
message: string; // 通知内容
8874
timestamp: number; // 时间戳 (毫秒)
89-
}
75+
}
9076
```
9177

92-
## 高级功能
78+
2. **$args**
79+
- 快捷指令参数
9380

94-
### iCloud 同步
81+
```typescript
82+
interface $args {
83+
text?: string // 输入内容
84+
json?: string // 输入JSON
85+
}
86+
```
9587

96-
TrollScript 支持两种 iCloud 同步模式：
88+
3. **脚本返回值**
89+
- 控制台显示返回值
90+
- 返回给快捷指令
91+
```javascript
92+
const test = "123"
93+
return test;
94+
```
95+
96+
## 安装方式
97+
98+
### 方式一：直接下载
9799

98-
1. **文件目录模式**（推荐）
99-
- 脚本存储在 `iCloud Drive/TrollScript/Scripts/` 目录
100-
- 可在「文件」App 中直接查看和编辑
101-
- 支持 `.trollscript` 和 `.js` 格式
100+
1. 前往 [Releases](https://github.com/dompling/TrollScript-Release/releases/latest) 页面
101+
2. 下载最新的 `.tipa` 文件
102+
3. 在 TrollStore 中安装
102103

103-
2. **数据库模式**
104-
- 使用 CloudKit + CoreData 同步
105-
- 自动后台同步，无需手动操作
104+
### 方式二：URL Scheme 安装
105+
106+
如果已安装 TrollStore，可以点击以下链接直接安装:
107+
108+
```
109+
apple-magnifier://install?url=https://github.com/dompling/TrollScript-Release/releases/latest/download/TrollScript_latest.tipa
110+
```
111+
112+
## 高级功能
106113

107114
### 脚本导入/导出
108115

109116
支持两种导出格式：
117+
110118
- `.trollscript` - 完整格式，包含代码和元数据
111119
- `.js` - 纯 JavaScript 代码
112120

@@ -138,11 +146,11 @@ trollscript://install?url=https://example.com/script.js
138146
trollscript://store?id=脚本ID&name=脚本名称&url=https://example.com/script.js
139147
```
140148

141-
| 参数 | 说明 |
142-
|------|------|
143-
| `id` | 脚本唯一标识（用于版本追踪） |
144-
| `name` | 脚本显示名称 |
145-
| `url` | 脚本下载地址 |
149+
| 参数 | 说明 |
150+
|--------|----------------|
151+
| `id` | 脚本唯一标识（用于版本追踪） |
152+
| `name` | 脚本显示名称 |
153+
| `url` | 脚本下载地址 |
146154

147155
#### 运行脚本
148156

@@ -177,10 +185,10 @@ trollscript://open
177185
trollscript://subscribe?name=订阅源名称&url=https://example.com/store.json
178186
```
179187

180-
| 参数 | 说明 |
181-
|------|------|
182-
| `name` | 订阅源显示名称 |
183-
| `url` | 订阅源 JSON 地址 |
188+
| 参数 | 说明 |
189+
|--------|-------------|
190+
| `name` | 订阅源显示名称 |
191+
| `url` | 订阅源 JSON 地址 |
184192

185193
### NPM 支持
186194

@@ -193,6 +201,7 @@ npm install --save-dev @dompling/trollscript-types
193201
```
194202

195203
## 截图
204+
196205
<p align="center">
197206
<img src="images/2781768272086_.pic_hd-portrait.png" width="35%" alt="Screenshot 3">
198207
<img src="images/2791768272087_.pic_hd-portrait.png" width="35%" alt="Screenshot 4">

0 commit comments

Comments
 (0)