--- slug: "timeline-digest-tool-pro" name: "timeline-digest-tool-pro" version: "1.0.0" displayName: "时间线摘要工具-专业版" summary: "企业级X/Twitter时间线摘要平台,支持定时调度/智能分类/多源聚合/自动推送。时间线摘要工具专业版,面向企业和专业用户的高级X/Twitter时间线信息聚合平台。核心能力: - 全时间" license: "Proprietary" edition: "pro" description: |- 时间线摘要工具专业版,面向企业和专业用户的高级X/Twitter时间线信息聚合平台。核心能力: - 全时间线抓取(For You + Following + 自定义列表) - 智能分类摘要(AI分类:科技/加密货币/商业洞察/其他) - 高级语义过滤与降噪 - 定时自动调度与增量处理 - 多源信息聚合(X/Twitter + RSS + 自定义源) - 自动推送通知(Telegram/邮件/Webhook) - 状态管理与云端同步 - 摘要分析仪表盘与趋势追踪 适用场景: - 企业舆情监控与行业动态追踪 tags: - 沟通协作 - 信息聚合 - X/Twitter - 企业级 - 智能摘要 - 自动化 - 工具 - 通信 - pro - aggregator - twitter - telegram tools: - read - exec - glob - grep homepage: "" category: "Automation" --- 时间线摘要工具专业版是一款面向企业和专业用户的高级X/Twitter时间线信息聚合平台。在免费版基础抓取和去重能力之上,PRO版新增了AI智能分类摘要、定时自动调度、多源信息聚合、自动推送通知等企业级功能,帮助用户构建自动化的信息聚合与分发工作流. PRO版与免费版完全兼容,升级后原有配置和状态数据继续使用。适合企业舆情监控、投资研究信息聚合、内容团队素材采集等需要持续追踪和自动化处理的场景. ### PRO版增强能力总览 | 能力分类 | 具体功能 | 免费版 | PRO版 | |----|----|---|----| | 时间线抓取 | For You + Following | 支持 | 支持 | | 时间线抓取 | 自定义列表 | - | 支持 | | 去重处理 | 硬去重(ID) | 支持 | 支持 | | 去重处理 | 近似去重(文本) | 支持 | 支持 | | 去重处理 | 语义去重 | - | 支持 | | 内容过滤 | 启发式过滤 | 基础 | 高级 | | 内容过滤 | 语义过滤 | - | 支持 | | 摘要输出 | 原始JSON | 支持 | 支持 | | 摘要输出 | AI分类摘要 | - | 支持 | | 摘要输出 | 中文智能简报 | - | 支持 | | 调度 | 手动执行 | 支持 | 支持 | | 调度 | 定时自动 | - | 支持 | | 多源聚合 | X/Twitter | 支持 | 支持 | | 多源聚合 | RSS源 | - | 支持 | | 多源聚合 | 自定义源 | - | 支持 | | 推送通知 | Telegram | - | 支持 | | 推送通知 | 邮件 | - | 支持 | | 推送通知 | Webhook | - | 支持 | | 状态管理 | 本地文件 | 支持 | 支持 | | 状态管理 | 云端同步 | - | 支持 | | 分析 | 趋势追踪 | - | 支持 | | 分析 | 仪表盘 | - | 支持 | ## 核心能力 ### 1. 智能分类摘要 PRO版通过LLM对去重后的推文进行智能分类和中文摘要生成. > 详细代码示例已移至 `references/detail.md` **输入**: 用户提供智能分类摘要所需的指令和必要参数. **处理**: 解析智能分类摘要的输入参数,完成核心逻辑,返回结构化响应. **输出**: 返回智能分类摘要的响应数据,包含状态码、结果和日志. ### 2. 定时自动调度 PRO版支持cron式定时调度,自动执行摘要生成流程. **输入**: 用户提供定时自动调度所需的指令和必要参数. **处理**: 解析定时自动调度的输入参数,完成核心逻辑,返回结构化响应. **输出**: 返回定时自动调度的响应数据,包含状态码、结果和日志. ### 3. 多源信息聚合 除X/Twitter时间线外,PRO版支持聚合RSS源和自定义信息源. **输入**: 用户提供多源信息聚合所需的指令和必要参数. **处理**: 解析多源信息聚合的输入参数,完成核心逻辑,返回结构化响应. **输出**: 返回多源信息聚合的响应数据,包含状态码、结果和日志. ### 4. 自动推送通知 **输入**: 用户提供自动推送通知所需的指令和必要参数. **处理**: 解析自动推送通知的输入参数,完成核心逻辑,返回结构化响应. **输出**: 返回自动推送通知的响应数据,包含状态码、结果和日志. **能力覆盖范围**：本skill的核心能力覆盖以下场景关键词：企业级、时间线摘要平台、支持定时调度、多源聚合、时间线摘要工具专、面向企业和专业用、户的高级、时间线信息聚合平、核心能力、全时间线抓取、You、Following、自定义列表、加密货币、商业洞察、高级语义过滤与降、定时自动调度与增、量处理、自定义源、Telegram、Webhook、状态管理与云端同、摘要分析仪表盘与、趋势追踪等。这些关键词对应description中声明的使用场景,均已在上述能力点中提供对应的操作支持. ## 使用场景 ### 场景一:企业舆情自动监控 企业设置每6小时自动抓取X/Twitter时间线,生成分类摘要并推送到Telegram群组. ## 输入格式 | 参数名 | 类型 | 必填 | 说明 | |:-----|:-----|:-----|:-----| | input | string | 是 | 时间线摘要工具-专业版处理的输入数据或指令 | | options | object | 否 | 附加配置选项,如模式选择、格式偏好等 | | callback_url | string | 否 | 异步处理完成后的回调通知URL | ```python config = { "intervalHours": 6, "fetchLimitForYou": 100, "fetchLimitFollowing": 60, "maxItemsPerDigest": 25, "notifications": { "telegram": { "enabled": True, "bot_token": "YOUR_BOT_TOKEN", "chat_id": "@company_pr_monitor" } } } # ... scheduler = DigestScheduler(config) scheduler.start() ``` ### 场景二:投资研究信息聚合 投资团队聚合X/Twitter和多个RSS源,生成每日投资简报. ```python aggregator = MultiSourceAggregator() aggregator.add_twitter_source("X-Crypto", limit=100) aggregator.add_rss_source("CoinDesk", "https://feeds.coindesk.com/coinbase") aggregator.add_rss_source("TechCrunch", "https://techcrunch.com/feed/") # ... all_items = aggregator.fetch_all() digest = SmartDigestGenerator().generate_smart_digest(all_items) # ... pusher = NotificationPusher({ "email": { "enabled": True, "from": "digest@company.com", "to": "research@company.com", "smtp_host": "smtp.company.com", "smtp_port": 587, "username": "digest@company.com", "password": "PASSWORD" } }) pusher.push_email(digest["digestText"]) ``` ### 场景三:内容团队素材采集 内容团队定期采集时间线中的热门话题,作为创作素材. ```python aggregator = MultiSourceAggregator() aggregator.add_twitter_source("X-Trending", limit=200) # ... items = aggregator.fetch_all() digest = SmartDigestGenerator().generate_smart_digest(items) # ... for section in digest["sections"]: print(f"\n{section['icon']} {section['category_name']} - {section['count']}条素材") for item in section["items"][:5]: print(f" • {item['author']}: {item['summary']}") print(f" {item['url']}") ``` ## 不适用场景 以下场景时间线摘要工具-专业版不适合处理： - 需要100%确定性的关键决策 - 医疗诊断 - 法律判决 ## 触发条件 需要AI模型调用、智能对话、Agent编排、LLM应用时使用。不适用于非本工具能力范围的需求. ## 快速开始 1. 阅读## 核心能力章节了解skill功能 2. 按## 依赖说明配置环境 3. 执行所需能力对应的命令 4. 参考## 错误处理章节处理异常 5. 查看## FAQ解答常见疑问 ### 从免费版升级 ```bash skill-platform skills install timeline-digest-tool-pro skill-platform gateway restart # ... ``` ### 全新安装 ```bash bird --version python3 --version # ... skill-platform skills install timeline-digest-tool-pro # ... python3 init_config.py --interval 6 --output config.json # ... python3 setup_notifications.py --telegram --email # ... python3 start_scheduler.py --config config.json ``` # ## 配置示例 ### PRO版企业级配置 ```json { "intervalHours": 6, "fetchLimitForYou": 100, "fetchLimitFollowing": 60, "maxItemsPerDigest": 25, "similarityThreshold": 0.9, "statePath": "~/.timeline-digest/state.json", # ... "smartDigest": { "enabled": true, "categories": ["ai_tech", "crypto", "insights", "other"], "language": "zh_CN", "max_summary_length": 100 }, # ... "multiSource": { "enabled": true, "sources": [ {"type": "twitter", "name": "X-ForYou", "limit": 100}, {"type": "twitter", "name": "X-Following", "limit": 60}, {"type": "rss", "name": "TechNews", "url": "https://feeds.example.com/tech"} ] }, # ... "notifications": { "telegram": { "enabled": true, "bot_token": "YOUR_BOT_TOKEN", "chat_id": "@your_channel" }, "email": { "enabled": false, "from": "digest@example.com", "to": "user@example.com", "smtp_host": "smtp.example.com", "smtp_port": 587 }, "webhook": { "enabled": false, "url": "https://hooks.example.com/digest" } }, # ... "scheduler": { "mode": "interval", "intervalHours": 6, "run_on_startup": true }, # ... "analytics": { "enabled": true, "trend_tracking": true, "dashboard_path": "./dashboard/" } } ``` ### 推送通知配置 ```yaml notifications: telegram: enabled: true bot_token: "${TELEGRAM_BOT_TOKEN}" chat_id: "@company_monitor" # ... email: enabled: true smtp_host: "smtp.company.com" smtp_port: 587 username: "${EMAIL_USER}" password: "${EMAIL_PASS}" from: "digest@company.com" to: ["team@company.com"] # ... webhook: enabled: true url: "https://hooks.company.com/timeline-digest" headers: Authorization: "Bearer ${WEBHOOK_TOKEN}" ``` ## 最佳实践 ### 1. 调度频率选择 | 使用场景 | 建议频率 | 抓取量 | 说明 | |---:|---:|---:|---:| | 实时舆情监控 | 每2小时 | ForYou 50 | 高频追踪,快速响应 | | 日常信息聚合 | 每6小时 | ForYou 100 | 平衡效率与覆盖 | | 每日简报 | 每天2次 | ForYou 200 | 早晚各一次 | | 每周回顾 | 每周1次 | ForYou 500 | 深度回顾 | ### 2. 多源聚合策略 ```text 多源聚合建议: 1. X/Twitter作为主要信息源(实时性强) 2. RSS补充深度内容(博客、新闻站) 3. 自定义源补充专业领域内容 4. 统一去重,避免跨源重复 5. 分类摘要时标注来源,便于追溯 ``` ### 3. 推送通知优化 ```python PUSH_BEST_PRACTICES = { "format": "使用简洁的格式,重点突出分类和数量", "length": "单次推送不超过2000字符,过长分段发送", "timing": "避免深夜推送,建议在9:00-21:00之间", "priority": "高优先级内容(突发新闻)可即时推送", "dedup": "推送前检查24小时内是否已推送相同内容", } ``` ## 常见问题 ### Q1: PRO版的智能分类准确率如何? **A:** PRO版使用关键词匹配+LLM语义分析双重分类机制。对于明确领域的内容(如AI、加密货币)准确率较高。用户可通过配置自定义分类关键词来提升特定领域的分类准确率. ### Q2: 定时调度如何保证不遗漏推文? **A:** PRO版使用增量过滤机制,每次运行只处理上次运行后的新推文。状态文件记录已处理的推文ID,即使调度间隔较长也不会遗漏。状态文件保留30天的记录,确保去重有效. ### Q3: 多源聚合会增加API调用吗? **A:** X/Twitter源的抓取通过bird工具完成,不额外增加API调用。RSS源是标准HTTP请求,不涉及API限制。自定义源取决于具体实现。建议合理设置抓取频率,避免对源站造成压力. ### Q4: 推送通知支持哪些渠道? **A:** PRO版支持Telegram Bot推送、邮件推送(SMTP)和Webhook推送。Webhook可对接Slack、飞书、企业微信等支持Webhook的平台. ### Q5: 状态文件可以云端同步吗? **A:** PRO版支持状态文件云端同步,适合多设备或团队共享去重状态的场景。配置中设置 `cloud_sync` 相关参数即可启用. ### Q6: 如何与免费版协作? **A:** PRO版与免费版完全兼容。免费版的状态文件格式与PRO版一致,升级后直接继承。免费版用户手动生成的JSON摘要也可以导入PRO版进行智能分类处理. ## 依赖说明 ### 运行环境 - **Agent平台**: 支持SKILL.md的任意AI Agent(Claude Code / Cursor / Codex / Gemini CLI等) - **操作系统**: Windows / macOS / Linux - **Python**: 3.8+ - **网络环境**: 需可访问X/Twitter服务和推送服务 ### 第三方依赖 | 依赖项 | 类型 | 是否必需 | 获取方式 | |:---:|:---:|:---:|:---:| | bird | CLI工具 | 必需 | 参考bird工具文档安装 | | Python 3.8+ | 运行时 | 必需 | python.org 下载 | | LLM API | API | 必需 | 由Agent内置LLM提供 | | feedparser | Python库 | 可选 | `pip install feedparser` | | requests | Python库 | 可选 | `pip install requests` | | schedule | Python库 | 可选 | `pip install schedule` | ### API Key 配置 - bird工具的认证(cookie)由bird工具自行管理 - Telegram推送需要Bot Token(通过 @BotFather 创建) - 邮件推送需要SMTP账号密码 - Webhook推送需要目标URL和认证Token - LLM智能摘要由Agent内置LLM提供,无需额外Key ### 可用性分类 - **分类**: MD+EXEC(纯Markdown指令,部分功能需exec命令行执行) - **说明**: 基于Markdown的AI Skill,通过自然语言指令驱动Agent执行时间线摘要和推送任务 - **运行模式**: 本地脚本执行 + 定时调度 + 远程推送 - **安全等级**: 只读抓取操作;推送通知需配置认证凭证;状态文件支持云端加密同步 - **兼容性**: 与免费版(timeline-digest-tool-free)完全兼容,支持无缝升级 ## 错误处理 | 错误场景 | 原因 | 处理方式 | |:------|------:|:------| | 配置错误 | 参数缺失或格式错误 | 检查依赖说明中的配置要求 | | 运行时错误 | 运行环境不满足 | 确认运行环境符合依赖说明 | | 网络错误 | 连接超时或不可达 | 执行ping命令测试网络连通性,检查防火墙和代理设置连接后执行ping命令测试网络连通性,检查防火墙和代理设置连接后重新执行命令，参考国内替代方案 | ## 已知限制 - 需LLM支持,无LLM环境不可用 - 复杂业务场景建议结合人工经验判断 - 执行效率受模型能力与网络环境影响 ## 示例 ### 基本用法 **输入**：用户提供操作指令和必要参数 **输出**：返回执行结果,包含操作状态和输出数据 ```text 用户: 执行核心功能 Skill: 正在执行核心功能... Skill: 执行完成,结果如下: 操作成功 ``` ## 输出格式 ```json { "success": true, "data": { "result": "时间线摘要工具-专业版处理结果", "execution_time": "0.5s", "metadata": { "version": "1.0", "processor": "timeline digest pro" } }, "execution_log": ["解析输入参数", "执行核心处理", "格式化输出结果"], "error": null } ```