📖 Introduction

NoneBot DeepSeek plugin. Integrates the DeepSeek model, providing intelligent dialogue and Q&A capabilities.

Wiki: 👉 Portal

[!IMPORTANT]

Star the project, you will receive all release notifications from GitHub without delay～⭐️

Star History

💿 Installation

You can choose either one of the methods mentioned below

[!TIP]

To enable Markdown to image conversion, you need to install nonebot-plugin-deepseek[image]

nb plugin install nonebot-plugin-deepseek

pip install nonebot-plugin-deepseek
or, use poetry
poetry add nonebot-plugin-deepseek
or, use pdm
pdm add nonebot-plugin-deepseek

plugins = ["nonebot_plugin_deepseek"]

⚙️ Configuration

Add the configurations in the table below to the project's configuration file

[!note]

api_key Please obtain it from DeepSeek Open Platform

enable_models is a dictionary of CustomModel structures; no modification is needed if you do not need to connect local models

To connect local models, please refer to: 👉 Wiki - Connect Local Models

| Configuration Item | Required | Default Value | Description | | :---------------------------------: | :------: | :-------------------------------------------------------------------: | :-----------------------------------------------------------------------------------------------------------------------------------------------------------: | | deepseek__api_key | Yes | None | API Key | | deepseek__enable_models | No | [{ "name": "deepseek-chat" }, { "name": "deepseek-reasoner" }] | Enabled models Configuration Explanation | | deepseek__prompt | No | None | Model preset | | deepseek__stream | No | False | Whether to enable streaming transmission | | deepseek__timeout | No | {"api_request": 100, "user_input": 60} | Timeout settings | | deepseek__md_to_pic | No | False | Whether to enable Markdown to image | | deepseek__enable_send_thinking | No | False | Whether to send the chain of thought |

🎉 Usage

[!note]

Please check your COMMAND_START and the above configuration items. The default command prefix is /

Help

deepseek --help
         --balance
         [...content] 
           --use-model [model]
           --with-context
           --render | -r
         model
           --list | -l
           --set-default [model]
           --render-markdown ['enable' | 'disable' | 'on' | 'off']

问答

/deepseek [内容]

Quick command: /ds [content] or reply to a text message

Multi-turn conversation

/deepseek --with-context [内容]

Shortcut commands: /ds --with-context [content] /multi-turn conversation

Deep Thinking

/deepseek [内容] --use-model deepseek-reasoner

快捷指令：/深度思考 [内容]

余额

权限：SUPERUSER

/deepseek --balance

快捷指令：/ds --balance /余额

设置

权限：设置默认模型 指令仅 SUPERUSER 可用

# 查看支持的模型列表
/deepseek model -l|--list
设置默认模型
/deepseek model --set-default [模型名]
设置 Markdown 转图片
/deepseek model --render-markdown ['enable' | 'disable' | 'on' | 'off']

Quick Commands: /model list /set default model [model name]

Custom Quick Commands

This feature relies on Alconna Quick Commands. Custom commands do not include COMMAND_START; if necessary, it must be manually added

# 增加
/deepseek --shortcut <自定义指令> /deepseek
删除
/deepseek --shortcut delete <自定义指令>
列出
/deepseek --shortcut list

例子:

user: /deepseek --shortcut /chat /deepseek --use-model deepseek-chat
bot: deepseek::deepseek 的快捷指令: "/chat" 添加成功
user: /chat
bot: (使用模型 deepseek-chat)

📸 Screenshots

💖 Acknowledgements

• KomoriDev/Starify: Provided eye-catching badges

Contributors

Thanks to these great people for their contributions to this project:

📄 License

This project is open source under the MIT license

THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
SOFTWARE.

--- Tranlated By Open Ai Tx | Last indexed: 2026-07-07 ---