# electronics-101 **Repository Path**: lsy_admin/electronics-101 ## Basic Information - **Project Name**: electronics-101 - **Description**: No description available - **Primary Language**: HTML - **License**: Not specified - **Default Branch**: master - **Homepage**: None - **GVP Project**: No ## Statistics - **Stars**: 0 - **Forks**: 0 - **Created**: 2026-11-12 - **Last Updated**: 2026-11-12 ## Categories & Tags **Categories**: Uncategorized **Tags**: None ## README # Electronics 101 · 交互式 3D 电子学课程(本地复刻版) > 文档语言:[English](Readme_en.md) · [简体中文](Readme_zh.md) · [默认中文版](Readme.md) 原站:[electronics-101-six.vercel.app](https://electronics-101-six.vercel.app/)(作者 [Dilum Sanjaya](https://x.com/DilumSanjaya))。 本目录是原站 Vite + three.js 构建产物的**完整本地副本**,可完全离线运行;另外增加了两项能力:**中英双语一键切换** 与 **左侧「全部课程」目录**。原站的 JS / CSS 构建产物一个字节都没有改动,所有增强都以独立文件叠加。 --- ## 运行动图 [![Electronics 101 运行动图](docs/demo.gif)](docs/demo.gif) > 约 10 秒循环播放,全部为真实页面录制:英文首页 → 一键切换简体中文 → 打开全部课程(7 章 / 48 课)→ 搜索「电阻」→ 按章节滚动 → 点击课程无刷新跳转 → 3D 场景与信息面板同步更新 → 一键切回英文。 > 若浏览器未播放 GIF,可查看 [静态首帧](docs/screenshot-demo.png)。 ## 运行截图 ### 桌面端 · 英文 / 中文 | 英文首页 | 中文首页 | | :---: | :---: | | [![英文首页](docs/screenshot-en.png)](docs/screenshot-en.png) | [![中文首页](docs/screenshot-zh.png)](docs/screenshot-zh.png) | 顶部品牌区与进度卡之间的 `EN | 中文 | ···` 为新增的双语切换控件;点击图片可查看 1440 × 900 原图。 ### 全部课程目录 | 中文目录 | 英文目录 | | :---: | :---: | | [![中文目录](docs/screenshot-catalog-zh.png)](docs/screenshot-catalog-zh.png) | [![英文目录](docs/screenshot-catalog-en.png)](docs/screenshot-catalog-en.png) | [![侧栏展开后的章节索引](docs/screenshot-sidebar.png)](docs/screenshot-sidebar.png) ### 移动端(390 × 844) | 首页入口 | 课程目录 | | :---: | :---: | | [![移动端首页](docs/screenshot-mobile.png)](docs/screenshot-mobile.png) | [![移动端课程目录](docs/screenshot-mobile-catalog.png)](docs/screenshot-mobile-catalog.png) | --- ## 快速开始 ```bash cd electronics-101 python serve.py ``` 打开终端打印的地址,默认是 **http://127.0.0.1:8090/**。 ```bash python serve.py 9000 # 指定起始端口(被占用时自动往后找空闲端口) ``` - 只需要 Python 3.8+,**无第三方依赖**,也**不需要联网**(字体、语言包、three.js 全部本地化) - 必须通过 HTTP 打开,**不要直接双击 `index.html`**:ES module 在 `file://` 下会被浏览器拦截 - 刷新任意课程链接(如 `/resistor?lang=zh`)也能正常显示,服务器带 SPA 路由回退 ## 中英双语 | 版本 | 直达链接 | | --- | --- | | 英文 | `http://127.0.0.1:8090/?lang=en` | | 简体中文 | `http://127.0.0.1:8090/?lang=zh` | | 指定课程 + 语言 | `http://127.0.0.1:8090/resistor?lang=zh` | 页面顶部的 **`EN | 中文 | ···`** 控件: - 点击即时切换,3D 场景、课程名、信息面板、图表标签、页面标题全部跟随,**不重载页面** - 选择写入原站的 `localStorage`,下次打开自动保持;`` 也会正确声明 - `···` 打开原站完整语言面板,共 **20 种语言**(英文 + 19 个语言包,含繁体中文、日、韩、阿拉伯语、希伯来语等) - 切换复用原站自带 i18n 引擎与译文(简体中文包 1745 条),**没有手写任何译文**;课程名与章节名同样自动翻译 ## 全部课程目录 原站侧栏的 Lessons 面板只显示**当前章节**。左侧新增的列表按钮(带 `48` 徽标)打开完整目录: - 7 个章节 / 48 节课全部列出,当前课高亮、已完成课打勾 - 内置搜索,中英文都能搜(如「电阻」或 `resistor`),分组标题吸顶 - 侧栏展开后下方还有 7 个章节索引,点击直接滚动到对应分组 - 点击任意课程**无刷新跳转**,包括跨章节;复用原站课程选择器,3D 场景、进度与信息面板同步更新 - 移动端入口在右上角;打开抽屉时语言控件自动避让,5 个底部导航图标保持可见 ## 3D 交互 | 操作 | 效果 | | --- | --- | | 点击 3D 刀开关 | 电路闭合 / 断开,灯泡亮灭、电流读数(300 mA)随之变化 | | 拖拽 / `W A S D` | 平移视角 | | `Q` / `E` | 旋转视角 | | 滚轮 | 缩放 | | 信息面板标签 | 概览 / 元件 / 电路 / 计算(中文)· Overview / Components / Circuit / Math(英文) | | 电路图按钮 | 放大电路示意图 | ## 目录结构 ``` electronics-101/ ├── Readme.md Readme_en.md Readme_zh.md # 本文档的多语言版本 ├── docs/ # 运行截图 + demo.gif 运行动图 ├── index.html # 入口(保留原站全部 DOM 结构) ├── serve.py # 本地静态服务器 + SPA 回退 ├── favicon.svg site.webmanifest og-image.jpg └── assets/ ├── index.css # 原站样式(63 KB) ├── index-ygiyd4oC.js # 主模块(294 KB) ├── three-*.js / scenes-*.js / ... # 7 个功能分包(含完整 three.js 584 KB) ├── zh-*.js / fr-*.js / ... # 19 个语言包 ├── fonts/ # 9 个 woff2 字体(已本地化) ├── lang-switch.css / .js # 新增:中英一键切换 ├── all-lessons.css / .js # 新增:全部课程目录 └── catalog-data.js # 新增:从原站课程表生成的目录数据 ``` 共 **59 个文件 / 约 15 MB**(其中 `docs/` 截图与动图约 9.6 MB;站点本体约 5.4 MB)。 ## 实现原则 1. **不碰原站产物**:`index-ygiyd4oC.js`、`index.css` 及各分包保持原样,新增能力通过 `index.html` 引入独立文件实现 2. **不重复造轮子**:语言切换驱动原站语言面板,课程目录复用原站课程选择器与翻译字典 3. **数据来自源码**:`catalog-data.js` 由原站课程表与语言包映射自动生成(7 章 / 48 课 / 20 语言) 4. **离线优先**:字体、语言包、three.js 全部本地,运行时无外部 CDN 请求 ## 排错 | 现象 | 原因 | 处理 | | --- | --- | --- | | 页面卡在加载 / `/assets/*` 404 | 端口被其他程序占用(本机 8080 常被 vnpy 交易终端占用) | `serve.py` 默认 8090,并会在 8090–8114 内自动跳到空闲端口;以终端打印的地址为准,或 `python serve.py 9000` | | 直接打开 `index.html` 一片空白 | `file://` 下 ES module 被浏览器 CORS 策略拦截 | 用 `python serve.py` 通过 HTTP 访问 | | 字体加载报 `ERR_CONNECTION_REFUSED` | 单线程服务器在 9 个字体并发时拒连 | `serve.py` 已改为 `ThreadingTCPServer`(队列 128) | | 刷新 `/resistor` 变成 404 | 普通静态服务器不认识 SPA 路由 | `serve.py` 已做 `index.html` 回退,请勿替换为 `python -m http.server` | | 想恢复英文界面 | 语言记忆写在 `localStorage` | 点击 `EN` 或访问 `?lang=en`;无痕窗口不会保留记忆 | | 3D 画面空白 / 很慢 | 浏览器禁用 WebGL 或硬件加速 | 换用支持 WebGL 的浏览器并开启硬件加速 | > 无头 Chrome 自动化测试中用合成 `PointerEvent` 点击 3D 画布会触发 `setPointerCapture` 的 `NotFoundError`,这是没有真实活动指针的测试环境限制,真实鼠标操作不会报错。 ## 验证 无头 Chrome 全流程回归:**0 异常 / 0 资源失败**。覆盖中英往返、深链直达、完整语言面板、课程目录 48 课渲染与搜索、同章节与跨章节无刷新跳转、3D 开关通断、桌面 1440 × 900 与移动端 390 × 844 布局。所有 JS 通过 `node --check` 语法校验。 ## 致谢 原站设计、3D 模型与课程内容版权归 [Dilum Sanjaya](https://x.com/DilumSanjaya) 所有。本项目仅为本地学习与研究用途的复刻副本,请保留原站中的作者署名与链接。