myspace-cli 1.3.0__py3-none-any.whl → 1.4.0__py3-none-any.whl

{myspace_cli-1.3.0.dist-info → myspace_cli-1.4.0.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: myspace-cli
-Version: 1.3.0
+Version: 1.4.0
 Summary: A macOS disk space analysis CLI: health, index, app usage, big files.
 Author-email: Your Name <you@example.com>
 License: MIT
@@ -17,28 +17,29 @@ Description-Content-Type: text/markdown
 Provides-Extra: mcp
 Requires-Dist: mcp<2,>=1; extra == "mcp"
 
-# space-cli - Mac OS 磁盘空间分析工具
+# space-cli - macOS 磁盘空间优化工具
 
 很多人的Mac电脑都会出现磁盘空间不够用，付费软件太贵或者难以使用。
 
-space-cli是一个开源的Mac OS命令行小工具，用于分析磁盘空间健康度并找出占用空间最大的目录。
+space-cli是一个开源的macOS命令行小工具，用于分析磁盘空间健康度并找出占用空间大的目录，可选择针对单个应用进行一键清理。
 
 本软件采用**最严安全原则**，所有分析操作采用只读模式，未经允许不会尝试改写和破坏用户电脑的任何数据，也不会上传任何数据到外网，严格保护用户的隐私。
 
 ## 功能特性
 
 - 🔍 **磁盘健康度检测** - 评估磁盘空间使用情况，提供健康状态建议
-- 📊 **目录大小分析** - 递归分析目录大小，找出占用空间最大的文件夹
-- 💻 **系统信息显示** - 显示Mac系统版本和基本信息
+- 📊 **交互式目录分析** - 递归分析目录大小，支持选择序号进行深度下探分析
+- 💻 **详细系统信息** - 显示CPU、内存、GPU、硬盘等完整硬件信息
 - 📄 **报告导出** - 将分析结果导出为JSON格式报告
-- ⚡ **高性能** - 优化的算法，快速分析大型文件系统
+- ⚡ **高性能优化** - 优先使用 `du -sk` 命令，失败时回退到 `os.scandir` 高效遍历
 - 🎯 **灵活配置** - 支持自定义分析路径和显示数量
-- 🗂️ **索引缓存** - 目录大小结果本地索引缓存（`~/.spacecli/index.json`），支持TTL与重建提示
+- 🗂️ **智能索引缓存** - 目录大小结果本地索引缓存（`~/.spacecli/index.json`），支持TTL与重建提示
 - 🧩 **应用分析** - 汇总 `Applications`、`Library`、`Caches`、`Logs` 等路径估算应用占用，给出卸载建议
 - 🗑️ **一键删除应用** - 在应用分析列表中输入序号即可一键删除所选应用及其缓存（含二次确认）
- - 🏠 **用户目录深度分析** - 针对 `~/Library`、`~/Downloads`、`~/Documents` 分别下探并展示Top N目录
- - 🗄️ **大文件分析** - 扫描并列出指定路径下最大的文件，支持数量和最小体积阈值
- - ⏱️ **支持MCP调用** - 支持你自己的AI Agent无缝调用磁盘空间信息
+- 🏠 **用户目录深度分析** - 针对 `~/Library`、`~/Downloads`、`~/Documents` 分别下探并展示Top N目录
+- 🗄️ **大文件分析** - 扫描并列出指定路径下最大的文件，支持数量和最小体积阈值
+- 🔄 **返回上一级** - 在下探分析中支持选择0返回上一级目录
+- ⏱️ **支持MCP调用** - 支持你自己的AI Agent无缝调用磁盘空间信息
 
 ## 安装
 
@@ -51,10 +52,16 @@ python3 -m pip install --upgrade myspace-cli
 pip install myspace-cli
 
 # 安装完成后直接使用
-space-cli --help
+# 请注意命令行的启动文件名(space-cli)和pip包的名字(myspace-cli)不一样
+# 建议直接运行，可以看到使用菜单
+space-cli
 
 # 或以模块方式
-python3 -m space_cli --help
+python3 -m space_cli
+
+# 如果要使用高级的功能，请使用更复杂的命令行参数，可以运行help
+space-cli --help
+
 ```
 
 ### 方法2：直接使用
@@ -89,7 +96,7 @@ space-cli
 ### 基本用法
 
 ```bash
-# 分析根目录（默认）
+# 分析根目录（默认）- 支持交互式下探分析
 python3 space_cli.py
 
 # 分析指定路径
@@ -100,6 +107,9 @@ python3 space_cli.py -n 10
 
 # 快捷分析当前用户目录（含用户目录深度分析）
 python3 space_cli.py --home
+
+# 交互式目录空间分析（支持选择序号下探，选择0返回上一级）
+python3 space_cli.py --directories-only
 ```
 
 ### 高级用法
@@ -182,21 +192,30 @@ python3 space_cli.py --big-files --export report.json
 建议: 磁盘空间不足，建议清理一些文件
 ```
 
-### 目录分析
+### 交互式目录分析
 ```
 ============================================================
 📊 占用空间最大的目录
 ============================================================
 显示前 20 个最大的目录:
 
- 1. /Applications
-    大小: 15.2 GB (3.04%)
+ 1. /Applications --    大小: 15.2 GB (3.04%)
+ 2. /Users/username/Library --    大小: 8.5 GB (1.70%)
+ 3. /System --    大小: 6.8 GB (1.36%)
 
- 2. /Users/username/Library
-    大小: 8.5 GB (1.70%)
+============================================================
+🔍 下探分析选项
+============================================================
+选择序号进行深度分析，选择0返回上一级，直接回车退出:
+请输入选择 [回车=退出]: 1
 
- 3. /System
-    大小: 6.8 GB (1.36%)
+🔍 正在分析: /Applications (15.2 GB)
+============================================================
+📊 占用空间最大的目录
+============================================================
+ 1. /Applications/Xcode.app --    大小: 8.2 GB (1.64%)
+ 2. /Applications/Docker.app --    大小: 3.1 GB (0.62%)
+ 3. /Applications/Visual Studio Code.app --    大小: 1.8 GB (0.36%)
 ```
 
 ### 大文件分析
@@ -257,12 +276,13 @@ python3 mcp_server.py
 
 ## 性能优化
 
-- 使用递归算法高效计算目录大小
-- 跳过无法访问的系统文件和隐藏文件
-- 支持中断操作（Ctrl+C）
-- 内存优化的文件遍历
- - 单行滚动进度避免输出刷屏
- - 进度刷新使用 ANSI 清行（\r\033[K），避免长行残留
+- **优先使用 `du -sk` 命令**：在 macOS 上使用原生 `du` 命令快速获取目录大小
+- **智能回退机制**：当 `du` 命令失败时，自动回退到基于 `os.scandir` 的高效遍历
+- **跳过系统目录**：自动忽略 `/System`、`/Volumes`、`/private` 等系统目录
+- **跳过无法访问的文件**：自动处理权限错误和符号链接
+- **支持中断操作**：使用 Ctrl+C 随时中断分析
+- **内存优化遍历**：使用栈式迭代替代递归，避免深度目录的栈溢出
+- **单行滚动进度**：避免输出刷屏，使用 ANSI 清行（\r\033[K）避免长行残留
 
 ## 故障排除
 
@@ -321,7 +341,14 @@ MIT License
 - 单行滚动进度显示
 
 ### v1.2.0
-- 应用分析支持“按序号一键删除应用”，并显示将删除的路径清单与预计释放空间
+- 应用分析支持"按序号一键删除应用"，并显示将删除的路径清单与预计释放空间
 - 删除过程增加权限修复与降级清理策略（chflags nouchg / chmod 0777 / 逐项清理）
 - 针对 "Operation not permitted" 增加友好提示（SIP、完全磁盘访问、退出相关应用）
 - 单行覆盖输出加入 ANSI 清行，避免长行残留
+
+### v1.3.0
+- **性能大幅优化**：优先使用 `du -sk` 命令获取目录大小，失败时回退到 `os.scandir` 高效遍历
+- **交互式下探分析**：支持选择序号进行深度目录分析，选择0返回上一级
+- **增强系统信息**：显示 CPU、内存、GPU、硬盘等完整硬件信息
+- **智能目录过滤**：自动忽略系统目录（`/System`、`/Volumes`、`/private`）
+- **优化用户体验**：改进菜单选项，支持交互式目录空间分析

myspace_cli-1.4.0.dist-info/RECORD

@@ -0,0 +1,6 @@
+space_cli.py,sha256=qEEhU_3nuiG--fWGbUDdQytrL9mL1CZTKGTMFpCyBNk,48380
+myspace_cli-1.4.0.dist-info/METADATA,sha256=DDp6iHPcaGr_nCmJg5GHqeVhfqY-2fpzuJQ-4izUlVg,12747
+myspace_cli-1.4.0.dist-info/WHEEL,sha256=_zCd3N1l69ArxyTb8rzEoP9TpbYXkqRFSNOD5OuxnTs,91
+myspace_cli-1.4.0.dist-info/entry_points.txt,sha256=sIVEmPf6W8aNa7KiqOwAI6JrsgHlQciO5xH2G29tKPQ,45
+myspace_cli-1.4.0.dist-info/top_level.txt,sha256=lnUfbQX9h-9ZjecMVCOWucS2kx69FwTndlrb48S20Sc,10
+myspace_cli-1.4.0.dist-info/RECORD,,

space_cli.py

@@ -154,20 +154,48 @@ class SpaceAnalyzer:
         return f"{bytes_value:.1f} PB"
     
     def get_directory_size(self, path: str) -> int:
-        """递归计算目录大小"""
-        total_size = 0
+        """高性能计算目录大小。
+
+        优先使用 macOS 的 du -sk（以 KiB 为单位，速度快，原生命令可处理边界情况），
+        若 du 调用失败则回退到基于 os.scandir 的非递归遍历实现（避免 os.walk 的函数调用开销）。
+        """
+        # 优先尝试 du -sk（BSD du 在 macOS 可用）。
         try:
-            for dirpath, dirnames, filenames in os.walk(path):
-                for filename in filenames:
-                    filepath = os.path.join(dirpath, filename)
-                    try:
-                        total_size += os.path.getsize(filepath)
-                    except (OSError, FileNotFoundError):
-                        # 跳过无法访问的文件
-                        continue
-        except (OSError, PermissionError):
-            # 跳过无法访问的目录
+            # du 输出形如: "<kib>\t<path>\n"
+            result = subprocess.run([
+                'du', '-sk', path
+            ], capture_output=True, text=True, check=True)
+            out = result.stdout.strip().split('\t', 1)[0].strip()
+            kib = int(out)
+            return kib * 1024
+        except Exception:
+            # du 不可用或失败时回退到 Python 实现
             pass
+
+        total_size = 0
+        # 基于栈的迭代遍历，避免递归栈与 os.walk 的额外开销
+        stack = [path]
+        while stack:
+            current = stack.pop()
+            try:
+                with os.scandir(current) as it:
+                    for entry in it:
+                        # 跳过符号链接，避免循环与跨文件系统问题
+                        try:
+                            if entry.is_symlink():
+                                continue
+                            if entry.is_file(follow_symlinks=False):
+                                try:
+                                    total_size += entry.stat(follow_symlinks=False).st_size
+                                except (OSError, FileNotFoundError, PermissionError):
+                                    continue
+                            elif entry.is_dir(follow_symlinks=False):
+                                stack.append(entry.path)
+                        except (OSError, FileNotFoundError, PermissionError):
+                            continue
+            except (OSError, FileNotFoundError, PermissionError):
+                # 无法进入该目录则跳过
+                continue
         return total_size
 
     def analyze_largest_files(self, root_path: str = "/", top_n: int = 50,
@@ -241,6 +269,14 @@ class SpaceAnalyzer:
                     return [(e["path"], int(e["size"])) for e in cached["entries"]][:top_n]
 
         print("正在分析目录大小，这可能需要一些时间...")
+
+        # 忽略的目录列表, 这些目录时系统目录，不需要分析
+        ignore_dir_list = [
+            "/System",  # 系统目录
+            "/Volumes", # 外部挂载卷
+            "/private", # 私有目录
+        ]
+
         
         directory_sizes = []
         
@@ -252,6 +288,9 @@ class SpaceAnalyzer:
                 # 跳过隐藏文件和系统文件
                 if item.startswith('.') and item not in ['.Trash', '.localized']:
                     continue
+
+                if item_path in ignore_dir_list:
+                    continue
                 
                 if os.path.isdir(item_path):
                     try:
@@ -284,19 +323,58 @@ class SpaceAnalyzer:
             return []
     
     def get_system_info(self) -> Dict:
-        """获取系统信息"""
+        """获取系统信息（包括 CPU、内存、GPU、硬盘等硬件信息）"""
+        system_info = {}
+        
         try:
-            # 获取系统版本
+            # 获取系统版本信息
             result = subprocess.run(['sw_vers'], capture_output=True, text=True)
-            system_info = {}
             for line in result.stdout.split('\n'):
                 if ':' in line:
                     key, value = line.split(':', 1)
                     system_info[key.strip()] = value.strip()
+        except Exception:
+            system_info["ProductName"] = "macOS"
+            system_info["ProductVersion"] = "未知"
+        
+        try:
+            # 获取 CPU 信息
+            cpu_result = subprocess.run(['sysctl', '-n', 'machdep.cpu.brand_string'], 
+                                     capture_output=True, text=True)
+            if cpu_result.returncode == 0:
+                system_info["CPU"] = cpu_result.stdout.strip()
             
-            return system_info
+            # 获取 CPU 核心数
+            cores_result = subprocess.run(['sysctl', '-n', 'hw.ncpu'], 
+                                        capture_output=True, text=True)
+            if cores_result.returncode == 0:
+                system_info["CPU核心数"] = cores_result.stdout.strip()
+                
+        except Exception:
+            system_info["CPU"] = "未知"
+            system_info["CPU核心数"] = "未知"
+        
+        try:
+            # 获取内存信息
+            mem_result = subprocess.run(['sysctl', '-n', 'hw.memsize'], 
+                                     capture_output=True, text=True)
+            if mem_result.returncode == 0:
+                mem_bytes = int(mem_result.stdout.strip())
+                system_info["内存"] = self.format_bytes(mem_bytes)
         except Exception:
-            return {"ProductName": "macOS", "ProductVersion": "未知"}
+            system_info["内存"] = "未知"
+                
+        
+        try:
+            # 获取启动时间
+            boot_result = subprocess.run(['uptime'], capture_output=True, text=True)
+            if boot_result.returncode == 0:
+                uptime_line = boot_result.stdout.strip()
+                system_info["运行时间"] = uptime_line
+        except Exception:
+            system_info["运行时间"] = "未知"
+        
+        return system_info
 
 
 class SpaceCli:
@@ -614,12 +692,12 @@ class SpaceCli:
         print(f"建议: \033[36m{message}\033[0m")
         print()
     
-    def print_largest_directories(self, path: str = "/", top_n: int = 20):
+    def print_largest_directories(self, path: str = "/Library", top_n: int = 20):
         """打印占用空间最大的目录"""
         print("=" * 60)
         print("📊 占用空间最大的目录")
         print("=" * 60)
-
+        
         # 若有缓存：直接显示缓存，然后再询问是否重新分析
         if self.args.use_index:
             cached = self.index.get(path)
@@ -635,6 +713,8 @@ class SpaceCli:
                     except EOFError:
                         ans = ""
                     if ans not in ("y", "yes"):
+                        # 提供下探分析选项
+                        self._offer_drill_down_analysis(cached_entries, path)
                         return
                 else:
                     return
@@ -655,6 +735,56 @@ class SpaceCli:
         total_bytes = total_info['total'] if total_info else 1
         print("\n已重新分析，最新结果：\n")
         self._render_dirs(directories, total_bytes)
+        
+        # 提供下探分析选项
+        self._offer_drill_down_analysis(directories, path)
+
+    def _offer_drill_down_analysis(self, directories: List[Tuple[str, int]], current_path: str) -> None:
+        """提供交互式下探分析选项"""
+        if not sys.stdin.isatty() or getattr(self.args, 'no_prompt', False):
+            return
+        
+        print("\n" + "=" * 60)
+        print("🔍 下探分析选项")
+        print("=" * 60)
+        print("选择序号进行深度分析，选择0返回上一级，直接回车退出:")
+        
+        try:
+            choice = input("请输入选择 [回车=退出]: ").strip()
+        except EOFError:
+            return
+        
+        if not choice:
+            return
+        
+        try:
+            idx = int(choice)
+        except ValueError:
+            print("❌ 无效的输入（应为数字序号）")
+            return
+        
+        if idx == 0:
+            # 返回上一级
+            parent_path = os.path.dirname(current_path.rstrip('/'))
+            if parent_path != current_path and parent_path != '/':
+                print(f"\n🔄 返回上一级: {parent_path}")
+                self.print_largest_directories(parent_path, self.args.top_n)
+            else:
+                print("❌ 已在根目录，无法返回上一级")
+            return
+        
+        if idx < 1 or idx > len(directories):
+            print("❌ 序号超出范围")
+            return
+        
+        selected_path, selected_size = directories[idx - 1]
+        size_str = self.analyzer.format_bytes(selected_size)
+        
+        print(f"\n🔍 正在分析: {selected_path} ({size_str})")
+        print("=" * 60)
+        
+        # 递归调用下探分析
+        self.print_largest_directories(selected_path, self.args.top_n)
 
     def print_app_analysis(self, top_n: int = 20):
         """打印应用目录占用分析，并给出卸载建议"""
@@ -765,7 +895,7 @@ class SpaceCli:
         system_info = self.analyzer.get_system_info()
         
         for key, value in system_info.items():
-            print(f"{key}: {value}")
+            print(f"{key}: \033[36m{value}\033[0m")
         print()
     
     def export_report(self, output_file: str, path: str = "/"):
@@ -964,13 +1094,13 @@ def main():
         print("🧭 SpaceCli 菜单（直接回车 = 执行全部项目）")
         print("=" * 60)
         home_path = str(Path.home())
-        print("1) \033[36m执行全部项目（系统信息 + 健康 + 目录 + 应用）\033[0m")
+        print("1) \033[36m执行主要项目（系统信息 + 健康 +  应用）\033[0m")
         print(f"2) \033[36m当前用户目录分析（路径: {home_path}）\033[0m")
         print("3) \033[36m仅显示系统信息\033[0m")
         print("4) \033[36m仅显示磁盘健康状态\033[0m")
-        print("5) \033[36m仅显示最大目录列表\033[0m")
-        print("6) \033[36m仅显示应用目录分析与建议\033[0m")
-        print("7) \033[36m仅显示大文件分析\033[0m")
+        print("5) \033[36m交互式目录空间分析\033[0m")
+        print("6) \033[36m仅分析程序应用目录空间\033[0m")
+        print("7) \033[36m仅进行大文件分析（很耗时，可随时终止）\033[0m")
         print("0) \033[36m退出\033[0m")
         try:
             choice = input("请选择 [回车=1]: ").strip()
@@ -985,27 +1115,34 @@ def main():
             args.health_only = False
             args.directories_only = False
         elif choice == "3": # 仅显示系统信息
-            args.health_only = True
+            args.health_only = False
             args.directories_only = False
             args.apps = False
+            args.big_files = False
         elif choice == "4": # 仅显示磁盘健康状态 
-            args.health_only = False
-            args.directories_only = True
+            args.health_only = True
+            args.directories_only = False
             args.apps = False
+            args.big_files = False
         elif choice == "5": # 仅显示最大目录列表
             args.health_only = False
-            args.directories_only = False
+            args.directories_only = True
             args.apps = False
+            args.big_files = False
         elif choice == "6": # 仅显示应用目录分析与建议
             args.health_only = False
             args.directories_only = False
             args.apps = True
+            args.big_files = False
         elif choice == "7": # 仅显示大文件分析
             args.health_only = False
-            args.directories_only = True
+            args.directories_only = False
             args.apps = False
             args.big_files = True
         else: # 默认执行全部（用户不选择，或者选择1）            
+            args.health_only = True
+            args.directories_only = False
+            args.big_files = False
             args.apps = True            
 
 
@@ -1025,15 +1162,14 @@ def main():
     
     try:
         # 显示系统信息
-        if not args.directories_only:
-            space_cli.print_system_info()
+        space_cli.print_system_info()
         
         # 显示磁盘健康状态
-        if not args.directories_only:
+        if args.health_only:
             space_cli.print_disk_health(args.path)
         
         # 显示目录分析
-        if not args.health_only:
+        if args.directories_only or args.path !='/':
             space_cli.print_largest_directories(args.path, args.top_n)
             # 若分析路径为当前用户目录，做深度分析
             if os.path.abspath(args.path) == os.path.abspath(str(Path.home())):
@@ -1044,7 +1180,8 @@ def main():
             space_cli.print_app_analysis(args.top_n)
 
         # 大文件分析
-        if getattr(args, 'big_files', False):
+        #if getattr(args, 'big_files', False):
+        if args.big_files:
             space_cli.print_big_files(args.path, top_n=args.big_files_top, min_size_bytes=args.big_files_min_bytes)
         
         # 导出报告

myspace_cli-1.3.0.dist-info/RECORD

@@ -1,6 +0,0 @@
-space_cli.py,sha256=ihUdZL8ojzxfK4Z81F-fJ6V-8Tn8AprP1mUAW2zp3iY,42738
-myspace_cli-1.3.0.dist-info/METADATA,sha256=_d8mzS3A3a3XDpgzDCbRbXeE8HX9LdDQEy25g0Tek8k,10674
-myspace_cli-1.3.0.dist-info/WHEEL,sha256=_zCd3N1l69ArxyTb8rzEoP9TpbYXkqRFSNOD5OuxnTs,91
-myspace_cli-1.3.0.dist-info/entry_points.txt,sha256=sIVEmPf6W8aNa7KiqOwAI6JrsgHlQciO5xH2G29tKPQ,45
-myspace_cli-1.3.0.dist-info/top_level.txt,sha256=lnUfbQX9h-9ZjecMVCOWucS2kx69FwTndlrb48S20Sc,10
-myspace_cli-1.3.0.dist-info/RECORD,,