Commit Graph

144 Commits

Author SHA1 Message Date
Jason Lee dbe0e0ce6e docs(cli): add v0.17.3 release notes (#917)
## Summary

- Add v0.17.3 release notes to `release-notes.md` and `changelog.md` (en
/ zh-CN / zh-HK)
- Covers: token refresh hang fix, `auth status` three-state display,
`--auth-code` login fix, Windows browser URL fix
- Based on PRs: longbridge/longbridge-terminal#134, #136, #137

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

Co-authored-by: Claude Sonnet 4.6 <noreply@anthropic.com>
2026-04-22 12:57:23 +08:00
Jason Lee 1f84bf5fed docs(cli): update command count from 50+ to 65+ (#914)
## Summary

- Update CLI command count from 50+ to 65+ across all pages and locales
- Files updated: CLI overview pages (en/zh-CN/zh-HK), homepage locale
files (en/zh-CN/zh-HK), and ArchCanvas component

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

Co-authored-by: Claude Sonnet 4.6 <noreply@anthropic.com>
2026-04-21 11:08:31 +08:00
Jason Lee 66ebe4cad0 docs(cli): add v0.17.1 release notes (#911)
## Summary

- Add CLI v0.17.1 release notes to changelog and release-notes pages
(en, zh-CN, zh-HK)
- Update `longbridge-terminal` submodule to v0.17.1
- Documents `completion` command for shell tab-completion
(bash/zsh/fish/elvish/powershell)
- Documents new `User-Agent` and `x-cli-cmd` request headers

## Test plan

- [ ] Verify release notes render correctly in all three language
versions
- [ ] Check changelog entries are correctly dated (2026-04-20)

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

Co-authored-by: Claude Sonnet 4.6 <noreply@anthropic.com>
2026-04-20 17:20:16 +08:00
Jason Lee 0c7e6292ca docs(cli): add v0.17.0 release notes and new command docs (#899)
## Summary

- Add v0.17.0 release notes to `release-notes.md` and `changelog.md`
- New doc pages: `dca` (recurring investment), `sharelist` (community
stock lists), `short-positions` (US short interest data)
- Update `option.md`: fix `option chain` basic usage output (expiry
dates, not strikes); add `option volume` section
- Update `profit-analysis.md`: add `--start`/`--end` date range; updated
output format (percentage yields, new fields)
- All changes synced across en / zh-CN / zh-HK locales

## Test plan

- [ ] Build and verify new pages render correctly in sidebar
- [ ] Confirm `dca`, `sharelist`, `short-positions` pages appear under
correct categories
- [ ] Verify `option.md` and `profit-analysis.md` updates look correct

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

Co-authored-by: Claude Sonnet 4.6 <noreply@anthropic.com>
2026-04-17 13:50:00 +08:00
Jason Lee ad09de0f9f docs(cli): fix v0.17.0 → v0.16.3 and add release notes (#897)
## Summary

- Rename incorrectly labeled `v0.17.0` entry to `v0.16.3` in
`release-notes.md` and `changelog.md` (all 3 locales: en / zh-CN /
zh-HK)
- Update changelog date from `2026-04-15` to `2026-04-16`
- Add v0.16.3 new content from
[longbridge/longbridge-terminal#114](https://github.com/longbridge/longbridge-terminal/pull/114):
  - Fix: US index symbols (`.DJI.US`, `.VIX.US`) now parse correctly
  - "Did you mean?" hints when a query returns no data

## Test plan

- [ ] Release Notes page shows `v0.16.3` (not `v0.17.0`) as the latest
entry
- [ ] Changelog shows `2026-04-16 / CLI v0.16.3` with all 4 bullet
points
- [ ] All 3 locales consistent

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

Co-authored-by: Claude Sonnet 4.6 <noreply@anthropic.com>
2026-04-16 11:15:58 +08:00
Jason Lee 718abf3d76 docs(cli): add v0.17.0 commands and release notes (#896)
## Summary

- **`auth` subcommand group** (`longbridge/longbridge-terminal#109`):
updated `install.md` in all 3 locales — `login`/`logout` → `auth
login`/`auth logout`, added `auth status` section
- **`alert enable/disable`** (`longbridge/longbridge-terminal#108`):
updated `alert.md` in all 3 locales with enable/disable subcommand
examples
- Added **v0.17.0** entry to `release-notes.md` and `changelog.md` in
all 3 locales

## Test plan

- [ ] Install page shows `auth login` / `auth logout` / `auth status`
correctly
- [ ] Alert page shows `enable` / `disable` examples
- [ ] Release notes and changelog show v0.17.0 at the top

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

---------

Co-authored-by: Claude Sonnet 4.6 <noreply@anthropic.com>
2026-04-16 09:56:42 +08:00
Jason Lee c80b23cc0c docs: Add Theta/Vega/Rho unit notes and CLI v0.16.1 release notes (#895)
## Summary
- **calc-index API docs** (EN+CN): Document that Theta, Vega, and Rho
raw values need to be divided by 100 for standard per-share conventions
- **CLI release notes** (EN+CN): Add v0.16.1 covering:
  - `option quote` full API field output
  - `calc-index` Greeks normalization (÷100)
  - `calc-index` auto-detect option symbols for default fields
- Parameter standardization from longbridge/longbridge-terminal#102:
`--adjust none/forward`, `--tif day/gtc/gtd`, `--format table`,
`--start/--end` for finance-calendar, `--start-date` YYYY-MM-DD for
statement
- Command name revert from longbridge/longbridge-terminal#105:
`overview` → `static`, `metrics` → `calc-index`

## Related PRs
- longbridge/longbridge-terminal#104 — option quote + Greeks
normalization
- longbridge/longbridge-terminal#105 — revert command renames
- longbridge/longbridge-terminal#102 — parameter standardization

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

---------

Co-authored-by: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
2026-04-14 22:00:57 +08:00
ihavecoke 904aeb8b5b Fix stats-grid popover item links and icon alignment (#891)
- Remove clickable links from hover card items in stats-grid popover
- Change hc-item align-items from flex-start to center for icon
alignment
- Fix URL formatting in llm.md across all three locales

Co-authored-by: Claude Sonnet 4.6 <noreply@anthropic.com>
2026-04-14 10:37:56 +08:00
Jason Lee 3f66b191fb docs(cli): add v0.16.0 commands and release notes (#889)
## Summary

- Add documentation for 14 new CLI commands introduced in v0.16.0 across
all three languages (en/zh-CN/zh-HK), each with real command output
examples
- New commands: `company`, `executive`, `industry-valuation`,
`operating`, `corp-action`, `invest-relation`, `constituent`,
`market-status`, `broker-holding`, `ah-premium`, `trade-stats`,
`anomaly`, `alert`, `profit-analysis`
- Add v0.16.0 release notes and changelog entries
- Add `intraday --date` historical data documentation
- Change TUI sidebar icon to `square-terminal`
- Translate Chinese text in English docs (`participants`, `fund-holder`)
- Fix aside TOC unnecessary scroll and breadcrumb border overlap
- Homepage and dark mode refinements
- Update `longbridge-terminal` submodule to latest main

## Test plan

- [ ] Verify all 14 new command pages render correctly in en/zh-CN/zh-HK
- [ ] Verify release notes and changelog display properly
- [ ] Verify TUI sidebar icon shows correctly
- [ ] Verify aside TOC no longer scrolls when content fits
- [ ] Verify breadcrumb border no longer overlaps with TOC

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

---------

Co-authored-by: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
2026-04-13 22:13:37 +08:00
ihavecoke b6e83e209a Rebuild homepage with new brand design system and interactive sections (#888)
## Summary

A complete overhaul of the Longbridge Developers homepage, introducing a
new brand design system built on inspira-ui animations, interactive
product showcases, and a unified multi-language content structure.

  ### New homepage sections
- **HeroSection** — Animated FlickeringGrid background, ColourfulText
rotating product showcase, interactive CTA buttons
- **PlatformStats** — 4 key stats with animated NumberTicker and hover
detail cards
- **CapSection** — Developer capability highlights with Spotlight +
Expand hover interaction
- **ArchSection** — Architecture diagram (custom SVG bus-topology) with
SdkMarquee
- **ProductCLI** — Interactive terminal mockup with real CLI output,
theme-aware (follows VitePress isDark), click-to-switch features
- **ProductMCP** — Custom SVG bus-topology diagram replacing VueFlow,
per-client config panels (shell/JSON/UI), tab sync with diagram
- **ProductSkill** — AI agent simulator with macOS traffic light dots
and install flow
- **ProductOpenAPI** — Bento Grid SDK showcase with Shiki syntax
highlighting, 6 SDKs × 4 domain code examples
  - **GetStarted** — Quick-start cards

  ### Design system additions
- 15+ inspira-ui animation components (`FlickeringGrid`,
`ColourfulText`, `NumberTicker`, `BorderBeam`, `Marquee`,
`AnimatedBeam`, etc.)
  - Tailwind CSS integration (`postcss.config.mjs`, `tailwind.css`)
- Unified section styles: consistent title/subtitle spacing (24px gap),
muted subtitle color, 14px minimum font size

  ### i18n
  - 150+ new keys added across `en.json`, `zh-CN.json`, `zh-HK.json`
  - All three locales kept in sync
2026-04-13 19:57:54 +08:00
Jason Lee be6a8cbfd9 docs(cli): add missing subcommands and statement docs (#886)
## Summary
- **topic**: Added `mine`, `create`, `replies`, `create-reply`
subcommand docs (previously only had list and detail)
- **kline**: Fixed `history` subcommand syntax — was incorrectly using
non-existent top-level `--start`/`--end` flags
- **investors**: Added `changes` subcommand for comparing position
changes between two 13F filings
- **statement**: Created new command docs covering `list` and `export`
subcommands (was completely missing)

All changes synced across en, zh-CN, zh-HK.

## Test plan
- [ ] Verify `bun run dev` builds without errors
- [ ] Check topic, kline, investors, statement pages render correctly in
all 3 languages
- [ ] Confirm sidebar shows statement under Portfolio & Account section

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

Co-authored-by: Claude Opus 4.6 <noreply@anthropic.com>
2026-04-11 23:39:32 +08:00
Jason Lee 4b99892fe5 docs(cli): replace iframe with SVG image link for asciinema demo
Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
2026-04-10 18:47:22 +08:00
Jason Lee 7d0022c8d9 docs: Fix CLI pages in cn region. (#883)
## Summary

- Rename `installation.md` → `install.md` in all three locales (en,
zh-CN, zh-HK)
- Update all internal links pointing to `/docs/cli/installation`
- Update sidebar `includes('installation')` matcher
- Add `/docs/cli/index.md` and `/docs/cli/install.md` to cn region
whitelist (`open.longbridge.cn`)

## Test plan

- [ ] Verify `/docs/cli/install` loads correctly
- [ ] Verify `/zh-CN/docs/cli/install` and `/zh-HK/docs/cli/install`
load correctly
- [ ] Verify sidebar Installation link works in all locales
- [ ] Verify `bun run dev:cn` shows `/docs/cli` and `/docs/cli/install`

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

---------

Co-authored-by: Claude Sonnet 4.6 <noreply@anthropic.com>
2026-04-10 15:52:46 +08:00
Jason Lee 77c7e128b9 feat(cli): Add cli full commands docs. (#882)
## Summary

- Add `github` icon SVG to `SIDEBAR_ICONS` in `gen.ts`
- Export `SIDEBAR_ICONS_MAP` for use in sidebar configs
- Fix zh-CN/zh-HK sidebar link generation to include locale prefix
(fixes link doubling bug)
- Inject GitHub repo link after Installation item in CLI sidebar for all
three locales (en, zh-CN, zh-HK)

## Test plan

- [ ] Verify CLI sidebar shows: Overview → Installation → GitHub (with
icon) → Market Data → ...
- [ ] Verify GitHub link works and opens
`https://github.com/longbridge/longbridge-terminal`
- [ ] Verify zh-CN and zh-HK CLI sidebar links are correct (no doubling)

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

---------

Co-authored-by: Claude Sonnet 4.6 <noreply@anthropic.com>
2026-04-10 15:33:28 +08:00
Jason Lee d3444dc3b4 fix: update issue links from longbridge/openapi to longbridge/developers (#880)
Issues 已从 longbridge/openapi 迁移至 longbridge/developers,同步更新文档中所有相关链接。

## 修改内容

- `docs/.vitepress/locales/{en,zh-CN,zh-HK}/nav.ts` — 导航栏 Issues 链接
- `docs/{en,zh-CN,zh-HK}/docs/getting-started.md` — 文档正文中的 Issues 链接
2026-04-10 11:49:27 +08:00
Jason Lee d8e0d9fc67 docs(cli): Add insider-trades, investors commands. (#412)
## Summary

- Rename `longbridge balance` to `longbridge assets` in CLI docs
(en/zh-CN/zh-HK)
- Update page title from "Get Account Balance" to "Get Account Assets"
in `trade/asset/account.md`

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

---------

Co-authored-by: Claude Sonnet 4.6 <noreply@anthropic.com>
2026-04-09 22:39:39 +08:00
Cooooooker 56be71dfc8 docs: Add is_pinned field to watchlist and limit hashtags to 1 (#413)
- Add `is_pinned` boolean field to watchlist groups API response
- Update create_topic hashtags maximum from 5 to 1

Co-authored-by: chengzhipeng <zhipeng.cheng@longbridge-inc.com>
Co-authored-by: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
2026-04-09 18:45:49 +08:00
Jason Lee f63b957d98 docs(cli): add v0.14.1 and v0.14.2 release notes (#411)
## Summary
- Add v0.14.2 release notes: `--lang` global flag for content language
- Add v0.14.1 release notes: CN region login support, `-v` flag
- Updated in cli.md and changelog.md across all three language versions
(en, zh-CN, zh-HK)

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

Co-authored-by: Claude Sonnet 4.6 <noreply@anthropic.com>
2026-04-08 17:26:22 +08:00
Jason Lee 33813fcc2b docs(mcp): add Codex client setup and remove ChatGPT (#408)
## Summary
- Add Codex client setup instructions with detailed GUI steps (Settings
→ MCP Servers → Add Server, Streamable HTTP, then Authenticate)
- Remove ChatGPT from the client list (MCP installation not supported)
- Changes applied across all three language versions (en, zh-CN, zh-HK)

## Test plan
- [ ] Verify Codex setup steps are accurate and complete
- [ ] Confirm ChatGPT entry is removed from all three language files

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

---------

Co-authored-by: Claude Sonnet 4.6 <noreply@anthropic.com>
2026-04-08 16:53:25 +08:00
Jason Lee 5918efb5cb docs(quote): clarify overnight quote requires LV1 quote card and US stocks only (#407)
## Summary

Closes https://github.com/longbridge/openapi/issues/514

-
在所有涉及夜盘的文档位置(getting-started、qa/quote、pull/quote、candlestick、history-candlestick)补充说明:
  - 夜盘数据默认不包含,需购买「LV1 实时行情 (OpenAPI)」行情卡
  - 目前夜盘行情仅支持美股,港股暂不支持
- 三语言(EN / zh-CN / zh-HK)同步更新

## Test plan

- [ ] 预览各文档页面,确认说明文字正确显示
- [ ] 确认 zh-CN / zh-HK 简繁体内容一致

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

---------

Co-authored-by: Claude Sonnet 4.6 <noreply@anthropic.com>
2026-04-08 16:10:20 +08:00
Jason Lee 91e46f9024 docs(skill): add Skill install step and CN mirror download link (#406)
## Summary

- Add **Step 1 — Install the Skill** section to the English install page
(was missing `npx skills add longbridge/developers` command and ZIP
download link), bringing it in line with zh-CN/zh-HK
- Add CN mirror download URL
(`https://open.longbridge.cn/skill/longbridge.zip`) for `longbridge.zip`
across all three locales
- Fix relative ZIP paths (`/skill/longbridge.zip`) to absolute URLs in
zh-CN/zh-HK
- Restructure English page sections: `Method 1/2` → `Step 2 Method A/B`

## Test plan

- [ ] Verify EN install page shows Step 1 with npx command and ZIP
download (with CN mirror link)
- [ ] Verify zh-CN and zh-HK pages show CN mirror link next to ZIP
download

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

---------

Co-authored-by: Claude Sonnet 4.6 <noreply@anthropic.com>
2026-04-03 22:12:23 +08:00
hold-baby 267a813a7d feat(region): add China region build with page whitelist, URL rewriti… (#405)
…ng and independent deployment

Co-authored-by: 袁昌瑞 <changrui.yuan@longbridge-inc.com>
2026-04-03 21:33:12 +08:00
Jason Lee 2844f33412 docs: Update CLI auth to device flow and add v0.14.0 release notes (#404)
## Summary

- Update authentication docs: OAuth browser flow → OAuth Device Auth
Flow (works in local, SSH, headless environments)
- Remove `--headless` references
- Add v0.14.0 release notes across all three languages (en, zh-CN,
zh-HK)

## v0.14.0 highlights

- Device auth login as default (`--headless` removed)
- Order enhancements: trailing stop, AO order type, `--expire-date`,
`--outside-rth`, `--remark`
- Linux segfault fix via musl binary

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

---------

Co-authored-by: Claude Sonnet 4.6 <noreply@anthropic.com>
2026-04-02 17:30:06 +08:00
Jason Lee ec6399fec0 docs: Update scoop install URL. 2026-04-02 10:53:15 +08:00
Jason Lee d8fe8f36f2 fix: Update Scoop install path to .scoop/longbridge.json (#402)
## Summary

- Rename `scoop.json` → `.scoop/longbridge.json` in
`longbridge-terminal` submodule — Scoop requires the manifest filename
to match the app name
- Update Scoop install command in docs (en / zh-CN / zh-HK) to point to
the new path

## Test plan

- [ ] Verify `scoop install
https://raw.githubusercontent.com/longbridge/longbridge-terminal/main/.scoop/longbridge.json`
installs successfully on Windows

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

---------

Co-authored-by: Claude Sonnet 4.6 <noreply@anthropic.com>
2026-04-02 10:40:49 +08:00
Jason Lee dc68e0caec docs: Add Windows Scoop install, Revoking Authorization, and skills.sh link (#401)
## Summary

- Add Windows [Scoop](https://scoop.sh) installation option across all
docs (`cli.md` en/zh-CN/zh-HK, `skill/install` en/zh-CN/zh-HK, skill
references)
- Add **Revoking Authorization** section to `skill/install`
troubleshooting and `references/setup.md`
- Add "Also available on skills.sh and GitHub." link below the ZIP
download button in `Skill.vue`

The Scoop manifest (`longbridge.json`) and auto-update workflow
(`update-scoop.yml`) are in a separate commit in the
`longbridge-terminal` submodule.

## Test plan

- [ ] Verify Scoop install command renders correctly in all 3 language
versions of `cli.md` and `skill/install`
- [ ] Verify Revoking Authorization appears in Troubleshooting section
(en) and 常见问题 (zh-CN/zh-HK)
- [ ] Verify "Also available on skills.sh and GitHub." appears below ZIP
download button on skill page
- [ ] Confirm `longbridge.json` is valid JSON and Scoop can parse it

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

---------

Co-authored-by: Claude Sonnet 4.6 <noreply@anthropic.com>
2026-04-01 20:43:39 +08:00
Jason Lee b99cfdf896 feat(skill): revamp install guide and add capability reference (#400)
## Summary

- Simplified install pages (en/zh-CN/zh-HK) to a clean two-step
structure: install Skill → connect account (CLI or MCP)
- Added npx/bunx install commands with Node.js/Bun environment notes
- Added Windows binary install instructions (download zip from GitHub
Releases)
- Added Homebrew install link for macOS, Linux-specific curl command
- Added mainland China MCP accelerated endpoint
(`openapi.longbridge.cn/mcp`)
- Added Claude Desktop, Gemini CLI, Warp to supported MCP clients table
- Added "Why Claude.ai and ChatGPT.com don't work" explanation section
- Added **Capability Reference** section to Skill.vue — 6-card 3×2 grid
covering all CLI/MCP capabilities
- Restored heroClients list to original five (OpenClaw, ChatGPT, Claude,
Claude Code, Codex)

## Test plan

- [ ] Build passes (`bun run build:canary`)
- [ ] Skill page renders capability reference section correctly across
en/zh-CN/zh-HK
- [ ] Install pages display correctly in all three languages
- [ ] MCP table and Windows install instructions render as expected

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

---------

Co-authored-by: Claude Sonnet 4.6 <noreply@anthropic.com>
2026-04-01 19:29:45 +08:00
Jason Lee 2a5b6a3840 docs: update changelog with recent API and CLI changes (#399)
## Summary

- Add **CLI v0.13.0** Fundamentals & Analysis section (10 new commands:
`financial-report`, `valuation`, `forecast-eps`, `consensus`,
`institution-rating`, `shareholder`, `fund-holder`, `dividend`,
`finance-calendar`, `exchange-rate`) + domain-grouped naming refactor
- Add **Statement API** (`GET /v1/statement/list`, `GET
/v1/statement/download`)
- Add **Community API** (my topics, create topic, topic detail, topic
replies, create reply)
- Bump `longbridge-terminal`, `openapi`, `openapi-go` submodules
- All three locales (en / zh-CN / zh-HK) kept in sync

## Test plan

- [ ] Verify changelog page renders correctly in all 3 locales (`bun run
dev`)

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

Co-authored-by: Claude Sonnet 4.6 <noreply@anthropic.com>
2026-04-01 13:34:35 +08:00
Jason Lee 00e156831b docs(cli): add fundamentals & analysis commands for v0.13.0 (#398)
## Summary

- Add new **Fundamentals & analysis** section to CLI docs (EN / zh-CN /
zh-HK)
- Documents 10 new commands introduced in [longbridge-terminal
v0.13.0](https://github.com/longbridge/longbridge-terminal/releases/tag/v0.13.0):
  - `financial-report` — financial statements with period/type filters
- `valuation` — P/E, P/B, P/S, dividend yield snapshot + peer comparison
+ history mode
  - `forecast-eps` — analyst EPS forecast consensus
- `consensus` — revenue/profit/EPS consensus with beat/miss annotations
- `institution-rating` / `institution-rating detail` — rating
distribution and monthly trends
- `shareholder` — institutional shareholders with change tracking and
sort options
  - `fund-holder` — funds and ETFs holding a symbol
- `dividend` / `dividend detail` — dividend history and distribution
plan
- `finance-calendar` — financial calendar by event type (financial,
report, dividend, ipo, macrodata, closed)
  - `exchange-rate` — exchange rates for all supported currencies

## Test plan

- [ ] Verify new section renders correctly in dev preview (`bun run
dev`)
- [ ] Confirm all three language versions are in sync

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

---------

Co-authored-by: Claude Sonnet 4.6 <noreply@anthropic.com>
2026-04-01 11:51:18 +08:00
Jason Lee cf021667ff cli: Refactor domain-grouped command names (#397)
Co-authored-by: Claude Sonnet 4.6 <noreply@anthropic.com>
2026-04-01 11:32:36 +08:00
geomantic_omen 137ffc9329 docs: Add statement API documentation. (#393)
feat(statement): add account statement CLI commands and API
documentation

- Add statement list and export CLI command examples to docs (en, zh-CN,
zh-HK)
- Document daily and monthly statement listing with filtering options
- Document statement export with section selection and output format
options (Markdown, CSV)
- Add Statement tag and endpoints to OpenAPI spec (/v1/statement/list,
/v1/statement/download)
- Add statement reference documentation to CLI skill guide
- Create comprehensive statement.md reference guide for CLI usage and
examples

---------

Co-authored-by: geomantic <lei.zhong@longbridge-inc.com>
Co-authored-by: Jason Lee <huacnlee@gmail.com>
Co-authored-by: Claude Sonnet 4.6 <noreply@anthropic.com>
2026-03-30 14:59:03 +08:00
Jason Lee e61c421395 feat: add CliCommand block with syntax highlighting and multi-example docs (#390)
## Summary

- New markdown-it plugin (`cli-command.ts`) renders `<CliCommand>` tags
as styled code blocks with proper shiki dual-theme color variables
(`--shiki-light` / `--shiki-dark`) for syntax highlighting: longbridge
binary (purple), subcommands (blue), args and inline comments (gray)
- Header changed from compact bar to h2-style title matching SDK Links
section; Install CLI link floats right with no border, pointing to
`/docs/cli`
- Single-line `<CliCommand>content</CliCommand>` tokens (parsed as
paragraph > inline by markdown-it) now correctly handled via Case 2
token splice
- Expanded all non-trade `<CliCommand>` blocks from single-line to
multi-line format with 2–4 real verified examples per command and
locale-aware comments (en / zh-CN / zh-HK) across quote pull, content,
subscribe, security, and watchlist docs

## Test plan

- [ ] Run `bun run dev` and verify CliCommand blocks render with correct
syntax highlighting in light and dark mode
- [ ] Verify h2 title "CLI" appears with Install CLI link on the right
(no border)
- [ ] Verify Install CLI link points to `/docs/cli`
- [ ] Check a few pages across en / zh-CN / zh-HK locales

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

---------

Co-authored-by: Claude Sonnet 4.6 <noreply@anthropic.com>
Co-authored-by: github-actions[bot] <41898282+github-actions[bot]@users.noreply.github.com>
2026-03-27 14:19:36 +08:00
Jason Lee 36734e7e02 feat: add topic detail, replies, and create reply APIs with docs (#389)
## Summary

- **openapi.yaml**: add 3 new endpoints (`GET /content/topics/{id}`,
`GET /POST /content/topics/{topic_id}/comments`) with rich Markdown
descriptions, rate-limit tables, and tickers abuse warnings; rename
`list_topic_comments` → `list_topic_replies` and `create_topic_comment`
→ `create_topic_reply` throughout
- **docs (en / zh-CN / zh-HK)**: new pages for `topic_detail`,
`topic_replies`, `create_reply`; update `create_topic` schema to full
`OwnedTopic` response; sync permission copy, rate-limit wording, and
`TipContainer` highlights across all locales
- **ApiReference.vue**: minor formatting cleanup

## Test plan

- [ ] Run `bun run dev` and verify the 3 new pages render correctly in
all 3 locales
- [ ] Confirm `create_topic` response schema now shows the full
OwnedTopic fields
- [ ] Confirm TipContainer warning appears on create_topic and
create_reply pages
- [ ] Verify API reference page shows the renamed operationIds

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

---------

Co-authored-by: Claude Sonnet 4.6 <noreply@anthropic.com>
2026-03-26 20:14:49 +08:00
Jason Lee 8f2d4689dd docs: add OAuth 2.0 auth flow to skill install guide, remove API Key references (#386)
## Summary

- Add OAuth 2.0 authorization section to all three locale Skill install
pages (en / zh-CN / zh-HK), covering: trigger flow, explicit `longbridge
login`, token cache location, and revocation
- Add "Updating the Skill" section noting that `longbridge.zip` is
updated periodically
- Update FAQ entries to point to OAuth 2.0 flow instead of mentioning
API Token
- Remove Legacy API Key sections from `skills/longbridge` references:
`setup.md`, `python-sdk/overview.md`, `rust-sdk/overview.md`, `mcp.md`
(Self-Hosted Binary section removed)
- Fix Rust SDK "Creating Contexts" example to use `Config::from_oauth`
instead of `Config::from_apikey_env`

## Test plan

- [ ] Verify install pages render correctly in all three locales
- [ ] Confirm no remaining references to API Key / API Token in skill
install docs
- [ ] Confirm OAuth 2.0 flow steps are accurate and complete

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

---------

Co-authored-by: Claude Sonnet 4.6 <noreply@anthropic.com>
2026-03-26 13:31:19 +08:00
Jason Lee b74f40145c docs: add Community content API docs (my-topics, create-topic) (#384)
## Summary

- Add `my_topics` and `create_topic` API reference pages in all 3
locales (en/zh-CN/zh-HK), using `<SDKLinks>` + `<Tabs>` pattern with
CLI, Python, Python async, Node.js, Java, Rust, C++, Go examples
- Rename Content sidebar category → **Community** across all locales
- Rename `security_topics` page title → "Get Community Topics by Symbol"
- Add Community content section to `cli.md` (all locales)
- Update `openapi.yaml`: add `x-codeSamples` for `list_my_topics` and
`create_topic`, fix `create_topic` schema (`title` not required at
schema level), move all community endpoints to `Community` tag
- Update CLI skill overview with `longbridge update` command details

## Key design notes

- `create_topic` page includes an article/post comparison table
explaining title requirement and body format differences
- SDK method signatures verified from source code
(`/Users/jason/work/openapi/`)

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

---------

Co-authored-by: Claude Sonnet 4.6 <noreply@anthropic.com>
2026-03-25 19:21:52 +08:00
Jason Lee 43b364794f docs: restructure Skill install guide with universal methods first
Reorganize the install page to lead with client-agnostic methods (ZIP
download and npx/bunx CLI) before client-specific setup guides. Adds
-g/-y flag explanations, bunx alternative, and replaces OpenClaw slash
command with a natural-language zip install instruction to prevent AI
misinterpretation.

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
2026-03-25 14:54:47 +08:00
Jason Lee 9476486b64 feat: integrate API appendix into API Reference, remove redundant docs (#383)
## Summary

- 将 HTTP API 认证/错误码文档通过 `x-pages` 扩展嵌入 `openapi.yaml`,在 `/docs/api/`
侧边栏展示为独立信息页
- 更新 `ApiReference.vue`:解析 `x-pages`、侧边栏展示、URL 状态管理、中英文切换
- 将 Socket 文档从 `api-reference/socket/` 移至独立类目 `socket/`(三语言,URL 不变)
- 删除已合并的冗余文档(12 个文件:3 语言 × 4 文件)

## Test Plan

- [ ] 访问 `/docs/api/`,侧边栏顶部显示 Authentication 和 Error Codes
- [ ] 点击 Authentication,展示合并后的 OAuth 2.0 认证内容
- [ ] 点击 Error Codes,展示错误码表格
- [ ] URL 状态:`?page=authentication` / `?page=error-codes`
正确写入,浏览器前进/后退正常
- [ ] 中文路由 `/zh-CN/docs/api` 侧边栏显示 认证 / 错误码
- [ ] Socket 页面(如 `/socket/hosts`)仍可正常访问
- [ ] 侧边栏 API 附录 类目已消失

---------

Co-authored-by: Claude Sonnet 4.6 <noreply@anthropic.com>
2026-03-24 22:13:20 +08:00
Jason Lee 6a4b543645 docs: Add openapi.yaml (#382)
Co-authored-by: Claude Sonnet 4.6 <noreply@anthropic.com>
2026-03-24 21:37:42 +08:00
Jason Lee c4dd3714c4 Revert skill paths. 2026-03-23 22:07:48 +08:00
Jason Lee 7a07e916c0 docs: clarify manual-only install for Claude.ai and ChatGPT (#379)
## Summary

- Add blockquote notes to the Claude.ai and ChatGPT sections explaining
that automated installation is not possible due to sandboxed execution
environments
- Claude.ai restricts outbound access to a fixed domain whitelist;
ChatGPT similarly cannot auto-install Skills during a conversation
- Users are directed to the manual download/upload flow in both cases

## Test plan

- [ ] Verify blockquote notes render correctly in all three locales (en,
zh-CN, zh-HK)

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

---------

Co-authored-by: Claude Sonnet 4.6 <noreply@anthropic.com>
2026-03-23 22:02:41 +08:00
Jason Lee 67e3857f58 docs: add skills.sh and GitHub links to OpenClaw install section
Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
2026-03-23 21:42:04 +08:00
Jason Lee e18f7061fc docs: Fix incorrect install skill command. 2026-03-23 21:31:45 +08:00
Jason Lee 5305d8cfc2 docs: fix CN region API host to use openapi.longbridge.cn (#363)
## Summary

- Update CN-specific API host from `openapi.longbridge.com` to
`openapi.longbridge.cn` across all language versions (zh-CN, zh-HK, en)
- Affected files: `getting-started.md`, `how-to-access-api.md`,
`refresh-token-api.md`
- Global (non-CN) host `openapi.longbridge.com` remains unchanged

## Test plan

- [ ] Verify CN region docs show `openapi.longbridge.cn`
- [ ] Verify global/production docs still show `openapi.longbridge.com`

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

Co-authored-by: Claude Sonnet 4.6 <noreply@anthropic.com>
2026-03-23 20:53:36 +08:00
Jason Lee c032ae2e83 Fix skill path 404 (#377) 2026-03-23 20:53:05 +08:00
Jason Lee 0add508ae2 feat: add Skill page with interactive demo (#376)
## Summary

- **New `/skill` page** with full trilingual support (en / zh-CN /
zh-HK)
- **Interactive chat demo**: 4 scenarios (Live Quote, Portfolio,
Subscription, Earnings) × 5 AI clients (OpenClaw, ChatGPT, Claude,
Claude Code, Codex) with typewriter animation
- **Rich response rendering**: tables with Shadcn-style borders, mini
SVG sparkline charts, syntax-highlighted code blocks
- **Scenario cards section** below the demo describing use cases
- **Nav update**: Skill link added to all three locale nav configs

## Bug Fixes

- **Syntax highlighter**: replaced chained-regex approach with a
single-pass tokenizer. The old code ran number → keyword → string
regexes sequentially on the same string — the keyword regex matched
`class` inside generated `<span class="hl-n">` attributes, and the
string regex matched `"hl-n"` as a string literal, corrupting the HTML
structure entirely
- **v-html routing**: replaced `currentMessages[2]?.rich` template
condition with an explicit `isRichResponse` ref set in `runAnimation()`
to prevent incorrect branch selection when switching client tabs

## Test plan

- [ ] Visit `/skill`, `/zh-CN/skill`, `/zh-HK/skill` — page loads in all
locales
- [ ] Click through all 4 scenario tabs — animation plays correctly for
each
- [ ] Click through all 5 client tabs — correct message shown, Claude
Code tab shows syntax-highlighted code (not raw HTML)
- [ ] Verify sparkline charts render in the Live Quote / OpenClaw
scenario
- [ ] Verify table borders render correctly (outer border + row
dividers, no missing bottom border)
- [ ] Verify gain/loss values show green/red colors in tables

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

---------

Co-authored-by: Claude Sonnet 4.6 <noreply@anthropic.com>
2026-03-23 20:03:14 +08:00
Sunli fbf171fcb9 docs: add C++ OAuth config example to getting-started
Add C++ tab to the OAuth authorization section in getting-started
across zh-CN, en, and zh-HK.
2026-03-23 19:08:36 +08:00
Sunli 7067a8bf78 docs: add C++ examples to all getting-started scenarios
Add C++ tab for account balance, subscribe quote, submit order,
and today orders across zh-CN, en, and zh-HK.
2026-03-23 19:08:36 +08:00
Sunli 744a368119 docs: update C++ ContentContext examples to synchronous style
ContentContext::create(config) now returns synchronously in 4.0.5,
same as QuoteContext and TradeContext. Updated 6 files across
zh-CN, en, and zh-HK.
2026-03-23 19:08:36 +08:00
Sunli 5b3b3e006d docs: add Python (async) examples to getting-started scenarios 2026-03-23 19:08:36 +08:00
Sunli 5f1306f9a1 fix: remove extra blank lines in Python async code examples 2026-03-23 19:08:36 +08:00