前言¶
本地微信聊天分析往往要同时碰三块东西：用 wx-cli 拉取或对接聊天数据、Flask 提供接口、前端做展示与交互。你在改接口、调样式或排查联调问题时，如果每次都要向 AI 重复项目路径、技术栈和目录约定，对话成本会很高。SkillHub 上的「微信聊天分析器」Skill，作用是把这套约定写进 Agent 可读的 SKILL.md，在开发、扩展或排错 wechat-analyzer 时自动带上项目背景。下面介绍它是什么、能帮你做什么，以及如何安装启用。
这是什么¶
「微信聊天分析器」是 SkillHub 用户 @user_4e735797 发布的 Agent Skill，官方入口为：
https://api.skillhub.cn/user_4e735797/wechat-analyzer
社区页面（与 API 同属 SkillHub 体系）为：
https://skillhub.cn/skills/user_4e735797/wechat-analyzer
Skill 简介指向本机项目目录 ~/Desktop/wechat-analyzer：一个微信聊天分析 Web 应用，后端为 Flask + wx-cli，前端为深色主题界面。适用时机是你在开发、扩展或调试该 wechat-analyzer 工程，而不是泛泛地问「怎么分析聊天」。
在 SkillHub 分类中，它属于 data-analysis；站内展示评分 99439，累计下载 472 次（数据来自任务线索，与页面展示一致）。截至 2026-10-22，通过浏览器打开上述 SkillHub 技能页可能提示「Skill 已不存在或已下线」；若遇此情况，仍以已安装的 SKILL.md 与本地工程为准，或通过 SkillHub CLI 尝试安装包内内容。
核心功能¶
结合官方 Skill 线索，可核实的能力边界如下。
- 项目定位：明确分析对象是
~/Desktop/wechat-analyzer下的 Web 应用，而不是任意仓库名或临时脚本。 - 技术栈提示：后端 Flask 与 wx-cli 分工、前端深色主题 UI，便于 Agent 在改 API、静态资源或前后端契约时少猜架构。
- 工作场景：在扩展功能、修 bug、做联调说明时触发 Skill，让回复贴合该仓库的约定，而不是通用 Flask 或通用聊天分析模板。
Skill 遵循通用 SKILL.md 格式，由 Cursor、Claude Code、Codex 等支持 Skills 的客户端读取后注入上下文。Skill 本身不替代你在本机启动服务或配置 wx-cli；具体命令以项目内文档为准。
安装与启用¶
安装流程以 SkillHub 官方说明为准：https://skillhub.cn/install/skillhub.md。
1、安装 SkillHub CLI（若尚未安装）¶
先检查是否已有 CLI：
command -v skillhub && skillhub --version
未安装时，可用官方脚本（需网络）：
curl -fsSL https://skillhub-1388575217.cos.ap-guangzhou.myqcloud.com/install/install.sh | bash
仅安装 CLI、不装默认 Skill 时：
curl -fsSL https://skillhub-1388575217.cos.ap-guangzhou.myqcloud.com/install/install.sh | bash -s -- --cli-only
2、安装本 Skill¶
SkillHub 页面提供的安装提示为：根据 https://skillhub.cn/install/skillhub.md，安装 @user_4e735797/wechat-analyzer。
CLI 安装时需把技能装进当前 Agent 识别的 skills 目录（文档要求使用 --dir，否则默认 ./skills/ 可能不会被加载）。常见路径示例：
| 客户端 | Skills 目录（示例） |
|---|---|
| Cursor | ~/.cursor/skills/ |
| Claude Code | ~/.claude/skills/ |
| Codex | ~/.codex/skills/ 或项目下 .agents/skills/ |
命令形态（将 <skills 目录> 换成你环境中的实际路径）：
skillhub search wechat-analyzer
skillhub install @user_4e735797/wechat-analyzer --dir <skills 目录>
安装后按所用客户端要求重启或重载 Agent，使 SKILL.md 生效。
3、本地工程¶
Skill 描述中的应用代码位于：
~/Desktop/wechat-analyzer
若你的克隆路径不同，应在本地自行对齐，或在对话中说明实际路径；Skill 默认假设为桌面下的 wechat-analyzer 目录。
典型用法¶
在 Agent 已加载该 Skill 的前提下，可按下面方式使用（示例为可复现的对话意图，非虚构运行结果）。
- 改后端：说明要在 Flask 中新增某个分析接口，并注明数据来源走 wx-cli；Agent 应结合 Skill 中的栈信息给出与现有结构一致的改法。
- 调前端：描述深色主题下某页面布局或图表展示问题，Agent 应默认你在
wechat-analyzerWeb 前端内修改，而不是另起项目。 - 排错联调：粘贴接口报错或 wx-cli 调用失败日志，并说明正在调试
wechat-analyzer；Skill 用于固定「当前在维护哪套工程」这一前提。
若 Skill 包内还带有更细的触发词或目录说明，以安装后的 SKILL.md 全文为准。
适用场景与注意¶
适合谁
- 已在或计划在
~/Desktop/wechat-analyzer维护 Flask + wx-cli + 深色前端分析应用的个人或小团队开发者。 - 使用 Cursor、Claude Code、Codex 等，并希望通过 Skill 减少重复交代技术栈。
限制与注意
- SkillHub 技能页可能下线或无法访问，安装与更新以 CLI 与包内
SKILL.md为准；勿假设页面上的营销文案与本地工程 100% 同步。 - Skill 提供的是开发上下文，不保证替你执行 wx-cli、不替代微信数据合规与隐私自查；聊天数据的导出与使用须遵守当地法规与平台规则。
- 评分与下载量为 SkillHub 站内指标，不代表代码审计或安全认证；引入前请自行审查依赖与 API Key 等配置。
- 若本机项目路径不是
~/Desktop/wechat-analyzer，需在对话中显式纠正路径，避免 Agent 引用错误目录。
结尾¶
「微信聊天分析器」Skill 的价值，在于把 Flask + wx-cli + 深色 Web 前端 与 ~/Desktop/wechat-analyzer 工程 绑进 Agent 上下文，让你在扩展和调试时少重复背景说明。安装与优先源策略见 SkillHub 官方文档；技能入口：
https://api.skillhub.cn/user_4e735797/wechat-analyzer
