公众号10万+文章搜索

概述

公众号10万+搜索

帮助用户找到领域内的公众号文章，并看清哪些已有10万+阅读数据。10万+是标记，不能作为交付门槛。 普通文章、未查询互动的文章和互动暂缺的文章都保留；只有实际返回文章为空，才说本次没有搜索结果。

可将搜索结果保存为参考报告，或按需提取单篇正文。搜索覆盖范围和数据采集时间以实际返回为准。以下命令均在本 Skill 目录执行。

查询与交付

1. 从用户需求提取关键词、时间和展示篇数。关键词不清楚才补问；不擅自扩词。未指定时建议先用一个关键词、最近七天、一页50篇、前10篇互动，并先说明本次条件。用户说“找3篇10万+”时，也交付实际返回的完整参考列表，说明确认数量，不能自动加查来凑数。
2. 搜索和互动查询可能产生费用，以真实账单为准。真实调用、开通和付款分别取得对应授权；已明确授权的本次查询可直接执行。先用以下受控脚本输出 JSON，不直接拼请求或读取凭证：

   python3 scripts/fetch_gzh_trends.py --keyword "职场" --publish-time week --sort hot --max-items 50 --interaction-limit 10 --output-format json

参数与数据口径见 [搜索与报告说明](references/search_report_format.md)。hot 是点赞排序，不是阅读排序。默认一页，不自动翻页、补查互动、扩词或提取正文。

1. 成功输出后，保留 articles 全部行和原顺序。阅读数 100001 是服务返回的触顶标记，显示“10万+”，不能写成精确100001次；其他真实计数原样展示，0 不当成缺失。interactionStatus 的“未查询”“暂缺”照实显示，不能判断为低阅读或补零。不要根据标题、作者、点赞或常识猜10万+。
2. 先说明返回篇数、实际取得阅读数据篇数、确认10万+篇数，再展示完整表格及原文链接。没有确认的10万+时说明“本次已取得的阅读数据中暂无确认的10万+，以下文章仍可参考”。不把开通、余额不足或服务错误当成空搜索。
3. 保留各行采集时间和返回的缓存标记；不得宣称即时榜单。账单金额和请求标识来自搜索输出，不重算、不承诺没找到10万+就免费。未读正文时，分析只基于标题和摘要，明确这个范围。

保存与继续

把成功 JSON 保存为用户选择的本地文件后，使用纯离线报告器：

python3 scripts/build_search_report.py --input search.json --output report.md

也可通过标准输入传入 JSON，省略 --output 则输出 Markdown。报告器保留全部行、标记10万+、保留原始账单，不读凭证、不访问网络；已有输出文件会拒绝覆盖。报告必须来自实际搜索结果，演示数据不能作为正式结果交付。

后续分页、补查指定篇目的互动、调整关键词都属于新的服务调用，先说明条件和可能费用，取得相应指令。沿用实际 nextOffset 翻页；--interaction-indices 使用本次页中1起算序号，不能与显式 --interaction-limit 同传。用户明确要求阅读指定文章后，才调用：

python3 scripts/extract_article.py --url "用户给定的公众号文章链接"

开通、付款与异常

• 首用收到 onboardingPreview 时，先读取 [首用演示](references/example_output.md)，把其中的演示说明和文章表格直接展示在对话里，再说明能力与可能费用、询问是否开通。不能只给文件链接或先要求开通。明确这些文章和数值是虚构演示，尚未执行用户的关键词搜索或链接提取；保留用户原需求，演示不进入实际结果、报告或账单。用户同意开通后运行 python3 scripts/service_client.py activate，由客户端打开同源激活页并密封保存凭证；不索要、读取或显示 API Key。已有凭证时正常处理需求，不重复展示首用演示。
• 余额不足、付款待确认、服务错误等信号按 [付款与恢复说明](references/payment.md) 处理。说明充值是付费、具体金额取真实订单；不将付款改称无费用的配置。订单和账单原文由受控程序使用，不让模型拼造凭证。没有付款授权时停在说明和可选下一步。
• 网络失败或超时只说明本次状态，不宣称没有文章，不无限重跑。存在挂起任务时按原有续查入口恢复，不能重跑普通搜索来代替续查或让用户重复付款。
• 不展示密钥、Payment-Proof、Payment-Needed、Payment-Validation、激活 Secret 或充值 URL；不要把完整客户端诊断未经检查复制给用户。账单安全字段与本机支付输出中的对客核对号码可展示。

默认本地凭证与状态目录为 ~/.aiworkskill/secrets/aiworkskill-wechat-search/。受控环境可通过 AIWORKSKILL_SECRETS_DIR 指定本 Skill 专用的存储目录。凭证由受控客户端保存和使用，不在对话中读取或显示。

首次从旧激活身份版本升级时需在官方页面重新开通；旧状态保留，不自动迁移凭证或在途任务。旧版未确认的请求或付款先沿原任务核对，不能换凭证重做。重新开通不代表必须充值，余额以实际账户状态为准。

宿主安全注入凭证时，须同时设置 AIWORKSKILL_WECHAT_API_KEY_SKILL_CODE=aiworkskill-wechat-search 明确本产品归属；缺少或不匹配时不使用环境凭证。模型不得读取凭证。存储目录末段必须为完整产品标识，不能使用旧目录、其他产品目录或符号链接。