使用文档

Factor Class Open

Factor Class Open 使用文档

公开文档不需要注册或登录。先完成客户端安装和授权，再用 Python SDK 或 Codex/Claude Code 驱动底层因子能力。

客户端安装与授权

下载代码后在本地安装 Python 包，设置平台地址和 license key，再激活当前设备。

python3 -m venv .venv
source .venv/bin/activate
python -m pip install -U pip
python -m pip install -e .

export FACTOR_CLASS_OPEN_STATE_DIR="$PWD/.factor-class-open-state"
export FCO_PLATFORM_URL="https://platform.example.com"
export FCO_LICENSE_KEY="<your_fco_license_key>"

factorctl license activate \
  --server-url "$FCO_PLATFORM_URL" \
  --license-key "$FCO_LICENSE_KEY" \
  --release-tag runtime-v0.1.1
factorctl doctor

Python SDK 操作手册

工程能力强的用户直接在 Python 里初始化授权，然后调用公开 SDK 的 D1、unary、plan 和组合因子能力。

import os
import factor_class_open as fco

fco.init(
    platform_url=os.environ["FCO_PLATFORM_URL"],
    license_key=os.environ["FCO_LICENSE_KEY"],
)

print(fco.status()["status"])
print(fco.d1_stat([1.0, 2.0, 3.0], "SUM"))
print(fco.unary([1.0, 3.0, 2.0], "hi", 2))
print(fco.plan()["run_id"])

自由组合因子示例

用户可以通过程序组合基础指标、周期、日汇总、unary 操作和回测输出，形成可复现的因子 recipe。

spec = (
    fco.factor("RSI")
    .periods([7, 14, 28])
    .timeframe("M30")
    .zscore_bars(12)
    .daily_aggregate(["STD"])
    .unary(["hi", "lo"], windows=[3])
    .name("rsi_std_unary_demo")
)

result = spec.run(bars, returns=forward_returns)
report = result.backtest()
report.save_return_curve("rsi_std_unary_demo.svg")
print(result.summary())
print(report.summary())

Codex / Claude Code 低代码操作手册

工程能力弱的用户可以把下面这段任务说明交给 Codex 或 Claude Code，让它按公开 SDK 生成和运行因子探索脚本。

你在 factor-class-open 客户端项目中工作。
只使用 factor_class_open 公开 SDK 和 examples 里的公开示例。
先检查 FCO_PLATFORM_URL、FCO_LICENSE_KEY 和 factorctl doctor。
然后基于本地 OHLCV 数据，组合 RSI/DPO/MOMENTUM 等指标、周期、D1 聚合和 unary 操作。
输出因子 summary、IS/OOS 指标、收益曲线 SVG，并说明 factor recipe。
不要读取私有路径、不要写入真实 license key、不要调用兄弟项目源码。