methodalgo-cli 1.0.1

package/src/utils/i18n.js

@@ -0,0 +1,204 @@
+import chalk from "chalk";
+import config from "./config-manager.js";
+
+const translations = {
+    en: {
+        HELP_DESC: "Methodalgo Market Intelligence Tool (Optimized for LLMs)",
+        CONFIG_DESC: "Manage tool configuration (e.g., API Key)",
+        CONFIG_SET_DESC: "Set configuration item",
+        CONFIG_GET_DESC: "Get configuration item",
+        CONFIG_LIST_DESC: "List all configurations (excluding sensitive info)",
+        SNAPSHOT_DESC: "Get TradingView chart snapshot",
+        NEWS_DESC: "Get cryptocurrency market news",
+        SIGNALS_DESC: "Get trading signals",
+        DASHBOARD_DESC: "Open real-time TUI dashboard (3-column layout)",
+        COL_NEWS: "Market News",
+        COL_SIGNALS: "L2 Signals",
+        COL_STATUS: "System Status",
+        TYPE_ARTICLE: "Articles",
+        TYPE_NEWS: "Breaking",
+        TYPE_ONCHAIN: "On-Chain",
+        TYPE_REPORT: "Reports",
+        LABEL_BREAKOUT: "Breakout",
+        LABEL_EXHAUSTION: "Exhaustion",
+        LABEL_GOLDEN_PIT: "Golden Pit",
+        LABEL_LIQUIDATION: "Liquidation",
+        LABEL_MARKET_TODAY: "Market Today",
+        LABEL_TOKEN_UNLOCK: "Token Unlock",
+        LABEL_FEAR_GREED: "Fear & Greed Index",
+        SENTIMENT_EXTREME_FEAR: "Extreme Fear",
+        SENTIMENT_FEAR: "Fear",
+        SENTIMENT_NEUTRAL: "Neutral",
+        SENTIMENT_GREED: "Greed",
+        SENTIMENT_EXTREME_GREED: "Extreme Greed",
+        GOLDEN_PIT_BULL: "Bull golden Pit",
+        GOLDEN_PIT_BEAR: "Bear golden Pit",
+        BREAKOUT_UP: "Breakup",
+        BREAKOUT_DOWN: "Breakdown",
+        LIQUIDATION_LONG: "LONG Liquidation",
+        LIQUIDATION_SHORT: "SHORT Liquidation",
+        TUI_QUIT: "Press 'q' or 'Ctrl+C' to quit",
+        ERR_MISSING_KEY: "Missing API Key. Please run 'methodalgo config set api-key <your-key>'",
+        ERR_NETWORK: "Network error",
+        SUGGESTION_KEY: "Please check your network connection or API Key configuration.",
+        SET_SUCCESS: "Set {key} to {value}",
+        VAL_NOT_SET: "Configuration {key} is not set",
+        FETCH_SUCCESS: "Fetched {count} items:",
+        SNAPSHOT_SUCCESS: "Snapshot fetched successfully [{ticker} {tf}]:",
+        INVALID_CMD: "Invalid command: {cmd}\nUse 'methodalgo --help' for available commands.",
+        LABEL_SUGGESTION: "Suggestion: ",
+        LABEL_EXAMPLE: "Example: ",
+        SIGNALS_CHANNELS: `Supported Channels:
+${chalk.cyan("- breakout-htf")}: ${chalk.gray("Detects 1D/3D trends. Alerts on breaking high/low within a 100-candle rolling window.")}
+${chalk.cyan("- breakout-mtf")}: ${chalk.gray("Detects 1H/4H trends. Alerts on breaking high/low within a 100-candle rolling window.")}
+${chalk.cyan("- breakout-24h")}: ${chalk.gray("Continuous breakout detection based on a 24-hour rolling window of high/low prices.")}
+${chalk.cyan("- liquidation")}: ${chalk.gray("Large liquidation order alerts.")}
+${chalk.cyan("- exhaustion-seller")}: ${chalk.gray("Reversal signals (Sellers exhausted, price likely to rise), based on Grim Reaper Heatmap.")}
+${chalk.cyan("- exhaustion-buyer")}: ${chalk.gray("Reversal signals (Buyers exhausted, price likely to fall), based on Grim Reaper Heatmap.")}
+${chalk.cyan("- golden-pit-mtf")}: ${chalk.gray("'Smart Cloud' patterns (Pump/Dump), 30m/1h/4h timeframes. Bull Pit: rise after pullback, Bear Pit: fall after rally.")}
+${chalk.cyan("- golden-pit-ltf")}: ${chalk.gray("'Smart Cloud' patterns (Pump/Dump), 5m/15m timeframes. Bull Pit: rise after pullback, Bear Pit: fall after rally.")}
+${chalk.cyan("- token-unlock")}: ${chalk.gray("Token unlock event highlights with countdowns.")}
+${chalk.cyan("- etf-tracker")}: ${chalk.gray("Daily inflows/outflows for BTC/ETH and SOL/XRP.")}
+${chalk.cyan("- market-today")}: ${chalk.gray("Alt Season Index and Fear & Greed Index.")}`,
+        NEWS_TYPES: `Supported Types:
+${chalk.cyan("- article")}: ${chalk.gray("Market news & analysis.")}
+${chalk.cyan("- breaking")}: ${chalk.gray("Real-time breaking news.")}
+${chalk.cyan("- onchain")}: ${chalk.gray("On-chain abnormality detection.")}
+${chalk.cyan("- report")}: ${chalk.gray("Institutional research reports.")}`,
+        ERR_AUTH_FAILED: "API Key Invalid or Expired.",
+        GET_API_KEY_LINK: "Get a new key at: https://account.methodalgo.com/account/api-keys",
+        RECONFIG_TIP: "Use 'methodalgo config set api-key <key>' to update.",
+        ONBOARD_WELCOME: "Welcome to MethodAlgo! It seems you haven't set an API Key yet.",
+        ONBOARD_PROMPT: "Please enter your API Key: ",
+        ONBOARD_VALIDATING: "Validating API Key... (Testing with a small request)",
+        ONBOARD_SUCCESS: "API Key verified and saved successfully!",
+        ONBOARD_FAILED: "Invalid API Key. Please double check and try again.",
+        ONBOARD_GET_LINK: "Get your key here: https://account.methodalgo.com/account/api-keys",
+        ONBOARD_LANG_PROMPT: "Select Language (1: English, 2: 中文): ",
+        LOGOUT_DESC: "Logout and clear API Key",
+        LOGOUT_SUCCESS: "Successfully logged out. API Key cleared, language preference kept.",
+        ERR_INVALID_CONFIG_KEY: "Invalid configuration key: {key}",
+        VAL_ALLOWED_KEYS: "Allowed keys are: api-key, lang, api-base",
+        ARG_SYMBOL_DESC: "Symbol (e.g., SOLUSDT for Spot, SOLUSDT.P for Perpetual)",
+        ARG_TF_DESC: "Timeframe (default 60)",
+        OPT_URL_DESC: "Force return the URL instead of binary (recommended for LLMs)",
+        OPT_BUFFER_DESC: "Force return binary buffer and try to render in terminal",
+        OPT_SEARCH_DESC: "Search keywords in news titles",
+        OPT_START_DATE_DESC: "Filter news from this date (ISO 8601 or YYYY-MM-DD, e.g., 2026-03-20)",
+        OPT_END_DATE_DESC: "Filter news up to this date (ISO 8601 or YYYY-MM-DD)",
+        SNAPSHOT_EXAMPLE: "methodalgo snapshot BTCUSDT 30",
+        NEWS_EXAMPLE: "methodalgo news --type breaking --limit 5 --search 'Bitcoin'",
+        SIGNALS_EXAMPLE: "methodalgo signals breakout-mtf",
+        CONFIG_EXAMPLE: "methodalgo config set lang zh",
+        DASHBOARD_EXAMPLE: "methodalgo dashboard",
+        TUI_HINTS: "Q:Quit | Tab:Switch | Enter:Detail",
+        OPT_LIMIT_DESC: "Limit results (max 600, or 100 with --after)",
+        OPT_AFTER_DESC: "Message ID to fetch signals after (for incremental fetching)",
+        SIGNALS_LIMIT_NOTE: "Note: Limit up to 600 if 'after' is not used, 100 if used.",
+        NEWS_LIMIT_NOTE: "Note: News data is from DB, max 500 per request."
+    },
+    zh: {
+        HELP_DESC: "Methodalgo 市场情报工具 (针对大模型优化版)",
+        CONFIG_DESC: "管理工具配置 (如 API Key)",
+        CONFIG_SET_DESC: "设置配置项",
+        CONFIG_GET_DESC: "获取配置项",
+        CONFIG_LIST_DESC: "列出所有配置 (不包含敏感信息)",
+        SNAPSHOT_DESC: "获取 TradingView 图表快照",
+        NEWS_DESC: "获取加密货币市场新闻",
+        SIGNALS_DESC: "获取交易信号",
+        DASHBOARD_DESC: "打开实时 TUI 仪表盘 (三列布局)",
+        COL_NEWS: "市场新闻",
+        COL_SIGNALS: "L2 信号",
+        COL_STATUS: "系统状态",
+        TYPE_ARTICLE: "新闻",
+        TYPE_NEWS: "突发快讯",
+        TYPE_ONCHAIN: "链上监测",
+        TYPE_REPORT: "机构报告",
+        LABEL_BREAKOUT: "突破",
+        LABEL_EXHAUSTION: "死神清算",
+        LABEL_GOLDEN_PIT: "黄金坑",
+        LABEL_LIQUIDATION: "强平订单",
+        LABEL_MARKET_TODAY: "今日市场",
+        LABEL_TOKEN_UNLOCK: "代币解锁",
+        TUI_QUIT: "按 'q' 或 'Ctrl+C' 退出",
+        ERR_MISSING_KEY: "缺失 API Key。请运行 'methodalgo config set api-key <your-key>'",
+        ERR_NETWORK: "网络错误",
+        SUGGESTION_KEY: "请检查您的网络连接或 API Key 是否正确配置。",
+        SET_SUCCESS: "已设置 {key} 为 {value}",
+        VAL_NOT_SET: "配置项 {key} 未设置",
+        FETCH_SUCCESS: "获取到 {count} 条结果:",
+        SNAPSHOT_SUCCESS: "快照获取成功 [{ticker} {tf}]:",
+        INVALID_CMD: "无效的命令: {cmd}\n使用 'methodalgo --help' 查看可用命令。",
+        LABEL_SUGGESTION: "建议方案: ",
+        LABEL_EXAMPLE: "示例: ",
+        SIGNALS_CHANNELS: `支持的频道：
+${chalk.yellow("- breakout-htf")}: ${chalk.gray("检测1D/3D趋势。在当前K线在100根K线的浮动时间窗口中，突破期间最高/低点时的报警。")}
+${chalk.yellow("- breakout-mtf")}: ${chalk.gray("检测1H/4H趋势。在当前K线在100根K线的浮动时间窗口中，突破期间最高/低点时的报警。")}
+${chalk.yellow("- breakout-24h")}: ${chalk.gray("基于过去24小时滚动时间窗口的最高/低点的持续突破检测。")}
+${chalk.yellow("- liquidation")}: ${chalk.gray("大额强平订单实时提醒。")}
+${chalk.yellow("- exhaustion-seller")}: ${chalk.gray("基于死神清算热力图，单边卖家强平库存<10%与<5%的反转信号 (卖家耗尽，价格会上升)。")}
+${chalk.yellow("- exhaustion-buyer")}: ${chalk.gray("基于死神清算热力图，单边买家强平库存<10%与<5%的反转信号 (买家耗尽，价格会下降)。")}
+${chalk.yellow("- golden-pit-mtf")}: ${chalk.gray("'Smart Cloud' 模式，预示随后会有显著的程序化波动 (30m/1h/4h 周期)。Bull Pit 代表短暂回撤后价格会拉升，Bear Pit 代表短暂上扬后价格会继续下降。")}
+${chalk.yellow("- golden-pit-ltf")}: ${chalk.gray("'Smart Cloud' 模式，预示随后会有显著的程序化波动 (5m/15m 周期)。Bull Pit 代表短暂回撤后价格会拉升，Bear Pit 代表短暂上扬后价格会继续下降。")}
+${chalk.yellow("- token-unlock")}: ${chalk.gray("代币解锁事件高亮及倒计时计。")}
+${chalk.yellow("- etf-tracker")}: ${chalk.gray("BTC/ETH 和 SOL/XRP 每日资金流入/流出追踪。")}
+${chalk.yellow("- market-today")}: ${chalk.gray("每日山寨季指数与贪婪恐惧指数。")}`,
+        NEWS_TYPES: `支持的类型：
+${chalk.yellow("- article")}: ${chalk.gray("深度市场新闻与分析")}
+${chalk.yellow("- breaking")}: ${chalk.gray("实时快讯")}
+${chalk.yellow("- onchain")}: ${chalk.gray("链上数据异动监测")}
+${chalk.yellow("- report")}: ${chalk.gray("机构研究报告")}`,
+        ERR_AUTH_FAILED: "API Key 无效或已过期。",
+        GET_API_KEY_LINK: "请在此获取新 Key: https://account.methodalgo.com/zh/account/api-keys",
+        RECONFIG_TIP: "请运行 'methodalgo config set api-key <key>' 进行更新。",
+        ONBOARD_WELCOME: "欢迎使用 MethodAlgo！检测到您尚未配置 API Key。",
+        ONBOARD_PROMPT: "请输入您的 API Key: ",
+        ONBOARD_VALIDATING: "正在验证 API Key... (尝试拉取测试数据)",
+        ONBOARD_SUCCESS: "API Key 验证通过并已成功保存！",
+        ONBOARD_FAILED: "API Key 无效，请检查后重试。",
+        ONBOARD_GET_LINK: "获取链接: https://account.methodalgo.com/zh/account/api-keys",
+        ONBOARD_LANG_PROMPT: "请选择语言 / Select Language (1: English, 2: 中文): ",
+        LOGOUT_DESC: "退出登录并清除 API Key",
+        LOGOUT_SUCCESS: "成功退出登录。API Key 已清除，语言设置已保留。",
+        ERR_INVALID_CONFIG_KEY: "无效的配置键: {key}",
+        VAL_ALLOWED_KEYS: "允许的键包括: api-key, lang, api-base",
+        ARG_SYMBOL_DESC: "交易对符号 (例如: SOLUSDT 为现货, SOLUSDT.P 为合约)",
+        ARG_TF_DESC: "时间周期 (默认 60)",
+        OPT_URL_DESC: "强制返回 URL 链接而非二进制流 (大模型调用时建议开启)",
+        OPT_BUFFER_DESC: "强制返回二进制流并尝试在终端渲染",
+        OPT_SEARCH_DESC: "在新闻标题中搜索关键词",
+        OPT_START_DATE_DESC: "从此日期开始筛选 (支持 ISO 8601 或 YYYY-MM-DD，如: 2026-03-20)",
+        OPT_END_DATE_DESC: "在此日期前筛选 (支持 ISO 8601 或 YYYY-MM-DD)",
+        SNAPSHOT_EXAMPLE: "methodalgo snapshot BTCUSDT 30",
+        NEWS_EXAMPLE: "methodalgo news --type breaking --limit 5 --search '比特币'",
+        SIGNALS_EXAMPLE: "methodalgo signals breakout-mtf",
+        CONFIG_EXAMPLE: "methodalgo config set lang zh",
+        DASHBOARD_EXAMPLE: "methodalgo dashboard",
+        TUI_HINTS: "Q:退出 | Tab:切换 | Enter:详情",
+        OPT_LIMIT_DESC: "获取结果数量 (最高 600，使用 --after 时最高 100)",
+        OPT_AFTER_DESC: "起始消息 ID (用于增量抓取)",
+        SIGNALS_LIMIT_NOTE: "注：不使用 after 时 limit 最高 600，使用时最高 100。",
+        NEWS_LIMIT_NOTE: "注：新闻类数据读取自数据库，单次最高限额 500 条。"
+    }
+};
+
+export function getLang() {
+    return config.get("lang") || "en";
+}
+
+/**
+ * 翻译函数
+ * @param {string} key 键值
+ * @param {object} params 替换参数
+ */
+export function t(key, params = {}) {
+    const lang = config.get("lang") || "en";
+    let text = translations[lang][key] || translations["en"][key] || key;
+    
+    // 简单的占位符替换
+    Object.keys(params).forEach(p => {
+        text = text.replace(`{${p}}`, params[p]);
+    });
+    
+    return text;
+}

package/src/utils/logger.js

@@ -0,0 +1,27 @@
+import chalk from "chalk";
+import { t } from "./i18n.js";
+
+/**
+ * 针对 LLM 优化的日志/错误输出工具
+ */
+const logger = {
+    info: (msg) => console.log(chalk.blue("ℹ ") + msg),
+    success: (msg) => console.log(chalk.green("✔ ") + msg),
+    warn: (msg) => console.log(chalk.yellow("⚠ ") + msg),
+    error: (msg, suggestion) => {
+        console.error(chalk.red("✖ ") + chalk.bold(msg));
+        if (suggestion) {
+            console.error(chalk.cyan(`\n💡 ${t("LABEL_SUGGESTION")}`) + suggestion);
+        }
+    },
+    json: (data) => console.log(JSON.stringify(data, null, 2)),
+    isIterm2: process.env.TERM_PROGRAM === "iTerm.app" || !!process.env.ITERM_SESSION_ID,
+    image: (buffer, force = false) => {
+        if ((!logger.isIterm2 && !force) || !buffer) return;
+        // iTerm2 Inline Image Protocol: \x1b]1337;File=inline=1;size=...:[base64]\x07
+        const base64 = buffer.toString("base64");
+        process.stdout.write(`\x1b]1337;File=inline=1;size=${buffer.length}:${base64}\x07\n`);
+    }
+};
+
+export default logger;

package/src/utils/onboard.js

@@ -0,0 +1,45 @@
+import readline from "readline";
+import chalk from "chalk";
+import config from "./config-manager.js";
+import { t } from "./i18n.js";
+import { validateApiKey } from "./api.js";
+
+export async function startOnboarding(banner = "") {
+    const rl = readline.createInterface({ input: process.stdin, output: process.stdout });
+    const question = (query) => new Promise((resolve) => rl.question(query, resolve));
+
+    console.clear();
+    if (banner) console.log(banner);
+
+    // 1. 设置语言
+    console.log(chalk.cyan("\n" + "=".repeat(50)));
+    const langIdx = await question(chalk.bold("\n请选择语言 / Select Language (1: English, 2: 中文) [1]: "));
+    const lang = langIdx === "2" ? "zh" : "en";
+    config.set("lang", lang);
+    console.log(chalk.green(`\n✓ Language set to: ${lang === "zh" ? "中文" : "English"}`));
+
+    // 2. 引导欢迎语
+    console.log(chalk.blue(`\n💡 ${t("ONBOARD_WELCOME")}`));
+    console.log(chalk.yellow(`🔗 ${t("ONBOARD_GET_LINK")}\n`));
+
+    // 3. 循环请求 API Key 直到校验成功
+    let valid = false;
+    while (!valid) {
+        const key = await question(chalk.bold(`🔑 ${t("ONBOARD_PROMPT")}`));
+        if (!key) continue;
+
+        console.log(chalk.blue(`\n⏳ ${t("ONBOARD_VALIDATING")}...`));
+        valid = await validateApiKey(key);
+
+        if (valid) {
+            config.set("apiKey", key);
+            console.log(chalk.green(`\n✨ ${t("ONBOARD_SUCCESS")}`));
+        } else {
+            console.log(chalk.red(`\n❌ ${t("ONBOARD_FAILED")}`));
+            console.log(chalk.yellow(`🔗 ${t("ONBOARD_GET_LINK")}\n`));
+        }
+    }
+
+    rl.close();
+    console.log(chalk.cyan("\n" + "=".repeat(50) + "\n"));
+}