dsh-hyperliquid 0.2.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

@@ -1,6 +1,6 @@
-export type DrawingKind = 'level' | 'hray' | 'vline' | 'text' | 'trend' | 'ray' | 'extended' | 'fib' | 'rect' | 'measure' | 'channel' | 'long' | 'short' | 'fibext' | 'fibchannel' | 'fibtime' | 'gannfan' | 'pitchfork' | 'regression' | 'arrow' | 'callout' | 'circle' | 'triangle' | 'brush' | 'crossline' | 'pricelabel' | 'infoline' | 'trendangle' | 'pricerange' | 'daterange' | 'elliott' | 'elliottabc' | 'xabcd' | 'abcd' | 'headshoulders' | 'gannbox' | 'gannsquare' | 'schiff' | 'modschiff' | 'icon'
+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 { color?: string; lineWidth?: number; lineStyle?: LineStyleName; locked?: boolean; hidden?: boolean; shared?: boolean; alert?: boolean }
+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>
@@ -21,3 +21,7 @@ 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

@@ -14,6 +14,8 @@ export const DRAWING_POINTS = {
   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.
@@ -44,6 +46,44 @@ 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). */
@@ -112,6 +152,11 @@ export function drawingGeometry(kind, request, now = Date.now()) {
   } 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)
@@ -141,6 +186,19 @@ export function drawingStyle(request) {
     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} 必须为布尔值`)

package/lib/remote.js

@@ -16,6 +16,9 @@ import { TradingGuard } from './trading-guard.js'
 import { normalizeMaLines } from './moving-average.js'
 import { ALERT_KINDS, ICON_NAMES, TEXT_KINDS, drawingGeometry, drawingStyle, isIconLabel, linePriceAt } from './chart-drawings.js'
 import { normalizeRiskSettings } from './risk-settings.js'
+import { INDICATOR_IDS, normalizeIndicatorSettings } from './studies.js'
+import { normalizeResearch } from './workspace-settings.js'
+import { fundingWindow } from './review.js'
 
 const TOOL_CALL = Symbol('verified DSH tool call')
 
@@ -482,6 +485,20 @@ export class HyperRemote extends TypertRemoteService {
     return maLines
   }
 
+  /** Agent sets what the session chart shows (interval, indicator panes); the desk follows on `chart.view`. */
+  setSessionChartView(sessionId, { interval, show = [], hide = [] } = {}) {
+    this.requireTradingSession(sessionId)
+    const unknown = [...show, ...hide].filter((id) => !INDICATOR_IDS.includes(id))
+    if (unknown.length) throw new Error(`未知指标 ${unknown.join(',')}，可选：${INDICATOR_IDS.join(', ')}`)
+    const current = this.store.getSessionWorkspace(sessionId)
+    const patch = { indicators: [...new Set([...(current.indicators ?? []).filter((id) => !hide.includes(id)), ...show])] }
+    if (interval != null) patch.interval = requireInterval(interval)
+    const next = this.store.updateSessionWorkspace(sessionId, patch)
+    if (this.desk?.sessionId === sessionId && patch.interval) this.desk.interval = patch.interval
+    this.store.recordEvent('chart.view', { sessionId, interval: next.interval, indicators: next.indicators })
+    return next
+  }
+
   /** Move, reshape, restyle or relabel one drawing; geometry is re-validated as a whole. */
   editChartMark(id, patch, sessionId) {
     this.requireTradingSession(sessionId)
@@ -492,7 +509,7 @@ export class HyperRemote extends TypertRemoteService {
     const fields = { ...drawingStyle({ ...patch, kind: current.kind }) }
     if (patch?.alert === true) fields.alertTriggeredAt = undefined
     // null clears a style back to its default (undo of a first restyle relies on this).
-    for (const key of ['color', 'lineWidth', 'lineStyle']) if (key in patch && patch[key] === null) fields[key] = undefined
+    for (const key of ['color', 'lineWidth', 'lineStyle', 'rows', 'valueArea']) if (key in patch && patch[key] === null) fields[key] = undefined
     if (geometryKeys.some((key) => key in patch)) Object.assign(fields, drawingGeometry(current.kind, merged))
     if ('label' in patch) {
       const label = String(patch.label ?? '').trim()
@@ -573,15 +590,22 @@ export class HyperRemote extends TypertRemoteService {
       patch.tapeTab = input.tapeTab
     }
     if ('bottomTab' in input) {
-      if (!['positions', 'orders', 'account'].includes(input.bottomTab)) throw new Error('账户页签无效')
+      if (!['positions', 'orders', 'account', 'review'].includes(input.bottomTab)) throw new Error('账户页签无效')
       patch.bottomTab = input.bottomTab
     }
     if ('indicators' in input) {
-      const allowed = ['volume', 'sma20', 'sma60', 'ema20', 'ema50', 'bollinger20', 'rsi14', 'macd']
+      const allowed = INDICATOR_IDS
       if (!Array.isArray(input.indicators) || input.indicators.length > allowed.length || input.indicators.some((id) => !allowed.includes(id))) throw new Error('图表指标无效')
       patch.indicators = [...new Set(input.indicators)]
     }
     if ('maLines' in input) patch.maLines = normalizeMaLines(input.maLines)
+    if ('indicatorSettings' in input) patch.indicatorSettings = normalizeIndicatorSettings(input.indicatorSettings)
+    if ('research' in input) patch.research = normalizeResearch(input.research)
+    if ('showDataWindow' in input) { if (typeof input.showDataWindow !== 'boolean') throw Error('数据窗口设置无效'); patch.showDataWindow = input.showDataWindow }
+    if ('chartType' in input) {
+      if (!['candles', 'bars', 'line', 'area', 'heikinAshi'].includes(input.chartType)) throw new Error('图表类型无效')
+      patch.chartType = input.chartType
+    }
     if ('priceScale' in input) {
       if (!['normal', 'log', 'percentage'].includes(input.priceScale)) throw new Error('价格刻度无效')
       patch.priceScale = input.priceScale
@@ -625,9 +649,30 @@ export class HyperRemote extends TypertRemoteService {
     return result
   }
 
+  async indicatorTemplates(request) {
+    const action = request?.action ?? 'list'
+    if (action === 'list') return { templates: this.store.indicatorTemplates() }
+    if (action === 'remove') { this.store.removeIndicatorTemplate(String(request?.id ?? '')); return { templates: this.store.indicatorTemplates() } }
+    if (action !== 'save') throw Error('指标模板操作无效')
+    const name = String(request?.name ?? '').trim()
+    if (!name || name.length > 60) throw Error('模板名称需要 1–60 个字符')
+    const indicators = request?.indicators
+    if (!Array.isArray(indicators) || indicators.length > INDICATOR_IDS.length || indicators.some((id) => !INDICATOR_IDS.includes(id))) throw Error('模板指标无效')
+    const id = request?.id
+    if (id != null && !this.store.indicatorTemplates().some((row) => row.id === id)) throw Error('指标模板不存在')
+    const template = this.store.saveIndicatorTemplate({ id, name, indicators: [...new Set(indicators)], indicatorSettings: normalizeIndicatorSettings(request?.indicatorSettings), maLines: normalizeMaLines(request?.maLines ?? []) })
+    return { template, templates: this.store.indicatorTemplates() }
+  }
+
+  async updatePaperCosts(request) {
+    if (this.activeTradeOps > 0) throw Error('交易操作仍在进行，请稍后修改模拟成本')
+    return { paperCosts: this.store.setPaperCosts(request?.costs) }
+  }
+
   async drawChartMark(request) {
     const sessionId = String(request?.sessionId ?? '')
-    return this.addChartMark(request, sessionId, 'user')
+    // Undo re-creates a deleted agent drawing; keep its origin so the chart still labels it as the agent's.
+    return this.addChartMark(request, sessionId, request?.restoreSource === 'agent' ? 'agent' : 'user')
   }
 
   async eraseChartMark(request) {
@@ -722,6 +767,7 @@ export class HyperRemote extends TypertRemoteService {
     const address = await this.resolveAddress()
     const wallet = this.cfg.signer === 'web3' ? this.walletService() : null
     return {
+      paperCosts: this.store.paperCosts?.() ?? { feeBps: 4.5, slippageBps: 5 },
       network: this.cfg.network,
       tradingMode: this.cfg.tradingMode,
       signer: this.cfg.signer,
@@ -832,7 +878,7 @@ export class HyperRemote extends TypertRemoteService {
         marginUsed: risk.marksConfirmed ? risk.marginUsed : null,
         availableMargin: risk.marksConfirmed ? Math.max(0, risk.equity - risk.marginUsed) : null,
         marksConfirmed: risk.marksConfirmed, positions: risk.positions, fills: paper.fills.slice(0, 50),
-        simulation: '固定滑点；未模拟盘口深度、手续费、资金费或强平' }
+        simulation: '已模拟配置的滑点与手续费；未模拟盘口深度、资金费或强平' }
     }
     const address = await this.resolveAddress()
     if (!address) throw new Error('live 模式需要钱包（config.privateKey 或 signer=web3）')
@@ -926,25 +972,45 @@ export class HyperRemote extends TypertRemoteService {
 
   /** Explicitly loaded history: these weighted API calls must not join the 3s account poll. */
   async tradeHistory(request) {
-    if (this.cfg.tradingMode === 'paper') {
+    const client = this.client, mode = this.cfg.tradingMode, network = this.cfg.network
+    if (request?.days != null && ![7, 30, 90].includes(request.days)) throw Error('复盘支持最近 7/30/90 天')
+    const end = Date.now(), requestedStart = request?.days != null ? end - request.days * 86_400_000 : request?.startTime == null ? null : Number(request.startTime)
+    if (requestedStart != null && (!Number.isFinite(requestedStart) || requestedStart < end - 90 * 86_400_000 || requestedStart >= end)) throw Error('复盘时间范围必须在最近 90 天内')
+    const start = requestedStart ?? Math.max(0, end - 30 * 86_400_000)
+    let result
+    if (mode === 'paper') {
       const paper = this.store.paperAccount()
-      return { mode: 'paper', orders: paper.orders.slice(0, 200), fills: paper.fills.slice(0, 200) }
+      result = { mode: 'paper', orders: paper.orders.slice(0, 5000), fills: paper.fills.slice(0, 5000), paperCosts: this.store.paperCosts(), funding: [],
+        coverage: { fundingStatus: 'not-simulated', fillsLimited: paper.fills.length >= 200, ordersLimited: paper.orders.length >= 200 } }
+    } else {
+      const address = await this.resolveAddress()
+      if (!address) throw Error('未配置交易主账户地址')
+      const [orders, fills] = await Promise.all([client.historicalOrders(address), client.userFills(address)])
+      if (!Array.isArray(orders) || !Array.isArray(fills)) throw Error('交易所历史数据响应无效')
+      const decisions = this.store.liveDecisions ?? {}
+      const rows = orders.slice(0, 2000).map((entry) => {
+        const order = entry.order ?? entry, local = this.store.liveOrders?.[order.cloid], decision = decisions[local?.decisionId]
+        return { ...order, status: entry.status ?? local?.status ?? 'unknown', statusTimestamp: entry.statusTimestamp,
+          referencePx: decision?.preview?.mid ?? null,
+          reason: local?.thesis ?? decision?.thesis ?? null, sessionId: local?.sessionId ?? decision?.sessionId ?? null }
+      })
+      result = { mode: 'live', orders: rows, fills: fills.slice(0, 2000), funding: [],
+        coverage: { fundingStatus: 'not-requested', fillsLimited: fills.length >= 2000, ordersLimited: orders.length >= 2000 },
+        localOrders: Object.entries(this.store.liveOrders ?? {}).map(([cloid, row]) => ({ cloid, coin: row.coin, status: row.status, at: row.updatedAt ?? row.at, sessionId: row.sessionId })) }
+      if (request?.includeFunding) {
+        try {
+          const funding = await fundingWindow(client, address, start, end)
+          result.funding = funding.rows
+          result.coverage.fundingStatus = funding.status
+        } catch (error) { result.coverage.fundingStatus = 'error'; result.coverage.fundingError = String(error?.message ?? error) }
+      }
     }
-    const address = await this.resolveAddress()
-    if (!address) throw new Error('未配置交易主账户地址')
-    const [orders, fills] = await Promise.all([
-      this.client.historicalOrders(address), this.client.userFills(address),
-    ])
-    if (!Array.isArray(orders) || !Array.isArray(fills)) throw new Error('交易所历史数据响应无效')
-    const localByCloid = this.store.liveOrders
-    const decisions = this.store.liveDecisions
-    return { mode: 'live', orders: orders.slice(0, 2000).map((entry) => {
-      const order = entry.order ?? entry
-      const local = localByCloid[order.cloid]
-      return { ...order, status: entry.status ?? local?.status ?? 'unknown', statusTimestamp: entry.statusTimestamp,
-        reason: local?.thesis ?? (local?.decisionId ? decisions[local.decisionId]?.thesis ?? null : null),
-        sessionId: local?.sessionId ?? (local?.decisionId ? decisions[local.decisionId]?.sessionId ?? null : null) }
-    }), fills: fills.slice(0, 2000) }
+    if (requestedStart != null) {
+      result.fills = result.fills.filter((row) => Number(row.time) >= start && Number(row.time) <= end)
+      const ids = new Set(result.fills.filter((row) => row.oid != null).map((row) => `${row.coin}:${row.oid}`))
+      result.orders = result.orders.filter((row) => Number(row.timestamp ?? row.time) >= start || ids.has(`${row.coin}:${row.oid}`))
+    }
+    return { ...result, network, observedAt: Date.now(), coverage: { ...result.coverage, startTime: start, endTime: end, bounded: true } }
   }
 
   /** Hyperliquid portfolio samples are display data, not an accounting ledger. */
@@ -953,7 +1019,10 @@ export class HyperRemote extends TypertRemoteService {
       const account = await this.account({})
       const fills = this.store.paperAccount().fills
       return { mode: 'paper', equity: account.equity, unrealizedPnl: account.uPnl,
-        realizedPnl: fills.reduce((sum, fill) => sum + Number(fill.realized ?? 0), 0), series: {} }
+        realizedPnl: fills.reduce((sum, fill) => sum + Number(fill.realized ?? 0), 0),
+        fees: fills.reduce((sum, fill) => sum + Number(fill.fee ?? 0), 0),
+        netRealizedPnl: fills.some((fill) => fill.fee == null) ? null : fills.reduce((sum, fill) => sum + Number(fill.realized ?? 0) - Number(fill.fee), 0),
+        retainedFills: fills.length, series: {} }
     }
     const address = await this.resolveAddress()
     if (!address) throw new Error('未配置交易主账户地址')
@@ -1142,30 +1211,32 @@ export class HyperRemote extends TypertRemoteService {
         if (!Number.isFinite(limit) || limit <= 0) throw new Error('限价单需要有效 px')
         if ((isBuy && limit < mid) || (!isBuy && limit > mid)) throw new Error('paper 当前只支持可立即成交的限价单')
       }
-      const slip = Number(request?.slippagePct)
-      const pct = Number.isFinite(slip) ? Math.min(Math.max(slip, 0), 10) / 100 : 0.0005
+      const costs = this.store.paperCosts()
+      const slip = request?.slippagePct == null ? null : Number(request.slippagePct)
+      const pct = slip != null && Number.isFinite(slip) ? Math.min(Math.max(slip, 0), 10) / 100 : costs.slippageBps / 10_000
       const px = mid * (isBuy ? 1 + pct : 1 - pct)
       if (request?.type === 'limit' && (isBuy ? px > Number(request.px) : px < Number(request.px))) throw new Error('paper 模拟滑点后无法满足限价')
       const paper = this.store.paperAccount()
-      const risk = paperRiskState(paper, { ...await safeMids(this), [coin]: px }, true)
+      const risk = paperRiskState(paper, { ...await safeMids(this), [coin]: mid }, true)
       const positionSize = Number(paper.positions[coin]?.size ?? 0)
       const leverage = Number(paper.positions[coin]?.leverage ?? paper.leverageByCoin?.[coin] ?? 1)
       const otherExposureUsd = risk.positions.reduce((sum, p) => sum + (p.coin === coin ? 0 : Math.abs(p.size) * p.markPx), 0)
       const guard = this.paperGuard ??= new TradingGuard(this.cfg.dataDir, { ...this.cfg, dataDir: this.cfg.dataDir }, { budgetName: this.cfg.network === 'mainnet' ? 'paper-budget-mainnet.json' : 'paper-budget.json' })
       const checked = guard.validate({ coin, isBuy, sz, price: px, positionSize, otherExposureUsd, accountValue: risk.equity, leverage, reduceOnly })
-      const currentMargin = Math.abs(positionSize) * px / leverage
-      const projectedMargin = risk.marginUsed - currentMargin + Math.abs(checked.nextSize) * px / leverage
-      if (!checked.riskReducing && projectedMargin > risk.equity + 1e-8) throw new Error('模拟账户可用保证金不足')
+      const currentMargin = Math.abs(positionSize) * mid / leverage
+      const projectedMargin = risk.marginUsed - currentMargin + Math.abs(checked.nextSize) * mid / leverage
+      const projectedEquity = risk.equity - checked.notionalUsd * costs.feeBps / 10_000 - sz * (isBuy ? px - mid : mid - px)
+      if (!checked.riskReducing && projectedMargin > projectedEquity + 1e-8) throw new Error('模拟账户可用保证金不足')
       const budgetTicket = guard.reserve(checked.notionalUsd, { riskReducing: checked.riskReducing })
       let fill
       const sessionId = request?.[TOOL_CALL]?.sessionId ?? null
-      try { fill = this.store.paperFill({ coin, isBuy, sz, px, reason: request?.reason ?? 'chat', sessionId }) }
+      try { fill = this.store.paperFill({ coin, isBuy, sz, px, reason: request?.reason ?? 'chat', sessionId, feeBps: costs.feeBps, referencePx: mid, slippageBps: pct * 10_000 }) }
       catch (err) { guard.release(budgetTicket); throw err }
-      this.store.paperOrderRecord({ coin, isBuy, sz, px: request?.type === 'limit' ? Number(request.px) : px,
+      this.store.paperOrderRecord({ oid: fill.oid, referencePx: mid, coin, isBuy, sz, px: request?.type === 'limit' ? Number(request.px) : px,
         filledPx: px, type: request?.type === 'limit' ? 'limit' : 'market', reduceOnly,
         reason: request?.reason ?? '', sessionId })
-      return { mode: 'paper', fill, marginUsed: projectedMargin, availableMargin: Math.max(0, risk.equity - projectedMargin),
-        simulation: '固定滑点；未模拟盘口深度、手续费、资金费或强平' }
+      return { mode: 'paper', fill, marginUsed: projectedMargin, availableMargin: Math.max(0, projectedEquity - projectedMargin),
+        simulation: '已模拟配置的滑点与手续费；未模拟盘口深度、资金费或强平' }
     }
     // live
     const trusted = request?.[TOOL_CALL]
@@ -1486,7 +1557,7 @@ function paperRiskState(paper, mids, strict = false) {
 
 // Remote markers: every method the web client may call.
 for (const m of [
-  'status', 'switchNetwork', 'switchTradingMode', 'updateRiskSettings', 'resetRiskSettings', 'markets', 'marketCatalog', 'marketDetail', 'chartMarks', 'drawChartMark', 'updateChartMark', 'eraseChartMark', 'sessionWorkspace', 'updateSessionWorkspace', 'snapshot', 'candles', 'fundingHistory', 'account', 'fills', 'tradeHistory', 'portfolio',
+  'indicatorTemplates', 'updatePaperCosts', 'status', 'switchNetwork', 'switchTradingMode', 'updateRiskSettings', 'resetRiskSettings', 'markets', 'marketCatalog', 'marketDetail', 'chartMarks', 'drawChartMark', 'updateChartMark', 'eraseChartMark', 'sessionWorkspace', 'updateSessionWorkspace', 'snapshot', 'candles', 'fundingHistory', 'account', 'fills', 'tradeHistory', 'portfolio',
   'sessions', 'registerSession', 'removeSession', 'bindCoin', 'deskState',
   'eventsSince',
 ]) {

package/lib/review.d.ts

@@ -0,0 +1,3 @@
+export interface ReviewRecord { id: string; coin: string; oid: string | number | null; time: number | null; px: number | null; size: number | null; isBuy: boolean | null; gross: number | null; fee: number | null; feeToken: string; net: number | null; reference: number | null; slippageBps: number | null; closedSize: number | null; reason: string; sessionId: string | null; flags: string[]; source: string }
+export declare function fundingWindow(client: any, address: string, startTime: number, endTime: number): Promise<{rows: any[]; status: string; pages: number}>
+export declare function reviewLedger(payload: any, coin?: string): { records: ReviewRecord[]; orders: any[]; duplicates: number; fees: Record<string, number>; gross: number | null; tradingNet: number | null; funding: number | null; net: number | null; closeCount: number; missingReasons: number; unmatched: number; gaps: number; unsupported: number }

package/lib/review.js

@@ -0,0 +1,79 @@
+/** Evidence over a bounded history window; missing fields remain unknown. No balance inference. */
+const numeric = (value) => value == null || value === '' || !Number.isFinite(Number(value)) ? null : Number(value)
+const key = (row) => row?.oid == null || !row.coin ? null : `${row.coin}:${String(row.oid)}`
+const core = (coin) => typeof coin === 'string' && coin.trim().length > 0 && !coin.startsWith('#') && !coin.includes(':') && !coin.startsWith('@') && !coin.includes('/')
+export async function fundingWindow(client, address, startTime, endTime) {
+  const rows = [], seen = new Set(); let cursor = startTime, partial = false
+  for (let page = 0; page < 12; page++) {
+    const result = await client.info('userFunding', { user: address, startTime: cursor, endTime })
+    if (!Array.isArray(result)) throw Error('资金费历史响应无效')
+    const valid = result.filter((row) => Number.isFinite(Number(row.time)) && Number(row.time) >= cursor && Number(row.time) <= endTime && row.delta?.type === 'funding')
+    if (valid.length !== result.length) partial = true
+    for (const row of valid) {
+      const id = `${row.time}:${row.hash ?? ''}:${row.delta.coin}:${row.delta.usdc}`
+      if (!seen.has(id)) { seen.add(id); rows.push(row) }
+    }
+    if (result.length < 500) return { rows, status: partial ? 'partial' : 'complete', pages: page + 1 }
+    const last = Math.max(...valid.map((row) => Number(row.time)))
+    if (!Number.isFinite(last) || last <= cursor) return { rows, status: 'partial', pages: page + 1 }
+    // Inclusive boundary: repeat the final timestamp and deduplicate, avoiding lost peers.
+    cursor = last
+  }
+  return { rows, status: 'partial', pages: 12 }
+}
+export function reviewLedger(payload, coin = '') {
+  const orders = (payload.orders ?? []).filter((row) => !coin || row.coin === coin)
+  const allFills = (payload.fills ?? []).filter((row) => !coin || row.coin === coin)
+  const byOrder = new Map(orders.filter((row) => key(row)).map((row) => [key(row), row]))
+  const seen = new Set(), records = []; let duplicates = 0
+  for (const [index, fill] of allFills.entries()) {
+    const id = fill.tid != null ? `${fill.coin}:${fill.tid}` : payload.mode === 'paper' && fill.oid ? `${fill.coin}:${fill.oid}` : `unidentified:${index}`
+    if (seen.has(id)) { duplicates++; continue } seen.add(id)
+    const order = byOrder.get(key(fill)), pnl = numeric(fill.closedPnl ?? fill.realized), fee = numeric(fill.fee)
+    const feeToken = String(fill.feeToken ?? '').trim()
+    const px = numeric(fill.px), size = numeric(fill.sz), buy = typeof fill.isBuy === 'boolean' ? fill.isBuy : fill.side === 'B' ? true : fill.side === 'A' ? false : null
+    const reference = numeric(fill.referencePx ?? order?.referencePx)
+    const reason = fill.reason || order?.reason || ''
+    const closed = numeric(fill.closedSize) ?? (buy != null && numeric(fill.startPosition) != null && Math.sign(Number(fill.startPosition)) !== (buy ? 1 : -1) ? Math.min(Math.abs(Number(fill.startPosition)), size ?? 0) : /^Close/.test(fill.dir ?? '') ? size : null)
+    const eligible = core(fill.coin) && feeToken === 'USDC'
+    const net = eligible && pnl != null && fee != null ? pnl - fee : null
+    const flags = []
+    if (!order) flags.push('unmatched-order')
+    if (px == null || px <= 0) flags.push('missing-price')
+    if (size == null || size <= 0) flags.push('missing-size')
+    if (numeric(fill.time) == null) flags.push('missing-time')
+    if (buy == null) flags.push('missing-side')
+    if (!reason || /^(session:|tool$|chat$|order$)/.test(reason)) flags.push('missing-reason')
+    if (fee == null || !feeToken) flags.push('missing-fee')
+    if (pnl == null) flags.push('missing-pnl')
+    if (fill.tid == null && payload.mode !== 'paper') flags.push('missing-trade-id')
+    records.push({ id, coin: fill.coin, oid: fill.oid ?? null, time: numeric(fill.time), px, size, isBuy: buy, gross: pnl, fee, feeToken, net,
+      reference, slippageBps: reference && reference > 0 && px && buy != null ? (buy ? px - reference : reference - px) / reference * 10_000 : null,
+      closedSize: closed, reason: flags.includes('missing-reason') ? '' : reason, sessionId: fill.sessionId ?? order?.sessionId ?? null, flags, source: payload.mode })
+  }
+  const reconciled = orders.map((order) => {
+    const fills = records.filter((row) => key(row) && key(row) === key(order))
+    const filled = fills.reduce((sum, row) => sum + (row.size ?? 0), 0)
+    const expected = numeric(order.origSz ?? order.sz), tolerance = Math.max(1e-8, (expected ?? 0) * 1e-6)
+    const status = fills.some((row) => row.flags.includes('missing-size')) ? 'missing-size' : /filled/i.test(order.status ?? '') && expected != null && Math.abs(filled - expected) > tolerance ? 'size-gap'
+      : expected != null && filled > expected + tolerance ? 'excess-fill' : fills.length ? 'matched' : 'no-fill-in-window'
+    return { coin: order.coin, oid: order.oid ?? null, status, filled, expected, exchangeStatus: order.status ?? 'unknown', reason: order.reason ?? '' }
+  })
+  const supported = records.filter((row) => core(row.coin))
+  const fees = {}; for (const row of records) if (row.fee != null && row.feeToken) fees[row.feeToken] = (fees[row.feeToken] ?? 0) + row.fee
+  const supportedScope = !coin || core(coin)
+  const gross = supportedScope ? supported.reduce((sum, row) => sum + (row.gross ?? 0), 0) : null
+  const tradingNet = !supportedScope || supported.some((row) => row.net == null) ? null : supported.reduce((sum, row) => sum + row.net, 0)
+  const fundingRows = (payload.funding ?? []).filter((row) => core(row.delta?.coin) && (!coin || row.delta.coin === coin))
+  const funding = supportedScope && payload.coverage?.fundingStatus === 'complete' && fundingRows.every((row) => numeric(row.delta.usdc) != null)
+    ? fundingRows.reduce((sum, row) => sum + Number(row.delta.usdc), 0) : null
+  const closes = supported.filter((row) => row.closedSize > 0)
+  return { records, orders: reconciled, duplicates, fees, gross, tradingNet, funding,
+    net: tradingNet != null && funding != null ? tradingNet + funding : null,
+    closeCount: closes.length,
+    missingReasons: records.filter((row) => row.flags.includes('missing-reason')).length,
+    unmatched: records.filter((row) => row.flags.includes('unmatched-order')).length,
+    gaps: reconciled.filter((row) => ['size-gap', 'excess-fill'].includes(row.status)).length,
+    unsupported: records.length - supported.length,
+  }
+}

package/lib/store.js

@@ -9,14 +9,18 @@ import { readFileSync, writeFileSync, renameSync, mkdirSync, existsSync, rmSync,
 import { dirname, join } from 'node:path'
 import { randomUUID, createHash } from 'node:crypto'
 import { canonicalMarketCoin } from './market-symbol.js'
+import { normalizePaperCosts } from './workspace-settings.js'
 
 const PAPER_START_USD = 100_000
 const WORKSPACE_DEFAULTS = Object.freeze({
   interval: '15m', bookGrouping: 'full', chartTab: 'chart', tapeTab: 'book', bottomTab: 'positions', indicators: ['volume'], maLines: [],
-  priceScale: 'normal', chartRanges: {}, chartLayers: { orders: true, fills: true, drawings: true },
+  priceScale: 'normal', chartType: 'candles', chartRanges: {}, chartLayers: { orders: true, fills: true, drawings: true },
   layout: { sessionsWidth: 232, chatWidth: 480, sessionsCollapsed: false, deskCollapsed: false, chatCollapsed: false },
 })
 
+/** Drawings per chart (session + coin, all intervals); the pan budget is verified at this size. */
+export const MAX_CHART_MARKS = 100
+
 export class HyperStore {
   constructor(dataDir, paperNetwork = 'testnet') {
     this.dataDir = dataDir
@@ -255,8 +259,9 @@ export class HyperStore {
   }
 
   addChartMark(mark) {
-    const related = this.listChartMarks(mark.sessionId, mark.coin, mark.interval)
-    if (related.length >= 30) throw new Error('当前图表最多保留 30 条标注，请先删除旧线')
+    // The chart shows a coin's drawings from every interval, so the cap counts them all.
+    const related = this.listChartMarks(mark.sessionId, mark.coin)
+    if (related.length >= MAX_CHART_MARKS) throw new Error(`当前图表最多保留 ${MAX_CHART_MARKS} 条标注，请先删除旧线`)
     const marks = mark.shared ? this.#shared() : this.#marks(mark.sessionId)
     if (marks.length >= 300) throw new Error('当前会话最多保留 300 条图表标注，请先删除旧线')
     const saved = { ...mark, id: randomUUID(), createdAt: Date.now() }
@@ -328,16 +333,39 @@ export class HyperStore {
     return JSON.parse(JSON.stringify(this.paper))
   }
 
+  paperCosts() {
+    const file = join(this.dataDir, 'paper-costs.json')
+    return normalizePaperCosts(existsSync(file) ? JSON.parse(readFileSync(file, 'utf8')) : undefined)
+  }
+  setPaperCosts(input) {
+    const costs = normalizePaperCosts(input)
+    this.#writeJson(join(this.dataDir, 'paper-costs.json'), costs)
+    return costs
+  }
+  indicatorTemplates() { return this.#readJson(join(this.dataDir, 'indicator-templates.json'), []) }
+  saveIndicatorTemplate(template) {
+    const rows = this.indicatorTemplates()
+    if (!rows.some((row) => row.id === template.id) && rows.length >= 20) throw Error('最多保存 20 个指标模板')
+    const next = { ...template, id: template.id || randomUUID(), updatedAt: Date.now() }
+    this.#writeJson(join(this.dataDir, 'indicator-templates.json'), [...rows.filter((row) => row.id !== next.id), next])
+    return next
+  }
+  removeIndicatorTemplate(id) {
+    this.#writeJson(join(this.dataDir, 'indicator-templates.json'), this.indicatorTemplates().filter((row) => row.id !== id))
+  }
+
   /**
    * Fill a paper order against the given mid with a simple slippage model.
    * @returns the fill record
    */
-  paperFill({ coin, isBuy, sz, px, time = Date.now(), reason = 'order', sessionId = null }) {
+  paperFill({ coin, isBuy, sz, px, time = Date.now(), reason = 'order', sessionId = null, feeBps = 0, referencePx = null, slippageBps = null }) {
     const szNum = Number(sz)
     const pxNum = Number(px)
     if (!Number.isFinite(szNum) || szNum <= 0) throw new Error('paper: 无效数量')
     if (!Number.isFinite(pxNum) || pxNum <= 0) throw new Error('paper: 无效价格')
     const notional = szNum * pxNum
+    if (!Number.isFinite(feeBps) || feeBps < 0 || feeBps > 100) throw Error('paper: 无效手续费')
+    const fee = notional * feeBps / 10_000
     const pos = this.paper.positions[coin] ?? { size: 0, entryPx: pxNum, leverage: this.paper.leverageByCoin?.[coin] ?? 1 }
     const signed = isBuy ? szNum : -szNum
     const prevSize = pos.size
@@ -360,11 +388,13 @@ export class HyperStore {
       pos.size = newSize
       this.paper.positions[coin] = pos
     }
-    this.paper.usd += realized // realized PnL settles into cash; margin tracked conceptually
+    this.paper.usd += realized - fee
     // sessionId: the trading conversation whose decision produced this fill.
-    const fill = { coin, isBuy, sz: szNum, px: pxNum, notional, realized, time, reason, sessionId }
+    const fill = { oid: `paper-${randomUUID()}`, coin, isBuy, sz: szNum, px: pxNum, notional, realized, closedPnl: realized,
+      fee, feeToken: 'USDC', netPnl: realized - fee, feeBps, referencePx, slippageBps,
+      closedSize: Math.min(Math.abs(prevSize), Math.sign(prevSize) !== Math.sign(signed) ? szNum : 0), startPosition: prevSize, time, reason, sessionId }
     this.paper.fills.unshift(fill)
-    if (this.paper.fills.length > 200) this.paper.fills.length = 200
+    if (this.paper.fills.length > 5000) this.paper.fills.length = 5000
     this.#writeJson(this.paperFile, this.paper)
     this.recordEvent('paper.fill', fill)
     return fill
@@ -373,7 +403,7 @@ export class HyperStore {
   paperOrderRecord(order) {
     const row = { ...order, time: Date.now(), status: 'filled' }
     this.paper.orders.unshift(row)
-    if (this.paper.orders.length > 200) this.paper.orders.length = 200
+    if (this.paper.orders.length > 5000) this.paper.orders.length = 5000
     this.#writeJson(this.paperFile, this.paper)
     this.recordEvent('paper.order', row)
   }

package/lib/studies.d.ts

@@ -0,0 +1,13 @@
+export interface IndicatorSettings {
+  rsi: { period: number; lower: number; upper: number }
+  macd: { fast: number; slow: number; signal: number }
+  bollinger: { period: number; multiplier: number }
+  stochastic: { period: number; smoothK: number; smoothD: number; lower: number; upper: number }
+  adx: { period: number; smoothing: number }
+}
+export type StudyKey = 'sma20' | 'sma60' | 'ema20' | 'ema50' | 'basis' | 'upper' | 'lower' | 'rsi14' | 'macd' | 'signal' | 'histogram' | 'atr14' | 'vwap' | 'stochK' | 'stochD' | 'adx' | 'plusDI' | 'minusDI' | 'obv'
+export declare const INDICATOR_IDS: string[]
+export declare const DEFAULT_INDICATOR_SETTINGS: IndicatorSettings
+export declare function normalizeIndicatorSettings(input?: unknown): IndicatorSettings
+export declare function computeStudies(candles: readonly {t: number; o: number; h: number; l: number; c: number; v: number}[], input?: IndicatorSettings): Record<StudyKey, Array<{ time: number; value: number }>>
+export declare function studyDefinitions(input?: IndicatorSettings): Array<[string, StudyKey, string]>