dsh-disk-manager 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 wangzhanchao883
+
+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/README.md

@@ -0,0 +1,144 @@
+# dsh-disk-manager · C盘空间规划整理大师
+
+> 一个 **DSH（DeepSeek Harness）Web UI 插件**，把 C 盘占用分门别类，针对每类给出**不同的正确动作**（删缓存 / 引导改址 / junction 搬家 / 提示废弃 / 个人文件只提醒），而不是像传统清理工具那样只会删缓存。**配置/记忆类（红线）永不自动执行。**
+
+<p align="center">
+  <img src="assets/screenshots/settings.png" alt="设置页" width="70%" />
+  <br/>
+  <em>设置页:一句话总结 + 「开始扫描C盘」按钮 + 通用设置</em>
+</p>
+
+<p align="center">
+  <img src="assets/screenshots/scan-result.png" alt="扫描分类结果" width="70%" />
+  <br/>
+  <img src="assets/screenshots/scan-result-2.png" alt="推荐档位" width="70%" />
+</p>
+
+## 定位
+
+现有磁盘清理工具普遍只做一件事：**删缓存**。但你真正的问题往往是：
+1. **软件忘了删**（很久没用的大软件还霸着 C 盘）；
+2. **数据放错了盘**（Docker 的 WSL、大缓存本来都可以搬到 D 盘）；
+3. 缓存可再生但**清一次就长回来**。
+
+`C盘空间规划整理大师` 是**统筹型参谋**:扫描整 C 盘 → 把每个大户分门别类 → 针对不同类别给不同动作 → 你点选确认后才执行。
+
+## 扫描范围
+
+整 C 盘(页面统一显示),**对内扫**:用户区 `AppData`(Local+Roaming) + 整个用户 profile(Downloads/Documents/Desktop 等) + `Program Files`;**不扫 Windows**(系统目录,扫了全是红线刷屏)。
+
+## 六类模型（核心）
+
+| 类别 | 含义 | 动作 | 风险 |
+|---|---|---|---|
+| **A 无忧缓存** | Cache/GPUCache/Code Cache/Temp/log/*.updater | 删 或 junction 搬 | 无(可再生) |
+| **B 官方可改址** | Docker/npm/pnpm/pip/浏览器 profile | 走官方设置改到别的盘 | 低(官方支持) |
+| **C 可junction搬** | 剪映/Notion/Trae/Cursor 等纯可再生缓存 | junction 搬到别的盘 | 低(可再生) |
+| **D 冷废弃软件** | 大体积 + 超过 N 天(默认180)没用 | 提示「你可能很久没用它了」 | 只提示 |
+| **E 配置/记忆(红线)** | Config/Storage/IndexedDB/MEMORY/.openviking/.qclaw | **只展示,绝不执行** | 高(绝不碰) |
+| **P 个人文件** | Downloads/Documents/Desktop 等用户自己的数据 | 只提醒大文件,可手动搬,绝不自动删 | 高(用户数据) |
+
+> **冷废弃(D)已修正误判**:已装软件(Docker、Typora、NVIDIA 等)的*安装目录*只在安装当天写一次 mtime,之后天天运行也不会更新,旧逻辑会按"lastAccess 超 180 天"误判成废弃。现在扫描时会快照一次运行中进程 + 命中 Docker/WSL 等常用白名单 → **在跑/常用的软件永不进入「冷废弃」**。
+
+## 环境要求
+
+- **Windows**(扫描与执行依赖 PowerShell;junction/删除用系统原生能力)。
+- **Node.js** ≥ 22(DSH 运行时)。
+- **DeepSeek Harness** web profile(插件安装进 web 使用)。
+- 可选:DSH 自带 LLM(用于未知目录的 LLM 兜底分类)。
+
+## 分类引擎:静态规则 + LLM 兜底 + 人工确认
+
+不同电脑软件千差万别,不能靠死规则硬吃。分类引擎是**三级**:
+
+1. **静态规则库 `core/riskmap.mjs`** —— 覆盖常见几十种软件/目录特征 + 扫描区(zone)判定,零成本、确定性。
+2. **本地分类缓存** —— 用户确认过一次的分类写入 `~/.dsh-disk-manager/classify-cache.json`,下次同类直接命中,越用越聪明。
+3. **LLM 兜底** —— 未命中的未知目录,打包特征(目录名/大小/子目录名)送 DSH 自带 LLM 判断类别,再让**用户确认**后才生效。
+
+**强红线**:任何 `config/storage/indexeddb/memory/database/.openviking/.qclaw` 特征、以及所有点目录(`.xxx`),即使 LLM 判错,也会被回退为 E(只展示,不执行)。
+
+## 架构速览
+
+```
+┌─────────────── client.js (Web 设置页, React.createElement 无构建) ───────────────┐
+│  一句话总结 · 「开始扫描C盘」按钮 → connection.api.sessions.prompt("/disk_scan")   │
+│  通用设置: 启用/目标盘/冷废弃天数/扫描范围 → settingsScope.set()                  │
+└───────────────────────────────┬──────────────────────────────────────────────────┘
+                                │ host 端工具 + 斜杠命令
+┌───────────────────────────────▼──────────────────────────────────────────────────┐
+│ index.mjs        工具注册(disk_scan/drives/preview/execute/classify/undo)        │
+│                   + /disk_scan 命令(host 直跑,复用 runScan)                      │
+│ config.mjs       配置(~/.dsh-disk-manager/config.json) + 分类缓存               │
+│ core/                                                                           │
+│   scanner.mjs    PowerShell 批量量体积 → {name,path,sizeMB,subdirs,lastAccess}   │
+│   active.mjs     进程快照 + 常用白名单(修冷废弃误判)                             │
+│   riskmap.mjs    静态规则库:目录名→A/B/C/D/E 特征映射                             │
+│   classify.mjs   规则→缓存→LLM 三级分类                                          │
+│   safety.mjs     红线判定 + dry-run + undo                                        │
+│   executor.mjs   删/junction/改址执行                                             │
+└──────────────────────────────────────────────────────────────────────────────────┘
+```
+
+## 安全防线
+
+- E 红线/程序本体/系统目录/点目录 **永远只展示**,无执行入口;
+- P 个人文件**只提醒,绝不自动删**(仅允许手动 junction 搬);
+- 执行前 `disk_preview` 生成 dry-run 预览;
+- 可生成 undo 日志(`disk_undo` 查看);
+- junction 迁移用原生 `New-Item -ItemType Junction`,已验证可回读。
+
+## 工具(对话里驱动)
+
+| 工具 | 作用 |
+|---|---|
+| `disk_drives` | 列出当前机器可用盘符(C/D/E...),供选择迁移目标盘 |
+| `disk_scan` | 扫描整 C 盘,量体积,按 A/B/C/D/E/P 分组返回报告 |
+| `disk_preview` | 对选中项 dry-run 预览(列出"将做什么") |
+| `disk_execute` | 真正执行(删/junction/引导改址);E/未分类不执行,P 不可删 |
+| `disk_classify_confirm` | 用户确认 LLM 判断的类别,写入本地缓存 |
+| `disk_undo` | 查看 undo 日志,便于回滚 |
+| `/disk_scan` | 斜杠命令:host 直跑扫描,不经模型;等价于 `disk_scan`,供设置页按钮调用 |
+
+## 安装
+
+```bash
+dsh plugin --profile web add dsh-disk-manager
+```
+
+安装后重启 DSH。设置页出现「C盘空间规划整理大师」标签;点「开始扫描C盘」一键扫描,或在对话里直接运行 `/disk_scan` / 调用 `disk_scan` 工具。
+
+## 配置文件
+
+`~/.dsh-disk-manager/config.json`,首次使用需在设置页或工具里选好**目标盘**。参考 [`config.example.json`](./config.example.json)。
+
+## 目录结构
+
+```
+dsh-disk-manager/
+├── package.json          # dsh.client.web 注入 + npm 元数据
+├── index.mjs             # 主入口 + 工具注册 + /disk_scan 命令
+├── client.js             # Web 设置页
+├── config.mjs            # 用户配置 + 分类缓存读写
+├── cordis.patch.yml
+├── screenshots.json      # 注册表截图声明
+├── assets/screenshots/   # 产品截图
+└── core/
+    ├── scanner.mjs       # 扫描引擎(PowerShell 后端)
+    ├── active.mjs        # 进程在跑检测 + 常用软件白名单(修冷废弃误判)
+    ├── riskmap.mjs       # 静态规则库(五类特征映射)
+    ├── classify.mjs      # 分类引擎(规则→缓存→LLM)
+    ├── safety.mjs        # 红线判定 + dry-run + undo
+    └── executor.mjs      # 执行引擎(删/junction/改址)
+```
+
+## 开发
+
+```bash
+npm install
+node dev-run.mjs      # 只读自测扫描+分类
+node dev-tool.mjs     # 模拟 ctx 走通 apply + disk_scan
+```
+
+## License
+
+[MIT](./LICENSE)

package/client.js

@@ -0,0 +1,244 @@
+/* dsh-disk-manager client bundle — Web 设置页。
+ * 以经典脚本形式注册到 window.__ModuleLoader__;工厂内用 require 取 React,
+ * 不能用 JSX(无构建步骤),一律 React.createElement。
+ * 说明:扫描/分类/执行由模型驱动的工具(disk_scan/disk_preview/disk_execute)
+ *       在对话里呈现与确认;本页负责用户配置(目标盘/启用)。 */
+window.__ModuleLoader__.load({
+  id: "dsh-disk-manager",
+  factory: (require) => {
+    var module = { exports: {} };
+    var exports = module.exports;
+
+    const React = require("react");
+    const h = React.createElement;
+    const { useEffect, useRef, useState } = React;
+
+    const NS = "settings.diskManager";
+    const SETTINGS_NAMESPACE = "dsh-disk-manager";
+
+    const zh = {
+      nav: "C盘空间规划整理大师",
+      loading: "正在读取配置…",
+      unavailable: "配置面板不可用(设置服务未挂载)。请直接编辑配置文件 ~/.dsh-disk-manager/config.json。",
+      saved: "已保存",
+      error: "保存失败:",
+      general: "通用设置",
+      enabled: "启用C盘空间规划整理大师",
+      enabledHint: "关闭后不再提供C盘扫描/清理工具",
+      targetDrive: "将C盘缓存数据搬迁到的新盘符",
+      targetDriveHint: "选择要把缓存/数据搬到的盘(如 D)。下拉框只列出检测到的盘符,避免乱填",
+      targetDrivePlaceholder: "请选择盘符",
+      abandon: "连续未运行的不常用软件扫描",
+      abandonMark: "180 天",
+      abandonHint: "连续 180 天未运行的软件会被提示「你可能很久没用它了」(默认 180 天,无需填写)",
+      scanRootDesc: "整 C 盘",
+      scanRootHint: "扫描整 C 盘用户区 + Program Files,不扫 Windows。",
+      use: "使用说明",
+      useText: "对话里调用 disk_scan 扫描分类、disk_preview 预览、disk_execute 确认执行。配置/记忆类(红线)永远只展示;个人文件只提醒、绝不自动删。",
+      summary: "扫描整 C 盘占用,把每个大空间按「可删缓存 / 可改址 / 可搬盘 / 冷废弃 / 红线保护」分类,动手前先预览、做完可回滚。扫描过程中耗时较长,一般需要几分钟,请耐心等待。",
+      startScan: "开始扫描C盘",
+      startScanHint: "点击后在对话里运行扫描并按类别返回清单;扫描耗时约几分钟。",
+      scanning: "扫描中…",
+      scanRunning: ">>> 已发起扫描,请到当前对话查看结果。",
+      scanNoSession: ">>> 无会话,请先在对话新建一个会话。",
+      scanUnknown: ">>> 未知命令: /disk_scan(插件未加载该命令)。",
+      scanFail: "发起失败:",
+    };
+
+    const en = {
+      nav: "C Drive Planner",
+      loading: "Reading configuration…",
+      unavailable: "Configuration panel unavailable. Edit ~/.dsh-disk-manager/config.json instead.",
+      saved: "Saved",
+      error: "Save failed:",
+      general: "General",
+      enabled: "Enable C Drive Planner",
+      enabledHint: "Disables C-drive scan/cleanup tools when off",
+      targetDrive: "Target drive for C-drive cache",
+      targetDriveHint: "Pick the drive to move caches/data to (e.g. D). Only detected drives are listed.",
+      targetDrivePlaceholder: "Select a drive",
+      abandon: "Rarely-used software scan",
+      abandonMark: "180 days",
+      abandonHint: "Software not run for 180 days is flagged as possibly abandoned (default, no input needed)",
+      scanRootDesc: "Entire C drive",
+      scanRootHint: "Scans C-drive user area + Program Files, not Windows.",
+      use: "Usage",
+      useText: "Call disk_scan in chat to scan/classify, disk_preview to dry-run, disk_execute to confirm. Config/memory (redline) is display-only; personal files are remind-only.",
+      summary: "Scan the whole C drive, categorize each large space into cache / relocatable / movable / abandoned / redline, preview before acting and undoable after. Scanning takes a few minutes — please wait.",
+      startScan: "Scan C Drive",
+      startScanHint: "Runs the scan in the conversation and returns categorized results; takes a few minutes.",
+      scanning: "Scanning…",
+      scanRunning: ">>> Scan started, check the current conversation for results.",
+      scanNoSession: ">>> No session, create one in the chat first.",
+      scanUnknown: ">>> Unknown command: /disk_scan (plugin not loaded).",
+      scanFail: "Failed to start:",
+    };
+
+    const STYLES = [
+      ".dsk-config{max-width:640px;display:flex;flex-direction:column;gap:16px;color:var(--dsw-alias-label-primary)}",
+      ".dsk-group{border:1px solid var(--dsw-alias-border-l2);border-radius:10px;padding:14px;background:var(--dsw-alias-bg-layer-2)}",
+      ".dsk-group h3{margin:0 0 12px;font-size:13px;font-weight:600}",
+      ".dsk-field{display:flex;flex-direction:column;gap:4px;margin-bottom:10px}",
+      ".dsk-field label{font-size:12px;font-weight:500}",
+      ".dsk-field select,.dsk-field input[type=text],.dsk-field input[type=number]{height:30px;border:1px solid var(--dsw-alias-border-l2);background:var(--dsw-alias-bg-layer-1);color:var(--dsw-alias-label-primary);border-radius:6px;padding:0 8px;font:inherit;font-size:13px;box-sizing:border-box}",
+      ".dsk-hint{font-size:11px;color:var(--dsw-alias-label-tertiary)}",
+      ".dsk-switch{display:flex;align-items:center;gap:8px;margin-bottom:6px}",
+      ".dsk-switch input{accent-color:var(--dsw-alias-state-business-primary)}",
+      ".dsk-status{font-size:12px;color:var(--dsw-alias-label-tertiary);min-height:16px}",
+      ".dsk-row{display:flex;gap:12px}",
+      ".dsk-note{font-size:12px;line-height:1.6;color:var(--dsw-alias-label-secondary);white-space:pre-wrap}",
+      ".dsk-static{font-size:13px;color:var(--dsw-alias-label-primary);padding:6px 0}",
+      ".dsk-summary{font-size:13px;line-height:1.7;color:var(--dsw-alias-label-primary);background:var(--dsw-alias-bg-layer-1);border:1px solid var(--dsw-alias-border-l2);border-left:4px solid var(--dsw-alias-state-business-primary);border-radius:8px;padding:12px 14px;white-space:pre-wrap}",
+      ".dsk-btn{height:32px;padding:0 16px;border:1px solid var(--dsw-alias-state-business-primary);background:var(--dsw-alias-state-business-primary);color:#fff;border-radius:6px;font:inherit;font-size:13px;cursor:pointer}",
+      ".dsk-btn:disabled{opacity:.6;cursor:not-allowed}",
+    ].join("");
+
+    function Field({ label, hint, children }) {
+      return h("div", { className: "dsk-field" }, h("label", null, label), children, hint ? h("div", { className: "dsk-hint" }, hint) : null);
+    }
+
+    /** 下拉选择(盘符) */
+    function SelectInput({ value, onCommit, options, placeholder }) {
+      return h("select", {
+        value: value || "",
+        onChange: (e) => onCommit(e.target.value),
+      }, [
+        h("option", { value: "", disabled: true }, placeholder || ""),
+        ...(options || []).map((opt) => h("option", { key: opt.value, value: opt.value }, opt.label)),
+      ]);
+    }
+
+    function ConfigSection({ scope, t, drives, runScan }) {
+      const [snap, setSnap] = useState(() => scope.getSnapshot());
+      const [status, setStatus] = useState("");
+      const [scanMsg, setScanMsg] = useState("");
+      const [scanning, setScanning] = useState(false);
+      const statusTimer = useRef(null);
+      useEffect(() => scope.subscribe(() => setSnap(scope.getSnapshot())), [scope]);
+      useEffect(() => () => { if (statusTimer.current) clearTimeout(statusTimer.current); }, []);
+      const flash = (msg) => {
+        setStatus(msg);
+        if (statusTimer.current) clearTimeout(statusTimer.current);
+        statusTimer.current = setTimeout(() => setStatus(""), 2500);
+      };
+      const save = (field, v) => {
+        Promise.resolve(scope.set(field, v))
+          .then(() => flash(t("saved")))
+          .catch((err) => flash(`${t("error")} ${err && err.message ? err.message : String(err)}`));
+      };
+      const doScan = () => {
+        if (!runScan || scanning) return;
+        setScanning(true);
+        setScanMsg("");
+        Promise.resolve(runScan())
+          .then((res) => setScanMsg(res || t("scanRunning")))
+          .catch((err) => setScanMsg(`${t("scanFail")} ${err && err.message ? err.message : String(err)}`))
+          .finally(() => setScanning(false));
+      };
+
+      if (snap.status === "loading") return h("p", { className: "dsk-status" }, t("loading"));
+      if (snap.status === "unavailable") return h("p", { className: "dsk-status" }, t("unavailable"));
+      const v = snap.value || {};
+      const driveOptions = (drives || []).map((d) => ({ value: d, label: d + ": 盘" }));
+
+      return h("div", { className: "dsk-config" }, [
+        h("div", { className: "dsk-summary" }, t("summary")),
+        h("div", { className: "dsk-group" }, [
+          h("button", { className: "dsk-btn", disabled: scanning, onClick: doScan }, scanning ? t("scanning") : t("startScan")),
+          h("div", { className: "dsk-hint" }, t("startScanHint")),
+          h("div", { className: "dsk-status" }, scanMsg),
+        ]),
+        h("div", { className: "dsk-group" }, [
+          h("h3", null, t("general")),
+          h("div", { className: "dsk-switch" }, [
+            h("input", { type: "checkbox", id: "dsk-enabled", checked: !!v.enabled, onChange: (e) => save("enabled", e.target.checked) }),
+            h("label", { htmlFor: "dsk-enabled" }, t("enabled")),
+          ]),
+          h("div", { className: "dsk-hint" }, t("enabledHint")),
+          Field({
+            label: t("targetDrive"),
+            hint: t("targetDriveHint"),
+            children: h(SelectInput, { value: v.targetDrive || "", onCommit: (val) => save("targetDrive", val), options: driveOptions, placeholder: t("targetDrivePlaceholder") }),
+          }),
+          Field({
+            label: t("abandon"),
+            hint: t("abandonHint"),
+            children: h("div", { className: "dsk-static" }, t("abandonMark")),
+          }),
+          Field({
+            label: t("scanRootDesc"),
+            hint: t("scanRootHint"),
+            children: h("div", { className: "dsk-static" }, t("scanRootDesc")),
+          }),
+          h("div", { className: "dsk-note" }, t("useText")),
+        ]),
+        h("div", { className: "dsk-status" }, status),
+      ]);
+    }
+
+    function apply(ctx) {
+      ctx.effect(() => {
+        const tag = document.createElement("style");
+        tag.setAttribute("data-plugin", "dsh-disk-manager");
+        tag.textContent = STYLES;
+        document.head.appendChild(tag);
+        return () => { if (tag.parentNode) tag.parentNode.removeChild(tag); };
+      }, "dsh-disk-manager: styles");
+
+      ctx.effect(() => {
+        return ctx.locale.register(NS, { zh, en });
+      }, "dsh-disk-manager: dictionaries");
+
+      const t = ctx.locale.bind(NS);
+      const scope = ctx.settingsScope.bind({ namespace: SETTINGS_NAMESPACE });
+      const drives = ["C", "D", "E", "F", "G", "H"]; // 兜底;实际以配置/扫描检测为准
+      const connection = ctx.get("connection");
+      const remote = ctx.get("remote");
+      const sessions = ctx.get("sessions");
+      const runScan = async () => {
+        try {
+          if (!connection) return `${t("scanFail")} connection 不可用`;
+          if (!sessions || !sessions.list) return `${t("scanFail")} sessions 不可用`;
+          // 1) 取当前会话(就是你正在看的这个对话);为空则回退到列表里最后一个
+          const cur = sessions.list.getSnapshot();
+          const targetId = cur.current || (cur.ids && cur.ids.length ? cur.ids[cur.ids.length - 1] : void 0);
+          if (!targetId) return t("scanNoSession");
+          // 2) 确保它在前台(已选中则无副作用)
+          try { if (sessions.open) sessions.open(targetId); } catch { /* 已在前台则忽略 */ }
+          // 3) 给该会话发一条用户消息 "/disk_scan",host 会走命令注册表执行、结果渲染进对话。
+          //    用 session.prompt(入队、立即返回),避免像 commands.execute 那样长时间等待/挂住。
+          const tz = (Intl.DateTimeFormat && Intl.DateTimeFormat().resolvedOptions().timeZone) || "Asia/Shanghai";
+          const { result } = await connection.api.sessions.prompt({
+            sessionId: targetId,
+            mode: "queue",
+            content: [{ type: "text", text: "/disk_scan" }],
+            clientTimeZone: tz,
+          });
+          if (result && result.ok === false) {
+            return `${t("scanFail")}${result.error && result.error.message ? " " + result.error.message : ""}`;
+          }
+          return t("scanRunning");
+        } catch (e) {
+          return `${t("scanFail")}${e && e.message ? " " + e.message : ""}`;
+        }
+      };
+      const injected = () => ({ scope, drives, runScan });
+
+      ctx.slots.inject("settings.section", () => ctx.slots.register({
+        name: "settings.section",
+        id: "dsh-disk-manager",
+        order: 210,
+        label: () => t("nav"),
+        locale: NS,
+        inject: injected,
+      }, ConfigSection));
+    }
+
+    module.exports = {
+      name: "dsh-disk-manager",
+      inject: ["slots", "locale", "settingsScope", "connection", "remote", "remote.commands", "sessions"],
+      apply,
+    };
+    return module.exports;
+  },
+});

package/config.example.json

@@ -0,0 +1,7 @@
+{
+  "enabled": true,
+  "targetDrive": "D",
+  "abandonDays": 180,
+  "minSizeMB": 50,
+  "undoLog": true
+}

package/config.mjs

@@ -0,0 +1,97 @@
+import { existsSync, mkdirSync, readFileSync, writeFileSync } from "node:fs";
+import { join } from "node:path";
+import { homedir } from "node:os";
+
+/**
+ * C盘空间规划整理大师 DSH 插件配置。
+ * 持久化位置 ~/.dsh-disk-manager/config.json。
+ * 默认目标盘为空(首次使用让用户选),180 天为"冷废弃软件"阈值。
+ */
+export const DEFAULT_CONFIG = Object.freeze({
+  enabled: true,
+  // 目标盘:首次使用由用户在 Web UI 下拉选择,如 "D"。为空则提示先选盘。
+  targetDrive: "",
+  // 冷废弃软件判定:超过该天数未使用视为"可能废弃"(类 D)
+  abandonDays: 180,
+  // 扫描根目录:整 C 盘用户区 + Program Files(不扫 Windows)。
+  // 页面统一显示为"整 C 盘";内部聚焦这些能发现真实大户的区。
+  scanRoots: [
+    { root: "C:\\Users\\Administrator\\AppData\\Local", zone: "appdata" },
+    { root: "C:\\Users\\Administrator\\AppData\\Roaming", zone: "appdata" },
+    { root: "C:\\Users\\Administrator", zone: "user" },
+    { root: "C:\\Program Files", zone: "program" },
+    { root: "C:\\Program Files (x86)", zone: "program" },
+  ],
+  // 最小展示体积阈值(MB),低于此不列,避免刷屏
+  minSizeMB: 50,
+  // 用户黑名单:这些路径标签永远只展示不执行
+  blacklist: [
+    "\\Programs\\",
+    "\\Packages\\",
+    "\\Microsoft\\Windows",
+    "\\Windows\\",
+  ],
+  // 是否生成 undo 日志(junction 迁移/删除可再生缓存时)
+  undoLog: true,
+});
+
+export function configDir() {
+  return join(homedir(), ".dsh-disk-manager");
+}
+
+export function configPath() {
+  return join(configDir(), "config.json");
+}
+
+/** 合并默认 + 配置文件 + 运行时入参(插件行 config 覆盖最高) */
+export function resolveConfig(input = {}) {
+  let file = {};
+  try {
+    if (existsSync(configPath())) {
+      file = JSON.parse(readFileSync(configPath(), "utf8"));
+    }
+  } catch {
+    file = {};
+  }
+  const merged = mergeDeep(structuredClone(DEFAULT_CONFIG), file);
+  return mergeDeep(merged, input);
+}
+
+export function saveConfig(config) {
+  mkdirSync(configDir(), { recursive: true });
+  writeFileSync(configPath(), JSON.stringify(config, null, 2), "utf8");
+}
+
+/** 分类缓存:记录"目录特征 -> 用户确认的类别",命中则跳过 LLM/人工 */
+export function classifyCachePath() {
+  return join(configDir(), "classify-cache.json");
+}
+
+export function loadClassifyCache() {
+  try {
+    if (existsSync(classifyCachePath())) {
+      return JSON.parse(readFileSync(classifyCachePath(), "utf8"));
+    }
+  } catch {
+    /* ignore */
+  }
+  return {};
+}
+
+export function saveClassifyCache(cache) {
+  mkdirSync(configDir(), { recursive: true });
+  writeFileSync(classifyCachePath(), JSON.stringify(cache, null, 2), "utf8");
+}
+
+function mergeDeep(base, patch) {
+  if (patch === undefined || patch === null) return base;
+  if (typeof patch !== "object" || Array.isArray(patch)) return patch;
+  const out = { ...base };
+  for (const [k, v] of Object.entries(patch)) {
+    out[k] =
+      typeof v === "object" && v !== null && !Array.isArray(v) && typeof out[k] === "object" && out[k] !== null
+        ? mergeDeep(out[k], v)
+        : v;
+  }
+  return out;
+}

package/cordis.patch.yml

@@ -0,0 +1,5 @@
+# dsh-disk-manager bundle patch layer.
+# 安装本包到 profile 后,host 端加载主入口(扫描/分类/执行引擎)。
+- insert:
+    - id: dsh-disk-manager
+      name: dsh-disk-manager

package/core/active.mjs

@@ -0,0 +1,70 @@
+import { execFileSync } from "node:child_process";
+
+/**
+ * active.mjs —— 判断目录对应的软件「是否正在使用/常用」。
+ *
+ * 用于修复:冷废弃(D)误判 —— 已装软件(如 Docker/Typora)的程序安装目录
+ * 只在安装当天写一次 mtime,之后每天运行也不会再改动该目录,导致
+ * "lastAccess 超 180 天"被误判为"废弃"。这里用"进程是否在跑 + 常用白名单"
+ * 作为更可靠的"是否还在用"信号,命中则不判冷废弃。
+ */
+
+/**
+ * 常用/常驻服务白名单:这些软件的目录名命中即视为"仍在用",永不判冷废弃。
+ * 即使扫描那一刻恰好没有前台进程(如开机自启、后台服务),也不误报。
+ */
+export const ALWAYS_ACTIVE = [
+  "docker", "com.docker", "wsl", "vmcompute", "lxss",
+  "dotnet", "nodejs",
+  "clash", "netease",
+];
+
+/** 快照当前所有运行进程的 ProcessName(小写、去重)。一次扫描只需调一次。 */
+export function snapshotProcessNames() {
+  try {
+    const raw = execFileSync("powershell", ["-NoProfile", "-Command",
+      "Get-Process -ErrorAction SilentlyContinue | Select-Object -ExpandProperty ProcessName | Sort-Object -Unique"], {
+      encoding: "utf8",
+      timeout: 15000,
+      maxBuffer: 8 * 1024 * 1024,
+    }).toString();
+    return raw
+      .split(/\r?\n/)
+      .map((s) => s.trim())
+      .filter(Boolean)
+      .map((s) => s.toLowerCase());
+  } catch {
+    return [];
+  }
+}
+
+/**
+ * 目录对应软件是否仍在用。
+ * @param {string} name     目录名(可能带空格,如 "Docker"/"TRAE SOLO CN")
+ * @param {string[]} procNames 运行中进程名快照(小写)
+ * @returns {boolean} true=仍在用(不判废弃)/ false=可视为未用
+ */
+export function isActive(name, procNames) {
+  const n = normalize(name);
+  if (!n) return false;
+
+  // 1) 常用白名单:命中即视为在用
+  for (const a of ALWAYS_ACTIVE) {
+    if (n.includes(normalize(a))) return true;
+  }
+
+  // 2) 进程匹配:任一运行进程名包含目录名(归一化后),视为在用。
+  //    注:进程名是"运行实例"的最直接证据,例如 Docker 运行时会有
+  //    docker / com.docker.backend / dockerdesktop 等进程。
+  for (const p of procNames) {
+    const pn = normalize(p);
+    if (pn.includes(n)) return true;
+  }
+
+  return false;
+}
+
+/** 归一化:小写,去除非字母数字(用于宽松匹配) */
+function normalize(s) {
+  return String(s || "").toLowerCase().replace(/[^a-z0-9]/g, "");
+}