Skip to content
Merged
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
42 changes: 38 additions & 4 deletions functions/[[path]].ts
Original file line number Diff line number Diff line change
Expand Up @@ -181,22 +181,56 @@ const GONE_PAGES: Record<string, string> = {
'/docs/api/us_etf_dividend_info': '/docs/api/dividends',
'/docs/api/us_company_dividends': '/docs/api/dividends',
'/docs/api/us_etf_files': '/docs/api/company_profile',
// 文档重组后的旧地址:#383 把接入说明、刷新 Token、错误码并进 API Reference
// (openapi.yaml 的 x-pages);#1001 把市场类接口拆到 market 类目下。
// API Reference 靠 ?page= 切换视图,不带 query 落在 Overview:接入说明、刷新 Token
// 并进了 authentication,错误码是 error-codes(站内链接都用这个地址)。
// 目标里的 query 怎么处理见 resolveGone()。
'/docs/how-to-access-api': '/docs/api?page=authentication',
'/docs/refresh-token-api': '/docs/api?page=authentication',
'/docs/error-codes': '/docs/api?page=error-codes',
'/docs/quote/pull/trade-session': '/docs/market/trade-session',
'/docs/quote/pull/trade-day': '/docs/market/trade-days',
'/docs/quote/pull/market_temperature': '/docs/market/market-temperature',
'/docs/quote/pull/history_market_temperature': '/docs/market/history-market-temperature',
'/docs/fundamental/market/market-status': '/docs/market/market-status',
'/docs/fundamental/market/unusual-items': '/docs/market/unusual-items',
'/docs/fundamental/calendar/dividend-calendar': '/docs/market/calendar/dividend-calendar',
'/docs/fundamental/calendar/earnings-calendar': '/docs/market/calendar/earnings-calendar',
'/docs/fundamental/calendar/ipo-calendar': '/docs/market/calendar/ipo-calendar',
'/docs/fundamental/calendar/macro-calendar': '/docs/market/calendar/macro-calendar',
'/docs/fundamental/calendar/meeting-calendar': '/docs/market/calendar/meeting-calendar',
'/docs/fundamental/calendar/merge-calendar': '/docs/market/calendar/merge-calendar',
'/docs/fundamental/calendar/split-calendar': '/docs/market/calendar/split-calendar',
// 资讯分类目录没有落地页,sitemap 里只有它下面的 news 页
'/docs/content/news': '/docs/content/news/news',
}

/**
* 旧地址 → 目标地址,保留来源的 locale 前缀与 `.md` 后缀;不是已下线页面返回 null。
*
* en 前缀直接丢掉:en 是 root locale,规则⑥本来就会把 /en 收敛到根,带着它跳会
* 变成 301 → 302 两跳。
*
* 目标可以自带 query(如 `/docs/api?page=error-codes`):
* - 页面请求:目标 query 在前、来源 query 接在后面,
* `/docs/error-codes?x=1` → `/docs/api?page=error-codes&x=1`;
* - `.md` 请求:`.md` 加在路径上,目标 query 丢掉。`?page=` 只是前端切换视图用的,
* markdown 孪生(如 `/docs/api.md`)本身就是整份原文、已含该视图的内容,
* 所以 `/docs/error-codes.md` → `/docs/api.md`,不会变成 `?page=error-codes.md`。
* 来源 query 两种情况都原样保留。
*/
function resolveGone(path: string): string | null {
function resolveGone(path: string, search: string): string | null {
const m = /^\/(en|zh-CN|zh-HK)(\/.*)$/.exec(path)
const bare = m ? m[2] : path
const isMd = bare.endsWith('.md')
const target = GONE_PAGES[isMd ? bare.slice(0, -'.md'.length) : bare]
if (!target) return null
const prefix = m && m[1] !== 'en' ? `/${m[1]}` : ''
return `${prefix}${target}${isMd ? '.md' : ''}`
const [targetPath, targetQuery = ''] = target.split('?')
if (isMd) return `${prefix}${targetPath}.md${search}`
const query = [targetQuery, search.slice(1)].filter(Boolean).join('&')
return `${prefix}${targetPath}${query ? `?${query}` : ''}`
}

/**
Expand Down Expand Up @@ -268,8 +302,8 @@ export const onRequest = async ({ request, next }: Ctx): Promise<Response> => {

// ⑤ 已下线页面 → 301 到现存的同类页面。排在 /en 收敛之前,让 /en/docs/... 一步
// 到位;排在末尾斜杠之后,让 .../us_asset_overview/ 先规范化再查表。
const gone = resolveGone(path)
if (gone) return Response.redirect(new URL(gone + url.search, url).toString(), 301)
const gone = resolveGone(path, url.search)
if (gone) return Response.redirect(new URL(gone, url).toString(), 301)

// ⑥ /en 前缀收敛(_release.conf:31)。站点域名上只放行 `_llms.conf` 已接管的
// /en/docs/**.md,与 nginx 一致:/en/skill-install.md 等先 302 掉前缀。
Expand Down