1. 项目定位与用途
Stonkfly 是面向神经科学与强化学习交叉研究的实验性命令行工具，核心定位是以全保留生物连接组作为可编程控制器，验证生物神经网络驱动金融交易决策的可行性，不提供盈利承诺，仅作为开源实验载体供研究者复现与验证相关假设。
项目档案开源项目
nftechie/stonkfly 是什么？用途、安装与使用指南
nftechie/stonkfly：Stonkfly 是一款实验性命令行工具，以果蝇 MaleCNS 全保留连接组作为神经网络控制器，结合 Coinbase AgentKit 执行本页整理它解决什么问题、适用场景、安装方式和使用方法。
AI 总结
Stonkfly 是一款实验性命令行工具，以果蝇 MaleCNS 全保留连接组作为神经网络控制器，结合 Coinbase AgentKit 执行受严格限制的加密货币现货交易，为神经科学与强化学习交叉研究提供可运行实验载体。
中文项目介绍
Stonkfly 是面向神经科学与强化学习交叉研究的开源实验性命令行工具，核心定位是以全保留生物连接组作为可编程控制器，验证生物神经网络驱动金融交易决策的可行性。
技术实现上，它将 Coinbase 公开的 BTC-USDC 1分钟K线数据渲染为320×180 RGB 感官图像，输入包含 166,700 神经元、2558万条连接的脉冲神经网络，通过工程化多巴胺强化信号调整突触连接，最终由固定神经读出层输出买/卖/持有决策，经 Coinbase AgentKit 执行受严格限制的现货交易。
运行层面默认以100 USDC 模拟余额运行模拟盘，无需 API 密钥，运行日志、感官图像、可恢复脑状态默认保存在 runs/paper/ 目录，支持 Ctrl-C 停止后断点恢复。实盘交易需单独配置 Coinbase Advanced 的 ECDSA API 密钥，且仅支持最多100 USDC 的小资金实验，项目明确未验证盈利性，风险极高。
详细信息与使用说明
2. 解决的问题
它解决的是“如何将高保真生物连接组模拟与真实金融交易执行链路结合”的实验验证问题，避免了传统神经网络交易策略的黑盒特性，为研究生物神经动力学与强化学习信号的交互作用提供了可运行的端到端实验框架，同时明确了工程化强化信号与生物生理模型的边界。
3. 适用场景
适用场景包括：果蝇 MaleCNS 连接组神经动力学模拟研究、加密货币模拟盘交易实验、受严格安全限制的小资金加密货币实盘交易实验、生物神经网络驱动交易决策的可行性验证，以及神经科学与强化学习交叉领域的教学与实验研究。
4. 安装方式
环境要求为 Python 3.11、C++17 编译器（macOS 用 clang++、Linux 用 GCC/Clang）、macOS/Linux 系统，推荐 16GB 内存，预留数 GB 存储空间用于数据集与依赖。安装步骤为：执行 python3.11 -m venv .venv 创建虚拟环境并激活，再执行 pip install -e '.[test]' 安装项目核心依赖与测试依赖。
5. 使用方式
默认模拟盘运行无需 API 密钥，先执行 python -m stonkfly prepare 下载约1.1GB上游数据、验证并构建完整连接组，再执行 python -m stonkfly run 启动，运行日志、感官图像、可恢复脑状态默认保存在 runs/paper/ 目录，Ctrl-C 可停止，再次执行相同命令可断点恢复。实盘交易需先将 .env.example 复制为 .env，填入 Coinbase Advanced 的 ECDSA API 密钥（仅 View+Trade 权限、无 Transfer 权限），先执行 python -m stonkfly run --live --preflight-only 完成预检，再执行 python -m stonkfly run --live 启动实盘。还可执行 python -m stonkfly status 查看运行状态，pytest -q 运行测试用例。
思维导图
当前仓库信息不足，或结构不够稳定，暂时没有生成可靠的思维导图。
常见问题
nftechie/stonkfly 是做什么的？
Stonkfly 是一款实验性命令行工具，以果蝇 MaleCNS 全保留连接组作为神经网络控制器，结合 Coinbase AgentKit 执行受严格限制的加密货币现货交易，为神经科学与强化学习交叉研究提供可运行实验载体。
nftechie/stonkfly 适合用在什么场景？
Stonkfly 是面向神经科学与强化学习交叉研究的实验性命令行工具，核心定位是以全保留生物连接组作为可编程控制器，验证生物神经网络驱动金融交易决策的可行性，不提供盈利承诺，仅作为开源实验载体供研究者复现与验证相关假设。
nftechie/stonkfly 如何安装？
环境要求为 Python 3.11、C++17 编译器（macOS 用 clang++、Linux 用 GCC/Clang）、macOS/Linux 系统，推荐 16GB 内存，预留数 GB 存储空间用于数据集与依赖。安装步骤为：执行 python3.11 -m venv .venv 创建虚拟环境并激活，再执行 pip install -e '.[test]' 安装项目核心依赖与测试依赖。
nftechie/stonkfly 如何开始使用？
默认模拟盘运行无需 API 密钥，先执行 python -m stonkfly prepare 下载约1.1GB上游数据、验证并构建完整连接组，再执行 python -m stonkfly run 启动，运行日志、感官图像、可恢复脑状态默认保存在 runs/paper/ 目录，Ctrl-C 可停止，再次执行相同命令可断点恢复。实盘交易需先将 .env.example 复制为 .env，填入 Coinbase Advanced 的 ECDSA API 密钥（仅 View+Trade 权限、无 Transfer 权限），先执行 python -m stonkfly run --live --preflight-only 完成预检，再执行 python -m stonkfly run --live 启动实盘。还可执行 python -m stonkfly status 查看运行状态，pytest -q 运行测试用例。