Commit Graph

239 Commits

Author SHA1 Message Date
sanbuphy 311546a2fc fix: replace all /en-us/ paths with /en/ for locale consistency 2026-02-26 04:42:28 +08:00
sanbuphy ef70b1d8e1 feat: add comprehensive backend topics and fix build issues
## 新增内容

### 附录文档扩展
- 扩展前端项目架构文档 (frontend-project-architecture.md)
- 扩展后端项目架构文档 (backend-project-architecture.md)
- 扩展数据治理文档 (data-governance.md)
- 扩展数据可视化文档 (data-visualization.md)
- 扩展分布式系统文档 (distributed-systems.md)
- 扩展高可用文档 (high-availability.md)
- 扩展单体到微服务文档 (monolith-to-microservices.md)
- 扩展系统设计方法论文档 (system-design-methodology.md)
- 扩展 Docker 容器文档 (docker-containers.md)
- 扩展 Kubernetes 文档 (kubernetes.md)
- 扩展 Linux 基础文档 (linux-basics.md)
- 扩展神经网络文档 (neural-networks.md)

### 新增交互式组件
- 数据治理组件: DataQualityDemo, DataGovernanceFrameworkDemo, DataLineageDemo
- 数据可视化组件: ChartTypeSelectorDemo, DashboardLayoutDemo
- 分布式系统组件: CAPTheoremDemo, ConsistencyModelsDemo, DistributedChallengesDemo
- 高可用组件: AvailabilityCalculatorDemo, FailoverStrategyDemo
- 系统设计组件: SystemDesignStepsDemo, CapacityEstimationDemo
- Docker 容器组件: DockerArchitectureDemo, DockerLifecycleDemo
- Kubernetes 组件: K8sArchitectureDemo, K8sWorkloadsDemo
- Linux 基础组件: LinuxFileSystemDemo, LinuxCommandDemo, LinuxPermissionsDemo
- 神经网络组件: NeuronDemo, NetworkLayersDemo, NetworkArchitectureDemo
- 单体到微服务组件: ArchEvolutionDemo
- 项目架构组件: ProjectArchitectureComparisonDemo
- 附录导航组件: AppendixFlowMap

### 英文版重构
- 将 en-us 目录重命名为 en
- 更新相关配置和组件中的语言代码

## Bug 修复
- 修复 index.js 中重复的组件导入语句导致的 build 失败
- 恢复被注释的 InvertedIndexDemo 和 SearchRelevanceDemo 导入
- 修复 HomeFeatures.vue 中 en-us 与 config.mjs 中 en 不一致导致的语言切换问题

## 其他改进
- 添加构建脚本 (scripts/build.mjs)
- 更新依赖版本
2026-02-26 04:35:28 +08:00
sanbuphy df51f84ab5 docs: 重构 README 附录展示 & 新增多个附录交互组件
README 更新:
- 移除顶部 header.png 横幅图片
- 新增「附录知识库」板块,以 3×3 网格展示 9 大知识领域精选内容
- 附录链接指向部署版网站 (datawhalechina.github.io)
- 阶段表格新增「附录」行,突出 80+ 交互式专题
- 章节标题「新手入门 & PM」简化为「零基础入门」
- News 新增 2026-02-25 附录知识库更新条目

新增交互组件:
- 异步任务队列 (async-task-queues) 演示组件
- 文件存储 (file-storage) 演示组件
- 项目架构 (project-architecture) 演示组件
- 限流与背压 (rate-limiting) 演示组件
- 搜索引擎 (search-engines) 演示组件
- 计算机基础: AppLaunch/BiosUefi/OSBoot 等启动流程演示组件

新增附录文档:
- 前端项目架构 (frontend-project-architecture.md)
- 后端项目架构 (backend-project-architecture.md)

内容优化:
- 算法思维、数据结构、编程语言、调试艺术等多篇附录内容更新
- HTML/CSS 布局、请求旅程等前后端文档完善
- 附录索引页 (index.md) 同步更新
2026-02-25 12:22:49 +08:00
sanbuphy f44c842fe7 feat(docs): update computer fundamentals content and demos
- Refactor frontend framework demo descriptions for clarity
- Remove interactive features from triad and field map demos
- Add new computer organization and DSL documentation links
- Split type systems and compilers into separate pages
- Enhance power-on-to-web article with relay race analogy
- Add new interactive demos for type systems and compilation
- Improve visual presentation of boot process and hardware flow
- Introduce new Vibe Coding flow demo component
2026-02-25 01:38:27 +08:00
sanbuphy 3af119a598 feat(appendix): 添加多个交互式演示组件,完善 AI/Infra 等章节内容
- 新增 Vibe Coding 全栈相关演示组件 (DeveloperSkillShift, FrontendTriad, BackendCore 等)
- 新增 RAG 相关组件 (RAGPipeline, ChunkingStrategy, Retrieval 等)
- 新增 Embedding & Vector 相关组件 (EmbeddingConcept, VectorSimilarity 等)
- 新增 AI Native App 设计组件 (AINativeArch, PromptDesign 等)
- 新增 Infrastructure as Code 组件 (IaCConcept, TerraformWorkflow 等)
- 新增 DNS & HTTPS 演示组件 (DnsResolution, HttpsHandshake 等)
- 新增 Model Finetuning 组件 (FinetuningPipeline 等)
- 更新多个章节的 markdown 内容,集成交互式演示
2026-02-24 18:22:58 +08:00
Sanbu b5a55811cc Merge pull request #38 from yli000/feat/sidebar-collapse
fix: 修复窄屏下汉堡菜单点击无响应的问题
2026-02-24 13:07:53 +08:00
sanbuphy f35cddeb8b feat(appendix): 重构工程实践章节,添加交互式演示组件
## 新增组件 (14个)
- CodeSmellDemo.vue: 代码异味识别演示
- DecisionMatrixDemo.vue: 决策矩阵工具
- DesignPatternCatalogDemo.vue: 设计模式目录
- DocStructureDemo.vue: 文档结构示例
- LicenseComparisonDemo.vue: 开源许可证对比
- OpenSourceWorkflowDemo.vue: 开源协作流程
- PatternPlaygroundDemo.vue: 设计模式演练场
- RefactoringDemo.vue: 重构实战演示
- SecurityChecklistDemo.vue: 安全检查清单
- TDDCycleDemo.vue: TDD 循环演示
- TechRadarDemo.vue: 技术雷达图
- TechWritingPracticeDemo.vue: 技术写作实践
- TestPyramidDemo.vue: 测试金字塔
- WebSecurityDemo.vue: Web 安全演示

## 文档更新 (7篇)
- code-quality-refactoring.md: 代码质量与重构
- design-patterns.md: 设计模式
- open-source-collaboration.md: 开源协作
- security-thinking.md: 安全思维
- technical-writing.md: 技术写作
- technology-selection.md: 技术选型
- testing-strategies.md: 测试策略

## 其他变更
- 将 browser-as-os.md 内容合并到 computer-networks.md
- 更新 .gitignore 和 theme/index.js
2026-02-24 13:03:21 +08:00
sanbuphy baba96e7ed fix(theme): 修复侧边栏收起后导航栏标题 border-bottom 重叠问题 2026-02-24 12:49:52 +08:00
yli 951541d5c5 fix: prevent sidebar collapse from blocking mobile hamburger menu
The `.ev-sidebar-collapsed .VPSidebar { display: none }` rule was not
wrapped in a media query, causing it to hide the sidebar at all viewport
widths. When a user collapsed the sidebar on desktop, the state persisted
in localStorage; resizing below 960px then caused VitePress's native
hamburger menu to open an immediately-hidden sidebar. Wrapping the rule
in `@media (min-width: 960px)` limits the override to desktop only.

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
2026-02-24 11:50:50 +08:00
sanbuphy 7538228113 feat(appendix): 重构数据模型章节,添加交互式演示组件
## 文档重构 (docs/zh-cn/appendix/5-data/data-models.md)

- 将原有电商系统实战内容移至第6节,新增系统性的数据模型选型指南
- 新增5种核心数据模型的详细介绍:
  1. 关系模型 (Relational) - MySQL/PostgreSQL
  2. 文档模型 (Document) - MongoDB/DynamoDB
  3. 图模型 (Graph) - Neo4j/Amazon Neptune
  4. 时序模型 (Time-Series) - InfluxDB/TimescaleDB
  5. 向量模型 (Vector) - Pinecone/Milvus/pgvector
- 每种模型包含:核心概念、适用场景、对比表格、选型建议
- 新增选型决策章节,提供清晰的决策矩阵
- 添加实战建议:现代系统应采用多模型混用策略

## 交互式组件 (docs/.vitepress/theme/components/appendix/data/DataModelsDemo.vue)

- 完全重写 DataModelsDemo 组件,支持5种数据模型的交互式展示
- 新增 Tab 切换界面,用户可直观对比不同模型
- 为每种模型添加特色可视化:
  - 关系模型:ER图示意 + 范式设计
  - 文档模型:JSON 结构展示 + 嵌套层级
  - 图模型:节点-边关系可视化
  - 时序模型:时间序列数据表格
  - 向量模型:Embedding 向量相似度演示
- 组件特性:
  - 响应式布局,支持移动端
  - VitePress 主题变量适配
  - 优缺点标签化展示
  - 典型用例场景列举

## 技术细节

- 使用 CSS Grid 和 Flexbox 实现紧凑布局
- 遵循 VitePress 设计系统(CSS 变量)
- 组件采用 Vue 3 Composition API 编写
2026-02-24 08:39:55 +08:00
sanbuphy 260d17ee8b feat: 添加多个附录交互式组件和文档更新
- 添加浏览器前端组件:无障碍访问、国际化、实时通信
- 添加 Transformer 注意力机制系列组件
- 更新 Canvas、数据追踪等现有组件
- 修复 ESLint 变量名冲突问题
- 完善相关附录文档
2026-02-24 08:34:53 +08:00
sanbuphy 94f9db0834 feat: 更新附录交互组件和文档 2026-02-24 00:18:09 +08:00
sanbuphy d45df3cda5 chore: 禁用 Prettier 对 Vue 文件的格式化,修复语法错误
- 在 .prettierignore 中添加 **/*.vue,避免格式化 Vue 组件
- 保留 JS 文件的格式化功能
- 避免 Prettier 将多行 HTML 属性压缩成单行,保持代码可读性
- 修复 ABTestingDemo.vue 中的语法错误:
  - 第 467 行:computed 回调函数缺少括号
  - 第 201 行:HTML 中的 < 符号需要转义为 &lt;
  - 第 480-481 行:变量声明缺少 const 关键字
2026-02-23 12:34:00 +08:00
sanbuphy 6e13832d97 feat: 更新附录文档及对应交互组件 2026-02-23 12:09:47 +08:00
sanbuphy 1062e2e16f refactor: 重构 api-intro、api-design、transistor-to-cpu 组件为紧凑布局
- 重构 api-intro 7 个 Vue 组件为更紧凑的左右布局
- 重构 api-design 相关组件
- 重构 transistor-to-cpu 相关组件
- 统一使用 demo-root -> demo-header -> demo-layout -> info-box 结构
- 扩写文章内容为 MIT 讲义风格
2026-02-23 01:50:43 +08:00
sanbuphy 2a0fdd3392 chore: save local history restorations from accidental git restore 2026-02-23 01:40:56 +08:00
sanbuphy 780be69b99 docs: Update Chinese documentation for API design and AI history, and modify the AI history demo component. 2026-02-22 23:51:53 +08:00
sanbuphy 5b622800b8 feat(docs): restructure API design guide with interactive demos and practical examples
refactor(components): replace static API design components with interactive demos
- Add ApiRequestDemo, RestfulUrlDemo, StatusCodeDemo, ErrorHandlingDemo, and ApiVersioningDemo
- Remove outdated ResourceAnalogy, RequestStructureDemo, and VersioningStrategyDemo

docs(api-design): completely rewrite API design chapter with restaurant analogy
- Add clear problem scenarios and solutions
- Include practical e-commerce API examples
- Add terminology glossary
- Improve error handling and versioning sections

style(ai-history): enhance FoundationDemo with better visual hierarchy
- Add section blocks for core theories and early breakthroughs
- Improve typography and highlighting

chore: remove unused components (CpuArchitectureDemo, EvolutionFlowDemo)
2026-02-22 23:20:27 +08:00
sanbuphy e5a5b9df5b feat(ai-protocols): add MCP and A2A protocol demos and documentation
docs(ai-protocols): update AI protocols page with visual demos and detailed explanations
style(git-demos): improve responsive design and layout for git visualization components
refactor(ai-history): simplify and clean up demo components
chore: update config to register new AI protocol components
2026-02-22 18:26:19 +08:00
sanbuphy 4b83a4c23e refactor(ui): improve sidebar toggle button interaction and styling
- Wrap toggle button in hover area for better UX
- Add fade-in animation and hover effects
- Adjust positioning and styling for consistency
2026-02-22 12:44:48 +08:00
yli b5baf54431 feat: 添加目录栏收起/展开功能 2026-02-22 01:56:23 +08:00
sanbuphy fd5ea92722 feat(docs): 完善开发工具文档并新增交互式演示组件
主要更新内容:

## 新增交互式演示组件
- SSH 认证流程可视化演示组件
- 正则表达式交互式测试工具
- 环境变量配置可视化演示
- 端口与 localhost 概念可视化解释
- 从晶体管到 CPU 的演进过程动画演示
- 数据编码(二进制/十六进制/base64)可视化演示

## 文档内容完善
- 补全 SSH 认证与密钥管理完整指南,包含最佳实践
- 完善正则表达式教程,增加常用模式示例
- 完成环境变量与 PATH 配置详解
- 详细解释端口、localhost 和网络基础知识
- 新增 Netlify 部署指南,包含表单处理和函数示例

## 样式优化
- 移除演示组件中的装饰性图标元素
- 清理未使用的 CSS 样式规则
- 统一组件视觉风格

## 资源清理
- 删除 chapter4 中未使用的冗余图片文件(57张)

## 其他改进
- 移除文档中的 placeholder 待实现标记
- 增加实用示例和故障排查提示
- 添加 API 密钥和环境变量安全最佳实践
- 优化文档结构和导航体验

涉及文件:189 个文件变更,新增 21989 行,删除 7784 行
2026-02-22 01:23:22 +08:00
sanbuphy 6b1a9cf056 feat(docs): add Netlify deployment guide and data encoding demos
- Add Netlify deployment section with form handling and functions examples
- Replace old Git demos with new interactive components
- Add comprehensive data encoding visualization demos
- Update comparison table with Netlify information
2026-02-22 01:21:39 +08:00
sanbuphy 6098908eee feat(docs): add interactive demos and complete content for development tools
- Add Vue components for interactive demos (SSH auth, regex, env vars, ports)
- Complete markdown content for SSH, regex, environment variables, and ports
- Remove placeholder "待实现" sections and replace with detailed guides
- Add visual explanations for key concepts like ports and localhost
- Include practical examples and troubleshooting tips
- Add component for showing evolution from transistors to CPU
- Improve documentation structure and navigation
- Add security best practices for API keys and environment variables
2026-02-21 10:04:47 +08:00
sanbuphy 399913d3ff style: remove icon elements and related styles from demo components
Clean up visual presentation by removing decorative icons from demo headers and info boxes across all components. Also removes now-unused CSS rules for icon styling.
2026-02-20 23:00:28 +08:00
sanbuphy da9e54f0cd Merge branch 'dev' into main
Including 30 new interactive components for computer fundamentals section
and routing fixes.
2026-02-20 22:02:52 +08:00
sanbuphy ec9d52033f feat: add 30 interactive components for computer fundamentals section
Added comprehensive interactive demos covering:
- Operating systems (2): OS overview, process/memory/filesystem
- Data encoding (2): data lifecycle, encoding/storage/transmission
- Network basics (5): overview, physical/data-link/transport/application layers
- Data structures (5): overview, linear structures, hash table, tree, selector
- Algorithms (4): overview, recursion, greedy thinking, paradigms
- Programming languages (5): evolution, paradigms, scenarios, comparison, type models
- Compilers (2): analogy, practice demo
- Additional (5): search/sort algorithms, network principles, encoding basics, storage hierarchy, graph structures

Also updated component registration in theme index.js and fixed minor formatting issues in related docs.
2026-02-20 21:59:52 +08:00
sanbuphy 0e8618f902 fix: use VitePress withBase in NavCard for correct routing
NavCard component now uses VitePress's withBase() utility function
to properly handle base path in all environments:
- Local development: /easy-vibe/
- GitHub Pages: /easy-vibe/
- Vercel: /

This fixes 404 errors when clicking NavCard links in appendix pages.

Co-Authored-By: Claude Sonnet 4.5 <noreply@anthropic.com>
2026-02-20 02:10:25 +08:00
sanbuphy c49ccf47eb Merge branch 'dev' 2026-02-20 01:48:56 +08:00
sanbuphy c4c494cbac fix: remove duplicate /easy-vibe prefix from internal links
Removed `/easy-vibe/` prefix from internal links in all index.md files.
VitePress automatically adds the base path, so these prefixes were causing
404 errors due to double path resolution:

- Before: /easy-vibe/zh-cn/appendix/...
- After: /zh-cn/appendix/...
- VitePress resolves to: /easy-vibe/zh-cn/appendix/... (local/GitHub)
- VitePress resolves to: /zh-cn/appendix/... (Vercel)

This fixes the sidebar 404 errors reported in appendix section.

Co-Authored-By: Claude Sonnet 4.5 <noreply@anthropic.com>
2026-02-20 01:47:53 +08:00
sanbuphy 0868fd85fb Merge branch 'dev' 2026-02-20 01:19:35 +08:00
sanbuphy 4aca9df44e chore: add husky pre-commit hook and auto-fix lint warnings
- Install husky for git hooks
- Add pre-commit hook to run 'npm run lint -- --fix' before each commit
- Auto-fix 6 additional warnings (attribute order, escape chars)
- 0 errors, 208 warnings (down from 214)

This ensures code quality checks run automatically before commits.

Co-Authored-By: Claude Sonnet 4.5 <noreply@anthropic.com>
2026-02-20 01:19:00 +08:00
sanbuphy 46cbb7b6d0 Merge branch 'dev' 2026-02-20 01:04:06 +08:00
sanbuphy 66b2ba6e45 fix: resolve all ESLint errors in Vue components
Fixed 22 ESLint errors across 26 Vue component files:
- Removed TypeScript type annotations from ReadingProgress.vue (converted to JS)
- Removed unused variables, imports, and duplicate function declarations
- Fixed HTML parsing errors (invalid attribute names, unclosed tags)
- Added missing :key directives to v-for loops
- Fixed duplicate object keys (backgroundImage)
- Replaced special characters in comments to avoid parsing issues
- Fixed malformed HTML tags (v-else", 003e attributes)

All warnings were left unchanged as requested. Build now passes with 0 errors.

Co-Authored-By: Claude Sonnet 4.5 <noreply@anthropic.com>
2026-02-20 01:03:38 +08:00
sanbuphy 0a187579d5 Merge branch 'dev' 2026-02-19 10:55:45 +08:00
sanbuphy 8078ee201c fix: fix Vue template parsing errors in ReadingProgress and TerminalHandsOn components
- Remove special characters from comment in ReadingProgress.vue
- Fix multi-line @click handler in TerminalHandsOn.vue
- Add simplified network components (NetworkLayersSimple, TcpUdpSimple)

Co-Authored-By: Claude Sonnet 4.5 <noreply@anthropic.com>
2026-02-19 10:54:31 +08:00
sanbuphy 94d06ce4ae Merge branch 'dev' 2026-02-19 10:16:50 +08:00
sanbuphy b1948225f4 fix: add /easy-vibe prefix to all appendix links 2026-02-19 10:16:32 +08:00
sanbuphy da2d8db031 Merge branch 'dev' 2026-02-19 02:06:04 +08:00
sanbuphy cca9185b2b feat: update zh-cn appendix index to match latest sidebar structure
- Reorganize content into 9 major categories matching config.mjs sidebar
- Add all NavCard entries for each section with proper descriptions
- Categories: 计算机基础, 开发工具, 浏览器与前端, 后端, 数据, 架构, 运维, AI, 工程素养
- Total 80+ articles now properly linked with card-based layout
2026-02-19 02:05:49 +08:00
sanbuphy cc9911fed3 Merge branch 'dev' 2026-02-19 01:29:28 +08:00
sanbuphy 0b8f17fbb0 style: update zh-cn appendix index to use NavGrid/NavCard components
- Replace simple markdown links with NavGrid and NavCard components
- Match the same card-based layout as en-us version
- Improve visual consistency across all language versions
2026-02-19 01:21:32 +08:00
sanbuphy 12c5fcd690 Merge branch 'dev' 2026-02-19 00:19:38 +08:00
sanbuphy f1d1b95a8f refactor: unify all language versions to use index.md instead of intro.md
- Rename stage-2/intro.md to stage-2/index.md for all languages
- Rename stage-3/intro.md to stage-3/index.md for all languages
- Rename appendix/intro.md to appendix/index.md for all languages
- Update config.mjs navigation links to use /stage-2/ and /stage-3/ instead of /stage-2/intro and /stage-3/intro
- This follows VitePress best practice where index.md is the default page for a directory
2026-02-19 00:19:14 +08:00
sanbuphy 0eba9e87e9 fix(eslint): reduce warnings in GitHub Actions deployment
- Disable formatting rules (handled by Prettier)
- Relaxed strict Vue/JS rules for demo code compatibility
- Fix syntax errors in ApiPlayground and VoiceCloningDemo
- Fix duplicate else-if condition in ApiPlayground
- Fix Promise executor async pattern in AutoregressiveAudioDemo
- Add TypeScript file support to ESLint config

Warnings reduced from 295 to 251 problems.

Co-Authored-By: Claude Sonnet 4.5 <noreply@anthropic.com>
2026-02-18 17:38:10 +08:00
sanbuphy a313f57fbf Merge branch 'dev' 2026-02-18 16:19:34 +08:00
sanbuphy 8b01686e68 feat: add zh-cn appendix intro.md 2026-02-18 16:19:14 +08:00
sanbuphy c7ee45646e Merge branch 'dev' 2026-02-18 16:05:04 +08:00
sanbuphy 6768339e35 docs: update IDE tutorial link in Chinese documentation 2026-02-18 16:03:42 +08:00
sanbuphy d0afb042b8 feat(computer-fundamentals): add comprehensive content for computer fundamentals section
Add detailed documentation and interactive demos for computer fundamentals topics including:
- Transistor to CPU architecture
- Data encoding, storage and transmission
- Operating system concepts (processes, memory, filesystems)
- Programming language overview and paradigms
- Algorithm and data structure basics

Includes Vue component demos for key concepts with visualizations and interactive elements to enhance learning experience. All content is written in Chinese with markdown formatting and embedded components.

The commit also updates the sidebar navigation and adds new Vue components for interactive demonstrations of key computer science concepts.
2026-02-18 15:52:55 +08:00