# ek-station 桌面 · 首次运行说明（0.9.0 打包案）
产品口径（2026-10-28 用户裁定）：**独立安装版**——装完之后不依赖我们这套开发环境；
桌面**手点连接**；无界面 daemon **按档案自动连接**；无界面写档 = 一次性 CLI。
---
## 1. 装完后怎么开始（最短路径）
1. 开始菜单 →「ek-station 桌面」（桌面快捷方式同名）。
窗口标题 = `ek-station 桌面`，插件 ui/dm/oms 常驻装配，**不会自动连柜台**。
2. 菜单「账户面板」→ 填一张账户表（broker / 账号 / 密码 / 交易前置 / 行情前置 /
AppID / 授权码，收录面现时只期货）→「保存并连接」。
- 保存 = 写档 `%APPDATA%\ek\cfg\ctp.<网关名>.ini`（网关名 = `ctp_<broker>_<账号>`）；
- **密码不进档案文件**：先进 Windows「凭据管理器」（密库），档案里只留引用行
`td_password = secret://ek/<ns>/gw_td_password`；界面上永远不回显密码。
3. 之后每次启动：账户面板会把档案里的账户**列回清单**（行上显
`〔档案·密库引用 ✓〕` 徽标）。要连哪一行，点那行的「连接」——
走的是与 daemon 完全同一条起连路（svctl.start → 回灌档案段 → 网关在
worker 侧解密引用并连接）。
## 2. 「自动连接」勾选（daemon 开关源）
- 账户行上的「自动连接」勾选 = 写进 `ui` 段的 `auto_connect.<网关名>` 键（手点才落盘）。
- **无界面 daemon**（`ek-station.exe`）启动时按该勾选**自动起连**；没勾的行零动作。
- 桌面**不看**这个勾做启动连接（桌面永远手点，用户裁定）。
- daemon 退回纯装配（不自动连）：`ek-station.exe --no-restore`。
## 3. 命令行写档（无界面、一次性）
```
ekapp.exe add-account --broker 9999 --user 278153 \
--td tcp://182.254.243.31:30001 --md tcp://182.254.243.31:30011 \
--app-id simnow_client_test --auth-code 0000000000000000
```
- 提示后**从 stdin 输入密码**（密码永不进命令行参数——进程行能被旁人看到）。
- 写完打印 `已写档 ctp.ctp_9999_278153.ini(…密码=密库引用,值不落盘)`。
- 清点（只读）：`ekapp.exe list-accounts`。
- 自动连接勾由桌面行上勾（CLI 只写档案段，`ui` 段是界面面）。
## 4. 多账户时「谁是行情源」
多张账户在线时，账户面板里给目标行点「设为行情源」（锁定口径：有账户在线后不可切换；
全断开后可切）。这是运行时选择，**不写进档案**（档案只存参数，不存运行时源）。
## 5. 卸载与数据
- 卸载器**不删** `%APPDATA%\ek`（账户档案 + 主题/自动连接勾）与 Windows 密库里的密码。
重装后 `ekapp list-accounts` 直接读回。
- 想彻底清干净（手动）：
- 档案：删除 `%APPDATA%\ek\cfg\ctp.*.ini`（及 `ui.ini`）；
- 密码：控制面板 → 用户账户 → **凭据管理器** → Windows 凭据 → 删 `ek-cfg!ctp.*!gw_*` 各条。
- 卸载器完成页会把这两条路径打印在弹窗里。
## 6. 已知边界（诚实清单）
- 收录面现时**只期货**（期权 2026-10-28 起全线退役）：旧档案里的 `product_classes = 1,2`
在复原时按**只期货**呈现（不悄悄重开期权）。
- 行情前置缺省回落交易账号凭据（档案里不写 `md_user/md_password` 时）。
- 独立部署的中文显示由**内置字体**保证（构建开 `bundled-font`）：装到没装过任何
中文字体的干净机器上，中文照常渲染。窗口进程 stderr 有装载证据行
`[ek-ui] CJK 回退字体已装载: (内置资产)assets/fonts/NotoSansSC-Regular.otf`。
- 柜台连通吃柜台面（SimNow 前置偶发不稳是市场现象，不是本机故障）：连接失败行上
显形「装配失败/未连接」，重点「连接」重试即可，档案不动。