diff --git a/docs/blender.md b/docs/blender.md index f3e0cd3e..db0465c2 100644 --- a/docs/blender.md +++ b/docs/blender.md @@ -121,6 +121,7 @@ Blender 的操作高度依赖快捷键,初学时记住下面这些即可完成 *图 3:依次按下数字小键盘的 1、3、7,分别得到前视图(正视)、右视图和顶视图。* 需要说明的是,这套数字键位于**键盘右侧的数字小键盘**上;只有主键盘区数字键的笔记本,可以在「Edit → Preferences → Input」中勾选「Emulate Numpad(模拟小键盘)」来替代。 +> **注意:** 勾选该选项后,主键盘区的数字键 `1` `2` `3` 会被占用为视角切换键,**不再用于编辑模式下的“顶点 / 边 / 面”选择模式切换**。如果之后发现按 `1` `2` `3` 无法切换选择模式,就是这个设置导致的。需要切换选择模式时,可以临时关闭该选项,或者直接用鼠标点击 3D 视图左上角的“顶点/边/面”图标进行切换。 ## 6. 从 Blender 到模拟器 diff --git a/reports/reports.md b/reports/reports.md new file mode 100644 index 00000000..23bac7ee --- /dev/null +++ b/reports/reports.md @@ -0,0 +1,16 @@ +# reports 文件夹说明 + +## 1. 目录用途 +本目录主要用于存放 OpenHUTB 项目在自动化统计过程中生成的各类数据报告(如 CSV 文件等)。这些报告用于追溯不同时间段的项目活跃度和提交记录。 + +## 2. 报告是如何生成的 +这些报告并非手动创建,而是通过运行 `src` 目录下的 `git_commit_stats.py` 脚本自动生成的。 + +以下是生成报告的具体操作步骤: + +1. 确保已经安装了 Python 环境。 +2. 在项目根目录下,打开命令行终端。 +3. 运行统计脚本,例如统计特定时间段的提交记录: + ```bash + python src/git_commit_stats.py --since "2026-02-27 18:00" --until "2026-03-08 00:00" --output reports/commit_stats.csv + ```