desic-okx-agent 0.2.0 → 0.3.0

package/dist/i18n/messages.js

@@ -0,0 +1,660 @@
+/**
+ * User-facing strings for the CLI and shell.
+ *
+ * Only presentation is translated. Tool names, field names, run ids, and error
+ * codes stay in English so a copied message still matches the API and the
+ * documentation, and so a bug report reads the same in any locale.
+ */
+export const LOCALES = ["en", "zh"];
+export function isLocale(value) {
+    return LOCALES.includes(value);
+}
+const en = {
+    bannerTitle: "Desic OKX · strategy research",
+    bannerHints: "/help for commands   tab completes   ↑ recalls   /exit leaves",
+    clearHint: "ctrl+c clears the line",
+    exitHint: "ctrl+c again to exit",
+    pythonNotFound: "python not found",
+    instrumentsWithHistory: (count) => `${count} instrument(s) with local history`,
+    working: "working",
+    cancelHint: "esc to cancel",
+    argumentsAsked: "Arguments you leave out are asked for.",
+    unknownCommand: (name) => `Unknown command '${name}'.`,
+    didYouMean: (name) => ` Did you mean /${name}?`,
+    seeHelp: " Type /help to see what is available.",
+    noCommandNamed: (name) => `No command named '${name}'.`,
+    needsTerminal: "The interactive shell needs a terminal. Use 'desic-okx <command>' for scripted use.",
+    needsUiPackages: "The interactive shell needs its UI packages. Install them with: npm install -g ink react",
+    noLocalHistory: "No local one-minute history yet.",
+    tryDownload: "Try: /download BTC-USDT-SWAP 30",
+    readingCoverage: "reading local coverage",
+    requestingHistory: (instId, days) => `${instId}  requesting ${days} day(s) of one-minute history`,
+    daysMustBePositive: "Days must be a positive number, for example: /download BTC-USDT-SWAP 30",
+    instrumentColumn: "INSTRUMENT",
+    fromColumn: "FROM",
+    toColumn: "TO",
+    barsColumn: "BARS",
+    gapsColumn: "GAPS",
+    gapsNone: "none",
+    coverageRange: "Range",
+    coverageStored: (count) => `${count} one-minute bars`,
+    coverageMissing: (bars, gaps) => `${bars} bars in ${gaps} gaps`,
+    coverageMissingNone: "none",
+    coverageUpdated: "Updated",
+    coverageExchangeEnd: "Exchange end",
+    coverageGaps: "Gaps",
+    coverageMore: (count) => `… ${count} more`,
+    syncRange: "range",
+    syncExpected: "expected",
+    syncElapsed: "elapsed",
+    syncNoEarlierData: (time) => `OKX has no data before ${time} UTC`,
+    giveFileNew: "Give a file name: /new strategy.py [template]",
+    giveFileValidate: "Give a file: /validate strategy.py",
+    giveFileBacktest: "Give a file: /backtest strategy.py [instrument] [days]",
+    giveRunId: (command) => `Give a run id: /${command} bt_abc123`,
+    unknownTemplate: (name, available) => `Unknown template '${name}'. Available: ${available}`,
+    fileExists: (file) => `${file} already exists. Choose another name so nothing is overwritten.`,
+    fileMissing: (file) => `${file} does not exist.`,
+    wroteTemplate: (name, file) => `Wrote the ${name} template to ${file}`,
+    nextValidate: (file) => `Next: /validate ${file}`,
+    validating: (file) => `validating ${file}`,
+    policyPassed: "source policy passed",
+    policyViolations: (count) => `${count} violation(s)`,
+    violationLine: (line, message) => `line ${line}  ${message}`,
+    backtestConfig: (file, instId, days) => `${file}  ${instId}  last ${days} day(s)`,
+    backtestWindow: (file, instId, window) => `${file}  ${instId}  ${window}`,
+    requestingWindow: (instId, window) => `${instId}  requesting ${window}`,
+    backtestSettings: (equity, leverage, preload) => `${equity} USDT · ${leverage}x · ${preload} preload bars`,
+    queuing: (instId) => `${instId}  queuing`,
+    noRuns: "No strategy runs yet.",
+    runsHint: "desic-okx strategy backtest --file strategy.py --inst BTC-USDT-SWAP",
+    forCurveAndTrades: (runId) => `/report ${runId}  for the equity curve and trades`,
+    cancelled: (runId) => `Cancelled ${runId}`,
+    deleteConfirm: (runId) => `This removes ${runId} and its stored series. Repeat with --yes to confirm.`,
+    deleted: (runId) => `Deleted ${runId}`,
+    alreadyFinished: (runId) => `${runId} was already finished.`,
+    statusLabel: "Status",
+    barsLabel: "Bars",
+    includingPreloaded: (count) => `including ${count} preloaded`,
+    snapshotLabel: "Snapshot",
+    etaLabel: "ETA",
+    elapsedLabel: "Elapsed",
+    errorLabel: "Error",
+    performance: "Performance",
+    netProfit: "net profit",
+    returnLabel: "return",
+    annualized: "annualized",
+    annualizedWithheld: (days) => `needs ${days}+ days of data`,
+    maxDrawdown: "max drawdown",
+    drawdownRecovery: "longest drawdown",
+    riskAdjusted: "Risk adjusted",
+    sharpeLabel: "sharpe",
+    sortinoLabel: "sortino",
+    calmarLabel: "calmar",
+    activity: "Activity",
+    tradesLabel: "trades",
+    longShort: (long, short) => `${long} long / ${short} short`,
+    winRate: "win rate",
+    profitFactor: "profit factor",
+    netOfFees: "net of fees",
+    expectancy: "expectancy",
+    averageWinLoss: "avg win / loss",
+    largestWinLoss: "best / worst",
+    streaks: "streaks",
+    holdingTime: "avg holding",
+    costs: "Costs",
+    feesLabel: "fees",
+    feesOfGross: "of gross PnL",
+    turnover: "turnover",
+    exposure: "exposure",
+    tradesPerDay: "trades/day",
+    marginExhaustedWarning: "Margin was exhausted during this run.",
+    marginExhaustedDetail: "That is a research risk boundary, not an OKX liquidation estimate.",
+    reportOpened: "Report opened in your browser.",
+    reportWritten: "Report written (could not open a browser).",
+    hoverPrompt: "hover or use arrow keys for values",
+    hoverTime: "Time",
+    hoverEquity: "Equity",
+    hoverChange: "Change",
+    hoverDrawdown: "Drawdown",
+    settingsTitle: "Backtest settings",
+    settingsHint: "↑↓ move   ⏎ edit or toggle   r reset   s save   esc cancel",
+    settingsUnsaved: "unsaved changes — press s to save",
+    settingsSaved: "Settings saved. They apply to every backtest from now on.",
+    settingsCancelled: "Cancelled. Nothing was changed.",
+    settingsDefaultIs: "default",
+    settingsHeading: "Settings",
+    settingsHintCommand: "/backtest setting  to change these",
+    assumptionsHeading: "Assumptions",
+    settingEquity: "Initial equity",
+    settingEquityHelp: "Starting balance in USDT. Position sizes are derived from equity, so this scales every trade.",
+    settingLeverage: "Leverage",
+    settingLeverageHelp: "Multiplies the entry budget into notional exposure. 10x on a 20% budget is 2x account notional.",
+    settingMarginSafety: "Margin safety",
+    settingMarginSafetyHelp: "Reserves this multiple of the required margin. Above 1 makes margin exhaustion less likely.",
+    settingBudgetPct: "Budget per entry",
+    settingBudgetPctHelp: "Share of current equity committed per entry. Compounds: gains raise later position sizes.",
+    settingBudgetUsdt: "Fixed budget",
+    settingBudgetUsdtHelp: "Fixed USDT per entry, overriding the percentage. Zero means use the percentage.",
+    settingTakerFee: "Taker fee",
+    settingTakerFeeHelp: "Charged on market fills. OKX standard is 5 bps; a VIP tier is lower.",
+    settingMakerFee: "Maker fee",
+    settingMakerFeeHelp: "Charged on limit fills. OKX standard is 2 bps.",
+    settingEntrySlippage: "Entry slippage",
+    settingEntrySlippageHelp: "Adverse price applied to every entry, in basis points.",
+    settingExitSlippage: "Exit slippage",
+    settingExitSlippageHelp: "Adverse price applied to every exit, in basis points.",
+    settingPreload: "Preload bars",
+    settingPreloadHelp: "Confirmed bars loaded before the evaluation start, for indicator warm-up. Excluded from results.",
+    settingDays: "Evaluation days",
+    settingDaysHelp: "Default trailing window when no explicit range is given.",
+    settingCloseAtEnd: "Close at end",
+    settingCloseAtEndHelp: "Flattens any open position on the final bar, so the result excludes an unrealized position.",
+    monthlyHeading: "By month",
+    distributionHeading: "Trade distribution",
+    colSide: "Side",
+    colQty: "Qty",
+    colEntry: "Entry",
+    colExit: "Exit",
+    colNetPnl: "Net PnL",
+    colReturn: "Ret%",
+    colCumulative: "Cumulative",
+    colFees: "Fees",
+    colHeld: "Held",
+    colOpened: "Opened",
+    colClosed: "Closed",
+    colMonth: "Month",
+    colOpenEquity: "Open",
+    colCloseEquity: "Close",
+    colChange: "Change",
+    colWorstDrop: "Worst drop",
+    equityHeading: "Equity",
+    tradesHeading: "Trades",
+    noClosedTrades: "(no closed trades)",
+    notEnoughPoints: "(not enough equity points to plot)",
+    simulationNote: "Simulated: fees, slippage, fills at the next bar's open, conservative limit fills.",
+    cmdHelp: "List commands, or explain one",
+    cmdData: "Show local one-minute history and its covered range",
+    cmdDataDetail: "Lists every instrument with stored bars, the UTC range covered, and how many bars are missing.",
+    cmdDownload: "Download or repair local one-minute history",
+    cmdDownloadDetail: "Fetches only the minutes that are absent. Higher timeframes are derived from one-minute bars, so this is the only download you need.",
+    cmdNew: "Write a starting strategy file",
+    cmdNewDetail: "Templates: blank, ema-trend, atr-breakout, bollinger-reversion.",
+    cmdValidate: "Statically check a strategy file",
+    cmdValidateDetail: "Reports policy violations with line numbers. Always cheaper than discovering them after a run.",
+    cmdBacktest: "Run a backtest",
+    cmdBacktestDetail: "Asks for anything missing, then runs. `/backtest setting` opens the assumptions form instead of starting a run.",
+    cmdOptimize: "Search a parameter space and rank candidates out of sample",
+    cmdOptimizeDetail: "Splits the window 70/30, searches the first part, and ranks by the second. A candidate that only works on the searched part is marked overfit. `/optimize report <runId>` reprints the table; add `--adopt <file>` to save the best parameters beside your strategy.",
+    cmdCompare: "Put two or more runs side by side",
+    cmdCompareDetail: "Overlays the equity curves normalized to a common start, shows only the assumptions that differ, and warns when the runs used different data. Opens in the browser; `--no-open` prints a table instead.",
+    cmdLive: "List live profiles, read their decisions, or stop one",
+    cmdLiveDetail: "Read-only apart from stopping. Creating and starting a profile stay in the CLI, because they are the two actions that commit money to a strategy — `desic-okx live create` and `desic-okx live start`.",
+    argLiveAction: "signals | stop; omit to list profiles",
+    argLiveProfileId: "profile id, for signals or stop",
+    cmdMarket: "Show or switch which OKX venue supplies market data",
+    cmdMarketDetail: "Demo and live are separate markets with different prices, so bars from one are not comparable with the other. Switching writes the setting; the runtime reads it at startup, so it applies after `desic-okx stop`. Bars already stored keep the venue they came from.",
+    argMarketEnv: "demo | live; omit to show the current one",
+    cmdSettings: "View or change the assumptions every backtest uses",
+    cmdSettingsDetail: "Opens the same form as `/backtest setting`. Saved to disk and applied to every later run.",
+    cmdCoverage: "Show one instrument's stored range and its gaps",
+    cmdCoverageDetail: "Lists the gaps that would make a backtest over that range fail, so they can be repaired first.",
+    cmdDelete: "Delete a run and its stored series",
+    cmdDeleteDetail: "Removes the equity curve, trades, and decisions. Asks for confirmation first.",
+    cmdRuns: "List recent runs",
+    cmdReport: "Show a run's metrics, equity curve, and trades",
+    cmdCancel: "Cancel a queued or running backtest",
+    cmdEnv: "Check the local Python environment",
+    cmdStatus: "Show runtime, market feed, and database status",
+    cmdLang: "Switch display language (en / zh)",
+    cmdLangDetail: "Saved to disk and reused on the next start. Tool names, field names, and error codes stay in English so a copied message still matches the API.",
+    cmdClear: "Clear the screen",
+    cmdClearDetail: "Clears the visible screen. Earlier output remains in the terminal's scrollback, because a scrolling shell writes each line once and never takes it back.",
+    cmdExit: "Leave the shell",
+    argHelpCommand: "Command to explain",
+    argInstrument: "OKX instrument ID",
+    argWindow30: "30, or 2026-07-01..2026-08-01",
+    argWindow90: "90, or 2026-05-01..2026-08-01",
+    argDestinationFile: "Destination file",
+    argTemplate: "blank | ema-trend | atr-breakout | bollinger-reversion",
+    argStrategyToCheck: "Strategy file to check",
+    argStrategyOrSetting: "Strategy file, or `setting` to edit assumptions",
+    argStrategyOrReport: "Strategy file, or `report` to reprint a finished search",
+    argSpaceFile: "Per-parameter { min, max, step } ranges",
+    argBudget: "Candidates to evaluate",
+    argRunsToCompare: "Two or more run ids, separated by spaces",
+    argNoOpen: "Print in the terminal instead of the browser",
+    argRunToDelete: "Run to delete",
+    argRowLimit: "Rows to list",
+    argRunToOpen: "Run to open, for example bt_abc123",
+    argRunToCancel: "Run to cancel",
+    argEnvSetup: "Create the environment instead of checking it",
+    argLocale: "en | zh; omit to show the current one",
+    argRequired: "required",
+    argOptional: "optional",
+    argDefault: (value) => `default ${value}`,
+    agentAccessState: (state) => `Agent access to live profiles: ${state}`,
+    agentAccessSet: (state) => `Agent access to live profiles set to ${state}.`,
+    agentAccessRestart: "Restart the MCP client to apply it — the tool list is built when that client connects.",
+    agentAccessWarning: "An agent can now create and enable demo profiles on its own. A real-money profile still requires its name typed back by a person.",
+    agentAccessUsage: "Usage: desic-okx live agent-access <on|off>",
+    liveNoProfiles: "No live profiles yet.",
+    liveCreateHint: "desic-okx live create --file ema.py --inst BTC-USDT-SWAP --account demo --entry-budget 100 --side-budget 400 --daily-loss 200",
+    liveNameColumn: "NAME",
+    liveBudgetColumn: "ENTRY/SIDE",
+    liveErrorColumn: "ERRORS",
+    liveEnabled: "enabled",
+    liveStopped: "stopped",
+    liveReady: "Ready to start.",
+    liveNotReady: (count) => `${count} thing(s) block starting this profile:`,
+    liveEvidence: (runId) => `Backtest evidence: ${runId}`,
+    liveRealMoneyWarning: "This profile trades with real money once started.",
+    liveNoSignals: "(no decisions recorded yet)",
+    liveCutoffColumn: "MINUTE",
+    liveActionColumn: "ACTION",
+    liveDetailColumn: "DETAIL",
+    liveQtyColumn: "QTY",
+    liveProfileCreated: (id) => `Created ${id}. It is stopped; nothing trades until you start it.`,
+    liveProfileStarted: (name) => `${name} is live. It now acts on every closed minute.`,
+    liveProfileStopped: (name) => `${name} stopped.`,
+    liveDeleteConfirm: (id) => `This removes ${id} and its signal history. Repeat with --yes to confirm.`,
+    marketEnvironmentLabel: "Market data:",
+    marketEnvironmentDemo: "demo (simulated)",
+    marketEnvironmentLive: "live",
+    demoDataWarning: "Prices and candles come from OKX's simulator, not the real market.",
+    environmentSwitched: (env) => `Market data environment set to ${env}.`,
+    environmentAlready: (env) => `Market data is already set to ${env}.`,
+    environmentRestartHint: "Run 'desic-okx stop' to apply it — the runtime reads this once at startup, and bars already stored stay with the environment they came from.",
+    environmentUsage: "Usage: desic-okx market env <demo|live>",
+    environmentUsageShell: "Usage: /market <demo|live>",
+    warnDifferentData: "These runs consumed different data. Metrics are not directly comparable: any difference may come from the bars rather than the strategy.",
+    warnDifferentInstruments: (list) => `Different instruments: ${list}. Returns reflect each market's own move, not a better strategy.`,
+    warnDifferentWindows: "These runs cover different evaluation windows, so their totals span different amounts of time.",
+    warnDifferentAssumptions: (keys) => `Different assumptions: ${keys}. A return figure means nothing without the costs behind it.`,
+    warnIncompleteRuns: (list) => `Not every run finished: ${list}`,
+    strategyColumn: "STRATEGY",
+    differingAssumptionsHeading: "Assumptions that differ",
+    assumptionsIdentical: "Every assumption matches across these runs.",
+    sharedAssumptionsNote: (count) => `${count} further assumptions are identical and were collapsed.`,
+    compareNormalizedNote: "Curves are indexed to 100 at each run's own start, so different initial equity does not change the shape.",
+    compareNeedsTwo: "Give at least two run ids: /compare bt_abc123 bt_def456",
+    compareTooMany: (limit) => `A comparison holds at most ${limit} runs.`,
+    comparisonHeading: "Comparison",
+    comparedRunsHeading: "Runs",
+    normalizedEquityHeading: "Normalized equity",
+    spaceLabel: "Space",
+    candidatesLabel: "Candidates",
+    candidatesOf: (done, budget, combinations) => `${done} of ${budget} evaluated, from ${combinations} possible`,
+    candidatesFailed: (count) => `${count} failed`,
+    trainLabel: "Train",
+    validationLabel: "Validate",
+    trainReturn: "TRAIN RET",
+    validationReturn: "VALID RET",
+    trainDrawdown: "TRAIN DD",
+    validationDrawdown: "VALID DD",
+    verdictColumn: "VERDICT",
+    verdictHolds: "holds",
+    verdictOverfit: "overfit",
+    verdictWeak: "weak",
+    verdictUnexplained: "unexplained",
+    overfitNote: "The validation column is the reportable one. A strong training return beside a weak validation return is fitted to noise, not an edge. Read the two columns together: a table where every candidate lost on training and won on validation says the validation segment favoured this kind of strategy, not that any candidate was confirmed.",
+    selectionNote: "The winner was chosen by its validation score, so that score is itself somewhat selected. Confirm on a later period before trusting the figure.",
+    noCandidatesYet: "(no candidate has finished yet)",
+    giveFileOptimize: "Give a file: /optimize strategy.py [instrument] [days | range]",
+    giveSpaceFile: "Give a parameter space file, for example space.json",
+    spaceFileMissing: (file) => `${file} does not exist. It holds { \"param\": { \"min\": 5, \"max\": 50, \"step\": 5 } }.`,
+    spaceFileInvalid: (file) => `${file} is not valid JSON.`,
+    optimizeWindow: (file, instId, window) => `${file}  ${instId}  ${window}`,
+    optimizeSearch: (candidates, combinations) => `${candidates} candidates from ${combinations} combinations`,
+    forCandidateTable: (runId) => `/optimize report ${runId}  for the full candidate table`,
+    adoptedParams: (file) => `Best parameters written to ${file}`,
+    adoptHint: (runId) => `Backtest them on their own to confirm, then compare against ${runId}`,
+    noBestCandidate: "No candidate finished, so there is nothing to adopt.",
+    pythonLabel: "Python",
+    readyLabel: "Ready",
+    notFound: "not found",
+    yes: "yes",
+    no: "no",
+    fixLabel: "Fix",
+    checkingEnvironment: "checking the Python environment",
+    preparingEnvironment: "preparing the Python environment (this can take a few minutes)",
+    environmentReady: "Environment ready",
+    runtimeLabel: "Runtime",
+    publicWs: "Public WS",
+    businessWs: "Business WS",
+    subscribed: (count) => `${count} instrument(s)`,
+    databaseLabel: "Database",
+    readingStatus: "reading runtime status",
+    readingRuns: "reading recent runs",
+    readingRun: (runId) => `reading ${runId}`,
+    languageChanged: (locale) => `Language set to ${locale}. It is saved and will be used next time.`,
+    languageCurrent: (locale) => `Current language: ${locale}`,
+    languageUsage: "Usage: /lang en | /lang zh"
+};
+const zh = {
+    bannerTitle: "Desic OKX · 策略研究",
+    bannerHints: "/help 查看命令   tab 补全   ↑ 历史   /exit 退出",
+    clearHint: "ctrl+c 清空输入",
+    exitHint: "再按 ctrl+c 退出",
+    pythonNotFound: "未找到 python",
+    instrumentsWithHistory: (count) => `本地已有 ${count} 个合约的历史数据`,
+    working: "处理中",
+    cancelHint: "按 esc 取消",
+    argumentsAsked: "未填写的参数会使用默认值。",
+    unknownCommand: (name) => `未知命令 '${name}'。`,
+    didYouMean: (name) => ` 是否想输入 /${name}？`,
+    seeHelp: " 输入 /help 查看可用命令。",
+    noCommandNamed: (name) => `没有名为 '${name}' 的命令。`,
+    needsTerminal: "交互式界面需要终端。脚本调用请使用 'desic-okx <命令>'。",
+    needsUiPackages: "交互式界面需要 UI 依赖。请安装：npm install -g ink react",
+    noLocalHistory: "本地还没有 1 分钟历史数据。",
+    tryDownload: "试试：/download BTC-USDT-SWAP 30",
+    readingCoverage: "正在读取本地数据覆盖情况",
+    requestingHistory: (instId, days) => `${instId}  正在请求 ${days} 天的 1 分钟数据`,
+    daysMustBePositive: "天数必须是正数，例如：/download BTC-USDT-SWAP 30",
+    instrumentColumn: "合约",
+    fromColumn: "起始",
+    toColumn: "结束",
+    barsColumn: "根数",
+    gapsColumn: "缺口",
+    gapsNone: "无",
+    coverageRange: "区间",
+    coverageStored: (count) => `${count} 根 1 分钟 K 线`,
+    coverageMissing: (bars, gaps) => `缺 ${bars} 根，共 ${gaps} 处缺口`,
+    coverageMissingNone: "无",
+    coverageUpdated: "更新于",
+    coverageExchangeEnd: "交易所边界",
+    coverageGaps: "缺口",
+    coverageMore: (count) => `… 还有 ${count} 处`,
+    syncRange: "区间",
+    syncExpected: "应有",
+    syncElapsed: "耗时",
+    syncNoEarlierData: (time) => `OKX 没有 ${time} UTC 之前的数据`,
+    giveFileNew: "请给出文件名：/new strategy.py [模板]",
+    giveFileValidate: "请给出文件：/validate strategy.py",
+    giveFileBacktest: "请给出文件：/backtest strategy.py [合约] [天数]",
+    giveRunId: (command) => `请给出运行 ID：/${command} bt_abc123`,
+    unknownTemplate: (name, available) => `未知模板 '${name}'。可选：${available}`,
+    fileExists: (file) => `${file} 已存在。请换一个名字，避免覆盖。`,
+    fileMissing: (file) => `${file} 不存在。`,
+    wroteTemplate: (name, file) => `已将 ${name} 模板写入 ${file}`,
+    nextValidate: (file) => `下一步：/validate ${file}`,
+    validating: (file) => `正在校验 ${file}`,
+    policyPassed: "源码校验通过",
+    policyViolations: (count) => `${count} 处违规`,
+    violationLine: (line, message) => `第 ${line} 行  ${message}`,
+    backtestConfig: (file, instId, days) => `${file}  ${instId}  最近 ${days} 天`,
+    backtestWindow: (file, instId, window) => `${file}  ${instId}  ${window}`,
+    requestingWindow: (instId, window) => `${instId}  正在请求 ${window}`,
+    backtestSettings: (equity, leverage, preload) => `${equity} USDT · ${leverage}倍 · 预热 ${preload} 根`,
+    queuing: (instId) => `${instId}  正在排队`,
+    noRuns: "还没有任何回测记录。",
+    runsHint: "desic-okx strategy backtest --file strategy.py --inst BTC-USDT-SWAP",
+    forCurveAndTrades: (runId) => `/report ${runId}  查看权益曲线与成交明细`,
+    cancelled: (runId) => `已取消 ${runId}`,
+    deleteConfirm: (runId) => `这会删除 ${runId} 及其存储的数据。加 --yes 确认。`,
+    deleted: (runId) => `已删除 ${runId}`,
+    alreadyFinished: (runId) => `${runId} 已经结束了。`,
+    statusLabel: "状态",
+    barsLabel: "K 线",
+    includingPreloaded: (count) => `含 ${count} 根预热`,
+    snapshotLabel: "数据快照",
+    etaLabel: "预计剩余",
+    elapsedLabel: "耗时",
+    errorLabel: "错误",
+    performance: "收益表现",
+    netProfit: "净盈亏",
+    returnLabel: "收益率",
+    annualized: "年化",
+    annualizedWithheld: (days) => `需要 ${days} 天以上数据`,
+    maxDrawdown: "最大回撤",
+    drawdownRecovery: "最长回撤",
+    riskAdjusted: "风险调整",
+    sharpeLabel: "夏普",
+    sortinoLabel: "索提诺",
+    calmarLabel: "卡玛",
+    activity: "交易活动",
+    tradesLabel: "成交笔数",
+    longShort: (long, short) => `多 ${long} / 空 ${short}`,
+    winRate: "胜率",
+    profitFactor: "盈亏比",
+    netOfFees: "已扣手续费",
+    expectancy: "单笔期望",
+    averageWinLoss: "平均盈利/亏损",
+    largestWinLoss: "最大盈利/亏损",
+    streaks: "连续盈亏",
+    holdingTime: "平均持仓",
+    costs: "成本",
+    feesLabel: "手续费",
+    feesOfGross: "占毛利比例",
+    turnover: "成交额",
+    exposure: "持仓占比",
+    tradesPerDay: "日均交易",
+    marginExhaustedWarning: "本次回测触发了保证金耗尽。",
+    marginExhaustedDetail: "这是研究用的风险边界，不是 OKX 强平价格的估算。",
+    reportOpened: "报告已在浏览器中打开。",
+    reportWritten: "报告已生成（未能自动打开浏览器）。",
+    hoverPrompt: "鼠标悬停或用方向键查看数值",
+    hoverTime: "时间",
+    hoverEquity: "权益",
+    hoverChange: "涨跌",
+    hoverDrawdown: "回撤",
+    settingsTitle: "回测参数",
+    settingsHint: "↑↓ 移动   ⏎ 编辑或切换   r 恢复默认   s 保存   esc 取消",
+    settingsUnsaved: "有未保存的修改 —— 按 s 保存",
+    settingsSaved: "参数已保存,之后的回测都会使用。",
+    settingsCancelled: "已取消,没有任何改动。",
+    settingsDefaultIs: "默认",
+    settingsHeading: "参数",
+    settingsHintCommand: "/backtest setting  修改这些参数",
+    assumptionsHeading: "本次回测参数",
+    settingEquity: "初始权益",
+    settingEquityHelp: "起始资金(USDT)。仓位按权益计算,所以这个值会等比缩放每一笔交易。",
+    settingLeverage: "杠杆",
+    settingLeverageHelp: "把入场预算放大成名义敞口。20% 预算配 10 倍 = 账户 2 倍名义敞口。",
+    settingMarginSafety: "保证金安全系数",
+    settingMarginSafetyHelp: "按所需保证金的这个倍数预留。大于 1 可降低保证金耗尽的概率。",
+    settingBudgetPct: "单笔预算比例",
+    settingBudgetPctHelp: "每笔入场投入当前权益的比例。会复利:赚了之后仓位变大。",
+    settingBudgetUsdt: "单笔固定预算",
+    settingBudgetUsdtHelp: "每笔固定投入的 USDT,优先于比例。填 0 表示用比例。",
+    settingTakerFee: "Taker 手续费",
+    settingTakerFeeHelp: "市价成交收取。OKX 标准档为 5 bps,VIP 更低。",
+    settingMakerFee: "Maker 手续费",
+    settingMakerFeeHelp: "限价成交收取。OKX 标准档为 2 bps。",
+    settingEntrySlippage: "入场滑点",
+    settingEntrySlippageHelp: "每次入场施加的不利价格偏移(基点)。",
+    settingExitSlippage: "出场滑点",
+    settingExitSlippageHelp: "每次出场施加的不利价格偏移(基点)。",
+    settingPreload: "预热 K 线",
+    settingPreloadHelp: "评估区间之前加载的已确认 K 线,用于指标预热,不计入结果。",
+    settingDays: "评估天数",
+    settingDaysHelp: "未指定具体区间时使用的默认回溯窗口。",
+    settingCloseAtEnd: "期末平仓",
+    settingCloseAtEndHelp: "在最后一根 K 线平掉未平仓位,使结果不含浮动盈亏。",
+    monthlyHeading: "按月表现",
+    distributionHeading: "单笔盈亏分布",
+    colSide: "方向",
+    colQty: "数量",
+    colEntry: "开仓价",
+    colExit: "平仓价",
+    colNetPnl: "净盈亏",
+    colReturn: "收益率",
+    colCumulative: "累计",
+    colFees: "手续费",
+    colHeld: "持仓",
+    colOpened: "开仓时间",
+    colClosed: "平仓时间",
+    colMonth: "月份",
+    colOpenEquity: "月初权益",
+    colCloseEquity: "月末权益",
+    colChange: "涨跌",
+    colWorstDrop: "最大回落",
+    equityHeading: "权益曲线",
+    tradesHeading: "成交明细",
+    noClosedTrades: "（没有已平仓交易）",
+    notEnoughPoints: "（权益点太少，无法绘图）",
+    simulationNote: "模拟结果：含手续费、滑点，下一根开盘成交，限价单按保守估计。",
+    cmdHelp: "列出所有命令，或说明其中一个",
+    cmdData: "查看本地 1 分钟数据及其覆盖区间",
+    cmdDataDetail: "列出每个已有数据的合约、覆盖的 UTC 区间，以及缺失了多少根。",
+    cmdDownload: "下载或补齐本地 1 分钟数据",
+    cmdDownloadDetail: "只请求缺失的那些分钟。更高周期都由 1 分钟数据合成，所以只需要下载这一种。",
+    cmdNew: "生成一个策略文件模板",
+    cmdNewDetail: "可选模板：blank、ema-trend、atr-breakout、bollinger-reversion。",
+    cmdValidate: "静态校验策略文件",
+    cmdValidateDetail: "报出违规位置和行号。比排队跑完才发现问题要划算得多。",
+    cmdBacktest: "执行一次回测",
+    cmdBacktestDetail: "缺少的参数会询问，然后开始运行。`/backtest setting` 打开参数表单，而不是启动回测。",
+    cmdOptimize: "搜索参数空间，并用样本外区间排名",
+    cmdOptimizeDetail: "把窗口按 7:3 切分，在前段搜索、用后段排名。只在搜索段有效的候选会被标为过拟合。`/optimize report <运行ID>` 重新打印候选表；加 `--adopt <文件>` 可把最佳参数保存到策略旁边。",
+    cmdCompare: "把两个或多个回测并排比较",
+    cmdCompareDetail: "把权益曲线归一化到同一起点后叠加，只显示有差异的参数，并在两次运行数据不同时给出警告。默认在浏览器打开；`--no-open` 则在终端打印表格。",
+    cmdLive: "列出实盘配置、查看决策记录，或停止某个配置",
+    cmdLiveDetail: "除停止外均为只读。创建和启动仍留在 CLI —— 这两个动作会把资金投入某个策略：`desic-okx live create` 和 `desic-okx live start`。",
+    argLiveAction: "signals | stop；留空则列出全部配置",
+    argLiveProfileId: "配置 ID，用于 signals 或 stop",
+    cmdMarket: "查看或切换行情数据来自哪个 OKX 环境",
+    cmdMarketDetail: "模拟盘和实盘是两个独立市场、价格不同，所以两边的 K 线不可混用。切换只写入配置；runtime 在启动时读取，因此需要执行 `desic-okx stop` 后生效。已存的 K 线仍归属它原本的环境。",
+    argMarketEnv: "demo | live；留空则显示当前设置",
+    cmdSettings: "查看或修改所有回测共用的参数",
+    cmdSettingsDetail: "和 `/backtest setting` 打开的是同一个表单。保存到磁盘，之后每次回测都会生效。",
+    cmdCoverage: "查看单个合约的数据区间与缺口",
+    cmdCoverageDetail: "列出会导致该区间回测失败的缺口，便于先补齐。",
+    cmdDelete: "删除一次运行及其存储的数据",
+    cmdDeleteDetail: "会删掉权益曲线、成交明细和决策记录。删除前会要求确认。",
+    cmdRuns: "列出最近的运行记录",
+    cmdReport: "查看一次运行的指标、权益曲线和成交明细",
+    cmdCancel: "取消排队中或正在运行的回测",
+    cmdEnv: "检查本地 Python 环境",
+    cmdStatus: "查看运行时、行情连接和数据库状态",
+    cmdLang: "切换显示语言（en / zh）",
+    cmdLangDetail: "保存到磁盘，下次启动继续生效。工具名、字段名和错误码保持英文，这样复制出来的信息仍能对应 API。",
+    cmdClear: "清屏",
+    cmdClearDetail: "只清空当前可见区域。之前的输出仍留在终端回滚缓冲里 —— 滚动式界面每行只写一次，不会收回。",
+    cmdExit: "退出交互界面",
+    argHelpCommand: "要说明的命令",
+    argInstrument: "OKX 合约 ID",
+    argWindow30: "30，或 2026-07-01..2026-08-01",
+    argWindow90: "90，或 2026-05-01..2026-08-01",
+    argDestinationFile: "目标文件",
+    argTemplate: "blank | ema-trend | atr-breakout | bollinger-reversion",
+    argStrategyToCheck: "要校验的策略文件",
+    argStrategyOrSetting: "策略文件，或填 `setting` 修改回测参数",
+    argStrategyOrReport: "策略文件，或填 `report` 重新打印已完成的搜索",
+    argSpaceFile: "每个参数的 { min, max, step } 范围",
+    argBudget: "要评估的候选数量",
+    argRunsToCompare: "两个或更多运行 ID，用空格分隔",
+    argNoOpen: "在终端打印，而不是打开浏览器",
+    argRunToDelete: "要删除的运行",
+    argRowLimit: "列出的行数",
+    argRunToOpen: "要查看的运行，例如 bt_abc123",
+    argRunToCancel: "要取消的运行",
+    argEnvSetup: "创建环境，而不是只做检查",
+    argLocale: "en | zh；留空则显示当前语言",
+    argRequired: "必填",
+    argOptional: "可选",
+    argDefault: (value) => `默认 ${value}`,
+    agentAccessState: (state) => `agent 的实盘权限：${state}`,
+    agentAccessSet: (state) => `agent 的实盘权限已设为 ${state}。`,
+    agentAccessRestart: "需重启 MCP 客户端生效 —— 工具列表在客户端连接时构建。",
+    agentAccessWarning: "agent 现在可以自主创建并启用模拟盘配置。真实资金的配置仍需由人手打名字确认。",
+    agentAccessUsage: "用法：desic-okx live agent-access <on|off>",
+    liveNoProfiles: "还没有实盘配置。",
+    liveCreateHint: "desic-okx live create --file ema.py --inst BTC-USDT-SWAP --account demo --entry-budget 100 --side-budget 400 --daily-loss 200",
+    liveNameColumn: "名称",
+    liveBudgetColumn: "单笔/同向",
+    liveErrorColumn: "连续错误",
+    liveEnabled: "已启用",
+    liveStopped: "已停止",
+    liveReady: "可以启动。",
+    liveNotReady: (count) => `有 ${count} 项阻碍启动：`,
+    liveEvidence: (runId) => `回测依据：${runId}`,
+    liveRealMoneyWarning: "启动后这个配置会用真实资金交易。",
+    liveNoSignals: "（还没有决策记录）",
+    liveCutoffColumn: "分钟",
+    liveActionColumn: "动作",
+    liveDetailColumn: "详情",
+    liveQtyColumn: "张数",
+    liveProfileCreated: (id) => `已创建 ${id}。当前为停止状态，启动前不会有任何交易。`,
+    liveProfileStarted: (name) => `${name} 已启用，之后每根收线都会执行。`,
+    liveProfileStopped: (name) => `${name} 已停止。`,
+    liveDeleteConfirm: (id) => `这会删除 ${id} 及其信号历史。加 --yes 确认。`,
+    marketEnvironmentLabel: "行情数据：",
+    marketEnvironmentDemo: "模拟盘",
+    marketEnvironmentLive: "实盘",
+    demoDataWarning: "价格与 K 线来自 OKX 模拟盘，不是真实市场。",
+    environmentSwitched: (env) => `行情数据环境已设为 ${env}。`,
+    environmentAlready: (env) => `行情数据环境已经是 ${env} 了。`,
+    environmentRestartHint: "执行 'desic-okx stop' 生效 —— runtime 只在启动时读一次这个配置；已存的 K 线仍归属它原本的环境。",
+    environmentUsage: "用法：desic-okx market env <demo|live>",
+    environmentUsageShell: "用法：/market <demo|live>",
+    warnDifferentData: "这几次运行使用的数据并不相同。指标无法直接对比：差异可能来自数据本身，而不是策略。",
+    warnDifferentInstruments: (list) => `合约不同：${list}。收益反映的是各自市场的涨跌，并不说明策略更好。`,
+    warnDifferentWindows: "这几次运行的评估区间不同，因此各项合计覆盖的时间长度也不一样。",
+    warnDifferentAssumptions: (keys) => `参数不同：${keys}。脱离背后的成本设定，收益率没有意义。`,
+    warnIncompleteRuns: (list) => `并非所有运行都已完成：${list}`,
+    strategyColumn: "策略",
+    differingAssumptionsHeading: "有差异的参数",
+    assumptionsIdentical: "这几次运行的参数完全一致。",
+    sharedAssumptionsNote: (count) => `另有 ${count} 项参数完全相同，已折叠。`,
+    compareNormalizedNote: "曲线按各自起点归一化到 100，因此初始权益不同不会影响形状。",
+    compareNeedsTwo: "请至少给出两个运行 ID：/compare bt_abc123 bt_def456",
+    compareTooMany: (limit) => `一次最多对比 ${limit} 个运行。`,
+    comparisonHeading: "对比",
+    comparedRunsHeading: "参与对比的运行",
+    normalizedEquityHeading: "归一化权益曲线",
+    spaceLabel: "参数空间",
+    candidatesLabel: "候选",
+    candidatesOf: (done, budget, combinations) => `已评估 ${done} / ${budget}，全部组合 ${combinations} 个`,
+    candidatesFailed: (count) => `${count} 个失败`,
+    trainLabel: "训练段",
+    validationLabel: "验证段",
+    trainReturn: "训练收益",
+    validationReturn: "验证收益",
+    trainDrawdown: "训练回撤",
+    validationDrawdown: "验证回撤",
+    verdictColumn: "结论",
+    verdictHolds: "稳健",
+    verdictOverfit: "过拟合",
+    verdictWeak: "偏弱",
+    verdictUnexplained: "无从解释",
+    overfitNote: "应当引用的是验证段数据。训练段亮眼而验证段疲软，说明拟合的是噪声，不是真实的优势。两列要合起来读：如果整张表都是训练段亏、验证段赚，那说明验证段这段行情本身有利于这类策略，而不是某个候选得到了验证。",
+    selectionNote: "第一名是按验证段得分挑出来的，因此该得分本身也带有挑选成分。要相信这个数字，需在更晚的区间上再确认一次。",
+    noCandidatesYet: "（还没有候选跑完）",
+    giveFileOptimize: "请给出文件：/optimize strategy.py [合约] [天数或区间]",
+    giveSpaceFile: "请给出参数空间文件，例如 space.json",
+    spaceFileMissing: (file) => `${file} 不存在。文件内容形如 { "param": { "min": 5, "max": 50, "step": 5 } }。`,
+    spaceFileInvalid: (file) => `${file} 不是合法的 JSON。`,
+    optimizeWindow: (file, instId, window) => `${file}  ${instId}  ${window}`,
+    optimizeSearch: (candidates, combinations) => `从 ${combinations} 个组合中取 ${candidates} 个候选`,
+    forCandidateTable: (runId) => `/optimize report ${runId}  查看完整候选表`,
+    adoptedParams: (file) => `最佳参数已写入 ${file}`,
+    adoptHint: (runId) => `建议用这组参数单独回测确认，再与 ${runId} 对比`,
+    noBestCandidate: "没有候选跑完，暂无可采用的参数。",
+    pythonLabel: "Python",
+    readyLabel: "就绪",
+    notFound: "未找到",
+    yes: "是",
+    no: "否",
+    fixLabel: "修复",
+    checkingEnvironment: "正在检查 Python 环境",
+    preparingEnvironment: "正在准备 Python 环境（可能需要几分钟）",
+    environmentReady: "环境已就绪",
+    runtimeLabel: "运行时",
+    publicWs: "公共 WS",
+    businessWs: "业务 WS",
+    subscribed: (count) => `${count} 个合约`,
+    databaseLabel: "数据库",
+    readingStatus: "正在读取运行时状态",
+    readingRuns: "正在读取最近的回测",
+    readingRun: (runId) => `正在读取 ${runId}`,
+    languageChanged: (locale) => `语言已设置为 ${locale}，配置已保存，下次启动继续生效。`,
+    languageCurrent: (locale) => `当前语言：${locale}`,
+    languageUsage: "用法：/lang en | /lang zh"
+};
+const BUNDLES = { en, zh };
+export function messages(locale) {
+    return BUNDLES[locale];
+}
+//# sourceMappingURL=messages.js.map