Commit Graph

914 Commits

Author SHA1 Message Date
Endless 2f793134fa https://open.longbridge.com/zh-CN/skill/install/
https://open.longbridge.com/zh-CN/docs/mcp

这两个页面顶部 (#1022)

🤖 Auto-generated by Endless task
[#17](https://endless.longbridge-inc.com/projects/developers/tasks/17).

Initiated by: Huacnlee Li Huashun

## 背景

Longbridge Developers 网站(open.longbridge.com)使用自定义的 `AppNav` 组件替代
VitePress 默认导航栏。`AppNav` 被设计为 `position: fixed`,固定在页面顶部,高度 60px。

VitePress 默认会在 `VPContent` 上添加 `padding-top: var(--vp-nav-height)`
来补偿固定导航栏的高度,确保页面内容从导航栏下方开始显示。然而,`index.css` 中存在一条全量覆写规则,将所有 `.VPContent`
的 `padding-top` 强制设为 0,注释中错误地描述 AppNav 为 sticky(文档流内),因此"不需要 VitePress
的补偿"。

实际上 AppNav 是 `position: fixed`,不在文档流内,页面内容需要显式的 `padding-top`
才能从导航栏下方开始渲染。

## 根因

`docs/.vitepress/theme/style/index.css` 中存在如下规则:

```css
@media (min-width: 960px) {
  .VPContent {
    padding-top: 0 !important;
  }
}
```

该规则对所有 `.VPContent` 生效,完全抹除了 VitePress 为固定导航栏所添加的 60px `padding-top` 补偿。

对于有侧边栏的页面(`.VPContent.has-sidebar`),侧边栏布局会另行处理内容偏移,因此该 bug 不可见。但对于使用默认
doc 布局且 `sidebar: false` 的页面——即 `/skill/install` 和
`/docs/mcp`——内容会从视口顶部开始渲染,直接被固定导航栏遮挡。

## 摘要

- 解决的问题:`/skill/install` 和 `/docs/mcp` 页面(含 en / zh-CN / zh-HK
三语言版本)顶部内容被 AppNav 遮挡
- 做了什么:将 `index.css` 中覆写 `padding-top` 的选择器从 `.VPContent` 收窄为
`.VPContent.has-sidebar`,仅对有侧边栏的页面保持 `padding-top: 0`;无侧边栏页面则恢复
VitePress 默认的 `padding-top: var(--vp-nav-height)`(60px)
- 为什么这样做:修改量最小,仅影响一处选择器;避免修改 AppNav 的 `position` 属性(会牵连更多依赖固定定位的布局),也避免在
6 个 Markdown 文件中逐一添加 `padding-top`
- 如何验证:`bun run dev`,访问 `/zh-CN/skill/install/` 和
`/zh-CN/docs/mcp`,确认标题不再被导航栏遮挡;访问任意带侧边栏的文档页确认布局无变化

## 修改

| 文件 | 改动内容 |
|---|---|
| `docs/.vitepress/theme/style/index.css` | 将 `@media (min-width:
960px)` 块中的 `.VPContent` 选择器改为 `.VPContent.has-sidebar` |

## 关键决策

将选择器从 `.VPContent` 收窄为 `.VPContent.has-sidebar`,而不是删除该规则或修改 AppNav
的定位方式:有侧边栏的页面依赖 `padding-top: 0` 来避免额外偏移,改动最小化、影响面最小,且对所有未来新增的无侧边栏 doc
页面同样生效,无需逐页维护。

Co-authored-by: Huacnlee Li Huashun <huacnlee@longbridge-inc.com>
2026-05-21 13:31:55 +08:00
Endless 6299f499a4 将首页的:“专为 AI 而生” 改为 “让你的 AI 直连真实市场”,但帮我优化一下语句 (#1023) 2026-05-21 12:58:16 +08:00
Endless 62d152c446 developers 项目的 Footer 下的 Products 里面去掉 Docs link, 它不是一个独立的产品。 (#1021)
🤖 Auto-generated by Endless task
[#16](https://endless.longbridge-inc.com/projects/developers/tasks/16).

Initiated by: Huacnlee Li Huashun

## 背景

Longbridge Developers 网站 Footer 的 Products 栏目中包含一个 "Docs" 链接,指向
`/docs`(文档首页)。Products 栏目的定位是列出平台提供的独立产品,如 AI Skill、CLI、MCP、LLMs
等。文档(Docs)是网站的通用入口,本身不是一个独立的产品形态,放在 Products 栏目中会造成概念混淆。

去掉该链接可以让 Products 栏目的内容更加准确,突出平台真正对外提供的产品。文档入口仍然保留在 Resources 栏目(以
"Documentation" 标题链接到 `/docs`),用户依然可以通过该入口访问文档。

## 摘要

- 解决的问题:Footer Products 栏目中 "Docs" 链接与产品定义不符,文档是通用入口而非独立产品。
- 做了什么:从 `AppFooter.vue` 的 Products `<ul>` 列表中删除 `<li><a
:href="localePath('/docs')">Docs</a></li>` 这一行。
- 为什么这样做:Products 栏目应只列出平台产品(AI Skill、CLI、MCP、LLMs),文档入口已在 Resources
栏目中以 "Documentation" 存在,不需要重复出现在 Products 中。
- 如何验证:本地运行 `bun run dev`,打开任意页面,检查 Footer > Products 栏目,确认只剩 AI Skill /
CLI / MCP / LLMs 四项,不再出现 Docs 链接;同时确认 Resources 栏目的 Documentation
链接仍然存在。

## 修改

| 文件 | 改动内容 |
|---|---|
| `docs/.vitepress/theme/components/AppFooter.vue` | 从 Products 列表中删除指向
`/docs` 的 Docs 链接 |

## 关键决策

无。改动范围极小(删除单行),不涉及任何逻辑变更,也不影响其他语言版本(`AppFooter.vue` 是唯一的 Footer
组件,`localePath` 会自动处理多语言路径)。

Co-authored-by: Huacnlee Li Huashun <huacnlee@longbridge-inc.com>
2026-05-21 11:24:41 +08:00
Jason Lee 79ed227ba7 chore: Fix sdk install commands. 2026-05-21 11:00:47 +08:00
Jason Lee da67ec3587 chore: Fix home links (#1019) 2026-05-21 10:56:45 +08:00
Jason Lee cea1675f2f Fix logo link and click range. 2026-05-20 22:52:44 +08:00
Jason Lee 367633925c Fix build error 2026-05-20 22:34:11 +08:00
Jason Lee 83eccefb2d Fix longbridge.cn page links. (#1018) 2026-05-20 22:33:13 +08:00
Jason Lee 3e81bc6ca4 fix(nav): use fixed paths for /dashboard and /log-out (#1016)
## Summary

- `/dashboard` 和 `/log-out` 属于另一个应用的路由,不应加语言前缀
- 将 `localePath('/dashboard')` 和 `localePath('/log-out')` 替换为固定路径
`/dashboard` 和 `/log-out`
- 涉及文件:`AppNav.vue`、`UserAvatar/index.vue`、`HeroSection.vue`

## Test plan

- [ ] 登录后点击导航栏 Dashboard 按钮,确认跳转到 `/dashboard`
- [ ] 点击头像下拉菜单中的 Dashboard / Log out,确认路径正确无语言前缀
- [ ] 在 `/zh-CN/` 页面下验证以上链接同样正确

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

Co-authored-by: Claude Sonnet 4.6 <noreply@anthropic.com>
2026-05-20 22:00:50 +08:00
Jason Lee 20d75dbad1 fix(nav): use createLoginRedirectPath for login button, fix footer legal links (#1015)
## Summary

- **AppNav**: Replace `localePath('/login')` with
`createLoginRedirectPath()` + `target="_self"` on the Get Started button
— bypasses VitePress SPA router interception so the browser navigates to
the server-side `/login` route with proper `redirect_to` params
- **AppFooter**: Replace placeholder `href="#"` on Terms / Privacy /
Risk Disclosure links with real Longbridge URLs, using locale-aware
`sgBaseUrl`

## Test plan

- [ ] Click "Get Started" in navbar → should navigate to login page (not
VitePress 404)
- [ ] After login, should redirect back to the originating page
- [ ] Footer legal links open correct Longbridge support pages in new
tab
- [ ] Locale switching (zh-CN / zh-HK) uses correct sgBaseUrl prefix for
footer links

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

Co-authored-by: Claude Sonnet 4.6 <noreply@anthropic.com>
2026-05-20 21:43:58 +08:00
Jason Lee 6369059aa4 Fix dashboard path. 2026-05-20 21:26:06 +08:00
Jason Lee 14779cce28 feat(design): unify nav, redesign homepage/pricing/skill pages (#1011)
## Summary

- Remove 1127 lines of dead CSS from `app-styles.css` — SKILL PAGE and
PRICING PAGE sections were fully overridden by scoped styles in
`Skill.vue` / `Pricing.vue`
- Delete 7 unused `HomePage/` components and `DashboardNavLink.vue` /
`vp-code.css` (no active references)
- Remove View Transition circle animation on light/dark mode toggle
- Center pricing matrix check icons (`display: block; margin: 0 auto`)
- Reduce dark mode card background contrast: `--lb-card` `#13182A` →
`#0E1222` (closer to page bg `#0A0E19`), strengthen card border to
compensate

## Test plan

- [ ] Home page — product cards visible, dark mode cards harmonize with
background
- [ ] Pricing page — matrix check icons centered, billing cycle toggle
works
- [ ] Skill page — styles unchanged (scoped styles still apply
correctly)
- [ ] Light/dark toggle — instant switch, no circle animation
- [ ] No build errors

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

---------

Co-authored-by: Claude Sonnet 4.6 <noreply@anthropic.com>
2026-05-20 21:13:15 +08:00
Hogan 6109102994 docs(fundamental): add business-segments, institution-rating-views, industry-rank, industry-peers, financial-report-snapshot (#999)
## Summary

Adds documentation for 6 new fundamental SDK APIs ported from
[longbridge-terminal PR
#202](https://github.com/longbridge/longbridge-terminal/pull/202).

**18 files created** across `zh-CN`, `zh-HK`, and `en`:

| API | SDK Method | Endpoint |
|-----|-----------|----------|
| Business Segments | `business_segments` | `GET
/v1/quote/fundamentals/business-segments` |
| Business Segments History | `business_segments_history` | `GET
/v1/quote/fundamentals/business-segments/history` |
| Institutional Rating Views | `institution_rating_views` | `GET
/v1/quote/ratings/institutional` |
| Industry Ranking | `industry_rank` | `GET /v1/quote/industry/rank` |
| Industry Peer Hierarchy | `industry_peers` | `GET
/v1/quote/industries/peers` |
| Financial Report Snapshot | `financial_report_snapshot` | `GET
/v1/quote/financials/earnings-snapshot` |

## Related PRs

- SDK (Rust): https://github.com/longbridge/openapi/pull/526
- SDK (Go): https://github.com/longbridge/openapi-go/pull/91

## Test plan

- [ ] Preview renders correctly for all 3 locales
- [ ] `<SDKLinks>` components resolve to correct methods
- [ ] `<CliCommand>` blocks display expected CLI invocations
- [ ] Response JSON examples and schema tables are accurate

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

---------

Co-authored-by: Claude Sonnet 4.6 (1M context) <noreply@anthropic.com>
2026-05-20 16:21:26 +08:00
Jason Lee bb7ecc63d7 cli: Clarify US/HK short selling setup and note HK IRD fee (#1008)
## Summary

- Clarifies that US stocks can be shorted directly with no additional
setup
- Clarifies that HK short selling requires activation via the mobile
app: place first HK short sell order → triggers SBL agreement signing →
wait for approval
- Notes that HK short selling is subject to a fee levied by the Hong
Kong Inland Revenue Department, with details in the in-app agreement
- Documents API error `602301` returned before the HK SBL agreement is
signed
- Updates `docs/{en,zh-CN,zh-HK}/docs/cli/orders/order.md` and
`skills/longbridge/references/cli/overview.md`

Co-authored-by: Claude Sonnet 4.6 <noreply@anthropic.com>
2026-05-19 16:34:51 +08:00
Jason Lee 2b0d6b1543 cli: Document short selling activation flow for order sell (#1007)
## Summary

- Adds short selling documentation to
`docs/{en,zh-CN,zh-HK}/docs/cli/orders/order.md` and
`skills/longbridge/references/cli/overview.md`
- Documents that US and HK markets must each be activated separately via
the mobile app before short selling is available via CLI/API/MCP
- Activation flow: place first short sell order in the mobile app →
triggers SBL agreement signing → wait for review approval
- Notes API error `602301` returned before the SBL agreement is signed
- Notes A-share (SH/SZ) short selling is not supported

---------

Co-authored-by: Claude Sonnet 4.6 <noreply@anthropic.com>
2026-05-19 16:04:56 +08:00
Jason Lee 68443a212b feat(nav): update FeaturesMenu links to point to feature docs instead of CLI (#1006)
## Summary

- Updated all 9 feature links in `FeaturesMenu.vue` (en/zh-CN/zh-HK) to
point to the corresponding feature documentation pages instead of CLI
command pages
- Fixed `option-quote.md` title from generic "Quotes" to "Option Quotes"
(三语言同步)

## Link mapping

| Feature | Old (CLI) | New (Docs) |
|---------|-----------|------------|
| Live Market Quotes | `/docs/cli/market-data/quote` |
`/docs/quote/pull/quote` |
| Price History | `/docs/cli/market-data/kline` |
`/docs/quote/pull/history-candlestick` |
| Financial Statements | `/docs/cli/fundamentals/financial-report` |
`/docs/fundamental/fundamental/financial-report` |
| Analyst Estimates | `/docs/cli/fundamentals/consensus` |
`/docs/fundamental/fundamental/consensus` |
| Company News | `/docs/cli/content/news` | `/docs/content/news/news` |
| SEC Filings | `/docs/cli/content/filing` | `/docs/quote/pull/filings`
|
| Institutional | `/docs/cli/research/investors` |
`/docs/fundamental/fundamental/fund-holdings` |
| Options & Warrants | `/docs/cli/derivatives/option` |
`/docs/quote/pull/option-quote` |
| Order Execution | `/docs/cli/orders/order` |
`/docs/trade/trade-overview` |

## Test plan

- [ ] 点击导航栏 Features 下拉菜单中的每个功能链接,确认跳转到对应文档页面
- [ ] 验证三语言版本链接均正确

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

Co-authored-by: Claude Sonnet 4.6 <noreply@anthropic.com>
2026-05-19 14:43:25 +08:00
Jason Lee 6624dd25c5 docs(quote): clarify SG market real-time quote availability (#1005)
## Summary

Ref #1003

- Replace the SG market code entry with a blockquote note explaining
that Singapore real-time quotes are currently unavailable via Longbridge
Developers (API / CLI / MCP)
- Direct users to the Longbridge client (app or desktop) for SG market
quotes
- Remove SG from the Basic quote permission level description in all
three language versions (en / zh-CN / zh-HK)

## Test plan

- [ ] Verify the note renders correctly as a blockquote in all three
locale pages
- [ ] Confirm the quote permission table looks correct without SG in the
Basic row

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

Co-authored-by: Claude Sonnet 4.6 <noreply@anthropic.com>
2026-05-19 14:21:19 +08:00
Jason Lee 0f90b0efbe docs(qa): update paper account to support US options trading (#1002)
## Summary

- 模拟账户现已支持美股期权交易,更新 QA 文档中的品种说明
- 从「不支持」列表移除期权,加入支持品种列表
- 三语言同步更新(en / zh-CN / zh-HK)

## Files Changed

- `docs/en/docs/qa/general.md` — Q4 trading section
- `docs/en/docs/qa/trade.md` — Q4 trading rules
- `docs/zh-CN/docs/qa/general.md`
- `docs/zh-CN/docs/qa/trade.md`
- `docs/zh-HK/docs/qa/general.md`
- `docs/zh-HK/docs/qa/trade.md`

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

Co-authored-by: Claude Sonnet 4.6 <noreply@anthropic.com>
2026-05-18 14:27:45 +08:00
Jason Lee fb32a9f35b refactor(docs): reorganize quote/trade/market sidebar structure (#1001)
## Summary

- **Quote restructure**: Split flat `pull/` (25 items) into semantic
groups — `stocks/`, `options/`, `warrants/`, `analytics/`
- **Subscribe**: Merged `push/` into `subscribe/` (renamed to
"Subscribe"); added Overview page explaining WebSocket subscription
model and pull API reference links
- **Market**: Extracted `quote/market/` to standalone top-level
`market/` section (position 3.2) to accommodate future additions like
rankings, screeners, IPO
- **Trade ordering**: Fixed `execution/` (History→Today) and `order/`
(Submit→Today→History→Details→Replace→Cancel→Estimate) sidebar ordering
- **Titles**: Optimized all Quote section titles with proper securities
industry terminology; renamed "Withdraw Order" → "Cancel Order"; "Update
Watchlist Group" → "Manage Group Securities"
- **Watchlist**: Renamed group label and sorted items; `update_group`
title now reflects its actual function (add/remove securities in group)
- **Appendix**: Moved `security_list` to socket appendix as "Overnight
Eligible Securities" with accurate description

## Test plan

- [ ] Build and verify sidebar structure renders correctly
- [ ] Verify existing URLs still resolve (absolute slugs preserved for
moved files)
- [ ] Verify new `/market/*` URLs work
- [ ] Check Subscribe Overview links resolve correctly

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

---------

Co-authored-by: Claude Sonnet 4.6 <noreply@anthropic.com>
2026-05-17 19:15:58 +08:00
Hogan c5b50a913d docs(cli): translate v0.21.0 new command docs to zh-CN/zh-HK (#1000)
Translates the new CLI v0.21.0 command documentation (business-segments,
industry-rank, industry-peers, financial-report snapshot,
institution-rating --views) from English to Simplified and Traditional
Chinese.

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

Co-authored-by: Claude Sonnet 4.6 (1M context) <noreply@anthropic.com>
2026-05-16 16:54:51 +08:00
Hogan 3a8e735e5a docs(cli): v0.21.0 new commands — business-segments, industry-rank, industry-peers, financial-report snapshot, institution-rating --views (#998)
## Summary

Adds documentation for the 5 new commands/flags in CLI v0.21.0.

### New docs (en / zh-CN / zh-HK)
- **`business-segments`** — revenue breakdown by segment, current or
historical
- **`industry-rank`** — industry ranking by market and indicator;
counter_id links to `industry-peers`
- **`industry-peers`** — hierarchical sub-sector tree

### Updated docs
- **`financial-report`** — added `snapshot` subcommand section (AI
earnings summary + beat/miss + peer dates)
- **`institution-rating`** — added `--views` flag section
(month-by-month rating distribution)

### Release notes
- Added v0.21.0 entry to `cli/release-notes.md` (en/zh-CN/zh-HK)

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

Co-authored-by: Claude Sonnet 4.6 (1M context) <noreply@anthropic.com>
2026-05-15 19:04:14 +08:00
Hogan 61c5a7e05b docs(changelog): CLI v0.21.0 (#997)
## Summary

Adds changelog entry for CLI v0.21.0 (consolidating v0.20.1~v0.20.3),
with MCP v0.3.0 mentioned inline.

### CLI v0.21.0
- Industry Intelligence: `industry-rank`, `industry-peers`
- Revenue Segment Breakdown: `business-segments`
- AI Earnings Snapshot: `financial-report snapshot`
- Analyst Conviction Trends: `institution-rating --views`
- MCP server updated with the same capabilities (133 tools total)

Written for end users — less technical, more about what you can now do.

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

Co-authored-by: Claude Sonnet 4.6 (1M context) <noreply@anthropic.com>
2026-05-15 18:52:06 +08:00
拉罐 f1bb0e18cb Update DESIGN.md 2026-05-15 09:51:17 +08:00
Jason Lee 9d53a0939e fix(cli): collapse all sidebar groups by default (#995)
## Summary

- CLI docs sidebar 的 `market-data` 和 `quant` 分组之前未设置折叠,导致与其他分组不一致
- 将三个语言版本(en / zh-CN / zh-HK)的这两个分组统一改为 `collapsed: true`,使 CLI sidebar
所有分组默认折叠

## Test plan

- [ ] 访问 CLI 文档页面,确认所有 sidebar 分组默认均为折叠状态

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

Co-authored-by: Claude Sonnet 4.6 <noreply@anthropic.com>
2026-05-14 18:54:35 +08:00
Endless 89d39f2be1 feat: sync new SDK APIs from openapi to docs site (#962)
## Summary

Syncs new SDK interfaces introduced in openapi to the developers
documentation site, along with a range of docs, UI, and infrastructure
improvements.

## New API Documentation (EN / zh-CN / zh-HK)

### Quote APIs
- `option_volume` — option volume query
- `option_volume_daily` — daily option volume query
- `short_positions` — short position data
- `update_pinned` — update pinned securities

### Fundamental APIs
- **Calendar**: dividend, earnings, IPO, macro, split calendars
- **Fundamental**: company profile, corporate actions, dividends,
executives, financial reports, fund holdings, ratings, shareholders,
valuations
- **Market**: AH premium, broker positions, index components, market
status, trading stats, unusual items

### Account APIs
- **Alert**: create, delete, list, update alerts
- **DCA** (dollar-cost averaging): create, delete, list, update, history
- **Portfolio**: capital flow, exchange rates, profit analysis (by
market, detail, summary)
- **Sharelist**: create, delete, list, update share lists

## UI / Site Improvements

- **Pricing page**: new tri-locale pricing comparison page for market
data subscription tiers; fixes for responsive layout and static QR code
on mobile
- **FeaturesMenu**: mega-menu dropdown in main nav with 9 financial data
product categories; full i18n support
- **Nav**: moved API Reference from top nav to Docs sidebar (opens in
new tab)
- **Homepage visual polish**: neutral color vars on ArchCanvas, distinct
card accent hues, section border delineation, ProductSkill gradient,
flat GetStarted background
- **Quote permission**: added permission notices across CLI docs, API
docs, and API Reference; removed unreliable client-side permission
status detection
- **Mock login toggle**: dev-only panel to simulate login/logout state;
shared reactive `useLoginState` composable

## Docs Updates

- CLI v0.19.2 release notes + updated `finance-calendar` subcommand
examples
- Corrected quote permission names to match Quote Store (pluralization,
Nasdaq Basic rename)
- Updated skill guide to use CLI-first flow
- Fixed missing zh-HK translations

## Bug Fixes

- Fixed UnoCSS build error from arbitrary `font-feature-settings` class
- Added `result.root` null guard in `postcss.config.mjs` to prevent
PostCSS crash
- Fixed home page footer rendering
- Fixed pricing page build dist

🤖 Auto-generated by Endless.

---------

Co-authored-by: 老袁 Yuan Zhanghong <zhanghong.yuan@longbridge-inc.com>
Co-authored-by: Claude Sonnet 4.6 (1M context) <noreply@anthropic.com>
Co-authored-by: Jason Lee <huacnlee@gmail.com>
2026-05-14 18:13:11 +08:00
Hogan 655bb92075 fix(pack-skills): add environment selector + fix step id conflict (#993)
## Problem

PR #992 merged a version of `pack-skills.yml` that was **missing the
environment-selection logic**. Both canary and release always upload
regardless of what you select.

## Two root causes

1. **Wrong version merged** — the file in #992 didn't include
`workflow_dispatch` inputs, the `Resolve environment` step, or the `if:`
conditions
2. **Reserved keyword** — the step used `id: env`, but `env` is a
built-in GitHub Actions context. Using it as a step ID causes
`steps.env.outputs.*` to silently fail, making every `if:` evaluate to
`true`

## Fix

- Adds `workflow_dispatch` inputs: `canary` / `release` / `both`
(default: `canary`)
- Adds `Resolve environment` step with `id: setup` (not `env`)
- Adds `if:` conditions: canary step only runs when target is `canary`
or `both`; release step only when `release` or `both`

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

Co-authored-by: Claude Sonnet 4.6 (1M context) <noreply@anthropic.com>
2026-05-14 17:48:26 +08:00
Jason Lee cf3d7be3e7 design: 更新 Logo、优化 footer 间距与视觉细节 (#994)
## Summary

- 替换导航栏 Logo 为新版 Longbridge Developers 图片(亮/暗双套),隐藏站点文字标题,CSS 固定宽度 145px
- 去除首页 OpenAPI SDK bento 卡片灰色背景(`bg-soft` → `bg`),移除 hover 时 border 变色
- 修复首页双 Footer 问题:`LayoutInner` page-bottom 插槽对 `new-home-page` 做条件判断
- 首页 `NewHomePage/Footer` 底部 padding 增至 2.5rem;doc 页 `HomePage/Footer`
减少顶部 margin 并增加底部空白
- `skill-chat-window` border 改用 `--lb-card-border` token;暗色模式值调整为
`rgba(255,255,255,0.1)`
- 去掉 `LayoutInner` Footer 容器多余的 `px-8`

## Test plan

- [ ] 首页:Logo 正常显示(亮/暗),无站点标题文字,宽度 145px
- [ ] 首页:SDK 卡片背景为白色,hover 无 border 变色
- [ ] 首页:页脚只有一个 Footer,底部有足够留白
- [ ] Pricing 页:Footer 底部空白正常
- [ ] Skill 页:chat window border 清晰,暗色模式不过亮
- [ ] 暗色模式全面检查

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

---------

Co-authored-by: Claude Sonnet 4.6 <noreply@anthropic.com>
2026-05-14 14:52:01 +08:00
Hogan 47cd4e6982 ci: pack-skills with environment selector (canary/release/both) (#992)
## Summary

Adds `pack-skills.yml` — triggered by `repository_dispatch` from
`longbridge/skills` or manually via `workflow_dispatch`.

## Changes from previous version

Added `environment` input parameter:

| Value | Behaviour |
|---|---|
| `canary` (default) | Upload to canary OSS only — safe for testing, no
production impact |
| `release` | Upload to release OSS only |
| `both` | Upload to both (full release) |

## How to test safely

1. Run `workflow_dispatch` in `longbridge/developers` → select
**`canary`**
2. Verify zip files appear at `oss://lb-assets/github/canary/.../skill/`
3. Once confirmed, run with **`both`** to push to production

## Secrets used

Reuses existing secrets — no new secrets needed:
- `FE_LB_ASSET_ACCESS_KEY_ID`
- `FE_LB_ASSET_ACCESS_KEY_SECRET`

## Counterpart

PR #23 in `longbridge/skills` — sends the dispatch event (also updated
to manual-only + passes `environment`).

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

Co-authored-by: Claude Sonnet 4.6 (1M context) <noreply@anthropic.com>
2026-05-14 12:02:34 +08:00
Jason Lee fc95f91c4d docs(skill): add Claude Code permission tip for Bash(longbridge *) in install guide (#990)
## Summary

- 在 Skill 安装指引(Method A CLI 章节)新增 Claude Code 专属提示
- 说明如何在 `.claude/settings.json` 中配置 `Bash(longbridge *)` 权限,避免 Claude
每次调用 `longbridge` 命令时弹出权限确认
- 三语言版本(en / zh-CN / zh-HK)同步更新

## Test plan

- [ ] 确认三语言页面渲染正常,JSON 代码块格式正确
- [ ] 确认提示位置在 `longbridge auth login` 步骤之后、CLI 文档链接之前

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

---------

Co-authored-by: Claude Sonnet 4.6 <noreply@anthropic.com>
2026-05-13 20:57:39 +08:00
Jason Lee fbce460442 docs(cli): CLI v0.20.3 release notes + v0.20.0 changelog backfill (#988)
## Summary

- Add CLI v0.20.3 release notes (3 languages): `analyst-estimates`
removal, HK symbol leading-zero fix, `ipo detail` auto-market detection
- Backfill CLI v0.20.0 changelog entry (3 languages): `ipo` command
group, `financial-statement`, `valuation-rank`, `institution-rating` new
flags, search commands, account commands

## Changes

- `docs/{en,zh-CN,zh-HK}/docs/cli/release-notes.md` — v0.20.3 entry
added at top
- `docs/{en,zh-CN,zh-HK}/docs/changelog.md` — v0.20.0 entry added
(changelog only tracks major versions)

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

Co-authored-by: Claude Sonnet 4.6 <noreply@anthropic.com>
2026-05-12 19:53:25 +08:00
Jason Lee 2d318616d5 docs(skill): add JSON config example for MCP server setup (#984)
## Summary

- Add JSON `mcpServers` config block to Method B (MCP) section of the
Skill install guide
- Clarifies that the JSON format works for Claude Desktop, Cursor, Zed,
Gemini CLI, and other JSON-config-based clients
- Updated all three language versions (en, zh-CN, zh-HK)

## Test plan

- [ ] Verify the JSON block renders correctly in the docs
- [ ] Check all three language versions display properly

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

Co-authored-by: Claude Sonnet 4.6 <noreply@anthropic.com>
2026-05-12 14:47:57 +08:00
Sunli 7a171bb280 docs(getting-started): add refresh_access_token section for legacy API key
Add a "Refresh Access Token" subsection covering Python, JavaScript,
Rust, Java, and C++ examples. Each example shows refreshing with a
3-year expiry and using the returned token to create a new Config.
2026-05-11 19:57:34 +08:00
Jason Lee dfe3fe41f3 docs(cli): remove analyst-estimates docs and restrict operating to HK stocks (#982)
## Summary

- 删除 `analyst-estimates` 的三语言文档(en/zh-CN/zh-HK),并从 v0.20.0 Release Notes
中移除对应条目
- 在 `operating` 文档中添加 `:::info`
提示说明仅支持港股,并将示例中的美股(AAPL.US、TSLA.US)替换为港股(700.HK、9988.HK)

## Test plan

- [ ] 确认 analyst-estimates 页面已从文档站移除
- [ ] 确认 operating 页面正确显示港股限制提示

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

Co-authored-by: Claude Sonnet 4.6 <noreply@anthropic.com>
2026-05-11 19:09:39 +08:00
Jason Lee 011660953b docs: CLI v0.20.2 release notes + Pricing US quote session clarification (#981)
## Summary

- Add CLI v0.20.2 release notes (EN / zh-CN / zh-HK): two bug fixes —
`institution-rating --history` output formatting and IPO date display
(1970 → correct date)
- Pricing comparison table: split the misleading "盘前盘后(夜盘)行情" row into
two distinct rows — "盘前、盘中、盘后行情" (✓ Nasdaq Basic free) and "夜盘行情" (✓ US
LV1 paid only)
- Free tier card note updated to mention Nasdaq Basic covers pre-market,
regular & after-hours sessions
- `quote-permissions.yaml`: add session coverage detail to `depth` and
`kline` command descriptions, consistent with `quote` / `trades` /
`intraday`

## Test plan

- [ ] Verify Pricing page comparison table shows correct checkmarks for
the two new rows
- [ ] Verify release notes appear correctly in all three locales

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

Co-authored-by: Claude Sonnet 4.6 <noreply@anthropic.com>
2026-05-11 16:26:21 +08:00
Jason Lee 3b8c6b3442 docs(skill): add AI step-order instruction and update en screenshots (#980)
## Summary

- Add hidden HTML comment at the top of all three locale files (`en` /
`zh-CN` / `zh-HK`) instructing the AI to follow a strict install order —
regardless of user prompts to skip steps:
  1. Install CLI or configure MCP
  2. Complete authentication (`longbridge auth login`)
  3. Verify with "Get the latest price for TSLA" and confirm live data
  4. Only then install the Skill (Step 2)
- Update English screenshots to latest versions for Claude Desktop and
Codex
- Clarify that both **Chat** and **Cowork** modes in Claude Desktop are
restricted (not just Chat)

## Test plan

- [ ] Verify HTML comments are not visible on the rendered page
- [ ] Confirm new screenshots render correctly in the en locale

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

Co-authored-by: Claude Sonnet 4.6 <noreply@anthropic.com>
2026-05-11 15:23:46 +08:00
Jason Lee f40ca233fa docs(skill): restructure install guide — CLI/MCP first, add tool restrictions (#978)
## Summary

- Reorder steps: connect to Longbridge platform (CLI or MCP) first,
install Skill second — the old order had Skill as Step 1, which is
useless without data access
- Lead intro with terminal-based AI tools (Claude Code, Codex, opencode,
OpenClaw) as the recommended/quickest path
- Clarify CLI vs MCP framing: CLI = best experience but needs local
install; MCP = easier, just a URL
- Add **Known restrictions by tool** section with clear guidance and
screenshots:
- **Claude Desktop Chat mode**: network whitelist blocks CLI/MCP —
switch to Code tab instead (screenshot added)
- **Codex Cloud mode**: same network restrictions — must select "Work
locally" (screenshot added)
  - **Claude.ai / ChatGPT.com web**: redirect to Claude Desktop Code tab
- Add mainland China accelerated MCP endpoint
(`https://openapi.longbridge.cn/mcp`) to English version
- Rename section heading "Connect your Longbridge account" → "Connect to
the Longbridge platform"
- All changes synced across en / zh-CN / zh-HK

## Test plan

- [ ] Preview skill install page in all three locales
- [ ] Verify screenshots render correctly
- [ ] Check all links resolve (CLI reference, Claude Desktop download)

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

---------

Co-authored-by: Claude Sonnet 4.6 <noreply@anthropic.com>
2026-05-11 14:55:10 +08:00
Jason Lee fd22a9876e fix(docs): correct CliCommand examples to use valid CLI subcommands (#974)
## Summary

- Trade commands (`buy`, `sell`, `cancel`, `replace`, `executions`,
`orders`) were missing the `order` parent command prefix — all now use
`longbridge order <subcommand>`
- `longbridge order <id>` → `longbridge order detail <id>`
- `longbridge topics SYMBOL` → `longbridge topic SYMBOL` (no trailing
`s`)
- `longbridge capital dist/flow SYMBOL` → `longbridge capital SYMBOL` /
`longbridge capital SYMBOL --flow` (`dist`/`flow` are not valid
subcommands)
- `longbridge topic create SYMBOL "body"` → `longbridge topic create
--body "..." --tickers SYMBOL` (positional args not supported)
- `longbridge watchlist update <id> --add A B` → `--add A --add B`
(`--add` is not multi-value, must be repeated)

## Test plan

- [ ] Verified each corrected command format against `longbridge <cmd>
--help`
- [ ] All 13 files updated; only `docs/en/` affected (zh-CN / zh-HK
counterparts do not exist)

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

---------

Co-authored-by: Claude Sonnet 4.6 <noreply@anthropic.com>
2026-05-11 11:49:08 +08:00
Hogan 30ef9bfde6 fix(skill): correct install URL and package name (#972)
## Summary

Fixes #970

- **Wrong domain**: `developers.longbridge.com` → `open.longbridge.com`
- **Wrong package name**: `longbridge/developers` → `longbridge/skills`
- **Outdated flags**: removed `-y`, use `-g` only

5 files changed:
- `NewHomePage/ProductSkill.vue` — homepage AI prompt URL + CLI tab
commands
- `Skill.vue` — skill catalog npx/OpenClaw commands
- `docs/{en,zh-CN,zh-HK}/skill/install/index.md` — install guide code
blocks

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

Co-authored-by: Claude Sonnet 4.6 (1M context) <noreply@anthropic.com>
2026-05-09 12:43:13 +08:00
拉罐 b6cda22e13 fix(skill): ui polish — border removal, amber theme, modal scroll, in… (#968)
…stall cmd fix

Co-authored-by: Claude Sonnet 4.6 <noreply@anthropic.com>
2026-05-08 22:10:01 +08:00
Hogan 0d241141d8 docs(skill): update install guide with correct repo and Claude Code plugin (#967)
## Summary

- Fix npx/bunx install address: `longbridge/developers` →
`longbridge/skills`(remove `-y` flag too)
- Add Claude Code plugin install as the first/recommended option for
Claude Code users:
  ```
  /plugin marketplace add longbridge/skills
  /plugin install longbridge@longbridge-skills
  ```
- Change "Two ways" → "Three ways" 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 (1M context) <noreply@anthropic.com>
2026-05-08 22:00:10 +08:00
Jason Lee e339c90caf docs(cli): v0.20.0 new commands documentation (#965)
## Summary

- New `ipo` command group docs (subscriptions, wait-listing, listed,
calendar, detail, orders, profit-loss; HK + US variants)
- New `financial-statement` command doc (detailed hierarchical IS/BS/CF
with YoY)
- New `valuation-rank` command doc (daily PE/PB/PS industry percentile
rank)
- New `analyst-estimates` command doc (EPS consensus estimates)
- New `bank-cards`, `withdrawals`, `deposits` account command docs
- Updated `institution-rating` with `--history` and `--industry-rank`
examples
- Updated `news` and `topic` with `search` subcommand examples
- Updated `portfolio` with `short-margin` subcommand
- Added v0.20.0 Release Notes (en/zh-CN/zh-HK)

All documentation is trilingual (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-05-08 21:05:29 +08:00
拉罐 5def33f0dd feat(skill): add skill catalog page with search, modal, and plugin bar (#964)
Co-authored-by: Claude Sonnet 4.6 <noreply@anthropic.com>
2026-05-08 20:05:53 +08:00
Hogan 11e9d004a3 ci(skill): pack longbridge.zip from longbridge/skills@main (#934)
## Summary

- Build now clones `longbridge/skills@main` and packs its `skills/`
contents into `longbridge.zip`, instead of zipping the local
`skills/longbridge/` folder.
- Fails the build if the clone fails or the upstream `skills/` directory
is missing — the published zip can no longer go silently stale.
- Each upstream skill (`longbridge-capital-flow`, `longbridge-depth`, …)
becomes a top-level entry in the zip, so unzip directly into
`.claude/skills/` keeps working.

## Test plan

- [ ] CI build passes and uploads `longbridge.zip`
- [ ] `unzip -l longbridge.zip` shows the upstream `longbridge-*` skill
folders at the top level
- [ ] Manually break the clone (e.g. wrong URL) locally and confirm the
build aborts with the new error message

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

Co-authored-by: Claude Sonnet 4.6 (1M context) <noreply@anthropic.com>
2026-05-08 20:04:34 +08:00
Endless a2a11361f0 fix: correct API reference example URLs in openapi.yaml (#963)
## Summary

Fixes incorrect API endpoint URLs in the API Reference documentation
examples.

## Problem

Many API Reference examples were using incorrect URLs with the wrong
domain, e.g.:

```
curl --request GET \
  --url 'https://openapi.longbridge.com/watchlist/
```

## Changes

- Updated 21 incorrect API endpoint URLs in `openapi.yaml` to use the
correct domain/base URL
- Ensures all curl examples in the API Reference reflect the accurate
endpoint addresses

## Files Changed

- `openapi.yaml`: 21 URL corrections (42 lines changed)

🤖 Auto-generated by Endless.

Co-authored-by: 老袁 Yuan Zhanghong <zhanghong.yuan@longbridge-inc.com>
2026-05-08 17:37:56 +08:00
Jason Lee 3b24eb640b style(home): homepage visual polish pass (#960)
## Summary

- **ArchCanvas**: replace all `--brand-color` usages with neutral vars
(`--vp-c-text-1/3`, `--vp-c-divider`, `--vp-c-bg-elv`) on arrows,
labels, API Gateway box, hover states
- **ProductCLI**: active feature item border/icon uses `--vp-c-text-2`
(dark, not brand); section gets `border-top` + `border-bottom`
- **Gray section borders**: ProductMCP, GetStarted, MarketCoverage all
get `border-top` + `border-bottom` to delineate from adjacent white
sections
- **CapSection**: switched from `bg-soft` to `bg` (white) to break
consecutive gray run with MCP section above it
- **CoreFeaturesSection**: 6 card accents now cover distinct hues across
the color wheel — teal, orange, blue, green, amber, purple (was
duplicating teal and blue-purple)
- **ProductSkill**: top-center radial gradient (`#00dbb6` 7%/12%
light/dark); code stream blocks get lighter background with solid border
- **ProductOpenAPI**: side-cell brand gradient raised from 8% → 13% for
better visibility
- **GetStarted**: removed messy 135deg multi-color gradient, replaced
with flat `bg-soft`

## Test plan

- [ ] Light mode: verify section alternation (white/gray/white) is
visually clear throughout the page
- [ ] Dark mode: verify Skill section teal gradient is visible; section
borders are subtle but present
- [ ] Developer Tools cards: confirm all 6 cards read as distinct colors
- [ ] Platform Architecture diagram: arrows and labels should appear
neutral/monochrome

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

---------

Co-authored-by: Claude Sonnet 4.6 <noreply@anthropic.com>
2026-05-08 14:11:35 +08:00
Jason Lee b57d909a6f Fix pricing page build dist. (#959) 2026-05-08 10:51:18 +08:00
Endless f2483f071e fix(pricing): responsive layout & static QR code for mobile (#957)
## Summary

Fixes the Pricing page mobile layout issues and replaces the dynamic
QRCode (which failed to render on mobile) with a hardcoded static SVG QR
code.

## Changes

- **Pricing.vue**: Fix responsive layout breakpoints and grid/flex rules
so the pricing comparison table renders correctly on small screens
- **Pricing.vue**: Replace dynamic QRCode component with a pre-generated
static SVG to ensure reliable display on all devices

## Motivation

The Pricing page had broken layout on mobile viewports, and the dynamic
QR code component was not rendering on mobile devices. Using a static
SVG eliminates the rendering dependency and ensures consistent display
across all platforms.

## Related

Builds on top of the Pricing page introduced in #951 and the
UnoCSS/PostCSS fixes from #955.

🤖 Auto-generated by Endless.

---------

Co-authored-by: Huacnlee Li Huashun <huacnlee@longbridge-inc.com>
Co-authored-by: Jason Lee <huacnlee@gmail.com>
Co-authored-by: Claude Sonnet 4.6 <noreply@anthropic.com>
2026-05-08 10:16:21 +08:00
Jason Lee 04d2e2aa74 feat(nav): move API Reference from nav to Docs sidebar (#956)
## Summary

- Remove API Reference from top navigation bar (all 3 locales)
- Add API Reference entry to Docs sidebar, positioned after LLMs item
- Opens in new tab (`target: '_blank'`)
- External-link icon appended to label to signal new-tab behavior
- Add `external-link` SVG to `SIDEBAR_ICONS_MAP` in `gen.ts`

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

Co-authored-by: Claude Sonnet 4.6 <noreply@anthropic.com>
2026-05-07 22:02:41 +08:00
Jason Lee e772d79d17 fix(pricing): fix UnoCSS build errors and update page titles (#955)
## Summary

- Fix UnoCSS build error: `[font-feature-settings:'tnum']` arbitrary
class causes "Unknown word tnum&" — moved to static `style` attribute
- Fix PostCSS crash: add `result.root` null guard in
`postcss.config.mjs`
- Simplify pricing page frontmatter titles to "Pricing / 定价 / 定價"

## Test plan

- [ ] Verify `bun run build:release` completes without errors
- [ ] Verify pricing page renders correctly in all three locales

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

Co-authored-by: Claude Sonnet 4.6 <noreply@anthropic.com>
2026-05-07 21:46:36 +08:00
Endless 58d538852c feat: Add pricing page comparing market data subscription tiers (#951)
## Summary

Implements a dedicated pricing page similar to
[financialdatasets.ai/pricing](https://www.financialdatasets.ai/pricing)
that visually compares different market data subscription levels and
their capabilities.

## Changes

- **`Pricing.vue`**: New Vue component that displays market data
subscription tiers in a pricing comparison table format, highlighting
feature availability and pricing across different permission levels
- **`index.ts`**: Registers the new `Pricing` component for use in
VitePress pages
- **`docs/en/docs/pricing.md`**: English pricing page
- **`docs/zh-CN/docs/pricing.md`**: Simplified Chinese pricing page
- **`docs/zh-HK/docs/pricing.md`**: Traditional Chinese pricing page

## Motivation

Users need a clear way to understand what market data features are
available at each subscription tier and how the tiers differ in price
and capability. A pricing comparison page makes it easy to evaluate
which subscription level fits their needs.

🤖 Auto-generated by Endless.

---------

Co-authored-by: Huacnlee Li Huashun <huacnlee@longbridge-inc.com>
Co-authored-by: Jason Lee <huacnlee@gmail.com>
Co-authored-by: Claude Sonnet 4.6 <noreply@anthropic.com>
2026-05-07 21:30:02 +08:00