docs: Update CLI auth to device flow and add v0.14.0 release notes (#404)

huacnlee · claude · web-flow · commit 2844f334128e · 2026-04-02T17:30:06.000+08:00
## 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>
diff --git a/CLAUDE.md b/CLAUDE.md
@@ -143,3 +143,13 @@ longbridge quote AAPL.US NVDA.US
 - 最新版本在最上方
 - 章节末尾保留完整 Releases 列表链接：`https://github.com/longbridge/longbridge-terminal/releases`
 - 三个语言版本同步更新
+
+## Changelog 页面
+
+`docs/{lang}/docs/changelog.md` 以 **整个 Longbridge Developers 平台**的角度记录变更，不限于 CLI：
+
+- 以日期为单位（`## YYYY-MM-DD`），最新在最上方
+- CLI 版本用子标题 `### CLI vX.Y.Z` 标注，平台/API 变更直接写在日期下
+- 每条只写重点（1–3 条），从平台视角描述功能价值，不堆砌命令细节
+- 发布 CLI 新版本时，同步在 changelog 添加对应条目
+- 三个语言版本同步更新
diff --git a/docs/en/docs/changelog.md b/docs/en/docs/changelog.md
@@ -5,6 +5,14 @@ slug: changelog
 sidebar_position: 7
 ---
 
+## 2026-04-02
+
+### CLI v0.14.0
+
+- **Device auth** — the Longbridge Developers platform now supports OAuth Device Authorization Flow; `longbridge login` displays a verification URL and code to authorize from any device, including SSH and headless environments
+- **Order enhancements** — trailing stop and AO order types; `--expire-date`, `--outside-rth`, `--remark` added to order commands
+- **Fix** — prebuilt Linux binary now uses musl to fix segfault on some distributions
+
 ## 2026-04-01
 
 ### CLI v0.13.0
diff --git a/docs/en/docs/cli.md b/docs/en/docs/cli.md
@@ -80,15 +80,15 @@ After installation, authenticate and explore available commands:
 
 ```bash
 longbridge --help   # List all available commands
-longbridge login    # Opens browser for OAuth, saves token to ~/.longbridge/terminal/.openapi-session
+longbridge login    # Authenticate via device flow — displays a URL and code to authorize on any device
 ```
 
 ## Authentication
 
-Uses OAuth 2.0 — no manual token management required:
+Uses OAuth 2.0 device authorization flow — works in any environment (local, SSH, headless):
 
 ```bash
-longbridge login    # Opens browser for OAuth, saves token to ~/.longbridge/terminal/.openapi-session
+longbridge login    # Displays a verification URL and code; authorize on any device or browser
 longbridge logout   # Clear saved token
 ```
 
@@ -351,6 +351,12 @@ Longbridge OpenAPI: maximum 10 calls per second. The SDK auto-refreshes OAuth to
 
 ## Release notes
 
+### [v0.14.0](https://github.com/longbridge/longbridge-terminal/releases/tag/v0.14.0)
+
+- **New: Device auth login** — `longbridge login` now uses OAuth device flow; displays a URL and code to authorize on any device, works in SSH and headless environments; `--headless` flag removed
+- **New: Order enhancements** — trailing stop and AO order types; `--expire-date`, `--outside-rth`, `--remark` added to order commands
+- **Fix: Linux segfault** — prebuilt Linux binary now uses musl to fix crash on some distributions
+
 ### [v0.13.0](https://github.com/longbridge/longbridge-terminal/releases/tag/v0.13.0)
 
 - **New: Fundamentals & analysis commands** — `financial-report`, `valuation`, `forecast-eps`, `consensus`, `institution-rating`, `shareholder`, `fund-holder`, `dividend`, `finance-calendar`, `exchange-rate`
diff --git a/docs/zh-CN/docs/changelog.md b/docs/zh-CN/docs/changelog.md
@@ -5,6 +5,14 @@ slug: changelog
 sidebar_position: 7
 ---
 
+## 2026-04-02
+
+### CLI v0.14.0
+
+- **Device Auth** — Longbridge Developers 平台现已支持 OAuth Device Auth 授权流程；`longbridge login` 显示验证 URL 和 Code，可在任意设备完成授权，支持 SSH 和无头环境
+- **订单增强** — 支持追踪止损和 AO 订单类型；订单命令新增 `--expire-date`、`--outside-rth`、`--remark` 参数
+- **修复** — Linux 预构建二进制改为 musl，修复在部分发行版的 Segfault
+
 ## 2026-04-01
 
 ### CLI v0.13.0
diff --git a/docs/zh-CN/docs/cli.md b/docs/zh-CN/docs/cli.md
@@ -80,15 +80,15 @@ iwr https://github.com/longbridge/longbridge-terminal/raw/main/install.ps1 | iex
 
 ```bash
 longbridge --help   # 查看所有可用命令
-longbridge login    # 打开浏览器完成 OAuth 授权，Token 存储至 ~/.longbridge/terminal/.openapi-session
+longbridge login    # 通过 Device Flow 认证 — 显示验证 URL 和 Code，在任意设备上完成授权
 ```
 
 ## 认证
 
-使用 OAuth 2.0 认证，无需手动管理 Token：
+使用 OAuth 2.0 Device Auth Flow，支持本地、SSH、无头环境：
 
 ```bash
-longbridge login    # 打开浏览器完成 OAuth 授权，Token 保存至 ~/.longbridge/terminal/.openapi-session
+longbridge login    # 显示验证 URL 和 Code，在任意设备或浏览器上完成授权
 longbridge logout   # 清除已保存的 Token
 ```
 
@@ -349,6 +349,12 @@ Longbridge OpenAPI 最高支持每秒 10 次调用，SDK 自动刷新 OAuth Toke
 
 ## Release Notes
 
+### [v0.14.0](https://github.com/longbridge/longbridge-terminal/releases/tag/v0.14.0)
+
+- **新增：Device Auth 登录** — `longbridge login` 改为 OAuth Device Flow，显示验证 URL 和 Code，在任意设备完成授权，支持 SSH 和无头环境；`--headless` 标志已移除
+- **新增：订单增强** — 支持追踪止损和 AO 订单类型；订单命令新增 `--expire-date`、`--outside-rth`、`--remark` 参数
+- **修复：Linux Segfault** — Linux 预构建二进制改为 musl，修复在部分发行版崩溃的问题
+
 ### [v0.13.0](https://github.com/longbridge/longbridge-terminal/releases/tag/v0.13.0)
 
 - **新增：基本面与分析命令** — `financial-report`、`valuation`、`forecast-eps`、`consensus`、`institution-rating`、`shareholder`、`fund-holder`、`dividend`、`finance-calendar`、`exchange-rate`
diff --git a/docs/zh-HK/docs/changelog.md b/docs/zh-HK/docs/changelog.md
@@ -5,6 +5,14 @@ slug: changelog
 sidebar_position: 7
 ---
 
+## 2026-04-02
+
+### CLI v0.14.0
+
+- **Device Auth** — Longbridge Developers 平台現已支援 OAuth Device Auth 授權流程；`longbridge login` 顯示驗證 URL 和 Code，可在任意裝置完成授權，支援 SSH 和無頭環境
+- **訂單增強** — 支援追蹤止損和 AO 訂單類型；訂單指令新增 `--expire-date`、`--outside-rth`、`--remark` 參數
+- **修復** — Linux 預建二進位改為 musl，修復在部分發行版的 Segfault
+
 ## 2026-04-01
 
 ### CLI v0.13.0
diff --git a/docs/zh-HK/docs/cli.md b/docs/zh-HK/docs/cli.md
@@ -80,15 +80,15 @@ iwr https://github.com/longbridge/longbridge-terminal/raw/main/install.ps1 | iex
 
 ```bash
 longbridge --help   # 查看所有可用指令
-longbridge login    # 開啟瀏覽器完成 OAuth 授權，Token 儲存至 ~/.longbridge/terminal/.openapi-session
+longbridge login    # 透過 Device Flow 認證 — 顯示驗證 URL 和 Code，在任意裝置上完成授權
 ```
 
 ## 認證
 
-使用 OAuth 2.0 認證，無需手動管理 Token：
+使用 OAuth 2.0 Device Auth Flow，支援本地、SSH、無頭環境：
 
 ```bash
-longbridge login    # 開啟瀏覽器完成 OAuth 授權，Token 儲存至 ~/.longbridge/terminal/.openapi-session
+longbridge login    # 顯示驗證 URL 和 Code，在任意裝置或瀏覽器上完成授權
 longbridge logout   # 清除已儲存的 Token
 ```
 
@@ -349,6 +349,12 @@ Longbridge OpenAPI 最高支援每秒 10 次調用，SDK 自動刷新 OAuth Toke
 
 ## Release Notes
 
+### [v0.14.0](https://github.com/longbridge/longbridge-terminal/releases/tag/v0.14.0)
+
+- **新增：Device Auth 登入** — `longbridge login` 改為 OAuth Device Flow，顯示驗證 URL 和 Code，在任意裝置完成授權，支援 SSH 和無頭環境；`--headless` 標誌已移除
+- **新增：訂單增強** — 支援追蹤止損和 AO 訂單類型；訂單指令新增 `--expire-date`、`--outside-rth`、`--remark` 參數
+- **修復：Linux Segfault** — Linux 預建二進位改為 musl，修復在部分發行版崩潰的問題
+
 ### [v0.13.0](https://github.com/longbridge/longbridge-terminal/releases/tag/v0.13.0)
 
 - **新增：基本面與分析命令** — `financial-report`、`valuation`、`forecast-eps`、`consensus`、`institution-rating`、`shareholder`、`fund-holder`、`dividend`、`finance-calendar`、`exchange-rate`
