ceyyy427/finathink

Finathink 将用户提供的数据、证据、因子、量化检验、风险检查、纸面组合和学习记录组织成一条可追溯的研究流程。运行结果保存为结构化记录和可离线打开的 HTML 报告，适合个人研究、量化学习、策略复盘和多代理协作。

用户数据连接 → 数据标准化与点时检查
    → 五类分析师并行 → 研究经理汇总证据
    → 受控因子提案 → 回测与 OOS 检验 → 指标、换手、衰减与排名
    → 确定性风险检查 → 纸面组合 → 成本与滑点模拟
    → 纸面决策卡 → HTML 报告 → as-of 学习提案

每个阶段都有稳定的运行 ID、输入与输出指纹、角色、状态、证据引用和 checkpoint。相同的 fixture 输入可以重放并得到稳定指纹。

金融事件可以进入证据链、知识理解和量化研究；策略想法可以进入因子、回测、OOS、风控和纸面组合流程。

• 保存用户自己的数据 API 连接配置和字段映射。
• 通过显式试连取得 JSON 数据，标准化为 DataBatch。
• 记录数据指纹、字段质量、来源说明和 point-in-time 状态。
• 使用环境变量或系统钥匙串引用保存凭证，凭证值不进入研究记录。

• 并行运行基本面、技术、情绪、新闻和学习分析师。
• 由 ResearchManager 汇总带证据引用的观察，形成研究计划。
• 每个角色都经过统一的任务、能力、状态和错误合同。
• 可使用离线驱动、用户配置的兼容模型接口和 Codex handoff 合同。

• 将自然语言假设映射到固定 DSL 模板和受控因子提案。
• 进行训练、验证、隐藏 OOS、冻结和一次性测试。
• 计算 IC、ICIR、换手、多周期衰减并按确定性指标排名。
• 记录来源、许可证、PIT 语义、字段依赖、版本和研究指纹，生成待人工准入的提案。
• 使用内部确定性量化网关执行回测和风险指标计算。

• 检查 PIT、流动性、集中度、回撤和压力情景。
• 按用户约束生成 long-only 纸面组合和权重。
• 模拟费用、滑点、现金变化和纸面成交台账。
• 风险、组合或量化阶段未通过时，决策卡保持不可执行状态。

• 本地持久化队列支持幂等、租约、重试、退避、取消和崩溃恢复。
• Worker 使用 checkpoint 和资源限制恢复长任务。
• 结算后的纸面事件可以生成因子权重、风险规则和注册表更新提案。
• 学习提案保留 as-of、结算指纹和证据引用，并经过显式准入记录。

• 生成自包含的多阶段 HTML 报告、manifest 和 activity 记录。
• 报告包含分析师、证据、研究、量化、风险、纸面决策和学习状态。
• 状态墙提供阶段、角色、重试、checkpoint、工具摘要和 manifest 指纹。
• 可比较多次实验的输入、指标和限制，并保留离线无 JavaScript 阅读能力。

要求 Python 3.11 或更高版本。

python3 -m venv .venv
source .venv/bin/activate
python3 -m pip install --upgrade pip
python3 -m pip install -e '.[dev]'
PYTHONPATH=src python3 -m pytest -q
python3 scripts/run_local_app.py --sample --port 8765

打开：

• 首页：http://127.0.0.1:8765/
• 研究工作区：http://127.0.0.1:8765/research
• 因子策略工作台：http://127.0.0.1:8765/workbench
• Provider 设置：http://127.0.0.1:8765/settings/providers

src/finahinking/        Python 核心包、研究编排、量化与报告引擎
frontend/               研究图表、工作台和交互界面
fixtures/               可复现的样例与测试数据
tests/                  单元、集成、契约和产品流程测试
docs/                   架构、研究指南、数据适配器与验证文档
site/                   静态产品入口与前端构建资源
.github/                CI、安全和自动化配置

• 快速开始
• Factor Strategy Workbench 指南
• Factor Strategy Workbench 验证记录
• 研究代理指南
• 策略研究指南
• 用户数据 API 指南
• 研究运行时指南
• 自主研究运行时发布清单
• 研究能力最终报告

研究工作台页面为 /workbench，其结构化接口为 /api/research/workbench，离线报告使用 workbench/index.html。

python3 scripts/validate_governance.py .
PYTHONPATH=src python3 -m pytest -q
python3 -m ruff check src tests scripts
python3 -m pip check
git diff --check