Skip to content

WeQ 存储管理 ​

设置 → 常规 → WeQ 存储管理仅负责数据与缓存清理,不再提供默认保存目录、保存方式或缓存目录配置。已有偏好与实际目录保持不变。关于 WeQ → 配置备份与恢复提供独立配置操作,不嵌入空间清理组件。「优先使用 CDN」位于凭据与数据 → 资源加载,不影响存储清理范围。

统计范围 ​

  • 平台 WeQ 数据根:配置、模型、日志、托管 QQ、诊断、合并转发归档等。
  • 当前缓存根与默认缓存根:即使改过缓存目录,仍统计默认目录里遗留或继续写入的数据。
  • Electron 提供的 userData、sessionData、logs 目录,以及系统缓存、更新下载与安装资源目录。开发态不扫描源码、node_modules 或构建产物。
  • Web 宿主的导出目录。
  • 上述目录中新出现或未识别的文件/目录自动接入,只读展示,不因名称带 cache 就允许删除。

不额外扫描其它 QQ 数据目录、用户任意选择的外部导出目录或整个系统临时目录。应用数据根中的托管 QQ 目录会计入,但可能包含该托管实例自己的聊天库,不能当成普通缓存。

数字是文件逻辑字节数,不是卷实际分配空间;符号链接只计链接本身,不遍历目标。显式配置的数据根先解析真实路径,目录别名去重,嵌套根按最具体归属统计,避免重复。扫描有访问上限,权限错误或达到上限时明确标记统计不完整,不提供该项清理。

清理列表按用途合并同类项目:当前与旧默认目录的同类缓存合并一行,桌面磁盘、代码、GPU 和着色器缓存统一显示为「桌面运行缓存」。一行保留全部来源路径,选择后仍以原始 ID 逐项核验和执行。数据库及程序备份保留按份选择,清除影响不同的数据不合并。零占用且统计完整的项目、空分类与仅含系统辅助文件的分类不显示;读取异常不能当作空项隐藏。

清理边界 ​

普通缓存包括 avatar、media、marketface、marketpack、voice、linkpreview、sysemoji、collection、qqshow、dress_shared,包含旧默认目录。voice 为语音解码文件,不是持久识别结果。共享装扮资源清除会提示当前字体、气泡与挂件可能暂时不可用,需重新进入账号按需下载,不删除账号装扮设置。

dress 是混合目录:下载器生成的顶层 <sha1(URL)>.(png|jpg|gif|webp) 图片单列为预览缓存;目录、链接、未知文件和自定义背景不混入普通缓存清理。其余装扮资源和自定义背景可单独选择风险清除,旧配置保留,两项统计不重复。

防撤回目录只有功能配置,不出现在空间清理中,也不能作为清理目标;设置恢复暂存同样归配置管理。intent_sense、db_tolerance、agentlab 和 dress 按非配置文件统计与清理:保留 config 子目录、config.json、assistant.json、bot_exports.json、manifest.json 及这些文件的附属备份/临时文件,不计入本页占用。意图分析结果、容错账本、克隆体与会话记忆、旧装扮资源仍可清理。克隆体本身是用户创建的业务对象,删除其数据包含人格定义与训练样本,不等同于重置应用或助手设置。执行时重新枚举,不删除父目录,因此扫描后新增的配置也保留。当前及旧默认缓存目录使用同一规则;符号链接不跟随、不清除。

其余已识别的持久业务数据可明确选择后清除,每项展示具体损失说明。备份页只提供「恢复默认设置」,通过独立事务按字段恢复通用与各账号功能偏好,API、目录和连接设置按确认选项处理,不再删除整个配置目录或全局配置文件,备份包内容不变。Electron 的 Cache、Code Cache、GPUCache 及着色器缓存归入其他可再生成缓存;保留原有占用检测及重启重试。远程连接身份、Local Storage、Cookie、Preferences、锁文件等标记为 management: runtime,仅保留后台占用统计,不显示在空间清理或备份页,也不开放通用删除。按用途分类,不把这些小型状态文件当成腾空间的目标。闪传成品及其旧目录不开放通用清理;任务状态与新下载的成品目录分离。安装资源由系统卸载管理;未知业务目录、符号链接、嵌套受保护根及不完整统计仍不开放。

风险项不参与未勾选时的默认缓存清理。「开始清理」固定在列表底部,确认框逐项展示影响。先直接清除闲置项目,仅对被占用的剩余项目另行确认是否重启。退出助手仅收到 will-quit 的明确提交、且确认宿主进程消失后才删除。未提交或宿主未退出不执行。修复/回滚、导出及模型下载在途时拒绝重启提交。结果写入 userData/storage-maintenance/last-result.json,助手完成清理、写入回执并移除清理锁后自动重开 WeQ;报告不冒充卷实际可用空间变化。

storage_inventory.ts 在通用统计后补充业务分类、管理归属及操作类型,并替换修复根的整体条目:备份按份统计,历史、报告和工作文件分别统计。跨当前、旧默认和自定义修复目录关联记录。关联备份复用 DbRepairHistory.deleteBackup,确认删除成功后再严格持久化 purgedAt;服务端历史缓存在入口重新加载。未知备份只读。repair-backups 仅对元数据及文件清单可确认的程序备份开放单独清理。旧工作区 ID 不再出现在可清理目标中。

重启计划由桌面主进程生成,不接受渲染进程传入路径。macOS 和 Windows 直接执行原应用程序,Linux AppImage 从原镜像路径启动而不是临时挂载中的二进制;开发模式重新启动 electron-vite 工具链。新进程移除清理助手的 ELECTRON_RUN_AS_NODE 与旧开发环境,并使用手动重启参数打开窗口,不沿用隐藏自启身份。退出前核对启动程序存在,原应用和重启资源不参与删除。

Web/远程宿主没有本机退出清除能力时只展示这些项目,要求在电脑桌面端操作。不扫描或额外清理其它 QQ 数据目录、用户任意外部导出目录。注意 managed-qq 内可能含托管实例的本地聊天库和媒体,并非单纯安装缓存;此项单独警告本地记录可能永久丢失,用户需先退出托管 QQ 并备份。不会为了测试功能实际删除用户数据。

bootstrap.listStorageUsage 额外返回 requiresExit、confirmation 和混合目录清理模式。旧 listClearableCache / clearWeqCache 始终只处理普通缓存,即使客户端传入风险项 ID 也不删除。退出清除使用 clearStorageData,只接受明确 ID 和 acknowledgeRisk=true,后端重新生成目标,拒绝任一无效、只读或不完整项,不接受客户端路径。

删除使用异步文件系统 API;仅删除并重建成功的目录进入成功列表,失败项单独返回,不将失败删除前的估计值报成已释放空间。界面的预计值和清理结果均为近似逻辑字节数,并发写入可能造成差异。

当前文档对应 v2.7.4 · 已发布内容以 CHANGELOG 为准