deepclean-mydisk 0.0.0-stage → 0.12.0

package/lib/platform.js

@@ -0,0 +1,29 @@
+import path from 'node:path'
+
+// Protection is checked again on the host, independently of UI selection.
+export function isProtected(target, whitelist, platform = process.platform) {
+  const paths = platform === 'win32' ? path.win32 : path.posix
+  if (typeof target !== 'string' || !paths.isAbsolute(target)) return false
+  return whitelist.some((root) => {
+    if (typeof root !== 'string' || !paths.isAbsolute(root)) return false
+    const contains = (parent, child) => {
+      const relative = paths.relative(paths.resolve(parent), paths.resolve(child))
+      return relative === '' || (relative !== '..' && !relative.startsWith('..' + paths.sep) && !paths.isAbsolute(relative))
+    }
+    // Removing an ancestor would also remove the protected descendant.
+    return contains(root, target) || contains(target, root)
+  })
+}
+
+export function parseTreeOutput(out, platform = process.platform) {
+  const children = []
+  for (const line of out.split(/\r?\n/)) {
+    const idx = line.indexOf('\t')
+    if (idx < 1) continue
+    const size = Number(line.slice(0, idx))
+    const target = line.slice(idx + 1)
+    if (!Number.isFinite(size) || size < 0 || !target) continue
+    children.push({ path: target, kb: platform === 'win32' ? size / 1024 : size })
+  }
+  return children
+}

package/locale/en.json

@@ -0,0 +1,7 @@
+{
+  "meta": {
+    "title": "DeepClean MyDisk",
+    "description": "Read-only disk audit and cleanup that moves selected files to the Trash or quarantine, with undo.",
+    "detail": "docs/plugin/DETAIL.en.md"
+  }
+}

package/locale/zh.json

@@ -0,0 +1,7 @@
+{
+  "meta": {
+    "title": "DeepClean MyDisk",
+    "description": "只读磁盘体检；清理把选中文件移入废纸篓或隔离区，可撤销。",
+    "detail": "docs/plugin/DETAIL.zh.md"
+  }
+}

package/package.json

@@ -1,6 +1,69 @@
 {
   "name": "deepclean-mydisk",
-  "version": "0.0.0-stage",
-  "stub": true,
-  "description": "Temporary package placeholder for staged publishing"
-}
+  "version": "0.12.0",
+  "description": "Read-only disk audit and cleanup for macOS and Windows: caches, leftovers, similar photos, space breakdown, and cross-disk file moves.",
+  "author": "huangxiaoliang",
+  "keywords": [
+    "dsh",
+    "dsh-plugin",
+    "disk",
+    "storage",
+    "cleanup",
+    "macos",
+    "windows"
+  ],
+  "icon": "./assets/icon-180.png",
+  "type": "module",
+  "main": "lib/index.js",
+  "engines": {
+    "dsh": ">=0.2.1-rc.5 <0.3.0-0"
+  },
+  "files": [
+    "lib",
+    "resources",
+    "cordis.patch.yml",
+    "README.md",
+    "LICENSE",
+    "locale/*.json",
+    "docs/plugin",
+    "assets/icon-180.png"
+  ],
+  "dsh": {
+    "bundle": {
+      "patch": "./cordis.patch.yml"
+    },
+    "client": {
+      "platform": "web"
+    }
+  },
+  "peerDependencies": {
+    "@deepseek-ai/dsh-tools": ">=0.2.1-rc.5 <0.3.0-0"
+  },
+  "license": "MIT",
+  "devDependencies": {
+    "@deepseek-ai/dsh-tools": "0.2.1-rc.5",
+    "react": "^19.3.1",
+    "react-dom": "^19.3.1"
+  },
+  "exports": {
+    ".": {
+      "default": "./lib/index.js"
+    },
+    "./client": {
+      "default": "./lib/client.js"
+    },
+    "./package.json": "./package.json",
+    "./locale/*.json": "./locale/*.json"
+  },
+  "scripts": {
+    "test": "node --test"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/huangxiaoliang/deepclean-mydisk-plugin.git"
+  },
+  "bugs": {
+    "url": "https://github.com/huangxiaoliang/deepclean-mydisk-plugin/issues"
+  },
+  "homepage": "https://github.com/huangxiaoliang/deepclean-mydisk-plugin#readme"
+}

package/resources/LICENSE-phosphor.txt

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2023 Phosphor Icons
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/resources/rules.json

@@ -0,0 +1,139 @@
+{
+  "version": 1,
+  "description": "mac-disk-audit 分类规则。改这里不用改代码。",
+  "thresholds": {
+    "displayMinMb": 10,
+    "mediaConfirmMb": 50,
+    "commandMinMb": 100,
+    "bigFileMb": 300
+  },
+  "mediaHints": [
+    "video",
+    "player",
+    "tenvideo",
+    "iqiyi",
+    "youku",
+    "bilibili",
+    "tv.",
+    "music",
+    "netease",
+    "spotify",
+    "podcast",
+    "fm.",
+    "radio",
+    "movie",
+    "cinema",
+    "douyin",
+    "tiktok",
+    "kuaishou",
+    "xiaohongshu",
+    "zhihu",
+    "weibo",
+    "qqmusic"
+  ],
+  "meetingHints": [
+    "meeting",
+    "zoom",
+    "teams",
+    "webex",
+    "voov",
+    "wemeet",
+    "wwmapp"
+  ],
+  "userDataHints": [
+    "wechat",
+    "weixin",
+    "wxwork",
+    "wecom",
+    "feishu",
+    "lark",
+    "dingtalk",
+    "telegram",
+    "whatsapp",
+    "signal",
+    "messenger",
+    "qq.",
+    "qqexdoc",
+    "qqexbrowser",
+    "txdocs",
+    "notes",
+    "evernote",
+    "yinxiang",
+    "notion",
+    "docs",
+    "office",
+    "wps",
+    "pdf",
+    "mail",
+    "calendar",
+    "messages",
+    "photos",
+    "books",
+    "kindle",
+    "weread",
+    "portfolio",
+    "frodo",
+    "douban"
+  ],
+  "devHints": [
+    "xcode",
+    "simulator",
+    "docker",
+    "electron",
+    "cursor",
+    "trae",
+    "codex"
+  ],
+  "extSuffixRe": "(?i)\\.[A-Za-z0-9]*(widget|widgets|extension|ext|helper|share|shares|shareextension|notification|notificationservice|notificationserviceextension|notificationcontent|findersync|quicklook|quicklookpreview|quicklookthumbnail|intent|intents|intenthandler|intentui|intentsui|ddsintents|action|actionextension|siri|broadcast|replaykit|today|todaywidget|fileprovider|fileproviderextension|fileproviderui|xpcservice|launcher|recentfiles|menu|preview|thumbnail|ipchelper|bridgeservice|webapp|safariextension|sharingextension|serviceextension|widgetkit|docktileplugin|finderhelper)$",
+  "systemCacheNames": [
+    "CloudKit",
+    "GeoServices",
+    "com.apple.geod",
+    "com.apple.mediaanalysisd",
+    "com.apple.Safari",
+    "com.apple.QuickLook",
+    "com.apple.exchangesync"
+  ],
+  "knownNames": {
+    "com.tencent.txdocs": "腾讯文档",
+    "com.tencent.qqexdoc": "腾讯文档组件",
+    "com.tencent.wwmapp": "企业微信会议组件",
+    "com.tencent.qqexbrowser": "QQ 浏览器组件",
+    "com.bytedance.douyin.desktop": "抖音桌面端",
+    "com.douban.frodo": "豆瓣",
+    "com.tencent.QQMusicMac": "QQ 音乐",
+    "com.netease.163music": "网易云音乐",
+    "com.tencent.weread": "微信读书",
+    "com.tencent.xinWeChat": "微信",
+    "com.tencent.qq": "QQ",
+    "com.bytedance.macos.feishu": "飞书",
+    "com.yinxiang.Mac": "印象笔记",
+    "com.tencent.tenvideo": "腾讯视频",
+    "com.xunlei.mvideo": "迅雷影音",
+    "tv.danmaku.bilianime": "哔哩哔哩",
+    "com.youku.mac": "优酷",
+    "com.iqiyi.player": "爱奇艺",
+    "com.tencent.meeting": "腾讯会议",
+    "com.tencent.portfolio": "腾讯微云",
+    "net.whatsapp.WhatsApp": "WhatsApp",
+    "com.tencent.yuanbao": "腾讯元宝",
+    "com.google.drivefs": "Google Drive",
+    "com.tencent.wework": "企业微信"
+  },
+  "denyPaths": [
+    "~/Library/Mail",
+    "~/Library/Messages",
+    "~/Library/Photos",
+    "~/Library/Keychains",
+    "~/Library/CloudStorage",
+    "~/Library/Group Containers",
+    "~/Library/Application Support"
+  ],
+  "componentOf": {
+    "com.tencent.wwmapp": "com.tencent.WeWorkMac",
+    "com.tencent.wecom": "com.tencent.WeWorkMac",
+    "com.tencent.wework": "com.tencent.WeWorkMac",
+    "com.tencent.WeWork-Helper": "com.tencent.WeWorkMac",
+    "88L2Q4487U.com.tencent.WeWorkMac": "com.tencent.WeWorkMac"
+  }
+}

package/resources/scripts/deepclean.py

@@ -0,0 +1,109 @@
+#!/usr/bin/env python3
+"""deepclean-mydisk 统一入口（v0.4.0）。
+
+- macOS：调用 scripts/scan.py（成熟实现，行为与 v0.3.x 一致）
+- Windows：调用 scripts/platforms/windows.py（只读，PowerShell 隔离区方案）
+
+用法：
+  python deepclean.py                       # 自动识别平台
+  python deepclean.py --quick --redact      # 透传给平台脚本
+  python deepclean.py --platform windows --self-test
+"""
+import argparse
+import subprocess
+import sys
+import tempfile
+from pathlib import Path
+
+VERSION = "0.5.0"
+HERE = Path(__file__).resolve().parent
+MACOS = HERE / "scan.py"
+WINDOWS = HERE / "platforms" / "windows.py"
+
+
+def detect_platform():
+    if sys.platform.startswith("win"):
+        return "windows"
+    if sys.platform == "darwin":
+        return "macos"
+    return "macos"
+
+
+def target(platform):
+    return WINDOWS if platform == "windows" else MACOS
+
+
+def split_args(argv):
+    platform = None
+    self_test = False
+    rest = []
+    i = 0
+    while i < len(argv):
+        a = argv[i]
+        if a == "--platform":
+            platform = argv[i + 1] if i + 1 < len(argv) else None
+            i += 2
+        elif a.startswith("--platform="):
+            platform = a.split("=", 1)[1]
+            i += 1
+        elif a == "--self-test":
+            self_test = True
+            i += 1
+        else:
+            rest.append(a)
+            i += 1
+    return platform, self_test, rest
+
+
+def macos_self_test():
+    """在临时 HOME 上跑一次 quick 扫描，验证只读链路与报告结构。"""
+    with tempfile.TemporaryDirectory(prefix="deepclean-mac-test-") as td:
+        home = Path(td) / "home"
+        (home / "Library" / "Containers").mkdir(parents=True)
+        (home / "Library" / "Caches").mkdir(parents=True)
+        report = Path(td) / "report.md"
+        proc = subprocess.run(
+            [sys.executable, str(MACOS), "--quick", "--home", str(home), "--md", str(report)],
+            capture_output=True, text=True)
+        if proc.returncode != 0:
+            print("FAIL  macos 扫描退出码", proc.returncode)
+            print(proc.stderr[-800:])
+            return 1
+        text = report.read_text(encoding="utf-8")
+        checks = [
+            ("报告标题", "磁盘体检报告" in text),
+            ("预计可释放", "预计可释放" in text),
+            ("不建议清理", "不建议清理" in text),
+            ("扫描范围", "扫描范围" in text),
+        ]
+        ok = True
+        for name, cond in checks:
+            print(("PASS  " if cond else "FAIL  ") + name)
+            ok = ok and cond
+        print("\n自检结果：" + ("通过" if ok else "失败"))
+        return 0 if ok else 1
+
+
+def main():
+    platform = None
+    if len(sys.argv) > 1:
+        platform, self_test, rest = split_args(sys.argv[1:])
+    else:
+        self_test, rest = False, []
+    if rest and rest[0] in ("--version", "-V"):
+        print(f"deepclean-mydisk {VERSION}")
+        return 0
+    platform = platform or detect_platform()
+    if platform not in ("macos", "windows"):
+        print(f"不支持的平台：{platform}", file=sys.stderr)
+        return 2
+    if self_test:
+        if platform == "windows":
+            return subprocess.call([sys.executable, str(WINDOWS), "--self-test"])
+        return macos_self_test()
+    cmd = [sys.executable, str(target(platform))] + rest
+    return subprocess.call(cmd)
+
+
+if __name__ == "__main__":
+    sys.exit(main())

package/resources/scripts/photos-windows.ps1

@@ -0,0 +1,77 @@
+# Read-only image decoding through the Windows .NET image codecs.
+# Writes only explicitly requested temporary JPEG outputs (never input files).
+param(
+    [Parameter(Mandatory=$true)][ValidateSet('hash','thumbnail')][string]$Mode,
+    [string]$InputPath,
+    [string]$OutputPath,
+    [ValidateRange(64,320)][int]$Size = 160
+)
+$ErrorActionPreference = 'Stop'
+[Console]::InputEncoding = [System.Text.UTF8Encoding]::new($false)
+[Console]::OutputEncoding = [System.Text.UTF8Encoding]::new($false)
+try {
+    Add-Type -AssemblyName System.Drawing
+    function Get-PhotoHash([string]$File) {
+        $image = $null; $bitmap = $null; $graphics = $null
+        try {
+            $image = [System.Drawing.Image]::FromFile($File)
+            $bitmap = [System.Drawing.Bitmap]::new(9, 8)
+            $graphics = [System.Drawing.Graphics]::FromImage($bitmap)
+            $graphics.DrawImage($image, 0, 0, 9, 8)
+            $hex = [System.Text.StringBuilder]::new()
+            $nibble = 0; $count = 0
+            for ($y = 0; $y -lt 8; $y++) {
+                for ($x = 0; $x -lt 8; $x++) {
+                    $a = $bitmap.GetPixel($x, $y); $b = $bitmap.GetPixel($x + 1, $y)
+                    $left = [Math]::Floor(0.299 * $a.R + 0.587 * $a.G + 0.114 * $a.B)
+                    $right = [Math]::Floor(0.299 * $b.R + 0.587 * $b.G + 0.114 * $b.B)
+                    $nibble = $nibble -shl 1
+                    if ($left -gt $right) { $nibble = $nibble -bor 1 }
+                    $count++
+                    if ($count -eq 4) {
+                        [void]$hex.Append($nibble.ToString('x'))
+                        $nibble = 0; $count = 0
+                    }
+                }
+            }
+            return $hex.ToString()
+        } finally {
+            if ($graphics) { $graphics.Dispose() }
+            if ($bitmap) { $bitmap.Dispose() }
+            if ($image) { $image.Dispose() }
+        }
+    }
+    if ($Mode -eq 'hash') {
+        $files = ConvertFrom-Json -InputObject ([Console]::In.ReadToEnd())
+        $results = @(foreach ($file in $files) {
+            try { @{path=[string]$file; hash=(Get-PhotoHash ([string]$file))} }
+            catch { @{path=[string]$file; error=$_.Exception.Message} }
+        })
+        ConvertTo-Json -InputObject $results -Depth 4 -Compress
+    } else {
+        $job = ConvertFrom-Json -InputObject ([Console]::In.ReadToEnd())
+        $InputPath = [string]$job.path
+        $OutputPath = [string]$job.output
+        $Size = [int]$job.size
+        if ($Size -lt 64 -or $Size -gt 320) { throw 'Invalid thumbnail size' }
+        $image = $null; $bitmap = $null; $graphics = $null
+        try {
+            $image = [System.Drawing.Image]::FromFile($InputPath)
+            $scale = [Math]::Min(1.0, $Size / [double][Math]::Max($image.Width, $image.Height))
+            $width = [Math]::Max(1, [int]($image.Width * $scale))
+            $height = [Math]::Max(1, [int]($image.Height * $scale))
+            $bitmap = [System.Drawing.Bitmap]::new($width, $height)
+            $graphics = [System.Drawing.Graphics]::FromImage($bitmap)
+            $graphics.Clear([System.Drawing.Color]::White)
+            $graphics.DrawImage($image, 0, 0, $width, $height)
+            $bitmap.Save($OutputPath, [System.Drawing.Imaging.ImageFormat]::Jpeg)
+        } finally {
+            if ($graphics) { $graphics.Dispose() }
+            if ($bitmap) { $bitmap.Dispose() }
+            if ($image) { $image.Dispose() }
+        }
+    }
+} catch {
+    [Console]::Error.WriteLine($_.Exception.Message)
+    exit 1
+}