From 22e8702639987a4ce93279852246e79e3d3dd3a9 Mon Sep 17 00:00:00 2001 From: koishi-bot <105629226+koishi-bot@users.noreply.github.com> Date: Mon, 11 Dec 2023 13:21:25 +0800 Subject: [PATCH 0001/3075] New translations community.md (French) [skip ci] --- fr-FR/about/community.md | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/fr-FR/about/community.md b/fr-FR/about/community.md index 78b112883566..098615d8aebf 100644 --- a/fr-FR/about/community.md +++ b/fr-FR/about/community.md @@ -4,8 +4,8 @@ ## 文档 -- [Koishi 插件开发入门教程](https://mp.weixin.qq.com/mp/appmsgalbum?action=getalbum&album_id=2700565655187865601) (沐辰-TimeBather) +- [Koishi 插件开发入门教程](https://mp.weixin.qq.com/mp/appmsgalbum?action=getalbum\&album_id=2700565655187865601) (沐辰-TimeBather) ## 视频 -- [合集] [Koishi 机器人教程](https://space.bilibili.com/23224916/channel/collectiondetail?sid=1049866) (Il Harper) +- \[合集] [Koishi 机器人教程](https://space.bilibili.com/23224916/channel/collectiondetail?sid=1049866) (Il Harper) From 863e9d5209a6e10b8f4e8df969924815192f9f45 Mon Sep 17 00:00:00 2001 From: koishi-bot <105629226+koishi-bot@users.noreply.github.com> Date: Mon, 11 Dec 2023 13:21:26 +0800 Subject: [PATCH 0002/3075] New translations community.md (German) [skip ci] --- de-DE/about/community.md | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/de-DE/about/community.md b/de-DE/about/community.md index 78b112883566..098615d8aebf 100644 --- a/de-DE/about/community.md +++ b/de-DE/about/community.md @@ -4,8 +4,8 @@ ## 文档 -- [Koishi 插件开发入门教程](https://mp.weixin.qq.com/mp/appmsgalbum?action=getalbum&album_id=2700565655187865601) (沐辰-TimeBather) +- [Koishi 插件开发入门教程](https://mp.weixin.qq.com/mp/appmsgalbum?action=getalbum\&album_id=2700565655187865601) (沐辰-TimeBather) ## 视频 -- [合集] [Koishi 机器人教程](https://space.bilibili.com/23224916/channel/collectiondetail?sid=1049866) (Il Harper) +- \[合集] [Koishi 机器人教程](https://space.bilibili.com/23224916/channel/collectiondetail?sid=1049866) (Il Harper) From 197715d53193d6b8bdc48e1474eb63935b259a8c Mon Sep 17 00:00:00 2001 From: koishi-bot <105629226+koishi-bot@users.noreply.github.com> Date: Mon, 11 Dec 2023 13:21:27 +0800 Subject: [PATCH 0003/3075] New translations community.md (Japanese) [skip ci] --- ja-JP/about/community.md | 10 +++++----- 1 file changed, 5 insertions(+), 5 deletions(-) diff --git a/ja-JP/about/community.md b/ja-JP/about/community.md index 304c0af3b83f..098615d8aebf 100644 --- a/ja-JP/about/community.md +++ b/ja-JP/about/community.md @@ -1,11 +1,11 @@ -# コミュニティリソース +# 社区资源 此页面中总结了一些优秀的社区资源可供学习。如果你也想在此页面中展示你的项目，请在点击页面底部的编辑按钮后创建 Pull Request。 -## ドキュメント +## 文档 -- [Koishi 插件开发入门教程](https://mp.weixin.qq.com/mp/appmsgalbum?action=getalbum&album_id=2700565655187865601) (沐辰-TimeBather) +- [Koishi 插件开发入门教程](https://mp.weixin.qq.com/mp/appmsgalbum?action=getalbum\&album_id=2700565655187865601) (沐辰-TimeBather) -## 動画 +## 视频 -- [合集] [Koishi 机器人教程](https://space.bilibili.com/23224916/channel/collectiondetail?sid=1049866) (Il Harper) +- \[合集] [Koishi 机器人教程](https://space.bilibili.com/23224916/channel/collectiondetail?sid=1049866) (Il Harper) From a98372b718153be411f30c92a994141f17bc8f27 Mon Sep 17 00:00:00 2001 From: koishi-bot <105629226+koishi-bot@users.noreply.github.com> Date: Mon, 11 Dec 2023 13:21:28 +0800 Subject: [PATCH 0004/3075] New translations community.md (Russian) [skip ci] --- ru-RU/about/community.md | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/ru-RU/about/community.md b/ru-RU/about/community.md index 78b112883566..098615d8aebf 100644 --- a/ru-RU/about/community.md +++ b/ru-RU/about/community.md @@ -4,8 +4,8 @@ ## 文档 -- [Koishi 插件开发入门教程](https://mp.weixin.qq.com/mp/appmsgalbum?action=getalbum&album_id=2700565655187865601) (沐辰-TimeBather) +- [Koishi 插件开发入门教程](https://mp.weixin.qq.com/mp/appmsgalbum?action=getalbum\&album_id=2700565655187865601) (沐辰-TimeBather) ## 视频 -- [合集] [Koishi 机器人教程](https://space.bilibili.com/23224916/channel/collectiondetail?sid=1049866) (Il Harper) +- \[合集] [Koishi 机器人教程](https://space.bilibili.com/23224916/channel/collectiondetail?sid=1049866) (Il Harper) From 8b90888163fa9489051aeb90b517d3be3b20295d Mon Sep 17 00:00:00 2001 From: koishi-bot <105629226+koishi-bot@users.noreply.github.com> Date: Mon, 11 Dec 2023 13:21:29 +0800 Subject: [PATCH 0005/3075] New translations community.md (Chinese Traditional) [skip ci] --- zh-TW/about/community.md | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/zh-TW/about/community.md b/zh-TW/about/community.md index 78b112883566..098615d8aebf 100644 --- a/zh-TW/about/community.md +++ b/zh-TW/about/community.md @@ -4,8 +4,8 @@ ## 文档 -- [Koishi 插件开发入门教程](https://mp.weixin.qq.com/mp/appmsgalbum?action=getalbum&album_id=2700565655187865601) (沐辰-TimeBather) +- [Koishi 插件开发入门教程](https://mp.weixin.qq.com/mp/appmsgalbum?action=getalbum\&album_id=2700565655187865601) (沐辰-TimeBather) ## 视频 -- [合集] [Koishi 机器人教程](https://space.bilibili.com/23224916/channel/collectiondetail?sid=1049866) (Il Harper) +- \[合集] [Koishi 机器人教程](https://space.bilibili.com/23224916/channel/collectiondetail?sid=1049866) (Il Harper) From 73cea0407b6817e3e6ccea5a05d7a7d588d57f7c Mon Sep 17 00:00:00 2001 From: koishi-bot <105629226+koishi-bot@users.noreply.github.com> Date: Mon, 11 Dec 2023 13:21:30 +0800 Subject: [PATCH 0006/3075] New translations community.md (English, United States) [skip ci] --- en-US/about/community.md | 12 ++++++------ 1 file changed, 6 insertions(+), 6 deletions(-) diff --git a/en-US/about/community.md b/en-US/about/community.md index 82377a33774a..098615d8aebf 100644 --- a/en-US/about/community.md +++ b/en-US/about/community.md @@ -1,11 +1,11 @@ -# Community Resources +# 社区资源 -Some excellent community resources to learn from are summarized on this page. If you also want to feature your project on this page, please click the edit button at the bottom of the page to edit and then create a Pull Request. +此页面中总结了一些优秀的社区资源可供学习。如果你也想在此页面中展示你的项目，请在点击页面底部的编辑按钮后创建 Pull Request。 -## Documentations +## 文档 -- [Plugin development tutorial](https://mp.weixin.qq.com/mp/appmsgalbum?action=getalbum&album_id=2700565655187865601) (TimeBather) +- [Koishi 插件开发入门教程](https://mp.weixin.qq.com/mp/appmsgalbum?action=getalbum\&album_id=2700565655187865601) (沐辰-TimeBather) -## Videos +## 视频 -- [Collection] [Koishi Tutorials](https://space.bilibili.com/23224916/channel/collectiondetail?sid=1049866) (Il Harper) +- \[合集] [Koishi 机器人教程](https://space.bilibili.com/23224916/channel/collectiondetail?sid=1049866) (Il Harper) From 2dedd9b404ce1c05b40896ff612d47cfac42df42 Mon Sep 17 00:00:00 2001 From: koishi-bot <105629226+koishi-bot@users.noreply.github.com> Date: Mon, 11 Dec 2023 13:21:31 +0800 Subject: [PATCH 0007/3075] New translations contact.md (French) [skip ci] --- fr-FR/about/contact.md | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/fr-FR/about/contact.md b/fr-FR/about/contact.md index 62b4b30d3a7b..ce5ec90b41a8 100644 --- a/fr-FR/about/contact.md +++ b/fr-FR/about/contact.md @@ -12,7 +12,7 @@ ### 开发者群 -[426230045](https://jq.qq.com/?_wv=1027&k=6FDoxQ6g) +[426230045](https://jq.qq.com/?_wv=1027\&k=6FDoxQ6g) 本群适用于已经有一定 Node.js / TypeScript 基础，并对 Koishi 开发感兴趣的用户——你可以在这里参与 Koishi 以及其他相关话题的深度讨论。 @@ -30,7 +30,7 @@ ## 论坛 - +https\://forum.koishi.xyz 论坛是一种特别的讨论方式，它允许你的问题、想法、反馈被永久的保存下来，并且可以同时进行不同的讨论。你的问题在论坛有更大的可能性获得解答，并且能够保存下来让他人也受益。 From 7b919e827a08565f6cf2c20d198b9e467734746f Mon Sep 17 00:00:00 2001 From: koishi-bot <105629226+koishi-bot@users.noreply.github.com> Date: Mon, 11 Dec 2023 13:21:32 +0800 Subject: [PATCH 0008/3075] New translations contact.md (German) [skip ci] --- de-DE/about/contact.md | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/de-DE/about/contact.md b/de-DE/about/contact.md index 62b4b30d3a7b..ce5ec90b41a8 100644 --- a/de-DE/about/contact.md +++ b/de-DE/about/contact.md @@ -12,7 +12,7 @@ ### 开发者群 -[426230045](https://jq.qq.com/?_wv=1027&k=6FDoxQ6g) +[426230045](https://jq.qq.com/?_wv=1027\&k=6FDoxQ6g) 本群适用于已经有一定 Node.js / TypeScript 基础，并对 Koishi 开发感兴趣的用户——你可以在这里参与 Koishi 以及其他相关话题的深度讨论。 @@ -30,7 +30,7 @@ ## 论坛 - +https\://forum.koishi.xyz 论坛是一种特别的讨论方式，它允许你的问题、想法、反馈被永久的保存下来，并且可以同时进行不同的讨论。你的问题在论坛有更大的可能性获得解答，并且能够保存下来让他人也受益。 From e1ef91cafb0e4b52b11f142e2ea3c312c0314dee Mon Sep 17 00:00:00 2001 From: koishi-bot <105629226+koishi-bot@users.noreply.github.com> Date: Mon, 11 Dec 2023 13:21:33 +0800 Subject: [PATCH 0009/3075] New translations contact.md (Japanese) [skip ci] --- ja-JP/about/contact.md | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/ja-JP/about/contact.md b/ja-JP/about/contact.md index 62b4b30d3a7b..ce5ec90b41a8 100644 --- a/ja-JP/about/contact.md +++ b/ja-JP/about/contact.md @@ -12,7 +12,7 @@ ### 开发者群 -[426230045](https://jq.qq.com/?_wv=1027&k=6FDoxQ6g) +[426230045](https://jq.qq.com/?_wv=1027\&k=6FDoxQ6g) 本群适用于已经有一定 Node.js / TypeScript 基础，并对 Koishi 开发感兴趣的用户——你可以在这里参与 Koishi 以及其他相关话题的深度讨论。 @@ -30,7 +30,7 @@ ## 论坛 - +https\://forum.koishi.xyz 论坛是一种特别的讨论方式，它允许你的问题、想法、反馈被永久的保存下来，并且可以同时进行不同的讨论。你的问题在论坛有更大的可能性获得解答，并且能够保存下来让他人也受益。 From 63593c1c8602904e30c6248f7d321a92a967763d Mon Sep 17 00:00:00 2001 From: koishi-bot <105629226+koishi-bot@users.noreply.github.com> Date: Mon, 11 Dec 2023 13:21:34 +0800 Subject: [PATCH 0010/3075] New translations contact.md (Russian) [skip ci] --- ru-RU/about/contact.md | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/ru-RU/about/contact.md b/ru-RU/about/contact.md index 62b4b30d3a7b..ce5ec90b41a8 100644 --- a/ru-RU/about/contact.md +++ b/ru-RU/about/contact.md @@ -12,7 +12,7 @@ ### 开发者群 -[426230045](https://jq.qq.com/?_wv=1027&k=6FDoxQ6g) +[426230045](https://jq.qq.com/?_wv=1027\&k=6FDoxQ6g) 本群适用于已经有一定 Node.js / TypeScript 基础，并对 Koishi 开发感兴趣的用户——你可以在这里参与 Koishi 以及其他相关话题的深度讨论。 @@ -30,7 +30,7 @@ ## 论坛 - +https\://forum.koishi.xyz 论坛是一种特别的讨论方式，它允许你的问题、想法、反馈被永久的保存下来，并且可以同时进行不同的讨论。你的问题在论坛有更大的可能性获得解答，并且能够保存下来让他人也受益。 From 3d831c91b28cb05c0d6b79373a15e6ec157b7b0e Mon Sep 17 00:00:00 2001 From: koishi-bot <105629226+koishi-bot@users.noreply.github.com> Date: Mon, 11 Dec 2023 13:21:35 +0800 Subject: [PATCH 0011/3075] New translations contact.md (Chinese Traditional) [skip ci] --- zh-TW/about/contact.md | 20 ++++++++++---------- 1 file changed, 10 insertions(+), 10 deletions(-) diff --git a/zh-TW/about/contact.md b/zh-TW/about/contact.md index e3c3a483d004..ce5ec90b41a8 100644 --- a/zh-TW/about/contact.md +++ b/zh-TW/about/contact.md @@ -1,26 +1,26 @@ -# 參與討論 +# 参与讨论 如果你在 Koishi 使用中遇到了问题，或者有新奇的点子想与其他人讨论，欢迎参与我们的社区。 ## QQ 群 -### 用戶群 +### 用户群 [948266958](https://qm.qq.com/q/7C9E9rjR0Q) -本群適用於剛剛入門 Koishi，或者在 Koishi 的使用過程中遇到了問題，希望得到解答的用戶——這裏有熱情的群友隨時解答你的問題！ +本群适用于刚刚入门 Koishi，或者在 Koishi 的使用过程中遇到了问题，希望得到解答的用户——这里有热情的群友随时解答你的问题！ -### 開發者群 +### 开发者群 -[426230045](https://jq.qq.com/?_wv=1027&k=6FDoxQ6g) +[426230045](https://jq.qq.com/?_wv=1027\&k=6FDoxQ6g) -本群適用於已經有一定 Node,js / TypeScript 基礎，并對 Koishi 開發感興趣的用戶——你可以在這裏參與 Koishi 以及其他相關話題的深度討論。 +本群适用于已经有一定 Node.js / TypeScript 基础，并对 Koishi 开发感兴趣的用户——你可以在这里参与 Koishi 以及其他相关话题的深度讨论。 ## Discord [加入服务器](https://discord.com/invite/xfxYwmd284) -我們的 Discord 服務器內設有版本發布、開發交流和問題反饋等不同功能的頻道，你也可以在這裏參與討論。 +我们的 Discord 服务器内设有版本发布、开发交流和问题反馈等不同功能的频道，你也可以在这里参与讨论。 ## Telegram @@ -28,11 +28,11 @@ 欢迎加入我们的 Telegram 群聊，你可以在这里参与讨论，或者在 Telegram 通知群中接收版本更新通知。 -## 論壇 +## 论坛 - +https\://forum.koishi.xyz -論壇是一種特別的討論方式，它允許你的問題、想法、反饋被永久的保存下來，並且可以同時進行不同的討論。你的問題在論壇有更大的可能性獲得解答，並且能夠保存下來讓他人也受益。 +论坛是一种特别的讨论方式，它允许你的问题、想法、反馈被永久的保存下来，并且可以同时进行不同的讨论。你的问题在论坛有更大的可能性获得解答，并且能够保存下来让他人也受益。 ## 企业支持 From 7466627420d3c411c21eed8ee8ff4f5882e95279 Mon Sep 17 00:00:00 2001 From: koishi-bot <105629226+koishi-bot@users.noreply.github.com> Date: Mon, 11 Dec 2023 13:21:36 +0800 Subject: [PATCH 0012/3075] New translations contact.md (English, United States) [skip ci] --- en-US/about/contact.md | 36 ++++++++++++++++++------------------ 1 file changed, 18 insertions(+), 18 deletions(-) diff --git a/en-US/about/contact.md b/en-US/about/contact.md index 410495ad1275..ce5ec90b41a8 100644 --- a/en-US/about/contact.md +++ b/en-US/about/contact.md @@ -1,41 +1,41 @@ -# Discussion +# 参与讨论 -If you have problems when using Koishi, or have new ideas to share to other users, welcome to join our community. +如果你在 Koishi 使用中遇到了问题，或者有新奇的点子想与其他人讨论，欢迎参与我们的社区。 -## QQ Groups +## QQ 群 -### For users +### 用户群 [948266958](https://qm.qq.com/q/7C9E9rjR0Q) -This group is for the users who newly used Koishi, or have problems when using Koishi and hope to receive an answer. There are many friendly members in the group and ready to answer your questions every time! +本群适用于刚刚入门 Koishi，或者在 Koishi 的使用过程中遇到了问题，希望得到解答的用户——这里有热情的群友随时解答你的问题！ -### For developers +### 开发者群 -[426230045](https://jq.qq.com/?_wv=1027&k=6FDoxQ6g) +[426230045](https://jq.qq.com/?_wv=1027\&k=6FDoxQ6g) -This group is for the users who had learned Node.js / TypeScript and interested in Koishi Development. You can discuss anything deeply about Koishi in this group. +本群适用于已经有一定 Node.js / TypeScript 基础，并对 Koishi 开发感兴趣的用户——你可以在这里参与 Koishi 以及其他相关话题的深度讨论。 ## Discord -[Join the Server](https://discord.com/invite/xfxYwmd284) +[加入服务器](https://discord.com/invite/xfxYwmd284) -Our Discord server has channels with different features such as Version Releases, Development Discuss and Question Feedback. You can also participate in discussions here. +我们的 Discord 服务器内设有版本发布、开发交流和问题反馈等不同功能的频道，你也可以在这里参与讨论。 ## Telegram -[Join the Chat Group](https://t.me/koishichat) / [Join the Announcement Channel](https://t.me/koishichannel) +[加入闲聊群](https://t.me/koishichat) / [加入通知频道](https://t.me/koishichannel) -Welcome to join our Telegram chat group, where you can participate in discussions or receive version update notifications in the announcement channel. +欢迎加入我们的 Telegram 群聊，你可以在这里参与讨论，或者在 Telegram 通知群中接收版本更新通知。 -## Forum +## 论坛 - +https\://forum.koishi.xyz -Forum is a special way of discussing. Your issues, ideas, feedback will save forever. And you can have different discussions at the same time.Your questions are more likely to be answered in the forum and can be saved for the benefit of others. +论坛是一种特别的讨论方式，它允许你的问题、想法、反馈被永久的保存下来，并且可以同时进行不同的讨论。你的问题在论坛有更大的可能性获得解答，并且能够保存下来让他人也受益。 -## Enterprise Support +## 企业支持 -QQ：[2953529126](https://qm.qq.com/q/P8eMJkP5yI) / WeChat：ilharp +QQ：[2953529126](https://qm.qq.com/q/P8eMJkP5yI) / 微信：ilharp -We provide exclusive support for enterprise users. In addition to participating in discussions through the above methods, enterprise users can also add customer service to get one-on-one exclusive support. +我们为企业用户提供专属支持。如果您是企业用户，除了通过上面的方式参与讨论以外，还可以添加客服，获得一对一专属支持。 From 3b2f0dcfb33adb879bf7e831b452a5f97ca539ee Mon Sep 17 00:00:00 2001 From: koishi-bot <105629226+koishi-bot@users.noreply.github.com> Date: Mon, 11 Dec 2023 13:21:37 +0800 Subject: [PATCH 0013/3075] New translations docs.md (French) [skip ci] --- fr-FR/about/contribute/docs.md | 16 ++++++++-------- 1 file changed, 8 insertions(+), 8 deletions(-) diff --git a/fr-FR/about/contribute/docs.md b/fr-FR/about/contribute/docs.md index 5df400afb658..9b09f451161c 100644 --- a/fr-FR/about/contribute/docs.md +++ b/fr-FR/about/contribute/docs.md @@ -21,7 +21,7 @@ ``` > 123 ABC -> +> > ビリビリ #### CJK 与西文之间一律插入一个空格 @@ -35,7 +35,7 @@ ``` > 在 Python 中，我们使用 `class` 关键字来声明类。 -> +> > 他只用了 100 行不到的代码就实现了那个复杂的功能。 #### 数字与英文单位之间加空格，与符号单位之间不加空格 @@ -49,7 +49,7 @@ ``` > 我有一块 512 GB 的硬盘。 -> +> > 今天气温 23˚C，有 70% 的可能性下雨。 #### 括号请使用半角书写，并按照下列规则在两侧添加空格 @@ -80,7 +80,7 @@ ``` > 1 + 2 = 3 -> +> > Bellman-Ford 算法 #### 除上述以外的标点均使用全角，且两侧均不留空格 @@ -111,7 +111,7 @@ ``` > 编程语言有很多，如 C、C++、Java…… -> +> > 他刚刚做了一个重要的决定——辞职。 #### 针对首次出现的概念，使用粗体进行强调，同时在两侧添加必要的空格 @@ -155,6 +155,6 @@ ## 参考资料 -- -- -- +- https\://github.com/vinta/pangu.js +- https\://stdrc.cc/style-guides/chinese.html +- https\://stdrc.cc/style-guides/markdown.html From b10d6a3b239f7491ea30ab62c46890c53e86cdce Mon Sep 17 00:00:00 2001 From: koishi-bot <105629226+koishi-bot@users.noreply.github.com> Date: Mon, 11 Dec 2023 13:21:38 +0800 Subject: [PATCH 0014/3075] New translations docs.md (German) [skip ci] --- de-DE/about/contribute/docs.md | 16 ++++++++-------- 1 file changed, 8 insertions(+), 8 deletions(-) diff --git a/de-DE/about/contribute/docs.md b/de-DE/about/contribute/docs.md index 5df400afb658..9b09f451161c 100644 --- a/de-DE/about/contribute/docs.md +++ b/de-DE/about/contribute/docs.md @@ -21,7 +21,7 @@ ``` > 123 ABC -> +> > ビリビリ #### CJK 与西文之间一律插入一个空格 @@ -35,7 +35,7 @@ ``` > 在 Python 中，我们使用 `class` 关键字来声明类。 -> +> > 他只用了 100 行不到的代码就实现了那个复杂的功能。 #### 数字与英文单位之间加空格，与符号单位之间不加空格 @@ -49,7 +49,7 @@ ``` > 我有一块 512 GB 的硬盘。 -> +> > 今天气温 23˚C，有 70% 的可能性下雨。 #### 括号请使用半角书写，并按照下列规则在两侧添加空格 @@ -80,7 +80,7 @@ ``` > 1 + 2 = 3 -> +> > Bellman-Ford 算法 #### 除上述以外的标点均使用全角，且两侧均不留空格 @@ -111,7 +111,7 @@ ``` > 编程语言有很多，如 C、C++、Java…… -> +> > 他刚刚做了一个重要的决定——辞职。 #### 针对首次出现的概念，使用粗体进行强调，同时在两侧添加必要的空格 @@ -155,6 +155,6 @@ ## 参考资料 -- -- -- +- https\://github.com/vinta/pangu.js +- https\://stdrc.cc/style-guides/chinese.html +- https\://stdrc.cc/style-guides/markdown.html From e93103a85188ae28549fa3c0a1480bd02cf2d047 Mon Sep 17 00:00:00 2001 From: koishi-bot <105629226+koishi-bot@users.noreply.github.com> Date: Mon, 11 Dec 2023 13:21:39 +0800 Subject: [PATCH 0015/3075] New translations docs.md (Japanese) [skip ci] --- ja-JP/about/contribute/docs.md | 18 +++++++++--------- 1 file changed, 9 insertions(+), 9 deletions(-) diff --git a/ja-JP/about/contribute/docs.md b/ja-JP/about/contribute/docs.md index 34a13b641dc2..9b09f451161c 100644 --- a/ja-JP/about/contribute/docs.md +++ b/ja-JP/about/contribute/docs.md @@ -21,7 +21,7 @@ ``` > 123 ABC -> +> > ビリビリ #### CJK 与西文之间一律插入一个空格 @@ -35,7 +35,7 @@ ``` > 在 Python 中，我们使用 `class` 关键字来声明类。 -> +> > 他只用了 100 行不到的代码就实现了那个复杂的功能。 #### 数字与英文单位之间加空格，与符号单位之间不加空格 @@ -49,7 +49,7 @@ ``` > 我有一块 512 GB 的硬盘。 -> +> > 今天气温 23˚C，有 70% 的可能性下雨。 #### 括号请使用半角书写，并按照下列规则在两侧添加空格 @@ -64,7 +64,7 @@ + Spring 框架的一种设计思想名叫控制反转 (IoC)，通常以依赖注入 (DI) 的方式实现。 ``` -> Spring Framework には「制御の反転(IoC)」というシステムアーキテクチャ設計がある、依存性注入(DI)の方式で実現することが多いです。 +> Spring 框架的一种设计思想名叫控制反转 (IoC)，通常以依赖注入 (DI) 的方式实现。 #### 西文标点一律使用半角书写，且在两侧添加空格的方式与括号类似 @@ -80,7 +80,7 @@ ``` > 1 + 2 = 3 -> +> > Bellman-Ford 算法 #### 除上述以外的标点均使用全角，且两侧均不留空格 @@ -111,7 +111,7 @@ ``` > 编程语言有很多，如 C、C++、Java…… -> +> > 他刚刚做了一个重要的决定——辞职。 #### 针对首次出现的概念，使用粗体进行强调，同时在两侧添加必要的空格 @@ -155,6 +155,6 @@ ## 参考资料 -- -- -- +- https\://github.com/vinta/pangu.js +- https\://stdrc.cc/style-guides/chinese.html +- https\://stdrc.cc/style-guides/markdown.html From ed34426446b7fc3be9f52002c3e1b16973ada9a8 Mon Sep 17 00:00:00 2001 From: koishi-bot <105629226+koishi-bot@users.noreply.github.com> Date: Mon, 11 Dec 2023 13:21:40 +0800 Subject: [PATCH 0016/3075] New translations docs.md (Russian) [skip ci] --- ru-RU/about/contribute/docs.md | 16 ++++++++-------- 1 file changed, 8 insertions(+), 8 deletions(-) diff --git a/ru-RU/about/contribute/docs.md b/ru-RU/about/contribute/docs.md index 5df400afb658..9b09f451161c 100644 --- a/ru-RU/about/contribute/docs.md +++ b/ru-RU/about/contribute/docs.md @@ -21,7 +21,7 @@ ``` > 123 ABC -> +> > ビリビリ #### CJK 与西文之间一律插入一个空格 @@ -35,7 +35,7 @@ ``` > 在 Python 中，我们使用 `class` 关键字来声明类。 -> +> > 他只用了 100 行不到的代码就实现了那个复杂的功能。 #### 数字与英文单位之间加空格，与符号单位之间不加空格 @@ -49,7 +49,7 @@ ``` > 我有一块 512 GB 的硬盘。 -> +> > 今天气温 23˚C，有 70% 的可能性下雨。 #### 括号请使用半角书写，并按照下列规则在两侧添加空格 @@ -80,7 +80,7 @@ ``` > 1 + 2 = 3 -> +> > Bellman-Ford 算法 #### 除上述以外的标点均使用全角，且两侧均不留空格 @@ -111,7 +111,7 @@ ``` > 编程语言有很多，如 C、C++、Java…… -> +> > 他刚刚做了一个重要的决定——辞职。 #### 针对首次出现的概念，使用粗体进行强调，同时在两侧添加必要的空格 @@ -155,6 +155,6 @@ ## 参考资料 -- -- -- +- https\://github.com/vinta/pangu.js +- https\://stdrc.cc/style-guides/chinese.html +- https\://stdrc.cc/style-guides/markdown.html From c01c8642cffacbe6988c32af5ad3480a427c5e56 Mon Sep 17 00:00:00 2001 From: koishi-bot <105629226+koishi-bot@users.noreply.github.com> Date: Mon, 11 Dec 2023 13:21:41 +0800 Subject: [PATCH 0017/3075] New translations docs.md (Chinese Traditional) [skip ci] --- zh-TW/about/contribute/docs.md | 156 ++++++++++++++++----------------- 1 file changed, 78 insertions(+), 78 deletions(-) diff --git a/zh-TW/about/contribute/docs.md b/zh-TW/about/contribute/docs.md index 4b1f902669fa..9b09f451161c 100644 --- a/zh-TW/about/contribute/docs.md +++ b/zh-TW/about/contribute/docs.md @@ -1,16 +1,16 @@ -# 文檔貢獻指南 +# 文档贡献指南 -## 術語表 +## 术语表 -- CJK：中日韓文字等 -- 西文：數字、拉丁字母、希臘字母等 -- 西文標點：兩側權重相同的半角標點，例如四則運算符，等號等 -- 前置標點：放在其相關文本前的標點，如左括號，左引號等 -- 後置標點：放在其相關文本後的標點，如冒號，句號，右引號等 +- CJK：中日韩文字等 +- 西文：数字、拉丁字母、希腊字母等 +- 西文标点：两侧权重相同的半角标点，例如四则运算符，等号等 +- 前置标点：放在其相关文本前的标点，如左括号，左引号等 +- 后置标点：放在其相关文本后的标点，如冒号，句号，右引号等 -## 中文寫作和排版指南 +## 中文写作和排版指南 -#### CJK 一律使用全角書寫，西文一律使用半角書寫 +#### CJK 一律使用全角书写，西文一律使用半角书写 ```diff - １２３ ＡＢＣ @@ -21,54 +21,54 @@ ``` > 123 ABC -> +> > ビリビリ -#### CJK 一律使用全角書寫，西文一律使用半角書寫 +#### CJK 与西文之间一律插入一个空格 ```diff -- 在Python中，我們使用`class`關鍵字來聲明類。 -+ 在 Python 中，我們使用 `class` 關鍵字來聲明類。 +- 在Python中，我们使用`class`关键字来声明类。 ++ 在 Python 中，我们使用 `class` 关键字来声明类。 -- 他只用了100行不到的代碼就實現了那個復雜的功能。 -+ 他只用了 100 行不到的代碼就實現了那個復雜的功能。 +- 他只用了100行不到的代码就实现了那个复杂的功能。 ++ 他只用了 100 行不到的代码就实现了那个复杂的功能。 ``` -> 在 Python 中，我們使用 `class` 關鍵字來聲明類。 -> -> 他只用了 100 行不到的代碼就實現了那個復雜的功能。 +> 在 Python 中，我们使用 `class` 关键字来声明类。 +> +> 他只用了 100 行不到的代码就实现了那个复杂的功能。 -#### 數字與英文單位之間加空格，與符號單位之間不加空格 +#### 数字与英文单位之间加空格，与符号单位之间不加空格 ```diff -- 我有一塊 512GB 的硬盤。 -+ 我有一塊 512GB 的硬盤。 +- 我有一块 512GB 的硬盘。 ++ 我有一块 512 GB 的硬盘。 -- 今天氣溫 23 ˚C，有 70 % 的可能性下雨。 -+ 今天氣溫 23 ˚C，有 70 % 的可能性下雨。 +- 今天气温 23 ˚C，有 70 % 的可能性下雨。 ++ 今天气温 23˚C，有 70% 的可能性下雨。 ``` -> 我有一塊 512GB 的硬盤。 -> -> 今天氣溫 23 ˚C，有 70 % 的可能性下雨。 +> 我有一块 512 GB 的硬盘。 +> +> 今天气温 23˚C，有 70% 的可能性下雨。 -#### 括號請使用半角書寫，並按照下列規則在兩側添加空格 +#### 括号请使用半角书写，并按照下列规则在两侧添加空格 -- 如果左括號的前一個字符不是前置標點，則在左括號前插入一個空格 +- 如果左括号的前一个字符不是前置标点，则在左括号前插入一个空格 - 如果右括号的后一个字符不是后置标点，则在右括号后插入一个空格 ```diff -- Spring 框架的一種設計思想名叫控製反轉（IoC），通常以依賴註入（DI）的方式實現。 -- Spring 框架的一種設計思想名叫控製反轉 (IoC) ，通常以依賴註入 (DI) 的方式實現。 -- Spring 框架的一種設計思想名叫控製反轉 (IoC) ，通常以依賴註入 (DI) 的方式實現。 -+ Spring 框架的一種設計思想名叫控製反轉 (IoC) ，通常以依賴註入 (DI) 的方式實現。 +- Spring 框架的一种设计思想名叫控制反转（IoC），通常以依赖注入（DI）的方式实现。 +- Spring 框架的一种设计思想名叫控制反转 (IoC) ，通常以依赖注入 (DI) 的方式实现。 +- Spring 框架的一种设计思想名叫控制反转(IoC)，通常以依赖注入(DI)的方式实现。 ++ Spring 框架的一种设计思想名叫控制反转 (IoC)，通常以依赖注入 (DI) 的方式实现。 ``` -> Spring 框架的一種設計思想名叫控製反轉 (IoC) ，通常以依賴註入 (DI) 的方式實現。 +> Spring 框架的一种设计思想名叫控制反转 (IoC)，通常以依赖注入 (DI) 的方式实现。 -#### 西文標點一律使用半角書寫，且在兩側添加空格的方式與括號類似 +#### 西文标点一律使用半角书写，且在两侧添加空格的方式与括号类似 -- 如果該標點與兩側的內容是一個整體，請不要添加空格 +- 如果该标点与两侧的内容是一个整体，请不要添加空格 ```diff - 1+2=3 @@ -80,81 +80,81 @@ ``` > 1 + 2 = 3 -> +> > Bellman-Ford 算法 -#### 除上述以外的標點均使用全角，且兩側均不留空格 +#### 除上述以外的标点均使用全角，且两侧均不留空格 ```diff -- 他有一臺 MacBook Pro. -- 他有一臺 MacBook Pro 。 -+ 他有一臺 MacBook Pro。 +- 他有一台 MacBook Pro. +- 他有一台 MacBook Pro 。 ++ 他有一台 MacBook Pro。 ``` -> 他有一臺 MacBook Pro。 +> 他有一台 MacBook Pro。 -#### 使用正確的省略號和破折號 +#### 使用正确的省略号和破折号 -正確的省略號和破折號占兩格，每格分別是「…」和「—」。使用了省略號則不宜同時使用「等等」。 +正确的省略号和破折号占两格，每格分别是「…」和「—」。使用了省略号则不宜同时使用「等等」。 ```diff -- 編程語言有很多，如 C、C++、Java… -- 編程語言有很多，如 C、C++、Java... -- 編程語言有很多，如 C、C++、Java。。。 -- 編程語言有很多，如 C、C++、Java……等等 -+ 編程語言有很多，如 C、C++、Java…… - -- 他剛剛做了一個重要的決定 - 辭職。 -- 他剛剛做了一個重要的決定-辭職。 -- 他剛剛做了一個重要的決定—辭職。 -+ 他剛剛做了一個重要的決定—辭職。 +- 编程语言有很多，如 C、C++、Java… +- 编程语言有很多，如 C、C++、Java... +- 编程语言有很多，如 C、C++、Java。。。 +- 编程语言有很多，如 C、C++、Java……等等 ++ 编程语言有很多，如 C、C++、Java…… + +- 他刚刚做了一个重要的决定 - 辞职。 +- 他刚刚做了一个重要的决定-辞职。 +- 他刚刚做了一个重要的决定—辞职。 ++ 他刚刚做了一个重要的决定——辞职。 ``` -> 編程語言有很多，如 C、C++、Java…… -> -> 他剛剛做了一個重要的決定——辭職。 +> 编程语言有很多，如 C、C++、Java…… +> +> 他刚刚做了一个重要的决定——辞职。 -#### 針對首次出現的概念，使用粗體進行強調，同時在兩側添加必要的空格 +#### 针对首次出现的概念，使用粗体进行强调，同时在两侧添加必要的空格 ```diff -- 下面介紹 TypeScript 特有的依賴合並 (Declaration Merging) 機製。 -- 下面介紹 TypeScript 特有的 **依賴合並** (Declaration Merging) 機製。 -+ 下面介紹 TypeScript 特有的 **依賴合並 (Declaration Merging)** 機製。 +- 下面介绍 TypeScript 特有的依赖合并 (Declaration Merging) 机制。 +- 下面介绍 TypeScript 特有的 **依赖合并** (Declaration Merging) 机制。 ++ 下面介绍 TypeScript 特有的 **依赖合并 (Declaration Merging)** 机制。 ``` -> 下面介紹 TypeScript 特有的 **依賴合並 (Declaration Merging)** 機製。 +> 下面介绍 TypeScript 特有的 **依赖合并 (Declaration Merging)** 机制。 -#### 強調的部分應盡量簡短，對要強調的概念的補充說明建議不使用粗體 +#### 强调的部分应尽量简短，对要强调的概念的补充说明建议不使用粗体 ```diff -- 組件的 **副作用 (觸發組件外的影響)** 應聲明在最前面。 -+ 組件的 **副作用** (觸發組件外的影響) 應聲明在最前面。 +- 组件的 **副作用 (触发组件外的影响)** 应声明在最前面。 ++ 组件的 **副作用** (触发组件外的影响) 应声明在最前面。 ``` -> 組件的 **副作用** (觸發組件外的影響) 應聲明在最前面。 +> 组件的 **副作用** (触发组件外的影响) 应声明在最前面。 -#### 盡量避免在正文中使用斜體 +#### 尽量避免在正文中使用斜体 -- 斜體的漢字非常不美觀，如有需求可以使用粗體 (`**`) +- 斜体的汉字非常不美观，如有需求可以使用粗体 (`**`) ```diff -- __只要有能夠拼接文件的構建系統，就把每個組件單獨分成文件。__ -+ **只要有能夠拼接文件的構建系統，就把每個組件單獨分成文件。** +- __只要有能够拼接文件的构建系统，就把每个组件单独分成文件。__ ++ **只要有能够拼接文件的构建系统，就把每个组件单独分成文件。** ``` -> **只要有能夠拼接文件的構建系統，就把每個組件單獨分成文件。** +> **只要有能够拼接文件的构建系统，就把每个组件单独分成文件。** -## Markdown 風格指南 +## Markdown 风格指南 -#### 使用一個、兩個和三個 `*` 分別表示斜體、粗體和粗斜體 +#### 使用一个、两个和三个 `*` 分别表示斜体、粗体和粗斜体 ```diff -- 這是一個_斜體_；這是一個__粗體__；這是一個___粗斜體___。 -+ 這是一個*斜體*；這是一個**粗體**；這是一個***粗斜體***。 +- 这是一个_斜体_；这是一个__粗体__；这是一个___粗斜体___。 ++ 这是一个*斜体*；这是一个**粗体**；这是一个***粗斜体***。 ``` -## 參考資料 +## 参考资料 -- -- -- +- https\://github.com/vinta/pangu.js +- https\://stdrc.cc/style-guides/chinese.html +- https\://stdrc.cc/style-guides/markdown.html From 095168389147a3a11b1fd06d04ed9d03ef50e409 Mon Sep 17 00:00:00 2001 From: koishi-bot <105629226+koishi-bot@users.noreply.github.com> Date: Mon, 11 Dec 2023 13:21:42 +0800 Subject: [PATCH 0018/3075] New translations docs.md (English, United States) [skip ci] --- en-US/about/contribute/docs.md | 32 ++++++++++++++++---------------- 1 file changed, 16 insertions(+), 16 deletions(-) diff --git a/en-US/about/contribute/docs.md b/en-US/about/contribute/docs.md index 2d3a01358b76..9b09f451161c 100644 --- a/en-US/about/contribute/docs.md +++ b/en-US/about/contribute/docs.md @@ -1,9 +1,9 @@ -# Documentation +# 文档贡献指南 -## Terms of Glossary +## 术语表 -- CJK：Chinese and Japanese Korean text etc. -- Western：Numbers, Latin Letters, Greek Letters, etc. +- CJK：中日韩文字等 +- 西文：数字、拉丁字母、希腊字母等 - 西文标点：两侧权重相同的半角标点，例如四则运算符，等号等 - 前置标点：放在其相关文本前的标点，如左括号，左引号等 - 后置标点：放在其相关文本后的标点，如冒号，句号，右引号等 @@ -21,10 +21,10 @@ ``` > 123 ABC -> +> > ビリビリ -#### Insert a space between CJK and Western +#### CJK 与西文之间一律插入一个空格 ```diff - 在Python中，我们使用`class`关键字来声明类。 @@ -35,7 +35,7 @@ ``` > 在 Python 中，我们使用 `class` 关键字来声明类。 -> +> > 他只用了 100 行不到的代码就实现了那个复杂的功能。 #### 数字与英文单位之间加空格，与符号单位之间不加空格 @@ -49,7 +49,7 @@ ``` > 我有一块 512 GB 的硬盘。 -> +> > 今天气温 23˚C，有 70% 的可能性下雨。 #### 括号请使用半角书写，并按照下列规则在两侧添加空格 @@ -80,7 +80,7 @@ ``` > 1 + 2 = 3 -> +> > Bellman-Ford 算法 #### 除上述以外的标点均使用全角，且两侧均不留空格 @@ -93,7 +93,7 @@ > 他有一台 MacBook Pro。 -#### Use correct ellipses and dashes +#### 使用正确的省略号和破折号 正确的省略号和破折号占两格，每格分别是「…」和「—」。使用了省略号则不宜同时使用「等等」。 @@ -111,7 +111,7 @@ ``` > 编程语言有很多，如 C、C++、Java…… -> +> > 他刚刚做了一个重要的决定——辞职。 #### 针对首次出现的概念，使用粗体进行强调，同时在两侧添加必要的空格 @@ -144,7 +144,7 @@ > **只要有能够拼接文件的构建系统，就把每个组件单独分成文件。** -## Markdown Style Guide +## Markdown 风格指南 #### 使用一个、两个和三个 `*` 分别表示斜体、粗体和粗斜体 @@ -153,8 +153,8 @@ + 这是一个*斜体*；这是一个**粗体**；这是一个***粗斜体***。 ``` -## Reference +## 参考资料 -- -- -- +- https\://github.com/vinta/pangu.js +- https\://stdrc.cc/style-guides/chinese.html +- https\://stdrc.cc/style-guides/markdown.html From ac0d1e2e0267fbf550480fb28527720dd0eec096 Mon Sep 17 00:00:00 2001 From: koishi-bot <105629226+koishi-bot@users.noreply.github.com> Date: Mon, 11 Dec 2023 13:21:46 +0800 Subject: [PATCH 0019/3075] New translations structure.md (Chinese Traditional) [skip ci] --- zh-TW/about/contribute/structure.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/zh-TW/about/contribute/structure.md b/zh-TW/about/contribute/structure.md index 5007595065c8..550438833b8d 100644 --- a/zh-TW/about/contribute/structure.md +++ b/zh-TW/about/contribute/structure.md @@ -1 +1 @@ -# 項目結構 +# 项目结构 From e09c7bc70bb703e1c302bc76cee9f0cb101a5c43 Mon Sep 17 00:00:00 2001 From: koishi-bot <105629226+koishi-bot@users.noreply.github.com> Date: Mon, 11 Dec 2023 13:21:46 +0800 Subject: [PATCH 0020/3075] New translations structure.md (English, United States) [skip ci] --- en-US/about/contribute/structure.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/en-US/about/contribute/structure.md b/en-US/about/contribute/structure.md index 2b4e5f6a6efe..550438833b8d 100644 --- a/en-US/about/contribute/structure.md +++ b/en-US/about/contribute/structure.md @@ -1 +1 @@ -# Infrastructure +# 项目结构 From 798d8daf90953531bac9b79a48fafdd6102f6093 Mon Sep 17 00:00:00 2001 From: koishi-bot <105629226+koishi-bot@users.noreply.github.com> Date: Mon, 11 Dec 2023 13:21:47 +0800 Subject: [PATCH 0021/3075] New translations events.md (French) [skip ci] --- fr-FR/about/events.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/fr-FR/about/events.md b/fr-FR/about/events.md index 6f9aef267af3..9f6abb0ffd89 100644 --- a/fr-FR/about/events.md +++ b/fr-FR/about/events.md @@ -1,4 +1,4 @@ -# Le Grand Événement +# 大事件 ## 开源之夏 2023 From 64940c009be5f44d7f7b5ff750b88d5e4680a3da Mon Sep 17 00:00:00 2001 From: koishi-bot <105629226+koishi-bot@users.noreply.github.com> Date: Mon, 11 Dec 2023 13:21:52 +0800 Subject: [PATCH 0022/3075] New translations faq.md (French) [skip ci] --- fr-FR/about/faq.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/fr-FR/about/faq.md b/fr-FR/about/faq.md index 4df40dacae64..e99928b2fb5b 100644 --- a/fr-FR/about/faq.md +++ b/fr-FR/about/faq.md @@ -1,4 +1,4 @@ -# Foire aux questions +# 常见问题 ## 谁在维护 Koishi？ From 77757f9cec877ee6be1b9695eb659336d3b5694c Mon Sep 17 00:00:00 2001 From: koishi-bot <105629226+koishi-bot@users.noreply.github.com> Date: Mon, 11 Dec 2023 13:21:56 +0800 Subject: [PATCH 0023/3075] New translations faq.md (English, United States) [skip ci] --- en-US/about/faq.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/en-US/about/faq.md b/en-US/about/faq.md index 27861c4f038f..e99928b2fb5b 100644 --- a/en-US/about/faq.md +++ b/en-US/about/faq.md @@ -1,4 +1,4 @@ -# FAQ +# 常见问题 ## 谁在维护 Koishi？ From 1a1ae6b282a0e30ec88d2837533a024dc05fde52 Mon Sep 17 00:00:00 2001 From: koishi-bot <105629226+koishi-bot@users.noreply.github.com> Date: Mon, 11 Dec 2023 13:22:00 +0800 Subject: [PATCH 0024/3075] New translations history.md (English, United States) [skip ci] --- en-US/about/history.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/en-US/about/history.md b/en-US/about/history.md index 014695a0fa87..dc106fc4ec72 100644 --- a/en-US/about/history.md +++ b/en-US/about/history.md @@ -1,4 +1,4 @@ -# History +# 发展史 2019 年 8 月，我开始编写我的第一个基于 Node.js 的聊天机器人，名为四季酱。当时我浏览各种聊天机器人框架，发现并没有自己真正想要的，遂决定从零开始编写。一开始这个机器人只包含了很少的功能，但随着其更多功能的加入，我开始调整起底层架构，并计划逐步将其开源出来。 From 476b1972ed0d3a91b8bbf50110d2347eeee4d059 Mon Sep 17 00:00:00 2001 From: koishi-bot <105629226+koishi-bot@users.noreply.github.com> Date: Mon, 11 Dec 2023 13:22:04 +0800 Subject: [PATCH 0025/3075] New translations license.md (English, United States) [skip ci] --- en-US/about/license.md | 24 ++++++++++++------------ 1 file changed, 12 insertions(+), 12 deletions(-) diff --git a/en-US/about/license.md b/en-US/about/license.md index 71a6f56aeeb5..ca028831f156 100644 --- a/en-US/about/license.md +++ b/en-US/about/license.md @@ -1,17 +1,17 @@ -# License +# 许可证 -The Koishi team is dedicated to maintaining a thriving open-source ecosystem. +Koishi 开发团队致力于维护良好的开源生态。 -## License used by Koishi +## Koishi 所使用的许可证 -- Koishi itself and its core plugins are all open-sourced under the MIT License ([repository link](https://github.com/koishijs/koishi)). -- Official plugins related to the console are open-sourced under the AGPL-3.0 License ([repository link](https://github.com/koishijs/webui)). - - According to the terms of the license, software that uses official console plugins must be open-sourced under the same license. - - Plugins that extend console functionality in the form of a service are not subject to this restriction. +- Koishi 本体及其核心插件全部使用 MIT 许可证开源 ([仓库链接](https://github.com/koishijs/koishi)) +- 与控制台相关的官方插件均使用 AGPL-3.0 许可证开源 ([仓库链接](https://github.com/koishijs/webui)) + - 根据许可证条款，使用了官方控制台插件的软件必须以相同许可证开源 + - 以服务形式扩展控制台功能的插件不受此限制 -## License for the official website +## 本文档所使用的许可证 -- The theme on which this document relies is open-sourced under the MIT License ([repository link](https://github.com/koishijs/theme)). -- The document repository is open-sourced under the CC-BY-SA-4.0 and AGPL-3.0 Licenses ([repository link](https://github.com/koishijs/docs)). - - The content of the document is open-sourced under the CC-BY-SA-4.0 License (parts outside the `.vitepress` directory). - - Extensions to the original theme library are open-sourced under the AGPL-3.0 License (parts in the `.vitepress` directory). +- 本文档所依赖的主题使用 MIT 许可证开源 ([仓库链接](https://github.com/koishijs/theme)) +- 本文档仓库使用 CC-BY-SA-4.0 和 AGPL-3.0 许可证开源 ([仓库链接](https://github.com/koishijs/docs)) + - 文档内容以 CC-BY-SA-4.0 许可证开源 (`.vitepress` 目录以外的部分) + - 对原主题库进行的扩展使用 AGPL-3.0 许可证开源 (`.vitepress` 目录中的部分) From f63713a58dcf0f90259f705730058fe657cad083 Mon Sep 17 00:00:00 2001 From: koishi-bot <105629226+koishi-bot@users.noreply.github.com> Date: Mon, 11 Dec 2023 13:22:05 +0800 Subject: [PATCH 0026/3075] New translations releases.md (French) [skip ci] --- fr-FR/about/releases.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/fr-FR/about/releases.md b/fr-FR/about/releases.md index fa8641959069..5d94f3986d25 100644 --- a/fr-FR/about/releases.md +++ b/fr-FR/about/releases.md @@ -1,4 +1,4 @@ -# Mettre à jour l'horaire +# 更新计划 ## 发布周期 From d3a6bca2c007795f019506f95009537ee367280e Mon Sep 17 00:00:00 2001 From: koishi-bot <105629226+koishi-bot@users.noreply.github.com> Date: Mon, 11 Dec 2023 13:22:09 +0800 Subject: [PATCH 0027/3075] New translations releases.md (English, United States) [skip ci] --- en-US/about/releases.md | 18 +++++++++--------- 1 file changed, 9 insertions(+), 9 deletions(-) diff --git a/en-US/about/releases.md b/en-US/about/releases.md index 5815441956ab..5d94f3986d25 100644 --- a/en-US/about/releases.md +++ b/en-US/about/releases.md @@ -1,15 +1,15 @@ -# Updates +# 更新计划 -## Release Cycle +## 发布周期 -Koishi currently adopts the Cordis architecture, with the majority of its functionalities provided in the form of plugins. These plugins are updated as needed and all follow the [Semantic Versioning](https://semver.org/lang/zh-CN/) guidelines: +Koishi 目前采用 Cordis 架构，绝大多数功能都以插件的形式提供。这些插件的更新会按需进行，且都遵循 [语义化版本](https://semver.org/lang/zh-CN/) 规范： -- Patch versions are only used for bug fixes and do not introduce new features. -- Minor versions may include new features but will not break existing functionalities. -- Major versions introduce breaking changes. +- 补丁版本 (patch) 只用于修复 bug，不会引入新的功能。 +- 次版本 (minor) 会包含新特性，但不会破坏现有功能。 +- 主版本 (major) 会引入破坏性变更。 -In the context of semantic versioning, all definitions of expected behavior are based on the official Koishi documentation. +在语义化版本的界定上，一切对预期行为的定义，以 Koishi 官方文档为准。 -Koishi's updates are released approximately every 1-2 weeks. These versions are classified as either patch or minor versions based on Koishi's own dependencies. The current major version of Koishi is v4, and there are no plans to change the major version at this time. +Koishi 本体大约每 1-2 周发布一个新版本。这些版本根据 Koishi 自身的依赖确定是补丁版本还是次版本。目前 Koishi 的主版本是 v4，且没有改动主版本的计划。 -For upgrades from lower versions of v4, you can refer to this [Migration Guide](./upgrade.md). +从 v4 的较低版本升级时，可以参考此 [迁移指南](./upgrade.md)。 From b6ce21e8cbbe7b32f4a3ae32ec5ea9c84b1b5acb Mon Sep 17 00:00:00 2001 From: koishi-bot <105629226+koishi-bot@users.noreply.github.com> Date: Mon, 11 Dec 2023 13:22:10 +0800 Subject: [PATCH 0028/3075] New translations team.md (French) [skip ci] --- fr-FR/about/team.md | 10 +++++----- 1 file changed, 5 insertions(+), 5 deletions(-) diff --git a/fr-FR/about/team.md b/fr-FR/about/team.md index e7aa3458a32a..17afd0207991 100644 --- a/fr-FR/about/team.md +++ b/fr-FR/about/team.md @@ -1,29 +1,29 @@ -# À propos de l'équipe +# 认识团队 ## 核心成员 ### Shigma - 创始人，koishijs/\*，satorijs/\* -- https://github.com/shigma +- https\://github.com/shigma ### Il Harper - Koishi Desktop - Koishi Handbook -- https://github.com/ilharp +- https\://github.com/ilharp ### Anillc - koishijs/core, satorijs/adapter-telegram - Koishi Android -- https://github.com/anillc +- https\://github.com/anillc ### MaikoTan - Translations - satorijs/adapter-lark -- https://github.com/maikotan +- https\://github.com/maikotan ## 团队成员 From 1a5eeb9ccff9e85fb19a03656151e13fbcd87217 Mon Sep 17 00:00:00 2001 From: koishi-bot <105629226+koishi-bot@users.noreply.github.com> Date: Mon, 11 Dec 2023 13:22:11 +0800 Subject: [PATCH 0029/3075] New translations team.md (German) [skip ci] --- de-DE/about/team.md | 8 ++++---- 1 file changed, 4 insertions(+), 4 deletions(-) diff --git a/de-DE/about/team.md b/de-DE/about/team.md index f9f81b3ad76d..17afd0207991 100644 --- a/de-DE/about/team.md +++ b/de-DE/about/team.md @@ -5,25 +5,25 @@ ### Shigma - 创始人，koishijs/\*，satorijs/\* -- https://github.com/shigma +- https\://github.com/shigma ### Il Harper - Koishi Desktop - Koishi Handbook -- https://github.com/ilharp +- https\://github.com/ilharp ### Anillc - koishijs/core, satorijs/adapter-telegram - Koishi Android -- https://github.com/anillc +- https\://github.com/anillc ### MaikoTan - Translations - satorijs/adapter-lark -- https://github.com/maikotan +- https\://github.com/maikotan ## 团队成员 From 440ff62ccc945bcf0d4f0e5ff3aa7eb07feb0e5d Mon Sep 17 00:00:00 2001 From: koishi-bot <105629226+koishi-bot@users.noreply.github.com> Date: Mon, 11 Dec 2023 13:22:12 +0800 Subject: [PATCH 0030/3075] New translations team.md (Japanese) [skip ci] --- ja-JP/about/team.md | 18 +++++++++--------- 1 file changed, 9 insertions(+), 9 deletions(-) diff --git a/ja-JP/about/team.md b/ja-JP/about/team.md index 79b60d40b1e4..17afd0207991 100644 --- a/ja-JP/about/team.md +++ b/ja-JP/about/team.md @@ -1,31 +1,31 @@ # 认识团队 -## コアメンバー +## 核心成员 ### Shigma -- 創設者、koishijs/\*、satorijs/\* -- https://github.com/shigma +- 创始人，koishijs/\*，satorijs/\* +- https\://github.com/shigma ### Il Harper - Koishi Desktop - Koishi Handbook -- https://github.com/ilharp +- https\://github.com/ilharp ### Anillc - koishijs/core, satorijs/adapter-telegram - Koishi Android -- https://github.com/anillc +- https\://github.com/anillc ### MaikoTan -- 翻訳 +- Translations - satorijs/adapter-lark -- https://github.com/maikotan +- https\://github.com/maikotan -## チームメンバー +## 团队成员 ### NWYLZW @@ -35,7 +35,7 @@ ### LittleC -## コミュニティコントリビューター +## 社区贡献者 ### i'DLisT From a160386d9bd188ca377b183f8e1d104f027a3205 Mon Sep 17 00:00:00 2001 From: koishi-bot <105629226+koishi-bot@users.noreply.github.com> Date: Mon, 11 Dec 2023 13:22:13 +0800 Subject: [PATCH 0031/3075] New translations team.md (Russian) [skip ci] --- ru-RU/about/team.md | 8 ++++---- 1 file changed, 4 insertions(+), 4 deletions(-) diff --git a/ru-RU/about/team.md b/ru-RU/about/team.md index f9f81b3ad76d..17afd0207991 100644 --- a/ru-RU/about/team.md +++ b/ru-RU/about/team.md @@ -5,25 +5,25 @@ ### Shigma - 创始人，koishijs/\*，satorijs/\* -- https://github.com/shigma +- https\://github.com/shigma ### Il Harper - Koishi Desktop - Koishi Handbook -- https://github.com/ilharp +- https\://github.com/ilharp ### Anillc - koishijs/core, satorijs/adapter-telegram - Koishi Android -- https://github.com/anillc +- https\://github.com/anillc ### MaikoTan - Translations - satorijs/adapter-lark -- https://github.com/maikotan +- https\://github.com/maikotan ## 团队成员 From 1eebb973db5157eefef52adf4f2fa31593556868 Mon Sep 17 00:00:00 2001 From: koishi-bot <105629226+koishi-bot@users.noreply.github.com> Date: Mon, 11 Dec 2023 13:22:14 +0800 Subject: [PATCH 0032/3075] New translations team.md (Chinese Traditional) [skip ci] --- zh-TW/about/team.md | 8 ++++---- 1 file changed, 4 insertions(+), 4 deletions(-) diff --git a/zh-TW/about/team.md b/zh-TW/about/team.md index f9f81b3ad76d..17afd0207991 100644 --- a/zh-TW/about/team.md +++ b/zh-TW/about/team.md @@ -5,25 +5,25 @@ ### Shigma - 创始人，koishijs/\*，satorijs/\* -- https://github.com/shigma +- https\://github.com/shigma ### Il Harper - Koishi Desktop - Koishi Handbook -- https://github.com/ilharp +- https\://github.com/ilharp ### Anillc - koishijs/core, satorijs/adapter-telegram - Koishi Android -- https://github.com/anillc +- https\://github.com/anillc ### MaikoTan - Translations - satorijs/adapter-lark -- https://github.com/maikotan +- https\://github.com/maikotan ## 团队成员 From 497e81637313f2c46a1395b9a6fe27ff33c1a3ed Mon Sep 17 00:00:00 2001 From: koishi-bot <105629226+koishi-bot@users.noreply.github.com> Date: Mon, 11 Dec 2023 13:22:15 +0800 Subject: [PATCH 0033/3075] New translations team.md (English, United States) [skip ci] --- en-US/about/team.md | 18 +++++++++--------- 1 file changed, 9 insertions(+), 9 deletions(-) diff --git a/en-US/about/team.md b/en-US/about/team.md index 5988a01e99d9..17afd0207991 100644 --- a/en-US/about/team.md +++ b/en-US/about/team.md @@ -1,31 +1,31 @@ -# Meet the Team +# 认识团队 -## Core Members +## 核心成员 ### Shigma -- Founder, koishijs/\*, satorijs/\* -- https://github.com/shigma +- 创始人，koishijs/\*，satorijs/\* +- https\://github.com/shigma ### Il Harper - Koishi Desktop - Koishi Handbook -- https://github.com/ilharp +- https\://github.com/ilharp ### Anillc - koishijs/core, satorijs/adapter-telegram - Koishi Android -- https://github.com/anillc +- https\://github.com/anillc ### MaikoTan - Translations - satorijs/adapter-lark -- https://github.com/maikotan +- https\://github.com/maikotan -## Team Members +## 团队成员 ### NWYLZW @@ -35,7 +35,7 @@ ### LittleC -## Community Contributors +## 社区贡献者 ### i'DLisT From 6d4854d749e3352ea8d2c959752bc40af9fd8732 Mon Sep 17 00:00:00 2001 From: koishi-bot <105629226+koishi-bot@users.noreply.github.com> Date: Mon, 11 Dec 2023 13:22:16 +0800 Subject: [PATCH 0034/3075] New translations upgrade.md (French) [skip ci] --- fr-FR/about/upgrade.md | 6 +++--- 1 file changed, 3 insertions(+), 3 deletions(-) diff --git a/fr-FR/about/upgrade.md b/fr-FR/about/upgrade.md index d44973a9d324..bbb3e959373d 100644 --- a/fr-FR/about/upgrade.md +++ b/fr-FR/about/upgrade.md @@ -1,4 +1,4 @@ -# Migration depuis une version ancienne +# 从低版本迁移 ## JSX 支持 v4.10.3 @@ -23,11 +23,11 @@ 1. 先将 market 插件更新到最新版本 (最新版本支持批量更新) 2. (非 v4.10.3 用户忽略此步骤) 在控制台中修改全局设置，将 `heartbeatInterval` 项的值改为 `6000`，`heartbeatTimeout` 项的值改为 `600000`，并点击「重载配置」按钮 -3. 在依赖管理中，通过下拉菜单将全部官方依赖修改为最新版本 (如果有 suggest 和 assets-* 依赖则选择移除)，并点击「应用更改」按钮 +3. 在依赖管理中，通过下拉菜单将全部官方依赖修改为最新版本 (如果有 suggest 和 assets-\* 依赖则选择移除)，并点击「应用更改」按钮 4. 更新完成后重启实例 5. 在控制台中修改全局设置，将 `heartbeatInterval` 和 `heartbeatTimeout` 项的值均改为 `0`，并点击「重载配置」按钮 6. 再次重启实例 -7. 如果之前移除了 assets-* 插件，请重新前往插件市场进行安装 +7. 如果之前移除了 assets-\* 插件，请重新前往插件市场进行安装 ## CLI 迁移 v4.11.0 From f1eced5e66b9ec3c9d9fb8fab1d0efeca3c6dd75 Mon Sep 17 00:00:00 2001 From: koishi-bot <105629226+koishi-bot@users.noreply.github.com> Date: Mon, 11 Dec 2023 13:22:17 +0800 Subject: [PATCH 0035/3075] New translations upgrade.md (German) [skip ci] --- de-DE/about/upgrade.md | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/de-DE/about/upgrade.md b/de-DE/about/upgrade.md index b7ff2cba0b36..bbb3e959373d 100644 --- a/de-DE/about/upgrade.md +++ b/de-DE/about/upgrade.md @@ -23,11 +23,11 @@ 1. 先将 market 插件更新到最新版本 (最新版本支持批量更新) 2. (非 v4.10.3 用户忽略此步骤) 在控制台中修改全局设置，将 `heartbeatInterval` 项的值改为 `6000`，`heartbeatTimeout` 项的值改为 `600000`，并点击「重载配置」按钮 -3. 在依赖管理中，通过下拉菜单将全部官方依赖修改为最新版本 (如果有 suggest 和 assets-* 依赖则选择移除)，并点击「应用更改」按钮 +3. 在依赖管理中，通过下拉菜单将全部官方依赖修改为最新版本 (如果有 suggest 和 assets-\* 依赖则选择移除)，并点击「应用更改」按钮 4. 更新完成后重启实例 5. 在控制台中修改全局设置，将 `heartbeatInterval` 和 `heartbeatTimeout` 项的值均改为 `0`，并点击「重载配置」按钮 6. 再次重启实例 -7. 如果之前移除了 assets-* 插件，请重新前往插件市场进行安装 +7. 如果之前移除了 assets-\* 插件，请重新前往插件市场进行安装 ## CLI 迁移 v4.11.0 From a79b49171806acf3adee360427b2abc330daec71 Mon Sep 17 00:00:00 2001 From: koishi-bot <105629226+koishi-bot@users.noreply.github.com> Date: Mon, 11 Dec 2023 13:22:18 +0800 Subject: [PATCH 0036/3075] New translations upgrade.md (Japanese) [skip ci] --- ja-JP/about/upgrade.md | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/ja-JP/about/upgrade.md b/ja-JP/about/upgrade.md index b7ff2cba0b36..bbb3e959373d 100644 --- a/ja-JP/about/upgrade.md +++ b/ja-JP/about/upgrade.md @@ -23,11 +23,11 @@ 1. 先将 market 插件更新到最新版本 (最新版本支持批量更新) 2. (非 v4.10.3 用户忽略此步骤) 在控制台中修改全局设置，将 `heartbeatInterval` 项的值改为 `6000`，`heartbeatTimeout` 项的值改为 `600000`，并点击「重载配置」按钮 -3. 在依赖管理中，通过下拉菜单将全部官方依赖修改为最新版本 (如果有 suggest 和 assets-* 依赖则选择移除)，并点击「应用更改」按钮 +3. 在依赖管理中，通过下拉菜单将全部官方依赖修改为最新版本 (如果有 suggest 和 assets-\* 依赖则选择移除)，并点击「应用更改」按钮 4. 更新完成后重启实例 5. 在控制台中修改全局设置，将 `heartbeatInterval` 和 `heartbeatTimeout` 项的值均改为 `0`，并点击「重载配置」按钮 6. 再次重启实例 -7. 如果之前移除了 assets-* 插件，请重新前往插件市场进行安装 +7. 如果之前移除了 assets-\* 插件，请重新前往插件市场进行安装 ## CLI 迁移 v4.11.0 From 5e6bf64368a2c8332b33339badadb3a7964398b3 Mon Sep 17 00:00:00 2001 From: koishi-bot <105629226+koishi-bot@users.noreply.github.com> Date: Mon, 11 Dec 2023 13:22:19 +0800 Subject: [PATCH 0037/3075] New translations upgrade.md (Russian) [skip ci] --- ru-RU/about/upgrade.md | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/ru-RU/about/upgrade.md b/ru-RU/about/upgrade.md index b7ff2cba0b36..bbb3e959373d 100644 --- a/ru-RU/about/upgrade.md +++ b/ru-RU/about/upgrade.md @@ -23,11 +23,11 @@ 1. 先将 market 插件更新到最新版本 (最新版本支持批量更新) 2. (非 v4.10.3 用户忽略此步骤) 在控制台中修改全局设置，将 `heartbeatInterval` 项的值改为 `6000`，`heartbeatTimeout` 项的值改为 `600000`，并点击「重载配置」按钮 -3. 在依赖管理中，通过下拉菜单将全部官方依赖修改为最新版本 (如果有 suggest 和 assets-* 依赖则选择移除)，并点击「应用更改」按钮 +3. 在依赖管理中，通过下拉菜单将全部官方依赖修改为最新版本 (如果有 suggest 和 assets-\* 依赖则选择移除)，并点击「应用更改」按钮 4. 更新完成后重启实例 5. 在控制台中修改全局设置，将 `heartbeatInterval` 和 `heartbeatTimeout` 项的值均改为 `0`，并点击「重载配置」按钮 6. 再次重启实例 -7. 如果之前移除了 assets-* 插件，请重新前往插件市场进行安装 +7. 如果之前移除了 assets-\* 插件，请重新前往插件市场进行安装 ## CLI 迁移 v4.11.0 From 1fabc009b6fe710e65689ac129daefd805734023 Mon Sep 17 00:00:00 2001 From: koishi-bot <105629226+koishi-bot@users.noreply.github.com> Date: Mon, 11 Dec 2023 13:22:20 +0800 Subject: [PATCH 0038/3075] New translations upgrade.md (Chinese Traditional) [skip ci] --- zh-TW/about/upgrade.md | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/zh-TW/about/upgrade.md b/zh-TW/about/upgrade.md index b7ff2cba0b36..bbb3e959373d 100644 --- a/zh-TW/about/upgrade.md +++ b/zh-TW/about/upgrade.md @@ -23,11 +23,11 @@ 1. 先将 market 插件更新到最新版本 (最新版本支持批量更新) 2. (非 v4.10.3 用户忽略此步骤) 在控制台中修改全局设置，将 `heartbeatInterval` 项的值改为 `6000`，`heartbeatTimeout` 项的值改为 `600000`，并点击「重载配置」按钮 -3. 在依赖管理中，通过下拉菜单将全部官方依赖修改为最新版本 (如果有 suggest 和 assets-* 依赖则选择移除)，并点击「应用更改」按钮 +3. 在依赖管理中，通过下拉菜单将全部官方依赖修改为最新版本 (如果有 suggest 和 assets-\* 依赖则选择移除)，并点击「应用更改」按钮 4. 更新完成后重启实例 5. 在控制台中修改全局设置，将 `heartbeatInterval` 和 `heartbeatTimeout` 项的值均改为 `0`，并点击「重载配置」按钮 6. 再次重启实例 -7. 如果之前移除了 assets-* 插件，请重新前往插件市场进行安装 +7. 如果之前移除了 assets-\* 插件，请重新前往插件市场进行安装 ## CLI 迁移 v4.11.0 From 6b4a20ac07f7f149753f0c7b4f9618ac4575b7e5 Mon Sep 17 00:00:00 2001 From: koishi-bot <105629226+koishi-bot@users.noreply.github.com> Date: Mon, 11 Dec 2023 13:22:21 +0800 Subject: [PATCH 0039/3075] New translations upgrade.md (English, United States) [skip ci] --- en-US/about/upgrade.md | 16 ++++++++-------- 1 file changed, 8 insertions(+), 8 deletions(-) diff --git a/en-US/about/upgrade.md b/en-US/about/upgrade.md index ba093ea54d70..bbb3e959373d 100644 --- a/en-US/about/upgrade.md +++ b/en-US/about/upgrade.md @@ -1,6 +1,6 @@ # 从低版本迁移 -## JSX Support v4.10.3 +## JSX 支持 v4.10.3 在 4.10.3 版本中，我们正式引入了 JSX 支持。这意味着你可以在插件中使用 JSX 语法来构造消息元素了。要实现这一点，你需要对你的项目进行一些配置： @@ -17,19 +17,19 @@ 2. 将要使用 JSX 的文件后缀名修改为 `.tsx`。 -## Heartbeat Migration v4.10.4 +## 心跳迁移 v4.10.4 在 4.10.4 版本中，我们调整了默认的心跳行为，这可能导致老用户升级时遭遇无限重启问题。可以执行下列操作进行升级： 1. 先将 market 插件更新到最新版本 (最新版本支持批量更新) 2. (非 v4.10.3 用户忽略此步骤) 在控制台中修改全局设置，将 `heartbeatInterval` 项的值改为 `6000`，`heartbeatTimeout` 项的值改为 `600000`，并点击「重载配置」按钮 -3. 在依赖管理中，通过下拉菜单将全部官方依赖修改为最新版本 (如果有 suggest 和 assets-* 依赖则选择移除)，并点击「应用更改」按钮 +3. 在依赖管理中，通过下拉菜单将全部官方依赖修改为最新版本 (如果有 suggest 和 assets-\* 依赖则选择移除)，并点击「应用更改」按钮 4. 更新完成后重启实例 5. 在控制台中修改全局设置，将 `heartbeatInterval` 和 `heartbeatTimeout` 项的值均改为 `0`，并点击「重载配置」按钮 6. 再次重启实例 -7. 如果之前移除了 assets-* 插件，请重新前往插件市场进行安装 +7. 如果之前移除了 assets-\* 插件，请重新前往插件市场进行安装 -## CLI Migration v4.11.0 +## CLI 迁移 v4.11.0 在 4.11.0 版本中我们移除了 @koishijs/cli 包，将其合并到了 koishi 中。这意味着你每次升级时不再需要同时升级两边了。但对于已经安装了 @koishijs/cli 的用户，你需要执行下列操作完成升级： @@ -37,7 +37,7 @@ 2. 在依赖管理中，修改 koishi 的版本号到 4.11.0，同时移除 @koishijs/cli 的版本号 3. 点击「应用更改」按钮 -## HMR Migration v4.12.0 +## HMR 迁移 v4.12.0 在 4.12.0 版本中，我们将模块热替换相关功能移至专门的插件 @koishijs/plugin-hmr 中。对于生产模式下的用户无影响，但开发者则需要在升级 Koishi 后手动安装新插件。你需要执行下列操作完成升级： @@ -45,7 +45,7 @@ 2. 修改你的配置文件，加上 [模块热替换](../guide/develop/script.md#模块热替换) 中提到的部分 3. 移除 `package.json` 文件中 `scripts.dev` 的 `--watch` 参数 -## Plugin Market Migration v4.13.0 +## 插件市场迁移 v4.13.0 在 4.13.0 版本中，我们将 @koishijs/plugin-market 插件分拆为了两个插件 market 和 config。其中 market 负责「插件市场」和「依赖管理」页面，而 config 则负责「插件配置」页面。直接将 market 插件更新到 2.0.0 或以上版本的用户会发现自己的「插件配置」页面消失，此时你需要执行下列操作完成升级： @@ -69,7 +69,7 @@ plugins: 4. 点击右上角的保存按钮 5. 重新启动 Koishi 实例 -## Internationalization Migration v4.13.0 +## 国际化迁移 v4.13.0 在 4.13.0 版本中，我们也引入了多语言的回退机制。这意味者，所有涉及语言配置的地方都需要从单一的语言字符串修改为数组。具体包括以下几个地方： From ae62ac178f2079db507bcf29dd9a0cb05e1762a7 Mon Sep 17 00:00:00 2001 From: koishi-bot <105629226+koishi-bot@users.noreply.github.com> Date: Mon, 11 Dec 2023 13:22:25 +0800 Subject: [PATCH 0040/3075] New translations component.md (English, United States) [skip ci] --- en-US/api/console/component.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/en-US/api/console/component.md b/en-US/api/console/component.md index 5eba3167d9b3..fb0966de7a1a 100644 --- a/en-US/api/console/component.md +++ b/en-US/api/console/component.md @@ -1,4 +1,4 @@ -# Built-in Components +# 内置组件 ## `` From 00dda758bc20c776c9657bdf58c08e357f3aa8f4 Mon Sep 17 00:00:00 2001 From: koishi-bot <105629226+koishi-bot@users.noreply.github.com> Date: Mon, 11 Dec 2023 13:22:26 +0800 Subject: [PATCH 0041/3075] New translations composition.md (French) [skip ci] --- fr-FR/api/console/composition.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/fr-FR/api/console/composition.md b/fr-FR/api/console/composition.md index 151fa0b39f3c..92253fa272ec 100644 --- a/fr-FR/api/console/composition.md +++ b/fr-FR/api/console/composition.md @@ -1,6 +1,6 @@ # 组合式 API -::: tip +:::tip 本节中所涉及的 API 都在 @koishijs/client 中导出。 ::: From fd8702146766ecf31a86230cdbf280fe84086fc5 Mon Sep 17 00:00:00 2001 From: koishi-bot <105629226+koishi-bot@users.noreply.github.com> Date: Mon, 11 Dec 2023 13:22:27 +0800 Subject: [PATCH 0042/3075] New translations composition.md (German) [skip ci] --- de-DE/api/console/composition.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/de-DE/api/console/composition.md b/de-DE/api/console/composition.md index 151fa0b39f3c..92253fa272ec 100644 --- a/de-DE/api/console/composition.md +++ b/de-DE/api/console/composition.md @@ -1,6 +1,6 @@ # 组合式 API -::: tip +:::tip 本节中所涉及的 API 都在 @koishijs/client 中导出。 ::: From 94963704e3d76b1165b6daa702f686e74bece369 Mon Sep 17 00:00:00 2001 From: koishi-bot <105629226+koishi-bot@users.noreply.github.com> Date: Mon, 11 Dec 2023 13:22:28 +0800 Subject: [PATCH 0043/3075] New translations composition.md (Japanese) [skip ci] --- ja-JP/api/console/composition.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/ja-JP/api/console/composition.md b/ja-JP/api/console/composition.md index 151fa0b39f3c..92253fa272ec 100644 --- a/ja-JP/api/console/composition.md +++ b/ja-JP/api/console/composition.md @@ -1,6 +1,6 @@ # 组合式 API -::: tip +:::tip 本节中所涉及的 API 都在 @koishijs/client 中导出。 ::: From 94e925b8022867b61b2a3106e2edf6e7a466d0b7 Mon Sep 17 00:00:00 2001 From: koishi-bot <105629226+koishi-bot@users.noreply.github.com> Date: Mon, 11 Dec 2023 13:22:29 +0800 Subject: [PATCH 0044/3075] New translations composition.md (Russian) [skip ci] --- ru-RU/api/console/composition.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/ru-RU/api/console/composition.md b/ru-RU/api/console/composition.md index 151fa0b39f3c..92253fa272ec 100644 --- a/ru-RU/api/console/composition.md +++ b/ru-RU/api/console/composition.md @@ -1,6 +1,6 @@ # 组合式 API -::: tip +:::tip 本节中所涉及的 API 都在 @koishijs/client 中导出。 ::: From 91c742ab77c655ccac1088e790595b246445eba8 Mon Sep 17 00:00:00 2001 From: koishi-bot <105629226+koishi-bot@users.noreply.github.com> Date: Mon, 11 Dec 2023 13:22:30 +0800 Subject: [PATCH 0045/3075] New translations composition.md (Chinese Traditional) [skip ci] --- zh-TW/api/console/composition.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/zh-TW/api/console/composition.md b/zh-TW/api/console/composition.md index 151fa0b39f3c..92253fa272ec 100644 --- a/zh-TW/api/console/composition.md +++ b/zh-TW/api/console/composition.md @@ -1,6 +1,6 @@ # 组合式 API -::: tip +:::tip 本节中所涉及的 API 都在 @koishijs/client 中导出。 ::: From ff96709e1a0a82572bb67f6d6c4f84f52cbc76c1 Mon Sep 17 00:00:00 2001 From: koishi-bot <105629226+koishi-bot@users.noreply.github.com> Date: Mon, 11 Dec 2023 13:22:31 +0800 Subject: [PATCH 0046/3075] New translations composition.md (English, United States) [skip ci] --- en-US/api/console/composition.md | 12 ++++++------ 1 file changed, 6 insertions(+), 6 deletions(-) diff --git a/en-US/api/console/composition.md b/en-US/api/console/composition.md index c2eb28d6a483..92253fa272ec 100644 --- a/en-US/api/console/composition.md +++ b/en-US/api/console/composition.md @@ -1,18 +1,18 @@ -# Combined API +# 组合式 API -::: tip -The APIs mentioned in this section are exported in @koishijs/client. +:::tip +本节中所涉及的 API 都在 @koishijs/client 中导出。 ::: ## useConfig() -- Return value: `Ref` +- 返回值: `Ref` -Get user settings. +获取用户设置。 ## useContext() -- Return value: [`Context`](./context.md) +- 返回值: [`Context`](./context.md) 获取当前组件所在的插件上下文。 From 8dca14d75e9b77e7601c4ae3d6fed08865d1fdc1 Mon Sep 17 00:00:00 2001 From: koishi-bot <105629226+koishi-bot@users.noreply.github.com> Date: Mon, 11 Dec 2023 13:22:32 +0800 Subject: [PATCH 0047/3075] New translations context.md (French) [skip ci] --- fr-FR/api/console/context.md | 12 ++++++------ 1 file changed, 6 insertions(+), 6 deletions(-) diff --git a/fr-FR/api/console/context.md b/fr-FR/api/console/context.md index 9a831073d236..52857be9fbb0 100644 --- a/fr-FR/api/console/context.md +++ b/fr-FR/api/console/context.md @@ -1,6 +1,6 @@ # 上下文 API -::: warning +:::warning 请注意：本文档介绍的是控制台客户端的 `Context`，而非 Koishi 本身的 `Context`。要查看后者的 API 文档请 [前往这里](../core/context.md)。 ::: @@ -37,11 +37,11 @@ Koishi 的控制台客户端一样通过插件化的方式加载，因此我们 - **id:** `string` 菜单标识符 - **items:** `MenuItem[]` 菜单项列表 - - **items[].id:** `string` 动作标识符 - - **items[].label:** `MaybeGetter?` 菜单项名称 - - **items[].type:** `MaybeGetter?` 菜单项类型 - - **items[].icon:** `MaybeGetter?` 菜单项图标 - - **items[].order:** `number?` 排列优先级 + - **items\[].id:** `string` 动作标识符 + - **items\[].label:** `MaybeGetter?` 菜单项名称 + - **items\[].type:** `MaybeGetter?` 菜单项类型 + - **items\[].icon:** `MaybeGetter?` 菜单项图标 + - **items\[].order:** `number?` 排列优先级 注册一个菜单。 From add7b991cc1876fb849d898f232e235183cb6c2c Mon Sep 17 00:00:00 2001 From: koishi-bot <105629226+koishi-bot@users.noreply.github.com> Date: Mon, 11 Dec 2023 13:22:33 +0800 Subject: [PATCH 0048/3075] New translations context.md (German) [skip ci] --- de-DE/api/console/context.md | 12 ++++++------ 1 file changed, 6 insertions(+), 6 deletions(-) diff --git a/de-DE/api/console/context.md b/de-DE/api/console/context.md index 9a831073d236..52857be9fbb0 100644 --- a/de-DE/api/console/context.md +++ b/de-DE/api/console/context.md @@ -1,6 +1,6 @@ # 上下文 API -::: warning +:::warning 请注意：本文档介绍的是控制台客户端的 `Context`，而非 Koishi 本身的 `Context`。要查看后者的 API 文档请 [前往这里](../core/context.md)。 ::: @@ -37,11 +37,11 @@ Koishi 的控制台客户端一样通过插件化的方式加载，因此我们 - **id:** `string` 菜单标识符 - **items:** `MenuItem[]` 菜单项列表 - - **items[].id:** `string` 动作标识符 - - **items[].label:** `MaybeGetter?` 菜单项名称 - - **items[].type:** `MaybeGetter?` 菜单项类型 - - **items[].icon:** `MaybeGetter?` 菜单项图标 - - **items[].order:** `number?` 排列优先级 + - **items\[].id:** `string` 动作标识符 + - **items\[].label:** `MaybeGetter?` 菜单项名称 + - **items\[].type:** `MaybeGetter?` 菜单项类型 + - **items\[].icon:** `MaybeGetter?` 菜单项图标 + - **items\[].order:** `number?` 排列优先级 注册一个菜单。 From 437be5e9478786a8e78184b448c90bc467bc46c1 Mon Sep 17 00:00:00 2001 From: koishi-bot <105629226+koishi-bot@users.noreply.github.com> Date: Mon, 11 Dec 2023 13:22:34 +0800 Subject: [PATCH 0049/3075] New translations context.md (Japanese) [skip ci] --- ja-JP/api/console/context.md | 12 ++++++------ 1 file changed, 6 insertions(+), 6 deletions(-) diff --git a/ja-JP/api/console/context.md b/ja-JP/api/console/context.md index 9a831073d236..52857be9fbb0 100644 --- a/ja-JP/api/console/context.md +++ b/ja-JP/api/console/context.md @@ -1,6 +1,6 @@ # 上下文 API -::: warning +:::warning 请注意：本文档介绍的是控制台客户端的 `Context`，而非 Koishi 本身的 `Context`。要查看后者的 API 文档请 [前往这里](../core/context.md)。 ::: @@ -37,11 +37,11 @@ Koishi 的控制台客户端一样通过插件化的方式加载，因此我们 - **id:** `string` 菜单标识符 - **items:** `MenuItem[]` 菜单项列表 - - **items[].id:** `string` 动作标识符 - - **items[].label:** `MaybeGetter?` 菜单项名称 - - **items[].type:** `MaybeGetter?` 菜单项类型 - - **items[].icon:** `MaybeGetter?` 菜单项图标 - - **items[].order:** `number?` 排列优先级 + - **items\[].id:** `string` 动作标识符 + - **items\[].label:** `MaybeGetter?` 菜单项名称 + - **items\[].type:** `MaybeGetter?` 菜单项类型 + - **items\[].icon:** `MaybeGetter?` 菜单项图标 + - **items\[].order:** `number?` 排列优先级 注册一个菜单。 From 765f8e3c665145b2027cc62ae8e8ec0d094fda75 Mon Sep 17 00:00:00 2001 From: koishi-bot <105629226+koishi-bot@users.noreply.github.com> Date: Mon, 11 Dec 2023 13:22:36 +0800 Subject: [PATCH 0050/3075] New translations context.md (Russian) [skip ci] --- ru-RU/api/console/context.md | 12 ++++++------ 1 file changed, 6 insertions(+), 6 deletions(-) diff --git a/ru-RU/api/console/context.md b/ru-RU/api/console/context.md index 9a831073d236..52857be9fbb0 100644 --- a/ru-RU/api/console/context.md +++ b/ru-RU/api/console/context.md @@ -1,6 +1,6 @@ # 上下文 API -::: warning +:::warning 请注意：本文档介绍的是控制台客户端的 `Context`，而非 Koishi 本身的 `Context`。要查看后者的 API 文档请 [前往这里](../core/context.md)。 ::: @@ -37,11 +37,11 @@ Koishi 的控制台客户端一样通过插件化的方式加载，因此我们 - **id:** `string` 菜单标识符 - **items:** `MenuItem[]` 菜单项列表 - - **items[].id:** `string` 动作标识符 - - **items[].label:** `MaybeGetter?` 菜单项名称 - - **items[].type:** `MaybeGetter?` 菜单项类型 - - **items[].icon:** `MaybeGetter?` 菜单项图标 - - **items[].order:** `number?` 排列优先级 + - **items\[].id:** `string` 动作标识符 + - **items\[].label:** `MaybeGetter?` 菜单项名称 + - **items\[].type:** `MaybeGetter?` 菜单项类型 + - **items\[].icon:** `MaybeGetter?` 菜单项图标 + - **items\[].order:** `number?` 排列优先级 注册一个菜单。 From 3631d88a9624169d1e3e6dd6a028e9d9a80be6be Mon Sep 17 00:00:00 2001 From: koishi-bot <105629226+koishi-bot@users.noreply.github.com> Date: Mon, 11 Dec 2023 13:22:37 +0800 Subject: [PATCH 0051/3075] New translations context.md (Chinese Traditional) [skip ci] --- zh-TW/api/console/context.md | 12 ++++++------ 1 file changed, 6 insertions(+), 6 deletions(-) diff --git a/zh-TW/api/console/context.md b/zh-TW/api/console/context.md index 9a831073d236..52857be9fbb0 100644 --- a/zh-TW/api/console/context.md +++ b/zh-TW/api/console/context.md @@ -1,6 +1,6 @@ # 上下文 API -::: warning +:::warning 请注意：本文档介绍的是控制台客户端的 `Context`，而非 Koishi 本身的 `Context`。要查看后者的 API 文档请 [前往这里](../core/context.md)。 ::: @@ -37,11 +37,11 @@ Koishi 的控制台客户端一样通过插件化的方式加载，因此我们 - **id:** `string` 菜单标识符 - **items:** `MenuItem[]` 菜单项列表 - - **items[].id:** `string` 动作标识符 - - **items[].label:** `MaybeGetter?` 菜单项名称 - - **items[].type:** `MaybeGetter?` 菜单项类型 - - **items[].icon:** `MaybeGetter?` 菜单项图标 - - **items[].order:** `number?` 排列优先级 + - **items\[].id:** `string` 动作标识符 + - **items\[].label:** `MaybeGetter?` 菜单项名称 + - **items\[].type:** `MaybeGetter?` 菜单项类型 + - **items\[].icon:** `MaybeGetter?` 菜单项图标 + - **items\[].order:** `number?` 排列优先级 注册一个菜单。 From cd132e73ae14175c6078967e279e096578c11784 Mon Sep 17 00:00:00 2001 From: koishi-bot <105629226+koishi-bot@users.noreply.github.com> Date: Mon, 11 Dec 2023 13:22:38 +0800 Subject: [PATCH 0052/3075] New translations context.md (English, United States) [skip ci] --- en-US/api/console/context.md | 12 ++++++------ 1 file changed, 6 insertions(+), 6 deletions(-) diff --git a/en-US/api/console/context.md b/en-US/api/console/context.md index 9a831073d236..52857be9fbb0 100644 --- a/en-US/api/console/context.md +++ b/en-US/api/console/context.md @@ -1,6 +1,6 @@ # 上下文 API -::: warning +:::warning 请注意：本文档介绍的是控制台客户端的 `Context`，而非 Koishi 本身的 `Context`。要查看后者的 API 文档请 [前往这里](../core/context.md)。 ::: @@ -37,11 +37,11 @@ Koishi 的控制台客户端一样通过插件化的方式加载，因此我们 - **id:** `string` 菜单标识符 - **items:** `MenuItem[]` 菜单项列表 - - **items[].id:** `string` 动作标识符 - - **items[].label:** `MaybeGetter?` 菜单项名称 - - **items[].type:** `MaybeGetter?` 菜单项类型 - - **items[].icon:** `MaybeGetter?` 菜单项图标 - - **items[].order:** `number?` 排列优先级 + - **items\[].id:** `string` 动作标识符 + - **items\[].label:** `MaybeGetter?` 菜单项名称 + - **items\[].type:** `MaybeGetter?` 菜单项类型 + - **items\[].icon:** `MaybeGetter?` 菜单项图标 + - **items\[].order:** `number?` 排列优先级 注册一个菜单。 From fdd7edbfd9794fd1e7885ca26ed3ff392941dd2b Mon Sep 17 00:00:00 2001 From: koishi-bot <105629226+koishi-bot@users.noreply.github.com> Date: Mon, 11 Dec 2023 13:22:39 +0800 Subject: [PATCH 0053/3075] New translations server.md (French) [skip ci] --- fr-FR/api/console/server.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/fr-FR/api/console/server.md b/fr-FR/api/console/server.md index 2183372bb47d..624772f651fc 100644 --- a/fr-FR/api/console/server.md +++ b/fr-FR/api/console/server.md @@ -1,6 +1,6 @@ # 服务端 API -::: tip +:::tip 本节中所涉及的 API 都在 @koishijs/plugin-console 中导出。 ::: From 62df15d4640773212cd67c0dacbd7ae816cf8e7a Mon Sep 17 00:00:00 2001 From: koishi-bot <105629226+koishi-bot@users.noreply.github.com> Date: Mon, 11 Dec 2023 13:22:40 +0800 Subject: [PATCH 0054/3075] New translations server.md (German) [skip ci] --- de-DE/api/console/server.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/de-DE/api/console/server.md b/de-DE/api/console/server.md index 2183372bb47d..624772f651fc 100644 --- a/de-DE/api/console/server.md +++ b/de-DE/api/console/server.md @@ -1,6 +1,6 @@ # 服务端 API -::: tip +:::tip 本节中所涉及的 API 都在 @koishijs/plugin-console 中导出。 ::: From ef79f2a3095b8bc5e9e3088e6259b9e6aeac7d4c Mon Sep 17 00:00:00 2001 From: koishi-bot <105629226+koishi-bot@users.noreply.github.com> Date: Mon, 11 Dec 2023 13:22:41 +0800 Subject: [PATCH 0055/3075] New translations server.md (Japanese) [skip ci] --- ja-JP/api/console/server.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/ja-JP/api/console/server.md b/ja-JP/api/console/server.md index 2183372bb47d..624772f651fc 100644 --- a/ja-JP/api/console/server.md +++ b/ja-JP/api/console/server.md @@ -1,6 +1,6 @@ # 服务端 API -::: tip +:::tip 本节中所涉及的 API 都在 @koishijs/plugin-console 中导出。 ::: From cc908e42c6ff15b19cb338d8c10c4073f74b5612 Mon Sep 17 00:00:00 2001 From: koishi-bot <105629226+koishi-bot@users.noreply.github.com> Date: Mon, 11 Dec 2023 13:22:42 +0800 Subject: [PATCH 0056/3075] New translations server.md (Russian) [skip ci] --- ru-RU/api/console/server.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/ru-RU/api/console/server.md b/ru-RU/api/console/server.md index 2183372bb47d..624772f651fc 100644 --- a/ru-RU/api/console/server.md +++ b/ru-RU/api/console/server.md @@ -1,6 +1,6 @@ # 服务端 API -::: tip +:::tip 本节中所涉及的 API 都在 @koishijs/plugin-console 中导出。 ::: From f96fa432d2b267a92a260463614d579ec12d354a Mon Sep 17 00:00:00 2001 From: koishi-bot <105629226+koishi-bot@users.noreply.github.com> Date: Mon, 11 Dec 2023 13:22:43 +0800 Subject: [PATCH 0057/3075] New translations server.md (Chinese Traditional) [skip ci] --- zh-TW/api/console/server.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/zh-TW/api/console/server.md b/zh-TW/api/console/server.md index 2183372bb47d..624772f651fc 100644 --- a/zh-TW/api/console/server.md +++ b/zh-TW/api/console/server.md @@ -1,6 +1,6 @@ # 服务端 API -::: tip +:::tip 本节中所涉及的 API 都在 @koishijs/plugin-console 中导出。 ::: From 2de05cc56ef3589a21453d91e8f599a6618f09db Mon Sep 17 00:00:00 2001 From: koishi-bot <105629226+koishi-bot@users.noreply.github.com> Date: Mon, 11 Dec 2023 13:22:44 +0800 Subject: [PATCH 0058/3075] New translations server.md (English, United States) [skip ci] --- en-US/api/console/server.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/en-US/api/console/server.md b/en-US/api/console/server.md index 2183372bb47d..624772f651fc 100644 --- a/en-US/api/console/server.md +++ b/en-US/api/console/server.md @@ -1,6 +1,6 @@ # 服务端 API -::: tip +:::tip 本节中所涉及的 API 都在 @koishijs/plugin-console 中导出。 ::: From 71b03e2b0c1a3289bb2628ac1441600c0dc89407 Mon Sep 17 00:00:00 2001 From: koishi-bot <105629226+koishi-bot@users.noreply.github.com> Date: Mon, 11 Dec 2023 13:22:45 +0800 Subject: [PATCH 0059/3075] New translations adapter.md (French) [skip ci] --- fr-FR/api/core/adapter.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/fr-FR/api/core/adapter.md b/fr-FR/api/core/adapter.md index 5871c26c58e1..9297e8d32e24 100644 --- a/fr-FR/api/core/adapter.md +++ b/fr-FR/api/core/adapter.md @@ -1,6 +1,6 @@ # 适配器 (Adapter) -::: tip +:::tip 参见：[开发 > 跨平台 > 实现适配器](../../guide/adapter/adapter.md) ::: From b4aa8eb6d573fb531baa5677583c1bf32ec00be6 Mon Sep 17 00:00:00 2001 From: koishi-bot <105629226+koishi-bot@users.noreply.github.com> Date: Mon, 11 Dec 2023 13:22:46 +0800 Subject: [PATCH 0060/3075] New translations adapter.md (German) [skip ci] --- de-DE/api/core/adapter.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/de-DE/api/core/adapter.md b/de-DE/api/core/adapter.md index 5871c26c58e1..9297e8d32e24 100644 --- a/de-DE/api/core/adapter.md +++ b/de-DE/api/core/adapter.md @@ -1,6 +1,6 @@ # 适配器 (Adapter) -::: tip +:::tip 参见：[开发 > 跨平台 > 实现适配器](../../guide/adapter/adapter.md) ::: From 5396652ceab7cf52abf9837a4b53cb410d96e7e4 Mon Sep 17 00:00:00 2001 From: koishi-bot <105629226+koishi-bot@users.noreply.github.com> Date: Mon, 11 Dec 2023 13:22:47 +0800 Subject: [PATCH 0061/3075] New translations adapter.md (Japanese) [skip ci] --- ja-JP/api/core/adapter.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/ja-JP/api/core/adapter.md b/ja-JP/api/core/adapter.md index 5871c26c58e1..9297e8d32e24 100644 --- a/ja-JP/api/core/adapter.md +++ b/ja-JP/api/core/adapter.md @@ -1,6 +1,6 @@ # 适配器 (Adapter) -::: tip +:::tip 参见：[开发 > 跨平台 > 实现适配器](../../guide/adapter/adapter.md) ::: From bf9ae322404566b64ed63c6cd9aff330ad582123 Mon Sep 17 00:00:00 2001 From: koishi-bot <105629226+koishi-bot@users.noreply.github.com> Date: Mon, 11 Dec 2023 13:22:48 +0800 Subject: [PATCH 0062/3075] New translations adapter.md (Russian) [skip ci] --- ru-RU/api/core/adapter.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/ru-RU/api/core/adapter.md b/ru-RU/api/core/adapter.md index 5871c26c58e1..9297e8d32e24 100644 --- a/ru-RU/api/core/adapter.md +++ b/ru-RU/api/core/adapter.md @@ -1,6 +1,6 @@ # 适配器 (Adapter) -::: tip +:::tip 参见：[开发 > 跨平台 > 实现适配器](../../guide/adapter/adapter.md) ::: From a1a92d7fd23b7bad28b5fe1e578e6899134705db Mon Sep 17 00:00:00 2001 From: koishi-bot <105629226+koishi-bot@users.noreply.github.com> Date: Mon, 11 Dec 2023 13:22:49 +0800 Subject: [PATCH 0063/3075] New translations adapter.md (Chinese Traditional) [skip ci] --- zh-TW/api/core/adapter.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/zh-TW/api/core/adapter.md b/zh-TW/api/core/adapter.md index 5871c26c58e1..9297e8d32e24 100644 --- a/zh-TW/api/core/adapter.md +++ b/zh-TW/api/core/adapter.md @@ -1,6 +1,6 @@ # 适配器 (Adapter) -::: tip +:::tip 参见：[开发 > 跨平台 > 实现适配器](../../guide/adapter/adapter.md) ::: From 95e89dac128bff0d0644f54c7ac6d38cc65a81c7 Mon Sep 17 00:00:00 2001 From: koishi-bot <105629226+koishi-bot@users.noreply.github.com> Date: Mon, 11 Dec 2023 13:22:50 +0800 Subject: [PATCH 0064/3075] New translations adapter.md (English, United States) [skip ci] --- en-US/api/core/adapter.md | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/en-US/api/core/adapter.md b/en-US/api/core/adapter.md index e141174ce6f3..9297e8d32e24 100644 --- a/en-US/api/core/adapter.md +++ b/en-US/api/core/adapter.md @@ -1,6 +1,6 @@ -# Adapter +# 适配器 (Adapter) -::: tip +:::tip 参见：[开发 > 跨平台 > 实现适配器](../../guide/adapter/adapter.md) ::: From 86970269d1f7176934d5837c31600017f4dc1437 Mon Sep 17 00:00:00 2001 From: koishi-bot <105629226+koishi-bot@users.noreply.github.com> Date: Mon, 11 Dec 2023 13:22:51 +0800 Subject: [PATCH 0065/3075] New translations app.md (French) [skip ci] --- fr-FR/api/core/app.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/fr-FR/api/core/app.md b/fr-FR/api/core/app.md index 9ecda1457034..2ebdd28e1ca9 100644 --- a/fr-FR/api/core/app.md +++ b/fr-FR/api/core/app.md @@ -116,7 +116,7 @@ interface DelayOptions { ## 配置文件选项 -::: warning +:::warning 下面的配置项来自 Koishi 的命令行工具，仅可在配置文件中编辑，不支持在控制台中修改。 ::: From d4bea048a8f4926e30ea7763eb298ccab0f9076f Mon Sep 17 00:00:00 2001 From: koishi-bot <105629226+koishi-bot@users.noreply.github.com> Date: Mon, 11 Dec 2023 13:22:52 +0800 Subject: [PATCH 0066/3075] New translations app.md (German) [skip ci] --- de-DE/api/core/app.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/de-DE/api/core/app.md b/de-DE/api/core/app.md index 9ecda1457034..2ebdd28e1ca9 100644 --- a/de-DE/api/core/app.md +++ b/de-DE/api/core/app.md @@ -116,7 +116,7 @@ interface DelayOptions { ## 配置文件选项 -::: warning +:::warning 下面的配置项来自 Koishi 的命令行工具，仅可在配置文件中编辑，不支持在控制台中修改。 ::: From 834f4290abb70c5c14d9c81b1f768867929b97f5 Mon Sep 17 00:00:00 2001 From: koishi-bot <105629226+koishi-bot@users.noreply.github.com> Date: Mon, 11 Dec 2023 13:22:54 +0800 Subject: [PATCH 0067/3075] New translations app.md (Japanese) [skip ci] --- ja-JP/api/core/app.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/ja-JP/api/core/app.md b/ja-JP/api/core/app.md index 9ecda1457034..2ebdd28e1ca9 100644 --- a/ja-JP/api/core/app.md +++ b/ja-JP/api/core/app.md @@ -116,7 +116,7 @@ interface DelayOptions { ## 配置文件选项 -::: warning +:::warning 下面的配置项来自 Koishi 的命令行工具，仅可在配置文件中编辑，不支持在控制台中修改。 ::: From 1cd8a57a4ffae445bcf6bfb67bb43aff3e1b8802 Mon Sep 17 00:00:00 2001 From: koishi-bot <105629226+koishi-bot@users.noreply.github.com> Date: Mon, 11 Dec 2023 13:22:55 +0800 Subject: [PATCH 0068/3075] New translations app.md (Russian) [skip ci] --- ru-RU/api/core/app.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/ru-RU/api/core/app.md b/ru-RU/api/core/app.md index 9ecda1457034..2ebdd28e1ca9 100644 --- a/ru-RU/api/core/app.md +++ b/ru-RU/api/core/app.md @@ -116,7 +116,7 @@ interface DelayOptions { ## 配置文件选项 -::: warning +:::warning 下面的配置项来自 Koishi 的命令行工具，仅可在配置文件中编辑，不支持在控制台中修改。 ::: From 3246ffac1778da59ef590e97d41439c9189fc237 Mon Sep 17 00:00:00 2001 From: koishi-bot <105629226+koishi-bot@users.noreply.github.com> Date: Mon, 11 Dec 2023 13:22:56 +0800 Subject: [PATCH 0069/3075] New translations app.md (Chinese Traditional) [skip ci] --- zh-TW/api/core/app.md | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/zh-TW/api/core/app.md b/zh-TW/api/core/app.md index 9ecda1457034..b50635733c40 100644 --- a/zh-TW/api/core/app.md +++ b/zh-TW/api/core/app.md @@ -30,7 +30,7 @@ - 类型：`string` -Koishi 服务暴露在公网的地址。部分功能（例如 [adapter-telegram](../../plugins/adapter/telegram.md) 或是 [plugin-assets-local](https://assets.koishi.chat/plugins/local.html)）需要用到。 +Koishi 服務暴露在公網的地址。部分功能（例如 [adapter-telegram](../../plugins/adapter/telegram.md) 或是 [plugin-assets-local](https://assets.koishi.chat/plugins/local.html)）需要用到。 ## 基础设置 @@ -116,7 +116,7 @@ interface DelayOptions { ## 配置文件选项 -::: warning +:::warning 下面的配置项来自 Koishi 的命令行工具，仅可在配置文件中编辑，不支持在控制台中修改。 ::: From 4ee4695aa8a3a45ef9249732252a700de72201ff Mon Sep 17 00:00:00 2001 From: koishi-bot <105629226+koishi-bot@users.noreply.github.com> Date: Mon, 11 Dec 2023 13:22:57 +0800 Subject: [PATCH 0070/3075] New translations app.md (English, United States) [skip ci] --- en-US/api/core/app.md | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/en-US/api/core/app.md b/en-US/api/core/app.md index 5aaa4eceda66..2ebdd28e1ca9 100644 --- a/en-US/api/core/app.md +++ b/en-US/api/core/app.md @@ -1,4 +1,4 @@ -# App +# 应用 (App) **应用 (App)** 是程序的入口。可以通过 `new Context()` 构造或通过 `ctx.root` 访问。 @@ -116,7 +116,7 @@ interface DelayOptions { ## 配置文件选项 -::: warning +:::warning 下面的配置项来自 Koishi 的命令行工具，仅可在配置文件中编辑，不支持在控制台中修改。 ::: From 6246f2fd9263527f0fdfee1b9e52cfc3ccf2d6b3 Mon Sep 17 00:00:00 2001 From: koishi-bot <105629226+koishi-bot@users.noreply.github.com> Date: Mon, 11 Dec 2023 13:22:58 +0800 Subject: [PATCH 0071/3075] New translations bot.md (French) [skip ci] --- fr-FR/api/core/bot.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/fr-FR/api/core/bot.md b/fr-FR/api/core/bot.md index f75faa5ace13..5bf6c5eee7c0 100644 --- a/fr-FR/api/core/bot.md +++ b/fr-FR/api/core/bot.md @@ -1,6 +1,6 @@ # 机器人 (Bot) -::: tip +:::tip 参见：[开发 > 跨平台 > 实现机器人](../../guide/adapter/bot.md) ::: From df6f35502e788285292f8f0458de182900c62014 Mon Sep 17 00:00:00 2001 From: koishi-bot <105629226+koishi-bot@users.noreply.github.com> Date: Mon, 11 Dec 2023 13:22:59 +0800 Subject: [PATCH 0072/3075] New translations bot.md (German) [skip ci] --- de-DE/api/core/bot.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/de-DE/api/core/bot.md b/de-DE/api/core/bot.md index f75faa5ace13..5bf6c5eee7c0 100644 --- a/de-DE/api/core/bot.md +++ b/de-DE/api/core/bot.md @@ -1,6 +1,6 @@ # 机器人 (Bot) -::: tip +:::tip 参见：[开发 > 跨平台 > 实现机器人](../../guide/adapter/bot.md) ::: From 1a85256a660f64e4067a903a4abe74e3bc429d4c Mon Sep 17 00:00:00 2001 From: koishi-bot <105629226+koishi-bot@users.noreply.github.com> Date: Mon, 11 Dec 2023 13:23:00 +0800 Subject: [PATCH 0073/3075] New translations bot.md (Japanese) [skip ci] --- ja-JP/api/core/bot.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/ja-JP/api/core/bot.md b/ja-JP/api/core/bot.md index f75faa5ace13..5bf6c5eee7c0 100644 --- a/ja-JP/api/core/bot.md +++ b/ja-JP/api/core/bot.md @@ -1,6 +1,6 @@ # 机器人 (Bot) -::: tip +:::tip 参见：[开发 > 跨平台 > 实现机器人](../../guide/adapter/bot.md) ::: From 2634c3077ac8045225f0644d91678192040ca385 Mon Sep 17 00:00:00 2001 From: koishi-bot <105629226+koishi-bot@users.noreply.github.com> Date: Mon, 11 Dec 2023 13:23:01 +0800 Subject: [PATCH 0074/3075] New translations bot.md (Russian) [skip ci] --- ru-RU/api/core/bot.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/ru-RU/api/core/bot.md b/ru-RU/api/core/bot.md index f75faa5ace13..5bf6c5eee7c0 100644 --- a/ru-RU/api/core/bot.md +++ b/ru-RU/api/core/bot.md @@ -1,6 +1,6 @@ # 机器人 (Bot) -::: tip +:::tip 参见：[开发 > 跨平台 > 实现机器人](../../guide/adapter/bot.md) ::: From 53e85a148442c2e49bf957c7895d5e2cfcf049ce Mon Sep 17 00:00:00 2001 From: koishi-bot <105629226+koishi-bot@users.noreply.github.com> Date: Mon, 11 Dec 2023 13:23:03 +0800 Subject: [PATCH 0075/3075] New translations bot.md (Chinese Traditional) [skip ci] --- zh-TW/api/core/bot.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/zh-TW/api/core/bot.md b/zh-TW/api/core/bot.md index f75faa5ace13..5bf6c5eee7c0 100644 --- a/zh-TW/api/core/bot.md +++ b/zh-TW/api/core/bot.md @@ -1,6 +1,6 @@ # 机器人 (Bot) -::: tip +:::tip 参见：[开发 > 跨平台 > 实现机器人](../../guide/adapter/bot.md) ::: From 748879b887cc1df5b55c89f809b862add9b557a8 Mon Sep 17 00:00:00 2001 From: koishi-bot <105629226+koishi-bot@users.noreply.github.com> Date: Mon, 11 Dec 2023 13:23:04 +0800 Subject: [PATCH 0076/3075] New translations bot.md (English, United States) [skip ci] --- en-US/api/core/bot.md | 24 ++++++++++++------------ 1 file changed, 12 insertions(+), 12 deletions(-) diff --git a/en-US/api/core/bot.md b/en-US/api/core/bot.md index 2726e253d132..5bf6c5eee7c0 100644 --- a/en-US/api/core/bot.md +++ b/en-US/api/core/bot.md @@ -1,46 +1,46 @@ -# Bot +# 机器人 (Bot) -::: tip +:::tip 参见：[开发 > 跨平台 > 实现机器人](../../guide/adapter/bot.md) ::: **机器人 (Bot)** 是适配器的核心，它将不同平台的 API 封装成统一的格式供 Koishi 使用。而不同的适配器也可以自行扩展 Bot 实例上的属性和方法。 -## Instance Properties +## 实例属性 ### bot.adapter -- Type: [`Adchapter`](./adapter.md) +- 类型: [`Adapter`](./adapter.md) 当前 `Bot` 所在的 [Adapter](./adapter.md) 实例。 ### bot.config -- Type: `object` +- 类型: `object` 构造 `Bot` 实例时所使用的配置项。 ### bot.ctx -- Type: [`Context`](./context.md) +- 类型: [`Context`](./context.md) 当前 `Bot` 所在的 [Context](./context.md) 实例。 ### bot.internal -- Type: `object` +- 类型: `object` 当前机器人的 [内部接口](../../guide/adapter/bot.md#实现内部接口)。 ### bot.platform -- Type: `string` +- 类型: `string` 当前 `Bot` 的 [平台名称](../glossary.md#平台-platform)。 ### bot.selfId -- Type: `string` +- 类型: `string` 当前 `Bot` 的平台账号。 @@ -56,7 +56,7 @@ 当前 `Bot` 的用户信息。 -## Adapter Related +## 适配器相关 ### bot.start() @@ -74,9 +74,9 @@ ### bot.dispatch(session) -- **session:** [`Session`](./session.md) Session instance +- **session:** [`Session`](./session.md) 会话实例 -Dispatch a session event. +触发一个会话事件。 ### bot.session(event?) From c267f96ab8c4873664b6d616ceead3322dcc4b3e Mon Sep 17 00:00:00 2001 From: koishi-bot <105629226+koishi-bot@users.noreply.github.com> Date: Mon, 11 Dec 2023 13:23:05 +0800 Subject: [PATCH 0077/3075] New translations command.md (French) [skip ci] --- fr-FR/api/core/command.md | 8 +++++--- 1 file changed, 5 insertions(+), 3 deletions(-) diff --git a/fr-FR/api/core/command.md b/fr-FR/api/core/command.md index 37ba86ff9e44..49db35025ee8 100644 --- a/fr-FR/api/core/command.md +++ b/fr-FR/api/core/command.md @@ -1,6 +1,6 @@ # 指令 (Command) -::: tip +:::tip 参见：[开发 > 交互基础 > 指令开发](../../guide/basic/command.md) ::: @@ -83,7 +83,8 @@ type CommandAction = (argv: Argv, ...args: any[]) => Awaitable - **fields:** `FieldCollector` 要请求的用户字段 - 返回值: `this` -如果指令需要用到用户数据，你可以提前声明，这样有助于合并多次请求，从而提高性能。 参见[按需加载](../../guide/database/builtin.md#声明所需字段)章节。 +如果指令需要用到用户数据，你可以提前声明，这样有助于合并多次请求，从而提高性能。 +参见[按需加载](../../guide/database/builtin.md#声明所需字段)章节。 ```ts type FieldCollector = @@ -96,7 +97,8 @@ type FieldCollector = - **fields:** `FieldCollector` 要请求的频道字段 - 返回值: `this` -如果指令需要用到频道数据，你可以提前声明，这样有助于合并多次请求，从而提高性能。 参见[按需加载](../../guide/database/builtin.md#声明所需字段)章节。 +如果指令需要用到频道数据，你可以提前声明，这样有助于合并多次请求，从而提高性能。 +参见[按需加载](../../guide/database/builtin.md#声明所需字段)章节。 ### cmd.alias(...names) From 3dcb568d5f458224d43c4594d8f067ab4d593549 Mon Sep 17 00:00:00 2001 From: koishi-bot <105629226+koishi-bot@users.noreply.github.com> Date: Mon, 11 Dec 2023 13:23:06 +0800 Subject: [PATCH 0078/3075] New translations command.md (German) [skip ci] --- de-DE/api/core/command.md | 8 +++++--- 1 file changed, 5 insertions(+), 3 deletions(-) diff --git a/de-DE/api/core/command.md b/de-DE/api/core/command.md index 37ba86ff9e44..49db35025ee8 100644 --- a/de-DE/api/core/command.md +++ b/de-DE/api/core/command.md @@ -1,6 +1,6 @@ # 指令 (Command) -::: tip +:::tip 参见：[开发 > 交互基础 > 指令开发](../../guide/basic/command.md) ::: @@ -83,7 +83,8 @@ type CommandAction = (argv: Argv, ...args: any[]) => Awaitable - **fields:** `FieldCollector` 要请求的用户字段 - 返回值: `this` -如果指令需要用到用户数据，你可以提前声明，这样有助于合并多次请求，从而提高性能。 参见[按需加载](../../guide/database/builtin.md#声明所需字段)章节。 +如果指令需要用到用户数据，你可以提前声明，这样有助于合并多次请求，从而提高性能。 +参见[按需加载](../../guide/database/builtin.md#声明所需字段)章节。 ```ts type FieldCollector = @@ -96,7 +97,8 @@ type FieldCollector = - **fields:** `FieldCollector` 要请求的频道字段 - 返回值: `this` -如果指令需要用到频道数据，你可以提前声明，这样有助于合并多次请求，从而提高性能。 参见[按需加载](../../guide/database/builtin.md#声明所需字段)章节。 +如果指令需要用到频道数据，你可以提前声明，这样有助于合并多次请求，从而提高性能。 +参见[按需加载](../../guide/database/builtin.md#声明所需字段)章节。 ### cmd.alias(...names) From 31e73d7326606de560fdead1936fc304b0911f06 Mon Sep 17 00:00:00 2001 From: koishi-bot <105629226+koishi-bot@users.noreply.github.com> Date: Mon, 11 Dec 2023 13:23:07 +0800 Subject: [PATCH 0079/3075] New translations command.md (Japanese) [skip ci] --- ja-JP/api/core/command.md | 8 +++++--- 1 file changed, 5 insertions(+), 3 deletions(-) diff --git a/ja-JP/api/core/command.md b/ja-JP/api/core/command.md index 37ba86ff9e44..49db35025ee8 100644 --- a/ja-JP/api/core/command.md +++ b/ja-JP/api/core/command.md @@ -1,6 +1,6 @@ # 指令 (Command) -::: tip +:::tip 参见：[开发 > 交互基础 > 指令开发](../../guide/basic/command.md) ::: @@ -83,7 +83,8 @@ type CommandAction = (argv: Argv, ...args: any[]) => Awaitable - **fields:** `FieldCollector` 要请求的用户字段 - 返回值: `this` -如果指令需要用到用户数据，你可以提前声明，这样有助于合并多次请求，从而提高性能。 参见[按需加载](../../guide/database/builtin.md#声明所需字段)章节。 +如果指令需要用到用户数据，你可以提前声明，这样有助于合并多次请求，从而提高性能。 +参见[按需加载](../../guide/database/builtin.md#声明所需字段)章节。 ```ts type FieldCollector = @@ -96,7 +97,8 @@ type FieldCollector = - **fields:** `FieldCollector` 要请求的频道字段 - 返回值: `this` -如果指令需要用到频道数据，你可以提前声明，这样有助于合并多次请求，从而提高性能。 参见[按需加载](../../guide/database/builtin.md#声明所需字段)章节。 +如果指令需要用到频道数据，你可以提前声明，这样有助于合并多次请求，从而提高性能。 +参见[按需加载](../../guide/database/builtin.md#声明所需字段)章节。 ### cmd.alias(...names) From 15f25c93072b4cb33923b8ec40d40a46e8bf56b1 Mon Sep 17 00:00:00 2001 From: koishi-bot <105629226+koishi-bot@users.noreply.github.com> Date: Mon, 11 Dec 2023 13:23:09 +0800 Subject: [PATCH 0080/3075] New translations command.md (Russian) [skip ci] --- ru-RU/api/core/command.md | 8 +++++--- 1 file changed, 5 insertions(+), 3 deletions(-) diff --git a/ru-RU/api/core/command.md b/ru-RU/api/core/command.md index 37ba86ff9e44..49db35025ee8 100644 --- a/ru-RU/api/core/command.md +++ b/ru-RU/api/core/command.md @@ -1,6 +1,6 @@ # 指令 (Command) -::: tip +:::tip 参见：[开发 > 交互基础 > 指令开发](../../guide/basic/command.md) ::: @@ -83,7 +83,8 @@ type CommandAction = (argv: Argv, ...args: any[]) => Awaitable - **fields:** `FieldCollector` 要请求的用户字段 - 返回值: `this` -如果指令需要用到用户数据，你可以提前声明，这样有助于合并多次请求，从而提高性能。 参见[按需加载](../../guide/database/builtin.md#声明所需字段)章节。 +如果指令需要用到用户数据，你可以提前声明，这样有助于合并多次请求，从而提高性能。 +参见[按需加载](../../guide/database/builtin.md#声明所需字段)章节。 ```ts type FieldCollector = @@ -96,7 +97,8 @@ type FieldCollector = - **fields:** `FieldCollector` 要请求的频道字段 - 返回值: `this` -如果指令需要用到频道数据，你可以提前声明，这样有助于合并多次请求，从而提高性能。 参见[按需加载](../../guide/database/builtin.md#声明所需字段)章节。 +如果指令需要用到频道数据，你可以提前声明，这样有助于合并多次请求，从而提高性能。 +参见[按需加载](../../guide/database/builtin.md#声明所需字段)章节。 ### cmd.alias(...names) From 998f09d7c77cdfacfac505d675bada59dae560da Mon Sep 17 00:00:00 2001 From: koishi-bot <105629226+koishi-bot@users.noreply.github.com> Date: Mon, 11 Dec 2023 13:23:10 +0800 Subject: [PATCH 0081/3075] New translations command.md (Chinese Traditional) [skip ci] --- zh-TW/api/core/command.md | 8 +++++--- 1 file changed, 5 insertions(+), 3 deletions(-) diff --git a/zh-TW/api/core/command.md b/zh-TW/api/core/command.md index 37ba86ff9e44..49db35025ee8 100644 --- a/zh-TW/api/core/command.md +++ b/zh-TW/api/core/command.md @@ -1,6 +1,6 @@ # 指令 (Command) -::: tip +:::tip 参见：[开发 > 交互基础 > 指令开发](../../guide/basic/command.md) ::: @@ -83,7 +83,8 @@ type CommandAction = (argv: Argv, ...args: any[]) => Awaitable - **fields:** `FieldCollector` 要请求的用户字段 - 返回值: `this` -如果指令需要用到用户数据，你可以提前声明，这样有助于合并多次请求，从而提高性能。 参见[按需加载](../../guide/database/builtin.md#声明所需字段)章节。 +如果指令需要用到用户数据，你可以提前声明，这样有助于合并多次请求，从而提高性能。 +参见[按需加载](../../guide/database/builtin.md#声明所需字段)章节。 ```ts type FieldCollector = @@ -96,7 +97,8 @@ type FieldCollector = - **fields:** `FieldCollector` 要请求的频道字段 - 返回值: `this` -如果指令需要用到频道数据，你可以提前声明，这样有助于合并多次请求，从而提高性能。 参见[按需加载](../../guide/database/builtin.md#声明所需字段)章节。 +如果指令需要用到频道数据，你可以提前声明，这样有助于合并多次请求，从而提高性能。 +参见[按需加载](../../guide/database/builtin.md#声明所需字段)章节。 ### cmd.alias(...names) From 6bf6f7c8a727322ca35dc1a0a8bb0d1b27b9697e Mon Sep 17 00:00:00 2001 From: koishi-bot <105629226+koishi-bot@users.noreply.github.com> Date: Mon, 11 Dec 2023 13:23:11 +0800 Subject: [PATCH 0082/3075] New translations command.md (English, United States) [skip ci] --- en-US/api/core/command.md | 10 ++++++---- 1 file changed, 6 insertions(+), 4 deletions(-) diff --git a/en-US/api/core/command.md b/en-US/api/core/command.md index 2d63bf8f540e..49db35025ee8 100644 --- a/en-US/api/core/command.md +++ b/en-US/api/core/command.md @@ -1,6 +1,6 @@ -# Command +# 指令 (Command) -::: tip +:::tip 参见：[开发 > 交互基础 > 指令开发](../../guide/basic/command.md) ::: @@ -83,7 +83,8 @@ type CommandAction = (argv: Argv, ...args: any[]) => Awaitable - **fields:** `FieldCollector` 要请求的用户字段 - 返回值: `this` -如果指令需要用到用户数据，你可以提前声明，这样有助于合并多次请求，从而提高性能。 参见[按需加载](../../guide/database/builtin.md#声明所需字段)章节。 +如果指令需要用到用户数据，你可以提前声明，这样有助于合并多次请求，从而提高性能。 +参见[按需加载](../../guide/database/builtin.md#声明所需字段)章节。 ```ts type FieldCollector = @@ -96,7 +97,8 @@ type FieldCollector = - **fields:** `FieldCollector` 要请求的频道字段 - 返回值: `this` -如果指令需要用到频道数据，你可以提前声明，这样有助于合并多次请求，从而提高性能。 参见[按需加载](../../guide/database/builtin.md#声明所需字段)章节。 +如果指令需要用到频道数据，你可以提前声明，这样有助于合并多次请求，从而提高性能。 +参见[按需加载](../../guide/database/builtin.md#声明所需字段)章节。 ### cmd.alias(...names) From e131e8800fcae64d0dbae9548fcd617ef8b90a2c Mon Sep 17 00:00:00 2001 From: koishi-bot <105629226+koishi-bot@users.noreply.github.com> Date: Mon, 11 Dec 2023 13:23:12 +0800 Subject: [PATCH 0083/3075] New translations context.md (French) [skip ci] --- fr-FR/api/core/context.md | 1 - 1 file changed, 1 deletion(-) diff --git a/fr-FR/api/core/context.md b/fr-FR/api/core/context.md index b46322c4a32a..0844bc54e09c 100644 --- a/fr-FR/api/core/context.md +++ b/fr-FR/api/core/context.md @@ -63,7 +63,6 @@ Koishi 使用了组合 (Compose) 的开发方式，绝大部分上下文属性 以当前上下文为原型创建一个新上下文。`meta` 中的属性将覆盖当前上下文的属性。 - - - - - - - From 95a53f1495c1c25452da162d2608866d35e2c45e Mon Sep 17 00:00:00 2001 From: koishi-bot <105629226+koishi-bot@users.noreply.github.com> Date: Mon, 11 Dec 2023 13:29:34 +0800 Subject: [PATCH 0379/3075] New translations builtin.md (Chinese Traditional) [skip ci] --- zh-TW/guide/database/builtin.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/zh-TW/guide/database/builtin.md b/zh-TW/guide/database/builtin.md index a6cb9aafb9c3..899dfa43780e 100644 --- a/zh-TW/guide/database/builtin.md +++ b/zh-TW/guide/database/builtin.md @@ -1,4 +1,4 @@ -# 內建資料結構 +# 内置数据结构 From 9d05b2f3828cbec83c89cddaff2bbab954bb0962 Mon Sep 17 00:00:00 2001 From: koishi-bot <105629226+koishi-bot@users.noreply.github.com> Date: Mon, 11 Dec 2023 13:29:35 +0800 Subject: [PATCH 0380/3075] New translations builtin.md (English, United States) [skip ci] --- en-US/guide/database/builtin.md | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/en-US/guide/database/builtin.md b/en-US/guide/database/builtin.md index 1b4e8fb894bd..899dfa43780e 100644 --- a/en-US/guide/database/builtin.md +++ b/en-US/guide/database/builtin.md @@ -1,4 +1,4 @@ -# Built-in Data Structure +# 内置数据结构 @@ -61,7 +61,7 @@ cmd.userFields((argv, fields) => { 你可以在 [这里](../../api/utils/observer.md) 看到完整的观察者 API。 -## Advanced Usage +## 进阶用法 ### attach 事件 From d06b142f7079e6620eeb95fe465ff1f884a5c996 Mon Sep 17 00:00:00 2001 From: koishi-bot <105629226+koishi-bot@users.noreply.github.com> Date: Mon, 11 Dec 2023 13:29:36 +0800 Subject: [PATCH 0381/3075] New translations index.md (French) [skip ci] --- fr-FR/guide/database/index.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/fr-FR/guide/database/index.md b/fr-FR/guide/database/index.md index c3f5878207f9..375e75b30925 100644 --- a/fr-FR/guide/database/index.md +++ b/fr-FR/guide/database/index.md @@ -1,6 +1,6 @@ # 基本用法 -::: tip +:::tip `ctx.database` 并非内置服务，因此如果你的插件需要使用数据库功能，需要[声明依赖](../plugin/service.md#inject-属性)。 ::: From 38d41368b1804caffcea30c6ce4fc029fde7f12e Mon Sep 17 00:00:00 2001 From: koishi-bot <105629226+koishi-bot@users.noreply.github.com> Date: Mon, 11 Dec 2023 13:29:37 +0800 Subject: [PATCH 0382/3075] New translations index.md (German) [skip ci] --- de-DE/guide/database/index.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/de-DE/guide/database/index.md b/de-DE/guide/database/index.md index 0dbfd15fa30c..d39e0ceee881 100644 --- a/de-DE/guide/database/index.md +++ b/de-DE/guide/database/index.md @@ -1,6 +1,6 @@ # 基本用法 -::: tip +:::tip `ctx.database` 并非内置服务，因此如果你的插件需要使用数据库功能，需要[声明依赖](../plugin/service.md#inject-属性)。 ::: From 2c1a5e6f2c0099578987e9f1c909e1ba7fe9afe0 Mon Sep 17 00:00:00 2001 From: koishi-bot <105629226+koishi-bot@users.noreply.github.com> Date: Mon, 11 Dec 2023 13:29:38 +0800 Subject: [PATCH 0383/3075] New translations index.md (Japanese) [skip ci] --- ja-JP/guide/database/index.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/ja-JP/guide/database/index.md b/ja-JP/guide/database/index.md index 6577d64b1c4e..0154447a51d5 100644 --- a/ja-JP/guide/database/index.md +++ b/ja-JP/guide/database/index.md @@ -1,6 +1,6 @@ # 基本用法 -::: tip +:::tip `ctx.database` 并非内置服务，因此如果你的插件需要使用数据库功能，需要[声明依赖](../plugin/service.md#inject-属性)。 ::: From ea0a5db361a306e961fecbe91c5eb0bdec62516f Mon Sep 17 00:00:00 2001 From: koishi-bot <105629226+koishi-bot@users.noreply.github.com> Date: Mon, 11 Dec 2023 13:29:39 +0800 Subject: [PATCH 0384/3075] New translations index.md (Russian) [skip ci] --- ru-RU/guide/database/index.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/ru-RU/guide/database/index.md b/ru-RU/guide/database/index.md index 0dbfd15fa30c..d39e0ceee881 100644 --- a/ru-RU/guide/database/index.md +++ b/ru-RU/guide/database/index.md @@ -1,6 +1,6 @@ # 基本用法 -::: tip +:::tip `ctx.database` 并非内置服务，因此如果你的插件需要使用数据库功能，需要[声明依赖](../plugin/service.md#inject-属性)。 ::: From f5294d93b7fc513bf36b3215b44fbe432935987d Mon Sep 17 00:00:00 2001 From: koishi-bot <105629226+koishi-bot@users.noreply.github.com> Date: Mon, 11 Dec 2023 13:29:40 +0800 Subject: [PATCH 0385/3075] New translations index.md (Chinese Traditional) [skip ci] --- zh-TW/guide/database/index.md | 16 ++++++++-------- 1 file changed, 8 insertions(+), 8 deletions(-) diff --git a/zh-TW/guide/database/index.md b/zh-TW/guide/database/index.md index 8a547e6473f2..d39e0ceee881 100644 --- a/zh-TW/guide/database/index.md +++ b/zh-TW/guide/database/index.md @@ -1,31 +1,31 @@ # 基本用法 -::: tip +:::tip `ctx.database` 并非内置服务，因此如果你的插件需要使用数据库功能，需要[声明依赖](../plugin/service.md#inject-属性)。 ::: -對於幾乎所有大型機器人專案，資料庫的使用都是不可或缺的。但如果每个插件都独立处理与数据库的交互，这将导致插件之间的兼容性非常差——用户要么选择同时安装多个数据库，要么只能放弃一些功能。为此，Koishi 设计了一整套对象关系映射 (ORM) 接口，它易于扩展并广泛地运用于各种插件中，足以应对绝大部分使用场景。 +对于几乎所有大型机器人项目，数据库的使用都是不可或缺的。但如果每个插件都独立处理与数据库的交互，这将导致插件之间的兼容性非常差——用户要么选择同时安装多个数据库，要么只能放弃一些功能。为此，Koishi 设计了一整套对象关系映射 (ORM) 接口，它易于扩展并广泛地运用于各种插件中，足以应对绝大部分使用场景。 ## `get`：查询数据 -使用 `database.get()` 方法以獲取特定表中的資料。下面是一個最基本的形式： +使用 `database.get()` 方法以获取特定表中的数据。下面是一个最基本的形式： ```ts -// 獲取 schedule 表中 id 為 1234 的資料行，返回一個陣列 +// 获取 schedule 表中 id 为 1234 的数据行，返回一个数组 await ctx.database.get('schedule', 1234) -// 獲取 schedule 表中 id 為 1234 或 5678 的資料行，返回一個陣列 +// 获取 schedule 表中 id 为 1234 或 5678 的数据行，返回一个数组 await ctx.database.get('schedule', [1234, 5678]) ``` -對於複雜的資料表，如果你只需要獲取少數欄位，你可以透過第三個引數手動指定要獲取的欄位： +对于复杂的数据表，如果你只需要获取少数字段，你可以通过第三个参数手动指定要获取的字段： ```ts // 返回的数组中每个元素只会包含 command, time 属性 await ctx.database.get('schedule', [1234], ['command', 'time']) ``` -你還可以向第二個引數傳入一個物件，用來查詢非主鍵上的資料或者同時指定多行的值： +你还可以向第二个参数传入一个对象，用来查询非主键上的数据或者同时指定多列的值： ```ts // 获取名为 schedule 的表中 assignee 为 telegram:123456 的数据行 @@ -118,7 +118,7 @@ await ctx.database.upsert('foo', [ 那么进行上述操作后的数据库将是这样的： -| id | foo | bar | 說明 | +| id | foo | bar | 说明 | | -- | ----- | ------ | ---------------------------------- | | 1 | hello | baz | 该行已经存在，只更新了 foo 字段 | | 2 | world | bar | 插入了新行，其中 foo 字段取自传入的数据，bar 字段取自默认值 | From 89022f3f1b98ee77d6775f8a6164296da70abfd9 Mon Sep 17 00:00:00 2001 From: koishi-bot <105629226+koishi-bot@users.noreply.github.com> Date: Mon, 11 Dec 2023 13:29:42 +0800 Subject: [PATCH 0386/3075] New translations index.md (English, United States) [skip ci] --- en-US/guide/database/index.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/en-US/guide/database/index.md b/en-US/guide/database/index.md index f60ec659ca91..b5988f9bbe6d 100644 --- a/en-US/guide/database/index.md +++ b/en-US/guide/database/index.md @@ -1,6 +1,6 @@ # 基本用法 -::: tip +:::tip `ctx.database` 并非内置服务，因此如果你的插件需要使用数据库功能，需要[声明依赖](../plugin/service.md#inject-属性)。 ::: From 42a2245c08604fcb7febd374bcf2845851a95cd2 Mon Sep 17 00:00:00 2001 From: koishi-bot <105629226+koishi-bot@users.noreply.github.com> Date: Mon, 11 Dec 2023 13:29:43 +0800 Subject: [PATCH 0387/3075] New translations model.md (French) [skip ci] --- fr-FR/guide/database/model.md | 6 +++--- 1 file changed, 3 insertions(+), 3 deletions(-) diff --git a/fr-FR/guide/database/model.md b/fr-FR/guide/database/model.md index dad6b8613d97..2553bf380706 100644 --- a/fr-FR/guide/database/model.md +++ b/fr-FR/guide/database/model.md @@ -1,8 +1,8 @@ -# Modèle de données +# 数据模型 Koishi 的架构允许任何插件对数据库的结构进行扩展。你就可以在不修改 Koishi 或其他插件源码的情况下，为数据库添加新的字段或者表。这些功能都是通过 `ctx.model` 提供的。 -::: tip +:::tip 请注意：数据模型的扩展一定要在使用前完成，不然后续数据库操作可能会失败。 ::: @@ -143,7 +143,7 @@ ctx.model.extend('foo', {}, { ## 整表迁移 实验性 -::: warning +:::warning 整表迁移的性能较差，建议谨慎设计数据库结构而不是依赖迁移。 ::: From fe70a8563d273305d87a7a5fe4353811c512c9d1 Mon Sep 17 00:00:00 2001 From: koishi-bot <105629226+koishi-bot@users.noreply.github.com> Date: Mon, 11 Dec 2023 13:29:44 +0800 Subject: [PATCH 0388/3075] New translations model.md (German) [skip ci] --- de-DE/guide/database/model.md | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/de-DE/guide/database/model.md b/de-DE/guide/database/model.md index 8e1f4107cda3..2553bf380706 100644 --- a/de-DE/guide/database/model.md +++ b/de-DE/guide/database/model.md @@ -2,7 +2,7 @@ Koishi 的架构允许任何插件对数据库的结构进行扩展。你就可以在不修改 Koishi 或其他插件源码的情况下，为数据库添加新的字段或者表。这些功能都是通过 `ctx.model` 提供的。 -::: tip +:::tip 请注意：数据模型的扩展一定要在使用前完成，不然后续数据库操作可能会失败。 ::: @@ -143,7 +143,7 @@ ctx.model.extend('foo', {}, { ## 整表迁移 实验性 -::: warning +:::warning 整表迁移的性能较差，建议谨慎设计数据库结构而不是依赖迁移。 ::: From 9468a3c85bc5ee39b1c87ffe7c3cbb045d16694d Mon Sep 17 00:00:00 2001 From: koishi-bot <105629226+koishi-bot@users.noreply.github.com> Date: Mon, 11 Dec 2023 13:29:45 +0800 Subject: [PATCH 0389/3075] New translations model.md (Japanese) [skip ci] --- ja-JP/guide/database/model.md | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/ja-JP/guide/database/model.md b/ja-JP/guide/database/model.md index 8e1f4107cda3..2553bf380706 100644 --- a/ja-JP/guide/database/model.md +++ b/ja-JP/guide/database/model.md @@ -2,7 +2,7 @@ Koishi 的架构允许任何插件对数据库的结构进行扩展。你就可以在不修改 Koishi 或其他插件源码的情况下，为数据库添加新的字段或者表。这些功能都是通过 `ctx.model` 提供的。 -::: tip +:::tip 请注意：数据模型的扩展一定要在使用前完成，不然后续数据库操作可能会失败。 ::: @@ -143,7 +143,7 @@ ctx.model.extend('foo', {}, { ## 整表迁移 实验性 -::: warning +:::warning 整表迁移的性能较差，建议谨慎设计数据库结构而不是依赖迁移。 ::: From 7e66b0bcc77850f62e3643a6fd12d71963e99a1d Mon Sep 17 00:00:00 2001 From: koishi-bot <105629226+koishi-bot@users.noreply.github.com> Date: Mon, 11 Dec 2023 13:29:46 +0800 Subject: [PATCH 0390/3075] New translations model.md (Russian) [skip ci] --- ru-RU/guide/database/model.md | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/ru-RU/guide/database/model.md b/ru-RU/guide/database/model.md index 8e1f4107cda3..2553bf380706 100644 --- a/ru-RU/guide/database/model.md +++ b/ru-RU/guide/database/model.md @@ -2,7 +2,7 @@ Koishi 的架构允许任何插件对数据库的结构进行扩展。你就可以在不修改 Koishi 或其他插件源码的情况下，为数据库添加新的字段或者表。这些功能都是通过 `ctx.model` 提供的。 -::: tip +:::tip 请注意：数据模型的扩展一定要在使用前完成，不然后续数据库操作可能会失败。 ::: @@ -143,7 +143,7 @@ ctx.model.extend('foo', {}, { ## 整表迁移 实验性 -::: warning +:::warning 整表迁移的性能较差，建议谨慎设计数据库结构而不是依赖迁移。 ::: From cc1f4ff7716859694ffedfc47fabc97c603ecbf0 Mon Sep 17 00:00:00 2001 From: koishi-bot <105629226+koishi-bot@users.noreply.github.com> Date: Mon, 11 Dec 2023 13:29:47 +0800 Subject: [PATCH 0391/3075] New translations model.md (Chinese Traditional) [skip ci] --- zh-TW/guide/database/model.md | 6 +++--- 1 file changed, 3 insertions(+), 3 deletions(-) diff --git a/zh-TW/guide/database/model.md b/zh-TW/guide/database/model.md index 324791d619b0..2553bf380706 100644 --- a/zh-TW/guide/database/model.md +++ b/zh-TW/guide/database/model.md @@ -2,7 +2,7 @@ Koishi 的架构允许任何插件对数据库的结构进行扩展。你就可以在不修改 Koishi 或其他插件源码的情况下，为数据库添加新的字段或者表。这些功能都是通过 `ctx.model` 提供的。 -::: tip +:::tip 请注意：数据模型的扩展一定要在使用前完成，不然后续数据库操作可能会失败。 ::: @@ -53,7 +53,7 @@ ctx.model.extend('user', { }) ``` -## 資料型別 +## 数据类型 上面的数据类型均直接使用字符串来定义。对于更复杂的需求，你也可以选择传入一个对象： @@ -143,7 +143,7 @@ ctx.model.extend('foo', {}, { ## 整表迁移 实验性 -::: warning +:::warning 整表迁移的性能较差，建议谨慎设计数据库结构而不是依赖迁移。 ::: From c11df78044b74eeb40930338a3267b187d607e40 Mon Sep 17 00:00:00 2001 From: koishi-bot <105629226+koishi-bot@users.noreply.github.com> Date: Mon, 11 Dec 2023 13:29:48 +0800 Subject: [PATCH 0392/3075] New translations model.md (English, United States) [skip ci] --- en-US/guide/database/model.md | 6 +++--- 1 file changed, 3 insertions(+), 3 deletions(-) diff --git a/en-US/guide/database/model.md b/en-US/guide/database/model.md index dc9c4c928088..2553bf380706 100644 --- a/en-US/guide/database/model.md +++ b/en-US/guide/database/model.md @@ -1,8 +1,8 @@ -# Data Model +# 数据模型 Koishi 的架构允许任何插件对数据库的结构进行扩展。你就可以在不修改 Koishi 或其他插件源码的情况下，为数据库添加新的字段或者表。这些功能都是通过 `ctx.model` 提供的。 -::: tip +:::tip 请注意：数据模型的扩展一定要在使用前完成，不然后续数据库操作可能会失败。 ::: @@ -143,7 +143,7 @@ ctx.model.extend('foo', {}, { ## 整表迁移 实验性 -::: warning +:::warning 整表迁移的性能较差，建议谨慎设计数据库结构而不是依赖迁移。 ::: From 615d0671445ff6b933dfc6a403f808d4753bff39 Mon Sep 17 00:00:00 2001 From: koishi-bot <105629226+koishi-bot@users.noreply.github.com> Date: Mon, 11 Dec 2023 13:29:49 +0800 Subject: [PATCH 0393/3075] New translations permission.md (French) [skip ci] --- fr-FR/guide/database/permission.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/fr-FR/guide/database/permission.md b/fr-FR/guide/database/permission.md index 82babe1445b7..787070b4754c 100644 --- a/fr-FR/guide/database/permission.md +++ b/fr-FR/guide/database/permission.md @@ -1,6 +1,6 @@ # 权限管理 实验性 -::: warning +:::warning 权限管理目前属于实验性功能，API 可能随时会发生变化。 ::: From c5590da6da6b7489e26913e402bc810281476de8 Mon Sep 17 00:00:00 2001 From: koishi-bot <105629226+koishi-bot@users.noreply.github.com> Date: Mon, 11 Dec 2023 13:29:50 +0800 Subject: [PATCH 0394/3075] New translations permission.md (German) [skip ci] --- de-DE/guide/database/permission.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/de-DE/guide/database/permission.md b/de-DE/guide/database/permission.md index 82babe1445b7..787070b4754c 100644 --- a/de-DE/guide/database/permission.md +++ b/de-DE/guide/database/permission.md @@ -1,6 +1,6 @@ # 权限管理 实验性 -::: warning +:::warning 权限管理目前属于实验性功能，API 可能随时会发生变化。 ::: From 2e7d2d9dc9644f3f62073419bad5967c739dbb2b Mon Sep 17 00:00:00 2001 From: koishi-bot <105629226+koishi-bot@users.noreply.github.com> Date: Mon, 11 Dec 2023 13:29:51 +0800 Subject: [PATCH 0395/3075] New translations permission.md (Japanese) [skip ci] --- ja-JP/guide/database/permission.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/ja-JP/guide/database/permission.md b/ja-JP/guide/database/permission.md index 82babe1445b7..787070b4754c 100644 --- a/ja-JP/guide/database/permission.md +++ b/ja-JP/guide/database/permission.md @@ -1,6 +1,6 @@ # 权限管理 实验性 -::: warning +:::warning 权限管理目前属于实验性功能，API 可能随时会发生变化。 ::: From 9c64264244366c14f8b775e8de4556c963773b1e Mon Sep 17 00:00:00 2001 From: koishi-bot <105629226+koishi-bot@users.noreply.github.com> Date: Mon, 11 Dec 2023 13:29:52 +0800 Subject: [PATCH 0396/3075] New translations permission.md (Russian) [skip ci] --- ru-RU/guide/database/permission.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/ru-RU/guide/database/permission.md b/ru-RU/guide/database/permission.md index 82babe1445b7..787070b4754c 100644 --- a/ru-RU/guide/database/permission.md +++ b/ru-RU/guide/database/permission.md @@ -1,6 +1,6 @@ # 权限管理 实验性 -::: warning +:::warning 权限管理目前属于实验性功能，API 可能随时会发生变化。 ::: From 4dac9674ea7e2a646a10e5a1fa2c4ef82e44128d Mon Sep 17 00:00:00 2001 From: koishi-bot <105629226+koishi-bot@users.noreply.github.com> Date: Mon, 11 Dec 2023 13:29:53 +0800 Subject: [PATCH 0397/3075] New translations permission.md (Chinese Traditional) [skip ci] --- zh-TW/guide/database/permission.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/zh-TW/guide/database/permission.md b/zh-TW/guide/database/permission.md index 82babe1445b7..787070b4754c 100644 --- a/zh-TW/guide/database/permission.md +++ b/zh-TW/guide/database/permission.md @@ -1,6 +1,6 @@ # 权限管理 实验性 -::: warning +:::warning 权限管理目前属于实验性功能，API 可能随时会发生变化。 ::: From 118a72a007386180454106fdf29c16c6b791d05a Mon Sep 17 00:00:00 2001 From: koishi-bot <105629226+koishi-bot@users.noreply.github.com> Date: Mon, 11 Dec 2023 13:29:54 +0800 Subject: [PATCH 0398/3075] New translations permission.md (English, United States) [skip ci] --- en-US/guide/database/permission.md | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/en-US/guide/database/permission.md b/en-US/guide/database/permission.md index e257f248022a..787070b4754c 100644 --- a/en-US/guide/database/permission.md +++ b/en-US/guide/database/permission.md @@ -1,6 +1,6 @@ -# Permission Management 实验性 +# 权限管理 实验性 -::: warning +:::warning 权限管理目前属于实验性功能，API 可能随时会发生变化。 ::: From aed59d6c61d97eadce8ee63fbf2f78b7a3dd06de Mon Sep 17 00:00:00 2001 From: koishi-bot <105629226+koishi-bot@users.noreply.github.com> Date: Mon, 11 Dec 2023 13:29:59 +0800 Subject: [PATCH 0399/3075] New translations writing.md (French) [skip ci] --- fr-FR/guide/database/writing.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/fr-FR/guide/database/writing.md b/fr-FR/guide/database/writing.md index 6880b62a2c5d..60e7603655a0 100644 --- a/fr-FR/guide/database/writing.md +++ b/fr-FR/guide/database/writing.md @@ -1,6 +1,6 @@ # 编写数据库插件 -::: danger 注意 +:::danger 注意 此页文档正在施工，其中的内容可能不是最新。 ::: From a5769ed91267c9ac265f34c1aa0d4ff069a144ed Mon Sep 17 00:00:00 2001 From: koishi-bot <105629226+koishi-bot@users.noreply.github.com> Date: Mon, 11 Dec 2023 13:30:00 +0800 Subject: [PATCH 0400/3075] New translations writing.md (German) [skip ci] --- de-DE/guide/database/writing.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/de-DE/guide/database/writing.md b/de-DE/guide/database/writing.md index 6880b62a2c5d..60e7603655a0 100644 --- a/de-DE/guide/database/writing.md +++ b/de-DE/guide/database/writing.md @@ -1,6 +1,6 @@ # 编写数据库插件 -::: danger 注意 +:::danger 注意 此页文档正在施工，其中的内容可能不是最新。 ::: From f7bdb7ee6cf32ca176cf8697ee7542f4c96ae777 Mon Sep 17 00:00:00 2001 From: koishi-bot <105629226+koishi-bot@users.noreply.github.com> Date: Mon, 11 Dec 2023 13:30:01 +0800 Subject: [PATCH 0401/3075] New translations writing.md (Japanese) [skip ci] --- ja-JP/guide/database/writing.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/ja-JP/guide/database/writing.md b/ja-JP/guide/database/writing.md index 6880b62a2c5d..60e7603655a0 100644 --- a/ja-JP/guide/database/writing.md +++ b/ja-JP/guide/database/writing.md @@ -1,6 +1,6 @@ # 编写数据库插件 -::: danger 注意 +:::danger 注意 此页文档正在施工，其中的内容可能不是最新。 ::: From b2bcc914951fd1958a22ef53dca4be7cb662683e Mon Sep 17 00:00:00 2001 From: koishi-bot <105629226+koishi-bot@users.noreply.github.com> Date: Mon, 11 Dec 2023 13:30:02 +0800 Subject: [PATCH 0402/3075] New translations writing.md (Russian) [skip ci] --- ru-RU/guide/database/writing.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/ru-RU/guide/database/writing.md b/ru-RU/guide/database/writing.md index 6880b62a2c5d..60e7603655a0 100644 --- a/ru-RU/guide/database/writing.md +++ b/ru-RU/guide/database/writing.md @@ -1,6 +1,6 @@ # 编写数据库插件 -::: danger 注意 +:::danger 注意 此页文档正在施工，其中的内容可能不是最新。 ::: From 13d066f986c6ccbd2ec6add265ad9f321081f950 Mon Sep 17 00:00:00 2001 From: koishi-bot <105629226+koishi-bot@users.noreply.github.com> Date: Mon, 11 Dec 2023 13:30:03 +0800 Subject: [PATCH 0403/3075] New translations writing.md (Chinese Traditional) [skip ci] --- zh-TW/guide/database/writing.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/zh-TW/guide/database/writing.md b/zh-TW/guide/database/writing.md index 6880b62a2c5d..60e7603655a0 100644 --- a/zh-TW/guide/database/writing.md +++ b/zh-TW/guide/database/writing.md @@ -1,6 +1,6 @@ # 编写数据库插件 -::: danger 注意 +:::danger 注意 此页文档正在施工，其中的内容可能不是最新。 ::: From 14b64f306dd282d75743db12330bf2f70e6621db Mon Sep 17 00:00:00 2001 From: koishi-bot <105629226+koishi-bot@users.noreply.github.com> Date: Mon, 11 Dec 2023 13:30:04 +0800 Subject: [PATCH 0404/3075] New translations writing.md (English, United States) [skip ci] --- en-US/guide/database/writing.md | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/en-US/guide/database/writing.md b/en-US/guide/database/writing.md index 73abacbefbac..60e7603655a0 100644 --- a/en-US/guide/database/writing.md +++ b/en-US/guide/database/writing.md @@ -1,6 +1,6 @@ -# Database Plugin +# 编写数据库插件 -::: danger 注意 +:::danger 注意 此页文档正在施工，其中的内容可能不是最新。 ::: From 214b7483ee97b053f68917d179455fcb95b5cd79 Mon Sep 17 00:00:00 2001 From: koishi-bot <105629226+koishi-bot@users.noreply.github.com> Date: Mon, 11 Dec 2023 13:30:05 +0800 Subject: [PATCH 0405/3075] New translations config.md (French) [skip ci] --- fr-FR/guide/develop/config.md | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/fr-FR/guide/develop/config.md b/fr-FR/guide/develop/config.md index fa95ec3de199..9e65eeaf0c0e 100644 --- a/fr-FR/guide/develop/config.md +++ b/fr-FR/guide/develop/config.md @@ -1,6 +1,6 @@ # 配置文件 -::: warning +:::warning 配置文件的结构未来可能会发生变化，请留意后续更新。 ::: @@ -107,7 +107,7 @@ plugins: ## 修改配置文件 -::: tip +:::tip 如果你不了解 YAML 的语法，请不要随意修改配置文件，否则将可能导致 Koishi 应用无法运行。你可以在 [这篇教程](https://www.runoob.com/w3cnote/yaml-intro.html) 中学习 YAML 的语法。 ::: From 11dd7b87dfab1cf9c530cc9ce51ed9255f9b213d Mon Sep 17 00:00:00 2001 From: koishi-bot <105629226+koishi-bot@users.noreply.github.com> Date: Mon, 11 Dec 2023 13:30:06 +0800 Subject: [PATCH 0406/3075] New translations config.md (German) [skip ci] --- de-DE/guide/develop/config.md | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/de-DE/guide/develop/config.md b/de-DE/guide/develop/config.md index fa95ec3de199..9e65eeaf0c0e 100644 --- a/de-DE/guide/develop/config.md +++ b/de-DE/guide/develop/config.md @@ -1,6 +1,6 @@ # 配置文件 -::: warning +:::warning 配置文件的结构未来可能会发生变化，请留意后续更新。 ::: @@ -107,7 +107,7 @@ plugins: ## 修改配置文件 -::: tip +:::tip 如果你不了解 YAML 的语法，请不要随意修改配置文件，否则将可能导致 Koishi 应用无法运行。你可以在 [这篇教程](https://www.runoob.com/w3cnote/yaml-intro.html) 中学习 YAML 的语法。 ::: From 44da756116216e21c77aeed81dea712d27cf907d Mon Sep 17 00:00:00 2001 From: koishi-bot <105629226+koishi-bot@users.noreply.github.com> Date: Mon, 11 Dec 2023 13:30:07 +0800 Subject: [PATCH 0407/3075] New translations config.md (Japanese) [skip ci] --- ja-JP/guide/develop/config.md | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/ja-JP/guide/develop/config.md b/ja-JP/guide/develop/config.md index fa95ec3de199..9e65eeaf0c0e 100644 --- a/ja-JP/guide/develop/config.md +++ b/ja-JP/guide/develop/config.md @@ -1,6 +1,6 @@ # 配置文件 -::: warning +:::warning 配置文件的结构未来可能会发生变化，请留意后续更新。 ::: @@ -107,7 +107,7 @@ plugins: ## 修改配置文件 -::: tip +:::tip 如果你不了解 YAML 的语法，请不要随意修改配置文件，否则将可能导致 Koishi 应用无法运行。你可以在 [这篇教程](https://www.runoob.com/w3cnote/yaml-intro.html) 中学习 YAML 的语法。 ::: From 2ffc2271b6cf6865c1d2768279e1d6a4fc0db748 Mon Sep 17 00:00:00 2001 From: koishi-bot <105629226+koishi-bot@users.noreply.github.com> Date: Mon, 11 Dec 2023 13:30:08 +0800 Subject: [PATCH 0408/3075] New translations config.md (Russian) [skip ci] --- ru-RU/guide/develop/config.md | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/ru-RU/guide/develop/config.md b/ru-RU/guide/develop/config.md index fa95ec3de199..9e65eeaf0c0e 100644 --- a/ru-RU/guide/develop/config.md +++ b/ru-RU/guide/develop/config.md @@ -1,6 +1,6 @@ # 配置文件 -::: warning +:::warning 配置文件的结构未来可能会发生变化，请留意后续更新。 ::: @@ -107,7 +107,7 @@ plugins: ## 修改配置文件 -::: tip +:::tip 如果你不了解 YAML 的语法，请不要随意修改配置文件，否则将可能导致 Koishi 应用无法运行。你可以在 [这篇教程](https://www.runoob.com/w3cnote/yaml-intro.html) 中学习 YAML 的语法。 ::: From 593a5cd62b6cce2ec356ab9891efb908e9b4f0aa Mon Sep 17 00:00:00 2001 From: koishi-bot <105629226+koishi-bot@users.noreply.github.com> Date: Mon, 11 Dec 2023 13:30:09 +0800 Subject: [PATCH 0409/3075] New translations config.md (Chinese Traditional) [skip ci] --- zh-TW/guide/develop/config.md | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/zh-TW/guide/develop/config.md b/zh-TW/guide/develop/config.md index fa95ec3de199..9e65eeaf0c0e 100644 --- a/zh-TW/guide/develop/config.md +++ b/zh-TW/guide/develop/config.md @@ -1,6 +1,6 @@ # 配置文件 -::: warning +:::warning 配置文件的结构未来可能会发生变化，请留意后续更新。 ::: @@ -107,7 +107,7 @@ plugins: ## 修改配置文件 -::: tip +:::tip 如果你不了解 YAML 的语法，请不要随意修改配置文件，否则将可能导致 Koishi 应用无法运行。你可以在 [这篇教程](https://www.runoob.com/w3cnote/yaml-intro.html) 中学习 YAML 的语法。 ::: From 4a815b7079072415dffaf384664d2ef2762f1ed1 Mon Sep 17 00:00:00 2001 From: koishi-bot <105629226+koishi-bot@users.noreply.github.com> Date: Mon, 11 Dec 2023 13:30:10 +0800 Subject: [PATCH 0410/3075] New translations config.md (English, United States) [skip ci] --- en-US/guide/develop/config.md | 12 ++++++------ 1 file changed, 6 insertions(+), 6 deletions(-) diff --git a/en-US/guide/develop/config.md b/en-US/guide/develop/config.md index 74313d56925f..7a9bffad100f 100644 --- a/en-US/guide/develop/config.md +++ b/en-US/guide/develop/config.md @@ -1,6 +1,6 @@ -# Configuration File +# 配置文件 -::: warning +:::warning 配置文件的结构未来可能会发生变化，请留意后续更新。 ::: @@ -8,7 +8,7 @@ 默认情况下配置文件的格式为 [YAML](https://en.wikipedia.org/wiki/YAML)，它是一种易于阅读和编辑的文本格式，你可以用任何文本编辑器打开。 -## 应用目录 +## workspace root 配置文件所在的目录叫**应用目录**。根据你的安装方式，应用目录的位置可能不同： @@ -65,7 +65,7 @@ plugins: enable: true ``` -### Plugin name +### 插件名称 插件名称通常对应于插件发布时的包名。例如： @@ -88,7 +88,7 @@ plugins: market: ``` -### Meta Information +### 元信息 一些以 `$` 开头的属性会记录插件和插件组的元信息。例如： @@ -107,7 +107,7 @@ plugins: ## 修改配置文件 -::: tip +:::tip 如果你不了解 YAML 的语法，请不要随意修改配置文件，否则将可能导致 Koishi 应用无法运行。你可以在 [这篇教程](https://www.runoob.com/w3cnote/yaml-intro.html) 中学习 YAML 的语法。 ::: From 7a4793299d4b682eb37f6e0501743a23a4b1f2e1 Mon Sep 17 00:00:00 2001 From: koishi-bot <105629226+koishi-bot@users.noreply.github.com> Date: Mon, 11 Dec 2023 13:30:12 +0800 Subject: [PATCH 0411/3075] New translations publish.md (French) [skip ci] --- fr-FR/guide/develop/publish.md | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/fr-FR/guide/develop/publish.md b/fr-FR/guide/develop/publish.md index 01c6b7a50a51..31ac503736ef 100644 --- a/fr-FR/guide/develop/publish.md +++ b/fr-FR/guide/develop/publish.md @@ -1,4 +1,4 @@ -# Publication du plugin +# 发布插件 为了让别人更方便地使用你编写的插件，你需要将其作为一个 npm 包进行发布。只需满足一定的规范，你的插件就能显示在 [插件市场](../../market/) 中，其他人可以通过控制台来安装它。 @@ -148,7 +148,7 @@ root 此外，还有一些字段与 [Koishi Online](../../cookbook/practice/online.md) 的部署流程相关 (如 `browser`, `exports` 等)。由于不影响主线开发，你可以稍后再进行了解。 ::: -## Publication du plugin +## 发布插件 编辑完上面的清单文件并 [构建源代码](./workspace.md#构建源代码) 后，你就可以公开发布你的插件了。 From 70e8460f378163d3b19ba739a39fc60d0fa25002 Mon Sep 17 00:00:00 2001 From: koishi-bot <105629226+koishi-bot@users.noreply.github.com> Date: Mon, 11 Dec 2023 13:30:14 +0800 Subject: [PATCH 0412/3075] New translations publish.md (Japanese) [skip ci] --- ja-JP/guide/develop/publish.md | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/ja-JP/guide/develop/publish.md b/ja-JP/guide/develop/publish.md index 0dbc76edf4fc..31ac503736ef 100644 --- a/ja-JP/guide/develop/publish.md +++ b/ja-JP/guide/develop/publish.md @@ -1,4 +1,4 @@ -# プラグインを公開する +# 发布插件 为了让别人更方便地使用你编写的插件，你需要将其作为一个 npm 包进行发布。只需满足一定的规范，你的插件就能显示在 [插件市场](../../market/) 中，其他人可以通过控制台来安装它。 @@ -148,7 +148,7 @@ root 此外，还有一些字段与 [Koishi Online](../../cookbook/practice/online.md) 的部署流程相关 (如 `browser`, `exports` 等)。由于不影响主线开发，你可以稍后再进行了解。 ::: -## プラグインを公開する +## 发布插件 编辑完上面的清单文件并 [构建源代码](./workspace.md#构建源代码) 后，你就可以公开发布你的插件了。 From a63c21b1416ecc2f4ade14807b452b2a42405ea6 Mon Sep 17 00:00:00 2001 From: koishi-bot <105629226+koishi-bot@users.noreply.github.com> Date: Mon, 11 Dec 2023 13:30:16 +0800 Subject: [PATCH 0413/3075] New translations publish.md (Chinese Traditional) [skip ci] --- zh-TW/guide/develop/publish.md | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/zh-TW/guide/develop/publish.md b/zh-TW/guide/develop/publish.md index 14945c4a2bc0..31ac503736ef 100644 --- a/zh-TW/guide/develop/publish.md +++ b/zh-TW/guide/develop/publish.md @@ -1,4 +1,4 @@ -# 釋出外掛 +# 发布插件 为了让别人更方便地使用你编写的插件，你需要将其作为一个 npm 包进行发布。只需满足一定的规范，你的插件就能显示在 [插件市场](../../market/) 中，其他人可以通过控制台来安装它。 @@ -148,7 +148,7 @@ root 此外，还有一些字段与 [Koishi Online](../../cookbook/practice/online.md) 的部署流程相关 (如 `browser`, `exports` 等)。由于不影响主线开发，你可以稍后再进行了解。 ::: -## 釋出外掛 +## 发布插件 编辑完上面的清单文件并 [构建源代码](./workspace.md#构建源代码) 后，你就可以公开发布你的插件了。 From 1f338d0f0d56eea880c9f86e9c87b562396d591b Mon Sep 17 00:00:00 2001 From: koishi-bot <105629226+koishi-bot@users.noreply.github.com> Date: Mon, 11 Dec 2023 13:30:17 +0800 Subject: [PATCH 0414/3075] New translations publish.md (English, United States) [skip ci] --- en-US/guide/develop/publish.md | 92 +++++++++++++++++----------------- 1 file changed, 46 insertions(+), 46 deletions(-) diff --git a/en-US/guide/develop/publish.md b/en-US/guide/develop/publish.md index 67184c0e4191..466bd9a08537 100644 --- a/en-US/guide/develop/publish.md +++ b/en-US/guide/develop/publish.md @@ -1,7 +1,6 @@ -# Publishing Plugins +# 发布插件 -Your plugin should be published onto npm before being available to Koishi users. -只需满足一定的规范，你的插件就能显示在 [插件市场](../../market/) 中，其他人可以通过控制台来安装它。 +为了让别人更方便地使用你编写的插件，你需要将其作为一个 npm 包进行发布。只需满足一定的规范，你的插件就能显示在 [插件市场](../../market/) 中，其他人可以通过控制台来安装它。 :::tip 本节中介绍的命令行都需要在 [应用目录](./config.md#应用目录) 下运行。 @@ -9,7 +8,7 @@ Your plugin should be published onto npm before being available to Koishi users. ## Prerequisite -首先让我们关注插件目录中的 `package.json` 文件。This file is crucial as it has all the meta information for publishing your plugin. +首先让我们关注插件目录中的 `package.json` 文件。这个文件非常重要，它包含了要发布插件的一切元信息。 ```diff{6} root @@ -17,16 +16,16 @@ root │ └── example │ ├── src │ │ └── index.ts -│ └── package.json # the file we concern about +│ └── package.json # 你应该修改这里 ├── koishi.yml -└── package.json # not this +└── package.json # 而不是这里 ``` :::tip -There is a `package.json` file in your workspace root and in each plugin folder,please make sure the file opened is the one in the corresponding plugin folder. +请注意 `package.json` 文件不是唯一的，它在应用目录和每个插件目录都会存在。请确保你修改了正确的文件。 ::: -2. The following structure is an example of the above file: +打开上述文件，你会看到它大概长这样： ```json title=package.json { @@ -39,22 +38,22 @@ There is a `package.json` file in your workspace root and in each plugin folder, 其中最重要的属性有两个：`name` 是要发布的包名，`version` 是当前版本号。可以看到，这里的包名相比实际在插件市场中看到的插件名多了一个 `koishi-plugin-` 的前缀，这使得我们很容易区分 Koishi 插件与其他 npm 包，同时也方便了用户安装和配置插件。 :::tip -请注意：包名和版本号都是唯一的：包名不能与其他已经发布的包相同，而同一个包的同一个版本号也只能发布一次。 你可以自行根据错误提示更改包名或更新插件版本。 +请注意：包名和版本号都是唯一的：包名不能与其他已经发布的包相同，而同一个包的同一个版本号也只能发布一次。如果出现了包名冲突或版本号冲突，则会在之后的发布流程中出现错误提示。你可以自行根据错误提示更改包名或更新插件版本。 ::: -## More information +## 补充更多信息 -The `package.json` of a plugin contains more than just name and version. It comprises dependencies, description, contributors, license, keywords and other details relevant to the plugin.Each time one of these elements is changed,you need to [update the version](#updating-version) and [reissue the plugin](#publishing-plugins-1) +除了包名和版本号以外，`package.json` 还包括了插件的依赖、描述、贡献者、许可证、关键词等更多信息。你并不需要一上来就把所有信息都填写完整，因为你可以随后再进行修改。但请别忘了，这些内容也是插件的一部分，修改完成后别忘了 [更新版本](#更新插件版本) 并 [再次发布](#发布插件)。 -### Requirements +### 准入条件 :::tip -You may skip this section, if your plugin created using the boilerplate. +使用模板项目创建的插件一定是符合要求的，因此你可以跳过这一节。 ::: -The `package.json` in your plugin should meet the requirements below to appear in the marketplace: +要想显示在插件市场中，插件的 `package.json` 需要满足以下基本要求： -- [`name`](https://docs.npmjs.com/cli/v8/configuring-npm/package-json#name) should match one of these formats: +- [`name`](https://docs.npmjs.com/cli/v8/configuring-npm/package-json#name) 必须符合以下格式之一： - `koishi-plugin-*` - `@bar/koishi-plugin-*` - `@koishijs/plugin-*` (官方插件) @@ -63,9 +62,9 @@ The `package.json` in your plugin should meet the requirements below to appear i - [`version`](https://docs.npmjs.com/cli/v10/configuring-npm/package-json#version) 应当符合 [语义化版本](https://semver.org/lang/zh-CN/) (通常从 `1.0.0` 开始) - [`peerDependencies`](https://docs.npmjs.com/cli/v10/configuring-npm/package-json#peerdependencies) 必须包含 `koishi` - 不能声明 [`private`](https://docs.npmjs.com/cli/v10/configuring-npm/package-json#private) 为 `true` (否则你的插件无法发布) -- Avoid [deprecating](https://docs.npmjs.com/deprecating-and-undeprecating-packages-or-package-versions) of the latest version unless there is a valid reason to do so. For example, if you intend to re-release the plugin under a different name, it can be used to hide the old plugin on the marketplace. +- 最新版本不能被 [弃用](https://docs.npmjs.com/deprecating-and-undeprecating-packages-or-package-versions) (一种常见的情况是：你已经发布了某个插件，又希望更换一个名字重新发布，此时你可以通过弃用的方式让旧的名字不显示在插件市场中) -Example: +一个符合上述标准的示例： ```json title=package.json { @@ -77,36 +76,36 @@ Example: } ``` -### The `package.json` file +### 添加相关信息 -To make more information available to Koishi users, you could add more comprehensive fields in the `package.json` of your plugin. +除去上面的基本要求外，`package.json` 中还有一些字段能帮助显示插件的相关信息。 ```json title=package.json { "name": "koishi-plugin-example", "version": "1.0.0", - "contributors": [ + "contributors": [ // 贡献者 "Alice ", "Bob " ], - "license": "MIT", - "homepage": "https://example.com", - "repository": { + "license": "MIT", // 许可证 + "homepage": "https://example.com", // 主页 + "repository": { // 源码仓库 "type": "git", "url": "git+https://github.com/alice/koishi-plugin-example.git" }, - "keywords": ["example"], + "keywords": ["example"], // 关键词 "peerDependencies": { - "koishi": "^4.15.6" + "koishi": "^4.3.2" } } ``` -- **contributors:** plugin maintainers, should be an array. The elements usually follow the format `Name `. -- **license:** plugin license, you can learn details about various licenses in [here](https://choosealicense.com/licenses/) -- **homepage:** homepage for your plugin, which can be a URL (e.g. your GitHub project address). -- **repository:** source code repository of the plugin, which should be an object. The `type` field specifies the type of repository, and the `url` field specifies the repository address. -- **keywords:** keywords for the plugin, which should be an array of strings. They are used for the search function in the plug-in market. +- **contributors:** 插件维护者，应该是一个数组，其中的元素通常使用 `名字 <邮箱>` 的格式 +- **license:** 插件许可证，你可以在 [这里](https://choosealicense.com/licenses/) 了解各种许可证的详细信息 +- **homepage:** 插件主页，可以是一个网址 (比如你的 GitHub 项目地址) +- **repository:** 插件源码仓库，应该是一个对象，其中 `type` 字段指定仓库类型，`url` 字段指定仓库地址 +- **keywords:** 插件关键词，应该是一个字符串数组，会用于插件市场中的搜索功能 :::tip `package.json` 中还有一些字段没有在这里提及，如果你对此感兴趣，可以前往 [npmjs.com](https://docs.npmjs.com/files/package.json/) 查看文档。 @@ -140,18 +139,18 @@ To make more information available to Koishi users, you could add more comprehen - **description:** 插件描述，应该是一个对象，其中的键代表语言名，值是对应语言下的描述 - **service:** 插件的服务相关信息，具体包含下列属性： - - **implements:** services that your plugin implements, represented as an array of service names. -- **locales:** This refers to the languages supported by the plugin, represented as an array of language names. -- **preview:** Configure `true` to allow plugin to be displayed as "developing" status -- **hidden:** If set to true, this prevents the plugin from being displayed in the marketplace (you usually don’t need to do this). + - **implements:** 实现的服务，应该是一个服务名构成的数组 +- **locales:** 插件支持的语言，应该是一个语言名构成的数组 +- **preview:** 配置为 `true` 可以让插件显示为「开发中」状态 +- **hidden:** 配置为 `true` 可以让插件市场中不显示该插件 (通常情况下你不需要这么做) :::tip -Furthermore, there are certain aspects related to the deployment process of [Koishi Online](../../cookbook/practice/online.md), including browsers, exports, and more.Since they do not affect the mainline development, you can learn about them later. +此外，还有一些字段与 [Koishi Online](../../cookbook/practice/online.md) 的部署流程相关 (如 `browser`, `exports` 等)。由于不影响主线开发，你可以稍后再进行了解。 ::: -## Publishing Plugins +## 发布插件 -Congratulations! It's time to publish your plugin, after editing the file above and [build source](./workspace.md##build-source-code). +编辑完上面的清单文件并 [构建源代码](./workspace.md#构建源代码) 后，你就可以公开发布你的插件了。 :::tabs code @@ -165,21 +164,22 @@ yarn pub [...name] ::: -- **name:** list of plugins to be published, all by default (`name` is your directory name) +- **name:** 要发布的插件列表，缺省时表示全部 (此处 `name` 不包含 `koishi-plugin-` 前缀，而是你的工作区目录名) -This will be released of all plugins that have changed version numbers. +这将发布所有版本号发生变动的插件。 :::tip -It takes some time for the plugin to be successfully published to the plugin marketplace (usually within 15 minutes). Please be patient. +从插件成功发布到进插件市场需要一定的时间 (通常在 15 分钟内)，请耐心等待。 ::: -If you are in China and have configured a mirror, you may encounter the following error hint: +:::: tip +如果你配置了国内镜像，你可能会遇到以下的错误提示： ```text No token found and can't prompt for login when running with --non-interactive. ``` -You need to use official mirrors when publishing at this time, following: +此时你需要在发布时使用官方镜像，具体操作如下： :::tabs code @@ -207,9 +207,9 @@ yarn config set npmPublishRegistry https://registry.yarnpkg.com ::: :::: -## Updating version +## 更新插件版本 -初始创建的插件版本号为 `1.0.0`。Its number needs to be updated before releasing changes. Run the command in the workspace root to update that: +初始创建的插件版本号为 `1.0.0`。当你修改过插件后，你需要更新版本号才能重新发布。在应用目录运行下面的命令以更新版本号： :::tabs code @@ -234,6 +234,6 @@ yarn bump [...name] [-1|-2|-3|-p|-v ] [-r] - 其他情况下，跳到下一个大版本的 `alpha.0` - **-v, --version:** 设置具体的版本号 - **-r, --recursive:** 递归更新依赖版本 -- Default: incremented by the last of the release version number +- 缺省情况：按照当前版本的最后一位递增 -When updating the version of a plug-in, the versions of dependencies that rely on this plug-in will also be upgraded to ensure consistency in the workspace.进一步，如果你希望更新了依赖版本的插件也同时更新自身的版本，那么可以附加 `-r, --recursive` 选项。 +当进行此操作时，其他相关插件的依赖版本也会同步更新，确保所有工作区内依赖的插件版本一致。进一步，如果你希望更新了依赖版本的插件也同时更新自身的版本，那么可以附加 `-r, --recursive` 选项。 From b9f2455b57d99a6bf913fceaf53d84e811230048 Mon Sep 17 00:00:00 2001 From: koishi-bot <105629226+koishi-bot@users.noreply.github.com> Date: Mon, 11 Dec 2023 13:30:18 +0800 Subject: [PATCH 0415/3075] New translations script.md (French) [skip ci] --- fr-FR/guide/develop/script.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/fr-FR/guide/develop/script.md b/fr-FR/guide/develop/script.md index 5c0fa8972e4d..972a8539c338 100644 --- a/fr-FR/guide/develop/script.md +++ b/fr-FR/guide/develop/script.md @@ -6,7 +6,7 @@ Koishi 提供了一套命令行工具，用于读取配置文件快速启动应 本节中介绍的命令行都需要在 [应用目录](./config.md#应用目录) 下运行。 ::: -## Utilisation de base +## 基本用法 我们通常使用 **启动脚本** 来启动 Koishi 应用。打开应用目录下的 `package.json` 文件： From f499be8c270f37931a84800a041ea3a3dc907276 Mon Sep 17 00:00:00 2001 From: koishi-bot <105629226+koishi-bot@users.noreply.github.com> Date: Mon, 11 Dec 2023 13:30:22 +0800 Subject: [PATCH 0416/3075] New translations script.md (English, United States) [skip ci] --- en-US/guide/develop/script.md | 38 +++++++++++++++++------------------ 1 file changed, 19 insertions(+), 19 deletions(-) diff --git a/en-US/guide/develop/script.md b/en-US/guide/develop/script.md index 7802db9d8a69..eb417cf2663c 100644 --- a/en-US/guide/develop/script.md +++ b/en-US/guide/develop/script.md @@ -1,12 +1,12 @@ -# Launch Script +# launch script -There is also a set of command line tools that provided by Koishi to boot the application quickly by reading the configuration file. +Koishi 提供了一套命令行工具，用于读取配置文件快速启动应用。 :::tip 本节中介绍的命令行都需要在 [应用目录](./config.md#应用目录) 下运行。 ::: -## Basic Usage +## 基本用法 我们通常使用 **启动脚本** 来启动 Koishi 应用。打开应用目录下的 `package.json` 文件： @@ -19,7 +19,7 @@ There is also a set of command line tools that provided by Koishi to boot the ap } ``` -Run the following command line in the workspace root to start the Koishi application: +在应用目录运行下面的命令行以启动 Koishi 应用： :::tabs code @@ -33,21 +33,21 @@ yarn start ::: -In the subsequent parts of this section, we will introduce more options of the above launch script. No matter what changes you make, you can use the above command line to start. This is also the significance of the boostrap script. +在本节的后续部分，我们会介绍上述启动脚本的更多参数。无论你做何改动，你都可以使用上面的命令行来快速启动。这也是启动脚本的意义所在。 -### Command Line Options +### 启动参数 启动脚本支持 Node.js 的 [命令行参数](https://nodejs.org/api/cli.html)。例如，上面的 `-r` 对应于 `--require`，它将允许你加载 `.ts` 和 `.yml` 后缀的文件。 -In addition to Node.js's command line options, Koishi also provides some additional options. We will introduce each of them below. +除了 Node.js 的命令行参数，Koishi 还提供了一些额外的参数。我们将在下面逐一介绍。 -### Auto Restart +### 自动重启 -Koishi's command line tool supports auto-restart. When the process running Koishi crashes, if Koishi has already started successfully, the surveillance process will automatically restart a new process. +Koishi 的命令行工具支持自动重启。当运行 Koishi 的进程崩溃时，如果 Koishi 已经启动成功，则监视进程将自动重新启动一个新的进程。 -## Development Mode +## 开发模式 -除了 `start` 以外，模板项目还准备了名为 `dev` 的开发模式启动脚本。Running the following command line in the workspace root can start the application in development mode: +除了 `start` 以外，模板项目还准备了名为 `dev` 的开发模式启动脚本。在应用目录运行下面的命令行可以以开发模式启动应用： :::tabs code @@ -61,13 +61,13 @@ yarn dev ::: -如你所见，`dev` 相当于在 `start` 指令的基础上添加了额外的参数和环境变量。These options enable us to use additional features, while the environment variables can affect some behaviors of the plugins. +如你所见，`dev` 相当于在 `start` 指令的基础上添加了额外的参数和环境变量。这些参数为我们启用了额外的特性，而环境变量则能影响插件的部分行为。 -### TypeScript Support +### TypeScript 支持 -The Koishi template project provides built-in support for TypeScript development. 上述 `-r esbuild-register` 参数允许我们在运行时直接使用工作区插件的 TypeScript 源代码。 +Koishi 模板项目原生地支持 TypeScript 开发。上述 `-r esbuild-register` 参数允许我们在运行时直接使用工作区插件的 TypeScript 源代码。 -You can also add support for more extensions on your own. For example, if you prefer CoffeeScript, you can modify your development script like this: +你也可以自行扩展更多的后缀名支持。例如，如果你更喜欢 CoffeeScript，你可以这样修改你的开发脚本为： ```json title=package.json { @@ -88,9 +88,9 @@ You can also add support for more extensions on your own. For example, if you pr ### Hot Module Replacement -If you are developing a large Koishi project, it might take several seconds just to load all plugins. At times like this, supporting hot module replacement like front-end frameworks becomes a great idea. Fortunately, Koishi also supports this! The built-in plugin @koishijs/plugin-hmr implements plugin-level hot replacement. Whenever you modify your local files, Koishi will try to reload your plugin and remind you in the terminal. +如果你开发着一个巨大的 Koishi 项目，可能光是加载一遍全部插件就需要好几秒了。在这种时候，像前端框架一样支持模块热替换就成了一个很棒的主意。幸运的是，Koishi 也做到了这一点！内置插件 @koishijs/plugin-hmr 实现了插件级别的热替换。每当你修改你的本地文件时，Koishi 就会尝试重载你的插件，并在命令行中提醒你。 -The behavior here can also be customized in the configuration file: +这里的行为也可以在配置文件中进行定制： ```yaml title=koishi.yml plugins: @@ -98,7 +98,7 @@ plugins: $if: env.NODE_ENV === 'development' hmr: root: '.' - # List of files to ignore, supports glob patterns + # 要忽略的文件列表，支持 glob patterns ignore: - some-file ``` @@ -110,7 +110,7 @@ plugins: NOSPC: System limit for number of file watchers reached ``` -In this case, you can use the following command to increase the limit of the number of file watchers: +此时你可以使用下面的命令来增加监听数量限制： ```sh echo fs.inotify.max_user_watches=524288 | From 69dddc56ffe4e6e4c0f17c85ac5f37e128d4b8bd Mon Sep 17 00:00:00 2001 From: koishi-bot <105629226+koishi-bot@users.noreply.github.com> Date: Mon, 11 Dec 2023 13:30:23 +0800 Subject: [PATCH 0417/3075] New translations setup.md (French) [skip ci] --- fr-FR/guide/develop/setup.md | 7 +++++-- 1 file changed, 5 insertions(+), 2 deletions(-) diff --git a/fr-FR/guide/develop/setup.md b/fr-FR/guide/develop/setup.md index f1e139781c59..890a8c6c09ed 100644 --- a/fr-FR/guide/develop/setup.md +++ b/fr-FR/guide/develop/setup.md @@ -54,17 +54,20 @@ git config –-global user.email "you@example.com" - Windows：`C:\dev` 或者 `D:\dev` (也不要直接在盘根创建项目，最好是建一层目录) - 其他操作系统：`~/dev` -::: + ::: 输入下面的命令以创建 Koishi 项目： -::: tabs code +:::tabs code + ```npm npm init koishi@latest ``` + ```yarn yarn create koishi ``` + ::: 跟随提示即可完成全套初始化流程。 From 6f6f0739afc3731b4462c38e3dfd70d3608b84be Mon Sep 17 00:00:00 2001 From: koishi-bot <105629226+koishi-bot@users.noreply.github.com> Date: Mon, 11 Dec 2023 13:30:24 +0800 Subject: [PATCH 0418/3075] New translations setup.md (German) [skip ci] --- de-DE/guide/develop/setup.md | 7 +++++-- 1 file changed, 5 insertions(+), 2 deletions(-) diff --git a/de-DE/guide/develop/setup.md b/de-DE/guide/develop/setup.md index f1e139781c59..890a8c6c09ed 100644 --- a/de-DE/guide/develop/setup.md +++ b/de-DE/guide/develop/setup.md @@ -54,17 +54,20 @@ git config –-global user.email "you@example.com" - Windows：`C:\dev` 或者 `D:\dev` (也不要直接在盘根创建项目，最好是建一层目录) - 其他操作系统：`~/dev` -::: + ::: 输入下面的命令以创建 Koishi 项目： -::: tabs code +:::tabs code + ```npm npm init koishi@latest ``` + ```yarn yarn create koishi ``` + ::: 跟随提示即可完成全套初始化流程。 From 94756887568c27c49a0f6c6826fee8aabcaf96de Mon Sep 17 00:00:00 2001 From: koishi-bot <105629226+koishi-bot@users.noreply.github.com> Date: Mon, 11 Dec 2023 13:30:25 +0800 Subject: [PATCH 0419/3075] New translations setup.md (Japanese) [skip ci] --- ja-JP/guide/develop/setup.md | 7 +++++-- 1 file changed, 5 insertions(+), 2 deletions(-) diff --git a/ja-JP/guide/develop/setup.md b/ja-JP/guide/develop/setup.md index f1e139781c59..890a8c6c09ed 100644 --- a/ja-JP/guide/develop/setup.md +++ b/ja-JP/guide/develop/setup.md @@ -54,17 +54,20 @@ git config –-global user.email "you@example.com" - Windows：`C:\dev` 或者 `D:\dev` (也不要直接在盘根创建项目，最好是建一层目录) - 其他操作系统：`~/dev` -::: + ::: 输入下面的命令以创建 Koishi 项目： -::: tabs code +:::tabs code + ```npm npm init koishi@latest ``` + ```yarn yarn create koishi ``` + ::: 跟随提示即可完成全套初始化流程。 From e0ac017952861a5244519b173a980ae30767121f Mon Sep 17 00:00:00 2001 From: koishi-bot <105629226+koishi-bot@users.noreply.github.com> Date: Mon, 11 Dec 2023 13:30:26 +0800 Subject: [PATCH 0420/3075] New translations setup.md (Russian) [skip ci] --- ru-RU/guide/develop/setup.md | 7 +++++-- 1 file changed, 5 insertions(+), 2 deletions(-) diff --git a/ru-RU/guide/develop/setup.md b/ru-RU/guide/develop/setup.md index f1e139781c59..890a8c6c09ed 100644 --- a/ru-RU/guide/develop/setup.md +++ b/ru-RU/guide/develop/setup.md @@ -54,17 +54,20 @@ git config –-global user.email "you@example.com" - Windows：`C:\dev` 或者 `D:\dev` (也不要直接在盘根创建项目，最好是建一层目录) - 其他操作系统：`~/dev` -::: + ::: 输入下面的命令以创建 Koishi 项目： -::: tabs code +:::tabs code + ```npm npm init koishi@latest ``` + ```yarn yarn create koishi ``` + ::: 跟随提示即可完成全套初始化流程。 From 114f7509a7efffe1338f4c9a8a5619f3661ec574 Mon Sep 17 00:00:00 2001 From: koishi-bot <105629226+koishi-bot@users.noreply.github.com> Date: Mon, 11 Dec 2023 13:30:27 +0800 Subject: [PATCH 0421/3075] New translations setup.md (Chinese Traditional) [skip ci] --- zh-TW/guide/develop/setup.md | 7 +++++-- 1 file changed, 5 insertions(+), 2 deletions(-) diff --git a/zh-TW/guide/develop/setup.md b/zh-TW/guide/develop/setup.md index f1e139781c59..890a8c6c09ed 100644 --- a/zh-TW/guide/develop/setup.md +++ b/zh-TW/guide/develop/setup.md @@ -54,17 +54,20 @@ git config –-global user.email "you@example.com" - Windows：`C:\dev` 或者 `D:\dev` (也不要直接在盘根创建项目，最好是建一层目录) - 其他操作系统：`~/dev` -::: + ::: 输入下面的命令以创建 Koishi 项目： -::: tabs code +:::tabs code + ```npm npm init koishi@latest ``` + ```yarn yarn create koishi ``` + ::: 跟随提示即可完成全套初始化流程。 From 2c48837416a9f5de533899e7d4dc4871aa3c442c Mon Sep 17 00:00:00 2001 From: koishi-bot <105629226+koishi-bot@users.noreply.github.com> Date: Mon, 11 Dec 2023 13:30:28 +0800 Subject: [PATCH 0422/3075] New translations setup.md (English, United States) [skip ci] --- en-US/guide/develop/setup.md | 21 ++++++++++++--------- 1 file changed, 12 insertions(+), 9 deletions(-) diff --git a/en-US/guide/develop/setup.md b/en-US/guide/develop/setup.md index 4edeb8d5d1b1..890a8c6c09ed 100644 --- a/en-US/guide/develop/setup.md +++ b/en-US/guide/develop/setup.md @@ -1,4 +1,4 @@ -# Setup Environment +# 环境搭建 本节将介绍推荐的开发环境搭建流程。如果某些软件已经安装完成，可以跳过对应的步骤。 @@ -47,29 +47,32 @@ git config –-global user.email "you@example.com" ## 安装 Koishi -Open a command line, cd to the directory that you want to create a Koishi template project. +打开命令行，并进入你想要创建 Koishi 项目的目录。 ::: tip -The working directory path should not be absurdly long, also it is recommended to use a path that contains ASCII characters only. For example: +这个目录不宜过长，且路径中请避免出现中文或者空格。我们推荐的目录如下： - Windows：`C:\dev` 或者 `D:\dev` (也不要直接在盘根创建项目，最好是建一层目录) -- Other operating systems: `~/dev` -::: +- 其他操作系统：`~/dev` + ::: + +输入下面的命令以创建 Koishi 项目： -Enter the following command to create Koishi template project: +:::tabs code -::: tabs code ```npm npm init koishi@latest ``` + ```yarn yarn create koishi ``` + ::: -Follow the prompts and finalize the initialization process. +跟随提示即可完成全套初始化流程。 -If you have successfully finalized the operations above, your application should be already launched, the Koishi Console Web UI should be also opened. 接下来的几节中我们将学习更多的命令行用法，因此我们可以先关闭 Koishi。在命令行中按下 `Ctrl+C` 组合键即可停止 Koishi 的运行。 +如果你顺利完成了上述操作，你的应用此时应该已经是启动状态，并弹出了控制台界面。接下来的几节中我们将学习更多的命令行用法，因此我们可以先关闭 Koishi。在命令行中按下 `Ctrl+C` 组合键即可停止 Koishi 的运行。 3. 仅限 `http` 连接方式：在跳转至的应用信息页面，在底部复制 `Signing Secret`，填入插件的 [`signing`](#config-signing) 字段。 +![app-1](/adapter/slack/app-1.webp) + + + +3. 仅限 `http` 连接方式：在跳转至的应用信息页面，在底部复制 `Signing Secret`，填入插件的 [`signing`](#config-signing) 字段。 ![secret-1](/adapter/slack/secret-1.webp) @@ -40,19 +44,19 @@ Slack 适配器提供了两种接入方式：`http` 和 `ws` (推荐)。其中 ### 推荐的事件列表 -- channel_archive -- channel_created -- channel_deleted -- channel_left -- channel_rename -- member_joined_channel -- member_left_channel +- channel\_archive +- channel\_created +- channel\_deleted +- channel\_left +- channel\_rename +- member\_joined\_channel +- member\_left\_channel - message.channels - message.groups - message.im -- reaction_added -- reaction_removed -- team_join +- reaction\_added +- reaction\_removed +- team\_join ### 推荐的权限列表 From fd75427c8ef94b20a145b08a8d9c491f94854539 Mon Sep 17 00:00:00 2001 From: koishi-bot <105629226+koishi-bot@users.noreply.github.com> Date: Mon, 11 Dec 2023 13:35:03 +0800 Subject: [PATCH 0628/3075] New translations slack.md (German) [skip ci] --- de-DE/plugins/adapter/slack.md | 26 +++++++++++++++----------- 1 file changed, 15 insertions(+), 11 deletions(-) diff --git a/de-DE/plugins/adapter/slack.md b/de-DE/plugins/adapter/slack.md index 4b5fa98e09e9..d90e70bb1a19 100644 --- a/de-DE/plugins/adapter/slack.md +++ b/de-DE/plugins/adapter/slack.md @@ -8,7 +8,11 @@ Slack 适配器提供了两种接入方式：`http` 和 `ws` (推荐)。其中 2. 前往 [应用后台](https://api.slack.com/apps)，点击「Create New App」>「From Scratch」，填入应用名称和所添加的工作区 (目前适配器只支持一个应用处理一个工作区的事件)，点击「Create App」。 -![app-1](/adapter/slack/app-1.webp)3. 仅限 `http` 连接方式：在跳转至的应用信息页面，在底部复制 `Signing Secret`，填入插件的 [`signing`](#config-signing) 字段。 +![app-1](/adapter/slack/app-1.webp) + + + +3. 仅限 `http` 连接方式：在跳转至的应用信息页面，在底部复制 `Signing Secret`，填入插件的 [`signing`](#config-signing) 字段。 ![secret-1](/adapter/slack/secret-1.webp) @@ -40,19 +44,19 @@ Slack 适配器提供了两种接入方式：`http` 和 `ws` (推荐)。其中 ### 推荐的事件列表 -- channel_archive -- channel_created -- channel_deleted -- channel_left -- channel_rename -- member_joined_channel -- member_left_channel +- channel\_archive +- channel\_created +- channel\_deleted +- channel\_left +- channel\_rename +- member\_joined\_channel +- member\_left\_channel - message.channels - message.groups - message.im -- reaction_added -- reaction_removed -- team_join +- reaction\_added +- reaction\_removed +- team\_join ### 推荐的权限列表 From e1230343ccaa3c3734a42313008712ff6e50398e Mon Sep 17 00:00:00 2001 From: koishi-bot <105629226+koishi-bot@users.noreply.github.com> Date: Mon, 11 Dec 2023 13:35:04 +0800 Subject: [PATCH 0629/3075] New translations slack.md (Japanese) [skip ci] --- ja-JP/plugins/adapter/slack.md | 26 +++++++++++++++----------- 1 file changed, 15 insertions(+), 11 deletions(-) diff --git a/ja-JP/plugins/adapter/slack.md b/ja-JP/plugins/adapter/slack.md index 4b5fa98e09e9..d90e70bb1a19 100644 --- a/ja-JP/plugins/adapter/slack.md +++ b/ja-JP/plugins/adapter/slack.md @@ -8,7 +8,11 @@ Slack 适配器提供了两种接入方式：`http` 和 `ws` (推荐)。其中 2. 前往 [应用后台](https://api.slack.com/apps)，点击「Create New App」>「From Scratch」，填入应用名称和所添加的工作区 (目前适配器只支持一个应用处理一个工作区的事件)，点击「Create App」。 -![app-1](/adapter/slack/app-1.webp)3. 仅限 `http` 连接方式：在跳转至的应用信息页面，在底部复制 `Signing Secret`，填入插件的 [`signing`](#config-signing) 字段。 +![app-1](/adapter/slack/app-1.webp) + + + +3. 仅限 `http` 连接方式：在跳转至的应用信息页面，在底部复制 `Signing Secret`，填入插件的 [`signing`](#config-signing) 字段。 ![secret-1](/adapter/slack/secret-1.webp) @@ -40,19 +44,19 @@ Slack 适配器提供了两种接入方式：`http` 和 `ws` (推荐)。其中 ### 推荐的事件列表 -- channel_archive -- channel_created -- channel_deleted -- channel_left -- channel_rename -- member_joined_channel -- member_left_channel +- channel\_archive +- channel\_created +- channel\_deleted +- channel\_left +- channel\_rename +- member\_joined\_channel +- member\_left\_channel - message.channels - message.groups - message.im -- reaction_added -- reaction_removed -- team_join +- reaction\_added +- reaction\_removed +- team\_join ### 推荐的权限列表 From ed22040de90a6a4bcd17d67f2d352d63a24dbaf4 Mon Sep 17 00:00:00 2001 From: koishi-bot <105629226+koishi-bot@users.noreply.github.com> Date: Mon, 11 Dec 2023 13:35:05 +0800 Subject: [PATCH 0630/3075] New translations slack.md (Russian) [skip ci] --- ru-RU/plugins/adapter/slack.md | 26 +++++++++++++++----------- 1 file changed, 15 insertions(+), 11 deletions(-) diff --git a/ru-RU/plugins/adapter/slack.md b/ru-RU/plugins/adapter/slack.md index 4b5fa98e09e9..d90e70bb1a19 100644 --- a/ru-RU/plugins/adapter/slack.md +++ b/ru-RU/plugins/adapter/slack.md @@ -8,7 +8,11 @@ Slack 适配器提供了两种接入方式：`http` 和 `ws` (推荐)。其中 2. 前往 [应用后台](https://api.slack.com/apps)，点击「Create New App」>「From Scratch」，填入应用名称和所添加的工作区 (目前适配器只支持一个应用处理一个工作区的事件)，点击「Create App」。 -![app-1](/adapter/slack/app-1.webp)3. 仅限 `http` 连接方式：在跳转至的应用信息页面，在底部复制 `Signing Secret`，填入插件的 [`signing`](#config-signing) 字段。 +![app-1](/adapter/slack/app-1.webp) + + + +3. 仅限 `http` 连接方式：在跳转至的应用信息页面，在底部复制 `Signing Secret`，填入插件的 [`signing`](#config-signing) 字段。 ![secret-1](/adapter/slack/secret-1.webp) @@ -40,19 +44,19 @@ Slack 适配器提供了两种接入方式：`http` 和 `ws` (推荐)。其中 ### 推荐的事件列表 -- channel_archive -- channel_created -- channel_deleted -- channel_left -- channel_rename -- member_joined_channel -- member_left_channel +- channel\_archive +- channel\_created +- channel\_deleted +- channel\_left +- channel\_rename +- member\_joined\_channel +- member\_left\_channel - message.channels - message.groups - message.im -- reaction_added -- reaction_removed -- team_join +- reaction\_added +- reaction\_removed +- team\_join ### 推荐的权限列表 From e2dbd93b52f3381db28d4009d7d788dbd7f6bb28 Mon Sep 17 00:00:00 2001 From: koishi-bot <105629226+koishi-bot@users.noreply.github.com> Date: Mon, 11 Dec 2023 13:35:07 +0800 Subject: [PATCH 0631/3075] New translations slack.md (Chinese Traditional) [skip ci] --- zh-TW/plugins/adapter/slack.md | 26 +++++++++++++++----------- 1 file changed, 15 insertions(+), 11 deletions(-) diff --git a/zh-TW/plugins/adapter/slack.md b/zh-TW/plugins/adapter/slack.md index 4b5fa98e09e9..d90e70bb1a19 100644 --- a/zh-TW/plugins/adapter/slack.md +++ b/zh-TW/plugins/adapter/slack.md @@ -8,7 +8,11 @@ Slack 适配器提供了两种接入方式：`http` 和 `ws` (推荐)。其中 2. 前往 [应用后台](https://api.slack.com/apps)，点击「Create New App」>「From Scratch」，填入应用名称和所添加的工作区 (目前适配器只支持一个应用处理一个工作区的事件)，点击「Create App」。 -![app-1](/adapter/slack/app-1.webp)3. 仅限 `http` 连接方式：在跳转至的应用信息页面，在底部复制 `Signing Secret`，填入插件的 [`signing`](#config-signing) 字段。 +![app-1](/adapter/slack/app-1.webp) + + + +3. 仅限 `http` 连接方式：在跳转至的应用信息页面，在底部复制 `Signing Secret`，填入插件的 [`signing`](#config-signing) 字段。 ![secret-1](/adapter/slack/secret-1.webp) @@ -40,19 +44,19 @@ Slack 适配器提供了两种接入方式：`http` 和 `ws` (推荐)。其中 ### 推荐的事件列表 -- channel_archive -- channel_created -- channel_deleted -- channel_left -- channel_rename -- member_joined_channel -- member_left_channel +- channel\_archive +- channel\_created +- channel\_deleted +- channel\_left +- channel\_rename +- member\_joined\_channel +- member\_left\_channel - message.channels - message.groups - message.im -- reaction_added -- reaction_removed -- team_join +- reaction\_added +- reaction\_removed +- team\_join ### 推荐的权限列表 From 997bf33a510970f32917a65015ea6dbf2821452c Mon Sep 17 00:00:00 2001 From: koishi-bot <105629226+koishi-bot@users.noreply.github.com> Date: Mon, 11 Dec 2023 13:35:08 +0800 Subject: [PATCH 0632/3075] New translations slack.md (English, United States) [skip ci] --- en-US/plugins/adapter/slack.md | 26 +++++++++++++++----------- 1 file changed, 15 insertions(+), 11 deletions(-) diff --git a/en-US/plugins/adapter/slack.md b/en-US/plugins/adapter/slack.md index 4b5fa98e09e9..d90e70bb1a19 100644 --- a/en-US/plugins/adapter/slack.md +++ b/en-US/plugins/adapter/slack.md @@ -8,7 +8,11 @@ Slack 适配器提供了两种接入方式：`http` 和 `ws` (推荐)。其中 2. 前往 [应用后台](https://api.slack.com/apps)，点击「Create New App」>「From Scratch」，填入应用名称和所添加的工作区 (目前适配器只支持一个应用处理一个工作区的事件)，点击「Create App」。 -![app-1](/adapter/slack/app-1.webp)3. 仅限 `http` 连接方式：在跳转至的应用信息页面，在底部复制 `Signing Secret`，填入插件的 [`signing`](#config-signing) 字段。 +![app-1](/adapter/slack/app-1.webp) + + + +3. 仅限 `http` 连接方式：在跳转至的应用信息页面，在底部复制 `Signing Secret`，填入插件的 [`signing`](#config-signing) 字段。 ![secret-1](/adapter/slack/secret-1.webp) @@ -40,19 +44,19 @@ Slack 适配器提供了两种接入方式：`http` 和 `ws` (推荐)。其中 ### 推荐的事件列表 -- channel_archive -- channel_created -- channel_deleted -- channel_left -- channel_rename -- member_joined_channel -- member_left_channel +- channel\_archive +- channel\_created +- channel\_deleted +- channel\_left +- channel\_rename +- member\_joined\_channel +- member\_left\_channel - message.channels - message.groups - message.im -- reaction_added -- reaction_removed -- team_join +- reaction\_added +- reaction\_removed +- team\_join ### 推荐的权限列表 From 24c67c2d3c8311d2ffc75dc068304419313196a2 Mon Sep 17 00:00:00 2001 From: koishi-bot <105629226+koishi-bot@users.noreply.github.com> Date: Mon, 11 Dec 2023 13:35:09 +0800 Subject: [PATCH 0633/3075] New translations telegram.md (French) [skip ci] --- fr-FR/plugins/adapter/telegram.md | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/fr-FR/plugins/adapter/telegram.md b/fr-FR/plugins/adapter/telegram.md index 0ba4ec708359..8287acac1e19 100644 --- a/fr-FR/plugins/adapter/telegram.md +++ b/fr-FR/plugins/adapter/telegram.md @@ -8,9 +8,9 @@ 4. 使用 `/setprivacy` 关闭 Privacy Mode（设置为 DISABLED，不然机器人只能收到特定消息） 5. 创建完毕后，你会获得一个 token（请注意不要泄露），将其作为机器人配置项即可使用 -参考文档： +参考文档：https\://core.telegram.org/bots -::: tip +:::tip 如果启动机器人后发现收不到不带 `/` 的消息，这很可能是由于 Privacy Mode 未开启。如果开启后仍然收不到消息，请尝试将机器人从群组中移除后重新加入。 ::: From 850d2bfaac63948f3b69808f4181b31650f59baf Mon Sep 17 00:00:00 2001 From: koishi-bot <105629226+koishi-bot@users.noreply.github.com> Date: Mon, 11 Dec 2023 13:35:10 +0800 Subject: [PATCH 0634/3075] New translations telegram.md (German) [skip ci] --- de-DE/plugins/adapter/telegram.md | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/de-DE/plugins/adapter/telegram.md b/de-DE/plugins/adapter/telegram.md index 0ba4ec708359..8287acac1e19 100644 --- a/de-DE/plugins/adapter/telegram.md +++ b/de-DE/plugins/adapter/telegram.md @@ -8,9 +8,9 @@ 4. 使用 `/setprivacy` 关闭 Privacy Mode（设置为 DISABLED，不然机器人只能收到特定消息） 5. 创建完毕后，你会获得一个 token（请注意不要泄露），将其作为机器人配置项即可使用 -参考文档： +参考文档：https\://core.telegram.org/bots -::: tip +:::tip 如果启动机器人后发现收不到不带 `/` 的消息，这很可能是由于 Privacy Mode 未开启。如果开启后仍然收不到消息，请尝试将机器人从群组中移除后重新加入。 ::: From f1dd039fe20e1d45cda40082cd9022c0ad1e16a3 Mon Sep 17 00:00:00 2001 From: koishi-bot <105629226+koishi-bot@users.noreply.github.com> Date: Mon, 11 Dec 2023 13:35:12 +0800 Subject: [PATCH 0635/3075] New translations telegram.md (Japanese) [skip ci] --- ja-JP/plugins/adapter/telegram.md | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/ja-JP/plugins/adapter/telegram.md b/ja-JP/plugins/adapter/telegram.md index 0ba4ec708359..8287acac1e19 100644 --- a/ja-JP/plugins/adapter/telegram.md +++ b/ja-JP/plugins/adapter/telegram.md @@ -8,9 +8,9 @@ 4. 使用 `/setprivacy` 关闭 Privacy Mode（设置为 DISABLED，不然机器人只能收到特定消息） 5. 创建完毕后，你会获得一个 token（请注意不要泄露），将其作为机器人配置项即可使用 -参考文档： +参考文档：https\://core.telegram.org/bots -::: tip +:::tip 如果启动机器人后发现收不到不带 `/` 的消息，这很可能是由于 Privacy Mode 未开启。如果开启后仍然收不到消息，请尝试将机器人从群组中移除后重新加入。 ::: From e5ce5f9ef94a032ac72ca9442f488432cb00b752 Mon Sep 17 00:00:00 2001 From: koishi-bot <105629226+koishi-bot@users.noreply.github.com> Date: Mon, 11 Dec 2023 13:35:13 +0800 Subject: [PATCH 0636/3075] New translations telegram.md (Russian) [skip ci] --- ru-RU/plugins/adapter/telegram.md | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/ru-RU/plugins/adapter/telegram.md b/ru-RU/plugins/adapter/telegram.md index 0ba4ec708359..8287acac1e19 100644 --- a/ru-RU/plugins/adapter/telegram.md +++ b/ru-RU/plugins/adapter/telegram.md @@ -8,9 +8,9 @@ 4. 使用 `/setprivacy` 关闭 Privacy Mode（设置为 DISABLED，不然机器人只能收到特定消息） 5. 创建完毕后，你会获得一个 token（请注意不要泄露），将其作为机器人配置项即可使用 -参考文档： +参考文档：https\://core.telegram.org/bots -::: tip +:::tip 如果启动机器人后发现收不到不带 `/` 的消息，这很可能是由于 Privacy Mode 未开启。如果开启后仍然收不到消息，请尝试将机器人从群组中移除后重新加入。 ::: From 0e716f1971f40aab8c30a667e13f796732dcfada Mon Sep 17 00:00:00 2001 From: koishi-bot <105629226+koishi-bot@users.noreply.github.com> Date: Mon, 11 Dec 2023 13:35:14 +0800 Subject: [PATCH 0637/3075] New translations telegram.md (Chinese Traditional) [skip ci] --- zh-TW/plugins/adapter/telegram.md | 8 ++++---- 1 file changed, 4 insertions(+), 4 deletions(-) diff --git a/zh-TW/plugins/adapter/telegram.md b/zh-TW/plugins/adapter/telegram.md index 0737ace5e7cf..8287acac1e19 100644 --- a/zh-TW/plugins/adapter/telegram.md +++ b/zh-TW/plugins/adapter/telegram.md @@ -3,14 +3,14 @@ ## 接入方法 1. 搜索 @botfather（有个官方认证的符号）并进入聊天界面 -2. 輸入 `/start` 後，會出現一個使用選單，你可以使用這裡指令對你的機器人進行配置 -3. 要建立一個機器人，請點選 `/newbot`，並根據系統提示完成建立流程 +2. 输入 `/start` 后，会出现一个使用菜单，你可以使用这里指令对你的机器人进行配置 +3. 要创建一个机器人，请点击 `/newbot`，并根据系统提示完成创建流程 4. 使用 `/setprivacy` 关闭 Privacy Mode（设置为 DISABLED，不然机器人只能收到特定消息） 5. 创建完毕后，你会获得一个 token（请注意不要泄露），将其作为机器人配置项即可使用 -参考文档： +参考文档：https\://core.telegram.org/bots -::: tip +:::tip 如果启动机器人后发现收不到不带 `/` 的消息，这很可能是由于 Privacy Mode 未开启。如果开启后仍然收不到消息，请尝试将机器人从群组中移除后重新加入。 ::: From ae2d1da598c124f7bee0cd5628942e45c0fc267a Mon Sep 17 00:00:00 2001 From: koishi-bot <105629226+koishi-bot@users.noreply.github.com> Date: Mon, 11 Dec 2023 13:35:16 +0800 Subject: [PATCH 0638/3075] New translations telegram.md (English, United States) [skip ci] --- en-US/plugins/adapter/telegram.md | 8 ++++---- 1 file changed, 4 insertions(+), 4 deletions(-) diff --git a/en-US/plugins/adapter/telegram.md b/en-US/plugins/adapter/telegram.md index 320069c189df..8287acac1e19 100644 --- a/en-US/plugins/adapter/telegram.md +++ b/en-US/plugins/adapter/telegram.md @@ -3,14 +3,14 @@ ## 接入方法 1. 搜索 @botfather（有个官方认证的符号）并进入聊天界面 -2. After entering `start`, a menu will appear. You can use commands to configure your bot here. -3. To create a bot, click `/newbot` and follow the instructions to finish the process of creation. +2. 输入 `/start` 后，会出现一个使用菜单，你可以使用这里指令对你的机器人进行配置 +3. 要创建一个机器人，请点击 `/newbot`，并根据系统提示完成创建流程 4. 使用 `/setprivacy` 关闭 Privacy Mode（设置为 DISABLED，不然机器人只能收到特定消息） 5. 创建完毕后，你会获得一个 token（请注意不要泄露），将其作为机器人配置项即可使用 -参考文档： +参考文档：https\://core.telegram.org/bots -::: tip +:::tip 如果启动机器人后发现收不到不带 `/` 的消息，这很可能是由于 Privacy Mode 未开启。如果开启后仍然收不到消息，请尝试将机器人从群组中移除后重新加入。 ::: From 55189ff20624efc6e96f316beaf64677be04bedb Mon Sep 17 00:00:00 2001 From: koishi-bot <105629226+koishi-bot@users.noreply.github.com> Date: Mon, 11 Dec 2023 13:35:17 +0800 Subject: [PATCH 0639/3075] New translations wechat-official.md (French) [skip ci] --- fr-FR/plugins/adapter/wechat-official.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/fr-FR/plugins/adapter/wechat-official.md b/fr-FR/plugins/adapter/wechat-official.md index 738c7fa072f5..0ff5ef80fbe7 100644 --- a/fr-FR/plugins/adapter/wechat-official.md +++ b/fr-FR/plugins/adapter/wechat-official.md @@ -8,7 +8,7 @@ 4. 页面下方启用服务器配置，将机器人的 `selfUrl` 值后连接 `/wechat-official` (如 `https://example.com/wechat-official`)，在 URL 一栏中填写；在插件配置和公众平台上填入相同的 Token；在公众平台上生成 EncodingAESKey 并填入插件的 aesKey 字段；三种消息加解密方式均可选择。 5. 如果公众号为企业主体，且通过了微信认证，可在插件配置中启用 customerService。客服接口提供了更宽松的消息回复能力。 -参考文档：[https://developers.weixin.qq.com/doc/offiaccount/Basic_Information/Access_Overview.html](https://developers.weixin.qq.com/doc/offiaccount/Basic_Information/Access_Overview.html) +参考文档：https\://developers.weixin.qq.com/doc/offiaccount/Basic\_Information/Access\_Overview\.html ## 配置项 From 932c1a8247dee98c7a2c915f085af0dc9ce195de Mon Sep 17 00:00:00 2001 From: koishi-bot <105629226+koishi-bot@users.noreply.github.com> Date: Mon, 11 Dec 2023 13:35:18 +0800 Subject: [PATCH 0640/3075] New translations wechat-official.md (German) [skip ci] --- de-DE/plugins/adapter/wechat-official.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/de-DE/plugins/adapter/wechat-official.md b/de-DE/plugins/adapter/wechat-official.md index 738c7fa072f5..0ff5ef80fbe7 100644 --- a/de-DE/plugins/adapter/wechat-official.md +++ b/de-DE/plugins/adapter/wechat-official.md @@ -8,7 +8,7 @@ 4. 页面下方启用服务器配置，将机器人的 `selfUrl` 值后连接 `/wechat-official` (如 `https://example.com/wechat-official`)，在 URL 一栏中填写；在插件配置和公众平台上填入相同的 Token；在公众平台上生成 EncodingAESKey 并填入插件的 aesKey 字段；三种消息加解密方式均可选择。 5. 如果公众号为企业主体，且通过了微信认证，可在插件配置中启用 customerService。客服接口提供了更宽松的消息回复能力。 -参考文档：[https://developers.weixin.qq.com/doc/offiaccount/Basic_Information/Access_Overview.html](https://developers.weixin.qq.com/doc/offiaccount/Basic_Information/Access_Overview.html) +参考文档：https\://developers.weixin.qq.com/doc/offiaccount/Basic\_Information/Access\_Overview\.html ## 配置项 From 44cb0fc6672ae7182311e2f6f86c9e31f9aa13e9 Mon Sep 17 00:00:00 2001 From: koishi-bot <105629226+koishi-bot@users.noreply.github.com> Date: Mon, 11 Dec 2023 13:35:19 +0800 Subject: [PATCH 0641/3075] New translations wechat-official.md (Japanese) [skip ci] --- ja-JP/plugins/adapter/wechat-official.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/ja-JP/plugins/adapter/wechat-official.md b/ja-JP/plugins/adapter/wechat-official.md index 738c7fa072f5..0ff5ef80fbe7 100644 --- a/ja-JP/plugins/adapter/wechat-official.md +++ b/ja-JP/plugins/adapter/wechat-official.md @@ -8,7 +8,7 @@ 4. 页面下方启用服务器配置，将机器人的 `selfUrl` 值后连接 `/wechat-official` (如 `https://example.com/wechat-official`)，在 URL 一栏中填写；在插件配置和公众平台上填入相同的 Token；在公众平台上生成 EncodingAESKey 并填入插件的 aesKey 字段；三种消息加解密方式均可选择。 5. 如果公众号为企业主体，且通过了微信认证，可在插件配置中启用 customerService。客服接口提供了更宽松的消息回复能力。 -参考文档：[https://developers.weixin.qq.com/doc/offiaccount/Basic_Information/Access_Overview.html](https://developers.weixin.qq.com/doc/offiaccount/Basic_Information/Access_Overview.html) +参考文档：https\://developers.weixin.qq.com/doc/offiaccount/Basic\_Information/Access\_Overview\.html ## 配置项 From 129ad4884a1fd19ac4c8be4d6b7ea74af06a0482 Mon Sep 17 00:00:00 2001 From: koishi-bot <105629226+koishi-bot@users.noreply.github.com> Date: Mon, 11 Dec 2023 13:35:20 +0800 Subject: [PATCH 0642/3075] New translations wechat-official.md (Russian) [skip ci] --- ru-RU/plugins/adapter/wechat-official.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/ru-RU/plugins/adapter/wechat-official.md b/ru-RU/plugins/adapter/wechat-official.md index 738c7fa072f5..0ff5ef80fbe7 100644 --- a/ru-RU/plugins/adapter/wechat-official.md +++ b/ru-RU/plugins/adapter/wechat-official.md @@ -8,7 +8,7 @@ 4. 页面下方启用服务器配置，将机器人的 `selfUrl` 值后连接 `/wechat-official` (如 `https://example.com/wechat-official`)，在 URL 一栏中填写；在插件配置和公众平台上填入相同的 Token；在公众平台上生成 EncodingAESKey 并填入插件的 aesKey 字段；三种消息加解密方式均可选择。 5. 如果公众号为企业主体，且通过了微信认证，可在插件配置中启用 customerService。客服接口提供了更宽松的消息回复能力。 -参考文档：[https://developers.weixin.qq.com/doc/offiaccount/Basic_Information/Access_Overview.html](https://developers.weixin.qq.com/doc/offiaccount/Basic_Information/Access_Overview.html) +参考文档：https\://developers.weixin.qq.com/doc/offiaccount/Basic\_Information/Access\_Overview\.html ## 配置项 From c3e914eaab088fc02a795b514b2dbd7072f0b673 Mon Sep 17 00:00:00 2001 From: koishi-bot <105629226+koishi-bot@users.noreply.github.com> Date: Mon, 11 Dec 2023 13:35:21 +0800 Subject: [PATCH 0643/3075] New translations wechat-official.md (Chinese Traditional) [skip ci] --- zh-TW/plugins/adapter/wechat-official.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/zh-TW/plugins/adapter/wechat-official.md b/zh-TW/plugins/adapter/wechat-official.md index 738c7fa072f5..0ff5ef80fbe7 100644 --- a/zh-TW/plugins/adapter/wechat-official.md +++ b/zh-TW/plugins/adapter/wechat-official.md @@ -8,7 +8,7 @@ 4. 页面下方启用服务器配置，将机器人的 `selfUrl` 值后连接 `/wechat-official` (如 `https://example.com/wechat-official`)，在 URL 一栏中填写；在插件配置和公众平台上填入相同的 Token；在公众平台上生成 EncodingAESKey 并填入插件的 aesKey 字段；三种消息加解密方式均可选择。 5. 如果公众号为企业主体，且通过了微信认证，可在插件配置中启用 customerService。客服接口提供了更宽松的消息回复能力。 -参考文档：[https://developers.weixin.qq.com/doc/offiaccount/Basic_Information/Access_Overview.html](https://developers.weixin.qq.com/doc/offiaccount/Basic_Information/Access_Overview.html) +参考文档：https\://developers.weixin.qq.com/doc/offiaccount/Basic\_Information/Access\_Overview\.html ## 配置项 From ba3cb45def65acf7c024014c38ae89a38bba9877 Mon Sep 17 00:00:00 2001 From: koishi-bot <105629226+koishi-bot@users.noreply.github.com> Date: Mon, 11 Dec 2023 13:35:22 +0800 Subject: [PATCH 0644/3075] New translations wechat-official.md (English, United States) [skip ci] --- en-US/plugins/adapter/wechat-official.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/en-US/plugins/adapter/wechat-official.md b/en-US/plugins/adapter/wechat-official.md index 738c7fa072f5..0ff5ef80fbe7 100644 --- a/en-US/plugins/adapter/wechat-official.md +++ b/en-US/plugins/adapter/wechat-official.md @@ -8,7 +8,7 @@ 4. 页面下方启用服务器配置，将机器人的 `selfUrl` 值后连接 `/wechat-official` (如 `https://example.com/wechat-official`)，在 URL 一栏中填写；在插件配置和公众平台上填入相同的 Token；在公众平台上生成 EncodingAESKey 并填入插件的 aesKey 字段；三种消息加解密方式均可选择。 5. 如果公众号为企业主体，且通过了微信认证，可在插件配置中启用 customerService。客服接口提供了更宽松的消息回复能力。 -参考文档：[https://developers.weixin.qq.com/doc/offiaccount/Basic_Information/Access_Overview.html](https://developers.weixin.qq.com/doc/offiaccount/Basic_Information/Access_Overview.html) +参考文档：https\://developers.weixin.qq.com/doc/offiaccount/Basic\_Information/Access\_Overview\.html ## 配置项 From 2b7c8c0bd3a143ef19a05027a738e92835b5feea Mon Sep 17 00:00:00 2001 From: koishi-bot <105629226+koishi-bot@users.noreply.github.com> Date: Mon, 11 Dec 2023 13:35:23 +0800 Subject: [PATCH 0645/3075] New translations wecom.md (French) [skip ci] --- fr-FR/plugins/adapter/wecom.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/fr-FR/plugins/adapter/wecom.md b/fr-FR/plugins/adapter/wecom.md index 8f5fb195b12e..81200fbbf1bf 100644 --- a/fr-FR/plugins/adapter/wecom.md +++ b/fr-FR/plugins/adapter/wecom.md @@ -9,7 +9,7 @@ 5. 于页面左上角返回应用页面，在下方开发者接口板块点击「企业可信 IP」的「配置」，设置白名单 IP，确定后稍等几分钟即可使用插件。 6. 推荐在几分钟后停用并启用一次插件，以便加载出平台信息呈现在控制台内。 -参考文档： +参考文档：https\://developer.work.weixin.qq.com/document/path/90487 ## 配置项 From a0d9362560bb4880c6fef65913374ef101b50ad1 Mon Sep 17 00:00:00 2001 From: koishi-bot <105629226+koishi-bot@users.noreply.github.com> Date: Mon, 11 Dec 2023 13:35:24 +0800 Subject: [PATCH 0646/3075] New translations wecom.md (German) [skip ci] --- de-DE/plugins/adapter/wecom.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/de-DE/plugins/adapter/wecom.md b/de-DE/plugins/adapter/wecom.md index 8f5fb195b12e..81200fbbf1bf 100644 --- a/de-DE/plugins/adapter/wecom.md +++ b/de-DE/plugins/adapter/wecom.md @@ -9,7 +9,7 @@ 5. 于页面左上角返回应用页面，在下方开发者接口板块点击「企业可信 IP」的「配置」，设置白名单 IP，确定后稍等几分钟即可使用插件。 6. 推荐在几分钟后停用并启用一次插件，以便加载出平台信息呈现在控制台内。 -参考文档： +参考文档：https\://developer.work.weixin.qq.com/document/path/90487 ## 配置项 From 618472567d6956c0aee88572db763c2322c88d2a Mon Sep 17 00:00:00 2001 From: koishi-bot <105629226+koishi-bot@users.noreply.github.com> Date: Mon, 11 Dec 2023 13:35:25 +0800 Subject: [PATCH 0647/3075] New translations wecom.md (Japanese) [skip ci] --- ja-JP/plugins/adapter/wecom.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/ja-JP/plugins/adapter/wecom.md b/ja-JP/plugins/adapter/wecom.md index 8f5fb195b12e..81200fbbf1bf 100644 --- a/ja-JP/plugins/adapter/wecom.md +++ b/ja-JP/plugins/adapter/wecom.md @@ -9,7 +9,7 @@ 5. 于页面左上角返回应用页面，在下方开发者接口板块点击「企业可信 IP」的「配置」，设置白名单 IP，确定后稍等几分钟即可使用插件。 6. 推荐在几分钟后停用并启用一次插件，以便加载出平台信息呈现在控制台内。 -参考文档： +参考文档：https\://developer.work.weixin.qq.com/document/path/90487 ## 配置项 From cbeaf8ea448cc67b26612eec5401dfee3275ef53 Mon Sep 17 00:00:00 2001 From: koishi-bot <105629226+koishi-bot@users.noreply.github.com> Date: Mon, 11 Dec 2023 13:35:26 +0800 Subject: [PATCH 0648/3075] New translations wecom.md (Russian) [skip ci] --- ru-RU/plugins/adapter/wecom.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/ru-RU/plugins/adapter/wecom.md b/ru-RU/plugins/adapter/wecom.md index 8f5fb195b12e..81200fbbf1bf 100644 --- a/ru-RU/plugins/adapter/wecom.md +++ b/ru-RU/plugins/adapter/wecom.md @@ -9,7 +9,7 @@ 5. 于页面左上角返回应用页面，在下方开发者接口板块点击「企业可信 IP」的「配置」，设置白名单 IP，确定后稍等几分钟即可使用插件。 6. 推荐在几分钟后停用并启用一次插件，以便加载出平台信息呈现在控制台内。 -参考文档： +参考文档：https\://developer.work.weixin.qq.com/document/path/90487 ## 配置项 From 720c65ac18a52ef312aa20f0a60ccf96cb591b2e Mon Sep 17 00:00:00 2001 From: koishi-bot <105629226+koishi-bot@users.noreply.github.com> Date: Mon, 11 Dec 2023 13:35:27 +0800 Subject: [PATCH 0649/3075] New translations wecom.md (Chinese Traditional) [skip ci] --- zh-TW/plugins/adapter/wecom.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/zh-TW/plugins/adapter/wecom.md b/zh-TW/plugins/adapter/wecom.md index 8f5fb195b12e..81200fbbf1bf 100644 --- a/zh-TW/plugins/adapter/wecom.md +++ b/zh-TW/plugins/adapter/wecom.md @@ -9,7 +9,7 @@ 5. 于页面左上角返回应用页面，在下方开发者接口板块点击「企业可信 IP」的「配置」，设置白名单 IP，确定后稍等几分钟即可使用插件。 6. 推荐在几分钟后停用并启用一次插件，以便加载出平台信息呈现在控制台内。 -参考文档： +参考文档：https\://developer.work.weixin.qq.com/document/path/90487 ## 配置项 From ea51d24745a373df5721126af1fdecade31f6ade Mon Sep 17 00:00:00 2001 From: koishi-bot <105629226+koishi-bot@users.noreply.github.com> Date: Mon, 11 Dec 2023 13:35:28 +0800 Subject: [PATCH 0650/3075] New translations wecom.md (English, United States) [skip ci] --- en-US/plugins/adapter/wecom.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/en-US/plugins/adapter/wecom.md b/en-US/plugins/adapter/wecom.md index 8f5fb195b12e..81200fbbf1bf 100644 --- a/en-US/plugins/adapter/wecom.md +++ b/en-US/plugins/adapter/wecom.md @@ -9,7 +9,7 @@ 5. 于页面左上角返回应用页面，在下方开发者接口板块点击「企业可信 IP」的「配置」，设置白名单 IP，确定后稍等几分钟即可使用插件。 6. 推荐在几分钟后停用并启用一次插件，以便加载出平台信息呈现在控制台内。 -参考文档： +参考文档：https\://developer.work.weixin.qq.com/document/path/90487 ## 配置项 From 2c111152d88e4b4c1662469eec22954b13090787 Mon Sep 17 00:00:00 2001 From: koishi-bot <105629226+koishi-bot@users.noreply.github.com> Date: Mon, 11 Dec 2023 13:35:37 +0800 Subject: [PATCH 0651/3075] New translations admin.md (French) [skip ci] --- fr-FR/plugins/common/admin.md | 9 +++++---- 1 file changed, 5 insertions(+), 4 deletions(-) diff --git a/fr-FR/plugins/common/admin.md b/fr-FR/plugins/common/admin.md index 3f3666ccab27..86f16ea19aac 100644 --- a/fr-FR/plugins/common/admin.md +++ b/fr-FR/plugins/common/admin.md @@ -1,10 +1,10 @@ # 数据管理 (Admin) -::: tip +:::tip 要使用本插件，你需要安装数据库支持。 ::: -::: tip +:::tip 建议配合阅读 [入门 > 权限管理](../../manual/usage/customize.md#权限管理) 章节。 ::: @@ -47,8 +47,9 @@ assign 指令可用于设置频道的 [受理人](../../manual/usage/customize.m 1. 私聊机器人 B，发送 `assign -c #A` 2. 在频道 A 中发送 `assign @B`（假设 B 能收到此消息） -## 指令：user.flag obsolète -## 指令：channel.flag obsolète +## 指令：user.flag 废弃 + +## 指令：channel.flag 废弃 - 基本语法：`xxx.flag [...names]` - 选项： From e579d530dac6827f37a0017421738db02a2369fd Mon Sep 17 00:00:00 2001 From: koishi-bot <105629226+koishi-bot@users.noreply.github.com> Date: Mon, 11 Dec 2023 13:35:38 +0800 Subject: [PATCH 0652/3075] New translations admin.md (German) [skip ci] --- de-DE/plugins/common/admin.md | 5 +++-- 1 file changed, 3 insertions(+), 2 deletions(-) diff --git a/de-DE/plugins/common/admin.md b/de-DE/plugins/common/admin.md index f5d3ed7a1703..86f16ea19aac 100644 --- a/de-DE/plugins/common/admin.md +++ b/de-DE/plugins/common/admin.md @@ -1,10 +1,10 @@ # 数据管理 (Admin) -::: tip +:::tip 要使用本插件，你需要安装数据库支持。 ::: -::: tip +:::tip 建议配合阅读 [入门 > 权限管理](../../manual/usage/customize.md#权限管理) 章节。 ::: @@ -48,6 +48,7 @@ assign 指令可用于设置频道的 [受理人](../../manual/usage/customize.m 2. 在频道 A 中发送 `assign @B`（假设 B 能收到此消息） ## 指令：user.flag 废弃 + ## 指令：channel.flag 废弃 - 基本语法：`xxx.flag [...names]` From c96db4cf35bdca6cbcbf91f77d7fbd3a3aad29a6 Mon Sep 17 00:00:00 2001 From: koishi-bot <105629226+koishi-bot@users.noreply.github.com> Date: Mon, 11 Dec 2023 13:35:40 +0800 Subject: [PATCH 0653/3075] New translations admin.md (Japanese) [skip ci] --- ja-JP/plugins/common/admin.md | 9 +++++---- 1 file changed, 5 insertions(+), 4 deletions(-) diff --git a/ja-JP/plugins/common/admin.md b/ja-JP/plugins/common/admin.md index 8c2b6abc03db..86f16ea19aac 100644 --- a/ja-JP/plugins/common/admin.md +++ b/ja-JP/plugins/common/admin.md @@ -1,10 +1,10 @@ # 数据管理 (Admin) -::: tip +:::tip 要使用本插件，你需要安装数据库支持。 ::: -::: tip +:::tip 建议配合阅读 [入门 > 权限管理](../../manual/usage/customize.md#权限管理) 章节。 ::: @@ -47,8 +47,9 @@ assign 指令可用于设置频道的 [受理人](../../manual/usage/customize.m 1. 私聊机器人 B，发送 `assign -c #A` 2. 在频道 A 中发送 `assign @B`（假设 B 能收到此消息） -## 指令：user.flag 非推奨 -## 指令：channel.flag 非推奨 +## 指令：user.flag 废弃 + +## 指令：channel.flag 废弃 - 基本语法：`xxx.flag [...names]` - 选项： From 2a1a7e905ad8a5d0634cf24352c8854926fd2492 Mon Sep 17 00:00:00 2001 From: koishi-bot <105629226+koishi-bot@users.noreply.github.com> Date: Mon, 11 Dec 2023 13:35:41 +0800 Subject: [PATCH 0654/3075] New translations admin.md (Russian) [skip ci] --- ru-RU/plugins/common/admin.md | 5 +++-- 1 file changed, 3 insertions(+), 2 deletions(-) diff --git a/ru-RU/plugins/common/admin.md b/ru-RU/plugins/common/admin.md index f5d3ed7a1703..86f16ea19aac 100644 --- a/ru-RU/plugins/common/admin.md +++ b/ru-RU/plugins/common/admin.md @@ -1,10 +1,10 @@ # 数据管理 (Admin) -::: tip +:::tip 要使用本插件，你需要安装数据库支持。 ::: -::: tip +:::tip 建议配合阅读 [入门 > 权限管理](../../manual/usage/customize.md#权限管理) 章节。 ::: @@ -48,6 +48,7 @@ assign 指令可用于设置频道的 [受理人](../../manual/usage/customize.m 2. 在频道 A 中发送 `assign @B`（假设 B 能收到此消息） ## 指令：user.flag 废弃 + ## 指令：channel.flag 废弃 - 基本语法：`xxx.flag [...names]` From 35e964b9eb83571289f04f839de9a30b324dbd39 Mon Sep 17 00:00:00 2001 From: koishi-bot <105629226+koishi-bot@users.noreply.github.com> Date: Mon, 11 Dec 2023 13:35:42 +0800 Subject: [PATCH 0655/3075] New translations admin.md (Chinese Traditional) [skip ci] --- zh-TW/plugins/common/admin.md | 5 +++-- 1 file changed, 3 insertions(+), 2 deletions(-) diff --git a/zh-TW/plugins/common/admin.md b/zh-TW/plugins/common/admin.md index f5d3ed7a1703..86f16ea19aac 100644 --- a/zh-TW/plugins/common/admin.md +++ b/zh-TW/plugins/common/admin.md @@ -1,10 +1,10 @@ # 数据管理 (Admin) -::: tip +:::tip 要使用本插件，你需要安装数据库支持。 ::: -::: tip +:::tip 建议配合阅读 [入门 > 权限管理](../../manual/usage/customize.md#权限管理) 章节。 ::: @@ -48,6 +48,7 @@ assign 指令可用于设置频道的 [受理人](../../manual/usage/customize.m 2. 在频道 A 中发送 `assign @B`（假设 B 能收到此消息） ## 指令：user.flag 废弃 + ## 指令：channel.flag 废弃 - 基本语法：`xxx.flag [...names]` From 58ce07ad8c0d36fad901d2d2d5a01c0363b2bfb9 Mon Sep 17 00:00:00 2001 From: koishi-bot <105629226+koishi-bot@users.noreply.github.com> Date: Mon, 11 Dec 2023 13:35:43 +0800 Subject: [PATCH 0656/3075] New translations admin.md (English, United States) [skip ci] --- en-US/plugins/common/admin.md | 11 ++++++----- 1 file changed, 6 insertions(+), 5 deletions(-) diff --git a/en-US/plugins/common/admin.md b/en-US/plugins/common/admin.md index 35d70817db5d..86f16ea19aac 100644 --- a/en-US/plugins/common/admin.md +++ b/en-US/plugins/common/admin.md @@ -1,10 +1,10 @@ -# Data Management (Admin) +# 数据管理 (Admin) -::: tip +:::tip 要使用本插件，你需要安装数据库支持。 ::: -::: tip +:::tip 建议配合阅读 [入门 > 权限管理](../../manual/usage/customize.md#权限管理) 章节。 ::: @@ -47,8 +47,9 @@ assign 指令可用于设置频道的 [受理人](../../manual/usage/customize.m 1. 私聊机器人 B，发送 `assign -c #A` 2. 在频道 A 中发送 `assign @B`（假设 B 能收到此消息） -## 指令：user.flag deprecated -## 指令：channel.flag deprecated +## 指令：user.flag 废弃 + +## 指令：channel.flag 废弃 - 基本语法：`xxx.flag [...names]` - 选项： From 28db51f6489c1107fa3bb8ad5fa6c0465338c199 Mon Sep 17 00:00:00 2001 From: koishi-bot <105629226+koishi-bot@users.noreply.github.com> Date: Mon, 11 Dec 2023 13:35:44 +0800 Subject: [PATCH 0657/3075] New translations bind.md (French) [skip ci] --- fr-FR/plugins/common/bind.md | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/fr-FR/plugins/common/bind.md b/fr-FR/plugins/common/bind.md index e475f16ee597..65ee65619ad1 100644 --- a/fr-FR/plugins/common/bind.md +++ b/fr-FR/plugins/common/bind.md @@ -1,10 +1,10 @@ # 账号绑定 (Bind) -::: tip +:::tip 要使用本插件，你需要安装数据库支持。 ::: -::: tip +:::tip 建议配合阅读 [入门 > 账号系统 > 账号绑定](../../manual/usage/platform.md#通过指令绑定) 章节。 ::: From 5ec091a190b3f6885eab89a979ce0da4e1f64ecf Mon Sep 17 00:00:00 2001 From: koishi-bot <105629226+koishi-bot@users.noreply.github.com> Date: Mon, 11 Dec 2023 13:35:45 +0800 Subject: [PATCH 0658/3075] New translations bind.md (German) [skip ci] --- de-DE/plugins/common/bind.md | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/de-DE/plugins/common/bind.md b/de-DE/plugins/common/bind.md index e475f16ee597..65ee65619ad1 100644 --- a/de-DE/plugins/common/bind.md +++ b/de-DE/plugins/common/bind.md @@ -1,10 +1,10 @@ # 账号绑定 (Bind) -::: tip +:::tip 要使用本插件，你需要安装数据库支持。 ::: -::: tip +:::tip 建议配合阅读 [入门 > 账号系统 > 账号绑定](../../manual/usage/platform.md#通过指令绑定) 章节。 ::: From 26aecab178c3102722b7651571120c54eba8e6d5 Mon Sep 17 00:00:00 2001 From: koishi-bot <105629226+koishi-bot@users.noreply.github.com> Date: Mon, 11 Dec 2023 13:35:46 +0800 Subject: [PATCH 0659/3075] New translations bind.md (Japanese) [skip ci] --- ja-JP/plugins/common/bind.md | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/ja-JP/plugins/common/bind.md b/ja-JP/plugins/common/bind.md index e475f16ee597..65ee65619ad1 100644 --- a/ja-JP/plugins/common/bind.md +++ b/ja-JP/plugins/common/bind.md @@ -1,10 +1,10 @@ # 账号绑定 (Bind) -::: tip +:::tip 要使用本插件，你需要安装数据库支持。 ::: -::: tip +:::tip 建议配合阅读 [入门 > 账号系统 > 账号绑定](../../manual/usage/platform.md#通过指令绑定) 章节。 ::: From 99deed57b77e02a1836b8f88758b4e0e302a3d76 Mon Sep 17 00:00:00 2001 From: koishi-bot <105629226+koishi-bot@users.noreply.github.com> Date: Mon, 11 Dec 2023 13:35:47 +0800 Subject: [PATCH 0660/3075] New translations bind.md (Russian) [skip ci] --- ru-RU/plugins/common/bind.md | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/ru-RU/plugins/common/bind.md b/ru-RU/plugins/common/bind.md index e475f16ee597..65ee65619ad1 100644 --- a/ru-RU/plugins/common/bind.md +++ b/ru-RU/plugins/common/bind.md @@ -1,10 +1,10 @@ # 账号绑定 (Bind) -::: tip +:::tip 要使用本插件，你需要安装数据库支持。 ::: -::: tip +:::tip 建议配合阅读 [入门 > 账号系统 > 账号绑定](../../manual/usage/platform.md#通过指令绑定) 章节。 ::: From 838a14071db1b25bf4d60adda6e70e15499ae903 Mon Sep 17 00:00:00 2001 From: koishi-bot <105629226+koishi-bot@users.noreply.github.com> Date: Mon, 11 Dec 2023 13:35:48 +0800 Subject: [PATCH 0661/3075] New translations bind.md (Chinese Traditional) [skip ci] --- zh-TW/plugins/common/bind.md | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/zh-TW/plugins/common/bind.md b/zh-TW/plugins/common/bind.md index e475f16ee597..65ee65619ad1 100644 --- a/zh-TW/plugins/common/bind.md +++ b/zh-TW/plugins/common/bind.md @@ -1,10 +1,10 @@ # 账号绑定 (Bind) -::: tip +:::tip 要使用本插件，你需要安装数据库支持。 ::: -::: tip +:::tip 建议配合阅读 [入门 > 账号系统 > 账号绑定](../../manual/usage/platform.md#通过指令绑定) 章节。 ::: From 5ba8dd00f9c56e3d79f5ec0a6ebf383b9f93318c Mon Sep 17 00:00:00 2001 From: koishi-bot <105629226+koishi-bot@users.noreply.github.com> Date: Mon, 11 Dec 2023 13:35:49 +0800 Subject: [PATCH 0662/3075] New translations bind.md (English, United States) [skip ci] --- en-US/plugins/common/bind.md | 6 +++--- 1 file changed, 3 insertions(+), 3 deletions(-) diff --git a/en-US/plugins/common/bind.md b/en-US/plugins/common/bind.md index 6ac7ac2ce0c9..65ee65619ad1 100644 --- a/en-US/plugins/common/bind.md +++ b/en-US/plugins/common/bind.md @@ -1,10 +1,10 @@ -# Account Connection (Bind) +# 账号绑定 (Bind) -::: tip +:::tip 要使用本插件，你需要安装数据库支持。 ::: -::: tip +:::tip 建议配合阅读 [入门 > 账号系统 > 账号绑定](../../manual/usage/platform.md#通过指令绑定) 章节。 ::: From 1c999008b13d3e5e3927e35dc8a18176877276a0 Mon Sep 17 00:00:00 2001 From: koishi-bot <105629226+koishi-bot@users.noreply.github.com> Date: Mon, 11 Dec 2023 13:35:50 +0800 Subject: [PATCH 0663/3075] New translations broadcast.md (French) [skip ci] --- fr-FR/plugins/common/broadcast.md | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/fr-FR/plugins/common/broadcast.md b/fr-FR/plugins/common/broadcast.md index bf23ba15cdda..4769932c3644 100644 --- a/fr-FR/plugins/common/broadcast.md +++ b/fr-FR/plugins/common/broadcast.md @@ -1,6 +1,6 @@ # 发送广播 (Broadcast) -::: tip +:::tip 要使用本插件，你需要安装数据库支持。 ::: @@ -20,6 +20,6 @@ broadcast foo bar baz # 向所有频道发送 foo bar baz 当一个机器人账号同时向多个频道发送广播消息时，为了避免风控，Koishi 会给每条消息发送后添加一段延迟，可以通过 [`delay.broadcast`](../../api/core/app.md#options-delay) 进行配置。 -::: tip 提示 +:::tip 提示 broadcast 指令的 message 参数是一个 [变长参数](../../manual/usage/command.md#参数和选项)，因此你应该把所有的选项写到消息前面，否则会被认为是消息的一部分。 ::: From 62ff5bfd1f4a8cf00f9e5d44744a531b7b6829c4 Mon Sep 17 00:00:00 2001 From: koishi-bot <105629226+koishi-bot@users.noreply.github.com> Date: Mon, 11 Dec 2023 13:35:52 +0800 Subject: [PATCH 0664/3075] New translations broadcast.md (German) [skip ci] --- de-DE/plugins/common/broadcast.md | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/de-DE/plugins/common/broadcast.md b/de-DE/plugins/common/broadcast.md index bf23ba15cdda..4769932c3644 100644 --- a/de-DE/plugins/common/broadcast.md +++ b/de-DE/plugins/common/broadcast.md @@ -1,6 +1,6 @@ # 发送广播 (Broadcast) -::: tip +:::tip 要使用本插件，你需要安装数据库支持。 ::: @@ -20,6 +20,6 @@ broadcast foo bar baz # 向所有频道发送 foo bar baz 当一个机器人账号同时向多个频道发送广播消息时，为了避免风控，Koishi 会给每条消息发送后添加一段延迟，可以通过 [`delay.broadcast`](../../api/core/app.md#options-delay) 进行配置。 -::: tip 提示 +:::tip 提示 broadcast 指令的 message 参数是一个 [变长参数](../../manual/usage/command.md#参数和选项)，因此你应该把所有的选项写到消息前面，否则会被认为是消息的一部分。 ::: From 54c4452fe3e92647d10b1e052d97a0aede703ad3 Mon Sep 17 00:00:00 2001 From: koishi-bot <105629226+koishi-bot@users.noreply.github.com> Date: Mon, 11 Dec 2023 13:35:52 +0800 Subject: [PATCH 0665/3075] New translations broadcast.md (Japanese) [skip ci] --- ja-JP/plugins/common/broadcast.md | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/ja-JP/plugins/common/broadcast.md b/ja-JP/plugins/common/broadcast.md index bf23ba15cdda..4769932c3644 100644 --- a/ja-JP/plugins/common/broadcast.md +++ b/ja-JP/plugins/common/broadcast.md @@ -1,6 +1,6 @@ # 发送广播 (Broadcast) -::: tip +:::tip 要使用本插件，你需要安装数据库支持。 ::: @@ -20,6 +20,6 @@ broadcast foo bar baz # 向所有频道发送 foo bar baz 当一个机器人账号同时向多个频道发送广播消息时，为了避免风控，Koishi 会给每条消息发送后添加一段延迟，可以通过 [`delay.broadcast`](../../api/core/app.md#options-delay) 进行配置。 -::: tip 提示 +:::tip 提示 broadcast 指令的 message 参数是一个 [变长参数](../../manual/usage/command.md#参数和选项)，因此你应该把所有的选项写到消息前面，否则会被认为是消息的一部分。 ::: From 96e81c03ee67c92cb23d3323fbae571e5c064802 Mon Sep 17 00:00:00 2001 From: koishi-bot <105629226+koishi-bot@users.noreply.github.com> Date: Mon, 11 Dec 2023 13:35:54 +0800 Subject: [PATCH 0666/3075] New translations broadcast.md (Russian) [skip ci] --- ru-RU/plugins/common/broadcast.md | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/ru-RU/plugins/common/broadcast.md b/ru-RU/plugins/common/broadcast.md index bf23ba15cdda..4769932c3644 100644 --- a/ru-RU/plugins/common/broadcast.md +++ b/ru-RU/plugins/common/broadcast.md @@ -1,6 +1,6 @@ # 发送广播 (Broadcast) -::: tip +:::tip 要使用本插件，你需要安装数据库支持。 ::: @@ -20,6 +20,6 @@ broadcast foo bar baz # 向所有频道发送 foo bar baz 当一个机器人账号同时向多个频道发送广播消息时，为了避免风控，Koishi 会给每条消息发送后添加一段延迟，可以通过 [`delay.broadcast`](../../api/core/app.md#options-delay) 进行配置。 -::: tip 提示 +:::tip 提示 broadcast 指令的 message 参数是一个 [变长参数](../../manual/usage/command.md#参数和选项)，因此你应该把所有的选项写到消息前面，否则会被认为是消息的一部分。 ::: From fab698ee5f671ff9a782718cdc93f0853814cbc7 Mon Sep 17 00:00:00 2001 From: koishi-bot <105629226+koishi-bot@users.noreply.github.com> Date: Mon, 11 Dec 2023 13:35:54 +0800 Subject: [PATCH 0667/3075] New translations broadcast.md (Chinese Traditional) [skip ci] --- zh-TW/plugins/common/broadcast.md | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/zh-TW/plugins/common/broadcast.md b/zh-TW/plugins/common/broadcast.md index bf23ba15cdda..4769932c3644 100644 --- a/zh-TW/plugins/common/broadcast.md +++ b/zh-TW/plugins/common/broadcast.md @@ -1,6 +1,6 @@ # 发送广播 (Broadcast) -::: tip +:::tip 要使用本插件，你需要安装数据库支持。 ::: @@ -20,6 +20,6 @@ broadcast foo bar baz # 向所有频道发送 foo bar baz 当一个机器人账号同时向多个频道发送广播消息时，为了避免风控，Koishi 会给每条消息发送后添加一段延迟，可以通过 [`delay.broadcast`](../../api/core/app.md#options-delay) 进行配置。 -::: tip 提示 +:::tip 提示 broadcast 指令的 message 参数是一个 [变长参数](../../manual/usage/command.md#参数和选项)，因此你应该把所有的选项写到消息前面，否则会被认为是消息的一部分。 ::: From df4f693fb58b9969e54939b5bf5dd035b5b9eece Mon Sep 17 00:00:00 2001 From: koishi-bot <105629226+koishi-bot@users.noreply.github.com> Date: Mon, 11 Dec 2023 13:35:55 +0800 Subject: [PATCH 0668/3075] New translations broadcast.md (English, United States) [skip ci] --- en-US/plugins/common/broadcast.md | 6 +++--- 1 file changed, 3 insertions(+), 3 deletions(-) diff --git a/en-US/plugins/common/broadcast.md b/en-US/plugins/common/broadcast.md index f1fb9e8ef989..4769932c3644 100644 --- a/en-US/plugins/common/broadcast.md +++ b/en-US/plugins/common/broadcast.md @@ -1,6 +1,6 @@ -# Broadcasting (Broadcast) +# 发送广播 (Broadcast) -::: tip +:::tip 要使用本插件，你需要安装数据库支持。 ::: @@ -20,6 +20,6 @@ broadcast foo bar baz # 向所有频道发送 foo bar baz 当一个机器人账号同时向多个频道发送广播消息时，为了避免风控，Koishi 会给每条消息发送后添加一段延迟，可以通过 [`delay.broadcast`](../../api/core/app.md#options-delay) 进行配置。 -::: tip 提示 +:::tip 提示 broadcast 指令的 message 参数是一个 [变长参数](../../manual/usage/command.md#参数和选项)，因此你应该把所有的选项写到消息前面，否则会被认为是消息的一部分。 ::: From 4e60e11e4c900688b0f36a9549956690b60e6f75 Mon Sep 17 00:00:00 2001 From: koishi-bot <105629226+koishi-bot@users.noreply.github.com> Date: Mon, 11 Dec 2023 13:35:56 +0800 Subject: [PATCH 0669/3075] New translations callme.md (French) [skip ci] --- fr-FR/plugins/common/callme.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/fr-FR/plugins/common/callme.md b/fr-FR/plugins/common/callme.md index ea3fc6e389ad..44136e374d02 100644 --- a/fr-FR/plugins/common/callme.md +++ b/fr-FR/plugins/common/callme.md @@ -1,6 +1,6 @@ # 设置昵称 (Callme) -::: tip +:::tip 要使用本插件，你需要安装数据库支持。 ::: From 5df145f5cee7ea1a59f9140c55faa1b127ee80ac Mon Sep 17 00:00:00 2001 From: koishi-bot <105629226+koishi-bot@users.noreply.github.com> Date: Mon, 11 Dec 2023 13:35:57 +0800 Subject: [PATCH 0670/3075] New translations callme.md (German) [skip ci] --- de-DE/plugins/common/callme.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/de-DE/plugins/common/callme.md b/de-DE/plugins/common/callme.md index ea3fc6e389ad..44136e374d02 100644 --- a/de-DE/plugins/common/callme.md +++ b/de-DE/plugins/common/callme.md @@ -1,6 +1,6 @@ # 设置昵称 (Callme) -::: tip +:::tip 要使用本插件，你需要安装数据库支持。 ::: From 2f8cf00d76f8999bc0ccdac7cfa5c77d551e38f2 Mon Sep 17 00:00:00 2001 From: koishi-bot <105629226+koishi-bot@users.noreply.github.com> Date: Mon, 11 Dec 2023 13:35:58 +0800 Subject: [PATCH 0671/3075] New translations callme.md (Japanese) [skip ci] --- ja-JP/plugins/common/callme.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/ja-JP/plugins/common/callme.md b/ja-JP/plugins/common/callme.md index ea3fc6e389ad..44136e374d02 100644 --- a/ja-JP/plugins/common/callme.md +++ b/ja-JP/plugins/common/callme.md @@ -1,6 +1,6 @@ # 设置昵称 (Callme) -::: tip +:::tip 要使用本插件，你需要安装数据库支持。 ::: From cb67c9d4aef546ea97b5587a3931b0297b46ee0d Mon Sep 17 00:00:00 2001 From: koishi-bot <105629226+koishi-bot@users.noreply.github.com> Date: Mon, 11 Dec 2023 13:35:59 +0800 Subject: [PATCH 0672/3075] New translations callme.md (Russian) [skip ci] --- ru-RU/plugins/common/callme.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/ru-RU/plugins/common/callme.md b/ru-RU/plugins/common/callme.md index ea3fc6e389ad..44136e374d02 100644 --- a/ru-RU/plugins/common/callme.md +++ b/ru-RU/plugins/common/callme.md @@ -1,6 +1,6 @@ # 设置昵称 (Callme) -::: tip +:::tip 要使用本插件，你需要安装数据库支持。 ::: From 1b9476e062467d71dc763c95eba79290dbb8fd5d Mon Sep 17 00:00:00 2001 From: koishi-bot <105629226+koishi-bot@users.noreply.github.com> Date: Mon, 11 Dec 2023 13:36:00 +0800 Subject: [PATCH 0673/3075] New translations callme.md (Chinese Traditional) [skip ci] --- zh-TW/plugins/common/callme.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/zh-TW/plugins/common/callme.md b/zh-TW/plugins/common/callme.md index ea3fc6e389ad..44136e374d02 100644 --- a/zh-TW/plugins/common/callme.md +++ b/zh-TW/plugins/common/callme.md @@ -1,6 +1,6 @@ # 设置昵称 (Callme) -::: tip +:::tip 要使用本插件，你需要安装数据库支持。 ::: From 0449695d5340b9b8f506009d8967b66ed66efa58 Mon Sep 17 00:00:00 2001 From: koishi-bot <105629226+koishi-bot@users.noreply.github.com> Date: Mon, 11 Dec 2023 13:36:01 +0800 Subject: [PATCH 0674/3075] New translations callme.md (English, United States) [skip ci] --- en-US/plugins/common/callme.md | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/en-US/plugins/common/callme.md b/en-US/plugins/common/callme.md index 41c8d17cce4d..44136e374d02 100644 --- a/en-US/plugins/common/callme.md +++ b/en-US/plugins/common/callme.md @@ -1,6 +1,6 @@ -# Nickname Setting (Callme) +# 设置昵称 (Callme) -::: tip +:::tip 要使用本插件，你需要安装数据库支持。 ::: From fb100ff6667da6a2398d045163ced6b5e6f5190b Mon Sep 17 00:00:00 2001 From: koishi-bot <105629226+koishi-bot@users.noreply.github.com> Date: Mon, 11 Dec 2023 13:36:02 +0800 Subject: [PATCH 0675/3075] New translations echo.md (French) [skip ci] --- fr-FR/plugins/common/echo.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/fr-FR/plugins/common/echo.md b/fr-FR/plugins/common/echo.md index 5f2168b01d4d..170f2eaa4f7e 100644 --- a/fr-FR/plugins/common/echo.md +++ b/fr-FR/plugins/common/echo.md @@ -19,6 +19,6 @@ echo -u @foo foo bar # 向用户 foo 私聊发送 foo bar echo -c #bar foo bar # 向频道 bar 发送 foo bar ``` -::: tip 提示 +:::tip 提示 echo 指令的 message 参数是一个 [变长参数](../../manual/usage/command.md#参数和选项)，因此你应该把所有的选项写到消息前面，否则会被认为是消息的一部分。 ::: From f3db5f6c6dee8580858039a15df91e03b6991082 Mon Sep 17 00:00:00 2001 From: koishi-bot <105629226+koishi-bot@users.noreply.github.com> Date: Mon, 11 Dec 2023 13:36:03 +0800 Subject: [PATCH 0676/3075] New translations echo.md (German) [skip ci] --- de-DE/plugins/common/echo.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/de-DE/plugins/common/echo.md b/de-DE/plugins/common/echo.md index 5f2168b01d4d..170f2eaa4f7e 100644 --- a/de-DE/plugins/common/echo.md +++ b/de-DE/plugins/common/echo.md @@ -19,6 +19,6 @@ echo -u @foo foo bar # 向用户 foo 私聊发送 foo bar echo -c #bar foo bar # 向频道 bar 发送 foo bar ``` -::: tip 提示 +:::tip 提示 echo 指令的 message 参数是一个 [变长参数](../../manual/usage/command.md#参数和选项)，因此你应该把所有的选项写到消息前面，否则会被认为是消息的一部分。 ::: From 5161c1f046ed802766b6dca0f74ca6a4eebcc0cf Mon Sep 17 00:00:00 2001 From: koishi-bot <105629226+koishi-bot@users.noreply.github.com> Date: Mon, 11 Dec 2023 13:36:04 +0800 Subject: [PATCH 0677/3075] New translations echo.md (Japanese) [skip ci] --- ja-JP/plugins/common/echo.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/ja-JP/plugins/common/echo.md b/ja-JP/plugins/common/echo.md index 5f2168b01d4d..170f2eaa4f7e 100644 --- a/ja-JP/plugins/common/echo.md +++ b/ja-JP/plugins/common/echo.md @@ -19,6 +19,6 @@ echo -u @foo foo bar # 向用户 foo 私聊发送 foo bar echo -c #bar foo bar # 向频道 bar 发送 foo bar ``` -::: tip 提示 +:::tip 提示 echo 指令的 message 参数是一个 [变长参数](../../manual/usage/command.md#参数和选项)，因此你应该把所有的选项写到消息前面，否则会被认为是消息的一部分。 ::: From 1063aa71a23b26f070a53ec148adcf79d3cd3e06 Mon Sep 17 00:00:00 2001 From: koishi-bot <105629226+koishi-bot@users.noreply.github.com> Date: Mon, 11 Dec 2023 13:36:05 +0800 Subject: [PATCH 0678/3075] New translations echo.md (Russian) [skip ci] --- ru-RU/plugins/common/echo.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/ru-RU/plugins/common/echo.md b/ru-RU/plugins/common/echo.md index 5f2168b01d4d..170f2eaa4f7e 100644 --- a/ru-RU/plugins/common/echo.md +++ b/ru-RU/plugins/common/echo.md @@ -19,6 +19,6 @@ echo -u @foo foo bar # 向用户 foo 私聊发送 foo bar echo -c #bar foo bar # 向频道 bar 发送 foo bar ``` -::: tip 提示 +:::tip 提示 echo 指令的 message 参数是一个 [变长参数](../../manual/usage/command.md#参数和选项)，因此你应该把所有的选项写到消息前面，否则会被认为是消息的一部分。 ::: From ca6a87b6731b99a59c2be03bc9e9ff973fb92700 Mon Sep 17 00:00:00 2001 From: koishi-bot <105629226+koishi-bot@users.noreply.github.com> Date: Mon, 11 Dec 2023 13:36:06 +0800 Subject: [PATCH 0679/3075] New translations echo.md (Chinese Traditional) [skip ci] --- zh-TW/plugins/common/echo.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/zh-TW/plugins/common/echo.md b/zh-TW/plugins/common/echo.md index 5f2168b01d4d..170f2eaa4f7e 100644 --- a/zh-TW/plugins/common/echo.md +++ b/zh-TW/plugins/common/echo.md @@ -19,6 +19,6 @@ echo -u @foo foo bar # 向用户 foo 私聊发送 foo bar echo -c #bar foo bar # 向频道 bar 发送 foo bar ``` -::: tip 提示 +:::tip 提示 echo 指令的 message 参数是一个 [变长参数](../../manual/usage/command.md#参数和选项)，因此你应该把所有的选项写到消息前面，否则会被认为是消息的一部分。 ::: From 304ecd0d4d197fce8711937ea2dabeff672ebd42 Mon Sep 17 00:00:00 2001 From: koishi-bot <105629226+koishi-bot@users.noreply.github.com> Date: Mon, 11 Dec 2023 13:36:07 +0800 Subject: [PATCH 0680/3075] New translations echo.md (English, United States) [skip ci] --- en-US/plugins/common/echo.md | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/en-US/plugins/common/echo.md b/en-US/plugins/common/echo.md index 40cebc50b5bf..170f2eaa4f7e 100644 --- a/en-US/plugins/common/echo.md +++ b/en-US/plugins/common/echo.md @@ -1,4 +1,4 @@ -# Send Messages (Echo) +# 发送消息 (Echo) ## 指令：echo @@ -19,6 +19,6 @@ echo -u @foo foo bar # 向用户 foo 私聊发送 foo bar echo -c #bar foo bar # 向频道 bar 发送 foo bar ``` -::: tip 提示 +:::tip 提示 echo 指令的 message 参数是一个 [变长参数](../../manual/usage/command.md#参数和选项)，因此你应该把所有的选项写到消息前面，否则会被认为是消息的一部分。 ::: From a90d9af447ef81216983a8354beb5bfe9a489e91 Mon Sep 17 00:00:00 2001 From: koishi-bot <105629226+koishi-bot@users.noreply.github.com> Date: Mon, 11 Dec 2023 13:36:08 +0800 Subject: [PATCH 0681/3075] New translations help.md (French) [skip ci] --- fr-FR/plugins/common/help.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/fr-FR/plugins/common/help.md b/fr-FR/plugins/common/help.md index 0024e2b38995..2707d21528b2 100644 --- a/fr-FR/plugins/common/help.md +++ b/fr-FR/plugins/common/help.md @@ -1,6 +1,6 @@ # 查看帮助 (Help) -::: tip +:::tip 使用方法请参见 [入门 > 指令系统 > 查看帮助](../../manual/usage/command.md#查看帮助) 章节。 ::: From f357d90dccb4d12db1fb31aef2aa86a7c682f6fa Mon Sep 17 00:00:00 2001 From: koishi-bot <105629226+koishi-bot@users.noreply.github.com> Date: Mon, 11 Dec 2023 13:36:09 +0800 Subject: [PATCH 0682/3075] New translations help.md (German) [skip ci] --- de-DE/plugins/common/help.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/de-DE/plugins/common/help.md b/de-DE/plugins/common/help.md index 0024e2b38995..2707d21528b2 100644 --- a/de-DE/plugins/common/help.md +++ b/de-DE/plugins/common/help.md @@ -1,6 +1,6 @@ # 查看帮助 (Help) -::: tip +:::tip 使用方法请参见 [入门 > 指令系统 > 查看帮助](../../manual/usage/command.md#查看帮助) 章节。 ::: From 78eaddd2b06915d373227629f9dd85f5a6d38cab Mon Sep 17 00:00:00 2001 From: koishi-bot <105629226+koishi-bot@users.noreply.github.com> Date: Mon, 11 Dec 2023 13:36:10 +0800 Subject: [PATCH 0683/3075] New translations help.md (Japanese) [skip ci] --- ja-JP/plugins/common/help.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/ja-JP/plugins/common/help.md b/ja-JP/plugins/common/help.md index 0024e2b38995..2707d21528b2 100644 --- a/ja-JP/plugins/common/help.md +++ b/ja-JP/plugins/common/help.md @@ -1,6 +1,6 @@ # 查看帮助 (Help) -::: tip +:::tip 使用方法请参见 [入门 > 指令系统 > 查看帮助](../../manual/usage/command.md#查看帮助) 章节。 ::: From 6199f8852338e5dfaf896179adc84bbf4a7eb11f Mon Sep 17 00:00:00 2001 From: koishi-bot <105629226+koishi-bot@users.noreply.github.com> Date: Mon, 11 Dec 2023 13:36:11 +0800 Subject: [PATCH 0684/3075] New translations help.md (Russian) [skip ci] --- ru-RU/plugins/common/help.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/ru-RU/plugins/common/help.md b/ru-RU/plugins/common/help.md index 0024e2b38995..2707d21528b2 100644 --- a/ru-RU/plugins/common/help.md +++ b/ru-RU/plugins/common/help.md @@ -1,6 +1,6 @@ # 查看帮助 (Help) -::: tip +:::tip 使用方法请参见 [入门 > 指令系统 > 查看帮助](../../manual/usage/command.md#查看帮助) 章节。 ::: From 1cdafcb104ddb6672bf2ccdb537d615308736407 Mon Sep 17 00:00:00 2001 From: koishi-bot <105629226+koishi-bot@users.noreply.github.com> Date: Mon, 11 Dec 2023 13:36:12 +0800 Subject: [PATCH 0685/3075] New translations help.md (Chinese Traditional) [skip ci] --- zh-TW/plugins/common/help.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/zh-TW/plugins/common/help.md b/zh-TW/plugins/common/help.md index 0024e2b38995..2707d21528b2 100644 --- a/zh-TW/plugins/common/help.md +++ b/zh-TW/plugins/common/help.md @@ -1,6 +1,6 @@ # 查看帮助 (Help) -::: tip +:::tip 使用方法请参见 [入门 > 指令系统 > 查看帮助](../../manual/usage/command.md#查看帮助) 章节。 ::: From 618bf995335ca061c04e8ee1ba27d9fa6d14815f Mon Sep 17 00:00:00 2001 From: koishi-bot <105629226+koishi-bot@users.noreply.github.com> Date: Mon, 11 Dec 2023 13:36:13 +0800 Subject: [PATCH 0686/3075] New translations help.md (English, United States) [skip ci] --- en-US/plugins/common/help.md | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/en-US/plugins/common/help.md b/en-US/plugins/common/help.md index 8b8615bf9ab3..2707d21528b2 100644 --- a/en-US/plugins/common/help.md +++ b/en-US/plugins/common/help.md @@ -1,6 +1,6 @@ -# Display Help (Help) +# 查看帮助 (Help) -::: tip +:::tip 使用方法请参见 [入门 > 指令系统 > 查看帮助](../../manual/usage/command.md#查看帮助) 章节。 ::: From 51687cd64e7ce429346b94bb52f11a5eb7103f15 Mon Sep 17 00:00:00 2001 From: koishi-bot <105629226+koishi-bot@users.noreply.github.com> Date: Mon, 11 Dec 2023 13:36:14 +0800 Subject: [PATCH 0687/3075] New translations inspect.md (French) [skip ci] --- fr-FR/plugins/common/inspect.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/fr-FR/plugins/common/inspect.md b/fr-FR/plugins/common/inspect.md index 3128dbe960ac..674fdce8744b 100644 --- a/fr-FR/plugins/common/inspect.md +++ b/fr-FR/plugins/common/inspect.md @@ -1,5 +1,5 @@ # 会话信息 (Inspect) -::: tip +:::tip 使用方法请参见 [入门 > 账号系统 > 获取账号信息](../../manual/usage/platform.md#获取账号信息) 章节。 ::: From 1654444a2a2a1a675557949b8de9586d5af82d5c Mon Sep 17 00:00:00 2001 From: koishi-bot <105629226+koishi-bot@users.noreply.github.com> Date: Mon, 11 Dec 2023 13:36:15 +0800 Subject: [PATCH 0688/3075] New translations inspect.md (German) [skip ci] --- de-DE/plugins/common/inspect.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/de-DE/plugins/common/inspect.md b/de-DE/plugins/common/inspect.md index 3128dbe960ac..674fdce8744b 100644 --- a/de-DE/plugins/common/inspect.md +++ b/de-DE/plugins/common/inspect.md @@ -1,5 +1,5 @@ # 会话信息 (Inspect) -::: tip +:::tip 使用方法请参见 [入门 > 账号系统 > 获取账号信息](../../manual/usage/platform.md#获取账号信息) 章节。 ::: From 99734afed1a40bd4cfd1f362f95195dc7be09f21 Mon Sep 17 00:00:00 2001 From: koishi-bot <105629226+koishi-bot@users.noreply.github.com> Date: Mon, 11 Dec 2023 13:36:16 +0800 Subject: [PATCH 0689/3075] New translations inspect.md (Japanese) [skip ci] --- ja-JP/plugins/common/inspect.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/ja-JP/plugins/common/inspect.md b/ja-JP/plugins/common/inspect.md index 3128dbe960ac..674fdce8744b 100644 --- a/ja-JP/plugins/common/inspect.md +++ b/ja-JP/plugins/common/inspect.md @@ -1,5 +1,5 @@ # 会话信息 (Inspect) -::: tip +:::tip 使用方法请参见 [入门 > 账号系统 > 获取账号信息](../../manual/usage/platform.md#获取账号信息) 章节。 ::: From e213b123690d84b8c0c1d325ad6aa378edbaaa69 Mon Sep 17 00:00:00 2001 From: koishi-bot <105629226+koishi-bot@users.noreply.github.com> Date: Mon, 11 Dec 2023 13:36:17 +0800 Subject: [PATCH 0690/3075] New translations inspect.md (Russian) [skip ci] --- ru-RU/plugins/common/inspect.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/ru-RU/plugins/common/inspect.md b/ru-RU/plugins/common/inspect.md index 3128dbe960ac..674fdce8744b 100644 --- a/ru-RU/plugins/common/inspect.md +++ b/ru-RU/plugins/common/inspect.md @@ -1,5 +1,5 @@ # 会话信息 (Inspect) -::: tip +:::tip 使用方法请参见 [入门 > 账号系统 > 获取账号信息](../../manual/usage/platform.md#获取账号信息) 章节。 ::: From 40a37143073ae981ef1369434965478dfdd1a69a Mon Sep 17 00:00:00 2001 From: koishi-bot <105629226+koishi-bot@users.noreply.github.com> Date: Mon, 11 Dec 2023 13:36:18 +0800 Subject: [PATCH 0691/3075] New translations inspect.md (Chinese Traditional) [skip ci] --- zh-TW/plugins/common/inspect.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/zh-TW/plugins/common/inspect.md b/zh-TW/plugins/common/inspect.md index 3128dbe960ac..674fdce8744b 100644 --- a/zh-TW/plugins/common/inspect.md +++ b/zh-TW/plugins/common/inspect.md @@ -1,5 +1,5 @@ # 会话信息 (Inspect) -::: tip +:::tip 使用方法请参见 [入门 > 账号系统 > 获取账号信息](../../manual/usage/platform.md#获取账号信息) 章节。 ::: From 45a67ab61a955d8bae2275a9b647326a61927909 Mon Sep 17 00:00:00 2001 From: koishi-bot <105629226+koishi-bot@users.noreply.github.com> Date: Mon, 11 Dec 2023 13:36:19 +0800 Subject: [PATCH 0692/3075] New translations inspect.md (English, United States) [skip ci] --- en-US/plugins/common/inspect.md | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/en-US/plugins/common/inspect.md b/en-US/plugins/common/inspect.md index 3f2c33340e9e..674fdce8744b 100644 --- a/en-US/plugins/common/inspect.md +++ b/en-US/plugins/common/inspect.md @@ -1,5 +1,5 @@ -# Session Inspector (Inspect) +# 会话信息 (Inspect) -::: tip +:::tip 使用方法请参见 [入门 > 账号系统 > 获取账号信息](../../manual/usage/platform.md#获取账号信息) 章节。 ::: From 64e3f4210c43ae5ad56d6df3532e6110612c4982 Mon Sep 17 00:00:00 2001 From: koishi-bot <105629226+koishi-bot@users.noreply.github.com> Date: Mon, 11 Dec 2023 13:36:23 +0800 Subject: [PATCH 0693/3075] New translations analytics.md (English, United States) [skip ci] --- en-US/plugins/console/analytics.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/en-US/plugins/console/analytics.md b/en-US/plugins/console/analytics.md index 485869fa85fc..df5e8943caea 100644 --- a/en-US/plugins/console/analytics.md +++ b/en-US/plugins/console/analytics.md @@ -1 +1 @@ -# Data Analytics (Analytics) +# 数据统计 (Analytics) From 7fca9a9f41357bc562c322d491b1f37dbb855b08 Mon Sep 17 00:00:00 2001 From: koishi-bot <105629226+koishi-bot@users.noreply.github.com> Date: Mon, 11 Dec 2023 13:36:27 +0800 Subject: [PATCH 0694/3075] New translations commands.md (French) [skip ci] --- fr-FR/plugins/console/commands.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/fr-FR/plugins/console/commands.md b/fr-FR/plugins/console/commands.md index 1a42b3e4f194..866252bf51a1 100644 --- a/fr-FR/plugins/console/commands.md +++ b/fr-FR/plugins/console/commands.md @@ -1,6 +1,6 @@ # 指令管理 (Commands) -::: tip +:::tip 使用方法请参见 [入门 > 指令系统 > 指令管理](../../manual/usage/command.md#指令管理) 一节。 ::: From 60b8a4253b84cbbdeae4f70f0ee7bf977b25fb1f Mon Sep 17 00:00:00 2001 From: koishi-bot <105629226+koishi-bot@users.noreply.github.com> Date: Mon, 11 Dec 2023 13:36:28 +0800 Subject: [PATCH 0695/3075] New translations commands.md (German) [skip ci] --- de-DE/plugins/console/commands.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/de-DE/plugins/console/commands.md b/de-DE/plugins/console/commands.md index 1a42b3e4f194..866252bf51a1 100644 --- a/de-DE/plugins/console/commands.md +++ b/de-DE/plugins/console/commands.md @@ -1,6 +1,6 @@ # 指令管理 (Commands) -::: tip +:::tip 使用方法请参见 [入门 > 指令系统 > 指令管理](../../manual/usage/command.md#指令管理) 一节。 ::: From 7facd7738ef9474c4fc377f0482c6910c429a066 Mon Sep 17 00:00:00 2001 From: koishi-bot <105629226+koishi-bot@users.noreply.github.com> Date: Mon, 11 Dec 2023 13:36:30 +0800 Subject: [PATCH 0696/3075] New translations commands.md (Japanese) [skip ci] --- ja-JP/plugins/console/commands.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/ja-JP/plugins/console/commands.md b/ja-JP/plugins/console/commands.md index 1a42b3e4f194..866252bf51a1 100644 --- a/ja-JP/plugins/console/commands.md +++ b/ja-JP/plugins/console/commands.md @@ -1,6 +1,6 @@ # 指令管理 (Commands) -::: tip +:::tip 使用方法请参见 [入门 > 指令系统 > 指令管理](../../manual/usage/command.md#指令管理) 一节。 ::: From 70f3f9ab730379c4d732658a6d1e0c252ceb6f47 Mon Sep 17 00:00:00 2001 From: koishi-bot <105629226+koishi-bot@users.noreply.github.com> Date: Mon, 11 Dec 2023 13:36:30 +0800 Subject: [PATCH 0697/3075] New translations commands.md (Russian) [skip ci] --- ru-RU/plugins/console/commands.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/ru-RU/plugins/console/commands.md b/ru-RU/plugins/console/commands.md index 1a42b3e4f194..866252bf51a1 100644 --- a/ru-RU/plugins/console/commands.md +++ b/ru-RU/plugins/console/commands.md @@ -1,6 +1,6 @@ # 指令管理 (Commands) -::: tip +:::tip 使用方法请参见 [入门 > 指令系统 > 指令管理](../../manual/usage/command.md#指令管理) 一节。 ::: From b2a7b97316b47ef3109b382bfb7fc5e223f55753 Mon Sep 17 00:00:00 2001 From: koishi-bot <105629226+koishi-bot@users.noreply.github.com> Date: Mon, 11 Dec 2023 13:36:31 +0800 Subject: [PATCH 0698/3075] New translations commands.md (Chinese Traditional) [skip ci] --- zh-TW/plugins/console/commands.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/zh-TW/plugins/console/commands.md b/zh-TW/plugins/console/commands.md index 1a42b3e4f194..866252bf51a1 100644 --- a/zh-TW/plugins/console/commands.md +++ b/zh-TW/plugins/console/commands.md @@ -1,6 +1,6 @@ # 指令管理 (Commands) -::: tip +:::tip 使用方法请参见 [入门 > 指令系统 > 指令管理](../../manual/usage/command.md#指令管理) 一节。 ::: From e51a3a8b6eea8c97c6fc64589182254ca9df6cf5 Mon Sep 17 00:00:00 2001 From: koishi-bot <105629226+koishi-bot@users.noreply.github.com> Date: Mon, 11 Dec 2023 13:36:32 +0800 Subject: [PATCH 0699/3075] New translations commands.md (English, United States) [skip ci] --- en-US/plugins/console/commands.md | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/en-US/plugins/console/commands.md b/en-US/plugins/console/commands.md index 33ff1409ae03..866252bf51a1 100644 --- a/en-US/plugins/console/commands.md +++ b/en-US/plugins/console/commands.md @@ -1,6 +1,6 @@ -# Command Management (Commands) +# 指令管理 (Commands) -::: tip +:::tip 使用方法请参见 [入门 > 指令系统 > 指令管理](../../manual/usage/command.md#指令管理) 一节。 ::: From 9ff3265f03f64d7d1a2fd6afb266c752be87860c Mon Sep 17 00:00:00 2001 From: koishi-bot <105629226+koishi-bot@users.noreply.github.com> Date: Mon, 11 Dec 2023 13:36:33 +0800 Subject: [PATCH 0700/3075] New translations config.md (French) [skip ci] --- fr-FR/plugins/console/config.md | 1 - 1 file changed, 1 deletion(-) diff --git a/fr-FR/plugins/console/config.md b/fr-FR/plugins/console/config.md index dc32e5984d42..60ccc2e4995b 100644 --- a/fr-FR/plugins/console/config.md +++ b/fr-FR/plugins/console/config.md @@ -1,2 +1 @@ # 插件配置 (Config) - From 09c6b555cf86170915a41d8a47c42932e42b611a Mon Sep 17 00:00:00 2001 From: koishi-bot <105629226+koishi-bot@users.noreply.github.com> Date: Mon, 11 Dec 2023 13:36:34 +0800 Subject: [PATCH 0701/3075] New translations config.md (German) [skip ci] --- de-DE/plugins/console/config.md | 1 - 1 file changed, 1 deletion(-) diff --git a/de-DE/plugins/console/config.md b/de-DE/plugins/console/config.md index dc32e5984d42..60ccc2e4995b 100644 --- a/de-DE/plugins/console/config.md +++ b/de-DE/plugins/console/config.md @@ -1,2 +1 @@ # 插件配置 (Config) - From 818049a72ab9dd82de32230b0afcdbc8272d6719 Mon Sep 17 00:00:00 2001 From: koishi-bot <105629226+koishi-bot@users.noreply.github.com> Date: Mon, 11 Dec 2023 13:36:35 +0800 Subject: [PATCH 0702/3075] New translations config.md (Japanese) [skip ci] --- ja-JP/plugins/console/config.md | 1 - 1 file changed, 1 deletion(-) diff --git a/ja-JP/plugins/console/config.md b/ja-JP/plugins/console/config.md index dc32e5984d42..60ccc2e4995b 100644 --- a/ja-JP/plugins/console/config.md +++ b/ja-JP/plugins/console/config.md @@ -1,2 +1 @@ # 插件配置 (Config) - From 1af0935513fa9b2c445672f595a49d274e09cd53 Mon Sep 17 00:00:00 2001 From: koishi-bot <105629226+koishi-bot@users.noreply.github.com> Date: Mon, 11 Dec 2023 13:36:36 +0800 Subject: [PATCH 0703/3075] New translations config.md (Russian) [skip ci] --- ru-RU/plugins/console/config.md | 1 - 1 file changed, 1 deletion(-) diff --git a/ru-RU/plugins/console/config.md b/ru-RU/plugins/console/config.md index dc32e5984d42..60ccc2e4995b 100644 --- a/ru-RU/plugins/console/config.md +++ b/ru-RU/plugins/console/config.md @@ -1,2 +1 @@ # 插件配置 (Config) - From bd083b25d8c2e617a981b874d533df6548b0d54d Mon Sep 17 00:00:00 2001 From: koishi-bot <105629226+koishi-bot@users.noreply.github.com> Date: Mon, 11 Dec 2023 13:36:37 +0800 Subject: [PATCH 0704/3075] New translations config.md (Chinese Traditional) [skip ci] --- zh-TW/plugins/console/config.md | 1 - 1 file changed, 1 deletion(-) diff --git a/zh-TW/plugins/console/config.md b/zh-TW/plugins/console/config.md index dc32e5984d42..60ccc2e4995b 100644 --- a/zh-TW/plugins/console/config.md +++ b/zh-TW/plugins/console/config.md @@ -1,2 +1 @@ # 插件配置 (Config) - From 2076e55ba2afaae795afa2300e5bcd12c013edc5 Mon Sep 17 00:00:00 2001 From: koishi-bot <105629226+koishi-bot@users.noreply.github.com> Date: Mon, 11 Dec 2023 13:36:38 +0800 Subject: [PATCH 0705/3075] New translations config.md (English, United States) [skip ci] --- en-US/plugins/console/config.md | 1 - 1 file changed, 1 deletion(-) diff --git a/en-US/plugins/console/config.md b/en-US/plugins/console/config.md index dc32e5984d42..60ccc2e4995b 100644 --- a/en-US/plugins/console/config.md +++ b/en-US/plugins/console/config.md @@ -1,2 +1 @@ # 插件配置 (Config) - From 19300ee75c704a5cc2a27be082a36875c1e1c73a Mon Sep 17 00:00:00 2001 From: koishi-bot <105629226+koishi-bot@users.noreply.github.com> Date: Mon, 11 Dec 2023 13:36:39 +0800 Subject: [PATCH 0706/3075] New translations explorer.md (French) [skip ci] --- fr-FR/plugins/console/explorer.md | 1 - 1 file changed, 1 deletion(-) diff --git a/fr-FR/plugins/console/explorer.md b/fr-FR/plugins/console/explorer.md index b54a092e7695..e6dbab8dbac5 100644 --- a/fr-FR/plugins/console/explorer.md +++ b/fr-FR/plugins/console/explorer.md @@ -1,2 +1 @@ # 资源管理器 (Explorer) - From 4f8ebf0d1190a14c50fa55a5516f1fc5b87f8fd6 Mon Sep 17 00:00:00 2001 From: koishi-bot <105629226+koishi-bot@users.noreply.github.com> Date: Mon, 11 Dec 2023 13:36:40 +0800 Subject: [PATCH 0707/3075] New translations explorer.md (German) [skip ci] --- de-DE/plugins/console/explorer.md | 1 - 1 file changed, 1 deletion(-) diff --git a/de-DE/plugins/console/explorer.md b/de-DE/plugins/console/explorer.md index b54a092e7695..e6dbab8dbac5 100644 --- a/de-DE/plugins/console/explorer.md +++ b/de-DE/plugins/console/explorer.md @@ -1,2 +1 @@ # 资源管理器 (Explorer) - From 4b7f1152981d729e16be963fd103d312f6c68db3 Mon Sep 17 00:00:00 2001 From: koishi-bot <105629226+koishi-bot@users.noreply.github.com> Date: Mon, 11 Dec 2023 13:36:41 +0800 Subject: [PATCH 0708/3075] New translations explorer.md (Japanese) [skip ci] --- ja-JP/plugins/console/explorer.md | 1 - 1 file changed, 1 deletion(-) diff --git a/ja-JP/plugins/console/explorer.md b/ja-JP/plugins/console/explorer.md index b54a092e7695..e6dbab8dbac5 100644 --- a/ja-JP/plugins/console/explorer.md +++ b/ja-JP/plugins/console/explorer.md @@ -1,2 +1 @@ # 资源管理器 (Explorer) - From 9dae4106295bcb9cd84b61d84464f4869bebe4b5 Mon Sep 17 00:00:00 2001 From: koishi-bot <105629226+koishi-bot@users.noreply.github.com> Date: Mon, 11 Dec 2023 13:36:41 +0800 Subject: [PATCH 0709/3075] New translations explorer.md (Russian) [skip ci] --- ru-RU/plugins/console/explorer.md | 1 - 1 file changed, 1 deletion(-) diff --git a/ru-RU/plugins/console/explorer.md b/ru-RU/plugins/console/explorer.md index b54a092e7695..e6dbab8dbac5 100644 --- a/ru-RU/plugins/console/explorer.md +++ b/ru-RU/plugins/console/explorer.md @@ -1,2 +1 @@ # 资源管理器 (Explorer) - From 37753f93094523e10cab8ea8d70c10ba2a20b29e Mon Sep 17 00:00:00 2001 From: koishi-bot <105629226+koishi-bot@users.noreply.github.com> Date: Mon, 11 Dec 2023 13:36:42 +0800 Subject: [PATCH 0710/3075] New translations explorer.md (Chinese Traditional) [skip ci] --- zh-TW/plugins/console/explorer.md | 1 - 1 file changed, 1 deletion(-) diff --git a/zh-TW/plugins/console/explorer.md b/zh-TW/plugins/console/explorer.md index b54a092e7695..e6dbab8dbac5 100644 --- a/zh-TW/plugins/console/explorer.md +++ b/zh-TW/plugins/console/explorer.md @@ -1,2 +1 @@ # 资源管理器 (Explorer) - From 4dfd5f258770b9f3c81a000dd0185ced982b3e78 Mon Sep 17 00:00:00 2001 From: koishi-bot <105629226+koishi-bot@users.noreply.github.com> Date: Mon, 11 Dec 2023 13:36:43 +0800 Subject: [PATCH 0711/3075] New translations explorer.md (English, United States) [skip ci] --- en-US/plugins/console/explorer.md | 3 +-- 1 file changed, 1 insertion(+), 2 deletions(-) diff --git a/en-US/plugins/console/explorer.md b/en-US/plugins/console/explorer.md index 2a8b2437633a..e6dbab8dbac5 100644 --- a/en-US/plugins/console/explorer.md +++ b/en-US/plugins/console/explorer.md @@ -1,2 +1 @@ -# Resource Manager (Explorer) - +# 资源管理器 (Explorer) From 1cdf047df396ba075bf2b91b7fe64cffd58b23fe Mon Sep 17 00:00:00 2001 From: koishi-bot <105629226+koishi-bot@users.noreply.github.com> Date: Mon, 11 Dec 2023 13:36:44 +0800 Subject: [PATCH 0712/3075] New translations index.md (French) [skip ci] --- fr-FR/plugins/console/index.md | 1 - 1 file changed, 1 deletion(-) diff --git a/fr-FR/plugins/console/index.md b/fr-FR/plugins/console/index.md index 4a5d5996c146..8eb6d44a0c0d 100644 --- a/fr-FR/plugins/console/index.md +++ b/fr-FR/plugins/console/index.md @@ -2,7 +2,6 @@ ## 配置项 - From 9a1ee0e39c8ee19e3c3951e91ef202653effd682 Mon Sep 17 00:00:00 2001 From: koishi-bot <105629226+koishi-bot@users.noreply.github.com> Date: Mon, 11 Dec 2023 15:06:20 +0800 Subject: [PATCH 1163/3075] New translations advanced.md (French) [skip ci] --- fr-FR/guide/basic/advanced.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/fr-FR/guide/basic/advanced.md b/fr-FR/guide/basic/advanced.md index de219215bd42..5ffd55b67bc2 100644 --- a/fr-FR/guide/basic/advanced.md +++ b/fr-FR/guide/basic/advanced.md @@ -1,4 +1,4 @@ -# 进阶用法 +# Utilisation avancée 在前面的几节中，我们已经了解了基础的交互概念。以他们为基础，Koishi 提供了一些进阶的用法，用于处理真实应用场景中的交互需求。 From 0c761b064ed105820a43d327fa3b0370d0804a62 Mon Sep 17 00:00:00 2001 From: koishi-bot <105629226+koishi-bot@users.noreply.github.com> Date: Mon, 11 Dec 2023 15:06:21 +0800 Subject: [PATCH 1164/3075] New translations advanced.md (Japanese) [skip ci] --- ja-JP/guide/basic/advanced.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/ja-JP/guide/basic/advanced.md b/ja-JP/guide/basic/advanced.md index de219215bd42..382189095629 100644 --- a/ja-JP/guide/basic/advanced.md +++ b/ja-JP/guide/basic/advanced.md @@ -1,4 +1,4 @@ -# 进阶用法 +# アドバンスト 在前面的几节中，我们已经了解了基础的交互概念。以他们为基础，Koishi 提供了一些进阶的用法，用于处理真实应用场景中的交互需求。 From 4cb5bb2d0eac7ff6d03c05c5dd3bdf5b2955ae78 Mon Sep 17 00:00:00 2001 From: koishi-bot <105629226+koishi-bot@users.noreply.github.com> Date: Mon, 11 Dec 2023 15:06:23 +0800 Subject: [PATCH 1165/3075] New translations advanced.md (Chinese Traditional) [skip ci] --- zh-TW/guide/basic/advanced.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/zh-TW/guide/basic/advanced.md b/zh-TW/guide/basic/advanced.md index de219215bd42..9c1b235dcdd0 100644 --- a/zh-TW/guide/basic/advanced.md +++ b/zh-TW/guide/basic/advanced.md @@ -1,4 +1,4 @@ -# 进阶用法 +# 進階用法 在前面的几节中，我们已经了解了基础的交互概念。以他们为基础，Koishi 提供了一些进阶的用法，用于处理真实应用场景中的交互需求。 From c74a502a7da82fcc220587c7c70518163b8d3469 Mon Sep 17 00:00:00 2001 From: koishi-bot <105629226+koishi-bot@users.noreply.github.com> Date: Mon, 11 Dec 2023 15:06:24 +0800 Subject: [PATCH 1166/3075] New translations advanced.md (English, United States) [skip ci] --- en-US/guide/basic/advanced.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/en-US/guide/basic/advanced.md b/en-US/guide/basic/advanced.md index de219215bd42..248f1e2b9771 100644 --- a/en-US/guide/basic/advanced.md +++ b/en-US/guide/basic/advanced.md @@ -1,4 +1,4 @@ -# 进阶用法 +# Advanced Usage 在前面的几节中，我们已经了解了基础的交互概念。以他们为基础，Koishi 提供了一些进阶的用法，用于处理真实应用场景中的交互需求。 From 662a9fd2795bff77832cf1bec74f09f7721ba0e5 Mon Sep 17 00:00:00 2001 From: koishi-bot <105629226+koishi-bot@users.noreply.github.com> Date: Mon, 11 Dec 2023 15:06:25 +0800 Subject: [PATCH 1167/3075] New translations command.md (French) [skip ci] --- fr-FR/guide/basic/command.md | 10 +++++----- 1 file changed, 5 insertions(+), 5 deletions(-) diff --git a/fr-FR/guide/basic/command.md b/fr-FR/guide/basic/command.md index 9e006962d58f..e722308bffe5 100644 --- a/fr-FR/guide/basic/command.md +++ b/fr-FR/guide/basic/command.md @@ -1,4 +1,4 @@ -# 指令开发 +# Commande :::tip 在学习本节之前，建议先完整阅读 [入门 > 指令系统](../../manual/usage/command.md)。 @@ -371,8 +371,8 @@ ctx.command('bar 一条看不见的指令', { hidden: true }) help -

当前可用的指令有：

-

help 显示帮助信息

+

Commandes disponibles :

+

help Afficher l'aide

输入“帮助+指令名”查看特定指令的语法和使用示例。

 help bar @@ -389,8 +389,8 @@ ctx.command('bar 一条看不见的指令', { hidden: true }) help -H -

当前可用的指令有：

-

help 显示帮助信息

+

Commandes disponibles :

+

help Afficher l'aide

bar 一条看不见的指令

输入“帮助+指令名”查看特定指令的语法和使用示例。

 From 54147f224100cb14941fdbdb295d4813111cf462 Mon Sep 17 00:00:00 2001 From: koishi-bot <105629226+koishi-bot@users.noreply.github.com> Date: Mon, 11 Dec 2023 15:06:27 +0800 Subject: [PATCH 1168/3075] New translations command.md (Japanese) [skip ci] --- ja-JP/guide/basic/command.md | 6 +++--- 1 file changed, 3 insertions(+), 3 deletions(-) diff --git a/ja-JP/guide/basic/command.md b/ja-JP/guide/basic/command.md index fbabb402d971..ae158be46a38 100644 --- a/ja-JP/guide/basic/command.md +++ b/ja-JP/guide/basic/command.md @@ -1,4 +1,4 @@ -# 指令开发 +# コマンドの開発 :::tip 在学习本节之前，建议先完整阅读 [入门 > 指令系统](../../manual/usage/command.md)。 @@ -371,7 +371,7 @@ ctx.command('bar 一条看不见的指令', { hidden: true }) help -

当前可用的指令有：

+

利用可能なコマンド：

help 显示帮助信息

输入“帮助+指令名”查看特定指令的语法和使用示例。

 @@ -389,7 +389,7 @@ ctx.command('bar 一条看不见的指令', { hidden: true }) help -H -

当前可用的指令有：

+

利用可能なコマンド：

help 显示帮助信息

bar 一条看不见的指令

输入“帮助+指令名”查看特定指令的语法和使用示例。

From 35f2bcb5e2b89a500f583104697d75ce7be78891 Mon Sep 17 00:00:00 2001 From: koishi-bot <105629226+koishi-bot@users.noreply.github.com> Date: Mon, 11 Dec 2023 15:06:29 +0800 Subject: [PATCH 1169/3075] New translations command.md (Chinese Traditional) [skip ci] --- zh-TW/guide/basic/command.md | 10 +++++----- 1 file changed, 5 insertions(+), 5 deletions(-) diff --git a/zh-TW/guide/basic/command.md b/zh-TW/guide/basic/command.md index 1ce2fa9525b9..d9c82994aabf 100644 --- a/zh-TW/guide/basic/command.md +++ b/zh-TW/guide/basic/command.md @@ -1,4 +1,4 @@ -# 指令开发 +# 指令開發 :::tip 在学习本节之前，建议先完整阅读 [入门 > 指令系统](../../manual/usage/command.md)。 @@ -371,8 +371,8 @@ ctx.command('bar 一条看不见的指令', { hidden: true }) help -

当前可用的指令有：

-

help 显示帮助信息

+

當前可用的指令有：

+

help 顯示幫助資訊

输入“帮助+指令名”查看特定指令的语法和使用示例。

 help bar @@ -389,8 +389,8 @@ ctx.command('bar 一条看不见的指令', { hidden: true }) help -H -

当前可用的指令有：

-

help 显示帮助信息

+

當前可用的指令有：

+

help 顯示幫助資訊

bar 一条看不见的指令

输入“帮助+指令名”查看特定指令的语法和使用示例。

 From 0b08860966b9efc0f1ddac43c265cb582db242d2 Mon Sep 17 00:00:00 2001 From: koishi-bot <105629226+koishi-bot@users.noreply.github.com> Date: Mon, 11 Dec 2023 15:06:30 +0800 Subject: [PATCH 1170/3075] New translations command.md (English, United States) [skip ci] --- en-US/guide/basic/command.md | 6 +++--- 1 file changed, 3 insertions(+), 3 deletions(-) diff --git a/en-US/guide/basic/command.md b/en-US/guide/basic/command.md index bc2cb9a5afc6..29b6817bcefe 100644 --- a/en-US/guide/basic/command.md +++ b/en-US/guide/basic/command.md @@ -1,4 +1,4 @@ -# 指令开发 +# Command :::tip 在学习本节之前，建议先完整阅读 [入门 > 指令系统](../../manual/usage/command.md)。 @@ -372,7 +372,7 @@ ctx.command('bar 一条看不见的指令', { hidden: true }) help

Available commands:

-

help 显示帮助信息

+

help Show help

输入“帮助+指令名”查看特定指令的语法和使用示例。

 help bar @@ -390,7 +390,7 @@ ctx.command('bar 一条看不见的指令', { hidden: true }) help -H

Available commands:

-

help 显示帮助信息

+

help Show help

bar 一条看不见的指令

输入“帮助+指令名”查看特定指令的语法和使用示例。

 From 6393b1e302374495bc46e14e2e4d2e479e440187 Mon Sep 17 00:00:00 2001 From: koishi-bot <105629226+koishi-bot@users.noreply.github.com> Date: Mon, 11 Dec 2023 15:06:31 +0800 Subject: [PATCH 1171/3075] New translations element.md (French) [skip ci] --- fr-FR/guide/basic/element.md | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/fr-FR/guide/basic/element.md b/fr-FR/guide/basic/element.md index 7d4e25f09df4..f4d48730288a 100644 --- a/fr-FR/guide/basic/element.md +++ b/fr-FR/guide/basic/element.md @@ -4,7 +4,7 @@ 消息元素类似于 HTML 元素，它是组成消息的基本单位。一个元素可以表示具有特定语义的内容，如文本、表情、图片、引用、元信息等。Koishi 会将这些元素转换为平台所支持的格式，以便在不同平台之间发送和接收消息。 -## 基本用法 +## Utilisation de base 一个典型的元素包含名称、属性和内容。在 Koishi 中，我们通常使用 JSX 或 API 的方式创建元素。下面是一些例子： @@ -70,7 +70,7 @@ h('p', 'hello', h('image', { url })) h('message', ) ``` -## 标准元素 +## Éléments standards Koishi 提供了一系列标准元素，它们覆盖了绝大部分常见的需求。例如： From 8a8b395c61000d8a0891d0578f1ab87a8b097c07 Mon Sep 17 00:00:00 2001 From: koishi-bot <105629226+koishi-bot@users.noreply.github.com> Date: Mon, 11 Dec 2023 15:06:33 +0800 Subject: [PATCH 1172/3075] New translations element.md (Japanese) [skip ci] --- ja-JP/guide/basic/element.md | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/ja-JP/guide/basic/element.md b/ja-JP/guide/basic/element.md index 7145737a11de..8cf27cc48ec2 100644 --- a/ja-JP/guide/basic/element.md +++ b/ja-JP/guide/basic/element.md @@ -1,4 +1,4 @@ -# 消息元素 +# メッセージ要素 当然，一个聊天平台所能发送或接收的内容往往不只有纯文本。为此，我们引入了 **消息元素 (Element)** 的概念。 @@ -70,7 +70,7 @@ h('p', 'hello', h('image', { url })) h('message', ) ``` -## 标准元素 +## 標準要素 Koishi 提供了一系列标准元素，它们覆盖了绝大部分常见的需求。例如： From b65e7e9f93eb2baaeb125416adc95c505d9aaaa9 Mon Sep 17 00:00:00 2001 From: koishi-bot <105629226+koishi-bot@users.noreply.github.com> Date: Mon, 11 Dec 2023 15:06:34 +0800 Subject: [PATCH 1173/3075] New translations element.md (Chinese Traditional) [skip ci] --- zh-TW/guide/basic/element.md | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/zh-TW/guide/basic/element.md b/zh-TW/guide/basic/element.md index 7145737a11de..3ca54fa1d501 100644 --- a/zh-TW/guide/basic/element.md +++ b/zh-TW/guide/basic/element.md @@ -1,4 +1,4 @@ -# 消息元素 +# 訊息元素 当然，一个聊天平台所能发送或接收的内容往往不只有纯文本。为此，我们引入了 **消息元素 (Element)** 的概念。 @@ -70,7 +70,7 @@ h('p', 'hello', h('image', { url })) h('message', ) ``` -## 标准元素 +## 標準元素 Koishi 提供了一系列标准元素，它们覆盖了绝大部分常见的需求。例如： From d753b99a8398f3626954ed227926d649203a85bd Mon Sep 17 00:00:00 2001 From: koishi-bot <105629226+koishi-bot@users.noreply.github.com> Date: Mon, 11 Dec 2023 15:06:35 +0800 Subject: [PATCH 1174/3075] New translations element.md (English, United States) [skip ci] --- en-US/guide/basic/element.md | 14 +++++++------- 1 file changed, 7 insertions(+), 7 deletions(-) diff --git a/en-US/guide/basic/element.md b/en-US/guide/basic/element.md index e13bd8eb9190..157a87620334 100644 --- a/en-US/guide/basic/element.md +++ b/en-US/guide/basic/element.md @@ -4,7 +4,7 @@ 消息元素类似于 HTML 元素，它是组成消息的基本单位。一个元素可以表示具有特定语义的内容，如文本、表情、图片、引用、元信息等。Koishi 会将这些元素转换为平台所支持的格式，以便在不同平台之间发送和接收消息。 -## 基本用法 +## Basic Usage 一个典型的元素包含名称、属性和内容。在 Koishi 中，我们通常使用 JSX 或 API 的方式创建元素。下面是一些例子： @@ -30,13 +30,13 @@ session.send(h('image', { url: 'https://koishi.chat/logo.png' })) 这两种写法各有优劣，不同人可能会有不同的偏好。但无论哪一种写法都表达了同样的意思。 -### 使用 JSX +### Use JSX 学习 JSX 的写法需要你有一定的 HTML 基础 (如果有 React 基础将更好，尽管这不是必需的)。如果你不熟悉 HTML，可以参考 [这篇文档](https://developer.mozilla.org/zh-CN/docs/Glossary/Element)。 如果你已经学习过 HTML 的相关知识，你唯一额外需要了解的事情就是我们使用单花括号 `{}` 进行插值。你可以在单花括号中使用任何 JavaScript 表达式，它们会在运算完成后成为元素的一部分。此外，我们还为消息元素编写了完整的 [语法规范](../../api/message/syntax.md)，供你参考。 -### 使用 API +### Use API 对于更喜欢原生 JavaScript 的人，我们也提供了 API 的方式来创建元素。Koishi 提供一个 `h` 函数，它有着灵活的使用方式： @@ -70,7 +70,7 @@ h('p', 'hello', h('image', { url })) h('message', ) ``` -## 标准元素 +## Standard Elements Koishi 提供了一系列标准元素，它们覆盖了绝大部分常见的需求。例如： @@ -151,11 +151,11 @@ h.image(buffer, 'image/png') **消息组件 (Component)** 是一种对消息元素的扩展和封装。它允许你创建可重用的定制元素，并在渲染时引入自定义逻辑。例如，`` 组件会将其中的内容作为指令执行，并将执行结果替换该元素： ```html -这是执行结果：echo hello +Execution result: echo hello ``` -这是执行结果：hello +Execution result: hello 如你所见，你可以像使用普通的消息元素一样使用消息组件。唯一的区别是消息组件不由适配器实现，而是由 Koishi 直接处理。与之相对的，某些消息组件只有在特定的会话环境下才能使用 (例如在 `ctx.broadcast()` 中传入 `` 是无意义的，也会抛出错误)。 @@ -202,7 +202,7 @@ session.send(h(Custom)) ::: -### 注册全局组件 +### Register Global Component 上面的写法只能在当前文件中使用，并且必须以大写字母开头。如果想要更自然的写法，并将组件提供给其他插件使用，只需使用 `ctx.component()` 将它注册为一个全局组件： From 6e91ef1b0d19efb927c6860858b8e43c49a836da Mon Sep 17 00:00:00 2001 From: koishi-bot <105629226+koishi-bot@users.noreply.github.com> Date: Mon, 11 Dec 2023 15:06:37 +0800 Subject: [PATCH 1175/3075] New translations events.md (French) [skip ci] --- fr-FR/guide/basic/events.md | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/fr-FR/guide/basic/events.md b/fr-FR/guide/basic/events.md index 004b572008f1..55003c892595 100644 --- a/fr-FR/guide/basic/events.md +++ b/fr-FR/guide/basic/events.md @@ -1,8 +1,8 @@ -# 事件系统 +# Système événement 在上一节中我们了解了指令开发，现在让我们回到更加基础的事件系统。事件系统在 Koishi 中扮演着底层的角色，它不仅包含由聊天平台触发的会话事件，还包含了监听运行状态的生命周期事件和提供扩展性的自定义事件。 -## 基本用法 +## Utilisation de base 让我们先从一个基本示例开始： From 2de52b50fc90a668d78bc27ed289c3e823b49bcd Mon Sep 17 00:00:00 2001 From: koishi-bot <105629226+koishi-bot@users.noreply.github.com> Date: Mon, 11 Dec 2023 15:06:38 +0800 Subject: [PATCH 1176/3075] New translations events.md (Japanese) [skip ci] --- ja-JP/guide/basic/events.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/ja-JP/guide/basic/events.md b/ja-JP/guide/basic/events.md index 004b572008f1..9dcf6bbb688c 100644 --- a/ja-JP/guide/basic/events.md +++ b/ja-JP/guide/basic/events.md @@ -1,4 +1,4 @@ -# 事件系统 +# イベントシステム 在上一节中我们了解了指令开发，现在让我们回到更加基础的事件系统。事件系统在 Koishi 中扮演着底层的角色，它不仅包含由聊天平台触发的会话事件，还包含了监听运行状态的生命周期事件和提供扩展性的自定义事件。 From a1b36d1b814c7cb070471763225a0566f91de329 Mon Sep 17 00:00:00 2001 From: koishi-bot <105629226+koishi-bot@users.noreply.github.com> Date: Mon, 11 Dec 2023 15:06:40 +0800 Subject: [PATCH 1177/3075] New translations events.md (Chinese Traditional) [skip ci] --- zh-TW/guide/basic/events.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/zh-TW/guide/basic/events.md b/zh-TW/guide/basic/events.md index 004b572008f1..b1fd49851ba8 100644 --- a/zh-TW/guide/basic/events.md +++ b/zh-TW/guide/basic/events.md @@ -1,4 +1,4 @@ -# 事件系统 +# 事件系統 在上一节中我们了解了指令开发，现在让我们回到更加基础的事件系统。事件系统在 Koishi 中扮演着底层的角色，它不仅包含由聊天平台触发的会话事件，还包含了监听运行状态的生命周期事件和提供扩展性的自定义事件。 From 39c592eb8cd70b4b8d4d7ea6388da99eb54adf7b Mon Sep 17 00:00:00 2001 From: koishi-bot <105629226+koishi-bot@users.noreply.github.com> Date: Mon, 11 Dec 2023 15:06:41 +0800 Subject: [PATCH 1178/3075] New translations events.md (English, United States) [skip ci] --- en-US/guide/basic/events.md | 6 +++--- 1 file changed, 3 insertions(+), 3 deletions(-) diff --git a/en-US/guide/basic/events.md b/en-US/guide/basic/events.md index 004b572008f1..b9ce9335eaeb 100644 --- a/en-US/guide/basic/events.md +++ b/en-US/guide/basic/events.md @@ -1,8 +1,8 @@ -# 事件系统 +# Event 在上一节中我们了解了指令开发，现在让我们回到更加基础的事件系统。事件系统在 Koishi 中扮演着底层的角色，它不仅包含由聊天平台触发的会话事件，还包含了监听运行状态的生命周期事件和提供扩展性的自定义事件。 -## 基本用法 +## Basic Usage 让我们先从一个基本示例开始： @@ -96,7 +96,7 @@ ctx.on('dialogue/before-search', callback, true) 如果你开发的插件希望允许其他插件扩展，那么触发事件就是最简单的方式。 -触发事件的基本用法也都与 EventEmitter 类似，第一个参数是事件名称，之后的参数对应回调函数的参数。下面是一个例子： +触发事件的基本用法也都与 EventEmitter 类似，第一个参数是事件名称，之后的参数对应回调函数的参数。Below is an example: ```ts declare module 'koishi' { From 5bea6177233aa82bfb8ab19b97f2c8b4c0cb9ce4 Mon Sep 17 00:00:00 2001 From: koishi-bot <105629226+koishi-bot@users.noreply.github.com> Date: Mon, 11 Dec 2023 15:06:42 +0800 Subject: [PATCH 1179/3075] New translations middleware.md (French) [skip ci] --- fr-FR/guide/basic/middleware.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/fr-FR/guide/basic/middleware.md b/fr-FR/guide/basic/middleware.md index 7b16b7217a4c..4ab973c23cb7 100644 --- a/fr-FR/guide/basic/middleware.md +++ b/fr-FR/guide/basic/middleware.md @@ -8,7 +8,7 @@ 与事件系统的通用性不同，中间件专注于消息事件。你不能使用中间件处理其他类型的事件。 ::: -## 基本用法 +## Utilisation de base 还记得上一节介绍的 [基本示例](./events.md#基本用法) 吗？让我们把它改成中间件的形式： From 75a5db6b6f5abf2ee3995a25aaec3fb856da0030 Mon Sep 17 00:00:00 2001 From: koishi-bot <105629226+koishi-bot@users.noreply.github.com> Date: Mon, 11 Dec 2023 15:06:44 +0800 Subject: [PATCH 1180/3075] New translations middleware.md (Chinese Traditional) [skip ci] --- zh-TW/guide/basic/middleware.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/zh-TW/guide/basic/middleware.md b/zh-TW/guide/basic/middleware.md index 647a65fadbbe..0f917b9ab6f5 100644 --- a/zh-TW/guide/basic/middleware.md +++ b/zh-TW/guide/basic/middleware.md @@ -1,4 +1,4 @@ -# 中间件 +# 中介軟體 有了接收事件和发送消息的能力，似乎你就能完成一切工作了——很多机器人框架也的确是这么想的。但是从 Koishi 的角度，这还远远不够。因为当我们面临更复杂的需求时，新的问题也会随之产生：如何限制消息能触发的应答次数？如何进行权限管理？如何提高机器人的性能？这些问题的答案将我们引向另一套更高级的系统——这也就是中间件的由来。 From fbd284d00b56352786d3766aa4c6e73279e4856f Mon Sep 17 00:00:00 2001 From: koishi-bot <105629226+koishi-bot@users.noreply.github.com> Date: Mon, 11 Dec 2023 15:06:45 +0800 Subject: [PATCH 1181/3075] New translations middleware.md (English, United States) [skip ci] --- en-US/guide/basic/middleware.md | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/en-US/guide/basic/middleware.md b/en-US/guide/basic/middleware.md index 7b16b7217a4c..45989875b998 100644 --- a/en-US/guide/basic/middleware.md +++ b/en-US/guide/basic/middleware.md @@ -8,7 +8,7 @@ 与事件系统的通用性不同，中间件专注于消息事件。你不能使用中间件处理其他类型的事件。 ::: -## 基本用法 +## Basic Usage 还记得上一节介绍的 [基本示例](./events.md#基本用法) 吗？让我们把它改成中间件的形式： @@ -108,7 +108,7 @@ ctx.middleware((session, next) => { 有的时候，你也可能需要实现这样一种逻辑：你的中间件产生了一个响应，但你认为这个响应优先级较低，希望等后续中间件执行完毕后，如果信号仍然未被截取，就执行之前的响应。这当然可以通过注册新的中间件并取消的方法来实现，但是由于这个新注册的中间件可能不被执行，你需要手动处理许多的边界情况。 -为了应对这种问题 Koishi 提供了更加方便的写法：你只需要在调用 `next` 时再次传入一个回调函数即可！这个回调函数只接受一个 `next` 参数，且只会加入当前的中间件执行队列；无论这个回调函数执行与否，在本次中间件解析完成后，它都会被清除。下面是一个例子： +为了应对这种问题 Koishi 提供了更加方便的写法：你只需要在调用 `next` 时再次传入一个回调函数即可！这个回调函数只接受一个 `next` 参数，且只会加入当前的中间件执行队列；无论这个回调函数执行与否，在本次中间件解析完成后，它都会被清除。Below is an example: ```ts ctx.middleware((session, next) => { From 2f9946d7666891241ffb2ff4ce58bf42fd306fa9 Mon Sep 17 00:00:00 2001 From: koishi-bot <105629226+koishi-bot@users.noreply.github.com> Date: Mon, 11 Dec 2023 15:06:47 +0800 Subject: [PATCH 1182/3075] New translations client.md (French) [skip ci] --- fr-FR/guide/console/client.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/fr-FR/guide/console/client.md b/fr-FR/guide/console/client.md index dea08395a16a..00b01ddda028 100644 --- a/fr-FR/guide/console/client.md +++ b/fr-FR/guide/console/client.md @@ -1,4 +1,4 @@ -# 客户端开发 +# Développement du client ## 布局组件 From 154991f11d67d4fa31e63131bcfd7337edc84abb Mon Sep 17 00:00:00 2001 From: koishi-bot <105629226+koishi-bot@users.noreply.github.com> Date: Mon, 11 Dec 2023 15:06:49 +0800 Subject: [PATCH 1183/3075] New translations client.md (Chinese Traditional) [skip ci] --- zh-TW/guide/console/client.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/zh-TW/guide/console/client.md b/zh-TW/guide/console/client.md index dea08395a16a..ba8f17d5bc1d 100644 --- a/zh-TW/guide/console/client.md +++ b/zh-TW/guide/console/client.md @@ -1,4 +1,4 @@ -# 客户端开发 +# 客戶端開發 ## 布局组件 From 37b86b4743289ec28838f85a41c8b59e27950aaf Mon Sep 17 00:00:00 2001 From: koishi-bot <105629226+koishi-bot@users.noreply.github.com> Date: Mon, 11 Dec 2023 15:06:50 +0800 Subject: [PATCH 1184/3075] New translations client.md (English, United States) [skip ci] --- en-US/guide/console/client.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/en-US/guide/console/client.md b/en-US/guide/console/client.md index dea08395a16a..e9bf6b7fb3f7 100644 --- a/en-US/guide/console/client.md +++ b/en-US/guide/console/client.md @@ -1,4 +1,4 @@ -# 客户端开发 +# Client Components ## 布局组件 From c51a8434281ccdd65bf89d410e65def2084f2549 Mon Sep 17 00:00:00 2001 From: koishi-bot <105629226+koishi-bot@users.noreply.github.com> Date: Mon, 11 Dec 2023 15:06:51 +0800 Subject: [PATCH 1185/3075] New translations data.md (French) [skip ci] --- fr-FR/guide/console/data.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/fr-FR/guide/console/data.md b/fr-FR/guide/console/data.md index 6de6c49585a0..c6a563d18080 100644 --- a/fr-FR/guide/console/data.md +++ b/fr-FR/guide/console/data.md @@ -1,4 +1,4 @@ -# 数据交互 +# Échange avec données Koishi 控制台前后端的数据交互基本是通过 WebSocket 实现的。为了适应不同的场景，我们提供了多种数据交互的形式。 From 97b7056c008d51bd1f1252c517ab695887a15192 Mon Sep 17 00:00:00 2001 From: koishi-bot <105629226+koishi-bot@users.noreply.github.com> Date: Mon, 11 Dec 2023 15:06:53 +0800 Subject: [PATCH 1186/3075] New translations data.md (Japanese) [skip ci] --- ja-JP/guide/console/data.md | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/ja-JP/guide/console/data.md b/ja-JP/guide/console/data.md index df2a9a275d1a..d1916deede55 100644 --- a/ja-JP/guide/console/data.md +++ b/ja-JP/guide/console/data.md @@ -1,4 +1,4 @@ -# 数据交互 +# データ通信 Koishi 控制台前后端的数据交互基本是通过 WebSocket 实现的。为了适应不同的场景，我们提供了多种数据交互的形式。 @@ -117,7 +117,7 @@ send('get-greeting').then(data => { ``` -## 权限管理 +## 権限管理 当你引入了 @koishijs/plugin-auth 插件之后，你可以为你的页面访问和数据交互引入鉴权机制： From 9e3d840a640530c0cef92e1656fa82a563b3aabd Mon Sep 17 00:00:00 2001 From: koishi-bot <105629226+koishi-bot@users.noreply.github.com> Date: Mon, 11 Dec 2023 15:06:54 +0800 Subject: [PATCH 1187/3075] New translations data.md (Chinese Traditional) [skip ci] --- zh-TW/guide/console/data.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/zh-TW/guide/console/data.md b/zh-TW/guide/console/data.md index 42f37c963388..ce764c92c9a9 100644 --- a/zh-TW/guide/console/data.md +++ b/zh-TW/guide/console/data.md @@ -1,4 +1,4 @@ -# 数据交互 +# 資料互動 Koishi 控制台前后端的数据交互基本是通过 WebSocket 实现的。为了适应不同的场景，我们提供了多种数据交互的形式。 From 1d9400123646fe6c04f03f608c286e55a52d0e38 Mon Sep 17 00:00:00 2001 From: koishi-bot <105629226+koishi-bot@users.noreply.github.com> Date: Mon, 11 Dec 2023 15:06:55 +0800 Subject: [PATCH 1188/3075] New translations data.md (English, United States) [skip ci] --- en-US/guide/console/data.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/en-US/guide/console/data.md b/en-US/guide/console/data.md index baa90c929c31..a00c21e5b6b8 100644 --- a/en-US/guide/console/data.md +++ b/en-US/guide/console/data.md @@ -1,4 +1,4 @@ -# 数据交互 +# Data Exchange Koishi 控制台前后端的数据交互基本是通过 WebSocket 实现的。为了适应不同的场景，我们提供了多种数据交互的形式。 From 1a50fdc6153ec31287d975f98446d53765184603 Mon Sep 17 00:00:00 2001 From: koishi-bot <105629226+koishi-bot@users.noreply.github.com> Date: Mon, 11 Dec 2023 15:06:56 +0800 Subject: [PATCH 1189/3075] New translations index.md (French) [skip ci] --- fr-FR/guide/console/index.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/fr-FR/guide/console/index.md b/fr-FR/guide/console/index.md index b089838343bd..216189c810dd 100644 --- a/fr-FR/guide/console/index.md +++ b/fr-FR/guide/console/index.md @@ -1,4 +1,4 @@ -# 扩展控制台 +# Extension de la console :::tip 在学习本章之前，建议先完整阅读 [入门 > 认识控制台](../../manual/usage/market.md#认识控制台)。 From 13314b938cd92a1dd76dd325c14557b4cfe042cf Mon Sep 17 00:00:00 2001 From: koishi-bot <105629226+koishi-bot@users.noreply.github.com> Date: Mon, 11 Dec 2023 15:06:58 +0800 Subject: [PATCH 1190/3075] New translations index.md (Chinese Traditional) [skip ci] --- zh-TW/guide/console/index.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/zh-TW/guide/console/index.md b/zh-TW/guide/console/index.md index b089838343bd..6849682fd118 100644 --- a/zh-TW/guide/console/index.md +++ b/zh-TW/guide/console/index.md @@ -1,4 +1,4 @@ -# 扩展控制台 +# 擴充套件控制檯 :::tip 在学习本章之前，建议先完整阅读 [入门 > 认识控制台](../../manual/usage/market.md#认识控制台)。 From f151ffa6f06bb5f8c1d868cfd27f1ff6d0610916 Mon Sep 17 00:00:00 2001 From: koishi-bot <105629226+koishi-bot@users.noreply.github.com> Date: Mon, 11 Dec 2023 15:06:59 +0800 Subject: [PATCH 1191/3075] New translations index.md (English, United States) [skip ci] --- en-US/guide/console/index.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/en-US/guide/console/index.md b/en-US/guide/console/index.md index b089838343bd..d3ddf83597ab 100644 --- a/en-US/guide/console/index.md +++ b/en-US/guide/console/index.md @@ -1,4 +1,4 @@ -# 扩展控制台 +# Console Extension :::tip 在学习本章之前，建议先完整阅读 [入门 > 认识控制台](../../manual/usage/market.md#认识控制台)。 From 699d44aff44fdf2bf735a7c91134a3af3dc8eda1 Mon Sep 17 00:00:00 2001 From: koishi-bot <105629226+koishi-bot@users.noreply.github.com> Date: Mon, 11 Dec 2023 15:07:02 +0800 Subject: [PATCH 1192/3075] New translations builtin.md (French) [skip ci] --- fr-FR/guide/database/builtin.md | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/fr-FR/guide/database/builtin.md b/fr-FR/guide/database/builtin.md index 899dfa43780e..866bcff381e6 100644 --- a/fr-FR/guide/database/builtin.md +++ b/fr-FR/guide/database/builtin.md @@ -1,4 +1,4 @@ -# 内置数据结构 +# Structure des données internes @@ -61,7 +61,7 @@ cmd.userFields((argv, fields) => { 你可以在 [这里](../../api/utils/observer.md) 看到完整的观察者 API。 -## 进阶用法 +## Utilisation avancée ### attach 事件 From 624eecdbdcdff99e8de91d000014efa340075e12 Mon Sep 17 00:00:00 2001 From: koishi-bot <105629226+koishi-bot@users.noreply.github.com> Date: Mon, 11 Dec 2023 15:07:04 +0800 Subject: [PATCH 1193/3075] New translations builtin.md (Japanese) [skip ci] --- ja-JP/guide/database/builtin.md | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/ja-JP/guide/database/builtin.md b/ja-JP/guide/database/builtin.md index 899dfa43780e..291cb3818557 100644 --- a/ja-JP/guide/database/builtin.md +++ b/ja-JP/guide/database/builtin.md @@ -1,4 +1,4 @@ -# 内置数据结构 +# 組み込みデータ構造 @@ -61,7 +61,7 @@ cmd.userFields((argv, fields) => { 你可以在 [这里](../../api/utils/observer.md) 看到完整的观察者 API。 -## 进阶用法 +## アドバンスト ### attach 事件 From d3779da5771f1c89784f640fd4483bc066d6e36f Mon Sep 17 00:00:00 2001 From: koishi-bot <105629226+koishi-bot@users.noreply.github.com> Date: Mon, 11 Dec 2023 15:07:05 +0800 Subject: [PATCH 1194/3075] New translations builtin.md (Chinese Traditional) [skip ci] --- zh-TW/guide/database/builtin.md | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/zh-TW/guide/database/builtin.md b/zh-TW/guide/database/builtin.md index 899dfa43780e..3a293de2028a 100644 --- a/zh-TW/guide/database/builtin.md +++ b/zh-TW/guide/database/builtin.md @@ -1,4 +1,4 @@ -# 内置数据结构 +# 內建資料結構 @@ -61,7 +61,7 @@ cmd.userFields((argv, fields) => { 你可以在 [这里](../../api/utils/observer.md) 看到完整的观察者 API。 -## 进阶用法 +## 進階用法 ### attach 事件 From 27ee6f34fc209a04d3cf085d4a9cdc6944c9425b Mon Sep 17 00:00:00 2001 From: koishi-bot <105629226+koishi-bot@users.noreply.github.com> Date: Mon, 11 Dec 2023 15:07:06 +0800 Subject: [PATCH 1195/3075] New translations builtin.md (English, United States) [skip ci] --- en-US/guide/database/builtin.md | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/en-US/guide/database/builtin.md b/en-US/guide/database/builtin.md index 899dfa43780e..1b4e8fb894bd 100644 --- a/en-US/guide/database/builtin.md +++ b/en-US/guide/database/builtin.md @@ -1,4 +1,4 @@ -# 内置数据结构 +# Built-in Data Structure @@ -61,7 +61,7 @@ cmd.userFields((argv, fields) => { 你可以在 [这里](../../api/utils/observer.md) 看到完整的观察者 API。 -## 进阶用法 +## Advanced Usage ### attach 事件 From b6a7c72f08500c86abddd9e1a308f6d99f2b3f51 Mon Sep 17 00:00:00 2001 From: koishi-bot <105629226+koishi-bot@users.noreply.github.com> Date: Mon, 11 Dec 2023 15:07:07 +0800 Subject: [PATCH 1196/3075] New translations index.md (French) [skip ci] --- fr-FR/guide/database/index.md | 12 ++++++------ 1 file changed, 6 insertions(+), 6 deletions(-) diff --git a/fr-FR/guide/database/index.md b/fr-FR/guide/database/index.md index 375e75b30925..4910701b2d01 100644 --- a/fr-FR/guide/database/index.md +++ b/fr-FR/guide/database/index.md @@ -1,4 +1,4 @@ -# 基本用法 +# Utilisation de base :::tip `ctx.database` 并非内置服务，因此如果你的插件需要使用数据库功能，需要[声明依赖](../plugin/service.md#inject-属性)。 @@ -118,11 +118,11 @@ await ctx.database.upsert('foo', [ 那么进行上述操作后的数据库将是这样的： -| id | foo | bar | 说明 | -| -- | ----- | ------ | ---------------------------------- | -| 1 | hello | baz | 该行已经存在，只更新了 foo 字段 | -| 2 | world | bar | 插入了新行，其中 foo 字段取自传入的数据，bar 字段取自默认值 | -| 3 | null | koishi | 插入了新行，其中 bar 字段取自传入的数据，foo 字段取自默认值 | +| id | foo | bar | 说明 | +| -- | ------- | ------ | ---------------------------------- | +| 1 | bonjour | baz | 该行已经存在，只更新了 foo 字段 | +| 2 | world | bar | 插入了新行，其中 foo 字段取自传入的数据，bar 字段取自默认值 | +| 3 | null | koishi | 插入了新行，其中 bar 字段取自传入的数据，foo 字段取自默认值 | 如果想以非主键来索引要修改的数据，可以使用第三个参数： From 4f537f826549e6470ed395697e381bc1bcb98caf Mon Sep 17 00:00:00 2001 From: koishi-bot <105629226+koishi-bot@users.noreply.github.com> Date: Mon, 11 Dec 2023 15:07:10 +0800 Subject: [PATCH 1197/3075] New translations index.md (Chinese Traditional) [skip ci] --- zh-TW/guide/database/index.md | 14 +++++++------- 1 file changed, 7 insertions(+), 7 deletions(-) diff --git a/zh-TW/guide/database/index.md b/zh-TW/guide/database/index.md index d39e0ceee881..4874b63e7c2b 100644 --- a/zh-TW/guide/database/index.md +++ b/zh-TW/guide/database/index.md @@ -4,28 +4,28 @@ `ctx.database` 并非内置服务，因此如果你的插件需要使用数据库功能，需要[声明依赖](../plugin/service.md#inject-属性)。 ::: -对于几乎所有大型机器人项目，数据库的使用都是不可或缺的。但如果每个插件都独立处理与数据库的交互，这将导致插件之间的兼容性非常差——用户要么选择同时安装多个数据库，要么只能放弃一些功能。为此，Koishi 设计了一整套对象关系映射 (ORM) 接口，它易于扩展并广泛地运用于各种插件中，足以应对绝大部分使用场景。 +對於幾乎所有大型機器人專案，資料庫的使用都是不可或缺的。但如果每个插件都独立处理与数据库的交互，这将导致插件之间的兼容性非常差——用户要么选择同时安装多个数据库，要么只能放弃一些功能。为此，Koishi 设计了一整套对象关系映射 (ORM) 接口，它易于扩展并广泛地运用于各种插件中，足以应对绝大部分使用场景。 ## `get`：查询数据 -使用 `database.get()` 方法以获取特定表中的数据。下面是一个最基本的形式： +使用 `database.get()` 方法以获取特定表中的数据。下面是一個最基本的形式： ```ts -// 获取 schedule 表中 id 为 1234 的数据行，返回一个数组 +// 獲取 schedule 表中 id 為 1234 的資料行，返回一個陣列 await ctx.database.get('schedule', 1234) -// 获取 schedule 表中 id 为 1234 或 5678 的数据行，返回一个数组 +// 獲取 schedule 表中 id 為 1234 或 5678 的資料行，返回一個陣列 await ctx.database.get('schedule', [1234, 5678]) ``` -对于复杂的数据表，如果你只需要获取少数字段，你可以通过第三个参数手动指定要获取的字段： +對於複雜的資料表，如果你只需要獲取少數欄位，你可以透過第三個引數手動指定要獲取的欄位： ```ts // 返回的数组中每个元素只会包含 command, time 属性 await ctx.database.get('schedule', [1234], ['command', 'time']) ``` -你还可以向第二个参数传入一个对象，用来查询非主键上的数据或者同时指定多列的值： +你還可以向第二個引數傳入一個物件，用來查詢非主鍵上的資料或者同時指定多行的值： ```ts // 获取名为 schedule 的表中 assignee 为 telegram:123456 的数据行 @@ -118,7 +118,7 @@ await ctx.database.upsert('foo', [ 那么进行上述操作后的数据库将是这样的： -| id | foo | bar | 说明 | +| id | foo | bar | 說明 | | -- | ----- | ------ | ---------------------------------- | | 1 | hello | baz | 该行已经存在，只更新了 foo 字段 | | 2 | world | bar | 插入了新行，其中 foo 字段取自传入的数据，bar 字段取自默认值 | From 3accf753dd3cf78dbc2e7beee27dec969bb9ed28 Mon Sep 17 00:00:00 2001 From: koishi-bot <105629226+koishi-bot@users.noreply.github.com> Date: Mon, 11 Dec 2023 15:07:11 +0800 Subject: [PATCH 1198/3075] New translations index.md (English, United States) [skip ci] --- en-US/guide/database/index.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/en-US/guide/database/index.md b/en-US/guide/database/index.md index b5988f9bbe6d..862537c9a94c 100644 --- a/en-US/guide/database/index.md +++ b/en-US/guide/database/index.md @@ -1,4 +1,4 @@ -# 基本用法 +# Basic Usage :::tip `ctx.database` 并非内置服务，因此如果你的插件需要使用数据库功能，需要[声明依赖](../plugin/service.md#inject-属性)。 From c780ffab6d4dfb845c14e0136eb8a31b8b8a3347 Mon Sep 17 00:00:00 2001 From: koishi-bot <105629226+koishi-bot@users.noreply.github.com> Date: Mon, 11 Dec 2023 15:07:12 +0800 Subject: [PATCH 1199/3075] New translations model.md (French) [skip ci] --- fr-FR/guide/database/model.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/fr-FR/guide/database/model.md b/fr-FR/guide/database/model.md index 2553bf380706..df1af3cc44cd 100644 --- a/fr-FR/guide/database/model.md +++ b/fr-FR/guide/database/model.md @@ -1,4 +1,4 @@ -# 数据模型 +# Modèle de données Koishi 的架构允许任何插件对数据库的结构进行扩展。你就可以在不修改 Koishi 或其他插件源码的情况下，为数据库添加新的字段或者表。这些功能都是通过 `ctx.model` 提供的。 From fe436e65c740303c5cab64c56e7003235d3faf74 Mon Sep 17 00:00:00 2001 From: koishi-bot <105629226+koishi-bot@users.noreply.github.com> Date: Mon, 11 Dec 2023 15:07:15 +0800 Subject: [PATCH 1200/3075] New translations model.md (Chinese Traditional) [skip ci] --- zh-TW/guide/database/model.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/zh-TW/guide/database/model.md b/zh-TW/guide/database/model.md index 2553bf380706..3483727edb16 100644 --- a/zh-TW/guide/database/model.md +++ b/zh-TW/guide/database/model.md @@ -53,7 +53,7 @@ ctx.model.extend('user', { }) ``` -## 数据类型 +## 資料型別 上面的数据类型均直接使用字符串来定义。对于更复杂的需求，你也可以选择传入一个对象： From e7e43864b99a73367ee0471755d3566ded1d2d17 Mon Sep 17 00:00:00 2001 From: koishi-bot <105629226+koishi-bot@users.noreply.github.com> Date: Mon, 11 Dec 2023 15:07:16 +0800 Subject: [PATCH 1201/3075] New translations model.md (English, United States) [skip ci] --- en-US/guide/database/model.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/en-US/guide/database/model.md b/en-US/guide/database/model.md index 2553bf380706..f8a67b55b427 100644 --- a/en-US/guide/database/model.md +++ b/en-US/guide/database/model.md @@ -1,4 +1,4 @@ -# 数据模型 +# Data Model Koishi 的架构允许任何插件对数据库的结构进行扩展。你就可以在不修改 Koishi 或其他插件源码的情况下，为数据库添加新的字段或者表。这些功能都是通过 `ctx.model` 提供的。 From 3a34e29b182f5d975f552d341b7d8e372aa08ddd Mon Sep 17 00:00:00 2001 From: koishi-bot <105629226+koishi-bot@users.noreply.github.com> Date: Mon, 11 Dec 2023 15:07:19 +0800 Subject: [PATCH 1202/3075] New translations selection.md (French) [skip ci] --- fr-FR/guide/database/selection.md | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/fr-FR/guide/database/selection.md b/fr-FR/guide/database/selection.md index a284cae325d0..ac33af669efd 100644 --- a/fr-FR/guide/database/selection.md +++ b/fr-FR/guide/database/selection.md @@ -1,8 +1,8 @@ -# 进阶查询技巧 +# Interrogations avancées `database.get()` 已经能实现一些简单的查询了。然而在实际的开发中，我们通常会遇到排序、分组乃至聚合等更复杂的查询需求。此时就轮到更加强大的 `database.select()` 方法登场了。 -## 基本用法 +## Utilisation de base `database.select()` 会创建一个 `Selection` 对象。它提供了一系列的链式方法，你可以将其理解成一个查询语句的构造器。构造完成后，你可以调用 `.execute()` 方法来执行最终的查询。下面是一个简单的例子： From f0c83a3c6564431c0b53c8550de62b725a62bd9d Mon Sep 17 00:00:00 2001 From: koishi-bot <105629226+koishi-bot@users.noreply.github.com> Date: Mon, 11 Dec 2023 15:07:22 +0800 Subject: [PATCH 1203/3075] New translations selection.md (English, United States) [skip ci] --- en-US/guide/database/selection.md | 14 +++++++------- 1 file changed, 7 insertions(+), 7 deletions(-) diff --git a/en-US/guide/database/selection.md b/en-US/guide/database/selection.md index a284cae325d0..fe9478ad6766 100644 --- a/en-US/guide/database/selection.md +++ b/en-US/guide/database/selection.md @@ -1,8 +1,8 @@ -# 进阶查询技巧 +# Advanced Query `database.get()` 已经能实现一些简单的查询了。然而在实际的开发中，我们通常会遇到排序、分组乃至聚合等更复杂的查询需求。此时就轮到更加强大的 `database.select()` 方法登场了。 -## 基本用法 +## Basic Usage `database.select()` 会创建一个 `Selection` 对象。它提供了一系列的链式方法，你可以将其理解成一个查询语句的构造器。构造完成后，你可以调用 `.execute()` 方法来执行最终的查询。下面是一个简单的例子： @@ -46,7 +46,7 @@ ctx.database ## 字段映射 -`.project()` 方法可以用于映射查询结果。它接受一个对象，对象的键表示要映射的字段名，值表示映射的表达式。下面是一个例子： +`.project()` 方法可以用于映射查询结果。它接受一个对象，对象的键表示要映射的字段名，值表示映射的表达式。Below is an example: ```ts // 返回的数组元素将只含有 a, b 属性 @@ -77,7 +77,7 @@ ctx.database ## 分组查询 -`.groupBy()` 和 `.having()` 方法可以用于分组查询。`.groupBy()` 方法接受一个字段名或求值函数，`.having()` 方法接受一个含有聚合运算并返回布尔值的表达式。下面是一个例子： +`.groupBy()` 和 `.having()` 方法可以用于分组查询。`.groupBy()` 方法接受一个字段名或求值函数，`.having()` 方法接受一个含有聚合运算并返回布尔值的表达式。Below is an example: ```ts // 按照 value 字段分组，返回结果数大于 5 的分组 @@ -104,7 +104,7 @@ ctx.database ### 添加字段 -`.groupBy()` 还额外接受一个二参数，用于在查询结果中添加聚合字段。这个参数是一个对象，同样与 `.project()` 中的用法类似。下面是一个例子： +`.groupBy()` 还额外接受一个二参数，用于在查询结果中添加聚合字段。这个参数是一个对象，同样与 `.project()` 中的用法类似。Below is an example: ```ts // 返回的数据包含 value, sum, count 三个属性 @@ -119,7 +119,7 @@ ctx.database ### 多级分组 -可以通过链式调用 `.groupBy()` 方法来实现多级分组。下面是一个例子： +可以通过链式调用 `.groupBy()` 方法来实现多级分组。Below is an example: ```ts ctx.database @@ -138,7 +138,7 @@ ctx.database ## 连接查询 实验性 -最后介绍一下连接查询的用法。使用 `.join()` 可以将多个表连接起来，返回一个新的 `Selection`，其属性分别对应多个表的名称。下面是一个例子： +最后介绍一下连接查询的用法。使用 `.join()` 可以将多个表连接起来，返回一个新的 `Selection`，其属性分别对应多个表的名称。Below is an example: ```ts // 返回的数据包含 foo, bar 两个属性 From 70bce2374869b02c80b37c3c6c6198f9b5a6b856 Mon Sep 17 00:00:00 2001 From: koishi-bot <105629226+koishi-bot@users.noreply.github.com> Date: Mon, 11 Dec 2023 15:07:23 +0800 Subject: [PATCH 1204/3075] New translations writing.md (French) [skip ci] --- fr-FR/guide/database/writing.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/fr-FR/guide/database/writing.md b/fr-FR/guide/database/writing.md index 60e7603655a0..ae4bcae8ff57 100644 --- a/fr-FR/guide/database/writing.md +++ b/fr-FR/guide/database/writing.md @@ -1,4 +1,4 @@ -# 编写数据库插件 +# Écrit du plugin de base des données :::danger 注意 此页文档正在施工，其中的内容可能不是最新。 From c062be3aa623413cc78b10b4ffabd71755c4b2ab Mon Sep 17 00:00:00 2001 From: koishi-bot <105629226+koishi-bot@users.noreply.github.com> Date: Mon, 11 Dec 2023 15:07:24 +0800 Subject: [PATCH 1205/3075] New translations writing.md (Japanese) [skip ci] --- ja-JP/guide/database/writing.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/ja-JP/guide/database/writing.md b/ja-JP/guide/database/writing.md index 60e7603655a0..43384d48fdeb 100644 --- a/ja-JP/guide/database/writing.md +++ b/ja-JP/guide/database/writing.md @@ -1,4 +1,4 @@ -# 编写数据库插件 +# データベースプラグインの作成 :::danger 注意 此页文档正在施工，其中的内容可能不是最新。 From 35a482bd3caf3be379015a9d3d09c35a99cdf727 Mon Sep 17 00:00:00 2001 From: koishi-bot <105629226+koishi-bot@users.noreply.github.com> Date: Mon, 11 Dec 2023 15:07:26 +0800 Subject: [PATCH 1206/3075] New translations writing.md (Chinese Traditional) [skip ci] --- zh-TW/guide/database/writing.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/zh-TW/guide/database/writing.md b/zh-TW/guide/database/writing.md index 60e7603655a0..ed1daaf0f2a5 100644 --- a/zh-TW/guide/database/writing.md +++ b/zh-TW/guide/database/writing.md @@ -1,4 +1,4 @@ -# 编写数据库插件 +# 編寫資料庫外掛 :::danger 注意 此页文档正在施工，其中的内容可能不是最新。 From 4bd02b9e60680ba0c7383443588f1fc8ddcea414 Mon Sep 17 00:00:00 2001 From: koishi-bot <105629226+koishi-bot@users.noreply.github.com> Date: Mon, 11 Dec 2023 15:07:27 +0800 Subject: [PATCH 1207/3075] New translations writing.md (English, United States) [skip ci] --- en-US/guide/database/writing.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/en-US/guide/database/writing.md b/en-US/guide/database/writing.md index 60e7603655a0..ab5e8bdcba1c 100644 --- a/en-US/guide/database/writing.md +++ b/en-US/guide/database/writing.md @@ -1,4 +1,4 @@ -# 编写数据库插件 +# Database Plugin :::danger 注意 此页文档正在施工，其中的内容可能不是最新。 From f6aaa5d9117acdb498d796134e5e6a1c24babd94 Mon Sep 17 00:00:00 2001 From: koishi-bot <105629226+koishi-bot@users.noreply.github.com> Date: Mon, 11 Dec 2023 15:07:28 +0800 Subject: [PATCH 1208/3075] New translations config.md (French) [skip ci] --- fr-FR/guide/develop/config.md | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/fr-FR/guide/develop/config.md b/fr-FR/guide/develop/config.md index 9e65eeaf0c0e..3473ef3103db 100644 --- a/fr-FR/guide/develop/config.md +++ b/fr-FR/guide/develop/config.md @@ -1,4 +1,4 @@ -# 配置文件 +# Fichier de configuration :::warning 配置文件的结构未来可能会发生变化，请留意后续更新。 @@ -65,7 +65,7 @@ plugins: enable: true ``` -### 插件名称 +### Le nom du plugin 插件名称通常对应于插件发布时的包名。例如： From 5f75ba8a4667157c7ba794d3589e8e3135b8b081 Mon Sep 17 00:00:00 2001 From: koishi-bot <105629226+koishi-bot@users.noreply.github.com> Date: Mon, 11 Dec 2023 15:07:30 +0800 Subject: [PATCH 1209/3075] New translations config.md (Japanese) [skip ci] --- ja-JP/guide/develop/config.md | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/ja-JP/guide/develop/config.md b/ja-JP/guide/develop/config.md index 9e65eeaf0c0e..b813b65f7a00 100644 --- a/ja-JP/guide/develop/config.md +++ b/ja-JP/guide/develop/config.md @@ -1,4 +1,4 @@ -# 配置文件 +# 設定ファイル :::warning 配置文件的结构未来可能会发生变化，请留意后续更新。 @@ -88,7 +88,7 @@ plugins: market: ``` -### 元信息 +### メタ情報 一些以 `$` 开头的属性会记录插件和插件组的元信息。例如： From 192e88eb47638cc5a840b8355283921ab433ed98 Mon Sep 17 00:00:00 2001 From: koishi-bot <105629226+koishi-bot@users.noreply.github.com> Date: Mon, 11 Dec 2023 15:07:31 +0800 Subject: [PATCH 1210/3075] New translations config.md (Chinese Traditional) [skip ci] --- zh-TW/guide/develop/config.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/zh-TW/guide/develop/config.md b/zh-TW/guide/develop/config.md index 9e65eeaf0c0e..9be3de899adf 100644 --- a/zh-TW/guide/develop/config.md +++ b/zh-TW/guide/develop/config.md @@ -1,4 +1,4 @@ -# 配置文件 +# 配置檔案 :::warning 配置文件的结构未来可能会发生变化，请留意后续更新。 From a5f0d82c5bc9e4aad62916e4bbb430e0b357504d Mon Sep 17 00:00:00 2001 From: koishi-bot <105629226+koishi-bot@users.noreply.github.com> Date: Mon, 11 Dec 2023 15:07:32 +0800 Subject: [PATCH 1211/3075] New translations config.md (English, United States) [skip ci] --- en-US/guide/develop/config.md | 8 ++++---- 1 file changed, 4 insertions(+), 4 deletions(-) diff --git a/en-US/guide/develop/config.md b/en-US/guide/develop/config.md index 7a9bffad100f..036293b40a40 100644 --- a/en-US/guide/develop/config.md +++ b/en-US/guide/develop/config.md @@ -1,4 +1,4 @@ -# 配置文件 +# Configuration File :::warning 配置文件的结构未来可能会发生变化，请留意后续更新。 @@ -65,9 +65,9 @@ plugins: enable: true ``` -### 插件名称 +### Plugin name -插件名称通常对应于插件发布时的包名。例如： +插件名称通常对应于插件发布时的包名。例如：例如： - `market` 对应于官方插件 `@koishijs/plugin-market` - `dialogue` 对应于社区插件 `koishi-plugin-dialogue` @@ -88,7 +88,7 @@ plugins: market: ``` -### 元信息 +### Meta Information 一些以 `$` 开头的属性会记录插件和插件组的元信息。例如： From 833e744e82527b7c7f6479ce44c8e0d814dbc3ef Mon Sep 17 00:00:00 2001 From: koishi-bot <105629226+koishi-bot@users.noreply.github.com> Date: Mon, 11 Dec 2023 15:07:33 +0800 Subject: [PATCH 1212/3075] New translations publish.md (French) [skip ci] --- fr-FR/guide/develop/publish.md | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/fr-FR/guide/develop/publish.md b/fr-FR/guide/develop/publish.md index 31ac503736ef..01c6b7a50a51 100644 --- a/fr-FR/guide/develop/publish.md +++ b/fr-FR/guide/develop/publish.md @@ -1,4 +1,4 @@ -# 发布插件 +# Publication du plugin 为了让别人更方便地使用你编写的插件，你需要将其作为一个 npm 包进行发布。只需满足一定的规范，你的插件就能显示在 [插件市场](../../market/) 中，其他人可以通过控制台来安装它。 @@ -148,7 +148,7 @@ root 此外，还有一些字段与 [Koishi Online](../../cookbook/practice/online.md) 的部署流程相关 (如 `browser`, `exports` 等)。由于不影响主线开发，你可以稍后再进行了解。 ::: -## 发布插件 +## Publication du plugin 编辑完上面的清单文件并 [构建源代码](./workspace.md#构建源代码) 后，你就可以公开发布你的插件了。 From 4316590d035022908ed943acbdfb2bdfc2d884c3 Mon Sep 17 00:00:00 2001 From: koishi-bot <105629226+koishi-bot@users.noreply.github.com> Date: Mon, 11 Dec 2023 15:07:35 +0800 Subject: [PATCH 1213/3075] New translations publish.md (Japanese) [skip ci] --- ja-JP/guide/develop/publish.md | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/ja-JP/guide/develop/publish.md b/ja-JP/guide/develop/publish.md index 31ac503736ef..0dbc76edf4fc 100644 --- a/ja-JP/guide/develop/publish.md +++ b/ja-JP/guide/develop/publish.md @@ -1,4 +1,4 @@ -# 发布插件 +# プラグインを公開する 为了让别人更方便地使用你编写的插件，你需要将其作为一个 npm 包进行发布。只需满足一定的规范，你的插件就能显示在 [插件市场](../../market/) 中，其他人可以通过控制台来安装它。 @@ -148,7 +148,7 @@ root 此外，还有一些字段与 [Koishi Online](../../cookbook/practice/online.md) 的部署流程相关 (如 `browser`, `exports` 等)。由于不影响主线开发，你可以稍后再进行了解。 ::: -## 发布插件 +## プラグインを公開する 编辑完上面的清单文件并 [构建源代码](./workspace.md#构建源代码) 后，你就可以公开发布你的插件了。 From fa157337454cc2729dcdac571ecbf0d46b1e02fe Mon Sep 17 00:00:00 2001 From: koishi-bot <105629226+koishi-bot@users.noreply.github.com> Date: Mon, 11 Dec 2023 15:07:36 +0800 Subject: [PATCH 1214/3075] New translations publish.md (Chinese Traditional) [skip ci] --- zh-TW/guide/develop/publish.md | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/zh-TW/guide/develop/publish.md b/zh-TW/guide/develop/publish.md index 31ac503736ef..14945c4a2bc0 100644 --- a/zh-TW/guide/develop/publish.md +++ b/zh-TW/guide/develop/publish.md @@ -1,4 +1,4 @@ -# 发布插件 +# 釋出外掛 为了让别人更方便地使用你编写的插件，你需要将其作为一个 npm 包进行发布。只需满足一定的规范，你的插件就能显示在 [插件市场](../../market/) 中，其他人可以通过控制台来安装它。 @@ -148,7 +148,7 @@ root 此外，还有一些字段与 [Koishi Online](../../cookbook/practice/online.md) 的部署流程相关 (如 `browser`, `exports` 等)。由于不影响主线开发，你可以稍后再进行了解。 ::: -## 发布插件 +## 釋出外掛 编辑完上面的清单文件并 [构建源代码](./workspace.md#构建源代码) 后，你就可以公开发布你的插件了。 From 234008c6fba9b58055b60397502658c0247cd5bd Mon Sep 17 00:00:00 2001 From: koishi-bot <105629226+koishi-bot@users.noreply.github.com> Date: Mon, 11 Dec 2023 15:07:38 +0800 Subject: [PATCH 1215/3075] New translations publish.md (English, United States) [skip ci] --- en-US/guide/develop/publish.md | 116 ++++++++++++++++----------------- 1 file changed, 58 insertions(+), 58 deletions(-) diff --git a/en-US/guide/develop/publish.md b/en-US/guide/develop/publish.md index 466bd9a08537..de1085694a3b 100644 --- a/en-US/guide/develop/publish.md +++ b/en-US/guide/develop/publish.md @@ -1,6 +1,7 @@ -# 发布插件 +# Publish your plugin -为了让别人更方便地使用你编写的插件，你需要将其作为一个 npm 包进行发布。只需满足一定的规范，你的插件就能显示在 [插件市场](../../market/) 中，其他人可以通过控制台来安装它。 +Your plugin should be published onto npm before being available to Koishi users. +只需满足一定的规范，你的插件就能显示在 [插件市场](../../market/) 中，其他人可以通过控制台来安装它。 :::tip 本节中介绍的命令行都需要在 [应用目录](./config.md#应用目录) 下运行。 @@ -8,7 +9,7 @@ ## Prerequisite -首先让我们关注插件目录中的 `package.json` 文件。这个文件非常重要，它包含了要发布插件的一切元信息。 +首先让我们关注插件目录中的 `package.json` 文件。This file is crucial as it has all the meta information for publishing your plugin. ```diff{6} root @@ -16,16 +17,16 @@ root │ └── example │ ├── src │ │ └── index.ts -│ └── package.json # 你应该修改这里 +│ └── package.json # the file we concern about ├── koishi.yml -└── package.json # 而不是这里 +└── package.json # not this ``` :::tip -请注意 `package.json` 文件不是唯一的，它在应用目录和每个插件目录都会存在。请确保你修改了正确的文件。 +There is a `package.json` file in your workspace root and in each plugin folder,please make sure the file opened is the one in the corresponding plugin folder. ::: -打开上述文件，你会看到它大概长这样： +2. The following structure is an example of the above file: ```json title=package.json { @@ -38,33 +39,33 @@ root 其中最重要的属性有两个：`name` 是要发布的包名，`version` 是当前版本号。可以看到，这里的包名相比实际在插件市场中看到的插件名多了一个 `koishi-plugin-` 的前缀，这使得我们很容易区分 Koishi 插件与其他 npm 包，同时也方便了用户安装和配置插件。 :::tip -请注意：包名和版本号都是唯一的：包名不能与其他已经发布的包相同，而同一个包的同一个版本号也只能发布一次。如果出现了包名冲突或版本号冲突，则会在之后的发布流程中出现错误提示。你可以自行根据错误提示更改包名或更新插件版本。 +请注意：包名和版本号都是唯一的：包名不能与其他已经发布的包相同，而同一个包的同一个版本号也只能发布一次。 你可以自行根据错误提示更改包名或更新插件版本。 ::: -## 补充更多信息 +## More information -除了包名和版本号以外，`package.json` 还包括了插件的依赖、描述、贡献者、许可证、关键词等更多信息。你并不需要一上来就把所有信息都填写完整，因为你可以随后再进行修改。但请别忘了，这些内容也是插件的一部分，修改完成后别忘了 [更新版本](#更新插件版本) 并 [再次发布](#发布插件)。 +The `package.json` of a plugin contains more than just name and version. It comprises dependencies, description, contributors, license, keywords and other details relevant to the plugin.Each time one of these elements is changed,you need to [update the version](#updating-version) and [reissue the plugin](#publishing-plugins-1) -### 准入条件 +### Requirements :::tip -使用模板项目创建的插件一定是符合要求的，因此你可以跳过这一节。 +You may skip this section, if your plugin created using the boilerplate. ::: -要想显示在插件市场中，插件的 `package.json` 需要满足以下基本要求： +The `package.json` in your plugin should meet the requirements below to appear in the marketplace: -- [`name`](https://docs.npmjs.com/cli/v8/configuring-npm/package-json#name) 必须符合以下格式之一： +- [`name`](https://docs.npmjs.com/cli/v8/configuring-npm/package-json#name) should match one of these formats: - `koishi-plugin-*` - `@bar/koishi-plugin-*` - `@koishijs/plugin-*` (官方插件) - 其中 `*` 是由数字、小写字母和连字符 `-` 组成的字符串 -- [`name`](https://docs.npmjs.com/cli/v10/configuring-npm/package-json#name) 不能与已发布的插件重复或相似 -- [`version`](https://docs.npmjs.com/cli/v10/configuring-npm/package-json#version) 应当符合 [语义化版本](https://semver.org/lang/zh-CN/) (通常从 `1.0.0` 开始) -- [`peerDependencies`](https://docs.npmjs.com/cli/v10/configuring-npm/package-json#peerdependencies) 必须包含 `koishi` -- 不能声明 [`private`](https://docs.npmjs.com/cli/v10/configuring-npm/package-json#private) 为 `true` (否则你的插件无法发布) -- 最新版本不能被 [弃用](https://docs.npmjs.com/deprecating-and-undeprecating-packages-or-package-versions) (一种常见的情况是：你已经发布了某个插件，又希望更换一个名字重新发布，此时你可以通过弃用的方式让旧的名字不显示在插件市场中) +- [`name`](https://docs.npmjs.com/cli/v10/configuring-npm/package-json#name) is unique +- [`version`](https://docs.npmjs.com/cli/v10/configuring-npm/package-json#version) should match [semantic version](https://semver.org/) (usually from `1.0.0`) +- [`peerDependencies`](https://docs.npmjs.com/cli/v10/configuring-npm/package-json#peerdependencies) must contain `koishi` +- Could not declare [`private`](https://docs.npmjs.com/cli/v10/configuring-npm/package-json#private) to `true` (otherwise your plugin cannot be published) +- Avoid [deprecating](https://docs.npmjs.com/deprecating-and-undeprecating-packages-or-package-versions) of the latest version unless there is a valid reason to do so. For example, if you intend to re-release the plugin under a different name, it can be used to hide the old plugin on the marketplace. -一个符合上述标准的示例： +Example: ```json title=package.json { @@ -76,36 +77,36 @@ root } ``` -### 添加相关信息 +### The `package.json` file -除去上面的基本要求外，`package.json` 中还有一些字段能帮助显示插件的相关信息。 +To make more information available to Koishi users, you could add more comprehensive fields in the `package.json` of your plugin. ```json title=package.json { "name": "koishi-plugin-example", "version": "1.0.0", - "contributors": [ // 贡献者 + "contributors": [ "Alice ", "Bob " ], - "license": "MIT", // 许可证 - "homepage": "https://example.com", // 主页 - "repository": { // 源码仓库 + "license": "MIT", + "homepage": "https://example.com", + "repository": { "type": "git", "url": "git+https://github.com/alice/koishi-plugin-example.git" }, - "keywords": ["example"], // 关键词 + "keywords": ["example"], "peerDependencies": { - "koishi": "^4.3.2" + "koishi": "^4.15.6" } } ``` -- **contributors:** 插件维护者，应该是一个数组，其中的元素通常使用 `名字 <邮箱>` 的格式 -- **license:** 插件许可证，你可以在 [这里](https://choosealicense.com/licenses/) 了解各种许可证的详细信息 -- **homepage:** 插件主页，可以是一个网址 (比如你的 GitHub 项目地址) -- **repository:** 插件源码仓库，应该是一个对象，其中 `type` 字段指定仓库类型，`url` 字段指定仓库地址 -- **keywords:** 插件关键词，应该是一个字符串数组，会用于插件市场中的搜索功能 +- **contributors:** plugin maintainers, should be an array. The elements usually follow the format `Name `. +- **license:** plugin license, you can learn details about various licenses in [here](https://choosealicense.com/licenses/) +- **homepage:** homepage for your plugin, which can be a URL (e.g. your GitHub project address). +- **repository:** source code repository of the plugin, which should be an object. The `type` field specifies the type of repository, and the `url` field specifies the repository address. +- **keywords:** keywords for the plugin, which should be an array of strings. They are used for the search function in the plug-in market. :::tip `package.json` 中还有一些字段没有在这里提及，如果你对此感兴趣，可以前往 [npmjs.com](https://docs.npmjs.com/files/package.json/) 查看文档。 @@ -113,7 +114,7 @@ root ### `koishi` 字段 -除此以外，我们还提供了一个额外的 `koishi` 字段，用于指定与 Koishi 相关的信息。 +We can also use the `koishi` field to specify Koishi related information ```json title=package.json { @@ -123,34 +124,34 @@ root "koishi": "^4.3.2" }, "koishi": { - "description": { // 不同语言的插件描述 + "description": { // descriptions in different languages "en": "English Description", "zh": "中文描述" }, "service": { - "required": ["database"], // 必需的服务 - "optional": ["assets"], // 可选的服务 - "implements": ["dialogue"], // 实现的服务 + "required": ["database"], // dependent services of required + "optional": ["assets"], // dependent services of optional + "implements": ["dialogue"], // services provided by the itself }, - "locales": ["en", "zh"], // 支持的语言 + "locales": ["en", "zh"], // supported languages } } ``` -- **description:** 插件描述，应该是一个对象，其中的键代表语言名，值是对应语言下的描述 -- **service:** 插件的服务相关信息，具体包含下列属性： - - **implements:** 实现的服务，应该是一个服务名构成的数组 -- **locales:** 插件支持的语言，应该是一个语言名构成的数组 -- **preview:** 配置为 `true` 可以让插件显示为「开发中」状态 -- **hidden:** 配置为 `true` 可以让插件市场中不显示该插件 (通常情况下你不需要这么做) +- **description:** This refers to the description of the plugin, which should be an object. The keys represent the language names, and the values are the descriptions in the corresponding languages. +- **service:** This pertains to the service-related information of the plugin, which includes the following attributes: + - **implements:** services that your plugin implements, represented as an array of service names. +- **locales:** This refers to the languages supported by the plugin, represented as an array of language names. +- **preview:** Configure `true` to allow plugin to be displayed as "developing" status +- **hidden:** If set to true, this prevents the plugin from being displayed in the marketplace (you usually don’t need to do this). :::tip -此外，还有一些字段与 [Koishi Online](../../cookbook/practice/online.md) 的部署流程相关 (如 `browser`, `exports` 等)。由于不影响主线开发，你可以稍后再进行了解。 +Furthermore, there are certain aspects related to the deployment process of [Koishi Online](../../cookbook/practice/online.md), including browsers, exports, and more.Since they do not affect the mainline development, you can learn about them later. ::: -## 发布插件 +## Publish your plugin -编辑完上面的清单文件并 [构建源代码](./workspace.md#构建源代码) 后，你就可以公开发布你的插件了。 +Congratulations! It's time to publish your plugin, after editing the file above and [build source](./workspace.md##build-source-code). :::tabs code @@ -164,22 +165,21 @@ yarn pub [...name] ::: -- **name:** 要发布的插件列表，缺省时表示全部 (此处 `name` 不包含 `koishi-plugin-` 前缀，而是你的工作区目录名) +- **name:** list of plugins to be published, all by default (`name` is your directory name) -这将发布所有版本号发生变动的插件。 +This will be released of all plugins that have changed version numbers. :::tip -从插件成功发布到进插件市场需要一定的时间 (通常在 15 分钟内)，请耐心等待。 +It takes some time for the plugin to be successfully published to the plugin marketplace (usually within 15 minutes). Please be patient. ::: -:::: tip -如果你配置了国内镜像，你可能会遇到以下的错误提示： +If you are in China and have configured a mirror, you may encounter the following error hint: ```text No token found and can't prompt for login when running with --non-interactive. ``` -此时你需要在发布时使用官方镜像，具体操作如下： +You need to use official mirrors when publishing at this time, following: :::tabs code @@ -207,9 +207,9 @@ yarn config set npmPublishRegistry https://registry.yarnpkg.com ::: :::: -## 更新插件版本 +## Updating version -初始创建的插件版本号为 `1.0.0`。当你修改过插件后，你需要更新版本号才能重新发布。在应用目录运行下面的命令以更新版本号： +初始创建的插件版本号为 `1.0.0`。Its number needs to be updated before releasing changes. Run the command in the workspace root to update that: :::tabs code @@ -234,6 +234,6 @@ yarn bump [...name] [-1|-2|-3|-p|-v ] [-r] - 其他情况下，跳到下一个大版本的 `alpha.0` - **-v, --version:** 设置具体的版本号 - **-r, --recursive:** 递归更新依赖版本 -- 缺省情况：按照当前版本的最后一位递增 +- Default: incremented by the last of the release version number -当进行此操作时，其他相关插件的依赖版本也会同步更新，确保所有工作区内依赖的插件版本一致。进一步，如果你希望更新了依赖版本的插件也同时更新自身的版本，那么可以附加 `-r, --recursive` 选项。 +When updating the version of a plug-in, the versions of dependencies that rely on this plug-in will also be upgraded to ensure consistency in the workspace.进一步，如果你希望更新了依赖版本的插件也同时更新自身的版本，那么可以附加 `-r, --recursive` 选项。 From d26a516374c8df8e4d2c3fe300f33c566392b1ef Mon Sep 17 00:00:00 2001 From: koishi-bot <105629226+koishi-bot@users.noreply.github.com> Date: Mon, 11 Dec 2023 15:07:39 +0800 Subject: [PATCH 1216/3075] New translations script.md (French) [skip ci] --- fr-FR/guide/develop/script.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/fr-FR/guide/develop/script.md b/fr-FR/guide/develop/script.md index 972a8539c338..5c0fa8972e4d 100644 --- a/fr-FR/guide/develop/script.md +++ b/fr-FR/guide/develop/script.md @@ -6,7 +6,7 @@ Koishi 提供了一套命令行工具，用于读取配置文件快速启动应 本节中介绍的命令行都需要在 [应用目录](./config.md#应用目录) 下运行。 ::: -## 基本用法 +## Utilisation de base 我们通常使用 **启动脚本** 来启动 Koishi 应用。打开应用目录下的 `package.json` 文件： From d723d98c1667f813e6fea7aa8f12f0e78228f25b Mon Sep 17 00:00:00 2001 From: koishi-bot <105629226+koishi-bot@users.noreply.github.com> Date: Mon, 11 Dec 2023 15:07:42 +0800 Subject: [PATCH 1217/3075] New translations script.md (English, United States) [skip ci] --- en-US/guide/develop/script.md | 36 +++++++++++++++++------------------ 1 file changed, 18 insertions(+), 18 deletions(-) diff --git a/en-US/guide/develop/script.md b/en-US/guide/develop/script.md index eb417cf2663c..fc6efa301c75 100644 --- a/en-US/guide/develop/script.md +++ b/en-US/guide/develop/script.md @@ -1,12 +1,12 @@ # launch script -Koishi 提供了一套命令行工具，用于读取配置文件快速启动应用。 +There is also a set of command line tools that provided by Koishi to boot the application quickly by reading the configuration file. :::tip 本节中介绍的命令行都需要在 [应用目录](./config.md#应用目录) 下运行。 ::: -## 基本用法 +## Basic Usage 我们通常使用 **启动脚本** 来启动 Koishi 应用。打开应用目录下的 `package.json` 文件： @@ -19,7 +19,7 @@ Koishi 提供了一套命令行工具，用于读取配置文件快速启动应 } ``` -在应用目录运行下面的命令行以启动 Koishi 应用： +Run the following command line in the workspace root to start the Koishi application: :::tabs code @@ -33,21 +33,21 @@ yarn start ::: -在本节的后续部分，我们会介绍上述启动脚本的更多参数。无论你做何改动，你都可以使用上面的命令行来快速启动。这也是启动脚本的意义所在。 +In the subsequent parts of this section, we will introduce more options of the above launch script. No matter what changes you make, you can use the above command line to start. This is also the significance of the boostrap script. -### 启动参数 +### Command Line Options 启动脚本支持 Node.js 的 [命令行参数](https://nodejs.org/api/cli.html)。例如，上面的 `-r` 对应于 `--require`，它将允许你加载 `.ts` 和 `.yml` 后缀的文件。 -除了 Node.js 的命令行参数，Koishi 还提供了一些额外的参数。我们将在下面逐一介绍。 +In addition to Node.js's command line options, Koishi also provides some additional options. We will introduce each of them below. -### 自动重启 +### Auto Restart -Koishi 的命令行工具支持自动重启。当运行 Koishi 的进程崩溃时，如果 Koishi 已经启动成功，则监视进程将自动重新启动一个新的进程。 +Koishi's command line tool supports auto-restart. When the process running Koishi crashes, if Koishi has already started successfully, the surveillance process will automatically restart a new process. -## 开发模式 +## Development Mode -除了 `start` 以外，模板项目还准备了名为 `dev` 的开发模式启动脚本。在应用目录运行下面的命令行可以以开发模式启动应用： +除了 `start` 以外，模板项目还准备了名为 `dev` 的开发模式启动脚本。Running the following command line in the workspace root can start the application in development mode: :::tabs code @@ -61,13 +61,13 @@ yarn dev ::: -如你所见，`dev` 相当于在 `start` 指令的基础上添加了额外的参数和环境变量。这些参数为我们启用了额外的特性，而环境变量则能影响插件的部分行为。 +如你所见，`dev` 相当于在 `start` 指令的基础上添加了额外的参数和环境变量。These options enable us to use additional features, while the environment variables can affect some behaviors of the plugins. -### TypeScript 支持 +### TypeScript Support -Koishi 模板项目原生地支持 TypeScript 开发。上述 `-r esbuild-register` 参数允许我们在运行时直接使用工作区插件的 TypeScript 源代码。 +The Koishi template project provides built-in support for TypeScript development. 上述 `-r esbuild-register` 参数允许我们在运行时直接使用工作区插件的 TypeScript 源代码。 -你也可以自行扩展更多的后缀名支持。例如，如果你更喜欢 CoffeeScript，你可以这样修改你的开发脚本为： +You can also add support for more extensions on your own. For example, if you prefer CoffeeScript, you can modify your development script like this: ```json title=package.json { @@ -88,9 +88,9 @@ Koishi 模板项目原生地支持 TypeScript 开发。上述 `-r esbuild-regist ### Hot Module Replacement -如果你开发着一个巨大的 Koishi 项目，可能光是加载一遍全部插件就需要好几秒了。在这种时候，像前端框架一样支持模块热替换就成了一个很棒的主意。幸运的是，Koishi 也做到了这一点！内置插件 @koishijs/plugin-hmr 实现了插件级别的热替换。每当你修改你的本地文件时，Koishi 就会尝试重载你的插件，并在命令行中提醒你。 +If you are developing a large Koishi project, it might take several seconds just to load all plugins. At times like this, supporting hot module replacement like front-end frameworks becomes a great idea. Fortunately, Koishi also supports this! The built-in plugin @koishijs/plugin-hmr implements plugin-level hot replacement. Whenever you modify your local files, Koishi will try to reload your plugin and remind you in the terminal. -这里的行为也可以在配置文件中进行定制： +The behavior here can also be customized in the configuration file: ```yaml title=koishi.yml plugins: @@ -98,7 +98,7 @@ plugins: $if: env.NODE_ENV === 'development' hmr: root: '.' - # 要忽略的文件列表，支持 glob patterns + # List of files to ignore, supports glob patterns ignore: - some-file ``` @@ -110,7 +110,7 @@ plugins: NOSPC: System limit for number of file watchers reached ``` -此时你可以使用下面的命令来增加监听数量限制： +In this case, you can use the following command to increase the limit of the number of file watchers: ```sh echo fs.inotify.max_user_watches=524288 | From b9bea46318a8f4978595cbc81214a22f85ee8a99 Mon Sep 17 00:00:00 2001 From: koishi-bot <105629226+koishi-bot@users.noreply.github.com> Date: Mon, 11 Dec 2023 15:07:43 +0800 Subject: [PATCH 1218/3075] New translations setup.md (French) [skip ci] --- fr-FR/guide/develop/setup.md | 10 +++++----- 1 file changed, 5 insertions(+), 5 deletions(-) diff --git a/fr-FR/guide/develop/setup.md b/fr-FR/guide/develop/setup.md index 890a8c6c09ed..d7b21ab68b03 100644 --- a/fr-FR/guide/develop/setup.md +++ b/fr-FR/guide/develop/setup.md @@ -1,4 +1,4 @@ -# 环境搭建 +# Configuration de l'environnement 本节将介绍推荐的开发环境搭建流程。如果某些软件已经安装完成，可以跳过对应的步骤。 @@ -47,7 +47,7 @@ git config –-global user.email "you@example.com" ## 安装 Koishi -打开命令行，并进入你想要创建 Koishi 项目的目录。 +Ouvrez une ligne de commande et accédez au répertoire dans lequel vous souhaitez créer le projet modèle de Koishi. ::: tip 这个目录不宜过长，且路径中请避免出现中文或者空格。我们推荐的目录如下： @@ -56,7 +56,7 @@ git config –-global user.email "you@example.com" - 其他操作系统：`~/dev` ::: -输入下面的命令以创建 Koishi 项目： +Saisissez la commande suivante pour créer le projet modèle de Koishi : :::tabs code @@ -70,9 +70,9 @@ yarn create koishi ::: -跟随提示即可完成全套初始化流程。 +Suivez les instructions pour terminer le processus d'initialisation. -如果你顺利完成了上述操作，你的应用此时应该已经是启动状态，并弹出了控制台界面。接下来的几节中我们将学习更多的命令行用法，因此我们可以先关闭 Koishi。在命令行中按下 `Ctrl+C` 组合键即可停止 Koishi 的运行。 +Si vous avez suivi avec succès les étapes ci-dessus, votre application devrait déjà être en cours d'exécution et la console Koishi devrait s'afficher. 接下来的几节中我们将学习更多的命令行用法，因此我们可以先关闭 Koishi。在命令行中按下 `Ctrl+C` 组合键即可停止 Koishi 的运行。 -### 链接 (a) +### 链接 (a) {#a} - **href:** `string` 链接的 URL @@ -55,9 +55,10 @@ ## 资源元素 -资源消息元素表示文本中存在的资源文件。不同的平台对资源文件的支持存在较大的差异。发送时只需提供 `url`。如果某个平台不支持特定的资源类型，适配器应该用 `url` 代替。如果某个平台不支持将资源消息元素和其他消息元素同时发送，适配器应该分多条发送，并返回最后一条消息的 ID。 +资源消息元素表示文本中存在的资源文件。不同的平台对资源文件的支持存在较大的差异。发送时只需提供 `src`。如果某个平台不支持特定的资源类型，适配器应该用 `src` 代替。如果某个平台不支持将资源消息元素和其他消息元素同时发送，适配器应该分多条发送，并返回最后一条消息的 ID。 -- **url:** `string` 资源的 URL +- **src:** `string` 资源的 URL +- **title:** `string` 资源文件名称 - **cache:** `boolean` 是否使用已缓存的文件 - **timeout:** `string` 下载文件的最长时间 @@ -70,30 +71,40 @@ 关于它们的最佳实践，可以参考 [嵌入图片和其他资源](../../guide/basic/element.md#嵌入图片和其他资源)。 ::: -### 图片 (image) +### 图片 (img) {#img} 除了上述通用属性外，还支持下面的属性： -- **width:** `number` 图片的宽度 -- **height:** `number` 图片的高度 +- **width:** `number` 图片宽度 (像素) +- **height:** `number` 图片高度 (像素) -`` 元素用于表示图片。 +`` 元素用于表示图片。 -### 语音 (audio) +### 音频 (audio) {#audio} -参见上述通用属性。 +除了上述通用属性外，还支持下面的属性： + +- **duration:** `number` 音频长度 (秒) +- **poster:** `string` 音频封面 URL `