Update the delta / gamma / theta / vega / rho response-field
descriptions on the Calc Index (calc_indexes) interface across all three
languages (zh-CN / zh-HK / en).
Key change: **theta now documents the per-day semantics** — the raw
value has been divided by 365 on the server to convert to a daily value
(previously the docs incorrectly said divide by 100). delta/gamma get
full descriptions; vega/rho reworded to the /100 form.
Source of truth: the 期权希腊字母 spec table. Matches the SDK
(longbridge/openapi#586), MCP, and CLI changes.
## Problem
The `history_executions` docs (zh-CN + en) list only `symbol` /
`start_at` / `end_at` in the parameter table, and the response section
states "`has_more` is `true` when results exceed 1000" — but never
document **how** to page. The sibling `all_executions` doc does document
`page`. So a reader hitting the 1000-record cap has no documented way to
paginate.
This surfaced downstream in longbridge/longbridge-terminal#320, where a
consumer building a ledger assumed windowed queries silently truncate at
1000 with no way forward.
## Change
Add the `page` parameter row to `history_executions.mdx` (zh-CN + en),
copied from `all_executions`.
**Verified against the production gateway**: `page` is 1-based and
respected — on an account with N (<1000) fills, `page=1` returns all N
and `page=2` returns empty; per-page size is fixed at 1000 (no size
param).
Refs longbridge/longbridge-terminal#320
Fixes#1249.
The Java example for the rank-list (人气排行榜) API called
`ctx.getRankList("hot_all-us", false)` with positional args, but the
Java API takes a `RankListOptions` object:
```java
RankListOptions opts = new RankListOptions();
opts.key = "hot_all-us";
opts.needArticle = false;
var resp = ctx.getRankList(opts).get();
```
Updated the Java example in all three languages (en / zh-CN / zh-HK).
The Rust / Python / Node.js / C++ examples in the same page were already
correct.
The accompanying runtime crash (`JNI call failed`) is fixed separately
in longbridge/openapi#587.
Composite components, build fix (§S1 already landed via Sätteri opt-out),
canary preview, and legacy cutover. §S1 documents both Plan A (unified()
processor, chosen path) and Plan B fallback (Astro 6 downgrade, not
needed).
Co-Authored-By: Claude Opus 4.7 <noreply@anthropic.com>
Rename all 882 markdown files under docs/{en,zh-CN,zh-HK}/ from .md to
.mdx, escaping <email@host> autolinks and bare {ident} braces that mdx
would misinterpret as JSX. Frontmatter untouched.
Co-Authored-By: Claude Opus 4.7 <noreply@anthropic.com>
Move vitepress config, theme, postcss and unocss configs into
.legacy/vitepress-reference/ for use as a source-of-truth reference
while we port components to React. Astro dependencies not yet
installed; scripts entry-points point to astro but running them will
fail until T2 lands astro.config.ts and dependencies.
Co-Authored-By: Claude Opus 4.7 <noreply@anthropic.com>
## 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>
🤖 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>
## 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>
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
- 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
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>
## 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>
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.
## 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>
`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>
🤖 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()` |
🤖 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>
## 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>
🤖 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>
🤖 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>
🤖 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>
🤖 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>
## Summary
- Add Longbridge ChatGPT App guidance across the home page, MCP docs,
Skill install docs, QA docs, and Longbridge Skill metadata.
- Update the Skill hero with a ChatGPT banner and third ChatGPT install
tab while keeping the generic Copy command flow intact.
- Replace the old ChatGPT Developer Mode flow with the official ChatGPT
Apps search, authorize, and @longbridge usage flow, including
screenshots.
## Test Plan
- git diff --check
- git diff --cached --check
- bun run build:release
Notes: build passes with the existing VitePress dynamic/static import
and chunk-size warnings.
---------
Co-authored-by: Codex <codex@openai.com>
- Add client_request_id parameter to prevent duplicate order submissions
- Document 10-minute server-side cache duration
- Include idempotency explanation and examples in all three language
versions (en, zh-CN, zh-HK)
- Update parameter tables and add new Idempotency/冪等性 sections
Co-authored-by: kun.liu <kun.liu@longbridge-inc.com>
Hogan