Option Desk

Option Desk

通过本地仪表盘、Agent 技能和 MCP 工具进行期权研究。 导入期权链，查看其 Greeks 和持仓情况，对比策略结构，并将结果保存为易读的文件。

目录

本页内容

• 查看工作台
• 快速开始
• 向 Agent 提问
• 遵循研究工作流
• 阅读文档
• 开发
• 许可

指南和 Wiki

• Wiki
• 架构和示意图
• 安装技能
• 用户指南
• 示例
• 安装
• 故障排除

查看工作台

仪表盘将期权链、模型假设和研究结果汇集在同一页面。 以下是当前本地仪表盘的截图，使用的是合成教学输入数据。 它们不是市场观察结果，也不能作为交易表现的依据。 截图详情区分了输入场景与截图日期。

仪表盘导览

打开图片可查看完整分辨率。完整图库包含各个面板和图表。 仪表盘指南介绍了如何阅读这些内容。

定位	波动率
检查假设的经销商敞口和链覆盖范围。	比较行权价和到期日，不隐藏缺失值。

结构收益	双到期日结构
同时查看各腿、盈亏平衡点和限制。	检查保留腿的估值假设。

模拟	回测
结合收敛诊断查看扇形图。	结合基准和模型局限性查看结果。

综合比较	合约阶梯
检查公式和模型之间的分歧。	比较敏感度和收益形态。

开始使用

选择一种方式：

你的起点	第一步	接下来
我想在没有数据账户的情况下试用	运行下方提供的示例。	首次体验指南
我使用 Claude Code 或 Codex	安装本地工具，然后连接插件。	Agent 工作流
我有 CSV 或 JSON 链数据	导入数据，并附上来源和时间戳。	数据导入
我想要一个基于浏览器的示例	打开托管示例。	托管连接

试用提供的示例

要求：Git 和 Python 3.11 或更高版本。 在 macOS 或 Linux 上运行以下命令：

git clone https://github.com/Iman/agent-driven-options-desk-and-skills.git
cd agent-driven-options-desk-and-skills
python3 -m venv .venv
. .venv/bin/activate
python -m pip install -e ./engine -e ./shell
optiondesk chain SYNTH --from-file examples/chain-synth.json --accept-data-rights --out-dir artifacts/tutorial
optiondesk greeks --out-dir artifacts/tutorial
optiondesk exposure --out-dir artifacts/tutorial
optiondesk compare --out-dir artifacts/tutorial
optiondesk dashboard --out-dir artifacts/tutorial

在同一台计算机上打开 **http://127.0.0.1:8787**。 选择 SYNTH 和 2026-10-08。 在终端中按 Ctrl+C 停止服务。结果文件会保留在 artifacts/tutorial 中。

提供的示例包含 62 个合成合约和固定的估值场景。 安装后无需外部数据提供方。 入门指南包含 Windows 激活方法、预期结果和后续步骤。 示例来源说明介绍了输入数据。

安装完整的本地交易工作台

在代码检出目录中运行：

./install.sh
optiondesk doctor

此操作会安装本地工具和技能，并尝试向其找到的受支持运行时 CLI 注册 MCP。 安装指南介绍路径、标志、Docker 和卸载。 仅安装插件并不会安装本地计算引擎。

如果已配置本地数据提供方，请运行完整演示：

./run.sh --symbols SPY

运行器会获取数据、生成研究产物、开立模拟持仓并提供仪表盘服务。 默认情况下，文件会写入 ~/TradingDesk/option-desk-demo。 使用 --dry-run 查看要执行的命令。 启用 Yahoo 访问前，请阅读数据提供方设置。

向你的 Agent 提问

在你的产品中安装技能

产品	安装选项
Codex	npx、手动复制、shell 安装程序或插件。
Claude Code	npx、手动复制、shell 安装程序或插件。
ChatGPT	如果账户支持 Skills，可单独上传托管技能；另有独立的 MCP 应用。
Claude chat	单独的托管技能 ZIP，以及自定义 MCP 连接器。

安装指南包含单技能和全部技能的命令、用户/项目范围、ZIP 准备步骤和连接检查。

连接本地工具后，询问：

Use examples/chain-synth.json, the supplied synthetic teaching sample.
I can use this file for private analysis.
Save the results under artifacts/tutorial.
Show its Greeks and positioning, then compare an iron condor with a straddle.
State the source, missing inputs, model assumptions, and degradation first.

你的需求	技能	示例
可用工具	desk-setup	检查我的 MCP 工具为何不可用。
合约敏感度	options-greeks	显示此链的 delta、gamma、theta 和 vega。
期权链持仓分布	options-positioning	显示 gamma 墙，并说明交易商符号假设。
多腿结构	options-strategy	按收益、亏损和希腊值比较这些结构。
远期分布	options-simulation	使用允许的历史数据模拟标的，并报告收敛情况。
历史研究	options-backtest	回测此结构，并说明基准和缺失的成本。

本地 MCP 服务提供 12 个工具。 托管服务支持较精简的工作流：快照验证、希腊值、持仓分布和策略图表。 模拟和回测仍是本地工作流。 请参阅 Agent 设置和提示词。

遵循研究工作流

步骤	操作	检查内容
1. 加载	导入期权链	来源、时间戳、到期日和缺失的输入数据。
2. 检查	计算希腊值和持仓分布。	单位、跳过计数和交易商符号假设。
3. 比较	构建结构	腿、盈亏平衡点、最大亏损和价差成本。
4. 探索时间	比较两个到期日	临近到期估值和扫描限制。
5. 研究历史	模拟或回测	收敛情况、基准、不确定性和未计入的成本。
6. 记录	创建模拟持仓	计划、论点、后续估值和不可用的报价。

仪表板读取已保存的产物。打开页面时，它不会获取新数据。 相关命令和仪表板请使用相同的 --out-dir。 结果指南说明了如何解读每个阶段。

阅读文档

指南	用途
用户指南主页	选择一项任务，并按照步骤完成。
安装参考	适用于本地、插件、仅技能、托管和容器使用的 8 种安装方式。
仪表板导览	查看各面板，并找出缺失的计算结果。
示例	可复制的命令和预期结果。
故障排除	安装、提供方、导入和图表问题。
常见问题	常见问题和解读限制。
功能	功能和接口目录。
主算法	为技能、循环、图路由、提示词、回测和模拟测试提供的一份伪代码参考。
架构	软件包、数据流、契约、当前图表和保留的设计参考。
保留的项目参考	完整的早期 README，包含工程细节、测量结果和示例。
API 清单	生成的公共函数和类参考。
文档索引	所有指南、政策和维护参考。

项目收录平台

平台	链接	状态
官方 MCP Registry	com.avidquant/optiondesk	于 2026-09-11 发布。托管端点的远程条目，域名已验证。
Smithery	iman-samizadeh/option-desk	于 2026-09-11 收录。托管端点，已扫描 13 个工具，TXT 记录已验证。
Glama 服务	Iman/agent-driven-options-desk-and-skills	从代码仓库建立索引，列出 12 个本地工具。
Glama 连接器	com.avidquant.optiondesk/option-desk	托管端点，于 2026-09-11 收录，经 Glama 健康检查，包含 13 个工具。
Claude Code 和 Codex 市场	本代码仓库：/plugin marketplace add Iman/agent-driven-options-desk-and-skills	本地插件 option-desk 和托管插件 option-desk-hosted。
托管示例	optiondesk.avidquant.com，MCP 位于 /mcp	合成 SYNTH 数据，无需账号。
LinkedIn 文章	我打造了一个 Agent 可驱动的期权交易台	于 2026-09-10 发布。
dev.to	dev.to/imansamizadeh	文章的转载版本，规范链接指向 LinkedIn，首周后发布。

目录中的条目描述的是所示日期时的托管端点或代码仓库。各目录的平台页面由对应目录维护，不在此代码仓库中维护。

开发

测试与覆盖率涵盖正常和失败路径、BDD 场景、集成检查，以及每个软件包 80% 的单元测试行覆盖率门槛。

安装开发依赖后，从仓库根目录运行。 有关环境设置和截图捕获，请参阅开发。

python -m pytest engine/tests -q    # 355 tests
python -m pytest shell/tests -q     # 574 tests
python -m pytest agent/tests -q     # 161 tests
python -m pytest -q                # 1090 tests

这些是集合计数，并不表示此次文档编辑运行了所有测试。 工作流徽章链接到实际的 CI 结果。

python3 scripts/refresh.py --no-index
python3 scripts/mutate.py --list

完整运行包含十个阶段，会重建生成的文档和软件包、检查已记录的证据，并运行测试套件和仓库规则。 变异测试框架定义了九十九个变异。请根据其输出区分检测到的变更、存活的变异和跳过的案例。

shell/src/optiondesk/contracts/ 下的八个架构定义了工件接口：八个架构 + 验证器。 有关它们的作用，请参阅架构指南。

历史记录示例

证据记录将较早的链路测量固定为 2026-08-30T14:12:17+00:00。 其中记录了 607 contracts, spot, listed expiries 和 595 solved, 12 refused as unidentified。 这些是历史证据字符串，并非示例或当前截图的计数。 记录器会在此保留这些内容，以满足现有文档检查。

贡献 · 待办事项 · 变更日志 · 安全

许可

本仓库使用 PolyForm Noncommercial 1.0.0。 该软件可获取源代码，并可免费用于非商业用途。 商业用途需要另行签订书面协议。请参阅 LICENSES.md。 软件许可证不授予使用提供方数据的权利。

研究软件。不下单。模型结果不代表成交、建议或投资建议。 请阅读免责声明、隐私政策和第三方声明。