// 站点配置数据(域名已更新)
let sites = [];
const tutorialState = {
currentLanguage: 'zh',
currentCategory: localStorage.getItem('tutorial-category') || 'getting-started',
searchOpen: false
};
const tutorialTranslations = {
zh: null,
en: window.TUTORIAL_I18N_EN || null
};
const navTitleEl = document.getElementById('navTitle');
const pageTitleEl = document.getElementById('pageTitle');
const projectLinkLabelTextEl = document.getElementById('projectLinkLabelText');
const projectLinkDescriptionEl = document.getElementById('projectLinkDescription');
const projectLinkButtonTextEl = document.getElementById('projectLinkButtonText');
const hamburgerBtn = document.getElementById('hamburgerBtn');
const languageDropdownEl = document.getElementById('languageDropdown');
const languageTriggerEl = document.getElementById('languageTrigger');
const languageMenuEl = document.getElementById('languageMenu');
const languageCurrentTextEl = document.getElementById('languageCurrentText');
const languageButtons = document.querySelectorAll('[data-lang-option]');
const languageNames = {
zh: '简体中文',
en: 'English'
};
function normalizeLanguage(language) {
return String(language || '').toLowerCase().startsWith('en') ? 'en' : 'zh';
}
function moveAuthorNoteSection() {
const authorNote = document.getElementById('author-note');
const faq = document.getElementById('faq');
if (!authorNote || !faq || faq.nextElementSibling === authorNote) {
return;
}
faq.insertAdjacentElement('afterend', authorNote);
}
function captureChineseBundle() {
if (tutorialTranslations.zh) {
return;
}
const sectionContent = {};
document.querySelectorAll('section').forEach(section => {
sectionContent[section.id] = section.innerHTML;
});
const navContent = {};
document.querySelectorAll('.nav-link').forEach(link => {
navContent[link.getAttribute('href').slice(1)] = link.textContent.trim();
});
tutorialTranslations.zh = {
meta: {
htmlLang: 'zh-CN',
pageTitle: document.title
},
ui: {
navTitle: navTitleEl.textContent.trim(),
pageHeaderTitle: pageTitleEl.textContent.trim(),
projectLinkLabel: projectLinkLabelTextEl.textContent.trim(),
projectLinkDescription: projectLinkDescriptionEl.textContent.trim(),
projectLinkButton: projectLinkButtonTextEl.textContent.trim(),
languageLabel: languageTriggerEl.getAttribute('aria-label') || '切换语言',
themeLight: '日间模式',
themeDark: '夜间模式',
hamburgerOpenLabel: '打开导航菜单',
hamburgerCloseLabel: '关闭导航菜单',
siteCardHint: '点击复制网址,去受控浏览器打开',
siteCardCopied: '已复制网址,请到受控浏览器粘贴打开',
siteCardCopyFailed: '复制失败,请手动复制并到受控浏览器打开',
siteCardEmpty: '当前没有读取到站点列表,请直接以控制面板中的站点配置为准。'
},
nav: navContent,
sections: sectionContent
};
}
function getCurrentBundle() {
return tutorialTranslations[tutorialState.currentLanguage] || tutorialTranslations.zh;
}
function getSiteCardTexts() {
const bundle = getCurrentBundle() || {};
const fallback = tutorialTranslations.zh || {};
const bundleUi = bundle.ui || {};
const fallbackUi = fallback.ui || {};
return {
hint: bundleUi.siteCardHint || fallbackUi.siteCardHint || '点击复制网址,去受控浏览器打开',
copied: bundleUi.siteCardCopied || fallbackUi.siteCardCopied || '已复制网址,请到受控浏览器粘贴打开',
copyFailed: bundleUi.siteCardCopyFailed || fallbackUi.siteCardCopyFailed || '复制失败,请手动复制并到受控浏览器打开',
empty: bundleUi.siteCardEmpty || fallbackUi.siteCardEmpty || '当前没有读取到站点列表,请直接以控制面板中的站点配置为准。'
};
}
function showSiteCopyToast(message, isError = false) {
let toast = document.getElementById('siteCopyToast');
if (!toast) {
toast = document.createElement('div');
toast.id = 'siteCopyToast';
toast.className = 'site-copy-toast';
toast.setAttribute('role', 'status');
toast.setAttribute('aria-live', 'polite');
document.body.appendChild(toast);
}
toast.textContent = message;
toast.classList.toggle('error', isError);
toast.classList.add('visible');
clearTimeout(showSiteCopyToast.timer);
showSiteCopyToast.timer = setTimeout(() => {
toast.classList.remove('visible');
}, 2600);
}
async function copyTextToClipboard(text) {
if (navigator.clipboard && navigator.clipboard.writeText) {
await navigator.clipboard.writeText(text);
return;
}
const helper = document.createElement('textarea');
helper.value = text;
helper.setAttribute('readonly', 'readonly');
helper.style.position = 'fixed';
helper.style.opacity = '0';
helper.style.pointerEvents = 'none';
document.body.appendChild(helper);
helper.focus();
helper.select();
try {
const copied = document.execCommand('copy');
if (!copied) {
throw new Error('copy_failed');
}
} finally {
document.body.removeChild(helper);
}
}
async function handleSiteCardClick(url) {
const texts = getSiteCardTexts();
try {
await copyTextToClipboard(url);
showSiteCopyToast(`${texts.copied}:${url}`);
} catch (error) {
showSiteCopyToast(`${texts.copyFailed}:${url}`, true);
}
}
async function loadSiteCatalog() {
try {
const baseUrl = window.location.protocol === 'file:' ? 'http://127.0.0.1:8199' : '';
const response = await fetch(`${baseUrl}/api/startup/controlled-browser-guide-data`, { cache: 'no-store' });
if (!response.ok) {
throw new Error(`HTTP ${response.status}`);
}
const payload = await response.json();
sites = Array.isArray(payload.sites)
? payload.sites.map(site => ({
url: String(site?.url || '').trim(),
name: String(site?.name || site?.domain || '').trim(),
id: String(site?.id || site?.domain || '').trim(),
domain: String(site?.domain || '').trim()
})).filter(site => site.url && site.name)
: [];
} catch (error) {
console.log('loadSiteCatalog failed (using default fallback sites for offline rendering):', error.message || error);
sites = [
{ name: 'ChatGPT', id: 'chatgpt.com', url: 'https://chatgpt.com', domain: 'chatgpt.com' },
{ name: 'Claude', id: 'claude.ai', url: 'https://claude.ai', domain: 'claude.ai' },
{ name: 'Gemini', id: 'gemini.google.com', url: 'https://gemini.google.com', domain: 'gemini.google.com' },
{ name: 'DeepSeek', id: 'chat.deepseek.com', url: 'https://chat.deepseek.com', domain: 'chat.deepseek.com' }
];
}
renderSiteGrid();
}
async function getRequestGeneratorText() {
const scriptUrl = new URL('./%E6%8B%A6%E6%88%AA%E8%AF%B7%E6%B1%82%E5%8F%91%E7%94%9F%E5%99%A8.txt', window.location.href);
try {
const response = await fetch(scriptUrl.href, { cache: 'no-store' });
if (response.ok) {
const text = await response.text();
if (text && text.trim()) {
return text;
}
}
} catch (error) {
// file:// 场景下 fetch 可能被浏览器限制,继续尝试 iframe 回退
}
const frame = document.getElementById('requestGeneratorFrame');
try {
const doc = frame?.contentDocument || frame?.contentWindow?.document;
const text = doc?.body?.innerText || doc?.documentElement?.innerText || '';
if (text && text.trim()) {
return text.replace(/\r\n/g, '\n');
}
} catch (error) {
// 某些浏览器对本地文件 iframe 访问更严格,继续走统一失败提示
}
throw new Error('request_generator_unavailable');
}
async function handleRequestGeneratorCopy() {
try {
const text = await getRequestGeneratorText();
await copyTextToClipboard(text);
showSiteCopyToast('已复制拦截请求发生器脚本,可直接粘贴到 Console');
} catch (error) {
showSiteCopyToast('复制脚本失败,请先展开下方内容后手动复制', true);
}
}
// 渲染站点卡片
function renderSiteGrid() {
const grid = document.getElementById('siteGrid');
if (!grid) {
return;
}
const texts = getSiteCardTexts();
if (!sites.length) {
grid.innerHTML = `
${texts.empty}
`;
return;
}
grid.innerHTML = sites.map(site => `
📋
${escapeDocsHtml(site.name)}
${escapeDocsHtml(site.id)}
${escapeDocsHtml(texts.hint)}
`).join('');
grid.querySelectorAll('.site-card-button').forEach(button => {
button.addEventListener('click', () => {
handleSiteCardClick(button.dataset.siteUrl || '');
});
});
}
function updateLanguageButtons() {
languageButtons.forEach(button => {
const isActive = button.dataset.langOption === tutorialState.currentLanguage;
button.classList.toggle('active', isActive);
button.setAttribute('aria-pressed', isActive ? 'true' : 'false');
button.setAttribute('aria-checked', isActive ? 'true' : 'false');
});
languageCurrentTextEl.textContent = languageNames[tutorialState.currentLanguage] || languageNames.zh;
}
function setLanguageDropdownOpen(isOpen) {
languageDropdownEl.classList.toggle('open', isOpen);
languageTriggerEl.setAttribute('aria-expanded', isOpen ? 'true' : 'false');
}
function toggleLanguageDropdown() {
setLanguageDropdownOpen(!languageDropdownEl.classList.contains('open'));
}
function updateHamburgerLabel(isOpen = document.getElementById('sidebar').classList.contains('open')) {
const bundle = getCurrentBundle();
hamburgerBtn.setAttribute(
'aria-label',
isOpen ? bundle.ui.hamburgerCloseLabel : bundle.ui.hamburgerOpenLabel
);
}
function applyLanguage(language) {
const normalized = normalizeLanguage(language);
const fallback = tutorialTranslations.zh;
const hasRequestedBundle = Boolean(tutorialTranslations[normalized]);
const effectiveLanguage = hasRequestedBundle ? normalized : 'zh';
const bundle = tutorialTranslations[effectiveLanguage] || fallback;
tutorialState.currentLanguage = effectiveLanguage;
document.documentElement.lang = bundle.meta?.htmlLang || fallback.meta.htmlLang;
document.title = bundle.meta?.pageTitle || fallback.meta.pageTitle;
navTitleEl.textContent = bundle.ui?.navTitle || fallback.ui.navTitle;
pageTitleEl.textContent = bundle.ui?.pageHeaderTitle || fallback.ui.pageHeaderTitle;
projectLinkLabelTextEl.textContent = bundle.ui?.projectLinkLabel || fallback.ui.projectLinkLabel;
projectLinkDescriptionEl.textContent = bundle.ui?.projectLinkDescription || fallback.ui.projectLinkDescription;
projectLinkButtonTextEl.textContent = bundle.ui?.projectLinkButton || fallback.ui.projectLinkButton;
languageTriggerEl.setAttribute('aria-label', bundle.ui?.languageLabel || fallback.ui.languageLabel);
languageMenuEl.setAttribute('aria-label', bundle.ui?.languageLabel || fallback.ui.languageLabel);
navLinks.forEach(link => {
const sectionId = link.getAttribute('href').slice(1);
link.textContent = bundle.nav?.[sectionId] || fallback.nav?.[sectionId] || link.textContent;
});
sections.forEach(section => {
const translatedHtml = bundle.sections?.[section.id] || fallback.sections?.[section.id];
if (typeof translatedHtml === 'string') {
section.innerHTML = translatedHtml;
}
});
renderSiteGrid();
updateLanguageButtons();
updateThemeButton(document.documentElement.getAttribute('data-theme') || 'light');
updateHamburgerLabel();
updateActiveNavLink();
}
function setLanguage(language) {
const normalized = normalizeLanguage(language);
localStorage.setItem('tutorial-language', normalized);
applyLanguage(normalized);
}
// 夜间模式
function toggleTheme() {
const current = document.documentElement.getAttribute('data-theme');
const next = current === 'dark' ? 'light' : 'dark';
document.documentElement.setAttribute('data-theme', next);
localStorage.setItem('tutorial-theme', next);
updateThemeButton(next);
}
function updateThemeButton(theme) {
const icon = document.getElementById('themeIcon');
const text = document.getElementById('themeText');
const bundle = getCurrentBundle();
if (theme === 'dark') {
icon.textContent = '☀️';
text.textContent = bundle.ui.themeLight;
} else {
icon.textContent = '🌙';
text.textContent = bundle.ui.themeDark;
}
}
function initTheme() {
const saved = localStorage.getItem('tutorial-theme');
let theme = 'light';
if (saved) {
theme = saved;
} else if (window.matchMedia('(prefers-color-scheme: dark)').matches) {
theme = 'dark';
}
document.documentElement.setAttribute('data-theme', theme);
updateThemeButton(theme);
}
moveAuthorNoteSection();
// 滚动高亮逻辑
const sections = document.querySelectorAll('section');
const navLinks = document.querySelectorAll('.nav-link');
function updateActiveNavLink() {
let current = '';
sections.forEach(section => {
const sectionTop = section.offsetTop;
if (scrollY >= sectionTop - 100) {
current = section.getAttribute('id');
}
});
navLinks.forEach(link => {
link.classList.remove('active');
if (link.getAttribute('href') === '#' + current) {
link.classList.add('active');
}
});
}
window.addEventListener('scroll', updateActiveNavLink);
// 侧边栏开关
function toggleSidebar() {
const sidebar = document.getElementById('sidebar');
const overlay = document.getElementById('sidebarOverlay');
const isOpen = sidebar.classList.contains('open');
sidebar.classList.toggle('open');
hamburgerBtn.classList.toggle('active');
if (!isOpen) {
overlay.style.display = 'block';
requestAnimationFrame(() => overlay.classList.add('active'));
} else {
overlay.classList.remove('active');
setTimeout(() => { overlay.style.display = 'none'; }, 300);
}
updateHamburgerLabel(!isOpen);
}
// 手机端点击导航链接后自动关闭侧边栏
navLinks.forEach(link => {
link.addEventListener('click', () => {
if (window.innerWidth <= 900) {
toggleSidebar();
}
});
});
languageButtons.forEach(button => {
button.addEventListener('click', () => {
setLanguage(button.dataset.langOption);
setLanguageDropdownOpen(false);
});
});
languageTriggerEl.addEventListener('click', (event) => {
event.stopPropagation();
toggleLanguageDropdown();
});
languageMenuEl.addEventListener('click', (event) => {
event.stopPropagation();
});
document.addEventListener('click', (event) => {
if (!languageDropdownEl.contains(event.target)) {
setLanguageDropdownOpen(false);
}
});
document.addEventListener('keydown', (event) => {
if (event.key === 'Escape') {
setLanguageDropdownOpen(false);
}
});
document.addEventListener('click', (event) => {
const copyButton = event.target.closest('#copyRequestGeneratorBtn');
if (copyButton) {
handleRequestGeneratorCopy();
}
});
// 页面加载时初始化
const docsCategories = [
{
id: 'getting-started',
label: { zh: '开始使用', en: 'Start Here' },
heroTitle: { zh: '开始使用', en: 'Start Here' },
subtitle: {
zh: '先把受控浏览器、控制台和 API 连接跑通,再逐步深入更细的站点配置。',
en: 'Get the controlled browser, dashboard, and API connection working first, then move into deeper site configuration.'
},
quickLinks: [
{
targetId: 'quick-start',
title: { zh: '快速开始', en: 'Quick Start' },
description: { zh: '先分清两个浏览器,再按顺序完成第一次接入。', en: 'Understand the two-browser setup and finish your first connection in order.' }
},
{
targetId: 'connect-api',
title: { zh: '连接 API', en: 'Connect API' },
description: { zh: '直接看 Base URL、API Key 和模型填写方式。', en: 'Jump straight to the Base URL, API key, and model setup.' }
},
{
targetId: 'dashboard-tour',
title: { zh: '控制台导览', en: 'Dashboard Tour' },
description: { zh: '搞清楚站点、标签页、日志和设置分别在哪里。', en: 'See where sites, tabs, logs, and settings live in the dashboard.' }
},
{
targetId: 'faq',
title: { zh: '常见问题', en: 'FAQ' },
description: { zh: '连接失败、登录态失效、标签页异常先看这里。', en: 'Start here for connection failures, profile issues, or tab problems.' }
}
],
groups: [
{
title: { zh: '上手主线', en: 'Core Flow' },
sectionIds: ['quick-start', 'connect-api']
},
{
title: { zh: '控制台与调度', en: 'Dashboard and Routing' },
sectionIds: ['dashboard-tour', 'tab-pool']
},
{
title: { zh: '答疑与预期', en: 'FAQ and Expectations' },
sectionIds: ['faq', 'author-note']
}
]
},
{
id: 'site-adaptation',
label: { zh: '接入站点', en: 'Add a Site' },
heroTitle: { zh: '接入站点', en: 'Add a Site' },
subtitle: {
zh: '这一组负责把新站点真正跑起来,重点是新增站点、预设、选择器和工作流。',
en: 'This track focuses on making a new site actually work: adding the site, presets, selectors, and workflow.'
},
quickLinks: [
{
targetId: 'add-site-guide',
title: { zh: '新增站点', en: 'Add Site' },
description: { zh: '先选自动识别还是手动配置,再按最小配置起步。', en: 'Choose auto-detection or manual setup, then start from the minimum viable config.' }
},
{
targetId: 'presets',
title: { zh: '预设系统', en: 'Presets' },
description: { zh: '同一站点拆分不同用途时,优先用预设而不是复制站点。', en: 'Use presets, not duplicate sites, when one domain needs different behaviors.' }
},
{
targetId: 'selectors',
title: { zh: '选择器配置', en: 'Selectors' },
description: { zh: '输入框、发送按钮和结果容器的定位都在这里。', en: 'Map the input, send button, and result container here.' }
},
{
targetId: 'workflow',
title: { zh: '工作流配置', en: 'Workflow' },
description: { zh: '决定点击、等待、输入和发送的执行顺序。', en: 'Define the order of click, wait, fill, and send actions.' }
}
],
groups: [
{
title: { zh: '新增与拆分', en: 'Add and Split' },
sectionIds: ['add-site-guide', 'presets']
},
{
title: { zh: '交互动作', en: 'Interaction Flow' },
sectionIds: ['selectors', 'workflow']
}
]
},
{
id: 'parsing-streaming',
label: { zh: '解析与流式', en: 'Parsing and Streaming' },
heroTitle: { zh: '解析与流式', en: 'Parsing and Streaming' },
subtitle: {
zh: '如果你在找“怎么创建解析器”,或者想分清提取器和网络响应解析器的职责,这一组就是入口。',
en: 'If you are looking for parser creation or want to separate extractor work from network-response parsing, this is the right entry point.'
},
quickLinks: [
{
targetId: 'extractor-vs-parser',
title: { zh: '提取器还是解析器?', en: 'Extractor or Parser?' },
description: { zh: '先判断问题属于 HTML 提取,还是网络响应解析。', en: 'Decide first whether the issue belongs to HTML extraction or network response parsing.' }
},
{
targetId: 'response-detection-parser-guide',
title: { zh: '创建解析器', en: 'Create a Parser' },
description: { zh: '直接跳到“我想创建一个解析器”这段入口说明。', en: 'Jump directly to the “I want to create a parser” entry section.' }
},
{
targetId: 'response-detection',
title: { zh: '响应检测', en: 'Response Detection' },
description: { zh: '看 DOM 模式、网络拦截模式和超时参数应该怎么配。', en: 'Review DOM mode, network interception, and timeout settings.' }
},
{
targetId: 'image-extraction',
title: { zh: '多模态与附件', en: 'Multimodal and Files' },
description: { zh: '多模态提取和文件粘贴都在这里串起来看。', en: 'Follow multimodal extraction and file attach behavior together from here.' }
}
],
groups: [
{
title: { zh: '判断该改哪里', en: 'Choose the Right Layer' },
sectionIds: ['extractors', 'response-detection']
},
{
title: { zh: '特殊内容', en: 'Special Content' },
sectionIds: ['image-extraction', 'file-paste']
}
]
},
{
id: 'advanced',
label: { zh: '高级能力', en: 'Advanced' },
heroTitle: { zh: '高级能力', en: 'Advanced' },
subtitle: {
zh: '这里收拢函数调用、命令、AI 元素识别以及全局环境配置,适合已经跑通基础流程后再看。',
en: 'This area collects function calling, commands, AI element recognition, and global environment settings once the basics already work.'
},
quickLinks: [
{
targetId: 'function-calling',
title: { zh: '函数调用', en: 'Function Calling' },
description: { zh: '先看边界,再决定要不要把工具调用接进来。', en: 'Review the boundaries before wiring tools into your workflow.' }
},
{
targetId: 'commands',
title: { zh: '自动化命令', en: 'Commands' },
description: { zh: '切代理、执行脚本和命令编排都在这一节。', en: 'Proxy switching, scripts, and command orchestration live here.' }
},
{
targetId: 'ai-recognition',
title: { zh: 'AI 元素识别', en: 'AI Recognition' },
description: { zh: '遇到结构复杂的新站点,可以先靠它起步。', en: 'Use it to bootstrap element discovery on unfamiliar sites.' }
},
{
targetId: 'env-config',
title: { zh: '环境配置', en: 'Environment' },
description: { zh: '全局超时、端口、浏览器和保存策略统一在这里看。', en: 'Review ports, timeouts, browser settings, and persistence in one place.' }
}
],
groups: [
{
title: { zh: '扩展能力', en: 'Extended Capabilities' },
sectionIds: ['function-calling', 'stealth-mode', 'commands']
},
{
title: { zh: '识别与环境', en: 'Recognition and Environment' },
sectionIds: ['ai-recognition', 'env-config', 'browser-config', 'config-manage']
}
]
}
];
const docsSectionAliases = {
'quick-start': '入门 上手 第一次使用 双浏览器 controlled browser',
'add-site-guide': '新增站点 新网站 接入站点 自动识别 手动新增',
'selectors': '选择器 selector input_box send_btn result_container message_wrapper',
'extractors': '提取器 extractor html markdown dom 文本提取',
'image-extraction': '多模态提取 图片提取 音频提取 视频提取 media audio video image',
'response-detection': '解析器 parser 创建解析器 listen_pattern 网络拦截 stream streaming 响应检测',
'workflow': '工作流 workflow click wait fill_input key_press stream_wait',
'file-paste': '附件 上传 长文本 文件粘贴 附件发送判定 高级附件规则 attachment_monitor attachment_selectors pending_selectors Gemini',
'commands': '命令 自动化 代理 切换命令',
'ai-recognition': 'AI识别 element detection 自动分析',
'env-config': '环境变量 helper api key base url model'
};
const docsUiCopy = {
zh: {
brandTitle: 'Universal Web-to-API',
brandSubtitle: '教程中心',
sidebarTitle: '本分类内容',
searchTrigger: '搜索章节、配置项、解析器或关键词',
searchHint: 'Ctrl + K',
searchPlaceholder: '试试搜索:解析器、选择器、工作流、代理、登录态...',
searchIdle: '输入关键词开始搜索。会自动跳到对应分类和章节。',
searchEmpty: '没有找到匹配内容,可以试试“解析器”“选择器”“工作流”“登录态”等关键词。',
badgeSection: '章节',
badgeHeading: '小节',
tocKicker: '目录',
tocTitle: '当前页导航',
tocEmpty: '当前章节没有更细的子标题,可以直接阅读正文。',
shareLink: '分享链接',
shareCopied: '已复制当前章节链接',
closeSearch: '关闭搜索'
},
en: {
brandTitle: 'Universal Web-to-API',
brandSubtitle: 'Docs Hub',
sidebarTitle: 'Current Category',
searchTrigger: 'Search sections, settings, parsers, or keywords',
searchHint: 'Ctrl + K',
searchPlaceholder: 'Try: parser, selector, workflow, proxy, login profile...',
searchIdle: 'Start typing to search. The page will switch to the matching category automatically.',
searchEmpty: 'No results found. Try terms like "parser", "selector", "workflow", or "profile".',
badgeSection: 'SECTION',
badgeHeading: 'TOPIC',
tocKicker: 'On This Page',
tocTitle: 'Current Page',
tocEmpty: 'This section has no deeper sub-headings, so you can read the body directly.',
shareLink: 'Copy Link',
shareCopied: 'Copied the current section link',
closeSearch: 'Close Search'
}
};
const docsSectionToCategory = docsCategories.reduce((map, category) => {
category.groups.forEach(group => {
group.sectionIds.forEach(sectionId => {
map[sectionId] = category.id;
});
});
return map;
}, {});
const docsNavLinkMap = Array.from(navLinks).reduce((map, link) => {
const targetId = (link.getAttribute('href') || '').replace(/^#/, '');
if (targetId) {
map[targetId] = link;
}
return map;
}, {});
const docsRuntime = {
layoutReady: false,
eventsBound: false,
activeSectionId: '',
activeHeadingId: '',
searchIndex: []
};
function getDocsText(value) {
if (typeof value === 'string') {
return value;
}
if (!value || typeof value !== 'object') {
return '';
}
return value[tutorialState.currentLanguage] || value.zh || value.en || '';
}
function getDocsUi() {
return docsUiCopy[tutorialState.currentLanguage] || docsUiCopy.zh;
}
function getTutorialDashboardUrl() {
if (window.location.protocol === 'http:' || window.location.protocol === 'https:') {
return `${window.location.origin}/`;
}
return 'http://127.0.0.1:8199/';
}
function syncDashboardLinks() {
const dashboardUrl = getTutorialDashboardUrl();
document.querySelectorAll('[data-dashboard-link="true"]').forEach(link => {
link.setAttribute('href', dashboardUrl);
});
}
function normalizeDocsCategory(categoryId) {
return docsCategories.some(category => category.id === categoryId) ? categoryId : docsCategories[0].id;
}
function getDocsCategory(categoryId = tutorialState.currentCategory) {
const normalized = normalizeDocsCategory(categoryId);
return docsCategories.find(category => category.id === normalized) || docsCategories[0];
}
function escapeDocsHtml(value) {
return String(value || '')
.replace(/&/g, '&')
.replace(//g, '>')
.replace(/"/g, '"')
.replace(/'/g, ''');
}
function escapeDocsRegExp(value) {
return String(value || '').replace(/[.*+?^${}()|[\]\\]/g, '\\$&');
}
function stripDocsText(value) {
return String(value || '').replace(/\s+/g, ' ').trim();
}
function getVisibleDocsSections() {
return Array.from(sections).filter(section => !section.classList.contains('is-hidden-by-category'));
}
function getDocsTargetMeta(targetId) {
const target = document.getElementById(targetId);
if (!target) {
return null;
}
const section = target.closest('section');
if (!section) {
return null;
}
return {
target,
section,
sectionId: section.id,
categoryId: section.dataset.docsCategory || docsSectionToCategory[section.id] || docsCategories[0].id
};
}
function assignDocsCategories() {
sections.forEach(section => {
const categoryId = docsSectionToCategory[section.id] || docsCategories[0].id;
section.dataset.docsCategory = categoryId;
section.dataset.searchAliases = docsSectionAliases[section.id] || '';
});
navLinks.forEach(link => {
const sectionId = (link.getAttribute('href') || '').replace(/^#/, '');
link.dataset.docsCategory = docsSectionToCategory[sectionId] || docsCategories[0].id;
});
}
function ensureDocsPageHeader() {
const header = document.querySelector('.page-header');
const projectBanner = header?.querySelector('.project-link-banner');
if (!header || !projectBanner) {
return;
}
if (!document.getElementById('pageKicker')) {
const kicker = document.createElement('div');
kicker.id = 'pageKicker';
kicker.className = 'page-kicker';
header.insertBefore(kicker, pageTitleEl);
}
if (!document.getElementById('pageSubtitle')) {
const subtitle = document.createElement('p');
subtitle.id = 'pageSubtitle';
subtitle.className = 'page-subtitle';
pageTitleEl.insertAdjacentElement('afterend', subtitle);
}
if (!document.getElementById('pageQuickLinks')) {
const quickLinks = document.createElement('div');
quickLinks.id = 'pageQuickLinks';
quickLinks.className = 'page-quick-links';
header.insertBefore(quickLinks, projectBanner);
}
}
function renderDocsTopTabs() {
const tabsEl = document.getElementById('topTabs');
if (!tabsEl) {
return;
}
tabsEl.innerHTML = docsCategories.map(category => `
${escapeDocsHtml(getDocsText(category.label))}
`).join('');
}
function renderDocsSidebarGroups() {
const nav = document.querySelector('#sidebar nav');
if (!nav) {
return;
}
const category = getDocsCategory();
const activeSectionId = docsRuntime.activeSectionId || getVisibleDocsSections()[0]?.id || category.groups[0]?.sectionIds[0] || '';
nav.innerHTML = '';
nav.classList.add('sidebar-nav');
category.groups.forEach((group, index) => {
const details = document.createElement('details');
details.className = 'nav-group';
details.open = index === 0 || group.sectionIds.includes(activeSectionId);
const summary = document.createElement('summary');
summary.className = 'nav-group-summary';
summary.textContent = getDocsText(group.title);
details.appendChild(summary);
const linksWrap = document.createElement('div');
linksWrap.className = 'nav-group-links';
group.sectionIds.forEach(sectionId => {
const link = docsNavLinkMap[sectionId];
if (!link) {
return;
}
link.classList.remove('is-hidden-by-category');
linksWrap.appendChild(link);
});
details.appendChild(linksWrap);
nav.appendChild(details);
});
}
function ensureDocsLayout() {
const sidebar = document.getElementById('sidebar');
const mainContent = document.querySelector('.main-content');
if (!sidebar || !mainContent) {
return;
}
if (!document.getElementById('docsTopbar')) {
const topbar = document.createElement('div');
topbar.className = 'docs-topbar';
topbar.id = 'docsTopbar';
topbar.innerHTML = `
`;
sidebar.parentNode.insertBefore(topbar, sidebar);
}
if (!document.getElementById('docsShell')) {
const shell = document.createElement('div');
shell.id = 'docsShell';
shell.className = 'docs-shell';
sidebar.parentNode.insertBefore(shell, sidebar);
shell.appendChild(sidebar);
const pageShell = document.createElement('div');
pageShell.id = 'pageShell';
pageShell.className = 'page-shell';
shell.appendChild(pageShell);
pageShell.appendChild(mainContent);
}
const pageShell = document.getElementById('pageShell');
if (pageShell && !document.getElementById('pageToc')) {
const toc = document.createElement('aside');
toc.className = 'page-toc';
toc.id = 'pageToc';
toc.innerHTML = `
`;
pageShell.appendChild(toc);
}
if (!document.getElementById('searchOverlay')) {
const overlay = document.createElement('div');
overlay.className = 'search-overlay';
overlay.id = 'searchOverlay';
overlay.innerHTML = `
`;
document.body.appendChild(overlay);
}
const docsActions = document.getElementById('docsActions');
if (docsActions && languageDropdownEl && languageDropdownEl.parentElement !== docsActions) {
docsActions.appendChild(languageDropdownEl);
}
ensureDocsPageHeader();
renderDocsTopTabs();
renderDocsSidebarGroups();
docsRuntime.layoutReady = true;
}
function syncDocsChrome() {
const ui = getDocsUi();
const category = getDocsCategory();
const quickLinks = document.getElementById('pageQuickLinks');
const pageKicker = document.getElementById('pageKicker');
const pageSubtitle = document.getElementById('pageSubtitle');
const brandTitle = document.getElementById('docsBrandTitle');
const brandSubtitle = document.getElementById('docsBrandSubtitle');
const searchTriggerText = document.getElementById('searchTriggerText');
const searchTriggerHint = document.getElementById('searchTriggerHint');
const searchModalLabel = document.getElementById('searchModalLabel');
const searchInput = document.getElementById('searchInput');
const searchCloseBtn = document.getElementById('searchCloseBtn');
const tocKicker = document.getElementById('pageTocKicker');
const tocShareBtn = document.getElementById('tocShareBtn');
navTitleEl.textContent = getDocsText(category.label) || ui.sidebarTitle;
pageTitleEl.textContent = getDocsText(category.heroTitle);
if (pageKicker) {
pageKicker.textContent = ui.brandSubtitle;
}
if (pageSubtitle) {
pageSubtitle.textContent = getDocsText(category.subtitle);
}
if (brandTitle) {
brandTitle.textContent = ui.brandTitle;
}
if (brandSubtitle) {
brandSubtitle.textContent = ui.brandSubtitle;
}
if (searchTriggerText) {
searchTriggerText.textContent = ui.searchTrigger;
}
if (searchTriggerHint) {
searchTriggerHint.textContent = ui.searchHint;
}
if (searchModalLabel) {
searchModalLabel.textContent = ui.searchTrigger;
}
if (searchInput) {
searchInput.placeholder = ui.searchPlaceholder;
}
if (searchCloseBtn) {
searchCloseBtn.textContent = 'Esc';
searchCloseBtn.setAttribute('aria-label', ui.closeSearch);
}
if (tocKicker) {
tocKicker.textContent = ui.tocKicker;
}
if (tocShareBtn) {
tocShareBtn.textContent = ui.shareLink;
}
if (quickLinks) {
quickLinks.innerHTML = category.quickLinks.map(link => `
${escapeDocsHtml(getDocsText(link.title))}
${escapeDocsHtml(getDocsText(link.description))}
`).join('');
}
renderDocsTopTabs();
}
function ensureDocsExtractorNote() {
const extractorsSection = document.getElementById('extractors');
if (!extractorsSection || extractorsSection.querySelector('[data-docs-extractor-note]')) {
return;
}
const note = document.createElement('div');
note.className = 'clarity-note';
note.dataset.docsExtractorNote = 'true';
note.innerHTML = tutorialState.currentLanguage === 'en'
? `
If the full answer is already visible on the page and only the captured result looks messy, incomplete, or badly formatted, start with the extractor .
If the answer is not rendered yet, or you want to read the underlying JSON / text directly, you need the parser and network interception instead.
If your goal is to create a parser for a new site, jump straight to the parser guide in the response detection section below.
`
: `
网页上已经有完整的字了,只是抓下来比较乱、缺内容、丢格式?先改提取器 。它负责把网页 HTML 清洗成干净的 Markdown。
字还没渲染出来,或者你想直接拦截底层 JSON / 文本?那就去看解析器 和网络拦截。它负责把响应体转换成最终输出。
如果你的目标是给新站点创建解析器,直接跳到下方「我想创建一个解析器,该从哪里看起?」这一段就行。
`;
const firstParagraph = extractorsSection.querySelector('p');
if (firstParagraph) {
firstParagraph.insertAdjacentElement('afterend', note);
} else {
extractorsSection.prepend(note);
}
}
function ensureDocsParserGuide() {
const responseSection = document.getElementById('response-detection');
if (!responseSection || responseSection.querySelector('[data-docs-parser-guide]')) {
return;
}
const guide = document.createElement('div');
guide.className = 'task-guide';
guide.dataset.docsParserGuide = 'true';
guide.innerHTML = tutorialState.currentLanguage === 'en'
? `
Hands-on
I want to create a parser. Where should I start?
If the site already renders the answer in the DOM and only the extracted text looks wrong, stay with extractors. You only need a parser when the real answer lives inside the intercepted request or response.
Use the built-in request generator in this section and export one real request sample.
Send that export to AI together with app/core/parsers/base.py, app/core/parsers/__init__.py, and one or two similar parsers.
Ask AI to create app/core/parsers/xxx_parser.py and tell you how to register it in __init__.py.
Return to the dashboard, enable network interception, then fill in listen_pattern and the parser ID you just created.
The detailed walkthrough is still right below. This entry is here so parser creation no longer stays buried in the middle of a long chapter.
`
: `
实战入口
我想创建一个解析器,该从哪里看起?
如果站点的回复已经渲染在 DOM 里,只是提取结果不对,那还是先看提取器。只有当真实内容藏在网络请求 / 响应里时,才需要自己写解析器。
先用本节内置的拦截脚本导出一次真实请求样本。
把导出文件和 app/core/parsers/base.py、app/core/parsers/__init__.py、一两个相近解析器一起发给 AI。
让 AI 新建 app/core/parsers/xxx_parser.py,并告诉你 __init__.py 里该怎么注册。
回到控制台开启网络拦截模式,再填写 listen_pattern 和你刚创建的 parser ID。
真正的详细示例步骤还在本节下面,这里只是先给你一个清晰入口,避免“创建解析器”的说明继续埋在长章节中间。
`;
const firstParagraph = responseSection.querySelector('p');
if (firstParagraph) {
firstParagraph.insertAdjacentElement('afterend', guide);
} else {
responseSection.prepend(guide);
}
}
function ensureDocsHeadingAnchors() {
sections.forEach(section => {
let h3Index = 0;
let h4Index = 0;
section.querySelectorAll('h3, h4').forEach(heading => {
if (heading.id) {
return;
}
if (heading.tagName === 'H3') {
h3Index += 1;
heading.id = `${section.id}-h3-${h3Index}`;
} else {
h4Index += 1;
heading.id = `${section.id}-h4-${h4Index}`;
}
});
});
}
function highlightDocsTerms(text, terms) {
let html = escapeDocsHtml(text);
terms.forEach(term => {
if (!term) {
return;
}
const matcher = new RegExp(`(${escapeDocsRegExp(term)})`, 'ig');
html = html.replace(matcher, '$1 ');
});
return html;
}
function getDocsSearchSnippet(item, terms) {
const source = stripDocsText(item.snippetSource || item.title || '');
if (!source) {
return item.sectionTitle ? escapeDocsHtml(item.sectionTitle) : '';
}
const lowerSource = source.toLowerCase();
const firstIndex = terms.reduce((current, term) => {
const index = lowerSource.indexOf(term);
if (index === -1) {
return current;
}
if (current === -1) {
return index;
}
return Math.min(current, index);
}, -1);
let snippet = source;
if (firstIndex > 72) {
snippet = `...${source.slice(firstIndex - 48, firstIndex + 120)}`;
} else {
snippet = source.slice(0, 168);
}
if (snippet.length < source.length && !snippet.endsWith('...')) {
snippet += '...';
}
return highlightDocsTerms(snippet, terms);
}
function buildDocsSearchIndex() {
const index = [];
sections.forEach(section => {
const sectionTitle = stripDocsText(section.querySelector('h2')?.textContent || section.id);
const sectionText = stripDocsText(section.textContent);
const categoryId = section.dataset.docsCategory || docsSectionToCategory[section.id] || docsCategories[0].id;
const aliases = stripDocsText(section.dataset.searchAliases || '');
index.push({
type: 'section',
targetId: section.id,
sectionId: section.id,
categoryId,
title: sectionTitle,
sectionTitle,
snippetSource: sectionText,
searchText: `${sectionTitle} ${aliases} ${sectionText}`.toLowerCase()
});
section.querySelectorAll('h3, h4').forEach(heading => {
const headingText = stripDocsText(heading.textContent);
if (!headingText) {
return;
}
const fragments = [headingText];
let sibling = heading.nextElementSibling;
let guard = 0;
while (sibling && !/^H[34]$/.test(sibling.tagName) && guard < 4) {
const text = stripDocsText(sibling.textContent);
if (text) {
fragments.push(text);
}
sibling = sibling.nextElementSibling;
guard += 1;
}
index.push({
type: 'heading',
targetId: heading.id,
sectionId: section.id,
categoryId,
title: headingText,
sectionTitle,
snippetSource: fragments.join(' '),
searchText: `${headingText} ${sectionTitle} ${aliases} ${fragments.join(' ')}`.toLowerCase()
});
});
});
docsRuntime.searchIndex = index;
}
function renderDocsSearchResults(query) {
const resultsEl = document.getElementById('searchResults');
if (!resultsEl) {
return;
}
const ui = getDocsUi();
const normalizedQuery = stripDocsText(query).toLowerCase();
const terms = normalizedQuery.split(/\s+/).filter(Boolean);
if (!terms.length) {
resultsEl.innerHTML = `${escapeDocsHtml(ui.searchIdle)}
`;
return;
}
const results = docsRuntime.searchIndex
.filter(item => terms.every(term => item.searchText.includes(term)))
.map(item => {
const titleLower = item.title.toLowerCase();
const score = terms.reduce((total, term) => {
let next = total;
if (titleLower.includes(term)) {
next += 12;
}
if (item.sectionTitle.toLowerCase().includes(term)) {
next += 4;
}
if (item.searchText.includes(term)) {
next += 2;
}
return next;
}, item.type === 'heading' ? 1 : 0);
return { ...item, score };
})
.sort((left, right) => right.score - left.score)
.slice(0, 14);
if (!results.length) {
resultsEl.innerHTML = `${escapeDocsHtml(ui.searchEmpty)}
`;
return;
}
resultsEl.innerHTML = results.map(item => {
const categoryLabel = getDocsText(getDocsCategory(item.categoryId).label);
const badge = item.type === 'heading' ? ui.badgeHeading : ui.badgeSection;
const snippet = getDocsSearchSnippet(item, terms);
return `
${highlightDocsTerms(item.title, terms)}
${escapeDocsHtml(badge)}
${escapeDocsHtml(categoryLabel)} / ${escapeDocsHtml(item.sectionTitle)} · ${snippet}
`;
}).join('');
}
function openDocsSearch(initialQuery = '') {
const overlay = document.getElementById('searchOverlay');
const input = document.getElementById('searchInput');
if (!overlay || !input) {
return;
}
tutorialState.searchOpen = true;
overlay.classList.add('open');
input.value = initialQuery;
renderDocsSearchResults(initialQuery);
requestAnimationFrame(() => {
input.focus();
input.select();
});
}
function closeDocsSearch() {
const overlay = document.getElementById('searchOverlay');
if (!overlay) {
return;
}
tutorialState.searchOpen = false;
overlay.classList.remove('open');
}
function getCurrentDocsSectionId() {
const visibleSections = getVisibleDocsSections();
let current = visibleSections[0]?.id || '';
visibleSections.forEach(section => {
if (window.scrollY >= section.offsetTop - 140) {
current = section.id;
}
});
return current;
}
function getCurrentDocsHeadingId(sectionId = docsRuntime.activeSectionId) {
const section = document.getElementById(sectionId);
if (!section) {
return '';
}
let current = '';
section.querySelectorAll('h3, h4').forEach(heading => {
if (window.scrollY >= heading.offsetTop - 148) {
current = heading.id;
}
});
return current;
}
function updateDocsTocActiveState() {
const activeHeadingId = docsRuntime.activeHeadingId;
const activeSectionId = docsRuntime.activeSectionId;
document.querySelectorAll('.toc-link').forEach(link => {
const targetId = (link.getAttribute('href') || '').replace(/^#/, '');
const isActive = activeHeadingId
? targetId === activeHeadingId
: targetId === activeSectionId;
link.classList.toggle('active', isActive);
});
}
function renderDocsToc() {
const tocTitle = document.getElementById('pageTocTitle');
const tocLinks = document.getElementById('pageTocLinks');
if (!tocTitle || !tocLinks) {
return;
}
const ui = getDocsUi();
const sectionId = docsRuntime.activeSectionId || getCurrentDocsSectionId();
const section = document.getElementById(sectionId);
if (!section) {
tocTitle.textContent = ui.tocTitle;
tocTitle.dataset.sectionId = '';
tocLinks.innerHTML = `${escapeDocsHtml(ui.tocEmpty)}
`;
return;
}
const sectionTitle = stripDocsText(section.querySelector('h2')?.textContent || section.id);
const headings = Array.from(section.querySelectorAll('h3, h4'));
tocTitle.textContent = sectionTitle;
tocTitle.dataset.sectionId = section.id;
if (!headings.length) {
tocLinks.innerHTML = `
${escapeDocsHtml(sectionTitle)}
`;
updateDocsTocActiveState();
return;
}
tocLinks.innerHTML = headings.map(heading => `
${escapeDocsHtml(stripDocsText(heading.textContent))}
`).join('');
updateDocsTocActiveState();
}
function scrollDocsToTarget(targetId, behavior = 'smooth', options = {}) {
const target = document.getElementById(targetId);
if (!target) {
return;
}
const offset = window.innerWidth <= 900 ? 92 : 118;
const top = target.getBoundingClientRect().top + window.scrollY - offset;
window.scrollTo({
top: Math.max(top, 0),
behavior
});
if (options.updateHash !== false) {
history.replaceState(null, '', `#${targetId}`);
}
}
function revealDocsTarget(targetId, options = {}) {
const meta = getDocsTargetMeta(targetId);
if (!meta) {
return;
}
const behavior = options.behavior || 'smooth';
if (meta.categoryId !== tutorialState.currentCategory) {
setDocsCategory(meta.categoryId, {
persist: options.persist,
skipScroll: true
});
}
requestAnimationFrame(() => {
scrollDocsToTarget(targetId, behavior, {
updateHash: options.updateHash !== false
});
updateActiveNavLink();
});
if (window.innerWidth <= 900) {
const sidebar = document.getElementById('sidebar');
if (sidebar?.classList.contains('open')) {
toggleSidebar();
}
}
}
function copyDocsCurrentLink() {
const ui = getDocsUi();
const targetId = docsRuntime.activeHeadingId
|| docsRuntime.activeSectionId
|| getVisibleDocsSections()[0]?.id
|| 'quick-start';
const url = new URL(window.location.href);
url.hash = targetId;
copyTextToClipboard(url.toString())
.then(() => showSiteCopyToast(ui.shareCopied))
.catch(() => showSiteCopyToast(ui.shareCopied, true));
}
function reorderDocsSections(categoryId) {
const mainContent = document.querySelector('.main-content');
const header = mainContent?.querySelector('.page-header');
if (!mainContent || !header) {
return;
}
const orderedIds = getDocsCategory(categoryId).groups.flatMap(group => group.sectionIds);
const remainingIds = Array.from(sections)
.map(section => section.id)
.filter(sectionId => !orderedIds.includes(sectionId));
[...orderedIds, ...remainingIds].forEach(sectionId => {
const section = document.getElementById(sectionId);
if (section) {
mainContent.appendChild(section);
}
});
}
function setDocsCategory(categoryId, options = {}) {
const normalized = normalizeDocsCategory(categoryId);
tutorialState.currentCategory = normalized;
if (options.persist !== false) {
localStorage.setItem('tutorial-category', normalized);
}
reorderDocsSections(normalized);
sections.forEach(section => {
const isVisible = section.dataset.docsCategory === normalized;
section.classList.toggle('is-hidden-by-category', !isVisible);
});
navLinks.forEach(link => {
const isVisible = link.dataset.docsCategory === normalized;
link.classList.toggle('is-hidden-by-category', !isVisible);
});
renderDocsSidebarGroups();
syncDocsChrome();
docsRuntime.activeSectionId = '';
docsRuntime.activeHeadingId = '';
updateActiveNavLink();
if (!options.skipScroll) {
const firstSectionId = options.targetId || getDocsCategory(normalized).groups[0]?.sectionIds[0];
if (firstSectionId) {
scrollDocsToTarget(firstSectionId, options.behavior || 'smooth', {
updateHash: options.updateHash !== false
});
}
}
}
function handleDocsHashChange() {
const hashTarget = decodeURIComponent(window.location.hash.replace(/^#/, ''));
if (!hashTarget) {
return;
}
const meta = getDocsTargetMeta(hashTarget);
if (!meta) {
return;
}
revealDocsTarget(hashTarget, {
behavior: 'auto',
persist: false,
updateHash: false
});
}
function bindDocsEvents() {
if (docsRuntime.eventsBound) {
return;
}
docsRuntime.eventsBound = true;
document.addEventListener('click', event => {
const navLink = event.target.closest('.nav-link');
if (navLink) {
const href = navLink.getAttribute('href') || '';
const targetId = decodeURIComponent(href.replace(/^#/, ''));
if (targetId) {
event.preventDefault();
revealDocsTarget(targetId);
return;
}
}
const categoryTrigger = event.target.closest('.top-tab[data-docs-category]');
if (categoryTrigger) {
event.preventDefault();
const categoryId = categoryTrigger.getAttribute('data-docs-category');
setDocsCategory(categoryId, {
targetId: getDocsCategory(categoryId).groups[0]?.sectionIds[0]
});
return;
}
const targetedLink = event.target.closest('[data-target-id]');
if (targetedLink) {
event.preventDefault();
const targetId = targetedLink.getAttribute('data-target-id');
if (targetedLink.classList.contains('search-result')) {
closeDocsSearch();
}
revealDocsTarget(targetId);
return;
}
if (event.target.closest('#searchTrigger')) {
event.preventDefault();
openDocsSearch(document.getElementById('searchInput')?.value || '');
return;
}
if (event.target.closest('#searchCloseBtn') || event.target.id === 'searchOverlay') {
event.preventDefault();
closeDocsSearch();
return;
}
if (event.target.closest('#tocShareBtn')) {
event.preventDefault();
copyDocsCurrentLink();
}
});
document.addEventListener('keydown', event => {
if ((event.ctrlKey || event.metaKey) && event.key.toLowerCase() === 'k') {
event.preventDefault();
openDocsSearch(document.getElementById('searchInput')?.value || '');
return;
}
if (tutorialState.searchOpen && event.key === 'Escape') {
closeDocsSearch();
}
});
const searchInput = document.getElementById('searchInput');
if (searchInput) {
searchInput.addEventListener('input', event => {
renderDocsSearchResults(event.target.value);
});
searchInput.addEventListener('keydown', event => {
if (event.key === 'Enter') {
const firstResult = document.querySelector('.search-result');
if (firstResult) {
event.preventDefault();
firstResult.click();
}
}
});
}
window.addEventListener('hashchange', handleDocsHashChange);
}
function updateActiveNavLink() {
const currentSectionId = getCurrentDocsSectionId();
docsRuntime.activeSectionId = currentSectionId;
docsRuntime.activeHeadingId = getCurrentDocsHeadingId(currentSectionId);
navLinks.forEach(link => {
const targetId = (link.getAttribute('href') || '').replace(/^#/, '');
const isActive = targetId === currentSectionId;
link.classList.toggle('active', isActive);
});
const tocTitle = document.getElementById('pageTocTitle');
if (tocTitle?.dataset.sectionId !== currentSectionId) {
renderDocsToc();
} else {
updateDocsTocActiveState();
}
}
function applyLanguage(language) {
const normalized = normalizeLanguage(language);
const fallback = tutorialTranslations.zh;
const bundle = tutorialTranslations[normalized] || fallback;
tutorialState.currentLanguage = normalized;
document.documentElement.lang = bundle.meta?.htmlLang || fallback.meta.htmlLang;
document.title = bundle.meta?.pageTitle || fallback.meta.pageTitle;
navTitleEl.textContent = bundle.ui?.navTitle || fallback.ui.navTitle;
pageTitleEl.textContent = bundle.ui?.pageHeaderTitle || fallback.ui.pageHeaderTitle;
projectLinkLabelTextEl.textContent = bundle.ui?.projectLinkLabel || fallback.ui.projectLinkLabel;
projectLinkDescriptionEl.textContent = bundle.ui?.projectLinkDescription || fallback.ui.projectLinkDescription;
projectLinkButtonTextEl.textContent = bundle.ui?.projectLinkButton || fallback.ui.projectLinkButton;
languageTriggerEl.setAttribute('aria-label', bundle.ui?.languageLabel || fallback.ui.languageLabel);
languageMenuEl.setAttribute('aria-label', bundle.ui?.languageLabel || fallback.ui.languageLabel);
navLinks.forEach(link => {
const sectionId = (link.getAttribute('href') || '').replace(/^#/, '');
link.textContent = bundle.nav?.[sectionId] || fallback.nav?.[sectionId] || link.textContent;
});
sections.forEach(section => {
const translatedHtml = bundle.sections?.[section.id] || fallback.sections?.[section.id];
if (typeof translatedHtml === 'string') {
section.innerHTML = translatedHtml;
}
});
syncDashboardLinks();
renderSiteGrid();
updateLanguageButtons();
updateThemeButton(document.documentElement.getAttribute('data-theme') || 'light');
updateHamburgerLabel();
assignDocsCategories();
ensureDocsExtractorNote();
ensureDocsParserGuide();
ensureDocsHeadingAnchors();
ensureDocsLayout();
bindDocsEvents();
syncDocsChrome();
buildDocsSearchIndex();
const hashTarget = decodeURIComponent(window.location.hash.replace(/^#/, ''));
const hashMeta = hashTarget ? getDocsTargetMeta(hashTarget) : null;
const nextCategory = hashMeta?.categoryId
|| normalizeDocsCategory(localStorage.getItem('tutorial-category') || tutorialState.currentCategory);
setDocsCategory(nextCategory, {
persist: false,
skipScroll: true
});
const currentTocTitle = document.getElementById('pageTocTitle');
if (currentTocTitle) {
currentTocTitle.dataset.sectionId = '';
}
if (hashMeta) {
requestAnimationFrame(() => {
scrollDocsToTarget(hashTarget, 'auto', { updateHash: false });
updateActiveNavLink();
});
} else {
updateActiveNavLink();
}
if (tutorialState.searchOpen) {
renderDocsSearchResults(document.getElementById('searchInput')?.value || '');
}
}
captureChineseBundle();
initTheme();
applyLanguage(normalizeLanguage(localStorage.getItem('tutorial-language') || 'zh'));
loadSiteCatalog();