FinRobot 安装实测 / AI4Finance-Foundation
FinRobot Windows 安装部署：本机实测记录与失败点
这一页不是把 README 的安装命令再抄一遍。本机（Windows 10 / Python 3.11.9 / Node 24）实际走了一遍四条路线，记下每一步的真实结果：桌面版对 Windows 根本不存在；浏览器模式里的 uv sync 因为本机没装 uv 就停了；pip install finrobot 装是装上了，但装到的是 2024 年的 V0，而且一条依赖都没带。先看清这些，再决定要不要投入时间自建。
FinRobot 的安装环境里有什么、缺什么？
下表是本次实测机器的真实配置（记录日期 2026-09-30）。「对 FinRobot 意味着什么」这一列是官方文档不会给你的——它直接决定你能走哪几条上手路线，以及会在哪里停下来。
| 检查项 | 本机实测结果 | 对 FinRobot 意味着什么 | 缺了时的替代路径 |
|---|---|---|---|
| 操作系统 | Windows 10.0.26200 | 官方桌面安装包只覆盖 macOS Apple Silicon，本机不在覆盖范围内 | 图形界面改走浏览器模式，或直接用命令行 |
| Python | 3.11.9（MSC v.1938 64bit） | 满足 V2 要求的 >=3.11；同时也落在 PyPI 上 V0 包的 >=3.10,<3.12 区间内 | 3.12 及以上装不了 PyPI 上的 V0 包，需单独建 3.10/3.11 环境 |
| Node | v24.18.0 | V2 浏览器模式与源码构建要求 Node 20+，本机满足（官方 CI 跑 22 / 24） | 低于 20 需要先升级；只跑命令行时可以不装 Node |
| npm | 11.16.0 | 浏览器模式要装一次前端依赖（desktop/ 下的 npm install） | — |
| git | 已安装 | 可以克隆仓库、走 V0 的源码安装（官方要求在仓库根执行安装） | 只用包管理器安装时可以不装 |
| uv | 未安装（命令探测无结果） | V2 的命令行与浏览器模式都以 uv sync 起步——本机这两条路线在此处停住 | 先安装 uv；或改用 pip install -e . 试命令行（官方未在此场景下背书） |
| Docker | 未安装 | V1 的容器路径不可用（构建文件必须在仓库根执行） | 改用本地虚拟环境 + 依赖清单安装 |
| 命令行依赖 | click 8.4.2 已装 | 仅够支撑命令行框架，命令行入口还依赖模型与数据层组件，不能只靠它跑起来 | 按 V2 的依赖清单完整安装 |
FinRobot 的四条上手路线，本机各跑到哪一步？
官方写入四条路线，但这四条在 Windows 上的可行性差别很大。下表写清了「实测到什么程度」与「卡在哪」——没跑到的直接写未实测，不替官方下结论。
| 路线 | 官方写入的前置与命令 | 本机实测到什么程度 | 卡点 | 更适合谁 |
|---|---|---|---|---|
| V2 桌面 App | 下载 macOS 发行物，拖进 Applications；未做 Apple notarize，打开前可能要清一次隔离标记；首次运行需在设置页填自己的模型密钥 | 无法安装：官方发行物里没有 Windows 资产 | 平台不支持，不是配置问题 | 有 Apple Silicon Mac、不想碰命令行的使用者 |
| V2 浏览器模式 | uv + Node 20+ + Python 3.11+；进入工程目录执行 uv sync，再装前端依赖，然后运行启动脚本，打开 http://localhost:5173 | 停在起步：本机未安装 uv，依赖同步无法执行；Node 与 npm 满足要求 | 缺 uv | Windows / Linux / Intel Mac 上想用图形界面的人 |
| V2 命令行 | 依赖同步后可用：研究全流程、估值、可比公司、投委会备忘、问答等子命令；多数命令支持指定模型与输出语言 | 同样卡在 uv；命令输出未实测（缺 uv 与模型密钥） | 缺 uv；之后还需要模型密钥和网络 | 要批处理或把研究流程接进自己脚本的开发者 |
| V1 Web 应用 | 复制配置示例为正式配置，填数据源与模型两个必填密钥（舆情密钥可选），执行部署脚本启动，访问 127.0.0.1:8001 | 未实测：本机缺数据源与模型两个必填密钥，无法完成取数与叙述环节 | 两个必填密钥；容器路径还需 Docker | 要一个能被同事访问的研报生成服务 |
| V0 教学版 | conda 建 Python 3.10/3.11 → 在仓库根执行源码安装 → 复制两个示例配置到子目录 → 跑教学 notebook | 部分实测：包管理器安装路径已完整验证（见下一节），源码安装与 notebook 未实测（需要模型与数据源密钥） | 模型密钥；数据源密钥；Python 版本区间 | 想读懂金融智能体怎么接起来的人 |
:8321 与 :5173 的进程结束掉——如果桌面 App 正开着，它的内置后端也会被一并结束，所以要先把 App 退出。② 浏览器模式下本地接口没有鉴权：桌面壳每次启动会生成能力令牌，纯浏览器没有对应通道可读，后端把鉴权中间件降级成空操作。它仍然只绑定本机回环地址，但同一台机器上的其它进程可以访问 :8321，其中包含持有密钥的设置接口——共享机器上优先用桌面 App。pip install finrobot 装到的是什么？
这是最容易浪费时间的一条路：命令成功、import 也成功，但一调用就报缺包。本机在隔离虚拟环境（Python 3.11.9）里完整走了一遍，并把包内文件与元数据都核了一遍。
| 检查项 | 实测结果 | 依据 | 注意点 |
|---|---|---|---|
| 装到的版本 | 包索引上是 0.1.5，上传时间 2024-06-17（该包共 7 个版本，最新仍是 0.1.5） | 包索引的版本列表 | 它是两年前的 V0 代码，不是当前的生产版 |
| Python 约束 | Requires-Python: >=3.10, <3.12 | 包元数据 | Python 3.12 及以上会直接装不上 |
| 许可元数据 | License: MIT | 包元数据 | 与仓库的 Apache-2.0 不一致，以仓库许可文件为准 |
| 依赖列表 | 空：元数据里没有任何 Requires-Dist；装完后虚拟环境里只有本体 | 安装后目录与包元数据 | 「装成功」在这里不等于「能用」 |
| import 之后 | import finrobot 成功；从智能体模块导入类时直接报 ModuleNotFoundError: No module named 'finnhub'；工具模块报 No module named 'autogen' | 本机实际报错原文 | 报的不是 FinRobot 自己的包名，容易误判成「环境坏了」 |
| 零依赖的根因 | 安装脚本去读子目录里的依赖清单文件，而该版本的源码包里没有这个文件（39 个条目里只有旧布局的包目录、安装脚本、许可、说明与元数据目录），读取失败后走了兜底分支，依赖列表被置成空列表 | 源码包内容逐条核对 + 安装脚本源码 | 属于打包遗漏，不是网络或本机问题 |
| 正确做法 | 要 V0：克隆仓库后在仓库根执行源码安装（此时依赖清单存在，依赖才会一起装上）；要 V2：不要走包索引，改用依赖同步方式 | 官方 README 的 V0 安装段 | 换机器、换镜像、重装都会得到同样结果 |
动手装 FinRobot 之前，哪些项该先确认？
这份清单的用途是用三分钟排除走不通的路线，而不是装到一半才发现平台不支持。每项都给了排查命令与不满足时的替代路径。
| 检查项 | 怎么查 | 不满足时怎么办 | 为什么重要 |
|---|---|---|---|
| 平台与芯片架构 | 看系统版本信息；Mac 上确认芯片类型 | Windows / Linux / Intel Mac 直接排除桌面安装包，改走浏览器模式或命令行 | 官方桌面发行物只覆盖 Apple Silicon |
| Python 版本 | python -V（Windows 也可列出本机所有版本） | V2 需 3.11+；V0 的包索引包需 3.10–3.11；用 3.11 可以同时满足两边 | 版本不符会在安装阶段直接失败 |
| 是否装了 uv | where uv（Windows）/ which uv | 没有就先装 uv；不装 uv 就没有 V2 的命令行与浏览器模式 | 本机实测正是卡在这里 |
| Node 版本 | node -v | 低于 20 先升级；只跑命令行时可以暂不装 | 浏览器模式与源码构建需要 |
| 端口占用 | netstat -ano | findstr :8321（同理查 :5173） | 先结束占用进程；注意启动脚本会主动结束这两个端口上的进程 | 端口被占时前端起不来 |
| 网络可达性 | 先用包管理器装一个很小的依赖试；再访问数据源文档页 | 受限网络先确认代理策略；取数失败要先分清是网络还是密钥 | 安装与取数是两条独立链路 |
| 是否已有模型密钥 | 确认账号已开通并可用 | 没有密钥时桌面 App 能打开，但分析请求会被拒绝；命令行与 V1 同理 | V2 用的是你自己的模型账号，App 不自带密钥 |
| 磁盘空间 | 看剩余空间 | 给 Python 依赖与前端依赖都留出余量 | 两套依赖体量都不小，装到一半没空间最难查 |
FinRobot 的三条自建路线分别怎么装？每步的预期输出是什么？
分步流程的价值不在命令本身，而在「跑完应该看到什么」。下表按版本给出真实命令与预期输出，再单独展开浏览器模式那一条——它的步骤最多、也最容易卡住。
| 版本 | 步骤 | 命令 | 预期输出 / 通过标准 |
|---|---|---|---|
| V2 浏览器 | 1. 装 uv | 按官方 uv 安装说明执行 | uv --version 有版本输出 |
| V2 浏览器 | 2. 同步后端依赖 | 进入工程目录执行 uv sync | 依赖解析安装完成；如需开发工具要带上可选标记同步（裸同步会移除已装的可选依赖） |
| V2 浏览器 | 3. 装前端依赖（一次） | 进入前端目录执行 npm install | 生成前端依赖目录，无报错 |
| V2 浏览器 | 4. 起服务 | 回到工程目录运行启动脚本 | 终端显示先起后端 :8321、再起前端 :5173，并提示打开本地地址 |
| V2 浏览器 | 5. 配密钥并验证 | 在设置页填模型密钥 | 发起一次分析请求能返回内容；未配密钥时会提示先配置 |
| V2 命令行 | 1. 同步依赖 | 进入工程目录执行 uv sync | 同上；之后命令行入口可用 |
| V2 命令行 | 2. 跑最小命令 | 估值子命令或研究全流程子命令，指定一个标的 | 输出里出现折现率、投影表与隐含价；若方法不适用会明确提示改用相对估值 |
| V1 | 1. 复制并填写配置 | 复制配置示例为正式配置后填两个必填密钥 | 文件存在且字段与示例一致 |
| V1 | 2. 启动服务 | 执行部署脚本的启动命令 | 脚本自安装依赖并启动，浏览器可打开 127.0.0.1:8001；无脚本环境可用虚拟环境 + 依赖清单 + 启动脚本替代 |
| V0 | 1. 建环境 | 用 conda 建 Python 3.10 环境后激活 | 提示符前出现环境名，python -V 返回 3.10.x |
| V0 | 2. 在仓库根安装 | 回到仓库根执行源码安装 | 以成功安装结束，导入本体无报错（注意：不要在该仓库的子目录里安装） |
| V0 | 3. 配两个配置文件 | 在子目录下复制两个示例文件并填写 | notebook 能按相对路径读到它们（所以位置不能随意挪） |
| V0 | 4. 跑 notebook | 从 notebook 所在目录打开并逐格执行 | 能走到最后并产出中间结果；卡在取数就回看数据源密钥 |
浏览器模式为什么值得单独走一遍
在 Windows 与 Linux 上，目前只有这一条路径能拿到 V2 图形界面，但需要两个进程协同：前端
:5173把接口请求代理到后端:8321。预期输出：终端先打印后端就绪、再打印前端地址；后端启动失败时会给出日志路径（官方文档写的是类 Unix 路径，Windows 上未必是该位置）。起服务前先确认端口空着
查
:8321与:5173是否被占用。预期输出：没有匹配行。若有匹配行，先结束占用进程——脚本会自己动手结束这两个端口上的进程，你可能因此关掉别的东西。先只起后端、再起前端
想知道问题出在哪一端，可以先单独启动后端服务，用浏览器访问它的接口文档路径看是否返回内容。预期输出：后端返回接口清单。这一步能明确区分「后端起不来」与「前端代理没接上」。
还没有可用的静态生产构建
官方说明里写明：前端构建命令产出的是桌面壳用的资源，预览命令没有配代理，接口请求到不了后端。含义：浏览器模式目前是本地开发形态，不要把它当成正式对外部署方案。
改后端要重起脚本
前端改动会热更新，后端改动需要重启启动脚本。预期输出：重启后设置与分析结果仍在（数据落在本地制品库里，不在进程内存）。
FinRobot 三代的密钥放哪、怎么不泄露？
三代的密钥管理方式完全不同：V2 走系统钥匙串，V1 走配置文件，V0 走两个放在特定目录下的文件。混用是「装了但跑不动」的高频原因。
| 版本 | 需要的密钥 | 存放位置 | 是否入库 | 怎么确认生效 |
|---|---|---|---|---|
| V2（桌面 / 浏览器） | 模型密钥，官方说明支持多家服务商，用你自己的账号 | 界面的设置页，写入系统钥匙串（不是普通环境变量文件） | 不入库 | 发起一次分析请求能返回内容；未配置时 App 能打开但请求会被拒绝 |
| V2（浏览器模式额外风险） | 同上 | 同上，但 :8321 在浏览器模式下无鉴权 | 不入库 | 同机其它进程可访问持有密钥的设置接口——共享机器上优先用桌面 App |
| V1 | 数据源密钥（必填）+ 模型密钥（必填）+ 舆情数据密钥（可选，启用零售情绪模块） | 数据源与模型配置目录下的配置文件 | 正式配置被忽略，示例文件才受版本控制 | 跑一次数据与分析脚本，能取到财务数据即生效 |
| V0 | 模型端点清单 + 数据源密钥（行情 / 财报 / 申报 / 社区等多类） | 两个文件都放教学版子目录（notebook 按相对路径读取） | 两个正式文件都被忽略，示例文件才入库 | 跑一个需要推理的最小 notebook，能返回即生效 |
| 通用纪律 | 任何密钥 | — | 都不提交进制品库、不贴进截图与工单 | 提交前先看一遍待提交清单；发现误提交要立即作废并更换密钥 |
装完 FinRobot 之后，怎么判断真的能用？
官方安装步骤到「装完包」为止；下面这份清单补的是安装之后、正式使用之前该怎么自查，并按版本给出不同的通过标准。
| 检查项 | 怎么做 | 正常表现 | 异常表现与下一步 | 适用版本 |
|---|---|---|---|---|
| 解释器是否同一个 | 激活环境后查 python -V 与解释器路径 | 路径落在该环境目录内 | 指向系统解释器 → 环境没激活，回到建环境那一步 | V0 / 自建环境 |
| 包是否装进该环境 | 用该解释器导入本体 | 无输出即成功 | 报缺第三方包（如行情库、多智能体框架）→ 说明依赖没装上，见包索引那一节 | V0 |
| 包管理器指向 | 查包管理器版本与路径 | 路径与环境一致、版本可查 | 指向全局目录 → 用 python -m pip 形式重装，或确认 uv 安装位置 | 全部 |
| 命令行入口是否注册 | 先看帮助，再列技能清单 | 列出可用子命令；技能清单能列出 56 个分析师手册 | 命令不存在 → 依赖未同步，或不在该环境里 | V2 |
| 默认端口是否可用 | 起服务前查 :8321 与 :5173 | 两个端口都空着 | 被占用 → 先结束占用进程，注意脚本会主动清这两个端口 | V2 浏览器 |
| 模型密钥是否读到 | 发一次最小分析请求 | 能返回内容 | 提示未配置或认证失败 → 回看密钥那一节 | 全部 |
| 数据源是否可达 | 跑一次需要取数的最小流程 | 取到非空数据 | 返回空表 → 分辨密钥 / 限流 / 网络三类原因 | 全部 |
| 端到端能不能跑完 | 跑一条完整流程（如一次单标的估值或一份报告） | 输出含方法、假设与数字，并在缺数据处给出警告 | 中途停在取数或推理 → 用中间输出定位是哪一环 | V2 / V1 |
FinRobot 安装与起步阶段的报错怎么排查？
安装环节的报错里真正属于「包坏了」的很少，多数是环境错位、前置工具缺失或密钥配置问题。表中前几行是本次实测真实遇到的，其余按现象归类。
| 现象 | 可能原因 | 处理建议 | 怎么确认修好了 | 适用版本 |
|---|---|---|---|---|
| uv 命令不存在，没法同步依赖 | 本机未安装 uv（本次实测即此情况） | 先安装 uv；或用仓库说明里的替代安装方式试命令行 | 版本命令有输出 | V2 |
| 装上后导入报缺行情库 / 缺多智能体框架 | 用包索引装到了零依赖的旧版包 | 改为在仓库根执行源码安装，或改用 V2 的依赖同步 | 依赖装齐后，同一个导入不再报缺包 | V0 |
| 前端起不来 / 提示端口被占用 | :8321 或 :5173 已被占用（含 App 的内置后端） | 先退出正开着的 App，再结束占用进程后重试 | 两个端口均无占用，前端能打开本地地址 | V2 浏览器 |
conda activate 不生效 | shell 未初始化 conda | 按 conda 官方提示初始化，或直接用环境内解释器的完整路径 | 提示符出现环境名，且解释器路径落在环境目录 | V0 |
| 安装时报依赖冲突 | 环境里已有版本不兼容的包 | 新建干净环境重装，不要在被污染的旧环境里硬升 | 安装成功且导入正常 | 全部 |
| Python 版本不符 | 系统默认解释器不是目标版本，或版本超出要求区间 | 显式用目标环境执行；V2 需 3.11+，V0 的包索引包需 3.10–3.11 | 版本落在要求区间内 | 全部 |
| 调用模型时报认证失败 | 密钥未配置、配置位置不对，或额度不足 | 对照密钥表确认位置与字段，再确认账号额度状态 | 最小推理请求能正常返回 | 全部 |
| 取数返回空或部分为空 | 对应数据源密钥缺失、限流或权限不足 | 先确认该密钥已配置，再换一个已配置好的数据源交叉验证 | 换源能取到数据，说明是原数据源的问题 | 全部 |
| 取数超时 / 接口不可达 | 网络策略、代理或目标站点限制 | 换网络或按运维要求配置代理后重试 | 同一命令在可直连网络下成功 | 全部 |
| 浏览器模式下别的程序能读到我的密钥 | 浏览器模式本地接口无鉴权（官方已说明） | 改用桌面 App，或不要在不信任的机器上开浏览器模式 | 接口不再被非预期进程访问 | V2 浏览器 |
| 带上可选依赖同步后工具不见了 | 裸执行同步会移除已装的可选依赖 | 带上原来的可选标记重新同步 | 测试工具命令恢复可用 | V2 |
FinRobot 装错了怎么干净卸载？升级前该备份什么？
官方文档没有统一的卸载章节，下表是按各组件的安装方式反向推出的通用做法——属本站整理，不是官方卸载说明，执行前请先确认你装的是哪一种形态。
| 组件 | 怎么卸载 | 会留下什么 | 升级前该备份什么 |
|---|---|---|---|
| V2 桌面 App（仅 macOS） | 从应用程序目录删除应用包；如曾清过隔离标记，无额外残留 | 用户数据目录与系统钥匙串里的模型密钥条目 | 已有研究制品与设置页里的密钥 |
| V2 浏览器模式 | 退出启动脚本后删除虚拟环境目录与前端依赖目录 | 本地制品库（历史运行与报告） | 制品库文件、模型密钥 |
| V2 命令行 | 在对应环境里卸载包；保留源码不影响其它环境 | 命令行入口脚本、缓存目录 | 运行记录与配置 |
| V1 | 先执行停止命令，再删除虚拟环境与配置文件 | 本地数据库文件、生成的报告输出目录 | 配置里的密钥、数据库与输出报告 |
| V0 | 在环境内卸载包，再删除该 conda 环境 | 两个明文配置文件、notebook 产物 | 两个配置文件（里面是你的密钥） |
| 通用残留 | 按需清理缓存与输出目录 | 价格缓存、日志、导出文件 | 确认没有要留的输出后再清理 |
FinRobot 在 Windows / macOS / Linux 上分别会卡在哪？
官方安装说明以命令行流程为主线，没有逐个系统展开。下表把不同系统上容易卡住的位置集中列出来，方便对号入座。
| 环境 | 能不能用 | 常见卡点 | 建议做法 |
|---|---|---|---|
| Windows（V0 命令行路线） | 可用 | 多个 Python 共存导致装错解释器；命令写法与文档示例不一致 | 全程使用同一个隔离环境，命令统一用 python -m pip 形式 |
| Windows（V2 图形界面） | 可用，但只能走浏览器模式 | 缺 uv 则起步即停；启动脚本是 shell 脚本形式，需在支持它的环境里执行 | 先装 uv 与 Node 20+，再按分步安装那一节走一遍 |
| macOS（Apple Silicon） | 可用，且是桌面 App 的覆盖平台 | 桌面版未做 Apple notarize，打开前可能需要清一次隔离标记 | 先跑命令行流程确认链路可用，再决定是否长期用桌面版 |
| macOS（Intel） | 可用，但桌面发行物不覆盖 | 系统自带解释器与环境混淆 | 确认解释器路径落在隔离环境内；图形界面走浏览器模式 |
| Linux 服务器 | 可用 | 无图形界面时浏览器模式需要端口转发；脚本依赖 shell 环境 | 先用命令行验证，再决定是否需要转发浏览器界面 |
| 无独立 GPU 的机器 | 可用 | 担心必须本地跑大模型 | 官方路径主要走云端模型接口，独立 GPU 不是必需项 |
| 公司内网 | 视网络策略而定 | 包源与数据源接口可能被拦截 | 先确认能访问包源与目标数据源，再开始安装 |
| 容器 / Docker | 视形态而定 | 镜像里常无 conda；重启后配置易丢；本机未安装 Docker，未实测 | 把环境准备与配置都写进构建脚本，别只手动执行一遍 |
哪些人适合自建 FinRobot、哪些可以先不装？
如果你只是想要一个研究结论，自建的时间成本可能高于收益。下表按「你的情况」给判断，并写明先做哪一步验证。
| 你的情况 | 是否建议自建 | 原因 | 先做哪一步验证 |
|---|---|---|---|
| 有编程基础，要做可追溯的研究流水线 | 建议 | 能自己维护环境与密钥，收益上限高 | 按分步安装跑通一条最小命令 |
| 要二次开发智能体或估值算子 | 建议 | 源码路径支持改造，算子层是纯 Python | 先确认能导入并调用一个算子 |
| 只想查一次行情 / 估值 / 技术面 | 不建议 | 装环境与配多个密钥的成本高于一次性收益 | 先用免部署路线拿到结果，再判断是否需要自建 |
| 没有可用的模型密钥 | 先别装 | 核心推理依赖模型密钥，缺了跑不动 | 先确认能拿到密钥，再动手装包 |
| 必须用 A 股数据 | 谨慎 | 官方数据源以美股链路为主，A 股需自行接入 | 先确认能否接上可用的 A 股数据源 |
| 只在 Windows 且想要图形界面 | 谨慎 | 桌面发行物不覆盖 Windows，只能走浏览器模式 | 先确认能装上 uv 并起两个本地端口 |
| 团队内需要固定口径与可审计输出 | 建议评估 | 自建可控，但需要有人长期维护环境 | 先确认估值类计算由代码算子完成、模型只写叙述 |
| 在共享机器上使用 | 谨慎 | 浏览器模式的本地接口无鉴权，同机其它进程可读密钥 | 改用桌面 App，或换一台你能独占的机器 |
FinRobot 安装常见问题
Windows 上到底能不能装 FinRobot？
分形态看：V0 的命令行流程与 V2 的浏览器模式、命令行都可以，但 V2 图形界面在 Windows 上只有浏览器模式这一条路——官方桌面发行物只覆盖 macOS Apple Silicon，Windows 没有可下载资产。本机实测的结论是：Windows 上能不能装，不取决于代码，而取决于你有没有先装 uv 与 Node。
为什么用包管理器装完之后一调用就报缺包？
因为包索引上是两年前的旧版本，它的源码包里没有依赖清单文件，安装脚本读取失败后把依赖列表置成空，所以装完只有本体、没有依赖。导入本体能通过，但一用到需要第三方库的模块就会报缺包。要 V0 请改成在仓库根做源码安装；要 V2 请改用依赖同步方式。
必须用 conda 吗？
官方安装说明写的是 conda 建独立环境（Python 3.10）。用其它隔离方式并非不可以，但官方没有展开这条流程，遇到依赖问题时不在官方文档覆盖范围内——以官方 README 为准。无论用哪种方式，「解释器与包必须同一个环境」这条不能破。
没有 API 密钥能跑吗？
不能完成完整的分析与研报流程：模型推理与数据获取都需要密钥。缺密钥的典型表现往往不是明确报错，而是取数为空或任务中途停住。组合上可以先配模型密钥与一个数据源密钥把最小流程跑通，再逐步补齐其它数据源。各家的申请方式与计费口径以各家官方页面为准。
要花多少钱才能跑起来？
项目本身是 Apache-2.0 许可、不收费；成本来自模型调用与部分数据源。不同服务商有免费档与付费档的差别，额度与计费差异很大，本页不列具体价格——以各家官方定价页为准。想控制成本，先用最小命令跑通链路，再逐步接入更多数据源与更长流程。
装完导入成功，是不是就能用了？
不是。导入成功只证明环境层没问题，真正的门槛在配置层：三代的密钥存放方式完全不同，任何一个没配到位，任务都会在取数或推理环节失败。本页的装后自检清单就是按「环境层 → 配置层 → 流程层」的顺序设计的，建议逐项走一遍再开始正式使用。
浏览器模式安全吗？
官方已明确说明：桌面壳每次启动会生成能力令牌，而纯浏览器没有读取该令牌的通道，因此后端把鉴权降级为空操作。它仍然只绑定本机回环地址，但同一台机器上的其它进程可以访问本地接口，其中包含持有密钥的设置接口。结论：能独占的机器上问题不大，共享机器上优先用桌面 App。
安装报依赖冲突怎么办？
优先新建一个干净环境重装，而不是在被污染的旧环境里硬升版本。多数「装不上」的根因是环境里残留了不兼容的包版本；如果重装仍失败，先确认 Python 版本符合要求，再看依赖报错里具体是哪个包。具体依赖版本以官方工程定义与包索引为准。