From 6ddf800f87d8f513e38752733cca51713affb167 Mon Sep 17 00:00:00 2001
From: cqh963852 <cqh963852@hotmail.com>
Date: Wed, 19 Aug 2026 14:58:42 +0800
Subject: [PATCH] =?UTF-8?q?refactor:=20tools=20=E6=A0=8F=E7=9B=AE=E6=89=81?=
 =?UTF-8?q?=E5=B9=B3=E5=8C=96=EF=BC=8C=E5=8E=BB=E9=99=A4=E5=AD=90=E6=96=87?=
 =?UTF-8?q?=E4=BB=B6=E5=A4=B9?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

- 文档全部移至 tools/ 根目录（docker_install、vscode_exception 等带前缀命名）
- 图片按板块前缀重命名（docker-1.png、prisma-verify1.png 等）避免名称冲突
- 更新文档内图片引用与 sidebar_position 排序
- 更新 tools/index.md 目录链接

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
---
 packages/stack-idealjs/tools/_category_.json    |   7 -------
 .../tools/{docker/1.png => docker-1.png}        | Bin
 .../tools/{docker/2.png => docker-2.png}        | Bin
 .../tools/{docker/5.png => docker-5.png}        | Bin
 .../tools/{docker/6.png => docker-6.png}        | Bin
 .../tools/{docker/7.png => docker-7.png}        | Bin
 .../tools/{docker/8.png => docker-8.png}        | Bin
 .../stack-idealjs/tools/docker/_category_.json  |   7 -------
 .../{docker/install.md => docker_install.md}    |  12 ++++++------
 .../tools/{docker/start.md => docker_start.md}  |   4 ++--
 .../{git/post-1-1.png => git-post-1-1.png}      | Bin
 .../{git/post-1-2.png => git-post-1-2.png}      | Bin
 .../tools/{git/index.mdx => git.mdx}            |   6 +++---
 .../stack-idealjs/tools/git/_category_.json     |   7 -------
 packages/stack-idealjs/tools/index.md           |  16 +++++++++-------
 .../stack-idealjs/tools/install/_category_.json |   7 -------
 .../stack-idealjs/tools/linux/_category_.json   |   7 -------
 .../tools/{linux/alias.md => linux_alias.md}    |   2 +-
 .../stack-idealjs/tools/{install => }/nodejs.md |   0
 .../tools/{nvm/install_nvm.md => nvm.md}        |   4 ++++
 packages/stack-idealjs/tools/{nvm => }/nvm.png  | Bin
 .../stack-idealjs/tools/nvm/_category_.json     |   7 -------
 .../{prisma/verify1.png => prisma-verify1.png}  | Bin
 .../{prisma/verify2.png => prisma-verify2.png}  | Bin
 .../stack-idealjs/tools/{prisma => }/prisma.md  |   8 ++++----
 .../stack-idealjs/tools/prisma/_category_.json  |   7 -------
 .../tools/{vscode/code.png => vscode-code.png}  | Bin
 .../tools/{vscode/json.png => vscode-json.png}  | Bin
 .../marketplace.png => vscode-marketplace.png}  | Bin
 .../{vscode/setting.png => vscode-setting.png}  | Bin
 .../stack-idealjs/tools/{install => }/vscode.md |   2 +-
 .../stack-idealjs/tools/vscode/_category_.json  |   7 -------
 .../exception.md => vscode_exception.md}        |  10 +++++-----
 33 files changed, 35 insertions(+), 85 deletions(-)
 delete mode 100644 packages/stack-idealjs/tools/_category_.json
 rename packages/stack-idealjs/tools/{docker/1.png => docker-1.png} (100%)
 rename packages/stack-idealjs/tools/{docker/2.png => docker-2.png} (100%)
 rename packages/stack-idealjs/tools/{docker/5.png => docker-5.png} (100%)
 rename packages/stack-idealjs/tools/{docker/6.png => docker-6.png} (100%)
 rename packages/stack-idealjs/tools/{docker/7.png => docker-7.png} (100%)
 rename packages/stack-idealjs/tools/{docker/8.png => docker-8.png} (100%)
 delete mode 100644 packages/stack-idealjs/tools/docker/_category_.json
 rename packages/stack-idealjs/tools/{docker/install.md => docker_install.md} (86%)
 rename packages/stack-idealjs/tools/{docker/start.md => docker_start.md} (95%)
 rename packages/stack-idealjs/tools/{git/post-1-1.png => git-post-1-1.png} (100%)
 rename packages/stack-idealjs/tools/{git/post-1-2.png => git-post-1-2.png} (100%)
 rename packages/stack-idealjs/tools/{git/index.mdx => git.mdx} (96%)
 delete mode 100644 packages/stack-idealjs/tools/git/_category_.json
 delete mode 100644 packages/stack-idealjs/tools/install/_category_.json
 delete mode 100644 packages/stack-idealjs/tools/linux/_category_.json
 rename packages/stack-idealjs/tools/{linux/alias.md => linux_alias.md} (97%)
 rename packages/stack-idealjs/tools/{install => }/nodejs.md (100%)
 rename packages/stack-idealjs/tools/{nvm/install_nvm.md => nvm.md} (97%)
 rename packages/stack-idealjs/tools/{nvm => }/nvm.png (100%)
 delete mode 100644 packages/stack-idealjs/tools/nvm/_category_.json
 rename packages/stack-idealjs/tools/{prisma/verify1.png => prisma-verify1.png} (100%)
 rename packages/stack-idealjs/tools/{prisma/verify2.png => prisma-verify2.png} (100%)
 rename packages/stack-idealjs/tools/{prisma => }/prisma.md (93%)
 delete mode 100644 packages/stack-idealjs/tools/prisma/_category_.json
 rename packages/stack-idealjs/tools/{vscode/code.png => vscode-code.png} (100%)
 rename packages/stack-idealjs/tools/{vscode/json.png => vscode-json.png} (100%)
 rename packages/stack-idealjs/tools/{vscode/marketplace.png => vscode-marketplace.png} (100%)
 rename packages/stack-idealjs/tools/{vscode/setting.png => vscode-setting.png} (100%)
 rename packages/stack-idealjs/tools/{install => }/vscode.md (89%)
 delete mode 100644 packages/stack-idealjs/tools/vscode/_category_.json
 rename packages/stack-idealjs/tools/{vscode/exception.md => vscode_exception.md} (84%)

diff --git a/packages/stack-idealjs/tools/_category_.json b/packages/stack-idealjs/tools/_category_.json
deleted file mode 100644
index ad2a864..0000000
--- a/packages/stack-idealjs/tools/_category_.json
+++ /dev/null
@@ -1,7 +0,0 @@
-{
-  "label": "工具使用",
-  "position": 4,
-  "link": {
-    "type": "generated-index"
-  }
-}
diff --git a/packages/stack-idealjs/tools/docker/1.png b/packages/stack-idealjs/tools/docker-1.png
similarity index 100%
rename from packages/stack-idealjs/tools/docker/1.png
rename to packages/stack-idealjs/tools/docker-1.png
diff --git a/packages/stack-idealjs/tools/docker/2.png b/packages/stack-idealjs/tools/docker-2.png
similarity index 100%
rename from packages/stack-idealjs/tools/docker/2.png
rename to packages/stack-idealjs/tools/docker-2.png
diff --git a/packages/stack-idealjs/tools/docker/5.png b/packages/stack-idealjs/tools/docker-5.png
similarity index 100%
rename from packages/stack-idealjs/tools/docker/5.png
rename to packages/stack-idealjs/tools/docker-5.png
diff --git a/packages/stack-idealjs/tools/docker/6.png b/packages/stack-idealjs/tools/docker-6.png
similarity index 100%
rename from packages/stack-idealjs/tools/docker/6.png
rename to packages/stack-idealjs/tools/docker-6.png
diff --git a/packages/stack-idealjs/tools/docker/7.png b/packages/stack-idealjs/tools/docker-7.png
similarity index 100%
rename from packages/stack-idealjs/tools/docker/7.png
rename to packages/stack-idealjs/tools/docker-7.png
diff --git a/packages/stack-idealjs/tools/docker/8.png b/packages/stack-idealjs/tools/docker-8.png
similarity index 100%
rename from packages/stack-idealjs/tools/docker/8.png
rename to packages/stack-idealjs/tools/docker-8.png
diff --git a/packages/stack-idealjs/tools/docker/_category_.json b/packages/stack-idealjs/tools/docker/_category_.json
deleted file mode 100644
index dfbef1c..0000000
--- a/packages/stack-idealjs/tools/docker/_category_.json
+++ /dev/null
@@ -1,7 +0,0 @@
-{
-  "label": "Docker",
-  "position": 4,
-  "link": {
-    "type": "generated-index"
-  }
-}
diff --git a/packages/stack-idealjs/tools/docker/install.md b/packages/stack-idealjs/tools/docker_install.md
similarity index 86%
rename from packages/stack-idealjs/tools/docker/install.md
rename to packages/stack-idealjs/tools/docker_install.md
index 7a9049f..69ef31e 100644
--- a/packages/stack-idealjs/tools/docker/install.md
+++ b/packages/stack-idealjs/tools/docker_install.md
@@ -1,5 +1,5 @@
 ---
-sidebar_position: 1
+sidebar_position: 6
 ---
 
 # docker的安装与验证
@@ -16,9 +16,9 @@ docker是一种开源平台，用于开发、部署和运行应用程序。
 ### 1. 开启windows功能
 通过控制面板，开启Hyper-v和适用于windows子系统功能
 
-![控制面板](./1.png)
+![控制面板](./docker-1.png)
 
-![启动windows功能](./2.png)
+![启动windows功能](./docker-2.png)
 
 ### 2. 下载并安装docker
 下载docker最安全的路径就是去官网，安装时要注意勾选`wsl`选项，安装成功后跳过登录docker Hub账号
@@ -29,9 +29,9 @@ https://docs.docker.com/desktop/install/windows-install/
 ## 配置Docker镜像
 安装docker后，进入docker，开始配置镜像
 
-![设置页面](./6.png)
+![设置页面](./docker-6.png)
 
-![Docker Engine](./7.png)
+![Docker Engine](./docker-7.png)
 
 配置镜像添加以下内容
 ```                           
@@ -44,5 +44,5 @@ https://docs.docker.com/desktop/install/windows-install/
  docker run hello-world
  ```
  当输出`Hello from Docker`命令时，表明Docker安装正确
- ![验证Docker](./8.png)
+ ![验证Docker](./docker-8.png)
 
diff --git a/packages/stack-idealjs/tools/docker/start.md b/packages/stack-idealjs/tools/docker_start.md
similarity index 95%
rename from packages/stack-idealjs/tools/docker/start.md
rename to packages/stack-idealjs/tools/docker_start.md
index 3112125..2d2327d 100644
--- a/packages/stack-idealjs/tools/docker/start.md
+++ b/packages/stack-idealjs/tools/docker_start.md
@@ -1,5 +1,5 @@
 ---
-sidebar_position: 1
+sidebar_position: 7
 ---
 
 # Docker启动数据库
@@ -54,7 +54,7 @@ docker-compose up --build
 ```
 docker ps
 ```
-![运行容器](./5.png)
+![运行容器](./docker-5.png)
 
 ### 5. 连接到PostgreSQL数据库
 运行以下命令，连接到PostgreSQL数据库：
diff --git a/packages/stack-idealjs/tools/git/post-1-1.png b/packages/stack-idealjs/tools/git-post-1-1.png
similarity index 100%
rename from packages/stack-idealjs/tools/git/post-1-1.png
rename to packages/stack-idealjs/tools/git-post-1-1.png
diff --git a/packages/stack-idealjs/tools/git/post-1-2.png b/packages/stack-idealjs/tools/git-post-1-2.png
similarity index 100%
rename from packages/stack-idealjs/tools/git/post-1-2.png
rename to packages/stack-idealjs/tools/git-post-1-2.png
diff --git a/packages/stack-idealjs/tools/git/index.mdx b/packages/stack-idealjs/tools/git.mdx
similarity index 96%
rename from packages/stack-idealjs/tools/git/index.mdx
rename to packages/stack-idealjs/tools/git.mdx
index b2275d6..0fb7f84 100644
--- a/packages/stack-idealjs/tools/git/index.mdx
+++ b/packages/stack-idealjs/tools/git.mdx
@@ -1,5 +1,5 @@
 ---
-sidebar_position: 1
+sidebar_position: 4
 ---
 
 import Tabs from "@theme/Tabs";
@@ -40,7 +40,7 @@ git 是一个代码管理工具，可以追踪代码的提交记录。这是每
 通常一个项目会对应一个 git 仓库，每次提交代码都会记录到 git 仓库中，这样就可以追踪代码的提交记录。
 
 用图形化的工具来看的话，会呈现出如下图
-![预览效果](./post-1-1.png)
+![预览效果](./git-post-1-1.png)
 
 ### 克隆
 
@@ -58,7 +58,7 @@ git clone https://github.com/idealjs/stack.git
 
 被克隆的仓库，我们通常叫他 **远程仓库**。或者源仓库。
 
-![预览效果](./post-1-2.png)
+![预览效果](./git-post-1-2.png)
 
 ### 拉取代码
 
diff --git a/packages/stack-idealjs/tools/git/_category_.json b/packages/stack-idealjs/tools/git/_category_.json
deleted file mode 100644
index 33448ee..0000000
--- a/packages/stack-idealjs/tools/git/_category_.json
+++ /dev/null
@@ -1,7 +0,0 @@
-{
-  "label": "Git",
-  "position": 2,
-  "link": {
-    "type": "generated-index"
-  }
-}
diff --git a/packages/stack-idealjs/tools/index.md b/packages/stack-idealjs/tools/index.md
index 0ee722c..cdc947c 100644
--- a/packages/stack-idealjs/tools/index.md
+++ b/packages/stack-idealjs/tools/index.md
@@ -10,10 +10,12 @@ sidebar_position: 1
 
 ## 内容
 
-1. [安装工具（nodejs、vscode）](./install/nodejs.md)
-2. [Git](./git/index.mdx)
-3. [NVM](./nvm/install_nvm.md)
-4. [Docker](./docker/install.md)
-5. [Prisma](./prisma/prisma.md)
-6. [VSCode 常见问题](./vscode/exception)
-7. [Linux Alias](./linux/alias.md)
+1. [安装 nodejs](./nodejs)
+2. [安装 vscode](./vscode)
+3. [Git](./git)
+4. [NVM](./nvm)
+5. [Docker 安装](./docker_install)
+6. [Docker 启动数据库](./docker_start)
+7. [Prisma](./prisma)
+8. [VSCode 常见问题](./vscode_exception)
+9. [Linux Alias](./linux_alias)
diff --git a/packages/stack-idealjs/tools/install/_category_.json b/packages/stack-idealjs/tools/install/_category_.json
deleted file mode 100644
index 9db37a8..0000000
--- a/packages/stack-idealjs/tools/install/_category_.json
+++ /dev/null
@@ -1,7 +0,0 @@
-{
-  "label": "安装工具-win",
-  "position": 1,
-  "link": {
-    "type": "generated-index"
-  }
-}
diff --git a/packages/stack-idealjs/tools/linux/_category_.json b/packages/stack-idealjs/tools/linux/_category_.json
deleted file mode 100644
index c4619af..0000000
--- a/packages/stack-idealjs/tools/linux/_category_.json
+++ /dev/null
@@ -1,7 +0,0 @@
-{
-  "label": "Linux",
-  "position": 7,
-  "link": {
-    "type": "generated-index"
-  }
-}
diff --git a/packages/stack-idealjs/tools/linux/alias.md b/packages/stack-idealjs/tools/linux_alias.md
similarity index 97%
rename from packages/stack-idealjs/tools/linux/alias.md
rename to packages/stack-idealjs/tools/linux_alias.md
index 8b69ff6..c5a2890 100644
--- a/packages/stack-idealjs/tools/linux/alias.md
+++ b/packages/stack-idealjs/tools/linux_alias.md
@@ -1,5 +1,5 @@
 ---
-sidebar_position: 1
+sidebar_position: 10
 ---
 
 # Linux alias
diff --git a/packages/stack-idealjs/tools/install/nodejs.md b/packages/stack-idealjs/tools/nodejs.md
similarity index 100%
rename from packages/stack-idealjs/tools/install/nodejs.md
rename to packages/stack-idealjs/tools/nodejs.md
diff --git a/packages/stack-idealjs/tools/nvm/install_nvm.md b/packages/stack-idealjs/tools/nvm.md
similarity index 97%
rename from packages/stack-idealjs/tools/nvm/install_nvm.md
rename to packages/stack-idealjs/tools/nvm.md
index 143d951..126c3d5 100644
--- a/packages/stack-idealjs/tools/nvm/install_nvm.md
+++ b/packages/stack-idealjs/tools/nvm.md
@@ -1,3 +1,7 @@
+---
+sidebar_position: 5
+---
+
 # nvm
 - Node.js是用于服务器端JavaScript运行，适合高性能、实时应用
 - NVM用于管理多个Node.js版本，便于在不同项目间切换
diff --git a/packages/stack-idealjs/tools/nvm/nvm.png b/packages/stack-idealjs/tools/nvm.png
similarity index 100%
rename from packages/stack-idealjs/tools/nvm/nvm.png
rename to packages/stack-idealjs/tools/nvm.png
diff --git a/packages/stack-idealjs/tools/nvm/_category_.json b/packages/stack-idealjs/tools/nvm/_category_.json
deleted file mode 100644
index 59c9eb9..0000000
--- a/packages/stack-idealjs/tools/nvm/_category_.json
+++ /dev/null
@@ -1,7 +0,0 @@
-{
-  "label": "NVM",
-  "position": 3,
-  "link": {
-    "type": "generated-index"
-  }
-}
diff --git a/packages/stack-idealjs/tools/prisma/verify1.png b/packages/stack-idealjs/tools/prisma-verify1.png
similarity index 100%
rename from packages/stack-idealjs/tools/prisma/verify1.png
rename to packages/stack-idealjs/tools/prisma-verify1.png
diff --git a/packages/stack-idealjs/tools/prisma/verify2.png b/packages/stack-idealjs/tools/prisma-verify2.png
similarity index 100%
rename from packages/stack-idealjs/tools/prisma/verify2.png
rename to packages/stack-idealjs/tools/prisma-verify2.png
diff --git a/packages/stack-idealjs/tools/prisma/prisma.md b/packages/stack-idealjs/tools/prisma.md
similarity index 93%
rename from packages/stack-idealjs/tools/prisma/prisma.md
rename to packages/stack-idealjs/tools/prisma.md
index deef634..4076fde 100644
--- a/packages/stack-idealjs/tools/prisma/prisma.md
+++ b/packages/stack-idealjs/tools/prisma.md
@@ -1,5 +1,5 @@
 ---
-sidebar_position: 1
+sidebar_position: 8
 ---
 
 # Next.js + Prisma + Docker构建全栈
@@ -13,7 +13,7 @@ sidebar_position: 1
 5. 确认已启动数据库
 
 >**提示**                                                                                                                                    
-如果不知道怎么启动数据库，可以参考使用 [Docker启动数据库](/tools/docker/start)文档
+如果不知道怎么启动数据库，可以参考使用 [Docker启动数据库](/tools/docker_start)文档
 
 ## 项目初始化
 - 打开Next.js项目
@@ -62,8 +62,8 @@ npx prisma studio
 #### 4.2 验证数据
 在`Prisma Studio`中，可以查看`User`表的数据，通过添加、编辑或修改记录，验证表是否正确
 
-![添加记录](./verify1.png)
-![添加成功](./verify2.png)
+![添加记录](./prisma-verify1.png)
+![添加成功](./prisma-verify2.png)
 
 ### 5. 在Next.js中使用Prisma
 #### 5.1 设置Prisma客户端
diff --git a/packages/stack-idealjs/tools/prisma/_category_.json b/packages/stack-idealjs/tools/prisma/_category_.json
deleted file mode 100644
index 59f46df..0000000
--- a/packages/stack-idealjs/tools/prisma/_category_.json
+++ /dev/null
@@ -1,7 +0,0 @@
-{
-  "label": "Prisma",
-  "position": 5,
-  "link": {
-    "type": "generated-index"
-  }
-}
diff --git a/packages/stack-idealjs/tools/vscode/code.png b/packages/stack-idealjs/tools/vscode-code.png
similarity index 100%
rename from packages/stack-idealjs/tools/vscode/code.png
rename to packages/stack-idealjs/tools/vscode-code.png
diff --git a/packages/stack-idealjs/tools/vscode/json.png b/packages/stack-idealjs/tools/vscode-json.png
similarity index 100%
rename from packages/stack-idealjs/tools/vscode/json.png
rename to packages/stack-idealjs/tools/vscode-json.png
diff --git a/packages/stack-idealjs/tools/vscode/marketplace.png b/packages/stack-idealjs/tools/vscode-marketplace.png
similarity index 100%
rename from packages/stack-idealjs/tools/vscode/marketplace.png
rename to packages/stack-idealjs/tools/vscode-marketplace.png
diff --git a/packages/stack-idealjs/tools/vscode/setting.png b/packages/stack-idealjs/tools/vscode-setting.png
similarity index 100%
rename from packages/stack-idealjs/tools/vscode/setting.png
rename to packages/stack-idealjs/tools/vscode-setting.png
diff --git a/packages/stack-idealjs/tools/install/vscode.md b/packages/stack-idealjs/tools/vscode.md
similarity index 89%
rename from packages/stack-idealjs/tools/install/vscode.md
rename to packages/stack-idealjs/tools/vscode.md
index 6689983..609b091 100644
--- a/packages/stack-idealjs/tools/install/vscode.md
+++ b/packages/stack-idealjs/tools/vscode.md
@@ -1,5 +1,5 @@
 ---
-sidebar_position: 1
+sidebar_position: 3
 ---
 
 # 安装 vscode 编辑器
diff --git a/packages/stack-idealjs/tools/vscode/_category_.json b/packages/stack-idealjs/tools/vscode/_category_.json
deleted file mode 100644
index 5e20e5b..0000000
--- a/packages/stack-idealjs/tools/vscode/_category_.json
+++ /dev/null
@@ -1,7 +0,0 @@
-{
-  "label": "VSCode",
-  "position": 6,
-  "link": {
-    "type": "generated-index"
-  }
-}
diff --git a/packages/stack-idealjs/tools/vscode/exception.md b/packages/stack-idealjs/tools/vscode_exception.md
similarity index 84%
rename from packages/stack-idealjs/tools/vscode/exception.md
rename to packages/stack-idealjs/tools/vscode_exception.md
index bd84bc6..34ed48a 100644
--- a/packages/stack-idealjs/tools/vscode/exception.md
+++ b/packages/stack-idealjs/tools/vscode_exception.md
@@ -1,5 +1,5 @@
 ---
-sidebar_position: 1
+sidebar_position: 9
 ---
 
 # 如何处理vscode安装插件异常
@@ -12,17 +12,17 @@ https://marketplace.visualstudio.com
 ```
 如果一切正常，您应该在`https://marketplace.visualstudio.com`有一个Extensions for Visual Studio Code的页面。
 
-![vscode扩展页面](./marketplace.png)
+![vscode扩展页面](./vscode-marketplace.png)
 
 ## 2. 防火墙阻止
 当我们第一次启动调试功能的时候，正常情况vscode会弹出防火墙阻止的界面
 
-![防火墙](./code.png)
+![防火墙](./vscode-code.png)
 
 ## 3. 设置代理
-![设置图片](./setting.png)
+![设置图片](./vscode-setting.png)
 
-![json图片](./json.png)
+![json图片](./vscode-json.png)
 
 在`setting.json`中添加以下代理
 ```