mirror of
https://github.com/LiteyukiStudio/nonebot-plugin-marshoai.git
synced 2025-07-31 18:29:55 +00:00
移动使用文档位置，添加小棉插件开关配置项
This commit is contained in:
155
README_EN.md
Executable file → Normal file
155
README_EN.md
Executable file → Normal file
@ -46,155 +46,14 @@ Plugin internally installed the catgirl character of Marsho, is able to have a c
|
||||
- 🍫 Eating snacks! Meat is yummy!
|
||||
- 🐾 Play! I like play with friends!
|
||||
|
||||
## 💿 Install
|
||||
|
||||
<details open>
|
||||
<summary>Install with nb-cli</summary>
|
||||
|
||||
Open shell under the root directory of nonebot2, input the command below.
|
||||
|
||||
nb plugin install nonebot-plugin-marshoai
|
||||
|
||||
</details>
|
||||
|
||||
<details>
|
||||
<summary>Install with pack manager</summary>
|
||||
|
||||
Open shell under the plugin directory of nonebot2, input corresponding command according to your pack manager.
|
||||
|
||||
<details>
|
||||
<summary>pip</summary>
|
||||
|
||||
pip install nonebot-plugin-marshoai
|
||||
|
||||
</details>
|
||||
<details>
|
||||
<summary>pdm</summary>
|
||||
|
||||
pdm add nonebot-plugin-marshoai
|
||||
|
||||
</details>
|
||||
<details>
|
||||
<summary>poetry</summary>
|
||||
|
||||
poetry add nonebot-plugin-marshoai
|
||||
|
||||
</details>
|
||||
<details>
|
||||
<summary>conda</summary>
|
||||
|
||||
conda install nonebot-plugin-marshoai
|
||||
|
||||
</details>
|
||||
|
||||
Open the `pyproject.toml` file under nonebot2's root directory, Add to`[tool.nonebot]`.
|
||||
|
||||
plugins = ["nonebot_plugin_marshoai"]
|
||||
|
||||
</details>
|
||||
|
||||
## 🤖 Get token(GitHub Models)
|
||||
|
||||
- Create new [personal access token](https://github.com/settings/tokens/new)，**Don't need any permissions**.
|
||||
- Copy the new token, add to the `.env` file's `marshoai_token` option.
|
||||
|
||||
## 🎉 Usage
|
||||
|
||||
End `marsho` in order to get direction for use(If you configured the custom command, please use the configured one).
|
||||
|
||||
#### 👉 Double click avatar
|
||||
|
||||
When nonebot linked to OneBot v11 adapter, can recieve double click and response to it. More detail in the `MARSHOAI_POKE_SUFFIX` option.
|
||||
|
||||
## 🛠️ MarshoTools
|
||||
|
||||
MarshoTools is a feature added in `v0.5.0`, support loading external function library to provide Function Call for Marsho. [Documentation](./README_TOOLS_EN.md)
|
||||
|
||||
## 👍 Praise list
|
||||
|
||||
Praise list stored in the `praises.json` in plugin directory（This directory will putput to log when Bot start), it'll automatically generate when option is `true`, include character name and advantage two basic data.
|
||||
|
||||
The character stored in it would be “know” and “like” by Marsho.
|
||||
|
||||
It's structure is similar to:
|
||||
|
||||
```json
|
||||
{
|
||||
"like": [
|
||||
{
|
||||
"name": "Asankilp",
|
||||
"advantages": "赋予了Marsho猫娘人格，使用vim与vscode为Marsho写了许多代码，使Marsho更加可爱"
|
||||
},
|
||||
{
|
||||
"name": "神羽(snowykami)",
|
||||
"advantages": "人脉很广，经常找小伙伴们开银趴，很会写后端代码"
|
||||
},
|
||||
...
|
||||
]
|
||||
}
|
||||
```
|
||||
|
||||
## ⚙️ Configurable options
|
||||
|
||||
Add options in the `.env` file from the diagram below in nonebot2 project.
|
||||
|
||||
#### plugin behaviour
|
||||
|
||||
| Option | Type | Default | Description |
|
||||
| ------------------------ | ------ | ------- | ---------------- |
|
||||
| MARSHOAI_USE_YAML_CONFIG | `bool` | `false` | Use YAML config format |
|
||||
|
||||
#### Marsho usage
|
||||
|
||||
| Option | Type | Default | Description |
|
||||
| --------------------- | ---------- | ----------- | ----------------- |
|
||||
| MARSHOAI_DEFAULT_NAME | `str` | `marsho` | Command to call Marsho |
|
||||
| MARSHOAI_ALIASES | `set[str]` | `set{"Marsho"}` | Other name(Alias) to call Marsho |
|
||||
| MARSHOAI_AT | `bool` | `false` | Call by @ or not |
|
||||
| MARSHOAI_MAIN_COLOUR | `str` | `FFAAAA` | Theme color, used by some tools and features |
|
||||
|
||||
#### AI call
|
||||
|
||||
| Option | Type | Default | Description |
|
||||
| -------------------------------- | ------- | --------------------------------------- | --------------------------------------------------------------------------------------------- |
|
||||
| MARSHOAI_TOKEN | `str` | | The token needed to call AI API |
|
||||
| MARSHOAI_DEFAULT_MODEL | `str` | `gpt-4o-mini` | The default model of Marsho |
|
||||
| MARSHOAI_PROMPT | `str` | Catgirl Marsho's character prompt | Marsho's basic system prompt **※Some models(o1 and so on) don't support it** |
|
||||
| MARSHOAI_ADDITIONAL_PROMPT | `str` | | Marsho's external system prompt |
|
||||
| MARSHOAI_POKE_SUFFIX | `str` | `揉了揉你的猫耳` | When double click Marsho who connected to OneBot adapter, the chat content. When it's empty string, double click function is off. Such as, the default content is `*[昵称]揉了揉你的猫耳。` |
|
||||
| MARSHOAI_AZURE_ENDPOINT | `str` | `https://models.inference.ai.azure.com` | OpenAI standard API |
|
||||
| MARSHOAI_TEMPERATURE | `float` | `null` | temperature parameter |
|
||||
| MARSHOAI_TOP_P | `float` | `null` | Nucleus Sampling parameter |
|
||||
| MARSHOAI_MAX_TOKENS | `int` | `null` | Max token number |
|
||||
| MARSHOAI_ADDITIONAL_IMAGE_MODELS | `list` | `[]` | External image-support model list, such as `hunyuan-vision` |
|
||||
|
||||
#### Feature Switches
|
||||
|
||||
| Option | Type | Default | Description |
|
||||
| --------------------------------- | ------ | ------ | -------------------------- |
|
||||
| MARSHOAI_ENABLE_SUPPORT_IMAGE_TIP | `bool` | `true` | When on, if user send request with photo and model don't support that, remind the user |
|
||||
| MARSHOAI_ENABLE_NICKNAME_TIP | `bool` | `true` | When on, if user haven't set username, remind user to set |
|
||||
| MARSHOAI_ENABLE_PRAISES | `bool` | `true` | Turn on Praise list or not |
|
||||
| MARSHOAI_ENABLE_TOOLS | `bool` | `true` | Turn on Marsho Tools or not |
|
||||
| MARSHOAI_LOAD_BUILTIN_TOOLS | `bool` | `true` | Loading the built-in toolkit or not |
|
||||
| MARSHOAI_TOOLSET_DIR | `list` | `[]` | List of external toolset directory |
|
||||
| MARSHOAI_DISABLED_TOOLKITS | `list` | `[]` | List of disabled toolkits' name |
|
||||
| MARSHOAI_ENABLE_RICHTEXT_PARSE | `bool` | `true` | Turn on auto parse rich text feature(including image, LaTeX equation) |
|
||||
| MARSHOAI_SINGLE_LATEX_PARSE | `bool` | `false`| Render single-line equation or not |
|
||||
## 😼 Usage
|
||||
Please read [Documentation](https://marsho.liteyuki.icu/start/install)
|
||||
|
||||
## ❤ Thanks&Copyright
|
||||
This project uses the following code from other projects:
|
||||
- [nonebot-plugin-latex](https://github.com/EillesWan/nonebot-plugin-latex)
|
||||
This project uses the following code from other projects:
|
||||
- [nonebot-plugin-latex](https://github.com/EillesWan/nonebot-plugin-latex)
|
||||
|
||||
"Marsho" logo contributed by [@Asankilp](https://github.com/Asankilp),
|
||||
licensed under [CC BY-NC-SA 4.0](http://creativecommons.org/licenses/by-nc-sa/4.0/) lisense.
|
||||
"Marsho" logo contributed by [@Asankilp](https://github.com/Asankilp),licensed under [CC BY-NC-SA 4.0](http://creativecommons.org/licenses/by-nc-sa/4.0/) lisense.
|
||||
|
||||
"nonebot-plugin-marshoai" is licensed under [MIT](./LICENSE-MIT) license.
|
||||
Some of the code is licensed under [Mulan PSL v2](./LICENSE-MULAN) license.
|
||||
|
||||
## 🕊️ TODO
|
||||
|
||||
- [x] [Melobot](https://github.com/Meloland/melobot) implementation
|
||||
- [x] Congize chat initiator(know who are chatting with Marsho) (Initially implement)
|
||||
- [ ] Optimize API (Not only GitHub Models）
|
||||
- [ ] Persistent storage context by database
|
||||
"nonebot-plugin-marshoai" is licensed under [MIT](./LICENSE-MIT) license.
|
||||
Some of the code is licensed under [Mulan PSL v2](./LICENSE-MULAN) license.
|
||||
|
||||
Reference in New Issue
Block a user