Commit Graph

484 Commits

Author SHA1 Message Date
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
Sanbu 8e558ac943 Merge pull request #36 from yli000/feat/sidebar-collapse
feat: 添加目录栏收起/展开功能
2026-02-22 11:25:26 +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 00702fbd10 Merge branch 'dev' 2026-02-20 01:32:13 +08:00
sanbuphy 648ac343f6 feat: enhance pre-commit hook with build verification
Updated pre-commit hook to:
- Only check ESLint errors (ignore warnings)
- Add build verification before committing
- Fail commit if build fails
- Provide helpful error messages and skip instructions

This ensures:
 No ESLint errors enter the codebase
 All commits can build successfully
 Fast feedback loop (~20s for build)

To skip: git commit --no-verify

Co-Authored-By: Claude Sonnet 4.5 <noreply@anthropic.com>
2026-02-20 01:31:18 +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
sanbuphy 47377646df feat(docs): enhance JavaScript runtime and browser-as-os content
refactor(demos): improve variable box, scope, and type annotation demos
style(demos): update visual styles and animations for better UX
docs(browser-as-os): restructure content with tables and practical examples
feat(demos): add new TypeScript and runtime environment demos
2026-02-17 01:39:59 +08:00
Sanbu 35972e43d7 Merge pull request #34 from GeoDaoyu/docs/title-md-format
fix: 修复标题#与序号顺序错误
2026-02-16 21:13:37 +08:00
Sanbu d1ace4f65a Merge pull request #33 from GeoDaoyu/docs/title-space
docs: 修复标题的空格间隔
2026-02-16 21:13:26 +08:00
GeoDaoyu 8e9093209e fix: 修复标题#与序号顺序错误 2026-02-16 09:21:33 +08:00
GeoDaoyu 990adeaffa docs: 修复标题的空格间隔 2026-02-16 09:11:28 +08:00
sanbuphy 9ee3312569 feat(docs): add JavaScript intro demos and update content structure
refactor(docs): rename "ClaudeCode" to "Claude Code" across all language versions

chore: add ESLint configuration and update build scripts

style: update component organization and remove unused imports
2026-02-15 18:15:42 +08:00
Sanbu 60b023f26d Merge pull request #32 from GeoDaoyu/docs/error-md-lang
docs: fix error markdown lang
2026-02-15 17:55:28 +08:00
sanbuphy 9c1a395962 feat(docs): add JavaScript introduction components and content 2026-02-15 16:23:15 +08:00
GeoDaoyu e822721dec docs: fix error markdown lang 2026-02-15 09:24:02 +08:00
sanbuphy 4732d48777 feat(docs): add IDE basics guide and restructure development tools section
- Add comprehensive IDE basics documentation with interactive demos
- Move prompt engineering content to artificial-intelligence section
- Create new IDE basics page under development-tools section
- Update sidebar config to reflect new structure
2026-02-15 02:08:12 +08:00
sanbuphy 07d82d046b feat(docs): restructure appendix content into organized directories
- Move standalone AI-related files into 8-artificial-intelligence directory
- Move development tools content into 2-development-tools directory
- Move server/backend content into 4-server-and-backend directory
- Create new index files for each section
- Update .gitignore to exclude old backup directories
- Update theme imports for new component locations
2026-02-15 01:57:52 +08:00
sanbuphy 004496f1d5 fix: 修复侧边栏点击后不自动滚动定位的问题
- 在 onMounted 中调用 initOutlineAutoScroll 初始化函数
- 添加 VPSidebar 选择器支持,修正 VitePress 侧边栏类名
- 修正激活状态类名为 is-active(VitePress 使用)
- 新增 scrollSidebarToActiveItem 函数实现侧边栏自动滚动
- 点击侧边栏链接后自动将激活项平滑滚动到可视区域中心
2026-02-15 01:56:48 +08:00
sanbuphy 73269958b2 docs(web-basics): add sections for remembering HTML tags and CSS properties
Add comprehensive guides for beginners to remember HTML tags and CSS properties by categorizing them and providing mnemonic techniques. Include practical tips for looking up unfamiliar elements and properties.
2026-02-14 23:09:58 +08:00