Repository navigation
Releases: cosZone/MoeKit
Release list
v0.1.0-preview.14
Mole 安装与升级
- 版本提示更清楚：显示已安装版本与已测试的 1.58.0，区分格式过旧、文件未验证与版本尚未测试。现有 Homebrew 安装优先，不再笼统提示“不兼容”
- 复用现有安装：支持经过核验的官方 1.57.0／1.58.0 分析器；其他符合要求的 Homebrew 官方构建可主动联网验证，每次分析另行确认，结果仅供查看
- 终端内确认升级：先展示实际的 Homebrew 更新与 Mole 升级命令，在终端中按回车才开始；支持交互输入、Ctrl-C 与停止，结束后重新检测安装
Homebrew 会安装当前提供的版本，不保证恰好为 1.58.0。更新可能影响 Homebrew、Mole 与依赖；取消不会回滚已发生的更改。
macOS 15+，Apple Silicon / Intel。Apple Development 签名、未公证；preview.9 及更早需先手动安装一次。
v0.1.0-preview.13
修复
-
缓存扫描：修复无关废纸篓的读取限制导致缓存扫描受阻的问题
-
大小显示：受保护或部分不可读的项目也能保留已读大小；完整、部分和未知状态分开显示
-
进度与提示：显示当前扫描阶段和路径，失败时提供更明确的原因
-
扫描稳定性：修复目录项较多时可能出现的读取崩溃
使用前
大小不代表可以删除，也不等于实际可回收空间。删除仍需复查确认；废纸篓列表不完整时不能整批清空，永久删除无法撤销。
macOS 15+，Apple Silicon / Intel。发布时计划采用 Apple Development 签名，暂不公证；preview.9 及更早需先手动安装一次。
Apple Development 开发签名，未经过 Apple 公证。
v0.1.0-preview.12
- Mole 更易上手：自动检测兼容安装，缺少时提供分步准备与重新检测
- AI worktree 收尾：确认本地合入，按需另行确认推送，核验后再单独决定退役；退役保留恢复数据
- 界面更简洁：精简重复说明，About 显示完整的 preview 版本
- 菜单栏焕新：幽灵工具箱图标、快捷面板和任务状态提示，支持“减少动态效果”
macOS 15+，兼容 Apple Silicon / Intel。Apple Development 签名、未公证；preview.9 及更早需先手动安装。本地合入仅限 fast-forward；推送与退役分别确认，不自动重试不确定结果，真实远端凭据交互仍需实机验收。
v0.1.0-preview.11
新增
- 废纸篓管理：查看个人废纸篓，删除所选项目；清空已扫描快照需输入
EMPTY - Docker 清理：按选择删除闲置镜像和停止容器；全部未使用构建缓存另行确认，运行容器和卷保持保护
- 清晰的操作结果：逐项显示完成、保留或不确定状态，取消后不自动重试
使用前
永久删除无法撤销；废纸篓目前只支持当前用户的内置 APFS 卷。macOS 15+，兼容 Apple Silicon 和 Intel；Apple Development 签名、未公证，macOS 可能阻止运行。preview.9 及更早版本需先手动安装一次。
下载 DMG · ZIP · 废纸篓使用说明 · Docker 使用说明 · 开发者验证记录
源码：6b23cb267bdb · 构建与签名 · build 2.0.11
v0.1.0-preview.10
macOS 15+ · 通用版本（Apple Silicon / Intel）
先手动安装一次，后续更新交给 Sparkle
本版首次接入固定版本 Sparkle 2.10.0，由它负责检查、下载、签名验证、安装与重新启动。应用菜单、菜单栏图标和 Settings → Updates 共享同一个更新控制器；主动检查时使用 Sparkle 的标准进度、取消、版本说明和安装界面。
preview.9 及更早版本没有自动安装器，升级到本版仍需手动下载 DMG 或 ZIP，并替换应用。 旧版的检查更新只能打开 GitHub Release 页面，不能自行安装 Sparkle。先结束当前操作并退出旧应用，再按 macOS 正常安装提示处理；完成首次安装后，后续符合条件的新版本才可通过应用内更新。
安装包继续支持 macOS 15+、Apple Silicon 与 Intel。已有的项目整理、精确进程停止、原生缓存工作流、Mole 分析和单个 Downloads 磁盘映像操作保留各自的复查、确认与恢复边界。
分别选择检查、下载安装与预览渠道
- Sparkle 的标准第二次启动提示询问是否允许后台检查；Settings 可随时调整「自动检查更新」
- 「自动下载并安装更新」默认关闭，由用户另行选择。启用后，自动安装通常在退出 MoeKit 时进行；也可以主动查看并立即安装
- 检查和下载偏好交由 Sparkle 保存，应用启动不会重置用户选择
- 预览版默认包含 preview 渠道，用户可在 Settings 关闭。渠道选择单独保存，正在更新时不能切换；切换渠道不授权降级
正在执行原生清理、移入废纸篓、恢复、Git 整理、进程停止或 Mole 分析时，应用会拒绝为更新退出并显示说明。请先完成当前工作；只读扫描、导入报告与任务记录属于本次会话，重启后不保留。
项目目录清单、置顶、偏好和私有恢复记录位于应用包之外。更新替换的是 MoeKit.app，不会主动清空这些数据或用户项目，也不会因更新失败而运行清理或重置偏好。
固定更新来源与签名验证
更新源固定为本仓库专用 updates 分支上的 appcast.xml。发布流程先验证并公开不可变版本资产，再创建或非 force 更新仅含 appcast 的分支；后续提交保留分支历史，拒绝重放或降级。
应用内置经审查的 MoeKit 专用 Ed25519 公钥，要求更新源本身已签名，并在解压前验证更新 ZIP 的签名。签名失败不会随时间变成允许未签名更新，也不会自动退回未签名安装路径。发布流程核对输入公钥与源码固定值一致，再验证生成的 feed 与 archive 签名；缺少或不匹配的配置会阻止发布。
未配置、配置无效或更新器启动失败时，仍可主动打开手动 GitHub 版本检查。开发、XCTest、以 --demo 或 --disable-updates 启动的进程不启动 Sparkle；已运行发布版中的「Use demo data」只切换工作区示例数据，不会关闭应用级更新。
更新请求发往 GitHub，可能携带应用版本，服务端可见连接的 IP 地址；不发送项目／任务内容或系统画像。更新说明禁用 JavaScript。源码配置仅包含公钥，不包含私钥或其他签名凭据。完整行为与信任边界见 自动更新说明。
版本顺序与交付检查
本版完整版本为 0.1.0-preview.10，内部 CFBundleVersion 为 2.0.10；展示用的核心版本仍为 0.1.0。更新顺序使用受限的数字版本映射，与 Actions 的运行编号分开。旧版没有自动安装器，其历史构建编号不会参与此更新比较。
发布流程精确核验八份代码对象：主 App、两个原创 helper，以及固定 Sparkle.framework 与其四个嵌套组件。每份代码均检查 arm64／x86_64、标识、开发签名、Hardened Runtime 和空 entitlements；ZIP 往返与 DMG 只读挂载还会复查完整 App 内容。没有捆绑 Apple Git 或第三方 Mole 分析器，也没有新增通用 CLI 执行权限。
交付文件为 DMG、ZIP、SHA256SUMS.txt、BUILD_INFO.json 与已签名 appcast.xml。两种安装包包含同一份 universal Release App；校验和覆盖两种包、构建信息与 appcast。精确 source／run／attempt、包内容和生产签名结果以该版本实际发布记录为准。发布与首次安装步骤见 开发签名预览说明。
验证范围与安装限制
更新设置、偏好保存、渠道、启动隔离和忙碌退出保护有自动测试；独立原生更新 fixture 在 Apple Silicon 与 Intel runner 上覆盖下载、实际替换、重新启动及篡改／取消／失败拒绝。测试使用自有合成应用、loopback 更新源和非生产测试密钥；fixture 的 ad-hoc 签名未启用 Hardened Runtime，不能据此声称已在真实用户安装的生产签名 MoeKit 上完成更新，也不能证明 Gatekeeper、隐私授权迁移或 Developer ID／公证行为。
本版继续使用 Apple Development 开发签名，未经过 Apple 公证。 Sparkle 不改变这一分发限制，Gatekeeper 仍可能阻止首次安装或后续运行；DMG 格式也不改变系统信任。不要通过关闭 macOS 安全检查、删除 quarantine 或重签应用解决。完整窗口、键盘、VoiceOver、双架构实机运行与真实目录权限仍需手动验收。
preview.9 的发布记录 继续描述其原始手动更新能力与四份资产，历史标签和下载不因本版改变。文档网站独立构建与部署，不随 App 安装；广域 Mole 清理、卸载、维护、任意项目删除、任意进程停止和 AI 专用无头浏览器归属识别仍未启用。
源码：2dc1e26edd6b · 构建与测试（attempt 1）
SHA256SUMS.txt 覆盖 DMG、ZIP 与 BUILD_INFO.json；两种包内 App 的文件内容、签名与构建来源已核对一致。
Apple Development 开发签名；不是 Developer ID 分发签名，未经过 Apple 公证。Gatekeeper 仍可能阻止打开，DMG 不改变这一限制。
Release 配置单元测试在 runner 架构通过；通用归档从同一源码单独构建。原生 UI、VoiceOver、双架构实机运行与隐私授权沿用仍需手动验收。
v0.1.0-preview.9
macOS 15+ · 通用版本（Apple Silicon / Intel）
分开复查、确认与恢复的 Git 整理
Projects 新增「Git cleanup…」入口。明确选择同时包含主仓库与目标 worktree 的父目录，指定要保留的本地 base 分支，再检查一个精确目标。首个可执行范围刻意限定为普通本地 SHA-1、files refs、index v2 仓库；未知、不完整或不支持的状态保持不可操作。
- 退役一个干净的 linked worktree：逐字节核对普通 tracked 文件与 index，并验证 index tree 对应分支提交、该提交已完全包含于所选 base。确认后把工作树和对应登记移入主仓库的私有恢复目录，保留原分支；目录清单随后移除已退役工作树
- 移除一个已合并的本地分支：独立输入分支名、重新检查并另行确认，仅支持未被任何 worktree 检出的 loose ref。只把该引用移入恢复目录，保留 reflog 与 branch 配置；不改远端分支，不因退役 worktree 而顺带删除分支
- 恢复是另一次操作：本次会话内可复查记录并另行确认，恢复到原来的工作树、登记或分支路径；存在冲突时拒绝，不覆盖、不合并。工作树恢复成功后加回目录清单
退役与分支移除都需要确认已停止使用目标的编辑器、终端与 Git 操作，并输入精确分支名。各自的检查计划最多有效 120 秒、只能使用一次；执行前重新核对该操作所需的路径、提交、对象来源和目录清单保护范围，退役还会重新核对工作树文件与 index。恢复使用独立确认和新鲜复核，不沿用原操作的授权。
退役拒绝主 worktree、锁定或受保护目标，以及有 staged／modified／untracked／ignored 文件、独有提交或重叠项目的工作树。分支移除拒绝任何 worktree 正在检出的分支、受保护分支及不完全包含于所选 base 的提交；不会把主工作树的文件检查当作分支移除的前提。
退役和移入恢复目录不释放磁盘空间。 工作树、登记或引用保存在主仓库 .git/moekit-recovery/ 下各自的操作目录，并保留分阶段记录。没有 force、递归删除或永久删除入口；重启后不自动扫描、恢复或清除记录。引用备份不是独立 Git bundle，Git 对象仍受仓库自身保留与 GC 规则影响，不能把它当作异地备份。
两次路径移动不是跨目录事务。崩溃、I/O 错误或并发变化可能留下部分结果；界面保留恢复位置并停止，不自动猜测、继续或重试。普通协作锁和有界复核不能证明所有进程均未使用目标，也不能保证抵御恶意同用户并发写入。
Git 执行范围与工具来源
普通项目发现和 Git 元数据展示仍是只读，未启用通用的实时 git status。整理检查由原创原生读取器解析 index、计算 blob／tree 并核对文件集合，不运行项目脚本、hooks、filters 或 live 仓库中的 Git 命令。
仅尝试固定位置已安装的 Apple Command Line Tools／Xcode Git，要求 Apple 签名及受支持版本；缺失、旧版、来源未知或不支持固定操作时拒绝，不自动安装、下载或回退。经验证的临时 Git 副本只读取 app 自有、隔离于 live 配置的对象副本，用于固定版本、tree 与祖先关系查询，不收到 live 仓库或 worktree 路径。外部配置、协议和 lazy fetch 均禁用；这不是 OS 沙箱。
配置 includes／filters、非默认内容转换、shallow、alternates、replace、reftable、packed 目标分支、split／sparse index、冲突、symlink／submodule 等布局保持不支持。检查有文件大小、数量、深度和分阶段时间／资源预算；取消会阻止后续查询，但不承诺同步文件读取或正在运行的私有查询即时停止。完整支持范围、部分恢复与限制见 Git 整理设计。
Dock 与菜单栏入口分别设置
- 原生菜单栏入口提供打开 MoeKit、设置、检查更新和退出；应用菜单也提供检查更新，Command-0 可返回主工作区
- Settings → App icons 中分别保存 Dock 与菜单栏图标的选择，默认均显示；两项互不隐式改变，可以同时隐藏
- 两个图标都隐藏时会显示恢复说明，可从 Finder 或 Spotlight 再次打开 MoeKit，重开已有工作区；另有设置或关于窗口时也不阻挡此恢复路径
- 关闭窗口不等于退出应用，工作区共享状态保留；各项分析、清理和确认仍遵守自身取消／撤销规则，不能据此假定所有任务都会在后台继续
打开设置、关闭窗口或恢复工作区不会自动开始项目扫描、清理或更新检查。实现及原生交互验收清单见 更新与应用入口。
主动检查 GitHub 新版本，手动下载安装
从应用菜单、菜单栏或 Settings 主动检查本仓库的公开 GitHub Releases。预览版本按数字比较，区分正式／预览渠道；开发构建只报告发现的版本，不把缺失的完整预览版本信息猜成“已是最新版”。重复点击复用一次在途请求，取消、关闭更新窗口或切换渠道后，迟到结果不能覆盖新检查。
请求不使用认证、cookie 或持久网络缓存，不发送项目和任务数据；GitHub 仍会收到网络连接的 IP 地址。超时、限流、离线、错误或不完整响应会明确显示，不冒充检查成功。
发现版本后只打开由已验证版本号构造的本仓库 Release 页面，下载与安装仍由用户在浏览器中完成。尚未启用 Sparkle 自动下载、安装或后台更新；仍需经审查的依赖、专用公开更新 key、受控 HTTPS feed 和签名发布配置，不能用手动检查入口代替这些前提。
验证与交付边界
回归覆盖真实／Demo 隔离、过期与重复确认、目标／目录清单变化、Git 拒绝路径、恢复冲突及部分结果；实际退役、分支移除和恢复仅操作唯一标记的测试自有仓库。进程与缓存操作同样使用测试自有 fixture，不停止用户进程、不清理用户缓存。原生菜单事件、图标组合、窗口重开、更新请求取消与迟到响应，以及英／简中视图都有自动检查。
完整 Debug、优化 Release、定向 AddressSanitizer、原生 fixture、helper 与渲染结果须按最终源码对应 CI 核实。发布构建的单元测试与显式 opt-in 原生检查分别记账；跳过不算通过。安装器使用证据若仅验证非空映像环境中的正确拒绝，就不能记为当前 noUseObserved，也不能据此绕过真实操作的使用检查。
发布流程仅允许主 App、原创 MoleAnalysisSupervisor 和原创 GitObjectInspector 三份代码，逐个执行 arm64／x86_64 签名验证；不捆绑、下载或重签 Apple Git，也不捆绑第三方 Mole 分析器。DMG 与 ZIP 包含同一份通用 Release App，支持 macOS 15+、Apple Silicon 与 Intel，并附 SHA256SUMS.txt 和 BUILD_INFO.json。具体源码、构建、签名及公开下载校验以实际发布记录为准。
继续使用 Apple Development 开发签名，尚未公证，Gatekeeper 仍可能阻止打开；DMG 格式不改变这一限制。完整窗口交互、键盘、VoiceOver、双架构实机运行和真实用户目录权限仍需手动验收，合成视图与 CI 不替代这些检查。
preview.8 安装包不包含本页新增的 Git 整理、菜单栏／Dock 设置与手动更新检查。此前的精确进程停止、原生缓存工作流、Mole 分析与单个 Downloads .dmg 操作继续保留各自确认和恢复边界；广域 Mole 清理、卸载、维护、任意项目删除、AI 专用无头浏览器归属识别和 Sparkle 自动更新仍未启用。文档网站独立构建和部署，不随 App 安装。
源码：c5de70153e2e · 构建与测试（attempt 1）
SHA256SUMS.txt 覆盖 DMG、ZIP 与 BUILD_INFO.json；两种包内 App 的文件内容、签名与构建来源已核对一致。
Apple Development 开发签名；不是 Developer ID 分发签名，未经过 Apple 公证。Gatekeeper 仍可能阻止打开，DMG 不改变这一限制。
Release 配置单元测试在 runner 架构通过；通用归档从同一源码单独构建。原生 UI、VoiceOver、双架构实机运行与隐私授权沿用仍需手动验收。
v0.1.0-preview.8
macOS 15+ · 通用版本（Apple Silicon / Intel）
复查并停止精确选择的进程
Processes & Ports 新增真实进程停止。主动扫描后，可选择 1–16 个符合条件的当前用户进程，复查每个身份、可执行文件、工作目录、端口及关联警告，确认未保存工作和依赖任务的影响后发送 SIGTERM。不会默认选择目标，也不会按名称、项目、进程组或父子关系扩展选择。
- 每次确认使用 60 秒内有效的一次性授权，执行前重新读取整组选中身份，并在逐项发送前复查。目标、执行版本、权限或必要元数据变化／无法读取时拒绝；刷新、筛选、选择、取消或 Demo 模式改变会使旧确认失效
- 使用内核 audit token 绑定 PID 与执行版本，拒绝已退出、PID 复用或重新执行后的旧身份；没有只凭 PID 发信号的回退，不提权、不运行 shell 命令
- 发送成功仅表示信号已提交。界面分别报告已观察到退出、仍在运行或未知；仅在温和停止后仍观察到同一身份时，才允许重新复查并另行确认
SIGKILL。没有自动升级、自动重试或后台停止 - 浏览器、应用、IDE、数据库、虚拟机、共享服务、系统、MoeKit 自身及祖先进程仍受保护。未标记保护不证明可安全停止；停止目标的自身处理逻辑也可能影响子进程和外部任务
- 不读取参数、环境变量或浏览器资料，不保存或上传进程历史。工作目录、端口、名称或运行时长不能证明 AI 专用无头浏览器的归属；这类会话识别与清理仍未实现
原生多缓存清理与恢复
Tools → Mole → Cleanup 新增主动检查、选择、复查和确认的原生缓存工作流。默认支持当前用户 ~/Library/Caches 的直属缓存目录；当前用户主目录内其他所选位置的直属候选目录必须含有效标准签名的 CACHEDIR.TAG，且不在 Git 树内。位置和标记仅提供候选依据，不能证明内容可丢弃。
- 必须复查精确路径和完整内容清单，确认已停止相关应用／构建／同步，并确认所有选中内容可以重新生成，才能移入 macOS 原生废纸篓。只操作固定选中批次，不运行广域 Mole
clean／purge - 每批最多 16 个缓存、共 25,000 个清单项目；检查受时间与数量预算限制。超限、未知或不完整证据保持不可操作。目录祖先不能含符号链接，清单内的链接只按链接处理，不跟随目标
- 仅开放当前用户的内置本地 APFS 范围。项目／worktree／Git 元数据、系统与安全缓存、凭据及 MoeKit 控制目录、云占位和未知权限／ACL／卷状态保持保护；普通项目的
build、dist、target或node_modules不会因为名字而获得删除权限 - 准备计划只读；120 秒内的一次性确认固定整批目标和清单。目录、选择、项目保护或模式改变会使计划失效。确认后重新核对整批，再逐项捕获并验证身份后移入原生废纸篓，错误或取消会停止后续项目
- 私有记录只关联本次实际操作。恢复需主动读取记录、重新复查并另行确认，只回到原路径；目标已存在时拒绝，不覆盖、不合并，也不自动恢复
移入废纸篓不释放缓存占用的存储。缓存重新生成可能需要重新下载或使首次运行变慢；使用前应了解选中应用的行为。这套检查面向已停止相关工作负载的普通本地使用，不是 OS 沙箱，也不能阻止持有旧文件描述符的进程继续写入或保证抵御恶意同用户进程竞争。
永久删除必须另行确认
只有本应用已完成且内容未改变的缓存废纸篓记录，才能进入独立的永久删除复查。再次展示精确目标与完整清单，确认不可恢复后，才执行这一项记录的删除；不扫描任意废纸篓内容，不清空整个废纸篓，也不改变既有 Downloads .dmg 恢复入口的边界。
删除前再次捕获并验证整棵树，再依据不可变清单逐项移入私有槽并核对身份后移除。新出现的路径不会加入删除范围；描述符预算不足时在确认前拒绝。部分删除或未知结果保留可见记录，不自动重试，也不把文件消失当作成功。该操作不能通过 MoeKit 或废纸篓撤销。
报告字节数表示逻辑内容大小，不等于已释放物理空间；打开的文件、硬链接、APFS 快照／克隆可能继续保留物理块，永久删除也不保证立即等量回收空间。
验证范围与预览交付
回归覆盖一次性授权、过期、取消、重复确认、真实／Demo 边界、身份与执行版本变化、受保护目标、清单变化、恢复冲突及部分／未知结果。原生信号测试仅启动并操作测试自有辅助进程，核对实际 SIGTERM／SIGKILL、旧执行版本拒绝与未选同名邻居存活；原生缓存 Trash／恢复／永久删除测试只操作唯一标记和身份约束的合成 fixture，不清理真实用户缓存。
构建、完整 Debug／优化 Release 测试、定向 AddressSanitizer、原生 fixture 与中英文渲染的结果，必须按最终源码对应 CI 记录核实。合成视图和自动化检查不等于完整原生窗口、键盘、VoiceOver、双架构实机或真实用户目录权限已通过手动验收。
0.1.0-preview.7 安装包不包含本页新增的进程停止与缓存工作流。实验性真实 Git status／Git 清理、菜单栏与 Dock 改进、手动更新入口不计入本版；广域 Mole 清理、卸载、维护、项目删除和 Sparkle 自动更新仍未启用。
继续沿用包含同一份通用 Release App 的 DMG 与 ZIP，支持 macOS 15+、Apple Silicon 和 Intel，并附 SHA256SUMS.txt 与 BUILD_INFO.json。具体源码、构建、签名与下载校验以实际发布记录为准。使用 Apple Development 开发签名，尚未公证，Gatekeeper 仍可能阻止打开；DMG 格式不会改变这一限制。文档网站独立构建和部署，不随 App 安装包交付。
源码：b0bdd59ff672 · 构建与测试（attempt 1）
SHA256SUMS.txt 覆盖 DMG、ZIP 与 BUILD_INFO.json；两种包内 App 的文件内容、签名与构建来源已核对一致。
Apple Development 开发签名；不是 Developer ID 分发签名，未经过 Apple 公证。Gatekeeper 仍可能阻止打开，DMG 不改变这一限制。
Release 配置单元测试在 runner 架构通过；通用归档从同一源码单独构建。原生 UI、VoiceOver、双架构实机运行与隐私授权沿用仍需手动验收。
v0.1.0-preview.7
macOS 15+ · 通用版本（Apple Silicon / Intel）
找到兼容的 Mole 分析器
Mole 的工具准备窗口改为提供实际分析适配器支持的 V1.57.0 官方发布 文件，按当前应用架构显示 analyze-darwin-arm64 或 analyze-darwin-amd64 的固定下载地址、文件大小和 SHA-256，不再默认推荐不兼容的 Homebrew 安装。
- 可以查看并复制下载命令，再自行审阅和运行。命令在主目录创建新的私有文件夹，下载固定文件，核对大小和 SHA-256 后才添加执行权限，并显示可供选择的
analyze-go路径 - 复制本身只更新剪贴板，不打开终端、不下载、不安装或运行分析器；命令不会覆盖已有安装、修改 PATH、执行上游安装脚本或自动删除下载目录
- 增加官方脚本安装的常见位置
~/.config/mole/bin/analyze-go。找到文件仍只表示“已找到 · 未验证”；每次分析都重新校验实际文件并确认范围，不能选择mo包装脚本 - Homebrew、自编译和其他版本仍不受支持。浏览器下载可能带有隔离标记；应用与复制命令都不移除隔离标记或绕过 Gatekeeper，遇到安全警告时不要通过换下载途径规避
将一个下载磁盘映像移到废纸篓
在 Tools → Mole → Space 对当前用户的真实 Downloads 目录完成一次受支持的 Mole 分析后，可从当前结果中选择一个直接位于该目录下的常规 .dmg，独立复查路径、大小、检查范围与影响，明确确认安装及使用已经结束，再移到 macOS 原生废纸篓。分析结果只提供选择线索；新的检查与这一次确认才允许操作。
- 只支持本地内置 APFS，且每次重新核对文件及祖先目录身份、权限与 ACL、项目列表保护和可观察的使用状态。不支持
.pkg、嵌套文件、批量操作、项目或 worktree、链接、云占位、网络或可移动卷；未知或改变的证据会拒绝操作 - 必须取得完整且为空的已挂载磁盘映像清单。只可自行推出自己打开的映像；系统管理的映像应保持原状，它们存在时该操作可能持续不可用。MoeKit 不自动推出任何映像
- 使用检查只覆盖可完整读取的当前用户文件描述符与 fileport，不证明全局未使用；内存映射、其他用户、系统服务及检查后新出现的使用不在证明范围内
- 导入 JSON、Demo 和单独选择路径不能授权移动文件。选择、分析、模式或项目列表改变会使旧计划失效；确认仅可使用一次，计划过期后需要重新复查
- 启动和打开页面不会自动扫描；主动准备计划只执行只读复查，不创建恢复记录或移动文件。移到废纸篓不会立即释放磁盘空间，也不代表文件内容已经被判定为可以丢弃
恢复需要另一次确认
确认操作后，MoeKit 在自己的私有应用数据目录保留操作记录，并核对 macOS 返回的实际废纸篓位置与文件身份。恢复入口只读取这些记录，不扫描任意废纸篓内容，也不自动重试或恢复。
恢复必须重新检查当前文件及原始目录，并对这份记录另行确认；只尝试回到原来的 Downloads 路径，目标已经存在时绝不覆盖。废纸篓被清空、文件身份或卷改变后可能无法恢复；不确定结果会保留可保留的数据并停止，不把文件消失当作成功。Finder 的“放回原处”可能指向内部暂存位置，应使用 MoeKit 的凭据恢复入口复查原路径。
此边界面向普通、合作的本地使用，不保证抵御恶意同用户进程竞争，也不保证检查之后无人打开文件。这项原生文件操作不清空废纸篓、不永久删除文件、不提权、不发送进程信号或修改系统安全设置。
验证范围与预览交付
新增单次确认、取消与过期、真实／Demo／导入边界、文件替换、ACL 与挂载拒绝、记录失败、恢复冲突和不确定结果的回归检查；原生 Trash／恢复测试只操作唯一且由测试持有的合成目录与文件。中英文确认和恢复视图增加渲染与可见性检查。
原生使用检查需要按对应提交的 CI 记录区分“当前完整检查未观察到使用”和“不支持当前运行环境”；历史正例或句柄诊断不能授权当前文件操作。具体构建、测试、签名及下载校验以最终发布记录为准。合成渲染和自动化检查不等于完整原生窗口、键盘、VoiceOver、双架构实机或真实用户目录权限已通过手动验收。
广域 Mole 清理、卸载、维护、项目删除、任意进程停止和真实 Git status 仍未启用；实验性 Git 工作不包含在本版。现有目录分析保持逐次确认，不因新增废纸篓入口变成自动清理。
继续沿用包含同一份通用 Release App 的 DMG 与 ZIP，支持 macOS 15+、Apple Silicon 和 Intel，并附 SHA256SUMS.txt 与 BUILD_INFO.json。使用 Apple Development 开发签名，尚未公证，Gatekeeper 仍可能阻止打开；DMG 格式不会改变这一限制。文档网站独立构建和部署，不随 App 安装包交付。
源码：a420ade54c8a · 构建与测试（attempt 1）
SHA256SUMS.txt 覆盖 DMG、ZIP 与 BUILD_INFO.json；两种包内 App 的文件内容、签名与构建来源已核对一致。
Apple Development 开发签名；不是 Developer ID 分发签名，未经过 Apple 公证。Gatekeeper 仍可能阻止打开，DMG 不改变这一限制。
Release 配置单元测试在 runner 架构通过；通用归档从同一源码单独构建。原生 UI、VoiceOver、双架构实机运行与隐私授权沿用仍需手动验收。
v0.1.0-preview.6
macOS 15+ · 通用版本（Apple Silicon / Intel）
使用 Mole 分析一个目录
在 Tools → Mole → Space 选择“使用 Mole 分析…”，选择受支持的直接分析器与一个目录，复查计划并确认后，运行分析、读取真实 JSON 结果并显示覆盖状态。选择文件或打开页面本身不会启动分析，已有 JSON 报告导入仍可独立使用。
- 仅支持 Mole V1.57.0 官方发布 的原始 arm64／x86_64 分析器及精确校验和。Homebrew、自行编译和其他版本不受此适配器支持；
mo包装脚本也不能代替直接分析器 - 每次运行前确认选定目录、版本与权限范围，并明确披露私有分析器副本、缓存和临时目录的创建与回收。MoeKit 不自动下载或安装 Mole，不修改其原有缓存，不移除隔离标记或绕过 Gatekeeper
- 分析以普通用户权限运行，不是 OS 沙箱。已审查的固定分析路径不修改或删除所选内容，但附带的元数据读取可能超出所选目录；结果不代表全盘物理占用或可回收容量
- 支持取消，并限制分析器运行时间、CPU 和输出；只接受与当前目录匹配且通过路径、身份与覆盖校验的报告。部分覆盖、不可用、失败和取消分别呈现，不伪装成完整成功
- 安装包仅新增 MoeKit 自己编写的进程管理辅助程序，Mole 上游可执行文件仍由用户另行提供；辅助程序与主 App 使用固定标识分别签名并验证
工具准备与状态提示
Settings → Tools 和 Mole 的工具准备窗口可主动检查固定常见位置，或选择另一个候选文件。此检查只读取元数据，不执行文件或版本探测；“已找到 · 未验证”不等于兼容或允许执行，也不能替代 Mole 分析的精确校验。
官方安装指引可查看或复制固定命令；复制不会打开终端或自动安装。Homebrew 安装指引不表示其产物符合本版 Mole 分析器白名单。检查结果只保留在当前会话，Demo 不读取真实工具位置。
文件、保存与 Demo 边界
- 项目发现以已打开的目录为基础遍历和读取元数据，范围内的目录遍历与元数据读取不跟随符号链接，并限制同时持有的描述符；可观察到的替换或重命名显示为未知或未读，不转而扫描替换目录
- 采用同一协议的 MoeKit 实例通过永久协调锁串行保存项目列表。忙碌与外部更改分别报告，避免把旧快照直接覆盖为新内容；不自动合并或修复。旧版 App、同步工具与任意外部编辑器不一定遵守该锁
- 切换 Demo 会清理临时错误并取消旧任务的界面所有权；旧进度、结果和错误不能覆盖新操作。项目列表存储恢复提示只在真实模式出现，系统错误中的原始路径与解码上下文不直接显示在弹窗中
- 这些检查不是跨文件系统快照或全面的恶意同用户进程隔离，也不保证远程 I/O 硬超时、任意外部写入者之间的无竞争或断电持久性
验证与未启用能力
CI 在唯一合成目录中运行官方固定版本分析器，检查正常与部分覆盖结果；另用可控的合成工具和报告验证拒绝路径、取消、资源限制与私有会话回收。发布还需验证固定辅助程序的双架构签名和 DMG／ZIP 一致性，以最终发布记录为准。实际用户目录、完整原生窗口交互、键盘、VoiceOver 和双架构实机仍需手动验收。
清理、卸载、维护、任意进程停止和真实 Git status 仍未启用；实验性 Git 工作不包含在本版。Mole 分析的取消只针对该次运行自己创建的进程组，不是 Processes & Ports 的停止功能。
同仓文档网站补充了搜索参数验证与明确的开发依赖公告例外跟踪；该例外不代表上游漏洞已经修复。网站独立构建和部署，不随 App 安装包交付，也未因此配置公开站点。
继续提供通用 DMG 与 ZIP，使用 Apple Development 开发签名，尚未公证。
源码：20504353f96a · 构建与测试（attempt 1）
SHA256SUMS.txt 覆盖 DMG、ZIP 与 BUILD_INFO.json；两种包内 App 的文件内容、签名与构建来源已核对一致。
Apple Development 开发签名；不是 Developer ID 分发签名，未经过 Apple 公证。Gatekeeper 仍可能阻止打开，DMG 不改变这一限制。
Release 配置单元测试在 runner 架构通过；通用归档从同一源码单独构建。原生 UI、VoiceOver、双架构实机运行与隐私授权沿用仍需手动验收。
v0.1.0-preview.5
macOS 15+ · 通用版本（Apple Silicon / Intel）
先了解，再开始
- 新增原生上手引导，提供“整理我的项目”“查看进程与端口”和“先看看示例”三个入口，先说明当前可用功能、读取范围与下一步
- 只有首次使用、真实项目列表健康且为空时才自动展示；已有项目、列表读取出错或显式 Demo 启动时不会自动弹出
- 可以返回、跳过或关闭，也能从 Help → Getting started、Settings → General → Getting started 重新打开；关闭记录仅额外保存一个本地引导版本整数，不记录所选目标、路径或时间
- 引导完成后进入对应工作区。进入 Projects 或 Processes & Ports 不会自动扫描、打开文件夹选择器或请求权限，仍需主动选择文件夹或点击 Start scan / Refresh
空状态给出下一步
- 空项目、任务、未扫描进程与未导入的 Mole Space 页面说明各自实际可用的操作，不再让新用户只面对空表格
- Mole 尚未接入的能力提供返回已实现 Space 报告导入的入口；不会执行清理、卸载或维护
- 修正空 Tasks 表格内容区域的宽度收缩，并覆盖引导、空工作区和现有 Demo 任务的渲染检查
数据与验证范围
“先看看示例”使用现有 Demo 样例与持续可见标识；进入 Demo 不扫描目录或进程、不导入报告，也不把示例写入真实项目列表。应用初始化仍会加载已有本地项目列表，引导不会替换或修复该文件。
补充了首次展示、跳过／关闭、被打断后再次启动、返回与重开、真实／Demo 切换、无扫描副作用和列表原数据保留的状态测试。中英文、浅深色及两种尺寸的测试自有视图已检查；较小尺寸的引导内容可以滚动。
合成渲染没有操作实际桌面窗口。窗口前后顺序、关闭最后一个主窗口后的重新打开、焦点、键盘遍历、VoiceOver 和真实 Mac 权限仍需手动验收，不把模型测试和图片检查当作这些交互已经通过。
真实 Git 状态仍为“Not checked”；Mole CLI 执行、目录清理、进程停止与强制停止均未启用。继续提供通用 DMG 与 ZIP，使用 Apple Development 开发签名，尚未公证。
源码：c54eb38eaa56 · 构建与测试（attempt 1）
SHA256SUMS.txt 覆盖 DMG、ZIP 与 BUILD_INFO.json；两种包内 App 的文件内容、签名与构建来源已核对一致。
Apple Development 开发签名；不是 Developer ID 分发签名，未经过 Apple 公证。Gatekeeper 仍可能阻止打开，DMG 不改变这一限制。
Release 配置单元测试在 runner 架构通过；通用归档从同一源码单独构建。原生 UI、VoiceOver、双架构实机运行与隐私授权沿用仍需手动验收。