这个项目能做什么

看盘(Kanpan,产品名 Hkline)是一个 Swift 原生 iOS 行情、自选与复盘应用。界面用 SwiftUI,图表由 UIKit/CoreGraphics 自绘,App 端无第三方依赖,不提供交易下单功能。行情数据来自币安 USDT 永续公开接口;设置中的「行情线路」提供直连(只走币安域名)与网关(走两台 VPS 取 OKX 行情)两档,由用户手动选择,不做自动切换,也不混源。 主要功能 - 皮肤:提供「青苔·冷」「陶土·暖」「经典」三套,各有浅色与深色,可跟随系统或手动指定。K 线颜色统一一套,皮肤只影响图外区域。 - 底栏:常驻「画线 · 图表 · 自选 · 板块分类 · 设置」五格等宽标签栏;「画线」是动作,点击后横屏绘制并自动转回。 - 行情页:顶栏含品种徽章、品种名、复盘入口(带待办角标)与搜索入口;价格块显示最新价、涨跌额与涨跌幅,右侧固定六格统计(仓/额、市值/费率、结算/振幅)。周期条常用行六档等宽,全部 14 档(1m 至 1y)可在「更多」中钉住或取消。价格区左右横滑可连续切换品种。 - 自选页:列表行含品种徽章、价格与涨跌药丸,支持分类文件夹、排序(含涨跌幅口径与「离提醒线最近」)、长按只读预览卡、拖动排序、滑动或批量删除后撤销。冷启动有收藏则进自选页,否则进 BTC。 - 板块分类:底栏第四格,一层板块气泡,点入为该板块品种列表,加密与美股为顶部硬切换。 - 图表:复刻 AICoin 手感。主图支持均线(10/30/120/256)、指数均线、布林带;副图出厂为成交量、持仓量、平滑异同,最多同时三个,另有相对强弱、随机指标、真实波幅、多空比、主动买卖比、基差等候选。支持盘口十行梯、双指缩放、历史焦点缩放、手动 Y 轴、末根贴右缘与越界阻尼。含 41 把画线工具(九组),画线与图表共用坐标。 - 提醒:独立模块。画线后头部价格行变为确认卡,可设「等它碰到」或「等它收盘穿过」两种判定,支持再次提醒。前台由 AlertEngine 本地评估,后台由 kanpan-worker 服务端评估并写回同步,以 active 状态去重。无 APNs 密钥时功能仍可用,仅不弹锁屏横幅。 - 复盘:记录一笔、列表/待办/统计、详情、逐根重温、私有 OHLC 找相似,记录固定所属行情源。 - 账号:用户名加密码注册登录,Keychain 会话,设备管理、改密、注销,个人数据按账号目录隔离,云端同步以待发队列为准,无邮箱注册。 代码结构 - Kanpan/Kanpan/:App 页面,含 Main、Symbols、Sector、Panels、Settings、Drawing、Account、ReviewIntegration。 - Kanpan/Symbols、Kanpan/Settings:KanpanSymbols、KanpanSettings 两个本地包及单测。 - Kanpan/KanpanUITests/:XCUITest,按 accessibilityIdentifier 定位控件。 - KanpanCore/:坐标、布局、指标、画线、皮肤色板等纯 Swift 算法。 - KanpanChart/:自绘图表与 UIKit 手势。 - KanpanNetwork/:HTTP/WS 最小接口、币安 REST/WS 客户端与限流、行情线路、网关竞速与冷却。 - KanpanData/:行情 feed、目录、历史 OI、快照与缓存。 - KanpanAccount/、KanpanReview/:账号同步与复盘模块。 - Backend/kanpan-gateway:两台 VPS 行情网关(Python + aiohttp,只做只读探测)。 - Backend/kanpan-api:Rust 个人后端,负责账号、同步与复盘索引。 - prototype/:HTML 原型;docs/:规格索引、工作清单与验收证据。 构建与验证 使用 Swift 6,部署目标 iOS 26.0(iOS 27 也在支持范围,26 以下不再维护)。打开 Kanpan/Kanpan.xcodeproj 或根目录 Kanpan.xcworkspace,选择 Kanpan scheme。可用 swift test 分别测试 KanpanCore、KanpanNetwork、KanpanData、Kanpan/Symbols,另有 make strict 与 xcodebuild 模拟器构建命令。验证以模拟器为主,受影响 UI 用例带超时执行并留存截图。仓库不包含 VPS 登录配置、私钥、密码或令牌。