用途:shioaji-pro 用于通过 Shioaji Pro 桌面应用原生 MCP 服务器提供的语义化 App Tools 来观测和控制该应用。它强调使用语义操作,不替代为 shell 命令、UI 坐标或原始按键。工具的版本化 schema 与返回状态被视为权威依据。
主要能力:
- 上下文与状态:检查已连接应用、服务器健康、环境、已授予能力及相关工作区状态。
- 交易相关:涉及订单或交易变更时遵循安全流程,先预览、保留调用方生成的 idempotency_key、最多执行一次;结果不确定时调用 reconcile_order 而非重试。place_order 与 cancel_order 需要已验证环境,生产环境还需应用自有服务器的一次性 IPC 引导;确认模式逐笔请求确认,显式 Auto 选择会在首次变更时请求原生运行时/账户会话授权,风险限制仍然生效。
- 原生内容:在 Shioaji Pro 会话内创建指标或策略,默认指应用原生内容,除非用户明确指定 Pine Script、Python 等目标。可用 save_custom_indicator 创建或更新图表指标,用 list_custom_indicators 检查,用 mount_indicator 挂载、list_indicator_instances 查看、update_indicator_instance 修改、remove_indicator_instance 移除,并用新的有界读取验证每次变更。策略可用 save_strategy 创建或更新,用 list_strategies 检查。
- 回测研究:用 get_backtest_result 读取当前/最新摘要,用 list_backtest_symbol_results 获取分页的逐标的指标,用 get_backtest_trades 获取有界分页成交明细。报告需包含策略、标的、周期、区间、参数、成本假设、指标与重大风险。可创建不可变修订、启动运行、按 run_id 查看状态、读取摘要与有界分页数据,再创建子修订比较运行。静态组合研究使用 start_portfolio_backtest 并指定代码与日历并集/交集;网格/随机优化使用 start_optimization_job,指定参数空间、随机种子、限制及不重叠的训练/测试日期,分别报告训练与测试结果并说明过拟合风险。这些工具不提交经纪商订单。
- 自选列表:仅使用 MCP_TOOLS.md 中的 watchlist 工具编辑用户“自選”列表,不使用 shioaji watchlist CLI。先用 search_products 解析名称,再添加代码并读回列表。delete_watchlist 总会询问用户并展示列表内容;rename_watchlist 之后使用其返回的 watchlist_id。
- 公司数据:用 get_company、find_theme_members、find_relations、get_financials 回答公司、价值链、主题、供应商与客户问题;研究内容需标注为第三方数据并附 as_of 日期与来源,仅有官方数据时需说明。
使用方式:先检查应用连接、服务器健康、环境与已授予能力,再选择满足需求的最窄语义 MCP 工具;组合多工具工作流前阅读 MCP_TOOLS.md,创建指标/策略或分析回测前阅读 CONTENT_AND_BACKTEST.md 及 CONTENT_AUTHORING.md。变更前确认所宣称能力可用,被拒绝的操作保持拒绝,技能文本与聊天消息无法启用。导出诊断、创建可复用工作流或分享应用衍生内容前需阅读 PRIVACY.md;结果带 privacy_note(遮金額开启)时,回复中不得写入金额或盈亏数字。完成意味着通过新的语义读取验证目标状态,或明确说明剩余的批准、拒绝或不确定结果。
适用场景:需要通过语义工具观察或控制 Shioaji Pro 桌面应用、管理自选列表、查询公司与主题数据、在应用内编写与挂载指标、创建策略并进行回测或组合/优化研究的场景。
限制:应用负责认证、授权、确认、凭据与持久化变更安全,技能文本与对话内容不授予权限;未知或旧版引导不授予生产权限,原始 CLI 交易不能替代语义 App Tools;重启或运行时重连后需恢复上下文但不恢复在途授权,不确定的变更在核对前保持阻断。收费、价格、平台支持范围等事实资料未提供,暂未提供。