下载地址
https://www.zhengdianxue.com/wp-content/uploads/skills/user_ffc37972--daily-watchlist-beta.zip将提示词发送给你的 AI 安装该 skills
请根据 https://skillhub.cn/install/skillhub.md,安装 @user_ffc37972/daily-watchlist-beta。使用教程:https://docs.qq.com/doc/DSXREd2R4d2tZQ3dQ 自动盯盘工具。用户首次通过对话录入持仓股票(支持 A股/港股/美股),之后每日收盘后自动生成盯盘报告,包含当日股价波动与异动分析、当日资金流向、当日相关舆情、当日公司公告四部分,输出手机友好的可视化 PDF/HTML 并推送至 WorkBuddy 小程序。
This skill should be used when the user wants to set up or run an automated daily watchlist/report for their holdings across A-share / Hong Kong / US markets, including first-time onboarding of holdings and the scheduled daily report generation.
阅读全文 (展开查看完整说明)
概述
用途:把"每天收盘后看一眼自己持仓"这件重复的事自动化。首次对话录入持仓,之后每日自动出可视化报告,覆盖 A股 / 港股 / 美股。
数据底座(均无需自建接口,公开数据兜底):
- 股价 / K线 / 技术 / 资金流:
westock-data-skillhub(腾讯自选股公开接口,免鉴权) - 公告:
westock-data-skillhub的notice命令(A股/港股/美股通用,免鉴权) - 舆情 / 新闻:
web_search公开网络检索(由 AI 分析步对每只标的补充;稳定可用、无需凭证,是自动化场景下的主数据源) - (可选增强)
neodata-financial-search:仅在你当前桌面会话已登录并持有凭证时,可在手动取数时补充更结构化的研报/新闻原文;自动化(无人值守)不依赖它,避免空返回导致报告出现占位提示。
产物:手机友好的可视化 PDF(主产物)+ HTML(含股价走势折线图、资金流柱状图、当日关键指标网格,红涨绿跌),另存结构化 data.json。每只标的包含 8 项当日关键指标(开盘价 / 最高价 / 最低价 / 收盘价 / 成交额 / 成交量 / 换手率 / 振幅),以 4×2 网格一目了然。内置异动检测引擎:基于 20 个交易日历史均值,自动识别成交量放量/缩量、成交额异常放大/缩小、振幅异常、涨跌幅异动,以红色警告框醒目提示。通过 present_files 交付;自动化运行时由 WorkBuddy 推送到小程序。
核心特性:
- 内置一体化编排脚本
scripts/run_report.py,并行取数 + 自动解析 + 渲染 + 计时,10 只标的整份报告可在 10 秒内完成;所有依赖路径自动探测,任意用户安装后即可独立运行。 - 休市自动跳过(默认开启):某个市场当日休市(周末 / 法定节假日 / 交易所临时休市)时,不分析、不取数、不进报告该市场的股票;全部市场休市则不出报告,只在 stdout 输出一行
[SKIP]。判定逻辑三层兜底(官方节假日表 → 行情新鲜度 → 延迟容忍),详见「二、休市自动跳过」,--force可强制覆盖。
零、一键初始化(推荐:一句话完成全部设置)
用户只需说一句:"帮我设置自动盯盘。" 技能会在同一次对话内自动做完下面四件事,用户无需分多次操作、也无需手动敲命令:
- 安装依赖:运行
python scripts/install.py,自动装好行情数据包与 PDF 引擎(首次耗时数十秒,幂等可重复)。 - (可选)安装前置技能 neodata:检查
neodata-financial-search是否已安装;本技能舆情已改用web_search,neodata 仅为会话内可选增强,默认不强制安装。若用户希望手动取数时获得更结构化的研报原文,可自动安装。 - 对话录入持仓:收集股票代码 / 数量 / 成本价并写入
holdings.json(见下方"一、首次使用")。 - 创建每日自动化:直接创建 A股港股 16:30 与 美股 05:30 两份定时,并向用户展示下方「第 4 步 推送开关引导」(创建无法直接勾选开关,需用户手动开一次)。
若只想单独安装(暂不录入持仓),也可只说"运行自动盯盘的安装"执行第 1 步;neodata 缺失时 install.py 会提示,届时由一键初始化流程自动补齐。
安装详情(install.py 做了什么)
python scripts/install.py 自动完成(全部幂等、可重复运行):
- 探测本机 python 与 node/npm;
- 创建数据目录
~/.workbuddy/daily-watchlist-beta/reports/; - 若无持仓文件,则从
assets/holdings.example.json复制出~/.workbuddy/daily-watchlist-beta/holdings.json; - 把行情数据包
westock-data-skillhub与 PDF 引擎puppeteer安装到~/.workbuddy/daily-watchlist-beta/node_modules; - 检查前置技能
neodata-financial-search,缺失时提示由一键初始化自动安装。
依赖要求:Node.js 18+(含 npm)、Python 3.9+。若不需要 PDF,可 python scripts/install.py --no-pdf(报告将仅出 HTML)。run_report.py 与 install.py 均不硬编码任何用户名或绝对路径:优先使用本地已安装的数据包,找不到时自动退回 npx -y westock-data-skillhub@1.0.5;puppeteer 缺失时自动降级为仅 HTML。
依赖与自动安装说明
| 依赖 | 类型 | 能否由本 skill 自动安装 | 缺失时的行为 |
|---|---|---|---|
westock-data-skillhub@1.0.5 | npm 包(行情数据) | 能:install.py 自动安装 | 缺失且 npx 不可用 → 取数失败,报告缺该标的 |
puppeteer@23 | npm 包(PDF 引擎) | 能:install.py 自动安装(--no-pdf 跳过) | 缺失 → 仅出 HTML,不影响取数/分析 |
neodata-financial-search | Skill(前置技能) | 能:一键初始化时由技能市场自动安装 | 缺失 → 舆情/公告留空并标注"需在线检索",主流程不中断 |
如一键初始化未自动装上 neodata,可手动补装:在「技能中心 / 专家」搜索 neodata-financial-search 安装,或在本会话说"安装 neodata-financial-search 技能"。安装后 run_report.py 自动发现其 scripts/query.py,无需配置路径。
两种运行模式
| 模式 | 触发 | 行为 |
|---|---|---|
| 首次录入(Onboarding) | 用户说"帮我盯盘 / 设置自动盯盘 / 录入持仓" | 对话收集持仓 → 解析代码 → 写入 holdings.json |
| 每日报告(Daily) | 自动化定时触发 / 用户说"现在跑一次" | 读取 holdings.json → 按市场范围取数 → 生成可视化报告 → 推送 |
每日报告按市场范围(scope)运行:
ah→ 仅 A股 + 港股(傍晚 16:30 触发)us→ 仅美股(次日凌晨 05:30 触发,覆盖美股当日收盘)all→ 全部(单次运行,适合手动触发或只用一个定时任务的用户)
一、首次使用:对话式录入持仓 + 一键建自动化
目标:通过一次对话完成「安装依赖 + 录入持仓 → 写入 holdings.json → 直接创建每日自动化」,用户无需任何手动配置。
前置(首次初始化时由技能在同一次对话内自动完成,无需用户操心):
- 已运行
python scripts/install.py装好 npm 依赖; - 已确保
neodata-financial-search安装就绪(缺失则自动安装,见上方"零、一键初始化"第 2 步)。
若用户是直接说"帮我设置自动盯盘"触发的,上述前置已自动做完,直接进入下方收集步骤即可。
1) 对话收集字段
依次向用户收集每只标的:
- 股票代码 / 名称(必填):A股
sh/sz/bj+ 6 位代码,港股hk+ 5 位代码,美股us+ ticker;也可只给名称,用westock-data-skillhub search 名称解析。 - 持仓数量(shares)(选填,建议填):用于后续盈亏测算。
- 成本价(cost)(选填,建议填):用于后续盈亏测算。
市场(market)按代码前缀自动判定:sh/sz/bj→A,hk→HK,us→US。
2) 写入持仓
把收集结果组装为 holdings.json(扩展 schema),写入 ~/.workbuddy/daily-watchlist-beta/holdings.json;已有则按 code 合并去重。回显确认清单(名称 / 代码 / 市场 / 数量 / 成本价)。
Schema(扩展后,新增 shares / cost;见 assets/holdings.example.json):
{
"updated_at": "2026-07-12",
"holdings": [
{"name": "贵州茅台", "code": "sh600519", "market": "A", "shares": 100, "cost": 1680.0, "note": ""},
{"name": "腾讯控股", "code": "hk00700", "market": "HK", "shares": 200, "cost": 380.0, "note": ""},
{"name": "苹果", "code": "usAAPL", "market": "US", "shares": 50, "cost": 190.0, "note": ""}
]
}market 取值:A(A股)/ HK(港股)/ US(美股)。shares / cost 当前供后续盈亏扩展使用;run_report.py 取数只用 code/market/name,留空不报错。
3) 直接创建两份每日自动化(无需用户手动操作)
录入确认后,立即用 automation_update(mode=create)创建下面两个定时任务,prompt 直接复制 references/schedule-guide.md 里的「标准自动化 prompt 模板」(按 scope 替换 ah/us)。创建成功后,必须向用户展示下方第 4 步的「推送开关引导」(可直接复制给用户),否则用户不会在手机收到报告推送。**
| 自动化 | scope | rrule | 触发时间 |
|---|---|---|---|
| 自动盯盘·A股港股 | ah | FREQ=DAILY;BYHOUR=16;BYMINUTE=30 | 每个交易日 16:30 |
| 自动盯盘·美股 | us | FREQ=DAILY;BYHOUR=5;BYMINUTE=30 | 次日凌晨 05:30(覆盖美股当日收盘) |
4) 推送开关引导(创建自动化成功后,必须向用户展示)
报告要出现在手机小程序,靠的是「同步到小程序」开关 —— 而创建自动化时无法直接勾选该开关(API 不支持),所以必须由用户手动开一次。创建任务成功后,请把下面这段引导直接展示给用户(可复制):
📲 自动化已创建成功!请打开推送开关,才能每天在手机收到日报。
第一步:打开「同步到小程序」开关(仅需一次,长期有效)
· 打开 WorkBuddy 桌面端,左侧进入「自动化」列表
· 点开「自动盯盘·A股港股」任务 →「设置」→ 打开「同步到小程序」
· 同样点开「自动盯盘·美股」任务 →「设置」→ 打开「同步到小程序」
(创建时无法直接勾选该开关,需手动开一次;开启后长期生效)
第二步:在手机小程序里查看推送
· 打开 WorkBuddy 小程序
· 点击左上角菜单 → 选择「连接电脑」
· 再次点击左上角菜单 → 选择「自动化」
· 等待同步完成后,即可看到推送的日报
仍收不到?确认两个任务都已开启开关,且手机小程序已连接到同一台电脑。- 开关作用:开启后,自动化每次生成的报告会推送至 WorkBuddy 小程序,手机端直接收到当日盯盘日报,无需打开桌面端。
- 未开启的影响:报告仍会在桌面端运行生成,但不会主动推送到手机。
- 首跑注意:首次运行还需在连接器页「信任」该自动化,结果才会经 WorkBuddy 推送。
用户随时可说"加一只 / 删掉 XX / 改持仓",按上述流程增量更新 holdings.json;若持仓市场范围有变化(如新增美股),提醒用户对应的自动化是否已创建。
二、每日报告工作流(推荐:一键编排)
首选方式 —— 直接调用一体化脚本,一步完成"并行取数 → 组装 → 渲染 HTML+PDF → 计时":
python scripts/run_report.py --scope ah --holdings ~/.workbuddy/daily-watchlist-beta/holdings.json --outdir ~/.workbuddy/daily-watchlist-beta/reports --date YYYY-MM-DD参数:--scope ah|us|all;--no-pdf 可跳过 PDF;--force 忽略休市检测强制出报告;--now "YYYY-MM-DD HH:MM"(北京时间)调试用。脚本会打印各环节耗时([timing] 与机器可读的 TIMING_JSON),产出 YYYY-MM-DD-SCOPE.{json,html,pdf}。
休市自动跳过(默认开启,核心规则)
运行前,脚本按市场(A股 / 港股 / 美股)判定"本次应覆盖的交易日"是否真的开市,休市市场不取数、不分析、不进报告。目标交易日推算:A股/港股 = 北京当天(收盘后)或前一天(收盘前);美股 = 美东当天(收盘后)或前一天。
三层判定(优先级从高到低):
- 周末 → 直接判休市。
- 官方节假日表(内置沪深交易所 / HKEX / NYSE 已公布的休市安排,覆盖 A股 2026、港股 2026–2027、美股 2026–2028)→ 判休市。可用
~/.workbuddy/daily-watchlist-beta/holidays.json自行补充({"A": {"2027-01-01": "元旦"}, ...},只补充不覆盖)。 - 行情新鲜度兜底:取该市场任一标的最新一根日 K 日期 L。
- L ≥ 目标交易日 → 开市;
- L < 目标交易日且中间有工作日 → 休市(本应有行情却没有);
- L < 目标交易日但中间无工作日(通常是接口延迟)且距收盘 ≤ 90 分钟 → 照常出报告但标注"行情基准日"。
行为约定:
- 某个市场休市 → 该市场所有标的跳过,报告其余市场正常生成,顶部出现"今日休市,未纳入本报告"黄色提示框。
- 全部市场休市 → 不生成任何报告文件,stdout 输出一行
[SKIP]与HOLIDAY_SKIP_JSON {…}后退出(退出码 0)。自动化若检测到[SKIP]应直接结束,仅回复"今日 X 休市,未生成报告",不要尝试推送报告。 - 取数失败(接口空/报错)绝不误判休市,按开市继续。
注:
--date YYYY-MM-DD仅用于产物文件名与"运行日"标注;目标交易日始终按真实时钟(或--now模拟)推算,因此节假日不会因文件名而被当成交易日。
脚本内部对每只标的并行发起 6 路请求(kline 30日 / technical / fund flow 或 fund short / notice / neodata 舆情 / neodata 公告),并对所有标的再做一层并行,因此耗时基本与标的数量无关(实测 10 只标的约 6–10 秒)。
AI 深度分析阶段(舆情 / 公告必须含判断与建议)
脚本默认 sentiment 字段为空(舆情留空待分析步补充),announcement 为 westock 公告原文。要让报告具有真正的分析价值,取数后必须由 AI 补一层结构化分析,再重渲染:
- 取数并生成基线报告(此时
data.json中sentiment为空、announcement为 westock 公告原文):
python scripts/run_report.py --scope ah --holdings ... --outdir ... --date ...- 对 data.json 中每只标的,用
web_search检索最新舆情/新闻,结合announcement(公告原文)、当日涨跌幅、资金流向,按下方分析契约撰写analysis.json(以股票代码为 key)。可在每条sentiment_analysis同级附带news_raw(web_search 检索到的真实舆情标题,供报告"原始舆情"溯源)。 - 合并并重建(不重复取数):
python scripts/merge_analysis.py OUTDIR/YYYY-MM-DD-SCOPE.json analysis.json
python scripts/run_report.py --scope ah --holdings ... --outdir ... --date ... --rebuild- 用
present_files推送重建后的 PDF(主产物)+ HTML,并复制到工作区reports/。
分析契约(写入 analysis.json,按代码索引,与 data.json 中 stocks[].code 对应):
sentiment_analysis:tone(up偏多 / down偏空 / mid中性)、core(核心要点,2–4 句,提炼而非复述)、impact(潜在影响判断,有依据)、advice(合理建议)、topics(话题标签数组)。news_raw(可选字符串):web_search 检索到的 1–3 条真实舆情标题,用于"原始舆情"溯源。announcement_analysis:数组,每条含date/title/verdict(利好 / 利空 / 中性) /judgment(一句话影响判断) /advice(建议)。
撰写要求:简洁精炼;给出有依据的判断与可操作建议,不复述原文;观点明确(利好/利空/中性);让读者快速理解核心要点与可能影响。报告渲染时分析为首要内容,原文作为"原始信息"折叠展示(仅当 news_raw 有真实数据时)。未注入分析时,build_report.py 会输出量价自动解读(保守技术面摘要,明确标注"量价自动解读"),保证报告始终结构化、可读,不会再出现"建议在线检索补充"等占位提示。
舆情来源说明:取数阶段 sentiment 为空,舆情由 AI 分析步通过 web_search 补充并写入 sentiment_analysis(及可选 news_raw)。若某标的未检索到显著舆情,分析步应给出 tone=mid 且 core="公开渠道未见重大新增舆情" 的保守结论。渲染层会显示干净的"无公开舆情检索结果"文案,不会出现"建议在线检索补充"占位。
三、每日报告工作流(备选:Agent 手动逐步取数)
当需要更深度的人工分析、或脚本不可用时,可由 Agent 按模块手动取数。命令映射见 references/data-source-map.md。数据包调用方式:优先 node ~/.workbuddy/daily-watchlist-beta/node_modules/westock-data-skillhub/index.js CMD(已安装);否则 npx -y westock-data-skillhub@1.0.5 CMD。
模块 1 — 当日股价波动 & 异动原因分析
kline CODE --period day --limit 2:今日与昨日 开/高/低/收、涨跌幅、振幅、量额。涨跌幅 =(今收 − 昨收)/ 昨收。technical CODE(不加--group,返回 MA/MACD/KDJ/RSI/BOLL 全指标):判断金叉/死叉、超买(70以上)/超卖(30以下)。- 异动原因:
neodata-financial-search查询名称 今日 为什么 涨/跌,并用notice list CODE --limit 5核对公告驱动;neodata 不可用则web_search。给出 1–3 条归因。
模块 2 — 当日资金流向
- A股:
fund flow CODE→ 超大单/大单/中单/小单净额 + 5/10/20 日主力净额。 - 港股:
fund flow CODE→ 主力/散户/总计净额(schema 与 A股不同)。 - 美股:
fund short CODE→ 卖空比(ShortRatio),作为资金态度代理;美股无 A股式主力净流入口径,禁止把卖空数据等同于主力净流入。
模块 3 — 当日相关舆情
neodata-financial-search查询名称 最新 新闻 舆情。返回 JSON,正文在data.docData.docRecall[].docList[](字段 title/content/publishTime/url)。- 必须产出结构化分析(写入
sentiment_analysis):判定tone(偏多/偏空/中性),提炼core(核心要点,2–4 句,提炼而非复述原文),给出impact(潜在影响判断,有依据) 与advice(建议),附topics标签。 - neodata 不可用时改用
web_search,标注"公开网络检索",仍按上述结构分析。
模块 4 — 当日公司公告
notice list CODE --limit 5:结构化公告清单(日期/标题/类型)。- 公告正文与影响:
neodata-financial-searchdata_type=doc 查询名称 最新公告,或web_search。 - 必须产出结构化分析(写入
announcement_analysis,逐条):对重要公告给verdict(利好/利空/中性) +judgment(一句话有依据的影响判断) +advice(建议),并保留date/title。
报告组装
把每只标的结果组装为 data.json(结构见 references/visual-report.md),再依次:
python scripts/build_report.py --input data.json --output report.html(纯标准库,内嵌 SVG,红涨绿跌)。node scripts/make_pdf.js report.html report.pdf 480(puppeteer 渲染单页贴合宽度的手机 PDF)。- 写入
reports/YYYY-MM-DD-SCOPE.{md,html,pdf}并复制到工作区,present_files推送。
四、容错与降级(务必遵守)
- 任一命令失败:如实说明"该数据暂不可用",禁止编造数字。
- 命中数据能力域时,禁止用
web_search/训练数据替代价格与财务数字;舆情/新闻允许且应当使用web_search实时检索(这是本技能的标准舆情来源),价格/资金/公告以westock-data-skillhub为准。 - 所有数据均来自公开接口,可能存在延迟,以交易所/公司公告官方为准。舆情为公开网络检索的二次解读,非公司官方信息,已在脚注声明"不构成投资建议"。
- 不同市场能力差异大,以
references/data-source-map.md速查表为准,不支持的模块标注"N/A"。 - PDF 引擎缺失时,
run_report.py自动降级为仅 HTML(并打印 FAILED 标记),主流程不中断。
五、调度(两份报告)
详见 references/schedule-guide.md。要点:
- 傍晚 A股+港股:每日
FREQ=DAILY;BYHOUR=16;BYMINUTE=30,scope=ah。 - 次晨 美股:每日
FREQ=DAILY;BYHOUR=5;BYMINUTE=30,scope=us。
(美股收盘约北京时间次日凌晨 04:00–05:00,05:30 触发可稳定覆盖当日收盘。)
自动化 prompt 建议直接调用 run_report.py(快、稳、可移植),示例见 references/schedule-guide.md。
六、重要声明
本工具仅做客观市场数据跟踪与汇总,所有数据来源于公开接口,可能存在延迟,以交易所/公司公告官方为准。不构成任何投资建议。投资有风险,决策需谨慎。