Skip to content

Commit 2f96df3

Browse files
SilverSlinky606timiya2333
authored andcommitted
对readme小修小补
1 parent bc578ff commit 2f96df3

File tree

1 file changed

+75
-67
lines changed

1 file changed

+75
-67
lines changed

README.md

Lines changed: 75 additions & 67 deletions
Original file line numberDiff line numberDiff line change
@@ -36,32 +36,35 @@ OneBot标准的TMBot插件加载框架(WebsocketClient) 推荐使用go-cqhtt
3636

3737
## 目录
3838

39-
- [上手指南](#上手指南)
40-
- [开发前的配置要求](#开发前的配置要求)
41-
- [安装步骤](#安装步骤)
42-
- [配置文件示例](#配置文件示例)
39+
- [快速上手指南](#快速上手指南)
40+
- [配置文件注释](#配置文件注释)
41+
- [插件开发指南](#插件开发指南)
42+
- [用户安装指南](#用户安装指南)
4343
- [文件目录说明](#文件目录说明)
44-
- [部署](#部署)
4544
- [使用到的框架](#使用到的框架)
4645
- [贡献者](#贡献者)
47-
- [如何参与开源项目](#如何参与开源项目)
48-
- [开发注意事项](#开发注意事项)
46+
- [如何参与此项目](#如何参与此项目)
47+
- [开发注意事项](#开发注意事项)
48+
- [一些额外注意事项](#一些额外注意事项)
4949
- [版本控制](#版本控制)
5050
- [作者](#作者)
51+
- [版权说明](版权说明)
5152
- [鸣谢](#鸣谢)
5253

53-
### 上手指南
54+
### 快速上手指南
5455

5556
1. 前往Releases页面下载最新的TMBot正式版
5657
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 ;)
6162

62-
#### 配置文件示例
63+
***更多内容请参阅[插件开发指南](#插件开发指南)[用户安装指南](#用户安装指南)***
6364

64-
```
65+
#### 配置文件注释
66+
67+
```json
6568
{
6669
"RoBot": { //机器人名字
6770
"Websocket": "ws://127.0.0.1:22", //你的ws地址和端口
@@ -72,88 +75,101 @@ OneBot标准的TMBot插件加载框架(WebsocketClient) 推荐使用go-cqhtt
7275
"LogFile": "RoBotLog-{Y}-{M}-{D}.log" //日志文件名格式,Y为年,M为月,D为日
7376
}
7477
}
78+
7579
```
7680

77-
#### 开发前的配置要求
81+
#### 插件开发指南
7882

7983
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,开始你的开发之旅
8590

86-
#### **安装步骤**
91+
#### **用户安装指南**
8792

88-
1. 克隆这个仓库
93+
1. 前往Releases 下载稳定版(推荐)或从Actions下载测试版(不推荐)
94+
95+
2. 安装必要的框架和依赖
8996

9097
```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
92104
```
93-
94-
2. 启动框架
95-
105+
3. 启动TMBot
96106
```sh
97-
./start.sh //Windows为start.bat
107+
./TMBotStart # Linux
108+
TMBotStart.exe # Windows
98109
```
99-
100-
更详细的步骤请见[上手指南](#上手指南)
101-
102110
### 文件目录说明
103111

104-
```
112+
```json
105113
FileTree:
106-
├── /config/ // TMBot总配置目录(不要往这里操作任何东西!)
107-
├── LICENSE.txt // 这个项目的许可证
108-
├── README.md // 您正在阅读的这个文件
114+
├── /config/ // TMBot总配置目录(您只应该去更改里面的config.json)
115+
├── node_modules // TMBot所需的依赖
109116
├── modules // TMBot框架模块
117+
└── /tools/ // TMBot用到的小工具
110118
├── /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 启动文件
114129

115130
```
116131

117-
### 部署
118-
119-
[上手指南](#上手指南)
120-
121132
### 使用到的框架
122133

123134
暂无
124135

125136
### 贡献者
126137

127-
请阅读**CONTRIBUTING.md** (现在没有) 查阅为该项目做出贡献的开发者。
138+
请阅读**CONTRIBUTING.md** 查阅为该项目做出贡献的开发者。
128139

129-
#### 如何参与开源项目
140+
#### 如何参与此项目
130141

131-
贡献使开源社区成为一个学习、激励和创造的绝佳场所。你所作的任何贡献都是**非常感谢**的。
142+
贡献使开源社区成为一个学习、激励和创造的绝佳场所。你所作的任何贡献都是**让我们非常感谢**的。
132143

133144
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```)
137148
5. 开始PR
138149

139-
#### 开发注意事项
150+
### 开发注意事项
140151

141152
此框架可以运行于LiteLoaderBDS与NodeJS上
153+
**但是请要注意,如果在`NodeJS环境上运行`,那么根目录是直接作用于`项目目录的`**
142154

143-
**但是请要注意,在```NodeJS环境上运行```,根目录是直接作用于```项目目录的```**
144-
145-
**而在```LiteLoaderBDS```上,根目录是作用于```BDS根目录```上的!**
155+
**而在`LiteLoaderBDS`上,根目录是作用于`BDS根目录`上的**
146156

147-
**所以可以使用 ```[FileClass.getStandardPath(<相对目录>)]``` 来获取作用于项目路径的绝对路径来避免此类BUG出现**
157+
**所以可以使用**
158+
```js
159+
FileClass.getStandardPath(<相对目录>)
160+
```
161+
**来获取作用于项目路径的绝对路径来避免此类BUG出现**
148162

149163
*```TIPS: TMBot的基础接口实现已经全部使用了上述方法,所以可以直接传入作用于项目的相对路径```*
150-
***
151-
### 您还需要注意的是
164+
165+
166+
#### 一些额外注意事项
152167

153168
1. TMBot已经为你写好了一些基础接口实现,
154169
例如:
155170

156-
```tools/data: JsonConfigFileClass,IniConfigFileClass,
171+
```js
172+
tools/data: JsonConfigFileClass,IniConfigFileClass,
157173
tools/file: FileClass.readFrom,
158174
FileClass.writeLine,
159175
FileClass.createDir,
@@ -177,41 +193,33 @@ tools/logger: Logger
177193
(请不要随意"使用"内部功能实现的模块) 如:```OneBotDocking``````PluginLoader``````Websocket```
178194
虽然不可以使用,但是可以引用它内部的方法作为参数类型
179195
8. 请在你正在使用的WS实例销毁时一并结束你的插件的一切工作,例子:
180-
```
196+
```js
181197
let tmp = BotDockingMgr.getBot("xxx");
182198
let sid = setInterval(()=>{},1000);
183199
tmp.Client.events.onDestroy.on(()=>{
184200
clearInterval(sid);
185201
})
186202
```
187-
***
203+
188204

189205
### 版本控制
190206

191-
该项目使用Git进行版本管理。您可以在repository参看当前可用版本
207+
该项目使用Git进行版本管理。您可以在GitHub查看当前可用版本
192208

193209
### 作者
194210

195211
Timiya
196212

197213
MineBBS:提米吖 &ensp; qq:284696890
198214

199-
*您也可以在贡献者名单(暂时没有)中参看所有参与该项目的开发者*
215+
*您也可以在贡献者名单中参看所有参与该项目的开发者*
200216

201217
### 版权说明
202218

203219
该项目使用 GPL-V3 授权许可,详情请参阅 [LICENSE](https://github.com/TMBotDev/TMBot/blob/master/LICENSE)
204220

205221
### 鸣谢
206222

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-
215223
<!-- links -->
216224
[contributors-shield]: https://img.shields.io/github/contributors/TMBotDev/TMBot.svg?style=flat-square
217225
[contributors-url]: https://github.com/TMBotDev/TMBot/graphs/contributors

0 commit comments

Comments
 (0)