koishi-plugin-cnb-bot 0.1.0 → 0.1.1
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/README.md +6 -58
- package/package.json +5 -1
package/README.md
CHANGED
|
@@ -1,18 +1,14 @@
|
|
|
1
1
|
# Koishi CNB 报障助手
|
|
2
2
|
|
|
3
|
-
|
|
4
|
-
|
|
5
|
-
|
|
6
|
-
|
|
7
|
-
需要 Node.js 18 或更高版本。在 Koishi 项目目录运行 `npm install ../cnb-bot-koishi`(按本机目录调整路径),然后在 Koishi 配置中加载 `koishi-plugin-cnb-bot`。确保已经启用数据库服务(例如 `@koishijs/plugin-database-sqlite`),默认无需指令前缀,直接发送 `debug`;如果自定义了 Koishi 的全局指令前缀,请按实际配置调用。
|
|
3
|
+
[](https://www.npmjs.com/package/koishi-plugin-cnb-bot)
|
|
4
|
+
[](https://www.npmjs.com/package/koishi-plugin-cnb-bot)
|
|
5
|
+
[](https://koishi.chat/)
|
|
6
|
+
[](LICENSE)
|
|
8
7
|
|
|
9
|
-
|
|
10
|
-
|
|
11
|
-
### Docker 挂载安装
|
|
8
|
+
Koishi 插件版 CNB 报障助手。用户发送 `debug [故障描述]` 后上传一个 `.zip` 或 `.log` 文件;插件把原始文件上传到 CNB、创建 Issue、请求配置好的 NPC 分析,并把已验证的分析结果发回会话。
|
|
12
9
|
|
|
13
|
-
挂载源码目录并通过 `portal:` 安装时,需要先在插件目录执行 `npm install` 和 `npm run build`,确保挂载目录包含 `lib/index.js`。`package.json` 的入口指向这个构建文件,Koishi 不会直接加载 `src/index.ts`。安装依赖时请使用与容器兼容的 Node.js 环境。
|
|
14
10
|
|
|
15
|
-
|
|
11
|
+
- [AstrBot CNB 报障助手](https://github.com/HarcoChen/astrbot_plugin_cnb_bot):适用于 AstrBot 的日志提交与 CNB 分析插件。
|
|
16
12
|
|
|
17
13
|
## 配置
|
|
18
14
|
|
|
@@ -57,51 +53,3 @@ Issue 创建后,在群里 @机器人并附上文字,或在私信中直接发
|
|
|
57
53
|
日志下载仅接受 `.zip` 和 `.log`,受大小上限约束。HTTP(S) 下载会检查每次重定向、域名白名单和解析到的 IP 地址,拒绝本机、内网及保留地址。临时文件存放在 Koishi 项目目录下的 `data/koishi-plugin-cnb-bot/`,成功上传或报障结束后会删除。
|
|
58
54
|
|
|
59
55
|
报障状态存储在 Koishi 配置的数据库中,其中包括平台、机器人、群/频道、用户、Issue 编号和处理状态。插件不读取群聊历史;只有发起报障后用户主动提交的描述、日志附件和补充文字会进入 CNB。插件重启后会恢复未完成的流程。CNB Issue 创建请求若因连接中断而无法确认,插件会暂停并提示管理员按追踪编号核对,避免重复创建。
|
|
60
|
-
|
|
61
|
-
## 开发
|
|
62
|
-
|
|
63
|
-
```sh
|
|
64
|
-
npm install
|
|
65
|
-
npm run build
|
|
66
|
-
```
|
|
67
|
-
|
|
68
|
-
## GitHub Actions 打包和发布
|
|
69
|
-
|
|
70
|
-
提交分支或创建 PR 会触发 `ci.yml`:通过 `npm ci` 安装锁定依赖并构建,检查插件入口、配置 Schema 和发布文件,再把 `.tgz` 安装包保存到 Actions 的 `npm-package` artifact。
|
|
71
|
-
|
|
72
|
-
推送 `v版本号` 标签会触发 `publish.yml`,自动构建、检查、打包并发布到 npm。标签必须与 `package.json` 的版本一致,例如版本 `0.1.1` 对应标签 `v0.1.1`。正式版本使用 `latest`,包含预发布标识的版本使用 `next`。
|
|
73
|
-
|
|
74
|
-
### 首次配置
|
|
75
|
-
|
|
76
|
-
本工作流使用 [npm Trusted Publisher](https://docs.npmjs.com/trusted-publishers/),通过 GitHub OIDC 认证,无需配置 npm Token Secret。
|
|
77
|
-
|
|
78
|
-
如果 npm 上还没有 `koishi-plugin-cnb-bot`,先在本机登录 npm 并发布第一个版本:
|
|
79
|
-
|
|
80
|
-
```sh
|
|
81
|
-
npm login --registry=https://registry.npmjs.org
|
|
82
|
-
npm publish --access public --registry=https://registry.npmjs.org
|
|
83
|
-
```
|
|
84
|
-
|
|
85
|
-
然后打开 npm 包的 Settings,在 Trusted Publisher 中选择 GitHub Actions,填写:
|
|
86
|
-
|
|
87
|
-
| 字段 | 值 |
|
|
88
|
-
| --- | --- |
|
|
89
|
-
| Organization or user | `HarcoChen` |
|
|
90
|
-
| Repository | `cnb-bot-koishi` |
|
|
91
|
-
| Workflow filename | `publish.yml`,只填写文件名 |
|
|
92
|
-
| Environment name | 留空 |
|
|
93
|
-
| Allowed actions(如显示) | 允许直接执行 `npm publish` |
|
|
94
|
-
|
|
95
|
-
保存后,把工作流和 `package-lock.json` 提交到 GitHub。首次发布已占用的版本号不能重复发布。
|
|
96
|
-
|
|
97
|
-
### 发布后续版本
|
|
98
|
-
|
|
99
|
-
确认当前工作区的代码已经提交,再执行:
|
|
100
|
-
|
|
101
|
-
```sh
|
|
102
|
-
npm version patch
|
|
103
|
-
git push origin main
|
|
104
|
-
git push origin v0.1.1
|
|
105
|
-
```
|
|
106
|
-
|
|
107
|
-
`npm version patch` 会同时更新 `package.json` 和锁文件、创建版本提交及 `v版本号` 标签。上面的 `v0.1.1` 是从 `0.1.0` 升级的示例,请替换为命令实际生成的标签;推送后,在 GitHub 的 Actions 页面查看发布结果。发布成功后可以从 npm 安装,也可以下载 Actions 保存的 `.tgz` 文件。
|
package/package.json
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "koishi-plugin-cnb-bot",
|
|
3
|
-
"version": "0.1.
|
|
3
|
+
"version": "0.1.1",
|
|
4
4
|
"description": "Koishi plugin for submitting diagnostic logs to CNB Issues and relaying NPC analysis.",
|
|
5
5
|
"repository": {
|
|
6
6
|
"type": "git",
|
|
@@ -38,6 +38,10 @@
|
|
|
38
38
|
"node": ">=18.0.0"
|
|
39
39
|
},
|
|
40
40
|
"koishi": {
|
|
41
|
+
"description": {
|
|
42
|
+
"zh": "将诊断日志提交到 CNB Issue,并转发 NPC 分析结果。",
|
|
43
|
+
"en": "Submit diagnostic logs to CNB Issues and relay NPC analysis."
|
|
44
|
+
},
|
|
41
45
|
"service": {
|
|
42
46
|
"required": ["database"]
|
|
43
47
|
}
|