docs: 更新 DEVELOPMENT.md

加入对 PyCharm setup 的说明

docs/DEVELOPMENT.md

@@ -1,26 +1,46 @@
 # 开发
-> [!NOTE]
+## 共通
-> 建议使用 VSCode 进行开发。
+1. 安装 [just](https://github.com/casey/just#packages) 构建工具。
-
+2. 创建 Python 3.10 虚拟环境，配置 node 环境。
-1. 确保你已经安装 [just](https://github.com/casey/just#packages) 构建工具
+3. 执行：
-2. 创建 Python 3.10 虚拟环境，然后执行：
    ```bash
-    git clone https://github.com/XcantloadX/KotonesAutoAssistant.git
+   git clone https://github.com/XcantloadX/kotones-auto-assistant.git
-    cd KotonesAutoAssistant
+   cd kotones-auto-assistant
    just env
+   cd kotonebot-devtool
+   npm i
    ```
-3. 配置 VSCode：
+
+## VSCode
 1. 进入“扩展 Extension”，搜索 `@recommended` ，然后安装里面的所有插件。
 2. 打开 VSCode 设置，搜索 `python.analysis.supportRestructuredText` 并勾选。
 3. 打开 VSCode 设置，搜索 `imageComments.pathMode` 并设置为 `relativeToWorkspace`。
-4. 编译资源：在 VSCode 中选择“Terminal” -> “Run Task” -> “Make R.py”并执行。
+4. 在 VSCode 中选择“Terminal” -> “Run Task” -> “Make R.py”并执行。
+
+## PyCharm
+1. 设置 Docstring 渲染
+![PyCharm dostring 设置页面](./images/pycharm_docstring_config.png)
+
+2. 按照下图新建一个 Run Configuration：
+![pycharm_run_config.png](images/pycharm_run_config.png)
+
+3. \[可选\] 强烈建议关闭 PyCharm 内置 typing check，安装
+[Pyright for PyCharm](https://plugins.jetbrains.com/plugin/24145-pyright) 作为替代。
+PyCharm 内置 typing check 功能太弱，在 kaa 代码中经常出现错误推断。
+如果你倾向于使用 mypy，也可以安装 [Mypy](https://plugins.jetbrains.com/plugin/25888-mypy) 插件。
+
+4. \[可选\] 启动 `tools\image_server.py`。
+由于 [PyCharm 的 bug](https://youtrack.jetbrains.com/issue/PY-54150/Cannot-display-local-images-in-docstring)， 
+docstring 中无法渲染本地图片，所以必须启动一个 HTTP 服务器作为中转。
+如果你不需要预览 docstring 中的图片（特别是 `R.py` 中的图片），可以跳过此步骤。
+
+5. **从 PyCharm 内置终端**执行 `tools\make_resources.py`。
+如果从外部终端执行，需要指定参数 `-i pycharm`。
 
 ## 运行单个任务
-如果使用 VSCode，只需要在运行配置里选择 `Python: Current Module` 即可。
+VSCode：运行配置里选择 `Python: Current Module`。
 
-如果使用 PyCharm，按照下图新建一个 Run Configuration：
+PyCharm：使用刚刚创建的 Run Configuration。
-
-![pycharm_run_config.png](images/pycharm_run_config.png)
 
 ## 打包 & 安装
 ```bash