国海金工量化终端
客户使用手册
从登录、配置到数据查询、因子研究、组合归因与智能工作流，以真实界面截图逐步说明每项功能的入口、操作、结果与注意事项。
2026.07 / HTML + PDF
How to read
先找到入口，再完成操作
每项功能都按“入口路径—用途—前置条件—操作—结果—注意事项”编排。截图来自当前已打开的 v1.3.0 App；源码只用于补漏和解释控件含义。
识别入口
用“主导航 → 页签 → 功能卡片”标出准确路径。
照图操作
步骤与截图编号对应；页面中会改变状态的按钮单独警示。
确认结果
说明成功状态、输出位置、权限要求和未实操边界。
已通过 Computer Use 打开页面、读取控件并保存当前截图。
入口和表单已确认，但保存、下载、更新、发送、运行等动作没有触发。
需要 Token、本地数据、路径、模型或微信配置；按说明准备后再执行。
安全边界
- 本手册核验过程没有执行下载、更新、上传、保存、回测、AI 任务、审批、发布、删除、反馈发送或账号切换。
- 截图中的个人问候、本机路径、技能清单、流水线正文、日志和微信业务内容已遮盖；浅蓝色大面积区域表示主动脱敏，不是界面故障。
- 市场行情截图仅用于说明界面位置，不构成投资建议；实际数据时点以本地缓存和服务器返回为准。
Quick start
第一次使用：四步完成只读查询
左上状态为绿色时，本地 FastAPI 已连接；未连接时先查看连接遮罩的“重试”。
在左侧主导航进入“数据”，展开一个数据模块，再选择具体数据表。
按页面要求选择市场、代码、日期、口径或因子 ID；留空是否代表全部，以输入框提示为准。
查询是只读操作。结果区显示表格、页码和状态；先确认日期、证券代码和单位再使用。
| 界面状态 | 含义 | 建议动作 |
|---|---|---|
| 本地 API 绿色 | 桌面端已连接本地后端 | 可以浏览页面并查询本地数据 |
| Token 未配置 | 远程认证尚未就绪 | 如只做本地查询可继续；需要更新时进入设置 |
| 查询结果“暂无数据” | 尚未查询、参数无匹配或本地文件为空 | 先检查参数，再核对本地数据文件 |
| 后台任务运行中 | 下载或更新在后台进行 | 打开下载管理查看进度，不要重复提交 |
Home & global tools
主页与全局入口
主页提供状态总览、主要指数、更新入口和全局工具。左侧主导航在所有页面保持一致，右侧 AI 助手可以随时展开。
更新所有数据
未执行按模块串行更新全部可更新表，耗时和写入量较大；需要 Token。
快速更新核心表
未执行仅更新日常使用的核心基础表；股票价格使用前复权口径。
下载管理
页面已核验查看进行中、完成、失败和已取消任务；运行中任务可取消，终态记录可移除。
版本与主题
入口已核验版本按钮打开更新日志；主题切换只影响显示，本次未切换。
主页面、Agent 平台、投研流水线、数据、组合、因子、个股、微信、设置、日志和反馈共 11 个主入口。
中央顶部显示当前模块和子页，避免在相似表单中误操作。
右下角“AI”打开助手；发送消息、导入文件和调用能力会产生新任务，本次未执行。
Agent platform
Agent 平台
Agent 是可以调用工具完成任务的 AI 助手。平台把对话、定时任务、技能、子代理、工作流、插件、Hook 脚本和能力中心放在同一入口。
AI 智能体
新建对话、选择模型、输入消息；“/”调用技能或工作流，“@”提及子代理。
定时任务
查看任务状态和计划；新建弹窗配置名称、任务内容、频率、时间、工作目录与权限。
技能 / 子代理 / 工作流
浏览可调用能力；技能是单项说明，子代理是专门角色，工作流把多个步骤串联。
插件 / Hook / 能力中心
查看扩展、脚本触发器和能力汇总。安装、启停、编辑或运行会改变配置，本次未执行。
先确定需要一次性对话、周期任务还是复用既有能力。
涉及本地文件时，目录决定 Agent 可以看到的工作范围。
输入框下方显示工具权限；权限越宽，越应先确认任务描述和边界。
发送或保存会创建任务；涉及敏感文件、外部消息或修改时先缩小权限。
Research pipeline
投研流水线
流水线把一个投研需求从创建、运行、质量门禁、审批到发布串成可追踪流程。适合需要留痕、复核和交付物管理的任务。
需求管理
登记研究目标、验收标准、输入和工作目录；打开详情后可启动运行。
运行中心
查看阶段时间线、模型、质量门禁、输出目录和实时执行流。
审批中心 / 发布记录
审批需要人工判断；发布记录用于追踪已交付版本和产物。
数据看板 / 流水线设置
汇总运行质量、耗时和状态；设置模型、目录和门禁参数。
明确目标、输入、输出和可验证的验收条件，避免 Agent 自行猜测。
流程依次经过需求文档、Agent 开发、测试、评审、质量门禁与审批。
先定位失败阶段和证据，再决定重试；不要盲目重复运行。
检查产物、参数和风险说明。审批和发布属于状态变更，本手册不代为操作。
Data center
数据中心
数据中心覆盖交易日、股票、指数、基金、债券、宏观、期货和因子数据，共 100 个独立查询页。69 个页面已通过只读查询返回真实表格；其余 31 个页面在当前机器缺少可用本地文件，不放置空结果截图。
在左侧“数据模块”选择交易日、股票、指数、基金、债券、宏观、期货或因子数据。
页面标题必须和目标表一致；“管理”可控制侧栏显示表，“更新”会批量更新该模块。
常见参数包括市场、证券代码、日期、复权方式、报表项目、曲线或因子 ID。
结果表头显示英文名和中文解释；底部本地数据区显示 parquet 文件和连接状态。
Portfolio & attribution
组合、回测与归因
组合模块把持仓管理、策略回测、实时监控、Brinson 归因和 Barra 归因放在一起。归因用于解释收益来源，不等同于收益预测。
组合管理
维护组合基本信息和持仓；新增、编辑、删除或导入会改变本地组合数据。
组合回测
配置组合、基准、日期、费率等参数，输出净值、回撤、换手、月度和年度统计。
持仓监控
查看当前持仓、权重、收益和风险提示；数据时点取决于本地行情。
Brinson / Barra 归因
Brinson 解释行业配置与选股贡献；Barra 用风格、行业和特异收益解释风险收益。
回测前的口径检查
- 组合与基准必须使用同一时间区间和频率。
- 确认交易费率、印花税、调仓频率和缺失数据处理。
- Barra 因子库依赖副服务器数据；没有相应数据时结果可能为空。
- 历史回测不代表未来表现。
Factor research
因子库与因子分析
因子是描述股票特征的数值指标。因子模块提供三类因子库、收益、IC/IR、分层回测、相关性和衰减分析。
国海 / Barra / AI 因子库
查看可用因子、字段说明、覆盖日期与来源；AI 因子库的生成过程需要模型配置。
因子收益
观察因子暴露对应的历史收益，不应仅凭单期收益判断有效性。
IC/IR 与分层回测
IC 衡量因子与未来收益的相关性；IR 衡量 IC 的稳定性；分层回测比较不同分组表现。
相关性与衰减
相关性用于识别重复信息；衰减展示预测能力随持有期变化。
先确认因子方向、频率、覆盖范围和缺失值处理。
避免使用未来数据；因子值日期必须早于对应收益区间。
同时观察 IC 均值、IR、分层单调性、换手和回撤。
分市场、分行业、分时期验证，并记录样本外表现。
Single stock research
个股研究
输入证券代码后，个股页汇总价格走势、估值区间和研究信息。实机只读核验使用公开示例代码 600519，返回 242 根 K 线及估值区间。
确认市场和代码格式，避免同名证券混淆。
等待行情、估值和相关信息加载；这是本次唯一实际执行的数据查询。
先看最新交易日和数据条数，再阅读图表。
分位数仅表示历史相对位置，不代表未来涨跌。
Wechat research
微信研究工具
微信模块用于配置数据源、检索历史信息、生成简报、追踪观点、选股、图片解密以及公众号文章分析。实际结果取决于客户自己的微信数据与模型配置。
配置与密码
设置数据位置、连接方式和访问密码。密码输入与保存属于敏感操作，本手册不展示。
信息检索与简报
按日期、群聊、关键词或分类筛选消息；简报把指定范围的信息汇总成结构化摘要。
观点追踪与选股
跟踪历史观点及后续表现；选股页按条件整理候选标的并支持导出。
图片解密与公众号分析
处理业务图片或公众号文章，智能分析需要已配置模型；上传、解密和生成均未实操。
隐私与合规
- 微信消息、联系人、群名、图片和文章列表可能包含非公开信息。
- 检索、导出、发送或交给模型分析前，应确认数据权限和使用目的。
- 手册截图保留页面导航和结构，主要业务区域已遮盖。
Settings, logs & feedback
设置、日志与反馈
设置管理大模型、远程账户与本地路径；日志按数据、回测和微信分类；反馈页用于提交问题和建议。
大模型
配置 AI 供应商、模型和必要凭证；修改后会影响 Agent、流水线和微信智能分析。
远程账户
登录后可查看、生成或撤销 Token。新 Token 只在生成时完整显示，应立即安全保存。
路径配置
设置数据、因子、Excel 导出和 Agent 工作目录，以及首次下载起始日期。
日志与反馈
日志用于定位错误和确认任务；反馈发送前应去除 Token、路径和客户数据。
大模型、远程账户和路径配置互相独立。
路径和模型变化会影响多个模块；先确认新目录存在且权限合适。
回到首页或目标页面确认模型、Token 和本地 API 状态。
数据问题看数据日志，回测问题看回测日志，微信问题看微信日志。
Troubleshooting & glossary
常见问题与术语
| 现象 | 优先检查 | 处理建议 |
|---|---|---|
| 一直显示无法连接本地 API | 连接遮罩、API 状态、端口 8765 | 先点一次“重试”；仍失败时重启 App，并查看数据日志。 |
| 查询后仍无数据 | 市场、代码、日期、口径、本地 parquet | 缩短日期或清空可选代码重试；确认底部本地文件存在。 |
| 缺少本地文件时查询一直转圈 | 底部是否显示“该方法暂无本地数据” | 不要继续提交查询；先切换页面。若全局查询按钮仍被锁定，重启 App。ETF IOPV 页面在本次核验中可复现。 |
| 基金全表查询长时间无响应 | 是否把基金代码留空；文件体积是否很大 | 先从“基金代码”结果选一个公开代码，再按单只基金查询。基准收益和费率不要直接用空代码全表读取。 |
| 更新按钮不可用 | Token 状态和是否已有同类任务 | 进入设置完成远程账户配置；在下载管理等待或取消重复任务。 |
| 因子或 Barra 页面为空 | 副服务器数据、因子 ID、日期覆盖 | 确认所选因子存在且数据区间有交集；必要时联系数据管理员。 |
| 回测结果异常 | 基准、费率、调仓、复权、缺失值 | 从最短区间和最简单组合开始，逐项恢复参数。 |
| AI 或流水线无法运行 | 模型配置、工作目录、权限、日志 | 先确认模型可用，再缩小到简单只读任务测试。 |
- Token
- 访问远程数据服务的认证凭证，应像密码一样保管。
- Parquet
- 本地列式数据文件；查询通常先读这些缓存文件。
- 复权
- 对分红送配造成的价格跳变进行调整，常见前复权、后复权和不复权。
- IC / IR
- IC 衡量因子与未来收益的相关性；IR 衡量 IC 的稳定程度。
- Brinson 归因
- 从行业配置和行业内选股等角度解释组合相对基准的收益。
- Barra 归因
- 用风格因子、行业因子和特异项解释组合风险与收益。
- 质量门禁
- 流水线中必须通过的自动检查，例如测试、评审或产物完整性。
- Hook
- 在特定事件发生时自动运行的脚本或规则。
Coverage ledger
功能覆盖索引
索引是本手册的完整性账本。每一行都列明入口、用途、前置条件、操作、结果、注意事项、截图编号和核验状态；可在 HTML 中按模块筛选，PDF 中默认全部展开。
| 功能 | 入口路径 | 用途 | 前置条件 | 分步操作 | 结果/状态 | 注意事项 | 截图 | 核验状态 |
|---|
Screenshot evidence
当前版本截图证据册
下列截图均来自本次 Computer Use 遍历。浅蓝色遮盖区用于隐藏个人目录、已安装能力、流水线任务、日志或微信业务内容；所有图片均随 HTML 本地保存，可离线打开。