myspace-cli 1.3.0__tar.gz → 1.5.0__tar.gz

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (12) hide show
  1. {myspace_cli-1.3.0 → myspace_cli-1.5.0}/PKG-INFO +53 -27
  2. {myspace_cli-1.3.0 → myspace_cli-1.5.0}/README.md +52 -26
  3. {myspace_cli-1.3.0 → myspace_cli-1.5.0}/myspace_cli.egg-info/PKG-INFO +53 -27
  4. {myspace_cli-1.3.0 → myspace_cli-1.5.0}/pyproject.toml +1 -1
  5. myspace_cli-1.5.0/space_cli.py +293 -0
  6. myspace_cli-1.3.0/space_cli.py +0 -1067
  7. {myspace_cli-1.3.0 → myspace_cli-1.5.0}/myspace_cli.egg-info/SOURCES.txt +0 -0
  8. {myspace_cli-1.3.0 → myspace_cli-1.5.0}/myspace_cli.egg-info/dependency_links.txt +0 -0
  9. {myspace_cli-1.3.0 → myspace_cli-1.5.0}/myspace_cli.egg-info/entry_points.txt +0 -0
  10. {myspace_cli-1.3.0 → myspace_cli-1.5.0}/myspace_cli.egg-info/requires.txt +0 -0
  11. {myspace_cli-1.3.0 → myspace_cli-1.5.0}/myspace_cli.egg-info/top_level.txt +0 -0
  12. {myspace_cli-1.3.0 → myspace_cli-1.5.0}/setup.cfg +0 -0
{myspace_cli-1.3.0 → myspace_cli-1.5.0}/PKG-INFO RENAMED
@@ -1,6 +1,6 @@
1
1
  Metadata-Version: 2.4
2
2
  Name: myspace-cli
3
- Version: 1.3.0
3
+ Version: 1.5.0
4
4
  Summary: A macOS disk space analysis CLI: health, index, app usage, big files.
5
5
  Author-email: Your Name <you@example.com>
6
6
  License: MIT
@@ -17,28 +17,28 @@ Description-Content-Type: text/markdown
17
17
  Provides-Extra: mcp
18
18
  Requires-Dist: mcp<2,>=1; extra == "mcp"
19
19
 
20
- # space-cli - Mac OS 磁盘空间分析工具
20
+ # space-cli - macOS 磁盘空间优化工具
21
21
 
22
22
  很多人的Mac电脑都会出现磁盘空间不够用，付费软件太贵或者难以使用。
23
23
 
24
- space-cli是一个开源的Mac OS命令行小工具，用于分析磁盘空间健康度并找出占用空间最大的目录。
24
+ space-cli是一个开源的macOS命令行小工具，用于分析磁盘空间健康度并找出占用空间大的目录，可选择针对单个应用进行一键清理。
25
25
 
26
26
  本软件采用**最严安全原则**，所有分析操作采用只读模式，未经允许不会尝试改写和破坏用户电脑的任何数据，也不会上传任何数据到外网，严格保护用户的隐私。
27
27
 
28
28
  ## 功能特性
29
29
 
30
30
  - 🔍 **磁盘健康度检测** - 评估磁盘空间使用情况，提供健康状态建议
31
- - 📊 **目录大小分析** - 递归分析目录大小，找出占用空间最大的文件夹
32
- - 💻 **系统信息显示** - 显示Mac系统版本和基本信息
31
+ - 📊 **交互式目录分析** - 递归分析目录大小，支持选择序号进行深度下探分析
32
+ - 💻 **详细系统信息** - 显示CPU、内存、GPU、硬盘等完整硬件信息
33
33
  - 📄 **报告导出** - 将分析结果导出为JSON格式报告
34
- - ⚡ **高性能** - 优化的算法，快速分析大型文件系统
34
+ - ⚡ **高性能优化** - 优先使用 `du -sk` 命令，失败时回退到 `os.scandir` 高效遍历
35
35
  - 🎯 **灵活配置** - 支持自定义分析路径和显示数量
36
- - 🗂️ **索引缓存** - 目录大小结果本地索引缓存（`~/.spacecli/index.json`），支持TTL与重建提示
36
+ - 🗂️ **智能索引缓存** - 目录大小结果本地索引缓存（`~/.spacecli/index.json`），支持TTL与重建提示
37
37
  - 🧩 **应用分析** - 汇总 `Applications`、`Library`、`Caches`、`Logs` 等路径估算应用占用，给出卸载建议
38
38
  - 🗑️ **一键删除应用** - 在应用分析列表中输入序号即可一键删除所选应用及其缓存（含二次确认）
39
- - 🏠 **用户目录深度分析** - 针对 `~/Library`、`~/Downloads`、`~/Documents` 分别下探并展示Top N目录
40
- - 🗄️ **大文件分析** - 扫描并列出指定路径下最大的文件，支持数量和最小体积阈值
41
- - ⏱️ **支持MCP调用** - 支持你自己的AI Agent无缝调用磁盘空间信息
39
+ - 🏠 **用户目录深度分析** - 针对 `~/Library`、`~/Downloads`、`~/Documents` 分别下探并展示Top N目录
40
+ - 🗄️ **大文件分析** - 扫描并列出指定路径下最大的文件，支持数量和最小体积阈值
41
+ - ⏱️ **支持MCP调用** - 支持你自己的AI Agent无缝调用磁盘空间信息
42
42
 
43
43
  ## 安装
44
44
 
@@ -51,10 +51,16 @@ python3 -m pip install --upgrade myspace-cli
51
51
  pip install myspace-cli
52
52
 
53
53
  # 安装完成后直接使用
54
- space-cli --help
54
+ # 请注意命令行的启动文件名(space-cli)和pip包的名字(myspace-cli)不一样
55
+ # 建议直接运行，可以看到使用菜单
56
+ space-cli
55
57
 
56
58
  # 或以模块方式
57
- python3 -m space_cli --help
59
+ python3 -m space_cli
60
+
61
+ # 如果要使用高级的功能，请使用更复杂的命令行参数，可以运行help
62
+ space-cli --help
63
+
58
64
  ```
59
65
 
60
66
  ### 方法2：直接使用
@@ -89,7 +95,7 @@ space-cli
89
95
  ### 基本用法
90
96
 
91
97
  ```bash
92
- # 分析根目录（默认）
98
+ # 分析根目录（默认）- 支持交互式下探分析
93
99
  python3 space_cli.py
94
100
 
95
101
  # 分析指定路径
@@ -100,6 +106,9 @@ python3 space_cli.py -n 10
100
106
 
101
107
  # 快捷分析当前用户目录（含用户目录深度分析）
102
108
  python3 space_cli.py --home
109
+
110
+ # 交互式目录空间分析（支持选择序号下探，选择0返回上一级）
111
+ python3 space_cli.py --directories-only
103
112
  ```
104
113
 
105
114
  ### 高级用法
@@ -182,21 +191,30 @@ python3 space_cli.py --big-files --export report.json
182
191
  建议: 磁盘空间不足，建议清理一些文件
183
192
  ```
184
193
 
185
- ### 目录分析
194
+ ### 交互式目录分析
186
195
  ```
187
196
  ============================================================
188
197
  📊 占用空间最大的目录
189
198
  ============================================================
190
199
  显示前 20 个最大的目录:
191
200
 
192
- 1. /Applications
193
- 大小: 15.2 GB (3.04%)
201
+ 1. /Applications -- 大小: 15.2 GB (3.04%)
202
+ 2. /Users/username/Library -- 大小: 8.5 GB (1.70%)
203
+ 3. /System -- 大小: 6.8 GB (1.36%)
194
204
 
195
- 2. /Users/username/Library
196
- 大小: 8.5 GB (1.70%)
205
+ ============================================================
206
+ 🔍 下探分析选项
207
+ ============================================================
208
+ 选择序号进行深度分析，选择0返回上一级，直接回车退出:
209
+ 请输入选择 [回车=退出]: 1
197
210
 
198
- 3. /System
199
- 大小: 6.8 GB (1.36%)
211
+ 🔍 正在分析: /Applications (15.2 GB)
212
+ ============================================================
213
+ 📊 占用空间最大的目录
214
+ ============================================================
215
+ 1. /Applications/Xcode.app -- 大小: 8.2 GB (1.64%)
216
+ 2. /Applications/Docker.app -- 大小: 3.1 GB (0.62%)
217
+ 3. /Applications/Visual Studio Code.app -- 大小: 1.8 GB (0.36%)
200
218
  ```
201
219
 
202
220
  ### 大文件分析
@@ -257,12 +275,13 @@ python3 mcp_server.py
257
275
 
258
276
  ## 性能优化
259
277
 
260
- - 使用递归算法高效计算目录大小
261
- - 跳过无法访问的系统文件和隐藏文件
262
- - 支持中断操作（Ctrl+C）
263
- - 内存优化的文件遍历
264
- - 单行滚动进度避免输出刷屏
265
- - 进度刷新使用 ANSI 清行（\r\033[K），避免长行残留
278
+ - **优先使用 `du -sk` 命令**：在 macOS 上使用原生 `du` 命令快速获取目录大小
279
+ - **智能回退机制**：当 `du` 命令失败时，自动回退到基于 `os.scandir` 的高效遍历
280
+ - **跳过系统目录**：自动忽略 `/System`、`/Volumes`、`/private` 等系统目录
281
+ - **跳过无法访问的文件**：自动处理权限错误和符号链接
282
+ - **支持中断操作**：使用 Ctrl+C 随时中断分析
283
+ - **内存优化遍历**：使用栈式迭代替代递归，避免深度目录的栈溢出
284
+ - **单行滚动进度**：避免输出刷屏，使用 ANSI 清行（\r\033[K）避免长行残留
266
285
 
267
286
  ## 故障排除
268
287
 
@@ -321,7 +340,14 @@ MIT License
321
340
  - 单行滚动进度显示
322
341
 
323
342
  ### v1.2.0
324
- - 应用分析支持“按序号一键删除应用”，并显示将删除的路径清单与预计释放空间
343
+ - 应用分析支持"按序号一键删除应用"，并显示将删除的路径清单与预计释放空间
325
344
  - 删除过程增加权限修复与降级清理策略（chflags nouchg / chmod 0777 / 逐项清理）
326
345
  - 针对 "Operation not permitted" 增加友好提示（SIP、完全磁盘访问、退出相关应用）
327
346
  - 单行覆盖输出加入 ANSI 清行，避免长行残留
347
+
348
+ ### v1.3.0
349
+ - **性能大幅优化**：优先使用 `du -sk` 命令获取目录大小，失败时回退到 `os.scandir` 高效遍历
350
+ - **交互式下探分析**：支持选择序号进行深度目录分析，选择0返回上一级
351
+ - **增强系统信息**：显示 CPU、内存、GPU、硬盘等完整硬件信息
352
+ - **智能目录过滤**：自动忽略系统目录（`/System`、`/Volumes`、`/private`）
353
+ - **优化用户体验**：改进菜单选项，支持交互式目录空间分析
{myspace_cli-1.3.0 → myspace_cli-1.5.0}/README.md RENAMED
@@ -1,25 +1,25 @@
1
- # space-cli - Mac OS 磁盘空间分析工具
1
+ # space-cli - macOS 磁盘空间优化工具
2
2
 
3
3
  很多人的Mac电脑都会出现磁盘空间不够用，付费软件太贵或者难以使用。
4
4
 
5
- space-cli是一个开源的Mac OS命令行小工具，用于分析磁盘空间健康度并找出占用空间最大的目录。
5
+ space-cli是一个开源的macOS命令行小工具，用于分析磁盘空间健康度并找出占用空间大的目录，可选择针对单个应用进行一键清理。
6
6
 
7
7
  本软件采用**最严安全原则**，所有分析操作采用只读模式，未经允许不会尝试改写和破坏用户电脑的任何数据，也不会上传任何数据到外网，严格保护用户的隐私。
8
8
 
9
9
  ## 功能特性
10
10
 
11
11
  - 🔍 **磁盘健康度检测** - 评估磁盘空间使用情况，提供健康状态建议
12
- - 📊 **目录大小分析** - 递归分析目录大小，找出占用空间最大的文件夹
13
- - 💻 **系统信息显示** - 显示Mac系统版本和基本信息
12
+ - 📊 **交互式目录分析** - 递归分析目录大小，支持选择序号进行深度下探分析
13
+ - 💻 **详细系统信息** - 显示CPU、内存、GPU、硬盘等完整硬件信息
14
14
  - 📄 **报告导出** - 将分析结果导出为JSON格式报告
15
- - ⚡ **高性能** - 优化的算法，快速分析大型文件系统
15
+ - ⚡ **高性能优化** - 优先使用 `du -sk` 命令，失败时回退到 `os.scandir` 高效遍历
16
16
  - 🎯 **灵活配置** - 支持自定义分析路径和显示数量
17
- - 🗂️ **索引缓存** - 目录大小结果本地索引缓存（`~/.spacecli/index.json`），支持TTL与重建提示
17
+ - 🗂️ **智能索引缓存** - 目录大小结果本地索引缓存（`~/.spacecli/index.json`），支持TTL与重建提示
18
18
  - 🧩 **应用分析** - 汇总 `Applications`、`Library`、`Caches`、`Logs` 等路径估算应用占用，给出卸载建议
19
19
  - 🗑️ **一键删除应用** - 在应用分析列表中输入序号即可一键删除所选应用及其缓存（含二次确认）
20
- - 🏠 **用户目录深度分析** - 针对 `~/Library`、`~/Downloads`、`~/Documents` 分别下探并展示Top N目录
21
- - 🗄️ **大文件分析** - 扫描并列出指定路径下最大的文件，支持数量和最小体积阈值
22
- - ⏱️ **支持MCP调用** - 支持你自己的AI Agent无缝调用磁盘空间信息
20
+ - 🏠 **用户目录深度分析** - 针对 `~/Library`、`~/Downloads`、`~/Documents` 分别下探并展示Top N目录
21
+ - 🗄️ **大文件分析** - 扫描并列出指定路径下最大的文件，支持数量和最小体积阈值
22
+ - ⏱️ **支持MCP调用** - 支持你自己的AI Agent无缝调用磁盘空间信息
23
23
 
24
24
  ## 安装
25
25
 
@@ -32,10 +32,16 @@ python3 -m pip install --upgrade myspace-cli
32
32
  pip install myspace-cli
33
33
 
34
34
  # 安装完成后直接使用
35
- space-cli --help
35
+ # 请注意命令行的启动文件名(space-cli)和pip包的名字(myspace-cli)不一样
36
+ # 建议直接运行，可以看到使用菜单
37
+ space-cli
36
38
 
37
39
  # 或以模块方式
38
- python3 -m space_cli --help
40
+ python3 -m space_cli
41
+
42
+ # 如果要使用高级的功能，请使用更复杂的命令行参数，可以运行help
43
+ space-cli --help
44
+
39
45
  ```
40
46
 
41
47
  ### 方法2：直接使用
@@ -70,7 +76,7 @@ space-cli
70
76
  ### 基本用法
71
77
 
72
78
  ```bash
73
- # 分析根目录（默认）
79
+ # 分析根目录（默认）- 支持交互式下探分析
74
80
  python3 space_cli.py
75
81
 
76
82
  # 分析指定路径
@@ -81,6 +87,9 @@ python3 space_cli.py -n 10
81
87
 
82
88
  # 快捷分析当前用户目录（含用户目录深度分析）
83
89
  python3 space_cli.py --home
90
+
91
+ # 交互式目录空间分析（支持选择序号下探，选择0返回上一级）
92
+ python3 space_cli.py --directories-only
84
93
  ```
85
94
 
86
95
  ### 高级用法
@@ -163,21 +172,30 @@ python3 space_cli.py --big-files --export report.json
163
172
  建议: 磁盘空间不足，建议清理一些文件
164
173
  ```
165
174
 
166
- ### 目录分析
175
+ ### 交互式目录分析
167
176
  ```
168
177
  ============================================================
169
178
  📊 占用空间最大的目录
170
179
  ============================================================
171
180
  显示前 20 个最大的目录:
172
181
 
173
- 1. /Applications
174
- 大小: 15.2 GB (3.04%)
182
+ 1. /Applications -- 大小: 15.2 GB (3.04%)
183
+ 2. /Users/username/Library -- 大小: 8.5 GB (1.70%)
184
+ 3. /System -- 大小: 6.8 GB (1.36%)
175
185
 
176
- 2. /Users/username/Library
177
- 大小: 8.5 GB (1.70%)
186
+ ============================================================
187
+ 🔍 下探分析选项
188
+ ============================================================
189
+ 选择序号进行深度分析，选择0返回上一级，直接回车退出:
190
+ 请输入选择 [回车=退出]: 1
178
191
 
179
- 3. /System
180
- 大小: 6.8 GB (1.36%)
192
+ 🔍 正在分析: /Applications (15.2 GB)
193
+ ============================================================
194
+ 📊 占用空间最大的目录
195
+ ============================================================
196
+ 1. /Applications/Xcode.app -- 大小: 8.2 GB (1.64%)
197
+ 2. /Applications/Docker.app -- 大小: 3.1 GB (0.62%)
198
+ 3. /Applications/Visual Studio Code.app -- 大小: 1.8 GB (0.36%)
181
199
  ```
182
200
 
183
201
  ### 大文件分析
@@ -238,12 +256,13 @@ python3 mcp_server.py
238
256
 
239
257
  ## 性能优化
240
258
 
241
- - 使用递归算法高效计算目录大小
242
- - 跳过无法访问的系统文件和隐藏文件
243
- - 支持中断操作（Ctrl+C）
244
- - 内存优化的文件遍历
245
- - 单行滚动进度避免输出刷屏
246
- - 进度刷新使用 ANSI 清行（\r\033[K），避免长行残留
259
+ - **优先使用 `du -sk` 命令**：在 macOS 上使用原生 `du` 命令快速获取目录大小
260
+ - **智能回退机制**：当 `du` 命令失败时，自动回退到基于 `os.scandir` 的高效遍历
261
+ - **跳过系统目录**：自动忽略 `/System`、`/Volumes`、`/private` 等系统目录
262
+ - **跳过无法访问的文件**：自动处理权限错误和符号链接
263
+ - **支持中断操作**：使用 Ctrl+C 随时中断分析
264
+ - **内存优化遍历**：使用栈式迭代替代递归，避免深度目录的栈溢出
265
+ - **单行滚动进度**：避免输出刷屏，使用 ANSI 清行（\r\033[K）避免长行残留
247
266
 
248
267
  ## 故障排除
249
268
 
@@ -302,7 +321,14 @@ MIT License
302
321
  - 单行滚动进度显示
303
322
 
304
323
  ### v1.2.0
305
- - 应用分析支持“按序号一键删除应用”，并显示将删除的路径清单与预计释放空间
324
+ - 应用分析支持"按序号一键删除应用"，并显示将删除的路径清单与预计释放空间
306
325
  - 删除过程增加权限修复与降级清理策略（chflags nouchg / chmod 0777 / 逐项清理）
307
326
  - 针对 "Operation not permitted" 增加友好提示（SIP、完全磁盘访问、退出相关应用）
308
327
  - 单行覆盖输出加入 ANSI 清行，避免长行残留
328
+
329
+ ### v1.3.0
330
+ - **性能大幅优化**：优先使用 `du -sk` 命令获取目录大小，失败时回退到 `os.scandir` 高效遍历
331
+ - **交互式下探分析**：支持选择序号进行深度目录分析，选择0返回上一级
332
+ - **增强系统信息**：显示 CPU、内存、GPU、硬盘等完整硬件信息
333
+ - **智能目录过滤**：自动忽略系统目录（`/System`、`/Volumes`、`/private`）
334
+ - **优化用户体验**：改进菜单选项，支持交互式目录空间分析
{myspace_cli-1.3.0 → myspace_cli-1.5.0}/myspace_cli.egg-info/PKG-INFO RENAMED
@@ -1,6 +1,6 @@
1
1
  Metadata-Version: 2.4
2
2
  Name: myspace-cli
3
- Version: 1.3.0
3
+ Version: 1.5.0
4
4
  Summary: A macOS disk space analysis CLI: health, index, app usage, big files.
5
5
  Author-email: Your Name <you@example.com>
6
6
  License: MIT
@@ -17,28 +17,28 @@ Description-Content-Type: text/markdown
17
17
  Provides-Extra: mcp
18
18
  Requires-Dist: mcp<2,>=1; extra == "mcp"
19
19
 
20
- # space-cli - Mac OS 磁盘空间分析工具
20
+ # space-cli - macOS 磁盘空间优化工具
21
21
 
22
22
  很多人的Mac电脑都会出现磁盘空间不够用，付费软件太贵或者难以使用。
23
23
 
24
- space-cli是一个开源的Mac OS命令行小工具，用于分析磁盘空间健康度并找出占用空间最大的目录。
24
+ space-cli是一个开源的macOS命令行小工具，用于分析磁盘空间健康度并找出占用空间大的目录，可选择针对单个应用进行一键清理。
25
25
 
26
26
  本软件采用**最严安全原则**，所有分析操作采用只读模式，未经允许不会尝试改写和破坏用户电脑的任何数据，也不会上传任何数据到外网，严格保护用户的隐私。
27
27
 
28
28
  ## 功能特性
29
29
 
30
30
  - 🔍 **磁盘健康度检测** - 评估磁盘空间使用情况，提供健康状态建议
31
- - 📊 **目录大小分析** - 递归分析目录大小，找出占用空间最大的文件夹
32
- - 💻 **系统信息显示** - 显示Mac系统版本和基本信息
31
+ - 📊 **交互式目录分析** - 递归分析目录大小，支持选择序号进行深度下探分析
32
+ - 💻 **详细系统信息** - 显示CPU、内存、GPU、硬盘等完整硬件信息
33
33
  - 📄 **报告导出** - 将分析结果导出为JSON格式报告
34
- - ⚡ **高性能** - 优化的算法，快速分析大型文件系统
34
+ - ⚡ **高性能优化** - 优先使用 `du -sk` 命令，失败时回退到 `os.scandir` 高效遍历
35
35
  - 🎯 **灵活配置** - 支持自定义分析路径和显示数量
36
- - 🗂️ **索引缓存** - 目录大小结果本地索引缓存（`~/.spacecli/index.json`），支持TTL与重建提示
36
+ - 🗂️ **智能索引缓存** - 目录大小结果本地索引缓存（`~/.spacecli/index.json`），支持TTL与重建提示
37
37
  - 🧩 **应用分析** - 汇总 `Applications`、`Library`、`Caches`、`Logs` 等路径估算应用占用，给出卸载建议
38
38
  - 🗑️ **一键删除应用** - 在应用分析列表中输入序号即可一键删除所选应用及其缓存（含二次确认）
39
- - 🏠 **用户目录深度分析** - 针对 `~/Library`、`~/Downloads`、`~/Documents` 分别下探并展示Top N目录
40
- - 🗄️ **大文件分析** - 扫描并列出指定路径下最大的文件，支持数量和最小体积阈值
41
- - ⏱️ **支持MCP调用** - 支持你自己的AI Agent无缝调用磁盘空间信息
39
+ - 🏠 **用户目录深度分析** - 针对 `~/Library`、`~/Downloads`、`~/Documents` 分别下探并展示Top N目录
40
+ - 🗄️ **大文件分析** - 扫描并列出指定路径下最大的文件，支持数量和最小体积阈值
41
+ - ⏱️ **支持MCP调用** - 支持你自己的AI Agent无缝调用磁盘空间信息
42
42
 
43
43
  ## 安装
44
44
 
@@ -51,10 +51,16 @@ python3 -m pip install --upgrade myspace-cli
51
51
  pip install myspace-cli
52
52
 
53
53
  # 安装完成后直接使用
54
- space-cli --help
54
+ # 请注意命令行的启动文件名(space-cli)和pip包的名字(myspace-cli)不一样
55
+ # 建议直接运行，可以看到使用菜单
56
+ space-cli
55
57
 
56
58
  # 或以模块方式
57
- python3 -m space_cli --help
59
+ python3 -m space_cli
60
+
61
+ # 如果要使用高级的功能，请使用更复杂的命令行参数，可以运行help
62
+ space-cli --help
63
+
58
64
  ```
59
65
 
60
66
  ### 方法2：直接使用
@@ -89,7 +95,7 @@ space-cli
89
95
  ### 基本用法
90
96
 
91
97
  ```bash
92
- # 分析根目录（默认）
98
+ # 分析根目录（默认）- 支持交互式下探分析
93
99
  python3 space_cli.py
94
100
 
95
101
  # 分析指定路径
@@ -100,6 +106,9 @@ python3 space_cli.py -n 10
100
106
 
101
107
  # 快捷分析当前用户目录（含用户目录深度分析）
102
108
  python3 space_cli.py --home
109
+
110
+ # 交互式目录空间分析（支持选择序号下探，选择0返回上一级）
111
+ python3 space_cli.py --directories-only
103
112
  ```
104
113
 
105
114
  ### 高级用法
@@ -182,21 +191,30 @@ python3 space_cli.py --big-files --export report.json
182
191
  建议: 磁盘空间不足，建议清理一些文件
183
192
  ```
184
193
 
185
- ### 目录分析
194
+ ### 交互式目录分析
186
195
  ```
187
196
  ============================================================
188
197
  📊 占用空间最大的目录
189
198
  ============================================================
190
199
  显示前 20 个最大的目录:
191
200
 
192
- 1. /Applications
193
- 大小: 15.2 GB (3.04%)
201
+ 1. /Applications -- 大小: 15.2 GB (3.04%)
202
+ 2. /Users/username/Library -- 大小: 8.5 GB (1.70%)
203
+ 3. /System -- 大小: 6.8 GB (1.36%)
194
204
 
195
- 2. /Users/username/Library
196
- 大小: 8.5 GB (1.70%)
205
+ ============================================================
206
+ 🔍 下探分析选项
207
+ ============================================================
208
+ 选择序号进行深度分析，选择0返回上一级，直接回车退出:
209
+ 请输入选择 [回车=退出]: 1
197
210
 
198
- 3. /System
199
- 大小: 6.8 GB (1.36%)
211
+ 🔍 正在分析: /Applications (15.2 GB)
212
+ ============================================================
213
+ 📊 占用空间最大的目录
214
+ ============================================================
215
+ 1. /Applications/Xcode.app -- 大小: 8.2 GB (1.64%)
216
+ 2. /Applications/Docker.app -- 大小: 3.1 GB (0.62%)
217
+ 3. /Applications/Visual Studio Code.app -- 大小: 1.8 GB (0.36%)
200
218
  ```
201
219
 
202
220
  ### 大文件分析
@@ -257,12 +275,13 @@ python3 mcp_server.py
257
275
 
258
276
  ## 性能优化
259
277
 
260
- - 使用递归算法高效计算目录大小
261
- - 跳过无法访问的系统文件和隐藏文件
262
- - 支持中断操作（Ctrl+C）
263
- - 内存优化的文件遍历
264
- - 单行滚动进度避免输出刷屏
265
- - 进度刷新使用 ANSI 清行（\r\033[K），避免长行残留
278
+ - **优先使用 `du -sk` 命令**：在 macOS 上使用原生 `du` 命令快速获取目录大小
279
+ - **智能回退机制**：当 `du` 命令失败时，自动回退到基于 `os.scandir` 的高效遍历
280
+ - **跳过系统目录**：自动忽略 `/System`、`/Volumes`、`/private` 等系统目录
281
+ - **跳过无法访问的文件**：自动处理权限错误和符号链接
282
+ - **支持中断操作**：使用 Ctrl+C 随时中断分析
283
+ - **内存优化遍历**：使用栈式迭代替代递归，避免深度目录的栈溢出
284
+ - **单行滚动进度**：避免输出刷屏，使用 ANSI 清行（\r\033[K）避免长行残留
266
285
 
267
286
  ## 故障排除
268
287
 
@@ -321,7 +340,14 @@ MIT License
321
340
  - 单行滚动进度显示
322
341
 
323
342
  ### v1.2.0
324
- - 应用分析支持“按序号一键删除应用”，并显示将删除的路径清单与预计释放空间
343
+ - 应用分析支持"按序号一键删除应用"，并显示将删除的路径清单与预计释放空间
325
344
  - 删除过程增加权限修复与降级清理策略（chflags nouchg / chmod 0777 / 逐项清理）
326
345
  - 针对 "Operation not permitted" 增加友好提示（SIP、完全磁盘访问、退出相关应用）
327
346
  - 单行覆盖输出加入 ANSI 清行，避免长行残留
347
+
348
+ ### v1.3.0
349
+ - **性能大幅优化**：优先使用 `du -sk` 命令获取目录大小，失败时回退到 `os.scandir` 高效遍历
350
+ - **交互式下探分析**：支持选择序号进行深度目录分析，选择0返回上一级
351
+ - **增强系统信息**：显示 CPU、内存、GPU、硬盘等完整硬件信息
352
+ - **智能目录过滤**：自动忽略系统目录（`/System`、`/Volumes`、`/private`）
353
+ - **优化用户体验**：改进菜单选项，支持交互式目录空间分析
{myspace_cli-1.3.0 → myspace_cli-1.5.0}/pyproject.toml RENAMED
@@ -4,7 +4,7 @@ build-backend = "setuptools.build_meta"
4
4
 
5
5
  [project]
6
6
  name = "myspace-cli"
7
- version = "1.3.0"
7
+ version = "1.5.0"
8
8
  description = "A macOS disk space analysis CLI: health, index, app usage, big files."
9
9
  readme = "README.md"
10
10
  requires-python = ">=3.8"