核心用法
zhheo-blog-tools 是一款面向中文博客生态的专业智能体连接器，深度整合张洪Heo（zhheo.com）博客的全量数据与 AI 能力。该 skill 提供四大核心功能模块：
1. 智能对话（洪墨AI）：直接调用博客内置的 PostChat 智能体，支持自然语言问答，AI 回复包含结构化参考来源
2. 文章检索：双模式搜索——优先本地 JSON 索引（O(1) 响应）+ 智能体语义搜索兜底，覆盖全站历史文章
3. 内容发现：标签云浏览、今日热门排行（基于 Umami 实时访问数据）、分类导航，支持个性化推荐
4. 博主资产查询：装备清单（equipment 页）、开发项目集（我的项目分类），满足粉丝向深度需求
显著优点
- 数据完整度高：直接对接博客官方 API（tags/categories/hot）与 RSS，非爬虫模拟，数据时效性与准确性有保障
- 混合检索策略：本地索引优先 + AI 语义兜底，平衡速度与智能，避免纯 RAG 的幻觉问题
- 多模态交互：支持聊天、搜索、浏览、API 直取四种交互形态，适配不同用户意图
- 中文创作者场景深度优化：针对个人博客的常见需求（装备晒单、项目展示、文章归档）做专项功能设计
潜在缺点与局限性
- 强域名依赖：所有数据源绑定
blog.zhheo.com及api.zhheo.com，若博主服务宕机或变更 CORS 策略，skill 将失效 - Referer 硬编码：HeoBlogAPI 需伪造 Referer 头，存在被服务端策略封禁风险，且非标准 HTTP 实践
- 无持久化缓存：每次搜索需重新 fetch post_info.json，高频调用时对博主服务器造成压力
- 智能体黑箱：洪墨AI 的具体模型版本、上下文长度、知识截止日期未公开，输出质量不可控
适合人群
- 张洪Heo 博客的忠实读者，希望快速检索历史文章或获取个性化推荐
- 中文独立博客爱好者，研究个人博客的 AI 化改造方案
- 设计师/开发者群体，关注博主分享的 Mac 生态、效率工具、前端技术内容
常规风险
- 隐私合规：fetch 热门 API 时需伪造 Referer，可能违反目标站点的服务条款
- 服务稳定性：依赖个人博客的免费托管资源，无 SLA 保障，存在单点故障风险
- 内容权威性：智能体回复可能包含未经事实核查的观点，重要决策需交叉验证原文