前言¶
本地微信聊天分析往往要同時碰三塊東西：用 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
