# labs_theme

**Repository Path**: qpchen888/labs_theme

## Basic Information

- **Project Name**: labs_theme
- **Description**: Frappe、ERPNext主题，来自https://github.com/mohsinalimat/labs_theme
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: V16
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 5
- **Forks**: 27
- **Created**: 2024-01-07
- **Last Updated**: 2026-07-10

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# labs

Fork from https://github.com/mohsinalimat/labs_theme

- 升级到16版，已经修复的问题：
- 快捷方式卡片颜色优化
- 报表/子表隔行变色
- 列表界面斑马纹 + 悬停效果
- 列表最右侧列参与斑马纹
- 报表字体大小调整
- 搜索弹窗输入框白字白底问题
- 列表界面列宽拖动功能
- 列表界面总计行跟随
- 深色主题支持
- 更多细节优化

## 安装

```bash
bench get-app https://gitee.com/qpchen888/labs_theme.git
bench --site mysite install-app labs_theme
```

将 `mysite` 替换为实际站点名。

## 提交前门禁

仓库不依赖第三方 Node 包。Node 18 及以上版本可直接运行：

```bash
npm test
npm run check:assets
npm run gate
```

`npm run gate` 会运行全部 Node 内置测试。`scripts/check-assets.js` 通过 `scripts/export-hook-assets.py` 实际导入 `labs_theme.hooks`，再检查运行时 URL 的本地路径、共享 `labs_theme.__version__` 和 CSS 固定加载顺序；它不通过解析源码推测 helper 输出。CI 必须提供 `python`，Windows 也可使用 `py -3`。

Desk 样式按固定级联顺序拆为 `tokens.css`、`base.css`、`chrome.css`、`list.css`、`report.css`、`grid.css`、`form.css`、`overlays.css`、`dark.css`、`responsive.css`。这些文件由 `hooks.py` 直接加载，不使用 `@import`。`tests/css_modules.test.js` 负责模块边界、顺序和重复规则检查；`tests/fixtures/css-rule-manifest.json` 则固定当前 481 条规则的模块、选择器、声明和顺序，删除任意规则都会使测试失败。

有意修改 CSS 规则后，先审查差异，再显式更新 manifest：

```bash
node scripts/css-rule-manifest.js --write
npm test
```

## 更新与部署检查

1. 部署前记录当前应用版本和可回滚的已验证版本，确认工作区没有未提交修改。
2. 拉取目标版本后运行提交前门禁：

   ```bash
   npm run gate
   ```

3. 在 bench 根目录重建应用资源并清缓存：

   ```bash
   bench build --app labs_theme
   bench --site mysite clear-cache
   ```

4. 如果生产环境的 web、socketio 或 worker 进程不会自动重新加载新资源，按现有进程管理方式 reload；无法 reload 时再执行：

   ```bash
   bench restart
   ```

5. 浏览器执行硬刷新（Windows/Linux: `Ctrl+F5`，macOS: `Cmd+Shift+R`），确认十个 Desk CSS 模块和脚本均带有与 `labs_theme.__version__` 一致的版本参数。
6. 冒烟检查：
   - Desk 首页和普通表单可打开，无控制台错误。
   - 列表列宽可拖拽，总计行与表头对齐。
   - 查询报表在有、无横向滚动时均无断线或多余留白。
   - 子表弹层可操作，浅色和深色主题均可读。
7. 按 [浏览器手工回归清单](docs/browser-regression-checklist.md) 完成四种视口验证。

### 回滚

恢复部署前记录的已验证应用版本或发布制品，然后重新执行 `bench build --app labs_theme`、站点 `clear-cache` 和必要的 web 进程 reload/restart。硬刷新后重复冒烟检查。不要通过覆盖本地未提交修改来回滚。

## 卸载

```bash
bench --site mysite uninstall-app labs_theme
```

## License

MIT