安装与环境#

FinHJB 最先要回答的通常不是方程怎么写，而是应该装发布版 package 还是整个仓库。

下游项目优先装发布版。需要 BCW 示例、源码树或 finhjb-model-coder 时，再切到仓库源码。

先选安装模式#

发布版 Python 包#

如果你在自己的项目里使用 FinHJB，而且不依赖仓库里的 BCW 示例脚本，这就是正确路径。

uv add finhjb

pip install finhjb

仓库源码 checkout#

如果你要做下面这些事，就应该使用仓库源码：

  • 运行 src/example/BCW2011Liquidation.py

  • 运行 src/example/BCW2011Refinancing.py

  • 运行 src/example/BCW2011Hedging.py

  • 运行 src/example/BCW2011CreditLine.py

  • 阅读或修改源码

  • 从当前仓库安装并开发 finhjb-model-coder skill

在仓库根目录执行：

uv sync
uv run python -c "import finhjb as fjb; print(fjb.__all__[:5])"

如果你在服务器或没有图形界面的环境里运行，再加上：

export MPLBACKEND=Agg

仓库专用材料#

发布到 PyPI 的 wheel 不包含这些仓库内文件：

  • src/example/BCW2011Liquidation.py

  • src/example/BCW2011Refinancing.py

  • src/example/BCW2011Hedging.py

  • src/example/BCW2011CreditLine.py

  • skills/finhjb-model-coder/

如果你的任务依赖这些文件，就不要只装发布版包。

在要求 finhjb-model-coder 交付可运行代码之前#

Skill 和 Python 包是两个独立对象。只有环境已经可用时，Skill 才能诚实地交付“可运行代码”。

在要求 Codex 交付“可运行代码”之前，先按下面的清单确认：

  • 如果任务依赖仓库示例或测试夹具，优先使用仓库源码和仓库 uv 环境；

  • 如果任务属于你自己的下游项目，请在那个项目里安装 finhjb，用 uv add finhjb 或 pip install finhjb；

  • 在正式交付前，先跑一个 smoke test，例如 python -c "import finhjb" 或 uv run python -c "import finhjb"。

如果 smoke test 失败，正确的下一步是先解决环境，而不是继续生成代码。

相关页面#