@@ -36,32 +36,35 @@ OneBot标准的TMBot插件加载框架(WebsocketClient) 推荐使用go-cqhtt
36
36
37
37
## 目录
38
38
39
- - [ 上手指南 ] ( #上手指南 )
40
- - [ 开发前的配置要求 ] ( #开发前的配置要求 )
41
- - [ 安装步骤 ] ( #安装步骤 )
42
- - [ 配置文件示例 ] ( #配置文件示例 )
39
+ - [ 快速上手指南 ] ( #快速上手指南 )
40
+ - [ 配置文件注释 ] ( #配置文件注释 )
41
+ - [ 插件开发指南 ] ( #插件开发指南 )
42
+ - [ 用户安装指南 ] ( #用户安装指南 )
43
43
- [ 文件目录说明] ( #文件目录说明 )
44
- - [ 部署] ( #部署 )
45
44
- [ 使用到的框架] ( #使用到的框架 )
46
45
- [ 贡献者] ( #贡献者 )
47
- - [ 如何参与开源项目] ( #如何参与开源项目 )
48
- - [ 开发注意事项] ( #开发注意事项 )
46
+ - [ 如何参与此项目] ( #如何参与此项目 )
47
+ - [ 开发注意事项] ( #开发注意事项 )
48
+ - [ 一些额外注意事项] ( #一些额外注意事项 )
49
49
- [ 版本控制] ( #版本控制 )
50
50
- [ 作者] ( #作者 )
51
+ - [ 版权说明] ( 版权说明 )
51
52
- [ 鸣谢] ( #鸣谢 )
52
53
53
- ### 上手指南
54
+ ### 快速上手指南
54
55
55
56
1 . 前往Releases页面下载最新的TMBot正式版
56
57
2 . 安装go-cqhttp或其他OneBot标准的机器人后端,设置为正向ws连接(go-cqhttp链接:< https://github.com/Mrs4s/go-cqhttp > )
57
- 2 . 启动start.bat(Linux使用start.sh )安装所需依赖
58
- 3 . 启动框架,在 /config/文件夹找到config.json,写入配置
59
- 4 . 修改配置文件后,启动机器人
60
- 5 . Enjoy it ;)
58
+ 3 . 启动TMBotStart.exe(Linux使用./TMBotStart )安装所需依赖
59
+ 4 . 重复3. ,在. /config/文件夹找到config.json,更改ws地址,端口和你想改的东西
60
+ 5 . 修改配置文件后,启动机器人
61
+ 6 . Enjoy it ;)
61
62
62
- #### 配置文件示例
63
+ *** 更多内容请参阅 [ 插件开发指南 ] ( #插件开发指南 ) 和 [ 用户安装指南 ] ( #用户安装指南 ) ***
63
64
64
- ```
65
+ #### 配置文件注释
66
+
67
+ ``` json
65
68
{
66
69
"RoBot" : { //机器人名字
67
70
"Websocket" : " ws://127.0.0.1:22" , //你的ws地址和端口
@@ -72,88 +75,101 @@ OneBot标准的TMBot插件加载框架(WebsocketClient) 推荐使用go-cqhtt
72
75
"LogFile" : " RoBotLog-{Y}-{M}-{D}.log" //日志文件名格式,Y为年,M为月,D为日
73
76
}
74
77
}
78
+
75
79
```
76
80
77
- #### 开发前的配置要求
81
+ #### 插件开发指南
78
82
79
83
1 . 安装node.js(Linux上还要安装npm)
80
- 2 . 使用start脚本安装框架所需依赖
81
- 3 . 您还需要go-cqhttp或其他OntBot协议的机器人作为后端(go-cqhttp链接:< https://github.com/Mrs4s/go-cqhttp > )
82
- 4 . 前往下载插件模板:< https://github.com/TMBotDev/TMBot-Plugin-Demo.git >
83
- 5 . 将插件安装进TMBot中
84
- 6 . 开始你的开发之旅
84
+ 2 . 克隆仓库或前往Releases下载TMBot框架
85
+ 3 . 运行一次TMBotStart,安装所需依赖
86
+ 4 . 下载go-cqhttp或其他OntBot协议的机器人作为后端(go-cqhttp链接:< https://github.com/Mrs4s/go-cqhttp > )
87
+ 5 . 下载插件模板:< https://github.com/TMBotDev/TMBot-Plugin-Demo.git >
88
+ 6 . 将插件安装进TMBot中
89
+ 7 . 运行TMBotStart,开始你的开发之旅
85
90
86
- #### ** 安装步骤 **
91
+ #### ** 用户安装指南 **
87
92
88
- 1 . 克隆这个仓库
93
+ 1 . 前往Releases 下载稳定版(推荐)或从Actions下载测试版(不推荐)
94
+
95
+ 2 . 安装必要的框架和依赖
89
96
90
97
``` sh
91
- git clone https://github.com/TMBotDev/TMBot/.git
98
+ sudo apt-get install nodejs npm # Linux Debian系可以这样安装
99
+ # Windows用户请自行前往Node.JS官网安装
100
+ # 下载后解压到一个文件夹
101
+ # Windows 用户双击TMBotStart.exe即可安装依赖
102
+ # Linux 用户在此处打开终端,输入:
103
+ chmod +x ./TMBotStart && ./TMBotStart
92
104
```
93
-
94
- 2 . 启动框架
95
-
105
+ 3 . 启动TMBot
96
106
``` sh
97
- ./start.sh //Windows为start.bat
107
+ ./TMBotStart # Linux
108
+ TMBotStart.exe # Windows
98
109
```
99
-
100
- 更详细的步骤请见[ 上手指南] ( #上手指南 )
101
-
102
110
### 文件目录说明
103
111
104
- ```
112
+ ``` json
105
113
FileTree:
106
- ├── /config/ // TMBot总配置目录(不要往这里操作任何东西!)
107
- ├── LICENSE.txt // 这个项目的许可证
108
- ├── README.md // 您正在阅读的这个文件
114
+ ├── /config/ // TMBot总配置目录(您只应该去更改里面的config.json)
115
+ ├── node_modules // TMBot所需的依赖
109
116
├── modules // TMBot框架模块
117
+ └── /tools/ // TMBot用到的小工具
110
118
├── /plugins/ // TMBot插件加载目录(在这里创建插件)
111
- │ ├── /Data/ // TMBot插件数据目录
112
- │ ├── xxx // 插件数据(最好每个创建都独立在Data目录创建一个文件夹,不要随意乱放)
113
- └── /tools/ //TMBot用到的小工具
119
+ ├── /Data/ // TMBot插件数据目录
120
+ ├── xxx // 插件数据(最好每个创建都独立在Data目录创建一个文件夹,不要随意乱放)
121
+ ├── app.js // TMBot的入口文件,正常情况下不应该修改
122
+ ├── CONTRIBUTING.md // TMBot的贡献者名单(Clone Only)
123
+ ├── LICENSE.txt // 这个项目的许可证 (Clone Only)
124
+ ├── logo.png // RT.
125
+ ├── package.json // (Clone Only)
126
+ ├── README.md // 您正在阅读的这个文件(Clone Only)
127
+ ├── TMBotStart.exe // Windows 启动文件
128
+ ├── TMBotStart // Linux 启动文件
114
129
115
130
```
116
131
117
- ### 部署
118
-
119
- 见[ 上手指南] ( #上手指南 )
120
-
121
132
### 使用到的框架
122
133
123
134
暂无
124
135
125
136
### 贡献者
126
137
127
- 请阅读** CONTRIBUTING.md** (现在没有) 查阅为该项目做出贡献的开发者。
138
+ 请阅读** CONTRIBUTING.md** 查阅为该项目做出贡献的开发者。
128
139
129
- #### 如何参与开源项目
140
+ #### 如何参与此项目
130
141
131
- 贡献使开源社区成为一个学习、激励和创造的绝佳场所。你所作的任何贡献都是** 非常感谢 ** 的。
142
+ 贡献使开源社区成为一个学习、激励和创造的绝佳场所。你所作的任何贡献都是** 让我们非常感谢 ** 的。
132
143
133
144
1 . Fork 这个项目
134
- 2 . 创建你的"Feature Branch",例如 (` git checkout -b feature/AmazingFeature ` )
135
- 3 . Commit你的更改 (` git commit -m 'Add some AmazingFeature' ` )
136
- 4 . 将更改推到你的分支上 (` git push origin feature/AmazingFeature ` )
145
+ 2 . 创建你的"Feature Branch",例如 (``` git checkout -b feature/AmazingFeature `` ` )
146
+ 3 . Commit你的更改 (``` git commit -m 'Add some Amazing Feature' `` ` )
147
+ 4 . 将更改推到你的分支上 (``` git push origin feature/AmazingFeature `` ` )
137
148
5 . 开始PR
138
149
139
- #### 开发注意事项
150
+ ### 开发注意事项
140
151
141
152
此框架可以运行于LiteLoaderBDS与NodeJS上
153
+ ** 但是请要注意,如果在` NodeJS环境上运行 ` ,那么根目录是直接作用于` 项目目录的 ` **
142
154
143
- ** 但是请要注意,在``` NodeJS环境上运行 ``` ,根目录是直接作用于``` 项目目录的 ``` **
144
-
145
- ** 而在``` LiteLoaderBDS ``` 上,根目录是作用于``` BDS根目录 ``` 上的!**
155
+ ** 而在` LiteLoaderBDS ` 上,根目录是作用于` BDS根目录 ` 上的**
146
156
147
- ** 所以可以使用 ``` [FileClass.getStandardPath(<相对目录>)] ``` 来获取作用于项目路径的绝对路径来避免此类BUG出现**
157
+ ** 所以可以使用**
158
+ ``` js
159
+ FileClass .getStandardPath (< 相对目录> )
160
+ ```
161
+ ** 来获取作用于项目路径的绝对路径来避免此类BUG出现**
148
162
149
163
* ``` TIPS: TMBot的基础接口实现已经全部使用了上述方法,所以可以直接传入作用于项目的相对路径 ``` *
150
- ***
151
- ### 您还需要注意的是
164
+
165
+
166
+ #### 一些额外注意事项
152
167
153
168
1 . TMBot已经为你写好了一些基础接口实现,
154
169
例如:
155
170
156
- ``` tools/data: JsonConfigFileClass,IniConfigFileClass,
171
+ ``` js
172
+ tools/ data: JsonConfigFileClass,IniConfigFileClass,
157
173
tools/ file: FileClass .readFrom ,
158
174
FileClass .writeLine ,
159
175
FileClass .createDir ,
@@ -177,41 +193,33 @@ tools/logger: Logger
177
193
(请不要随意"使用"内部功能实现的模块) 如:``` OneBotDocking ``` , ``` PluginLoader ``` ,``` Websocket ``` 。
178
194
虽然不可以使用,但是可以引用它内部的方法作为参数类型
179
195
8 . 请在你正在使用的WS实例销毁时一并结束你的插件的一切工作,例子:
180
- ```
196
+ ``` js
181
197
let tmp = BotDockingMgr .getBot (" xxx" );
182
198
let sid = setInterval (()=> {},1000 );
183
199
tmp .Client .events .onDestroy .on (()=> {
184
200
clearInterval (sid);
185
201
})
186
202
```
187
- ***
203
+
188
204
189
205
### 版本控制
190
206
191
- 该项目使用Git进行版本管理。您可以在repository参看当前可用版本 。
207
+ 该项目使用Git进行版本管理。您可以在GitHub查看当前可用版本 。
192
208
193
209
### 作者
194
210
195
211
Timiya
196
212
197
213
MineBBS:提米吖 &ensp ; qq:284696890
198
214
199
- * 您也可以在贡献者名单(暂时没有)中参看所有参与该项目的开发者 。*
215
+ * 您也可以在贡献者名单中参看所有参与该项目的开发者 。*
200
216
201
217
### 版权说明
202
218
203
219
该项目使用 GPL-V3 授权许可,详情请参阅 [ LICENSE] ( https://github.com/TMBotDev/TMBot/blob/master/LICENSE )
204
220
205
221
### 鸣谢
206
222
207
- <!-- 暂时没用>
208
- - [GitHub Emoji Cheat Sheet](https://www.webpagefx.com/tools/emoji-cheat-sheet)
209
- - [Img Shields](https://shields.io)
210
- - [Choose an Open Source License](https://choosealicense.com)
211
- - [GitHub Pages](https://pages.github.com)
212
- - [Animate.css](https://daneden.github.io/animate.css)
213
- - [xxxxxxxxxxxxxx](https://connoratherton.com/loaders)
214
-
215
223
<!-- links -->
216
224
[ contributors-shield ] : https://img.shields.io/github/contributors/TMBotDev/TMBot.svg?style=flat-square
217
225
[ contributors-url ] : https://github.com/TMBotDev/TMBot/graphs/contributors
0 commit comments