Function parseKbLink

web/lib/markdown-render.ts:160–198

(href: string)

 *  RelationType，由 WikiLink 组件渲染徽章。
 */
export function parseKbLink(href: string): {
  target: string;
  anchor: string | null;
  relation: RelationType | null;
} | null {
  if (!isKbLink(href)) return null;
  const stripped = href.slice(KB_LINK_PREFIX.length);
  // 解析顺序：hash 永远在 query 之后（preprocessWikiLinks 也是这么写入的），
  // 所以先按 # 切，再在前半段按 ? 切
  const hashIdx = stripped.indexOf("#");
  const beforeHash = hashIdx === -1 ? stripped : stripped.slice(0, hashIdx);
  let anchor: string | null = null;
  if (hashIdx !== -1) {
    const rawAnchor = stripped.slice(hashIdx + 1);
    try {
      anchor = decodeURIComponent(rawAnchor);
    } catch {
      anchor = rawAnchor;
    }
  }
  const queryIdx = beforeHash.indexOf("?");
  const rawTarget = queryIdx === -1 ? beforeHash : beforeHash.slice(0, queryIdx);
  let target: string;
  try {
    target = decodeURIComponent(rawTarget);
  } catch {
    target = rawTarget;
  }
  let relation: RelationType | null = null;
  if (queryIdx !== -1) {
    const queryStr = beforeHash.slice(queryIdx + 1);
    const params = new URLSearchParams(queryStr);
    const rel = params.get("rel");
    // 只认白名单内的关系类型，与 splitAliasOrRelation 口径一致——
    // 防止伪造 / 拼错的 ?rel= 值被当成合法 RelationType 透传给徽章渲染。
    if (rel && RELATION_TYPES.has(rel)) relation = rel as RelationType;
  }
  return { target, anchor, relation };
}

/**
 * 识别 convert.py 自动加在 heading / paragraph / table / code / figure 末尾的锚点：