Vibe-Trading：一个垂直领域 Agent 的完整工程切面
值得读它的理由不在「交易」两个字，而在它把一个高风险垂直场景需要的东西补齐了：技能怎么按需加载、 工具返回太长怎么办、Agent 编数字怎么拦、长任务跑偏怎么纠、以及最关键的——真要动账户时， 授权、闸门、熔断、审计这四层各自该长什么样。这些问题换个领域一样存在。 代价也明确：一旦接上券商，凭据的暴露面就等于整个 Agent 进程的暴露面，下错的单不可撤销。 本专题共 40 篇，每篇都对着仓库里的真实文件写，**只讨论工程实现，不评价任何策略或因子的好坏， 不构成任何投资建议**。项目仍在高频迭代，文中结论以 仓库最新代码与文档 为准。
Vibe-Trading 是什么：HKUDS 这个开源交易 Agent 项目的工程全景与边界
从仓库结构出发拆解 HKUDS 开源项目 Vibe-Trading：它把金融研究工作流切成技能、工具、多智能体编制三层可加载单元，挂在一个通用 Agent 循环上。读完你能画出它的全景地图、知道每层代码落在哪个目录、以及它明确不管的那些事。不提供任何投资建议，也不评价策略好坏。
上手与使用
先跑起来：装上、接模型、理清数据源路由、把技能与多智能体编制调起来。
开源 Vibe-Trading 的 Alpha Zoo 因子库怎么调用
拆开开源项目 Vibe-Trading 的 Alpha Zoo：几百个因子文件如何靠一个注册表暴露成一条命令，AST 扫元数据的代价是什么，工具返回的每个字段该怎么读，以及最容易踩的 zoo 名与枚举值。只讲工程实现，不讲因子有效性。
开源交易 Agent 项目 Vibe-Trading 里怎么自己写一个技能：四个工具加一份范本
拆开源项目 Vibe-Trading 的技能机制：技能文档怎么被加载进上下文、写技能的 save_skill / patch_skill / delete_skill / skill_file 四个工具各管什么、一份叫 research-discipline 的技能文档为什么算能用的范本。给出仓库真实路径、边界代价与避坑清单。不讲交易策略，不给任何投资建议。
开源交易 Agent Vibe-Trading 的四层安全边界拆解
按代码逐层拆开 Vibe-Trading 的安全设计：工作区路径校验、允许根目录、出网地址过滤、外部内容注入扫描各管到哪一段，哪几个文件其实只是兼容转发层。你会拿到一张模块与仓库路径对照表、一份避坑清单，以及它明确不管的部分。不含任何投资建议与策略结论。
开源项目 Vibe-Trading 不装界面也能用：MCP 接入方式与边界
Vibe-Trading 是 HKUDS 放出的开源个人交易 Agent，它自带一个 MCP 服务端入口，不用装它的前端界面，就能把整套金融研究工具挂到你现有的 Agent 上。这篇讲清三种传输方式怎么选、工具面被砍掉了什么、凭据与安全护栏在哪一层，以及哪些事它明确不管。不讲怎么投资，也不给任何策略结论。
开源项目 Vibe-Trading 的 30 份多智能体编制怎么调
拆开 Vibe-Trading 仓库里 swarm 这一层：30 份 YAML 编制文件把角色、依赖、工具白名单写成静态 DAG，一句话经关键词路由变成一支队伍。读完你能看懂编制文件的三段结构、分层调度与上游上下文的传递方式，知道哪些坑是配置写法造成的。不讲投资方法，不评价任何输出结果的好坏。
开源项目 Vibe-Trading 的技能体系：88 个目录如何按需加载
拆解 HKUDS 开源交易 Agent Vibe-Trading 的技能组织法：88 个技能各一份 SKILL.md，系统提示词只放一行描述，全文靠 load_skill 按名取并分页。读完能拿到完整数据通路、分页信封的设计动机与避坑清单。只讲工程实现，不讲投资。
开源项目 Vibe-Trading 工具层：72 个文件与上下文预算
拆开 HKUDS 的开源交易 Agent 项目 Vibe-Trading 的工具目录，讲清 72 个文件靠哪几条正交规则分组、哪些是任何 Agent 都要有的通用底座、哪些是金融领域专用，以及它用什么手段让工具结果不把模型上下文冲垮。只讲工程实现，不涉及任何投资判断，也不评价策略好坏。
开源项目 Vibe-Trading 渠道层：接进聊天软件的代价与新问题
拆解开源交易 Agent 项目 Vibe-Trading 的 channels 目录：靠扫包做渠道注册、两条队列做消息总线、权限与配对收在基类。读完知道接一个聊天渠道要写什么，以及 Agent 进群后的会话边界与凭据问题。不讲投资方法，只讲工程实现。
Vibe-Trading 的三层配置：结构 schema、环境变量 schema、路径与限额各管什么
拆开开源交易 Agent 项目 Vibe-Trading 的 agent/src/config 目录，讲清它为什么把配置切成结构校验、环境变量表、路径与限额三层，每层挡住什么错误、在哪个文件里、排查时该先看哪一个。只讲配置工程实现，不涉及任何投资判断，也不替你判断实盘合规。
Vibe-Trading 开源仓库的 Web 层：一条时间线让长任务可见
Vibe-Trading 的 Web 那一侧被拆成了两半：FastAPI 端按会话、运行、设置等分组注册路由，再用一条 SSE 事件流把每一步推给浏览器；前端用一行可折叠的活动条把思考、工具调用与产出串起来。本文按仓库代码梳理这套让长任务可见的做法，并给出边界与避坑清单。不讲交易策略，不给任何投资判断。
Vibe-Trading 开源仓库的回测层：多引擎共用一个 runner
拆解 HKUDS 开源项目 Vibe-Trading 的回测层工程结构：一个 runner 怎么把配置校验、策略源码扫描、市场引擎路由串起来，约束层、指标层、验证层又怎么各自独立成模块。读完你能照着这套分层去接自己的市场规则；不解决策略好坏、参数怎么调、更不涉及任何投资判断。
Vibe-Trading 开源交易 Agent：三个入口与第一次配置
HKUDS 开源的 Vibe-Trading 装完之后给你三个可执行入口——交互命令行、FastAPI 服务、MCP 服务端。这篇按仓库代码梳理三者各自的信任边界，拆开首次配置向导的五步到底往磁盘上写了什么，列清哪些凭据可以先不给，以及这套设计明确不管的那些事。不讲怎么投资，只讲工程实现。
Vibe-Trading 开源项目的数据源层拆解：一个注册表、一条回退链和一份路由技能文档
拆开 HKUDS 开源的 Vibe-Trading 个人交易 Agent，看它怎么把二十多个行情数据源收进一个注册表、按市场排出回退链，再用一份 data-routing 技能文档告诉模型该走哪条线。读完你能拿到一套可以搬到自己 Agent 上的多数据源路由与降级写法。不讲投资方法，不评价任何策略。
Vibe-Trading 开源项目跑不起来：自检表、限额与数据源降级
Vibe-Trading 是 HKUDS 开源的个人交易 Agent。本文按仓库代码梳理它跑不起来时的排查顺序：先读启动前自检表分清致命项与降级项，再看工具结果限额造成的假性故障，最后看 A 股数据源从主源到备源的兜底路径。只讲工程实现，不讲策略好坏，也不涉及任何投资判断。
Vibe-Trading 开源项目怎么接大模型：能力表与登录态通道
拆开 HKUDS 开源项目 Vibe-Trading 的模型接入层：为什么把供应商差异拆成目录 JSON 与能力表两层，走 ChatGPT 登录态的那条通道为什么必须另起炉灶。读完你能照抄这套结构，也知道它明确不管什么。不讲价格额度与投资判断。
结构与机制
按层逐块读：主循环与上下文、记忆分层、防编造、多智能体运行时、以及授权与风控那四道闸。
拆解开源交易 Agent Vibe-Trading：工具、技能与风控三层
把 HKUDS 开源的交易研究 Agent Vibe-Trading 与 opencode、Hermes Agent 这类通用向 Agent 放在一起，逐层比对工具清单、技能组织方式与安全边界的分野，每条差异都回到仓库里的真实目录与文件取证。读完你会知道垂直领域 Agent 在工程上多做了什么、代价是什么，不解决怎么投资、怎么选标的这类问题。
拆解开源项目 Vibe-Trading 的券商抽象层与凭据保管
HKUDS 开源的交易 Agent 项目 Vibe-Trading 接了十二家券商与交易所，靠的是一层 profiles 抽象加一组统一类型定义。这篇按仓库代码拆开这层抽象怎么切分传输方式、能力声明与只读标记，以及三种到达方式各自绕不开的凭据保管代价。只讲工程实现与边界，不涉及任何投资判断，也不替你评估任何券商。
拆开 Vibe-Trading 开源项目的因子引擎：算子层、注册表与批量跑分
逐层拆解 HKUDS 开源项目 Vibe-Trading 的因子模块，讲清算子基类的 NaN 与防未来函数约定、注册表如何靠 AST 静态扫描把元数据变成准入凭证、批量跑分怎么用进程池跑完整个因子库、分析核心输出哪些字段。读完你能拿到一套把几百条公式工程化成可批量执行对象的做法。本文不评价任何因子好坏，不提供投资建议。
读懂 Vibe-Trading 开源项目的因子库来源：一份 NOTICE 与四份子目录许可证
Vibe-Trading 的因子库不是自研，而是对公开公式的工程化重实现。这篇拆开它的根 NOTICE 与四个子目录各自的 LICENSE.md，讲清楚重实现公开公式这套合规结构是怎么搭的、代码层面靠什么保证、以及它明确不管什么。不提供法律意见，能否商用一律以许可证原文为准。
技能文档该写多长：Vibe-Trading 88 份文档量出的长度预算
给 Agent 读的技能文档写多长才合适？Vibe-Trading 的单次工具结果硬顶 10,000 字符，实际可用约 9,400，超了不报错只会切成多页。本文量了 88 份 SKILL.md 的长度分布，说清哪类文档天生会超、翻页要付什么代价。只讲工程实现，不涉及投资判断。
开源交易 Agent 项目 Vibe-Trading 的常驻运行时拆解
逐行读开源项目 Vibe-Trading 的 agent/src/live/runtime/ 模块，讲清一个 Agent 想长期跑着要补哪四块：调度怎么防钟表跳变、执行按什么顺序失败即停、重启后怎么和外部状态对账、怎么判断它还活着。纯工程视角，不讲交易策略，不涉及投资判断。
开源交易 Agent 项目 Vibe-Trading 的上下文管理：组装、压缩工具与记忆压缩
拆开源项目 Vibe-Trading 的上下文这条线：ContextBuilder 怎么组装系统提示词、五层压缩各自在什么水位触发、compact 工具为什么只是个开关、记忆侧的三级降级怎么写回磁盘。你能拿到一套可照搬的分层判断与避坑清单。不讲投资方法，不评价任何策略结果。
开源项目 Vibe-Trading 仓库结构导读：改一处功能从哪进去
逐目录拆开 HKUDS 开源的 Vibe-Trading 仓库：后端、前端、技能库、因子库、公开 wiki 各占哪一块，加一个工具、加一支多智能体团队、加一个因子分别该从哪个文件进去，以及它写给 AI 贡献者的那份指南划出了哪些安全关键区。纯工程视角，不讨论任何投资判断，也不给策略优劣结论。
开源项目 Vibe-Trading 的定时研究：把每天自动跑一遍做成带存储的可执行对象
拆解开源交易 Agent 项目 Vibe-Trading 的 scheduled_research 模块与 OpenBB 桥接：定时任务如何落成一条可持久化的作业记录、状态机在崩溃与并发下怎么自保、cron 遇上时区与夏令时的处理策略，以及外部数据进入提示词那条线的字符预算。读完你能拿到一份可照抄的定时 Agent 落地自检清单，不解决任何投资决策问题。
开源项目 Vibe-Trading：30 份 yaml 定义的多智能体团队编制
拆解开源项目 Vibe-Trading 里 30 份 swarm 编制文件的字段设计——一份 yaml 声明了哪些键、角色顺序怎么靠 depends_on 排出拓扑层、上下文怎么靠 input_from 定向流动。读完你能拿到一套可复用的组织即配置写法，以及三个实测出来的坑。不讲投资方法，不评价策略好坏。
HKUDS 开源项目 Vibe-Trading 的 mandate：Agent 先提授权再动手
拆开 HKUDS 开源项目 Vibe-Trading 的 mandate 模块，看它怎么把「Agent 能做什么」变成用户签发、可存档、会过期的授权文件，以及提议与提交为什么由两套互不可达的代码持有。读完能拿到一套可搬到自己高风险 Agent 上的授权抽象，只讲工程实现。
Vibe-Trading 仓库的多智能体运行时：任务怎么派，崩了怎么办
拆开 HKUDS 开源项目 Vibe-Trading 的 swarm 目录，把 runtime、worker、task_store、serialization 四块串成一条完整链路，讲清任务按什么顺序派、结果落在哪个文件、超时和失败各走哪条分支，以及哪些坑读代码才能看出来。只讲 Agent 工程实现，不涉及任何投资判断。
Vibe-Trading 策略仓库：注册、衰减跟踪与退役的生命周期设计
拆解开源项目 Vibe-Trading 的 strategy_store 模块，看它如何用六个状态、四档信号和一台纯函数状态机，把「策略存进去」变成「策略被持续跟踪并最终退役」。读完你能拿到一套可迁移到提示词库、技能库、评测集的资产生命周期骨架，以及这套设计明确不管的那几件事。本文只讨论工程实现，不涉及任何投资判断。
Vibe-Trading 的目标账本：开源交易 Agent 如何防跑偏
拆开源项目 Vibe-Trading 的 goal 模块，看它怎么把一次研究的目标做成可读可写可审计的一等公民：数据模型、准入策略、SQLite 台账、四个模型侧工具与主循环续跑判据。读完你能照着评估自己的长任务 Agent 该不该建目标层，也知道它明确不管哪些事。不讲任何投资方法。
Vibe-Trading 假设注册表：开源交易 Agent 怎样拦住越研究越自信
拆开 HKUDS 开源项目 Vibe-Trading 的假设注册表模块与研究纪律技能，看它怎么把一句口头假设变成有生命周期、能被作废的本地记录。读完你能拿到一份可复刻的「假设登记」工程设计，以及它明确不管的那部分边界。本文只讲 Agent 工程实现，不涉及任何投资建议。
Vibe-Trading 开源交易 Agent 的四道下单闸门：从强制执行层到日频计数
拆开 HKUDS 开源项目 Vibe-Trading 的实盘下单链路，逐个读它的强制执行层、下单守卫、文件级熔断和日频计数四段代码，讲清每道闸放在哪个函数、按什么顺序跑、失败时倒向哪一边。读完你能拿到一套可以照搬到自己 Agent 上的失效顺序设计思路。不讲交易方法，不讲任何策略效果。
Vibe-Trading 开源交易 Agent 的下单闸门：分类、拦截与审计三件套
拆开 HKUDS 开源项目 Vibe-Trading 的 live 模块，讲清工具读写分类、下单前门禁、只追加审计流水这三件事各自负责什么、怎么串起来，以及审计为什么必须独立于业务代码。读完你能把这套结构搬到自己的高危工具上；不解决交易本身怎么做。
Vibe-Trading 开源项目的记忆分层：四个模块与它们的新麻烦
拆开开源 Agent 项目 Vibe-Trading 的记忆子系统，逐个读 hierarchy、lifecycle、persistent、semantic_links 四个文件，讲清每层解决什么问题、开关怎么控、分层之后又冒出哪些新麻烦。只谈工程实现，不涉及任何投资判断。
Vibe-Trading 开源项目的脱敏层：Agent 输出转发出去之前先看清它管到哪一步
拆解 HKUDS 开源项目 Vibe-Trading 的脱敏实现：结构化载荷的键分类与双 sink、自由文本的三条正则、路径拓扑隐藏，以及仓库里那套提交前的 CI 闸门。读完你能判断把 Agent 输出转发到群里时哪些面已被覆盖、哪些要自己补。不解决怎么投资，也不评价任何策略。
Vibe-Trading 开源项目防模型编造数字的两层设计与代价
拆开 HKUDS 开源的个人交易 Agent 项目 Vibe-Trading，看它怎么把「不许编数字」从提示词约束改成结构约束：主循环侧的身份闸门与证据台账、多智能体侧的开跑前行情注入、以及一个只算不取数的财务严谨性工具。读完你能拿到一套可以平移到别的高风险领域的做法，以及它明确不管的部分。本文只讲工程实现，不涉及任何投资判断。
Vibe-Trading 开源项目给 Agent 开 shell 怎么兜底：命令校验与工作区访问控制
拆开 HKUDS 开源项目 Vibe-Trading 的 shell 兜底层，看清它到底拦下哪几类命令、拦截发生在调用链的哪一步，以及文件工具的路径收敛与会话层工作区范围各自管到哪里。读完你能判断这类防护的适用边界，它不解决沙箱隔离，也不替代进程级或容器级隔离。
Vibe-Trading 项目怎么处理工具返回太长：分页、后台与进度三层
拆开 HKUDS 开源的 Vibe-Trading 仓库，看它怎么让一个动辄上万字符的金融数据返回不撑爆模型上下文：整条记录分页的 fit_records、把长命令挪走的 background_run、以及走旁路的进度与心跳事件。读完你能拿到三层各自的职责边界、真实文件位置和迁移到自己 Agent 时的避坑点。本文只讲工程实现，不涉及任何投资判断。
Vibe-Trading 影子账户：从交易记录抽规则到生成回测代码的流水线
拆解开源项目 Vibe-Trading 里 shadow_account 这条流水线的四段实现——从交割单 FIFO 配对出发做特征与聚类得到结构化规则，用 Jinja2 渲染出带静态校验的 signal_engine.py，驱动回测并解析产物，最后渲染成分节报告。读完你能拿到一套把隐性规则显式化的工程范式与它的边界。本文不展示任何业绩结果，也不提供投资建议。
Vibe-Trading 源码：Agent 主循环与 runner 的分工
逐行读开源项目 Vibe-Trading 的 agent/src/agent/loop.py、core/runner.py 与 core/state.py，讲清一轮 ReAct 迭代里到底发生了什么、五层上下文压缩各自何时触发、只读工具为什么并行而写工具只报警不杀、状态分别落在哪几个文件。纯工程视角，不涉及任何投资建议、行情判断与业绩数据。
想把 Agent 真正搭起来，而不只是会用？
从 Agent 工程实践到数字员工落地，站内有成体系的教程与课程。