重要通知（2026-07-24）
为推进 FANDEX 体系的长期演进，整体项目正进行整合与重构，后续将以全新仓库（fanquanpp/FANDEX）作为唯一维护主体重新发布，预计 2026 年 8 月下旬正式完成。
据此，本仓库内容及站内文档自即日起暂停更新，但仍会围绕美术风格、交互体验（UI/UX）等方向持续探索。新仓库正式发布后，本仓库将进入只读归档状态，现有源码与历史 Release 仍可自由获取与使用；如有 fork 或二次开发需求，请遵循 MIT 许可证条款自行处理，作者不再对使用过程中的任何问题提供支持。
线上站点会在首页与文档页通过弹窗展示本公告，关闭后不再重复弹出。
一份无需任何先修门槛的计算机自学教程，以系统化的知识组织方式，帮助零基础自学者从第一行代码起步，逐步建立达到计算机专业本科毕业生水平的完整知识体系。六大领域环环相扣，51 个模块覆盖工具链、开发语言、数据库、计算机科学、工程基础设施与数据技术，近 2000 篇结构化文档陪伴每一位自学者走完从入门到精通的完整旅程。
- 零基础友好：不预设任何编程经验，模块间通过前置知识自然衔接
- 完整知识体系：近 2000 篇文档覆盖 51 个模块，从工具链到 AI 工程的完整学习路径
- 交互学习：内置进度追踪、术语悬浮、交互测验、知识地图、全文搜索等学习辅助功能
- PWA 离线访问：Service Worker 多策略缓存，支持添加到主屏幕
- 双主题响应式：Dark / Light 主题切换，桌面端侧边栏 + 移动端抽屉导航 + 底部导航栏
- AI 辅助理念：不内置 AI 功能，鼓励学习者使用外部 AI 工具自主学习，文档结构适配 AI 检索与问答
环境要求：Node.js 22 LTS + npm（或 pnpm / yarn）
npm install # 安装依赖
npm run dev # 本地开发（端口 3000）
npm run build # 构建生产版本
npm run preview # 预览构建结果（搜索功能需先 build）
npm run type-check
npm run test开发模式下 Pagefind 搜索索引未生成，搜索功能不可用。需
npm run build后npm run preview才能使用搜索。
仓库已配置 GitHub Actions 自动部署（.github/workflows/deploy.yml），push 到 main 分支即自动构建并部署至 GitHub Pages。
Astro 7（SSG + 岛屿架构）· Vue 3（按需水合）· Tailwind CSS v4 · shadcn-vue (radix-vue) · Shiki 双主题高亮 · Pagefind + Fuse.js 双引擎搜索 · Mermaid 11 知识地图 · Pyodide 浏览器内 Python 执行 · IndexedDB + localStorage 进度双存储 · Service Worker 多策略缓存 · JSON-LD + Sitemap SEO。
FANDEX 生态包含以下关联仓库，各仓库代码互相独立、内容互相关联，内容基准统一以本仓库为准：
| 仓库 | 定位 |
|---|---|
| FANDEX-exe | 跨平台桌面端（Tauri 2，Windows / macOS / Linux） |
| FANDEX-App | Android 离线速查应用（Kotlin + Jetpack Compose） |
本仓库为全部项目的根本内容源，所有文档、索引及数据均以此为唯一蓝本，仅允许只读引用。内容均由人工与人工智能协同编撰，可能存在遗漏、过时或错误之处，使用者应结合官方文档与权威资料独立验证。
完整免责条款见 DISCLAIMER.md，贡献指南见 CONTRIBUTING.md。
本仓库所有内容基于 MIT 许可证 完全开源。