deepclean-mydisk 0.12.1 → 0.13.0

package/README.md

@@ -29,7 +29,8 @@ dsh plugin --profile <name> add link:/绝对路径/deepclean-mydisk-plugin
 ### 平台依赖
 
 - macOS：系统自带 `python3`（扫描器依赖 `du` / `plutil` / `sips`）；
-- Windows：`py -3`（或 `python`），扫描器与照片解码为纯 Python + PowerShell `.NET`，**不需要 Pillow**；
+- Windows：需要 Python 3.9 或更新版本。插件依次尝试 `py -3`、`python`、`python3`；能运行其中一个即可。照片解码使用 PowerShell `.NET`，**不需要 Pillow**；
+- 找不到可用的 Python 时，点击「让 DSH 帮我安装 Python」，把设置请求发送到当前对话。DSH 会先检查是否已有兼容版本，再请你确认所需的安装或设置。没有打开的对话时，可以复制提示词。设置完成后重启 DSH，再重试扫描。
 - 支持 macOS / Windows；Linux 宿主有分支但**未验收**。
 
 ### 权限
@@ -43,7 +44,7 @@ dsh plugin --profile <name> add link:/绝对路径/deepclean-mydisk-plugin
 |---|---|
 | 体检（首页） | 实时容量、开始体检 / 查看清理建议、AI 解读、扫描选项、体检向导、最近一次整理 |
 | 清理 | 垃圾清理（全部项目 + 7 个内容分类，风险分档、搜索排序、逐项「问 AI」与清理前复核）与相似照片 |
-| 空间 | 目录分布（环形图 + 面包屑 + 下钻）与大文件（筛选 + 移动 + 「这是什么」） |
+| 空间 | 目录分布（潮汐带状图 + 面包屑 + 下钻）与大文件（筛选 + 移动 + 「这是什么」） |
 | 历史 | 趋势与复清、隔离区/废纸篓占用与永久删除、扫描历史、可恢复批次、AI 趋势分析 |
 | 设置 | 安全说明、中英切换、保护名单、权限检查、环境信息 |
 
@@ -67,7 +68,7 @@ dsh plugin --profile <name> add link:/绝对路径/deepclean-mydisk-plugin
 
 ### 空间
 
-- 目录分布以家目录为范围（含隐藏项），环形图与明细表共用分母，长尾归入「其他」；支持下钻、面包屑、显示更多与重新统计。
+- 目录分布以家目录为范围（含隐藏项），潮汐带状图与明细表共用分母，长尾归入「其他」；支持下钻、面包屑、显示更多与重新统计。
 - 大文件视图支持全局（完整扫描）与目录联动，可按名称/路径搜索，按大小或未修改天数排序，按修改时间/类型/大小筛选。
 - 明细行可跳到清理页查看该路径的可清理项；移动完成后自动重新统计当前目录。
 
@@ -123,7 +124,7 @@ dsh plugin --profile <name> add link:/绝对路径/deepclean-mydisk-plugin
 - 相似照片范围固定为四个目录、最多 600 张、最小 200 KB；HEIC/WebP 等格式受系统解码能力限制，云盘目录与照片图库会被跳过。
 - 残留细粒度拆分只认目录名像缓存的子目录（Caches/tmp/Code Cache/GPUCache/CacheStorage 等）；缓存目录用了别的名字或 App 仍在运行时，整组仍留在「需确认」。
 - AI 入口依赖当前 DSH 会话与模型；没有打开的会话时只能复制提示词，提示词带的是报告摘要而不是完整报告，模型也可能答错。
-- 依赖本机 Python 3（Windows `py -3`）；缺失时扫描与权限检查不可用。
+- 如果 Windows 提示找不到 Python，在 PowerShell 运行 `py -3 --version`、`python --version` 或 `python3 --version`。如果都无法显示可用版本，请安装 Python 3 并确保命令在 `PATH` 中，然后重启 DSH。
 
 ## 反馈与支持
 

package/docs/plugin/DETAIL.en.md

@@ -12,7 +12,7 @@ DeepClean MyDisk is a DSH plugin for macOS and Windows that audits disk usage wi
 
 ![Cleanup screen](shot-clean.jpg)
 
-**Space.** A directory breakdown with a ring chart, breadcrumbs, and drill-down covers the home directory, and a large-file view supports size and age filters.
+**Space.** A tide-band chart of the home directory, with breadcrumbs and drill-down, plus a large-file view filtered by size and age.
 
 **Similar photos.** dHash fingerprinting groups similar photos across Pictures, Downloads, Desktop, and Documents, up to 600 photos of at least 200 KB. Keep-largest, keep-newest, and keep-shallowest strategies are available.
 
@@ -35,7 +35,7 @@ The allow-set is re-checked in the host. Protected paths always win, symbolic li
 ## Requirements
 
 - macOS: Full Disk Access plus `python3`; the scanner uses built-in tools such as `du`, `plutil`, and `sips`.
-- Windows: `py -3` or `python`, with PowerShell for photo decoding; some system directories need administrator rights.
+- Windows: Python 3.9 or later (`py -3`, `python`, or `python3`), with PowerShell for photo decoding; some system directories need administrator rights.
 - DSH 0.2.x (>=0.2.1-rc.5, <0.3.0). Linux is unverified.
 
 ## Install

package/docs/plugin/DETAIL.zh.md

@@ -12,7 +12,7 @@ DeepClean MyDisk 是 macOS / Windows 上的 DSH 磁盘插件：先做**只读**
 
 ![清理页](shot-clean.jpg)
 
-**空间。** 家目录环形图 + 面包屑 + 下钻，另有按大小/修改时间筛选的大文件视图。
+**空间。** 家目录潮汐带状图 + 面包屑 + 下钻，另有按大小/修改时间筛选的大文件视图。
 
 **相似照片。** 用 dHash 指纹在图片、下载、桌面、文稿四个目录中分组相似照片（最多 600 张、最小 200 KB），支持保留最大/最新/路径最浅。
 
@@ -35,7 +35,7 @@ DeepClean MyDisk 是 macOS / Windows 上的 DSH 磁盘插件：先做**只读**
 ## 环境要求
 
 - macOS：需要「完全磁盘访问」与 `python3`；扫描器使用系统自带的 `du`、`plutil`、`sips` 等工具。
-- Windows：需要 `py -3` 或 `python`；照片解码使用 PowerShell；部分系统目录需要管理员权限。
+- Windows：需要 Python 3.9 或更新版本（`py -3`、`python` 或 `python3`）；照片解码使用 PowerShell；部分系统目录需要管理员权限。
 - DSH 0.2.x（≥0.2.1-rc.5，<0.3.0）。Linux 未验收。
 
 ## 安装