本文为环境搭建记录，配置以官方文档为准：gethomepage.dev

家里或实验室里 NAS、路由、监控、常用网页越来越多，浏览器书签和各个管理后台来回切换很费时间。GetHomepage 是一个可自托管的仪表盘：把服务卡片、Docker 状态、书签和小部件集中在一页，刷新浏览器就能总览。

本文将按顺序说明：

• 用 Docker Compose 拉起容器（端口、环境变量、权限）
• config 目录里各配置文件的分工
• settings.yaml 主题、语言与背景
• （可选）挂载本地图片 / 图标目录（不要挂载整个 /app/public）
• services.yaml 分组与卡片的最小可用写法
• bookmarks.yaml / widgets.yaml 各自管什么（仅作入门，细节见官网）
• （可选）挂载 docker.sock 做 Docker 集成（见官方 Docker 安装页）

概念

本质上，webpack 是一个用于现代 JavaScript 应用程序的 静态模块打包工具。当 webpack 处理应用程序时，它会在内部从一个或多个入口点构建一个依赖图，然后将你项目中所需的每一个模块组合成一个或多个 bundles，它们均为静态资源，用于展示你的内容。

本文章为学习时通过AI总结，仅供参考

背景

在一个中后台项目中，我们遇到了一个典型但长期被低估的问题：

• Swagger 文档先于页面设计完成
• 页面实际需要的数据结构与现有接口不一致
• 错误码基本等同于 HTTP Status，语义不足
• 前端页面中大量 if (res.code !== 0) + toast(res.message)

结果是：

• 前后端对接口结构理解不一致
• Mock 与真实接口行为不一致
• 错误提示不可控，难以国际化
• 后续维护成本持续升高

我们最终决定 重构接口契约的生产流程，而不是继续修补页面代码。

本文章为学习时通过AI总结，仅供参考

为什么要重新理解 MSW

在很多项目里，MSW 被当成了：

• 一个 mock 数据工具
• 一个本地调试的临时方案
• 一个替代 mock.js 的库

但在实际工程中，如果这样使用 MSW，价值会非常有限，甚至会制造新的混乱。

我们最终达成的共识是：

MSW 不是用来“造假数据”的，而是用来“定义接口行为”的。

在日常前端开发中，我们经常需要为不同项目使用不同版本的 Node.js。

例如：

• 老项目需要 Node 14/16
• 新项目需要 Node 18/20
• 一些工具链只能运行在特定版本上

为了避免每次手动 nvm use，我们可以实现 进入项目目录时自动切换到正确的 Node 版本 。

本文将分别讲解：

• macOS 自动切换 Node（nvm + zsh hook）

• Windows 自动切换 Node（nvm-windows、fnm、Volta 三种方法）

• .nvmrc 的正确用法

为什么需要模块化

当前端工程到达一定规模后，就会出现下面的问题：

• 全局变量污染：多个文件中定义的全局变量容易冲突
• 依赖混乱：多个文件之间的依赖关系复杂，难以维护

使用Canvas进行2D绘制，需要使用Canvas的上下文对象，上下文对象提供了一些方法（API）来绘制图形。
我们不仅可以通过Canvas绘制图形，还可以通过Canvas绘制动画。

实现效果

如何在Home下添加如图所示短横线

JavaScript是非常灵活的一门编程语言，但是这种灵活是把双刃剑，一方面使得JavaScript蓬勃发展，无所不能；另一方面也使它的代码质量参差不齐，维护成本高，运行时错误多。

TypeScript是具有类型的JavaScript，在很大程度上弥补了它的缺点。

快速入门

本文章于 2023 年学习时记录，无法保证准确性

用例编写

unittest 是 Python 自带的一个单元测试框架

此外，unittest 还支持自动化测试的接口测试、UI 测试。