chore: 安全升级并完善 CI/测试
- 升级 js-yaml 修复生产依赖漏洞 - 新增 CI:lint/test/build - 增加书签处理单测与可测性导出"- 生成器补充 config/user 缺失提示 - 增加 lint/format/check 脚本与 Prettier 配置 - 统一行尾策略并支持书签确定性输出"
This commit is contained in:
22
README.md
22
README.md
@@ -265,6 +265,10 @@ npm install
|
||||
```bash
|
||||
npm run import-bookmarks
|
||||
```
|
||||
- 若希望生成结果保持确定性(便于版本管理,减少时间戳导致的无意义 diff):
|
||||
```bash
|
||||
MENAV_BOOKMARKS_DETERMINISTIC=1 npm run import-bookmarks
|
||||
```
|
||||
- 系统会自动将书签转换为配置文件保存到`config/user/pages/bookmarks.yml`
|
||||
- **注意**:`npm run dev`命令不会自动处理书签文件,必须先手动运行上述命令
|
||||
|
||||
@@ -281,6 +285,19 @@ npm run build
|
||||
|
||||
构建后的文件位于`dist`目录
|
||||
|
||||
6. 提交前检查(推荐)
|
||||
|
||||
```bash
|
||||
# 一键检查(语法检查 + 单元测试 + 构建)
|
||||
npm run check
|
||||
```
|
||||
|
||||
(可选)格式化代码:
|
||||
|
||||
```bash
|
||||
npm run format
|
||||
```
|
||||
|
||||
</details>
|
||||
|
||||
## 部署方式
|
||||
@@ -413,7 +430,8 @@ MeNav使用模块化配置方式,将配置分散到多个文件中,更易于
|
||||
* **创建配置目录**:
|
||||
- 在`config/user/`目录下创建您的自定义配置文件
|
||||
- 可以参考项目结构中的`config/_default/`目录结构
|
||||
- 至少需要创建`site.yml`
|
||||
- 至少需要创建`site.yml`(缺失时构建会直接报错退出,避免生成空白站点)
|
||||
- 首次使用建议先完整复制 `config/_default/` 到 `config/user/`,再按需修改(因为配置采用“完全替换”策略,不会从默认配置补齐缺失项)
|
||||
|
||||
### 配置详解
|
||||
|
||||
@@ -745,6 +763,8 @@ MeNav支持从浏览器导入书签,快速批量添加网站链接,无需手
|
||||
|
||||
</details>
|
||||
|
||||
> 💡 *版本管理建议*:若你希望每次导入书签生成的 `bookmarks.yml` 内容保持确定性(避免因时间戳导致的无意义 diff),可在运行导入时设置环境变量:`MENAV_BOOKMARKS_DETERMINISTIC=1`。
|
||||
|
||||
> 生成的配置可在`config/user/pages/bookmarks.yml`中查看和编辑
|
||||
|
||||
## 常见问题
|
||||
|
||||
Reference in New Issue
Block a user