← 归档索引 · 2026-10-15 13:06 · eb19b095fef4
# Cron Job: 模拟盘首笔试单-1015(一次性)
**Job ID:** eb19b095fef4
**Run Time:** 2026-10-15 13:06:53
**Schedule:** once at 2026-10-15 13:05
**Prompt Characters:** 7880
## Prompt
[IMPORTANT: The user has invoked the "mx-moni" skill, indicating they want you to follow its instructions. The full skill content is loaded below.]
---
name: mx-moni
display_name: 妙想模拟组合管理 (MXSKILLS)
title: 妙想模拟组合管理 skill
description: 妙想提供的股票模拟组合管理系统，支持持仓查询、买卖操作、撤单、委托查询、历史成交查询和资金查询等功能。通过安全认证的API接口实现真实交易体验。
homepage: https://dl.dfcfs.com/m/itc4
author: 东方财富妙想团队
version: 1.0.4
required_env_vars:
- MX_APIKEY
- MX_API_URL
primary_credential:
- MX_APIKEY
credentials:
- name: MX_APIKEY
description: 妙想Skills页面获取的专属API密钥，用于接口认证
required: true
type: secret
- name: MX_API_URL
description: 模拟交易API的基础地址，默认为 https://mkapi2.dfcfs.com/finskillshub
required: false
type: string
default: "https://mkapi2.dfcfs.com/finskillshub"
---
# mx-moni 妙想模拟组合管理 skill
本 Skill 由妙想提供一个股票模拟组合管理系统，支持股票组合持仓查询、买卖操作、撤单、委托查询、历史成交查询和资金查询等功能。通过调用后端模拟组合交易相关原生接口，实现真实的交易体验，所有操作均通过安全认证的 API 接口完成。
```yaml
tags: ["模拟炒股", "A股", "投资练手", "策略验证"]
use_when:
- 用户需要模拟炒股练手、验证交易策略
- 用户需要进行模拟交易操作（买卖/撤单）
- 用户需要查询模拟账户的持仓、资金、委托、历史成交记录
not_for:
- 真实资金交易、投资建议生成、交易决策指引
- 非A股类投资模拟（期货、外汇、港股、美股等）
- 商业用途、代他人操作、非法交易演示
# 环境变量配置
parameters:
- name: MX_APIKEY
description: 妙想Skills页面获取专属API密钥
required: true
type: secret
default: process.env.MX_APIKEY
- name: MX_API_URL
description: 模拟交易API基础地址
required: false
type: string
default: process.env.MX_API_URL || "https://mkapi2.dfcfs.com/finskillshub"
```
## 功能说明
根据**用户问句**自动识别意图并调用对应接口，支持以下功能：
1. **持仓查询**：查询指定账户的当前持仓股票。
2. **买入卖出操作**：执行买入和卖出操作，支持限价/市价委托，自动识别市场号和价格小数位。
3. **撤单操作**：撤销指定委托单，也支持一键撤单。
4. **委托查询**：查询账户下的所有委托订单（含已成交、未成交、已撤单）以及账户的历史成交记录。
5. **资金查询**：查询账户可用资金与总资产。
## 配置
- **MX_APIKEY**：妙想Skills页面获取的API密钥，需保密。
- **MX_API_URL**：模拟交易API的基础URL，默认为 `https://mkapi2.dfcfs.com/finskillshub`。
- **默认输出目录**: `/root/.openclaw/workspace/mx_data/output/`（自动创建）
- **输出文件名前缀**: `mx_moni_`
- **输出文件**:
- `mx_moni_{query}.txt` - 提取后的纯文本结果
- `mx_moni_{query}.json` - API 原始 JSON 数据
在使用前，请确保已配置以下环境变量：
```bash
# 导出API Key和API地址
export MX_APIKEY=your_api_key_here
export MX_API_URL=${MX_API_URL:-"https://mkapi2.dfcfs.com/finskillshub"}
```
## 使用方式（直接 Python 脚本调用）
1. 在妙想Skills页面获取apikey。
2. 将apikey存到环境变量，命名为MX_APIKEY，检查本地apikey是否存在，若存在可直接用。
3. 直接运行 Python 脚本，根据自然语言问句自动识别功能：
```bash
# ==================== 常用调用示例 ====================
# 1. 账户查询类
python ./mx_moni.py "我的持仓"
python ./mx_moni.py "查询持仓"
python ./mx_moni.py "我的资金"
python ./mx_moni.py "账户余额"
python ./mx_moni.py "我的委托"
python ./mx_moni.py "查询订单"
# 2. 买入操作
python ./mx_moni.py "买入 600519 价格 1700 数量 100 股" # 限价买入
python ./mx_moni.py "市价买入 600519 100 股" # 市价买入
python ./mx_moni.py "买 300059 19.4 100股" # 简写也支持
# 3. 卖出操作
python ./mx_moni.py "卖出 600519 价格 1750 数量 100 股" # 限价卖出
python ./mx_moni.py "市价卖出 600519 100 股" # 市价卖出
python ./mx_moni.py "卖 300059 19.5 100股" # 简写也支持
# 4. 撤单操作
python ./mx_moni.py "撤单 260854300000078983" # 按委托编号撤单
python ./mx_moni.py "一键撤单" # 撤销当日所有未成交委托
```
> ⚠️ **安全注意事项**
>
> - **外部请求**: 本 Skill 会通过 Python 脚本发送请求至东方财富官方 API 域名 ( `mkapi2.dfcfs.com` ) 以获取模拟交易数据。
> - **凭据保护**: API Key 仅通过环境变量 `MX_APIKEY` 在服务端或受信任的运行环境中使用，不会在前端明文暴露。
## 异常情形与处理方式
| 异常情形 | 可能原因 | 处理方式 |
|----------|----------|----------|
| **connect: Connection refused** | 网络无法访问 mkapi2.dfcfs.com | 检查服务器网络配置，确保能访问公网 |
| **401 Unauthorized / API密钥不存在** | API Key 错误或已失效 | 前往妙想Skills页面重新获取 API Key 并更新环境变量 |
| **code=113 / 今日调用次数已达上限** | 当日调用次数超限 | 前往妙想Skills页面获取更多调用次数 |
| **code=404 / 未绑定模拟组合账户** | 账户未创建绑定 | 前往妙想Skills页面创建模拟账户并绑定后重试 |
| **委托方式错误 / 委托失败** | 当前非交易时间，或价格格式错误 | A股交易时间为 9:30-11:30/13:00-15:00，非交易时间无法下单；检查价格小数位是否符合市场规则 |
| **可撤委托不存在** | 委托已经成交或已撤单 | 查询委托列表确认委托状态 |
| **数据结果为空** | 账户无持仓/无委托 | 确认账户状态后重试 |
| **JSON解析错误** | 网络中断或返回内容不完整 | 检查网络后重试 |
## 交易操作说明
### 买入操作
**语法格式：**
```
python ./mx_moni.py "买入 [股票代码] [价格] [数量] 股"
python ./mx_moni.py "市价买入 [股票代码] [数量] 股"
```
**参数规则：**
| 参数 | 必填 | 说明 |
|------|------|------|
| `股票代码` | 是 | 6位数字A股代码，系统自动识别市场 |
| `价格` | 是（限价） | 委托价格，沪市不超过2位小数，深市不超过3位小数 |
| `数量` | 是 | 委托数量（股），必须为100的整数倍（100、200、300...） |
| `市价委托` | - | 使用 `市价买入` 时无需提供价格，自动以当前最新价成交 |
### 卖出操作
**语法格式：**
```
python ./mx_moni.py "卖出 [股票代码] [价格] [数量] 股"
python ./mx_moni.py "市价卖出 [股票代码] [数量] 股"
```
参数规则与买入一致。
### 撤单操作
**语法格式：**
```
python ./mx_moni.py "撤单 [委托编号]"
python ./mx_moni.py "一键撤单"
```
- **按委托编号撤单**：需要从委托查询中获取委托编号
- **一键撤单**：撤销当日所有未成交委托，无需参数
### 股票代码格式说明
买入/卖出/撤单接口的股票代码入参仅支持A股，格式为6位数字，例如 `600519`、`000001`。
### 委托数量说明
必须为整数，且需为100的整数倍（如100、200、300等），否则会被交易所拒单。
### 委托价格说明
当 `useMarketPrice=false` （限价委托）时，price参数必填，且需符合市场规则：沪市价格小数位不超过2位，深市价格小数位不超过3位；当 `useMarketPrice=true` （市价委托）时，price参数会被忽略，系统会自动以行情最新价进行买入。
---
## 前置要求
- 用户需在妙想Skills页面获取并配置 `MX_APIKEY` 和 `MX_API_URL` 环境变量。
- 模拟组合账户操作前，用户需在妙想Skills页面（地址：https://dl.dfcfs.com/m/itc4 ），创建模拟账户后，并绑定模拟组合。
- 买入/卖出操作需提供正确的股票代码、价格和数量，且价格需符合市场规则（如价格小数位）。
- 撤单操作需提供有效的委托编号，且该委托必须处于可撤销状态。
- 查询操作需确保账户已绑定且存在有效数据。
## 支持功能与触发词（脚本自动识别）
| 功能 | 触发词 | 使用示例 |
|------|--------|----------|
| 持仓查询 | `查询持仓`、`我的持仓`、`持仓情况` | `python mx_moni.py 我的持仓` |
| 资金查询 | `查询资金`、`我的资金`、`账户余额`、`资金情况` | `python mx_moni.py 我的资金` |
| 委托查询 | `查询委托`、`我的委托`、`订单`、`委托记录` | `python mx_moni.py 我的委托` |
| 买入操作 | `买入`、`买进`、`建仓`、`市价买入` | `python mx_moni.py 买入 600519 1700 100股` |
| 卖出操作 | `卖出`、`抛售`、`减仓`、`市价卖出` | `python mx_moni.py 卖出 600519 1750 100股` |
| 撤单操作 | `撤单`、`撤销`、`一键撤单` | `python mx_moni.py 撤单 260854300000078983` |
脚本会根据关键词自动识别并调用对应接口。结果输出到终端，并保存原始 JSON 到输出目录。
## 安全与错误处理
| 错误类型 | 处理方式 |
| ----------------------- | ----------------------------------------------- |
| 今日调用次数已达上限 (113) | 提示用户前往妙想Skills页面，获取更多次数 |
| API密钥不存在或已失效，请确认密钥是否正确 (114) | 提示用户前往妙想Skills页面，更新apikey |
| 请求未携带API密钥，请检查请求参数 (115) | 提示用户检查 `MX_APIKEY` 是否配置正确 |
| API密钥不存在，请确认密钥是否正确 (116) | 提示用户检查 `MX_APIKEY` 是否配置正确 |
| 未绑定模拟组合账户 (404) | 提示用户前往妙想Skills页面创建并绑定模拟账户 |
| 网络错误 | 重试最多3次，仍失败则提示“网络异常，请稍后重试” |
The user has provided the following instruction alongside the skill invocation: [IMPORTANT: You are running as a scheduled cron job. DELIVERY: Your final response will be automatically delivered to the user — do NOT use send_message or try to deliver the output yourself. Just produce your report/output as your final response and the system handles the rest. SILENT: If there is genuinely nothing new to report, respond with exactly "[SILENT]" (nothing else) to suppress delivery. [SILENT] is a literal ASCII control token — never translate or rephrase it, whatever language the rest of your answer uses. Never combine [SILENT] with content — either report your findings normally, or say [SILENT] and nothing more. FAILURE: If a delegated child fails and this cron run must be recorded as failed, put [CRON_FAILURE] on the first line by itself, then explain the child failure on following lines. RECURSION: This is a run of an EXISTING scheduled job — execute the task now. NEVER create or update a cron job because of recurring or future-schedule language in the task prompt below; treat phrasing like "each Monday" or "every day at 9" as context for this run, not as a request to schedule another job.]
你是富贵系统的模拟盘执行员。目标：完成今日首笔试单并回读验证。全程用 mx_paper.py 外挂包装器（在 /home/ubuntu/stock_workspace 下）。步骤：
1) cd /home/ubuntu/stock_workspace && 用 ./.venv/bin/python3 mx_paper.py signals 看今日门禁通过信号
2) 选排在最前的一只（如无信号则直接报告『无信号不试单』）
3) 查最新价：cd ~/.hermes/skills/mx-data && python3 mx_data.py '<代码> 最新价' --output-dir /tmp/mx_out （读返回的最新价）
4) 下单：./.venv/bin/python3 mx_paper.py buy <代码> <最新价*1.002四舍五入2位> 100 （限价100股）
5) 回读：./.venv/bin/python3 mx_paper.py status 确认持仓/可用资金变化
6) 汇报到本对话：代码/名称/限价/委托结果/回读持仓，失败贴原始错误码与信息。
约束：只买1笔、100股、不做第二笔；若 mx_paper 返回 rc=5 说明非交易时段则停并报告；绝不改任何代码文件。
**Response Characters:** 512
## Response
**今日首笔试单完成回读 ✅**
**① 门禁信号**：今日(2026-10-15)通过 8 条，排最前 = **601965.SH 中国汽研** [price_structure_scan] 看多
**② 最新价**：13.66 元（来源 mx_data 中国汽研最新价 @2026-10-15 13:06）
**③ 下单**：限价 **13.69**（=13.66×1.002 四舍五入2位）× **100股**
- 结果：**操作成功**（rc=0，非 rc=5，交易时段内）
- 委托编号：**262874500000047179**，委托价 1369（分），状态=2（已报未成交），成交量 0
**④ 回读 status**：
- 可用资金：1,000,000.00 → **998,625.99 元**（冻结 1,374.01 = 委托 1,369 + 费用约 5.01）
- 持仓：暂无成交记录（委托尚未成交，属正常挂单状态）
- 委托列表确认该单存在，今日委托总数 = 1
**结论**：单笔100股试单已提交并被接受，资金已正确冻结；成交与否以盘中后续委托状态为准。未做第二笔，未改任何代码文件。