# Starline Trade 技术概览

Trade 当前是带模拟 K 线背景的静态产品页面。图形数据在浏览器本地生成，登录和注册入口进入地区选择及暂不可用提示；当前源码没有接入真实行情、交易账户或订单执行服务。

## 入口与结构

公开指定入口为 [Starline Trade](https://trade.thestarline.cn/)。页面由 HTML、CSS、Canvas 2D、独立行情动画模型和地区选择组件组成，无交易服务端依赖。

| 模块 | 职责 |
| --- | --- |
| `market-model.js` | 逐笔模拟、OHLC、随机过程与收盘推进 |
| `market-background.js` | Canvas 尺寸、像素密度、绘制节奏与暂停 |
| `region-gate.js` 及地区数据 | 国家或地区、省份选择、搜索、不可用提示 |
| 风景与署名资料 | 地区图片、地标与图片来源页面 |

页面文案和品牌入口用于产品展示，不能据此推断已开放金融交易或得到任何地区许可。本页只说明代码，不提供交易建议。

## K 线模型与绘制数据流

模型中的每根柱包含开盘、最高、最低和收盘值。最新一根随模拟逐笔价格变化，最高、最低只记录该周期实际生成的价格；默认每 4200 毫秒收盘，新柱开盘承接上一柱收盘，已收盘 OHLC保持不变。

随机模型改变方向偏向、波动强度、逐笔间隔和短暂停顿，避免固定的涨跌阶段循环。模型使用确定的随机状态，并把数据推进与绘制分开：重绘、改变窗口尺寸或降低绘制帧率不会单独改写已经生成的模拟走势。

历史参考文件只用来校准波动比例。运行页面不会持续请求实时 BTC 行情，也不会直接重放该样本。屏幕上的红绿变化、价格范围和走势不能用于资产估值、交易判断或核对外部交易所数据。

绘制按设备像素密度和视口调整，上限为每秒 30 帧；切入后台暂停，系统开启“减少动态效果”时保持静止。该暂停属于页面资源管理，不涉及真实市场停盘或订单处理。

## 地区选择流程

登录和注册复用地区选择界面：可搜索 250 个国家或地区，选中国后再选省份，最后显示对应的暂不可用提示。用户可返回、关闭或按 Escape退出，关闭后焦点回到原入口。

该流程不提交用户名、密码或身份资料，不跳转认证服务，也不保存地区选择。选择地区不是 IP定位、GPS定位、KYC、开户或交易适当性判断。页面没有向用户索取位置权限。

旗帜、照片和地标由同源静态资源加载。地区展示优先使用既定地标映射，其余采用当地风景照片。照片灰度只施加在图像层，文字、旗帜和交互控件保持各自样式。图片来源页保留作者、原始出处和许可链接，更新素材时必须同步维护署名，不能只替换文件。

## 当前不具备的服务

源码未提供行情订阅、订单簿、限价或市价委托、撤单、持仓、钱包、充值、提现、清算或结算接口。页面“登录”“注册”是当前展示流程的入口，不能作为已接入 Account 的证据；与 [Pay](https://document.thestarline.cn/pay/) 共享地区界面也不表示共享支付账户或资金系统。

要扩展成真实业务，需要先定义权威服务端、用户授权、数据供应、幂等订单、持仓记账、故障恢复与地域服务边界。视觉模型适合独立调整动画，不宜作为交易状态模型直接复用。

## 失败与验证边界

静态资源失败会影响地区图像或动画展示，但不会产生待执行交易。减少动态、后台暂停、无搜索结果、横竖屏变化和焦点返回需要单独验收。模型测试可以检查 OHLC一致性和模拟结果稳定性，不能验证真实行情延迟或资金正确性。

资料依据 2026-10-23 源码整理。历史域名与部署记录保留原日期；当前可达性、响应式、动画暂停和地区流程需针对实际发布版本验收。相关政策见 [法律中心](https://document.thestarline.cn/legal/) 与 [隐私中心](https://document.thestarline.cn/privacy/)。

## 源码依据

主要依据为 `trade/index.html`、`market-model.js`、`market-background.js`、`market-model.test.cjs`、`region-gate.js`、地区数据及 `scenery/credits.json`。