vibe-astock

<p align="center"><b>简体中文</b> | <a href="README_en.md">English</a></p> <h1 align="center">Vibe AStock</h1> <p align="center"> <b>A 股短线复盘与跟踪工作台</b><br> 盯盘 · 情绪复盘 · AI 复盘 · 明日验证 · 交易日志 · 个股深挖 · 回测 · 182 个数据端点 </p> <p align="center"> <a href="LICENSE"><img alt="License: Apache-2.0" src="https://img.shields.io/badge/license-Apache--2.0-blue"></a> <a href="CHANGELOG.md"><img alt="源码版本 v2.1.0" src="https://img.shields.io/badge/source-v2.1.0-F35D2B"></a> <img alt="A 股短线" src="https://img.shields.io/badge/market-A%20%E8%82%A1-c92a2a"> <img alt="182 个数据端点" src="https://img.shields.io/badge/data-182%20endpoints-2f9e44"> <img alt="AI：Claude Code、Codex、WorkBuddy 或模型 API" src="https://img.shields.io/badge/AI-Claude%20Code%20%7C%20Codex%20%7C%20WorkBuddy%20%7C%20API-black"> </p> --- <p align="center"> <a href="#界面预览">界面预览</a> · <a href="#功能">功能</a> · <a href="#数据与市场">数据</a> · <a href="#支持的-ai">支持的 AI</a> · <a href="#快速开始">快速开始</a> · <a href="#从旧版v1x升级">从旧版升级</a> · <a href="#安全与隐私">隐私</a> · <a href="#开发与测试">开发</a> · <a href="CHANGELOG.md">更新日志</a> </p> Vibe AStock 是一个 A 股短线复盘与跟踪工作台。盘中在「盯盘」看持仓、自选和昨日梯队的异动；收盘后在「情绪复盘」看情绪读数，让 AI 分情绪、资金、题材、龙虎榜、龙头五段写复盘，写下明天要验证的条件，下一个交易日收盘自动对账；自己的每笔交易记进「交易日志」，按入场那天的情绪和板位回头自查。行情和统计由程序算，AI 只负责解读，每个数字都由程序核对出处；数据和记录都存在自己的电脑上。 v2.0.0 起和 [Vibe Research](https://github.com/simonlin1212/Vibe-Research) 用同一套底座：接入 AI、个股深挖（A 股、港股、美股）、回测、产业资讯、产业研究、研报库、远程访问和免安装包都和它一样。用过旧版（v1.x，Python 版）的可以把数据导进来，见[从旧版升级](#从旧版v1x升级)。 - **10 个一级栏目**：首页、盯盘、复盘、交易日志、产业资讯、产业研究、研究工具、我的股票、资料库、接入 AI。短线相关的排在前面：「盯盘」下面是实时动态、竞价与盘中，「复盘」下面是情绪复盘、每日复盘，「交易日志」单独一个栏目；「研究工具」下面是个股深挖、多空辩论、回测、候选池，「产业研究」下面直接列出各个板块。 - **盯盘**：持仓、自选、昨日梯队、大票和成交额前十的当下读数，3 分钟涨跌超 1.5% 记急拉 / 急跌，碰到或离开涨停价记封板 / 开板；昨日涨停股 09:25 的竞价强弱，和全天六个时点的情绪路径。 - **情绪复盘**：赚钱效应、晋级率、连板天梯、连板溢价、梯队断层、情绪周期、封板质量、题材事件树、首板名单、近 5 天题材轮动；AI 复盘与 AI 周报、明日验证（头天晚上写条件，第二天收盘自动对账）、涨停样本统计、结构变化。 - **交易日志**：每笔交易自动对上入场那天的情绪强中弱和当时板位，按情绪环境、板位、打法、是否按计划分组看胜率；风险与纪律、复查、模式卡。只存在本机，不发给 AI。 - **182 个数据端点**（35 层），其中 14 个是短线专用：情绪读数、六张事实表、连板天梯、题材事件树、题材轮动、首板名单、涨停结构、盘中情绪、昨日梯队等；另有行情、K 线、逐笔、财务、一致预期、公告、研报、资金、龙虎榜、限售解禁、可转债、期货与大宗、港美股、新闻、宏观等。 - **六阶段个股研究（A 股、港股、美股）**：公司画像 → 财务 → 盈利预期 → 估值 → 风险 → 报告，原始数据保留来源，派生数字保留计算过程。 - **AI 用自己的**：Claude Code、Codex、WorkBuddy 订阅，或 DeepSeek、通义千问、Kimi、MiMo 等任意兼容 Chat Completions 的模型 API。 - **Windows、macOS、Linux 都能运行**；也可以装在 macOS / Linux 云端电脑上，用带访问口令的链接远程打开。 --- ## 界面预览  「情绪复盘 · 今日情绪」：昨天涨停的今天赚不赚钱、晋级顺不顺、梯队哪里断层、钱亏在哪个板位。 <table> <tr> <td width="50%" valign="top"><img src="assets/screenshots/2026-10-10/shortline-ladder.png" alt="连板天梯"><br><b>连板天梯</b>：每个高度有谁，昨天下面一层几只接上了，没接上的今天是跌停、炸板还是没涨停</td> <td width="50%" valign="top"><img src="assets/screenshots/2026-10-10/shortline-rotation.png" alt="题材轮动"><br><b>题材轮动</b>：近 5 个交易日每个题材的涨停只数和名次，标出连续、回流、首次出现；只描述过去，不预测</td> </tr> <tr> <td width="50%" valign="top"><img src="assets/screenshots/2026-10-10/watch-live.png" alt="盯盘 · 实时动态"><br><b>盯盘 · 实时动态</b>：持仓、自选、昨日梯队的当下读数和盘中异动（拍摄时是周末，显示休市）</td> <td width="50%" valign="top"><img src="assets/screenshots/2026-10-10/watch-intraday.png" alt="盯盘 · 竞价与盘中"><br><b>盯盘 · 竞价与盘中</b>：昨日涨停股的竞价强弱，六个时点的情绪路径</td> </tr> <tr> <td width="50%" valign="top"><img src="assets/screenshots/2026-10-10/shortline-review.png" alt="AI 复盘"><br><b>AI 复盘</b>：五段分开写再汇总，每个数字由程序核对，建议的验证条件一键加进明日验证</td> <td width="50%" valign="top"><img src="assets/screenshots/2026-10-10/shortline-weekly.png" alt="AI 周报"><br><b>AI 周报</b>：情绪走势、题材轮动、验证回看；「本周我的交易」只在本机算</td> </tr> <tr> <td width="50%" valign="top"><img src="assets/screenshots/2026-10-10/shortline-verify.png" alt="明日验证"><br><b>明日验证</b>：收盘后写下一个交易日的方向条件，附历史发生率，下一场收盘自动对账</td> <td width="50%" valign="top"><img src="assets/screenshots/2026-10-10/shortline-samples.png" alt="涨停样本"><br><b>涨停样本</b>：昨日涨停股次日表现，按封板时间、打法、入场日情绪分组</td> </tr> <tr> <td width="50%" valign="top"><img src="assets/screenshots/2026-10-10/journal-records.png" alt="交易日志 · 交易记录（示例数据）"><br><b>交易日志 · 交易记录（示例数据）</b>：按情绪环境、当时板位、打法、是否按计划分组看胜率</td> <td width="50%" valign="top"><img src="assets/screenshots/2026-10-10/journal-review.png" alt="交易日志 · 复查（示例数据）"><br><b>交易日志 · 复查（示例数据）</b>：值得回头看的单子、最大浮盈浮亏、看错了还是没做好</td> </tr> </table> <details> <summary>其他栏目（和 Vibe Research 共用）</summary> <table> <tr> <td width="50%" valign="top"><img src="assets/screenshots/2026-10-10/home-dark.png" alt="首页"><br><b>首页</b>：指数、自选、持仓与对话区</td> <td width="50%" valign="top"><img src="assets/screenshots/2026-10-10/home-light.png" alt="首页（浅色主题）"><br><b>首页（浅色主题）</b></td> </tr> <tr> <td width="50%" valign="top"><img src="assets/screenshots/2026-10-10/daily-review.png" alt="每日复盘"><br><b>每日复盘</b>：涨跌面、量能、连板高度、两融、主要指数的中长期位置</td> <td width="50%" valign="top"><img src="assets/screenshots/2026-10-10/stock-overview.png" alt="个股深挖 · 概览"><br><b>个股深挖 · 概览</b>：K 线（可切复权）、财报前瞻与复盘、事件回看</td> </tr> <tr> <td width="50%" valign="top"><img src="assets/screenshots/2026-10-10/research-report.png" alt="六阶段研究报告"><br><b>六阶段研究报告</b>：正文里的数字带证据或计算编号，右侧证据附录能回查到原始数据</td> <td width="50%" valign="top"><img src="assets/screenshots/2026-10-10/sectors.png" alt="产业研究"><br><b>产业研究</b>：20 个板块，每个配一组分步研究提示词</td> </tr> <tr> <td width="50%" valign="top"><img src="assets/screenshots/2026-10-10/intel.png" alt="资讯雷达"><br><b>资讯雷达</b>：12 个行业的公开信源，近 3 天资讯</td> <td width="50%" valign="top"><img src="assets/screenshots/2026-10-10/signals.png" alt="产业信号"><br><b>产业信号</b>：GPU 租金一年走势与现货价</td> </tr> <tr> <td width="50%" valign="top"><img src="assets/screenshots/2026-10-10/holdings.png" alt="我的持仓（示例数据）"><br><b>我的持仓（示例数据）</b>：按交易流水算持仓、成本和盈亏</td> <td width="50%" valign="top"><img src="assets/screenshots/2026-10-10/calendar.png" alt="事件日历"><br><b>事件日历</b>：自选和持仓的除权、财报预约，加上自己写的裁决点</td> </tr> <tr> <td width="50%" valign="top"><img src="assets/screenshots/2026-10-10/candidates.png" alt="候选池"><br><b>候选池</b>：按条件逐只核对指数成分股，只排除、不排名</td> <td width="50%" valign="top"><img src="assets/screenshots/2026-10-10/connect-ai.png" alt="接入 AI"><br><b>接入 AI</b>：第一次打开时选订阅或模型 API</td> </tr> <tr> <td width="50%" valign="top"><img src="assets/screenshots/2026-10-10/settings-import.png" alt="从旧版导入"><br><b>从旧版导入</b>：先预览、再导入，导入前自动备份</td> <td width="50%" valign="top"></td> </tr> </table> </details> 截图拍摄于 2026-10-10 至 10-11（开发版，周末休市），使用单独的演示工作区，未接入 AI。持仓、自选和交易日志里的交易是为截图录入的示例数据（备注写着「示例数据」，价格取在当天真实的最高价和最低价之间），不是真实交易；AI 复盘和 AI 周报是 2026-10-10 用 Claude Code 订阅给 2026-10-09 实际写的版本，原样展示；「竞价与盘中」是旧版在 2026-09-23 交易时段存下、再从旧版导入的快照；研究报告是 2026-10-08 开发验证时跑完的一份报告；其余都是拍摄时页面取到的公开数据。截图只展示界面，不构成投资建议（[截图说明](assets/screenshots/2026-10-10/README.md)）。 ## 功能 左侧共 10 个一级栏目，有几个页面的收成二级（点一级栏目旁的箭头展开；侧栏收成图标时，点图标在旁边弹出二级）： <table> <thead> <tr><th nowrap>一级栏目</th><th nowrap>二级栏目</th><th>可以做什么</th></tr> </thead> <tbody> <tr><td nowrap>首页</td><td nowrap>—</td><td>先看大盘与全球指数、我的自选、我的持仓（市值、持仓盈亏、当日盈亏，开盘时价格自动刷新），再往下和 AI 对话，从分类目录进入各个功能</td></tr> <tr><td nowrap>盯盘</td><td nowrap>实时动态</td><td>盘中盯着持仓与自选（现价、今日涨跌、浮动盈亏 %）、昨日梯队（昨天涨停的票今天涨跌、封没封）、500 亿以上大票的涨幅前十、昨日成交额前十；3 分钟内涨跌超 1.5% 记急拉 / 急跌，碰到或离开涨停价记封板 / 开板，异动按幅度和范围筛。页面开着就自动刷新，切走就停</td></tr> <tr><td nowrap>盯盘</td><td nowrap>竞价与盘中</td><td>昨日涨停股 09:25 的竞价强弱（中位、高开占比、分板位、最高标），09:25 / 09:35 / 10:00 / 11:30 / 14:00 / 15:00 六个时点的情绪路径（昨日涨停股中位涨幅 + 当时全市场涨停 / 炸板 / 跌停），昨晚写的明日验证条件拿盘中读数先对一对。快照由程序在时点自动存，过了时点补不回来</td></tr> <tr><td nowrap>复盘</td><td nowrap>情绪复盘</td><td>短线情绪在什么温度：赚钱效应、晋级率、连板天梯、连板溢价、梯队断层、昨日强势股反馈、封板质量、题材事件树和首板名单；AI 复盘按情绪、资金、题材、龙虎榜、龙头分五段写再汇总，每个数字和引用由程序核对、可以逐条查看依据，建议的验证条件一键加进明日验证；另有近 5 天（题材热度、题材轮动、龙头谱系）、情绪历史、明日验证（头天晚上写条件，下一个交易日收盘后自动对账）、涨停样本统计和结构变化</td></tr> <tr><td nowrap>复盘</td><td nowrap>每日复盘</td><td>打开就看市场处在什么状态：涨跌面、量能、短线情绪（涨停 / 跌停 / 炸板、昨日涨停今日表现、晋级、连板股）、指数中长期位置、两融、股债收益率、行业资金和龙虎榜；涨停股按行业分档并和前两个交易日比</td></tr> <tr><td nowrap>交易日志</td><td nowrap>—</td><td>记下自己的每笔 A 股交易（有成交明细的写进持仓流水，盈亏按流水扣掉佣金、印花税、过户费算；没有明细的只记盈亏 %），自动对上入场那天的情绪强中弱和当时板位（首板、连板、炸板、没碰涨停），按情绪环境、板位、打法、是否按计划、持有天数分组看胜率和平均每笔；<strong>风险与纪律</strong>看按计划止损估算的在险资金、权益曲线、最近 10 / 20 / 50 笔的状态、计划外交易的代价和自己的规矩有没有违反；<strong>复查</strong>列出值得回头看的单子、最大浮盈浮亏、看错了还是没执行好；<strong>模式卡</strong>把自己的打法写下来，按版本分段看业绩。只存在本机，不发给 AI</td></tr> <tr><td nowrap>产业资讯</td><td nowrap>资讯雷达</td><td>新闻、公司公告与事件线索，找出需要进一步核对的信息</td></tr> <tr><td nowrap>产业资讯</td><td nowrap>产业信号</td><td>GPU 租金、月度产业数据、原材料与招聘等上下游信号</td></tr> <tr><td nowrap>产业研究</td><td nowrap>20 个板块</td><td>侧栏里直接列出 20 个产业板块（点「产业研究」本身是全部板块一览），每个板块一页，配一组分步研究提示词：先让 AI 读研报，再按栏目一页页梳理技术路线、产业链和格局；可以复制到自己常用的 AI，也可以填进「问 Agent」。板块内容由你的 AI 查资料产出，产品不预先填写</td></tr> <tr><td nowrap>研究工具</td><td nowrap>个股深挖</td><td>选一只股票（A 股、港股、美股），分两个分页：<strong>概览</strong>直接看 K 线、财报前瞻与复盘、事件回看（A 股看业绩预告、股东增减持、回购、机构调研、龙虎榜和限售解禁，港股、美股看业绩公布前后的涨跌）；<strong>深度研究</strong>分阶段整理公司业务、财务、盈利预期、估值和风险，生成带证据的研究报告，可生成分享卡</td></tr> <tr><td nowrap>研究工具</td><td nowrap>多空辩论</td><td>目前只做 A 股：对照支持与反对的观点，找出遗漏的前提、风险与反证</td></tr> <tr><td nowrap>研究工具</td><td nowrap>回测</td><td>用对话描述要验证的想法，用历史数据检查规则表现，和指数对照、出图</td></tr> <tr><td nowrap>研究工具</td><td nowrap>候选池</td><td>在自选、持仓或指数成分股里按你设的条件逐只核对，每条写明满足、不满足还是缺数据；按代码排列，不排名</td></tr> <tr><td nowrap>我的股票</td><td nowrap>自选与持仓</td><td>两个分页。<strong>自选</strong>按名称、拼音或代码批量添加，刷新行情、持续跟踪，A 股显示离交易所异常波动标准还有多远，已持有的标「持有」；<strong>持仓</strong>按交易流水记账，结合行情看持仓、盈亏和收益率，做持仓体检、回看历史大跌期，不能下单交易。点股票名进个股深挖</td></tr> <tr><td nowrap>我的股票</td><td nowrap>事件日历</td><td>自选和持仓接下来的财报、解禁、除权除息，和台账里的裁决点、复核日排在一条时间轴上，每条带来源</td></tr> <tr><td nowrap>我的股票</td><td nowrap>提醒</td><td>A 股交易日开盘前整理盘前提醒（隔夜外围、连板股公告与停复牌、当天新股），收盘后整理收盘摘要、自选变化和到期的判据，放进收件箱，可推到系统通知或飞书 / 企业微信 / 钉钉群</td></tr> <tr><td nowrap>资料库</td><td nowrap>我的研报</td><td>导入、查阅和检索自己的资料，围绕资料提问并核对原文</td></tr> <tr><td nowrap>资料库</td><td nowrap>研究记录</td><td>按时间回看、搜索和管理研究、回测与辩论报告</td></tr> <tr><td nowrap>接入 AI</td><td nowrap>—</td><td>选择订阅或模型 API，测试成功后全站共用；固定在侧栏底部</td></tr> </tbody> </table> ### 盯盘 「盯盘」分两页。页面开着就自动刷新，切到后台就停并写明「已暂停」；开几个窗口都只取一份行情。 **实时动态** - **持仓与自选**：持仓列现价、今日涨跌、浮动盈亏 %（股数和成本在「自选与持仓」页），自选列现价、今日涨跌和成交额。 - **昨日梯队**：上一个交易日收盘仍封在涨停价的票今天走得怎么样，按全部 / 2 板以上 / 3 板以上筛；「封住」= 现价在涨停价，只在连续竞价和收盘后判断。今天还没取到行情时，先显示上一个交易日的读数并标「非今日」。 - **大票与成交额**：500 亿以上大票的涨幅前十、跌幅前五，昨日成交额前十。 - **盘中异动**：3 分钟内涨跌 ≥ 1.5% 记急拉 / 急跌，碰到 / 离开涨停价记封板 / 开板，同一只同一类 5 分钟内不重复；只在连续竞价时段判断，集合竞价和午休时清零窗口与封板状态。可以按幅度（≥1.5% / ≥3% / ≥5%）和范围（全部盯的票 / 只看持仓与自选）筛；当天的异动存在本机，重启后接着显示。异动是已经发生的行情事件，不是推荐，也不是预测。 - 连续竞价时每 3 秒取一次（大票 30 秒），其余时段 15–60 秒。行情是腾讯快照，不是逐笔，两次快照之间的变化看不到。 **竞价与盘中** - **竞价强弱**：昨日涨停股 09:25 的竞价中位数、均值、高开占比、低开超 5% 的只数，按昨日板位分开看（首板和高位板的竞价含义不同），以及最高标。 - **今日情绪路径**：09:25 / 09:35 / 10:00 / 11:30 / 14:00 / 15:00 六个时点，昨日涨停股的中位涨幅（承接强弱）和当时全市场的涨停 / 炸板 / 跌停家数、封板率、最高板，以及与复盘同口径的 1进2。同样是收盘 −2%，「早上 +3% 一路杀下来」和「早上 −5% 修复上来」是两回事，只看收盘值读不出来。 - **明日验证的盘中读数**：昨晚写的条件拿盘中读数先对一对，标「暂」，以收盘为准。 - 快照由定时任务到点自动存（同一时点失败最多重试 6 次），时点窗口里也能手动存一张；过了时点补不回来，没存的写「没存」。周末、节假日各时点标「休市」。可以选日期回看以前存下的。 ### 情绪复盘 「复盘」组里排第一，共 8 个分页。复盘日默认是最近一个已收盘的交易日；未来日期和非交易日直接拒绝，不会算出「涨停 0 家」。 - **今日情绪**：赚钱效应（昨日涨停股今天的中位数、均值、翻红率、再度涨停）、晋级率（1进2、2进3、3 板以上）、连板天梯（每个高度有谁、昨天下面一层几只接上了，没接上的今天是跌停、炸板还是没涨停）、连板溢价、梯队结构（哪个板位断档）、昨日强势股反馈（按昨日身份分档）、亏钱效应、封板质量（一直没炸、炸后回封）、情绪周期、题材事件树（同花顺涨停原因归到题材，问财补充）和首板名单。每块都有「口径」，点开看是怎么算的。 - **AI 复盘**：情绪、资金、题材、龙虎榜、龙头五段，每段开一个新对话、只看自己那几块数据，最后写汇总并建议明日验证条件，一键加进「明日验证」。每个数字由程序分三档核对：对得上资料包、写了算式且重算通过、没交代出处（算式对不上标红）；证据编号逐个核对，「查看依据」悬停看原始那一行。复盘日之后的数据不进资料包；每写一次存一版，不覆盖旧版。 - **AI 周报**：选中那天所在的一周，情绪走势、题材轮动、验证回看三段加汇总，核对方式同 AI 复盘，开头写明本周休市的工作日。「本周我的交易」从交易日志在本机算，只在页面上显示，不进 AI 资料包，也不进页面上下文。 - **近 5 天**：题材热度、题材轮动和龙头谱系。题材轮动列出近 5 个交易日每个题材每天涨停几只、排第几，标出连续几天、隔几天回流、这几天第一次出现，以及昨天还在、今天退下去的；某天没取到画「—」，不当成 0。龙头走势用前复权日 K；同样高度的最高标按首封时间排。 - **情绪历史**：每日读数在近 10 / 20 / 30 / 60 个交易日里的分位，和前一天比。 - **明日验证**：收盘后写下一个交易日的方向条件（比如「涨停家数明天持平」「1进2 晋级率明天上升」），每条附这个方向历史上出现过几成；下一场收盘自动对账，给近 60 个交易日的累计战绩。下一个交易日 09:15 开盘竞价以后不能再写或改，那之后写进来的标「事后」、不进战绩。 - **涨停样本**：昨日涨停股的次日表现，按打法（首板打板、首板早封等）、最后封板时间、入场日情绪分组，可选近 20 / 30 / 60 / 90 天。样本是事后名单，没扣掉排队买不到的情况，按收盘价等权算，是市场现象统计，不是策略回测。 - **结构变化**：最近 10 个交易日对比之前 20 个，各项读数按日中位数比有没有明显移位；东财几张池返回的字段清单有没有变（数据源改字段会造出假断点）；可以登记制度事件，比如涨跌幅制度调整。 情绪分档和周期是分析框架，不是客观事实，也不能由某一个读数直接推出交易结论。东财的涨停、炸板、跌停池只保留约一个月；「短线收盘取数」每个交易日 15:35 把定稿的读数存到本机，存下来以后一直能看。没取到的读数写明原因，不当成 0。复盘里的 AI 只解读程序取到的数据，不推荐个股、不预测涨跌、不给买卖时机。 ### 交易日志 「交易日志」排在复盘后面，共 4 个分页。数据只存在本机，**不发给 AI**：这几页不登记页面上下文，右下角的 AI 会显示「这一页还没有可聊的内容」。 - **交易记录**：成交只记在「我的股票」的交易流水里，一份账；同一只从空仓买进到卖光算一笔。每笔自动对上入场那天的情绪强中弱和当时板位（首板、连板、炸板、没碰涨停，带炸板次数和行业）。情绪分 = 涨停家数 ×（1 + 最高连板）×（1 − 炸板率），在你自己交易过的日子里三等分，所以强中弱是相对的。每笔可以标打法（打板、低吸、接力、半路、套利、其它）、是否按计划、计划止损和目标价、备注；按情绪环境、当时板位、打法、是否按计划、持有天数分组看笔数、胜率、平均每笔、最好最差和净盈亏，胜率不算持平，样本少的标「样本少」。没有成交明细的也可以只记盈亏 %。 - **风险与纪律**：按计划止损估算的在险资金、权益曲线、最近 10 / 20 / 50 笔的状态、计划外交易的代价；自己写的规矩（单笔亏损上限、单日亏损上限、同时持仓只数、每天开仓笔数、计划外占比）逐条检查，违反的列出日期。 - **复查**：值得回头看的单子，判定基准全部来自你自己（仓位大不大、拿得久不久都和你自己的中位数比，亏损上限用你写的规矩）；最大浮盈浮亏（腾讯不复权日 K，只算卖光了的一轮）；看错了还是没做好（入场那天对照前一晚写的明日验证）。 - **模式卡**：把自己的打法写下来（适用情形、入场、出场、仓位），改了从次日起算新版本，按版本分段看业绩。 只管 A 股股票（费率、印花税、T+1 都按 A 股股票的规则），ETF、可转债和港股、美股的成交照样在持仓里算，不进交易日志。算法照旧版：移动加权平均成本，费用没填的按费率估并标「估」。隐私模式遮金额、股数和自己写的价位（输入框也一样），不画权益曲线。这些都是对自己历史行为的统计，不预测市场，也不给下一笔建议。 ### 首页 打开首页先看自己的股票，再往下才是对话： - **大盘与全球指数**：A 股上证指数、沪深300、深证成指、创业板指，美股道琼斯、纳斯达克综合，港股恒生指数、恒生科技。 - **我的自选**：现价和涨跌幅，先列 10 只，可以展开全部；点名字进个股深挖。 - **我的持仓**：股数和成本由交易流水算出，列出现价、市值、持仓盈亏（金额和百分比）、当日盈亏；合计按人民币、港元、美元分开，不换汇相加。当日盈亏 =（现价 − 昨收）× 股数；这只股票最近一个交易日有买卖或送转时不能只按昨收算，就不算并把原因写在「—」下面。「最近一个交易日」先看行情自带的成交日期，节假日里也认得出（行情停在节前那天）。没取到现价或昨收的显示「—」并说明，不当成 0；流水里有数据不对、没参与计算的，和持仓页一样提示。 - **价格自动刷新**：自选和持仓在交易时段、页面在前台时约每 3 秒取一次；指数在 A 股、港股、美股任一开盘时每 15 秒取一次。港股算到 16:10，收盘竞价定下的收市价也会刷到。休市或切到别的窗口时不刷，指数条可以手动刷新。行情是腾讯快照，不是逐笔实时。 - 打开隐私模式时金额遮住，百分比照常显示。首页这部分只读，不会开始研究、调用模型或改台账。 再往下直接提问；其他栏目右上角也能打开对话，围绕当前页面继续聊。 接入订阅或模型 API 后，AI 会按问题需要联网搜索、读取网页、取数和计算；解释概念、梳理思路、翻译这类不需要新数据的问题一般直接回答。完整研究要你确认后才启动，对话不会自动变成一轮研究。没接入 AI 时也可以先浏览各个栏目。 每条回答下面列出「本轮来源」：取了哪些数据（来源、取数时间、条数，只取到一部分或用的是上次的快照会写明）、读了哪些网页（附链接）、引用了你哪份研报的第几页，没成功的单独列出；这一轮什么都没查，也会写明回答里的内容没有来源可以核对。 对话回答里的每个数字都会核对出处：要能在你发的消息、当前页面、取到的数据和网页或此前的对话里找到，或者是回答里写出的算式算出来的。找不到的只把那个数字换成「（略※）」，末尾注明有几处，其余内容照常显示。日期、年份、编号、指数名（如沪深300）、均线天数这类不是数据的数字不核对，写明「假设」的举例也不核对。核对的是数字在这些内容里出现过，不是用得对不对；一手多少股、涨跌幅限制这类常识数字，对话里没有出处时同样会被略去。 ### 每日复盘 「每日复盘」打开就看市场处在什么状态，可以让 Agent 按页面上的数据写一份复盘。交易时段默认看今天（收盘前数字还会变），也可以切到上一个交易日看完整的一天。从上到下： - **市场状态**：八格一眼看全 —— 涨跌家数、两市成交额和 20 / 60 日均值比、涨停 / 跌停 / 封板率、最高连板、昨日涨停今天的平均涨跌、站上 20 / 60 / 250 日线的指数个数、两融余额的 5 日变化、沪深300 市盈率与股息率和 10 年国债收益率。 - **短线情绪**：涨跌分布（涨停到跌停 23 档）和沪深京三所家数、成交额；赚钱效应（昨天涨停的今天平均 / 中位数涨跌、上涨比例、又涨停的比例）与亏钱效应（跌停、炸板、昨日涨停今天跌 5% 以上）；晋级（首板 → 2 板、2 板 → 3 板……各有几只又涨停）；连板股（连板数、首封时间、当天价格与成交额、流通市值、行业、同花顺题材）。 - **中长线**：八个主要指数的 5 / 20 / 60 / 250 日和年初至今涨跌、离一年高点多远、在 20 / 60 / 250 日线上方还是下方；两市成交额近 60 日柱图和均值线（盘中那根没收完，不和整天均值比）；两融余额走势；沪深300 股息率、盈利收益率和 10 年国债收益率的差。 - **资金去了哪**：行业资金净流入 / 流出居前（东财取不到时换新浪，口径写明）、全市场成交额前 20、龙虎榜净买入 / 净卖出居前。 每块写着自己的数据日；涨跌分布、行业资金、成交额榜三个来源只给当天，看上一个交易日时标「此刻快照」。没取到的块直接说没取到和原因，不显示成 0。「偏强」「活跃」这类标签按写死的阈值算，规则写在标签上；全部是公开数据的整理，不预测涨跌。 涨停股按东财行业归类，和前两个交易日比，按只数分四档：**连续集中**（今天同一行业 ≥ 3 只涨停，前两个交易日每天也 ≥ 2 只）、**今天集中**（今天 ≥ 3 只，前两个交易日不是每天都 ≥ 2 只）、**零散**（2 只）、**单只**。每个行业列出涨停的股票、连板数、最高板（连板数最多、同样多时首封最早的那只）和梯队（各连板高度各几只），以及出现最多的同花顺题材标签。档位是按只数的固定规则，不代表能不能持续，也不是推荐；行业名是东财给的简称（最长 4 个字），题材标签是同花顺的市场叙事，不是核验过的因果。前两个交易日的涨停池没取到时写明分不出是不是连续，不当成 0。让 Agent 复盘时，板块部分按这四档的顺序写，小标题不超过 25 个字，不用渲染词。 ### 产业研究 「产业研究」列出 20 个产业板块（人形机器人、AI 算力、HBM、光互联、PCB、半导体国产替代、固态电池、可控核聚变等）。每个板块配一组分步研究提示词：第 1 步让 AI 先读你资料库里和这个板块相关的研报，再找今年和去年的公开行业研报；之后一步产出一页，比如总览、技术路线、产业链与价值量、全球格局、确定性地图（光互联、HBM、人形机器人、PCB 四个板块用各自的栏目）。年份按打开页面当天的日期写，不写死。 每一步可以「复制」贴到你常用的 AI，也可以点「发给 Agent」填进右上角「问 Agent」的输入框，看过再发送，不会自动发出；回答下面点「存进记录」，攒成这个板块的研究笔记。 板块内容不预先填写：提示词只给研究方法，内容由你的 AI 当场查资料产出，每个数字都要求写来源和年份，查不到写「未查到」；只讲产业，公司只按在产业链里的位置描述，不涉及估值和买卖。 ### 候选池 「候选池」在一个范围里按你设的条件逐只核对。范围可以选自选、持仓，或沪深300、中证A500、中证500、中证1000、中证2000、上证50、科创50、创业板指的成分股（成分取自中证 / 国证指数官网的成分文件）。条件可以设市盈率（TTM）、市净率、总市值、当天成交额、换手率的区间，以及排除 ST / \*ST / 退市整理和当天没有成交的（停牌）；行情来自腾讯。 每只、每条都写明满足、不满足还是缺数据，并列出实际的值。结果分「全部满足」「有缺数据」「有不满足」三组，按代码排列，不排名、不打分；「全部满足」只说明过了你设的这几条。来源没给的值单独算缺数据，不当成 0；亏损公司的市盈率是负数，照实显示。开盘前几乎所有股票都还没有成交，这时「停牌」这一条记为缺数据。自选和持仓里的基金、债券、港股、美股不核对，页面上写明。点「去研究」会打开个股深挖并选好这只股票。 ### 个股深挖 「个股深挖」页先选一只 A 股、港股或美股，再分「概览」「深度研究」两个分页。选股票只是打开这只，不会自动开始研究。A 股的页头有「多空辩论」按钮，带着这只股票去多空辩论页。 「深度研究」按 **公司画像 → 财务 → 盈利预期 → 估值 → 风险 → 报告** 六个阶段展开。除了报告，还保留每个阶段用到的资料、计算依据、来源冲突与数据缺口：缺数据就记为缺口，不当成零；无法验证的结果不写成已完成。 港股、美股同样走这六个阶段，口径按市场调整：开头先核对公司身份（行情来源和公司资料来源报的公司名要对得上，对不上就写明没核实）；财务只用研究当天已经公布的数（按公告日筛选），季度、全年、年初至今累计分开标，近四季合计由累计值推算，不按自然季度硬拆；股价、市值和利润币种不同时（如腾讯港元报价、人民币列报）先按汇率换算再算市盈率，汇率照抄汇率数据；一致预期取当前财年和下一财年；报价参考日按市场取美股标普 500 或港股恒生指数；市盈率历史分位用百度股市通的 PE TTM 序列。港美股不披露扣非，扣非市盈率一格写明未获取；单季环比本版不算。 报告「推断」里每条标一档可信度：已披露证实 / 有依据的推断 / 未核实线索 / 被反证，除「未核实线索」外都要写出证据或计算编号。报告开头附「口径提示」：同一计算混用了币种、TTM 与单季计算的期末不一致、按 A 股定期报告披露期限财报不是最新一期、扣非 × 4 年化被季节性放大或压低时，会写明。报告里没引编号、本次取到的数据和计算里也找不到出处的数字（同行引了用户资料的，资料片段里找得到也算有出处），交付前换成「〔未核实〕」，报告开头写明有几处，运行标为不完整；日期、编号、写明是假设或情景的行和表格不算。 「概览」直接看 K 线：5/10/20/60 日均线和成交量，日 / 周 / 月三档，A 股可切换前复权、后复权、不复权；只看行情，不画买卖点，北交所暂不支持。 K 线下面是「财报前瞻与复盘」（A 股、港股、美股都能看）：下一份财报的日期（A 股取东财预约披露日，公司可以改期，以交易所公告为准；港美股取 Yahoo，写明是估计日期还是公司公布的日期）、一致预期的均值和区间（A 股是全年每股收益，港美股是本季每股收益），A 股有下一期业绩预告时一并列出；过去几次财报发布后第一个交易日的涨跌（复权收盘价，含当天大盘涨跌；几份财报落在同一天的合并算一次），和此前几次的平均绝对涨跌对照，以及实际和预期差多少（A 股对照业绩预告区间，港美股对照一致预期）。数字都由计算库算出；只描述过去，不预测下一次，不出目标价。北交所的涨跌暂不支持（行情来源不支持），取不到的写进缺口。「问 Agent」会带上这张卡片。 概览里还有「事件回看」。A 股可选七类事件——业绩预告、重要股东增持、重要股东减持、回购方案、机构调研、龙虎榜上榜、限售解禁（东财数据），列出这只股票历史上每一次事件前 5 个交易日到后 20 个交易日、相对沪深300指数的累计超额收益（每天的涨跌减去指数当天的涨跌，再累加），按「事件前 5 日 / 第 0–1 日 / 第 0–5 日 / 第 0–20 日」四档给平均、中位数和上涨占比，再画一条平均路径；业绩预告另按向好（预增、略增、扭亏、减亏）和向差（预减、略减、首亏、增亏）分组，龙虎榜按上榜席位合计净买入 / 净卖出分组，限售解禁按实际可流通股数占总股本 ≥ 1% / 不到 1% 分组。回购按方案第一次公告的日子算；机构调研按调研记录的公告日算（东财只保留近一年左右）；龙虎榜收盘后才公布，第 0 天从上榜日的下一个交易日算起，上榜当天的涨跌落在「事件前 5 日」；限售解禁另把已经排期、还没到的批次列在最上面（只列出来，不算涨跌）。港股、美股看「业绩公布」：港股按港交所披露易的末期 / 中期 / 季度业绩公告，16:00 收市后发的从下一个交易日算起（平安夜、除夕这类半日市午后发的仍算当天），对照盈富基金（跟踪恒生指数）；美股按 SEC 8-K 里的业绩公布（Item 2.02）：在「接入 AI」页填了 SEC 联系方式（英文姓名和邮箱，SEC 要求每个访问者留下）就用 SEC 官方全文检索，大银行这类也能取全；没填用东财转载的申报，大银行每年上千份债券申报翻不完，可能取不到，结果里会提示去填。第 0 天是美东提交日（多数公司收市后发，主要看「第 0–1 日」），对照 SPY；外国公司（ADR）用 6-K 报业绩，取不到；港美股日线只能取到约 10 年前，更早的事件不算。同一天的几条公告算一次；窗口里有停牌的照列、不进平均；最近的还没满 20 个交易日的只进已有的几档；两次相隔太近、窗口重叠的会标出来；少于 8 次不给平均，只列逐次结果。A 股用前复权日线，沪深300指数是价格指数、不含分红；港美股用 Yahoo 拆股调整后的收盘价，对照的 ETF 也是收盘价、不含分红。港美股的股东增减持这一版没做。回购多数公司只做过几次、机构调研只有近一年，次数常常不到 8 次，这时只列逐次结果。点「开始回看」才取数，「问 Agent」会带上结果；只描述过去，不预测、不给买卖提示。 同一家公司研究过两次以上，打开报告时可以另选一次来比较：关键数据逐条对齐，分「变了 / 新增 / 消失」，每个数都能追回各自的证据编号；报告按章节列出哪几行改了。只并列两次写了什么，不解读涨跌；证据和计算编号每次都会重新生成，比较时已经忽略。 换一家 Agent 再研究同一只股票，「各次研究过程对比」能把这几次的研究过程并排看：取了多少证据、实际引用多少、报告里引了证据编号的数字有多少对得上、几个阶段资料齐全、几个阶段一次就过校验、写出了几条缺口、用了多久。只比研究过程，不比结论对错，也不比收益；不打总分、不排名次，读不到的显示「—」。取数范围不同、只跑了部分阶段时会先说明，这时数量不能直接比。 对比出来以后，下面会列出本机已登录的订阅 Agent（Codex / Claude Code / WorkBuddy），点一下就用那家的订阅、同样的取数范围再研究这只股票，只这一次用它，不改你在「接入 AI」里的设置。对比表可以存进研究记录；研究归档旁的「本周对比周报」把近 7 天被两家以上 Agent 研究过的股票汇成一份，只存在本机。 报告通过校验后可以生成「分享卡」：竖版（手机）或横版的 PNG，也能复制成文字。卡片只放这次研究取到的原始数据（股价、总市值、市盈率、市净率、营业收入、归母净利润、一致预期每股收益，各带日期和来源；同一期几个来源的值不一样就都列出，图上每项最多两个，文字版最多三个）、用了多少证据 / 来源 / 计算、哪几项数据有缺口，以及一句声明；不放报告里的判断、评分和目标价。 研究中可以看进度、请求中止，刷新页面后状态还在；发出中止请求不代表已经停止，页面会分开显示这两种状态。报告、证据和计算记录都存进「研究记录」。 ### 我的研报 导入 PDF、DOCX、TXT、MD 或 CSV，查阅、检索，围绕资料提问。回答里的引用能回查原文，文本型 PDF 带页码；扫描版 PDF 要先做文字识别。**有引用不代表推论一定正确，仍需核对原文与计算条件。** 原文件在本机保存和解析，检索命中的正文片段才会发给所选模型；本地保存不等于全程离线。 ### 多空辩论与回测 **多空辩论**（研究工具下单独一页，目前只支持 A 股；个股深挖页头的按钮会带上当前股票）：不同分析视角围绕同一份资料，给出支持理由、风险和反驳，找出尚未解决的分歧。 **回测**：用自然语言描述要验证的规则，缺条件会继续追问，条件齐了再用历史数据跑。跑不了或不支持的条件会直接说明，不把没执行的任务写成回测结果。 - 和指数对照：A 股沪深300指数、美股标普500 ETF（SPY）、港股盈富基金（02800.HK，跟踪恒生指数）；取不到时退回所测标的自身的等权买入持有，并写明。 - 43 项数值指标，附月度 / 年度收益表和最深 5 段回撤；另把费用和滑点设为零、同一套信号再跑一遍，给出扣费前后对照和成本吃掉的百分点；报告下方画累计收益对基准、水下回撤、月度收益热力图、年度收益柱 4 张图，图里的数和报告同源。图只在当次会话里显示，存进「研究记录」的是报告和年度收益、回撤段附表。 - 稳健性检验（夏普置信区间、分段检验）和邻近参数敏感度网格，页面写明不代表最优参数，也不代表未来表现。 - 内置四种规则：买入持有、均线交叉、RSI 均值回归、RSRS 择时。RSRS 按光大证券 2017 年公开研报的公式自己写（每天用最近 18 天的最高价对最低价回归取斜率，看斜率的标准分有没有越过 ±0.7），研报参数是在沪深300指数上定的，用在个股不一定成立；前 617 根日线只用来算指标、不持有，所以区间要更长（默认参数下波段约 3.5 年、长线约 4.5 年起，不够会直接说明还差多少）；平仓记录少于 10 条时，报告写明结论说明不了有效还是无效。只用于历史回测，不给当天的读数。 - 一次运行里的多只标的合成等权组合；A 股只回测个股，ETF、指数、可转债会被拒绝。 - 回测最后一天能卖的按收盘价平仓；最后一天才买进的部分（A 股 T+1；最后一天加仓的只留加的那部分）、收盘封在跌停、当天没有行情的不编一笔卖出，按收盘价计入期末净值，报告里写明是哪几只。 两者都要先接入 AI，报告存进「研究记录」。历史表现不代表未来结果，也不是交易建议。 ### 自选与持仓、研究记录 「自选与持仓」分两个分页：「自选」管关注清单，已经持有的标「持有」；「持仓」按交易流水记账，收益表现、交易流水、持仓体检、历史回放在页面下方分页切换。点股票名进个股深挖。「研究记录」按时间保存研究、回测和辩论报告。A 股、美股、港股代码都能用。 - 找股票：个股深挖、多空辩论、持仓（记一笔）共用一个搜索框，输入「gzmt」「茅台」「600519」都能找到；自选可以粘贴一串代码、中文名或拼音首字母批量添加，有歧义的会列出候选。搜索接口不通时退回只认代码，并给出提示。 - 异动接近度：A 股自选显示离交易所「异常波动 / 严重异常波动」标准还有多远：3 日、10 日、30 日的累计偏离（区间涨跌幅减去基准指数同期涨跌幅）对照标准，以及 10 日内已有几次同向异常波动。标准取自沪深北交易所 2026 年修订的交易规则，按公开规则推算，以交易所公告为准；只看离标准多远，不判断方向、不预测。北交所（行情来源不支持）、基金、债券、港美股不算，页面写明；沪深主板「换手率放大」那一条日 K 里没有换手率，也写明没算。 - 交易流水：持仓按一笔笔流水记——期初持仓、买入、卖出、现金分红、送转拆股，按日期重放出当前持仓、已实现盈亏和分红；成本法可选先进先出或移动加权平均。数据不对的流水逐条写原因、不参与计算。各币种分别合计，另给一行按当前汇率折合的人民币参考（写明汇率和日期）。以前一只一条的持有记录会自动转成「期初持仓」流水，转之前先备份到数据目录的 `ledger/持仓迁移备份-日期/`；同一代码已经有自己记的流水时不自动转，由你来选。 - 收益率：按币种分开给时间加权收益（看所选的票本身走得怎么样）和资金加权收益（XIRR，看这些钱实际赚了多少），不满一年不给年化。A 股用不复权价、按流水里的送转换算股数；港美股按流水里的送转拆股还原成当时的价格，所以送转拆股要记上。取不到价格的整只不算、写进缺口，不拿成本价凑市值；价格大约能取到近 5 年，更早就卖光的不算，写明几只。流水里没填费用的买卖按 0 算，说明里写明几笔、收益率可能偏高。 - 从表格批量导入流水：选 CSV 文件或从表格软件复制粘贴，在本机按列名解析、不发给 AI；常见券商导出的列名和 GBK 编码都认。每行和手动记一笔过同一套检查；表格软件吃掉开头 0 的纯数字代码（如 1、700）一律拒，免得把 A 股记成港股。先预览（和已记的重复、写进去会卖超的、已记的会因此算不了的都标出来），勾选的行要么全写、要么全不写，写之前先备份到 `ledger/持仓导入备份-日期/`。 - 持仓体检：按币种分别算集中度、年化波动、最大回撤、单日 95% VaR / ES、每只的风险贡献和两两相关性，以及行业暴露（A 股按申万一级；港美股按 GICS 一级，来自东财公司资料，美股按东财给的细分行业对回一级），每个行业下面列出是哪几只；ETF、基金这类没有行业资料的单独一组，不算进单一行业提醒线。提醒线自己设，超线时在持仓页顶部提示；只给数字，不出综合分，缺数据的写进缺口。 - 历史情景回放：按现在的持仓比例，把几段历史大跌期重放一遍——A 股 5 段（2015 年股灾、2016 年熔断、2018 年、2020 年 3 月、2021–2024 年），港股、美股各 4 段，并排看组合涨跌、期间最大回撤、最差单日和同期指数，点开一段看走势图和每只的贡献。按币种分开、不换汇；当时还没上市或没有价格的写进缺口，有价格的不到这一组市值一半时不给组合数字。A 股能回到 2015 年，港美股约 10 年；A 股的 ETF、指数、可转债这一版回放不了（港美股 ETF 可以）。点「开始回放」才取数；只回看，不预测、不给操作提示。 - 防篡改核对：每次研究结束、每次在软件里保存或删除记录，都在本地登记簿里记一个指纹。「研究记录」页最下面点「核对」，能查出报告、证据、原始数据和台账记录有没有被人绕开软件改过或删掉，并写明是哪几个文件。登记簿和数据在同一个文件夹，能改数据的人也能整份重写登记簿，所以页面会给一个「链头」，复制到别处保存，以后粘回来比一下就能发现。 自选股和持仓还支持让 AI 从截图或表格识别出草稿，**核对后手动确认才保存**，上传不会直接改写台账。识别时选定的内容会发给当前 AI，请先去掉无关的敏感信息。本机暂存件在成功、失败或取消后都会清理，请保留原文件以便核对；清理本机暂存件不代表模型服务商删除了已收到的内容。 ### 定时提醒 程序开着时，A 股交易日开盘前和收盘后会自动整理四份消息，放进「提醒」页的收件箱： - **盘前提醒**（默认 09:05）：隔夜美股三大指数、A50 期指（较前结算）和美元兑人民币；前一交易日 2 板及以上的连板股今天在不在停复牌名单里，板数最高的 20 只有哪些新公告（标题里有停牌、异常波动、问询、减持这类字眼的排前面）、按交易所规则推算离严重异常波动较近的（以交易所公告为准）；今天申购和上市的新股。设在上午、拖到 11:30 以后才补跑的不发。 - **收盘摘要**（默认 15:40）：主要指数涨跌、涨停 / 炸板 / 跌停家数、最高连板、主力资金净流入和净流出前三的行业、龙虎榜上榜只数。 - **自选变化**（默认 16:15）：自选里每只的当日涨跌（港美股标出行情日），A 股自选上次以来的新公告标题（最多查 30 只），以及离交易所异常波动标准七成以上的 A 股自选（按规则推算，以交易所公告为准）。 - **判据到期**（默认 16:30）：台账里的裁决点、证伪条件到了日子，列出写下以来的公司公告标题（A 股），提醒回来标记。周末到期的在下一个交易日提醒，同一条只提醒一次。 另有两件不发消息的后台活：**短线收盘取数**（默认 15:35）把当天定稿的情绪读数、昨日涨停股今日表现、涨停结构、事实表和连板天梯先存到本机，以后打开情绪历史、明日验证不用等，东财只留约一个月的数据也能一直攒下去；**盘中快照**在交易日 09:25 / 09:35 / 10:00 / 11:30 / 14:00 / 15:00 各存一张，给「盯盘 · 竞价与盘中」用，过了时点补不回来。 只列事实，不给买卖建议；某块数据没取到就写「没取到」，不写成 0。时刻按北京时间，可以改，也可以关掉；周末和节假日不运行，交易日历取不到时当天不运行，并在收件箱说明。电脑关机或程序没开时不会运行，当天再打开时，过了时刻还没跑的任务会补跑一次。 推送可选：系统通知（macOS、Linux）和飞书、企业微信、钉钉群机器人，不开也照样进收件箱。机器人地址和密钥只存在本机，页面上只显示打码后的样子。可以设静默时段（只进收件箱、不推送）；同一条内容 24 小时内只推一次。 ### 事件日历 「事件日历」把自选和持仓接下来 7 / 30 / 90 天要发生的事排成一条时间轴，每条写明来源： - A 股：定期报告预约披露日、限售解禁（写实际解禁股数）、除权除息（每 10 股派息和送转）。过了预约日还没披露的单独列出。 - 美股：财报日（Nasdaq）；只是预估的日子标「预估」。 - 港股：目前没有可用的逐只事件来源，页面上写明没查。A 股的 ETF 等基金和债券也不在这几个来源里，同样写明没查。 - 台账里写的裁决点到期日、论点复核日和待办到期日放进同一条时间轴；过了日子还没处理的放在最上面。 - 宏观日历（华尔街见闻，只取重要程度高的）默认不显示，可以打开。 A 股最多查 30 只，持有的优先。某个来源没取到会列在「没查到的」里，不当成没有事件。 到期没判的裁决点和证伪条件放在页面上方，每条附上写下以来的公司公告标题（A 股；来源每次只给最近 30 条，看不全时会写明）。对照后自己标记：裁决点选「兑现 / 没兑现」，证伪条件选「到期没触发 / 触发了」，也可以「不再跟踪」，并写一句依据；标错了可以改回待判。判过的累积成一张回看表，只数判据兑现了多少，不算涨跌、不算胜率。 ## 数据与市场 数据注册表共 **182 个端点、35 层**，其中 14 个是短线专用（`cn_shortline_*`）：情绪四项、情绪周期、每日读数、六张事实表、连板天梯、题材事件树、近 5 天题材轮动、首板名单、昨日涨停股当日表现、涨停结构、盘中情绪、昨日梯队、成交额前十、大市值股；已收盘的日子长期缓存，没收盘的一天标「部分」、不缓存。SEC 的 7 个端点要先在「接入 AI」页填 SEC 联系方式（或设环境变量 `VRA_SEC_CONTACT`），没填时会说明缺这一项。其余类别包括行情、K 线、逐笔、财务、一致预期、公告、研报、资金、筹码、南向资金、AH 溢价、公司资料、期权、指数、期货与大宗、事件驱动、可转债、SEC / FINRA / CBOE、新闻、宏观、产业温度计、招聘、管制与数据日历。A 股数据同步到 [a-stock-data](https://github.com/simonlin1212/a-stock-data) v3.10.1，美股 / 港股数据同步到 [global-stock-data](https://github.com/simonlin1212/global-stock-data) v2.0.3。 | | A 股 | 美股 | 港股 | |---|---|---|---| | 盯盘、情绪复盘、交易日志里的板位与情绪 | ✓ | — | — | | 数据端点（各市场种类不同，见端点目录） | ✓ | ✓ | ✓ | | 自选股、持仓、研报库、AI 对话 | ✓ | ✓ | ✓ | | 六阶段个股研究 | ✓ | ✓ | ✓ | - 短线功能只看 A 股：涨停、炸板、连板、梯队这些读数来自东财涨停池、同花顺和问财等 A 股来源。交易日志也只管 A 股股票（费率、印花税、T+1 都按 A 股股票的规则）；ETF、可转债和港股、美股的成交在「自选与持仓」照样记账、算盈亏，不进交易日志，页面上只报个数。 - 东财的涨停、炸板、跌停池只保留约一个月；「短线收盘取数」每个交易日 15:35 把定稿的读数存到本机，存下来以后一直能看。程序没开、没存上的日子，超过一个月就补不回来；没取到的读数写明原因，不当成 0。 - 港股、美股研究的口径差异见上文「个股深挖」。 - 端点登记在册不保证第三方服务随时可用；第三方公开数据可能延迟、缺失或有误。 端点目录见 [datasources/CATALOG.md](datasources/CATALOG.md)。 ## 支持的 AI | AI | 需要准备 | |---|---| | Claude Code 订阅 | 本机安装 Claude Code，并用 claude.ai 订阅登录 | | Codex 订阅 | 本机安装 OpenAI 官方 Codex CLI（0.160.0 及以上），并用 ChatGPT 账号 `codex login` 登录 | | WorkBuddy / CodeBuddy | 本机已安装并登录的 WorkBuddy 桌面版（自带 CodeBuddy Code），或腾讯官方 CLI `@tencent-ai/codebuddy-code` | | 模型 API | 任意兼容 Chat Completions 的服务：DeepSeek、通义千问、智谱 GLM、Kimi、MiMo、OpenAI 等，填 API 地址、模型名和 key | - 第一次打开首页会弹出「请接入AI」：已登录的订阅点一下就能测试并保存；「其他接入方式」进入设置页填 API。也可以先关掉弹窗浏览栏目。 - 订阅直接用你本机已登录的 CLI，不需要往页面里填 key；产品不读、不复制登录文件。 - 点「测试并保存」会先发一次真实对话，成功才生效；失败不会覆盖当前已生效的配置。 - 选了哪个就用哪个，条件不满足会直接报错，不会悄悄换成别家。 - 模型 API 要支持 Chat Completions 和工具调用（function calling）。 - 产品不附赠订阅或额度，需要对应服务可用。 - 不接 AI 也能用：盯盘、情绪读数、明日验证对账、涨停样本、交易日志都由程序算；AI 复盘、AI 周报、对话、个股研究、多空辩论和回测要先接入。 **各家怎么连接：** - **Codex**：`npm install -g @openai/codex`，在终端运行 `codex login`，用 ChatGPT 账号登录；回到「接入 AI」点「重新检测」，显示可用后点「测试并保存」。用 API key 登录的 Codex 不可用，避免订阅悄悄变成按量计费。 - **Claude Code**：用 claude.ai 订阅登录后，设置页会自动检测；API key、Bedrock、Vertex 登录不算订阅。 - **WorkBuddy / CodeBuddy**：装好并登录 WorkBuddy 桌面版就能直接识别，不用重复安装或登录；Windows 上装在别的盘或自定义文件夹，也会从「已安装的程序」登记或正在运行的 WorkBuddy 里找到。没有桌面版时，运行 `npm install -g @tencent-ai/codebuddy-code`，再运行 `codebuddy` 登录。仍找不到时（卡片显示「未安装」），先打开 WorkBuddy 再点「重新检测」，或在 WorkBuddy 卡片里填它的安装文件夹，或在启动前设环境变量 `CODEBUDDY_BIN`。 - **模型 API**：「接入 AI」→「API 接入」，选供应商，填 API 地址、模型名和 key，点「测试并保存」。 本机状态不明确时，运行 `scripts/doctor`（Windows 为 `scripts\doctor.ps1`）查看修复提示。 <details> <summary>接入细节、工具权限与局域网访问</summary> - 研究的每个阶段是一次独立会话，只能调用 Vibe AStock 的 5 个受控工具（列文件、读文件、确定性计算、写阶段产物、写报告），订阅 CLI 的内建工具全部关闭；收工检查由产品执行，四种 AI 来源都一样。 - 页面上的对话、研究、辩论和回测都允许 AI 联网和调用产品工具。通过接口调用时仍可传 `executionMode: "direct"` 要一轮不调用工具的回答；这时个股研究、多空辩论和 Agent 回测会直接报错，不会悄悄降级。 - 订阅只认对应的订阅登录（Codex 只认 ChatGPT 登录，Claude 只认 claude.ai 订阅登录）。终端里的 API key 环境变量不会带进 CLI，避免计费方被悄悄换掉。研究只开放产品受控工具；用户配置与自动记忆保持关闭。 - 例外：Codex 会读你自己的全局 `$CODEX_HOME/AGENTS.md`（没有参数能关）。产品指令优先级更高，但里面的称呼、语气等设定仍可能生效；产品不加载你的 `config.toml`。 - WorkBuddy 自带的旧版 CLI 如果没有「禁止会话落盘」参数，整次回答会改在一次性临时目录里运行，结束后删除。 - 订阅的每次对话都会启动对应的本机 CLI，不承诺固定响应时间。 - API 模式的 key 保存在当前浏览器的本机 `localStorage`，方便下次直接使用；它不是系统钥匙串，也不承诺加密，只建议在可信的个人电脑上使用，共享电脑用完请主动清除。key 随请求发到本机后端，不写进仓库、后端配置、运行账本或日志。 - 内置供应商模板：OpenAI、DeepSeek、通义千问、智谱 GLM、Kimi、MiMo 指向各家官方 Chat Completions 地址，另有一个未实测的 `selfhosted` 自托管占位模板。截至 2026-10-11，这些模板都还没用真实 key 跑过兼容矩阵，界面标「有模板·未实测」。未实测照样能用：结构化要求写进提示词，产物仍由产品自己校验；用真实 key 实测过的模板才标「已实测」。 - 出现重新连接提示时，按页面上的具体错误处理（未登录、登录失效或连接测试没通过），不要都当成订阅过期。 详细说明见 [docs/model-access.md](docs/model-access.md) 和 [providers/README.md](providers/README.md)。 **局域网访问**（可选，默认关闭）：从仓库根目录运行 `VRA_LAN=1 bash scripts/start`；Windows PowerShell 先设置 `$env:VRA_LAN="1"`，再运行 `scripts/start.ps1`。只开放前端，后端仍绑定回环地址； 后端已启动时也可运行 `VRA_LAN=1 npm run dev --prefix desktop`。 **仅限受信任的局域网**：这是单用户工作台共享，不是账号隔离，网络内能访问端口的人都能操作。 HTTP 不加密，API key、研究资料和交易记录可能明文传输；不要暴露到公网，也不要在不可信网络开启。 代理先校验浏览器同源，再归一化 Origin；远程模型地址仍须 HTTPS，本机模型可用回环 HTTP。 详见[模型接入与局域网边界](docs/model-access.md#5-自托管模型局域网与远程访问)。 </details> ## 快速开始 ### 环境要求 | 项目 | 要求 | |---|---| | 操作系统 | Windows 11、macOS 或 Linux；Windows 原生运行，不要求 WSL | | Node.js | ≥ 22.18，推荐 24 LTS | | Python | ≥ 3.11，推荐并已验证 3.12 | | Git | 用于克隆和更新代码 | | AI | 见[支持的 AI](#支持的-ai)；setup 不会安装 Claude Code、Codex 或 WorkBuddy | > Node 必须是启用了 TypeScript 支持的构建（nodejs.org 官方安装包、nvm / fnm / Volta 装的都是）：`node -p process.features.typescript` 应输出 `strip` 或 `transform`。部分 Linux 发行版仓库打包的 Node 编译时关闭了这一项，启动或跑测试会报 `ERR_UNKNOWN_FILE_EXTENSION ".ts"` / `ERR_NO_TYPESCRIPT`，请换官方构建。`npm test` 前会先做这项检查并给出同样的提示。 ### 安装并启动 Windows（PowerShell / CMD）： ```bat git clone https://github.com/simonlin1212/vibe-astock.git vibe-astock cd vibe-astock scripts\setup-windows.cmd scripts\start.cmd ``` macOS / Linux： ```bash git clone https://github.com/simonlin1212/vibe-astock.git vibe-astock cd vibe-astock scripts/setup scripts/start ``` - setup（`scripts/setup` 或 `scripts\setup-windows.cmd`）会创建 `.venv`、安装 Node / Python 依赖、初始化私有数据目录并运行体检。 - start（`scripts/start` 或 `scripts\start.cmd`）会检查安装状态和端口，同时启动本机 API 与页面，两边都可用后打开 [http://127.0.0.1:5940](http://127.0.0.1:5940)；不需要开两个终端，按 Ctrl+C 同时关闭。 - 端口和 Vibe Research（5930）错开，两个可以同时开，接入 AI 的设置、对话记录和登录状态也不会两边混用。环境变量沿用 Vibe Research 的 `VRA_` 前缀：在系统里全局设过 `VRA_DATA_ROOT` 的话两个产品会用同一个数据目录，只在单条命令前设置就不会。 - 端口：页面默认 5940、本机 API 默认 8770。默认端口被别的程序占用、或被系统保留（Windows 上 Hyper-V / WSL 常整段预留端口）时，会自动换一个空闲端口并在终端说明，浏览器打开的就是实际地址；已经开着一个 Vibe AStock 时，会提示直接打开它。 - 换了端口后，「接入 AI」里的模型 API 设置和对话记录要在新地址重新设置：它们存在浏览器里，按地址分开。同样的占用情况每次换到同一个端口；默认端口空出来后重启，就回到原来的地址和设置。 - 想固定端口：`scripts/start --port 6940 --api-port 9770`（Windows：`scripts\start.cmd -Port 6940 -ApiPort 9770`），或设环境变量 `VRA_UI_PORT` / `VRA_API_PORT`。自己指定的端口不能用时直接报错，不会擅自换。 - macOS / Linux 不想自动打开浏览器时，运行 `scripts/start --no-open`。 - Vite 只在本机代理 `/api/*`，并在服务端补上鉴权信息。若设置了 `VRA_DATA_ROOT`，两个进程必须使用同一个值。 - 盯盘的自动刷新、收盘取数和盘中快照都要程序开着；电脑关机或程序没开时不会运行，盘中快照过了时点补不回来。 部署、接口与维护说明见 [AGENTS.md](AGENTS.md)；`desktop/` 是浏览器前端目录，不是桌面客户端。 ### 免安装版（Windows / macOS） 不想装 Node、Python 和 Git，可以到 [Releases](https://github.com/simonlin1212/vibe-astock/releases) 下载对应电脑的压缩包，包里带好了 Node 和 Python： | 电脑 | 系统要求 | 压缩包 | |---|---|---| | Windows（x64） | 64 位 Windows 10 及以上 | `VibeAStock-<版本>-win-x64.zip` | | Apple 芯片 Mac | macOS 14 及以上 | `VibeAStock-<版本>-mac-arm64.zip` | | Intel Mac | macOS 14 及以上 | `VibeAStock-<版本>-mac-x64.zip` | 1. 解压到任意文件夹，双击里面的 `Start-VibeAStock.cmd`（Windows）或 `Start-VibeAStock.command`（macOS）。会开一个命令行 / 终端窗口，浏览器自动打开 [http://127.0.0.1:5940](http://127.0.0.1:5940)（5940 被占用时自动换一个端口，以窗口里显示的地址为准）；关掉那个窗口就退出。 2. 包没有代码签名，第一次打开会被系统拦：Windows 弹出「Windows 已保护你的电脑」时点「更多信息」→「仍要运行」；macOS 提示无法验证开发者时，在终端运行 `xattr -dr com.apple.quarantine <解压出来的文件夹>`，再双击启动。 3. 交易记录、复盘、研究记录和设置都存在这个文件夹的 `.local` 里（macOS 的访达默认不显示以点开头的文件夹，按 Command+Shift+. 就能看到）。升级时把新版本解压到新文件夹，把旧文件夹里的 `.local` 整个复制过去，再从新文件夹启动；确认没问题再删旧文件夹。 4. 接入 AI 和源码版一样：沿用电脑上已登录的 Claude Code / Codex / WorkBuddy，或在「接入 AI」填模型 API。 每个压缩包旁边有同名的 `.sha256` 文件，可核对下载是否完整。免安装版只在本机打开，不开放局域网；要局域网或云端访问、或用的是 Linux / 更早的 macOS，请用上面的源码安装。 ### 远程访问（云端电脑） 在一台 macOS / Linux 云端电脑上： ```bash scripts/setup scripts/start --remote --no-open --public-url https://<平台给页面端口（默认 5940）分配的公网地址> ``` 启动后终端会打印一条带访问口令的链接（`https://…/?access=…`），用浏览器打开就能用；之后 30 天内直接打开公网地址即可。不需要 SSH，也不用连回本地电脑。后台运行、更换口令等完整步骤见 [AGENTS.md](AGENTS.md) §3。 - 页面、静态资源和接口的每个请求都要先过访问口令；本机 API 仍只监听回环地址。 - **只用 https 公网地址**，否则页面里填的 API key 会明文传输。页面只能挂在根地址，不支持子路径。 - 拿到链接的人能用这台电脑上的全部功能，包括你的交易日志和持仓，链接只给自己用；启动日志里也有访问口令，别外传。 - 云端电脑上通常没有你的订阅登录，在页面里用模型 API 接入即可。 - 远程模式的页面端口不会自动换（云平台映射的是固定端口）：5940 被占用时先停掉占用它的程序，或用 `--port` 换成平台开放的端口。 - 程序一直开着的云端电脑适合跑收盘取数和盘中快照，不会因为本机关机漏存。 ### 从旧版（v1.x）升级 旧版 v1.x 是 Python 程序（数据在 `~/.duanxian-agents`，页面在 8910 端口），新版是另一套程序，不能原地升级： - 重新克隆仓库，或下载免安装包，按上面的步骤安装。旧版的文件夹和数据目录不用删，新版不会改动它们。 - 页面地址从 `http://127.0.0.1:8910` 换成 `http://127.0.0.1:5940`（本机 API 在 8770）。 - 旧版数据：到「接入 AI」页最下面的「从旧版导入」，先预览、再导入。能导的有交易记录、交易日志设置（费率、规矩、账户规模）、模式卡（带全部版本）、AI 复盘、明日验证条件、盘中快照和个股深挖；导入前把涉及的台账文件备份到数据目录的 `ledger/旧版导入备份-日期/`，旧版的文件只读。不导的（方向命中评估、涨停池存档、各种缓存、回测结果、被拒的复盘）在预览里列出数量和原因。旧版设过 `ASTOCK_DATA_HOME` 的，导入时默认去那里找。 - 导入前先按新版规则预演：会算不了的、已记的标注会被顶掉的、和已记的成交一模一样（可能记重）的，预览里先列出来；不合新版规则的（读不出的文件、符号链接、超过 30MB、卖出超过持有、代码或价格不对、B 股等）跳过并写原因。可以重复导，导过的按来源跳过。 - AI 要重新接一次：Claude Code、Codex、WorkBuddy 订阅直接用本机已登录的官方 CLI；旧版产品专用的 Codex 登录不再使用。 - 旧版的启动方式（`scripts/manage.py`、`启动 Vibe AStock.command / .cmd`）和 `VIBE_ALLOW_HOSTS` 不再使用；局域网和远程访问的开法见上文。 ### 在 Claude Code / Codex / Cursor 里调用 Vibe AStock Vibe AStock 提供 MCP 接口。接上以后，在 Claude Code、Codex、Cursor 等支持 MCP 的工具里可以直接用 Vibe AStock 取数（包括短线端点）、发起研究、读报告和证据；研究结果和页面里看到的是同一份。MCP 不读交易日志和持仓。 先跑完上面的 setup，然后在仓库目录里运行（Windows PowerShell 把 `"$(pwd)/orchestrator/src/mcp.ts"` 换成 `"$PWD\orchestrator\src\mcp.ts"`）。 Claude Code（想在所有目录都能用，加 `-s user`）： ```bash claude mcp add vibe-astock -- node "$(pwd)/orchestrator/src/mcp.ts" ``` Codex： ```bash codex mcp add vibe-astock -- node "$(pwd)/orchestrator/src/mcp.ts" ``` Cursor：在 `~/.cursor/mcp.json`（只给某个项目用就放项目里的 `.cursor/mcp.json`）加入下面这段，路径换成你的仓库位置。Cursor 提示找不到 node 时，把 `"node"` 换成终端里 `which node` 输出的完整路径。 ```json { "mcpServers": { "vibe-astock": { "command": "node", "args": ["/你的路径/vibe-astock/orchestrator/src/mcp.ts"] } } } ``` 接好后可以这样问： - 「用 vibe-astock 取 2026-10-09 的短线情绪读数和首板名单」 - 「用 vibe-astock 查 600519 最近的券商研报和机构一致预期」 - 「用 vibe-astock 给 300308 跑一次研究，跑完把估值部分的数字和出处列给我」 共 8 个工具：7 个只读（端点列表、取数、研究状态、报告、证据、研究列表、知识档案），1 个发起研究（目前只支持 A 股）。连接时会附上使用说明；出错时会写明能不能重试、下一步怎么做。 - 发起研究用这台电脑的**后台默认 AI 来源**，页面「接入 AI」里的选择不算：在 `.local/config.json` 写 `provider.profile`（如 `cli-claude`），或者添加时带上环境变量，例如 `claude mcp add vibe-astock -e VRA_PROVIDER=cli-claude -- node …`、`codex mcp add vibe-astock --env VRA_PROVIDER=cli-codex -- node …`。研究会消耗所选 AI 的额度。 - 只取数、读报告和证据不需要 AI。 ## 安全与隐私 - 交易日志、持仓和自选只存在本机。自己的成交、持仓、成本和盈亏**不发给 AI**（和 Vibe Research 不同）：交易日志的几页和 AI 周报里的「本周我的交易」不登记页面上下文、不进 AI 资料包；持仓页只告诉 AI「这页的数据不提供」；盯盘、候选池、事件日历发给 AI 的内容去掉只因持仓才出现的股票；AI 在对话里读台账时拿不到成交、持仓、交易日志和模式卡。自选、笔记、论点和判据可以发给 AI。例外是你主动选的：自选和持仓的「从截图或表格识别」会把选中的文件发给当前 AI；你在对话里自己写出来的内容也会发给所选模型。 - 从旧版导入只读旧版的文件，导入前先把新版里涉及的台账文件备份到 `ledger/旧版导入备份-日期/`，附恢复说明。 - AI 读取公开网页时可能经第三方 Jina Reader 转发；目标网址（包括查询参数）会发送给该服务。不要提交含私密令牌、内部资料或签名下载凭据的网址。搜索请求同样会发送到对应搜索服务。 - 原始研报文件只保存在本机；模型只接收服务端检索命中的正文片段。 - 后端默认 provider 的 key 只走环境变量，不写入产品配置或仓库。 - 浏览器里填写的 API key 只保存在当前浏览器 `localStorage`，仅在调用时经本机后端转给所选模型服务商。 - 对话可使用产品提供的联网和研究工具。资料抽取等有界任务仍按任务限制执行权限。 - 资料引用格式为 `[资料:<id> p.<页码>]`，漏引、错引和未知引用会被机器校验拒绝。 - 研究阶段没有网络，只能用 5 个受控工具；取数由编排器用受控脚本完成，原始响应落盘并记录哈希。 - 本机 API 默认只绑定 `127.0.0.1`，写请求必须鉴权并使用 JSON。 - 隐私模式（右上角眼睛图标）：录屏、截图前打开，金额、股数、成本价和交易日志里自己写的价位显示成 ••••（输入框按密码样式显示），百分比照常；交易日志的权益曲线不画。只遮屏幕显示，不影响计算和发给 AI 的内容；对话按措辞识别，个别说法可能遮不到。 - 新版提示：每天访问一次 GitHub 接口（没查成隔一小时再试），查有没有新的正式版本，请求里只带当前版本号；可在「接入 AI」页最下面关掉，或设环境变量 `VRA_UPDATE_CHECK=0`（完全不联网）。 - SEC 联系方式（选填）：在「接入 AI」页填了才有，存在数据目录的 `sec-contact.json`（只在本机、只有自己可读），只交给要访问 SEC 的取数，放进发往 SEC 的请求头；页面上只显示打码后的样子。也可以用环境变量 `VRA_SEC_CONTACT` 设置，设了以环境变量为准。 - 防篡改核对：研究结果和台账记录的指纹登记在数据目录的 `audit/chain.jsonl`，只在本机，不上传。它能发现绕开软件的改动，但防不住能同时改写登记簿的人——要防这一点，把页面给的链头另存到别处。 - 输出只包含数据、分析框架、情景概率、待验证条件和裁决点，不提供建仓、加减仓、目标价或止损位；交易日志里的止损和目标价是你自己写的计划，程序只拿来对账。 ## 当前边界 - 盯盘：v2.0.0 开发和截图都在 2026-10-10、10-11（周末），实时刷新、盘中异动、昨日梯队「封没封」和到点自动存快照还没在交易时段实测过；README 里「竞价与盘中」的截图用的是旧版 2026-09-23 交易时段存下、再导进来的快照。 - AI 复盘和 AI 周报：2026-10-10 只用 Claude Code 订阅实测过（复盘 4 版、周报 3 版）；Codex、WorkBuddy 和模型 API 还没在这两个功能上跑过。 - 从旧版导入：用一份真实旧数据的副本实测过预览和导入；旧版其他写法的文件会在预览里列为跳过并写原因。 - 提供源码和 Windows / macOS 免安装包，界面都是本地浏览器页面。免安装包没有代码签名，发版时在 GitHub Actions 上构建、冒烟通过才上传，没在实机上验收。 - 内置模型 API 模板都还没用真实 key 实测；没跑过兼容矩阵的模板不会标成「已实测」。三家订阅的实测范围见 [CHANGELOG](CHANGELOG.md)。 - Windows 11 原生支持已接入：PowerShell 初始化 / 启动脚本、Windows 路径与进程处理、受控研究工具链。CI 配置包含 `windows-latest` / `macos-latest` / `ubuntu-latest`，Windows 跑的是选定的跨平台契约测试，并非全部后端测试。仍未在 Windows 实机验收，也尚未验证正常退出后的 Job Object 子进程回收保证。Windows 10 未验证。 - 港股、美股六阶段研究和 Vibe Research 是同一套代码：Vibe Research v2.1.0 发布前用 Claude Code 订阅各真跑了一只完整研究（苹果、腾讯控股），美股按现在的判分硬测试全部通过（报告数字 142/142 对上出处），港股只差一项：报告里还有 3 处数字真没标出处。其他 AI 来源还没在港股、美股上跑过硬测试。研究过去某天的港股时，东财会把旧报告期的公告日改成之后再次披露的日期，按公告日筛选会保守地丢掉这些期，近四季合计可能算不出（只会少用数据，不会用到研究日之后才公布的数）。ADR 与本地股的换股比例本版不处理。 - 远程访问只支持 macOS / Linux。 - 源码运行需要本机依赖环境。 ## 开发与测试 ### 工作方式 ```text 本地浏览器工作台 首页 · 盯盘 · 情绪复盘 · 交易日志 · 每日复盘 · 产业资讯 · 产业研究 · 个股深挖 · 回测 · 研报库 │ ▼ 投研层 182 个数据端点 · 短线读数与对账 · 六阶段研究流程 · calc · validator · 报告归档 │ ▼ 本地 Agent 运行时（Local Agent Runtime）与模型供应商（Model Provider） 按用户所选来源路由（不是串联运行，也不互相回落） ├─ Claude 订阅 → 本机 Claude Code CLI ├─ Codex 订阅 → 本机 Codex CLI（用户自己的 ChatGPT 登录） ├─ WorkBuddy / CodeBuddy → 本机 CodeBuddy Code CLI └─ 模型 API → Chat Completions（由产品在本机跑工具循环） ``` 三级约束，不只依赖提示词： <table> <thead> <tr><th nowrap>层</th><th>组成</th><th>作用</th></tr> </thead> <tbody> <tr><td nowrap>提示层</td><td><code>methodology/constitution.md</code>（研究宪法）+ <code>.agents/skills/</code> + <code>calc/SPEC.md</code></td><td>定义金融研究纪律、研究流程与计算函数契约，所有 AI 来源一视同仁</td></tr> <tr><td nowrap>执行层</td><td>受控工具白名单 + 收工检查</td><td>研究阶段只开放 5 个受控工具，订阅 CLI 关闭全部内建工具；产物缺失或校验不过就退回去接着修</td></tr> <tr><td nowrap>编排层</td><td>orchestrator + validator + calc + gate</td><td>强制阶段、证据引用、确定性计算和合规边界；AI 复盘和周报里的每个数字、证据编号由程序逐个核对</td></tr> </tbody> </table> v2.0.0 起不再内置 Codex Harness：三家订阅直接调用使用者本机的官方 CLI，模型 API 直接走 Chat Completions，执行层与编排层由产品自己实现。 ### 项目结构 | 路径 | 作用 | |---|---| | `desktop/` | React + Vite 本地浏览器 UI | | `orchestrator/` | Agent 编排、validator、API、MCP、对话、资料库与报告归档 | | `orchestrator/src/finance/shortline/` | 短线读数、盯盘、AI 复盘与周报、明日验证、涨停样本、结构变化、从旧版导入 | | `orchestrator/src/finance/journal/` | 交易日志：按轮次切分、情绪环境与板位、风险与纪律、复查、模式卡 | | `backtest/` | 确定性回测引擎与工具入口 | | `calc/` | 确定性计算库 | | `datasources/` | 数据端点注册表、目录和健康巡检 | | `.agents/skills/` | 金融研究流程与取数工具 | | `providers/` | 模型供应商模板，不包含密钥 | | `methodology/` | 研究宪法（`constitution.md`），研究线程的最高纪律 | | `AGENTS.md` | 部署、接口与维护说明 | | `scripts/` | 安装、启动、初始化与体检 | | `.local/` | 用户私有数据、配置、报告、交易记录、访问口令和运行产物；已 gitignore | 和 Vibe Research 共用的部分照它的结构放，方便以后合并它的修复；产品名、仓库地址和端口集中写在 `orchestrator/src/brand.ts` 和 `desktop/src/verticals/finance/lib/brand.ts`。 ### 命令行运行一次研究 Windows PowerShell： ```powershell node orchestrator/src/run.ts ` --symbol 300308 ` --market SZ ` --provider cli-claude ` --python "$PWD\.venv\Scripts\python.exe" ``` macOS / Linux： ```bash node orchestrator/src/run.ts \ --symbol 300308 \ --market SZ \ --provider cli-claude \ --python "$(pwd)/.venv/bin/python" < /dev/null ``` `--provider` 指定这次研究用的 AI：`cli-claude` / `cli-codex` / `cli-codebuddy` 用本机已登录的订阅，`deepseek` 等模板 id 用模型 API （key 从模板声明的环境变量读，如 `DEEPSEEK_API_KEY`）。不传就用后台默认（`.local/config.json` 的 `provider.profile` 或环境变量 `VRA_PROVIDER`），都没有会直接报错，不会替你选。 所有平台、所有 AI 来源都只走受控工具：研究线程没有 Shell、没有网络、没有写目录权限，只能通过受控工具读取净化后的运行文件、 调用确定性计算并写当前阶段产物。 完整研究耗时取决于取数范围、模型响应与校验重试，可能需要数十分钟或更久，不承诺固定时长。进度会持续显示，结果写入 `.local/runs/<run-id>/`。 退出码：`0` complete、`2` incomplete/stale、`3` failed。 港股、美股把 `--symbol` / `--market` 换成 `--symbol 00700 --market HK` 或 `--symbol AAPL --market US`；港美股必须传 `--market`。 ### 研究运行产物 - `report.md`：最终研究报告。 - `evidence.json`：本轮使用的证据，每条保留来源、资料期和原文引用。 - `calculations.json`：派生数字的输入、函数和计算 DAG。 - `conflicts.json`：跨来源冲突，不静默取舍。 - `manifest.json`：所用 AI 来源与执行保障等级、模型、版本、阶段、状态、资料召回和运行清单。 - `viewer.html`：在浏览器里查看证据与报告。 ### 回归检查 ```bash npm run typecheck --prefix orchestrator npm test --prefix orchestrator npm run typecheck --prefix desktop npm test --prefix desktop npm run build --prefix desktop .venv/bin/python -m pytest calc/tests -q .venv/bin/python -m pytest backtest/tests -q .venv/bin/python -m pytest .agents/skills/data-access/scripts/tests -q ``` 最近本机验收记录（2026-10-11，v2.1.0 发布前）： - orchestrator：Node 26 运行全部后端测试，**1433 项：1429 通过、4 项 Windows 专项跳过**；类型检查通过。 - desktop：**405/405**，类型检查与生产构建通过（构建只有 Vite 的打包体积提示）；Python（计算库 311、回测 583、数据脚本 783）：**1677/1677**；mypy 检查 115 个文件通过。 - 发版前两轮独立只读审计（Codex 6.1 Sol、Opus 5.5）确认 4 条，都在合入的 Vibe Research 代码里，已修并随 Vibe Research v2.2.1 发布；修复补丁另做了一次独立复核（Opus 5.5），找到的 6 处全部修掉。每条修复都做了反向检查（把修复改回去，测试必须变红）。 - 上一版（v2.0.0）AI 复盘和 AI 周报用 Claude Code 订阅真跑过（2026-10-10 给 2026-10-09 写，复盘 4 版、周报 3 版；本版没改这两处，没有再真跑），程序的数字核对和证据编号核对都生效；从旧版导入用一份真实旧数据的副本实测过（没动原件）。 - 盘前提醒用真实数据手动跑过（2026-10-11），还没在交易日 09:05 正点跑过；本轮未重跑全部外部取数端点或 Windows 实机；盯盘还没在交易时段实测（见「当前边界」）。 项目约定：每个环节完成后先测试；重要改动做一次独立审查，逐条核实、修复后复验受影响范围；审查完成前不把 该环节称为“建成”，也不提交或推送。 ## 更新日志 见 [CHANGELOG.md](CHANGELOG.md)。v2.0.0 换到 Vibe Research 的底座上，底座本身的历史见 [Vibe Research 的 CHANGELOG](https://github.com/simonlin1212/Vibe-Research/blob/main/CHANGELOG.md)。 <details> <summary>查看与上一版 v1.1.3 的对比</summary> 对照基线为 [v1.1.3 发布说明](https://github.com/simonlin1212/vibe-astock/releases/tag/v1.1.3)。完整变化见 [CHANGELOG](CHANGELOG.md)。 <table> <thead> <tr><th nowrap>方面</th><th>v1.1.3</th><th>v2.0.0</th></tr> </thead> <tbody> <tr><td nowrap>程序</td><td>Python 后端 + React 网页，内置 OpenAI Codex Harness 当 Agent 底座</td><td>换到 Vibe Research v2.1.0 的底座（Node + React，Python 只做计算和取数），不再内置 Codex Harness</td></tr> <tr><td nowrap>页面地址</td><td><code>http://127.0.0.1:8910</code></td><td><code>http://127.0.0.1:5940</code>（本机 API 在 8770），和 Vibe Research 错开</td></tr> <tr><td nowrap>数据目录</td><td><code>~/.duanxian-agents</code>、<code>~/.vibe-astock-agent</code> 和浏览器本地存储</td><td>仓库里的 <code>.local/</code>（免安装包在解压出来的文件夹里）；旧数据用「从旧版导入」</td></tr> <tr><td nowrap>盯盘</td><td>盘面数据、实时动态、昨日梯队、盘中核验</td><td>实时动态（持仓、自选、昨日梯队、大票、成交额、盘中异动）+ 竞价与盘中（竞价强弱、全天六个时点的情绪路径），快照到点自动存</td></tr> <tr><td nowrap>复盘</td><td>复盘报告、首板分析、近 5 天热度、历史统计</td><td>情绪复盘 8 个分页（今日情绪、AI 复盘、AI 周报、近 5 天、情绪历史、明日验证、涨停样本、结构变化）+ 每日复盘；AI 复盘分五段写，每个数字由程序核对</td></tr> <tr><td nowrap>交易日志</td><td>在「我的股票」下</td><td>单独一个栏目：自动对上入场日的情绪和板位，另有风险与纪律、复查、模式卡；不发给 AI</td></tr> <tr><td nowrap>其他栏目</td><td>资讯雷达、个股研究与多空辩论、回测、持仓自选、研究记录</td><td>另有产业信号、产业研究（20 个板块）、六阶段个股研究（A 股、港股、美股）、候选池、事件日历、定时提醒、我的研报</td></tr> <tr><td nowrap>接入 AI</td><td>Codex 用产品专用登录；模型 API 要支持 Responses API</td><td>Claude Code、Codex、WorkBuddy 订阅直接用本机已登录的官方 CLI；模型 API 走 Chat Completions</td></tr> <tr><td nowrap>安装方式</td><td>源码 + <code>scripts/manage.py</code>，或双击启动脚本</td><td>源码 <code>scripts/setup</code> + <code>scripts/start</code>，另有 Windows / macOS 免安装包；可以装在云端电脑上远程打开</td></tr> </tbody> </table> </details> ## 免责声明 本工具用于数据整理、研究和历史复核，只产出研究数据、分析框架、待验证条件与裁决点，不提供投资决策、买卖建议或仓位指令。 情绪分档和周期是分析框架，不是客观事实；涨停样本是市场现象统计，不是策略回测。公开数据、程序计算、个人记录与 AI 解读都可能出错， 引用存在不代表推论正确，历史结果不代表未来表现。投资有风险，使用者应自行核实并承担决策责任，同时遵守各数据源的使用条款。 ## License Apache-2.0，详见 [LICENSE](LICENSE)。v2.0.0 起的底座来自同一作者的 [Vibe Research](https://github.com/simonlin1212/Vibe-Research)（MIT），原许可声明见 [NOTICE](NOTICE)。 **作者：** Simon 林 · X [@linsizhen](https://x.com/linsizhen) · 邮箱：[simonlin0423@gmail.com](mailto:simonlin0423@gmail.com)