AtlasNexus

AtlasNexus

开发知识体系地图站点，用于新人自检、学习路线推进、团队技术交流和知识沉淀。站点基于 React + Vite 开发。

开发

pnpm install
pnpm dev

开发服务默认运行在 http://localhost:5173。

生产构建

pnpm build

构建产物输出到 dist/。生产环境可由 Caddy 托管：

caddy run --config Caddyfile

路线图内容维护在 content/knowledge-map.md。节点关系集中写在顶部 ## 脉络关系，节点详情只保留展示和学习内容。修改后执行：

node scripts/validate-content.js
pnpm build

开发环境下修改 content/knowledge-map.md 后，Vite 会触发页面更新；生产环境需要重新构建并发布 dist/。

测试

pnpm test
pnpm validate

pnpm test 使用 Vitest 覆盖 Markdown 解析/序列化、路线图校验和地图布局纯函数。pnpm validate 校验 content/knowledge-map.md 的节点字段、章节和引用关系。

主要文件

• index.html：Vite 入口。
• src/App.jsx：React 应用装配入口。
• src/features/：地图、详情、编辑器和 Markdown 面板等业务 UI。
• src/hooks/：路线图文档、进度、地图拖拽和连线测量状态。
• src/lib/roadmap.js：Markdown 解析和序列化规则。
• src/lib/roadmapRelations.js：集中解析、生成主干/分支/子节点关系。
• src/lib/roadmapValidation.js：Markdown 节点字段、章节和引用校验规则。
• src/lib/mapLayout.js：地图布局、筛选、搜索和进度统计纯函数。
• src/styles/app.scss：Sass 样式入口，按基础样式和主题覆盖拆分。
• content/knowledge-map.md：知识地图 Markdown 数据源。
• public/knowledge-map.md：由同步脚本复制生成，构建时进入 dist/ 方便直接访问。
• docs/site-design.md：站点设计说明。
• docs/dev-knowledge-system.md：Markdown 规则和内容维护规范。
• docs/dev-knowledge-map.md：原始开发知识路线文档。
• scripts/validate-content.js：调用共享校验规则检查 Markdown 内容。
• scripts/sync-content.js：将内容源同步到 public/knowledge-map.md。
• Caddyfile：生产静态托管配置。