From 7fe4a0041bbd316f061271882ed918674004efc1 Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?=E8=A2=81=E7=AB=A0=E6=B4=AA?= Date: Mon, 28 Sep 2026 19:29:46 +0800 Subject: [PATCH 1/7] docs(cli): add fund (mutual-fund) channel docs, release notes, changelog MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit Add CLI documentation for the new `longbridge fund` command group under docs/{en,zh-CN,zh-HK}/docs/cli/fund/ — a Funds category with three pages (market data, positions, orders & trading) covering all 28 fund subcommands. Funds are addressed by counter_id (not a stock symbol); submit/cancel prompt for confirmation unless --yes. Also add the CLI v0.29.0 entry to the CLI release notes and the shared changelog in all three locales. The 28 fund endpoints are intentionally NOT documented in the SDK (/docs) or API (/docs/api) reference, since the channel is counter_id-only. --- docs/en/docs/changelog.mdx | 6 ++ docs/en/docs/cli/fund/_category_.json | 1 + docs/en/docs/cli/fund/market.mdx | 101 +++++++++++++++++++++++ docs/en/docs/cli/fund/orders.mdx | 96 +++++++++++++++++++++ docs/en/docs/cli/fund/positions.mdx | 74 +++++++++++++++++ docs/en/docs/cli/release-notes.mdx | 4 + docs/zh-CN/docs/changelog.mdx | 6 ++ docs/zh-CN/docs/cli/fund/_category_.json | 1 + docs/zh-CN/docs/cli/fund/market.mdx | 101 +++++++++++++++++++++++ docs/zh-CN/docs/cli/fund/orders.mdx | 96 +++++++++++++++++++++ docs/zh-CN/docs/cli/fund/positions.mdx | 74 +++++++++++++++++ docs/zh-CN/docs/cli/release-notes.mdx | 4 + docs/zh-HK/docs/changelog.mdx | 6 ++ docs/zh-HK/docs/cli/fund/_category_.json | 1 + docs/zh-HK/docs/cli/fund/market.mdx | 101 +++++++++++++++++++++++ docs/zh-HK/docs/cli/fund/orders.mdx | 96 +++++++++++++++++++++ docs/zh-HK/docs/cli/fund/positions.mdx | 74 +++++++++++++++++ docs/zh-HK/docs/cli/release-notes.mdx | 4 + 18 files changed, 846 insertions(+) create mode 100644 docs/en/docs/cli/fund/_category_.json create mode 100644 docs/en/docs/cli/fund/market.mdx create mode 100644 docs/en/docs/cli/fund/orders.mdx create mode 100644 docs/en/docs/cli/fund/positions.mdx create mode 100644 docs/zh-CN/docs/cli/fund/_category_.json create mode 100644 docs/zh-CN/docs/cli/fund/market.mdx create mode 100644 docs/zh-CN/docs/cli/fund/orders.mdx create mode 100644 docs/zh-CN/docs/cli/fund/positions.mdx create mode 100644 docs/zh-HK/docs/cli/fund/_category_.json create mode 100644 docs/zh-HK/docs/cli/fund/market.mdx create mode 100644 docs/zh-HK/docs/cli/fund/orders.mdx create mode 100644 docs/zh-HK/docs/cli/fund/positions.mdx diff --git a/docs/en/docs/changelog.mdx b/docs/en/docs/changelog.mdx index b6ad6f78..c53a36ca 100644 --- a/docs/en/docs/changelog.mdx +++ b/docs/en/docs/changelog.mdx @@ -6,6 +6,12 @@ sidebar_position: 7 sidebar_icon: newspaper --- +## 2026-09-28 + +### CLI v0.29.0 + +- **[Hong Kong mutual funds in the terminal](/docs/cli/fund/market)** — the new `longbridge fund` command group covers the whole channel: browse the catalog and a fund's detail, analysis, trend, returns, performance, NAV and holdings; review your fund positions; and validate, submit and cancel fund orders. Funds are addressed by `counter_id` (e.g. `UT/FD/HK0000384492`); `submit-order` / `cancel-order` prompt for confirmation unless `--yes` + ## 2026-08-19 ### CLI v0.28.0 diff --git a/docs/en/docs/cli/fund/_category_.json b/docs/en/docs/cli/fund/_category_.json new file mode 100644 index 00000000..9b253dac --- /dev/null +++ b/docs/en/docs/cli/fund/_category_.json @@ -0,0 +1 @@ +{ "label": "Funds", "icon": "coins", "position": 11, "collapsed": true } diff --git a/docs/en/docs/cli/fund/market.mdx b/docs/en/docs/cli/fund/market.mdx new file mode 100644 index 00000000..d8addcde --- /dev/null +++ b/docs/en/docs/cli/fund/market.mdx @@ -0,0 +1,101 @@ +--- +title: 'market data' +sidebar_label: 'market data' +sidebar_position: 1 +--- + +# longbridge fund (market data) + +Browse the mutual-fund catalog and a fund's market data from the terminal — the hot list, the filterable fund list, and per-fund detail, analysis, trend, returns, performance, net value (NAV) and holdings. + +Every fund is identified by its **`counter_id`** (e.g. `UT/FD/HK0000384492`), not a stock symbol. Get one from `longbridge fund hot` or `longbridge fund list`, then pass it as the positional argument to the other commands. + +## Basic Usage + +```bash +# Hot-selling funds — a good source of counter_ids +longbridge fund hot +``` + +``` +| Counter ID | Name | Currency | Earning Rate | Risk Level | +|---------------------|-------------------------------|----------|--------------|------------| +| UT/FD/HK0000384492 | Allianz Income and Growth | USD | 12.34% | Medium | +| UT/FD/KYG3861F1019 | JPMorgan Global Bond | USD | 4.21% | Low | +``` + +## Examples + +### Discover funds + +```bash +# Hot-selling fund list +longbridge fund hot +# Full fund list, optionally narrowed by quick-filter ids and earning-rate intervals +longbridge fund list +longbridge fund list --quick-id 1 --quick-id 2 --time-interval 1m --time-interval 1y +# The filter options you can pass to `list` +longbridge fund filters +``` + +### Fund detail & analysis + +```bash +# Fund profile: name, ISIN, risk level, manager, fees… +longbridge fund detail UT/FD/HK0000384492 +# Analysis (level 1) and the deeper level-2 breakdown; --period selects the window +longbridge fund analysis UT/FD/HK0000384492 +longbridge fund analysis-detail UT/FD/HK0000384492 --period 3 +# Trend chart data +longbridge fund trend UT/FD/HK0000384492 +``` + +### Returns & performance + +```bash +# Annual / quarterly returns (paged) +longbridge fund annual-returns UT/FD/HK0000384492 --page 1 --size 20 +longbridge fund quarterly-returns UT/FD/HK0000384492 +# Performance figures, and a peer comparison +longbridge fund performance UT/FD/HK0000384492 +longbridge fund performance-comparison UT/FD/HK0000384492 --period 3 +``` + +### Net value (NAV) + +```bash +# Latest NAV +longbridge fund nav UT/FD/HK0000384492 +# Historical NAV — paged, or by a relative time range +longbridge fund nav-history UT/FD/HK0000384492 --page 1 --size 30 +longbridge fund nav-range UT/FD/HK0000384492 --month-before 6 +longbridge fund nav-range UT/FD/HK0000384492 --year-before 1 +``` + +### Holdings + +```bash +# A fund's top-10 holdings (--scene selects the breakdown) +longbridge fund holdings UT/FD/HK0000384492 +# Reverse lookup: which funds hold a given stock +longbridge fund stock-holdings UT/FD/HK0000384492 --limit 20 +``` + +Add `--format json` to any command for machine-readable output. + +## Options + +| Option | Commands | Description | Default | +| ------ | -------- | ----------- | ------- | +| `--quick-id` | `list` | Quick-filter id (repeatable) | — | +| `--time-interval` | `list` | Earning-rate interval, e.g. `1m` `3m` `1y` (repeatable) | — | +| `--period` | `analysis`, `analysis-detail`, `trend`, `performance-comparison` | Analysis / comparison period selector | — | +| `--page` / `--size` | `annual-returns`, `quarterly-returns`, `nav-history` | Page number and page size | — | +| `--month-before` / `--year-before` | `nav-range` | Relative NAV window before now | — | +| `--scene` | `holdings` | Holdings breakdown scene | — | +| `--limit` | `stock-holdings` | Max number of stocks to return | — | +| `--format` | all | Output format: `table` \| `json` | `table` | + +## Requirements + +These are market-data commands and need no account permission. Funds are addressed by `counter_id`, which you obtain from `fund hot` / `fund list`. For your holdings and orders, see [my positions](/docs/cli/fund/positions) and [orders & trading](/docs/cli/fund/orders). diff --git a/docs/en/docs/cli/fund/orders.mdx b/docs/en/docs/cli/fund/orders.mdx new file mode 100644 index 00000000..9ee1678b --- /dev/null +++ b/docs/en/docs/cli/fund/orders.mdx @@ -0,0 +1,96 @@ +--- +title: 'orders & trading' +sidebar_label: 'orders & trading' +sidebar_position: 3 +--- + +# longbridge fund (orders & trading) + +Manage mutual-fund orders from the terminal — list your orders and transactions, inspect one order, validate an order before sending it, and submit or cancel an order. + +Funds are identified by their **`counter_id`** (e.g. `UT/FD/HK0000384492`). These commands act on your account, so they require login; `submit-order` and `cancel-order` move real money and prompt for confirmation unless you pass `--yes`. + +## Basic Usage + +```bash +# Your fund orders (also the trade / execution record) +longbridge fund orders +``` + +``` +| Order ID | Counter ID | Action | Amount | Units | Status | Currency | Created At | +|--------------------|---------------------|--------|--------|---------|-----------|----------|----------------------| +| 776181234567890123 | UT/FD/HK0000384492 | Buy | 100.00 | — | Filled | USD | 2026-09-20 10:03:11 | +``` + +## Examples + +### Inspect orders & transactions + +```bash +# All fund orders, or filtered +longbridge fund orders +longbridge fund orders --counter-id UT/FD/HK0000384492 --action buy --state filled \ + --currency USD --start 2026-01-01 --end 2026-09-30 --page 1 --size 20 +# One order's detail +longbridge fund order 776181234567890123 +# Cash-flow transaction records +longbridge fund transactions --currencies USD,HKD --start 2026-01-01 --end 2026-09-30 +``` + +### Validate before you buy + +```bash +# Dry-run validation — places NO order, returns fees / estimated units / limits +longbridge fund validate-order UT/FD/KYG3861F1019 --action buy --currency USD --amount 100 +``` + +### Submit an order + +```bash +# Buy by cash amount (prompts for confirmation) +longbridge fund submit-order UT/FD/KYG3861F1019 --action buy --currency USD --amount 100 +# Sell by units, skipping the prompt +longbridge fund submit-order UT/FD/KYG3861F1019 --action sell --currency USD --units 50 --yes +# Sell the entire holding +longbridge fund submit-order UT/FD/KYG3861F1019 --action sell --currency USD --sell-all --yes +``` + +### Cancel an order + +```bash +# Withdraw an unfilled order (prompts for confirmation) +longbridge fund cancel-order 776181234567890123 +longbridge fund cancel-order 776181234567890123 --yes +``` + +Add `--format json` to any command for machine-readable output. + +## Options + +| Option | Commands | Description | Default | +| ------ | -------- | ----------- | ------- | +| `--counter-id` | `orders` | Filter by fund counter id (repeatable) | — | +| `--action` | `orders`, `validate-order`, `submit-order` | `orders`: filter (`buy,sell`); order commands: `buy` \| `sell` | — | +| `--state` | `orders` | Filter by state(s), comma-separated | — | +| `--currency` | `orders`, `validate-order`, `submit-order` | Currency (e.g. `USD`, `HKD`) | — | +| `--business-type` / `--category` / `--currencies` | `transactions` | Transaction filters | — | +| `--start` / `--end` | `orders`, `transactions` | Date range (`YYYY-MM-DD` or RFC 3339) | — | +| `--page` / `--size` | `orders`, `transactions` | Page number and page size | — | +| `--amount` | `validate-order`, `submit-order` | Cash amount (amount-based order) | — | +| `--units` | `validate-order`, `submit-order` | Unit count (unit-based order) | — | +| `--dividend-option` | `validate-order`, `submit-order` | Dividend option | — | +| `--fund-source` | `validate-order` | Fund source | — | +| `--fee` | `submit-order` | Fee | — | +| `--sell-all` | `submit-order` | Sell the entire holding | false | +| `--remark` | `submit-order` | Order remark / note | — | +| `--yes` | `submit-order`, `cancel-order` | Skip the interactive confirmation | false | +| `--format` | all | Output format: `table` \| `json` | `table` | + +## Requirements + +OAuth trade permission is required — run `longbridge auth login` first. Always `validate-order` (or run `submit-order` without `--yes` to see the confirmation) before committing real capital. Funds are addressed by `counter_id` (from [`fund hot` / `fund list`](/docs/cli/fund/market)). + +## Notes + +`submit-order` and `cancel-order` affect live capital and prompt for confirmation before running; pass `--yes` only in trusted, non-interactive contexts. diff --git a/docs/en/docs/cli/fund/positions.mdx b/docs/en/docs/cli/fund/positions.mdx new file mode 100644 index 00000000..49054b39 --- /dev/null +++ b/docs/en/docs/cli/fund/positions.mdx @@ -0,0 +1,74 @@ +--- +title: 'positions' +sidebar_label: 'positions' +sidebar_position: 2 +--- + +# longbridge fund (positions) + +Review your mutual-fund holdings — the positions overview, a single holding's detail, and its performance, cumulative profit, net-value history and dividends. + +Funds are identified by their **`counter_id`** (e.g. `UT/FD/HK0000384492`). These commands read your account, so they require login. + +## Basic Usage + +```bash +# Overview of every fund you hold +longbridge fund positions +``` + +``` +| Counter ID | Name | Currency | Holding Units | Cost NAV | Current NAV | Holding Profit | +|---------------------|-----------------------------|----------|---------------|----------|-------------|----------------| +| UT/FD/HK0000384492 | Allianz Income and Growth | USD | 1250.00 | 9.812 | 10.431 | +773.75 | +``` + +## Examples + +### Positions overview + +```bash +longbridge fund positions +# Scope to a specific sub-account +longbridge fund positions --account-channel lb --aaid 123456 +``` + +### A single holding + +```bash +# Detail of one held fund, optionally over a date range +longbridge fund position UT/FD/HK0000384492 +longbridge fund position UT/FD/HK0000384492 --start 2026-01-01 --end 2026-06-30 +``` + +### Performance, profit, NAV & dividends of a held fund + +```bash +# Performance figures for a fund you hold +longbridge fund position-performance UT/FD/HK0000384492 +# Cumulative-profit series (paged, date range) +longbridge fund position-profits UT/FD/HK0000384492 --start 2026-01-01 --end 2026-06-30 --page 1 --size 30 +# Net-value history over a relative window +longbridge fund position-nav UT/FD/HK0000384492 --month-before 6 +longbridge fund position-nav UT/FD/HK0000384492 --year-before 1 +# Dividend records +longbridge fund position-dividends UT/FD/HK0000384492 --currency USD --page 1 --size 20 +``` + +Add `--format json` to any command for machine-readable output. + +## Options + +| Option | Commands | Description | Default | +| ------ | -------- | ----------- | ------- | +| `--account-channel` | `positions`, `position` | Account channel | — | +| `--aaid` | `positions`, `position` | Sub-account id | — | +| `--start` / `--end` | `position`, `position-profits`, `position-dividends` | Date range (`YYYY-MM-DD` or RFC 3339) | — | +| `--month-before` / `--year-before` | `position-nav` | Relative NAV window before now | — | +| `--currency` | `position-dividends` | Currency filter (e.g. `HKD`, `USD`) | — | +| `--page` / `--size` | `position-profits`, `position-dividends` | Page number and page size | — | +| `--format` | all | Output format: `table` \| `json` | `table` | + +## Requirements + +OAuth account permission is required — run `longbridge auth login` first. Funds are addressed by `counter_id` (from [`fund hot` / `fund list`](/docs/cli/fund/market)). To place or cancel fund orders, see [orders & trading](/docs/cli/fund/orders). diff --git a/docs/en/docs/cli/release-notes.mdx b/docs/en/docs/cli/release-notes.mdx index 5100b213..2122b0e1 100644 --- a/docs/en/docs/cli/release-notes.mdx +++ b/docs/en/docs/cli/release-notes.mdx @@ -7,6 +7,10 @@ sidebar_icon: newspaper # Release Notes +### [v0.29.0](https://github.com/longbridge/longbridge-terminal/releases/tag/v0.29.0) + +- **New `fund` command group — Hong Kong mutual funds** — `longbridge fund` brings the mutual-fund channel to the terminal: browse the catalog (`hot`, `list`, `filters`), read a fund's `detail`, `analysis` / `analysis-detail`, `trend`, `annual-returns` / `quarterly-returns`, `performance` / `performance-comparison`, latest and historical NAV (`nav`, `nav-history`, `nav-range`) and `holdings` / `stock-holdings`; review your holdings (`positions`, `position`, `position-performance`, `position-profits`, `position-nav`, `position-dividends`); and manage orders (`orders`, `order`, `transactions`, `validate-order`, `submit-order`, `cancel-order`). Funds are addressed by `counter_id` (e.g. `UT/FD/HK0000384492`), not a stock symbol — get one from `fund hot` / `fund list`. `submit-order` and `cancel-order` prompt for confirmation unless `--yes`. See the [Funds](/docs/cli/fund/market) docs + ### [v0.28.0](https://github.com/longbridge/longbridge-terminal/releases/tag/v0.28.0) - **[Chat with LongbridgeAI in the terminal](/docs/cli/ai)** — the new `longbridge ai` command opens a full-screen chat: answers stream in as Markdown with terminal-drawn charts, box-drawn tables, syntax-highlighted code and live quote cards. A title-bar ticker follows every security the conversation mentions (click one for a full quote card), slash commands cover `/new` `/retry` `/copy` `/export` `/quote` `/resume` `/settings` `/agent` `/login`, and conversations are stored on your account — a chat started in the terminal continues wherever else you use LongbridgeAI diff --git a/docs/zh-CN/docs/changelog.mdx b/docs/zh-CN/docs/changelog.mdx index 5584fc4b..05e68312 100644 --- a/docs/zh-CN/docs/changelog.mdx +++ b/docs/zh-CN/docs/changelog.mdx @@ -6,6 +6,12 @@ sidebar_position: 7 sidebar_icon: newspaper --- +## 2026-09-28 + +### CLI v0.29.0 + +- **[香港互惠基金进入终端](/zh-CN/docs/cli/fund/market)** — 新增 `longbridge fund` 命令组,覆盖整个基金渠道:浏览目录及单只基金的详情、分析、走势、收益、业绩、净值与持仓;查看你的基金持仓;并校验、提交与撤销基金订单。基金以 `counter_id`(如 `UT/FD/HK0000384492`)寻址;`submit-order` / `cancel-order` 除非传 `--yes` 否则会要求确认 + ## 2026-08-19 ### CLI v0.28.0 diff --git a/docs/zh-CN/docs/cli/fund/_category_.json b/docs/zh-CN/docs/cli/fund/_category_.json new file mode 100644 index 00000000..4d719079 --- /dev/null +++ b/docs/zh-CN/docs/cli/fund/_category_.json @@ -0,0 +1 @@ +{ "label": "基金", "icon": "coins", "position": 11, "collapsed": true } diff --git a/docs/zh-CN/docs/cli/fund/market.mdx b/docs/zh-CN/docs/cli/fund/market.mdx new file mode 100644 index 00000000..732b5bb7 --- /dev/null +++ b/docs/zh-CN/docs/cli/fund/market.mdx @@ -0,0 +1,101 @@ +--- +title: 'market data' +sidebar_label: 'market data' +sidebar_position: 1 +--- + +# longbridge fund（行情数据） + +在终端浏览基金目录与单只基金的行情数据——热销榜、可筛选的基金列表，以及单只基金的详情、分析、走势、收益、业绩、净值（NAV）与持仓。 + +每只基金以其 **`counter_id`**（如 `UT/FD/HK0000384492`）标识，而非股票 symbol。可从 `longbridge fund hot` 或 `longbridge fund list` 获取,再作为位置参数传给其他命令。 + +## 基本用法 + +```bash +# 热销基金——获取 counter_id 的好起点 +longbridge fund hot +``` + +``` +| Counter ID | Name | Currency | Earning Rate | Risk Level | +|---------------------|-------------------------------|----------|--------------|------------| +| UT/FD/HK0000384492 | Allianz Income and Growth | USD | 12.34% | Medium | +| UT/FD/KYG3861F1019 | JPMorgan Global Bond | USD | 4.21% | Low | +``` + +## 示例 + +### 发现基金 + +```bash +# 热销基金列表 +longbridge fund hot +# 完整基金列表,可用快捷筛选 id 与收益率区间收窄 +longbridge fund list +longbridge fund list --quick-id 1 --quick-id 2 --time-interval 1m --time-interval 1y +# 可传给 list 的筛选选项 +longbridge fund filters +``` + +### 基金详情与分析 + +```bash +# 基金档案:名称、ISIN、风险等级、管理人、费用…… +longbridge fund detail UT/FD/HK0000384492 +# 分析(一级)与更深入的二级拆解;--period 选择周期 +longbridge fund analysis UT/FD/HK0000384492 +longbridge fund analysis-detail UT/FD/HK0000384492 --period 3 +# 走势图数据 +longbridge fund trend UT/FD/HK0000384492 +``` + +### 收益与业绩 + +```bash +# 年度 / 季度收益(分页) +longbridge fund annual-returns UT/FD/HK0000384492 --page 1 --size 20 +longbridge fund quarterly-returns UT/FD/HK0000384492 +# 业绩数据,以及同类比较 +longbridge fund performance UT/FD/HK0000384492 +longbridge fund performance-comparison UT/FD/HK0000384492 --period 3 +``` + +### 净值（NAV） + +```bash +# 最新净值 +longbridge fund nav UT/FD/HK0000384492 +# 历史净值——分页,或按相对时间区间 +longbridge fund nav-history UT/FD/HK0000384492 --page 1 --size 30 +longbridge fund nav-range UT/FD/HK0000384492 --month-before 6 +longbridge fund nav-range UT/FD/HK0000384492 --year-before 1 +``` + +### 持仓 + +```bash +# 基金前十大持仓(--scene 选择拆解口径) +longbridge fund holdings UT/FD/HK0000384492 +# 反向查询:哪些基金持有某只股票 +longbridge fund stock-holdings UT/FD/HK0000384492 --limit 20 +``` + +任意命令加 `--format json` 可输出机器可读格式。 + +## 选项 + +| 选项 | 命令 | 说明 | 默认 | +| ---- | ---- | ---- | ---- | +| `--quick-id` | `list` | 快捷筛选 id(可重复) | — | +| `--time-interval` | `list` | 收益率区间,如 `1m` `3m` `1y`(可重复) | — | +| `--period` | `analysis`、`analysis-detail`、`trend`、`performance-comparison` | 分析 / 比较周期 | — | +| `--page` / `--size` | `annual-returns`、`quarterly-returns`、`nav-history` | 页码与每页条数 | — | +| `--month-before` / `--year-before` | `nav-range` | 相对当前的净值时间窗 | — | +| `--scene` | `holdings` | 持仓拆解口径 | — | +| `--limit` | `stock-holdings` | 返回股票数量上限 | — | +| `--format` | 全部 | 输出格式:`table` \| `json` | `table` | + +## 要求 + +这些是行情数据命令,无需账户权限。基金以 `counter_id` 寻址,可从 `fund hot` / `fund list` 获取。查看你的持仓与订单,见 [我的持仓](/zh-CN/docs/cli/fund/positions) 与 [订单与交易](/zh-CN/docs/cli/fund/orders)。 diff --git a/docs/zh-CN/docs/cli/fund/orders.mdx b/docs/zh-CN/docs/cli/fund/orders.mdx new file mode 100644 index 00000000..e94bafe2 --- /dev/null +++ b/docs/zh-CN/docs/cli/fund/orders.mdx @@ -0,0 +1,96 @@ +--- +title: 'orders & trading' +sidebar_label: 'orders & trading' +sidebar_position: 3 +--- + +# longbridge fund（订单与交易） + +在终端管理基金订单——列出订单与交易流水、查看单笔订单、下单前校验,以及提交或撤销订单。 + +基金以其 **`counter_id`**（如 `UT/FD/HK0000384492`）标识。这些命令作用于你的账户,需要登录;`submit-order` 与 `cancel-order` 动用真实资金,除非传 `--yes`,否则会要求确认。 + +## 基本用法 + +```bash +# 你的基金订单(同时也是成交 / 交易记录) +longbridge fund orders +``` + +``` +| Order ID | Counter ID | Action | Amount | Units | Status | Currency | Created At | +|--------------------|---------------------|--------|--------|---------|-----------|----------|----------------------| +| 776181234567890123 | UT/FD/HK0000384492 | Buy | 100.00 | — | Filled | USD | 2026-09-20 10:03:11 | +``` + +## 示例 + +### 查看订单与流水 + +```bash +# 全部基金订单,或按条件筛选 +longbridge fund orders +longbridge fund orders --counter-id UT/FD/HK0000384492 --action buy --state filled \ + --currency USD --start 2026-01-01 --end 2026-09-30 --page 1 --size 20 +# 单笔订单详情 +longbridge fund order 776181234567890123 +# 资金流水记录 +longbridge fund transactions --currencies USD,HKD --start 2026-01-01 --end 2026-09-30 +``` + +### 下单前校验 + +```bash +# 试运行校验——不会下单,返回费用 / 预估份额 / 限额 +longbridge fund validate-order UT/FD/KYG3861F1019 --action buy --currency USD --amount 100 +``` + +### 提交订单 + +```bash +# 按金额买入(会要求确认) +longbridge fund submit-order UT/FD/KYG3861F1019 --action buy --currency USD --amount 100 +# 按份额卖出,跳过确认 +longbridge fund submit-order UT/FD/KYG3861F1019 --action sell --currency USD --units 50 --yes +# 全部卖出 +longbridge fund submit-order UT/FD/KYG3861F1019 --action sell --currency USD --sell-all --yes +``` + +### 撤销订单 + +```bash +# 撤销未成交的订单(会要求确认) +longbridge fund cancel-order 776181234567890123 +longbridge fund cancel-order 776181234567890123 --yes +``` + +任意命令加 `--format json` 可输出机器可读格式。 + +## 选项 + +| 选项 | 命令 | 说明 | 默认 | +| ---- | ---- | ---- | ---- | +| `--counter-id` | `orders` | 按基金 counter id 筛选(可重复) | — | +| `--action` | `orders`、`validate-order`、`submit-order` | `orders`:筛选(`buy,sell`);下单命令:`buy` \| `sell` | — | +| `--state` | `orders` | 按状态筛选,逗号分隔 | — | +| `--currency` | `orders`、`validate-order`、`submit-order` | 币种(如 `USD`、`HKD`) | — | +| `--business-type` / `--category` / `--currencies` | `transactions` | 流水筛选条件 | — | +| `--start` / `--end` | `orders`、`transactions` | 日期区间(`YYYY-MM-DD` 或 RFC 3339) | — | +| `--page` / `--size` | `orders`、`transactions` | 页码与每页条数 | — | +| `--amount` | `validate-order`、`submit-order` | 金额(按金额下单) | — | +| `--units` | `validate-order`、`submit-order` | 份额(按份额下单) | — | +| `--dividend-option` | `validate-order`、`submit-order` | 分红方式 | — | +| `--fund-source` | `validate-order` | 资金来源 | — | +| `--fee` | `submit-order` | 费用 | — | +| `--sell-all` | `submit-order` | 卖出全部持仓 | false | +| `--remark` | `submit-order` | 订单备注 | — | +| `--yes` | `submit-order`、`cancel-order` | 跳过交互式确认 | false | +| `--format` | 全部 | 输出格式:`table` \| `json` | `table` | + +## 要求 + +需要 OAuth 交易权限——先运行 `longbridge auth login`。动用真实资金前,务必先 `validate-order`(或不带 `--yes` 运行 `submit-order` 以查看确认信息)。基金以 `counter_id` 寻址(来自 [`fund hot` / `fund list`](/zh-CN/docs/cli/fund/market))。 + +## 说明 + +`submit-order` 与 `cancel-order` 动用真实资金,运行前会要求确认;仅在可信、非交互场景下传 `--yes`。 diff --git a/docs/zh-CN/docs/cli/fund/positions.mdx b/docs/zh-CN/docs/cli/fund/positions.mdx new file mode 100644 index 00000000..6b81f370 --- /dev/null +++ b/docs/zh-CN/docs/cli/fund/positions.mdx @@ -0,0 +1,74 @@ +--- +title: 'positions' +sidebar_label: 'positions' +sidebar_position: 2 +--- + +# longbridge fund（持仓） + +查看你的基金持仓——持仓总览、单只持仓详情,及其业绩、累计收益、净值历史与分红。 + +基金以其 **`counter_id`**（如 `UT/FD/HK0000384492`）标识。这些命令读取你的账户,需要登录。 + +## 基本用法 + +```bash +# 你持有的每只基金总览 +longbridge fund positions +``` + +``` +| Counter ID | Name | Currency | Holding Units | Cost NAV | Current NAV | Holding Profit | +|---------------------|-----------------------------|----------|---------------|----------|-------------|----------------| +| UT/FD/HK0000384492 | Allianz Income and Growth | USD | 1250.00 | 9.812 | 10.431 | +773.75 | +``` + +## 示例 + +### 持仓总览 + +```bash +longbridge fund positions +# 限定到某个子账户 +longbridge fund positions --account-channel lb --aaid 123456 +``` + +### 单只持仓 + +```bash +# 单只持有基金的详情,可选日期区间 +longbridge fund position UT/FD/HK0000384492 +longbridge fund position UT/FD/HK0000384492 --start 2026-01-01 --end 2026-06-30 +``` + +### 持有基金的业绩、收益、净值与分红 + +```bash +# 持有基金的业绩数据 +longbridge fund position-performance UT/FD/HK0000384492 +# 累计收益序列(分页、日期区间) +longbridge fund position-profits UT/FD/HK0000384492 --start 2026-01-01 --end 2026-06-30 --page 1 --size 30 +# 相对时间窗内的净值历史 +longbridge fund position-nav UT/FD/HK0000384492 --month-before 6 +longbridge fund position-nav UT/FD/HK0000384492 --year-before 1 +# 分红记录 +longbridge fund position-dividends UT/FD/HK0000384492 --currency USD --page 1 --size 20 +``` + +任意命令加 `--format json` 可输出机器可读格式。 + +## 选项 + +| 选项 | 命令 | 说明 | 默认 | +| ---- | ---- | ---- | ---- | +| `--account-channel` | `positions`、`position` | 账户渠道 | — | +| `--aaid` | `positions`、`position` | 子账户 id | — | +| `--start` / `--end` | `position`、`position-profits`、`position-dividends` | 日期区间(`YYYY-MM-DD` 或 RFC 3339) | — | +| `--month-before` / `--year-before` | `position-nav` | 相对当前的净值时间窗 | — | +| `--currency` | `position-dividends` | 币种筛选(如 `HKD`、`USD`) | — | +| `--page` / `--size` | `position-profits`、`position-dividends` | 页码与每页条数 | — | +| `--format` | 全部 | 输出格式:`table` \| `json` | `table` | + +## 要求 + +需要 OAuth 账户权限——先运行 `longbridge auth login`。基金以 `counter_id` 寻址(来自 [`fund hot` / `fund list`](/zh-CN/docs/cli/fund/market))。下单或撤单见 [订单与交易](/zh-CN/docs/cli/fund/orders)。 diff --git a/docs/zh-CN/docs/cli/release-notes.mdx b/docs/zh-CN/docs/cli/release-notes.mdx index 23228971..93544534 100644 --- a/docs/zh-CN/docs/cli/release-notes.mdx +++ b/docs/zh-CN/docs/cli/release-notes.mdx @@ -7,6 +7,10 @@ sidebar_icon: newspaper # Release Notes +### [v0.29.0](https://github.com/longbridge/longbridge-terminal/releases/tag/v0.29.0) + +- **新增 `fund` 命令组 —— 香港互惠基金** — `longbridge fund` 把基金渠道带入终端:浏览目录(`hot`、`list`、`filters`),查看单只基金的 `detail`、`analysis` / `analysis-detail`、`trend`、`annual-returns` / `quarterly-returns`、`performance` / `performance-comparison`、最新与历史净值(`nav`、`nav-history`、`nav-range`)以及 `holdings` / `stock-holdings`;查看你的持仓(`positions`、`position`、`position-performance`、`position-profits`、`position-nav`、`position-dividends`);并管理订单(`orders`、`order`、`transactions`、`validate-order`、`submit-order`、`cancel-order`)。基金以 `counter_id`(如 `UT/FD/HK0000384492`)寻址,而非股票 symbol —— 可从 `fund hot` / `fund list` 获取。`submit-order` 与 `cancel-order` 除非传 `--yes` 否则会要求确认。详见 [基金](/zh-CN/docs/cli/fund/market) 文档 + ### [v0.28.0](https://github.com/longbridge/longbridge-terminal/releases/tag/v0.28.0) - **[在终端里与 LongbridgeAI 对话](/zh-CN/docs/cli/ai)** — 新增 `longbridge ai` 命令，打开全屏对话界面：回答实时流式返回，以 Markdown 渲染，图表、表格、语法高亮代码和实时行情卡片都直接画在终端里。标题栏行情条跟随对话提到的每一只标的（点击即展开完整行情卡片），斜杠命令覆盖 `/new` `/retry` `/copy` `/export` `/quote` `/resume` `/settings` `/agent` `/login`；对话保存在你的账户上，在终端开始的对话可以在其他使用 LongbridgeAI 的地方继续 diff --git a/docs/zh-HK/docs/changelog.mdx b/docs/zh-HK/docs/changelog.mdx index f7ae42f1..42a8702b 100644 --- a/docs/zh-HK/docs/changelog.mdx +++ b/docs/zh-HK/docs/changelog.mdx @@ -6,6 +6,12 @@ sidebar_position: 7 sidebar_icon: newspaper --- +## 2026-09-28 + +### CLI v0.29.0 + +- **[香港互惠基金進入終端](/zh-HK/docs/cli/fund/market)** — 新增 `longbridge fund` 命令組,覆蓋整個基金渠道:瀏覽目錄及單隻基金的詳情、分析、走勢、收益、業績、淨值與持倉;查看你的基金持倉;並校驗、提交與撤銷基金訂單。基金以 `counter_id`(如 `UT/FD/HK0000384492`)尋址;`submit-order` / `cancel-order` 除非傳 `--yes` 否則會要求確認 + ## 2026-08-19 ### CLI v0.28.0 diff --git a/docs/zh-HK/docs/cli/fund/_category_.json b/docs/zh-HK/docs/cli/fund/_category_.json new file mode 100644 index 00000000..4d719079 --- /dev/null +++ b/docs/zh-HK/docs/cli/fund/_category_.json @@ -0,0 +1 @@ +{ "label": "基金", "icon": "coins", "position": 11, "collapsed": true } diff --git a/docs/zh-HK/docs/cli/fund/market.mdx b/docs/zh-HK/docs/cli/fund/market.mdx new file mode 100644 index 00000000..dfe21e21 --- /dev/null +++ b/docs/zh-HK/docs/cli/fund/market.mdx @@ -0,0 +1,101 @@ +--- +title: 'market data' +sidebar_label: 'market data' +sidebar_position: 1 +--- + +# longbridge fund（行情數據） + +在終端瀏覽基金目錄與單隻基金的行情數據——熱銷榜、可篩選的基金列表,以及單隻基金的詳情、分析、走勢、收益、業績、淨值（NAV）與持倉。 + +每隻基金以其 **`counter_id`**（如 `UT/FD/HK0000384492`）標識,而非股票 symbol。可從 `longbridge fund hot` 或 `longbridge fund list` 獲取,再作為位置參數傳給其他命令。 + +## 基本用法 + +```bash +# 熱銷基金——獲取 counter_id 的好起點 +longbridge fund hot +``` + +``` +| Counter ID | Name | Currency | Earning Rate | Risk Level | +|---------------------|-------------------------------|----------|--------------|------------| +| UT/FD/HK0000384492 | Allianz Income and Growth | USD | 12.34% | Medium | +| UT/FD/KYG3861F1019 | JPMorgan Global Bond | USD | 4.21% | Low | +``` + +## 示例 + +### 發現基金 + +```bash +# 熱銷基金列表 +longbridge fund hot +# 完整基金列表,可用快捷篩選 id 與收益率區間收窄 +longbridge fund list +longbridge fund list --quick-id 1 --quick-id 2 --time-interval 1m --time-interval 1y +# 可傳給 list 的篩選選項 +longbridge fund filters +``` + +### 基金詳情與分析 + +```bash +# 基金檔案:名稱、ISIN、風險等級、管理人、費用…… +longbridge fund detail UT/FD/HK0000384492 +# 分析(一級)與更深入的二級拆解;--period 選擇週期 +longbridge fund analysis UT/FD/HK0000384492 +longbridge fund analysis-detail UT/FD/HK0000384492 --period 3 +# 走勢圖數據 +longbridge fund trend UT/FD/HK0000384492 +``` + +### 收益與業績 + +```bash +# 年度 / 季度收益(分頁) +longbridge fund annual-returns UT/FD/HK0000384492 --page 1 --size 20 +longbridge fund quarterly-returns UT/FD/HK0000384492 +# 業績數據,以及同類比較 +longbridge fund performance UT/FD/HK0000384492 +longbridge fund performance-comparison UT/FD/HK0000384492 --period 3 +``` + +### 淨值（NAV） + +```bash +# 最新淨值 +longbridge fund nav UT/FD/HK0000384492 +# 歷史淨值——分頁,或按相對時間區間 +longbridge fund nav-history UT/FD/HK0000384492 --page 1 --size 30 +longbridge fund nav-range UT/FD/HK0000384492 --month-before 6 +longbridge fund nav-range UT/FD/HK0000384492 --year-before 1 +``` + +### 持倉 + +```bash +# 基金前十大持倉(--scene 選擇拆解口徑) +longbridge fund holdings UT/FD/HK0000384492 +# 反向查詢:哪些基金持有某隻股票 +longbridge fund stock-holdings UT/FD/HK0000384492 --limit 20 +``` + +任意命令加 `--format json` 可輸出機器可讀格式。 + +## 選項 + +| 選項 | 命令 | 說明 | 默認 | +| ---- | ---- | ---- | ---- | +| `--quick-id` | `list` | 快捷篩選 id(可重複) | — | +| `--time-interval` | `list` | 收益率區間,如 `1m` `3m` `1y`(可重複) | — | +| `--period` | `analysis`、`analysis-detail`、`trend`、`performance-comparison` | 分析 / 比較週期 | — | +| `--page` / `--size` | `annual-returns`、`quarterly-returns`、`nav-history` | 頁碼與每頁條數 | — | +| `--month-before` / `--year-before` | `nav-range` | 相對當前的淨值時間窗 | — | +| `--scene` | `holdings` | 持倉拆解口徑 | — | +| `--limit` | `stock-holdings` | 返回股票數量上限 | — | +| `--format` | 全部 | 輸出格式:`table` \| `json` | `table` | + +## 要求 + +這些是行情數據命令,無需賬戶權限。基金以 `counter_id` 尋址,可從 `fund hot` / `fund list` 獲取。查看你的持倉與訂單,見 [我的持倉](/zh-HK/docs/cli/fund/positions) 與 [訂單與交易](/zh-HK/docs/cli/fund/orders)。 diff --git a/docs/zh-HK/docs/cli/fund/orders.mdx b/docs/zh-HK/docs/cli/fund/orders.mdx new file mode 100644 index 00000000..5485d1b5 --- /dev/null +++ b/docs/zh-HK/docs/cli/fund/orders.mdx @@ -0,0 +1,96 @@ +--- +title: 'orders & trading' +sidebar_label: 'orders & trading' +sidebar_position: 3 +--- + +# longbridge fund（訂單與交易） + +在終端管理基金訂單——列出訂單與交易流水、查看單筆訂單、下單前校驗,以及提交或撤銷訂單。 + +基金以其 **`counter_id`**（如 `UT/FD/HK0000384492`）標識。這些命令作用於你的賬戶,需要登錄;`submit-order` 與 `cancel-order` 動用真實資金,除非傳 `--yes`,否則會要求確認。 + +## 基本用法 + +```bash +# 你的基金訂單(同時也是成交 / 交易記錄) +longbridge fund orders +``` + +``` +| Order ID | Counter ID | Action | Amount | Units | Status | Currency | Created At | +|--------------------|---------------------|--------|--------|---------|-----------|----------|----------------------| +| 776181234567890123 | UT/FD/HK0000384492 | Buy | 100.00 | — | Filled | USD | 2026-09-20 10:03:11 | +``` + +## 示例 + +### 查看訂單與流水 + +```bash +# 全部基金訂單,或按條件篩選 +longbridge fund orders +longbridge fund orders --counter-id UT/FD/HK0000384492 --action buy --state filled \ + --currency USD --start 2026-01-01 --end 2026-09-30 --page 1 --size 20 +# 單筆訂單詳情 +longbridge fund order 776181234567890123 +# 資金流水記錄 +longbridge fund transactions --currencies USD,HKD --start 2026-01-01 --end 2026-09-30 +``` + +### 下單前校驗 + +```bash +# 試運行校驗——不會下單,返回費用 / 預估份額 / 限額 +longbridge fund validate-order UT/FD/KYG3861F1019 --action buy --currency USD --amount 100 +``` + +### 提交訂單 + +```bash +# 按金額買入(會要求確認) +longbridge fund submit-order UT/FD/KYG3861F1019 --action buy --currency USD --amount 100 +# 按份額賣出,跳過確認 +longbridge fund submit-order UT/FD/KYG3861F1019 --action sell --currency USD --units 50 --yes +# 全部賣出 +longbridge fund submit-order UT/FD/KYG3861F1019 --action sell --currency USD --sell-all --yes +``` + +### 撤銷訂單 + +```bash +# 撤銷未成交的訂單(會要求確認) +longbridge fund cancel-order 776181234567890123 +longbridge fund cancel-order 776181234567890123 --yes +``` + +任意命令加 `--format json` 可輸出機器可讀格式。 + +## 選項 + +| 選項 | 命令 | 說明 | 默認 | +| ---- | ---- | ---- | ---- | +| `--counter-id` | `orders` | 按基金 counter id 篩選(可重複) | — | +| `--action` | `orders`、`validate-order`、`submit-order` | `orders`:篩選(`buy,sell`);下單命令:`buy` \| `sell` | — | +| `--state` | `orders` | 按狀態篩選,逗號分隔 | — | +| `--currency` | `orders`、`validate-order`、`submit-order` | 幣種(如 `USD`、`HKD`) | — | +| `--business-type` / `--category` / `--currencies` | `transactions` | 流水篩選條件 | — | +| `--start` / `--end` | `orders`、`transactions` | 日期區間(`YYYY-MM-DD` 或 RFC 3339) | — | +| `--page` / `--size` | `orders`、`transactions` | 頁碼與每頁條數 | — | +| `--amount` | `validate-order`、`submit-order` | 金額(按金額下單) | — | +| `--units` | `validate-order`、`submit-order` | 份額(按份額下單) | — | +| `--dividend-option` | `validate-order`、`submit-order` | 分紅方式 | — | +| `--fund-source` | `validate-order` | 資金來源 | — | +| `--fee` | `submit-order` | 費用 | — | +| `--sell-all` | `submit-order` | 賣出全部持倉 | false | +| `--remark` | `submit-order` | 訂單備註 | — | +| `--yes` | `submit-order`、`cancel-order` | 跳過交互式確認 | false | +| `--format` | 全部 | 輸出格式:`table` \| `json` | `table` | + +## 要求 + +需要 OAuth 交易權限——先運行 `longbridge auth login`。動用真實資金前,務必先 `validate-order`(或不帶 `--yes` 運行 `submit-order` 以查看確認信息)。基金以 `counter_id` 尋址(來自 [`fund hot` / `fund list`](/zh-HK/docs/cli/fund/market))。 + +## 說明 + +`submit-order` 與 `cancel-order` 動用真實資金,運行前會要求確認;僅在可信、非交互場景下傳 `--yes`。 diff --git a/docs/zh-HK/docs/cli/fund/positions.mdx b/docs/zh-HK/docs/cli/fund/positions.mdx new file mode 100644 index 00000000..f15e44ac --- /dev/null +++ b/docs/zh-HK/docs/cli/fund/positions.mdx @@ -0,0 +1,74 @@ +--- +title: 'positions' +sidebar_label: 'positions' +sidebar_position: 2 +--- + +# longbridge fund（持倉） + +查看你的基金持倉——持倉總覽、單隻持倉詳情,及其業績、累計收益、淨值歷史與分紅。 + +基金以其 **`counter_id`**（如 `UT/FD/HK0000384492`）標識。這些命令讀取你的賬戶,需要登錄。 + +## 基本用法 + +```bash +# 你持有的每隻基金總覽 +longbridge fund positions +``` + +``` +| Counter ID | Name | Currency | Holding Units | Cost NAV | Current NAV | Holding Profit | +|---------------------|-----------------------------|----------|---------------|----------|-------------|----------------| +| UT/FD/HK0000384492 | Allianz Income and Growth | USD | 1250.00 | 9.812 | 10.431 | +773.75 | +``` + +## 示例 + +### 持倉總覽 + +```bash +longbridge fund positions +# 限定到某個子賬戶 +longbridge fund positions --account-channel lb --aaid 123456 +``` + +### 單隻持倉 + +```bash +# 單隻持有基金的詳情,可選日期區間 +longbridge fund position UT/FD/HK0000384492 +longbridge fund position UT/FD/HK0000384492 --start 2026-01-01 --end 2026-06-30 +``` + +### 持有基金的業績、收益、淨值與分紅 + +```bash +# 持有基金的業績數據 +longbridge fund position-performance UT/FD/HK0000384492 +# 累計收益序列(分頁、日期區間) +longbridge fund position-profits UT/FD/HK0000384492 --start 2026-01-01 --end 2026-06-30 --page 1 --size 30 +# 相對時間窗內的淨值歷史 +longbridge fund position-nav UT/FD/HK0000384492 --month-before 6 +longbridge fund position-nav UT/FD/HK0000384492 --year-before 1 +# 分紅記錄 +longbridge fund position-dividends UT/FD/HK0000384492 --currency USD --page 1 --size 20 +``` + +任意命令加 `--format json` 可輸出機器可讀格式。 + +## 選項 + +| 選項 | 命令 | 說明 | 默認 | +| ---- | ---- | ---- | ---- | +| `--account-channel` | `positions`、`position` | 賬戶渠道 | — | +| `--aaid` | `positions`、`position` | 子賬戶 id | — | +| `--start` / `--end` | `position`、`position-profits`、`position-dividends` | 日期區間(`YYYY-MM-DD` 或 RFC 3339) | — | +| `--month-before` / `--year-before` | `position-nav` | 相對當前的淨值時間窗 | — | +| `--currency` | `position-dividends` | 幣種篩選(如 `HKD`、`USD`) | — | +| `--page` / `--size` | `position-profits`、`position-dividends` | 頁碼與每頁條數 | — | +| `--format` | 全部 | 輸出格式:`table` \| `json` | `table` | + +## 要求 + +需要 OAuth 賬戶權限——先運行 `longbridge auth login`。基金以 `counter_id` 尋址(來自 [`fund hot` / `fund list`](/zh-HK/docs/cli/fund/market))。下單或撤單見 [訂單與交易](/zh-HK/docs/cli/fund/orders)。 diff --git a/docs/zh-HK/docs/cli/release-notes.mdx b/docs/zh-HK/docs/cli/release-notes.mdx index 4ea78c76..6c46340e 100644 --- a/docs/zh-HK/docs/cli/release-notes.mdx +++ b/docs/zh-HK/docs/cli/release-notes.mdx @@ -7,6 +7,10 @@ sidebar_icon: newspaper # Release Notes +### [v0.29.0](https://github.com/longbridge/longbridge-terminal/releases/tag/v0.29.0) + +- **新增 `fund` 命令組 —— 香港互惠基金** — `longbridge fund` 把基金渠道帶入終端:瀏覽目錄(`hot`、`list`、`filters`),查看單隻基金的 `detail`、`analysis` / `analysis-detail`、`trend`、`annual-returns` / `quarterly-returns`、`performance` / `performance-comparison`、最新與歷史淨值(`nav`、`nav-history`、`nav-range`)以及 `holdings` / `stock-holdings`;查看你的持倉(`positions`、`position`、`position-performance`、`position-profits`、`position-nav`、`position-dividends`);並管理訂單(`orders`、`order`、`transactions`、`validate-order`、`submit-order`、`cancel-order`)。基金以 `counter_id`(如 `UT/FD/HK0000384492`)尋址,而非股票 symbol —— 可從 `fund hot` / `fund list` 獲取。`submit-order` 與 `cancel-order` 除非傳 `--yes` 否則會要求確認。詳見 [基金](/zh-HK/docs/cli/fund/market) 文檔 + ### [v0.28.0](https://github.com/longbridge/longbridge-terminal/releases/tag/v0.28.0) - **[在終端裏與 LongbridgeAI 對話](/zh-HK/docs/cli/ai)** — 新增 `longbridge ai` 命令，打開全屏對話界面：回答實時流式返回，以 Markdown 渲染，圖表、表格、語法高亮代碼和實時行情卡片都直接畫在終端裏。標題欄行情條跟隨對話提到的每一隻標的（點擊即展開完整行情卡片），斜槓命令覆蓋 `/new` `/retry` `/copy` `/export` `/quote` `/resume` `/settings` `/agent` `/login`；對話保存在你的賬戶上，在終端開始的對話可以在其他使用 LongbridgeAI 的地方繼續 From f8d87819d9b6ec68f5ef3898755554b32be5fb59 Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?=E8=A2=81=E7=AB=A0=E6=B4=AA?= Date: Tue, 29 Sep 2026 09:42:44 +0800 Subject: [PATCH 2/7] docs(cli): satisfy autocorrect (fullwidth punctuation / CJK spacing) --- docs/zh-CN/docs/changelog.mdx | 2 +- docs/zh-CN/docs/cli/fund/market.mdx | 8 ++++---- docs/zh-CN/docs/cli/fund/orders.mdx | 24 ++++++++++++------------ docs/zh-CN/docs/cli/fund/positions.mdx | 12 ++++++------ docs/zh-CN/docs/cli/release-notes.mdx | 2 +- docs/zh-HK/docs/changelog.mdx | 2 +- docs/zh-HK/docs/cli/fund/market.mdx | 10 +++++----- docs/zh-HK/docs/cli/fund/orders.mdx | 24 ++++++++++++------------ docs/zh-HK/docs/cli/fund/positions.mdx | 12 ++++++------ docs/zh-HK/docs/cli/release-notes.mdx | 2 +- 10 files changed, 49 insertions(+), 49 deletions(-) diff --git a/docs/zh-CN/docs/changelog.mdx b/docs/zh-CN/docs/changelog.mdx index 05e68312..64fd1fce 100644 --- a/docs/zh-CN/docs/changelog.mdx +++ b/docs/zh-CN/docs/changelog.mdx @@ -10,7 +10,7 @@ sidebar_icon: newspaper ### CLI v0.29.0 -- **[香港互惠基金进入终端](/zh-CN/docs/cli/fund/market)** — 新增 `longbridge fund` 命令组,覆盖整个基金渠道:浏览目录及单只基金的详情、分析、走势、收益、业绩、净值与持仓;查看你的基金持仓;并校验、提交与撤销基金订单。基金以 `counter_id`(如 `UT/FD/HK0000384492`)寻址;`submit-order` / `cancel-order` 除非传 `--yes` 否则会要求确认 +- **[香港互惠基金进入终端](/zh-CN/docs/cli/fund/market)** — 新增 `longbridge fund` 命令组，覆盖整个基金渠道：浏览目录及单只基金的详情、分析、走势、收益、业绩、净值与持仓;查看你的基金持仓;并校验、提交与撤销基金订单。基金以 `counter_id`(如 `UT/FD/HK0000384492`) 寻址;`submit-order` / `cancel-order` 除非传 `--yes` 否则会要求确认 ## 2026-08-19 diff --git a/docs/zh-CN/docs/cli/fund/market.mdx b/docs/zh-CN/docs/cli/fund/market.mdx index 732b5bb7..e8e0947f 100644 --- a/docs/zh-CN/docs/cli/fund/market.mdx +++ b/docs/zh-CN/docs/cli/fund/market.mdx @@ -8,7 +8,7 @@ sidebar_position: 1 在终端浏览基金目录与单只基金的行情数据——热销榜、可筛选的基金列表，以及单只基金的详情、分析、走势、收益、业绩、净值（NAV）与持仓。 -每只基金以其 **`counter_id`**（如 `UT/FD/HK0000384492`）标识，而非股票 symbol。可从 `longbridge fund hot` 或 `longbridge fund list` 获取,再作为位置参数传给其他命令。 +每只基金以其 **`counter_id`**（如 `UT/FD/HK0000384492`）标识，而非股票 symbol。可从 `longbridge fund hot` 或 `longbridge fund list` 获取，再作为位置参数传给其他命令。 ## 基本用法 @@ -88,14 +88,14 @@ longbridge fund stock-holdings UT/FD/HK0000384492 --limit 20 | 选项 | 命令 | 说明 | 默认 | | ---- | ---- | ---- | ---- | | `--quick-id` | `list` | 快捷筛选 id(可重复) | — | -| `--time-interval` | `list` | 收益率区间,如 `1m` `3m` `1y`(可重复) | — | +| `--time-interval` | `list` | 收益率区间，如 `1m` `3m` `1y`(可重复) | — | | `--period` | `analysis`、`analysis-detail`、`trend`、`performance-comparison` | 分析 / 比较周期 | — | | `--page` / `--size` | `annual-returns`、`quarterly-returns`、`nav-history` | 页码与每页条数 | — | | `--month-before` / `--year-before` | `nav-range` | 相对当前的净值时间窗 | — | | `--scene` | `holdings` | 持仓拆解口径 | — | | `--limit` | `stock-holdings` | 返回股票数量上限 | — | -| `--format` | 全部 | 输出格式:`table` \| `json` | `table` | +| `--format` | 全部 | 输出格式：`table` \| `json` | `table` | ## 要求 -这些是行情数据命令,无需账户权限。基金以 `counter_id` 寻址,可从 `fund hot` / `fund list` 获取。查看你的持仓与订单,见 [我的持仓](/zh-CN/docs/cli/fund/positions) 与 [订单与交易](/zh-CN/docs/cli/fund/orders)。 +这些是行情数据命令，无需账户权限。基金以 `counter_id` 寻址，可从 `fund hot` / `fund list` 获取。查看你的持仓与订单，见 [我的持仓](/zh-CN/docs/cli/fund/positions) 与 [订单与交易](/zh-CN/docs/cli/fund/orders)。 diff --git a/docs/zh-CN/docs/cli/fund/orders.mdx b/docs/zh-CN/docs/cli/fund/orders.mdx index e94bafe2..470ecd76 100644 --- a/docs/zh-CN/docs/cli/fund/orders.mdx +++ b/docs/zh-CN/docs/cli/fund/orders.mdx @@ -6,9 +6,9 @@ sidebar_position: 3 # longbridge fund（订单与交易） -在终端管理基金订单——列出订单与交易流水、查看单笔订单、下单前校验,以及提交或撤销订单。 +在终端管理基金订单——列出订单与交易流水、查看单笔订单、下单前校验，以及提交或撤销订单。 -基金以其 **`counter_id`**（如 `UT/FD/HK0000384492`）标识。这些命令作用于你的账户,需要登录;`submit-order` 与 `cancel-order` 动用真实资金,除非传 `--yes`,否则会要求确认。 +基金以其 **`counter_id`**（如 `UT/FD/HK0000384492`）标识。这些命令作用于你的账户，需要登录;`submit-order` 与 `cancel-order` 动用真实资金，除非传 `--yes`,否则会要求确认。 ## 基本用法 @@ -70,27 +70,27 @@ longbridge fund cancel-order 776181234567890123 --yes | 选项 | 命令 | 说明 | 默认 | | ---- | ---- | ---- | ---- | -| `--counter-id` | `orders` | 按基金 counter id 筛选(可重复) | — | -| `--action` | `orders`、`validate-order`、`submit-order` | `orders`:筛选(`buy,sell`);下单命令:`buy` \| `sell` | — | -| `--state` | `orders` | 按状态筛选,逗号分隔 | — | -| `--currency` | `orders`、`validate-order`、`submit-order` | 币种(如 `USD`、`HKD`) | — | +| `--counter-id` | `orders` | 按基金 counter id 筛选 (可重复) | — | +| `--action` | `orders`、`validate-order`、`submit-order` | `orders`:筛选 (`buy,sell`);下单命令：`buy` \| `sell` | — | +| `--state` | `orders` | 按状态筛选，逗号分隔 | — | +| `--currency` | `orders`、`validate-order`、`submit-order` | 币种 (如 `USD`、`HKD`) | — | | `--business-type` / `--category` / `--currencies` | `transactions` | 流水筛选条件 | — | -| `--start` / `--end` | `orders`、`transactions` | 日期区间(`YYYY-MM-DD` 或 RFC 3339) | — | +| `--start` / `--end` | `orders`、`transactions` | 日期区间 (`YYYY-MM-DD` 或 RFC 3339) | — | | `--page` / `--size` | `orders`、`transactions` | 页码与每页条数 | — | -| `--amount` | `validate-order`、`submit-order` | 金额(按金额下单) | — | -| `--units` | `validate-order`、`submit-order` | 份额(按份额下单) | — | +| `--amount` | `validate-order`、`submit-order` | 金额 (按金额下单) | — | +| `--units` | `validate-order`、`submit-order` | 份额 (按份额下单) | — | | `--dividend-option` | `validate-order`、`submit-order` | 分红方式 | — | | `--fund-source` | `validate-order` | 资金来源 | — | | `--fee` | `submit-order` | 费用 | — | | `--sell-all` | `submit-order` | 卖出全部持仓 | false | | `--remark` | `submit-order` | 订单备注 | — | | `--yes` | `submit-order`、`cancel-order` | 跳过交互式确认 | false | -| `--format` | 全部 | 输出格式:`table` \| `json` | `table` | +| `--format` | 全部 | 输出格式：`table` \| `json` | `table` | ## 要求 -需要 OAuth 交易权限——先运行 `longbridge auth login`。动用真实资金前,务必先 `validate-order`(或不带 `--yes` 运行 `submit-order` 以查看确认信息)。基金以 `counter_id` 寻址(来自 [`fund hot` / `fund list`](/zh-CN/docs/cli/fund/market))。 +需要 OAuth 交易权限——先运行 `longbridge auth login`。动用真实资金前，务必先 `validate-order`(或不带 `--yes` 运行 `submit-order` 以查看确认信息)。基金以 `counter_id` 寻址 (来自 [`fund hot` / `fund list`](/zh-CN/docs/cli/fund/market))。 ## 说明 -`submit-order` 与 `cancel-order` 动用真实资金,运行前会要求确认;仅在可信、非交互场景下传 `--yes`。 +`submit-order` 与 `cancel-order` 动用真实资金，运行前会要求确认;仅在可信、非交互场景下传 `--yes`。 diff --git a/docs/zh-CN/docs/cli/fund/positions.mdx b/docs/zh-CN/docs/cli/fund/positions.mdx index 6b81f370..fd9f59eb 100644 --- a/docs/zh-CN/docs/cli/fund/positions.mdx +++ b/docs/zh-CN/docs/cli/fund/positions.mdx @@ -6,9 +6,9 @@ sidebar_position: 2 # longbridge fund（持仓） -查看你的基金持仓——持仓总览、单只持仓详情,及其业绩、累计收益、净值历史与分红。 +查看你的基金持仓——持仓总览、单只持仓详情，及其业绩、累计收益、净值历史与分红。 -基金以其 **`counter_id`**（如 `UT/FD/HK0000384492`）标识。这些命令读取你的账户,需要登录。 +基金以其 **`counter_id`**（如 `UT/FD/HK0000384492`）标识。这些命令读取你的账户，需要登录。 ## 基本用法 @@ -63,12 +63,12 @@ longbridge fund position-dividends UT/FD/HK0000384492 --currency USD --page 1 -- | ---- | ---- | ---- | ---- | | `--account-channel` | `positions`、`position` | 账户渠道 | — | | `--aaid` | `positions`、`position` | 子账户 id | — | -| `--start` / `--end` | `position`、`position-profits`、`position-dividends` | 日期区间(`YYYY-MM-DD` 或 RFC 3339) | — | +| `--start` / `--end` | `position`、`position-profits`、`position-dividends` | 日期区间 (`YYYY-MM-DD` 或 RFC 3339) | — | | `--month-before` / `--year-before` | `position-nav` | 相对当前的净值时间窗 | — | -| `--currency` | `position-dividends` | 币种筛选(如 `HKD`、`USD`) | — | +| `--currency` | `position-dividends` | 币种筛选 (如 `HKD`、`USD`) | — | | `--page` / `--size` | `position-profits`、`position-dividends` | 页码与每页条数 | — | -| `--format` | 全部 | 输出格式:`table` \| `json` | `table` | +| `--format` | 全部 | 输出格式：`table` \| `json` | `table` | ## 要求 -需要 OAuth 账户权限——先运行 `longbridge auth login`。基金以 `counter_id` 寻址(来自 [`fund hot` / `fund list`](/zh-CN/docs/cli/fund/market))。下单或撤单见 [订单与交易](/zh-CN/docs/cli/fund/orders)。 +需要 OAuth 账户权限——先运行 `longbridge auth login`。基金以 `counter_id` 寻址 (来自 [`fund hot` / `fund list`](/zh-CN/docs/cli/fund/market))。下单或撤单见 [订单与交易](/zh-CN/docs/cli/fund/orders)。 diff --git a/docs/zh-CN/docs/cli/release-notes.mdx b/docs/zh-CN/docs/cli/release-notes.mdx index 93544534..ff9b4333 100644 --- a/docs/zh-CN/docs/cli/release-notes.mdx +++ b/docs/zh-CN/docs/cli/release-notes.mdx @@ -9,7 +9,7 @@ sidebar_icon: newspaper ### [v0.29.0](https://github.com/longbridge/longbridge-terminal/releases/tag/v0.29.0) -- **新增 `fund` 命令组 —— 香港互惠基金** — `longbridge fund` 把基金渠道带入终端:浏览目录(`hot`、`list`、`filters`),查看单只基金的 `detail`、`analysis` / `analysis-detail`、`trend`、`annual-returns` / `quarterly-returns`、`performance` / `performance-comparison`、最新与历史净值(`nav`、`nav-history`、`nav-range`)以及 `holdings` / `stock-holdings`;查看你的持仓(`positions`、`position`、`position-performance`、`position-profits`、`position-nav`、`position-dividends`);并管理订单(`orders`、`order`、`transactions`、`validate-order`、`submit-order`、`cancel-order`)。基金以 `counter_id`(如 `UT/FD/HK0000384492`)寻址,而非股票 symbol —— 可从 `fund hot` / `fund list` 获取。`submit-order` 与 `cancel-order` 除非传 `--yes` 否则会要求确认。详见 [基金](/zh-CN/docs/cli/fund/market) 文档 +- **新增 `fund` 命令组 —— 香港互惠基金** — `longbridge fund` 把基金渠道带入终端：浏览目录 (`hot`、`list`、`filters`),查看单只基金的 `detail`、`analysis` / `analysis-detail`、`trend`、`annual-returns` / `quarterly-returns`、`performance` / `performance-comparison`、最新与历史净值 (`nav`、`nav-history`、`nav-range`) 以及 `holdings` / `stock-holdings`;查看你的持仓 (`positions`、`position`、`position-performance`、`position-profits`、`position-nav`、`position-dividends`);并管理订单 (`orders`、`order`、`transactions`、`validate-order`、`submit-order`、`cancel-order`)。基金以 `counter_id`(如 `UT/FD/HK0000384492`) 寻址，而非股票 symbol —— 可从 `fund hot` / `fund list` 获取。`submit-order` 与 `cancel-order` 除非传 `--yes` 否则会要求确认。详见 [基金](/zh-CN/docs/cli/fund/market) 文档 ### [v0.28.0](https://github.com/longbridge/longbridge-terminal/releases/tag/v0.28.0) diff --git a/docs/zh-HK/docs/changelog.mdx b/docs/zh-HK/docs/changelog.mdx index 42a8702b..5b262ce9 100644 --- a/docs/zh-HK/docs/changelog.mdx +++ b/docs/zh-HK/docs/changelog.mdx @@ -10,7 +10,7 @@ sidebar_icon: newspaper ### CLI v0.29.0 -- **[香港互惠基金進入終端](/zh-HK/docs/cli/fund/market)** — 新增 `longbridge fund` 命令組,覆蓋整個基金渠道:瀏覽目錄及單隻基金的詳情、分析、走勢、收益、業績、淨值與持倉;查看你的基金持倉;並校驗、提交與撤銷基金訂單。基金以 `counter_id`(如 `UT/FD/HK0000384492`)尋址;`submit-order` / `cancel-order` 除非傳 `--yes` 否則會要求確認 +- **[香港互惠基金進入終端](/zh-HK/docs/cli/fund/market)** — 新增 `longbridge fund` 命令組，覆蓋整個基金渠道：瀏覽目錄及單隻基金的詳情、分析、走勢、收益、業績、淨值與持倉;查看你的基金持倉;並校驗、提交與撤銷基金訂單。基金以 `counter_id`(如 `UT/FD/HK0000384492`) 尋址;`submit-order` / `cancel-order` 除非傳 `--yes` 否則會要求確認 ## 2026-08-19 diff --git a/docs/zh-HK/docs/cli/fund/market.mdx b/docs/zh-HK/docs/cli/fund/market.mdx index dfe21e21..22706181 100644 --- a/docs/zh-HK/docs/cli/fund/market.mdx +++ b/docs/zh-HK/docs/cli/fund/market.mdx @@ -6,9 +6,9 @@ sidebar_position: 1 # longbridge fund（行情數據） -在終端瀏覽基金目錄與單隻基金的行情數據——熱銷榜、可篩選的基金列表,以及單隻基金的詳情、分析、走勢、收益、業績、淨值（NAV）與持倉。 +在終端瀏覽基金目錄與單隻基金的行情數據——熱銷榜、可篩選的基金列表，以及單隻基金的詳情、分析、走勢、收益、業績、淨值（NAV）與持倉。 -每隻基金以其 **`counter_id`**（如 `UT/FD/HK0000384492`）標識,而非股票 symbol。可從 `longbridge fund hot` 或 `longbridge fund list` 獲取,再作為位置參數傳給其他命令。 +每隻基金以其 **`counter_id`**（如 `UT/FD/HK0000384492`）標識，而非股票 symbol。可從 `longbridge fund hot` 或 `longbridge fund list` 獲取，再作為位置參數傳給其他命令。 ## 基本用法 @@ -88,14 +88,14 @@ longbridge fund stock-holdings UT/FD/HK0000384492 --limit 20 | 選項 | 命令 | 說明 | 默認 | | ---- | ---- | ---- | ---- | | `--quick-id` | `list` | 快捷篩選 id(可重複) | — | -| `--time-interval` | `list` | 收益率區間,如 `1m` `3m` `1y`(可重複) | — | +| `--time-interval` | `list` | 收益率區間，如 `1m` `3m` `1y`(可重複) | — | | `--period` | `analysis`、`analysis-detail`、`trend`、`performance-comparison` | 分析 / 比較週期 | — | | `--page` / `--size` | `annual-returns`、`quarterly-returns`、`nav-history` | 頁碼與每頁條數 | — | | `--month-before` / `--year-before` | `nav-range` | 相對當前的淨值時間窗 | — | | `--scene` | `holdings` | 持倉拆解口徑 | — | | `--limit` | `stock-holdings` | 返回股票數量上限 | — | -| `--format` | 全部 | 輸出格式:`table` \| `json` | `table` | +| `--format` | 全部 | 輸出格式：`table` \| `json` | `table` | ## 要求 -這些是行情數據命令,無需賬戶權限。基金以 `counter_id` 尋址,可從 `fund hot` / `fund list` 獲取。查看你的持倉與訂單,見 [我的持倉](/zh-HK/docs/cli/fund/positions) 與 [訂單與交易](/zh-HK/docs/cli/fund/orders)。 +這些是行情數據命令，無需賬戶權限。基金以 `counter_id` 尋址，可從 `fund hot` / `fund list` 獲取。查看你的持倉與訂單，見 [我的持倉](/zh-HK/docs/cli/fund/positions) 與 [訂單與交易](/zh-HK/docs/cli/fund/orders)。 diff --git a/docs/zh-HK/docs/cli/fund/orders.mdx b/docs/zh-HK/docs/cli/fund/orders.mdx index 5485d1b5..975ec211 100644 --- a/docs/zh-HK/docs/cli/fund/orders.mdx +++ b/docs/zh-HK/docs/cli/fund/orders.mdx @@ -6,9 +6,9 @@ sidebar_position: 3 # longbridge fund（訂單與交易） -在終端管理基金訂單——列出訂單與交易流水、查看單筆訂單、下單前校驗,以及提交或撤銷訂單。 +在終端管理基金訂單——列出訂單與交易流水、查看單筆訂單、下單前校驗，以及提交或撤銷訂單。 -基金以其 **`counter_id`**（如 `UT/FD/HK0000384492`）標識。這些命令作用於你的賬戶,需要登錄;`submit-order` 與 `cancel-order` 動用真實資金,除非傳 `--yes`,否則會要求確認。 +基金以其 **`counter_id`**（如 `UT/FD/HK0000384492`）標識。這些命令作用於你的賬戶，需要登錄;`submit-order` 與 `cancel-order` 動用真實資金，除非傳 `--yes`,否則會要求確認。 ## 基本用法 @@ -70,27 +70,27 @@ longbridge fund cancel-order 776181234567890123 --yes | 選項 | 命令 | 說明 | 默認 | | ---- | ---- | ---- | ---- | -| `--counter-id` | `orders` | 按基金 counter id 篩選(可重複) | — | -| `--action` | `orders`、`validate-order`、`submit-order` | `orders`:篩選(`buy,sell`);下單命令:`buy` \| `sell` | — | -| `--state` | `orders` | 按狀態篩選,逗號分隔 | — | -| `--currency` | `orders`、`validate-order`、`submit-order` | 幣種(如 `USD`、`HKD`) | — | +| `--counter-id` | `orders` | 按基金 counter id 篩選 (可重複) | — | +| `--action` | `orders`、`validate-order`、`submit-order` | `orders`:篩選 (`buy,sell`);下單命令：`buy` \| `sell` | — | +| `--state` | `orders` | 按狀態篩選，逗號分隔 | — | +| `--currency` | `orders`、`validate-order`、`submit-order` | 幣種 (如 `USD`、`HKD`) | — | | `--business-type` / `--category` / `--currencies` | `transactions` | 流水篩選條件 | — | -| `--start` / `--end` | `orders`、`transactions` | 日期區間(`YYYY-MM-DD` 或 RFC 3339) | — | +| `--start` / `--end` | `orders`、`transactions` | 日期區間 (`YYYY-MM-DD` 或 RFC 3339) | — | | `--page` / `--size` | `orders`、`transactions` | 頁碼與每頁條數 | — | -| `--amount` | `validate-order`、`submit-order` | 金額(按金額下單) | — | -| `--units` | `validate-order`、`submit-order` | 份額(按份額下單) | — | +| `--amount` | `validate-order`、`submit-order` | 金額 (按金額下單) | — | +| `--units` | `validate-order`、`submit-order` | 份額 (按份額下單) | — | | `--dividend-option` | `validate-order`、`submit-order` | 分紅方式 | — | | `--fund-source` | `validate-order` | 資金來源 | — | | `--fee` | `submit-order` | 費用 | — | | `--sell-all` | `submit-order` | 賣出全部持倉 | false | | `--remark` | `submit-order` | 訂單備註 | — | | `--yes` | `submit-order`、`cancel-order` | 跳過交互式確認 | false | -| `--format` | 全部 | 輸出格式:`table` \| `json` | `table` | +| `--format` | 全部 | 輸出格式：`table` \| `json` | `table` | ## 要求 -需要 OAuth 交易權限——先運行 `longbridge auth login`。動用真實資金前,務必先 `validate-order`(或不帶 `--yes` 運行 `submit-order` 以查看確認信息)。基金以 `counter_id` 尋址(來自 [`fund hot` / `fund list`](/zh-HK/docs/cli/fund/market))。 +需要 OAuth 交易權限——先運行 `longbridge auth login`。動用真實資金前，務必先 `validate-order`(或不帶 `--yes` 運行 `submit-order` 以查看確認信息)。基金以 `counter_id` 尋址 (來自 [`fund hot` / `fund list`](/zh-HK/docs/cli/fund/market))。 ## 說明 -`submit-order` 與 `cancel-order` 動用真實資金,運行前會要求確認;僅在可信、非交互場景下傳 `--yes`。 +`submit-order` 與 `cancel-order` 動用真實資金，運行前會要求確認;僅在可信、非交互場景下傳 `--yes`。 diff --git a/docs/zh-HK/docs/cli/fund/positions.mdx b/docs/zh-HK/docs/cli/fund/positions.mdx index f15e44ac..b777d2ca 100644 --- a/docs/zh-HK/docs/cli/fund/positions.mdx +++ b/docs/zh-HK/docs/cli/fund/positions.mdx @@ -6,9 +6,9 @@ sidebar_position: 2 # longbridge fund（持倉） -查看你的基金持倉——持倉總覽、單隻持倉詳情,及其業績、累計收益、淨值歷史與分紅。 +查看你的基金持倉——持倉總覽、單隻持倉詳情，及其業績、累計收益、淨值歷史與分紅。 -基金以其 **`counter_id`**（如 `UT/FD/HK0000384492`）標識。這些命令讀取你的賬戶,需要登錄。 +基金以其 **`counter_id`**（如 `UT/FD/HK0000384492`）標識。這些命令讀取你的賬戶，需要登錄。 ## 基本用法 @@ -63,12 +63,12 @@ longbridge fund position-dividends UT/FD/HK0000384492 --currency USD --page 1 -- | ---- | ---- | ---- | ---- | | `--account-channel` | `positions`、`position` | 賬戶渠道 | — | | `--aaid` | `positions`、`position` | 子賬戶 id | — | -| `--start` / `--end` | `position`、`position-profits`、`position-dividends` | 日期區間(`YYYY-MM-DD` 或 RFC 3339) | — | +| `--start` / `--end` | `position`、`position-profits`、`position-dividends` | 日期區間 (`YYYY-MM-DD` 或 RFC 3339) | — | | `--month-before` / `--year-before` | `position-nav` | 相對當前的淨值時間窗 | — | -| `--currency` | `position-dividends` | 幣種篩選(如 `HKD`、`USD`) | — | +| `--currency` | `position-dividends` | 幣種篩選 (如 `HKD`、`USD`) | — | | `--page` / `--size` | `position-profits`、`position-dividends` | 頁碼與每頁條數 | — | -| `--format` | 全部 | 輸出格式:`table` \| `json` | `table` | +| `--format` | 全部 | 輸出格式：`table` \| `json` | `table` | ## 要求 -需要 OAuth 賬戶權限——先運行 `longbridge auth login`。基金以 `counter_id` 尋址(來自 [`fund hot` / `fund list`](/zh-HK/docs/cli/fund/market))。下單或撤單見 [訂單與交易](/zh-HK/docs/cli/fund/orders)。 +需要 OAuth 賬戶權限——先運行 `longbridge auth login`。基金以 `counter_id` 尋址 (來自 [`fund hot` / `fund list`](/zh-HK/docs/cli/fund/market))。下單或撤單見 [訂單與交易](/zh-HK/docs/cli/fund/orders)。 diff --git a/docs/zh-HK/docs/cli/release-notes.mdx b/docs/zh-HK/docs/cli/release-notes.mdx index 6c46340e..b7527b43 100644 --- a/docs/zh-HK/docs/cli/release-notes.mdx +++ b/docs/zh-HK/docs/cli/release-notes.mdx @@ -9,7 +9,7 @@ sidebar_icon: newspaper ### [v0.29.0](https://github.com/longbridge/longbridge-terminal/releases/tag/v0.29.0) -- **新增 `fund` 命令組 —— 香港互惠基金** — `longbridge fund` 把基金渠道帶入終端:瀏覽目錄(`hot`、`list`、`filters`),查看單隻基金的 `detail`、`analysis` / `analysis-detail`、`trend`、`annual-returns` / `quarterly-returns`、`performance` / `performance-comparison`、最新與歷史淨值(`nav`、`nav-history`、`nav-range`)以及 `holdings` / `stock-holdings`;查看你的持倉(`positions`、`position`、`position-performance`、`position-profits`、`position-nav`、`position-dividends`);並管理訂單(`orders`、`order`、`transactions`、`validate-order`、`submit-order`、`cancel-order`)。基金以 `counter_id`(如 `UT/FD/HK0000384492`)尋址,而非股票 symbol —— 可從 `fund hot` / `fund list` 獲取。`submit-order` 與 `cancel-order` 除非傳 `--yes` 否則會要求確認。詳見 [基金](/zh-HK/docs/cli/fund/market) 文檔 +- **新增 `fund` 命令組 —— 香港互惠基金** — `longbridge fund` 把基金渠道帶入終端：瀏覽目錄 (`hot`、`list`、`filters`),查看單隻基金的 `detail`、`analysis` / `analysis-detail`、`trend`、`annual-returns` / `quarterly-returns`、`performance` / `performance-comparison`、最新與歷史淨值 (`nav`、`nav-history`、`nav-range`) 以及 `holdings` / `stock-holdings`;查看你的持倉 (`positions`、`position`、`position-performance`、`position-profits`、`position-nav`、`position-dividends`);並管理訂單 (`orders`、`order`、`transactions`、`validate-order`、`submit-order`、`cancel-order`)。基金以 `counter_id`(如 `UT/FD/HK0000384492`) 尋址，而非股票 symbol —— 可從 `fund hot` / `fund list` 獲取。`submit-order` 與 `cancel-order` 除非傳 `--yes` 否則會要求確認。詳見 [基金](/zh-HK/docs/cli/fund/market) 文檔 ### [v0.28.0](https://github.com/longbridge/longbridge-terminal/releases/tag/v0.28.0) From c06006fe5fb34fd3a15fbcc87c3708451d055842 Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?=E8=A2=81=E7=AB=A0=E6=B4=AA?= Date: Tue, 29 Sep 2026 16:02:23 +0800 Subject: [PATCH 3/7] docs(changelog): note MCP fund tools; reword fund heading MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit Add an MCP subsection to the 2026-09-28 entry (fund channel ships on MCP in sync with the CLI), and reword the fund heading to '基金登陆终端' / 'Mutual funds come to the terminal'. --- docs/en/docs/changelog.mdx | 6 +++++- docs/zh-CN/docs/changelog.mdx | 6 +++++- docs/zh-HK/docs/changelog.mdx | 6 +++++- 3 files changed, 15 insertions(+), 3 deletions(-) diff --git a/docs/en/docs/changelog.mdx b/docs/en/docs/changelog.mdx index c53a36ca..dcbb68d3 100644 --- a/docs/en/docs/changelog.mdx +++ b/docs/en/docs/changelog.mdx @@ -10,7 +10,11 @@ sidebar_icon: newspaper ### CLI v0.29.0 -- **[Hong Kong mutual funds in the terminal](/docs/cli/fund/market)** — the new `longbridge fund` command group covers the whole channel: browse the catalog and a fund's detail, analysis, trend, returns, performance, NAV and holdings; review your fund positions; and validate, submit and cancel fund orders. Funds are addressed by `counter_id` (e.g. `UT/FD/HK0000384492`); `submit-order` / `cancel-order` prompt for confirmation unless `--yes` +- **[Mutual funds come to the terminal](/docs/cli/fund/market)** — the new `longbridge fund` command group covers the whole channel: browse the catalog and a fund's detail, analysis, trend, returns, performance, NAV and holdings; review your fund positions; and validate, submit and cancel fund orders. Funds are addressed by `counter_id` (e.g. `UT/FD/HK0000384492`); `submit-order` / `cancel-order` prompt for confirmation unless `--yes` + +### MCP + +- **28 fund-channel tools** — Longbridge MCP gains the Hong Kong mutual-fund channel in sync: catalog & market data, your positions, order lookup, and fund order validate / submit / cancel (writes require two-step confirmation) ## 2026-08-19 diff --git a/docs/zh-CN/docs/changelog.mdx b/docs/zh-CN/docs/changelog.mdx index 64fd1fce..8104f53a 100644 --- a/docs/zh-CN/docs/changelog.mdx +++ b/docs/zh-CN/docs/changelog.mdx @@ -10,7 +10,11 @@ sidebar_icon: newspaper ### CLI v0.29.0 -- **[香港互惠基金进入终端](/zh-CN/docs/cli/fund/market)** — 新增 `longbridge fund` 命令组，覆盖整个基金渠道：浏览目录及单只基金的详情、分析、走势、收益、业绩、净值与持仓;查看你的基金持仓;并校验、提交与撤销基金订单。基金以 `counter_id`(如 `UT/FD/HK0000384492`) 寻址;`submit-order` / `cancel-order` 除非传 `--yes` 否则会要求确认 +- **[基金登陆终端](/zh-CN/docs/cli/fund/market)** — 新增 `longbridge fund` 命令组，覆盖整个基金渠道：浏览目录及单只基金的详情、分析、走势、收益、业绩、净值与持仓;查看你的基金持仓;并校验、提交与撤销基金订单。基金以 `counter_id`(如 `UT/FD/HK0000384492`) 寻址;`submit-order` / `cancel-order` 除非传 `--yes` 否则会要求确认 + +### MCP + +- **新增 28 个基金渠道工具** — Longbridge MCP 同步支持香港互惠基金：目录与行情、我的持仓、订单查询，以及基金下单校验 / 提交 / 撤销（写操作需两步确认） ## 2026-08-19 diff --git a/docs/zh-HK/docs/changelog.mdx b/docs/zh-HK/docs/changelog.mdx index 5b262ce9..3c524165 100644 --- a/docs/zh-HK/docs/changelog.mdx +++ b/docs/zh-HK/docs/changelog.mdx @@ -10,7 +10,11 @@ sidebar_icon: newspaper ### CLI v0.29.0 -- **[香港互惠基金進入終端](/zh-HK/docs/cli/fund/market)** — 新增 `longbridge fund` 命令組，覆蓋整個基金渠道：瀏覽目錄及單隻基金的詳情、分析、走勢、收益、業績、淨值與持倉;查看你的基金持倉;並校驗、提交與撤銷基金訂單。基金以 `counter_id`(如 `UT/FD/HK0000384492`) 尋址;`submit-order` / `cancel-order` 除非傳 `--yes` 否則會要求確認 +- **[基金登陸終端](/zh-HK/docs/cli/fund/market)** — 新增 `longbridge fund` 命令組，覆蓋整個基金渠道：瀏覽目錄及單隻基金的詳情、分析、走勢、收益、業績、淨值與持倉;查看你的基金持倉;並校驗、提交與撤銷基金訂單。基金以 `counter_id`(如 `UT/FD/HK0000384492`) 尋址;`submit-order` / `cancel-order` 除非傳 `--yes` 否則會要求確認 + +### MCP + +- **新增 28 個基金渠道工具** — Longbridge MCP 同步支持香港互惠基金：目錄與行情、我的持倉、訂單查詢，以及基金下單校驗 / 提交 / 撤銷（寫操作需兩步確認） ## 2026-08-19 From b43db77c126da9a9177ab93b67b3aebec4eb5c86 Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?=E8=A2=81=E7=AB=A0=E6=B4=AA?= Date: Tue, 29 Sep 2026 16:09:37 +0800 Subject: [PATCH 4/7] docs: add Funds sidebar icon; note the symbol-migration CLI change - Register a 'coins' glyph in the sidebar icon set so the Funds category (_category_.json icon: coins) actually renders an icon. - Add the unreleased CLI change since v0.28.7 (terminal #319: requests now send the user-facing symbol directly, dropping client-side symbol<->counter_id conversion) to the v0.29.0 release notes and changelog. --- docs/en/docs/changelog.mdx | 1 + docs/en/docs/cli/release-notes.mdx | 1 + docs/zh-CN/docs/changelog.mdx | 1 + docs/zh-CN/docs/cli/release-notes.mdx | 1 + docs/zh-HK/docs/changelog.mdx | 1 + docs/zh-HK/docs/cli/release-notes.mdx | 1 + src/components/shell/sidebar-icons.ts | 1 + 7 files changed, 7 insertions(+) diff --git a/docs/en/docs/changelog.mdx b/docs/en/docs/changelog.mdx index dcbb68d3..c0bb927b 100644 --- a/docs/en/docs/changelog.mdx +++ b/docs/en/docs/changelog.mdx @@ -11,6 +11,7 @@ sidebar_icon: newspaper ### CLI v0.29.0 - **[Mutual funds come to the terminal](/docs/cli/fund/market)** — the new `longbridge fund` command group covers the whole channel: browse the catalog and a fund's detail, analysis, trend, returns, performance, NAV and holdings; review your fund positions; and validate, submit and cancel fund orders. Funds are addressed by `counter_id` (e.g. `UT/FD/HK0000384492`); `submit-order` / `cancel-order` prompt for confirmation unless `--yes` +- **Requests now send the user-facing symbol directly** — the CLI drops its client-side `symbol` ↔ `counter_id` conversion (and the bundled ETF / index tables) to match the SDK; every command sends symbols like `AAPL.US` / `HSI.HK` straight to the gateway and reads `symbol` back from responses ### MCP diff --git a/docs/en/docs/cli/release-notes.mdx b/docs/en/docs/cli/release-notes.mdx index 2122b0e1..35e68ebd 100644 --- a/docs/en/docs/cli/release-notes.mdx +++ b/docs/en/docs/cli/release-notes.mdx @@ -10,6 +10,7 @@ sidebar_icon: newspaper ### [v0.29.0](https://github.com/longbridge/longbridge-terminal/releases/tag/v0.29.0) - **New `fund` command group — Hong Kong mutual funds** — `longbridge fund` brings the mutual-fund channel to the terminal: browse the catalog (`hot`, `list`, `filters`), read a fund's `detail`, `analysis` / `analysis-detail`, `trend`, `annual-returns` / `quarterly-returns`, `performance` / `performance-comparison`, latest and historical NAV (`nav`, `nav-history`, `nav-range`) and `holdings` / `stock-holdings`; review your holdings (`positions`, `position`, `position-performance`, `position-profits`, `position-nav`, `position-dividends`); and manage orders (`orders`, `order`, `transactions`, `validate-order`, `submit-order`, `cancel-order`). Funds are addressed by `counter_id` (e.g. `UT/FD/HK0000384492`), not a stock symbol — get one from `fund hot` / `fund list`. `submit-order` and `cancel-order` prompt for confirmation unless `--yes`. See the [Funds](/docs/cli/fund/market) docs +- **Requests now send the user-facing symbol directly** — the CLI drops its client-side `symbol` ↔ `counter_id` conversion (and the bundled ETF / index tables) to match the SDK: `quote`, `fundamental`, `ipo`, `dca`, `trade`, `sharelist`, `screener` and the rest send symbols like `AAPL.US` / `HSI.HK` straight to the gateway and read the `symbol` field back from responses. `is_etf` now resolves via the gateway instead of a local table ### [v0.28.0](https://github.com/longbridge/longbridge-terminal/releases/tag/v0.28.0) diff --git a/docs/zh-CN/docs/changelog.mdx b/docs/zh-CN/docs/changelog.mdx index 8104f53a..15b27c18 100644 --- a/docs/zh-CN/docs/changelog.mdx +++ b/docs/zh-CN/docs/changelog.mdx @@ -11,6 +11,7 @@ sidebar_icon: newspaper ### CLI v0.29.0 - **[基金登陆终端](/zh-CN/docs/cli/fund/market)** — 新增 `longbridge fund` 命令组，覆盖整个基金渠道：浏览目录及单只基金的详情、分析、走势、收益、业绩、净值与持仓;查看你的基金持仓;并校验、提交与撤销基金订单。基金以 `counter_id`(如 `UT/FD/HK0000384492`) 寻址;`submit-order` / `cancel-order` 除非传 `--yes` 否则会要求确认 +- **请求直接发送用户可见的 symbol** — CLI 移除客户端的 `symbol` ↔ `counter_id` 转换（及内置的 ETF / 指数对照表），与 SDK 对齐:每个命令直接把 `AAPL.US` / `HSI.HK` 这样的 symbol 发往网关，并从响应的 `symbol` 字段读回 ### MCP diff --git a/docs/zh-CN/docs/cli/release-notes.mdx b/docs/zh-CN/docs/cli/release-notes.mdx index ff9b4333..a1c32e86 100644 --- a/docs/zh-CN/docs/cli/release-notes.mdx +++ b/docs/zh-CN/docs/cli/release-notes.mdx @@ -10,6 +10,7 @@ sidebar_icon: newspaper ### [v0.29.0](https://github.com/longbridge/longbridge-terminal/releases/tag/v0.29.0) - **新增 `fund` 命令组 —— 香港互惠基金** — `longbridge fund` 把基金渠道带入终端：浏览目录 (`hot`、`list`、`filters`),查看单只基金的 `detail`、`analysis` / `analysis-detail`、`trend`、`annual-returns` / `quarterly-returns`、`performance` / `performance-comparison`、最新与历史净值 (`nav`、`nav-history`、`nav-range`) 以及 `holdings` / `stock-holdings`;查看你的持仓 (`positions`、`position`、`position-performance`、`position-profits`、`position-nav`、`position-dividends`);并管理订单 (`orders`、`order`、`transactions`、`validate-order`、`submit-order`、`cancel-order`)。基金以 `counter_id`(如 `UT/FD/HK0000384492`) 寻址，而非股票 symbol —— 可从 `fund hot` / `fund list` 获取。`submit-order` 与 `cancel-order` 除非传 `--yes` 否则会要求确认。详见 [基金](/zh-CN/docs/cli/fund/market) 文档 +- **请求直接发送用户可见的 symbol** — CLI 移除客户端的 `symbol` ↔ `counter_id` 转换（及内置的 ETF / 指数对照表），与 SDK 对齐：`quote`、`fundamental`、`ipo`、`dca`、`trade`、`sharelist`、`screener` 等命令直接把 `AAPL.US` / `HSI.HK` 这样的 symbol 发往网关，并从响应的 `symbol` 字段读回；`is_etf` 改为经网关判定,不再依赖本地对照表 ### [v0.28.0](https://github.com/longbridge/longbridge-terminal/releases/tag/v0.28.0) diff --git a/docs/zh-HK/docs/changelog.mdx b/docs/zh-HK/docs/changelog.mdx index 3c524165..32e50a8e 100644 --- a/docs/zh-HK/docs/changelog.mdx +++ b/docs/zh-HK/docs/changelog.mdx @@ -11,6 +11,7 @@ sidebar_icon: newspaper ### CLI v0.29.0 - **[基金登陸終端](/zh-HK/docs/cli/fund/market)** — 新增 `longbridge fund` 命令組，覆蓋整個基金渠道：瀏覽目錄及單隻基金的詳情、分析、走勢、收益、業績、淨值與持倉;查看你的基金持倉;並校驗、提交與撤銷基金訂單。基金以 `counter_id`(如 `UT/FD/HK0000384492`) 尋址;`submit-order` / `cancel-order` 除非傳 `--yes` 否則會要求確認 +- **請求直接發送用戶可見的 symbol** — CLI 移除客戶端的 `symbol` ↔ `counter_id` 轉換（及內置的 ETF / 指數對照表），與 SDK 對齊:每個命令直接把 `AAPL.US` / `HSI.HK` 這樣的 symbol 發往網關，並從響應的 `symbol` 欄位讀回 ### MCP diff --git a/docs/zh-HK/docs/cli/release-notes.mdx b/docs/zh-HK/docs/cli/release-notes.mdx index b7527b43..72e465ea 100644 --- a/docs/zh-HK/docs/cli/release-notes.mdx +++ b/docs/zh-HK/docs/cli/release-notes.mdx @@ -10,6 +10,7 @@ sidebar_icon: newspaper ### [v0.29.0](https://github.com/longbridge/longbridge-terminal/releases/tag/v0.29.0) - **新增 `fund` 命令組 —— 香港互惠基金** — `longbridge fund` 把基金渠道帶入終端：瀏覽目錄 (`hot`、`list`、`filters`),查看單隻基金的 `detail`、`analysis` / `analysis-detail`、`trend`、`annual-returns` / `quarterly-returns`、`performance` / `performance-comparison`、最新與歷史淨值 (`nav`、`nav-history`、`nav-range`) 以及 `holdings` / `stock-holdings`;查看你的持倉 (`positions`、`position`、`position-performance`、`position-profits`、`position-nav`、`position-dividends`);並管理訂單 (`orders`、`order`、`transactions`、`validate-order`、`submit-order`、`cancel-order`)。基金以 `counter_id`(如 `UT/FD/HK0000384492`) 尋址，而非股票 symbol —— 可從 `fund hot` / `fund list` 獲取。`submit-order` 與 `cancel-order` 除非傳 `--yes` 否則會要求確認。詳見 [基金](/zh-HK/docs/cli/fund/market) 文檔 +- **請求直接發送用戶可見的 symbol** — CLI 移除客戶端的 `symbol` ↔ `counter_id` 轉換（及內置的 ETF / 指數對照表），與 SDK 對齊：`quote`、`fundamental`、`ipo`、`dca`、`trade`、`sharelist`、`screener` 等命令直接把 `AAPL.US` / `HSI.HK` 這樣的 symbol 發往網關，並從響應的 `symbol` 欄位讀回；`is_etf` 改為經網關判定,不再依賴本地對照表 ### [v0.28.0](https://github.com/longbridge/longbridge-terminal/releases/tag/v0.28.0) diff --git a/src/components/shell/sidebar-icons.ts b/src/components/shell/sidebar-icons.ts index 861511f9..8756f48f 100644 --- a/src/components/shell/sidebar-icons.ts +++ b/src/components/shell/sidebar-icons.ts @@ -29,5 +29,6 @@ export const SIDEBAR_ICONS: Record = { 'badge-question-mark': ``, 'square-terminal': ``, 'line-chart': ``, + coins: ``, 'external-link': ``, } From a92c9fe20e9de07d725349e4ff6d7b7b37e484ec Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?=E8=A2=81=E7=AB=A0=E6=B4=AA?= Date: Tue, 29 Sep 2026 16:21:07 +0800 Subject: [PATCH 5/7] docs: drop the symbol-migration note from the fund release entry MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit Remove the #319 'requests send symbol directly' bullet from the v0.29.0 release notes and changelog (all locales) — out of scope for the fund docs, and it also tripped the autocorrect check. The Funds icon, MCP subsection and reworded heading remain. --- docs/en/docs/changelog.mdx | 1 - docs/en/docs/cli/release-notes.mdx | 1 - docs/zh-CN/docs/changelog.mdx | 1 - docs/zh-CN/docs/cli/release-notes.mdx | 1 - docs/zh-HK/docs/changelog.mdx | 1 - docs/zh-HK/docs/cli/release-notes.mdx | 1 - 6 files changed, 6 deletions(-) diff --git a/docs/en/docs/changelog.mdx b/docs/en/docs/changelog.mdx index c0bb927b..dcbb68d3 100644 --- a/docs/en/docs/changelog.mdx +++ b/docs/en/docs/changelog.mdx @@ -11,7 +11,6 @@ sidebar_icon: newspaper ### CLI v0.29.0 - **[Mutual funds come to the terminal](/docs/cli/fund/market)** — the new `longbridge fund` command group covers the whole channel: browse the catalog and a fund's detail, analysis, trend, returns, performance, NAV and holdings; review your fund positions; and validate, submit and cancel fund orders. Funds are addressed by `counter_id` (e.g. `UT/FD/HK0000384492`); `submit-order` / `cancel-order` prompt for confirmation unless `--yes` -- **Requests now send the user-facing symbol directly** — the CLI drops its client-side `symbol` ↔ `counter_id` conversion (and the bundled ETF / index tables) to match the SDK; every command sends symbols like `AAPL.US` / `HSI.HK` straight to the gateway and reads `symbol` back from responses ### MCP diff --git a/docs/en/docs/cli/release-notes.mdx b/docs/en/docs/cli/release-notes.mdx index 35e68ebd..2122b0e1 100644 --- a/docs/en/docs/cli/release-notes.mdx +++ b/docs/en/docs/cli/release-notes.mdx @@ -10,7 +10,6 @@ sidebar_icon: newspaper ### [v0.29.0](https://github.com/longbridge/longbridge-terminal/releases/tag/v0.29.0) - **New `fund` command group — Hong Kong mutual funds** — `longbridge fund` brings the mutual-fund channel to the terminal: browse the catalog (`hot`, `list`, `filters`), read a fund's `detail`, `analysis` / `analysis-detail`, `trend`, `annual-returns` / `quarterly-returns`, `performance` / `performance-comparison`, latest and historical NAV (`nav`, `nav-history`, `nav-range`) and `holdings` / `stock-holdings`; review your holdings (`positions`, `position`, `position-performance`, `position-profits`, `position-nav`, `position-dividends`); and manage orders (`orders`, `order`, `transactions`, `validate-order`, `submit-order`, `cancel-order`). Funds are addressed by `counter_id` (e.g. `UT/FD/HK0000384492`), not a stock symbol — get one from `fund hot` / `fund list`. `submit-order` and `cancel-order` prompt for confirmation unless `--yes`. See the [Funds](/docs/cli/fund/market) docs -- **Requests now send the user-facing symbol directly** — the CLI drops its client-side `symbol` ↔ `counter_id` conversion (and the bundled ETF / index tables) to match the SDK: `quote`, `fundamental`, `ipo`, `dca`, `trade`, `sharelist`, `screener` and the rest send symbols like `AAPL.US` / `HSI.HK` straight to the gateway and read the `symbol` field back from responses. `is_etf` now resolves via the gateway instead of a local table ### [v0.28.0](https://github.com/longbridge/longbridge-terminal/releases/tag/v0.28.0) diff --git a/docs/zh-CN/docs/changelog.mdx b/docs/zh-CN/docs/changelog.mdx index 15b27c18..8104f53a 100644 --- a/docs/zh-CN/docs/changelog.mdx +++ b/docs/zh-CN/docs/changelog.mdx @@ -11,7 +11,6 @@ sidebar_icon: newspaper ### CLI v0.29.0 - **[基金登陆终端](/zh-CN/docs/cli/fund/market)** — 新增 `longbridge fund` 命令组，覆盖整个基金渠道：浏览目录及单只基金的详情、分析、走势、收益、业绩、净值与持仓;查看你的基金持仓;并校验、提交与撤销基金订单。基金以 `counter_id`(如 `UT/FD/HK0000384492`) 寻址;`submit-order` / `cancel-order` 除非传 `--yes` 否则会要求确认 -- **请求直接发送用户可见的 symbol** — CLI 移除客户端的 `symbol` ↔ `counter_id` 转换（及内置的 ETF / 指数对照表），与 SDK 对齐:每个命令直接把 `AAPL.US` / `HSI.HK` 这样的 symbol 发往网关，并从响应的 `symbol` 字段读回 ### MCP diff --git a/docs/zh-CN/docs/cli/release-notes.mdx b/docs/zh-CN/docs/cli/release-notes.mdx index a1c32e86..ff9b4333 100644 --- a/docs/zh-CN/docs/cli/release-notes.mdx +++ b/docs/zh-CN/docs/cli/release-notes.mdx @@ -10,7 +10,6 @@ sidebar_icon: newspaper ### [v0.29.0](https://github.com/longbridge/longbridge-terminal/releases/tag/v0.29.0) - **新增 `fund` 命令组 —— 香港互惠基金** — `longbridge fund` 把基金渠道带入终端：浏览目录 (`hot`、`list`、`filters`),查看单只基金的 `detail`、`analysis` / `analysis-detail`、`trend`、`annual-returns` / `quarterly-returns`、`performance` / `performance-comparison`、最新与历史净值 (`nav`、`nav-history`、`nav-range`) 以及 `holdings` / `stock-holdings`;查看你的持仓 (`positions`、`position`、`position-performance`、`position-profits`、`position-nav`、`position-dividends`);并管理订单 (`orders`、`order`、`transactions`、`validate-order`、`submit-order`、`cancel-order`)。基金以 `counter_id`(如 `UT/FD/HK0000384492`) 寻址，而非股票 symbol —— 可从 `fund hot` / `fund list` 获取。`submit-order` 与 `cancel-order` 除非传 `--yes` 否则会要求确认。详见 [基金](/zh-CN/docs/cli/fund/market) 文档 -- **请求直接发送用户可见的 symbol** — CLI 移除客户端的 `symbol` ↔ `counter_id` 转换（及内置的 ETF / 指数对照表），与 SDK 对齐：`quote`、`fundamental`、`ipo`、`dca`、`trade`、`sharelist`、`screener` 等命令直接把 `AAPL.US` / `HSI.HK` 这样的 symbol 发往网关，并从响应的 `symbol` 字段读回；`is_etf` 改为经网关判定,不再依赖本地对照表 ### [v0.28.0](https://github.com/longbridge/longbridge-terminal/releases/tag/v0.28.0) diff --git a/docs/zh-HK/docs/changelog.mdx b/docs/zh-HK/docs/changelog.mdx index 32e50a8e..3c524165 100644 --- a/docs/zh-HK/docs/changelog.mdx +++ b/docs/zh-HK/docs/changelog.mdx @@ -11,7 +11,6 @@ sidebar_icon: newspaper ### CLI v0.29.0 - **[基金登陸終端](/zh-HK/docs/cli/fund/market)** — 新增 `longbridge fund` 命令組，覆蓋整個基金渠道：瀏覽目錄及單隻基金的詳情、分析、走勢、收益、業績、淨值與持倉;查看你的基金持倉;並校驗、提交與撤銷基金訂單。基金以 `counter_id`(如 `UT/FD/HK0000384492`) 尋址;`submit-order` / `cancel-order` 除非傳 `--yes` 否則會要求確認 -- **請求直接發送用戶可見的 symbol** — CLI 移除客戶端的 `symbol` ↔ `counter_id` 轉換（及內置的 ETF / 指數對照表），與 SDK 對齊:每個命令直接把 `AAPL.US` / `HSI.HK` 這樣的 symbol 發往網關，並從響應的 `symbol` 欄位讀回 ### MCP diff --git a/docs/zh-HK/docs/cli/release-notes.mdx b/docs/zh-HK/docs/cli/release-notes.mdx index 72e465ea..b7527b43 100644 --- a/docs/zh-HK/docs/cli/release-notes.mdx +++ b/docs/zh-HK/docs/cli/release-notes.mdx @@ -10,7 +10,6 @@ sidebar_icon: newspaper ### [v0.29.0](https://github.com/longbridge/longbridge-terminal/releases/tag/v0.29.0) - **新增 `fund` 命令組 —— 香港互惠基金** — `longbridge fund` 把基金渠道帶入終端：瀏覽目錄 (`hot`、`list`、`filters`),查看單隻基金的 `detail`、`analysis` / `analysis-detail`、`trend`、`annual-returns` / `quarterly-returns`、`performance` / `performance-comparison`、最新與歷史淨值 (`nav`、`nav-history`、`nav-range`) 以及 `holdings` / `stock-holdings`;查看你的持倉 (`positions`、`position`、`position-performance`、`position-profits`、`position-nav`、`position-dividends`);並管理訂單 (`orders`、`order`、`transactions`、`validate-order`、`submit-order`、`cancel-order`)。基金以 `counter_id`(如 `UT/FD/HK0000384492`) 尋址，而非股票 symbol —— 可從 `fund hot` / `fund list` 獲取。`submit-order` 與 `cancel-order` 除非傳 `--yes` 否則會要求確認。詳見 [基金](/zh-HK/docs/cli/fund/market) 文檔 -- **請求直接發送用戶可見的 symbol** — CLI 移除客戶端的 `symbol` ↔ `counter_id` 轉換（及內置的 ETF / 指數對照表），與 SDK 對齊：`quote`、`fundamental`、`ipo`、`dca`、`trade`、`sharelist`、`screener` 等命令直接把 `AAPL.US` / `HSI.HK` 這樣的 symbol 發往網關，並從響應的 `symbol` 欄位讀回；`is_etf` 改為經網關判定,不再依賴本地對照表 ### [v0.28.0](https://github.com/longbridge/longbridge-terminal/releases/tag/v0.28.0) From 482c94889f20bddd0eabd844fc893b5c1a543028 Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?=E8=A2=81=E7=AB=A0=E6=B4=AA?= Date: Tue, 29 Sep 2026 16:58:41 +0800 Subject: [PATCH 6/7] docs: fund positions expose counter_id instead of ISIN The trade fund-positions holding identifier is now counter_id (was the ISIN). Update the CLI fund-positions table header + prose and the /v1/asset/fund API reference response field across all locales. --- docs/en/docs/cli/account/fund-positions.mdx | 4 ++-- docs/en/docs/trade/asset/fund.mdx | 2 +- docs/zh-CN/docs/cli/account/fund-positions.mdx | 2 +- docs/zh-CN/docs/trade/asset/fund.mdx | 2 +- docs/zh-HK/docs/cli/account/fund-positions.mdx | 2 +- docs/zh-HK/docs/trade/asset/fund.mdx | 2 +- 6 files changed, 7 insertions(+), 7 deletions(-) diff --git a/docs/en/docs/cli/account/fund-positions.mdx b/docs/en/docs/cli/account/fund-positions.mdx index 5ac73d0a..3816370e 100644 --- a/docs/en/docs/cli/account/fund-positions.mdx +++ b/docs/en/docs/cli/account/fund-positions.mdx @@ -15,7 +15,7 @@ longbridge fund-positions ``` ``` -| Symbol | Name | Net Asset Value | Cost Net Asset Value | Currency | Holding Units | +| Counter ID | Name | Net Asset Value | Cost Net Asset Value | Currency | Holding Units | |--------|------|-----------------|----------------------|----------|---------------| ``` @@ -28,7 +28,7 @@ longbridge fund-positions longbridge fund-positions --format json ``` -Displays all fund and ETF positions in your account, including symbol, quantity, and cost information. +Displays all fund and ETF positions in your account, including counter_id, quantity, and cost information. ## Requirements diff --git a/docs/en/docs/trade/asset/fund.mdx b/docs/en/docs/trade/asset/fund.mdx index 284ecc20..cc33e92d 100644 --- a/docs/en/docs/trade/asset/fund.mdx +++ b/docs/en/docs/trade/asset/fund.mdx @@ -268,7 +268,7 @@ func main() { | list | object[] | false | stock holding information | | ∟ account_channel | string | true | account type | | ∟ fund_info | object[] | false | Fund Details | -| ∟∟ symbol | string | true | Fund ISIN code | +| ∟∟ counter_id | string | true | Fund counter id (last /-segment is the ISIN) | | ∟∟ current_net_asset_value | string | true | current Equity | | ∟∟ net_asset_value_day | string | true | current Equity time | | ∟∟ symbol_name | string | true | Fund name | diff --git a/docs/zh-CN/docs/cli/account/fund-positions.mdx b/docs/zh-CN/docs/cli/account/fund-positions.mdx index 9aafc649..8b50b109 100644 --- a/docs/zh-CN/docs/cli/account/fund-positions.mdx +++ b/docs/zh-CN/docs/cli/account/fund-positions.mdx @@ -15,7 +15,7 @@ longbridge fund-positions ``` ``` -| Symbol | Name | Net Asset Value | Cost Net Asset Value | Currency | Holding Units | +| Counter ID | Name | Net Asset Value | Cost Net Asset Value | Currency | Holding Units | |--------|------|-----------------|----------------------|----------|---------------| ``` diff --git a/docs/zh-CN/docs/trade/asset/fund.mdx b/docs/zh-CN/docs/trade/asset/fund.mdx index a426471e..03bbb6ea 100644 --- a/docs/zh-CN/docs/trade/asset/fund.mdx +++ b/docs/zh-CN/docs/trade/asset/fund.mdx @@ -266,7 +266,7 @@ func main() { | list | object[] | false | 股票持仓信息 | | ∟ account_channel | string | true | 账户类型 | | ∟ fund_info | object[] | false | 基金详情 | -| ∟∟ symbol | string | true | 基金 ISIN 代码 | +| ∟∟ counter_id | string | true | 基金 counter_id（末段为 ISIN） | | ∟∟ current_net_asset_value | string | true | 当前净值 | | ∟∟ net_asset_value_day | string | true | 当前净值时间 | | ∟∟ symbol_name | string | true | 基金名称 | diff --git a/docs/zh-HK/docs/cli/account/fund-positions.mdx b/docs/zh-HK/docs/cli/account/fund-positions.mdx index bd695a49..8799dbd3 100644 --- a/docs/zh-HK/docs/cli/account/fund-positions.mdx +++ b/docs/zh-HK/docs/cli/account/fund-positions.mdx @@ -15,7 +15,7 @@ longbridge fund-positions ``` ``` -| Symbol | Name | Net Asset Value | Cost Net Asset Value | Currency | Holding Units | +| Counter ID | Name | Net Asset Value | Cost Net Asset Value | Currency | Holding Units | |--------|------|-----------------|----------------------|----------|---------------| ``` diff --git a/docs/zh-HK/docs/trade/asset/fund.mdx b/docs/zh-HK/docs/trade/asset/fund.mdx index 0c27952f..81007ef9 100644 --- a/docs/zh-HK/docs/trade/asset/fund.mdx +++ b/docs/zh-HK/docs/trade/asset/fund.mdx @@ -264,7 +264,7 @@ func main() { | list | object[] | false | 股票持倉信息 | | ∟ account_channel | string | true | 賬戶類型 | | ∟ fund_info | object[] | false | 基金詳情 | -| ∟∟ symbol | string | true | 基金 ISIN 代碼 | +| ∟∟ counter_id | string | true | 基金 counter_id（末段為 ISIN） | | ∟∟ current_net_asset_value | string | true | 當前淨值 | | ∟∟ net_asset_value_day | string | true | 當前淨值時間 | | ∟∟ symbol_name | string | true | 基金名稱 | From e9370878ae227000729f2dfaf9624ba114da0f68 Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?=E8=A2=81=E7=AB=A0=E6=B4=AA?= Date: Tue, 29 Sep 2026 17:20:40 +0800 Subject: [PATCH 7/7] docs: update /v1/asset/fund JSON example to counter_id The response schema row was renamed symbol -> counter_id; update the JSON response sample to match (UT/FD/HK0000447943). --- docs/en/docs/trade/asset/fund.mdx | 2 +- docs/zh-CN/docs/trade/asset/fund.mdx | 2 +- docs/zh-HK/docs/trade/asset/fund.mdx | 2 +- 3 files changed, 3 insertions(+), 3 deletions(-) diff --git a/docs/en/docs/trade/asset/fund.mdx b/docs/en/docs/trade/asset/fund.mdx index cc33e92d..f4ed7863 100644 --- a/docs/en/docs/trade/asset/fund.mdx +++ b/docs/en/docs/trade/asset/fund.mdx @@ -231,7 +231,7 @@ func main() { "account_channel": "lb", "fund_info": [ { - "symbol": "HK0000447943", + "counter_id": "UT/FD/HK0000447943", "symbol_name": "GAOTENG EMERGING MARKETS PLUS LONG/SHORT FIXED INCOME ALPHA FUND", "currency": "USD", "holding_units": "5.000", diff --git a/docs/zh-CN/docs/trade/asset/fund.mdx b/docs/zh-CN/docs/trade/asset/fund.mdx index 03bbb6ea..f2df0ae3 100644 --- a/docs/zh-CN/docs/trade/asset/fund.mdx +++ b/docs/zh-CN/docs/trade/asset/fund.mdx @@ -229,7 +229,7 @@ func main() { "account_channel": "lb", "fund_info": [ { - "symbol": "HK0000447943", + "counter_id": "UT/FD/HK0000447943", "symbol_name": "高腾亚洲收益基金", "currency": "USD", "holding_units": "5.000", diff --git a/docs/zh-HK/docs/trade/asset/fund.mdx b/docs/zh-HK/docs/trade/asset/fund.mdx index 81007ef9..e90a61e3 100644 --- a/docs/zh-HK/docs/trade/asset/fund.mdx +++ b/docs/zh-HK/docs/trade/asset/fund.mdx @@ -227,7 +227,7 @@ func main() { "account_channel": "lb", "fund_info": [ { - "symbol": "HK0000447943", + "counter_id": "UT/FD/HK0000447943", "symbol_name": "高騰亞洲收益基金", "currency": "USD", "holding_units": "5.000",