WorkBuddy Tuner 卡顿诊断与性能优化助手

WorkBuddy 卡顿原因一键扫描、优化方案智能生成、性能趋势持续追踪、自巡检闭环与重装恢复。以「诊断分析 + 实时监控 + 优化执行 + 会话审计 + 学习反馈 + 自巡检 + 重装恢复」七大模块为核心：自动扫描卡顿根因（冗余进程、缓存堆积、内存超限、模型缓存）并给出最优策略；实时监控——会话上下文膨胀检测、内存/CPU/磁盘/网络五大维度实时告警与一键快速优化；生成结构化优化方案（缓存清理/进程管理/模型优化/集成管理）；审计历史会话、评估启动性能、去重与归档；通过学习反馈自动优化策略权重，生成趋势报告；定时自巡检（daily/startup 双模式，健康分 <60 自动触发升级信号建议重装）；重装恢复闭环（前置分析+资产清点+连续性清单+迁移方案，全量/选择性迁移，跨设备恢复保障）。

WorkBuddy Tuner 卡顿诊断与性能优化助手 v3.3.0

实时监控 · 卡顿诊断 · 智能优化 · 会话审计 · 学习反馈 · 趋势追踪 —— 五大模块，让 WorkBuddy 始终保持最佳运行状态

---

快速开始

直接说需求即可，无需任何命令：

text

"WorkBuddy卡了，帮我诊断一下"
"清理缓存，释放一些空间"
"最近性能怎么样，生成个趋势报告"
"审计一下我的历史会话"

小技巧：补充具体表现（"打开页面慢"、"启动要很久"）可获得更精准的诊断。

---

卡顿原理分析与预防（必读）

以下基于全网社区实证 + 官方文档交叉验证，结合 WorkBuddy Tuner 实测数据整理。

五大卡顿根因（附机理分析）

根因	现象	机理	预防方法
① 内存暴涨/进程派生过多	启动即占 9GB+，派生 32 个相关进程，16GB 机器几乎占满	启动时自动加载所有历史工作空间，多模型常驻导致内存激增	仅留 1 个主模型 + 关预加载
② 上下文膨胀	越用越卡、响应变慢、单会话"前说后忘"	AI Agent context 接近上限时指令遵循退化、工具调用退化、出现"让我回顾一下"急救行为	单会话 >30 轮开新会话；定期压缩（60-80% 为佳）
③ 缓存堆积拖慢 I/O	多窗口 Agent、频繁切换模型产生大量 .log/.tmp/.cache	滞留缓存占用磁盘 I/O，影响读写性能	定期清理 >3 天缓存
④ 多模型常驻内存激增	默认启用全部模型，8GB 设备触发页面交换→卡顿	多个 LLM 同时加载导致常驻内存飙升	仅启用 1 个主模型
⑤ 网络/代理抖动	指令挂起数秒、响应延迟高	全局代理、DNS 劫持使 API 请求重试超时	公共 DNS：119.29.29.29 / 223.5.5.5

以上 5 项是实测验证的高频根因，覆盖了 WorkBuddy 卡顿的绝大多数场景。

---

预防型问答推荐

Q1：启动即占 9GB+ 内存、频繁死机，怎么办？

答：一键诊断 → tuner.diagnose.scan 定位根因 → 优化模型配置（关预加载、只留主模型）→ 关闭未用消息平台长连接 → 清理过期缓存 → 一键生成闭环报告。这是实测最高频的卡顿场景，优先检查此项。

Q2：越用越卡、单会话"前说后忘"，怎么处理？

答：① 不同任务开不同会话；② 单会话 >30 轮就开新会话并重述关键背景；③ 大任务拆小步，每步确认方向再继续；④ 定期压缩上下文（60-80% 质量最高）。立竿见影的习惯：精准锚定文件路径+行号，别让 AI 自己搜（消耗降 10-50 倍）。

Q3：指令挂起数秒无响应，是卡死了？

答：多数情况是网络/代理问题，非真的卡死。检查：DNS 设置（建议 119.29.29.29 / 223.5.5.5）、代理配置、IPv6 查询开关。用 tuner.monitor.check_network 量化延迟，超过 500ms 即告警。

Q4：多模型导致 8GB 设备必卡，怎么解决？

答：默认启用 Hunyuan/DeepSeek/GLM 全部模型是高频根因。做法：仅启用 1 个主模型（办公选 Hunyuan，代码选 DeepSeek），关 preloadAll 预加载。用 tuner.monitor.check_memory 确认 RSS 降到安全范围（< 4GB）。

Q5：缓存堆积导致 I/O 慢，怎么预防？

答：建立"定期清理"习惯。tuner_original.optimize 的 cache 子命令先 --dry 查看可回收空间，确认无误后 --yes 执行。注意：保留 config.json / credentials 目录。

Q6：如何获得优化/重装/迁移的现成提示词？

答：直接说"给我一份性能优化提示词"或"重装初始化提示词"，内置三大支柱提示词可直接套用。

---

高效使用技巧速查（分层推荐）

立竿见影（优先执行）

技巧	做法
① 单模型 + 关预加载	办公选 Hunyuan，代码选 DeepSeek，关 preloadAll
② 关未用消息平台	QQ/飞书/钉钉/企微只用其一，其余关自动连接
③ 单会话 ≤ 30 轮	超过就开新会话，结论写文件再关闭
④ 大任务拆小步	每步先确认方向再继续，降单上下文膨胀

提质提效

技巧	做法
⑤ 三要素公式	做什么 + 有什么 + 怎么样，别让 AI 猜意图
⑥ 精准锚定	给文件路径+行号，消耗降 10-50 倍
⑦ 先本地后远程	桌面端验证无误再放远程自主跑
⑧ 主动压缩	context 到 70-80% 就 compact，别等截断

风险护栏（必读）

• ⚠️ 变更前先备份（optimize.py 写前自动 .bak，可一键回退）
• ⚠️ 远程/自动化只用于重复高、规则明、无需实时干预的任务
• ⚠️ 凭证/敏感配置只读不碰，所有写操作默认 dry-run
• ⚠️ 敏感操作不擅自执行未确认的命令

---

红线总纲

1. 不擅自执行未确认操作
2. 变更前必备份，可一键回退（.bak_<时间戳>）
3. 敏感配置（凭证/账号）只读不碰
4. 架构/批量变更先给分析再动手
5. 所有写/删默认 dry-run，需显式 --yes 才执行

---

实战教训（来自真机调优，必读）

以下教训来自 Windows 11 + CodeBuddy/Claw 全链路实战，每条 = 踩坑现象 → 根因 → 修复规则。改诊断/清理逻辑前必读。

编号	教训	防复发规则
L1	进程统计虚高 4~5 倍——匹配关键字含泛词 tencent，把微信/QQ管家/输入法全算进来	进程匹配禁用厂商级泛词，只认产品名，维护显式排除表
L2	测量自污染——diagnose.py 派生的临时 node 子进程被计入常驻数，13↔17 跳变	排除自身进程链以主进程为边界截断 + 寿命判据
L3	网络探测硬编码不存在域名——恒定扣分	任何探测端点先验证 DNS 存在性，未验证域名不得入代码
L4	cache 命令空转——报 0 个可清文件，实有 1900+	清理范围按目录白名单指定后缀+阈值，禁止全局加 .json
L5	凭经验断言"重启释放内存"——实测 2.4GB 是基线成本，非膨胀	量化承诺必须有前后实测数据，凭经验推断要标注"未实测"
L6	技能重复索引——同一技能出现 20+ 次，启动索引 328 个 SKILL.md，启动慢头号元凶	技能目录内备份须避开 SKILL.md 原名
L7	插件市场 1.1GB 残留——是更新泄漏（zip/.tmp 清理缺失），不是缓存	泄漏持续复发，每月 marketplace --dry 巡检
L8	误报诊断比没有工具更糟——引导用户修不存在的问题	新增检测项必须构造正反例各验证一次
L9	备份只有"跑通"没有"验证"——等于没有备份	任何数据搬运命令必须有 SHA256 比对回归测试
L10	凭证过滤用泛子串 token 误杀 157 个源码文件——备份"成功"但恢复后技能残缺	整词边界正则 + 三层过滤（扩展名/文件名/语义）
L11	便携归档不剪枝——1.65GB 里 1.2GB 是内置运行时/回收站等噪声	扫描/入包/清点口径必须是同一份常量

---

核心能力

能力	说明	特色
实时系统监控	五大维度实时监控（上下文膨胀/内存/CPU/磁盘/网络），自动告警 + 一键快速优化	实时告警
一键卡顿诊断	自动扫描冗余进程、缓存堆积、内存占用、模型缓存、集成状态，输出健康评分与问题清单	结构化定位
智能优化方案	基于诊断结果自动生成缓存清理/进程管理/模型优化/集成优化四类方案，预估释放空间	一键优化
会话审计	审计历史会话、评估启动性能、检测重复文件、规划归档	历史追溯
学习反馈	对优化策略打标记（有效/无效），自动调整策略权重，下次更精准	自我进化
趋势追踪	生成长期性能趋势图，识别持续恶化趋势，给出预防建议	持续监控

---

典型应用场景

卡顿诊断

问："WorkBuddy卡了" 答：健康评分 78 分，发现 3 个问题——2 个冗余进程、缓存 520MB 过期、1 个模型缓存堆积。

一键优化

问："清理缓存" 答：已生成缓存清理方案，预估释放 520MB，是否执行？

会话审计

问："审计一下我的历史会话" 答：共 30 个历史会话，2 个重复配置已标记，建议归档 5 个旧会话。

性能趋势

问："生成趋势报告" 答：近 7 天健康评分趋势为上升趋势，从 62 升至 78，优化有效。

实时监控

问："实时监控" 答：上下文 8KB / 32 轮 — 健康；内存 2.4GB/16GB — 健康；CPU 32% — 健康；磁盘 C: 120GB/500GB — 健康；网络延迟 45ms — 健康。整体：健康。

一键快速优化

问："一键优化" 答：发现 3 项优化建议——①上下文 24KB 超过阈值，建议重启会话（高优）；②缓存 1.5GB 过期，清理释放空间（中优）；③归档 12 个旧会话（低优）。

---

五大模块详解

1. 卡顿诊断（Diagnose）

扫描四大维度：

维度	检查内容
进程	冗余进程、僵尸进程、孤儿进程、异常状态
缓存	过期缓存目录、缓存大小与天数
内存	内存占用量、是否存在超限
模型	模型缓存、集成管理状态

输出：健康评分（0-100）+ 问题清单 + 最优策略推荐

2. 智能优化（Optimize）

优化类型	内容
缓存清理	按过期天数自动筛选，预估释放空间
进程管理	识别冗余进程，给出保留/终止建议
模型优化	模型缓存清理、模型重新加载
集成管理	集成状态检查、连接优化
优化报告	汇总优化效果，便于回顾

3. 会话审计（Session Audit）

• 历史审计：扫描所有历史会话，检测异常模式
• 启动评估：评估启动性能，定位拖慢原因
• 去重检测：识别重复配置、重复文件
• 归档规划：建议归档过期会话，释放空间

4. 学习反馈与趋势（Learn & Trend）

• 策略反馈：对优化策略标记有效/无效
• 权重重算：根据反馈自动调整策略优先级
• 趋势生成：生成健康评分变化曲线
• 趋势建议：识别下降趋势，给出预防行动

5. 实时监控（Monitor）

五大维度实时告警 + 一键快速优化：

监控维度	检测内容	告警阈值（默认）
上下文膨胀	会话上下文大小（KB）、对话轮数、消息数	超过 16KB 或 50 轮告警
内存占用	系统总/可用内存、WorkBuddy RSS、缓存大小	RSS > 4GB 或可用 < 15% 告警
CPU 占用	CPU 总使用率、WorkBuddy 进程 CPU、线程数	CPU > 80% 告警
磁盘空间	各分区可用空间、使用率、大文件积压	可用 < 10GB 告警
网络延迟	API 端点延迟、连接成功率、丢包率	延迟 > 500ms 告警

告警等级：健康（绿色）→ 需关注（黄色）→ 严重（红色）

监控工具集：

工具	功能
check_context	会话上下文膨胀检查
check_memory	内存占用实时监控
check_cpu	CPU 占用实时监控
check_disk	磁盘空间与 IO 监控
check_network	网络延迟监控
quick_fix	一键快速优化综合方案
setup_alerts	自定义监控阈值与告警规则
status_report	生成实时状态报告

告警→优化闭环：

text

设置告警阈值 → 实时数据采集团续 → 阈值比对 → 触发告警 → 一键快速优化 → 记录效果 → 持续追踪
       ↑                                                                                    │
       └──────────────────────────────────────────── 告警阈值可调整 ─────────────────────────┘

说"实时监控"触发全维度检查；说"一键优化"触发综合快速优化；说"设置告警"自定义各维度阈值。

6. 定时监控与自动扫描（Auto Scan）

通过 WorkBuddy Automation 实现周期性自动监控，无需人工干预，系统异常时自动推送评估报告。

使用方式：在 WorkBuddy 中创建自动化任务，定期调用 tuner.monitor.auto_scan，即可实现全维度自动扫描。

扫描资源影响（基于实测数据）

实测单次完整扫描（5 个维度 WMI 采集）耗时约 7.4 秒。不同扫描频率的资源消耗如下：

扫描间隔	每日次数	每日总耗时	CPU 占用	适用场景
5 分钟	288 次	~35 分钟	2.5%	不推荐，系统开销过大
10 分钟	144 次	~18 分钟	1.2%	不推荐，明显影响用户体验
30 分钟	48 次	~6 分钟	0.4%	可用但非最优
60 分钟	24 次	< 3 分钟	< 0.1%	推荐，性价比高

推荐扫描间隔：60 分钟

• 每日 24 次扫描，总耗时 < 3 分钟，CPU 占用 < 0.1%，用户完全无感
• 内存数据变化周期 30-60 分钟，60 分钟间隔足以捕获主要变化
• CPU 突发峰值 1-5 分钟，短期波动对整体趋势影响有限
• 磁盘空间变化以小时计，60 分钟间隔绰绰有余
• 如需高频监控，可优先启用「上下文膨胀」快速检测（耗时 < 100ms，每日可数百次）

自动扫描流程：

text

定时触发 → 采集全维度数据 → 健康评分(0-100) → 趋势判断 → 生成评估报告 → 输出建议
   ↑                                                                    │
   └──────────────────── 建议回传 → 记录效果 → 持续追踪 ──────────────────┘

评估报告内容：

字段	说明
health_score	综合健康评分（0-100）
overall	综合状态（健康/需关注/严重）
trend	趋势判断（improving/stable/degrading）
suggestions	评估建议列表（按优先级排序）
quick_fix	一键快速优化方案

告警建议生成逻辑：

text

各维度告警检测 → 严重/需关注 → 生成建议 → 按优先级排序（critical > warning > info）

• 严重：CPU > 90%、内存可用 < 15%、磁盘 < 10GB、网络 > 2000ms → 立即处理
• 需关注：健康分下降趋势、上下文膨胀、单维度超阈值 → 建议关注
• 优化建议：快速修复方案 + 预期效果

查看扫描资源影响：

问："帮我分析扫描频率的资源影响" 答：当前扫描间隔 30 分钟，每日 48 次，总耗时约 6 分钟，CPU 占用 0.4%。 推荐 60 分钟间隔，每日 24 次，总耗时 < 3 分钟，CPU < 0.1%，完全无感。 若需高频监控，建议优先启用「上下文膨胀」快速检测（< 100ms/次，每日可数百次）。

历史报告查询：

问："查看监控历史" 答：共 52 条报告，最近 7 天平均健康分 88.5，趋势稳定，最高 95，最低 72。

---

用户示例

例1：启用定时监控（推荐 60 分钟）

问："帮我设置定时监控" 答：配置已生成。在 WorkBuddy 中创建自动化任务：

• 频率：每 60 分钟
• 提示词：「运行 tuner 自动监控扫描，生成评估报告。如果有 critical 或 warning 级别告警，总结并建议处理措施。如果一切正常，简要汇报即可。」
• 保存并启用自动化 注：60 分钟间隔下每日 24 次扫描，总耗时 < 3 分钟，CPU 占用 < 0.1%，完全无感。

例2：查看扫描资源影响

问："扫描对系统有影响吗" 答：当前扫描间隔 30 分钟，每日 48 次，总耗时约 6 分钟，CPU 占用 0.4%。 推荐 60 分钟间隔（每日 24 次，< 3 分钟，CPU < 0.1%）。 10 分钟间隔（每日 144 次，~18 分钟）明显影响性能，不建议使用。

例3：修改扫描频率

问："改成 60 分钟扫一次" 答：扫描间隔已更新为 60 分钟。每日 24 次扫描，总耗时 < 3 分钟，CPU < 0.1%，系统开销极低。

例4：查看历史报告趋势

问："近 7 天监控趋势怎么样" 答：共 52 条报告，趋势稳定（上升 3.2 分），平均 88.5 分，最高 95，最低 72。无严重告警，系统状态良好。

---

优化流程

text

扫描诊断（健康评分）→ 生成最优策略 → 执行优化方案 → 记录效果 → 反馈学习 → 持续追踪
       ↑                                                                    │
       └──────────────────────────── 循环优化 ───────────────────────────────┘

---

技能矩阵智能关联

本技能是 MCP Toolbox 技能矩阵 的核心成员之一，与以下技能共享同一 MCP 服务端、结论口径一致、可协同使用：

专题	专题特色	一键查看
Flow Immersion	番茄钟·ADHD辅助·桌面沉浸·任务规划·提醒生成·专注统计	一键查看
WorkBuddy Gift Claimer	积分签到自动领取·场景识别·定时任务·遗漏补领·学习优化	一键查看

说"安装完整技能矩阵"即可一键装齐全部 3 个 MCP Toolbox 技能，已装自动跳过；也可在技能市场搜索单独安装。

---

重要提示

• 诊断与优化方案为辅助参考，不涉及系统级操作
• 历史会话审计不会修改任何文件，仅给出建议
• 学习反馈基于历史数据，不采集隐私信息

隐私保护

• 仅在本机生成随机匿名标识用于服务调用，不会采集任何设备信息或个人隐私数据。

---

技术支持联系信息：QQ-1817694478