Folio：AI 投资研究工作台

本地优先的 AI 投资研究工作台（AI investment research workbench），支持深度调研、证据化投资论点、投资组合风险分析、自选股与 Pi Agent 副驾驶。

Folio English · 简体中文 本地优先的 AI 原生投资研究工作台 研究市场、理解敞口，并把判断留在有证据的报告、投资逻辑和提醒里。 发布版本 · 系统架构 · 产品需求 行情终端告诉你 What happened。Folio 的 Agent 用来回答 Why does this matter to you，记下 What did you believe before，并继续追踪 What changed。 我们的产品 Folio 是面向公开市场投资者的桌面研究环境。左侧是导航，中间是金融工作区（自选、K 线、财报、新闻、研究报告），右侧常驻一个能看见当前页面和标的的 Agent 副驾驶。选中哪只股票，K 线、概览、研究和 Agent 上下文一起切换。 Folio 本地优先：会话、凭证和研究状态默认留在本机。行情与模型是显式接入的提供方，密钥放在主进程的凭证库里。 Folio 是研究与决策支持工具，只读。能力注册表里没有下单或交易能力。 当前包版本：0.4.0-beta.2。 截图 下面的图来自 macOS 上 Folio 0.4.0-beta.2 的一次真实运行（Electron）。美股报价和日/周 K 线来自 Yahoo Finance，界面标注为延迟行情。这台机器没有安装 Longbridge CLI，因此财报、新闻、盘口等依赖 Longbridge 的区域写明不可用。投资组合和事件页使用应用自带的示例数据，页面上有「示例数据」标记。 今日 今日。三栏布局：导航、工作区、Agent。总资产和部分卡片为示例数据；自选里的美股报价来自 Yahoo Finance 延迟行情。快捷入口包括深度研究、复核投资组合和对比个股。 工作台：K 线、概览与新闻 K 线。NVDA.US 日 K，带 EMA 与成交量。右上角写明来源「Yahoo Finance · Delayed」。周期可切；Yahoo 提供日 K 和周 K。 左：报告/概览把行情、持仓和研究放在一起（此处持仓为示例数据）。右：新闻依赖 Longbridge；CLI 未安装时页面写明原因，而不是空白。 深度研究 左：研究进行中，逐项显示每个能力的取数状态。右：NVDA.US 综合策略研究结束。16 个计划能力里行情、K 线和公司概况成功，其余因 Longbridge 未安装而失败，状态为部分运行；判断为看空，置信度 55%。 报告正文：证据表（来源、声明、新鲜度、置信度）、立场与摘要，以及「保存为投资逻辑」。 投资逻辑 把报告保存为可编辑、可复核的投资逻辑。今日页会提示哪些逻辑该复核。 对比 一次对比 2–4 只标的。价格和 1 个月 / 3 个月 / 1 年回报来自 Yahoo；估值和财务指标在没有 Longbridge 时显示为「—」。对比处于焦点时，Agent 上下文带上这些标的。 机会发现 17 个确定性筛选任务，覆盖市场异动、基本面、技术面和事件。页面写明规则基于行情数据，不做 AI 扫描。没有候选时给出更换条件、增加自选或检查行情连接的建议。 投资组合 投资组合（示例数据）：总资产、现金、配置条和持仓。每行可以发起深度研究。底部分析配置、集中度、赫芬达尔指数、大额持仓、回撤和敞口。支持导入持仓。 事件与催化 事件与催化剂（示例数据）：财报、宏观数据和央行日历。每条可以带着上下文跳到研究。提醒规则另支持价格、新闻、财报、评级、股息、持仓权重和回撤。 Agent 副驾驶 Agent 知道当前页面和标的，可切换模型和思考等级，运行中可以停止。这次提问要求查询 NVDA 报价和 K 线；get_quote、get_kline、get_market_status 因 Longbridge CLI 未安装而失败，回答是数据缺口说明，没有编造价格。工具活动和来源检查器可以展开核对每次调用。 技能 技能中心列出内置技能、开关和能力依赖。详情页区分必需/可选能力、就绪状态和参考文件。 评测 评测中心：概览、实验、模型对比、失败模式。图中是本地 fixture 实验 folio-agent-v1（15 次运行），用来查看任务完成、工具选择、证据和时效等维度，不是对外的收益承诺。 设置、连接与个人 设置 → 通用：运行时、当前模型、思考等级和语言。设置 → LLM：提供方状态，密钥不回显。设置 → 连接：Longbridge 未安装、Massive 未连接、Yahoo Finance 已连接（延迟、非官方、个人使用）。个人与安全页汇总本地工作区健康状况。诊断页可复制或导出健康快照。 命令面板 任意页面按 ⌘K 打开命令面板，搜索页面、标的和操作并跳转。 核心功能 研究工作区 自选、行情、K 线、财务报表、新闻和证券概览。顶部页签在 K 线 / 财务报表 / 新闻 / 报告之间切换。 三栏桌面布局：导航、市场工作区、Agent 副驾驶。 K 线标注数据来源。Yahoo Finance 路径为延迟美股日 K / 周 K，可叠加均线。 数据新鲜度可见。缺失值显示为 —，不可用时写明原因（例如 Longbridge CLI 未安装）。 深度研究 从当前标的发起结构化研究：规划 → 有界并行的能力调用（超时、取消）→ 数据包 → 模型综合 → ResearchReport。 报告包含立场、置信度、章节、看多论点、看空论点、催化剂、风险，以及每条论断对应的能力执行记录。 部分能力失败时仍可生成报告，状态为部分运行，不可用的数据逐项标出。 研究有 checkpoint，状态包括排队、取数、综合、完成、部分、失败和取消。 八种研究策略：综合、价值、成长、技术、财报、事件驱动、风险复盘、收益。 导出支持复制 Markdown、下载 .md、复制分享文案、下载分享卡片 .svg。 同一标的多次研究后，研究差异（Research Diff）对比结论、估值、新风险和置信度变化。 投资逻辑 从报告保存为可编辑的投资逻辑，记下论点、关键假设和复核状态。 有新数据时可以重新评估。今日页列出待复核的逻辑。 多标的对比 一次放入 2–4 只标的，按估值、成长、利润率、ROE、股息、回报、评级和动量等行对齐。 某个提供方没有的字段保持 —。Agent 在对比页会带上当前标的集合。 机会发现 17 个确定性筛选任务，覆盖市场异动、基本面、技术面和事件。筛选是规则，不是模型扫描。 候选可以送去研究、对比或加入自选，并带上证据和理由。 没有命中时结果就是空的，并提示如何调整范围或检查连接。 投资组合与风险 总资产、现金、配置、持仓数量、成本和盈亏。持仓行可以进入深度研究，支持导入。 组合分析覆盖配置、集中度、赫芬达尔指数、大额持仓、财报、新闻、回撤和敞口。 未接入券商账户时，组合页使用内置示例数据，并带「示例数据」标记。示例不会冒充已连接账户。示例集之外的代码保持空态或错误态。 提醒与事件 提醒规则覆盖价格、新闻、财报、评级、股息、持仓权重和回撤。 事件与催化剂页汇总财报、宏观数据和央行日历，一条事件可以带上下文进入研究。 今日页汇总组合关注事项、自选异动、提醒、即将到来的事件、近期研究和待复核逻辑。 截图中的事件页是示例数据。 Agent 副驾驶 Pi Agent 运行时上的持久会话和流式回答。内部综合会话不进入可见对话历史。 模型与思考等级、停止/取消、工作区上下文（当前标的、当前视图、选中持仓）。 Markdown 回答包含标题、列表、表格、链接和代码块。 回答下方可展开工具活动（工具名、参数、耗时、成功或失败），并用来源检查器查看引用到的工具数据。 工具失败时说明缺口。截图里的行情工具调用在 Longbridge CLI 未安装时失败；同一环境下，工作区和深度研究仍可通过 Yahoo Finance 拿到美股延迟报价和 K 线。 Agent 如何组织 内核在 Electron 主进程，渲染进程只订阅事件、做视图投影。 AgentKernel：SessionManager 持久化会话；RunManager 保证同一时间一个 run，并在超时、崩溃或工具失败时收敛。 运行时：PiRuntimeAdapter 通过 JSONL / stdio RPC 驱动 Pi；LocalRuntimeAdapter 用于确定性路径和测试。 会话：每个 Folio 会话对应一个 Pi 会话文件。工作区上下文随提问传入，不写进长期会话文件。 能力注册表：只读能力的单一事实来源，同时生成 Pi 工具、驱动 UI 是否可用、以及技能就绪。没有交易能力。个人页在本次运行中显示 20 项可用能力。 ProviderRouter：主源加备用，返回带来源的 ProviderResult。界面上的「Yahoo Finance · Delayed」来自这条链路。 研究综合：综合阶段基于已取到的数据包写报告，并对进入提示词的外部文本做清洗。 凭证：CredentialStore 使用系统 safeStorage 加密，密钥不回传渲染进程。 技能：SkillHub 只把技能索引进提示词；Agent 需要时再用 read_skill_resource 读取 SKILL.md 和参考资料。路径穿越和符号链接逃逸会被拒绝。 技能 技能声明必需和可选能力。技能中心显示就绪、部分就绪和已禁用。 缺少的能力不会被说成可用。 评测与可观测性 评测中心查看实验、基线、模型对比、失败模式、案例详情和人工反馈。 维度包括任务完成、工具选择与参数、证据/来源、时延、失败恢复、研究完整性和决策可用性。 folio-agent-v1 含 86 个案例（黄金路径、困难、长尾、工具失败、回归、对抗）。另有深度研究金标集 deep-research-gold-v1。 追踪可接 LangSmith 或 Langfuse，默认关闭。隐私级别和 API 密钥在设置中单独管理，界面不回显密钥。 PR 使用确定性的 bun run eval:smoke。完整 benchmark 用 bun run eval:full，按需或定时运行。 本地优先与只读 会话、研究状态和凭证默认在本机。 Electron：contextIsolation、sandbox、nodeIntegration: false，IPC 按通道白名单。 产品路径不提供下单。 工作原理 Yahoo Finance / Longbridge / Massive │ ▼ ProviderRouter 主源 + 备用，每条数据带来源 │ ▼ Capability Registry（只读） │ ┌────────┼─────────────┐ ▼ ▼ ▼ Agent 深度研究 产品 UI 工具 + 投资逻辑 + 技能 + 提醒 + 对比 + 组合风险 + 今日 / 事件 │ ▼ 基于证据的报告 主进程 AgentKernel SessionManager · RunManager PiRuntimeAdapter / LocalRuntimeAdapter SkillHub · CredentialStore 提供方返回规范化数据和来源，能力暴露类型化操作，产品工作流消费这些契约。 数据源与其他集成 Yahoo Finance： 免密钥的美股延迟报价和日/周 K 线备用源，Longbridge 与 Massive 未配置时可用。非官方接口，仅供个人使用。见 Yahoo Finance 说明。 Longbridge： 美股 / 港股 / 内地市场数据以及券商账户的主要连接器。可选。未安装 CLI 时，依赖它的财报、新闻、盘口和券商持仓显示为不可用。终端登录：longbridge auth login。 Massive： 已配置时作为美股后备数据源。 模型： Pi 运行时对接已配置的 LLM 提供方，包括 OpenAI 兼容的本地或远程端点。开发与离线黄金路径可以使用确定性本地运行时。 桌面端： Electron，提供 macOS arm64 打包。渲染进程、预加载桥和主进程内核隔离。 技能： 随应用提供的 SKILL.md 资源，含引用、启用状态、触发器和能力要求。 评测： 本地 Evaluation Backend，或可选的 LangSmith / Langfuse。工程指标可以和投资结果放在一起看，不把分数说成收益。 快速开始 面向用户 从发布页面下载最新的 macOS 构建。启动后： 可以直接浏览工作台。未接入的组合、事件等模块显示带「示例数据」标记的内置内容。 在 设置 → LLM 配置模型提供方。运行时、默认模型和思考等级在 设置 → 通用。 在 设置 → 连接 查看数据源。Yahoo Finance 无需 API 密钥，可提供美股延迟报价和 K 线。需要财报、新闻、盘口、港股/A 股或券商持仓时，再连接 Longbridge。 从自选打开一只标的，查看 K 线，或点击 深度研究。 按 ⌘K 搜索页面和标的。 Longbridge 也可以在终端登录： longbridge auth login 面向开发者 前置条件：Bun。实时 Longbridge 数据需要 Longbridge CLI。Pi 运行时需要一个 LLM 提供方；确定性本地运行时不需要外部模型。 Windows：在普通（非管理员）开发终端下，先开启「开发人员模式」（设置 → 系统 → 开发者选项）。否则 Bun 安装 workspace 符号链接依赖时，可能出现 node_modules 空目录、缺少 .bin 或 tsc not found。已有符号链接权限或以提升权限运行的进程不受此限制。 git clone https://github.com/helsome/folio.git cd folio bun install # 开发模式启动 Electron 渲染进程 bun run dev # 确定性本地 Agent，不需要外部 LLM FINAGENT_AGENT_PROVIDER=local bun run dev # 离线演示：真实提供方不可用时回退到内置示例数据 FINAGENT_AGENT_PROVIDER=local FINAGENT_DEMO_DATA=1 bun run dev 命令 命令 说明 bun run dev 以开发模式启动 Electron 渲染进程 bun test 运行单元与集成测试 bun run typecheck 对所有工作区包做类型检查 bun run bui