Commit Graph

980 Commits

Author SHA1 Message Date
Jason Lee 1a637e7d0b docs: Align the signals reference with the RPC contract
Checked the reference against the `QuerySignals` / `Signal` RPC definitions
and against production responses:

- `status` documents its lifecycle values (0 pending … 5 analysis submit
  failed) instead of being left unexplained.
- `total` is `int32`, matching `QuerySignalsResponse`.
- `risk_level` and `display_control` are dropped from the field tables and
  examples — neither is in the `Signal` message, and production returns
  neither.
- `catalyst_name` says what it matches: the triggering factor's name
  (`EARNINGS_RELEASED`, `macd_12_26_9`), not the prose `key_catalyst` a signal
  displays. Filtering by the value shown in `key_catalyst` returns nothing, so
  both fields now spell out which is which.
- `start_time` / `end_time` also accept a Unix timestamp (≥ 10¹² read as
  milliseconds), per the field definitions.

Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>
2026-08-25 20:19:31 +08:00
Jason Lee 174add6380 docs: Document the security-facts response from live data
`GET /v1/facts/security_facts` served an empty `facts` array when the
reference was written, so the item shape was described as "type-specific" and
the example was an empty envelope. The endpoint now serves data, so both are
replaced with the real thing:

- Full field table: fact id / type / direction / occurrence time, the
  securities it is about, the factors behind it (groups, direction, trigger
  condition, anomaly test), the data sources, and `nl_info`.
- `direction` takes `long`, `short` or `neutral`; `fact_type` takes `News`,
  `Fundamental` or `Technical`.
- `nl_info.summary`, `invest_anal` and `eli_explain` each carry a JSON array
  of `{tag, value}` inside a string — called out so readers parse it.

Also drops the `ticker.region` phrasing from the two pre-existing grid
endpoints, matching the wording used everywhere else.

Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>
2026-08-25 20:01:23 +08:00
Jason Lee 78a6916267 docs: Add the Signals & Catalysts API reference
Documents the three signal endpoints across `openapi.yaml` and the
en / zh-CN / zh-HK reference pages:

- `GET /v1/signals` — query signals with symbol / strategy / catalyst /
  time-range filters and limit/offset paging
- `GET /v1/signals/{signal_id}` — one signal, with the full strategy analysis
  in `json_data`
- `GET /v1/facts/security_facts` — a security's fact (catalyst) events

Field tables come from the live response: `symbol` (not `counter_id`),
millisecond `created_at` / `updated_at`, and the five `outlook` values.

Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>
2026-08-25 19:12:07 +08:00
Jason Lee f397352666 docs: rename Longbridge AI to LongbridgeAI (#1220)
## Summary

`LongbridgeAI` written as one word is the correct brand name. This
renames all occurrences in the docs content across the three locales (en
/ zh-CN / zh-HK) — 63 replacements in 15 files.

Pages touched (each in all three locales):

- `docs/cli/ai.md`
- `docs/cli/acp.md`
- `docs/cli/release-notes.md`
- `docs/changelog.md`
- `docs/cli/index.md`

## Deliberately not changed

- **`docs/{lang}/docs/legal/`** — `Longbridge AI Technologies Pte. Ltd.`
/ `Longbridge AI Technology Pte. Ltd.` / `Longbridge AI Technologies
Limited` are registered legal entity names, along with the "Longbridge
AI" short form defined from them. Renaming would break the legal text.
- **Vue components** (`Skill.vue`, `NewHomePage/index.vue`,
`NewHomePage/ProductSkill.vue`) — the string `Install Longbridge AI
toolkit following the guide...` refers to the Skill/CLI toolkit, not the
LongbridgeAI chat product. Left for a separate decision (possibly
`Longbridge Skill toolkit`).

`autocorrect --fix` was run on the zh-CN / zh-HK trees and produced no
further changes.

🤖 Generated with [Claude Code](https://claude.com/claude-code)

Co-authored-by: Claude Opus 5 (1M context) <noreply@anthropic.com>
2026-08-21 14:39:22 +08:00
Jason Lee 48d61e346c Update longbridge ai demo image. 2026-08-21 14:19:28 +08:00
Jason Lee 2e9d7cced8 Add Longbridge AI demo. 2026-08-21 14:17:33 +08:00
Jason Lee 7a5e8c648a docs(cli): add ai and serve guides, and CLI v0.28.0 notes (#1217)
## What

Documents the two new top-level CLI commands and prepares the v0.28.0
release notes. All pages exist in `en` / `zh-CN` / `zh-HK`.

### `cli/ai` — the Longbridge AI chat TUI

Screen layout (title-bar ticker, transcript, prompt, status row) and the
click-through quote card; the 12 slash commands with aliases; the full
key reference; how answers render (Markdown, terminal-drawn `vis-chart`
charts, box-drawn tables, syntax-highlighted code, live quote cards,
tool activity); the agent's own questions (options / multi-select /
authorization); conversations stored on the account; copy and export;
the five settings; agent switching. Two screenshots.

### `cli/serve` — for developers building on the CLI

Written for someone about to write a client:

- Why it exists, against the spawn-per-poll alternative
- The NDJSON JSON-RPC 2.0 wire format and four properties to design
around: concurrent (so out-of-order) responses, the 8-request upstream
cap, exit on stdin EOF, whole-line stdout
- The method surface, the layering that keeps it from drifting behind
the CLI, and why payloads are the raw OpenAPI shapes rather than
`--format json`
- The live feed: `fields`, the notification table, and the three things
to get right — a tick is not a snapshot, a push can predate the
snapshot, unsubscribe drops every field
- Error codes mapped to "can a retry help", parameter conventions, the
full method list, and a ~40-line Python client

Closes with **Longbridge for Omarchy** as a case study — install steps,
and how it actually uses `serve` (one parked session, no polling, folded
pushes, sparklines from `quote.candlesticks`, `holdings` from
`trade.stock_positions`, portfolio via the CLI) — with three
screenshots.

### Release notes and changelog

CLI v0.28.0: `ai`, `serve`, the `grid` command group, the reworked TUI
chrome, the intraday-chart fill fix (and the two bugs behind it), and
`news detail` returning structured data.

## Also

- Sidebar order for the top-level pages: AI → ACP → JSON-RPC Server →
TUI → Release Notes
- The CLI overview's quick start mentions `longbridge ai`
- Fixed `](/en/docs/...)` links in the English release notes and
changelog — `en` is the root locale, so those 404

## Verification

Every command detail was checked against `longbridge-terminal` at
7b6a297 (source and locale files), and the `serve` request/response
examples are real output from a live `longbridge serve` session. Sidebar
generation verified by running `genMarkdowDocs` for all three locales.
No build run, per repo convention.

🤖 Generated with [Claude Code](https://claude.com/claude-code)

---------

Co-authored-by: Claude Opus 5 (1M context) <noreply@anthropic.com>
2026-08-21 13:48:14 +08:00
Hogan 8e4eb3dd85 docs: add grid trading documentation (CLI, API, SDK, MCP) (#1204)
## Summary

Complete grid trading documentation for the Longbridge Developers site —
the new grid strategy orders documented across CLI, HTTP API, SDKs, and
MCP, in English / Simplified Chinese / Traditional Chinese.

## What's included

- **Grid Trading API reference** (`docs/trade/grid/`) — an overview page
plus 11 endpoint pages: submit, replace, list, list-by-IDs, detail,
trigger history, cancel, suspend, restart, questionnaire, and symbol
info. Each endpoint page carries a `<CliCommand>` example, Python /
Node.js / Java / Rust / C++ SDK tabs, request/response tables, and a `##
Schemas` section — matching the existing `trade/order` pages.
- **CLI usage page** (`cli/orders/grid.md`) — the `longbridge grid`
command group under "Orders & Trading".
- **WebSocket push** — the `GridOrderChanged` (`gridtrading_order`)
event documented in `trade-push.md`.
- **FAQ** — `qa/trade.md` updated: grid orders are now supported.
- **Changelog & CLI release notes** — a 2026-08-14 changelog entry (SDK
v4.5.0 / CLI v0.27.0 / MCP: 11 grid tools) and a CLI v0.27.0 release
note.
- **`openapi.yaml`** — the `/v1/gridtrading/*`,
`/v1/record/questionnaire`, and `/v1/orders/info` paths plus the
`GridTradeRule` schema, under a new `Grid Trading` tag.
- **`SDKLinks` component** — now supports the `grid` module and a
`hideGo` flag (the Go SDK has no grid bindings yet).

All pages are mirrored across `en` / `zh-CN` / `zh-HK`.

## Notes

- Field names, enums, and HTTP paths come from the source PRs
(longbridge/openapi#563, longbridge/longbridge-terminal#281).
- The v0.27.0 / v4.5.0 release tags go live with the 2026-08-14 release;
the release-note links resolve then.
- CI (Build Test + autocorrect) is green.

Refs: longbridge/openapi#563, longbridge/longbridge-terminal#281

---------

Co-authored-by: Jason Lee <huacnlee@gmail.com>
2026-08-21 13:42:14 +08:00
Endless 2fef8dc564 docs add Longbridge Developers style guide and content strategy (#1156)
🤖 Auto-generated by Endless task
[#38](https://endless.longbridge-inc.com/projects/developers/tasks/38).

Initiated by: huacnlee@longbridge-inc.com
Worker agent: Kayak (ri · lboneapi · DeepSeek-V3.2)

## Summary
- Longbridge Developers lacked a formal documentation content strategy
and writing standard, making it difficult to maintain consistency across
multilingual docs
- Introduces a comprehensive style guide (inspired by Cloudflare's
Product docs content strategy) covering content types, API reference
standards, information architecture, writing guidelines, and
multilingual rules
- Adds a product spec (`specs/2026-07-14-content-strategy.md`) capturing
the full content strategy design rationale
- Removes obsolete `content/overview.md` pages across all three locales
(en, zh-CN, zh-HK) and cleans up the sensors utility
- Verify by navigating to the `/style-guide/` section in the local dev
server and confirming all five guide pages render correctly with sidebar
navigation
- Cross-check that existing pages (getting-started, CLI, quote APIs)
still render without broken links after the nav config updates

## Changes

| File | Change |
|---|---|
| `docs/en/docs/style-guide/index.md` | New style guide landing page
(EN) |
| `docs/en/docs/style-guide/content-types.md` | New content-types guide
defining tutorials, how-tos, reference, and concept pages |
| `docs/en/docs/style-guide/api-reference.md` | New API reference
writing standard |
| `docs/en/docs/style-guide/information-architecture.md` | New IA
guidelines for doc structure and navigation |
| `docs/en/docs/style-guide/writing-guidelines.md` | New writing style
and tone guidelines |
| `docs/en/docs/style-guide/multilingual.md` | New multilingual
documentation rules |
| `docs/en/docs/style-guide/_category_.json` | Sidebar category metadata
for style guide section |
| `specs/2026-07-14-content-strategy.md` | Full product spec for the
content strategy initiative |
| `docs/.vitepress/config.mts` | Added style guide section to VitePress
site config |
| `docs/.vitepress/locales/en/index.ts` | Updated EN locale nav/sidebar
to include style guide |
| `docs/.vitepress/locales/zh-CN/index.ts` | Updated zh-CN locale
nav/sidebar |
| `docs/.vitepress/locales/zh-HK/index.ts` | Updated zh-HK locale
nav/sidebar |
| `docs/.vitepress/theme/utils/sensors.ts` | Removed unused analytics
sensors utility |
| `docs/.vitepress/theme/index.ts` | Cleaned up theme entry, removed
sensors import |
| `docs/.vitepress/theme/components/NewHomePage/index.vue` | Minor
homepage component cleanup |
| `docs/.vitepress/theme/components/Pricing.vue` | Minor pricing
component cleanup |
| `docs/.vitepress/theme/components/Skill.vue` | Minor skill component
cleanup |
| `docs/en/docs/content/overview.md` | Removed obsolete content overview
page (EN) |
| `docs/zh-CN/docs/content/overview.md` | Removed obsolete content
overview page (zh-CN) |
| `docs/zh-HK/docs/content/overview.md` | Removed obsolete content
overview page (zh-HK) |
| `docs/en/docs/quote/stocks/history-candlestick.md` | Updated
candlestick doc formatting/content |
| `docs/zh-CN/docs/quote/stocks/history-candlestick.md` | Updated
candlestick doc formatting/content (zh-CN) |
| `docs/zh-HK/docs/quote/stocks/history-candlestick.md` | Updated
candlestick doc formatting/content (zh-HK) |
| `docs/en/docs/quote/stocks/quote.md` | Minor fix to quote doc |
| `docs/zh-CN/docs/quote/stocks/quote.md` | Minor fix to quote doc
(zh-CN) |
| `docs/zh-HK/docs/quote/stocks/quote.md` | Minor fix to quote doc
(zh-HK) |
| `docs/en/docs/getting-started.md` | Minor fix to getting started doc

---------

Co-authored-by: Huacnlee Li Huashun <huacnlee@longbridge-inc.com>
Co-authored-by: Jason Lee <huacnlee@gmail.com>
Co-authored-by: Claude Opus 5 (1M context) <noreply@anthropic.com>
2026-08-21 13:39:38 +08:00
Jason Lee efc7d0b34a docs: clarify US-specific trade APIs are unavailable to paper accounts (#1219)
## 背景

Longbridge US 柜台(US DC)未提供模拟账户功能,因此整个 US region
在模拟环境下均不可用。用模拟账户调用美股专用接口会返回**错误**,而不是空结果,容易被误解为"此账户没有委托"。

## 变更

- **交易 FAQ**:新增 Q10,说明该限制,并指引需要模拟环境的用户改用 AP 账户 +
通用交易接口(`today_orders`、`history_orders`、`account_balance`、`stock_positions`
等)
- **`us_query_orders` / `us_order_detail`**:扩展 warning
提示块,明确说明其他数据中心账户(HK/SG)与模拟账户均不支持,并提醒不要把调用失败当成空结果
- 三语言(en / zh-CN / zh-HK)同步更新

🤖 Generated with [Claude Code](https://claude.com/claude-code)

Co-authored-by: Claude Opus 5 (1M context) <noreply@anthropic.com>
2026-08-21 13:35:45 +08:00
Hogan 5ed1f92f66 feat(footer): add AI Integrations column with ChatGPT App and Claude Connector (#1203)
新增页脚 **AI Integrations** 分栏,展示 Longbridge 的三种 AI 接入方式:

- **MCP**(从 Products 栏迁移至此)
- **ChatGPT App** — 链接到 ChatGPT App 商店页
- **Claude Connector** — 链接到 Claude 连接器目录

同时在首页页脚(HomePage/Footer.vue)补充 ChatGPT App 与 Claude Connector 链接。

页脚网格由 5 列扩展为 6 列,三语言(en / zh-CN / zh-HK)文案同步新增 `footer.integrations`。
2026-08-21 13:34:46 +08:00
liuyuhou-code 841f294604 docs(trade): remove contract_size from multi_leg legs (#1215)
1.订单详情/当日订单/历史订单的多腿 legs 移除 contract_size 字段说明与示例,
2026-08-18 14:57:15 +08:00
liuyuhou-code 7e32345fbb Feature/multileg docs (#1213)
update example
2026-08-17 16:19:06 +08:00
liuyuhou-code 070ca18c0c docs(trade): add multi-leg option order docs (#1212)
1.新增多腿期权下单接口,订单查询/详情与 WebSocket 推送补充 multi_leg 字段。
2026-08-17 14:51:05 +08:00
liuyuhou-code ee8224b38a Feature/execution side (#1188)
Co-authored-by: Sunli <scott_s829@163.com>
2026-08-17 10:25:22 +08:00
Jason Lee 46babbcdb5 docs: clarify ACP usage and setup (#1209)
## Summary

- rewrite the CLI v0.27.0 ACP release note around user-facing purpose
and investment scenarios
- add English, Simplified Chinese, and Traditional Chinese `longbridge
acp` guides
- document generic ACP client configuration and keep Zed as the sole
product-specific example
- link Longbridge AI and the release notes to the new setup guide

## Test Plan

- `git diff --check`
- `npm run build:release`

Co-authored-by: Codex <codex@openai.com>
2026-08-14 22:17:18 +08:00
Hogan d89e74990f docs: CLI v0.27.0 (agent + ACP) and CI build heap bump (#1208)
Non-grid slice split out of #1204 so it can ship independently (grid
trading is blocked on the gateway).

## Changes
- **Changelog & CLI release notes** (`en` / `zh-CN` / `zh-HK`) — a
2026-08-14 `CLI v0.27.0` entry documenting:
- **`agent` commands (A2A)** — `workspace list`, `agent list`, streaming
`agent chat` / `agent continue` (longbridge/longbridge-terminal#280)
- **`acp` runtime** — `longbridge acp` exposes the Longbridge AI agent
over the Agent Client Protocol, with Codex / Claude adapter presets
(longbridge/longbridge-terminal#282)
- **CI** — raise the docs build Node heap to 14GB (`package.json` +
`build.yml` + `canary.yml`).

## Not included
Grid trading docs (API reference, CLI `grid` page, SDK examples, push
event, MCP tools) stay in #1204 until the gateway is live.

Refs: longbridge/longbridge-terminal#280,
longbridge/longbridge-terminal#282
2026-08-14 17:43:26 +08:00
Jason Lee 68f8ec908f chore: Remove the deprecated skills/ directory (#1206)
The Longbridge skill files are maintained in
[longbridge/skills](https://github.com/longbridge/skills). The copy
under `skills/` here is a stale duplicate — nothing in the site build
reads it, and the two copies had already drifted apart.

## Heads-up before merging

`skills/longbridge/references/cli/quant.md` (448 lines of Navi scripting
docs) exists **only** in this copy — `longbridge/skills` has no such
file. Deleting it here leaves that content reachable only through git
history.

Both copies also received parallel Navi updates recently (#1169 here,
`quant-navi` there), so please confirm nothing newer lives on this side
before merging.

Everything else in the directory has an equivalent in
`longbridge/skills`.

🤖 Generated with [Claude Code](https://claude.com/claude-code)
2026-08-13 21:36:22 +08:00
Ryder 59cf80c8aa docs(ai): 新增公开 Agent 列表接口文档 (#1202) 2026-08-13 13:12:36 +08:00
Endless 8af8ecb67d fix: update Claude Longbridge Connector URL from /longbridge-mcp to /longbridge (#1200)
🤖 Auto-generated by Endless task
[#41](https://endless.longbridge-inc.com/projects/developers/tasks/41).
Initiated by: huacnlee@longbridge-inc.com
Worker agent: Claude Code (claude_code · lboneapi · claude-sonnet-4-6)

## Commits

- **fix: update Claude Longbridge Connector URL from /longbridge-mcp to
/longbridge**

- **feat: add claude.ai connector install guide to MCP page and update
claudeSteps in Skill.vue**
- Add ### claude.ai section to mcp.md (en/zh-CN/zh-HK) with step-by-step
Customize → Connectors → Browser Connectors flow and direct URL
- Update claudeSteps in Skill.vue (all 3 locales) to reflect the same
accurate UI navigation flow

---------

Co-authored-by: Jason Lee <huacnlee@gmail.com>
2026-08-07 09:23:35 +08:00
Ryder 4d525a9de3 docs: add parent_message_id parameter to conversation API docs (#1198)
Co-authored-by: Biao <biao.wang@longbridge-inc.com>
2026-08-06 20:59:37 +08:00
拉罐 fe9ae6dd5c feat(login): forward invite-code to login redirect (query > cookie) (#1199) 2026-08-06 19:16:18 +08:00
Hogan 2d861dd567 feat(skill): add Claude connector alongside ChatGPT (#1196)
## What changed

**Skill page (`/skill/`)**
- New **Claude** tab in the install segmented control (Connect AI · Copy
command · ChatGPT · **Claude**), linking to the Claude connector
directory `https://claude.ai/directory/connectors/longbridge-mcp`. Tab
bar now scrolls instead of overflowing on mobile.
- Hero callout now covers both channels: "ChatGPT and Claude can install
Longbridge directly — use `@longbridge` in ChatGPT, or the connector in
Claude." (fixed its layout so the longer sentence wraps cleanly instead
of centering raggedly).

**Home page**
- New **"Now available in ChatGPT and Claude"** intro band above the
FEATURES section, reusing the exact same `eyebrow + h-section` header
style as the other sections, with ChatGPT / Claude logo chips on the
right.

All copy synced across **en / zh-CN / zh-HK**.

🤖 Generated with [Claude Code](https://claude.com/claude-code)

---------

Co-authored-by: twosugar <sugarfish@yeah.net>
Co-authored-by: Claude Opus 4.7 <noreply@anthropic.com>
2026-08-05 22:34:17 +08:00
拉罐 0eb792d64c docs(seo): add cross-domain internal links to longbridge.com (#1193)
Wrap 6 existing terms across the docs as hyperlinks pointing to the
matching longbridge.com pages (per SEO team requirement doc). Targets
are unprefixed so longbridge.com auto-routes by browser locale; the same
URL is used from all three language sites.

- docs index: community topics -> /topics; watchlist -> /watchlist
- screener/screener_indicators: stock screener -> /screener
- market/calendar/macro_calendar: macroeconomic data ->
/calendar/macrodata
- fundamental/overview: Financial event calendars -> /calendar/macrodata
- content/overview: security news -> /news
2026-08-04 13:31:41 +08:00
Sunli e95c5710e2 docs: update option volume daily SDK params and examples
Add timestamp/count params, update all SDK call examples to pass explicit
args, and note that Go SDK uses start/end time range instead.
2026-07-31 09:36:44 +08:00
Sunli c4980dee0d docs: update option volume API response fields
- Simplify option_volume response to call_volume and put_volume only
- Rename list to stats in option_volume_daily response
- Add symbol, total_volume, total_open_interest fields to daily stats
- Change pc_vol and pc_oi types from string to float
2026-07-30 15:43:44 +08:00
Shine Xia b2c7d05660 docs: add attached order (take-profit/stop-loss) params docs and orde… (#1092)
Co-authored-by: Xia Guanghui <guanghui.xia@longbridge.sg>
2026-07-29 16:38:31 +08:00
Jason Lee 36363471c8 docs: Add v0.26.0 CLI release notes (#1185)
Adds the release-notes entry for what has landed on
`longbridge-terminal` `main` since v0.25.0, in all three locales (en /
zh-CN / zh-HK).

Covered:

- TUI settings modal (`Ctrl+,`), context-aware shortcut hints, mouse
scrolling — longbridge/longbridge-terminal#272
- TUI visual refresh — longbridge/longbridge-terminal#273
- Access point no longer sticks to China Mainland —
longbridge/longbridge-terminal#276
- `ipo calendar` returned no data — longbridge/longbridge-terminal#275
- Clearer error for US option quotes without OPRA access —
longbridge/longbridge-terminal#271
- `ipo detail` degrades gracefully when an auxiliary endpoint is down —
longbridge/longbridge-terminal#270

The version heading assumes **v0.26.0**, since the batch adds TUI
features rather than only fixes. Say the word if it should ship as
v0.25.1 and I will renumber.

Also refreshes the access-point paragraph in
`skills/longbridge/references/cli/overview.md`, which still described
detection as a non-blocking startup probe keyed off mere reachability,
and adds `LONGBRIDGE_REGION` to the environment-variable table — the CLI
now names that variable in its own error output.

The existing v0.25.0 entry is untouched; the diff is additive.

🤖 Generated with [Claude Code](https://claude.com/claude-code)

Co-authored-by: Claude Opus 5 (1M context) <noreply@anthropic.com>
2026-07-27 21:28:57 +08:00
Ryder e1a7f482d1 新增 SSE 事件参考页并补全事件类型说明 (#1177)
- 新增 docs/{en,zh-CN,zh-HK}/docs/portai/chat/events.md,逐一列出 chat/workflow
生命周期、message、thinking、node_tool_use、subagent、agent_tool、human_interaction_required
及辅助事件的字段表与示例
     - 说明帧格式信封结构:SSE event 恒为 message,客户端应按 data.event 分发并忽略未知事件以保持向前兼容
- 给出成功/中断/失败三种典型事件序列,并注明中断运行不发 workflow_finished、恢复时不再发 workflow_started
- conversation.md 的流式示例中 workflow_run_id 由占位符 wr_... 修正为真实格式的数字字符串
745910371102313,并添加指向 events 页的链接
     - 三语言页面 sidebar_position 均为 4,紧随 continue(3)之后

---------

Co-authored-by: Biao <biao.wang@longbridge-inc.com>
2026-07-22 17:14:52 +08:00
Jason Lee 8b5b881aa8 fix: refine AI Agent sidebar navigation (#1174)
## Summary

- move AI Agent directly after Account in all three locales
- keep AI Agent expanded while collapsing Workspace and Conversation so
only the first level is visible
- replace the AI Agent CPU icon with a bot icon and add icons for Market
and Screener
- preserve the configured expanded/collapsed state of all other sidebar
sections

## Test Plan

- generated the English, Simplified Chinese, and Traditional Chinese
sidebars and asserted ordering, nesting, collapse state, and icon output
- ran Prettier checks on the changed sidebar/config files
- ran `git diff --check`
- build not run per repository instructions

Co-authored-by: Codex <codex@openai.com>
2026-07-20 18:35:14 +08:00
拉罐 4d758951cc feat: support US environment via cookie app_id (#1173)
Runtime US tenant detection based on cookie `app_id` /
`x-original-app-id` (longbridge_us / longbridge_us_uat), aligned with
openapi-website-private.

- API baseUrl (request.ts) prefers US host when cookie matches:
    longbridge_us     -> https://mr.longbridge.com
    longbridge_us_uat -> https://mr.longbridge-staging.com
  falls back to hostname suffix.
- __API_PROXY_URL__ resolves the same way in an inline bootstrap script
  that runs before longport-internal.iife.js loads.
- Append `with-us=1` to the login redirect URL.
- Pin longport-internal.iife.js to versioned CDN artifact that contains
  US tenant normalization

(assets.lbctrl.com/openapi-sdk/release/longport-internal-202607201728.iife.js).
- Rename portal gateway host m.* -> mr.* in package.json,
region.config.ts,
  config.mts and workflow yml.
2026-07-20 18:14:52 +08:00
Hogan bd71d5b939 docs: merge CLI v0.25.0 + SDK v4.4.0 changelog into single 2026-07-20 entry (#1172)
Merge the two CLI v0.25.0 sections (from 2026-07-20 and 2026-07-07) and
SDK v4.4.0 into a single combined entry under 2026-07-20.
2026-07-20 17:37:21 +08:00
Jason Lee b94a84cc35 docs: add CLI v0.25.0 release notes and US data center docs (#1170)
## Summary

- **CLI v0.25.0 release notes** — US data-center support, 14 US-routed
account/fundamentals commands, `quant run` migrated to the v2 API with
Navi support
- **Changelog** — same CLI entry plus a platform-level note that
Longbridge Developers now supports US account login, with the `.cn`
domain limitation called out
- **Getting Started** — new "Access Points and Data Centers" section
clarifying that `.com`/`.cn` are access points (network routing only)
while `ap`/`us` are data centers, and that `.cn` has no route to the US
data center

All three languages (en / zh-CN / zh-HK) updated in sync. Source for the
DC explanation: `longbridge-terminal/src/region.rs`.

Note: prettier reflowed the environment-variable table in
`docs/en/docs/getting-started.md` — formatting only, no content change.

🤖 Generated with [Claude Code](https://claude.com/claude-code)

---------

Co-authored-by: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
2026-07-20 17:16:28 +08:00
Hogan a0792276fc docs: US market APIs — CLI v0.25.0 + SDK v4.4.0 (14 new methods) (#1137)
## Summary

新增美股市场 API 文档(CLI PR #262 / OpenAPI PR #555 / openapi-go PR #106),三语言同步。

## CLI v0.25.0

### 新增命令
- **`etf-docs <SYMBOL>`** — 列出美股 ETF 监管文件(招股书、事实说明书等);`--limit`
- **`financial-report key-metrics`** — 美股关键财务指标;`--report
annual|quarterly`
- **`profit-analysis realized`** — 美股已实现盈亏;`--category
stock|option|crypto`

### 已有命令更新(美股账户自动路由)
- `company`, `valuation`, `financial-report`, `consensus`, `dividend` —
添加 US 路由说明
- `order` — 新增 `--status`、`--action` 筛选flag,`order detail --attached`
关联子委托

## SDK v4.4.0 — 14 个新方法(均为 US Only)

### FundamentalContext(9 个)
`us_company_overview`, `us_valuation_overview`, `us_financial_overview`,
`us_financial_statement_v3`, `us_key_financial_metrics`,
`us_analyst_consensus`, `us_etf_dividend_info`, `us_company_dividends`,
`us_etf_files`

### QuoteContext(1 个)
`us_crypto_overview`

### TradeContext(4 个)
`us_query_orders`, `us_order_detail`, `us_asset_overview`,
`us_realized_pl`

## Related PRs
- CLI: longbridge/longbridge-terminal#262
- SDK: longbridge/openapi#555
- Go SDK: longbridge/openapi-go#106

🤖 Generated with [Claude Code](https://claude.com/claude-code)

---------

Co-authored-by: Claude Sonnet 4.6 (1M context) <noreply@anthropic.com>
2026-07-20 17:14:08 +08:00
Jason Lee 8c082a34c6 docs: Update quant scripting docs for Navi (#1169)
`longbridge quant run` now defaults to Navi
([longbridge-terminal#267](https://github.com/longbridge/longbridge-terminal/pull/267)),
so the CLI docs and the `longbridge` skill are rewritten around it.

## Scope

- `docs/{en,zh-CN,zh-HK}/docs/cli/quant/index.md` — language section and
all examples
- `docs/{en,zh-CN,zh-HK}/docs/cli/quant/backtest.md` — 4 strategy
scripts and the `strategy()` settings table
- `skills/longbridge/references/cli/quant.md` — 11 examples

**Every example script is new Navi source and passes `navi lint`.**

## Errors this surfaced

These were already broken before the rewrite:

- **`jq` paths were wrong.** Docs used `.data.report_json`; the report
is at `.report_json`. Every documented backtest one-liner returned
`null`.
- **The Bollinger example was needlessly manual.** It stated `ta.bbands`
was unavailable and built bands from `ta.sma` + `ta.stdev`. Navi's
`ta.bb` returns `(basis, upper, lower)` directly.
- **`strategy()` settings named PineScript symbols** —
`strategy.commission.percent`, `strategy.fixed`,
`strategy.percent_of_equity` — which in Navi are `CommissionType` /
`DefaultQtyType` variants.
- **Indicator outputs were stale.** The six indicator examples now show
real `quant run` output.

## Syntax highlighting

Replaces the OpenPine TextMate grammar with the official Navi grammar
from `navi-docs`, registered as `navi` with an `nv` alias. The `pine`
alias is dropped, and all fences use `nv`.

## Note on remaining stale values

The JSON figures under **Backtesting** in `backtest.md` are carried over
unverified — the quant API has been returning `code=14` (UNAVAILABLE)
and I could not re-run them. Worth re-checking once it recovers. The
indicator tables in `index.md` *are* freshly captured.

Per-language reference detail is kept deliberately thin:
[navi-lang.org](https://navi-lang.org) is authoritative and its API
evolves.

🤖 Generated with [Claude Code](https://claude.com/claude-code)

Co-authored-by: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
2026-07-20 14:47:40 +08:00
Endless 4843eea28b feat: reorder AI Agent sidebar item to end and set collapsed state (#1166)
🤖 Auto-generated by Endless task
[#40](https://endless.longbridge-inc.com/projects/developers/tasks/40).
Initiated by: huacnlee@longbridge-inc.com
Worker agent: Dory (ri · lboneapi · claude-haiku-4-5-20251001)

## Summary

- **Issue**: AI Agent sidebar items were displayed in the middle of the
sidebar due to directory ordering, with expanded state by default,
reducing visibility of higher-priority documentation items (API, CLI,
MCP).
- **Solution**: Implemented sidebar reordering logic to move AI Agent
items to the end of the sidebar (before the external API Reference link)
and set `collapsed: true` for default folded state across all three
language versions (zh-CN, en, zh-HK).
- **Verification**: Modified three `buildDocsSidebar()` functions to
identify AI Agent items by `/ai` path pattern, extract using `splice()`,
set collapsed property, and re-append to end. No changes to core
generation logic (`genMarkdowDocs()`).

## Changes

| File | Change |
|------|--------|
| `docs/.vitepress/locales/zh-CN/sidebar.ts` | Added AI Agent item
reordering and collapse logic to `buildDocsSidebar()` |
| `docs/.vitepress/locales/en/sidebar.ts` | Added AI Agent item
reordering and collapse logic to `buildDocsSidebar()` |
| `docs/.vitepress/locales/zh-HK/sidebar.ts` | Added AI Agent item
reordering and collapse logic to `buildDocsSidebar()` |
2026-07-20 14:25:45 +08:00
Endless 4727b908c3 feat: add Navi link to footer and Navi CLI docs in quant indicator guides (#1161)
🤖 Auto-generated by Endless task
[#39](https://endless.longbridge-inc.com/projects/developers/tasks/39).

Initiated by: huacnlee@longbridge-inc.com
Worker agent: Claude Code (claude_code · anthropic · claude-sonnet-4-6)

## Summary
- Added a link to [https://navi-lang.org](https://navi-lang.org) across
all footer components (AppFooter and both HomePage/NewHomePage variants)
- Created new indicator documentation pages (`indicator.md`) for `en`,
`zh-CN`, and `zh-HK` locales under the CLI quant section
- Each indicator doc introduces Navi's capabilities in the context of
existing quant features and guides users to install the Navi CLI for
local verification
- To verify: check the site footer for the Navi link and navigate to the
CLI → Quant → Indicator docs in all three locales

## Changes

| File | Change |
|---|---|
| `docs/.vitepress/theme/components/AppFooter.vue` | Added Navi
(navi-lang.org) link to the app footer |
| `docs/.vitepress/theme/components/HomePage/Footer.vue` | Added Navi
link to the HomePage footer |
| `docs/.vitepress/theme/components/NewHomePage/Footer.vue` | Added Navi
link to the NewHomePage footer |
| `docs/en/docs/cli/quant/indicator.md` | New EN doc: introduces Navi
for quant indicators and guides Navi CLI installation |
| `docs/zh-CN/docs/cli/quant/indicator.md` | New zh-CN doc: introduces
Navi for quant indicators and guides Navi CLI installation |
| `docs/zh-HK/docs/cli/quant/indicator.md` | New zh-HK doc: introduces
Navi for quant indicators and guides Navi CLI installation |

---------

Co-authored-by: Huacnlee Li Huashun <huacnlee@longbridge-inc.com>
Co-authored-by: Jason Lee <huacnlee@gmail.com>
2026-07-17 18:52:18 +08:00
QFCG 05bf5fba80 docs: add history candlestick months limit description (#1160)
Co-authored-by: 梁轩伟 <xuanwei.liang@longbridge.sg>
2026-07-17 15:31:06 +08:00
拉罐 5f101c334f Feat/seo (#1159)
Co-authored-by: Claude Opus 4.7 <noreply@anthropic.com>
2026-07-16 18:18:26 +08:00
hold-baby fb1e18fbff docs: add Content API overview pages and fix homepage capability card links (#1158)
## Merge Verdict

**[APPROVE]** — Docs-only change: adds Content API overview pages (3
locales) and fixes homepage API capability card links; all link targets
verified against production.

> 4 files · +237 / -7 · `NewHomePage` `docs/content`

---

## Summary

- Homepage "API Capabilities" cards previously all linked to `/api`,
which returns 404 in production — each of the 5 cards now links to its
own capability page via a new `link` field on `API_CAPS`.
- Added `overview.md` for the Content module (News & Contents) in all
three locales (`en`, `zh-CN`, `zh-HK`), following the structure of
`quote/overview.md` / `trade/overview.md`: a categorized table (News ×1
/ Topics ×6 / Sharelist ×9) linking to all 16 endpoint pages.
- Content & News card now points to the new `/docs/content/overview`
page shipped in the same PR.

---

## Risk Analysis

| Risk | Level | Mitigation |
| ------ | ------ | ------------ |
| Broken link targets |  | All 5 card URLs curl-verified:
`/docs/quote/overview`, `/docs/trade/trade-overview`,
`/docs/cli/derivatives/option`,
`/docs/cli/fundamentals/financial-report` return 200 in production;
`/docs/content/overview` is added by this PR |
| Overview link/title drift |  | All 16 table links use the exact
`slug` frontmatter of target pages; titles match target page `title`
verbatim in each locale |
| Sidebar ordering | 🟢 | `sidebar_position: 0` sorts the overview before
News(1)/Topics(2)/Sharelist(3), same pattern as the quote module |

---

## Design Decisions

- **Per-card links instead of a single `/docs/api` link**: matches user
intent for the homepage capability grid; each card lands on its
capability's most relevant page.
- **No Protobuf/WebSocket access sections in the Content overview**:
Content APIs are plain HTTP REST, so the quote overview's
private-protocol sections were intentionally not copied; a one-line HTTP
+ SDK note is kept instead.

---

## Code Concerns

1. **[信息]** Unused component with a stale broken link
(`docs/.vitepress/theme/components/NewHomePage/CapSection.vue:64`)
`CapSection.vue` is referenced by no file (dead code) and contains
`/docs/trade/overview`, a live 404 — pre-existing and outside this diff;
consider deleting the component or fixing its links in a follow-up.
   ——作者回复:Will be removed in a separate follow-up PR.

---

## Verification Status

 Link targets curl-verified against production ·  Slugs/titles
cross-checked against target page frontmatter · 📋 To verify: homepage
card navigation in local dev (`bun run dev`), including `/zh-CN` locale
prefix handling

Co-authored-by: 袁昌瑞 <changrui.yuan@longbridge-inc.com>
2026-07-16 15:25:15 +08:00
拉罐 f675b0caed docs(seo): add cross-domain internal links to longbridge.com (#1157)
Per SEO team's cross-domain internal linking spec:
- docs/index: link "Market news" -> /en/news, "Real-time and historical
quotes" -> /markets
- docs/getting-started: link "HK Market" -> /hk/
- docs/cli/index: link "AI-agent tool" -> /hk/longbridge-ai
- docs/quote/pull/quote: update anchor to "Longbridge Global Markets" ->
/en/markets
- docs/cli/quant/screener: update anchor to "Longbridge Stock Screener"
-> /en/screener
- Skill.vue: update "screen stocks" & "live market data" targets to
/en/*
- Pricing.vue: align "news", "Longbridge App", "integrated accounts",
"View live market data" to /en/news, /hk/en/download, /en/markets

Trilingual sync across en / zh-CN / zh-HK. Links only, no copy changes.

Co-authored-by: Claude Opus 4.7 <noreply@anthropic.com>
2026-07-16 14:40:02 +08:00
Endless 0bc89537ca feat(mcp): add Grok to MCP installation guide and skill list (#1155)
🤖 Auto-generated by Endless task
[#37](https://endless.longbridge-inc.com/projects/developers/tasks/37).

Initiated by: huacnlee@longbridge-inc.com

- Added Grok as a supported MCP client in the installation documentation
across all three locales (en, zh-CN, zh-HK)
- Documents the step-by-step flow: **Skills and Connectors → Connectors
→ New Connector → Custom**, entering name `Longbridge` and server URL
`https://mcp.longbridge.com`
- Covers completing the Longbridge OAuth 2 authorization after clicking
**Add Connector**
- Updated `Skill.vue` to include Grok in the supported clients list,
positioned after Codex

Co-authored-by: Huacnlee Li Huashun <huacnlee@longbridge-inc.com>
2026-07-14 11:56:14 +08:00
Jason Lee f22c2d47e3 chore: Update DESIGN GUIDE. 2026-07-13 16:35:14 +08:00
Ryder de56f3a0f4 docs: Add AI conversations API (#1129)
- 新增 conversation.md 描述发起对话接口 POST
/v1/babbage/agents/:id/conversations,含阻塞式与 SSE 流式两种响应模式及请求示例
- 新增 continue.md 描述继续对话接口,覆盖 answers_by_tool_call 结构、多次中断续跑及归属校验规则
- conversation.md 提供 conversation_response schema,含 interrupt
中断结构(node_id、tool_call_id、questions)与 error 字段说明
- 新增 portai 与 chat 目录的 _category_.json,配置 sidebar 位置(2.7)、cpu 图标与分组标签
- en / zh-CN / zh-HK 三语言目录同步创建,内容与结构保持一致

---------

Co-authored-by: Biao <biao.wang@longbridge-inc.com>
2026-07-13 16:02:44 +08:00
Endless 149bea3de6 fix: update favicon URLs to correct light/dark logo assets (#1148) 2026-07-10 12:36:29 +08:00
Endless f8af02c983 feat(docs): add dark theme App Icon resource to Assets documentation (#1147)
🤖 Auto-generated by Endless task
[#35](https://endless.longbridge-inc.com/projects/developers/tasks/35).

Initiated by: huacnlee@longbridge-inc.com

- Added `app-icon-dark.svg` as a new Longbridge App Icon resource in the
Assets documentation across all locales (en, zh-CN, zh-HK)
- The dark theme icon is intended for use in contexts such as GitHub
avatars, ChatGPT/Claude plugins, and similar integrations
- Updated VitePress config (`config.mts`) to include the new Assets
section in the sidebar navigation
- Documentation added consistently across all three language versions to
maintain i18n parity

---------

Co-authored-by: Huacnlee Li Huashun <huacnlee@longbridge-inc.com>
2026-07-10 11:45:36 +08:00
Endless 37d8312c2c docs: update ChatGPT entry from Apps to Plugins for Longbridge install (#1146)
🤖 Auto-generated by Endless task
[#34](https://endless.longbridge-inc.com/projects/developers/tasks/34).

Initiated by: huacnlee@longbridge-inc.com

- Updated installation instructions across EN, zh-CN, and zh-HK docs to
reflect that the ChatGPT entry point has changed from **Apps** to
**Plugins**
- Modified `mcp.md`, `qa/general.md`, and `skill/install/index.md` in
all three locales (9 files total)
- Ensures users can correctly locate and install the Longbridge plugin
within the ChatGPT interface

Co-authored-by: Huacnlee Li Huashun <huacnlee@longbridge-inc.com>
2026-07-10 10:40:58 +08:00
Hogan 02c1f3b67c chore: update skills.json (2026-07-08) (#1139)
Auto-generated by skills repo CI.

Source commit:
longbridge/skills@888de9eaf5

Updates `skills.json` with the latest skill list extracted from all
`SKILL.md` frontmatter files.

Co-authored-by: github-actions[bot] <github-actions[bot]@users.noreply.github.com>
2026-07-09 17:58:17 +08:00
Endless 98522cfadc docs(mcp): add note on ChatGPT MCP trading order restrictions (#1144)
🤖 Auto-generated by Endless task
[#33](https://endless.longbridge-inc.com/projects/developers/tasks/33).

Initiated by: huacnlee@longbridge-inc.com

- Added clarification in MCP documentation (EN, zh-CN, zh-HK) that the
MCP published on ChatGPT has special limitations
- Noted that trading/order placement functionality is excluded from the
ChatGPT-hosted MCP
- Explained that these restrictions are due to ChatGPT platform policy
rules
- Updated all three language variants of the MCP docs to keep content
consistent across locales

---------

Co-authored-by: Huacnlee Li Huashun <huacnlee@longbridge-inc.com>
2026-07-09 17:47:17 +08:00
liuyuhou-code aac040c7ce docs(trade): fix OrderTag enum value GTC to Gtc (#1142) 2026-07-09 10:31:34 +08:00