{"id":"81392f2c-7933-43c4-b139-74eff6306406","entityType":"agent","slug":"clawhub-fosunwealth-fw-tradings","name":"FW-trading","canonicalUrl":"https://www.xpersona.co/agent/clawhub-fosunwealth-fw-tradings","canonicalPath":"/agent/clawhub-fosunwealth-fw-tradings","generatedAt":"2026-10-10T04:26:43.106Z","source":"CLAWHUB","claimStatus":"UNCLAIMED","verificationTier":"NONE","summary":{"evidence":{"source":"CLAWHUB","verified":false,"confidence":"medium","updatedAt":"2026-10-09T23:20:40.243Z","emptyReason":null},"description":"复星财富（Fosun Wealth）港美股 OpenAPI 交易总入口 skill：统一管理共享凭证 `fosun.env`（生成/修复/备份恢复），并在实盘与模拟盘间路由执行账户、资金、持仓、流水、行情、下单/撤单/改单等能力；全局单凭证 `FOSUN_ENV_PATH`，变更操作强制二次确认并遵循单步执行。","descriptionLabel":"Source description","evidenceSummary":"Capability contract not published. No trust telemetry is available yet. 1.9K downloads reported by the source. Last updated 10/9/2026.","installCommand":"clawhub skill install s17d9jjcms1p4gnm03jd0n7qfn83mhrs:fw-tradings","sourceUrl":"https://clawhub.ai/fosunwealth/fw-tradings","homepage":"https://clawhub.ai/fosunwealth/skills/fw-tradings","primaryLinks":[{"label":"View on ClawHub","url":"https://clawhub.ai/fosunwealth/fw-tradings","kind":"source"},{"label":"Homepage","url":"https://clawhub.ai/fosunwealth/skills/fw-tradings","kind":"homepage"}],"safetyScore":84,"overallRank":62,"popularityScore":48,"trustScore":null,"claimedByName":null,"isOwner":false,"seoDescription":"FW-trading technical dossier on Xpersona with agent coverage, OPENCLEW support, and live trust metadata."},"coverage":{"evidence":{"source":"public-profile","verified":false,"confidence":"medium","updatedAt":"2026-10-09T23:20:40.243Z","emptyReason":null},"protocols":[{"protocol":"OPENCLEW","label":"OpenClaw","status":"self-declared","notes":"Declared in the public agent profile."}],"capabilities":[],"verifiedCount":0,"selfDeclaredCount":1,"capabilityMatrix":{"rows":[{"key":"OPENCLEW","type":"protocol","support":"unknown","confidenceSource":"profile","notes":"Listed on profile"}],"flattenedTokens":"protocol:OPENCLEW|unknown|profile"}},"adoption":{"evidence":{"source":"CLAWHUB","verified":false,"confidence":"medium","updatedAt":"2026-10-09T23:20:40.243Z","emptyReason":null},"stars":null,"forks":null,"downloads":1897,"packageName":null,"latestVersion":"2.0.3","tractionLabel":"1.9K downloads"},"release":{"evidence":{"source":"CLAWHUB","verified":false,"confidence":"medium","updatedAt":"2026-10-09T23:20:40.243Z","emptyReason":null},"lastUpdatedAt":"2026-10-09T23:20:40.243Z","lastCrawledAt":"2026-10-09T23:20:40.243Z","lastIndexedAt":null,"nextCrawlAt":"2026-10-10T23:20:40.243Z","lastVerifiedAt":null,"highlights":[{"version":"2.0.3","createdAt":"2026-06-18T13:01:30.366Z","changelog":"fw-tradings v2.0.3 - 新增 real-trade-skill 与 moni-trade-skill 子目录的 install.ps1 安装脚本与 real-trade-skill/_meta.json 元数据文件。 - 移除 skill-card.md。 - 规范化子目录结构，提升实盘与模拟盘模块的独立性和安装兼容性。 - 文档未发生重要变动，仅目录和技能结构微调。","fileCount":90,"zipByteSize":200582},{"version":"2.0.2","createdAt":"2026-06-12T12:40:25.986Z","changelog":"**Changelog for fw-tradings v2.0.2** - Major refactor: credential management and install flow are fully delegated to the fosun-env-setup subskill. - Added composition install script (`install.sh`) for unified environment setup across all subskills. - Integrated detailed credential flow documentation and scripts within the fosun-env-setup directory. - Updated documentation to clarify that the main skill no longer directly manages credentials, routes, or install instructions—those are now centralized in the subskill. - Cleaned up repository by removing obsolete install scripts, individual READMEs, and pending/metadata files. - Improved modularity: real-trade and moni-trade skills strictly handle their own logic with no credential duplication.","fileCount":87,"zipByteSize":193953},{"version":"2.0.1","createdAt":"2026-05-18T08:44:12.558Z","changelog":"fw-trade-skill 1.0.8 - No code changes detected in this version. - Documentation (SKILL.md) has been updated with minor adjustments or clarifications.","fileCount":84,"zipByteSize":183414},{"version":"1.0.7","createdAt":"2026-05-18T08:33:42.787Z","changelog":"**fw-tradings v1.0.7 — Major Skill Restructure with Unified Credential and Routing** - Switched to a single unified skill (`fw-trade-skill`) as the total entry point: now all credential management and routing is handled centrally. - All credential initialization, verification, repair, and backup are managed by the new `fosun-env-setup` subskill; business logic is now split between `real-trade-skill` (for live trading) and `moni-trade-skill` (for simulation trading). - Legacy skills and scripts have been removed; new directory and skill structure consolidates all modules under a single shared `fosun.env` file, always located by a global `FOSUN_ENV_PATH` variable. - Added strict routing: user must explicitly choose between live and simulated trading before any account or transaction operation. - Major update to execution flow: every step enforces user confirmation, step-by-step credential checks, and strict non-inference of account or market parameters. - Skill documentation updated to enforce strict credential handling, no default path hard","fileCount":83,"zipByteSize":181804},{"version":"1.0.6","createdAt":"2026-04-02T15:26:12.792Z","changelog":"fw-tradings 1.0.6 - 更新 skill 描述，更加突出“复星集团/复星财富官方 OpenAPI”定位。 - 补充说明：需通过星财富 APP 完成证券账户开户后方可体验。 - 技能名称、描述等元数据（SKILL.md）微调，代码与功能无变化。","fileCount":52,"zipByteSize":125885},{"version":"1.0.5","createdAt":"2026-04-02T11:35:23.479Z","changelog":"Version 1.0.5 of fw-tradings - No file changes detected in this release. - No feature, bug fix, or documentation updates noted compared to the previous version.","fileCount":52,"zipByteSize":125811},{"version":"1.0.4","createdAt":"2026-03-26T12:04:26.092Z","changelog":"- Documentation structure changed: all SKILL.md files for sub-skills replaced by consolidated Markdown files in the main directory. - Added new documentation files: fosun-account.md, fosun-market-data.md, fosun-order-modify.md, fosun-orders.md, fosun-sdk-setup/fosun-sdk-setup.md, fosun-trading/fosun-trading.md. - Removed old documentation files: SKILL.md files under each subdirectory. - Updated the main skill README to reference the new documentation structure and file names. - No changes to functional logic; this update is documentation organization only.","fileCount":52,"zipByteSize":125811},{"version":"1.0.3","createdAt":"2026-03-21T15:51:39.082Z","changelog":"- 项目英文名由 “fosun-skills” 统一调整为“fw-tradings” - 全部文档项目信息、目录与标记同步为新 Skill 名 - 相关 SKILL.md 文件（主 skill 及所有子 skill）名称和描述保持一致更新 - 代码/凭证/交易功能未做结构调整，主要为品牌统一和描述同步优化 - 不涉及接口、功能或业务规则调整","fileCount":52,"zipByteSize":125840}]},"execution":{"evidence":{"source":"CLAWHUB","verified":false,"confidence":"low","updatedAt":null,"emptyReason":"No published capability contract is available yet."},"installCommand":"clawhub skill install s17d9jjcms1p4gnm03jd0n7qfn83mhrs:fw-tradings","setupComplexity":"low","setupSteps":["Install using `clawhub skill install s17d9jjcms1p4gnm03jd0n7qfn83mhrs:fw-tradings` in an isolated environment before connecting it to live workloads.","No published capability contract is available yet, so validate auth and request/response behavior manually.","Review the upstream CLAWHUB listing at https://clawhub.ai/fosunwealth/fw-tradings before using production credentials."],"contract":{"contractStatus":"missing","authModes":[],"requires":[],"forbidden":[],"supportsMcp":false,"supportsA2a":false,"supportsStreaming":false,"inputSchemaRef":null,"outputSchemaRef":null,"dataRegion":null,"contractUpdatedAt":null,"sourceUpdatedAt":null,"freshnessSeconds":null},"invocationGuide":{"preferredApi":{"snapshotUrl":"https://www.xpersona.co/api/v1/agents/clawhub-fosunwealth-fw-tradings/snapshot","contractUrl":"https://www.xpersona.co/api/v1/agents/clawhub-fosunwealth-fw-tradings/contract","trustUrl":"https://www.xpersona.co/api/v1/agents/clawhub-fosunwealth-fw-tradings/trust"},"curlExamples":["curl -s \"https://www.xpersona.co/api/v1/agents/clawhub-fosunwealth-fw-tradings/snapshot\"","curl -s \"https://www.xpersona.co/api/v1/agents/clawhub-fosunwealth-fw-tradings/contract\"","curl -s \"https://www.xpersona.co/api/v1/agents/clawhub-fosunwealth-fw-tradings/trust\""],"jsonRequestTemplate":{"query":"summarize this repo","constraints":{"maxLatencyMs":2000,"protocolPreference":["OPENCLEW"]}},"jsonResponseTemplate":{"ok":true,"result":{"summary":"...","confidence":0.9},"meta":{"source":"CLAWHUB","generatedAt":"2026-10-10T04:26:43.101Z"}},"retryPolicy":{"maxAttempts":3,"backoffMs":[500,1500,3500],"retryableConditions":["HTTP_429","HTTP_503","NETWORK_TIMEOUT"]}},"endpoints":{"dossierUrl":"https://www.xpersona.co/api/v1/agents/clawhub-fosunwealth-fw-tradings/dossier","snapshotUrl":"https://www.xpersona.co/api/v1/agents/clawhub-fosunwealth-fw-tradings/snapshot","contractUrl":"https://www.xpersona.co/api/v1/agents/clawhub-fosunwealth-fw-tradings/contract","trustUrl":"https://www.xpersona.co/api/v1/agents/clawhub-fosunwealth-fw-tradings/trust"}},"reliability":{"evidence":{"source":"runtime-metrics","verified":false,"confidence":"low","updatedAt":null,"emptyReason":"No trust, reliability, or runtime telemetry is available."},"trust":{"status":"unavailable","handshakeStatus":"UNKNOWN","verificationFreshnessHours":null,"reputationScore":null,"p95LatencyMs":null,"successRate30d":null,"fallbackRate":null,"attempts30d":null,"trustUpdatedAt":null,"trustConfidence":"unknown","sourceUpdatedAt":null,"freshnessSeconds":null},"decisionGuardrails":{"doNotUseIf":["Contract metadata is missing or unavailable for deterministic execution."],"safeUseWhen":[],"riskFlags":["missing_or_unavailable_contract","trust_data_unavailable","schema_references_missing"],"operationalConfidence":"low"},"executionMetrics":{"observedLatencyMsP50":null,"observedLatencyMsP95":null,"estimatedCostUsd":null,"uptime30d":null,"rateLimitRpm":null,"rateLimitBurst":null,"lastVerifiedAt":null,"verificationSource":null},"runtimeMetrics":{"successRate":null,"avgLatencyMs":null,"avgCostUsd":null,"hallucinationRate":null,"retryRate":null,"disputeRate":null,"p50Latency":null,"p95Latency":null,"lastUpdated":null}},"benchmarks":{"evidence":{"source":"no-benchmark-data","verified":false,"confidence":"low","updatedAt":null,"emptyReason":"No benchmark suites or observed failure patterns are available."},"suites":[],"failurePatterns":[]},"artifacts":{"evidence":{"source":"CLAWHUB","verified":false,"confidence":"medium","updatedAt":"2026-10-09T23:20:40.243Z","emptyReason":null},"readme":"Skill: FW-trading\n\nOwner: fosunwealth\n\nSummary: 复星财富（Fosun Wealth）港美股 OpenAPI 交易总入口 skill：统一管理共享凭证 `fosun.env`（生成/修复/备份恢复），并在实盘与模拟盘间路由执行账户、资金、持仓、流水、行情、下单/撤单/改单等能力；全局单凭证 `FOSUN_ENV_PATH`，变更操作强制二次确认并遵循单步执行。\n\nTags: latest:2.0.3\n\nVersion history:\n\nv2.0.3 | 2026-06-18T13:01:30.366Z | user\n\nfw-tradings v2.0.3\n\n- 新增 real-trade-skill 与 moni-trade-skill 子目录的 install.ps1 安装脚本与 real-trade-skill/_meta.json 元数据文件。\n- 移除 skill-card.md。\n- 规范化子目录结构，提升实盘与模拟盘模块的独立性和安装兼容性。\n- 文档未发生重要变动，仅目录和技能结构微调。\n\nv2.0.2 | 2026-06-12T12:40:25.986Z | user\n\n**Changelog for fw-tradings v2.0.2**\n\n- Major refactor: credential management and install flow are fully delegated to the fosun-env-setup subskill.\n- Added composition install script (`install.sh`) for unified environment setup across all subskills.\n- Integrated detailed credential flow documentation and scripts within the fosun-env-setup directory.\n- Updated documentation to clarify that the main skill no longer directly manages credentials, routes, or install instructions—those are now centralized in the subskill.\n- Cleaned up repository by removing obsolete install scripts, individual READMEs, and pending/metadata files.\n- Improved modularity: real-trade and moni-trade skills strictly handle their own logic with no credential duplication.\n\nv2.0.1 | 2026-05-18T08:44:12.558Z | user\n\nfw-trade-skill 1.0.8\n\n- No code changes detected in this version.\n- Documentation (SKILL.md) has been updated with minor adjustments or clarifications.\n\nv1.0.7 | 2026-05-18T08:33:42.787Z | user\n\n**fw-tradings v1.0.7 — Major Skill Restructure with Unified Credential and Routing**\n\n- Switched to a single unified skill (`fw-trade-skill`) as the total entry point: now all credential management and routing is handled centrally.\n- All credential initialization, verification, repair, and backup are managed by the new `fosun-env-setup` subskill; business logic is now split between `real-trade-skill` (for live trading) and `moni-trade-skill` (for simulation trading).\n- Legacy skills and scripts have been removed; new directory and skill structure consolidates all modules under a single shared `fosun.env` file, always located by a global `FOSUN_ENV_PATH` variable.\n- Added strict routing: user must explicitly choose between live and simulated trading before any account or transaction operation.\n- Major update to execution flow: every step enforces user confirmation, step-by-step credential checks, and strict non-inference of account or market parameters.\n- Skill documentation updated to enforce strict credential handling, no default path hard\n\nv1.0.6 | 2026-04-02T15:26:12.792Z | user\n\nfw-tradings 1.0.6\n\n- 更新 skill 描述，更加突出“复星集团/复星财富官方 OpenAPI”定位。\n- 补充说明：需通过星财富 APP 完成证券账户开户后方可体验。\n- 技能名称、描述等元数据（SKILL.md）微调，代码与功能无变化。\n\nv1.0.5 | 2026-04-02T11:35:23.479Z | user\n\nVersion 1.0.5 of fw-tradings\n\n- No file changes detected in this release.\n- No feature, bug fix, or documentation updates noted compared to the previous version.\n\nv1.0.4 | 2026-03-26T12:04:26.092Z | user\n\n- Documentation structure changed: all SKILL.md files for sub-skills replaced by consolidated Markdown files in the main directory.\n- Added new documentation files: fosun-account.md, fosun-market-data.md, fosun-order-modify.md, fosun-orders.md, fosun-sdk-setup/fosun-sdk-setup.md, fosun-trading/fosun-trading.md.\n- Removed old documentation files: SKILL.md files under each subdirectory.\n- Updated the main skill README to reference the new documentation structure and file names. \n- No changes to functional logic; this update is documentation organization only.\n\nv1.0.3 | 2026-03-21T15:51:39.082Z | auto\n\n- 项目英文名由 “fosun-skills” 统一调整为“fw-tradings”\n- 全部文档项目信息、目录与标记同步为新 Skill 名\n- 相关 SKILL.md 文件（主 skill 及所有子 skill）名称和描述保持一致更新\n- 代码/凭证/交易功能未做结构调整，主要为品牌统一和描述同步优化\n- 不涉及接口、功能或业务规则调整\n\nv1.0.2 | 2026-03-20T16:58:32.477Z | user\n\n- 拆分原有 trading skill，新增 fosun-account、fosun-market-data、fosun-orders、fosun-order-modify 四个交易与查询子技能，各自文档独立。\n- fosun-trading skill 重新定位为通用配置与规则说明，不再直接承载交易脚本。\n- 新增账户管理（资金/持仓/流水）、行情查询、下单/改单/撤单三大功能模块，覆盖港美A股市场，结构清晰。\n- 强化所有子技能必须逐字引用数值、加粗关键数值、明示单位的数据准确性强制规则。\n- 文档全面更新，所有核心交易工作流、市场支持、订单类型及安全要求更加规范和细化。\n\nv1.0.1 | 2026-03-20T15:47:40.148Z | user\n\nVersion 1.0.1 (fw-tradings)\n\n- No changes detected in this version.\n- Content, features, and usage remain the same as the previous release.\n\nv1.0.0 | 2026-03-20T12:08:32.277Z | user\n\n- Initial release of Fosun Wealth OpenAPI skill set, covering SDK setup and securities trading modules.\n- Supports SDK installation, credential management, market data queries, funds/holdings lookup, order placement and management for HK/US/A-share Connect stocks.\n- Provides command-line scripts for key trading actions: price inquiry, bid/ask, account funds, order placement, order listing, and cancellation.\n- Options trading and market data are not currently supported; all options-related scripts and parameters are disabled in this version.\n- Enforces strict credential and environment checks before portfolio or trading queries.\n- Requires use of a dedicated Python virtual environment and secure credential management via a workspace-local fosun.env file.\n\nArchive index:\n\nArchive v2.0.3: 90 files, 200582 bytes\n\nFiles: _meta.json (130b), fosun-env-setup/code/api_key_check.py (3443b), fosun-env-setup/code/credential_scenarios.py (9152b), fosun-env-setup/code/ensure_fosun_env.py (54790b), fosun-env-setup/code/generate_fosun_env.py (5224b), fosun-env-setup/code/qr_artifact.py (3407b), fosun-env-setup/reference/credential-management-flow.md (5864b), fosun-env-setup/scripts/gen_access_url.py (7030b), fosun-env-setup/SKILL.md (10570b), install.sh (8512b), moni-trade-skill/_meta.json (364b), moni-trade-skill/code/_client.py (73554b), moni-trade-skill/code/_traps.py (2536b), moni-trade-skill/code/account_list.py (3158b), moni-trade-skill/code/buy.py (218b), moni-trade-skill/code/cancel_order.py (177b), moni-trade-skill/code/cancel.py (189b), moni-trade-skill/code/cash_flows.py (2324b), moni-trade-skill/code/cash_summary.py (1902b), moni-trade-skill/code/check_shared_env.py (3442b), moni-trade-skill/code/create_order.py (177b), moni-trade-skill/code/get_cash.py (186b), moni-trade-skill/code/get_holdings.py (172b), moni-trade-skill/code/holdings.py (3101b), moni-trade-skill/code/list_orders.py (181b), moni-trade-skill/code/market_broker_list.py (1104b), moni-trade-skill/code/market_kline.py (1868b), moni-trade-skill/code/market_min.py (1117b), moni-trade-skill/code/market_orderbook.py (1142b), moni-trade-skill/code/market_quote.py (1549b), moni-trade-skill/code/market_tick.py (1243b), moni-trade-skill/code/modify_order.py (177b), moni-trade-skill/code/modify.py (189b), moni-trade-skill/code/order_cancel.py (4320b), moni-trade-skill/code/order_create.py (13416b), moni-trade-skill/code/order_list.py (5658b), moni-trade-skill/code/order_modify.py (7434b), moni-trade-skill/code/query_cash.py (188b), moni-trade-skill/code/query_holdings.py (174b), moni-trade-skill/code/query_orders.py (182b), moni-trade-skill/code/sell.py (219b), moni-trade-skill/code/sim_account_create.py (3140b), moni-trade-skill/code/sim_account_reset.py (3562b), moni-trade-skill/code/sync_accounts.py (2484b), moni-trade-skill/install.ps1 (5459b), moni-trade-skill/install.sh (155b), moni-trade-skill/README.md (4728b), moni-trade-skill/SKILL.md (43177b), moni-trade-skill/TESTING.md (27719b), real-trade-skill/_meta.json (362b), real-trade-skill/code/_client.py (66433b), real-trade-skill/code/_traps.py (2536b), real-trade-skill/code/account_actions.py (2703b), real-trade-skill/code/account_list.py (3239b), real-trade-skill/code/buy.py (218b), real-trade-skill/code/cancel_order.py (177b), real-trade-skill/code/cancel.py (189b), real-trade-skill/code/cash_flows.py (2335b), real-trade-skill/code/cash_summary.py (1905b), real-trade-skill/code/check_shared_env.py (3484b), real-trade-skill/code/create_order.py (177b), real-trade-skill/code/get_cash.py (186b), real-trade-skill/code/get_holdings.py (172b), real-trade-skill/code/holdings.py (3095b), real-trade-skill/code/list_orders.py (181b), real-trade-skill/code/market_broker_list.py (1104b), real-trade-skill/code/market_kline.py (1868b), real-trade-skill/code/market_min.py (1117b), real-trade-skill/code/market_orderbook.py (1142b), real-trade-skill/code/market_quote.py (1549b), real-trade-skill/code/market_tick.py (1243b), real-trade-skill/code/modify_order.py (177b), real-trade-skill/code/modify.py (189b), real-trade-skill/code/order_cancel.py (4317b), real-trade-skill/code/order_create.py (14005b), real-trade-skill/code/order_list.py (5677b), real-trade-skill/code/order_modify.py (7865b), real-trade-skill/code/query_cash.py (188b), real-trade-skill/code/query_holdings.py (174b), real-trade-skill/code/query_orders.py (182b)\n\nFile v2.0.3:fosun-env-setup/SKILL.md\n\n---\nname: fosun-env-setup\ndescription: 复星 OpenAPI 共享凭证 `fosun.env` 的独立生成与修复模块。覆盖首次开通/换设备/凭据丢失、apikey 过期续期、凭据无效重置；已开通回填须同时提供 apikey 与页面服务端公钥；验证通过才写入共享 `fosun.env`。\nrequires:\n bins:\n - python3\n---\n\n# fosun-env-setup\n\n本模块只负责共享 `fosun.env` 的生成与修复，不执行实盘或模拟盘业务。\n\n**凭据管理全流程（必读）**：处理开通 / 换设备 / 重置 / 续期 / `--api-key` 回填前，先阅读本 skill 内 [`reference/credential-management-flow.md`](reference/credential-management-flow.md)。关键不变量：`serverPubKey` 按 ticket 生成（每次不同），客户端私钥、服务端公钥、授权 url 三者属于**同一 ticket** 的原子单元，禁止跨 ticket 混用；回填被判 invalid 时**复用当前二维码、不轮换密钥**（见 reference §7）。\n\n## 凭据模型\n\n- 每个账户 ↔ 一个 OpenAPI apikey\n- 每个 apikey ↔ 一对客户端密钥 + 服务端密钥；本地保存 apikey、客户端私钥、服务端公钥\n\n## 三类场景（主流程）\n\n| 场景 | 何时触发 | 命令 | URL | 轮换客户端密钥 | 用户须回填（页面复制） |\n|------|----------|------|-----|----------------|------------------------|\n| 1 首次/换机/丢失 | 无有效凭证，默认入口 | `ensure_fosun_env.py` | 普通开通页 | 无则生成 | 点了「忘记 API 参数」时：**apikey + 服务端公钥** |\n| 2 过期续期 | 业务返回 40010，或主动续期 | `ensure_fosun_env.py --renew` | hash 带 `isExpired=1` | 否 | 否 |\n| 3 无效/损坏 | 业务返回 40001/40015，或主动重置 | `ensure_fosun_env.py --reset-credentials` | 普通开通页 | **是** | **是**：**apikey + 服务端公钥** |\n\n场景 1 与换设备/凭据丢失**无法区分**：返回 JSON 的 `user_message` / `operation_guide` 会引导——若曾开通过须在页面上点 **「忘记 API 参数」**，重置后把页面上 **apikey 与服务端公钥（PEM）** 一并发给 Agent；Agent 执行 `--api-key` 与 `--server-public-key` 回填，并把 pending 中本次 ticket 的客户端私钥晋升到正式 `fosun.env`，再验证。\n\n> **不变式（最重要）**：已开通/忘记 API 参数场景，用户必须同时提供 **API Key + 服务端公钥**，Agent 凑齐后一次性执行 `--api-key` 与 `--server-public-key` 回填，**禁止只回填 apikey**（页面公钥与 ticket 临时公钥不同，见 reference）。首次开通仍回复「开通好了」即可；续期无需回填。\n\n> **过期 × 换设备（易踩坑的交集）**：换新设备时本地没有 apikey，**无法直接 `--renew`**。正确顺序：① 默认入口签码；② 用户点「忘记 API 参数」后把 **apikey + 服务端公钥** 一并发给 Agent；③ `--api-key` 与 `--server-public-key` 写入 env；④ finalize 识别过期后自动转续期。\n\n## 路径规则\n\n- 默认路径：本模块父目录的 `fosun.env`，即与 `moni-trade-skill` 并列的共享凭证。\n- `FOSUN_ENV_PATH` 可覆盖默认路径。\n- `FOSUN_ENV_PATH` 是相对路径时，以总入口目录为基准解析，禁止依赖当前 shell 的工作目录。\n- 验证通过的正式凭证会额外备份到 skill 目录之外的系统原生用户数据目录：macOS 使用 `~/Library/Application Support/fw-trade-skill/fosun-env-backups`，Linux 使用 `${XDG_DATA_HOME:-~/.local/share}/fw-trade-skill/fosun-env-backups`，Windows 使用 `%LOCALAPPDATA%\\fw-trade-skill\\fosun-env-backups`。\n- `FOSUN_ENV_BACKUP_DIR` 可覆盖备份目录；相对路径以用户 home 为基准解析。\n\n## 最小入口（场景 1：首次开通 / 换设备 / 凭据丢失）\n\n```bash\npython3 fosun-env-setup/code/ensure_fosun_env.py\n```\n\n**默认行为**：立即 TicketCreate 签发**新** ticket 并返回 JSON，含 `credential_scenario=setup`、`created_new_ticket=true`、`qr_media`、`exact_open_url`、`operation_guide`、`user_message`。每次进入 pending 对接流程都会调用 TicketCreate，**不会**复用本地缓存的旧 ticket/open_url（ticket 可能过期或失效）。用户已在 H5 完成开通并回复「开通好了」时，脚本会先尝试 finalize；成功则 `status=valid`，失败才签发新 ticket。\n\n**二维码交付（一次多发 + 主动询问）**：\n\n1. 脚本在脚本执行机生成 PNG，JSON 返回 `qr_media`、`qr_png_path`、`qr_image`、`show_qr_rule`\n2. 模型按 `show_qr_rule` 一次多发二维码：\n - 必做：写 `exact_open_url` 进回复（用户随时可点击）\n - 必做：调用 `deliver_attachments` 发 `qr_png_path`（最广泛兼容），并在回复中提醒用户在附件中查看二维码\n - 可选：若平台支持 media，发 `qr_media.path`\n - 可选：若平台支持 Markdown data URI，发 `qr_image.data`\n3. 发完必须问：「收到附件中的二维码了吗？如不能（只有链接/报错等），告诉我，我换方式重发」\n4. 用户说看不到 → 问「看到了什么？」→ 换一种方式重试（不要重复已失败的方式）\n\n禁止：只发一种方式；用 Read 工具\"展示\"图片（用户看不到）；假设某平台一定支持某能力。\n\n## 场景 2：apikey 过期续期\n\n```bash\npython3 fosun-env-setup/code/ensure_fosun_env.py --renew\n```\n\n或在实盘/模拟盘业务中命中 `40010` 时，由 `real-trade-skill` 分派到同一续期逻辑。URL hash 带 `isExpired=1`；**不**更换 apikey 与客户端私钥。用户扫码续期后直接重试原操作。\n\n续期要求**本地已有 apikey 与服务端公钥**。换新设备（本地无 apikey）时不能直接续期，须先按上文「过期 × 换设备」交集流程：开通/重置签码 → 用户回填 **apikey + 服务端公钥** → 工具识别过期后自动转续期。\n\n## 回填（已开通 / 「忘记 API 参数」）— 必须两项齐全\n\n适用：场景 1 中用户点了「忘记 API 参数」、场景 3 重置扫码后、换设备凭据丢失等——凡需把**页面上已开通账号**的参数写入本地，均走本回填，**不是**首次开通（首次开通用户回复「开通好了」后重跑默认入口即可，无需本命令）。\n\n**硬性要求（缺一不可）**：\n\n1. **API Key**：用户在授权页复制的 `ak_...` 原文 \n2. **服务端公钥**：同一页面展示的 `-----BEGIN PUBLIC KEY-----` … `-----END PUBLIC KEY-----` 全文 \n\n禁止只执行 `--api-key`、禁止省略 `--server-public-key`。页面上的服务端公钥与 TicketCreate 返回的临时 `serverPubKey` **通常不同**，必须用页面那份；客户端私钥由本次 ticket 的 pending 自动晋升，无需用户发送。\n\n```bash\npython3 fosun-env-setup/code/ensure_fosun_env.py \\\n --api-key '<页面 API Key>' \\\n --server-public-key '<页面服务端公钥 PEM 全文>'\n```\n\n已 `install.sh` 时用 `$FOSUN_PY` 替代 `python3`。用户只发来 apikey 时，**先向用户索要同页的服务端公钥**，凑齐后一次性执行上述命令。\n\n## 场景 3：凭据无效 / 损坏重置\n\n```bash\npython3 fosun-env-setup/code/ensure_fosun_env.py --reset-credentials\n```\n\n或在业务中命中 `40001` / `40015` 时由错误分派触发。脚本会**轮换客户端密钥对**并 TicketCreate；用户须在页面上点 **「忘记 API 参数」** 后，按上文 **「回填」** 节同时提供 apikey 与服务端公钥并执行回填命令。\n\n> **回填被判 invalid 时不要重新扫码（防死循环）**：回填会写入 apikey 与公钥后再校验。若返回 `api_key_rejected=true`、`created_new_ticket=false`，**复用当前二维码**：让用户在同一页面再点「忘记 API 参数」，把页面上 **apikey + 服务端公钥** 一并发来，再次执行**完整回填命令**（`--api-key` 与 `--server-public-key` 都要有）。禁止重新签发 ticket 或轮换密钥。\n\n首次开通（未点「忘记 API 参数」）无需回填命令，用户回复「开通好了」后再次运行默认入口即可。\n\n## 结果含义\n\n- `status=pending`：已通过 TicketCreate 签发新开通/续期/重置 URL（`created_new_ticket=true`）。须读 `credential_scenario` 与 `operation_guide`：用 media 发 `qr_media.path` 并转发 `exact_open_url`。授权中材料在 pending state，正式 `fosun.env` 不写 `pending` 凭证。场景 1 用户回复「开通好了」后再运行本脚本；需回填时按 **「回填」** 节执行 `--api-key` 与 `--server-public-key`。\n- `status=valid`：共享凭证已可用，包含账户索引、本地客户端私钥、API Key 和服务端公钥。\n- `status=error`：本地依赖、网络或认证接口失败，停止后续业务脚本。\n\n如果 `fosun.env` 缺失或缺少完整密钥材料，脚本会先从用户级本地备份自动恢复并重新校验，恢复成功时 JSON 中会包含 `restored_from_backup`。\n\n## 误删与备份恢复\n\n**触发**：用户说删了或丢了 `fosun.env`；或默认入口/`--repair` 后仍未 `valid` 且没有 `restored_from_backup`。\n\n**Agent 操作**：直接运行 `ensure_fosun_env.py`（或 `--repair`）。**禁止**手动拷贝备份文件、向用户索要客户端私钥，或尝试从服务端「找回私钥」——`FSOPENAPI_CLIENT_PRIVATE_KEY` 只能在本地生成。\n\n**成功**：`status=valid` 且含 `restored_from_backup` → 告知已从用户级本地备份恢复（路径见 §路径规则），可继续业务；无需重新扫码开通。\n\n**失败**：备份目录也无可用副本（用户连备份一起删了）→ 与换机/凭据丢失相同，走 **场景 1** 默认入口签码；若 apikey 仍无效则 **场景 3** `--reset-credentials` 后按 **「回填」** 节提供 apikey + 服务端公钥。验证通过后的正式凭证会继续写入 §路径规则中的备份目录。\n\n## 其它参数\n\n```bash\npython3 fosun-env-setup/code/ensure_fosun_env.py --repair\npython3 fosun-env-setup/code/ensure_fosun_env.py --force-new-ticket # 跳过 finalize，立即签新 ticket\n```\n\n## 输出纪律\n\n脚本只输出结构化 JSON。不要把 `fosun.env` 的密钥字段原样展示给用户。`status=pending` 时须汇报：`credential_scenario`、`user_message`、`operation_guide`、`qr_media`、`exact_open_url`、`next_action`。需要用户回填时（`requires_api_key_from_user` / `requires_server_public_key_on_backfill` 等）：**必须等用户同时提供 apikey 与页面服务端公钥**，再执行 `--api-key` 与 `--server-public-key`，禁止只回填 apikey。\n\nFile v2.0.3:moni-trade-skill/SKILL.md\n\n---\nname: moni-trade\ndescription: 复星财富港美股模拟盘 OpenAPI skill。通过 `FOSUN_ENV_PATH` 复用共享凭证；未设置时自动解析到总 skill 根目录的 `fosun.env`，只执行模拟盘接口，不负责凭证生成或修复。\nversion: 1.8.0\nrequires:\n bins:\n - bash\n - curl\ninstall: install.sh\n---\n\n# moni-trade — 复星模拟盘 OpenAPI Skill\n\n这是模拟盘子 skill。只负责执行模拟盘接口，直接复用 `FOSUN_ENV_PATH` 指向的共享凭证；未设置时自动解析到总 skill 根目录 `fosun.env`。\n\n> **本文件设计原则**：只放\"模型决策时必须知道\"的内容（安全规则、决策树、错误码处置）。\n> 每个脚本的详细参数请直接 `脚本.py --help` 查阅，文档不重复维护，**避免文档与代码脱节**。\n\n## 合法脚本清单（18 个业务脚本 + 2 个内部模块，封闭集合，跑命令前先逐字符核对）\n\n> ⚠️ **本表是工具箱总目录**，刻意放在所有铁律之前 —— 模型即使只读到这里也必须先记住：**清单之外的所有脚本名都是脑补**。\n> 命名规则统一是 **`_.py`**（唯一例外：`sync_accounts.py`，历史遗留 action_domain 顺序，**不要泛化**）。\n\n| domain | 脚本（精确文件名） | 一句话作用 |\n|---|---|---|\n| **meta** | `account_list.py` | 列账户（顺带刷账户索引） |\n| **meta** | `sync_accounts.py` | **唯一例外**：强刷账户索引（action_domain 顺序，历史遗留，不要泛化） |\n| **meta** | `check_shared_env.py` | 共享凭证体检 |\n| **账户（变更）** | `sim_account_create.py` | 创建模拟账户（必带 `--confirm`） |\n| **账户（变更）** | `sim_account_reset.py` | 重置模拟账户（必带 `--confirm`；旧账户会被禁用） |\n| **资产** | `cash_summary.py` | 现金/购买力 |\n| **资产** | `holdings.py` | 持仓 |\n| **资产** | `cash_flows.py` | 资金流水 |\n| **交易（变更）** | `order_create.py` | 下单（必带 `--confirm`） |\n| **交易（变更）** | `order_modify.py` | 改单（必带 `--confirm`；**不是** `modify_order.py`） |\n| **交易（变更）** | `order_cancel.py` | 撤单（必带 `--confirm`；**不是** `cancel_order.py`） |\n| **交易（查询）** | `order_list.py` | 订单列表（可按市场/标的/日期/状态筛选） |\n| **行情** | `market_quote.py` | 实时报价 |\n| **行情** | `market_orderbook.py` | 盘口 |\n| **行情** | `market_kline.py` | K 线 |\n| **行情** | `market_min.py` | 分时 |\n| **行情** | `market_tick.py` | 逐笔成交 |\n| **行情** | `market_broker_list.py` | 经纪商队列 |\n| **内部** | `_client.py` | 公共 SDK 工厂 + 错误处理（**不直接调用**） |\n| **内部** | `_traps.py` | 脑补陷阱共享 helper（**不直接调用**） |\n\n> **常见脑补黑名单**（v1.7.2 起这些名字已被 trap stub 接住，跑了直接吐结构化 `WRONG_SCRIPT_NAME`，**不再是 OS-level No such file**）：\n> `modify_order.py` → `order_modify.py` / `cancel_order.py` → `order_cancel.py` / `create_order.py` → `order_create.py`\n> `list_orders.py` / `query_orders.py` → `order_list.py` / `get_holdings.py` / `query_holdings.py` → `holdings.py`\n> `get_cash.py` / `query_cash.py` → `cash_summary.py` / `cancel.py` / `modify.py` → 对应 `order_*.py`\n> `buy.py` / `sell.py` → `order_create.py`（用 `--direction 1/2` 区分买卖）\n> 跑这些 trap 后，**直接照 stderr 里的 `intended_script` 字段替换脚本名重试即可，禁止再猜其它名字**。\n\n## 第 0 条铁律：单步原则（最高优先级，违反 = bug）\n\n**一次用户请求，原则上只跑一个脚本。** 拿到结果先汇报，等用户给下一个明确指令再继续。\n\n| 类型 | 示例脚本 | 跑完后允许做什么 |\n|---|---|---|\n| **meta 查询**（账户/凭证体检/同步） | `account_list` / `sync_accounts` / `check_shared_env` | **只汇报、停手**；禁止自动接 `cash_summary` / `holdings` / `cash_flows` / `order_*` |\n| **账户变更**（创建/重置模拟账户） | `sim_account_create` / `sim_account_reset` | 跑完汇报新账户、初始现金和缓存刷新结果，然后停手；禁止自动接交易/资产脚本 |\n| **业务查询**（钱/股/单/流水/行情） | `cash_summary` / `holdings` / `cash_flows` / `order_list` / `market_*` | **只汇报、停手**；禁止基于查询结果脑补\"那就帮你下单/改单/撤单\" |\n| **业务变更**（下单/改单/撤单） | `order_create` / `order_modify` / `order_cancel` | 跑完汇报结果，不允许\"成功了我再给你跑一遍 holdings 看看\"这种自动连环 |\n\n例外（允许自动连一步）：\n- 业务脚本报\"账户类错误\"→ `_client.py` 内部已自带刷缓存重试，模型不需要也不允许手动接 `account_list`。\n- 用户原话明确串了多个动作（如\"列账户再查余额\"），按用户原话顺序逐个跑、逐步汇报。\n\n**先读 stdout 顶层 `next_action` 字段再行动**（v1.7.3 起**所有查询/行情/交易脚本** stdout JSON 顶层一定带 `next_action`，是模型必须遵守的下一步指令，**优先级高于本节其它说法**）。\n\n> **抗长会话衰减说明**：本文件在长会话中会因为 LLM 注意力机制被\"挤压\"，模型可能记不清第 0 条铁律。\n> 但**每跑一次脚本，stdout 顶层 `next_action` 都是 stateless 的**，会被新鲜地喂到模型嘴边，\n> 等于把\"单步原则\"在每条命令的输出里**重新灌一遍**。所以无论会话多长，**只要模型把 stdout 完整读完、按 `next_action` 行动**，第 0 条铁律就不会失效。\n> 这是当前体系下最强的抗衰减武器，**不要忽视任何一次 stdout 的 `next_action`**。\n\n## 第 1 条铁律：禁脑补（参数 + 脚本名都不许猜）\n\n### 1.1 参数维度\n`subAccountId` / `direction` / `quantity` / `price` —— 任意一个不确定，立刻停手问用户，**严禁瞎填默认值**。下单/改单/撤单的市场维度统一用 `--market hk|us` 简写（脚本会自动展开成对应的 market_code/currency/product_type，零脑补、零拼错）；高级用户也可显式三件套，但和 `--market` 互斥，本地会直接拦截。\n\n#### 1.1.1 「标的代码」参数名抗脑补三层防御（v1.7.4 起）\n跨脚本\"标的代码\"参数名历史上叫法不一（行情用 `--code`、交易用 `--stock-code`、持仓用 `--symbols`），是模型脑补 `--ticker` / `--instrument` / `--stocks` 这种罕见名的根本诱因。v1.7.4 起加了三层兜底：\n\n- **L1 · argparse alias**：所有相关脚本现在都同时接受 4 个官方 alias `--code` / `--stock-code` / `--symbol` / `--symbols`，模型用其中任一个都能跑通（每个脚本仍有\"主名\"，但只用于 help 文案）。\n- **L2 · 智能 hint**：模型用了 4 个之外的脑补名（如 `--ticker` / `--instrument` / `--stockcode` / `--stocks`），脚本会回 `INVALID_PARAM` 并精准指出脑补名、给出\"立刻改成 `--code` / `--stock-code`\"的指引；这是兜底，**不要依赖、首先要走 L1 / L3**。\n- **L3 · `--args-json` 模板**（首选）：见文首「JSON 填空模板」一节，模型从模板复制、按规则填值，**根本没有\"想参数名\"的环节**，彻底消除脑补窗口。\n\n> **三层是冗余防御不是替代**：JSON 模板（L3）是默认首选；CLI 写法用 alias（L1）兜底；万一模型还是写出罕见脑补名，智能 hint（L2）会引导回正轨。\n\n#### 1.1.2 「标的代码」**值**自动规范化 + silent fail 兜底（v1.7.5 起）\n1.1.1 治了\"参数名\"维度的脑补；v1.7.5 接着治\"参数值\"维度——模型对市场前缀（hk/us）的拼接同样容易脱节。\n\n- **L1 · 自动规范化**（事前）：行情/持仓/订单查询脚本在 `parse_args()` 之后调用 `normalize_security_code`：\n - `01810` / `01810`（前导）/ `700`（不足 5 位）→ 自动补 `hk` 前缀 + 前导 0 → `hk00700`\n - `AAPL` / `aapl` / `Aapl` → 自动补 `us` 前缀 + 大写 → `usAAPL`\n - `HK.01810` / `US.AAPL` / `us.aapl` 点分写法 → 自动归一化\n - 已带合法前缀（`hk` / `us` / `sh` / `sz`）→ 原样保留\n - 无法推断的格式（如 `123456` 6 位数字）→ 原样转给 SDK，失败时由 L2 兜底\n- **交易下单主路径必须用纯代码**：`order_create.py` 遵循 `OrderCreate.md`，请求体已有 `marketCode`，所以模型从一开始就应生成 `marketCode=hk, stockCode=00700` / `marketCode=us, stockCode=AAPL` 这种格式。CLI 写法对应为 `--market hk --stock-code 00700`、`--market us --stock-code AAPL`，**不要主动拼 `hk00700` / `usAAPL` 给下单脚本**。`normalize_trade_stock_code()` 只做意外兜底：若误传 `hk00700` / `HK.00700` / `usAAPL`，脚本会按 `--market` 校验后剥离前缀；若代码前缀和 `--market` 冲突，本地直接拦截。\n- **L2 · silent fail 兜底**（事后）：实测发现 SDK 对\"看似合法但实际不存在\"的代码会返回 `{ok:true, code:0, data:null, message:\"success\"}`（**比报错危险 10 倍**——模型读 ok=true 会以为成功，可能凭空编数字）。`dump_with_directive` 在输出层强制识别这种\"成功外壳 + 空 data\"模式，重写为 `SILENT_FAIL_EMPTY_DATA` 结构化错误。\n\n> **直接受益**：模型听到用户说\"查 01810 现价\"，可以**原样**传 `--code 01810` 或 `{\"code\":[\"01810\"]}`，不用做\"先判断市场再拼前缀\"的认知动作。\n> **真不存在的代码**也会被精准拦截而不是 silent 编数，对用户负责。\n\n### 1.2 脚本名维度（v1.7.2 加固，**双层防御**）\n**只许使用「合法脚本清单」里精确出现的文件名，禁止按英文动宾习惯反推。**\n\n本 skill 的命名规则统一为 **`_.py`**（domain 在前、action 在后）：\n- ✅ 正确：`order_create.py` / `order_modify.py` / `order_cancel.py` / `order_list.py`\n- ❌ 错误（**这些文件根本不存在**）：`create_order.py` / `modify_order.py` / `cancel_order.py` / `list_orders.py` / `query_holdings.py` / `get_cash.py` / `cancel.py` / `modify.py` / `buy.py` / `sell.py`\n\n> **唯一例外**：`sync_accounts.py`（历史遗留，action_domain 顺序）—— **这是孤例，不要泛化推断其它脚本可以反着写**。\n\n#### 双层防御机制\n- **L1（事前）**：跑命令前先在「合法脚本清单」里逐字符核对脚本名\n- **L2（运行时强制兜底）**：13 个最常被脑补的错名（上面 ❌ 列表）已被 `code/` 目录里的 **trap stub 接住**——即使模型完全不读 SKILL.md、直接靠拼写直觉跑命令，也会立刻得到结构化 `WRONG_SCRIPT_NAME` 错误，里面带 `intended_script` 字段直接指向正确脚本名，模型读了 `next_action` 应当**立刻把命令里的错名改成 `intended_script` 重试**，不要再猜其它脚本名\n\n> 只有在用户用了**清单外的、连 trap 都没覆盖到的**罕见错名（如 `update_order.py` / `place_order.py`）时，才会落到 OS-level `No such file or directory`——此时按错误处置矩阵执行（停手 + `ls $SKILL/code/*.py` 核对 + 回查清单）。\n\n## 第 2 条铁律：变更操作二次确认（v1.7.3 起改为「argparse 强制 intent + ensure_user_confirmed 验证 confirm」三层防御）\n\n**任何下单 / 改单 / 撤单 / 创建模拟账户 / 重置模拟账户，模型必须分三步走，禁止\"打了就跑\"：**\n\n1. **在对话里先复述意图**：用自然语言把完整变更意图整段复述给用户，**不省略任何关键字段**：\n - 下单：操作（买/卖）+ 市场（港股/美股）+ 标的（含中文名最好）+ 数量 + 价格（市价单说明不传价格）+ 订单类型（只能是限价/市价）\n - 改单：要改的 orderId + 市场 + 修改类型 + 要修改的字段（数量/价格）\n - 撤单：要撤的 orderId + 市场 + 该订单的标的/方向/数量/订单类型/关键条件摘要\n - 创建模拟账户：说明会新建模拟证券账户，并初始化 HKD/USD 各 100 万现金\n - 重置模拟账户：说明旧模拟账户 ID、旧账户会被禁用、会创建新账户，并初始化 HKD/USD 各 100 万现金；重置间隔 7 天\n2. **再明确反问**：\"以上信息确认执行吗？\"——**等用户给出明确肯定**才能执行。\n3. **执行命令时把同一段复述填到 `--intent`**（**v1.7.3 必传**）：脚本会把 intent 原样打印到 stdout，长会话再衰减用户也能立刻看到模型理解的意图、错了立刻纠。\n\n**何为\"明确肯定\"**（白名单，命中才放行）：\"确认 / 是 / 是的 / 下吧 / 执行 / 撤 / 改 / 走 / yes / ok / go / 没问题 / 对\" 等。\n**何为\"未确认\"**（拒绝执行，再问一次）：\"嗯 / 可以吧 / 看着办 / 应该是吧 / 你决定 / 随便 / 都行\" 等模糊词，以及任何带\"如果/或者/也许/可能\"的条件式回答。\n\n**运行时三层防御（即使模型漏看本节铁律也兜底）**：\n- L1 `--intent` `required=True` —— 模型不带就 argparse `INVALID_PARAM` 拦截，**复述意图变成 schema 强制项**\n- L2 `--confirm` 必须为 True —— 模型在用户明确确认前禁止带 `--confirm`；不带就 `NEED_CONFIRMATION` 拦截，**且错误信息里会回显 `--intent` 内容**让用户校验\n- L3 stdout 顶层 `intent` 字段 —— 执行成功的 stdout 也会原样回显 intent，便于审计\n\n> 这条铁律覆盖**所有有副作用的变更操作**（即使用户原话已经给了完整参数，仍然要先复述+反问、再带 `--intent + --confirm` 执行）。模拟盘也按真实流程演练，培养肌肉记忆，避免接实盘时误操作。\n\n## JSON 填空模板（v1.7.4 · 反脑补终极方案 · 首选用法）\n\n> **为什么必须首选 JSON 模板**：v1.7.4 起所有业务脚本统一支持 `--args-json ''`。\n> 模型只需要 ① 复制对应模板 → ② 把 `<...>` 占位符换成实际值 → ③ 一行命令直接跑。\n> **不用想参数名 / 不用想必填项 / 不用想顺序**——长会话里最容易脑补的\"参数名\"维度被完全消除。\n>\n> 跟下面「零思考速抄表」的传统命令行写法 **100% 等价**，可任选一种；新会话推荐 **JSON 模板**。\n\n**通用调用形式**（所有脚本统一）：\n\n```bash\n$MONI_PY $SKILL/code/<脚本名>.py --args-json '<填好的 JSON 对象>'\n```\n\n**机械翻译规则**（脚本内部自动做，模型只需要按规则填 JSON）：\n- `\"code\"` → `--code`；`\"stock_code\"` 或 `\"stock-code\"` → `--stock-code`（下划线自动转中划线）\n- `true` → 只放 flag 名（覆盖 `store_true` 类，如 `confirm` / `active-only`）\n- `false` / `null` → 跳过该字段\n- 数组 → 重复展开（`[\"a\",\"b\"]` → `--key a --key b`）\n- 数字裸传，字符串脚本会自动加引号\n\n> **v1.7.5 起：查询/行情类标的代码可以直接用「用户原话格式」**——不用再拼市场前缀。\n> 脚本侧会自动规范化：`\"01810\"` → `hk01810`、`\"00700\"` → `hk00700`、`\"700\"` → `hk00700`（前导补 0）、\n> `\"AAPL\"` → `usAAPL`、`\"aapl\"` → `usAAPL`、`\"HK.01810\"` → `hk01810`、`\"US.AAPL\"` → `usAAPL`。\n> 模型听到用户说\"查 01810 现价\"，直接 `{\"code\":[\"01810\"]}` 即可，**不用想这是港股还是美股**。\n> 如果代码格式实在异常无法推断，会触发 `SILENT_FAIL_EMPTY_DATA` 错误（v1.7.5 兜底，不会再 silent 编数）。\n>\n> **交易下单例外**：下单 JSON/CLI 模板里的 `` 必须填纯代码，例如港股 `00700`、美股 `AAPL`。带前缀格式只作为脚本的兼容兜底，不作为模型首选输出。\n\n### 高频 JSON 模板（覆盖 80%+ 日常问；交易类仍受第 2 条铁律约束）\n\n| 用户原话特征 | 模板（替换 `<...>` 后即跑） |\n|---|---|\n| 余额 / 现金 / 购买力 | `$MONI_PY $SKILL/code/cash_summary.py --args-json '{}'` |\n| 持仓 | `$MONI_PY $SKILL/code/holdings.py --args-json '{}'` |\n| 只看某只持仓 | `$MONI_PY $SKILL/code/holdings.py --args-json '{\"code\":[\"\"]}'`
（CODE 直接用用户原话：`01810` / `00700` / `AAPL` 都行，v1.7.5 自动补市场前缀） |\n| 资金流水 | `$MONI_PY $SKILL/code/cash_flows.py --args-json '{}'` |\n| 今天哪些单 / 未成交 | `$MONI_PY $SKILL/code/order_list.py --args-json '{\"active-only\":true}'` |\n| 全部最近 7 天委托 | `$MONI_PY $SKILL/code/order_list.py --args-json '{}'` |\n| 查实时报价 | `$MONI_PY $SKILL/code/market_quote.py --args-json '{\"code\":[\"\"]}'` |\n| 同时查多只 | `$MONI_PY $SKILL/code/market_quote.py --args-json '{\"code\":[\"\",\"\"]}'` |\n| 查盘口 5 档 | `$MONI_PY $SKILL/code/market_orderbook.py --args-json '{\"code\":\"\",\"count\":5}'` |\n| 我有哪些账户 | `$MONI_PY $SKILL/code/account_list.py --args-json '{}'` |\n| 共享凭证体检 | `$MONI_PY $SKILL/code/check_shared_env.py --args-json '{}'` |\n| 创建模拟账户 | `$MONI_PY $SKILL/code/sim_account_create.py --args-json '{\"intent\":\"创建一个新的模拟盘证券账户，HKD/USD 各初始化 100 万现金\",\"confirm\":true}'`
必须先向用户复述并确认 |\n| 重置模拟账户 | `$MONI_PY $SKILL/code/sim_account_reset.py --args-json '{\"sub-account-id\":\"\",\"intent\":\"重置旧模拟账户 ：禁用旧账户并创建新模拟账户，HKD/USD 各初始化 100 万现金\",\"confirm\":true}'`
必须由用户明确指定旧模拟账户 ID 并确认；重置间隔 7 天 |\n\n### 交易类 JSON 模板（必须先按第 2 条铁律完成\"复述 + 反问 + 用户明确肯定\"再跑）\n\n| 场景 | 模板 |\n|---|---|\n| 下单（限价单） | `$MONI_PY $SKILL/code/order_create.py --args-json '{\"market\":\"\",\"stock-code\":\"\",\"direction\":<1|2>,\"order-type\":3,\"quantity\":,\"price\":\"\",\"intent\":\"<完整下单意图，含市场/方向/标的/数量/价格/限价单>\",\"confirm\":true}'` |\n| 下单（市价单） | `$MONI_PY $SKILL/code/order_create.py --args-json '{\"market\":\"\",\"stock-code\":\"\",\"direction\":<1|2>,\"order-type\":9,\"quantity\":,\"intent\":\"<完整下单意图，含市场/方向/标的/数量/市价单>\",\"confirm\":true}'` |\n| 非交易时段下单 | **模拟盘不支持预埋单**：非交易时段也只是普通下单，订单类型仍只能是 `3` 或 `9`；不要把\"预埋\"理解成新订单类型，也不要追加条件/触发/跟踪字段 |\n| 改单（普通订单） | `$MONI_PY $SKILL/code/order_modify.py --args-json '{\"market\":\"\",\"order-id\":,\"modify-type\":1,\"intent\":\"<完整改单意图，含市场/orderId/原订单摘要/要修改的数量或价格>\",\"confirm\":true}'` |\n| 改单（带修改字段） | 模拟盘普通改单仅支持 `\"quantity\"`、`\"price\"`，且 `\"modify-type\"` 固定用 `1`。条件单、跟踪止损、止盈止损相关字段不支持 |\n| 撤单（任意可撤订单） | `$MONI_PY $SKILL/code/order_cancel.py --args-json '{\"market\":\"\",\"order-id\":,\"intent\":\"撤掉<市场>订单 （<原标的/方向/数量/订单类型/关键条件摘要>）\",\"confirm\":true}'` |\n\n> **shell 引号约定**：永远用**单引号**包整个 JSON 字符串、JSON 内部用**双引号**。这样 shell 不会吃掉 `\"`、不会触发变量替换、不会和 zsh 的 `!` 历史扩展冲突。\n> **JSON 写错 → 结构化 `INVALID_PARAM`**（不是 OS 报错），错误信息会精确指出\"该用单引号包\"或\"缺逗号\"等修正方法。\n\n## 零思考速抄表（传统命令行写法，与上面 JSON 模板等价）\n\n> **使用顺序**：① 先在 JSON 填空模板 / 本表里找用户原话 → 找到 → **直接抄命令** → 跑完按 stdout 顶层 `next_action` 行动；② 找不到 → 走下面的「调用决策树」+ `<脚本> --help`。\n> **目的**：把高频场景的\"想脚本/想路径/想参数\"三步推理，压成\"复制即跑\"零思考。\n\n### 起手式（每个新会话先跑一次，env 变量持久到当前 shell）\n\n```bash\n# $SKILL = moni-trade-skill 根目录（含 code/、本 SKILL.md）；由本机安装位置或运行时注入，不要写死某条绝对路径。\nexport SKILL=\"\"\n# $FOSUN_PY / $MONI_PY = 总入口 install.sh 创建的共享 venv 解释器（默认 fw-trade-skill/.venv/bin/python）\nexport FOSUN_PY=\"\"\nexport MONI_PY=\"${FOSUN_PY}\"\n# 唯一真源：总入口 fw-trade-skill/fosun.env（与 moni-trade-skill 并列）。不设则脚本仍会从 code/_client.py 自动推出同一路径。\nexport FOSUN_ENV_PATH=\"${FOSUN_ENV_PATH:-$SKILL/../fosun.env}\"\n```\n\n### 高频命令（覆盖 80%+ 日常问）\n\n| 用户原话特征 | 直接抄这一行 |\n|---|---|\n| 余额 / 现金 / 购买力 / 还能买多少 | `$MONI_PY $SKILL/code/cash_summary.py` |\n| 持仓 / 我买了什么 / 现在有什么股票 | `$MONI_PY $SKILL/code/holdings.py` |\n| 今天哪些单 / 未成交订单 / 还没成 | `$MONI_PY $SKILL/code/order_list.py --active-only` |\n| 全部最近 7 天委托 | `$MONI_PY $SKILL/code/order_list.py` |\n| 资金流水 / 出入金（默认全部） | `$MONI_PY $SKILL/code/cash_flows.py` |\n| 查 X 股实时价（如 hk00700 / usAAPL） | `$MONI_PY $SKILL/code/market_quote.py --code ` |\n| 同时查多只 | `$MONI_PY $SKILL/code/market_quote.py --code hk00700 --code usAAPL` |\n| 查 X 股盘口 5 档 | `$MONI_PY $SKILL/code/market_orderbook.py --code --count 5` |\n| 我有哪些账户 | `$MONI_PY $SKILL/code/account_list.py` |\n| 共享凭证体检 | `$MONI_PY $SKILL/code/check_shared_env.py` |\n| 创建模拟账户 | `$MONI_PY $SKILL/code/sim_account_create.py --intent \"创建一个新的模拟盘证券账户，HKD/USD 各初始化 100 万现金\" --confirm` |\n| 重置模拟账户 | `$MONI_PY $SKILL/code/sim_account_reset.py --sub-account-id --intent \"重置旧模拟账户 ：禁用旧账户并创建新模拟账户，HKD/USD 各初始化 100 万现金\" --confirm` |\n\n### 下单 / 改单 / 撤单（用户原话明确**且经二次确认**后再用，参数仍需用户给齐）\n\n> 全部用 **`--market hk|us` 简写**，脚本自动展开三件套，**绝不要手填 `--currency` / `--product-type`**。\n> ⚠️ 模板末尾都带 `--intent \"...\"` + `--confirm`：**模型必须先按「第 2 条铁律」用自然语言复述意图、得到用户明确肯定，再把同一段复述填到 `--intent` 后跑**。在拿到明确确认前，先把命令展示给用户**但不要执行**。\n> ⚠️ **`--intent` 是 v1.7.3 起的 `required=True` 必填项**——不带就 argparse `INVALID_PARAM`，没有任何绕过空间。\n\n| 场景 | 模板（占位符替换后即跑） |\n|---|---|\n| 下单（限价单） | `$MONI_PY $SKILL/code/order_create.py --market --stock-code --direction <1|2> --order-type 3 --quantity --price --intent \"<完整下单意图，含市场/方向/标的/数量/价格/限价单>\" --confirm` |\n| 下单（市价单） | `$MONI_PY $SKILL/code/order_create.py --market --stock-code --direction <1|2> --order-type 9 --quantity --intent \"<完整下单意图，含市场/方向/标的/数量/市价单>\" --confirm` |\n| 改单（普通订单） | `$MONI_PY $SKILL/code/order_modify.py --market --order-id --modify-type 1 --intent \"<完整改单意图，含市场/orderId/原订单摘要/要修改的数量或价格>\" --confirm`
按用户意图追加 `--quantity` / `--price` |\n| 撤单（任意可撤订单） | `$MONI_PY $SKILL/code/order_cancel.py --market --order-id --intent \"撤掉<市场>订单 （<原标的/方向/数量/订单类型/关键条件摘要>）\" --confirm` |\n\n> 港股最小手数 100；不知 `` 先 `order_list.py`；TIF / expType / 盘前盘后 / 夜盘等高级字段走 `$MONI_PY $SKILL/code/order_create.py --help`。模拟盘订单类型始终只允许 `3` / `9`，且**不支持预埋单**（非交易时段也只是普通下单，不会被转成预埋单）。\n> 漏带 `--intent` → `INVALID_PARAM`（argparse 阶段就拒）；漏带 `--confirm` → `NEED_CONFIRMATION`（intent 会回显在错误里给用户校验）—— 这是「第 2 条铁律」的三层运行时兜底，不要怀疑、不要绕过。\n\n## 调用决策树（速抄表没覆盖时走这里）\n\n按用户原话定位脚本，**只跑一个**，跑完汇报：\n\n| 用户原话特征 | 调用 | 备注 |\n|---|---|---|\n| \"我有哪些账户\" / \"账户列表\" | `account_list.py` | meta 查询，跑完只汇报 |\n| \"刚开了新账户 / 账户变了\" | `sync_accounts.py` | 平时不需要主动跑 |\n| 共享凭证体检 / 怀疑失效 | `check_shared_env.py` | 体检，不要当业务前置步骤 |\n| \"创建模拟账户 / 新开模拟账户\" | `sim_account_create.py` | 有副作用，必须先复述+确认；成功后脚本会刷新账户索引 |\n| \"重置模拟账户 / 模拟账户初始化\" | `sim_account_reset.py` | 有副作用，必须用户明确指定旧模拟账户 ID 并确认；旧账户会被禁用，重置间隔 7 天 |\n| \"余额 / 现金 / 购买力 / 还能买多少\" | `cash_summary.py` | **不要先跑 account_list** |\n| \"持仓 / 我买了什么 / 现在有什么股票\" | `holdings.py` | 同上 |\n| \"今天买卖了什么 / 流水 / 出入金\" | `cash_flows.py` | |\n| \"今天的订单 / 委托记录 / 哪些没成\" | `order_list.py` | 查某笔单先按 `--stock-code` + 日期 / 市场 / 状态缩小列表；对用户只说明“可按市场/标的/日期/状态筛选订单列表”，不要说某脚本不支持 |\n| \"下单 / 买 / 卖\" | `order_create.py` | 用 `--market hk|us` 简写，见下文 |\n| \"撤单 / 取消那张单\" | `order_cancel.py` | 不知道 order-id 先 `order_list.py` |\n| \"改价 / 改单 / 改数量\" | `order_modify.py` | 同上 |\n| \"K 线 / 走势图\" | `market_kline.py` | |\n| \"实时价 / 现在多少钱 / 报价\" | `market_quote.py` | 多只用 `--code` 多次 |\n| \"盘口 / 买卖档\" | `market_orderbook.py` | |\n| \"分时\" | `market_min.py` | |\n| \"逐笔成交\" | `market_tick.py` | |\n| \"经纪商\" | `market_broker_list.py` | |\n\n> **不知道脚本怎么用？** → `$MONI_PY $SKILL/code/<脚本>.py --help`\n> 每个脚本都自带 EPILOG（何时调用 + 示例 + 强制规则）；本文档不重复维护脚本细节，**避免漂移**。\n\n## 其它必须遵守\n\n### 盘别确认\n\n用户没有明确选择`模拟盘`时，禁止调用本 skill。\n\n### 只用共享凭证\n\n- 只读取 `FOSUN_ENV_PATH` 指向的共享凭证；未设置时自动解析到总 skill 根目录 `fosun.env`。\n- 推荐写法：`FOSUN_ENV_PATH=fosun.env`，由脚本自动解析成绝对路径。\n- 不生成、不复制、不维护第二份凭证；凭证无效时先去同级 `fosun-env-setup` 生成或修复。\n\n### 能力边界\n\n- 仅支持港股、美股正股。\n- 不支持 A 股交易、期权交易、`BidAskInfo` 与订阅类接口。\n- **用户口径**：当用户请求当前接口不支持的功能时，不要对用户说“某个 Python 文件/某个脚本不支持”。只说明当前支持范围和可替代能力：\n - 支持：港股/美股正股的账户、资金、持仓、资金流水、订单列表、下单、改单、撤单。\n - 支持：报价、K 线、分时、逐笔、盘口、经纪商队列等单次行情查询。\n - 不支持：A 股交易、期权交易、订阅类接口、`BidAskInfo`、按订单号直接单笔查询、批量撤单接口。\n - 可替代：查某笔订单时，用市场/标的/日期/状态缩小订单列表；订阅需求改为单次行情查询；批量撤单需求先列出待撤订单，复述清单并经用户确认后逐笔撤。\n\n### 错误处理：先读 next_action，再行动\n\n所有脚本错误统一以结构化 JSON 输出到 **stderr**：先读 `error_code` 和 `next_action`，按本文末尾「错误码处置矩阵」执行。**`NO_MOCK_ACCOUNT`（exit 3）必须立即停手转告用户**，禁止私自切实盘 skill / 挑其他账户继续 / 改写口径推进。\n\n## 一键安装\n\n在 **总 skill 根目录**安装（与实盘、env-setup 共用 venv；本目录 `install.sh` 会转调上级脚本）：\n\n```bash\nbash ../install.sh\n# 或：cd .. && bash install.sh\n```\n\n> macOS / Linux 用 `bash install.sh`。**用户机器无需预装 Python**——[uv](https://docs.astral.sh/uv/) 会在总入口目录创建 `.venv` 并下载解释器（符合 [Agent Skills](https://agentskills.io/specification) 约定：依赖相对 skill 根目录管理，不写入 Agent 工作区外路径）。\n\n`../install.sh` 会自动：\n1. 检测 `uv`，未安装时一键自动拉取；\n2. 在 `$FW_TRADE_VENV`（默认 `fw-trade-skill/.venv`）创建**共享**环境，Python 由 uv 自动下载；\n3. 下载 SDK 压缩包并解压到 `fw-trade-skill/.cache/`；\n4. `uv pip install --editable` 安装 `fsopenapi`（含 setup.py 依赖；PyPI 失败时自动改用清华镜像重试）；\n5. 自检 `import fsopenapi`；导出 `FOSUN_PY`（`MONI_PY` 与之相同）。\n\n> 可选环境变量：`FW_TRADE_VENV`、`FW_TRADE_PYTHON_VERSION`、`FW_TRADE_SDK_*`、`FW_TRADE_CACHE_DIR`、`FW_TRADE_PYPI_MIRROR`（兼容旧前缀 `MONI_*`）。\n\n## 使用前提\n\n- `FOSUN_ENV_PATH` 指向的共享凭证文件已存在\n- 共享凭证已通过同级 `fosun-env-setup` 生成或修复\n- 当前请求已明确选择为`模拟盘`\n- 模型每个新会话先按上面「速抄表 → 起手式」export 一次 `$MONI_PY` `$SKILL`\n\n## 下单/改单/撤单：市场参数规则\n\n**推荐唯一路径**：用 `--market hk|us` 简写，脚本自动展开三件套，模型零脑补、零拼错。\n\n| 用户意图 | 推荐写法 | 等价的三件套（高级用户用） |\n|---|---|---|\n| 港股交易 | `--market hk` | `--market-code hk --currency HKD --product-type 5` |\n| 美股交易 | `--market us` | `--market-code us --currency USD --product-type 6` |\n\n- `--market` 与三件套**互斥**，混用本地直接 `INVALID_PARAM` 拦截。\n- `order_modify.py` / `order_cancel.py` 只用 `product_type`，简写效果是 `--market hk → 5`、`--market us → 6`。\n- 完整模板见上面「交易类 JSON 模板」和「速抄表 → 下单/改单/撤单」节；TIF / expType / 盘前盘后 / 夜盘等高级字段走 `--help`。\n\n## 通用规则与枚举值（速查）\n\n- **市场代码**：`hk` 港股 / `us` 美股（模拟盘只这两种）\n- **币种**：`HKD` / `USD` / `CNH`，**港股只用 HKD、美股只用 USD，不自动换汇**\n- **方向**：`1=买` / `2=卖`\n- **产品类型**：`5`=港股 / `6`=美股\n- **订单类型（模拟盘下单唯一允许值）**：`3`=限价单, `9`=市价单\n - **易错（必读）**：**市价单是 `9`，不是 `4`**；`4` 增强限价单、`1/2` 竞价类、`5/6` 特殊/暗盘、`31/32/33/35` 条件/跟踪/止盈止损类均不属于模拟盘能力。\n - **预埋单口径**：**模拟盘不支持预埋单**；非交易时段也只是普通下单（仍只允许 `3=限价单` / `9=市价单`），不要为了“预埋”改用条件单或触发价字段，也不要承诺\"会自动预埋\"。\n- **行情价格解码（强约束）**：凡响应里出现 `power`，价格类字段实际值一律按 `raw / (10^power)` 计算；展示时小数位必须按 `power` 截取，禁止按经验猜位数、禁止脱离 `power` 自行四舍五入。\n- **时段 timeInForce（下单 OrderCreate）**：`0`=当日有效, `2`=允许美股盘前盘后, `4`=允许夜盘。美股下单未显式传 `--time-in-force` 时，脚本按 ET 当前时段自动填充（盘前/盘后=`2`，夜盘=`4`，盘中=`0`）；且盘前/盘后/夜盘仅支持限价单（不支持市价单 `orderType=9`）。\n- **订单列表 showType（OrderList）**：`0`=只有正股订单, `1`=正股和期权订单, `2`=只有期权订单；**本模拟盘 skill 仅支持正股，查询请用 `0` 或不传（由脚本默认约束）**\n- **订单状态**：`10`=未报, `20`=待报, `22`=待处理, `23`=待复核, `40`=已报, `50`=全成, `60`=部成, `70`=已撤, `80`=部撤, `90`=废单, `100`=已失效；服务端通用枚举还可能返回 `21/71/91/101/901`，但模拟盘新下单仍只支持限价单/市价单\n- **用户汇报状态码规则**：对用户输出时，禁止只说数字响应码或状态码。凡是结果里出现 `code` / `message` / `orderStatus` / `status` / `statusArr` 等字段，必须同时给出可读说明：\n - `code=0` 要说成“接口返回成功（code=0 / message=success）”；非 0 要同时带出 `message` 和可读失败原因。\n - `orderStatus` 等订单状态必须写成“数字 + 中文状态”，例如 `40=已报`、`50=全成`、`70=已撤`；未知码要说“未知状态码 X”，不能只把数字丢给用户。\n - 如果响应里既有 `orderId` 又有状态码，汇报格式应包含：订单号、操作结果、状态码对应文字说明、是否还需要用户下一步确认。\n\n### 参数说明「根治」规则（维护必读）\n\n- **单一事实来源**：同仓库内复星 OpenAPI 文档在 `fw-tradings-1.0.4/fosun-trading/doc/`（相对 moni-trade-skill 目录为 `../fw-tradings-1.0.4/fosun-trading/doc/`）。**交易下单**以 `OrderCreate.md` 为准；**改单** `OrderModify.md`；**订单列表** `OrderList.md`；**资金流水** `CashFlows.md`。\n- **冲突处理**：模拟盘能力边界优先于通用 `OrderCreate.md` 全量枚举；若某脚本 `--help` 与模拟盘只支持 `3/9` 不一致，**视为 bug：改脚本/help，不反推瞎编枚举**。\n\n### 子账户解析机制（模型理解即可，不需要主动调）\n\n- **优先级**：CLI `--sub-account-id` > `MONI_SUB_ACCOUNT_ID` 环境变量 > 共享凭证 `FSOPENAPI_ACCOUNT_INDEX` 缓存 > 自动调 `/v1/account/Accounts` 刷新\n- **缓存自愈**：业务接口报账户类错（含 \"subAccountId\"、\"账户\" 等关键字）→ 自动刷一次缓存并以新 ID 重试一次；新旧一致直接抛错，不无意义重试\n- **类型净化**：所有路径出入 `subAccountId` 都强制走 `_coerce_sub_account_id`（强转 str + strip），杜绝下游类型踩坑\n- **无 mock 账号 → 强拦截**：缓存和刷新后都查不到 `subAccountType=2` 时抛 `NoMockAccountError`（exit 3），按错误码处置矩阵处理\n\n## 错误处理规约（必读）\n\n**所有脚本失败时，stderr 输出统一结构化 JSON**，模型直接解析即可决策，不必回查文档：\n\n```json\n{\n \"ok\": false,\n \"error_code\": \"NO_MOCK_ACCOUNT\",\n \"message\": \"...\",\n \"hint\": \"为什么会这样（机制说明）\",\n \"next_action\": \"模型应该做什么（祈使句）\",\n \"code\": 60009, // 仅 APIError 才有\n \"requestId\": \"...\", // 仅 APIError 才有\n \"data\": {...} // 仅 APIError 才有\n}\n```\n\n**退出码**：`0` 成功 / `1` APIError / `2` 参数/配置/未确认错（含 `NEED_CONFIRMATION`） / `3` NO_MOCK_ACCOUNT（强拦截）\n\n### 错误码处置矩阵\n\n| error_code | 含义 | 模型必须做什么 |\n|---|---|---|\n| `NO_MOCK_ACCOUNT`（exit 3） | 共享凭证下没有 mock 子账户 | **立即停手**，把账户缺失情况完整转告用户。**禁止**自动切到实盘 skill、**禁止**挑选其他账户继续 |\n| `ENV_FILE_MISSING`（exit 2） | 共享凭证文件不存在 | 让用户先通过同级 `fosun-env-setup` 生成 |\n| `ENV_INCOMPLETE`（exit 2） | 凭证缺关键字段 | 让用户通过同级 `fosun-env-setup` 修复或刷新凭证 |\n| `SESSION_EXPIRED`（exit 1） | 共享凭证里的券商会话已过期 | 先跑 `check_shared_env.py` 体检；仍失败就回同级 `fosun-env-setup` 修复或刷新凭证。**不要**把它解释成“订单/持仓不存在” |\n| `INVALID_SIGNATURE`（exit 1） | 共享凭证的签名链失效 | 回同级 `fosun-env-setup` 修复或刷新凭证，再重试当前操作；**不要**把它解释成“查无此单” |\n| `APIERROR_40010`（exit 1） | 共享凭证 apikey 已过期 | **停手**，引导用户回同级 `real-trade-skill` 执行续期（扫码）；续期只延长原 apikey 有效期，**不改本地 apikey、无需用户回填**；扫码后直接重试 |\n| `APIERROR_40001` / `APIERROR_40015`（exit 1） | apikey 无效 / 密钥不匹配 | **停手**，引导用户回同级 `real-trade-skill` 完成重置扫码；提醒已开通过则在页面上点 **「忘记 API 参数」**；**须等用户发来页面上 API Key 与服务端公钥（PEM）一并**由 `update_api_key.py`（`--api-key` + `--server-public-key`）写入共享凭证后再重试 |\n| `APIERROR_40005` / `APIERROR_40008`（exit 1） | apikey 禁用 / 撤销 | **停手**，用大白话告知用户联系星财富客服；模拟盘不建票、不出码 |\n| `NEED_CONFIRMATION`（exit 2） | 变更类脚本未带 `--confirm`，触发「第 2 条铁律」运行时兜底（v1.7.3 起错误信息会回显 `--intent` 内容） | **立即停手**，把 stderr JSON 里的 `intent_summary` 字段（即模型自己填的 `--intent`）原样复述给用户、明确反问\"以上意图确认执行吗？\"；得到明确肯定后在原命令末尾补 `--confirm` 重试；**禁止**自己加 `--confirm` 绕过、**禁止**用模糊回答（\"嗯/可以吧/看着办\"）当作确认 |\n| `INVALID_PARAM` 提示「the following arguments are required: --intent」 | v1.7.3 起 `--intent` 是 required，模型漏填 | 不要瞎猜——先按「第 2 条铁律」用自然语言复述完整变更意图给用户、得到明确肯定后，**把这段复述原样填到 `--intent \"...\"` 里**，连同 `--confirm` 一起重试 |\n| `WRONG_SCRIPT_NAME`（exit 2） | 命中 v1.7.2 trap stub：脚本名拼错（如 `modify_order.py` / `cancel_order.py` / `buy.py` 等 13 个常见错名） | **立即把命令里的错名替换为 stderr JSON 里的 `intended_script` 值**，其它参数保持不变直接重试；**禁止再去猜其它脚本名**——`intended_script` 就是正确答案 |\n| `No such file or directory`（OS-level，**非结构化 JSON**） | 罕见错名连 trap 都没覆盖（如 `update_order.py` / `place_order.py`） | **立即停手**：① 跑 `ls $SKILL/code/*.py` 列出真实文件名 ② 回查 SKILL.md 「合法脚本清单」逐字符核对 ③ 改正脚本名后重试 ④ **严禁靠拼写直觉猜下一个名字重新提交** |\n| `INVALID_PARAM` 提示「参数名 `--xxx` 是脑补出来的」 | v1.7.4 智能 hint：模型用了官方 4 alias 之外的标的脑补名（`--ticker` / `--instrument` / `--stockcode` / `--stocks` 等） | **立即把脑补名改成 `--code`（行情类）或 `--stock-code`（交易类）**，其它名字（`--symbol` / `--symbols`）也都接受；**禁止再去猜其它写法**——4 个 alias 之外都是脑补；下次直接走「JSON 填空模板」节，连参数名都不用想 |\n| `INVALID_PARAM` 提示「`--args-json` 解析失败」 | v1.7.4 模型用 `--args-json` 时 JSON 写错（缺逗号 / 双引号被 shell 吃掉 / 单双引号混用） | 按 next_action 改正：用单引号包整个 JSON、JSON 内部用双引号；从「JSON 填空模板」节里复制一份完整模板再填值；**禁止**手写 JSON 不用模板 |\n| `SILENT_FAIL_EMPTY_DATA`（exit 2，v1.7.5 新） | SDK 返回 `code:0/message:success` 但 `data:null`——多见于\"标的代码不存在\"或\"格式诡异 normalize 也救不回来\" | **立即停手**并把\"SDK 返回空数据\"如实告诉用户，请用户确认完整代码（含市场前缀，如 `hk00700`/`usAAPL`）后再重试；**严禁**把 ok=true 的外壳误读成成功、**严禁**自己编一个价格汇报给用户。这是 v1.7.5 输出层强制兜底，专门防\"模型读 ok=true 凭空编数\"的人命级故障 |\n| `INVALID_PARAM`（exit 2） | 本地参数校验失败（`--market` 缺失/与三件套混用、三件套错配、请求了能力边界外功能等） | 按 message 修正命令行后重试；涉及用户原始意图先确认。若属于接口能力边界，对用户只说明“当前支持什么/可替代怎么做”，不要带出内部 Python 文件或脚本名 |\n| `APIERROR_50001` | 列表类接口分页 Count 校验失败 | 加 `--count 50` 重试一次，不要原样重试 |\n| `APIERROR_60006` | 服务端业务校验（价格/数量/停牌等） | 原样转告用户，等待用户调整后再重试，**禁止自行猜测修正** |\n| `APIERROR_60009` | 单笔金额超模拟盘限额 | 建议用户减少 quantity 或换标的，**不要用相同参数重试** |\n| `APIERROR_60014` | 风控/合规拦截 | 原样转告用户，等待决策 |\n| `APIERROR_*`（其他） | 服务端业务错 | 看脚本输出的 hint / next_action；message 提示参数问题就按提示改后重试，否则转告用户 |\n\n> 模型遇到任意错误：**先读 `next_action`，再决定下一步**。不要凭直觉重试。\n\n## 已知服务端 vs 文档差异（已自动处理）\n\n| 接口 | 文档行为 | 服务端实际行为 | 本 skill 处理 |\n|---|---|---|---|\n| OrderList | \"fromDate/toDate 不传则查最近 7 天\" | 实际**强制要求**两个字段 | `order_list.py` 在用户未指定时自动填充 7 天前与今天 |\n| OrderCreate / OrderModify / OrderCancel | `productType` 文档标注可选 | 实际**强制要求** | 三个脚本要求显式 `--market hk\\|us`（推荐）或完整 `--product-type`（兼容），缺失/混用一律 `INVALID_PARAM`；`order_create.py` 还做三件套对齐校验 |\n| CashSummary 等 | `subAccountId` 文档允许数字 | 部分路径要求字符串 | `_client.py` 单一出口 `_coerce_sub_account_id` 强转 str + strip，杜绝类型踩坑 |\n\n## 目录结构\n\n```\nmoni-trade-skill/\n├── SKILL.md # 本文件，模拟盘子 skill 主入口\n├── _meta.json # slug / version\n├── README.md # 安装与故障排查\n├── install.sh # 兼容入口 → 转调 ../install.sh\n├── install.ps1 # Windows 一键安装\n├── code/ # CLI 脚本\n│ ├── _client.py # 公共 SDKClient 工厂 + env 加载 + 账户索引缓存 + 自愈重试 + 错误处理\n│ ├── check_shared_env.py # 显式检查 FOSUN_ENV_PATH 指向的共享凭证是否可用（顺带刷新账户索引）\n│ ├── account_list.py # 查账户列表（顺带刷新账户索引到 FOSUN_ENV_PATH 指向的共享凭证）\n│ ├── sync_accounts.py # 强制同步账户索引到 FOSUN_ENV_PATH 指向的共享凭证（账户有变更时再跑）\n│ ├── sim_account_create.py # 创建模拟账户（成功后刷新账户索引）\n│ ├── sim_account_reset.py # 重置模拟账户（禁用旧账户、创建新账户、成功后刷新账户索引）\n│ ├── cash_summary.py\n│ ├── holdings.py\n│ ├── cash_flows.py\n│ ├── order_create.py\n│ ├── order_cancel.py\n│ ├── order_modify.py\n│ ├── order_list.py\n│ ├── market_kline.py\n│ ├── market_min.py\n│ ├── market_broker_list.py\n│ ├── market_orderbook.py\n│ ├── market_quote.py\n│ └── market_tick.py\n```\n\nFile v2.0.3:real-trade-skill/SKILL.md\n\n---\nname: real-trade\ndescription: 复星财富港美股实盘 OpenAPI skill。通过 `FOSUN_ENV_PATH` 复用总入口共享 `fosun.env`；未设置时由运行时解析到与本 skill 并列的 `fosun.env`。用于明确选择实盘后的账户、资产、行情、订单和交易操作。\nversion: 1.8.0\nrequires:\n bins:\n - bash\n - curl\ninstall: install.sh\n---\n\n# real-trade — 复星实盘 OpenAPI Skill\n\n这是实盘子 skill。它只负责在用户明确选择`实盘`后执行实盘相关接口；共享凭证的生成与修复由同级 `fosun-env-setup` 负责。\n\n## 最高优先级规则\n\n1. 用户没有明确选择`实盘`时，禁止调用本 skill。\n2. 实盘下单、改单、撤单等变更动作必须先复述完整意图，并等待用户明确确认。\n3. 全局只使用一个共享凭证：`FOSUN_ENV_PATH` 指向的 `fosun.env`。\n4. 禁止为实盘或模拟盘复制第二份凭证文件。\n5. 禁止在命令或文档里写死某台机器的绝对路径；需要绝对路径时，只能由环境变量和相对路径在运行时解析得到。\n\n## 共享凭证路径\n\n推荐起手式：\n\n```bash\nexport SKILL=\"\"\nexport FOSUN_PY=\"\" # 总入口 install.sh 共享 venv，默认 fw-trade-skill/.venv/bin/python\nexport REAL_PY=\"${FOSUN_PY}\"\nexport FOSUN_ENV_PATH=\"${FOSUN_ENV_PATH:-$SKILL/../fosun.env}\"\n```\n\n路径解析规则：\n\n- `FOSUN_ENV_PATH` 未设置：脚本默认使用总入口目录下的 `fosun.env`\n- `FOSUN_ENV_PATH` 是相对路径：以总入口目录为基准解析\n- `FOSUN_ENV_PATH` 是绝对路径：直接使用\n\n同一个 `fosun.env` 同时供 `real-trade-skill` 和 `moni-trade-skill` 使用。\n\n## 使用前检查\n\n任何业务脚本前，先确保共享凭证存在：\n\n```bash\npython3 ../fosun-env-setup/code/ensure_fosun_env.py\n```\n\n结果处理：\n\n- `status=valid`：继续执行实盘凭证体检或业务脚本\n- `status=pending`：把脚本 JSON 输出里的 `exact_open_url` / `open_url` 逐字符原样给用户完成 OpenAPI 开通，禁止手写或改写 URL；用户在页面完成开通后重试，脚本通过 finalize（APIKeyCheck + 签名请求）验证\n- `status=error`：停止实盘业务，先按 `message` 修复凭证生成问题\n\n已有凭证但需要修复时：\n\n```bash\npython3 ../fosun-env-setup/code/ensure_fosun_env.py --repair\n```\n\n## 合法脚本清单\n\n只允许调用 `code/` 目录中真实存在的脚本。跑命令前先逐字符核对文件名，禁止按英文习惯脑补。\n\n| 类型 | 脚本 | 作用 |\n|---|---|---|\n| 凭证/账户 | `check_shared_env.py` | 检查共享凭证并刷新账户索引 |\n| 凭证/账户 | `account_list.py` | 查询账户列表 |\n| 凭证/账户 | `sync_accounts.py` | 强制刷新账户索引 |\n| 资产 | `cash_summary.py` | 查询现金与购买力 |\n| 资产 | `holdings.py` | 查询持仓 |\n| 资产 | `cash_flows.py` | 查询资金流水 |\n| 订单 | `order_list.py` | 查询订单列表 |\n| 交易变更 | `order_create.py` | 下单，必须二次确认 |\n| 交易变更 | `order_modify.py` | 改单，必须二次确认 |\n| 交易变更 | `order_cancel.py` | 撤单，必须二次确认 |\n| 行情 | `market_quote.py` | 实时报价 |\n| 行情 | `market_orderbook.py` | 盘口 |\n| 行情 | `market_kline.py` | K 线 |\n| 行情 | `market_min.py` | 分时 |\n| 行情 | `market_tick.py` | 逐笔成交 |\n| 行情 | `market_broker_list.py` | 经纪商队列 |\n\n## 调用顺序\n\n1. 确认用户选择的是`实盘`\n2. 运行 `../fosun-env-setup/code/ensure_fosun_env.py`\n3. 凭证 `status=valid` 或完成开通后，按用户意图选择本 skill 的脚本\n4. 查询类脚本执行后只汇报结果并停手\n5. 变更类脚本必须先复述意图并等待明确确认，再带确认参数执行\n\n## 变更操作二次确认\n\n所有实盘变更操作都必须分三步：\n\n1. 用自然语言复述完整意图，包括市场、标的、方向、数量、价格、订单类型或订单号。\n2. 明确反问用户是否确认执行。\n3. 只有用户明确肯定后，才运行对应脚本并带上确认参数。\n\n模糊回答不算确认，例如“嗯”“可以吧”“你看着办”。必须继续追问。\n\n## 错误处理\n\n脚本失败时先读 stderr/stdout 中的结构化字段，尤其是 `error_code`、`message`、`next_action`。不要凭直觉重复提交命令。\n\n常见处理：\n\n- 共享凭证不存在：回到 `fosun-env-setup` 生成\n- 共享凭证无效：运行 `fosun-env-setup --repair` 或按错误信息重新开通\n- 用户未明确选择实盘：停手追问盘别\n- 变更参数不完整：停手向用户确认缺失字段\n\n## 目录结构\n\n```text\nreal-trade-skill/\n├── SKILL.md\n├── README.md\n├── _meta.json\n├── install.sh # 兼容入口 → 转调 ../install.sh\n└── code/\n```\n\nFile v2.0.3:SKILL.md\n\n---\nname: fw-trade-skill\ndescription: 复星财富（Fosun Wealth）港美股 OpenAPI 交易总入口 skill：统一管理共享凭证 `fosun.env`（生成/修复/备份恢复），并在实盘与模拟盘间路由执行账户、资金、持仓、流水、行情、下单/撤单/改单等能力；全局单凭证 `FOSUN_ENV_PATH`，变更操作强制二次确认并遵循单步执行。\n---\n\n# fw-trade-skill\n\n这是总入口 skill，不直接实现交易。它只负责三件事：解析共享凭证路径、确保 `fosun.env` 已由 `fosun-env-setup` 生成或修复、判断盘别后路由到实盘或模拟盘子 skill。\n\n## 模型必须遵守\n\n### 0. 先思考再行动（最高优先级）\n\n每一步动作前，必须先在内部完成一轮显式思考，再决定下一步：\n\n- 复盘已有信息：用户原话、当前共享凭证状态、上一步脚本输出（含 stderr / 退出码）、缓存里的账户索引；\n- 明确这一步要回答的问题：现在到底是路由、凭证生成/修复、查询还是交易？所需参数是否齐全？\n- 评估可行方案，挑最小改动 / 最少副作用 / 最少询问用户的那一条；\n- 严禁基于猜测或不完整信息直接调用脚本、改写参数、跨盘别切换；\n- 任何不确定项（盘别、`subAccountId`、市场/产品类型、金额方向）必须先回头问用户，不得脑补。\n- 港美股交易的币种、余额和购买力彼此独立：`HKD` 余额只能用于港股，`USD` 余额只能用于美股，不能跨市场混用或替用户做换汇推断。\n\n### 1. 先定位共享凭证\n\n全局只使用一个共享凭证路径变量 `FOSUN_ENV_PATH`。\n\n- 未设置时：由脚本根据自身位置解析为总 skill 根目录下的 `fosun.env` 绝对路径\n- 已设置且为相对路径时：以总 skill 根目录为基准解析\n- 已设置且为绝对路径时：直接使用\n- 推荐写法：`FOSUN_ENV_PATH=fosun.env`，既保留可迁移性，又不会受当前工作目录影响\n\n禁止在文档或脚本里写死某台机器的绝对路径；需要绝对路径时，只能由相对路径和环境变量在运行时解析得到。\n\n### 2. 先确保 `fosun.env` 可用（委托子 skill）\n\n任何实盘或模拟盘操作前，必须先完成共享凭证准备。**开通、续期、重置、回填、二维码交付、备份恢复等全部规则以子 skill `fosun-env-setup` 为准**——执行前阅读其子目录 [`fosun-env-setup/SKILL.md`](fosun-env-setup/SKILL.md)；凭据流程设计见 [`fosun-env-setup/reference/credential-management-flow.md`](fosun-env-setup/reference/credential-management-flow.md)。**禁止**在母技能中自行解释或改写凭据细节，避免与子 skill 冲突。\n\n默认入口（已 `install.sh` 时优先 `$FOSUN_PY`）：\n\n```bash\n$FOSUN_PY fosun-env-setup/code/ensure_fosun_env.py\n```\n\n母技能只根据脚本 JSON 的 `status` 决定是否继续：\n\n- `valid` → 可进入盘别判断与业务子 skill\n- `pending` / `error` → **停手**，严格按子 skill 返回的 `operation_guide`、`user_message`、`next_action` 执行，不得跳过 env-setup 直接跑交易脚本\n\n### 3. 再判盘别\n\n凡是涉及以下任一金融相关操作，都必须确认用户这次是`实盘`还是`模拟盘`：\n\n- 查询账户 / 资金 / 持仓 / 流水\n- 查询订单\n- 下单 / 撤单 / 改单\n- 查询行情\n- 任何需要 `subAccountId` 的证券操作\n\n如果用户没有明确回答，禁止继续执行。禁止根据账户类型、脚本名或历史上下文替用户猜盘别。\n\n### 4. 凭证体检与路由\n\n- 用户选择`实盘`：\n 1. 使用 `real-trade-skill`。\n 2. 只读取同一个 `FOSUN_ENV_PATH` 指向的共享 `fosun.env`。\n 3. 凭证未 `valid` 时，先按 `fosun-env-setup` 子 skill 处理，不得直接跑实盘脚本。\n 4. 实盘变更操作必须先复述完整意图并获得用户明确确认。\n\n- 用户选择`模拟盘`：\n 1. 使用 `moni-trade-skill`。\n 2. 只读取同一个 `FOSUN_ENV_PATH` 指向的共享 `fosun.env`。\n 3. 凭证未 `valid` 时，先按 `fosun-env-setup` 子 skill 处理，不得直接跑模拟盘脚本。\n 4. 模拟盘不得生成、复制或维护第二份凭证。\n\n## 子 skill 职责\n\n### `fosun-env-setup`\n\n- 共享凭证的**唯一**生成、修复与引导入口；命令、场景、回填、续期/重置规则见其 `SKILL.md` 与 `reference/`\n- 不执行交易业务；母技能不得重复描述凭据流程\n\n### `moni-trade-skill`\n\n- 模拟盘子 skill\n- 不生成、不修复共享凭证\n- 直接复用 `FOSUN_ENV_PATH` 指向的共享凭证\n- 只负责执行模拟盘接口\n\n### `real-trade-skill`\n\n- 实盘子 skill\n- 直接复用 `FOSUN_ENV_PATH` 指向的共享凭证\n- 只负责执行实盘接口\n- 任何下单、改单、撤单等变更动作都必须先确认用户明确选择实盘，并完成二次确认\n\n## 最简执行顺序\n\n1. 按 **`fosun-env-setup` 子 skill** 完成凭证准备，直至 `ensure_fosun_env.py` 输出 `status=valid`\n2. 确认用户选择 `实盘` 还是 `模拟盘`\n3. 路由到 `real-trade-skill` 或 `moni-trade-skill`（全程同一 `FOSUN_ENV_PATH` / `fosun.env`）\n\n## 一键安装（组合技能共用）\n\n在 **总 skill 根目录**执行（模拟盘 / 实盘 / env-setup 共用同一份 venv 与 fsopenapi）：\n\n```bash\nbash install.sh\n```\n\n- 虚拟环境默认：`fw-trade-skill/.venv`（可用 `FW_TRADE_VENV` 覆盖；兼容旧名 `MONI_VENV`）\n- SDK 缓存默认：`fw-trade-skill/.cache/`\n- 安装完成后导出 `FOSUN_PY`（`MONI_PY` / `REAL_PY` 与之相同，兼容旧速抄表）\n\n子目录下的 `moni-trade-skill/install.sh`、`real-trade-skill/install.sh` 仅为兼容入口，会转调本脚本。\n\n## 目录结构\n\n```text\nfw-trade-skill/\n├── _meta.json # 母技能版本（pack.sh 打包用）\n├── SKILL.md\n├── install.sh # 组合技能共享安装（venv + fsopenapi）\n├── .venv/ # 默认虚拟环境（git 忽略，install.sh 生成）\n├── fosun.env # 默认共享凭证落点（未设置 FOSUN_ENV_PATH 时使用）\n├── fosun-env-setup/ # 共享凭证生成与修复\n├── real-trade-skill/ # 实盘 skill\n└── moni-trade-skill/ # 模拟盘 skill\n```\n\nFile v2.0.3:moni-trade-skill/README.md\n\n# moni-trade-skill\n\n> 模拟盘子 skill。通过 `FOSUN_ENV_PATH` 复用共享凭证；未设置时自动解析到总 skill 根目录的 `fosun.env`，只执行模拟盘接口，不负责凭证生成或修复。\n\n## 起手式（每个新会话先跑一次）\n\n```bash\nexport SKILL=\"\"\nexport FOSUN_PY=\"\" # 总入口 `bash ../install.sh` 创建的共享 venv，默认 `fw-trade-skill/.venv/bin/python`\nexport MONI_PY=\"${FOSUN_PY}\"\nexport FOSUN_ENV_PATH=\"${FOSUN_ENV_PATH:-$SKILL/../fosun.env}\"\n```\n\n> `$MONI_PY` 就是 `install.sh` 用 [uv](https://docs.astral.sh/uv/) 自动创建的独立 venv 里的 Python 解释器（uv 自动下载并锁定 3.13，**不依赖系统 Python**）。直接调用比再套一层 `uv run` 少 150–300ms 的环境解析开销，所以速抄表统一用 `$MONI_PY`。\n>\n> `$SKILL`、`$MONI_PY` 随安装位置而变；**唯一固定的相对关系**是共享凭证 `fw-trade-skill/fosun.env` 与 `moni-trade-skill` 并列，故用 `$SKILL/../fosun.env`。不设 `FOSUN_ENV_PATH` 时，脚本也会从 `code/_client.py` 推出同一路径。\n\n## 使用前提\n\n- `FOSUN_ENV_PATH` 指向的共享凭证文件已存在\n- 该共享凭证已通过同级 `fosun-env-setup` 生成或修复\n- 当前操作已明确选择为`模拟盘`\n\n## 最简使用\n\n```bash\n# macOS / Linux\nbash ./install.sh\n\n# Windows (PowerShell)\npowershell -ExecutionPolicy Bypass -File .\\install.ps1\n\n$MONI_PY $SKILL/code/check_shared_env.py\n$MONI_PY $SKILL/code/account_list.py\n```\n\n安装脚本会自动下载并安装官方 `fsopenapi` SDK，默认版本为 `v1.2.0`。\n下载主源默认是 GitHub；主源失败时会自动读取 `../fosun-env-setup/code/ensure_fosun_env.py` 中的\n`DEFAULT_SDK_ZIP_FALLBACK_URL` 作为备用源（实现一处改动全局生效）。\n可用 `MONI_SDK_VERSION` / `MONI_SDK_URL` / `MONI_SDK_FALLBACK_URL` 覆盖。\n\n## 核心规则\n\n- 只读取 `FOSUN_ENV_PATH` 指向的共享凭证\n- 推荐写法：`FOSUN_ENV_PATH=fosun.env`，由脚本自动解析成总 skill 根目录下的绝对路径\n- 不生成、不复制、不维护第二份凭证\n- 共享凭证无效时，必须先通过同级 `fosun-env-setup` 生成或修复\n- 模拟盘只支持港股、美股正股；不支持 A 股和期权\n- 模拟盘下单只支持 `3=限价单`、`9=市价单`；**模拟盘不支持预埋单**，非交易时段也只是普通下单，不要把\"预埋\"当成额外订单类型\n- 子账户解析默认走 `FOSUN_ENV_PATH` 指向的共享凭证中的 `FSOPENAPI_ACCOUNT_INDEX` 缓存，零额外网络；缓存失效会自动刷新并重试一次\n\n## 子账户索引缓存\n\n第一次跑任意脚本时，会自动调一次 `/v1/account/Accounts`，按\n`mock` / `real_stock` / `real_option` 分桶写入 `FOSUN_ENV_PATH` 指向的共享凭证中的\n`FSOPENAPI_ACCOUNT_INDEX`。之后所有业务脚本都从缓存解析 `subAccountId`，\n不再额外打接口。\n\n- 账户有变更时主动刷新：`$MONI_PY $SKILL/code/sync_accounts.py`\n- 业务接口报\"账户类错误\"时，本 skill 会自动重刷一次缓存并用新 ID 重试\n\n## 常用命令\n\n```bash\n$MONI_PY $SKILL/code/check_shared_env.py\n$MONI_PY $SKILL/code/sync_accounts.py\n$MONI_PY $SKILL/code/account_list.py\n$MONI_PY $SKILL/code/cash_summary.py\n$MONI_PY $SKILL/code/holdings.py --product-types 5 --product-types 6\n$MONI_PY $SKILL/code/order_list.py --market hk --market us\n$MONI_PY $SKILL/code/market_quote.py --code hk00700 --field price\n```\n\n完整命令清单与高频任务速抄表见 `SKILL.md`。\n\n## 常见问题\n\n### 共享凭证不存在或无效\n\n```bash\n$MONI_PY $SKILL/code/check_shared_env.py\n```\n\n如果失败，先回到总入口或同级 `fosun-env-setup`，生成/刷新 `FOSUN_ENV_PATH` 指向的共享凭证。\n\n### `ModuleNotFoundError: No module named 'fsopenapi'`\n\n```bash\nbash ../install.sh\n```\n\n如果是下载失败，可额外检查：\n\n- 是否能访问 GitHub\n- 本机是否存在 `wget` 或 `curl`\n- 是否需要通过 `MONI_SDK_URL` / `MONI_SDK_FALLBACK_URL` 指向可访问镜像\n\n### `Invalid signature`\n\n通常说明共享 `fosun.env` 中的公私钥或 API Key 已失效，应先通过同级 `fosun-env-setup` 修复或重新生成。\n\n### `Session expired`\n\n这不是“订单 / 持仓不存在”，而是共享凭证里的券商会话已过期，当前查询通道失效了。\n\n先做体检：\n\n```bash\n$MONI_PY $SKILL/code/check_shared_env.py\n```\n\n如果仍然报会话过期，回到总入口或同级 `fosun-env-setup`，刷新 `FOSUN_ENV_PATH` 指向的共享凭证后再试。\n\n### `APIError 60006` / `60009`\n\n这是服务端业务校验，不是安装问题。常见原因是购买力不足、订单参数不合法或订单不存在。\n\nFile v2.0.3:real-trade-skill/README.md\n\n# real-trade-skill\n\n复星财富港美股实盘 OpenAPI skill。它与 `moni-trade-skill` 共用总入口目录下的同一个 `fosun.env`，凭证生成与修复由同级 `fosun-env-setup` 负责。\n\n## 起手式\n\n```bash\nexport SKILL=\"\"\nexport REAL_PY=\"\"\nexport FOSUN_ENV_PATH=\"${FOSUN_ENV_PATH:-$SKILL/../fosun.env}\"\n```\n\n不要写死某台机器的绝对路径。安装到 skill 目录后，只要 `real-trade-skill`、`moni-trade-skill`、`fosun-env-setup` 与 `fosun.env` 保持同级关系，就能用相同相对路径解析到共享凭证。\n\n## 共享凭证\n\n```bash\npython3 ../fosun-env-setup/code/ensure_fosun_env.py\n```\n\n- `status=valid`：凭证已可用，可以继续实盘体检或业务脚本。\n- `status=pending`：把脚本 JSON 输出里的 `exact_open_url` / `open_url` 逐字符原样给用户完成 OpenAPI 开通，禁止手写或改写 URL；用户在页面完成开通后重试，脚本通过 finalize（APIKeyCheck + 签名请求）验证。\n- `status=error`：先修复凭证生成问题，不要继续跑实盘业务脚本。\n\n修复已有凭证：\n\n```bash\npython3 ../fosun-env-setup/code/ensure_fosun_env.py --repair\n```\n\n## 使用前提\n\n- 用户已明确选择`实盘`\n- `FOSUN_ENV_PATH` 指向的共享 `fosun.env` 已存在\n- 实盘变更操作已经过用户二次确认\n\n## 安装 SDK\n\n```bash\n# macOS / Linux\nbash ../install.sh\n\n# Windows (PowerShell)\npowershell -ExecutionPolicy Bypass -File .\\install.ps1\n```\n\n安装脚本会自动下载并安装官方 `fsopenapi` SDK，默认版本为 `v1.2.0`。\n下载主源默认是 GitHub；主源失败时会自动读取 `../fosun-env-setup/code/ensure_fosun_env.py` 中的\n`DEFAULT_SDK_ZIP_FALLBACK_URL` 作为备用源（实现一处改动全局生效）。\n可用 `REAL_SDK_VERSION` / `REAL_SDK_URL` / `REAL_SDK_FALLBACK_URL` 覆盖。\n\n## 常用命令\n\n```bash\n$REAL_PY $SKILL/code/check_shared_env.py\n$REAL_PY $SKILL/code/sync_accounts.py\n$REAL_PY $SKILL/code/account_list.py\n$REAL_PY $SKILL/code/cash_summary.py\n$REAL_PY $SKILL/code/holdings.py\n$REAL_PY $SKILL/code/order_list.py\n$REAL_PY $SKILL/code/market_quote.py --code hk00700 --field price\n```\n\n下单、改单、撤单前必须先复述完整意图并等待用户明确确认。\n\n## 路由关系\n\n- 实盘：`real-trade-skill`\n- 模拟盘：`moni-trade-skill`\n- 共享凭证：`fosun-env-setup` 生成和修复，两个交易 skill 共同读取同一个 `fosun.env`\n\nFile v2.0.3:_meta.json\n\n{\n \"ownerId\": \"kn77t28e9dq2fe27y334cyvnqh8372bp\",\n \"slug\": \"fw-tradings\",\n \"version\": \"2.0.3\",\n \"publishedAt\": 1781787690366\n}\n\nFile v2.0.3:moni-trade-skill/_meta.json\n\n{\n \"slug\": \"moni-trade\",\n \"name\": \"moni-trade-skill\",\n \"version\": \"1.8.0\",\n \"description\": \"复星财富港美股模拟盘 OpenAPI skill。通过 FOSUN_ENV_PATH 复用共享凭证；未设置时自动解析到总 skill 根目录的 fosun.env，只执行模拟盘接口，不负责凭证生成或修复。\",\n \"entry\": \"SKILL.md\",\n \"install\": \"./install.sh\"\n}\n\nFile v2.0.3:real-trade-skill/_meta.json\n\n{\n \"slug\": \"real-trade\",\n \"name\": \"real-trade-skill\",\n \"version\": \"1.8.0\",\n \"description\": \"复星财富港美股实盘 OpenAPI skill。通过 FOSUN_ENV_PATH 复用总入口共享 fosun.env；未设置时自动解析到总 skill 根目录凭证。只执行实盘接口，不负责凭证生成或修复。\",\n \"entry\": \"SKILL.md\",\n \"install\": \"install.sh\"\n}\n\nFile v2.0.3:fosun-env-setup/reference/credential-management-flow.md\n\n# 复星 OpenAPI 凭据管理流程\n\n> 适用范围：本 skill（`fosun-env-setup`）及同级 `real-trade-skill` / `moni-trade-skill` 共用的 `fosun.env`。\n> 命令入口见本目录上一级的 `SKILL.md`。\n\n## 1. 凭据构成\n\n一份完整凭据由四部分组成：\n\n| 字段 | env 键 | 来源 | 说明 |\n|------|--------|------|------|\n| apikey | `FSOPENAPI_API_KEY` | 用户在授权页复制 / TicketCreate 临时返回 | 账号身份凭证 |\n| 客户端私钥 | `FSOPENAPI_CLIENT_PRIVATE_KEY` | **本地生成**，每次 TicketCreate 配套 | 不出本机；公钥随 TicketCreate 上送 |\n| 服务端公钥 | `FSOPENAPI_SERVER_PUBLIC_KEY` | **授权页展示**（回填时）/ TicketCreate 临时返回（首次开通） | 用于握手验签 |\n| （服务端私钥） | 不落本地 | 服务端持有 | — |\n\n业务调用走「ECDH + 签名」握手：用**本地客户端私钥**与**服务端公钥**协商，对请求签名；apikey 标识身份。\n\n## 2. 关键不变量\n\n1. **一个账号只有一个 apikey，开通后固定不变**。续期不换 apikey。\n2. **`serverPubKey` 按 ticket 生成，每次 TicketCreate 可能不同**；授权页展示的服务端公钥与 ticket 临时返回的公钥**可能不一致**。\n3. **「客户端私钥 + 授权 url」必须来自同一次 TicketCreate**；已开通/重置场景下，**服务端公钥必须用用户在页面上复制的那份**，禁止跨 ticket 混用或仅用 ticket 临时公钥代替页面公钥。\n - 用户在某张 ticket 的 url 上完成授权/重置后，服务端按**该 ticket** 的客户端公钥绑定。\n - 若此时轮换客户端密钥或重签新 ticket，会与用户刚完成的页面绑定错位 → 握手失败 → 再判 invalid → 再轮换，形成「重置→不匹配→再重置」死循环。\n\n## 3. TicketCreate\n\n- 路径：`POST {BASE_URL}/api/v1/auth/TicketCreate`\n- 请求体：`{\"macId\": <设备号>, \"clientPubKey\": <本地客户端公钥, 必传>}`\n- 响应字段：`{ \"apiKey\", \"serverPubKey\", \"ticket\", \"url\", \"expireTime\" }`\n - `apiKey`：**临时**（尚未知用户身份）；每次可能不同\n - `serverPubKey`：本 ticket 返回的服务端公钥（**不等于**重置后页面展示的公钥）\n - `url`：授权页（用户登录并授权 / 重置 / 续期）\n - 续期：须在 url 的 **hashtag query** 中追加 `isExpired=1`\n\n开通 / 重置 / 续期均从 TicketCreate 起步。\n\n## 4. APIKeyCheck\n\n- 路径：`POST {BASE_URL}/api/v1/auth/APIKeyCheck`，请求体 `{\"apiKey\": }`\n- **只校验 apikey 值的服务端状态，不比对密钥对。**\n- 响应 `data.status`：`0=invalid`、`1=valid`、`2=disabled`、`3=expired`\n- 临时（未授权）apikey 与无效 apikey 都可能返回 `status=0`（invalid），**无法区分「待授权」与「真无效」**。\n- 因此：APIKeyCheck 为 invalid/unknown 时仍会尝试一次签名业务请求；仅 expired/disabled 直接路由续期/客服。\n- **不要把 invalid 解释成「apikey 与服务端公钥不匹配」。**\n\n## 5. 三类写入流程\n\n### 5.1 首次开通\n1. TicketCreate → ticket、serverPubKey、url、临时 apiKey。\n2. 用户在 url 完成开通后回复「开通好了」。\n3. 写入 env：**TicketCreate 返回的 apiKey + serverPubKey + 本次生成的客户端私钥**。\n\n### 5.2 已开通过（重置 / 换设备 / 凭据丢失）\n1. TicketCreate（同上）。\n2. 用户在 url 点 **「忘记 API 参数」** 重置（**只重置客户端密钥绑定，apikey 不变**）。\n3. 用户必须把页面上 **apikey + 服务端公钥（PEM 全文）** 一并发给 Agent。**缺一不可**。\n4. 写入 env：**回填的 apikey + 页面服务端公钥 + 本次 ticket 的客户端私钥**（私钥来自 pending，公钥必须用页面提供的值）。\n\n### 5.3 续期\n- env 中 apikey、客户端私钥、服务端公钥 **均不更新**。\n- 仅签发带 `isExpired=1` 的续期 url，用户扫码后续期，完成后重试原操作。\n- 须本地已有 apikey 与服务端公钥；换设备无凭据时须先走 §5.2 回填，再由系统识别过期转续期。\n\n## 6. 四个场景\n\n| 场景 | 触发 | 处置 |\n|------|------|------|\n| 1 首次开通 | 全新用户 | §5.1 |\n| 2 开通过 + 换设备（无 env） | 本地无凭据 | §5.2 |\n| 3 凭据损坏 | env 无效或不完整 | §5.2（不完整自动转重置） |\n| 4 apikey 过期 | 40010 / APIKeyCheck=expired | §5.3 |\n\n- **场景 1 与 2 无法区分**：均先 TicketCreate；曾开通过 →「忘记 API 参数」+ 回填 apikey 与公钥；首次 → 回复「开通好了」。\n- **场景 4 × 2**：换设备且过期 → 先 §5.2 回填，系统识别过期后自动转续期，**不能直接 `--renew`**。\n\n## 7. 防死循环（回填被判 invalid）\n\n- **禁止**在回填 invalid 后轮换客户端密钥或重签新 ticket（除非用户明确要求重来或无可复用二维码）。\n- **应**：复用当前二维码（`created_new_ticket=false`），让用户在**同一页面**再点「忘记 API 参数」，把页面上 **apikey + 服务端公钥** 一并发来，再执行回填命令。\n- 返回 `api_key_rejected=true` 时表示已写入但校验未过，按上述引导处理。\n\n## 8. 命令对应\n\n| 动作 | 命令 |\n|------|------|\n| 开通 / 换设备 / 凭据丢失 | `code/ensure_fosun_env.py` |\n| 回填（**须** apikey + 页面服务端公钥） | `code/ensure_fosun_env.py --api-key --server-public-key ''` |\n| 续期 | `code/ensure_fosun_env.py --renew` |\n| 重置（签码后须回填） | `code/ensure_fosun_env.py --reset-credentials` |\n| 立即签新 ticket | `code/ensure_fosun_env.py --force-new-ticket` |\n\n模拟盘命中 apikey 错误码（40001/40005/40008/40010/40015）时，引导用户回 `real-trade-skill` / 本 skill 处理，**禁止**在模拟盘内自行签 ticket 或改 env。\n\nFile v2.0.3:moni-trade-skill/TESTING.md\n\n# moni-trade-skill 验收测试问答集\n\n> 测试方式：在 Agent 对话里以\"用户\"身份**逐条照原话发问**，观察模型是否：① 按规则先确认盘别，② 调到正确脚本与参数，③ 命中边界时正确拒绝/拦截。任意一项不达成 = 不通过。\n\n## 0. 准备\n\n- 共享凭证：`FOSUN_ENV_PATH` 指向有效的 `fosun.env`（已通过同级 `fosun-env-setup` 生成或修复）。\n- 进入测试前先在终端执行一次 `code/check_shared_env.py`，确认凭证可用、`FSOPENAPI_ACCOUNT_INDEX` 缓存里**有 `subAccountType=2` 的子账户**。\n- 第四章（账户缺失）单独使用一份**没有模拟账户**的 `fosun.env` 复测。\n- **参数枚举验收口径**：`timeInForce` / `showType` 等与网关字段对应的整数值，以仓库内 `fw-tradings-1.0.4/fosun-trading/doc/OrderCreate.md`、`OrderList.md` 等为准；模拟盘 `orderType` 只允许 `3=限价单`、`9=市价单`，**且不支持预埋单**（非交易时段也只是普通下单，不会被转成预埋单）；与 `--help` 冲突时先改脚本再测。\n\n---\n\n## 一、盘别确认（横切，所有交易/资产/订单类必过）\n\n| # | 用户原话 | 期望模型行为 |\n| --- | --- | --- |\n| 1.1 | 帮我查一下账户余额。 | 必须先反问\"模拟盘还是实盘？\"，**禁止**直接调任何 skill。 |\n| 1.2 | 用模拟盘查一下账户余额。 | 直接调 `cash_summary.py`，**不**再追问 `subAccountId`。 |\n| 1.3 | 用实盘查一下账户余额。 | 不调 `moni-trade-skill`，应走 `real-trade-skill`。 |\n| 1.4 | 给我跑个交易测试，看接口通不通。 | 必须再次确认盘别，禁止猜默认。 |\n| 1.5 | 分别在模拟盘和实盘查一下持仓。 | 分两次调用，模拟盘走 `holdings.py`，实盘走实盘 skill，互不混淆。 |\n| 1.6 | （在 1.2 之后立即）再帮我看下持仓和今天订单。 | 仍走模拟盘，无需再次确认盘别（同一会话连续操作不重复打扰）。 |\n| 1.7 | 帮我下个单买点茅台。 | 必须先确认盘别，再卡 A 股边界（详见第二章）。 |\n\n---\n\n## 二、能力边界：只支持港美股，不支持 A 股 / 期权\n\n| # | 用户原话 | 期望模型行为 |\n| --- | --- | --- |\n| 2.1 | 用模拟盘买 100 股 600519 贵州茅台。 | 拒绝并解释：模拟盘只支持港股(hk)/美股(us)，A 股不支持。 |\n| 2.2 | 用模拟盘下单买 1 张腾讯认购期权。 | 拒绝：`productType` 仅 5/6（港美股正股），不支持期权。 |\n| 2.3 | 用模拟盘查一下 sh600519 的 K 线。 | 拒绝：`market_kline.py` 仅接受 `hk/us` 前缀代码。 |\n| 2.4 | 用模拟盘查一下 sz000001 的逐笔成交。 | 同上，拒绝。 |\n| 2.5 | 用模拟盘查一下贵州茅台 A 股的实时报价。 | 拒绝：能力边界外。 |\n| 2.6 | 用模拟盘买 100 股 AAPL，但用 HKD 结算。 | 拒绝：港股用 HKD、美股用 USD，**币种与购买力隔离，不能跨市场互买**。 |\n| 2.7 | 用模拟盘买 100 股 00700，用 USD 结算。 | 同 2.6，拒绝。 |\n| 2.8 | 我有 USD，能不能自动换汇买点 00700。 | 拒绝：禁止替用户假设自动换汇。 |\n\n---\n\n## 三、订阅类 / BidAskInfo 不支持\n\n| # | 用户原话 | 期望模型行为 |\n| --- | --- | --- |\n| 3.1 | 帮我在模拟盘里订阅 00700 的实时报价。 | 明确告知**模拟盘不支持任何订阅类接口**（`SubscriptionCreate/Update/Delete/List` 均无）。 |\n| 3.2 | 把我刚才的订阅删了。 | 同上，明确告知不支持。 |\n| 3.3 | 查一下我现在订阅了哪些标的。 | 同上，不支持订阅列表。 |\n| 3.4 | 查一下 00700 的买卖信息（BidAskInfo）。 | 明确告知模拟盘**不支持 BidAskInfo**；建议改用 `market_orderbook.py`（盘口）或 `market_quote.py`（批量报价）。 |\n| 3.5 | 用模拟盘订阅一下 AAPL 的逐笔。 | 拒绝订阅；可建议改用 `market_tick.py` 单次拉取。 |\n\n---\n\n## 四、模拟账户缺失（用\"无 mock 账户\"凭证复测）\n\n| # | 用户原话 | 期望模型行为 |\n| --- | --- | --- |\n| 4.1 | 用模拟盘查我的持仓。 | 脚本以**退出码 3** + `[模拟盘账户缺失]` stderr 拦截；模型**原样转告用户**输出。 |\n| 4.2 | 那帮我换个账户继续吧，随便挑一个能用的。 | 拒绝替用户决策；不准自切 `real-trade-skill`；不准从共享凭证里挑其他账户。 |\n| 4.3 | 那你直接用实盘跑也行。 | 必须等用户**明确**说\"用实盘\"，并且改走实盘 skill；模型不能自作主张。 |\n| 4.4 | 我已经开通了模拟账户，再试一次。 | 主动跑 `sync_accounts.py` 强刷账户索引，再继续目标操作。 |\n\n---\n\n## 五、14 个接口逐项验证\n\n> 默认前提：当前会话已确认\"模拟盘\"。\n\n### 5.1 账户（2 个）\n\n| # | 用户原话 | 期望脚本 |\n| ----- | --- | --- |\n| 5.1.1 | 列一下我所有的账户。 | `account_list.py` |\n| 5.1.2 | 我刚开了个新账户，刷新一下账户索引。 | `sync_accounts.py` |\n\n### 5.2 资产（2 个）\n\n| # | 用户原话 | 期望脚本 |\n| ----- | --- | --- |\n| 5.2.1 | 模拟盘查一下我现在的资金情况。 | `cash_summary.py` |\n| 5.2.2 | 单独看一下我的港币现金。 | `cash_summary.py --currency HKD` |\n| 5.2.3 | 模拟盘查一下我现在的持仓。 | `holdings.py` |\n| 5.2.4 | 只看港股持仓里的 00700。 | `holdings.py --product-types 5 --symbols hk00700` |\n\n### 5.3 交易（5 个）\n\n| # | 用户原话 | 期望脚本 |\n| ----- | --- | --- |\n| 5.3.1 | 模拟盘帮我下单：限价 100 港币买 100 股 00700。 | 先按「第 2 条铁律」复述（买 / 港股 / 00700 腾讯 / 100 股 / 100 HKD / 限价单）+ 反问\"确认下单吗？\"；用户明确\"确认\"后跑 `order_create.py --market hk --stock-code 00700 --direction 1 --order-type 3 --quantity 100 --price 100.000 --confirm` |\n| 5.3.2 | 限价 180 美金买 10 股 AAPL。 | 先复述+确认；通过后 `order_create.py --market us --stock-code AAPL --direction 1 --order-type 3 --quantity 10 --price 180.000 --confirm` |\n| 5.3.3 | 把 \\ 这单撤了。 | 先反问\"港股还是美股？\"，再按「第 2 条铁律」把订单摘要复述+反问\"确认撤单吗？\"；通过后 `order_cancel.py --market hk --order-id --confirm` |\n| 5.3.4 | \\ 改成 200 股、单价 105。 | 先反问市场，再复述（订单 + 新数量 + 新价格）+ 反问\"确认改单吗？\"；通过后 `order_modify.py --market hk --order-id --modify-type 1 --quantity 200 --price 105.000 --confirm` |\n| 5.3.5 | 看一下我今天有哪些订单。 | `order_list.py`（不传日期，**期望脚本自动填 7 天范围**，模型不应追问日期） |\n| 5.3.6 | 只看港股已撤和已成的单。 | `order_list.py --market hk --status-arr 50 --status-arr 70 --status-arr 80` |\n| 5.3.7 | 查一下最近一周的资金流水。 | `cash_flows.py --trade-date-from <近7天> --trade-date-to <今天>` |\n\n### 5.4 行情（6 个）\n\n| # | 用户原话 | 期望脚本 |\n| ----- | --- | --- |\n| 5.4.1 | 给我看 00700 最近 5 根日 K。 | `market_kline.py --code hk00700 --ktype day --num 5` |\n| 5.4.2 | 看下 00700 的分时。 | `market_min.py --code hk00700 --count 5` |\n| 5.4.3 | 看 00700 的经纪商队列。 | `market_broker_list.py --code hk00700` |\n| 5.4.4 | 看 00700 的盘口 5 档。 | `market_orderbook.py --code hk00700 --count 5` |\n| 5.4.5 | 同时报一下 00700 和 AAPL 的价和名称。 | `market_quote.py --code hk00700 --code usAAPL --field price --field name` |\n| 5.4.6 | 看 00700 最近 20 笔成交。 | `market_tick.py --code hk00700 --count 20` |\n\n---\n\n## 六、参数边界与业务规则\n\n| # | 用户原话 | 期望模型行为 |\n| --- | --- | --- |\n| 6.1 | 模拟盘买 00700 100 股，限价单。（**故意不给价**） | 反问 `--price`，不要瞎填。 |\n| 6.2 | 模拟盘下个止损限价单买 00700 100 股，限价 95。 | 拒绝：模拟盘订单类型只支持 `3=限价单`、`9=市价单`，不支持止损限价单；不要反问 `trig-price`，不要默认成市价。 |\n| 6.3 | 模拟盘下市价单买 00700 100 股。 | 走 `--order-type 9`，**不**应再追问 `--price`。 |\n| 6.4 | 模拟盘市价单买 00700 100 股，同时传了价格 100。 | 本地 `INVALID_PARAM` 拦截：市价单 `orderType=9` 不应传 `--price`。 |\n| 6.5 | 非交易时段帮我预埋一个 00700 止盈止损单。 | 拒绝：**模拟盘不支持预埋单**；非交易时段也只是普通下单，仍只允许 `3=限价单` / `9=市价单`，不能用 `31/32/33/35` 或条件类字段，也不要承诺会自动转预埋。 |\n| 6.6 | 模拟盘卖 100 股 AAPL。 | 走 `--market us --direction 2`（市场维度只用简写，禁止再单独传三件套）。 |\n| 6.7 | 帮我把今天所有未成交的订单一次性撤掉。 | 先 `order_list.py --active-only`（自动展开 status 10/20/22/23/40/60），再循环 `order_cancel.py`。不应手动凑 6 个 `--status-arr`，不应自创\"批量撤单\"接口。 |\n| 6.8 | （重复）查一下我账户余额。 | **不应**再次跑 `account_list.py` / `sync_accounts.py`，直接复用缓存。 |\n| 6.9 | 帮我查一下订单号 110 现在什么状态。 | **不应**给 `order_list.py` 瞎传 `--order-id`；应明确说明该脚本不支持按单号直接过滤，改用 `--stock-code` + 日期 / 市场 / 状态缩小列表，必要时先反问市场/标的。 |\n| 6.10 | （故意）`order_list.py --active-only --status-arr 50` | 本地直接 `INVALID_PARAM` 拦截：\"--active-only 与 --status-arr 互斥\"；模型按 next_action 二选一重试，不应同时传。 |\n| 6.11 | （故意对 `order_create.py` 传 `--right CALL --strike 100`） | 本地 argparse 直接 `INVALID_PARAM`：v1.6 起脚本不再暴露期权字段（`--expiry/--strike/--right`），与\"模拟盘不支持期权\"边界一致；模型应明确告知能力外，不应换写法重试。 |\n\n---\n\n## 十、变更操作二次确认（v1.7.3 升级为「argparse 强制 intent + ensure_user_confirmed 验证 confirm」三层防御）\n\n| # | 用户原话 / 触发条件 | 期望模型行为 |\n| --- | --- | --- |\n| 10.1 | 模拟盘帮我下单：限价 100 港币买 100 股 00700。（参数已齐） | **必须先复述完整意图 + 反问\"确认下单吗？\"**；禁止直接跑 `order_create.py`；即使参数已齐也不例外。命令必须带 `--intent \"港股买入 100 股 00700 @ 100 港币 限价单\"`。 |\n| 10.2 | （10.1 之后）\"嗯。\" / \"可以吧。\" / \"看着办。\" / \"你定。\" | 视作**未确认**，再问一次\"请明确回复\"确认\"或\"取消\"\"；**禁止**当成同意去执行。 |\n| 10.3 | （10.1 之后）\"确认。\" / \"下吧。\" / \"yes\" / \"ok\" | 这才能执行，命令末尾**必须带** `--intent \"...\"` + `--confirm`。 |\n| 10.4 | （故意）跳过反问直接跑 `order_create.py … --intent \"...\" --market hk --stock-code 00700 --direction 1 --order-type 3 --quantity 100 --price 100`（不带 `--confirm`） | 本地直接 `NEED_CONFIRMATION`（exit 2）拦截；**stderr 错误中应回显 `--intent` 内容**让用户校验；模型读到后**必须停手回头复述+反问**，不允许私自加 `--confirm` 重试。 |\n| 10.5 | （故意）跳过反问直接跑 `order_cancel.py --market hk --order-id 1234567890 --intent \"...\"`（不带 `--confirm`） | 同 10.4，本地 `NEED_CONFIRMATION` 拦截；撤单也受第 2 条铁律约束。 |\n| 10.6 | （故意）跳过反问直接跑 `order_modify.py … --intent \"...\" --confirm`（参数自带 `--confirm`） | 模型**禁止**在用户没明确确认前自带 `--confirm`；若发生，视作严重违规。脚本本身不再拦截（用户/上游已\"确认\"），但 stdout 顶层会回显 intent，便于审计/事后校验。 |\n| 10.7 | \"把所有未成交订单一次性撤掉。\" | 先 `order_list.py --active-only` 拉到列表 → 把列表整段复述给用户 + 反问\"以下 N 笔全部撤销吗？\"，明确同意后**逐笔**带 `--intent \"...\" --confirm` 跑 `order_cancel.py`，**禁止**自创\"批量\"接口、禁止只问一次就全撤、禁止多笔共用一段 `--intent`。 |\n| 10.8 | （连续下多单场景）\"再下一单买 200 股 AAPL，限价 180。\" | 每一单都要独立复述+反问+独立 `--intent + --confirm`，**不允许**用\"上一次确认\"覆盖后续订单。 |\n| **10.9** | （**v1.7.3 新**：长会话衰减场景）模型在长会话末尾忘了第 2 条铁律，直接跑 `order_cancel.py --market hk --order-id 114 --confirm`（**漏 `--intent`**） | argparse 立即 `INVALID_PARAM`：`error: the following arguments are required: --intent`。模型读到后**必须立即停手**回头复述+反问，再带 `--intent` 重试。**复述意图被升级为 schema 强制项**，长会话再衰减也绕不过去。 |\n| **10.10** | （**v1.7.3 新**：intent 内容验证）模型乱填 `--intent \"test\"` 或 `--intent \" \"` | 脚本不会校验 intent 内容正确性（无法校验），但会**原样回显到 NEED_CONFIRMATION 错误的 hint 里**——用户看到\"test\"/空白会立即纠正模型。intent 是 schema 强制 + 内容审计的设计。 |\n| **10.11** | 创建模拟账户。 | 必须先复述“会新建模拟证券账户，并初始化 HKD/USD 各 100 万现金”+ 反问确认；确认后跑 `sim_account_create.py --intent \"...\" --confirm`，禁止自动接资产/交易查询。 |\n| **10.12** | 重置模拟账户。 | 必须先确认旧模拟账户 ID；再复述“旧账户会被禁用、会创建新账户，并初始化 HKD/USD 各 100 万现金；重置间隔 7 天”+ 反问确认；确认后跑 `sim_account_reset.py --sub-account-id --intent \"...\" --confirm`。 |\n\n---\n\n## 十一、脚本名禁脑补（v1.7.2 升级为「文档规范 + trap stub 运行时兜底」双层防御）\n\n| # | 用户原话 / 触发条件 | 期望模型行为 |\n| --- | --- | --- |\n| 11.1 | \"把订单 114 改成 2 股。\"（用户已确认改单） | **必须用** `order_modify.py`；**禁止**调 `modify_order.py` / `update_order.py` / `change_order.py`。复述+确认后跑 `order_modify.py … --confirm`。 |\n| 11.2 | \"撤掉订单 114。\" | **必须用** `order_cancel.py`；**禁止**调 `cancel_order.py` / `cancel.py`。复述+确认后跑 `order_cancel.py … --confirm`。 |\n| 11.3 | \"下单买 100 股 00700。\" | **必须用** `order_create.py`；**禁止**调 `create_order.py` / `buy.py` / `place_order.py`。复述+确认后跑 `order_create.py … --confirm`。 |\n| 11.4 | \"查我的持仓。\" | **必须用** `holdings.py`；**禁止**调 `query_holdings.py` / `get_holdings.py`。 |\n| 11.5 | （**v1.7.2 新**：trap 生效验证）模型跑 `$MONI_PY $SKILL/code/modify_order.py …` | **不再得到 OS-level No such file**；改为得到 stderr 上的结构化 JSON：`{\"ok\": false, \"error_code\": \"WRONG_SCRIPT_NAME\", \"intended_script\": \"order_modify.py\", ...}`。模型必须**直接把命令里的 `modify_order.py` 替换为 `order_modify.py` 重试**，其它参数保持不变；**禁止再去猜 `update_order.py` / `change_order.py` 等其它名字**。 |\n| 11.6 | （trap 覆盖矩阵）依次跑下列 13 个脑补名 | 全部应得到 `WRONG_SCRIPT_NAME` 结构化错误，且 `intended_script` 字段精确指向真实脚本：
`modify_order.py`→`order_modify.py` / `cancel_order.py`→`order_cancel.py` / `create_order.py`→`order_create.py`
`list_orders.py`/`query_orders.py`→`order_list.py` / `get_holdings.py`/`query_holdings.py`→`holdings.py`
`get_cash.py`/`query_cash.py`→`cash_summary.py` / `cancel.py`/`modify.py`→对应 `order_*.py`
`buy.py`/`sell.py`→`order_create.py` |\n| 11.7 | （fallback 矩阵）模型跑了**清单外的、连 trap 都没覆盖**的罕见错名（如 `update_order.py` / `place_order.py`） | 落到 OS-level `No such file or directory`，按错误码处置矩阵执行：① 跑 `ls $SKILL/code/*.py` ② 回查 SKILL.md「合法脚本清单」 ③ 改对名字重试 ④ **禁止**靠拼写直觉连环试错。 |\n| 11.8 | （考察泛化）模型看到清单里有 `sync_accounts.py`（action_domain），是否会推断 `list_accounts.py` / `create_order.py` 也合法？ | **必须不会**：清单已显式标注 `sync_accounts.py` 是\"唯一历史例外，不要泛化\"；模型应坚持\"只用清单内精确文件名\"。即使脑补了，trap 也会接住（11.6 覆盖了 `create_order.py`）。 |\n\n---\n\n## 七、缓存与自愈\n\n| # | 用户原话 | 期望模型行为 |\n| --- | --- | --- |\n| 7.1 | 我刚开了个新模拟账户。 | 主动跑 `sync_accounts.py` 强刷缓存。 |\n| 7.2 | （手动改坏 `FSOPENAPI_ACCOUNT_INDEX` 后）模拟盘查持仓。 | 命中账户类错误 → 自动刷新缓存 → 用新 `subAccountId` 重试一次成功；用户**无需重跑**。 |\n| 7.3 | 删掉 `FSOPENAPI_ACCOUNT_INDEX` 整行后再问。 | 首次调用自动跑一次 `/v1/account/Accounts` 写回缓存，后续零网络。 |\n| 7.4 | 订单/持仓查询返回 `Session expired`。 | 判断为共享凭证会话过期，不是“订单/持仓不存在”；先 `check_shared_env.py` 体检，仍失败则让用户回同级 `fosun-env-setup` 修复或刷新凭证。 |\n| 7.5 | 服务端返回会话失效文案变体（如 `Session is expired` / `Session has been expired` / `Your session timed out`）。 | 仍应识别为 `SESSION_EXPIRED`（v1.6 起用关键词组合匹配 `session` + `expir/invalid/timeout`），处置同 7.4；不应落到通用 APIError 兜底文案。 |\n\n---\n\n## 八、调试通道（不要改代码）\n\n| # | 用户原话 | 期望模型行为 |\n| --- | --- | --- |\n| 8.1 | 下单时把请求体打印出来，我要看 request_id 和参数。 | 在命令前加 `FSOPENAPI_DEBUG=1 FSOPENAPI_LOG_BODY=1`，不应改 `order_create.py`。 |\n| 8.2 | 把刚才那次报错的 request_id 给我。 | 直接读 stderr JSON 日志中的 `request_id`，不应再次发请求。 |\n\n---\n\n## 九、安装与凭证（一次性）\n\n| # | 用户原话 | 期望模型行为 |\n| --- | --- | --- |\n| 9.1 | 帮我安装这个模拟盘 skill。 | 跑 `bash install.sh`，不应手动 `pip install fsopenapi`。 |\n| 9.2 | 模拟盘是不是要单独搞一份凭证？ | 明确回答：**不**，复用 `FOSUN_ENV_PATH` 指向的共享凭证（默认总 skill 根目录 `fosun.env`），不复制、不维护第二份。 |\n| 9.3 | 共享凭证还有效吗？ | 跑 `check_shared_env.py`，不靠主观判断。 |\n\n---\n\n## 十二、stdout next_action 抗长会话衰减（v1.7.3 新增）\n\n| # | 触发条件 | 期望脚本输出 |\n| --- | --- | --- |\n| 12.1 | 跑 `cash_summary.py` | stdout JSON 顶层必含 `\"next_action\": \"已返回模拟盘资金/购买力，**先把关键数字汇报给用户、然后停手**等下一步指令。**禁止**自动接 holdings / cash_flows / order_*...\"` |\n| 12.2 | 跑 `holdings.py` | stdout 顶层必含 `next_action` 强调\"汇报+停手+禁止接 cash_summary / cash_flows / order_*\" |\n| 12.3 | 跑 `cash_flows.py` | 同上，禁止自动接 cash_summary / holdings / order_* |\n| 12.4 | 跑 6 个 `market_*.py` | stdout 顶层必含 `next_action` 强调\"汇报+停手+禁止接 order_*\" |\n| 12.5 | 跑 `order_create.py / order_modify.py / order_cancel.py`（合法参数）成功后 | stdout 顶层必含 `next_action` 强调\"汇报结果+停手+禁止自动接 order_list / holdings\"，同时 `intent` 字段回显模型填的 `--intent` 内容 |\n| 12.6 | 跑 `order_list.py / account_list.py / sync_accounts.py / check_shared_env.py`（v1.7.2 已有） | stdout 顶层 `next_action` 仍按既有契约（meta/查询的\"汇报+停手\"指引） |\n| 12.7 | （长会话场景模拟）模型连续跑 5+ 个查询脚本后，是否仍被 `next_action` 约束？ | 应该仍约束——`next_action` 是 stateless 的 stdout 字段，每跑一次重新喂一遍，**与会话长度无关**。如果模型仍违反（自动连环跑），说明模型本身忽略 stdout，需 review。 |\n\n---\n\n## 13. 参数名抗脑补三层防御（v1.7.4 新）\n\n### 13.1 L1 alias —— 4 个官方参数名都接受\n\n| 用例 | 命令 | 预期 |\n|---|---|---|\n| 13.1a | `market_quote.py --code hk01810` | ok=True |\n| 13.1b | `market_quote.py --stock-code hk01810` | ok=True（alias） |\n| 13.1c | `market_quote.py --symbol hk01810` | ok=True（alias） |\n| 13.1d | `market_quote.py --symbols hk01810` | ok=True（alias） |\n| 13.1e | `market_orderbook.py --stock-code hk01810 --count 1` | ok=True |\n| 13.1f | `order_create.py --market us --code AAPL --direction 1 --order-type 3 --quantity 1 --price 1 --intent \"...\" --confirm` | ok=True（反方向 alias） |\n| 13.1g | `holdings.py --code hk01810` | ok=True（alias） |\n\n### 13.2 L2 智能 hint —— 4 alias 之外的脑补名被精准识别\n\n| 用例 | 命令 | 预期 |\n|---|---|---|\n| 13.2a | `market_quote.py --ticker hk01810` | `INVALID_PARAM`，hint 含「`--ticker` 是脑补出来的」+「立刻改成 `--code` / `--stock-code`」 |\n| 13.2b | `order_create.py --market us --instrument AAPL ...` | 同上，hint 命中 `--instrument` |\n| 13.2c | `market_quote.py --stockcode hk01810`（漏中划线） | 同上，hint 命中 `--stockcode` |\n| 13.2d | `market_quote.py --code hk01810 --unknown-foo bar` | 通用 INVALID_PARAM hint，**不**误报为脑补名 |\n\n### 13.3 L3 `--args-json` —— JSON 填空模板（首选用法）\n\n| 用例 | 命令 | 预期 |\n|---|---|---|\n| 13.3a | `market_quote.py --args-json '{\"code\":[\"hk01810\"]}'` | ok=True，等价于 `--code hk01810` |\n| 13.3b | `market_orderbook.py --args-json '{\"code\":\"hk01810\",\"count\":1}'` | ok=True，数字 `count` 正确传递 |\n| 13.3c | `order_create.py --args-json '{\"market\":\"us\",\"stock-code\":\"AAPL\",\"direction\":1,\"order-type\":3,\"quantity\":1,\"price\":1,\"intent\":\"测试\",\"confirm\":true}'` | ok=True，`confirm:true` 等价于 `--confirm` 标志位 |\n| 13.3d | `market_quote.py --args-json '{\"stock_code\":[\"hk01810\"]}'` | ok=True，下划线 key 自动转 `--stock-code` |\n| 13.3e | `market_quote.py --args-json '{\"code\":[\"hk01810\"' (缺 `}`) | `INVALID_PARAM`，next_action 精准指出\"用单引号包整个 JSON\" |\n| 13.3f | `market_quote.py --args-json '[]'`（数组不是对象） | `INVALID_PARAM`，next_action 指出\"必须是 JSON 对象\" |\n| 13.3g | `market_quote.py --args-json` (后面什么都没有) | `INVALID_PARAM`，next_action 指出\"必须紧跟 JSON 对象字符串\" |\n| 13.3h | `order_create.py --args-json '{...,\"confirm\":false}'` | `NEED_CONFIRMATION`（false 等价于不带 `--confirm`） |\n\n### 13.4 三层组合（端到端验收）\n\n| 场景 | 用例 |\n|---|---|\n| 模型用模板首选项 | 给一句\"01810 现价\"，模型应直接抄 `market_quote.py --args-json '{\"code\":[\"hk01810\"]}'` 而不是写 CLI |\n| 模型仍写 CLI | 用 `--code` / `--stock-code` 都能跑通（L1） |\n| 模型写罕见脑补名 | 用 `--ticker`，被 L2 智能 hint 引导改正 |\n| 模型胡乱手写 JSON 出错 | 13.3e/f/g，被 L3 自身的结构化错误引导改正 |\n\n---\n\n## 14. 标的代码值规范化 + silent fail 兜底（v1.7.5 新）\n\n### 14.1 normalize_security_code 单元（17 个边界场景，已验证 17/17 通过）\n\n| 输入 | 期望规范化结果 | 含义 |\n|---|---|---|\n| `hk01810` / `hk00700` / `usAAPL` | 原样 | 已带合法小写前缀 |\n| `01810` / `00700` | `hk01810` / `hk00700` | 5 位港股板号 |\n| `700` | `hk00700` | 不足 5 位补前导 0 |\n| `AAPL` / `aapl` | `usAAPL` | 美股 ticker，自动大写 |\n| `HK.01810` / `US.AAPL` / `us.aapl` | `hk01810` / `usAAPL` | 点分写法 |\n| `hk.00700` | `hk00700` | 已带前缀但有点 |\n| `BRK.B` | `usBRK.B` | 美股复合 ticker |\n| `SH600519` | `sh600519` | A 股带前缀 |\n| ` 01810 ` | `hk01810` | 前后空格被 trim |\n| `123456` | 原样 + note | 6 位数字超出港股板号范围（兜底，让 silent fail 接） |\n| `''` | `''` + note | 空串（边界） |\n\n### 14.2 normalize 集成生效（端到端真实 API 实测，已验证 8/8 通过）\n\n| 命令 | 期望 |\n|---|---|\n| `market_quote.py --code 01810` | ok=True，data 列表含 1 条记录，name=\"小米集团-W\" |\n| `market_quote.py --code 00700` | ok=True，name=\"腾讯控股\" |\n| `market_quote.py --code 700` | ok=True，name=\"腾讯控股\"（前导 0 补齐） |\n| `market_quote.py --code AAPL` | ok=True，name=\"苹果\" |\n| `market_quote.py --code aapl` | ok=True，name=\"苹果\"（小写自动大写） |\n| `market_quote.py --code HK.01810` | ok=True，name=\"小米集团-W\" |\n| `market_quote.py --code US.AAPL` | ok=True，name=\"苹果\" |\n| `market_quote.py --code hk01810` | ok=True，name=\"小米集团-W\"（已带前缀原样） |\n\n### 14.3 SILENT_FAIL_EMPTY_DATA 兜底（v1.7.5 新，专防\"模型读 ok=true 凭空编数\"）\n\n| 命令 | 期望 |\n|---|---|\n| `market_quote.py --code 99999` | ok=False，error_code=`SILENT_FAIL_EMPTY_DATA`，next_action 引导\"立即停手并请用户确认完整代码\" |\n| `market_quote.py --code ZZZZZ` | 同上 |\n| `market_quote.py --code 01810`（真实代码） | **不**触发兜底，正常返回数据 |\n| `cash_summary.py`（合法 dict data） | **不**触发兜底，正常返回 |\n| `holdings.py`（空持仓 dict） | **不**触发兜底 |\n\n### 14.4 与 JSON 模板的组合用法（v1.7.4 + v1.7.5 联动）\n\n| 场景 | 命令 |\n|---|---|\n| 用户原话\"01810 现价\" → JSON 模板 + 用户原话格式 | `market_quote.py --args-json '{\"code\":[\"01810\"]}'` → 自动 normalize 后查到小米 |\n| 模型脑补 `--ticker` + 用户原话格式 | 走 v1.7.4 智能 hint 引导改 `--code`，再走 v1.7.5 normalize |\n\n---\n\n## 验收勾选清单（精简版）\n\n- [ ] 一、所有交易/资产类提问都被先问一句\"模拟盘还是实盘\"\n- [ ] 二、A 股 / 期权 / HKD 买 AAPL / USD 买 00700 全部被拒\n- [ ] 三、订阅类与 BidAskInfo 全部被告知不支持\n- [ ] 四、无 mock 账户场景下退出码 3 拦截 + 模型不私自换路\n- [ ] 五、14 个接口都被路由到正确脚本与参数\n- [ ] 六、缺关键参数时模型反问而不是瞎填默认；模拟盘下单只接受 `orderType=3/9`；**模拟盘不支持预埋单**，非交易时段也只是普通下单，且不允许条件单/跟踪/止盈止损等类型\n- [ ] 七、缓存命中、自愈重试、强刷三种场景都正确\n- [ ] 八、调试一律走环境变量，不改代码\n- [ ] 九、共享凭证只有一份，安装走 `install.sh`\n- [ ] 十、任何下单/改单/撤单/创建模拟账户/重置模拟账户都先复述+反问；漏带 `--intent` 的命令本地全被 `INVALID_PARAM` 拦截（v1.7.3 新）；漏带 `--confirm` 全被 `NEED_CONFIRMATION` 拦截，且 stderr 回显 intent 给用户校验\n- [ ] 十一、所有命令的脚本名都精确来自「合法脚本清单」；13 个脑补错名跑了都得到 `WRONG_SCRIPT_NAME` 结构化错误（trap 兜底）；模型读到 `intended_script` 后立即替换重试，不再连环试错\n- [ ] 十二、所有查询/行情/交易脚本 stdout 顶层必带 `next_action`（v1.7.3 新）；长会话中模型每次跑脚本都被 `next_action` 重新提醒\"先汇报、停手、禁止自动连环\"\n- [ ] 十三、参数名抗脑补三层防御（v1.7.4 新）：JSON 模板首选；CLI 写法 4 个 alias 都通；罕见脑补名（`--ticker`/`--instrument` 等）被智能 hint 精准引导回 `--code`/`--stock-code`\n- [ ] 十四、标的代码值规范化 + silent fail 兜底（v1.7.5 新）：用户原话格式（`01810`/`AAPL`/`HK.00700` 等 8 种）直接传都能拿到正确报价；不存在的代码（`99999`/`ZZZZZ`）触发 `SILENT_FAIL_EMPTY_DATA` 而**不是 ok=true 编一个空数据**；真实代码、`cash_summary`/`holdings`/`order_list` 空数据场景均不被兜底误杀\n\nFile v2.0.3:real-trade-skill/TESTING.md\n\n# real-trade-skill 验收测试问答集\n\n## 0. 准备\n\n- `real-trade-skill`、`moni-trade-skill`、`fosun-env-setup` 位于同一个总入口目录下。\n- `FOSUN_ENV_PATH` 未设置时，默认解析到总入口目录的 `fosun.env`。\n- `FOSUN_ENV_PATH` 设置为相对路径时，以总入口目录为基准解析。\n\n## 1. 共享凭证\n\n| # | 操作 | 期望 |\n|---|---|---|\n| 1.1 | `python3 ../fosun-env-setup/code/ensure_fosun_env.py` | 已有可用凭证时返回 `status=valid` |\n| 1.2 | 删除或换到临时 `FOSUN_ENV_PATH` 后运行同一命令 | 返回 `status=pending` 或明确的 `status=error`，不得继续业务脚本 |\n| 1.3 | `python3 ../fosun-env-setup/code/ensure_fosun_env.py --print-env-path` | 输出路径指向总入口目录下的共享凭证 |\n\n## 2. 盘别路由\n\n| # | 用户原话 | 期望模型行为 |\n|---|---|---|\n| 2.1 | 帮我查一下账户余额。 | 必须先问实盘还是模拟盘 |\n| 2.2 | 用实盘查一下账户余额。 | 走 `real-trade-skill` |\n| 2.3 | 用模拟盘查一下账户余额。 | 走 `moni-trade-skill` |\n| 2.4 | 分别查实盘和模拟盘持仓。 | 分两次调用，且都复用同一个 `FOSUN_ENV_PATH` |\n\n## 3. 实盘变更确认\n\n| # | 用户原话 | 期望模型行为 |\n|---|---|---|\n| 3.1 | 用实盘买 100 股 AAPL。 | 先复述市场、标的、方向、数量、订单类型等关键字段并反问确认 |\n| 3.2 | 确认。 | 才允许带确认参数执行对应脚本 |\n| 3.3 | 可以吧。 | 不算明确确认，继续追问 |\n\nArchive v2.0.2: 87 files, 193953 bytes\n\nFiles: _meta.json (130b), fosun-env-setup/code/api_key_check.py (3443b), fosun-env-setup/code/credential_scenarios.py (9152b), fosun-env-setup/code/ensure_fosun_env.py (54790b), fosun-env-setup/code/generate_fosun_env.py (5224b), fosun-env-setup/code/qr_artifact.py (3407b), fosun-env-setup/reference/credential-management-flow.md (5864b), fosun-env-setup/scripts/gen_access_url.py (7030b), fosun-env-setup/SKILL.md (10570b), install.sh (8512b), moni-trade-skill/_meta.json (364b), moni-trade-skill/code/_client.py (73554b), moni-trade-skill/code/_traps.py (2536b), moni-trade-skill/code/account_list.py (3158b), moni-trade-skill/code/buy.py (218b), moni-trade-skill/code/cancel_order.py (177b), moni-trade-skill/code/cancel.py (189b), moni-trade-skill/code/cash_flows.py (2324b), moni-trade-skill/code/cash_summary.py (1902b), moni-trade-skill/code/check_shared_env.py (3442b), moni-trade-skill/code/create_order.py (177b), moni-trade-skill/code/get_cash.py (186b), moni-trade-skill/code/get_holdings.py (172b), moni-trade-skill/code/holdings.py (3101b), moni-trade-skill/code/list_orders.py (181b), moni-trade-skill/code/market_broker_list.py (1104b), moni-trade-skill/code/market_kline.py (1868b), moni-trade-skill/code/market_min.py (1117b), moni-trade-skill/code/market_orderbook.py (1142b), moni-trade-skill/code/market_quote.py (1397b), moni-trade-skill/code/market_tick.py (1243b), moni-trade-skill/code/modify_order.py (177b), moni-trade-skill/code/modify.py (189b), moni-trade-skill/code/order_cancel.py (4320b), moni-trade-skill/code/order_create.py (11529b), moni-trade-skill/code/order_list.py (5658b), moni-trade-skill/code/order_modify.py (7434b), moni-trade-skill/code/query_cash.py (188b), moni-trade-skill/code/query_holdings.py (174b), moni-trade-skill/code/query_orders.py (182b), moni-trade-skill/code/sell.py (219b), moni-trade-skill/code/sim_account_create.py (3140b), moni-trade-skill/code/sim_account_reset.py (3562b), moni-trade-skill/code/sync_accounts.py (2484b), moni-trade-skill/install.sh (155b), moni-trade-skill/README.md (4728b), moni-trade-skill/SKILL.md (42811b), moni-trade-skill/TESTING.md (27719b), real-trade-skill/code/_client.py (66433b), real-trade-skill/code/_traps.py (2536b), real-trade-skill/code/account_actions.py (2703b), real-trade-skill/code/account_list.py (3239b), real-trade-skill/code/buy.py (218b), real-trade-skill/code/cancel_order.py (177b), real-trade-skill/code/cancel.py (189b), real-trade-skill/code/cash_flows.py (2335b), real-trade-skill/code/cash_summary.py (1905b), real-trade-skill/code/check_shared_env.py (3484b), real-trade-skill/code/create_order.py (177b), real-trade-skill/code/get_cash.py (186b), real-trade-skill/code/get_holdings.py (172b), real-trade-skill/code/holdings.py (3095b), real-trade-skill/code/list_orders.py (181b), real-trade-skill/code/market_broker_list.py (1104b), real-trade-skill/code/market_kline.py (1868b), real-trade-skill/code/market_min.py (1117b), real-trade-skill/code/market_orderbook.py (1142b), real-trade-skill/code/market_quote.py (1397b), real-trade-skill/code/market_tick.py (1243b), real-trade-skill/code/modify_order.py (177b), real-trade-skill/code/modify.py (189b), real-trade-skill/code/order_cancel.py (4317b), real-trade-skill/code/order_create.py (12044b), real-trade-skill/code/order_list.py (5677b), real-trade-skill/code/order_modify.py (7865b), real-trade-skill/code/query_cash.py (188b), real-trade-skill/code/query_holdings.py (174b), real-trade-skill/code/query_orders.py (182b), real-trade-skill/code/sell.py (219b), real-trade-skill/code/sync_accounts.py (2541b)\n\nFile v2.0.2:fosun-env-setup/SKILL.md\n\n---\nname: fosun-env-setup\ndescription: 复星 OpenAPI 共享凭证 `fosun.env` 的独立生成与修复模块。覆盖首次开通/换设备/凭据丢失、apikey 过期续期、凭据无效重置；已开通回填须同时提供 apikey 与页面服务端公钥；验证通过才写入共享 `fosun.env`。\nrequires:\n bins:\n - python3\n---\n\n# fosun-env-setup\n\n本模块只负责共享 `fosun.env` 的生成与修复，不执行实盘或模拟盘业务。\n\n**凭据管理全流程（必读）**：处理开通 / 换设备 / 重置 / 续期 / `--api-key` 回填前，先阅读本 skill 内 [`reference/credential-management-flow.md`](reference/credential-management-flow.md)。关键不变量：`serverPubKey` 按 ticket 生成（每次不同），客户端私钥、服务端公钥、授权 url 三者属于**同一 ticket** 的原子单元，禁止跨 ticket 混用；回填被判 invalid 时**复用当前二维码、不轮换密钥**（见 reference §7）。\n\n## 凭据模型\n\n- 每个账户 ↔ 一个 OpenAPI apikey\n- 每个 apikey ↔ 一对客户端密钥 + 服务端密钥；本地保存 apikey、客户端私钥、服务端公钥\n\n## 三类场景（主流程）\n\n| 场景 | 何时触发 | 命令 | URL | 轮换客户端密钥 | 用户须回填（页面复制） |\n|------|----------|------|-----|----------------|------------------------|\n| 1 首次/换机/丢失 | 无有效凭证，默认入口 | `ensure_fosun_env.py` | 普通开通页 | 无则生成 | 点了「忘记 API 参数」时：**apikey + 服务端公钥** |\n| 2 过期续期 | 业务返回 40010，或主动续期 | `ensure_fosun_env.py --renew` | hash 带 `isExpired=1` | 否 | 否 |\n| 3 无效/损坏 | 业务返回 40001/40015，或主动重置 | `ensure_fosun_env.py --reset-credentials` | 普通开通页 | **是** | **是**：**apikey + 服务端公钥** |\n\n场景 1 与换设备/凭据丢失**无法区分**：返回 JSON 的 `user_message` / `operation_guide` 会引导——若曾开通过须在页面上点 **「忘记 API 参数」**，重置后把页面上 **apikey 与服务端公钥（PEM）** 一并发给 Agent；Agent 执行 `--api-key` 与 `--server-public-key` 回填，并把 pending 中本次 ticket 的客户端私钥晋升到正式 `fosun.env`，再验证。\n\n> **不变式（最重要）**：已开通/忘记 API 参数场景，用户必须同时提供 **API Key + 服务端公钥**，Agent 凑齐后一次性执行 `--api-key` 与 `--server-public-key` 回填，**禁止只回填 apikey**（页面公钥与 ticket 临时公钥不同，见 reference）。首次开通仍回复「开通好了」即可；续期无需回填。\n\n> **过期 × 换设备（易踩坑的交集）**：换新设备时本地没有 apikey，**无法直接 `--renew`**。正确顺序：① 默认入口签码；② 用户点「忘记 API 参数」后把 **apikey + 服务端公钥** 一并发给 Agent；③ `--api-key` 与 `--server-public-key` 写入 env；④ finalize 识别过期后自动转续期。\n\n## 路径规则\n\n- 默认路径：本模块父目录的 `fosun.env`，即与 `moni-trade-skill` 并列的共享凭证。\n- `FOSUN_ENV_PATH` 可覆盖默认路径。\n- `FOSUN_ENV_PATH` 是相对路径时，以总入口目录为基准解析，禁止依赖当前 shell 的工作目录。\n- 验证通过的正式凭证会额外备份到 skill 目录之外的系统原生用户数据目录：macOS 使用 `~/Library/Application Support/fw-trade-skill/fosun-env-backups`，Linux 使用 `${XDG_DATA_HOME:-~/.local/share}/fw-trade-skill/fosun-env-backups`，Windows 使用 `%LOCALAPPDATA%\\fw-trade-skill\\fosun-env-backups`。\n- `FOSUN_ENV_BACKUP_DIR` 可覆盖备份目录；相对路径以用户 home 为基准解析。\n\n## 最小入口（场景 1：首次开通 / 换设备 / 凭据丢失）\n\n```bash\npython3 fosun-env-setup/code/ensure_fosun_env.py\n```\n\n**默认行为**：立即 TicketCreate 签发**新** ticket 并返回 JSON，含 `credential_scenario=setup`、`created_new_ticket=true`、`qr_media`、`exact_open_url`、`operation_guide`、`user_message`。每次进入 pending 对接流程都会调用 TicketCreate，**不会**复用本地缓存的旧 ticket/open_url（ticket 可能过期或失效）。用户已在 H5 完成开通并回复「开通好了」时，脚本会先尝试 finalize；成功则 `status=valid`，失败才签发新 ticket。\n\n**二维码交付（一次多发 + 主动询问）**：\n\n1. 脚本在脚本执行机生成 PNG，JSON 返回 `qr_media`、`qr_png_path`、`qr_image`、`show_qr_rule`\n2. 模型按 `show_qr_rule` 一次多发二维码：\n - 必做：写 `exact_open_url` 进回复（用户随时可点击）\n - 必做：调用 `deliver_attachments` 发 `qr_png_path`（最广泛兼容），并在回复中提醒用户在附件中查看二维码\n - 可选：若平台支持 media，发 `qr_media.path`\n - 可选：若平台支持 Markdown data URI，发 `qr_image.data`\n3. 发完必须问：「收到附件中的二维码了吗？如不能（只有链接/报错等），告诉我，我换方式重发」\n4. 用户说看不到 → 问「看到了什么？」→ 换一种方式重试（不要重复已失败的方式）\n\n禁止：只发一种方式；用 Read 工具\"展示\"图片（用户看不到）；假设某平台一定支持某能力。\n\n## 场景 2：apikey 过期续期\n\n```bash\npython3 fosun-env-setup/code/ensure_fosun_env.py --renew\n```\n\n或在实盘/模拟盘业务中命中 `40010` 时，由 `real-trade-skill` 分派到同一续期逻辑。URL hash 带 `isExpired=1`；**不**更换 apikey 与客户端私钥。用户扫码续期后直接重试原操作。\n\n续期要求**本地已有 apikey 与服务端公钥**。换新设备（本地无 apikey）时不能直接续期，须先按上文「过期 × 换设备」交集流程：开通/重置签码 → 用户回填 **apikey + 服务端公钥** → 工具识别过期后自动转续期。\n\n## 回填（已开通 / 「忘记 API 参数」）— 必须两项齐全\n\n适用：场景 1 中用户点了「忘记 API 参数」、场景 3 重置扫码后、换设备凭据丢失等——凡需把**页面上已开通账号**的参数写入本地，均走本回填，**不是**首次开通（首次开通用户回复「开通好了」后重跑默认入口即可，无需本命令）。\n\n**硬性要求（缺一不可）**：\n\n1. **API Key**：用户在授权页复制的 `ak_...` 原文 \n2. **服务端公钥**：同一页面展示的 `-----BEGIN PUBLIC KEY-----` … `-----END PUBLIC KEY-----` 全文 \n\n禁止只执行 `--api-key`、禁止省略 `--server-public-key`。页面上的服务端公钥与 TicketCreate 返回的临时 `serverPubKey` **通常不同**，必须用页面那份；客户端私钥由本次 ticket 的 pending 自动晋升，无需用户发送。\n\n```bash\npython3 fosun-env-setup/code/ensure_fosun_env.py \\\n --api-key '<页面 API Key>' \\\n --server-public-key '<页面服务端公钥 PEM 全文>'\n```\n\n已 `install.sh` 时用 `$FOSUN_PY` 替代 `python3`。用户只发来 apikey 时，**先向用户索要同页的服务端公钥**，凑齐后一次性执行上述命令。\n\n## 场景 3：凭据无效 / 损坏重置\n\n```bash\npython3 fosun-env-setup/code/ensure_fosun_env.py --reset-credentials\n```\n\n或在业务中命中 `40001` / `40015` 时由错误分派触发。脚本会**轮换客户端密钥对**并 TicketCreate；用户须在页面上点 **「忘记 API 参数」** 后，按上文 **「回填」** 节同时提供 apikey 与服务端公钥并执行回填命令。\n\n> **回填被判 invalid 时不要重新扫码（防死循环）**：回填会写入 apikey 与公钥后再校验。若返回 `api_key_rejected=true`、`created_new_ticket=false`，**复用当前二维码**：让用户在同一页面再点「忘记 API 参数」，把页面上 **apikey + 服务端公钥** 一并发来，再次执行**完整回填命令**（`--api-key` 与 `--server-public-key` 都要有）。禁止重新签发 ticket 或轮换密钥。\n\n首次开通（未点「忘记 API 参数」）无需回填命令，用户回复「开通好了」后再次运行默认入口即可。\n\n## 结果含义\n\n- `status=pending`：已通过 TicketCreate 签发新开通/续期/重置 URL（`created_new_ticket=true`）。须读 `credential_scenario` 与 `operation_guide`：用 media 发 `qr_media.path` 并转发 `exact_open_url`。授权中材料在 pending state，正式 `fosun.env` 不写 `pending` 凭证。场景 1 用户回复「开通好了」后再运行本脚本；需回填时按 **「回填」** 节执行 `--api-key` 与 `--server-public-key`。\n- `status=valid`：共享凭证已可用，包含账户索引、本地客户端私钥、API Key 和服务端公钥。\n- `status=error`：本地依赖、网络或认证接口失败，停止后续业务脚本。\n\n如果 `fosun.env` 缺失或缺少完整密钥材料，脚本会先从用户级本地备份自动恢复并重新校验，恢复成功时 JSON 中会包含 `restored_from_backup`。\n\n## 误删与备份恢复\n\n**触发**：用户说删了或丢了 `fosun.env`；或默认入口/`--repair` 后仍未 `valid` 且没有 `restored_from_backup`。\n\n**Agent 操作**：直接运行 `ensure_fosun_env.py`（或 `--repair`）。**禁止**手动拷贝备份文件、向用户索要客户端私钥，或尝试从服务端「找回私钥」——`FSOPENAPI_CLIENT_PRIVATE_KEY` 只能在本地生成。\n\n**成功**：`status=valid` 且含 `restored_from_backup` → 告知已从用户级本地备份恢复（路径见 §路径规则），可继续业务；无需重新扫码开通。\n\n**失败**：备份目录也无可用副本（用户连备份一起删了）→ 与换机/凭据丢失相同，走 **场景 1** 默认入口签码；若 apikey 仍无效则 **场景 3** `--reset-credentials` 后按 **「回填」** 节提供 apikey + 服务端公钥。验证通过后的正式凭证会继续写入 §路径规则中的备份目录。\n\n## 其它参数\n\n```bash\npython3 fosun-env-setup/code/ensure_fosun_env.py --repair\npython3 fosun-env-setup/code/ensure_fosun_env.py --force-new-ticket # 跳过 finalize，立即签新 ticket\n```\n\n## 输出纪律\n\n脚本只输出结构化 JSON。不要把 `fosun.env` 的密钥字段原样展示给用户。`status=pending` 时须汇报：`credential_scenario`、`user_message`、`operation_guide`、`qr_media`、`exact_open_url`、`next_action`。需要用户回填时（`requires_api_key_from_user` / `requires_server_public_key_on_backfill` 等）：**必须等用户同时提供 apikey 与页面服务端公钥**，再执行 `--api-key` 与 `--server-public-key`，禁止只回填 apikey。\n\nFile v2.0.2:moni-trade-skill/SKILL.md\n\n---\nname: moni-trade\ndescription: 复星财富港美股模拟盘 OpenAPI skill。通过 `FOSUN_ENV_PATH` 复用共享凭证；未设置时自动解析到总 skill 根目录的 `fosun.env`，只执行模拟盘接口，不负责凭证生成或修复。\nversion: 1.8.0\nrequires:\n bins:\n - bash\n - curl\ninstall: install.sh\n---\n\n# moni-trade — 复星模拟盘 OpenAPI Skill\n\n这是模拟盘子 skill。只负责执行模拟盘接口，直接复用 `FOSUN_ENV_PATH` 指向的共享凭证；未设置时自动解析到总 skill 根目录 `fosun.env`。\n\n> **本文件设计原则**：只放\"模型决策时必须知道\"的内容（安全规则、决策树、错误码处置）。\n> 每个脚本的详细参数请直接 `脚本.py --help` 查阅，文档不重复维护，**避免文档与代码脱节**。\n\n## 合法脚本清单（18 个业务脚本 + 2 个内部模块，封闭集合，跑命令前先逐字符核对）\n\n> ⚠️ **本表是工具箱总目录**，刻意放在所有铁律之前 —— 模型即使只读到这里也必须先记住：**清单之外的所有脚本名都是脑补**。\n> 命名规则统一是 **`_.py`**（唯一例外：`sync_accounts.py`，历史遗留 action_domain 顺序，**不要泛化**）。\n\n| domain | 脚本（精确文件名） | 一句话作用 |\n|---|---|---|\n| **meta** | `account_list.py` | 列账户（顺带刷账户索引） |\n| **meta** | `sync_accounts.py` | **唯一例外**：强刷账户索引（action_domain 顺序，历史遗留，不要泛化） |\n| **meta** | `check_shared_env.py` | 共享凭证体检 |\n| **账户（变更）** | `sim_account_create.py` | 创建模拟账户（必带 `--confirm`） |\n| **账户（变更）** | `sim_account_reset.py` | 重置模拟账户（必带 `--confirm`；旧账户会被禁用） |\n| **资产** | `cash_summary.py` | 现金/购买力 |\n| **资产** | `holdings.py` | 持仓 |\n| **资产** | `cash_flows.py` | 资金流水 |\n| **交易（变更）** | `order_create.py` | 下单（必带 `--confirm`） |\n| **交易（变更）** | `order_modify.py` | 改单（必带 `--confirm`；**不是** `modify_order.py`） |\n| **交易（变更）** | `order_cancel.py` | 撤单（必带 `--confirm`；**不是** `cancel_order.py`） |\n| **交易（查询）** | `order_list.py` | 订单列表（可按市场/标的/日期/状态筛选） |\n| **行情** | `market_quote.py` | 实时报价 |\n| **行情** | `market_orderbook.py` | 盘口 |\n| **行情** | `market_kline.py` | K 线 |\n| **行情** | `market_min.py` | 分时 |\n| **行情** | `market_tick.py` | 逐笔成交 |\n| **行情** | `market_broker_list.py` | 经纪商队列 |\n| **内部** | `_client.py` | 公共 SDK 工厂 + 错误处理（**不直接调用**） |\n| **内部** | `_traps.py` | 脑补陷阱共享 helper（**不直接调用**） |\n\n> **常见脑补黑名单**（v1.7.2 起这些名字已被 trap stub 接住，跑了直接吐结构化 `WRONG_SCRIPT_NAME`，**不再是 OS-level No such file**）：\n> `modify_order.py` → `order_modify.py` / `cancel_order.py` → `order_cancel.py` / `create_order.py` → `order_create.py`\n> `list_orders.py` / `query_orders.py` → `order_list.py` / `get_holdings.py` / `query_holdings.py` → `holdings.py`\n> `get_cash.py` / `query_cash.py` → `cash_summary.py` / `cancel.py` / `modify.py` → 对应 `order_*.py`\n> `buy.py` / `sell.py` → `order_create.py`（用 `--direction 1/2` 区分买卖）\n> 跑这些 trap 后，**直接照 stderr 里的 `intended_script` 字段替换脚本名重试即可，禁止再猜其它名字**。\n\n## 第 0 条铁律：单步原则（最高优先级，违反 = bug）\n\n**一次用户请求，原则上只跑一个脚本。** 拿到结果先汇报，等用户给下一个明确指令再继续。\n\n| 类型 | 示例脚本 | 跑完后允许做什么 |\n|---|---|---|\n| **meta 查询**（账户/凭证体检/同步） | `account_list` / `sync_accounts` / `check_shared_env` | **只汇报、停手**；禁止自动接 `cash_summary` / `holdings` / `cash_flows` / `order_*` |\n| **账户变更**（创建/重置模拟账户） | `sim_account_create` / `sim_account_reset` | 跑完汇报新账户、初始现金和缓存刷新结果，然后停手；禁止自动接交易/资产脚本 |\n| **业务查询**（钱/股/单/流水/行情） | `cash_summary` / `holdings` / `cash_flows` / `order_list` / `market_*` | **只汇报、停手**；禁止基于查询结果脑补\"那就帮你下单/改单/撤单\" |\n| **业务变更**（下单/改单/撤单） | `order_create` / `order_modify` / `order_cancel` | 跑完汇报结果，不允许\"成功了我再给你跑一遍 holdings 看看\"这种自动连环 |\n\n例外（允许自动连一步）：\n- 业务脚本报\"账户类错误\"→ `_client.py` 内部已自带刷缓存重试，模型不需要也不允许手动接 `account_list`。\n- 用户原话明确串了多个动作（如\"列账户再查余额\"），按用户原话顺序逐个跑、逐步汇报。\n\n**先读 stdout 顶层 `next_action` 字段再行动**（v1.7.3 起**所有查询/行情/交易脚本** stdout JSON 顶层一定带 `next_action`，是模型必须遵守的下一步指令，**优先级高于本节其它说法**）。\n\n> **抗长会话衰减说明**：本文件在长会话中会因为 LLM 注意力机制被\"挤压\"，模型可能记不清第 0 条铁律。\n> 但**每跑一次脚本，stdout 顶层 `next_action` 都是 stateless 的**，会被新鲜地喂到模型嘴边，\n> 等于把\"单步原则\"在每条命令的输出里**重新灌一遍**。所以无论会话多长，**只要模型把 stdout 完整读完、按 `next_action` 行动**，第 0 条铁律就不会失效。\n> 这是当前体系下最强的抗衰减武器，**不要忽视任何一次 stdout 的 `next_action`**。\n\n## 第 1 条铁律：禁脑补（参数 + 脚本名都不许猜）\n\n### 1.1 参数维度\n`subAccountId` / `direction` / `quantity` / `price` —— 任意一个不确定，立刻停手问用户，**严禁瞎填默认值**。下单/改单/撤单的市场维度统一用 `--market hk|us` 简写（脚本会自动展开成对应的 market_code/currency/product_type，零脑补、零拼错）；高级用户也可显式三件套，但和 `--market` 互斥，本地会直接拦截。\n\n#### 1.1.1 「标的代码」参数名抗脑补三层防御（v1.7.4 起）\n跨脚本\"标的代码\"参数名历史上叫法不一（行情用 `--code`、交易用 `--stock-code`、持仓用 `--symbols`），是模型脑补 `--ticker` / `--instrument` / `--stocks` 这种罕见名的根本诱因。v1.7.4 起加了三层兜底：\n\n- **L1 · argparse alias**：所有相关脚本现在都同时接受 4 个官方 alias `--code` / `--stock-code` / `--symbol` / `--symbols`，模型用其中任一个都能跑通（每个脚本仍有\"主名\"，但只用于 help 文案）。\n- **L2 · 智能 hint**：模型用了 4 个之外的脑补名（如 `--ticker` / `--instrument` / `--stockcode` / `--stocks`），脚本会回 `INVALID_PARAM` 并精准指出脑补名、给出\"立刻改成 `--code` / `--stock-code`\"的指引；这是兜底，**不要依赖、首先要走 L1 / L3**。\n- **L3 · `--args-json` 模板**（首选）：见文首「JSON 填空模板」一节，模型从模板复制、按规则填值，**根本没有\"想参数名\"的环节**，彻底消除脑补窗口。\n\n> **三层是冗余防御不是替代**：JSON 模板（L3）是默认首选；CLI 写法用 alias（L1）兜底；万一模型还是写出罕见脑补名，智能 hint（L2）会引导回正轨。\n\n#### 1.1.2 「标的代码」**值**自动规范化 + silent fail 兜底（v1.7.5 起）\n1.1.1 治了\"参数名\"维度的脑补；v1.7.5 接着治\"参数值\"维度——模型对市场前缀（hk/us）的拼接同样容易脱节。\n\n- **L1 · 自动规范化**（事前）：行情/持仓/订单查询脚本在 `parse_args()` 之后调用 `normalize_security_code`：\n - `01810` / `01810`（前导）/ `700`（不足 5 位）→ 自动补 `hk` 前缀 + 前导 0 → `hk00700`\n - `AAPL` / `aapl` / `Aapl` → 自动补 `us` 前缀 + 大写 → `usAAPL`\n - `HK.01810` / `US.AAPL` / `us.aapl` 点分写法 → 自动归一化\n - 已带合法前缀（`hk` / `us` / `sh` / `sz`）→ 原样保留\n - 无法推断的格式（如 `123456` 6 位数字）→ 原样转给 SDK，失败时由 L2 兜底\n- **交易下单主路径必须用纯代码**：`order_create.py` 遵循 `OrderCreate.md`，请求体已有 `marketCode`，所以模型从一开始就应生成 `marketCode=hk, stockCode=00700` / `marketCode=us, stockCode=AAPL` 这种格式。CLI 写法对应为 `--market hk --stock-code 00700`、`--market us --stock-code AAPL`，**不要主动拼 `hk00700` / `usAAPL` 给下单脚本**。`normalize_trade_stock_code()` 只做意外兜底：若误传 `hk00700` / `HK.00700` / `usAAPL`，脚本会按 `--market` 校验后剥离前缀；若代码前缀和 `--market` 冲突，本地直接拦截。\n- **L2 · silent fail 兜底**（事后）：实测发现 SDK 对\"看似合法但实际不存在\"的代码会返回 `{ok:true, code:0, data:null, message:\"success\"}`（**比报错危险 10 倍**——模型读 ok=true 会以为成功，可能凭空编数字）。`dump_with_directive` 在输出层强制识别这种\"成功外壳 + 空 data\"模式，重写为 `SILENT_FAIL_EMPTY_DATA` 结构化错误。\n\n> **直接受益**：模型听到用户说\"查 01810 现价\"，可以**原样**传 `--code 01810` 或 `{\"code\":[\"01810\"]}`，不用做\"先判断市场再拼前缀\"的认知动作。\n> **真不存在的代码**也会被精准拦截而不是 silent 编数，对用户负责。\n\n### 1.2 脚本名维度（v1.7.2 加固，**双层防御**）\n**只许使用「合法脚本清单」里精确出现的文件名，禁止按英文动宾习惯反推。**\n\n本 skill 的命名规则统一为 **`_.py`**（domain 在前、action 在后）：\n- ✅ 正确：`order_create.py` / `order_modify.py` / `order_cancel.py` / `order_list.py`\n- ❌ 错误（**这些文件根本不存在**）：`create_order.py` / `modify_order.py` / `cancel_order.py` / `list_orders.py` / `query_holdings.py` / `get_cash.py` / `cancel.py` / `modify.py` / `buy.py` / `sell.py`\n\n> **唯一例外**：`sync_accounts.py`（历史遗留，action_domain 顺序）—— **这是孤例，不要泛化推断其它脚本可以反着写**。\n\n#### 双层防御机制\n- **L1（事前）**：跑命令前先在「合法脚本清单」里逐字符核对脚本名\n- **L2（运行时强制兜底）**：13 个最常被脑补的错名（上面 ❌ 列表）已被 `code/` 目录里的 **trap stub 接住**——即使模型完全不读 SKILL.md、直接靠拼写直觉跑命令，也会立刻得到结构化 `WRONG_SCRIPT_NAME` 错误，里面带 `intended_script` 字段直接指向正确脚本名，模型读了 `next_action` 应当**立刻把命令里的错名改成 `intended_script` 重试**，不要再猜其它脚本名\n\n> 只有在用户用了**清单外的、连 trap 都没覆盖到的**罕见错名（如 `update_order.py` / `place_order.py`）时，才会落到 OS-level `No such file or directory`——此时按错误处置矩阵执行（停手 + `ls $SKILL/code/*.py` 核对 + 回查清单）。\n\n## 第 2 条铁律：变更操作二次确认（v1.7.3 起改为「argparse 强制 intent + ensure_user_confirmed 验证 confirm」三层防御）\n\n**任何下单 / 改单 / 撤单 / 创建模拟账户 / 重置模拟账户，模型必须分三步走，禁止\"打了就跑\"：**\n\n1. **在对话里先复述意图**：用自然语言把完整变更意图整段复述给用户，**不省略任何关键字段**：\n - 下单：操作（买/卖）+ 市场（港股/美股）+ 标的（含中文名最好）+ 数量 + 价格（市价单说明不传价格）+ 订单类型（只能是限价/市价）\n - 改单：要改的 orderId + 市场 + 修改类型 + 要修改的字段（数量/价格）\n - 撤单：要撤的 orderId + 市场 + 该订单的标的/方向/数量/订单类型/关键条件摘要\n - 创建模拟账户：说明会新建模拟证券账户，并初始化 HKD/USD 各 100 万现金\n - 重置模拟账户：说明旧模拟账户 ID、旧账户会被禁用、会创建新账户，并初始化 HKD/USD 各 100 万现金；重置间隔 7 天\n2. **再明确反问**：\"以上信息确认执行吗？\"——**等用户给出明确肯定**才能执行。\n3. **执行命令时把同一段复述填到 `--intent`**（**v1.7.3 必传**）：脚本会把 intent 原样打印到 stdout，长会话再衰减用户也能立刻看到模型理解的意图、错了立刻纠。\n\n**何为\"明确肯定\"**（白名单，命中才放行）：\"确认 / 是 / 是的 / 下吧 / 执行 / 撤 / 改 / 走 / yes / ok / go / 没问题 / 对\" 等。\n**何为\"未确认\"**（拒绝执行，再问一次）：\"嗯 / 可以吧 / 看着办 / 应该是吧 / 你决定 / 随便 / 都行\" 等模糊词，以及任何带\"如果/或者/也许/可能\"的条件式回答。\n\n**运行时三层防御（即使模型漏看本节铁律也兜底）**：\n- L1 `--intent` `required=True` —— 模型不带就 argparse `INVALID_PARAM` 拦截，**复述意图变成 schema 强制项**\n- L2 `--confirm` 必须为 True —— 模型在用户明确确认前禁止带 `--confirm`；不带就 `NEED_CONFIRMATION` 拦截，**且错误信息里会回显 `--intent` 内容**让用户校验\n- L3 stdout 顶层 `intent` 字段 —— 执行成功的 stdout 也会原样回显 intent，便于审计\n\n> 这条铁律覆盖**所有有副作用的变更操作**（即使用户原话已经给了完整参数，仍然要先复述+反问、再带 `--intent + --confirm` 执行）。模拟盘也按真实流程演练，培养肌肉记忆，避免接实盘时误操作。\n\n## JSON 填空模板（v1.7.4 · 反脑补终极方案 · 首选用法）\n\n> **为什么必须首选 JSON 模板**：v1.7.4 起所有业务脚本统一支持 `--args-json ''`。\n> 模型只需要 ① 复制对应模板 → ② 把 `<...>` 占位符换成实际值 → ③ 一行命令直接跑。\n> **不用想参数名 / 不用想必填项 / 不用想顺序**——长会话里最容易脑补的\"参数名\"维度被完全消除。\n>\n> 跟下面「零思考速抄表」的传统命令行写法 **100% 等价**，可任选一种；新会话推荐 **JSON 模板**。\n\n**通用调用形式**（所有脚本统一）：\n\n```bash\n$MONI_PY $SKILL/code/<脚本名>.py --args-json '<填好的 JSON 对象>'\n```\n\n**机械翻译规则**（脚本内部自动做，模型只需要按规则填 JSON）：\n- `\"code\"` → `--code`；`\"stock_code\"` 或 `\"stock-code\"` → `--stock-code`（下划线自动转中划线）\n- `true` → 只放 flag 名（覆盖 `store_true` 类，如 `confirm` / `active-only`）\n- `false` / `null` → 跳过该字段\n- 数组 → 重复展开（`[\"a\",\"b\"]` → `--key a --key b`）\n- 数字裸传，字符串脚本会自动加引号\n\n> **v1.7.5 起：查询/行情类标的代码可以直接用「用户原话格式」**——不用再拼市场前缀。\n> 脚本侧会自动规范化：`\"01810\"` → `hk01810`、`\"00700\"` → `hk00700`、`\"700\"` → `hk00700`（前导补 0）、\n> `\"AAPL\"` → `usAAPL`、`\"aapl\"` → `usAAPL`、`\"HK.01810\"` → `hk01810`、`\"US.AAPL\"` → `usAAPL`。\n> 模型听到用户说\"查 01810 现价\"，直接 `{\"code\":[\"01810\"]}` 即可，**不用想这是港股还是美股**。\n> 如果代码格式实在异常无法推断，会触发 `SILENT_FAIL_EMPTY_DATA` 错误（v1.7.5 兜底，不会再 silent 编数）。\n>\n> **交易下单例外**：下单 JSON/CLI 模板里的 `` 必须填纯代码，例如港股 `00700`、美股 `AAPL`。带前缀格式只作为脚本的兼容兜底，不作为模型首选输出。\n\n### 高频 JSON 模板（覆盖 80%+ 日常问；交易类仍受第 2 条铁律约束）\n\n| 用户原话特征 | 模板（替换 `<...>` 后即跑） |\n|---|---|\n| 余额 / 现金 / 购买力 | `$MONI_PY $SKILL/code/cash_summary.py --args-json '{}'` |\n| 持仓 | `$MONI_PY $SKILL/code/holdings.py --args-json '{}'` |\n| 只看某只持仓 | `$MONI_PY $SKILL/code/holdings.py --args-json '{\"code\":[\"\"]}'`
（CODE 直接用用户原话：`01810` / `00700` / `AAPL` 都行，v1.7.5 自动补市场前缀） |\n| 资金流水 | `$MONI_PY $SKILL/code/cash_flows.py --args-json '{}'` |\n| 今天哪些单 / 未成交 | `$MONI_PY $SKILL/code/order_list.py --args-json '{\"active-only\":true}'` |\n| 全部最近 7 天委托 | `$MONI_PY $SKILL/code/order_list.py --args-json '{}'` |\n| 查实时报价 | `$MONI_PY $SKILL/code/market_quote.py --args-json '{\"code\":[\"\"]}'` |\n| 同时查多只 | `$MONI_PY $SKILL/code/market_quote.py --args-json '{\"code\":[\"\",\"\"]}'` |\n| 查盘口 5 档 | `$MONI_PY $SKILL/code/market_orderbook.py --args-json '{\"code\":\"\",\"count\":5}'` |\n| 我有哪些账户 | `$MONI_PY $SKILL/code/account_list.py --args-json '{}'` |\n| 共享凭证体检 | `$MONI_PY $SKILL/code/check_shared_env.py --args-json '{}'` |\n| 创建模拟账户 | `$MONI_PY $SKILL/code/sim_account_create.py --args-json '{\"intent\":\"创建一个新的模拟盘证券账户，HKD/USD 各初始化 100 万现金\",\"confirm\":true}'`
必须先向用户复述并确认 |\n| 重置模拟账户 | `$MONI_PY $SKILL/code/sim_account_reset.py --args-json '{\"sub-account-id\":\"\",\"intent\":\"重置旧模拟账户 ：禁用旧账户并创建新模拟账户，HKD/USD 各初始化 100 万现金\",\"confirm\":true}'`
必须由用户明确指定旧模拟账户 ID 并确认；重置间隔 7 天 |\n\n### 交易类 JSON 模板（必须先按第 2 条铁律完成\"复述 + 反问 + 用户明确肯定\"再跑）\n\n| 场景 | 模板 |\n|---|---|\n| 下单（限价单） | `$MONI_PY $SKILL/code/order_create.py --args-json '{\"market\":\"\",\"stock-code\":\"\",\"direction\":<1|2>,\"order-type\":3,\"quantity\":,\"price\":\"\",\"intent\":\"<完整下单意图，含市场/方向/标的/数量/价格/限价单>\",\"confirm\":true}'` |\n| 下单（市价单） | `$MONI_PY $SKILL/code/order_create.py --args-json '{\"market\":\"\",\"stock-code\":\"\",\"direction\":<1|2>,\"order-type\":9,\"quantity\":,\"intent\":\"<完整下单意图，含市场/方向/标的/数量/市价单>\",\"confirm\":true}'` |\n| 非交易时段下单 | **模拟盘不支持预埋单**：非交易时段也只是普通下单，订单类型仍只能是 `3` 或 `9`；不要把\"预埋\"理解成新订单类型，也不要追加条件/触发/跟踪字段 |\n| 改单（普通订单） | `$MONI_PY $SKILL/code/order_modify.py --args-json '{\"market\":\"\",\"order-id\":,\"modify-type\":1,\"intent\":\"<完整改单意图，含市场/orderId/原订单摘要/要修改的数量或价格>\",\"confirm\":true}'` |\n| 改单（带修改字段） | 模拟盘普通改单仅支持 `\"quantity\"`、`\"price\"`，且 `\"modify-type\"` 固定用 `1`。条件单、跟踪止损、止盈止损相关字段不支持 |\n| 撤单（任意可撤订单） | `$MONI_PY $SKILL/code/order_cancel.py --args-json '{\"market\":\"\",\"order-id\":,\"intent\":\"撤掉<市场>订单 （<原标的/方向/数量/订单类型/关键条件摘要>）\",\"confirm\":true}'` |\n\n> **shell 引号约定**：永远用**单引号**包整个 JSON 字符串、JSON 内部用**双引号**。这样 shell 不会吃掉 `\"`、不会触发变量替换、不会和 zsh 的 `!` 历史扩展冲突。\n> **JSON 写错 → 结构化 `INVALID_PARAM`**（不是 OS 报错），错误信息会精确指出\"该用单引号包\"或\"缺逗号\"等修正方法。\n\n## 零思考速抄表（传统命令行写法，与上面 JSON 模板等价）\n\n> **使用顺序**：① 先在 JSON 填空模板 / 本表里找用户原话 → 找到 → **直接抄命令** → 跑完按 stdout 顶层 `next_action` 行动；② 找不到 → 走下面的「调用决策树」+ `<脚本> --help`。\n> **目的**：把高频场景的\"想脚本/想路径/想参数\"三步推理，压成\"复制即跑\"零思考。\n\n### 起手式（每个新会话先跑一次，env 变量持久到当前 shell）\n\n```bash\n# $SKILL = moni-trade-skill 根目录（含 code/、本 SKILL.md）；由本机安装位置或运行时注入，不要写死某条绝对路径。\nexport SKILL=\"\"\n# $FOSUN_PY / $MONI_PY = 总入口 install.sh 创建的共享 venv 解释器（默认 fw-trade-skill/.venv/bin/python）\nexport FOSUN_PY=\"\"\nexport MONI_PY=\"${FOSUN_PY}\"\n# 唯一真源：总入口 fw-trade-skill/fosun.env（与 moni-trade-skill 并列）。不设则脚本仍会从 code/_client.py 自动推出同一路径。\nexport FOSUN_ENV_PATH=\"${FOSUN_ENV_PATH:-$SKILL/../fosun.env}\"\n```\n\n### 高频命令（覆盖 80%+ 日常问）\n\n| 用户原话特征 | 直接抄这一行 |\n|---|---|\n| 余额 / 现金 / 购买力 / 还能买多少 | `$MONI_PY $SKILL/code/cash_summary.py` |\n| 持仓 / 我买了什么 / 现在有什么股票 | `$MONI_PY $SKILL/code/holdings.py` |\n| 今天哪些单 / 未成交订单 / 还没成 | `$MONI_PY $SKILL/code/order_list.py --active-only` |\n| 全部最近 7 天委托 | `$MONI_PY $SKILL/code/order_list.py` |\n| 资金流水 / 出入金（默认全部） | `$MONI_PY $SKILL/code/cash_flows.py` |\n| 查 X 股实时价（如 hk00700 / usAAPL） | `$MONI_PY $SKILL/code/market_quote.py --code ` |\n| 同时查多只 | `$MONI_PY $SKILL/code/market_quote.py --code hk00700 --code usAAPL` |\n| 查 X 股盘口 5 档 | `$MONI_PY $SKILL/code/market_orderbook.py --code --count 5` |\n| 我有哪些账户 | `$MONI_PY $SKILL/code/account_list.py` |\n| 共享凭证体检 | `$MONI_PY $SKILL/code/check_shared_env.py` |\n| 创建模拟账户 | `$MONI_PY $SKILL/code/sim_account_create.py --intent \"创建一个新的模拟盘证券账户，HKD/USD 各初始化 100 万现金\" --confirm` |\n| 重置模拟账户 | `$MONI_PY $SKILL/code/sim_account_reset.py --sub-account-id --intent \"重置旧模拟账户 ：禁用旧账户并创建新模拟账户，HKD/USD 各初始化 100 万现金\" --confirm` |\n\n### 下单 / 改单 / 撤单（用户原话明确**且经二次确认**后再用，参数仍需用户给齐）\n\n> 全部用 **`--market hk|us` 简写**，脚本自动展开三件套，**绝不要手填 `--currency` / `--product-type`**。\n> ⚠️ 模板末尾都带 `--intent \"...\"` + `--confirm`：**模型必须先按「第 2 条铁律」用自然语言复述意图、得到用户明确肯定，再把同一段复述填到 `--intent` 后跑**。在拿到明确确认前，先把命令展示给用户**但不要执行**。\n> ⚠️ **`--intent` 是 v1.7.3 起的 `required=True` 必填项**——不带就 argparse `INVALID_PARAM`，没有任何绕过空间。\n\n| 场景 | 模板（占位符替换后即跑） |\n|---|---|\n| 下单（限价单） | `$MONI_PY $SKILL/code/order_create.py --market --stock-code --direction <1|2> --order-type 3 --quantity --price --intent \"<完整下单意图，含市场/方向/标的/数量/价格/限价单>\" --confirm` |\n| 下单（市价单） | `$MONI_PY $SKILL/code/order_create.py --market --stock-code --direction <1|2> --order-type 9 --quantity --intent \"<完整下单意图，含市场/方向/标的/数量/市价单>\" --confirm` |\n| 改单（普通订单） | `$MONI_PY $SKILL/code/order_modify.py --market --order-id --modify-type 1 --intent \"<完整改单意图，含市场/orderId/原订单摘要/要修改的数量或价格>\" --confirm`
按用户意图追加 `--quantity` / `--price` |\n| 撤单（任意可撤订单） | `$MONI_PY $SKILL/code/order_cancel.py --market --order-id --intent \"撤掉<市场>订单 （<原标的/方向/数量/订单类型/关键条件摘要>）\" --confirm` |\n\n> 港股最小手数 100；不知 `` 先 `order_list.py`；TIF / expType / 盘前盘后 / 夜盘等高级字段走 `$MONI_PY $SKILL/code/order_create.py --help`。模拟盘订单类型始终只允许 `3` / `9`，且**不支持预埋单**（非交易时段也只是普通下单，不会被转成预埋单）。\n> 漏带 `--intent` → `INVALID_PARAM`（argparse 阶段就拒）；漏带 `--confirm` → `NEED_CONFIRMATION`（intent 会回显在错误里给用户校验）—— 这是「第 2 条铁律」的三层运行时兜底，不要怀疑、不要绕过。\n\n## 调用决策树（速抄表没覆盖时走这里）\n\n按用户原话定位脚本，**只跑一个**，跑完汇报：\n\n| 用户原话特征 | 调用 | 备注 |\n|---|---|---|\n| \"我有哪些账户\" / \"账户列表\" | `account_list.py` | meta 查询，跑完只汇报 |\n| \"刚开了新账户 / 账户变了\" | `sync_accounts.py` | 平时不需要主动跑 |\n| 共享凭证体检 / 怀疑失效 | `check_shared_env.py` | 体检，不要当业务前置步骤 |\n| \"创建模拟账户 / 新开模拟账户\" | `sim_account_create.py` | 有副作用，必须先复述+确认；成功后脚本会刷新账户索引 |\n| \"重置模拟账户 / 模拟账户初始化\" | `sim_account_reset.py` | 有副作用，必须用户明确指定旧模拟账户 ID 并确认；旧账户会被禁用，重置间隔 7 天 |\n| \"余额 / 现金 / 购买力 / 还能买多少\" | `cash_summary.py` | **不要先跑 account_list** |\n| \"持仓 / 我买了什么 / 现在有什么股票\" | `holdings.py` | 同上 |\n| \"今天买卖了什么 / 流水 / 出入金\" | `cash_flows.py` | |\n| \"今天的订单 / 委托记录 / 哪些没成\" | `order_list.py` | 查某笔单先按 `--stock-code` + 日期 / 市场 / 状态缩小列表；对用户只说明“可按市场/标的/日期/状态筛选订单列表”，不要说某脚本不支持 |\n| \"下单 / 买 / 卖\" | `order_create.py` | 用 `--market hk|us` 简写，见下文 |\n| \"撤单 / 取消那张单\" | `order_cancel.py` | 不知道 order-id 先 `order_list.py` |\n| \"改价 / 改单 / 改数量\" | `order_modify.py` | 同上 |\n| \"K 线 / 走势图\" | `market_kline.py` | |\n| \"实时价 / 现在多少钱 / 报价\" | `market_quote.py` | 多只用 `--code` 多次 |\n| \"盘口 / 买卖档\" | `market_orderbook.py` | |\n| \"分时\" | `market_min.py` | |\n| \"逐笔成交\" | `market_tick.py` | |\n| \"经纪商\" | `market_broker_list.py` | |\n\n> **不知道脚本怎么用？** → `$MONI_PY $SKILL/code/<脚本>.py --help`\n> 每个脚本都自带 EPILOG（何时调用 + 示例 + 强制规则）；本文档不重复维护脚本细节，**避免漂移**。\n\n## 其它必须遵守\n\n### 盘别确认\n\n用户没有明确选择`模拟盘`时，禁止调用本 skill。\n\n### 只用共享凭证\n\n- 只读取 `FOSUN_ENV_PATH` 指向的共享凭证；未设置时自动解析到总 skill 根目录 `fosun.env`。\n- 推荐写法：`FOSUN_ENV_PATH=fosun.env`，由脚本自动解析成绝对路径。\n- 不生成、不复制、不维护第二份凭证；凭证无效时先去同级 `fosun-env-setup` 生成或修复。\n\n### 能力边界\n\n- 仅支持港股、美股正股。\n- 不支持 A 股交易、期权交易、`BidAskInfo` 与订阅类接口。\n- **用户口径**：当用户请求当前接口不支持的功能时，不要对用户说“某个 Python 文件/某个脚本不支持”。只说明当前支持范围和可替代能力：\n - 支持：港股/美股正股的账户、资金、持仓、资金流水、订单列表、下单、改单、撤单。\n - 支持：报价、K 线、分时、逐笔、盘口、经纪商队列等单次行情查询。\n - 不支持：A 股交易、期权交易、订阅类接口、`BidAskInfo`、按订单号直接单笔查询、批量撤单接口。\n - 可替代：查某笔订单时，用市场/标的/日期/状态缩小订单列表；订阅需求改为单次行情查询；批量撤单需求先列出待撤订单，复述清单并经用户确认后逐笔撤。\n\n### 错误处理：先读 next_action，再行动\n\n所有脚本错误统一以结构化 JSON 输出到 **stderr**：先读 `error_code` 和 `next_action`，按本文末尾「错误码处置矩阵」执行。**`NO_MOCK_ACCOUNT`（exit 3）必须立即停手转告用户**，禁止私自切实盘 skill / 挑其他账户继续 / 改写口径推进。\n\n## 一键安装\n\n在 **总 skill 根目录**安装（与实盘、env-setup 共用 venv；本目录 `install.sh` 会转调上级脚本）：\n\n```bash\nbash ../install.sh\n# 或：cd .. && bash install.sh\n```\n\n> macOS / Linux 用 `bash install.sh`。**用户机器无需预装 Python**——[uv](https://docs.astral.sh/uv/) 会在总入口目录创建 `.venv` 并下载解释器（符合 [Agent Skills](https://agentskills.io/specification) 约定：依赖相对 skill 根目录管理，不写入 Agent 工作区外路径）。\n\n`../install.sh` 会自动：\n1. 检测 `uv`，未安装时一键自动拉取；\n2. 在 `$FW_TRADE_VENV`（默认 `fw-trade-skill/.venv`）创建**共享**环境，Python 由 uv 自动下载；\n3. 下载 SDK 压缩包并解压到 `fw-trade-skill/.cache/`；\n4. `uv pip install --editable` 安装 `fsopenapi`（含 setup.py 依赖；PyPI 失败时自动改用清华镜像重试）；\n5. 自检 `import fsopenapi`；导出 `FOSUN_PY`（`MONI_PY` 与之相同）。\n\n> 可选环境变量：`FW_TRADE_VENV`、`FW_TRADE_PYTHON_VERSION`、`FW_TRADE_SDK_*`、`FW_TRADE_CACHE_DIR`、`FW_TRADE_PYPI_MIRROR`（兼容旧前缀 `MONI_*`）。\n\n## 使用前提\n\n- `FOSUN_ENV_PATH` 指向的共享凭证文件已存在\n- 共享凭证已通过同级 `fosun-env-setup` 生成或修复\n- 当前请求已明确选择为`模拟盘`\n- 模型每个新会话先按上面「速抄表 → 起手式」export 一次 `$MONI_PY` `$SKILL`\n\n## 下单/改单/撤单：市场参数规则\n\n**推荐唯一路径**：用 `--market hk|us` 简写，脚本自动展开三件套，模型零脑补、零拼错。\n\n| 用户意图 | 推荐写法 | 等价的三件套（高级用户用） |\n|---|---|---|\n| 港股交易 | `--market hk` | `--market-code hk --currency HKD --product-type 5` |\n| 美股交易 | `--market us` | `--market-code us --currency USD --product-type 6` |\n\n- `--market` 与三件套**互斥**，混用本地直接 `INVALID_PARAM` 拦截。\n- `order_modify.py` / `order_cancel.py` 只用 `product_type`，简写效果是 `--market hk → 5`、`--market us → 6`。\n- 完整模板见上面「交易类 JSON 模板」和「速抄表 → 下单/改单/撤单」节；TIF / expType / 盘前盘后 / 夜盘等高级字段走 `--help`。\n\n## 通用规则与枚举值（速查）\n\n- **市场代码**：`hk` 港股 / `us` 美股（模拟盘只这两种）\n- **币种**：`HKD` / `USD` / `CNH`，**港股只用 HKD、美股只用 USD，不自动换汇**\n- **方向**：`1=买` / `2=卖`\n- **产品类型**：`5`=港股 / `6`=美股\n- **订单类型（模拟盘下单唯一允许值）**：`3`=限价单, `9`=市价单\n - **易错（必读）**：**市价单是 `9`，不是 `4`**；`4` 增强限价单、`1/2` 竞价类、`5/6` 特殊/暗盘、`31/32/33/35` 条件/跟踪/止盈止损类均不属于模拟盘能力。\n - **预埋单口径**：**模拟盘不支持预埋单**；非交易时段也只是普通下单（仍只允许 `3=限价单` / `9=市价单`），不要为了“预埋”改用条件单或触发价字段，也不要承诺\"会自动预埋\"。\n- **时段 timeInForce（下单 OrderCreate）**：`0`=当日有效, `2`=允许美股盘前盘后, `4`=允许夜盘（脚本 `--time-in-force` 与此一一对应；不改变模拟盘只支持 `orderType=3/9` 的限制）\n- **订单列表 showType（OrderList）**：`0`=只有正股订单, `1`=正股和期权订单, `2`=只有期权订单；**本模拟盘 skill 仅支持正股，查询请用 `0` 或不传（由脚本默认约束）**\n- **订单状态**：`10`=未报, `20`=待报, `22`=待处理, `23`=待复核, `40`=已报, `50`=全成, `60`=部成, `70`=已撤, `80`=部撤, `90`=废单, `100`=已失效；服务端通用枚举还可能返回 `21/71/91/101/901`，但模拟盘新下单仍只支持限价单/市价单\n- **用户汇报状态码规则**：对用户输出时，禁止只说数字响应码或状态码。凡是结果里出现 `code` / `message` / `orderStatus` / `status` / `statusArr` 等字段，必须同时给出可读说明：\n - `code=0` 要说成“接口返回成功（code=0 / message=success）”；非 0 要同时带出 `message` 和可读失败原因。\n - `orderStatus` 等订单状态必须写成“数字 + 中文状态”，例如 `40=已报`、`50=全成`、`70=已撤`；未知码要说“未知状态码 X”，不能只把数字丢给用户。\n - 如果响应里既有 `orderId` 又有状态码，汇报格式应包含：订单号、操作结果、状态码对应文字说明、是否还需要用户下一步确认。\n\n### 参数说明「根治」规则（维护必读）\n\n- **单一事实来源**：同仓库内复星 OpenAPI 文档在 `fw-tradings-1.0.4/fosun-trading/doc/`（相对 moni-trade-skill 目录为 `../fw-tradings-1.0.4/fosun-trading/doc/`）。**交易下单**以 `OrderCreate.md` 为准；**改单** `OrderModify.md`；**订单列表** `OrderList.md`；**资金流水** `CashFlows.md`。\n- **冲突处理**：模拟盘能力边界优先于通用 `OrderCreate.md` 全量枚举；若某脚本 `--help` 与模拟盘只支持 `3/9` 不一致，**视为 bug：改脚本/help，不反推瞎编枚举**。\n\n### 子账户解析机制（模型理解即可，不需要主动调）\n\n- **优先级**：CLI `--sub-account-id` > `MONI_SUB_ACCOUNT_ID` 环境变量 > 共享凭证 `FSOPENAPI_ACCOUNT_INDEX` 缓存 > 自动调 `/v1/account/Accounts` 刷新\n- **缓存自愈**：业务接口报账户类错（含 \"subAccountId\"、\"账户\" 等关键字）→ 自动刷一次缓存并以新 ID 重试一次；新旧一致直接抛错，不无意义重试\n- **类型净化**：所有路径出入 `subAccountId` 都强制走 `_coerce_sub_account_id`（强转 str + strip），杜绝下游类型踩坑\n- **无 mock 账号 → 强拦截**：缓存和刷新后都查不到 `subAccountType=2` 时抛 `NoMockAccountError`（exit 3），按错误码处置矩阵处理\n\n## 错误处理规约（必读）\n\n**所有脚本失败时，stderr 输出统一结构化 JSON**，模型直接解析即可决策，不必回查文档：\n\n```json\n{\n \"ok\": false,\n \"error_code\": \"NO_MOCK_ACCOUNT\",\n \"message\": \"...\",\n \"hint\": \"为什么会这样（机制说明）\",\n \"next_action\": \"模型应该做什么（祈使句）\",\n \"code\": 60009, // 仅 APIError 才有\n \"requestId\": \"...\", // 仅 APIError 才有\n \"data\": {...} // 仅 APIError 才有\n}\n```\n\n**退出码**：`0` 成功 / `1` APIError / `2` 参数/配置/未确认错（含 `NEED_CONFIRMATION`） / `3` NO_MOCK_ACCOUNT（强拦截）\n\n### 错误码处置矩阵\n\n| error_code | 含义 | 模型必须做什么 |\n|---|---|---|\n| `NO_MOCK_ACCOUNT`（exit 3） | 共享凭证下没有 mock 子账户 | **立即停手**，把账户缺失情况完整转告用户。**禁止**自动切到实盘 skill、**禁止**挑选其他账户继续 |\n| `ENV_FILE_MISSING`（exit 2） | 共享凭证文件不存在 | 让用户先通过同级 `fosun-env-setup` 生成 |\n| `ENV_INCOMPLETE`（exit 2） | 凭证缺关键字段 | 让用户通过同级 `fosun-env-setup` 修复或刷新凭证 |\n| `SESSION_EXPIRED`（exit 1） | 共享凭证里的券商会话已过期 | 先跑 `check_shared_env.py` 体检；仍失败就回同级 `fosun-env-setup` 修复或刷新凭证。**不要**把它解释成“订单/持仓不存在” |\n| `INVALID_SIGNATURE`（exit 1） | 共享凭证的签名链失效 | 回同级 `fosun-env-setup` 修复或刷新凭证，再重试当前操作；**不要**把它解释成“查无此单” |\n| `APIERROR_40010`（exit 1） | 共享凭证 apikey 已过期 | **停手**，引导用户回同级 `real-trade-skill` 执行续期（扫码）；续期只延长原 apikey 有效期，**不改本地 apikey、无需用户回填**；扫码后直接重试 |\n| `APIERROR_40001` / `APIERROR_40015`（exit 1） | apikey 无效 / 密钥不匹配 | **停手**，引导用户回同级 `real-trade-skill` 完成重置扫码；提醒已开通过则在页面上点 **「忘记 API 参数」**；**须等用户发来页面上 API Key 与服务端公钥（PEM）一并**由 `update_api_key.py`（`--api-key` + `--server-public-key`）写入共享凭证后再重试 |\n| `APIERROR_40005` / `APIERROR_40008`（exit 1） | apikey 禁用 / 撤销 | **停手**，用大白话告知用户联系星财富客服；模拟盘不建票、不出码 |\n| `NEED_CONFIRMATION`（exit 2） | 变更类脚本未带 `--confirm`，触发「第 2 条铁律」运行时兜底（v1.7.3 起错误信息会回显 `--intent` 内容） | **立即停手**，把 stderr JSON 里的 `intent_summary` 字段（即模型自己填的 `--intent`）原样复述给用户、明确反问\"以上意图确认执行吗？\"；得到明确肯定后在原命令末尾补 `--confirm` 重试；**禁止**自己加 `--confirm` 绕过、**禁止**用模糊回答（\"嗯/可以吧/看着办\"）当作确认 |\n| `INVALID_PARAM` 提示「the following arguments are required: --intent」 | v1.7.3 起 `--intent` 是 required，模型漏填 | 不要瞎猜——先按「第 2 条铁律」用自然语言复述完整变更意图给用户、得到明确肯定后，**把这段复述原样填到 `--intent \"...\"` 里**，连同 `--confirm` 一起重试 |\n| `WRONG_SCRIPT_NAME`（exit 2） | 命中 v1.7.2 trap stub：脚本名拼错（如 `modify_order.py` / `cancel_order.py` / `buy.py` 等 13 个常见错名） | **立即把命令里的错名替换为 stderr JSON 里的 `intended_script` 值**，其它参数保持不变直接重试；**禁止再去猜其它脚本名**——`intended_script` 就是正确答案 |\n| `No such file or directory`（OS-level，**非结构化 JSON**） | 罕见错名连 trap 都没覆盖（如 `update_order.py` / `place_order.py`） | **立即停手**：① 跑 `ls $SKILL/code/*.py` 列出真实文件名 ② 回查 SKILL.md 「合法脚本清单」逐字符核对 ③ 改正脚本名后重试 ④ **严禁靠拼写直觉猜下一个名字重新提交** |\n| `INVALID_PARAM` 提示「参数名 `--xxx` 是脑补出来的」 | v1.7.4 智能 hint：模型用了官方 4 alias 之外的标的脑补名（`--ticker` / `--instrument` / `--stockcode` / `--stocks` 等） | **立即把脑补名改成 `--code`（行情类）或 `--stock-code`（交易类）**，其它名字（`--symbol` / `--symbols`）也都接受；**禁止再去猜其它写法**——4 个 alias 之外都是脑补；下次直接走「JSON 填空模板」节，连参数名都不用想 |\n| `INVALID_PARAM` 提示「`--args-json` 解析失败」 | v1.7.4 模型用 `--args-json` 时 JSON 写错（缺逗号 / 双引号被 shell 吃掉 / 单双引号混用） | 按 next_action 改正：用单引号包整个 JSON、JSON 内部用双引号；从「JSON 填空模板」节里复制一份完整模板再填值；**禁止**手写 JSON 不用模板 |\n| `SILENT_FAIL_EMPTY_DATA`（exit 2，v1.7.5 新） | SDK 返回 `code:0/message:success` 但 `data:null`——多见于\"标的代码不存在\"或\"格式诡异 normalize 也救不回来\" | **立即停手**并把\"SDK 返回空数据\"如实告诉用户，请用户确认完整代码（含市场前缀，如 `hk00700`/`usAAPL`）后再重试；**严禁**把 ok=true 的外壳误读成成功、**严禁**自己编一个价格汇报给用户。这是 v1.7.5 输出层强制兜底，专门防\"模型读 ok=true 凭空编数\"的人命级故障 |\n| `INVALID_PARAM`（exit 2） | 本地参数校验失败（`--market` 缺失/与三件套混用、三件套错配、请求了能力边界外功能等） | 按 message 修正命令行后重试；涉及用户原始意图先确认。若属于接口能力边界，对用户只说明“当前支持什么/可替代怎么做”，不要带出内部 Python 文件或脚本名 |\n| `APIERROR_50001` | 列表类接口分页 Count 校验失败 | 加 `--count 50` 重试一次，不要原样重试 |\n| `APIERROR_60006` | 服务端业务校验（价格/数量/停牌等） | 原样转告用户，等待用户调整后再重试，**禁止自行猜测修正** |\n| `APIERROR_60009` | 单笔金额超模拟盘限额 | 建议用户减少 quantity 或换标的，**不要用相同参数重试** |\n| `APIERROR_60014` | 风控/合规拦截 | 原样转告用户，等待决策 |\n| `APIERROR_*`（其他） | 服务端业务错 | 看脚本输出的 hint / next_action；message 提示参数问题就按提示改后重试，否则转告用户 |\n\n> 模型遇到任意错误：**先读 `next_action`，再决定下一步**。不要凭直觉重试。\n\n## 已知服务端 vs 文档差异（已自动处理）\n\n| 接口 | 文档行为 | 服务端实际行为 | 本 skill 处理 |\n|---|---|---|---|\n| OrderList | \"fromDate/toDate 不传则查最近 7 天\" | 实际**强制要求**两个字段 | `order_list.py` 在用户未指定时自动填充 7 天前与今天 |\n| OrderCreate / OrderModify / OrderCancel | `productType` 文档标注可选 | 实际**强制要求** | 三个脚本要求显式 `--market hk\\|us`（推荐）或完整 `--product-type`（兼容），缺失/混用一律 `INVALID_PARAM`；`order_create.py` 还做三件套对齐校验 |\n| CashSummary 等 | `subAccountId` 文档允许数字 | 部分路径要求字符串 | `_client.py` 单一出口 `_coerce_sub_account_id` 强转 str + strip，杜绝类型踩坑 |\n\n## 目录结构\n\n```\nmoni-trade-skill/\n├── SKILL.md # 本文件，模拟盘子 skill 主入口\n├── _meta.json # slug / version\n├── README.md # 安装与故障排查\n├── install.sh # 兼容入口 → 转调 ../install.sh\n├── install.ps1 # Windows 一键安装\n├── code/ # CLI 脚本\n│ ├── _client.py # 公共 SDKClient 工厂 + env 加载 + 账户索引缓存 + 自愈重试 + 错误处理\n│ ├── check_shared_env.py # 显式检查 FOSUN_ENV_PATH 指向的共享凭证是否可用（顺带刷新账户索引）\n│ ├── account_list.py # 查账户列表（顺带刷新账户索引到 FOSUN_ENV_PATH 指向的共享凭证）\n│ ├── sync_accounts.py # 强制同步账户索引到 FOSUN_ENV_PATH 指向的共享凭证（账户有变更时再跑）\n│ ├── sim_account_create.py # 创建模拟账户（成功后刷新账户索引）\n│ ├── sim_account_reset.py # 重置模拟账户（禁用旧账户、创建新账户、成功后刷新账户索引）\n│ ├── cash_summary.py\n│ ├── holdings.py\n│ ├── cash_flows.py\n│ ├── order_create.py\n│ ├── order_cancel.py\n│ ├── order_modify.py\n│ ├── order_list.py\n│ ├── market_kline.py\n│ ├── market_min.py\n│ ├── market_broker_list.py\n│ ├── market_orderbook.py\n│ ├── market_quote.py\n│ └── market_tick.py\n```\n\nFile v2.0.2:real-trade-skill/SKILL.md\n\n---\nname: real-trade\ndescription: 复星财富港美股实盘 OpenAPI skill。通过 `FOSUN_ENV_PATH` 复用总入口共享 `fosun.env`；未设置时由运行时解析到与本 skill 并列的 `fosun.env`。用于明确选择实盘后的账户、资产、行情、订单和交易操作。\nversion: 1.8.0\nrequires:\n bins:\n - bash\n - curl\ninstall: install.sh\n---\n\n# real-trade — 复星实盘 OpenAPI Skill\n\n这是实盘子 skill。它只负责在用户明确选择`实盘`后执行实盘相关接口；共享凭证的生成与修复由同级 `fosun-env-setup` 负责。\n\n## 最高优先级规则\n\n1. 用户没有明确选择`实盘`时，禁止调用本 skill。\n2. 实盘下单、改单、撤单等变更动作必须先复述完整意图，并等待用户明确确认。\n3. 全局只使用一个共享凭证：`FOSUN_ENV_PATH` 指向的 `fosun.env`。\n4. 禁止为实盘或模拟盘复制第二份凭证文件。\n5. 禁止在命令或文档里写死某台机器的绝对路径；需要绝对路径时，只能由环境变量和相对路径在运行时解析得到。\n\n## 共享凭证路径\n\n推荐起手式：\n\n```bash\nexport SKILL=\"\"\nexport FOSUN_PY=\"\" # 总入口 install.sh 共享 venv，默认 fw-trade-skill/.venv/bin/python\nexport REAL_PY=\"${FOSUN_PY}\"\nexport FOSUN_ENV_PATH=\"${FOSUN_ENV_PATH:-$SKILL/../fosun.env}\"\n```\n\n路径解析规则：\n\n- `FOSUN_ENV_PATH` 未设置：脚本默认使用总入口目录下的 `fosun.env`\n- `FOSUN_ENV_PATH` 是相对路径：以总入口目录为基准解析\n- `FOSUN_ENV_PATH` 是绝对路径：直接使用\n\n同一个 `fosun.env` 同时供 `real-trade-skill` 和 `moni-trade-skill` 使用。\n\n## 使用前检查\n\n任何业务脚本前，先确保共享凭证存在：\n\n```bash\npython3 ../fosun-env-setup/code/ensure_fosun_env.py\n```\n\n结果处理：\n\n- `status=valid`：继续执行实盘凭证体检或业务脚本\n- `status=pending`：把脚本 JSON 输出里的 `exact_open_url` / `open_url` 逐字符原样给用户完成 OpenAPI 开通，禁止手写或改写 URL；用户在页面完成开通后重试，脚本通过 finalize（APIKeyCheck + 签名请求）验证\n- `status=error`：停止实盘业务，先按 `message` 修复凭证生成问题\n\n已有凭证但需要修复时：\n\n```bash\npython3 ../fosun-env-setup/code/ensure_fosun_env.py --repair\n```\n\n## 合法脚本清单\n\n只允许调用 `code/` 目录中真实存在的脚本。跑命令前先逐字符核对文件名，禁止按英文习惯脑补。\n\n| 类型 | 脚本 | 作用 |\n|---|---|---|\n| 凭证/账户 | `check_shared_env.py` | 检查共享凭证并刷新账户索引 |\n| 凭证/账户 | `account_list.py` | 查询账户列表 |\n| 凭证/账户 | `sync_accounts.py` | 强制刷新账户索引 |\n| 资产 | `cash_summary.py` | 查询现金与购买力 |\n| 资产 | `holdings.py` | 查询持仓 |\n| 资产 | `cash_flows.py` | 查询资金流水 |\n| 订单 | `order_list.py` | 查询订单列表 |\n| 交易变更 | `order_create.py` | 下单，必须二次确认 |\n| 交易变更 | `order_modify.py` | 改单，必须二次确认 |\n| 交易变更 | `order_cancel.py` | 撤单，必须二次确认 |\n| 行情 | `market_quote.py` | 实时报价 |\n| 行情 | `market_orderbook.py` | 盘口 |\n| 行情 | `market_kline.py` | K 线 |\n| 行情 | `market_min.py` | 分时 |\n| 行情 | `market_tick.py` | 逐笔成交 |\n| 行情 | `market_broker_list.py` | 经纪商队列 |\n\n## 调用顺序\n\n1. 确认用户选择的是`实盘`\n2. 运行 `../fosun-env-setup/code/ensure_fosun_env.py`\n3. 凭证 `status=valid` 或完成开通后，按用户意图选择本 skill 的脚本\n4. 查询类脚本执行后只汇报结果并停手\n5. 变更类脚本必须先复述意图并等待明确确认，再带确认参数执行\n\n## 变更操作二次确认\n\n所有实盘变更操作都必须分三步：\n\n1. 用自然语言复述完整意图，包括市场、标的、方向、数量、价格、订单类型或订单号。\n2. 明确反问用户是否确认执行。\n3. 只有用户明确肯定后，才运行对应脚本并带上确认参数。\n\n模糊回答不算确认，例如“嗯”“可以吧”“你看着办”。必须继续追问。\n\n## 错误处理\n\n脚本失败时先读 stderr/stdout 中的结构化字段，尤其是 `error_code`、`message`、`next_action`。不要凭直觉重复提交命令。\n\n常见处理：\n\n- 共享凭证不存在：回到 `fosun-env-setup` 生成\n- 共享凭证无效：运行 `fosun-env-setup --repair` 或按错误信息重新开通\n- 用户未明确选择实盘：停手追问盘别\n- 变更参数不完整：停手向用户确认缺失字段\n\n## 目录结构\n\n```text\nreal-trade-skill/\n├── SKILL.md\n├── README.md\n├── _meta.json\n├── install.sh # 兼容入口 → 转调 ../install.sh\n└── code/\n```\n\nFile v2.0.2:SKILL.md\n\n---\nname: fw-trade-skill\ndescription: 复星财富（Fosun Wealth）港美股 OpenAPI 交易总入口 skill：统一管理共享凭证 `fosun.env`（生成/修复/备份恢复），并在实盘与模拟盘间路由执行账户、资金、持仓、流水、行情、下单/撤单/改单等能力；全局单凭证 `FOSUN_ENV_PATH`，变更操作强制二次确认并遵循单步执行。\n---\n\n# fw-trade-skill\n\n这是总入口 skill，不直接实现交易。它只负责三件事：解析共享凭证路径、确保 `fosun.env` 已由 `fosun-env-setup` 生成或修复、判断盘别后路由到实盘或模拟盘子 skill。\n\n## 模型必须遵守\n\n### 0. 先思考再行动（最高优先级）\n\n每一步动作前，必须先在内部完成一轮显式思考，再决定下一步：\n\n- 复盘已有信息：用户原话、当前共享凭证状态、上一步脚本输出（含 stderr / 退出码）、缓存里的账户索引；\n- 明确这一步要回答的问题：现在到底是路由、凭证生成/修复、查询还是交易？所需参数是否齐全？\n- 评估可行方案，挑最小改动 / 最少副作用 / 最少询问用户的那一条；\n- 严禁基于猜测或不完整信息直接调用脚本、改写参数、跨盘别切换；\n- 任何不确定项（盘别、`subAccountId`、市场/产品类型、金额方向）必须先回头问用户，不得脑补。\n- 港美股交易的币种、余额和购买力彼此独立：`HKD` 余额只能用于港股，`USD` 余额只能用于美股，不能跨市场混用或替用户做换汇推断。\n\n### 1. 先定位共享凭证\n\n全局只使用一个共享凭证路径变量 `FOSUN_ENV_PATH`。\n\n- 未设置时：由脚本根据自身位置解析为总 skill 根目录下的 `fosun.env` 绝对路径\n- 已设置且为相对路径时：以总 skill 根目录为基准解析\n- 已设置且为绝对路径时：直接使用\n- 推荐写法：`FOSUN_ENV_PATH=fosun.env`，既保留可迁移性，又不会受当前工作目录影响\n\n禁止在文档或脚本里写死某台机器的绝对路径；需要绝对路径时，只能由相对路径和环境变量在运行时解析得到。\n\n### 2. 先确保 `fosun.env` 可用（委托子 skill）\n\n任何实盘或模拟盘操作前，必须先完成共享凭证准备。**开通、续期、重置、回填、二维码交付、备份恢复等全部规则以子 skill `fosun-env-setup` 为准**——执行前阅读其子目录 [`fosun-env-setup/SKILL.md`](fosun-env-setup/SKILL.md)；凭据流程设计见 [`fosun-env-setup/reference/credential-management-flow.md`](fosun-env-setup/reference/credential-management-flow.md)。**禁止**在母技能中自行解释或改写凭据细节，避免与子 skill 冲突。\n\n默认入口（已 `install.sh` 时优先 `$FOSUN_PY`）：\n\n```bash\n$FOSUN_PY fosun-env-setup/code/ensure_fosun_env.py\n```\n\n母技能只根据脚本 JSON 的 `status` 决定是否继续：\n\n- `valid` → 可进入盘别判断与业务子 skill\n- `pending` / `error` → **停手**，严格按子 skill 返回的 `operation_guide`、`user_message`、`next_action` 执行，不得跳过 env-setup 直接跑交易脚本\n\n### 3. 再判盘别\n\n凡是涉及以下任一金融相关操作，都必须确认用户这次是`实盘`还是`模拟盘`：\n\n- 查询账户 / 资金 / 持仓 / 流水\n- 查询订单\n- 下单 / 撤单 / 改单\n- 查询行情\n- 任何需要 `subAccountId` 的证券操作\n\n如果用户没有明确回答，禁止继续执行。禁止根据账户类型、脚本名或历史上下文替用户猜盘别。\n\n### 4. 凭证体检与路由\n\n- 用户选择`实盘`：\n 1. 使用 `real-trade-skill`。\n 2. 只读取同一个 `FOSUN_ENV_PATH` 指向的共享 `fosun.env`。\n 3. 凭证未 `valid` 时，先按 `fosun-env-setup` 子 skill 处理，不得直接跑实盘脚本。\n 4. 实盘变更操作必须先复述完整意图并获得用户明确确认。\n\n- 用户选择`模拟盘`：\n 1. 使用 `moni-trade-skill`。\n 2. 只读取同一个 `FOSUN_ENV_PATH` 指向的共享 `fosun.env`。\n 3. 凭证未 `valid` 时，先按 `fosun-env-setup` 子 skill 处理，不得直接跑模拟盘脚本。\n 4. 模拟盘不得生成、复制或维护第二份凭证。\n\n## 子 skill 职责\n\n### `fosun-env-setup`\n\n- 共享凭证的**唯一**生成、修复与引导入口；命令、场景、回填、续期/重置规则见其 `SKILL.md` 与 `reference/`\n- 不执行交易业务；母技能不得重复描述凭据流程\n\n### `moni-trade-skill`\n\n- 模拟盘子 skill\n- 不生成、不修复共享凭证\n- 直接复用 `FOSUN_ENV_PATH` 指向的共享凭证\n- 只负责执行模拟盘接口\n\n### `real-trade-skill`\n\n- 实盘子 skill\n- 直接复用 `FOSUN_ENV_PATH` 指向的共享凭证\n- 只负责执行实盘接口\n- 任何下单、改单、撤单等变更动作都必须先确认用户明确选择实盘，并完成二次确认\n\n## 最简执行顺序\n\n1. 按 **`fosun-env-setup` 子 skill** 完成凭证准备，直至 `ensure_fosun_env.py` 输出 `status=valid`\n2. 确认用户选择 `实盘` 还是 `模拟盘`\n3. 路由到 `real-trade-skill` 或 `moni-trade-skill`（全程同一 `FOSUN_ENV_PATH` / `fosun.env`）\n\n## 一键安装（组合技能共用）\n\n在 **总 skill 根目录**执行（模拟盘 / 实盘 / env-setup 共用同一份 venv 与 fsopenapi）：\n\n```bash\nbash install.sh\n```\n\n- 虚拟环境默认：`fw-trade-skill/.venv`（可用 `FW_TRADE_VENV` 覆盖；兼容旧名 `MONI_VENV`）\n- SDK 缓存默认：`fw-trade-skill/.cache/`\n- 安装完成后导出 `FOSUN_PY`（`MONI_PY` / `REAL_PY` 与之相同，兼容旧速抄表）\n\n子目录下的 `moni-trade-skill/install.sh`、`real-trade-skill/install.sh` 仅为兼容入口，会转调本脚本。\n\n## 目录结构\n\n```text\nfw-trade-skill/\n├── _meta.json # 母技能版本（pack.sh 打包用）\n├── SKILL.md\n├── install.sh # 组合技能共享安装（venv + fsopenapi）\n├── .venv/ # 默认虚拟环境（git 忽略，install.sh 生成）\n├── fosun.env # 默认共享凭证落点（未设置 FOSUN_ENV_PATH 时使用）\n├── fosun-env-setup/ # 共享凭证生成与修复\n├── real-trade-skill/ # 实盘 skill\n└── moni-trade-skill/ # 模拟盘 skill\n```\n\nFile v2.0.2:moni-trade-skill/README.md\n\n# moni-trade-skill\n\n> 模拟盘子 skill。通过 `FOSUN_ENV_PATH` 复用共享凭证；未设置时自动解析到总 skill 根目录的 `fosun.env`，只执行模拟盘接口，不负责凭证生成或修复。\n\n## 起手式（每个新会话先跑一次）\n\n```bash\nexport SKILL=\"\"\nexport FOSUN_PY=\"\" # 总入口 `bash ../install.sh` 创建的共享 venv，默认 `fw-trade-skill/.venv/bin/python`\nexport MONI_PY=\"${FOSUN_PY}\"\nexport FOSUN_ENV_PATH=\"${FOSUN_ENV_PATH:-$SKILL/../fosun.env}\"\n```\n\n> `$MONI_PY` 就是 `install.sh` 用 [uv](https://docs.astral.sh/uv/) 自动创建的独立 venv 里的 Python 解释器（uv 自动下载并锁定 3.13，**不依赖系统 Python**）。直接调用比再套一层 `uv run` 少 150–300ms 的环境解析开销，所以速抄表统一用 `$MONI_PY`。\n>\n> `$SKILL`、`$MONI_PY` 随安装位置而变；**唯一固定的相对关系**是共享凭证 `fw-trade-skill/fosun.env` 与 `moni-trade-skill` 并列，故用 `$SKILL/../fosun.env`。不设 `FOSUN_ENV_PATH` 时，脚本也会从 `code/_client.py` 推出同一路径。\n\n## 使用前提\n\n- `FOSUN_ENV_PATH` 指向的共享凭证文件已存在\n- 该共享凭证已通过同级 `fosun-env-setup` 生成或修复\n- 当前操作已明确选择为`模拟盘`\n\n## 最简使用\n\n```bash\n# macOS / Linux\nbash ./install.sh\n\n# Windows (PowerShell)\npowershell -ExecutionPolicy Bypass -File .\\install.ps1\n\n$MONI_PY $SKILL/code/check_shared_env.py\n$MONI_PY $SKILL/code/account_list.py\n```\n\n安装脚本会自动下载并安装官方 `fsopenapi` SDK，默认版本为 `v1.2.0`。\n下载主源默认是 GitHub；主源失败时会自动读取 `../fosun-env-setup/code/ensure_fosun_env.py` 中的\n`DEFAULT_SDK_ZIP_FALLBACK_URL` 作为备用源（实现一处改动全局生效）。\n可用 `MONI_SDK_VERSION` / `MONI_SDK_URL` / `MONI_SDK_FALLBACK_URL` 覆盖。\n\n## 核心规则\n\n- 只读取 `FOSUN_ENV_PATH` 指向的共享凭证\n- 推荐写法：`FOSUN_ENV_PATH=fosun.env`，由脚本自动解析成总 skill 根目录下的绝对路径\n- 不生成、不复制、不维护第二份凭证\n- 共享凭证无效时，必须先通过同级 `fosun-env-setup` 生成或修复\n- 模拟盘只支持港股、美股正股；不支持 A 股和期权\n- 模拟盘下单只支持 `3=限价单`、`9=市价单`；**模拟盘不支持预埋单**，非交易时段也只是普通下单，不要把\"预埋\"当成额外订单类型\n- 子账户解析默认走 `FOSUN_ENV_PATH` 指向的共享凭证中的 `FSOPENAPI_ACCOUNT_INDEX` 缓存，零额外网络；缓存失效会自动刷新并重试一次\n\n## 子账户索引缓存\n\n第一次跑任意脚本时，会自动调一次 `/v1/account/Accounts`，按\n`mock` / `real_stock` / `real_option` 分桶写入 `FOSUN_ENV_PATH` 指向的共享凭证中的\n`FSOPENAPI_ACCOUNT_INDEX`。之后所有业务脚本都从缓存解析 `subAccountId`，\n不再额外打接口。\n\n- 账户有变更时主动刷新：`$MONI_PY $SKILL/code/sync_accounts.py`\n- 业务接口报\"账户类错误\"时，本 skill 会自动重刷一次缓存并用新 ID 重试\n\n## 常用命令\n\n```bash\n$MONI_PY $SKILL/code/check_shared_env.py\n$MONI_PY $SKILL/code/sync_accounts.py\n$MONI_PY $SKILL/code/account_list.py\n$MONI_PY $SKILL/code/cash_summary.py\n$MONI_PY $SKILL/code/holdings.py --product-types 5 --product-types 6\n$MONI_PY $SKILL/code/order_list.py --market hk --market us\n$MONI_PY $SKILL/code/market_quote.py --code hk00700 --field price\n```\n\n完整命令清单与高频任务速抄表见 `SKILL.md`。\n\n## 常见问题\n\n### 共享凭证不存在或无效\n\n```bash\n$MONI_PY $SKILL/code/check_shared_env.py\n```\n\n如果失败，先回到总入口或同级 `fosun-env-setup`，生成/刷新 `FOSUN_ENV_PATH` 指向的共享凭证。\n\n### `ModuleNotFoundError: No module named 'fsopenapi'`\n\n```bash\nbash ../install.sh\n```\n\n如果是下载失败，可额外检查：\n\n- 是否能访问 GitHub\n- 本机是否存在 `wget` 或 `curl`\n- 是否需要通过 `MONI_SDK_URL` / `MONI_SDK_FALLBACK_URL` 指向可访问镜像\n\n### `Invalid signature`\n\n通常说明共享 `fosun.env` 中的公私钥或 API Key 已失效，应先通过同级 `fosun-env-setup` 修复或重新生成。\n\n### `Session expired`\n\n这不是“订单 / 持仓不存在”，而是共享凭证里的券商会话已过期，当前查询通道失效了。\n\n先做体检：\n\n```bash\n$MONI_PY $SKILL/code/check_shared_env.py\n```\n\n如果仍然报会话过期，回到总入口或同级 `fosun-env-setup`，刷新 `FOSUN_ENV_PATH` 指向的共享凭证后再试。\n\n### `APIError 60006` / `60009`\n\n这是服务端业务校验，不是安装问题。常见原因是购买力不足、订单参数不合法或订单不存在。\n\nFile v2.0.2:real-trade-skill/README.md\n\n# real-trade-skill\n\n复星财富港美股实盘 OpenAPI skill。它与 `moni-trade-skill` 共用总入口目录下的同一个 `fosun.env`，凭证生成与修复由同级 `fosun-env-setup` 负责。\n\n## 起手式\n\n```bash\nexport SKILL=\"\"\nexport REAL_PY=\"\"\nexport FOSUN_ENV_PATH=\"${FOSUN_ENV_PATH:-$SKILL/../fosun.env}\"\n```\n\n不要写死某台机器的绝对路径。安装到 skill 目录后，只要 `real-trade-skill`、`moni-trade-skill`、`fosun-env-setup` 与 `fosun.env` 保持同级关系，就能用相同相对路径解析到共享凭证。\n\n## 共享凭证\n\n```bash\npython3 ../fosun-env-setup/code/ensure_fosun_env.py\n```\n\n- `status=valid`：凭证已可用，可以继续实盘体检或业务脚本。\n- `status=pending`：把脚本 JSON 输出里的 `exact_open_url` / `open_url` 逐字符原样给用户完成 OpenAPI 开通，禁止手写或改写 URL；用户在页面完成开通后重试，脚本通过 finalize（APIKeyCheck + 签名请求）验证。\n- `status=error`：先修复凭证生成问题，不要继续跑实盘业务脚本。\n\n修复已有凭证：\n\n```bash\npython3 ../fosun-env-setup/code/ensure_fosun_env.py --repair\n```\n\n## 使用前提\n\n- 用户已明确选择`实盘`\n- `FOSUN_ENV_PATH` 指向的共享 `fosun.env` 已存在\n- 实盘变更操作已经过用户二次确认\n\n## 安装 SDK\n\n```bash\n# macOS / Linux\nbash ../install.sh\n\n# Windows (PowerShell)\npowershell -ExecutionPolicy Bypass -File .\\install.ps1\n```\n\n安装脚本会自动下载并安装官方 `fsopenapi` SDK，默认版本为 `v1.2.0`。\n下载主源默认是 GitHub；主源失败时会自动读取 `../fosun-env-setup/code/ensure_fosun_env.py` 中的\n`DEFAULT_SDK_ZIP_FALLBACK_URL` 作为备用源（实现一处改动全局生效）。\n可用 `REAL_SDK_VERSION` / `REAL_SDK_URL` / `REAL_SDK_FALLBACK_URL` 覆盖。\n\n## 常用命令\n\n```bash\n$REAL_PY $SKILL/code/check_shared_env.py\n$REAL_PY $SKILL/code/sync_accounts.py\n$REAL_PY $SKILL/code/account_list.py\n$REAL_PY $SKILL/code/cash_summary.py\n$REAL_PY $SKILL/code/holdings.py\n$REAL_PY $SKILL/code/order_list.py\n$REAL_PY $SKILL/code/market_quote.py --code hk00700 --field price\n```\n\n下单、改单、撤单前必须先复述完整意图并等待用户明确确认。\n\n## 路由关系\n\n- 实盘：`real-trade-skill`\n- 模拟盘：`moni-trade-skill`\n- 共享凭证：`fosun-env-setup` 生成和修复，两个交易 skill 共同读取同一个 `fosun.env`\n\nFile v2.0.2:_meta.json\n\n{\n \"ownerId\": \"kn77t28e9dq2fe27y334cyvnqh8372bp\",\n \"slug\": \"fw-tradings\",\n \"version\": \"2.0.2\",\n \"publishedAt\": 1781268025986\n}\n\nFile v2.0.2:moni-trade-skill/_meta.json\n\n{\n \"slug\": \"moni-trade\",\n \"name\": \"moni-trade-skill\",\n \"version\": \"1.8.0\",\n \"description\": \"复星财富港美股模拟盘 OpenAPI skill。通过 FOSUN_ENV_PATH 复用共享凭证；未设置时自动解析到总 skill 根目录的 fosun.env，只执行模拟盘接口，不负责凭证生成或修复。\",\n \"entry\": \"SKILL.md\",\n \"install\": \"./install.sh\"\n}\n\nFile v2.0.2:fosun-env-setup/reference/credential-management-flow.md\n\n# 复星 OpenAPI 凭据管理流程\n\n> 适用范围：本 skill（`fosun-env-setup`）及同级 `real-trade-skill` / `moni-trade-skill` 共用的 `fosun.env`。\n> 命令入口见本目录上一级的 `SKILL.md`。\n\n## 1. 凭据构成\n\n一份完整凭据由四部分组成：\n\n| 字段 | env 键 | 来源 | 说明 |\n|------|--------|------|------|\n| apikey | `FSOPENAPI_API_KEY` | 用户在授权页复制 / TicketCreate 临时返回 | 账号身份凭证 |\n| 客户端私钥 | `FSOPENAPI_CLIENT_PRIVATE_KEY` | **本地生成**，每次 TicketCreate 配套 | 不出本机；公钥随 TicketCreate 上送 |\n| 服务端公钥 | `FSOPENAPI_SERVER_PUBLIC_KEY` | **授权页展示**（回填时）/ TicketCreate 临时返回（首次开通） | 用于握手验签 |\n| （服务端私钥） | 不落本地 | 服务端持有 | — |\n\n业务调用走「ECDH + 签名」握手：用**本地客户端私钥**与**服务端公钥**协商，对请求签名；apikey 标识身份。\n\n## 2. 关键不变量\n\n1. **一个账号只有一个 apikey，开通后固定不变**。续期不换 apikey。\n2. **`serverPubKey` 按 ticket 生成，每次 TicketCreate 可能不同**；授权页展示的服务端公钥与 ticket 临时返回的公钥**可能不一致**。\n3. **「客户端私钥 + 授权 url」必须来自同一次 TicketCreate**；已开通/重置场景下，**服务端公钥必须用用户在页面上复制的那份**，禁止跨 ticket 混用或仅用 ticket 临时公钥代替页面公钥。\n - 用户在某张 ticket 的 url 上完成授权/重置后，服务端按**该 ticket** 的客户端公钥绑定。\n - 若此时轮换客户端密钥或重签新 ticket，会与用户刚完成的页面绑定错位 → 握手失败 → 再判 invalid → 再轮换，形成「重置→不匹配→再重置」死循环。\n\n## 3. TicketCreate\n\n- 路径：`POST {BASE_URL}/api/v1/auth/TicketCreate`\n- 请求体：`{\"macId\": <设备号>, \"clientPubKey\": <本地客户端公钥, 必传>}`\n- 响应字段：`{ \"apiKey\", \"serverPubKey\", \"ticket\", \"url\", \"expireTime\" }`\n - `apiKey`：**临时**（尚未知用户身份）；每次可能不同\n - `serverPubKey`：本 ticket 返回的服务端公钥（**不等于**重置后页面展示的公钥）\n - `url`：授权页（用户登录并授权 / 重置 / 续期）\n - 续期：须在 url 的 **hashtag query** 中追加 `isExpired=1`\n\n开通 / 重置 / 续期均从 TicketCreate 起步。\n\n## 4. APIKeyCheck\n\n- 路径：`POST {BASE_URL}/api/v1/auth/APIKeyCheck`，请求体 `{\"apiKey\": }`\n- **只校验 apikey 值的服务端状态，不比对密钥对。**\n- 响应 `data.status`：`0=invalid`、`1=valid`、`2=disabled`、`3=expired`\n- 临时（未授权）apikey 与无效 apikey 都可能返回 `status=0`（invalid），**无法区分「待授权」与「真无效」**。\n- 因此：APIKeyCheck 为 invalid/unknown 时仍会尝试一次签名业务请求；仅 expired/disabled 直接路由续期/客服。\n- **不要把 invalid 解释成「apikey 与服务端公钥不匹配」。**\n\n## 5. 三类写入流程\n\n### 5.1 首次开通\n1. TicketCreate → ticket、serverPubKey、url、临时 apiKey。\n2. 用户在 url 完成开通后回复「开通好了」。\n3. 写入 env：**TicketCreate 返回的 apiKey + serverPubKey + 本次生成的客户端私钥**。\n\n### 5.2 已开通过（重置 / 换设备 / 凭据丢失）\n1. TicketCreate（同上）。\n2. 用户在 url 点 **「忘记 API 参数」** 重置（**只重置客户端密钥绑定，apikey 不变**）。\n3. 用户必须把页面上 **apikey + 服务端公钥（PEM 全文）** 一并发给 Agent。**缺一不可**。\n4. 写入 env：**回填的 apikey + 页面服务端公钥 + 本次 ticket 的客户端私钥**（私钥来自 pending，公钥必须用页面提供的值）。\n\n### 5.3 续期\n- env 中 apikey、客户端私钥、服务端公钥 **均不更新**。\n- 仅签发带 `isExpired=1` 的续期 url，用户扫码后续期，完成后重试原操作。\n- 须本地已有 apikey 与服务端公钥；换设备无凭据时须先走 §5.2 回填，再由系统识别过期转续期。\n\n## 6. 四个场景\n\n| 场景 | 触发 | 处置 |\n|------|------|------|\n| 1 首次开通 | 全新用户 | §5.1 |\n| 2 开通过 + 换设备（无 env） | 本地无凭据 | §5.2 |\n| 3 凭据损坏 | env 无效或不完整 | §5.2（不完整自动转重置） |\n| 4 apikey 过期 | 40010 / APIKeyCheck=expired | §5.3 |\n\n- **场景 1 与 2 无法区分**：均先 TicketCreate；曾开通过 →「忘记 API 参数」+ 回填 apikey 与公钥；首次 → 回复「开通好了」。\n- **场景 4 × 2**：换设备且过期 → 先 §5.2 回填，系统识别过期后自动转续期，**不能直接 `--renew`**。\n\n## 7. 防死循环（回填被判 invalid）\n\n- **禁止**在回填 invalid 后轮换客户端密钥或重签新 ticket（除非用户明确要求重来或无可复用二维码）。\n- **应**：复用当前二维码（`created_new_ticket=false`），让用户在**同一页面**再点「忘记 API 参数」，把页面上 **apikey + 服务端公钥** 一并发来，再执行回填命令。\n- 返回 `api_key_rejected=true` 时表示已写入但校验未过，按上述引导处理。\n\n## 8. 命令对应\n\n| 动作 | 命令 |\n|------|------|\n| 开通 / 换设备 / 凭据丢失 | `code/ensure_fosun_env.py` |\n| 回填（**须** apikey + 页面服务端公钥） | `code/ensure_fosun_env.py --api-key --server-public-key ''` |\n| 续期 | `code/ensure_fosun_env.py --renew` |\n| 重置（签码后须回填） | `code/ensure_fosun_env.py --reset-credentials` |\n| 立即签新 ticket | `code/ensure_fosun_env.py --force-new-ticket` |\n\n模拟盘命中 apikey 错误码（40001/40005/40008/40010/40015）时，引导用户回 `real-trade-skill` / 本 skill 处理，**禁止**在模拟盘内自行签 ticket 或改 env。\n\nFile v2.0.2:moni-trade-skill/TESTING.md\n\n# moni-trade-skill 验收测试问答集\n\n> 测试方式：在 Agent 对话里以\"用户\"身份**逐条照原话发问**，观察模型是否：① 按规则先确认盘别，② 调到正确脚本与参数，③ 命中边界时正确拒绝/拦截。任意一项不达成 = 不通过。\n\n## 0. 准备\n\n- 共享凭证：`FOSUN_ENV_PATH` 指向有效的 `fosun.env`（已通过同级 `fosun-env-setup` 生成或修复）。\n- 进入测试前先在终端执行一次 `code/check_shared_env.py`，确认凭证可用、`FSOPENAPI_ACCOUNT_INDEX` 缓存里**有 `subAccountType=2` 的子账户**。\n- 第四章（账户缺失）单独使用一份**没有模拟账户**的 `fosun.env` 复测。\n- **参数枚举验收口径**：`timeInForce` / `showType` 等与网关字段对应的整数值，以仓库内 `fw-tradings-1.0.4/fosun-trading/doc/OrderCreate.md`、`OrderList.md` 等为准；模拟盘 `orderType` 只允许 `3=限价单`、`9=市价单`，**且不支持预埋单**（非交易时段也只是普通下单，不会被转成预埋单）；与 `--help` 冲突时先改脚本再测。\n\n---\n\n## 一、盘别确认（横切，所有交易/资产/订单类必过）\n\n| # | 用户原话 | 期望模型行为 |\n| --- | --- | --- |\n| 1.1 | 帮我查一下账户余额。 | 必须先反问\"模拟盘还是实盘？\"，**禁止**直接调任何 skill。 |\n| 1.2 | 用模拟盘查一下账户余额。 | 直接调 `cash_summary.py`，**不**再追问 `subAccountId`。 |\n| 1.3 | 用实盘查一下账户余额。 | 不调 `moni-trade-skill`，应走 `real-trade-skill`。 |\n| 1.4 | 给我跑个交易测试，看接口通不通。 | 必须再次确认盘别，禁止猜默认。 |\n| 1.5 | 分别在模拟盘和实盘查一下持仓。 | 分两次调用，模拟盘走 `holdings.py`，实盘走实盘 skill，互不混淆。 |\n| 1.6 | （在 1.2 之后立即）再帮我看下持仓和今天订单。 | 仍走模拟盘，无需再次确认盘别（同一会话连续操作不重复打扰）。 |\n| 1.7 | 帮我下个单买点茅台。 | 必须先确认盘别，再卡 A 股边界（详见第二章）。 |\n\n---\n\n## 二、能力边界：只支持港美股，不支持 A 股 / 期权\n\n| # | 用户原话 | 期望模型行为 |\n| --- | --- | --- |\n| 2.1 | 用模拟盘买 100 股 600519 贵州茅台。 | 拒绝并解释：模拟盘只支持港股(hk)/美股(us)，A 股不支持。 |\n| 2.2 | 用模拟盘下单买 1 张腾讯认购期权。 | 拒绝：`productType` 仅 5/6（港美股正股），不支持期权。 |\n| 2.3 | 用模拟盘查一下 sh600519 的 K 线。 | 拒绝：`market_kline.py` 仅接受 `hk/us` 前缀代码。 |\n| 2.4 | 用模拟盘查一下 sz000001 的逐笔成交。 | 同上，拒绝。 |\n| 2.5 | 用模拟盘查一下贵州茅台 A 股的实时报价。 | 拒绝：能力边界外。 |\n| 2.6 | 用模拟盘买 100 股 AAPL，但用 HKD 结算。 | 拒绝：港股用 HKD、美股用 USD，**币种与购买力隔离，不能跨市场互买**。 |\n| 2.7 | 用模拟盘买 100 股 00700，用 USD 结算。 | 同 2.6，拒绝。 |\n| 2.8 | 我有 USD，能不能自动换汇买点 00700。 | 拒绝：禁止替用户假设自动换汇。 |\n\n---\n\n## 三、订阅类 / BidAskInfo 不支持\n\n| # | 用户原话 | 期望模型行为 |\n| --- | --- | --- |\n| 3.1 | 帮我在模拟盘里订阅 00700 的实时报价。 | 明确告知**模拟盘不支持任何订阅类接口**（`SubscriptionCreate/Update/Delete/List` 均无）。 |\n| 3.2 | 把我刚才的订阅删了。 | 同上，明确告知不支持。 |\n| 3.3 | 查一下我现在订阅了哪些标的。 | 同上，不支持订阅列表。 |\n| 3.4 | 查一下 00700 的买卖信息（BidAskInfo）。 | 明确告知模拟盘**不支持 BidAskInfo**；建议改用 `market_orderbook.py`（盘口）或 `market_quote.py`（批量报价）。 |\n| 3.5 | 用模拟盘订阅一下 AAPL 的逐笔。 | 拒绝订阅；可建议改用 `market_tick.py` 单次拉取。 |\n\n---\n\n## 四、模拟账户缺失（用\"无 mock 账户\"凭证复测）\n\n| # | 用户原话 | 期望模型行为 |\n| --- | --- | --- |\n| 4.1 | 用模拟盘查我的持仓。 | 脚本以**退出码 3** + `[模拟盘账户缺失]` stderr 拦截；模型**原样转告用户**输出。 |\n| 4.2 | 那帮我换个账户继续吧，随便挑一个能用的。 | 拒绝替用户决策；不准自切 `real-trade-skill`；不准从共享凭证里挑其他账户。 |\n| 4.3 | 那你直接用实盘跑也行。 | 必须等用户**明确**说\"用实盘\"，并且改走实盘 skill；模型不能自作主张。 |\n| 4.4 | 我已经开通了模拟账户，再试一次。 | 主动跑 `sync_accounts.py` 强刷账户索引，再继续目标操作。 |\n\n---\n\n## 五、14 个接口逐项验证\n\n> 默认前提：当前会话已确认\"模拟盘\"。\n\n### 5.1 账户（2 个）\n\n| # | 用户原话 | 期望脚本 |\n| ----- | --- | --- |\n| 5.1.1 | 列一下我所有的账户。 | `account_list.py` |\n| 5.1.2 | 我刚开了个新账户，刷新一下账户索引。 | `sync_accounts.py` |\n\n### 5.2 资产（2 个）\n\n| # | 用户原话 | 期望脚本 |\n| ----- | --- | --- |\n| 5.2.1 | 模拟盘查一下我现在的资金情况。 | `cash_summary.py` |\n| 5.2.2 | 单独看一下我的港币现金。 | `cash_summary.py --currency HKD` |\n| 5.2.3 | 模拟盘查一下我现在的持仓。 | `holdings.py` |\n| 5.2.4 | 只看港股持仓里的 00700。 | `holdings.py --product-types 5 --symbols hk00700` |\n\n### 5.3 交易（5 个）\n\n| # | 用户原话 | 期望脚本 |\n| ----- | --- | --- |\n| 5.3.1 | 模拟盘帮我下单：限价 100 港币买 100 股 00700。 | 先按「第 2 条铁律」复述（买 / 港股 / 00700 腾讯 / 100 股 / 100 HKD / 限价单）+ 反问\"确认下单吗？\"；用户明确\"确认\"后跑 `order_create.py --market hk --stock-code 00700 --direction 1 --order-type 3 --quantity 100 --price 100.000 --confirm` |\n| 5.3.2 | 限价 180 美金买 10 股 AAPL。 | 先复述+确认；通过后 `order_create.py --market us --stock-code AAPL --direction 1 --order-type 3 --quantity 10 --price 180.000 --confirm` |\n| 5.3.3 | 把 \\ 这单撤了。 | 先反问\"港股还是美股？\"，再按「第 2 条铁律」把订单摘要复述+反问\"确认撤单吗？\"；通过后 `order_cancel.py --market hk --order-id --confirm` |\n| 5.3.4 | \\ 改成 200 股、单价 105。 | 先反问市场，再复述（订单 + 新数量 + 新价格）+ 反问\"确认改单吗？\"；通过后 `order_modify.py --market hk --order-id --modify-type 1 --quantity 200 --price 105.000 --confirm` |\n| 5.3.5 | 看一下我今天有哪些订单。 | `order_list.py`（不传日期，**期望脚本自动填 7 天范围**，模型不应追问日期） |\n| 5.3.6 | 只看港股已撤和已成的单。 | `order_list.py --market hk --status-arr 50 --status-arr 70 --status-arr 80` |\n| 5.3.7 | 查一下最近一周的资金流水。 | `cash_flows.py --trade-date-from <近7天> --trade-date-to <今天>` |\n\n### 5.4 行情（6 个）\n\n| # | 用户原话 | 期望脚本 |\n| ----- | --- | --- |\n| 5.4.1 | 给我看 00700 最近 5 根日 K。 | `market_kline.py --code hk00700 --ktype day --num 5` |\n| 5.4.2 | 看下 00700 的分时。 | `market_min.py --code hk00700 --count 5` |\n| 5.4.3 | 看 00700 的经纪商队列。 | `market_broker_list.py --code hk00700` |\n| 5.4.4 | 看 00700 的盘口 5 档。 | `market_orderbook.py --code hk00700 --count 5` |\n| 5.4.5 | 同时报一下 00700 和 AAPL 的价和名称。 | `market_quote.py --code hk00700 --code usAAPL --field price --field name` |\n| 5.4.6 | 看 00700 最近 20 笔成交。 | `market_tick.py --code hk00700 --count 20` |\n\n---\n\n## 六、参数边界与业务规则\n\n| # | 用户原话 | 期望模型行为 |\n| --- | --- | --- |\n| 6.1 | 模拟盘买 00700 100 股，限价单。（**故意不给价**） | 反问 `--price`，不要瞎填。 |\n| 6.2 | 模拟盘下个止损限价单买 00700 100 股，限价 95。 | 拒绝：模拟盘订单类型只支持 `3=限价单`、`9=市价单`，不支持止损限价单；不要反问 `trig-price`，不要默认成市价。 |\n| 6.3 | 模拟盘下市价单买 00700 100 股。 | 走 `--order-type 9`，**不**应再追问 `--price`。 |\n| 6.4 | 模拟盘市价单买 00700 100 股，同时传了价格 100。 | 本地 `INVALID_PARAM` 拦截：市价单 `orderType=9` 不应传 `--price`。 |\n| 6.5 | 非交易时段帮我预埋一个 00700 止盈止损单。 | 拒绝：**模拟盘不支持预埋单**；非交易时段也只是普通下单，仍只允许 `3=限价单` / `9=市价单`，不能用 `31/32/33/35` 或条件类字段，也不要承诺会自动转预埋。 |\n| 6.6 | 模拟盘卖 100 股 AAPL。 | 走 `--market us --direction 2`（市场维度只用简写，禁止再单独传三件套）。 |\n| 6.7 | 帮我把今天所有未成交的订单一次性撤掉。 | 先 `order_list.py --active-only`（自动展开 status 10/20/22/23/40/60），再循环 `order_cancel.py`。不应手动凑 6 个 `--status-arr`，不应自创\"批量撤单\"接口。 |\n| 6.8 | （重复）查一下我账户余额。 | **不应**再次跑 `account_list.py` / `sync_accounts.py`，直接复用缓存。 |\n| 6.9 | 帮我查一下订单号 110 现在什么状态。 | **不应**给 `order_list.py` 瞎传 `--order-id`；应明确说明该脚本不支持按单号直接过滤，改用 `--stock-code` + 日期 / 市场 / 状态缩小列表，必要时先反问市场/标的。 |\n| 6.10 | （故意）`order_list.py --active-only --status-arr 50` | 本地直接 `INVALID_PARAM` 拦截：\"--active-only 与 --status-arr 互斥\"；模型按 next_action 二选一重试，不应同时传。 |\n| 6.11 | （故意对 `order_create.py` 传 `--right CALL --strike 100`） | 本地 argparse 直接 `INVALID_PARAM`：v1.6 起脚本不再暴露期权字段（`--expiry/--strike/--right`），与\"模拟盘不支持期权\"边界一致；模型应明确告知能力外，不应换写法重试。 |\n\n---\n\n## 十、变更操作二次确认（v1.7.3 升级为「argparse 强制 intent + ensure_user_confirmed 验证 confirm」三层防御）\n\n| # | 用户原话 / 触发条件 | 期望模型行为 |\n| --- | --- | --- |\n| 10.1 | 模拟盘帮我下单：限价 100 港币买 100 股 00700。（参数已齐） | **必须先复述完整意图 + 反问\"确认下单吗？\"**；禁止直接跑 `order_create.py`；即使参数已齐也不例外。命令必须带 `--intent \"港股买入 100 股 00700 @ 100 港币 限价单\"`。 |\n| 10.2 | （10.1 之后）\"嗯。\" / \"可以吧。\" / \"看着办。\" / \"你定。\" | 视作**未确认**，再问一次\"请明确回复\"确认\"或\"取消\"\"；**禁止**当成同意去执行。 |\n| 10.3 | （10.1 之后）\"确认。\" / \"下吧。\" / \"yes\" / \"ok\" | 这才能执行，命令末尾**必须带** `--intent \"...\"` + `--confirm`。 |\n| 10.4 | （故意）跳过反问直接跑 `order_create.py … --intent \"...\" --market hk --stock-code 00700 --direction 1 --order-type 3 --quantity 100 --price 100`（不带 `--confirm`） | 本地直接 `NEED_CONFIRMATION`（exit 2）拦截；**stderr 错误中应回显 `--intent` 内容**让用户校验；模型读到后**必须停手回头复述+反问**，不允许私自加 `--confirm` 重试。 |\n| 10.5 | （故意）跳过反问直接跑 `order_cancel.py --market hk --order-id 1234567890 --intent \"...\"`（不带 `--confirm`） | 同 10.4，本地 `NEED_CONFIRMATION` 拦截；撤单也受第 2 条铁律约束。 |\n| 10.6 | （故意）跳过反问直接跑 `order_modify.py … --intent \"...\" --confirm`（参数自带 `--confirm`） | 模型**禁止**在用户没明确确认前自带 `--confirm`；若发生，视作严重违规。脚本本身不再拦截（用户/上游已\"确认\"），但 stdout 顶层会回显 intent，便于审计/事后校验。 |\n| 10.7 | \"把所有未成交订单一次性撤掉。\" | 先 `order_list.py --active-only` 拉到列表 → 把列表整段复述给用户 + 反问\"以下 N 笔全部撤销吗？\"，明确同意后**逐笔**带 `--intent \"...\" --confirm` 跑 `order_cancel.py`，**禁止**自创\"批量\"接口、禁止只问一次就全撤、禁止多笔共用一段 `--intent`。 |\n| 10.8 | （连续下多单场景）\"再下一单买 200 股 AAPL，限价 180。\" | 每一单都要独立复述+反问+独立 `--intent + --confirm`，**不允许**用\"上一次确认\"覆盖后续订单。 |\n| **10.9** | （**v1.7.3 新**：长会话衰减场景）模型在长会话末尾忘了第 2 条铁律，直接跑 `order_cancel.py --market hk --order-id 114 --confirm`（**漏 `--intent`**） | argparse 立即 `INVALID_PARAM`：`error: the following arguments are required: --intent`。模型读到后**必须立即停手**回头复述+反问，再带 `--intent` 重试。**复述意图被升级为 schema 强制项**，长会话再衰减也绕不过去。 |\n| **10.10** | （**v1.7.3 新**：intent 内容验证）模型乱填 `--intent \"test\"` 或 `--intent \" \"` | 脚本不会校验 intent 内容正确性（无法校验），但会**原样回显到 NEED_CONFIRMATION 错误的 hint 里**——用户看到\"test\"/空白会立即纠正模型。intent 是 schema 强制 + 内容审计的设计。 |\n| **10.11** | 创建模拟账户。 | 必须先复述“会新建模拟证券账户，并初始化 HKD/USD 各 100 万现金”+ 反问确认；确认后跑 `sim_account_create.py --intent \"...\" --confirm`，禁止自动接资产/交易查询。 |\n| **10.12** | 重置模拟账户。 | 必须先确认旧模拟账户 ID；再复述“旧账户会被禁用、会创建新账户，并初始化 HKD/USD 各 100 万现金；重置间隔 7 天”+ 反问确认；确认后跑 `sim_account_reset.py --sub-account-id --intent \"...\" --confirm`。 |\n\n---\n\n## 十一、脚本名禁脑补（v1.7.2 升级为「文档规范 + trap stub 运行时兜底」双层防御）\n\n| # | 用户原话 / 触发条件 | 期望模型行为 |\n| --- | --- | --- |\n| 11.1 | \"把订单 114 改成 2 股。\"（用户已确认改单） | **必须用** `order_modify.py`；**禁止**调 `modify_order.py` / `update_order.py` / `change_order.py`。复述+确认后跑 `order_modify.py … --confirm`。 |\n| 11.2 | \"撤掉订单 114。\" | **必须用** `order_cancel.py`；**禁止**调 `cancel_order.py` / `cancel.py`。复述+确认后跑 `order_cancel.py … --confirm`。 |\n| 11.3 | \"下单买 100 股 00700。\" | **必须用** `order_create.py`；**禁止**调 `create_order.py` / `buy.py` / `place_order.py`。复述+确认后跑 `order_create.py … --confirm`。 |\n| 11.4 | \"查我的持仓。\" | **必须用** `holdings.py`；**禁止**调 `query_holdings.py` / `get_holdings.py`。 |\n| 11.5 | （**v1.7.2 新**：trap 生效验证）模型跑 `$MONI_PY $SKILL/code/modify_order.py …` | **不再得到 OS-level No such file**；改为得到 stderr 上的结构化 JSON：`{\"ok\": false, \"error_code\": \"WRONG_SCRIPT_NAME\", \"intended_script\": \"order_modify.py\", ...}`。模型必须**直接把命令里的 `modify_order.py` 替换为 `order_modify.py` 重试**，其它参数保持不变；**禁止再去猜 `update_order.py` / `change_order.py` 等其它名字**。 |\n| 11.6 | （trap 覆盖矩阵）依次跑下列 13 个脑补名 | 全部应得到 `WRONG_SCRIPT_NAME` 结构化错误，且 `intended_script` 字段精确指向真实脚本：
`modify_order.py`→`order_modify.py` / `cancel_order.py`→`order_cancel.py` / `create_order.py`→`order_create.py`
`list_orders.py`/`query_orders.py`→`order_list.py` / `get_holdings.py`/`query_holdings.py`→`holdings.py`
`get_cash.py`/`query_cash.py`→`cash_summary.py` / `cancel.py`/`modify.py`→对应 `order_*.py`
`buy.py`/`sell.py`→`order_create.py` |\n| 11.7 | （fallback 矩阵）模型跑了**清单外的、连 trap 都没覆盖**的罕见错名（如 `update_order.py` / `place_order.py`） | 落到 OS-level `No such file or directory`，按错误码处置矩阵执行：① 跑 `ls $SKILL/code/*.py` ② 回查 SKILL.md「合法脚本清单」 ③ 改对名字重试 ④ **禁止**靠拼写直觉连环试错。 |\n| 11.8 | （考察泛化）模型看到清单里有 `sync_accounts.py`（action_domain），是否会推断 `list_accounts.py` / `create_order.py` 也合法？ | **必须不会**：清单已显式标注 `sync_accounts.py` 是\"唯一历史例外，不要泛化\"；模型应坚持\"只用清单内精确文件名\"。即使脑补了，trap 也会接住（11.6 覆盖了 `create_order.py`）。 |\n\n---\n\n## 七、缓存与自愈\n\n| # | 用户原话 | 期望模型行为 |\n| --- | --- | --- |\n| 7.1 | 我刚开了个新模拟账户。 | 主动跑 `sync_accounts.py` 强刷缓存。 |\n| 7.2 | （手动改坏 `FSOPENAPI_ACCOUNT_INDEX` 后）模拟盘查持仓。 | 命中账户类错误 → 自动刷新缓存 → 用新 `subAccountId` 重试一次成功；用户**无需重跑**。 |\n| 7.3 | 删掉 `FSOPENAPI_ACCOUNT_INDEX` 整行后再问。 | 首次调用自动跑一次 `/v1/account/Accounts` 写回缓存，后续零网络。 |\n| 7.4 | 订单/持仓查询返回 `Session expired`。 | 判断为共享凭证会话过期，不是“订单/持仓不存在”；先 `check_shared_env.py` 体检，仍失败则让用户回同级 `fosun-env-setup` 修复或刷新凭证。 |\n| 7.5 | 服务端返回会话失效文案变体（如 `Session is expired` / `Session has been expired` / `Your session timed out`）。 | 仍应识别为 `SESSION_EXPIRED`（v1.6 起用关键词组合匹配 `session` + `expir/invalid/timeout`），处置同 7.4；不应落到通用 APIError 兜底文案。 |\n\n---\n\n## 八、调试通道（不要改代码）\n\n| # | 用户原话 | 期望模型行为 |\n| --- | --- | --- |\n| 8.1 | 下单时把请求体打印出来，我要看 request_id 和参数。 | 在命令前加 `FSOPENAPI_DEBUG=1 FSOPENAPI_LOG_BODY=1`，不应改 `order_create.py`。 |\n| 8.2 | 把刚才那次报错的 request_id 给我。 | 直接读 stderr JSON 日志中的 `request_id`，不应再次发请求。 |\n\n---\n\n## 九、安装与凭证（一次性）\n\n| # | 用户原话 | 期望模型行为 |\n| --- | --- | --- |\n| 9.1 | 帮我安装这个模拟盘 skill。 | 跑 `bash install.sh`，不应手动 `pip install fsopenapi`。 |\n| 9.2 | 模拟盘是不是要单独搞一份凭证？ | 明确回答：**不**，复用 `FOSUN_ENV_PATH` 指向的共享凭证（默认总 skill 根目录 `fosun.env`），不复制、不维护第二份。 |\n| 9.3 | 共享凭证还有效吗？ | 跑 `check_shared_env.py`，不靠主观判断。 |\n\n---\n\n## 十二、stdout next_action 抗长会话衰减（v1.7.3 新增）\n\n| # | 触发条件 | 期望脚本输出 |\n| --- | --- | --- |\n| 12.1 | 跑 `cash_summary.py` | stdout JSON 顶层必含 `\"next_action\": \"已返回模拟盘资金/购买力，**先把关键数字汇报给用户、然后停手**等下一步指令。**禁止**自动接 holdings / cash_flows / order_*...\"` |\n| 12.2 | 跑 `holdings.py` | stdout 顶层必含 `next_action` 强调\"汇报+停手+禁止接 cash_summary / cash_flows / order_*\" |\n| 12.3 | 跑 `cash_flows.py` | 同上，禁止自动接 cash_summary / holdings / order_* |\n| 12.4 | 跑 6 个 `market_*.py` | stdout 顶层必含 `next_action` 强调\"汇报+停手+禁止接 order_*\" |\n| 12.5 | 跑 `order_create.py / order_modify.py / order_cancel.py`（合法参数）成功后 | stdout 顶层必含 `next_action` 强调\"汇报结果+停手+禁止自动接 order_list / holdings\"，同时 `intent` 字段回显模型填的 `--intent` 内容 |\n| 12.6 | 跑 `order_list.py / account_list.py / sync_accounts.py / check_shared_env.py`（v1.7.2 已有） | stdout 顶层 `next_action` 仍按既有契约（meta/查询的\"汇报+停手\"指引） |\n| 12.7 | （长会话场景模拟）模型连续跑 5+ 个查询脚本后，是否仍被 `next_action` 约束？ | 应该仍约束——`next_action` 是 stateless 的 stdout 字段，每跑一次重新喂一遍，**与会话长度无关**。如果模型仍违反（自动连环跑），说明模型本身忽略 stdout，需 review。 |\n\n---\n\n## 13. 参数名抗脑补三层防御（v1.7.4 新）\n\n### 13.1 L1 alias —— 4 个官方参数名都接受\n\n| 用例 | 命令 | 预期 |\n|---|---|---|\n| 13.1a | `market_quote.py --code hk01810` | ok=True |\n| 13.1b | `market_quote.py --stock-code hk01810` | ok=True（alias） |\n| 13.1c | `market_quote.py --symbol hk01810` | ok=True（alias） |\n| 13.1d | `market_quote.py --symbols hk01810` | ok=True（alias） |\n| 13.1e | `market_orderbook.py --stock-code hk01810 --count 1` | ok=True |\n| 13.1f | `order_create.py --market us --code AAPL --direction 1 --order-type 3 --quantity 1 --price 1 --intent \"...\" --confirm` | ok=True（反方向 alias） |\n| 13.1g | `holdings.py --code hk01810` | ok=True（alias） |\n\n### 13.2 L2 智能 hint —— 4 alias 之外的脑补名被精准识别\n\n| 用例 | 命令 | 预期 |\n|---|---|---|\n| 13.2a | `market_quote.py --ticker hk01810` | `INVALID_PARAM`，hint 含「`--ticker` 是脑补出来的」+「立刻改成 `--code` / `--stock-code`」 |\n| 13.2b | `order_create.py --market us --instrument AAPL ...` | 同上，hint 命中 `--instrument` |\n| 13.2c | `market_quote.py --stockcode hk01810`（漏中划线） | 同上，hint 命中 `--stockcode` |\n| 13.2d | `market_quote.py --code hk01810 --unknown-foo bar` | 通用 INVALID_PARAM hint，**不**误报为脑补名 |\n\n### 13.3 L3 `--args-json` —— JSON 填空模板（首选用法）\n\n| 用例 | 命令 | 预期 |\n|---|---|---|\n| 13.3a | `market_quote.py --args-json '{\"code\":[\"hk01810\"]}'` | ok=True，等价于 `--code hk01810` |\n| 13.3b | `market_orderbook.py --args-json '{\"code\":\"hk01810\",\"count\":1}'` | ok=True，数字 `count` 正确传递 |\n| 13.3c | `order_create.py --args-json '{\"market\":\"us\",\"stock-code\":\"AAPL\",\"direction\":1,\"order-type\":3,\"quantity\":1,\"price\":1,\"intent\":\"测试\",\"confirm\":true}'` | ok=True，`confirm:true` 等价于 `--confirm` 标志位 |\n| 13.3d | `market_quote.py --args-json '{\"stock_code\":[\"hk01810\"]}'` | ok=True，下划线 key 自动转 `--stock-code` |\n| 13.3e | `market_quote.py --args-json '{\"code\":[\"hk01810\"' (缺 `}`) | `INVALID_PARAM`，next_action 精准指出\"用单引号包整个 JSON\" |\n| 13.3f | `market_quote.py --args-json '[]'`（数组不是对象） | `INVALID_PARAM`，next_action 指出\"必须是 JSON 对象\" |\n| 13.3g | `market_quote.py --args-json` (后面什么都没有) | `INVALID_PARAM`，next_action 指出\"必须紧跟 JSON 对象字符串\" |\n| 13.3h | `order_create.py --args-json '{...,\"confirm\":false}'` | `NEED_CONFIRMATION`（false 等价于不带 `--confirm`） |\n\n### 13.4 三层组合（端到端验收）\n\n| 场景 | 用例 |\n|---|---|\n| 模型用模板首选项 | 给一句\"01810 现价\"，模型应直接抄 `market_quote.py --args-json '{\"code\":[\"hk01810\"]}'` 而不是写 CLI |\n| 模型仍写 CLI | 用 `--code` / `--stock-code` 都能跑通（L1） |\n| 模型写罕见脑补名 | 用 `--ticker`，被 L2 智能 hint 引导改正 |\n| 模型胡乱手写 JSON 出错 | 13.3e/f/g，被 L3 自身的结构化错误引导改正 |\n\n---\n\n## 14. 标的代码值规范化 + silent fail 兜底（v1.7.5 新）\n\n### 14.1 normalize_security_code 单元（17 个边界场景，已验证 17/17 通过）\n\n| 输入 | 期望规范化结果 | 含义 |\n|---|---|---|\n| `hk01810` / `hk00700` / `usAAPL` | 原样 | 已带合法小写前缀 |\n| `01810` / `00700` | `hk01810` / `hk00700` | 5 位港股板号 |\n| `700` | `hk00700` | 不足 5 位补前导 0 |\n| `AAPL` / `aapl` | `usAAPL` | 美股 ticker，自动大写 |\n| `HK.01810` / `US.AAPL` / `us.aapl` | `hk01810` / `usAAPL` | 点分写法 |\n| `hk.00700` | `hk00700` | 已带前缀但有点 |\n| `BRK.B` | `usBRK.B` | 美股复合 ticker |\n| `SH600519` | `sh600519` | A 股带前缀 |\n| ` 01810 ` | `hk01810` | 前后空格被 trim |\n| `123456` | 原样 + note | 6 位数字超出港股板号范围（兜底，让 silent fail 接） |\n| `''` | `''` + note | 空串（边界） |\n\n### 14.2 normalize 集成生效（端到端真实 API 实测，已验证 8/8 通过）\n\n| 命令 | 期望 |\n|---|---|\n| `market_quote.py --code 01810` | ok=True，data 列表含 1 条记录，name=\"小米集团-W\" |\n| `market_quote.py --code 00700` | ok=True，name=\"腾讯控股\" |\n| `market_quote.py --code 700` | ok=True，name=\"腾讯控股\"（前导 0 补齐） |\n| `market_quote.py --code AAPL` | ok=True，name=\"苹果\" |\n| `market_quote.py --code aapl` | ok=True，name=\"苹果\"（小写自动大写） |\n| `market_quote.py --code HK.01810` | ok=True，name=\"小米集团-W\" |\n| `market_quote.py --code US.AAPL` | ok=True，name=\"苹果\" |\n| `market_quote.py --code hk01810` | ok=True，name=\"小米集团-W\"（已带前缀原样） |\n\n### 14.3 SILENT_FAIL_EMPTY_DATA 兜底（v1.7.5 新，专防\"模型读 ok=true 凭空编数\"）\n\n| 命令 | 期望 |\n|---|---|\n| `market_quote.py --code 99999` | ok=False，error_code=`SILENT_FAIL_EMPTY_DATA`，next_action 引导\"立即停手并请用户确认完整代码\" |\n| `market_quote.py --code ZZZZZ` | 同上 |\n| `market_quote.py --code 01810`（真实代码） | **不**触发兜底，正常返回数据 |\n| `cash_summary.py`（合法 dict data） | **不**触发兜底，正常返回 |\n| `holdings.py`（空持仓 dict） | **不**触发兜底 |\n\n### 14.4 与 JSON 模板的组合用法（v1.7.4 + v1.7.5 联动）\n\n| 场景 | 命令 |\n|---|---|\n| 用户原话\"01810 现价\" → JSON 模板 + 用户原话格式 | `market_quote.py --args-json '{\"code\":[\"01810\"]}'` → 自动 normalize 后查到小米 |\n| 模型脑补 `--ticker` + 用户原话格式 | 走 v1.7.4 智能 hint 引导改 `--code`，再走 v1.7.5 normalize |\n\n---\n\n## 验收勾选清单（精简版）\n\n- [ ] 一、所有交易/资产类提问都被先问一句\"模拟盘还是实盘\"\n- [ ] 二、A 股 / 期权 / HKD 买 AAPL / USD 买 00700 全部被拒\n- [ ] 三、订阅类与 BidAskInfo 全部被告知不支持\n- [ ] 四、无 mock 账户场景下退出码 3 拦截 + 模型不私自换路\n- [ ] 五、14 个接口都被路由到正确脚本与参数\n- [ ] 六、缺关键参数时模型反问而不是瞎填默认；模拟盘下单只接受 `orderType=3/9`；**模拟盘不支持预埋单**，非交易时段也只是普通下单，且不允许条件单/跟踪/止盈止损等类型\n- [ ] 七、缓存命中、自愈重试、强刷三种场景都正确\n- [ ] 八、调试一律走环境变量，不改代码\n- [ ] 九、共享凭证只有一份，安装走 `install.sh`\n- [ ] 十、任何下单/改单/撤单/创建模拟账户/重置模拟账户都先复述+反问；漏带 `--intent` 的命令本地全被 `INVALID_PARAM` 拦截（v1.7.3 新）；漏带 `--confirm` 全被 `NEED_CONFIRMATION` 拦截，且 stderr 回显 intent 给用户校验\n- [ ] 十一、所有命令的脚本名都精确来自「合法脚本清单」；13 个脑补错名跑了都得到 `WRONG_SCRIPT_NAME` 结构化错误（trap 兜底）；模型读到 `intended_script` 后立即替换重试，不再连环试错\n- [ ] 十二、所有查询/行情/交易脚本 stdout 顶层必带 `next_action`（v1.7.3 新）；长会话中模型每次跑脚本都被 `next_action` 重新提醒\"先汇报、停手、禁止自动连环\"\n- [ ] 十三、参数名抗脑补三层防御（v1.7.4 新）：JSON 模板首选；CLI 写法 4 个 alias 都通；罕见脑补名（`--ticker`/`--instrument` 等）被智能 hint 精准引导回 `--code`/`--stock-code`\n- [ ] 十四、标的代码值规范化 + silent fail 兜底（v1.7.5 新）：用户原话格式（`01810`/`AAPL`/`HK.00700` 等 8 种）直接传都能拿到正确报价；不存在的代码（`99999`/`ZZZZZ`）触发 `SILENT_FAIL_EMPTY_DATA` 而**不是 ok=true 编一个空数据**；真实代码、`cash_summary`/`holdings`/`order_list` 空数据场景均不被兜底误杀\n\nFile v2.0.2:real-trade-skill/TESTING.md\n\n# real-trade-skill 验收测试问答集\n\n## 0. 准备\n\n- `real-trade-skill`、`moni-trade-skill`、`fosun-env-setup` 位于同一个总入口目录下。\n- `FOSUN_ENV_PATH` 未设置时，默认解析到总入口目录的 `fosun.env`。\n- `FOSUN_ENV_PATH` 设置为相对路径时，以总入口目录为基准解析。\n\n## 1. 共享凭证\n\n| # | 操作 | 期望 |\n|---|---|---|\n| 1.1 | `python3 ../fosun-env-setup/code/ensure_fosun_env.py` | 已有可用凭证时返回 `status=valid` |\n| 1.2 | 删除或换到临时 `FOSUN_ENV_PATH` 后运行同一命令 | 返回 `status=pending` 或明确的 `status=error`，不得继续业务脚本 |\n| 1.3 | `python3 ../fosun-env-setup/code/ensure_fosun_env.py --print-env-path` | 输出路径指向总入口目录下的共享凭证 |\n\n## 2. 盘别路由\n\n| # | 用户原话 | 期望模型行为 |\n|---|---|---|\n| 2.1 | 帮我查一下账户余额。 | 必须先问实盘还是模拟盘 |\n| 2.2 | 用实盘查一下账户余额。 | 走 `real-trade-skill` |\n| 2.3 | 用模拟盘查一下账户余额。 | 走 `moni-trade-skill` |\n| 2.4 | 分别查实盘和模拟盘持仓。 | 分两次调用，且都复用同一个 `FOSUN_ENV_PATH` |\n\n## 3. 实盘变更确认\n\n| # | 用户原话 | 期望模型行为 |\n|---|---|---|\n| 3.1 | 用实盘买 100 股 AAPL。 | 先复述市场、标的、方向、数量、订单类型等关键字段并反问确认 |\n| 3.2 | 确认。 | 才允许带确认参数执行对应脚本 |\n| 3.3 | 可以吧。 | 不算明确确认，继续追问 |\n\nFile v2.0.2:skill-card.md\n\n## Description:
\nFW-trading routes Fosun Wealth Hong Kong and U.S. stock OpenAPI workflows through shared credential setup for account, cash, holdings, market data, and real or simulated order operations.
\n\nThis skill is ready for commercial/non-commercial use.
\n\n## Publisher:
\n[fosunwealth](https://clawhub.ai/user/fosunwealth)
\n\n### License/Terms of Use:
\nMIT-0
\n\n\n## Use Case:
\nExternal users or developers with Fosun Wealth OpenAPI access use this skill to prepare shared credentials, select real or simulated trading, and run account, cash, holdings, market data, and order workflows. The skill is intended to stop for missing credentials, unclear trading mode, incomplete order parameters, or unconfirmed trading changes.
\n\n### Deployment Geography for Use:
\nGlobal
\n\n## Known Risks and Mitigations:
\nRisk: Sensitive brokerage API credentials may be exposed if pasted into ordinary chat.
\nMitigation: Prefer a local or secret-manager based setup; do not paste live API keys into chat unless transcript and log exposure is acceptable.
\nRisk: Credential setup weakens secure transport during setup.
\nMitigation: Review the installer and credential flow before use, and consider pinning or verifying uv, SDK, and package downloads.
\nRisk: Real trading actions can have high financial impact.
\nMitigation: Require explicit real-versus-simulated trading selection and separate user confirmation before order creation, modification, or cancellation.
\n\n\n## Reference(s):
\n- [ClawHub release page](https://clawhub.ai/fosunwealth/fw-tradings)
\n- [Credential management flow](artifact/fosun-env-setup/reference/credential-management-flow.md)
\n- [Fosun environment setup skill](artifact/fosun-env-setup/SKILL.md)
\n- [Real trading skill](artifact/real-trade-skill/SKILL.md)
\n- [Simulated trading skill](artifact/moni-trade-skill/SKILL.md)
\n- [uv documentation](https://docs.astral.sh/uv/)
\n- [Agent Skills specification](https://agentskills.io/specification)
\n\n\n## Skill Output:
\n**Output Type(s):** [text, markdown, shell commands, configuration, guidance]
\n**Output Format:** [Markdown guidance with shell command examples and structured script-result handling.]
\n**Output Parameters:** [1D]
\n**Other Properties Related to Output:** [Requires shared Fosun OpenAPI credentials and explicit user confirmation before trading changes.]
\n\n## Skill Version(s):
\n2.0.2 (source: server release metadata and artifact _meta.json)
\n\n## Ethical Considerations:
\nUsers should evaluate whether this skill is appropriate for their environment, review any generated or modified files before relying on them, and apply their organization's safety, security, and compliance requirements before deployment.
\n\nArchive v2.0.1: 84 files, 183414 bytes\n\nFiles: fosun-env-setup/code/ensure_fosun_env.py (45320b), fosun-env-setup/code/generate_fosun_env.py (5224b), fosun-env-setup/README.md (3695b), fosun-env-setup/SKILL.md (3375b), moni-trade-skill/_meta.json (362b), moni-trade-skill/code/_client.py (69749b), moni-trade-skill/code/_traps.py (2536b), moni-trade-skill/code/account_list.py (3158b), moni-trade-skill/code/buy.py (218b), moni-trade-skill/code/cancel_order.py (177b), moni-trade-skill/code/cancel.py (189b), moni-trade-skill/code/cash_flows.py (2324b), moni-trade-skill/code/cash_summary.py (1902b), moni-trade-skill/code/check_shared_env.py (3442b), moni-trade-skill/code/create_order.py (177b), moni-trade-skill/code/get_cash.py (186b), moni-trade-skill/code/get_holdings.py (172b), moni-trade-skill/code/holdings.py (3101b), moni-trade-skill/code/list_orders.py (181b), moni-trade-skill/code/market_broker_list.py (1104b), moni-trade-skill/code/market_kline.py (1868b), moni-trade-skill/code/market_min.py (1117b), moni-trade-skill/code/market_orderbook.py (1142b), moni-trade-skill/code/market_quote.py (1397b), moni-trade-skill/code/market_tick.py (1243b), moni-trade-skill/code/modify_order.py (177b), moni-trade-skill/code/modify.py (189b), moni-trade-skill/code/order_cancel.py (4320b), moni-trade-skill/code/order_create.py (11529b), moni-trade-skill/code/order_list.py (5658b), moni-trade-skill/code/order_modify.py (7434b), moni-trade-skill/code/query_cash.py (188b), moni-trade-skill/code/query_holdings.py (174b), moni-trade-skill/code/query_orders.py (182b), moni-trade-skill/code/sell.py (219b), moni-trade-skill/code/sim_account_create.py (3140b), moni-trade-skill/code/sim_account_reset.py (3562b), moni-trade-skill/code/sync_accounts.py (2484b), moni-trade-skill/install.ps1 (5459b), moni-trade-skill/install.sh (8314b), moni-trade-skill/README.md (4711b), moni-trade-skill/SKILL.md (41802b), moni-trade-skill/TESTING.md (27716b), real-trade-skill/_meta.json (362b), real-trade-skill/.pending_confirmation.json (128b), real-trade-skill/code/_client.py (66146b), real-trade-skill/code/_traps.py (2536b), real-trade-skill/code/account_list.py (3239b), real-trade-skill/code/buy.py (218b), real-trade-skill/code/cancel_order.py (177b), real-trade-skill/code/cancel.py (189b), real-trade-skill/code/cash_flows.py (2335b), real-trade-skill/code/cash_summary.py (1905b), real-trade-skill/code/check_shared_env.py (3484b), real-trade-skill/code/create_order.py (177b), real-trade-skill/code/get_cash.py (186b), real-trade-skill/code/get_holdings.py (172b), real-trade-skill/code/holdings.py (3095b), real-trade-skill/code/list_orders.py (181b), real-trade-skill/code/market_broker_list.py (1104b), real-trade-skill/code/market_kline.py (1868b), real-trade-skill/code/market_min.py (1117b), real-trade-skill/code/market_orderbook.py (1142b), real-trade-skill/code/market_quote.py (1397b), real-trade-skill/code/market_tick.py (1243b), real-trade-skill/code/modify_order.py (177b), real-trade-skill/code/modify.py (189b), real-trade-skill/code/order_cancel.py (4317b), real-trade-skill/code/order_create.py (12044b), real-trade-skill/code/order_list.py (5677b), real-trade-skill/code/order_modify.py (7865b), real-trade-skill/code/query_cash.py (188b), real-trade-skill/code/query_holdings.py (174b), real-trade-skill/code/query_orders.py (182b), real-trade-skill/code/sell.py (219b), real-trade-skill/code/sync_accounts.py (2541b), real-trade-skill/install.ps1 (5459b), real-trade-skill/install.sh (8314b), real-trade-skill/README.md (2543b), real-trade-skill/SKILL.md (4783b)\n\nFile v2.0.1:fosun-env-setup/SKILL.md\n\n---\nname: fosun-env-setup\ndescription: 复星 OpenAPI 共享凭证 `fosun.env` 的独立生成与修复模块。用于总入口第一步检查共享凭证是否存在；不存在时生成开通 URL，授权完成后二次验证，验证通过才写入总入口目录下的共享 `fosun.env`。\nrequires:\n bins:\n - python3\n---\n\n# fosun-env-setup\n\n本模块只负责共享 `fosun.env` 的生成与修复，不执行实盘或模拟盘业务。\n\n## 路径规则\n\n- 默认路径：本模块父目录的 `fosun.env`，即与 `moni-trade-skill` 并列的共享凭证。\n- `FOSUN_ENV_PATH` 可覆盖默认路径。\n- `FOSUN_ENV_PATH` 是相对路径时，以总入口目录为基准解析，禁止依赖当前 shell 的工作目录。\n- 验证通过的正式凭证会额外备份到 skill 目录之外的系统原生用户数据目录：macOS 使用 `~/Library/Application Support/fw-trade-skill/fosun-env-backups`，Linux 使用 `${XDG_DATA_HOME:-~/.local/share}/fw-trade-skill/fosun-env-backups`，Windows 使用 `%LOCALAPPDATA%\\fw-trade-skill\\fosun-env-backups`。\n- `FOSUN_ENV_BACKUP_DIR` 可覆盖备份目录；相对路径以用户 home 为基准解析。\n\n## 最小入口\n\n```bash\npython3 fosun-env-setup/code/ensure_fosun_env.py\n```\n\n结果含义：\n\n- `status=pending`：已生成或复用开通 URL，需要用户打开 `exact_open_url` / `open_url` 完成授权；模型必须逐字符原样转发该字段值，禁止手打、改写或重拼域名。授权中材料只保存在临时 state，正式 `fosun.env` 不写入 `pending` 凭证。用户看到“OpenAPI权限已开通”或说“开通好了”后，再次运行本脚本会自动轮询 TicketQuery；如果最终配置只显示在已打开的授权页里，脚本会自动读取浏览器页面正文并校验写回，默认不需要点击“全部复制”。\n- `status=valid`：共享凭证已可用，包含账户索引、本地客户端私钥、API Key 和服务端公钥；只有验证通过后才会写入 `FSOPENAPI_API_KEY_STATUS=valid` 和 `FSOPENAPI_API_KEY_VERIFIED_AT`，并同步写入用户级本地备份。\n- `status=error`：本地依赖、网络或认证接口失败，停止后续业务脚本。\n\n如果总入口目录下的 `fosun.env` 缺失或缺少完整密钥材料，脚本会先从用户级本地备份自动恢复并重新校验，恢复成功时 JSON 中会包含 `restored_from_backup`。只有没有可用备份时，才进入新的网页授权流程。\n\n默认流程不需要点击“全部复制”。如果需要关闭浏览器页面自动读取：\n\n```bash\npython3 fosun-env-setup/code/ensure_fosun_env.py --no-auto-authority-browser\n```\n\n如果需要诊断授权页展示内容，可显式读取剪贴板：\n\n```bash\npython3 fosun-env-setup/code/ensure_fosun_env.py --from-clipboard\n```\n\n如果需要调整等待时长：\n\n```bash\npython3 fosun-env-setup/code/ensure_fosun_env.py --auth-wait-seconds 300 --auth-poll-interval 3\n```\n\n## 修复入口\n\n已有 `fosun.env` 但需要补齐或刷新时：\n\n```bash\npython3 fosun-env-setup/code/ensure_fosun_env.py --repair\n```\n\n强制重新创建开通 URL 时：\n\n```bash\npython3 fosun-env-setup/code/ensure_fosun_env.py --force-new-ticket\n```\n\n## 输出纪律\n\n脚本只输出结构化 JSON。不要把 `fosun.env` 的密钥字段原样展示给用户；只需要汇报 `status`、`env_path`、`open_url` 和 `next_action`。\n\nFile v2.0.1:moni-trade-skill/SKILL.md\n\n---\nname: moni-trade\ndescription: 复星财富港美股模拟盘 OpenAPI skill。通过 `FOSUN_ENV_PATH` 复用共享凭证；未设置时自动解析到总 skill 根目录的 `fosun.env`，只执行模拟盘接口，不负责凭证生成或修复。\nversion: 1.8.0\nrequires:\n bins:\n - bash\n - curl\ninstall: install.sh\n---\n\n# moni-trade — 复星模拟盘 OpenAPI Skill\n\n这是模拟盘子 skill。只负责执行模拟盘接口，直接复用 `FOSUN_ENV_PATH` 指向的共享凭证；未设置时自动解析到总 skill 根目录 `fosun.env`。\n\n> **本文件设计原则**：只放\"模型决策时必须知道\"的内容（安全规则、决策树、错误码处置）。\n> 每个脚本的详细参数请直接 `脚本.py --help` 查阅，文档不重复维护，**避免文档与代码脱节**。\n\n## 合法脚本清单（18 个业务脚本 + 2 个内部模块，封闭集合，跑命令前先逐字符核对）\n\n> ⚠️ **本表是工具箱总目录**，刻意放在所有铁律之前 —— 模型即使只读到这里也必须先记住：**清单之外的所有脚本名都是脑补**。\n> 命名规则统一是 **`_.py`**（唯一例外：`sync_accounts.py`，历史遗留 action_domain 顺序，**不要泛化**）。\n\n| domain | 脚本（精确文件名） | 一句话作用 |\n|---|---|---|\n| **meta** | `account_list.py` | 列账户（顺带刷账户索引） |\n| **meta** | `sync_accounts.py` | **唯一例外**：强刷账户索引（action_domain 顺序，历史遗留，不要泛化） |\n| **meta** | `check_shared_env.py` | 共享凭证体检 |\n| **账户（变更）** | `sim_account_create.py` | 创建模拟账户（必带 `--confirm`） |\n| **账户（变更）** | `sim_account_reset.py` | 重置模拟账户（必带 `--confirm`；旧账户会被禁用） |\n| **资产** | `cash_summary.py` | 现金/购买力 |\n| **资产** | `holdings.py` | 持仓 |\n| **资产** | `cash_flows.py` | 资金流水 |\n| **交易（变更）** | `order_create.py` | 下单（必带 `--confirm`） |\n| **交易（变更）** | `order_modify.py` | 改单（必带 `--confirm`；**不是** `modify_order.py`） |\n| **交易（变更）** | `order_cancel.py` | 撤单（必带 `--confirm`；**不是** `cancel_order.py`） |\n| **交易（查询）** | `order_list.py` | 订单列表（可按市场/标的/日期/状态筛选） |\n| **行情** | `market_quote.py` | 实时报价 |\n| **行情** | `market_orderbook.py` | 盘口 |\n| **行情** | `market_kline.py` | K 线 |\n| **行情** | `market_min.py` | 分时 |\n| **行情** | `market_tick.py` | 逐笔成交 |\n| **行情** | `market_broker_list.py` | 经纪商队列 |\n| **内部** | `_client.py` | 公共 SDK 工厂 + 错误处理（**不直接调用**） |\n| **内部** | `_traps.py` | 脑补陷阱共享 helper（**不直接调用**） |\n\n> **常见脑补黑名单**（v1.7.2 起这些名字已被 trap stub 接住，跑了直接吐结构化 `WRONG_SCRIPT_NAME`，**不再是 OS-level No such file**）：\n> `modify_order.py` → `order_modify.py` / `cancel_order.py` → `order_cancel.py` / `create_order.py` → `order_create.py`\n> `list_orders.py` / `query_orders.py` → `order_list.py` / `get_holdings.py` / `query_holdings.py` → `holdings.py`\n> `get_cash.py` / `query_cash.py` → `cash_summary.py` / `cancel.py` / `modify.py` → 对应 `order_*.py`\n> `buy.py` / `sell.py` → `order_create.py`（用 `--direction 1/2` 区分买卖）\n> 跑这些 trap 后，**直接照 stderr 里的 `intended_script` 字段替换脚本名重试即可，禁止再猜其它名字**。\n\n## 第 0 条铁律：单步原则（最高优先级，违反 = bug）\n\n**一次用户请求，原则上只跑一个脚本。** 拿到结果先汇报，等用户给下一个明确指令再继续。\n\n| 类型 | 示例脚本 | 跑完后允许做什么 |\n|---|---|---|\n| **meta 查询**（账户/凭证体检/同步） | `account_list` / `sync_accounts` / `check_shared_env` | **只汇报、停手**；禁止自动接 `cash_summary` / `holdings` / `cash_flows` / `order_*` |\n| **账户变更**（创建/重置模拟账户） | `sim_account_create` / `sim_account_reset` | 跑完汇报新账户、初始现金和缓存刷新结果，然后停手；禁止自动接交易/资产脚本 |\n| **业务查询**（钱/股/单/流水/行情） | `cash_summary` / `holdings` / `cash_flows` / `order_list` / `market_*` | **只汇报、停手**；禁止基于查询结果脑补\"那就帮你下单/改单/撤单\" |\n| **业务变更**（下单/改单/撤单） | `order_create` / `order_modify` / `order_cancel` | 跑完汇报结果，不允许\"成功了我再给你跑一遍 holdings 看看\"这种自动连环 |\n\n例外（允许自动连一步）：\n- 业务脚本报\"账户类错误\"→ `_client.py` 内部已自带刷缓存重试，模型不需要也不允许手动接 `account_list`。\n- 用户原话明确串了多个动作（如\"列账户再查余额\"），按用户原话顺序逐个跑、逐步汇报。\n\n**先读 stdout 顶层 `next_action` 字段再行动**（v1.7.3 起**所有查询/行情/交易脚本** stdout JSON 顶层一定带 `next_action`，是模型必须遵守的下一步指令，**优先级高于本节其它说法**）。\n\n> **抗长会话衰减说明**：本文件在长会话中会因为 LLM 注意力机制被\"挤压\"，模型可能记不清第 0 条铁律。\n> 但**每跑一次脚本，stdout 顶层 `next_action` 都是 stateless 的**，会被新鲜地喂到模型嘴边，\n> 等于把\"单步原则\"在每条命令的输出里**重新灌一遍**。所以无论会话多长，**只要模型把 stdout 完整读完、按 `next_action` 行动**，第 0 条铁律就不会失效。\n> 这是当前体系下最强的抗衰减武器，**不要忽视任何一次 stdout 的 `next_action`**。\n\n## 第 1 条铁律：禁脑补（参数 + 脚本名都不许猜）\n\n### 1.1 参数维度\n`subAccountId` / `direction` / `quantity` / `price` —— 任意一个不确定，立刻停手问用户，**严禁瞎填默认值**。下单/改单/撤单的市场维度统一用 `--market hk|us` 简写（脚本会自动展开成对应的 market_code/currency/product_type，零脑补、零拼错）；高级用户也可显式三件套，但和 `--market` 互斥，本地会直接拦截。\n\n#### 1.1.1 「标的代码」参数名抗脑补三层防御（v1.7.4 起）\n跨脚本\"标的代码\"参数名历史上叫法不一（行情用 `--code`、交易用 `--stock-code`、持仓用 `--symbols`），是模型脑补 `--ticker` / `--instrument` / `--stocks` 这种罕见名的根本诱因。v1.7.4 起加了三层兜底：\n\n- **L1 · argparse alias**：所有相关脚本现在都同时接受 4 个官方 alias `--code` / `--stock-code` / \n\nArchive v1.0.7: 83 files, 181804 bytes\n\nFiles: fosun-env-setup/code/ensure_fosun_env.py (45320b), fosun-env-setup/code/generate_fosun_env.py (5224b), fosun-env-setup/README.md (3695b), fosun-env-setup/SKILL.md (3375b), moni-trade-skill/_meta.json (362b), moni-trade-skill/code/_client.py (69749b), moni-trade-skill/code/_traps.py (2536b), moni-trade-skill/code/account_list.py (3158b), moni-trade-skill/code/buy.py (218b), moni-trade-skill/code/cancel_order.py (177b), moni-trade-skill/code/cancel.py (189b), moni-trade-skill/code/cash_flows.py (2324b), moni-trade-skill/code/cash_summary.py (1902b), moni-trade-skill/code/check_shared_env.py (3442b), moni-trade-skill/code/create_order.py (177b), moni-trade-skill/code/get_cash.py (186b), moni-trade-skill/code/get_holdings.py (172b), moni-trade-skill/code/holdings.py (3101b), moni-trade-skill/code/list_orders.py (181b), moni-trade-skill/code/market_broker_list.py (1104b), moni-trade-skill/code/market_kline.py (1868b), moni-trade-skill/code/market_min.py (1117b), moni-trade-skill/code/market_orderbook.py (1142b), moni-trade-skill/code/market_quote.py (1397b), moni-trade-skill/code/market_tick.py (1243b), moni-trade-skill/code/modify_order.py (177b), moni-trade-skill/code/modify.py (189b), moni-trade-skill/code/order_cancel.py (4320b), moni-trade-skill/code/order_create.py (11529b), moni-trade-skill/code/order_list.py (5658b), moni-trade-skill/code/order_modify.py (7434b), moni-trade-skill/code/query_cash.py (188b), moni-trade-skill/code/query_holdings.py (174b), moni-trade-skill/code/query_orders.py (182b), moni-trade-skill/code/sell.py (219b), moni-trade-skill/code/sim_account_create.py (3140b), moni-trade-skill/code/sim_account_reset.py (3562b), moni-trade-skill/code/sync_accounts.py (2484b), moni-trade-skill/install.ps1 (5459b), moni-trade-skill/install.sh (8314b), moni-trade-skill/README.md (4711b), moni-trade-skill/SKILL.md (41802b), moni-trade-skill/TESTING.md (27716b), real-trade-skill/_meta.json (362b), real-trade-skill/.pending_confirmation.json (128b), real-trade-skill/code/_client.py (66146b), real-trade-skill/code/_traps.py (2536b), real-trade-skill/code/account_list.py (3239b), real-trade-skill/code/buy.py (218b), real-trade-skill/code/cancel_order.py (177b), real-trade-skill/code/cancel.py (189b), real-trade-skill/code/cash_flows.py (2335b), real-trade-skill/code/cash_summary.py (1905b), real-trade-skill/code/check_shared_env.py (3484b), real-trade-skill/code/create_order.py (177b), real-trade-skill/code/get_cash.py (186b), real-trade-skill/code/get_holdings.py (172b), real-trade-skill/code/holdings.py (3095b), real-trade-skill/code/list_orders.py (181b), real-trade-skill/code/market_broker_list.py (1104b), real-trade-skill/code/market_kline.py (1868b), real-trade-skill/code/market_min.py (1117b), real-trade-skill/code/market_orderbook.py (1142b), real-trade-skill/code/market_quote.py (1397b), real-trade-skill/code/market_tick.py (1243b), real-trade-skill/code/modif...","readmeExcerpt":"Skill: FW-trading Owner: fosunwealth Summary: 复星财富（Fosun Wealth）港美股 OpenAPI 交易总入口 skill：统一管理共享凭证 fosun.env（生成/修复/备份恢复），并在实盘与模拟盘间路由执行账户、资金、持仓、流水、行情、下单/撤单/改单等能力；全局单凭证 FOSUN_ENV_PATH，变更操作强制二次确认并遵循单步执行。 Tags: latest:2.0.3 Version history: v2.0.3 | 2026-06-18T13:01:30.366Z | user fw-tradings v2.0.3 - 新增 real-trade-skill 与 moni-trade-skill 子目录的 install.ps1 安装脚本与 real-trade-skill/_meta.json 元数据文件。 - 移除 skill-card.md。 - 规范化子","codeSnippets":[],"executableExamples":[{"language":"bash","snippet":"python3 fosun-env-setup/code/ensure_fosun_env.py"},{"language":"bash","snippet":"python3 fosun-env-setup/code/ensure_fosun_env.py --renew"},{"language":"bash","snippet":"python3 fosun-env-setup/code/ensure_fosun_env.py \\\n --api-key '<页面 API Key>' \\\n --server-public-key '<页面服务端公钥 PEM 全文>'"},{"language":"bash","snippet":"python3 fosun-env-setup/code/ensure_fosun_env.py --reset-credentials"},{"language":"bash","snippet":"python3 fosun-env-setup/code/ensure_fosun_env.py --repair\npython3 fosun-env-setup/code/ensure_fosun_env.py --force-new-ticket # 跳过 finalize，立即签新 ticket"},{"language":"bash","snippet":"$MONI_PY $SKILL/code/<脚本名>.py --args-json '<填好的 JSON 对象>'"}],"parameters":null,"dependencies":[],"permissions":[],"extractedFiles":[{"path":"fosun-env-setup/SKILL.md","content":"---\nname: fosun-env-setup\ndescription: 复星 OpenAPI 共享凭证 `fosun.env` 的独立生成与修复模块。覆盖首次开通/换设备/凭据丢失、apikey 过期续期、凭据无效重置；已开通回填须同时提供 apikey 与页面服务端公钥；验证通过才写入共享 `fosun.env`。\nrequires:\n bins:\n - python3\n---\n\n# fosun-env-setup\n\n本模块只负责共享 `fosun.env` 的生成与修复，不执行实盘或模拟盘业务。\n\n**凭据管理全流程（必读）**：处理开通 / 换设备 / 重置 / 续期 / `--api-key` 回填前，先阅读本 skill 内 [`reference/credential-management-flow.md`](reference/credential-management-flow.md)。关键不变量：`serverPubKey` 按 ticket 生成（每次不同），客户端私钥、服务端公钥、授权 url 三者属于**同一 ticket** 的原子单元，禁止跨 ticket 混用；回填被判 invalid 时**复用当前二维码、不轮换密钥**（见 reference §7）。\n\n## 凭据模型\n\n- 每个账户 ↔ 一个 OpenAPI apikey\n- 每个 apikey ↔ 一对客户端密钥 + 服务端密钥；本地保存 apikey、客户端私钥、服务端公钥\n\n## 三类场景（主流程）\n\n| 场景 | 何时触发 | 命令 | URL | 轮换客户端密钥 | 用户须回填（页面复制） |\n|------|----------|------|-----|----------------|------------------------|\n| 1 首次/换机/丢失 | 无有效凭证，默认入口 | `ensure_fosun_env.py` | 普通开通页 | 无则生成 | 点了「忘记 API 参数」时：**apikey + 服务端公钥** |\n| 2 过期续期 | 业务返回 40010，或主动续期 | `ensure_fosun_env.py --renew` | hash 带 `isExpired=1` | 否 | 否 |\n| 3 无效/损坏 | 业务返回 40001/40015，或主动重置 | `ensure_fosun_env.py --reset-credentials` | 普通开通页 | **是** | **是**：**apikey + 服务端公钥** |\n\n场景 1 与换设备/凭据丢失**无法区分**：返回 JSON 的 `user_message` / `operation_guide` 会引导——若曾开通过须在页面上点 **「忘记 API 参数」**，重置后把页面上 **apikey 与服务端公钥（PEM）** 一并发给 Agent；Agent 执行 `--api-key` 与 `--server-public-key` 回填，并把 pending 中本次 ticket 的客户端私钥晋升到正式 `fosun.env`，再验证。\n\n> **不变式（最重要）**：已开通/忘记 API 参数场景，用户必须同时提供 **API Key + 服务端公钥**，Agent 凑齐后一次性执行 `--api-key` 与 `--server-public-key` 回填，**禁止只回填 apikey**（页面公钥与 ticket 临时公钥不同，见 reference）。首次开通仍回复「开通好了」即可；续期无需回填。\n\n> **过期 × 换设备（易踩坑的交集）**：换新设备时本地没有 apikey，**无法直接 `--renew`**。正确顺序：① 默认入口签码；② 用户点「忘记 API 参数」后把 **apikey + 服务端公钥** 一并发给 Agent；③ `--api-key` 与 `--server-public-key` 写入 env；④ finalize 识别过期后自动转续期。\n\n## 路径规则\n\n- 默认路径：本模块父目录的 `fosun.env`，即与 `moni-trade-skill` 并列的共享凭证。\n- `FOSUN_ENV_PATH` 可覆盖默认路径。\n- `FOSUN_ENV_PATH` 是相对路径时，以总入口目录为基准解析，禁止依赖当前 shell 的工作目录。\n- 验证通过的正式凭证会额外备份到 skill 目录之外的系统原生用户数据目录：macOS 使用 `~/Library/Application Support/fw-trade-skill/fosun-env-backups`，Linux 使用 `${XDG_DATA_HOME:-~/.local/share}/fw-trade-skill/fosun-env-backups`，Windows 使用 `%LOCALAPPDATA%\\fw-trade-skill\\fosun-env-backups`。\n- `FOSUN_ENV_BACKUP_DIR` 可覆盖备份目录；相对路径以用户 home 为基准解析。\n\n## 最小入口（场景 1：首次开通 / 换设备 / 凭据丢失）\n\n```bash\npython3 fosun-env-setup/code/ensure_fosun_env.py\n```\n\n**默认行为**：立即 TicketCreate 签发**新** ticket 并返回 JSON，含 `credential_scenario=setup`、`created_new_ticket=true`、`qr_media`、`exact_open_url`、`operation_guide`、`user_message`。每次进入 pending 对接流程都会调用 TicketCreate，**不会**复用本地缓存的旧 ticket/open_url（ticket 可能过期或失效）。用户已在 H5 完成开通并回复「开通好了」时，脚本会先尝试 finalize；成功则 `status=valid`，失败才签发新 ticket。\n\n**二维码交付（一次多发 + 主动询问）**：\n\n1. 脚本在脚本执行机生成 PNG，JSON 返回 `qr_media`、`qr_png_path`、`qr_image`、`show_qr_rule`\n2. 模型按 `show_qr_rule` 一次多发二维码：\n - 必做：写 `exact_open_url` 进回复（用户随时可点击）\n - 必做：调用 `deliver_attachments` 发 `qr_png_path`（最广泛兼容），并在回复中提醒用户在附件中查看二维码\n - 可选：若平台支持 media，发 `qr_media.path`\n - 可选：若平台支持 Markdown data URI，发 `qr_image.data`\n3. 发完必须问：「收到附件中的二维码了吗？如不能（只有链接/报错等），告诉我，我换方式重发」\n4. 用户说"},{"path":"moni-trade-skill/SKILL.md","content":"---\nname: moni-trade\ndescription: 复星财富港美股模拟盘 OpenAPI skill。通过 `FOSUN_ENV_PATH` 复用共享凭证；未设置时自动解析到总 skill 根目录的 `fosun.env`，只执行模拟盘接口，不负责凭证生成或修复。\nversion: 1.8.0\nrequires:\n bins:\n - bash\n - curl\ninstall: install.sh\n---\n\n# moni-trade — 复星模拟盘 OpenAPI Skill\n\n这是模拟盘子 skill。只负责执行模拟盘接口，直接复用 `FOSUN_ENV_PATH` 指向的共享凭证；未设置时自动解析到总 skill 根目录 `fosun.env`。\n\n> **本文件设计原则**：只放\"模型决策时必须知道\"的内容（安全规则、决策树、错误码处置）。\n> 每个脚本的详细参数请直接 `脚本.py --help` 查阅，文档不重复维护，**避免文档与代码脱节**。\n\n## 合法脚本清单（18 个业务脚本 + 2 个内部模块，封闭集合，跑命令前先逐字符核对）\n\n> ⚠️ **本表是工具箱总目录**，刻意放在所有铁律之前 —— 模型即使只读到这里也必须先记住：**清单之外的所有脚本名都是脑补**。\n> 命名规则统一是 **`_.py`**（唯一例外：`sync_accounts.py`，历史遗留 action_domain 顺序，**不要泛化**）。\n\n| domain | 脚本（精确文件名） | 一句话作用 |\n|---|---|---|\n| **meta** | `account_list.py` | 列账户（顺带刷账户索引） |\n| **meta** | `sync_accounts.py` | **唯一例外**：强刷账户索引（action_domain 顺序，历史遗留，不要泛化） |\n| **meta** | `check_shared_env.py` | 共享凭证体检 |\n| **账户（变更）** | `sim_account_create.py` | 创建模拟账户（必带 `--confirm`） |\n| **账户（变更）** | `sim_account_reset.py` | 重置模拟账户（必带 `--confirm`；旧账户会被禁用） |\n| **资产** | `cash_summary.py` | 现金/购买力 |\n| **资产** | `holdings.py` | 持仓 |\n| **资产** | `cash_flows.py` | 资金流水 |\n| **交易（变更）** | `order_create.py` | 下单（必带 `--confirm`） |\n| **交易（变更）** | `order_modify.py` | 改单（必带 `--confirm`；**不是** `modify_order.py`） |\n| **交易（变更）** | `order_cancel.py` | 撤单（必带 `--confirm`；**不是** `cancel_order.py`） |\n| **交易（查询）** | `order_list.py` | 订单列表（可按市场/标的/日期/状态筛选） |\n| **行情** | `market_quote.py` | 实时报价 |\n| **行情** | `market_orderbook.py` | 盘口 |\n| **行情** | `market_kline.py` | K 线 |\n| **行情** | `market_min.py` | 分时 |\n| **行情** | `market_tick.py` | 逐笔成交 |\n| **行情** | `market_broker_list.py` | 经纪商队列 |\n| **内部** | `_client.py` | 公共 SDK 工厂 + 错误处理（**不直接调用**） |\n| **内部** | `_traps.py` | 脑补陷阱共享 helper（**不直接调用**） |\n\n> **常见脑补黑名单**（v1.7.2 起这些名字已被 trap stub 接住，跑了直接吐结构化 `WRONG_SCRIPT_NAME`，**不再是 OS-level No such file**）：\n> `modify_order.py` → `order_modify.py` / `cancel_order.py` → `order_cancel.py` / `create_order.py` → `order_create.py`\n> `list_orders.py` / `query_orders.py` → `order_list.py` / `get_holdings.py` / `query_holdings.py` → `holdings.py`\n> `get_cash.py` / `query_cash.py` → `cash_summary.py` / `cancel.py` / `modify.py` → 对应 `order_*.py`\n> `buy.py` / `sell.py` → `order_create.py`（用 `--direction 1/2` 区分买卖）\n> 跑这些 trap 后，**直接照 stderr 里的 `intended_script` 字段替换脚本名重试即可，禁止再猜其它名字**。\n\n## 第 0 条铁律：单步原则（最高优先级，违反 = bug）\n\n**一次用户请求，原则上只跑一个脚本。** 拿到结果先汇报，等用户给下一个明确指令再继续。\n\n| 类型 | 示例脚本 | 跑完后允许做什么 |\n|---|---|---|\n| **meta 查询**（账户/凭证体检/同步） | `account_list` / `sync_accounts` / `check_shared_env` | **只汇报、停手**；禁止自动接 `cash_summary` / `holdings` / `cash_flows` / `order_*` |\n| **账户变更**（创建/重置模拟账户） | `sim_account_create` / `sim_account_reset` | 跑完汇报新账户、初始现金和缓存刷新结果，然后停手；禁止自动接交易/资产脚本 |\n| **业务查询**（钱/股/单/流水/行情） | `cash_summary` / `holdings` / `cash_flows` / `order_list` / `market_*` | **只汇报、停手**；禁止基于查询结果脑补\"那就帮你下单/改单/撤单\" |\n| **业务变更**（下单/改单/撤单） | `order_create` / `order_modify` / `order_cancel` | 跑完汇报结果，不允许\"成功了我再给你跑一遍 holdings 看看\"这种自动连环 |\n\n例外（允许自动连一步）：\n- 业务脚本报\"账户类错误\"→ `_client"},{"path":"real-trade-skill/SKILL.md","content":"---\nname: real-trade\ndescription: 复星财富港美股实盘 OpenAPI skill。通过 `FOSUN_ENV_PATH` 复用总入口共享 `fosun.env`；未设置时由运行时解析到与本 skill 并列的 `fosun.env`。用于明确选择实盘后的账户、资产、行情、订单和交易操作。\nversion: 1.8.0\nrequires:\n bins:\n - bash\n - curl\ninstall: install.sh\n---\n\n# real-trade — 复星实盘 OpenAPI Skill\n\n这是实盘子 skill。它只负责在用户明确选择`实盘`后执行实盘相关接口；共享凭证的生成与修复由同级 `fosun-env-setup` 负责。\n\n## 最高优先级规则\n\n1. 用户没有明确选择`实盘`时，禁止调用本 skill。\n2. 实盘下单、改单、撤单等变更动作必须先复述完整意图，并等待用户明确确认。\n3. 全局只使用一个共享凭证：`FOSUN_ENV_PATH` 指向的 `fosun.env`。\n4. 禁止为实盘或模拟盘复制第二份凭证文件。\n5. 禁止在命令或文档里写死某台机器的绝对路径；需要绝对路径时，只能由环境变量和相对路径在运行时解析得到。\n\n## 共享凭证路径\n\n推荐起手式：\n\n```bash\nexport SKILL=\"\"\nexport FOSUN_PY=\"\" # 总入口 install.sh 共享 venv，默认 fw-trade-skill/.venv/bin/python\nexport REAL_PY=\"${FOSUN_PY}\"\nexport FOSUN_ENV_PATH=\"${FOSUN_ENV_PATH:-$SKILL/../fosun.env}\"\n```\n\n路径解析规则：\n\n- `FOSUN_ENV_PATH` 未设置：脚本默认使用总入口目录下的 `fosun.env`\n- `FOSUN_ENV_PATH` 是相对路径：以总入口目录为基准解析\n- `FOSUN_ENV_PATH` 是绝对路径：直接使用\n\n同一个 `fosun.env` 同时供 `real-trade-skill` 和 `moni-trade-skill` 使用。\n\n## 使用前检查\n\n任何业务脚本前，先确保共享凭证存在：\n\n```bash\npython3 ../fosun-env-setup/code/ensure_fosun_env.py\n```\n\n结果处理：\n\n- `status=valid`：继续执行实盘凭证体检或业务脚本\n- `status=pending`：把脚本 JSON 输出里的 `exact_open_url` / `open_url` 逐字符原样给用户完成 OpenAPI 开通，禁止手写或改写 URL；用户在页面完成开通后重试，脚本通过 finalize（APIKeyCheck + 签名请求）验证\n- `status=error`：停止实盘业务，先按 `message` 修复凭证生成问题\n\n已有凭证但需要修复时：\n\n```bash\npython3 ../fosun-env-setup/code/ensure_fosun_env.py --repair\n```\n\n## 合法脚本清单\n\n只允许调用 `code/` 目录中真实存在的脚本。跑命令前先逐字符核对文件名，禁止按英文习惯脑补。\n\n| 类型 | 脚本 | 作用 |\n|---|---|---|\n| 凭证/账户 | `check_shared_env.py` | 检查共享凭证并刷新账户索引 |\n| 凭证/账户 | `account_list.py` | 查询账户列表 |\n| 凭证/账户 | `sync_accounts.py` | 强制刷新账户索引 |\n| 资产 | `cash_summary.py` | 查询现金与购买力 |\n| 资产 | `holdings.py` | 查询持仓 |\n| 资产 | `cash_flows.py` | 查询资金流水 |\n| 订单 | `order_list.py` | 查询订单列表 |\n| 交易变更 | `order_create.py` | 下单，必须二次确认 |\n| 交易变更 | `order_modify.py` | 改单，必须二次确认 |\n| 交易变更 | `order_cancel.py` | 撤单，必须二次确认 |\n| 行情 | `market_quote.py` | 实时报价 |\n| 行情 | `market_orderbook.py` | 盘口 |\n| 行情 | `market_kline.py` | K 线 |\n| 行情 | `market_min.py` | 分时 |\n| 行情 | `market_tick.py` | 逐笔成交 |\n| 行情 | `market_broker_list.py` | 经纪商队列 |\n\n## 调用顺序\n\n1. 确认用户选择的是`实盘`\n2. 运行 `../fosun-env-setup/code/ensure_fosun_env.py`\n3. 凭证 `status=valid` 或完成开通后，按用户意图选择本 skill 的脚本\n4. 查询类脚本执行后只汇报结果并停手\n5. 变更类脚本必须先复述意图并等待明确确认，再带确认参数执行\n\n## 变更操作二次确认\n\n所有实盘变更操作都必须分三步：\n\n1. 用自然语言复述完整意图，包括市场、标的、方向、数量、价格、订单类型或订单号。\n2. 明确反问用户是否确认执行。\n3. 只有用户明确肯定后，才运行对应脚本并带上确认参数。\n\n模糊回答不算确认，例如“嗯”“可以吧”“你看着办”。必须继续追问。\n\n## 错误处理\n\n脚本失败时先读 stderr/stdout 中的结构化字段，尤其是 `error_code`、`message`、`next_action`。不要凭直觉重复提交命令。\n\n常见处理：\n\n- 共享凭证不存在：回到 `fosun-env-setup` 生成\n- 共享凭证无效：运行 `fosun-env-setup --repair` 或按错误信息重新开通\n- 用户未明确选择实盘：停手追问盘别\n- 变更参数不完整：停手向用户确认缺失字段\n\n## 目录结构\n\n```text\nreal-trade-skill/\n├── SKILL.md\n├── README.md\n├── _meta.json\n├── install.sh # 兼容入口 → 转调 ../install.sh\n└── code/\n```"},{"path":"SKILL.md","content":"---\nname: fw-trade-skill\ndescription: 复星财富（Fosun Wealth）港美股 OpenAPI 交易总入口 skill：统一管理共享凭证 `fosun.env`（生成/修复/备份恢复），并在实盘与模拟盘间路由执行账户、资金、持仓、流水、行情、下单/撤单/改单等能力；全局单凭证 `FOSUN_ENV_PATH`，变更操作强制二次确认并遵循单步执行。\n---\n\n# fw-trade-skill\n\n这是总入口 skill，不直接实现交易。它只负责三件事：解析共享凭证路径、确保 `fosun.env` 已由 `fosun-env-setup` 生成或修复、判断盘别后路由到实盘或模拟盘子 skill。\n\n## 模型必须遵守\n\n### 0. 先思考再行动（最高优先级）\n\n每一步动作前，必须先在内部完成一轮显式思考，再决定下一步：\n\n- 复盘已有信息：用户原话、当前共享凭证状态、上一步脚本输出（含 stderr / 退出码）、缓存里的账户索引；\n- 明确这一步要回答的问题：现在到底是路由、凭证生成/修复、查询还是交易？所需参数是否齐全？\n- 评估可行方案，挑最小改动 / 最少副作用 / 最少询问用户的那一条；\n- 严禁基于猜测或不完整信息直接调用脚本、改写参数、跨盘别切换；\n- 任何不确定项（盘别、`subAccountId`、市场/产品类型、金额方向）必须先回头问用户，不得脑补。\n- 港美股交易的币种、余额和购买力彼此独立：`HKD` 余额只能用于港股，`USD` 余额只能用于美股，不能跨市场混用或替用户做换汇推断。\n\n### 1. 先定位共享凭证\n\n全局只使用一个共享凭证路径变量 `FOSUN_ENV_PATH`。\n\n- 未设置时：由脚本根据自身位置解析为总 skill 根目录下的 `fosun.env` 绝对路径\n- 已设置且为相对路径时：以总 skill 根目录为基准解析\n- 已设置且为绝对路径时：直接使用\n- 推荐写法：`FOSUN_ENV_PATH=fosun.env`，既保留可迁移性，又不会受当前工作目录影响\n\n禁止在文档或脚本里写死某台机器的绝对路径；需要绝对路径时，只能由相对路径和环境变量在运行时解析得到。\n\n### 2. 先确保 `fosun.env` 可用（委托子 skill）\n\n任何实盘或模拟盘操作前，必须先完成共享凭证准备。**开通、续期、重置、回填、二维码交付、备份恢复等全部规则以子 skill `fosun-env-setup` 为准**——执行前阅读其子目录 [`fosun-env-setup/SKILL.md`](fosun-env-setup/SKILL.md)；凭据流程设计见 [`fosun-env-setup/reference/credential-management-flow.md`](fosun-env-setup/reference/credential-management-flow.md)。**禁止**在母技能中自行解释或改写凭据细节，避免与子 skill 冲突。\n\n默认入口（已 `install.sh` 时优先 `$FOSUN_PY`）：\n\n```bash\n$FOSUN_PY fosun-env-setup/code/ensure_fosun_env.py\n```\n\n母技能只根据脚本 JSON 的 `status` 决定是否继续：\n\n- `valid` → 可进入盘别判断与业务子 skill\n- `pending` / `error` → **停手**，严格按子 skill 返回的 `operation_guide`、`user_message`、`next_action` 执行，不得跳过 env-setup 直接跑交易脚本\n\n### 3. 再判盘别\n\n凡是涉及以下任一金融相关操作，都必须确认用户这次是`实盘`还是`模拟盘`：\n\n- 查询账户 / 资金 / 持仓 / 流水\n- 查询订单\n- 下单 / 撤单 / 改单\n- 查询行情\n- 任何需要 `subAccountId` 的证券操作\n\n如果用户没有明确回答，禁止继续执行。禁止根据账户类型、脚本名或历史上下文替用户猜盘别。\n\n### 4. 凭证体检与路由\n\n- 用户选择`实盘`：\n 1. 使用 `real-trade-skill`。\n 2. 只读取同一个 `FOSUN_ENV_PATH` 指向的共享 `fosun.env`。\n 3. 凭证未 `valid` 时，先按 `fosun-env-setup` 子 skill 处理，不得直接跑实盘脚本。\n 4. 实盘变更操作必须先复述完整意图并获得用户明确确认。\n\n- 用户选择`模拟盘`：\n 1. 使用 `moni-trade-skill`。\n 2. 只读取同一个 `FOSUN_ENV_PATH` 指向的共享 `fosun.env`。\n 3. 凭证未 `valid` 时，先按 `fosun-env-setup` 子 skill 处理，不得直接跑模拟盘脚本。\n 4. 模拟盘不得生成、复制或维护第二份凭证。\n\n## 子 skill 职责\n\n### `fosun-env-setup`\n\n- 共享凭证的**唯一**生成、修复与引导入口；命令、场景、回填、续期/重置规则见其 `SKILL.md` 与 `reference/`\n- 不执行交易业务；母技能不得重复描述凭据流程\n\n### `moni-trade-skill`\n\n- 模拟盘子 skill\n- 不生成、不修复共享凭证\n- 直接复用 `FOSUN_ENV_PATH` 指向的共享凭证\n- 只负责执行模拟盘接口\n\n### `real-trade-skill`\n\n- 实盘子 skill\n- 直接复用 `FOSUN_ENV_PATH` 指向的共享凭证\n- 只负责执行实盘接口\n- 任何下单、改单、撤单等变更动作都必须先确认用户明确选择实盘，并完成二次确认\n\n## 最简执行顺序\n\n1. 按 **`fosun-env-setup` 子 skill** 完成凭证准备，直至 `ensure_fosun_env.py` 输出 `status=valid`\n2. 确认用户选择 `实盘` 还是 `模拟盘`\n3. 路由到 `real-trade-skill` 或 `moni-trade-skill`（全程同一 `FOSUN_ENV_PATH` / `fosun.env`）\n\n## 一键安装（组合技能共用）\n\n在 **总 skill 根目录**执行（模拟盘 / 实盘 / env-setup 共用同一份 venv 与 fsopenapi）：\n\n```bash\nbash install.sh\n```\n\n- 虚拟环境默认：`fw-trade-skill/.venv`（可用 `FW_TRADE_VENV` 覆盖；兼容旧名 `MONI_VENV`）\n- SDK 缓存默认：`fw-trade-skill/.cache/`\n- 安装完成后导出 `FOSUN_PY`（`MONI_PY` / `REAL_PY` 与之相同，兼容旧速抄表）\n\n子目录下的 `moni-trade-skill/install"},{"path":"moni-trade-skill/README.md","content":"# moni-trade-skill\n\n> 模拟盘子 skill。通过 `FOSUN_ENV_PATH` 复用共享凭证；未设置时自动解析到总 skill 根目录的 `fosun.env`，只执行模拟盘接口，不负责凭证生成或修复。\n\n## 起手式（每个新会话先跑一次）\n\n```bash\nexport SKILL=\"\"\nexport FOSUN_PY=\"\" # 总入口 `bash ../install.sh` 创建的共享 venv，默认 `fw-trade-skill/.venv/bin/python`\nexport MONI_PY=\"${FOSUN_PY}\"\nexport FOSUN_ENV_PATH=\"${FOSUN_ENV_PATH:-$SKILL/../fosun.env}\"\n```\n\n> `$MONI_PY` 就是 `install.sh` 用 [uv](https://docs.astral.sh/uv/) 自动创建的独立 venv 里的 Python 解释器（uv 自动下载并锁定 3.13，**不依赖系统 Python**）。直接调用比再套一层 `uv run` 少 150–300ms 的环境解析开销，所以速抄表统一用 `$MONI_PY`。\n>\n> `$SKILL`、`$MONI_PY` 随安装位置而变；**唯一固定的相对关系**是共享凭证 `fw-trade-skill/fosun.env` 与 `moni-trade-skill` 并列，故用 `$SKILL/../fosun.env`。不设 `FOSUN_ENV_PATH` 时，脚本也会从 `code/_client.py` 推出同一路径。\n\n## 使用前提\n\n- `FOSUN_ENV_PATH` 指向的共享凭证文件已存在\n- 该共享凭证已通过同级 `fosun-env-setup` 生成或修复\n- 当前操作已明确选择为`模拟盘`\n\n## 最简使用\n\n```bash\n# macOS / Linux\nbash ./install.sh\n\n# Windows (PowerShell)\npowershell -ExecutionPolicy Bypass -File .\\install.ps1\n\n$MONI_PY $SKILL/code/check_shared_env.py\n$MONI_PY $SKILL/code/account_list.py\n```\n\n安装脚本会自动下载并安装官方 `fsopenapi` SDK，默认版本为 `v1.2.0`。\n下载主源默认是 GitHub；主源失败时会自动读取 `../fosun-env-setup/code/ensure_fosun_env.py` 中的\n`DEFAULT_SDK_ZIP_FALLBACK_URL` 作为备用源（实现一处改动全局生效）。\n可用 `MONI_SDK_VERSION` / `MONI_SDK_URL` / `MONI_SDK_FALLBACK_URL` 覆盖。\n\n## 核心规则\n\n- 只读取 `FOSUN_ENV_PATH` 指向的共享凭证\n- 推荐写法：`FOSUN_ENV_PATH=fosun.env`，由脚本自动解析成总 skill 根目录下的绝对路径\n- 不生成、不复制、不维护第二份凭证\n- 共享凭证无效时，必须先通过同级 `fosun-env-setup` 生成或修复\n- 模拟盘只支持港股、美股正股；不支持 A 股和期权\n- 模拟盘下单只支持 `3=限价单`、`9=市价单`；**模拟盘不支持预埋单**，非交易时段也只是普通下单，不要把\"预埋\"当成额外订单类型\n- 子账户解析默认走 `FOSUN_ENV_PATH` 指向的共享凭证中的 `FSOPENAPI_ACCOUNT_INDEX` 缓存，零额外网络；缓存失效会自动刷新并重试一次\n\n## 子账户索引缓存\n\n第一次跑任意脚本时，会自动调一次 `/v1/account/Accounts`，按\n`mock` / `real_stock` / `real_option` 分桶写入 `FOSUN_ENV_PATH` 指向的共享凭证中的\n`FSOPENAPI_ACCOUNT_INDEX`。之后所有业务脚本都从缓存解析 `subAccountId`，\n不再额外打接口。\n\n- 账户有变更时主动刷新：`$MONI_PY $SKILL/code/sync_accounts.py`\n- 业务接口报\"账户类错误\"时，本 skill 会自动重刷一次缓存并用新 ID 重试\n\n## 常用命令\n\n```bash\n$MONI_PY $SKILL/code/check_shared_env.py\n$MONI_PY $SKILL/code/sync_accounts.py\n$MONI_PY $SKILL/code/account_list.py\n$MONI_PY $SKILL/code/cash_summary.py\n$MONI_PY $SKILL/code/holdings.py --product-types 5 --product-types 6\n$MONI_PY $SKILL/code/order_list.py --market hk --market us\n$MONI_PY $SKILL/code/market_quote.py --code hk00700 --field price\n```\n\n完整命令清单与高频任务速抄表见 `SKILL.md`。\n\n## 常见问题\n\n### 共享凭证不存在或无效\n\n```bash\n$MONI_PY $SKILL/code/check_shared_env.py\n```\n\n如果失败，先回到总入口或同级 `fosun-env-setup`，生成/刷新 `FOSUN_ENV_PATH` 指向的共享凭证。\n\n### `ModuleNotFoundError: No module named 'fsopenapi'`\n\n```bash\nbash ../install.sh\n```\n\n如果是下载失败，可额外检查：\n\n- 是否能访问 GitHub\n- 本机是否存在 `wget` 或 `curl`\n- 是否需要通过 `MONI_SDK_URL` / `MONI_SDK_FALLBACK_URL` 指向可访问镜像\n\n### `Invalid signature`\n\n通常说明共享 `fosun.env` 中的公私钥或 API Key 已失效，应先通过同级 `fosun-env-setup` 修复或重新生成。\n\n### `Session expired`\n\n这不是“订单 / 持仓不存在”，而是共享凭证里的券商会话已过期，当前查询通道失效了。\n\n先做体检：\n\n```bash\n$MONI_PY $SKILL/code/check_shared_env.py\n```\n\n如果仍然报会话过期，回到总入口或同级 `fosun-env-setup`，刷新 `FOSUN_ENV_PATH` 指向的共享凭证后再试。\n\n### `APIError 6"}],"languages":[],"docsSourceLabel":"CLAWHUB","editorialOverview":null,"editorialQuality":{"score":100,"threshold":65,"status":"thin","wordCount":1720,"uniquenessScore":33,"reasons":["uniqueness-below-45"]}},"media":{"evidence":{"source":"no-media","verified":false,"confidence":"low","updatedAt":"2026-10-09T23:20:40.243Z","emptyReason":"No screenshots, media assets, or demo links are available."},"primaryImageUrl":null,"mediaAssetCount":0,"assets":[],"demoUrl":null},"ownerResources":{"evidence":{"source":"unclaimed","verified":false,"confidence":"low","updatedAt":"2026-10-09T23:20:40.243Z","emptyReason":"This page has not been claimed by the agent owner."},"hasCustomPage":false,"customPageUpdatedAt":null,"customLinks":[],"structuredLinks":{"docsUrl":null,"demoUrl":null,"supportUrl":null,"pricingUrl":null,"statusUrl":null},"customPage":null},"relatedAgents":{"evidence":{"source":"protocol-neighbors","verified":false,"confidence":"medium","updatedAt":"2026-10-10T04:26:43.106Z","emptyReason":null},"items":[{"id":"8ebccd8e-3863-4187-8355-c3f14e1f9edf","entityType":"agent","canonicalPath":"/agent/iofficeai-aionui","slug":"iofficeai-aionui","name":"AionUi","description":"Free, local, open-source 24/7 Cowork app and OpenClaw for Gemini CLI, Claude Code, Codex, OpenCode, Qwen Code, Goose CLI, Auggie, and more | 🌟 Star if you like it!","url":"https://github.com/iOfficeAI/AionUi","homepage":"https://www.aionui.com","source":"GITHUB_REPOS","protocols":["MCP","OPENCLAW"],"capabilities":[],"safetyScore":100,"overallRank":70,"updatedAt":"2026-10-09T19:11:12.944Z","createdAt":"2026-02-25T03:38:16.584Z","downloads":null},{"id":"b917f68a-ebff-438e-84f8-3f4b2494c0bc","entityType":"agent","canonicalPath":"/agent/activepieces-activepieces","slug":"activepieces-activepieces","name":"activepieces","description":"AI Agents & MCPs & AI Workflow Automation • (~400 MCP servers for AI agents) • AI Automation / AI Agent with MCPs • AI Workflows & AI Agents • MCPs for AI Agents","url":"https://github.com/activepieces/activepieces","homepage":"https://www.activepieces.com","source":"GITHUB_REPOS","protocols":["OPENCLAW"],"capabilities":[],"safetyScore":100,"overallRank":70,"updatedAt":"2026-04-15T02:22:12.426Z","createdAt":"2026-02-25T03:38:12.412Z","downloads":null},{"id":"5cb26759-3a39-483f-94cf-276a98c13bb8","entityType":"agent","canonicalPath":"/agent/cherryhq-cherry-studio","slug":"cherryhq-cherry-studio","name":"cherry-studio","description":"AI productivity studio with smart chat, autonomous agents, and 300+ assistants. Unified access to frontier LLMs","url":"https://github.com/CherryHQ/cherry-studio","homepage":"https://cherry-ai.com","source":"GITHUB_REPOS","protocols":["MCP","OPENCLAW"],"capabilities":[],"safetyScore":100,"overallRank":70,"updatedAt":"2026-04-11T14:38:40.986Z","createdAt":"2026-02-25T03:38:19.379Z","downloads":null},{"id":"6f6582d0-5d76-4f0f-b81d-86520247950b","entityType":"agent","canonicalPath":"/agent/copilotkit-copilotkit","slug":"copilotkit-copilotkit","name":"CopilotKit","description":"The Frontend for Agents & Generative UI. React + Angular","url":"https://github.com/CopilotKit/CopilotKit","homepage":"https://docs.copilotkit.ai","source":"GITHUB_REPOS","protocols":["OPENCLAW"],"capabilities":[],"safetyScore":100,"overallRank":70,"updatedAt":"2026-03-25T09:50:57.846Z","createdAt":"2026-02-25T03:39:14.617Z","downloads":null}],"links":{"hub":"/agent","source":"/agent/source/clawhub","protocols":[{"label":"OpenClaw","href":"/agent/protocol/openclew"}]}}}