peng01.guo 15b3337339 RDK 知识库数据集:论坛帖子导出 + 文档中心 Markdown + RAG 评测集(352 条)及全量生产管线
- forum-solved-export: 3539 个已解决话题(问题+全部对话+采纳回答),含索引
- rdk-docs-export: 21 个文档子站 ~3430 篇 Markdown(源码仓库/抓取/反解析三种方式)
- kb-eval: 352 条 RAG 检索评测集(答案全部锚定文档、多轮子代理交叉审计),
  含检索/出题/校验工具与子代理提示词模板,支持增量扩产
- pipeline: 论坛枚举导出、文档抓取反解析、覆盖率统计全部脚本(可重跑)
2026-09-18 17:14:40 +08:00
..

English | 简体中文

Documentation Repository

This repository contains the source code for the RDK case development documentation site, built with Docusaurus. It includes the main Chinese documentation, English translations, site theme customization.

Repository Structure Overview

The main directories are described as follows:

  • docs/: Main content of the Chinese documentation
  • i18n/en/docusaurus-plugin-content-docs/current/: English documentation content
  • scripts/: Maintenance and build helper scripts (numbering, link fixing, scope building, etc.)
  • src/: Theme customization, plugins, and remark extensions
  • static/: Static assets
  • .github/workflows/: CI/CD workflows (Pages deployment, OSS sync, Algolia index update)
  • docusaurus.config.js: Main site configuration
  • sidebars.js: Entry point for document sidebar configuration

Environment Setup

  • Node.js: >= 18
  • Package manager: npm
#  Quick installation for daily development (updates dependencies according to semver)
npm install

Documentation Maintenance Workflow

It is recommended to follow the steps below in order:


# 1) Local preview (Chinese)
npm run start

# 2) Local preview (English)
npm run start:en

# 3) Perform a full build check before committing
npm run build

# 4) Locally serve the build output for verification
npm run serve

Common Maintenance Commands

Content and Structure Maintenance


# Generate sidebar scope configuration (Doc Scope)
npm run generate-sidebar-config

# Watch document changes during development and automatically update sidebar scope configuration
npm run watch-sidebar-config

Local Development

# Chinese development mode (includes sidebar config watching)
npm run start

# English development mode (includes sidebar config watching)
npm run start:en

# Chinese development mode, using port 3001
npm run start:port

# Chinese development mode (without starting watcher)
npm run start:no-watch

# English development mode (without starting watcher)
npm run start:no-watch:en

# Clear Docusaurus cache
npm run clear

Build and Output Verification

# Standard full build
npm run build

# Locally preview the build directory
npm run serve

# Preview with specified host and port (example)
npm run serve -- --host=10.64.62.34 --port=1688 --no-open

Common access paths (the port will depend on the actual serve output):

  • English: http://localhost:3000/en/case_doc/case
  • Chinese: http://localhost:3000/case_doc/case