📝 添加项目结构说明 | add project structure description

This commit is contained in:
远野千束 2024-09-01 10:23:06 +08:00
parent 29c2aa9404
commit fd1d73cc32
4 changed files with 43 additions and 6 deletions

View File

@ -21,6 +21,25 @@ If you need to submit code to the Liteyuki repository, please read the following
- During development, you can use tools such as `mypy`, `flake8`, and `black` for code checking and formatting. - During development, you can use tools such as `mypy`, `flake8`, and `black` for code checking and formatting.
- Enable developer mode by setting `dev_mode: true` in `config.yml` to see more debugging information in the console. - Enable developer mode by setting `dev_mode: true` in `config.yml` to see more debugging information in the console.
## Project Structure
- `main.py`: Bot entry file
- `liteyuki`: Framework directory (liteyukibot)
- `src`: Bot application source code directory
- `liteyuki_plugins`: Liteyuki plugin directory
- `nonebot_plugins`: Nonebot plugin directory
- `resources`: Built-in resource packs directory
- `utils`: Utility directory
- `tests`: Unit test directory
- `docs`: Documentation directory
- `en`: English documentation
- `zh`: Chinese documentation
- `docker`: Docker related content directory
The `liteyuki` framework is included in the `LiteyukiBot` application, so this project is both the `LiteyukiBot` application repository and the `liteyuki` framework repository.
The `src` directory is the application part, please develop business logic in this directory. `liteyuki_plugins` and `nonebot_plugins` directories are plugin directories, please develop plugins in these directories.
## Standardization ## Standardization
- Code should follow [`PEP8`](https://pep8.org/) and [`Google Python Style Guide`](https://google.github.io/styleguide/pyguide.html). - Code should follow [`PEP8`](https://pep8.org/) and [`Google Python Style Guide`](https://google.github.io/styleguide/pyguide.html).
- In addition, code submitted to the Liteyuki repository should follow the following guidelines: - In addition, code submitted to the Liteyuki repository should follow the following guidelines:

View File

@ -7,13 +7,13 @@ hero:
tagline: "An integrated chat bot application and management framework" tagline: "An integrated chat bot application and management framework"
actions: actions:
- theme: brand - theme: brand
text: Get Started text: 🚀 Get Started
link: ./deploy/install link: ./deploy/install
- theme: alt - theme: alt
text: Manual text: 📖 Manual
link: ./usage/basic link: ./usage/basic
- theme: alt - theme: alt
text: Extensions text: 📦 Extensions
link: ./store/ link: ./store/
image: image:

View File

@ -20,6 +20,24 @@ order: 0
- 开发过程中可以使用`mypy`, `flake8`, `black`等工具进行代码检查和格式化。 - 开发过程中可以使用`mypy`, `flake8`, `black`等工具进行代码检查和格式化。
- 启用开发者模式,可以在`config.yml`中设置`dev_mode: true`,这样可以在控制台看到更多的调试信息。 - 启用开发者模式,可以在`config.yml`中设置`dev_mode: true`,这样可以在控制台看到更多的调试信息。
## 项目结构
- `main.py`: 机器人入口文件
- `liteyuki`: 框架目录liteyukibot
- `src`: 机器人源码目录
- `liteyuki_plugins`: 轻雪插件目录
- `nonebot_plugins`: Nonebot插件目录
- `resources`: 内置资源包目录
- `utils`: 工具目录
- `tests`: 单元测试目录
- `docs`: 文档目录
- `en`: 英文文档
- `zh`: 中文文档
- `docker`: Docker相关内容目录
其中,`liteyuki`框架是包含在`LiteyukiBot`应用中的,所以此项目既是`LiteyukiBot`应用仓库,同时也是`liteyuki`框架的仓库
`src`目录下为应用程序部分,业务逻辑请在此目录下进行开发,`liteyuki_plugins`和`nonebot_plugins`目录下为插件目录,插件开发请在此目录下进行开发。
## 规范化 ## 规范化
- 代码请遵循[`PEP8`](https://pep8.org/)和[`Google Python Style Guide`](https://google.github.io/styleguide/pyguide.html) - 代码请遵循[`PEP8`](https://pep8.org/)和[`Google Python Style Guide`](https://google.github.io/styleguide/pyguide.html)
- 此外,提交到轻雪仓库的代码,请遵循以下规范: - 此外,提交到轻雪仓库的代码,请遵循以下规范:

View File

@ -7,13 +7,13 @@ hero:
tagline: "一个综合性的机器人应用及管理框架" tagline: "一个综合性的机器人应用及管理框架"
actions: actions:
- theme: brand - theme: brand
text: 快速开始 text: 🚀 快速开始
link: ./deploy/install link: ./deploy/install
- theme: alt - theme: alt
text: 使用手册 text: 📖 使用手册
link: ./usage/basic link: ./usage/basic
- theme: alt - theme: alt
text: 扩展 text: 📦 扩展
link: ./store/resource link: ./store/resource
image: image:
light: ./liteyuki.svg light: ./liteyuki.svg