dsh-hyperliquid 0.1.0 → 0.3.0

package/docs/research-review-2026-10-16.md

@@ -0,0 +1,46 @@
+# 多周期、指标配置与复盘证据
+
+范围按用户选择收敛为三项：复盘可信度、多周期研究、常用指标设置。其余 TradingView 平台功能不作为待办。
+
+## 入口与行为
+
+- 图表「单图 / 双图研究 / 四图研究」：同一会话标的，不同周期；副图可独立选择 14 种周期。时间视窗按 UTC epoch 联动，光标定位到对应周期包含该时间的 K 线；可分别关闭联动。布局、周期、联动开关和各周期视区按会话保存。
+- 主图编辑画线，其他研究图同步显示该会话标注。每图的点位引用都携带自己的周期、原始 OHLCV 和当前参数计算值。副图只读画线，避免误改。
+- 「指标 → 参数与模板」配置 RSI 长度及阈值、MACD 快慢和信号长度、BOLL 长度和标准差倍数、Stochastic 参数及阈值、ADX/DMI 参数。模板包括已启用指标、全部参数、自定义均线；宿主保存，可跨会话载入、更新和删除。
+- 「数据窗口」显示光标对应的原始 OHLCV、当前启用指标和自定义均线值。未完成预热的指标留空，不填零。配置及开关按会话保存。
+- 「交易复盘」按 7 / 30 / 90 天、当前标的或全部标的读取成交、委托和资金费。展开逐笔记录查看 oid、交易 ID、原始原因、费用、执行偏差及缺口；可定位图表、导出含原始证据与核对结果的 JSON，或交给 AI 复盘。
+- 「交易设置 → 交易限额 → 模拟成交成本」：默认手续费 4.5 bps、不利滑点 5 bps，可配置 0–100 bps；是模拟假设，不是账户实际费率。费用实际扣现金，保证金预检包含费用和滑点损失。仅作用于新成交，逐笔保存当时配置与参考中间价。
+
+## 复盘口径
+
+交易窗口统计不等于账户收益率，也不等于一笔完整开平仓。订单按 `coin + oid` 匹配，成交优先按 `coin + tid` 去重；模拟成交使用本地唯一 oid。保留原始决策原因，未记录的原因标为缺失，不事后补写为原始依据。
+
+核心 USDC 永续：已实现毛盈亏使用成交的 closedPnl，扣费净额减去该窗口所有成交手续费（含开仓手续费）。资金费按现金流正负计入，仅在完整取得窗口资金费时显示含资金费净额。手续费 fee 已含 builderFee，不能重复扣除；不同 feeToken 分开汇总。HIP-3、现货和 Outcome 不并入核心永续的 USDC 净额。平仓成交笔数不是完整往返交易数。
+
+缺失 fee、closedPnl 或资金费数据时净额显示未知；历史达到保留上限时显示覆盖缺口。实盘受交易所最近 2000 笔成交 / 历史委托限制；资金费分页使用包含末时间戳的边界并去重，最多 12 页，遇到无法推进、无效记录、请求错误或上限则标为不完整。历史订单没有窗口内成交可能是撤单、未成交、窗口外成交或截断，不据此认定执行失败。状态未知的本地下单需按 cloid 查询 orderStatus。
+
+模拟账本保留最多 5000 笔成交与委托；旧版本仅保留 200 笔，达到这一数量后保守提示历史可能截断。旧记录未知费用不追溯补算。不模拟盘口深度、资金费和强平。钱包统计也明确仅覆盖保留成交。
+
+## 指标口径与 AI 一致性
+
+`lib/studies.js` 是图表、数据窗口、点位引用和 AI 配置指标的共同计算入口。RSI 使用 Wilder 平滑；本次纠正旧图表后续涨跌项未除以周期的错误。MACD 用 SMA 初始化的 EMA；BOLL 使用总体标准差；Stochastic 使用区间最高 / 最低计算原始 %K，再对 %K / %D 做 SMA；ADX 使用 TR、方向运动和 DX 的 Wilder 平滑；OBV 从已加载首根的零基准累积有符号成交量。
+
+OBV 绝对值随历史窗口变化；EMA、RSI、ADX 等有递归初始化，对比不同加载窗口时可能存在预热差异。图表含形成中末根，AI `hyper_market indicators` 排除未收盘 K 线，只能在相同参数、相同历史窗口、相同已收盘时点比较。高周期光标匹配到的柱子在低周期当时可能尚未收盘；联动用于研究，不是隔离未来数据的回放器。
+
+`hyper_context.workspace` 返回参数和研究布局；`hyper_market indicators.configured` 返回实际参数、各指标值和已收盘时点，兼容字段 RSI/MACD/BOLL 也按配置更新；`hyper_account review` 返回与界面相同的证据和核对结果。策略框架继续使用其明确写出的固定默认条件，不能把自定义参数当作已验证策略。
+
+## 验证
+
+- `npm test`：新增指标手工金值、RSI 与既有后端对照、资金费分页边界、重复成交、builder fee、不完整费用、数量差异、模拟成本扣账、模板及会话配置恢复、AI 参数一致性。
+- `npm run typecheck` / `npm run build`。
+- `npm run smoke:research`：临时真实 DSH 宿主，四图/双图、光标和时间联动、拖动不引用、参数与模板、数据窗口、点位参数、复盘导出与刷新恢复。
+- `npm run smoke:drawing`：原绘图、图表基础交互及新增研究流程的组合回归。
+
+本轮已通过 `npm test`、`npm run typecheck`、`npm run build`、`npm run smoke:chart` 和 `npm run smoke:research`。浏览器验收覆盖模拟费用设置保存、四图/双图、光标与时间联动、拖动不引用、参数化点位引用、90 天复盘证据导出、刷新恢复及模板跨会话应用。图表基础回归覆盖画线坐标、图表类型、日期导航、导出和放大视图。
+
+## 口径依据
+
+- [Hyperliquid Info endpoint](https://hyperliquid.gitbook.io/hyperliquid-docs/for-developers/api/info-endpoint)：成交 ID、费用字段、返回上限。
+- [Hyperliquid perpetuals info](https://hyperliquid.gitbook.io/hyperliquid-docs/for-developers/api/info-endpoint/perpetuals)：userFunding 时间窗和现金流字段。
+- [TradingView Stochastic](https://www.tradingview.com/support/solutions/43000502332-stochastic-stoch/)：%K / %D 定义。
+- [TradingView ADX](https://www.tradingview.com/support/solutions/43000589099-average-directional-index-adx/) 与 [OBV](https://www.tradingview.com/support/solutions/43000502593-on-balance-volume-obv/)：指标含义与计算口径。

package/index.js

@@ -94,7 +94,8 @@ export function apply(ctx, config = {}) {
         const lines = [
           '## Hyperliquid 交易台（dsh-hyperliquid）',
           `本 Harness 装有 Hyperliquid 交易台（mode=${mode}，network=${net}）。用户可在面板看行情并填写交易票据；票据只把意图送入当前会话，所有实际下单只能由你调用工具完成。`,
-          '可用工具：hyper_context（会话交易上下文）、hyper_market（详细行情）、hyper_chart（在行情图上画支撑/阻力与趋势线）、hyper_account（账户）、hyper_decide（交易决策预检并返回一次性 decisionId）、hyper_order（执行/撤单/杠杆）、hyper_session（会话视角）。',
+          '可用工具只有这 7 个，没有其它 hyper_* 工具：hyper_context（会话交易上下文）、hyper_market（行情：action=overview/catalog/book 盘口/candles/indicators/trades）、hyper_chart（画线 41 种、kind=ma 均线、action=view 切周期与 RSI/MACD 等副图指标）、hyper_account（账户）、hyper_decide（交易决策预检并返回一次性 decisionId）、hyper_order（执行/撤单/杠杆）、hyper_session（会话视角与绑定币对）。',
+          '均线用 hyper_chart add kind=ma、RSI/MACD 等用 hyper_chart action=view show=[...]，图表会实时计算；不要自己计算均线再用多段趋势线拼折线。工具返回错误时换正确参数重试一次，仍失败就直接告诉用户，不要反复推演。',
           '用户说"当前/界面上这个币"时，先 hyper_context 或 hyper_session status；需要技术判断时用 hyper_market indicators 验证趋势、动量、波动和支撑阻力，可用 hyper_chart 将依据画给用户看。交易前核对行情与账户，说明方向、数量、依据及风险。paper 模式用 hyper_order 执行；live 模式先用 hyper_decide 预检，并用返回的一次性 decisionId 执行 hyper_order。是否可自主执行由宿主配置和钱包策略决定。',
         ]
         if (skillRemove) lines.push('复杂的 Hyperliquid 分析、交易或异常对账，请先加载 hyperliquid-trading skill。')

package/lib/chart-drawings.d.ts

@@ -0,0 +1,27 @@
+export type DrawingKind = 'level' | 'hray' | 'vline' | 'text' | 'trend' | 'ray' | 'extended' | 'fib' | 'rect' | 'measure' | 'channel' | 'long' | 'short' | 'fibext' | 'fibchannel' | 'fibtime' | 'gannfan' | 'pitchfork' | 'regression' | 'vprofile' | 'arrow' | 'callout' | 'circle' | 'triangle' | 'brush' | 'crossline' | 'pricelabel' | 'infoline' | 'trendangle' | 'pricerange' | 'daterange' | 'elliott' | 'elliottabc' | 'xabcd' | 'abcd' | 'headshoulders' | 'gannbox' | 'gannsquare' | 'schiff' | 'modschiff' | 'icon'
+export type LineStyleName = 'solid' | 'dashed' | 'dotted'
+export interface DrawingStyle { rows?: number; valueArea?: number; color?: string; lineWidth?: number; lineStyle?: LineStyleName; locked?: boolean; hidden?: boolean; shared?: boolean; alert?: boolean }
+export declare const DRAWING_POINTS: Record<DrawingKind, number>
+export declare const DRAWING_KINDS: DrawingKind[]
+export declare const DRAWING_CLICKS: Record<DrawingKind, number>
+export declare const LINE_STYLES: LineStyleName[]
+export declare function drawingStyle(request: unknown): DrawingStyle
+export declare const FIB_LEVELS: number[]
+export declare function drawingGeometry(kind: string, request: unknown, now?: number): Record<string, unknown>
+export declare const BRUSH_MIN: number
+export declare const BRUSH_MAX: number
+export declare const TEXT_KINDS: DrawingKind[]
+export declare const FIB_EXT_LEVELS: number[]
+export declare const FIB_TIME_SERIES: number[]
+export declare const GANN_RATIOS: Array<[number, number]>
+export declare const ICON_NAMES: string[]
+export declare const GANN_BOX_LEVELS: number[]
+export declare const STICKERS: Record<'trading' | 'faces' | 'symbols', string[]>
+export declare function isIconLabel(label: unknown): boolean
+export declare const ALERT_KINDS: DrawingKind[]
+export declare function linePriceAt(mark: unknown, time: number): number | null
+export declare function isSingleEmoji(value: unknown): boolean
+export interface VolumeProfileRow { low: number; high: number; up: number; down: number }
+export declare function volumeProfile(bars: Array<{ open: number; high: number; low: number; close: number; volume: number }>, options?: { rows?: number; valueArea?: number }): { rows: VolumeProfileRow[]; total: number; poc: number; pocIndex: number; vah: number; val: number; valueLow: number; valueHigh: number } | null
+export declare const PROFILE_ROWS_MIN: number
+export declare const PROFILE_ROWS_MAX: number

package/lib/chart-drawings.js

@@ -0,0 +1,217 @@
+/**
+ * dsh-hyperliquid — chart drawing kinds shared by the host (validation, the
+ * hyper_chart tool) and the browser chart (tools menu, rendering).
+ *
+ * level / trend keep their original flat fields (price; fromTime…toPrice);
+ * every other kind stores `points: [{ time, price }]` in click order.
+ * @module lib/chart-drawings
+ */
+
+/** kind → number of anchor points (level: a price only). */
+export const DRAWING_POINTS = {
+  level: 1, hray: 1, vline: 1, text: 1, trend: 2, ray: 2, extended: 2, fib: 2, rect: 2, measure: 2, channel: 3,
+  // Positions store [entry, stop, target]; the desk creates them with 2 clicks (target defaults to 2R).
+  long: 3, short: 3,
+  // Fibonacci family, Gann, pitchfork, regression.
+  fibext: 3, fibchannel: 3, fibtime: 2, gannfan: 2, pitchfork: 3, regression: 2,
+  // Fixed range volume profile: the two points only set the time range.
+  vprofile: 2,
+  // Annotation and shapes. brush is freehand: 0 = variable (BRUSH_MIN..BRUSH_MAX points).
+  arrow: 2, callout: 2, circle: 2, triangle: 3, brush: 0,
+  // More lines and measures: cross line, price label, info line, trend angle, price-only and date-only ranges.
+  crossline: 1, pricelabel: 1, infoline: 2, trendangle: 2, pricerange: 2, daterange: 2,
+  // Advanced: Elliott waves, harmonic / chart patterns, Gann box & square, pitchfork variants, icons.
+  elliott: 6, elliottabc: 4, xabcd: 5, abcd: 4, headshoulders: 7,
+  gannbox: 2, gannsquare: 2, schiff: 3, modschiff: 3, icon: 1,
+}
+/** Icon stickers (the drawing's label holds the icon name). */
+export const ICON_NAMES = ['flag', 'star', 'up', 'down', 'warning', 'check', 'cross', 'fire', 'target', 'bell', 'pin', 'clock', 'dollar', 'shield', 'bolt', 'heart', 'question', 'info']
+/** Sticker library (TradingView's emoji stickers): category → emoji. An icon label is a name or `emoji:<char>`. */
+export const STICKERS = {
+  trading: ['📈', '📉', '💰', '💸', '🚀', '🎯', '🔥', '💎', '🐂', '🐻', '🐋', '🚨', '🔔', '⏰', '📌', '🧭', '🛑', '🏦', '⚖️', '🪙'],
+  faces: ['😀', '😂', '😎', '🤔', '😱', '😭', '😡', '🥳', '🤯', '🙏', '👍', '👎', '👀', '💪', '🫡', '🤝'],
+  symbols: ['⭐', '❗', '❓', '💡', '🔒', '🔓', '⛔', '🟢', '🔴', '🟡', '⬆️', '⬇️', '↗️', '↘️', '🏁', '🎉', '✅', '❌', '⚠️', '♻️', '⏸️', '▶️'],
+}
+const STICKER_SET = new Set(Object.values(STICKERS).flat())
+/** Whether an icon drawing's label names a built-in icon or a library sticker. */
+export function isIconLabel(label) {
+  if (ICON_NAMES.includes(label)) return true
+  if (typeof label !== 'string' || !label.startsWith('emoji:')) return false
+  const emoji = label.slice(6)
+  return STICKER_SET.has(emoji) || isSingleEmoji(emoji)
+}
+
+/** Any one emoji (a single grapheme that is pictographic, or a regional-indicator flag), so the whole emoji set works as stickers. */
+export function isSingleEmoji(value) {
+  if (typeof value !== 'string' || !value || value.length > 32 || !/\p{Extended_Pictographic}|\p{Regional_Indicator}/u.test(value)) return false
+  return [...new Intl.Segmenter(undefined, { granularity: 'grapheme' }).segment(value)].length === 1
+}
+/**
+ * Fixed range volume profile (TradingView FRVP): each bar's volume is spread evenly over its high–low
+ * range into `rows` price rows, split by bar direction. POC is the heaviest row; the value area grows
+ * from the POC toward the heavier neighbour until it holds `valueArea` of the volume.
+ * @param {Array<{ open: number, high: number, low: number, close: number, volume: number }>} bars
+ */
+export const PROFILE_ROWS_MIN = 6
+export const PROFILE_ROWS_MAX = 200
+export function volumeProfile(bars, { rows = 48, valueArea = 0.7 } = {}) {
+  const valid = bars.filter((bar) => [bar.open, bar.high, bar.low, bar.close, bar.volume].every(Number.isFinite) && bar.high >= bar.low && bar.volume >= 0)
+  if (!valid.length) return null
+  const low = Math.min(...valid.map((bar) => bar.low)), high = Math.max(...valid.map((bar) => bar.high))
+  // A flat range is one row at that exact price, not a row of invented width above it.
+  const count = high > low ? rows : 1
+  const step = high > low ? (high - low) / count : 0
+  const out = Array.from({ length: count }, (_, index) => ({ low: low + index * step, high: count === 1 ? high : low + (index + 1) * step, up: 0, down: 0 }))
+  for (const bar of valid) {
+    const side = bar.close >= bar.open ? 'up' : 'down'
+    if (count === 1) { out[0][side] += bar.volume; continue }
+    if (bar.high === bar.low) { out[Math.min(count - 1, Math.floor((bar.low - low) / step))][side] += bar.volume; continue }
+    const first = Math.max(0, Math.floor((bar.low - low) / step)), last = Math.min(count - 1, Math.floor((bar.high - low) / step))
+    for (let index = first; index <= last; index += 1) {
+      const overlap = Math.min(bar.high, out[index].high) - Math.max(bar.low, out[index].low)
+      if (overlap > 0) out[index][side] += bar.volume * overlap / (bar.high - bar.low)
+    }
+  }
+  const total = out.reduce((sum, row) => sum + row.up + row.down, 0)
+  if (!(total > 0)) return null
+  const size = (index) => index >= 0 && index < count ? out[index].up + out[index].down : -1
+  let poc = 0
+  for (let index = 1; index < count; index += 1) if (size(index) > size(poc)) poc = index
+  let lo = poc, hi = poc, held = size(poc)
+  while (held < total * valueArea && (lo > 0 || hi < count - 1)) {
+    if (size(hi + 1) >= size(lo - 1)) { hi += 1; held += size(hi) } else { lo -= 1; held += size(lo) }
+  }
+  return { rows: out, total, poc: (out[poc].low + out[poc].high) / 2, pocIndex: poc, vah: out[hi].high, val: out[lo].low, valueLow: lo, valueHigh: hi }
+}
+
+/** Gann box divisions on both axes (TradingView defaults). */
+export const GANN_BOX_LEVELS = [0, 0.25, 0.382, 0.5, 0.618, 0.75, 1]
+/** Drawings a price can cross: alerts fire when the mid price crosses them (once, like TradingView). */
+export const ALERT_KINDS = ['level', 'hray', 'trend', 'ray', 'extended']
+
+/** The line's price at `time`, or null when the drawing does not exist at that time. */
+export function linePriceAt(mark, time) {
+  if (mark.kind === 'level') return Number(mark.price)
+  const [a, b] = mark.kind === 'trend'
+    ? [{ time: mark.fromTime, price: mark.fromPrice }, { time: mark.toTime, price: mark.toPrice }]
+    : mark.points ?? []
+  if (!a) return null
+  if (mark.kind === 'hray') return time >= a.time ? a.price : null
+  if (!b || b.time === a.time) return null
+  if (mark.kind === 'trend' && (time < Math.min(a.time, b.time) || time > Math.max(a.time, b.time))) return null
+  if (mark.kind === 'ray' && (time - a.time) * (b.time - a.time) < 0) return null
+  return a.price + (b.price - a.price) * (time - a.time) / (b.time - a.time)
+}
+
+export const BRUSH_MIN = 2
+export const BRUSH_MAX = 500
+/** Kinds whose label is free text shown on the chart (up to 200 characters). */
+export const TEXT_KINDS = ['text', 'callout']
+/** Clicks that create a drawing when they differ from its stored anchor count. */
+export const DRAWING_CLICKS = { ...Object.fromEntries(Object.entries(DRAWING_POINTS)), long: 2, short: 2 }
+export const DRAWING_KINDS = Object.keys(DRAWING_POINTS)
+/** Fibonacci retracement levels (0 = second point, 1 = first point, as in TradingView). */
+export const FIB_LEVELS = [0, 0.236, 0.382, 0.5, 0.618, 0.786, 1]
+/** Trend-based Fibonacci extension levels (projected from the third point, TradingView defaults). */
+export const FIB_EXT_LEVELS = [0, 0.382, 0.618, 1, 1.272, 1.618, 2, 2.618]
+/** Fibonacci time zones: bar multiples of the first two points' spacing. */
+export const FIB_TIME_SERIES = [0, 1, 2, 3, 5, 8, 13, 21, 34, 55, 89]
+/** Gann fan angles as price/time ratios relative to the 1×1 line. */
+export const GANN_RATIOS = [[1, 8], [1, 4], [1, 3], [1, 2], [1, 1], [2, 1], [3, 1], [4, 1], [8, 1]]
+
+const OLDEST = Date.UTC(2015, 0, 1)
+
+/**
+ * Validate the geometry of one drawing request (throws on invalid input).
+ * @returns the geometry fields to persist for that kind.
+ */
+export function drawingGeometry(kind, request, now = Date.now()) {
+  if (!DRAWING_KINDS.includes(kind)) throw new Error(`画线类型必须为 ${DRAWING_KINDS.join('/')}`)
+  const latest = now + 365 * 86_400_000
+  const point = (time, price, label) => {
+    const t = Number(time), p = Number(price)
+    if (!Number.isFinite(t) || t < OLDEST || t > latest) throw new Error(`${label}时间必须为 2015 年至今后一年内的毫秒时间戳`)
+    if (!Number.isFinite(p) || p <= 0) throw new Error(`${label}价格必须为正数`)
+    return { time: t, price: p }
+  }
+  if (kind === 'level') {
+    const price = Number(request?.price)
+    if (!Number.isFinite(price) || price <= 0) throw new Error('水平线 price 必须为正数')
+    return { price }
+  }
+  if (kind === 'trend') {
+    const from = point(request?.fromTime, request?.fromPrice, '趋势线起点')
+    const to = point(request?.toTime, request?.toPrice, '趋势线终点')
+    if (to.time <= from.time) throw new Error('趋势线终点时间必须晚于起点')
+    return { fromTime: from.time, fromPrice: from.price, toTime: to.time, toPrice: to.price }
+  }
+  const need = DRAWING_POINTS[kind]
+  const raw = request?.points
+  if (kind === 'brush') {
+    if (!Array.isArray(raw) || raw.length < BRUSH_MIN || raw.length > BRUSH_MAX) throw new Error(`brush 需要 ${BRUSH_MIN}-${BRUSH_MAX} 个 points`)
+  } else if (!Array.isArray(raw) || raw.length !== need) throw new Error(`${kind} 需要 ${need} 个 points（{ time, price }）`)
+  const points = raw.map((item, index) => point(item?.time, item?.price, `第 ${index + 1} 个点`))
+  if (['trend', 'ray', 'extended', 'channel', 'fibchannel', 'gannfan', 'regression', 'fibtime', 'infoline', 'trendangle'].includes(kind) && points[0].time === points[1].time) throw new Error('前两个点的时间不能相同')
+  if (kind === 'vprofile') {
+    if (points[0].time === points[1].time) throw new Error('成交量分布需要一个时间区间')
+    // Only the time range matters, so either drawing direction is fine.
+    if (points[1].time < points[0].time) points.reverse()
+  }
+  if ((kind === 'regression' || kind === 'fibtime' || kind === 'gannfan') && points[1].time < points[0].time) throw new Error('第二个点必须晚于第一个点')
+  if (kind === 'long' || kind === 'short') {
+    const [entry, stop, target] = points.map((item) => item.price)
+    const ok = kind === 'long' ? stop < entry && entry < target : target < entry && entry < stop
+    if (!ok) throw new Error(kind === 'long' ? '多头头寸需要 止损 < 入场 < 止盈' : '空头头寸需要 止盈 < 入场 < 止损')
+    if (points[1].time <= points[0].time) throw new Error('头寸右边界时间必须晚于入场时间')
+  }
+  return { points }
+}
+
+const COLOR = /^#[0-9a-fA-F]{6}$/
+export const LINE_STYLES = ['solid', 'dashed', 'dotted']
+
+/** Validate optional appearance fields; absent keys are left untouched. */
+export function drawingStyle(request) {
+  const style = {}
+  if (request?.color != null) {
+    if (typeof request.color !== 'string' || !COLOR.test(request.color)) throw new Error('画线颜色必须为 #RRGGBB')
+    style.color = request.color.toLowerCase()
+  }
+  if (request?.lineWidth != null) {
+    const width = Number(request.lineWidth)
+    if (!Number.isInteger(width) || width < 1 || width > 4) throw new Error('线宽必须为 1-4 的整数')
+    style.lineWidth = width
+  }
+  if (request?.lineStyle != null) {
+    if (!LINE_STYLES.includes(request.lineStyle)) throw new Error(`线型必须为 ${LINE_STYLES.join('/')}`)
+    style.lineStyle = request.lineStyle
+  }
+  // Volume profile settings (TradingView "Rows" and "Value Area Volume").
+  if (request?.rows != null) {
+    if (request?.kind != null && request.kind !== 'vprofile') throw new Error('rows 只适用于固定范围成交量分布')
+    const rows = Number(request.rows)
+    if (!Number.isInteger(rows) || rows < PROFILE_ROWS_MIN || rows > PROFILE_ROWS_MAX) throw new Error(`成交量分布行数必须为 ${PROFILE_ROWS_MIN}-${PROFILE_ROWS_MAX} 的整数`)
+    style.rows = rows
+  }
+  if (request?.valueArea != null) {
+    if (request?.kind != null && request.kind !== 'vprofile') throw new Error('valueArea 只适用于固定范围成交量分布')
+    const share = Number(request.valueArea)
+    if (!Number.isFinite(share) || share < 0.5 || share > 0.95) throw new Error('价值区比例必须在 0.5-0.95 之间')
+    style.valueArea = share
+  }
+  for (const flag of ['shared', 'alert']) {
+    if (request?.[flag] == null) continue
+    if (typeof request[flag] !== 'boolean') throw new Error(`${flag} 必须为布尔值`)
+    style[flag] = request[flag]
+  }
+  if (style.alert && request?.kind != null && !ALERT_KINDS.includes(request.kind)) throw new Error(`只有 ${ALERT_KINDS.join('/')} 支持价格提醒`)
+  if (request?.hidden != null) {
+    if (typeof request.hidden !== 'boolean') throw new Error('hidden 必须为布尔值')
+    style.hidden = request.hidden
+  }
+  if (request?.locked != null) {
+    if (typeof request.locked !== 'boolean') throw new Error('locked 必须为布尔值')
+    style.locked = request.locked
+  }
+  return style
+}

package/lib/indicators.js

@@ -46,13 +46,18 @@ function closeTime(row, interval) {
   return minutes ? row.t + minutes * 60_000 - 1 : row.t
 }
 
-export function computeIndicators(candles, { now = Date.now(), interval } = {}) {
+/** Valid, de-duplicated, ascending candles split into closed rows and the count of still-forming ones. */
+export function closedCandles(candles, { now = Date.now(), interval } = {}) {
   const valid = (candles ?? []).map((c) => ({ t: Number(c.t), T: c.T, o: Number(c.o), h: Number(c.h), l: Number(c.l), c: Number(c.c), v: Number(c.v) }))
     .filter((c) => [c.t, c.o, c.h, c.l, c.c, c.v].every(Number.isFinite) && c.t > 0 && c.h >= c.l && c.c > 0)
     .sort((a, b) => a.t - b.t)
   const unique = [...new Map(valid.map((row) => [row.t, row])).values()]
   const rows = unique.filter((row) => closeTime(row, interval) < now)
-  const excludedOpen = unique.length - rows.length
+  return { rows, excludedOpen: unique.length - rows.length, closeTime: (row) => closeTime(row, interval) }
+}
+
+export function computeIndicators(candles, { now = Date.now(), interval } = {}) {
+  const { rows, excludedOpen } = closedCandles(candles, { now, interval })
   if (rows.length < 50) return { ready: false, candlesUsed: rows.length, excludedOpen, reason: '至少需要 50 根已收盘的有效 K 线' }
   const close = rows.map((c) => c.c)
   const volume = rows.map((c) => c.v)

package/lib/moving-average.d.ts

@@ -0,0 +1,21 @@
+export type MaKind = 'sma' | 'ema' | 'smma' | 'wma'
+export type MaSource = 'close' | 'open' | 'high' | 'low' | 'hl2' | 'hlc3' | 'ohlc4'
+export interface MaLine {
+  id: string
+  kind: MaKind
+  period: number
+  source: MaSource
+  smoothing: { kind: MaKind; period: number } | null
+  color?: string
+}
+export interface MaCandle { o: number; h: number; l: number; c: number }
+export declare const MA_KINDS: MaKind[]
+export declare const MA_SOURCES: MaSource[]
+export declare const MA_MAX_LINES: number
+export declare const MA_MAX_PERIOD: number
+export declare function normalizeMaLine(input: unknown): MaLine
+export declare function normalizeMaLines(list: unknown): MaLine[]
+export declare function maLabel(line: MaLine): string
+export declare function movingAverage(values: Array<number | null>, kind: MaKind, period: number): Array<number | null>
+export declare function maSeries(candles: MaCandle[], line: MaLine): { values: Array<number | null>; smoothed: Array<number | null> | null }
+export declare function maLatest(candles: MaCandle[], lines: MaLine[]): Array<{ id: string; label: string; value: number | null; smoothed: number | null; line: MaLine }>

package/lib/moving-average.js

@@ -0,0 +1,133 @@
+/**
+ * dsh-hyperliquid — configurable moving-average lines, shared by the host
+ * (hyper_market / hyper_chart) and the browser chart so both compute the
+ * exact same values.
+ *
+ * Definitions follow TradingView Pine:
+ *   SMA   ta.sma   arithmetic mean of the last n values
+ *   EMA   ta.ema   alpha = 2/(n+1), seeded with the SMA of the first n values
+ *   SMMA  ta.rma   alpha = 1/n (Wilder / smoothed MA), seeded with the SMA
+ *   WMA   ta.wma   linear weights n, n-1, …, 1 (newest heaviest)
+ * An optional smoothing applies a second MA to the first line, like the
+ * "Smoothing" setting of TradingView's moving-average indicators.
+ * @module lib/moving-average
+ */
+
+export const MA_KINDS = ['sma', 'ema', 'smma', 'wma']
+export const MA_SOURCES = ['close', 'open', 'high', 'low', 'hl2', 'hlc3', 'ohlc4']
+export const MA_MAX_LINES = 8
+export const MA_MAX_PERIOD = 500
+const COLOR = /^#[0-9a-fA-F]{6}$/
+
+/**
+ * Validate and canonicalize one line definition (throws on invalid input).
+ * @param {object} input - { kind, period, source?, smoothing?: { kind, period }, color? }
+ * @returns {{ id: string, kind: string, period: number, source: string, smoothing: { kind: string, period: number } | null, color?: string }}
+ */
+export function normalizeMaLine(input) {
+  if (!input || typeof input !== 'object') throw new Error('均线定义无效')
+  const kind = String(input.kind ?? '').toLowerCase()
+  if (!MA_KINDS.includes(kind)) throw new Error(`均线类型必须为 ${MA_KINDS.join('/')}`)
+  const period = Number(input.period)
+  if (!Number.isInteger(period) || period < 1 || period > MA_MAX_PERIOD) throw new Error(`均线周期必须为 1-${MA_MAX_PERIOD} 的整数`)
+  const source = String(input.source ?? 'close').toLowerCase()
+  if (!MA_SOURCES.includes(source)) throw new Error(`均线价格源必须为 ${MA_SOURCES.join('/')}`)
+  let smoothing = null
+  if (input.smoothing != null) {
+    const sKind = String(input.smoothing.kind ?? '').toLowerCase()
+    const sPeriod = Number(input.smoothing.period)
+    if (!MA_KINDS.includes(sKind)) throw new Error(`平滑类型必须为 ${MA_KINDS.join('/')}`)
+    if (!Number.isInteger(sPeriod) || sPeriod < 1 || sPeriod > MA_MAX_PERIOD) throw new Error(`平滑周期必须为 1-${MA_MAX_PERIOD} 的整数`)
+    smoothing = { kind: sKind, period: sPeriod }
+  }
+  const id = `${kind}${period}${source === 'close' ? '' : '-' + source}${smoothing ? `-${smoothing.kind}${smoothing.period}` : ''}`
+  const line = { id, kind, period, source, smoothing }
+  if (input.color != null) {
+    if (typeof input.color !== 'string' || !COLOR.test(input.color)) throw new Error('均线颜色必须为 #RRGGBB')
+    line.color = input.color.toLowerCase()
+  }
+  return line
+}
+
+/** Validate a whole set: at most MA_MAX_LINES, de-duplicated by id (last definition wins its slot). */
+export function normalizeMaLines(list) {
+  if (!Array.isArray(list)) throw new Error('均线列表无效')
+  const byId = new Map()
+  for (const item of list) { const line = normalizeMaLine(item); byId.set(line.id, line) }
+  if (byId.size > MA_MAX_LINES) throw new Error(`最多同时显示 ${MA_MAX_LINES} 条均线`)
+  return [...byId.values()]
+}
+
+/** "SMMA 7", "EMA 21 hl2", "SMA 20 · EMA 9". */
+export function maLabel(line) {
+  return `${line.kind.toUpperCase()} ${line.period}${line.source === 'close' ? '' : ' ' + line.source}${line.smoothing ? ` · ${line.smoothing.kind.toUpperCase()} ${line.smoothing.period}` : ''}`
+}
+
+function sourceOf(candle, source) {
+  const o = Number(candle.o), h = Number(candle.h), l = Number(candle.l), c = Number(candle.c)
+  switch (source) {
+    case 'open': return o
+    case 'high': return h
+    case 'low': return l
+    case 'hl2': return (h + l) / 2
+    case 'hlc3': return (h + l + c) / 3
+    case 'ohlc4': return (o + h + l + c) / 4
+    default: return c
+  }
+}
+
+/**
+ * One MA over a series that may start with nulls (e.g. the input of a smoothing pass).
+ * @param {Array<number|null>} values
+ * @param {string} kind
+ * @param {number} period
+ * @returns {Array<number|null>} aligned with `values`; null until enough data.
+ */
+export function movingAverage(values, kind, period) {
+  const out = new Array(values.length).fill(null)
+  const window = []
+  let prior = null
+  for (let i = 0; i < values.length; i += 1) {
+    const value = values[i]
+    if (value == null || !Number.isFinite(value)) { if (kind === 'sma' || kind === 'wma') window.length = 0; continue }
+    if (kind === 'sma' || kind === 'wma') {
+      window.push(value)
+      if (window.length > period) window.shift()
+      if (window.length < period) continue
+      if (kind === 'sma') out[i] = window.reduce((sum, v) => sum + v, 0) / period
+      else { let num = 0; for (let k = 0; k < period; k += 1) num += window[k] * (k + 1); out[i] = num / (period * (period + 1) / 2) }
+      continue
+    }
+    // ema / smma: seed with the SMA of the first `period` values, then recurse.
+    if (prior == null) {
+      window.push(value)
+      if (window.length < period) continue
+      prior = window.reduce((sum, v) => sum + v, 0) / period
+    } else {
+      const alpha = kind === 'ema' ? 2 / (period + 1) : 1 / period
+      prior = alpha * value + (1 - alpha) * prior
+    }
+    out[i] = prior
+  }
+  return out
+}
+
+/**
+ * Values of one normalized line over candles (ascending by time).
+ * @returns {{ values: Array<number|null>, smoothed: Array<number|null> | null }}
+ */
+export function maSeries(candles, line) {
+  const input = candles.map((candle) => { const v = sourceOf(candle, line.source); return Number.isFinite(v) ? v : null })
+  const values = movingAverage(input, line.kind, line.period)
+  const smoothed = line.smoothing ? movingAverage(values, line.smoothing.kind, line.smoothing.period) : null
+  return { values, smoothed }
+}
+
+/** Latest defined value of each line (and its smoothing) — what the agent reads. */
+export function maLatest(candles, lines) {
+  return lines.map((line) => {
+    const { values, smoothed } = maSeries(candles, line)
+    const last = (series) => { for (let i = series.length - 1; i >= 0; i -= 1) if (series[i] != null) return series[i]; return null }
+    return { id: line.id, label: maLabel(line), value: last(values), smoothed: smoothed ? last(smoothed) : null, line }
+  })
+}