Desic Terminal

English · 简体中文（当前）

AI 原生的 OKX USDT 永续合约交易终端
行情、图表、下单、市场情报、AI 助手与策略研究共享同一份实时状态与审计链路。

安装 · 三十秒上手 · 界面一览 · 核心能力 · 市场雷达 · AI 与交易的边界 · 开发

三十秒上手


1. 装	Windows EXE · macOS Apple Silicon · macOS Intel
2. 连	用模拟盘 API Key 起步；AI 也可以在配置里选本机已登录的 Codex / Claude Code，不必先购买模型 API Key
3. 看	打开市场雷达看全市场强弱 → 把标的拉进图表 → 在图上直接下单，或交给 AI 出结论

[!IMPORTANT]
当前安装包尚未使用 Apple Developer ID 或 Windows Authenticode 签名。macOS 首次启动时，请将应用拖入"应用程序"，右键应用选择"打开"；如果仍被拦截，请前往"系统设置 → 隐私与安全性"选择"仍要打开"。Windows 首次安装可能显示 SmartScreen 提示，请确认下载地址属于本仓库后再选择继续运行。

安装

推荐直接下载与操作系统匹配的构建版本：

平台	安装包
Windows x64	下载 EXE 安装程序
macOS Apple Silicon（M1 及更新芯片）	下载 Apple Silicon DMG
macOS Intel	下载 Intel DMG

也可以前往 GitHub Releases 查看版本说明和全部附件；应用内置更新检查与签名校验。

界面一览

_{交易工作台：多周期 K 线、24 个主副图指标、实时盘口与逐笔成交、限价 / 市价 / 计划委托、止盈止损}	_{多图表工作区：独立窗口四宫格、模板与布局、在图上直接做多 / 做空 / 设提醒}
_{AI 交易助手：读取账户与市场证据，输出偏空 / 偏多证据、本轮决策与下次唤醒条件}	_{指标库与 AI 自定义指标：内置指标库，并可用自然语言生成安全的 DSL 指标}
_{AI 自动化：Profile 配置模式、账户、环境、模型、关注品种与协作编排}	_{协作编排：主 Agent 唯一决策，按需点名市场结构 / 情报资金 / 账户风险 / 反方审查等专家}
_{市场情报：新闻与情绪、仓位状态 OI / 价格、主动成交、资金与基差、市场压力与样本采集}	_{市场雷达：全市场综合排名、分类强弱与市场宽度、评分归因与点时验证}

文档

文档	内容
📖 入门教程	从安装、配置模拟盘、第一笔交易到 AI 助手与情报，一步步上手
🤖 AI 自动化指南	Profile、唤醒条件、Skill 版本、Agent 库与勾选制编排、复盘与迭代的完整使用指导
📈 系统化策略指南	Python 策略编程、回测、参数调优与实盘 Profile 的完整工作流
🔧 策略协议规范	策略运行时协议、源码策略与安全边界的权威规范
🏗 产品规范	产品边界与关键设计决策

核心能力

工作域	能力
实时交易	OKX Public / Business / Private WebSocket、深度与逐笔、交易票、限价/市价/计划委托、止盈止损、OCO、改单撤单、持仓管理
专业图表	多周期 K 线、24 个主副图指标、图层与绘图、图表快速交易、多图表独立窗口、K 线数据表与 CSV 导出
AI 助手	流式推理、白名单工具、账户与市场证据读取、交易机会、图表动作、安全 DSL 自定义指标、多供应商与官方 CLI 通道
AI 自动化	Profile、类型化唤醒条件、受限自动执行、运行审计、Agent 库与勾选制编排、仓位复盘、Skill 版本与优化建议
市场雷达	全市场综合排名、分类强弱与市场宽度、排名变化、评分归因、保存筛选、研究提醒和点时历史验证
系统化策略	免安装 Python、模板策略、最长 366 天 1 分钟级回测、参数调优工作台、实盘 Profile 与信号历史
市场情报	新闻、事件聚类、币种情绪、经济日历、OI、主动流、拥挤度、资金费率、基差、Smart Money 与系统压力
通知与恢复	应用内通知、飞书机器人、持久化执行状态、未知结果对账、幂等提交与启动恢复

市场雷达

市场雷达独立扫描 OKX 全部 live USDT 永续市场，不受自选列表限制。它将日线相对强度、实现波动率、成交活跃度、趋势稳定性、流动性与当前市场快照组合成可解释的研究优先级，并保留全市场排名与筛选范围内排名两种口径。

全市场研究基线：全部 live USDT 永续准备最多 400 天 UTC 日线，按成交额选出的 Top 100 额外准备 90 天小时线；历史任务在应用启动后后台运行，不依赖打开市场雷达页面。
可复现的研究工作流：支持分类排名、自然语言确定性筛选、多标的比较、市场宽度、1 小时/1 日/7 日排名变化、评分变化归因和 1/5/20 日点时验证。
股票永续识别：使用官方 NASDAQ Trader Symbol Directory 补充证券名称和交易所，并为中文界面提供可缓存的简体/繁体实体名称。
AI 原生读取：内置 market-radar-research Skill 与只读 radar.* 工具直接读取 SQLite 快照；宽泛的当前市场分析会先检查市场宽度与默认综合排名，不依赖当前 Tab 或可见行。

[!NOTE]
市场雷达评分只用于确定下一步研究顺序，不是收益预测、买卖信号、策略入场条件或订单命令。Radar AI 工具不能修改筛选、提醒、策略、账户或订单。

AI 与交易的边界

权限不是提示词。模式决定 AI 能做什么，代码决定它做不到什么。

模式	读取市场与账户	交易机会	外部交易副作用
`advisor`	是	否	禁止
`copilot`	是	创建、修改、复用	必须由用户审批
`limited_auto`	是	通过冻结候选提交	仅限 Profile 授权范围

模型调用依次经过 Sidecar 工具可见性、Agent runtime policy、Rust 账户与环境绑定、合约参数校验、交易预检、实盘确认、幂等控制和持久化审计。

支持的 AI 供应商

Desic Terminal 可以通过 Provider API 使用下列模型服务，也支持通过本机官方 Codex CLI 与 Claude Code 委托请求。

OpenAI _{API / Codex CLI}	Claude _{API / Claude Code}	Gemini _{Google AI}	Grok _xAI
DeepSeek _深度求索	通义千问 _{阿里云百炼}	KIMI _{Moonshot AI}	豆包 _火山方舟
MiniMax _{Anthropic 兼容}	GLM（智谱） _{智谱 AI}	自定义 _兼容接口

安全与执行原则

Desic Terminal 将"不确定结果"视为独立状态，而不是简单的成功或失败。一次外部写入超时后，系统会使用稳定执行键、客户端订单 ID、账户身份和 OKX 查询进行对账；在结果明确前，不会用新的执行键自动重试风险增加操作。

flowchart LR
  Intent[人工或 AI 交易意图] --> Normalize[合约单位与价格规范化]
  Normalize --> Precheck[账户、保证金与风险预检]
  Precheck --> Approval[权限与实盘确认]
  Approval --> Reserve[持久化幂等预留]
  Reserve --> OKX[OKX Private WS / REST]
  OKX --> Reconcile[身份校验与未知结果对账]
  Reconcile --> Audit[(审计 / 订单 / Episode)]

API Key 不应包含提现权限。
模拟盘与实盘使用独立凭据和确认状态。
风险增加操作失败关闭；平仓等风险降低路径保持可用。
delegated Agent 永远只读，不能通过任务文本获得额外权限。
日志、错误和诊断信息在写入前执行敏感字段脱敏。

架构

flowchart LR
  subgraph Desktop[Desic Terminal Desktop]
    UI[React + TypeScript\nTerminal / Chart / Intelligence / AI]
    HOT[Bounded Hot Store]
    IPC[Tauri Commands & Events]
    CORE[Rust Runtime\nMarket / Trade / Automation / Systematic]
    DB[(SQLite\nHistory / Audit / Review)]
    SIDECAR[AI Sidecar\nPinned Node Runtime]
  end

  OKX[OKX WebSocket + REST]
  MODEL[AI Provider / Official CLI]
  FEISHU[Feishu Bot]

  OKX <--> CORE
  CORE <--> DB
  CORE <--> SIDECAR <--> MODEL
  CORE --> FEISHU
  CORE <--> IPC <--> HOT <--> UI

高频 ticker、盘口和逐笔不会逐条写入 React 状态。Rust 运行时负责 sequence、checksum、时间同步和有界微批；前端只接收可绘制快照。历史 K 线、订单、成交、复盘和审计由 SQLite 提供连续上下文，AI Sidecar 只暴露当前权限允许的工具集合。

核心代码边界：

src/                         React UI、图表适配、状态与桌面调用封装
src-tauri/src/               Tauri command、事件、外部 IO 与运行时编排
src-tauri/crates/            交易领域、图表 DSL、情报与自动化领域模块
scripts/                     AI Sidecar、Provider 适配、策略测试与 smoke tests
docs/                        使用文档与开发规范

开发

当前项目处于持续开发阶段。仓库已经配置 Windows x64、macOS Apple Silicon 与 macOS Intel 的安装包和安全更新产物流水线；正式安装包仍以 GitHub Releases 中实际发布并完成平台验证的版本为准。开发环境需要 Node.js、npm、Rust stable，以及 Tauri 2 对应的平台依赖。

npm install
npm run prepare:sidecar
npm run tauri dev

仅运行前端预览：

npm run dev

提交前最低验证：

npm run build
cargo check --manifest-path src-tauri/Cargo.toml --workspace
npm run test:ai-policy
npm run smoke:config-security

与改动直接相关的测试和 smoke suite 也必须运行。架构、安全与交易约束见 PRODUCT.md 和开发规范。

项目状态

当前聚焦 OKX USDT 线性永续、Windows 与 macOS 桌面端。多交易所、现货、期权和移动端不在现阶段范围内。自动化执行属于高风险能力，应从 advisor 和模拟盘开始验证，并根据运行记录、对账与仓位复盘逐步提升权限。

社区与支持

如果 Desic Terminal 对你有帮助，欢迎在 GitHub 为项目点亮 Star。Star 能帮助更多交易者和开发者发现项目。

QQ 交流群

QQ群：781180447

OKX 专属邀请

通过 OKX 专属注册链接 注册并满足活动规则，可享 15% 返佣。具体资格、比例和有效期以 OKX 页面展示的规则为准。

免责声明

本软件仅供学习研究使用，使用风险由使用者自行承担。作者及所有关联方对您的交易结果不承担任何责任。请勿投入您无法承受损失的资金。代码可能存在缺陷——本软件不附带任何形式的保证。

License

Desic Terminal 源代码基于 MIT License 开源。第三方依赖和素材仍遵循各自的许可证，概览见 THIRD_PARTY_NOTICES.md，完整许可清单随安装包分发并可在应用内"关于 → 开源许可"查看；MIT License 不授予 Desic Terminal 名称、Logo 或品牌标识的商标使用权。

Desic Terminal
Observe with context. Execute with control. Improve with evidence.

Desic-Terminal