aria-code 0.81.0__tar.gz → 0.83.0__tar.gz

{aria_code-0.81.0/src/aria_code.egg-info → aria_code-0.83.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: aria-code
-Version: 0.81.0
+Version: 0.83.0
 Summary: Open-source AI agent for coding, financial analysis and logistics operations: numbers you can check, client data kept apart, actions a person approves
 License: Apache-2.0
 Project-URL: Homepage, https://github.com/artheras/aria-code

{aria_code-0.81.0 → aria_code-0.83.0}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "aria-code"
-version = "0.81.0"
+version = "0.83.0"
 description = "Open-source AI agent for coding, financial analysis and logistics operations: numbers you can check, client data kept apart, actions a person approves"
 readme = "README.md"
 license = { text = "Apache-2.0" }

{aria_code-0.81.0 → aria_code-0.83.0}/src/aria_code/_version.py

@@ -17,4 +17,4 @@ from __future__ import annotations
 
 __all__ = ["__version__"]
 
-__version__ = "0.81.0"
+__version__ = "0.83.0"

{aria_code-0.81.0 → aria_code-0.83.0}/src/aria_code/apps/cli/commands/analysis_cmds.py

@@ -2,6 +2,8 @@
 
 from __future__ import annotations
 
+from aria_code.apps.cli.i18n import ui_text
+
 from aria_code.apps.cli.commands.market import parse_analysis_args
 from aria_code.apps.cli.commands.market_context import context_has_price
 
@@ -98,7 +100,7 @@ class AnalysisCommandsMixin:
         response_lang = parsed.lang or ("zh" if is_cn else "en")
 
         if self.context.has_rich:
-            with self.context.console.status(f"[dim]正在获取 {symbol} 数据...[/dim]", spinner="dots"):
+            with self.context.console.status(f"[dim]{ui_text(self, f'正在获取 {symbol} 数据', f'Fetching {symbol} data')}...[/dim]", spinner="dots"):
                 ctx = await self._build_analyze_context(symbol, is_cn)
         else:
             print(f"Fetching data for {symbol}...")
@@ -166,7 +168,7 @@ class AnalysisCommandsMixin:
 
         if region in ("us", "all"):
             if self.context.has_rich:
-                with self.context.console.status("[dim]获取美国宏观数据 (FRED)...[/dim]", spinner="dots"):
+                with self.context.console.status(f"[dim]{ui_text(self, '获取美国宏观数据 (FRED)', 'Fetching US macro data (FRED)')}...[/dim]", spinner="dots"):
                     r = await loop.run_in_executor(None, lambda: get_us_macro(indicator if region == "us" else "all"))
             else:
                 r = get_us_macro(indicator if region == "us" else "all")
@@ -174,7 +176,7 @@ class AnalysisCommandsMixin:
 
         if region in ("cn", "all"):
             if self.context.has_rich:
-                with self.context.console.status("[dim]获取中国宏观数据 (akshare)...[/dim]", spinner="dots"):
+                with self.context.console.status(f"[dim]{ui_text(self, '获取中国宏观数据 (akshare)', 'Fetching China macro data (akshare)')}...[/dim]", spinner="dots"):
                     r_cn = await loop.run_in_executor(None, lambda: get_cn_macro(indicator if region == "cn" else "all"))
             else:
                 r_cn = get_cn_macro(indicator if region == "cn" else "all")
@@ -182,7 +184,7 @@ class AnalysisCommandsMixin:
 
         if region in ("rates", "all"):
             if self.context.has_rich:
-                with self.context.console.status("[dim]获取央行利率...[/dim]", spinner="dots"):
+                with self.context.console.status(f"[dim]{ui_text(self, '获取央行利率', 'Fetching central bank rates')}...[/dim]", spinner="dots"):
                     r_rates = await loop.run_in_executor(None, get_central_bank_rates)
             else:
                 r_rates = get_central_bank_rates()
@@ -190,7 +192,7 @@ class AnalysisCommandsMixin:
 
         if region == "calendar":
             if self.context.has_rich:
-                with self.context.console.status("[dim]获取经济日历...[/dim]", spinner="dots"):
+                with self.context.console.status(f"[dim]{ui_text(self, '获取经济日历', 'Fetching the economic calendar')}...[/dim]", spinner="dots"):
                     r_cal = await loop.run_in_executor(None, lambda: get_economic_calendar(7))
             else:
                 r_cal = get_economic_calendar(7)
@@ -216,7 +218,7 @@ class AnalysisCommandsMixin:
         import asyncio as _asyncio
         loop = _asyncio.get_event_loop()
         if self.context.has_rich:
-            with self.context.console.status(f"[dim]获取 {symbol} 期权链...[/dim]", spinner="dots"):
+            with self.context.console.status(f"[dim]{ui_text(self, f'获取 {symbol} 期权链', f'Fetching the {symbol} option chain')}...[/dim]", spinner="dots"):
                 from local_finance_tools import _get_options_chain
                 r = await loop.run_in_executor(None, _get_options_chain,
                                                {"symbol": symbol, "type": opt_type, "expiry": expiry, "limit": 20})
@@ -281,7 +283,7 @@ class AnalysisCommandsMixin:
         import asyncio as _asyncio
         loop = _asyncio.get_event_loop()
         if self.context.has_rich:
-            with self.context.console.status(f"[dim]计算 {symbol} 财务质量评分...[/dim]", spinner="dots"):
+            with self.context.console.status(f"[dim]{ui_text(self, f'计算 {symbol} 财务质量评分', f'Scoring {symbol} financial quality')}...[/dim]", spinner="dots"):
                 from local_finance_tools import _piotroski_fscore, _altman_zscore
                 f_r = await loop.run_in_executor(None, _piotroski_fscore, {"symbol": symbol})
                 z_r = await loop.run_in_executor(None, _altman_zscore, {"symbol": symbol})
@@ -303,7 +305,7 @@ class AnalysisCommandsMixin:
         import asyncio as _asyncio
         loop = _asyncio.get_event_loop()
         if self.context.has_rich:
-            with self.context.console.status(f"[dim]计算 {symbol} 一目均衡表...[/dim]", spinner="dots"):
+            with self.context.console.status(f"[dim]{ui_text(self, f'计算 {symbol} 一目均衡表', f'Computing {symbol} Ichimoku')}...[/dim]", spinner="dots"):
                 from local_finance_tools import _calculate_ichimoku
                 r = await loop.run_in_executor(None, _calculate_ichimoku, {"symbol": symbol})
         else:
@@ -322,7 +324,7 @@ class AnalysisCommandsMixin:
         import asyncio as _asyncio
         loop = _asyncio.get_event_loop()
         if self.context.has_rich:
-            with self.context.console.status("[dim]获取恐惧贪婪指数...[/dim]", spinner="dots"):
+            with self.context.console.status(f"[dim]{ui_text(self, '获取恐惧贪婪指数', 'Fetching the Fear & Greed index')}...[/dim]", spinner="dots"):
                 from local_finance_tools import _get_fear_greed_index
                 r = await loop.run_in_executor(None, _get_fear_greed_index, {})
         else:
@@ -356,7 +358,7 @@ class AnalysisCommandsMixin:
         loop = _asyncio.get_event_loop()
         if compare_mode:
             if self.context.has_rich:
-                with self.context.console.status("[dim]并行查询 binance / okx / bybit...[/dim]", spinner="dots"):
+                with self.context.console.status(f"[dim]{ui_text(self, '并行查询 binance / okx / bybit', 'Querying binance / okx / bybit in parallel')}...[/dim]", spinner="dots"):
                     from local_finance_tools import _get_funding_rates_compare
                     r = await loop.run_in_executor(None, _get_funding_rates_compare, {"symbols": syms})
             else:
@@ -365,7 +367,7 @@ class AnalysisCommandsMixin:
             _render_funding_compare(r)
         else:
             if self.context.has_rich:
-                with self.context.console.status(f"[dim]获取 {exchange} 资金费率...[/dim]", spinner="dots"):
+                with self.context.console.status(f"[dim]{ui_text(self, f'获取 {exchange} 资金费率', f'Fetching {exchange} funding rates')}...[/dim]", spinner="dots"):
                     from local_finance_tools import _get_funding_rates
                     r = await loop.run_in_executor(None, _get_funding_rates, {"exchange": exchange, "symbols": syms})
             else:

{aria_code-0.81.0 → aria_code-0.83.0}/src/aria_code/apps/cli/commands/broker_cmds.py

@@ -6,6 +6,8 @@ imported lazily inside each method body to avoid circular imports at load time.
 
 from __future__ import annotations
 
+from aria_code.apps.cli.i18n import ui_text
+
 from ._ui import Panel, print_error, rich_box
 from aria_code.packages.aria_core.paths import aria_home
 
@@ -389,7 +391,7 @@ class BrokerCommandsMixin:
         label = broker_id
         try:
             if self.context.has_rich:
-                with self.context.console.status(f"[dim]正在连接 {broker_id}...[/dim]", spinner="dots"):
+                with self.context.console.status(f"[dim]{ui_text(self, f'正在连接 {broker_id}', f'Connecting to {broker_id}')}...[/dim]", spinner="dots"):
                     import asyncio as _aio
                     loop = _aio.get_event_loop()
                     broker = await loop.run_in_executor(None, reg.connect, broker_id)
@@ -859,7 +861,7 @@ class BrokerCommandsMixin:
             if not broker:
                 return
             import asyncio as _aio
-            with self.context.console.status("[dim]获取持仓...[/dim]", spinner="dots") if self.context.has_rich else _null_ctx():
+            with self.context.console.status(f"[dim]{ui_text(self, '获取持仓', 'Fetching positions')}...[/dim]", spinner="dots") if self.context.has_rich else _null_ctx():
                 pos = await _aio.get_event_loop().run_in_executor(None, broker.positions)
             _print_broker_positions(pos, broker.label, broker.config.get("currency","CNY"))
         except Exception as e:
@@ -889,7 +891,7 @@ class BrokerCommandsMixin:
             if not broker:
                 return
             import asyncio as _aio
-            with self.context.console.status("[dim]获取订单...[/dim]", spinner="dots") if self.context.has_rich else _null_ctx():
+            with self.context.console.status(f"[dim]{ui_text(self, '获取订单', 'Fetching orders')}...[/dim]", spinner="dots") if self.context.has_rich else _null_ctx():
                 orders = await _aio.get_event_loop().run_in_executor(
                     None, lambda: broker.orders(status=status, limit=30)
                 )

{aria_code-0.81.0 → aria_code-0.83.0}/src/aria_code/apps/cli/commands/business_workflow_cmds.py

@@ -2,6 +2,8 @@
 
 from __future__ import annotations
 
+from aria_code.apps.cli.i18n import ui_text
+
 from ._business_render import p, print_realty_result, print_risk_scan
 
 
@@ -275,7 +277,7 @@ class BusinessWorkflowCommandsMixin:
 
     async def _run_realty_agent(self, agent_name: str, project_id: str, input_data: dict):
         if self.context.has_rich:
-            with self.context.console.status(f"[dim]运行 {agent_name} Agent...[/dim]", spinner="dots"):
+            with self.context.console.status(f"[dim]{ui_text(self, f'运行 {agent_name} Agent', f'Running the {agent_name} agent')}...[/dim]", spinner="dots"):
                 result = await self._call_realty_agent(agent_name, project_id, input_data)
         else:
             print(f"Running {agent_name}...")
@@ -286,7 +288,8 @@ class BusinessWorkflowCommandsMixin:
     async def _run_realty_team(self, agents: list, project_id: str, input_data: dict):
         import asyncio
         if self.context.has_rich:
-            with self.context.console.status(f"[dim]并行扫描 {', '.join(agents)}...[/dim]", spinner="dots"):
+            _names = ', '.join(agents)
+            with self.context.console.status(f"[dim]{ui_text(self, f'并行扫描 {_names}', f'Scanning {_names} in parallel')}...[/dim]", spinner="dots"):
                 tasks = [self._call_realty_agent(n, project_id, input_data) for n in agents]
                 results = await asyncio.gather(*tasks, return_exceptions=False)
         else:

aria_code-0.83.0/src/aria_code/apps/cli/commands/catalog.py

@@ -0,0 +1,160 @@
+"""Shared CLI command metadata.
+
+This module is intentionally UI-free so future channel adapters such as Feishu
+or a local gateway can reuse the same command categories without importing the
+large terminal implementation.
+"""
+
+from __future__ import annotations
+
+from dataclasses import dataclass
+from typing import FrozenSet, Tuple
+
+
+@dataclass(frozen=True)
+class DirectCommandSpec:
+    name: str
+    method_name: str
+    async_method: bool = False
+    watchable: bool = False
+    aliases: Tuple[str, ...] = ()
+
+    @property
+    def names(self) -> Tuple[str, ...]:
+        return (self.name, *self.aliases)
+
+
+DIRECT_COMMANDS: Tuple[DirectCommandSpec, ...] = (
+    DirectCommandSpec("quote", "cmd_quote", async_method=True, watchable=True),
+    DirectCommandSpec("backtest", "cmd_backtest", async_method=True),
+    DirectCommandSpec("health", "cmd_health", async_method=True, watchable=True),
+    DirectCommandSpec("doctor", "cmd_doctor"),
+    DirectCommandSpec("tools", "cmd_tools"),
+    DirectCommandSpec("skills", "cmd_skills"),
+    DirectCommandSpec("sessions", "cmd_sessions"),
+    DirectCommandSpec("watch", "cmd_watch", aliases=("watchlist",)),
+    DirectCommandSpec("export", "cmd_export", async_method=True),
+    DirectCommandSpec("tv", "cmd_tv", async_method=True),
+    DirectCommandSpec("ashare", "cmd_ashare", async_method=True, aliases=("a-share",)),
+    DirectCommandSpec("markets", "cmd_markets"),
+    DirectCommandSpec("orchestrate", "cmd_orchestrate"),
+)
+
+
+DIRECT_COMMAND_MAP = {
+    alias: spec
+    for spec in DIRECT_COMMANDS
+    for alias in spec.names
+}
+
+
+WATCHABLE_DIRECT_COMMANDS: FrozenSet[str] = frozenset(
+    alias
+    for spec in DIRECT_COMMANDS
+    if spec.watchable
+    for alias in spec.names
+)
+
+
+# Commands shown by default in /help. Other slash commands remain executable but
+# are hidden to keep the startup surface compact.
+VISIBLE_SLASH_COMMANDS: FrozenSet[str] = frozenset({
+    # Session
+    "/help", "/clear", "/compact", "/cost", "/status", "/health",
+    "/regen", "/undo", "/rewind", "/copy", "/recap", "/btw",
+    # Sessions
+    "/save", "/load", "/sessions", "/recall", "/export",
+    # Config
+    "/model", "/thinking", "/config", "/permissions", "/privacy",
+    # Setup & discovery
+    "/setup", "/apikey", "/doctor", "/architecture", "/mcp", "/skills", "/tools", "/packages", "/markets",
+    # Auth
+    "/login", "/logout", "/whoami",
+    # Persistent data (direct writes)
+    "/alert", "/journal", "/watch", "/note", "/todo", "/memory",
+    # Broker
+    "/broker", "/account", "/positions", "/orders", "/paper", "/trade",
+    # Code & project
+    "/project", "/init", "/review", "/code", "/plan", "/orchestrate", "/run", "/tasks", "/delegate", "/canva", "/completions", "/lsp",
+    # Research
+    "/team", "/warehouse", "/deep",
+    # Quant
+    "/backtest", "/wf", "/tv", "/ashare",
+    # UI generation
+    "/ui",
+    # Other
+    "/artifacts", "/vision", "/upload-image", "/file", "/strategy", "/accuracy",
+})
+
+
+# ── What "/" shows ────────────────────────────────────────────────────────────
+# The "/" popup listed every command — 167 of them plus 14 skills, 92 without
+# a category — and /help printed about 90 lines. Codex lists only session
+# controls under "/", shows eight rows, and takes tasks in plain language.
+# Aria keeps every command runnable by name; the popup opens on these two
+# tiers, and typing narrows it over everything.
+
+# Session and setup controls, in popup order.
+CORE_SLASH_COMMANDS: Tuple[str, ...] = (
+    "/help", "/model", "/review", "/plan", "/init", "/status", "/sessions", "/clear",
+    "/compact", "/copy", "/rewind", "/permissions", "/config", "/doctor", "/login",
+)
+
+# One way into each capability: building code, financial analysis, logistics.
+ENTRY_SLASH_COMMANDS: Tuple[str, ...] = (
+    "/code", "/ta", "/backtest", "/team", "/report", "/portfolio", "/inventory", "/carriers",
+)
+
+# Second names for a command; the popup lists the command once.
+COMMAND_ALIASES = {"/upload-image": "/vision"}
+
+
+@dataclass(frozen=True)
+class HelpTopic:
+    key: str
+    title_en: str
+    title_zh: str
+    commands: Tuple[str, ...]
+
+
+HELP_TOPICS: Tuple[HelpTopic, ...] = (
+    HelpTopic("code", "Code and projects", "代码与项目", (
+        "/code", "/project", "/init", "/review", "/plan", "/run", "/read", "/write", "/edit", "/ls",
+        "/search", "/verify", "/scaffold", "/apply", "/changes", "/git")),
+    HelpTopic("market", "Market research", "市场研究", (
+        "/quote", "/analyze", "/ta", "/chart", "/tv", "/deep", "/team", "/report", "/news", "/markets",
+        "/watch", "/alert")),
+    HelpTopic("quant", "Quant and portfolios", "量化与组合", (
+        "/backtest", "/wf", "/compare", "/auto-strategy", "/execution", "/portfolio", "/risk",
+        "/optimize", "/stress", "/factors")),
+    HelpTopic("logistics", "Logistics", "物流", ("/inventory", "/carriers", "/warehouse")),
+    HelpTopic("data", "Notes, files and artifacts", "笔记、文件与产物", (
+        "/journal", "/note", "/todo", "/memory", "/artifacts", "/strategy", "/accuracy", "/file",
+        "/vision", "/ui")),
+    HelpTopic("broker", "Broker and trading", "券商与交易", (
+        "/broker", "/paper", "/trade", "/account", "/positions", "/orders")),
+    HelpTopic("session", "Session", "会话", (
+        "/clear", "/compact", "/cost", "/status", "/health", "/regen", "/undo", "/rewind", "/copy",
+        "/recap", "/btw", "/save", "/load", "/sessions", "/export", "/export-pdf")),
+    HelpTopic("config", "Setup", "设置", (
+        "/model", "/thinking", "/config", "/permissions", "/privacy", "/local", "/update", "/setup",
+        "/apikey", "/doctor", "/mcp", "/login", "/logout", "/skills", "/tools", "/packages")),
+)
+
+HELP_TOPIC_MAP = {topic.key: topic for topic in HELP_TOPICS}
+
+
+def popup_rank(name: str) -> int:
+    """0 for a core command, 1 for an entry point, 2 for everything else."""
+    if name in CORE_SLASH_COMMANDS:
+        return 0
+    if name in ENTRY_SLASH_COMMANDS:
+        return 1
+    return 2
+
+
+def short_description(description: str) -> str:
+    """The description without its usage tail: "Technical indicators: /ta AAPL …" → "Technical indicators"."""
+    text = str(description or "")
+    cut = text.find(": /")
+    return (text[:cut] if cut > 0 else text).strip()

{aria_code-0.81.0 → aria_code-0.83.0}/src/aria_code/apps/cli/commands/core_cmds.py

@@ -13,6 +13,7 @@ NameError，而这正是 requires-python = "<3.14,>=3.10" 声明支持的全部
 全绿。已发布的 4.3.0 同样中招：pip install 后运行 aria-code 直接崩溃。
 """
 
+from aria_code.apps.cli.i18n import ui_text
 from ._ui import print_error
 
 import pathlib
@@ -116,7 +117,11 @@ class CoreCommandsMixin:
         # Contextual help: /help <command>
         from aria_code.apps.cli.skills_catalog import SKILLS
         target = args.strip().lower()
-        if target:
+        if target and target != "all":
+            from aria_code.apps.cli.commands.catalog import HELP_TOPIC_MAP
+            if target in HELP_TOPIC_MAP:
+                self._print_help_topic(HELP_TOPIC_MAP[target])
+                return
             cmd_key = target if target.startswith("/") else f"/{target}"
             if cmd_key in self.commands:
                 _, desc = self.commands[cmd_key]
@@ -148,7 +153,11 @@ class CoreCommandsMixin:
             self.context.console.print(f"[dim]No help for: {target}. Try /help[/dim]" if self.context.has_rich else f"No help for: {target}")
             return
 
-        # Full help listing
+        if not target:
+            self._print_help_overview()
+            return
+
+        # /help all: every command, grouped
         if self.context.has_rich:
             self.context.console.print()
 
@@ -247,6 +256,105 @@ class CoreCommandsMixin:
             print("\nSkills:")
             for s in SKILLS:
                 print(f"  {s['command']:20s} {s['description']}")
+    def _print_help_overview(self) -> None:
+        """One screen: what to type, the core commands, a way into each capability.
+
+        /help printed about 90 lines — every group, every skill — so the
+        commands that matter scrolled out of view. The rest is a topic away.
+        """
+        from aria_code.apps.cli.commands.catalog import (
+            CORE_SLASH_COMMANDS, ENTRY_SLASH_COMMANDS, HELP_TOPICS, short_description,
+        )
+        zh = str(self.terminal.config.get("ui_lang", "en")).lower().startswith("zh")
+        T = (lambda a, b: a) if zh else (lambda a, b: b)
+        core = [(n, short_description(self.commands[n][1])) for n in CORE_SLASH_COMMANDS if n in self.commands]
+        entry = [(n, short_description(self.commands[n][1])) for n in ENTRY_SLASH_COMMANDS if n in self.commands]
+        examples = (
+            T("给 utils.py 补上测试并运行", "Add tests for utils.py and run them"),
+            T("NVDA 这周走势怎么样？", "How's NVDA this week?"),
+            T("看看 skus.csv 哪些 SKU 该补货", "Which SKUs in skus.csv need reordering?"),
+        )
+        topics = " · ".join(t.key for t in HELP_TOPICS)
+        if not self.context.has_rich:
+            print("\n" + T("直接描述要做的事，Aria 会选择工具：", "Describe what you want; Aria picks the tools:"))
+            for example in examples:
+                print(f"  {example}")
+            print("\n" + T("常用命令", "Commands"))
+            for name, desc in core + entry:
+                print(f"  {name:13s} {desc}")
+            print("\n" + T(f"更多：/help {topics} · all · <命令>", f"More: /help {topics} · all · <command>"))
+            return
+
+        from rich.text import Text
+
+        console = self.context.console
+        console.print()
+        console.print(f"[bold]{T('直接描述要做的事', 'Describe what you want')}[/bold]  "
+                      f"[dim]{T('Aria 会选择工具', 'Aria picks the tools')}[/dim]")
+        for example in examples:
+            console.print(f"  [#C08050]{example}[/#C08050]")
+        console.print()
+
+        name_width = max(len(name) for name, _ in core + entry)
+        # indent 2, name, gap 2, description, gap 3, name, gap 2, description
+        desc_width = max(12, (console.width - 2 - 2 * name_width - 2 - 3 - 2) // 2)
+
+        def cell(text: str) -> str:
+            return text if len(text) <= desc_width else text[:desc_width - 1] + "…"
+
+        two_columns = console.width >= 96
+        if not two_columns:
+            desc_width = max(12, console.width - 2 - name_width - 2)
+
+        def grid(rows):
+            if two_columns:
+                half = (len(rows) + 1) // 2
+                pairs = zip(rows[:half], rows[half:] + [("", "")])
+            else:
+                pairs = ((row, ("", "")) for row in rows)
+            lines = Text()
+            for left, right in pairs:
+                lines.append("  " + left[0].ljust(name_width + 2), style="bold #C08050")
+                lines.append(cell(left[1]).ljust(desc_width + 3) if right[0] else cell(left[1]), style="dim")
+                if right[0]:
+                    lines.append(right[0].ljust(name_width + 2), style="bold #C08050")
+                    lines.append(cell(right[1]), style="dim")
+                lines.append("\n")
+            lines.rstrip()
+            return lines
+
+        console.print(f"[bold]{T('命令', 'Commands')}[/bold]")
+        console.print(grid(core))
+        console.print()
+        console.print(f"[bold]{T('开始一项任务', 'Start a task')}[/bold]  "
+                      f"[dim]{T('代码 · 金融分析 · 物流', 'code · financial analysis · logistics')}[/dim]")
+        console.print(grid(entry))
+        console.print()
+        console.print(f"[dim]{T('更多', 'More')}: /help {topics} · all · <{T('命令', 'command')}>[/dim]")
+        console.print(f"[dim]@ {T('附加上下文', 'attaches context')} · ! {T('运行 shell 命令', 'runs a shell command')}"
+                      f" · Esc {T('中断', 'interrupts')}[/dim]")
+        console.print()
+
+    def _print_help_topic(self, topic) -> None:
+        from aria_code.apps.cli.commands.catalog import short_description
+
+        zh = str(self.terminal.config.get("ui_lang", "en")).lower().startswith("zh")
+        rows = [(n, self.commands[n][1]) for n in topic.commands if n in self.commands]
+        title = topic.title_zh if zh else topic.title_en
+        if not self.context.has_rich:
+            print(f"\n{title}")
+            for name, desc in rows:
+                print(f"  {name:16s} {desc}")
+            return
+        from rich.markup import escape
+
+        console = self.context.console
+        console.print()
+        console.print(f"[bold]{title}[/bold]")
+        for name, desc in rows:
+            console.print(f"  [bold #C08050]{name:16s}[/bold #C08050][dim]{escape(desc)}[/dim]", highlight=False)
+        console.print()
+
     async def cmd_artifacts(self, args: str):
         from aria_code.ui.render.output import display_path as _display_path
         from aria_code.apps.cli.helpers import _copy_text_to_clipboard, _open_path_or_url, _reveal_path_in_finder
@@ -2240,7 +2348,7 @@ class CoreCommandsMixin:
             return
         mdc = _get_mdc()
         if self.context.has_rich:
-            with self.context.console.status("[dim]获取全球指数...[/dim]", spinner="dots"):
+            with self.context.console.status(f"[dim]{ui_text(self, '获取全球指数', 'Fetching global indices')}...[/dim]", spinner="dots"):
                 r = mdc.indices()
         else:
             print("  获取全球指数...")
@@ -2287,7 +2395,7 @@ class CoreCommandsMixin:
 
         mdc = _get_mdc()
         if self.context.has_rich:
-            with self.context.console.status(f"[dim]获取{market.upper()}热门股...[/dim]", spinner="dots"):
+            with self.context.console.status(f"[dim]{ui_text(self, f'获取{market.upper()}热门股', f'Fetching top {market.upper()} movers')}...[/dim]", spinner="dots"):
                 r = mdc.hot_stocks(market=market, top_n=top_n)
         else:
             r = mdc.hot_stocks(market=market, top_n=top_n)
@@ -2489,7 +2597,7 @@ class CoreCommandsMixin:
         sub    = parts[1].lower() if len(parts) > 1 else "filings"
 
         if self.context.has_rich:
-            with self.context.console.status(f"[dim]查询 EDGAR {symbol}...[/dim]", spinner="dots"):
+            with self.context.console.status(f"[dim]{ui_text(self, f'查询 EDGAR {symbol}', f'Querying EDGAR for {symbol}')}...[/dim]", spinner="dots"):
                 result = await asyncio.get_event_loop().run_in_executor(
                     None, lambda: _fetch_edgar_data(symbol, sub)
                 )

{aria_code-0.81.0 → aria_code-0.83.0}/src/aria_code/apps/cli/commands/data_cmds.py

@@ -2,6 +2,8 @@
 
 from __future__ import annotations
 
+from aria_code.apps.cli.i18n import ui_text
+
 from ._ui import print_error
 
 
@@ -86,7 +88,7 @@ class DataCommandsMixin:
                     self.context.console.print("[dim]用法: /data sql \"SELECT ...\"|/dim]")
                 return
             if self.context.has_rich:
-                with self.context.console.status("[dim]执行 SQL...[/dim]", spinner="dots"):
+                with self.context.console.status(f"[dim]{ui_text(self, '执行 SQL', 'Running SQL')}...[/dim]", spinner="dots"):
                     r = await loop.run_in_executor(None, sql_query, {"query": query})
             else:
                 r = sql_query({"query": query})
@@ -104,7 +106,7 @@ class DataCommandsMixin:
                 export_data = {"示例数据": [{"symbol": s, "note": "需 yfinance"} for s in watchlist]}
             p = {"data": export_data, "filename": fname}
             if self.context.has_rich:
-                with self.context.console.status("[dim]生成 Excel...[/dim]", spinner="dots"):
+                with self.context.console.status(f"[dim]{ui_text(self, '生成 Excel', 'Building Excel')}...[/dim]", spinner="dots"):
                     r = await loop.run_in_executor(None, export_to_excel, p)
             else:
                 r = export_to_excel(p)
@@ -125,7 +127,7 @@ class DataCommandsMixin:
                     self.context.console.print("[dim]用法: /data load <csv文件路径>[/dim]")
                 return
             if self.context.has_rich:
-                with self.context.console.status("[dim]加载 CSV...[/dim]", spinner="dots"):
+                with self.context.console.status(f"[dim]{ui_text(self, '加载 CSV', 'Loading CSV')}...[/dim]", spinner="dots"):
                     r = await loop.run_in_executor(None, load_csv_data, {"path": csv_path})
             else:
                 r = load_csv_data({"path": csv_path})
@@ -221,7 +223,7 @@ class DataCommandsMixin:
 
         elif sub == "check":
             if self.context.has_rich:
-                with self.context.console.status("[dim]检查价格预警...[/dim]", spinner="dots"):
+                with self.context.console.status(f"[dim]{ui_text(self, '检查价格预警', 'Checking price alerts')}...[/dim]", spinner="dots"):
                     r = await loop.run_in_executor(None, check_alerts)
             else:
                 r = check_alerts()
@@ -262,7 +264,8 @@ class DataCommandsMixin:
             return
 
         if self.context.has_rich:
-            with self.context.console.status(f"[dim]计算 {', '.join(symbols)} 相关性矩阵...[/dim]", spinner="dots"):
+            _names = ', '.join(symbols)
+            with self.context.console.status(f"[dim]{ui_text(self, f'计算 {_names} 相关性矩阵', f'Computing the {_names} correlation matrix')}...[/dim]", spinner="dots"):
                 r = await loop.run_in_executor(None, calc_correlation_matrix,
                                                {"symbols": symbols, "period": period})
         else:
@@ -312,7 +315,8 @@ class DataCommandsMixin:
             p_params["weights"] = weights
 
         if self.context.has_rich:
-            with self.context.console.status(f"[dim]回测 {', '.join(symbols)} ({period})...[/dim]", spinner="dots"):
+            _names = ', '.join(symbols)
+            with self.context.console.status(f"[dim]{ui_text(self, f'回测 {_names} ({period})', f'Backtesting {_names} ({period})')}...[/dim]", spinner="dots"):
                 r = await loop.run_in_executor(None, portfolio_backtest, p_params)
         else:
             r = portfolio_backtest(p_params)
@@ -332,7 +336,7 @@ class DataCommandsMixin:
         import asyncio as _asyncio
         loop = _asyncio.get_event_loop()
         if self.context.has_rich:
-            with self.context.console.status(f"[dim]获取 {symbol} 同行数据...[/dim]", spinner="dots"):
+            with self.context.console.status(f"[dim]{ui_text(self, f'获取 {symbol} 同行数据', f'Fetching {symbol} peer data')}...[/dim]", spinner="dots"):
                 from local_finance_tools import _peer_comparison
                 r = await loop.run_in_executor(None, _peer_comparison,
                                                {"symbol": symbol, "peers": peers})