WonderTrader / Console & Studio
wondertrader 控制台：WtMonSvr 六组件、调度能力与工作台
要把系统长期跑起来，靠的不是盯着终端日志。官方提供两层工具：一层是监控服务，把组合、策略、通道与日志集中到浏览器里，并提供自动调度与进程守护；另一层是图形化工作台，把环境、账号、策略研究、回测与数据管理也纳入界面。这一页按官方文档把两者分开讲清楚。
监控服务由六个组件构成
官方文档把服务端拆得很清楚：它同时提供网页接口与推送服务，再调用后台组件完成数据、调度、事件与回测管理。
| 组件 | 职责 | 你要关心它的场景 | 注意点 |
|---|---|---|---|
| 监控服务核心 | 整个监控服务的入口，提供网页接口服务 | 部署与端口配置 | 自带网页静态资源目录，默认不需要额外指定 |
| 数据管理器 | 读取并缓存组合相关数据 | 组合列表与资金数据显示异常 | 官方更新日志记录过为提升兼容性做的读取处理 |
| 调度管理器 | 自动调度任务，并监控组合运行情况 | 需要按周设定自动启停 | 它的进程检查方式在版本演进中做过调整，重启服务后能重新接管在跑的进程 |
| 推送服务 | 把组合的日志与交易回报实时推送到网页端 | 页面数据不刷新 | 推送依赖事件接收器送来的数据 |
| 在线回测管理器 | 提供在线回测服务的管理模块 | 要在服务端统一跑回测 | 需要先配置数据伺服；官方对该模块有「可能取消、慎用」的提示 |
| 事件接收器 | 通过消息队列组件接收各交易组合推送的消息，再经推送服务转发到网页端 | 事件通知没有到达页面 | 依赖消息队列组件的可用性 |
两个入口与部署注意点
官方文档给出了明确的访问地址与默认值。默认口令是公开信息，因此这里既是使用说明，也是一条安全提醒。
| 项 | 官方默认值 / 说明 | 适用场景 | 注意点 |
|---|---|---|---|
| PC 版入口 | 服务端口下的控制台路径，官方示例端口为 8099 | 桌面端盯盘与配置 | 端口可按部署环境调整，调整后所有入口一并变化 |
| 移动版入口 | 同一服务端口下的移动路径 | 手机端查看运行状态 | 移动入口是随版本新增的能力，旧版本可能没有 |
| 默认账号 | 官方文档公开了一组默认账号与口令 | 首次登录 | 部署后必须立即修改；本文不复述具体凭据，请查阅官方文档后自行替换 |
| 主题 | 默认黑色主题，可切换为白色 | 不同光线环境 | 纯界面偏好，无功能差异 |
| 访问令牌模式 | 后续版本增加了面向跨域场景的令牌访问模式 | 跨域集成 | 来自官方更新日志记录，属于安全相关能力，建议开启评估 |
| 部署根目录 | 创建监控服务时指定的策略组合部署根目录 | 统一管理多个组合 | 传错目录会看到空列表，这是最常见的「用不了」原因 |
组合详情能看到什么
控制台把每个组合的数据分成五个模块，理解它们的分工，排查问题时就知道该点哪个标签。
| 模块 | 包含的数据 | 排查什么问题时用 | 注意点 |
|---|---|---|---|
| 策略管理 | 各子策略的持仓、成交、信号、回合与资金明细，含单策略每日资金与净值曲线 | 某个策略行为异常、想单独看它的信号 | 这里看的是策略的理论数据，不是账户真实数据 |
| 组合管理 | 组合层持仓、成交、回合、风控与资金数据，含按品种的累计收益分布 | 判断组合整体表现与品种归因 | 组合数据是子策略头寸轧平后的净头寸口径 |
| 通道管理 | 各交易通道的持仓、成交、订单与资金明细 | 理论仓位与账户实际仓位不一致 | 通道数据来自本地记录，需与柜台端核对 |
| 配置管理 | 以文件树加编辑器的形式管理组合配置文件 | 想在界面上改配置 | 改完要注意进程何时读取，避免改了不生效 |
| 滚动日志 | 组合的实时运行日志 | 排查启动失败、行情未到、下单被拒 | 日志的详细程度由日志配置决定 |
| 组合风控 | 三类过滤器的操作入口 | 盘中柔性干预 | 过滤器的具体生效行为见风控页 |
自动调度：让它自己开盘收盘
长期运行靠的是调度而不是人。官方文档给出的调度能力包含计划任务与进程守护两块。
| 能力 | 官方描述 | 典型用法 | 注意点 |
|---|---|---|---|
| 计划任务 | 可按一周七天分别配置时间点，执行启动、停止或重启 | 每天开盘前启动交易组合，收盘后停止 | 官方说明每天可配置多个时间点，够覆盖夜盘与白盘的切换 |
| 进程守护 | 按设定的时间间隔检查进程是否存在，不存在则自动启动 | 常驻服务类任务（如 7×24 的组件） | 官方把它定位为长期常驻场景；交易组合通常用计划任务更合适 |
| 任务字段 | 任务 ID、启动参数、执行程序、工作目录、消息地址 | 为每个组合建一条任务 | 交易组合的启动参数一般是入口脚本，工作目录是组合根目录 |
| Python 环境关联 | 可通过关联按钮读取监控服务运行所用的解释器路径 | 避免系统里多个解释器混用 | 用错解释器会在启动时报依赖缺失 |
| 调度日志 | 记录调度任务的执行情况 | 任务没按预期启停 | 先看日志再怀疑脚本 |
| 通知推送 | 接收组合推送的事件并转发给监控端提示用户 | 异常事件及时知晓 | 依赖事件链路完整 |
图形化工作台：分区与预设任务
官方另有一套图形化工作台，把环境、账号、监控、调度、策略研究与数据管理集中到界面里。它与监控服务是两个程序。
| 功能分区 | 能做什么 | 适用场景 | 注意点 |
|---|---|---|---|
| 环境设置 | 选择内置或已有 Python 环境、管理内置环境的依赖包；设置数据目录、工作目录与广播端口 | 首次使用与多用户隔离 | 官方说明首次运行会自动选择可用容量最大的分区作为数据目录；工作目录按登录用户分子目录，避免互相干扰 |
| 账号管理 | 管理行情账号与交易账号，支持内置前置与自定义前置 | 接入自己的柜台 | 账号信息加密存储，加密密钥在注册时随机生成 |
| 组合监控 | 实时查看组合、策略与通道数据，支持买卖点信号跟踪与自定义指标 | 盯盘与复盘 | 官方说明该功能是从监控服务迁移过来的，能力同源 |
| 自动调度 | 按时间节点自动调度程序，关闭时最小化到托盘以保持常驻 | 需要长期自动运行 | 要常驻后台，因此它不会真正退出 |
| 策略研究 | 策略管理、代码编辑、启动回测、参数优化，结果带日绩效曲线与交易分析 | 在图形界面里迭代策略 | 官方注明优化算法目前只提供遍历算法；研究进程与工作台独立，互不干扰 |
| 数据管理 | 数据查看、从第三方源下载历史数据、维护主力规则 | 补齐历史数据 | 官方说明目前集成的第三方数据源为米筐 rqdata；下载可选连续数据或分月数据 |
| 预设任务（首次运行自动生成） | 作用 | 调度频率 | 注意点 |
|---|---|---|---|
| 数据组件 | 读取账号管理中设置的行情账号进行数据落地 | 按设置的交易时段 | 依赖账号管理里已配置行情账号 |
| 合约加载器 | 加载最新的期货合约列表与品种列表 | 每天早盘与晚盘各一次 | 依赖账号管理里设置的合约账号 |
| 主力确定脚本 | 读取当日落地的行情快照，判断主力合约并更新规则 | 每天收盘后（官方文档约为 16:20） | 必须先有当天落地数据，否则无法判断 |
还没做完的部分
官方 README 里明确标了一项「在建」的能力。选型时把未完成项也算进去，比上线后才发现便宜。
| 能力 | 官方状态 | 影响 | 现阶段的替代做法 |
|---|---|---|---|
| 全自动远程部署 | 官方 README 标注「在建」，计划覆盖回测环境与实盘环境等场景的自动化部署 | 目前仍需人工完成环境搭建与部署 | 用官方仓库 docker 目录的镜像定义统一构建环境；用控制台的调度能力做运行时自动化 |
| 控制台用户与权限 | 已有管理员与风控员角色，并支持按角色配置组合权限 | 更细粒度的权限模型需自行设计 | 结合主机访问控制与网络层限制补齐 |
| 在线回测模块 | 官方提示可能取消，慎用 | 不建议把它作为长期依赖 | 用图形化工作台的研究区或本地脚本跑回测 |
| 优化算法 | 官方注明目前只提供遍历算法，后续会逐步增加 | 复杂寻优需自行实现 | 先用遍历方式缩小参数范围，再手工精调 |
常见问题
控制台相关描述来自官方文档「WtMonSvr监控服务」「控制台使用手册」「移动控制台使用手册」与工作台手册。
监控服务和控制台是一回事吗？
可以说监控服务是控制台的服务端。官方对监控服务的定义是：作为控制台的服务端，提供网页接口与推送服务，整合数据管理、任务调度、事件转发与回测管理几个组件。也就是说你在浏览器里看到的是前端界面，背后跑的是监控服务这组组件。
默认口令安全吗？
不安全，必须改。官方文档公开了默认账号与口令，属于公开信息。任何可被他人访问的部署都存在被登录的风险，而控制台连接的是真实交易环境。部署后请立即修改默认凭据、限制访问来源，并按你的安全规范评估是否需要在前面加一层访问控制。本文不复述具体凭据。
计划任务和进程守护该用哪个？
看任务的形态。计划任务适合有明确开收盘周期的任务，官方支持按一周七天分别配置时间点执行启动、停止与重启，交易组合一般属于这一类。进程守护适合需要长期常驻的任务，它按间隔检查进程是否存在、不在就拉起，官方把它定位为长期运行场景的保障。两者不是二选一，可以按其需要的任务分别配置。
为什么打开控制台组合列表是空的？
最常见的原因是部署根目录指错了。创建监控服务时需要指定策略组合的部署根目录，如果这个目录下没有组合数据，界面自然什么都不显示。另外也要确认对应目录下的交易进程是否已经写过数据 —— 没有数据可读，界面也不会凭空出现内容。
策略的理论数据和账户真实数据对不上怎么办？
先分清看的是哪一层。策略管理里看到的是各子策略的理论数据，组合管理里看到的是子策略头寸轧平后的净头寸，通道管理里看到的才是各交易通道的真实回报与持仓。三者口径本就不同。如果通道层与柜台端仍对不上，再检查成交回报是否完整，以及通道过滤器是否处于生效状态。
控制台这块和 EasyClaw 有什么关系？
没有已证实的集成关系。本框架的控制台是自建服务，连接的是你自己的交易进程与柜台；EasyClaw 侧提供的是数据、研究分析与模拟交易类技能，不提供组合监控、通道管理与自动调度这套运行时能力。若要长期运行，仍需要自行部署并运维监控服务；两者的定位是不同层级的工具。