xueqiu-skills 项目知识库

生成时间: 2026-03-06
最新提交: 756179c Initial commit
分支: main

项目概览

轻量级 AI 技能仓库，专为 AI Agent 协作设计。核心功能：爬取雪球投资时间线，AI 分析观点并生成 PDF 报告。

技术栈: Python 3.10+ (uv) + Playwright (agent-browser) + Markdown/PDF 转换

仓库结构

xueqiu-skills/
├── AGENTS.md              # 本文件，AI 编程工具指引
├── README.md              # 人类用户文档
├── LICENSE
└── skills/
    └── crawl-xueqiu-my-timeline/
        ├── SKILL.md              # 技能详细文档（AI 主要参考）
        ├── assets/
        │   └── github-markdown.css
        ├── evals/
        │   └── evals.json
        └── scripts/
            ├── check-cdp.sh
            ├── check-agent-browser.sh
            └── crawl_xueqiu_home_timeline_api.py

模块说明

代码地图

入口点

关键函数

命令速查

# 环境检查
sh skills/crawl-xueqiu-my-timeline/scripts/check-cdp.sh
sh skills/crawl-xueqiu-my-timeline/scripts/check-agent-browser.sh

# 爬取最近 24 小时
uv run skills/crawl-xueqiu-my-timeline/scripts/crawl_xueqiu_home_timeline_api.py

# 爬取最近 N 小时
uv run skills/crawl-xueqiu-my-timeline/scripts/crawl_xueqiu_home_timeline_api.py --hours N

# 爬取最近 N 天
uv run skills/crawl-xueqiu-my-timeline/scripts/crawl_xueqiu_home_timeline_api.py --days N

# 指定日期范围
uv run skills/crawl-xueqiu-my-timeline/scripts/crawl_xueqiu_home_timeline_api.py \
  --start-date 2026-03-01 --end-date 2026-03-06

技能触发条件

当用户提及以下关键词时，立即触发 crawl-xueqiu-my-timeline 技能：

✅ 触发关键词：

• 雪球时间线、雪球关注、雪球大 V
• 投资要闻、市场热点、投资热点
• 投资分析报告、生成 PDF 报告
• 爬取雪球、整理雪球观点

❌ 不触发：

• 打开雪球网站（简单浏览器操作）
• 查看某只股票行情（单一数据查询）
• 登录雪球（简单网页操作）

执行流程

步骤 1：环境检查

sh skills/crawl-xueqiu-my-timeline/scripts/check-cdp.sh
sh skills/crawl-xueqiu-my-timeline/scripts/check-agent-browser.sh

如未安装，脚本会自动安装。脚本生成：home_timeline_YYYYMMDD_YYYYMMDD.md

步骤 2：执行爬取

uv run skills/crawl-xueqiu-my-timeline/scripts/crawl_xueqiu_home_timeline_api.py

如需指定时间范围，添加参数（见 README.md）。

步骤 3：创建 TODO 列表

读取生成的 Markdown 文件，统计每位发言人的发言数量，按单个用户的发言条数分配 TODO：

使用 todowrite 工具创建 TODO 列表。

步骤 4：启动 Subagent 分析

并发限制：同时运行的 subagent 不超过 3 个

每个 subagent 的任务：

1. 读取时间线文件，定位指定用户的发言
2. 只总结本人观点（排除 // 或 > 开头的内容）
3. 提取：核心观点、涉及标的（$xxx$ 格式）、情绪倾向
4. 返回分析结果（不写中间文件）

重试机制：失败时自动重试，最多 2 次

步骤 5：生成分析报告

整合所有 subagent 的结果，写入 Markdown 格式报告（保存为 雪球时间线_YYYYMMDD_YYYYMMDD.md）：

# 雪球关注时间线分析报告

## 时间范围
2026-03-05 至 2026-03-06

## 发言人统计
- @产业驱动博弈：19 条
- @管我财：6 条

## 发言观点总结

### @发言人 A
- **发言数量**: X 条
- **主要观点**:
  - 观点 1
  - 观点 2
- **涉及标的**: $XXX$, $YYY$
- **情绪倾向**: 乐观/中性/悲观

## 市场热点 TOP3
1. 热点主题 1 - 讨论人数 X
2. 热点主题 2 - 讨论人数 X
3. 热点主题 3 - 讨论人数 X

## 投资建议/风险提示
...

步骤 6：转换为 PDF

bunx mdpdf 雪球时间线_YYYYMMDD_YYYYMMDD.md \
  --style=skills/crawl-xueqiu-my-timeline/assets/github-markdown.css

步骤 7：清理临时文件

rm 雪球时间线_YYYYMMDD_YYYYMMDD.md

重要规则

观点归属判断

只有不以 // 或 > 开头的内容才是发言人自己的观点：

注意：回复@XXX： 前缀是雪球自动生成的，整行都是发言人自己的观点，应总结。

报告核心原则

• ✅ 必须包含所有发言人，即使只有 1 条发言
• ✅ 按发言数量降序排列
• ✅ 只总结本人观点
• ✅ 分析失败的发言人在报告中标注"⚠️ 分析失败"

错误处理

环境适配

根据当前环境选择工具：

• OpenCode: 使用 task 启动 subagent，todowrite 管理 TODO
• Claude Code: 使用适合的方式启动 subagent
• 其他环境：遵循相同逻辑，适配对应工具

完整技能文档

详细技能说明：skills/crawl-xueqiu-my-timeline/SKILL.md