@h5l0/codelens 0.1.3 → 0.1.4

package/README.md

@@ -23,7 +23,7 @@ npm install -g @h5l0/codelens
 codelens
 ```
 
-No configuration is needed. The tool collects the data at startup and serves it to the local browser only. It does not write to the analyzed repository.
+No configuration is needed. codelens collects the data at startup and writes nothing to disk by default.
 
 ## The two views
 
@@ -44,14 +44,14 @@ A treemap: each rectangle's area is its line count, its color is the category, a
 ```
 codelens [directory] [options]
 
---profile <name|file>  Profile, see below; built in: all, web
+--profile <name|file>  Profile, see below. Built in: all, web
 --config <file>        Config file, defaults to <directory>/codelens.config.json
 --days <days>          Calendar time span, 0 means full history (default 120)
 --exclude <glob>       Extra paths to ignore, repeatable
 --port <port>          Listen port, default 5178, tries the next ports when busy
---host <address>       Listen address, default 127.0.0.1; other addresses expose the page to your network
+--host <address>       Listen address, default 127.0.0.1. Other addresses expose the page to your network
 --no-open              Do not open the browser automatically
---no-gitignore         Ignore .gitignore; only built-in heavy directories are skipped
+--no-gitignore         Do not filter by .gitignore. Only the built-in dependency and build directories are skipped
 --dump <dir>           Write data.json and loc.json, then exit without starting a server
 --dev                  Dev mode with Vite hot reload
 -h, --help             Show help
@@ -60,77 +60,86 @@ codelens [directory] [options]
 
 ## Profiles
 
-`--profile` sets how the tool splits the repository:
+A profile controls how codelens divides the repository. The calendar colors commits by **group** (`groups`). The treemap colors files by **category** (`categories`).
 
-1. Point it at a JSON file: `--profile ./my-profile.json`;
-2. Or use a name under `profiles` in `codelens.config.json`. Use `--config` to move that file: `--profile web`.
+`--profile` takes a file or a profile name:
 
-Two profiles are built in:
+```bash
+codelens --profile ./my-profile.json   # use this file as the profile
+codelens --profile web                 # use the web profile from the config
+```
+
+Two profiles come with codelens:
+
+| Name    | Shown in the page as   | What it does                                                                                      |
+| ------- | ---------------------- | ------------------------------------------------------------------------------------------------- |
+| `all`   | All                    | The default profile. It has no groups and counts the whole repository.                            |
+| `web`   | Frontend / backend     | Directories such as `frontend/`, `web/`, `client/` and `ui/` are frontend. The rest is backend.   |
 
-| Name | What it does |
-| --- | --- |
-| `all` | Default; no groups, the tool counts the whole repository together |
-| `web` | `frontend/`, `web/`, `client/`, `ui/` and similar directories count as frontend, everything else as backend |
+### Config
 
-### Config file format
+The config controls the default behavior of codelens and holds a list of profiles. codelens loads `codelens.config.json` from the workspace root by default. Use `--config` to point at another file.
 
 ```jsonc
 {
-  "profiles": {
-    "modules": {
-      "label": "By module",
-      // Calendar groups: a file goes to the first group whose patterns match.
-      // End the list with ["**"] to get an "A / everything else" split.
-      "groups": [
+  "profiles": [
+    {
+      "id": "modules",
+      "label": "By module",                      // shown in the startup log
+      "groups": [                                 // calendar colors, first match wins
         { "id": "core", "label": "Core", "hue": 214, "sat": 58, "match": ["src/core/**"] },
         { "id": "web", "label": "UI", "hue": 152, "sat": 46, "match": ["src/web/**"] },
-        { "id": "other", "label": "Other", "hue": 32, "sat": 62, "match": ["**"] }
+        { "id": "rest", "label": "Rest", "hue": 32, "sat": 62, "match": ["**"] }
       ],
-      // Line-count categories: drive the legend and colors; the entry without a match is the fallback.
-      "categories": [
+      "categories": [                             // treemap colors and the legend
         { "id": "core", "label": "Core code", "hue": 214, "sat": 58, "match": ["src/core/**"] },
         { "id": "test", "label": "Tests", "hue": 152, "sat": 46, "defaultOn": false, "match": ["**/*.test.ts"] },
         { "id": "app", "label": "Other code", "hue": 220, "sat": 20 }
       ],
-      // Extra paths to ignore on top of .gitignore
-      "ignore": ["data/**", "**/*.snap"]
-    }
-  }
+      "ignore": ["data/**", "**/*.snap"]          // extra paths to skip
+    },
+  ]
 }
 ```
 
-Field notes:
-
-- `groups[].match`, `categories[].match` and `ignore` use globs relative to the repository root: `**` crosses directories, `*` does not, `?` matches one character, and `{a,b}` matches either. A pattern without `/` matches items of that name at any depth. `/foo` is anchored to the root. `foo/` means the directory and everything inside it.
-- The config file accepts `//` and `/* */` comments and trailing commas.
-- `groups[].id` must not be `all`, and it must be unique in one profile.
-- `hue` and `sat` are HSL color components for the group and category colors. The defaults are 214 and 50.
-- `categories[].defaultOn: false` means the category is off in the legend by default. Of the built-in categories, "generated code", "docs" and "config" are off by default.
-
-Without `categories`, the tool uses six built-in categories: application code, tests, scripts, docs, config and generated code.
-
-A profile name that the config file does not define falls back to the built-in profile. A repository with a `codelens.config.json` that defines only custom profiles still supports `codelens --profile all` and `--profile web`. A name that is missing from both places is an error.
+| Field                                           | Meaning                                                                                       |
+| ----------------------------------------------- | --------------------------------------------------------------------------------------------- |
+| `profiles[*].id`                                | The name of the profile. This is what `--profile` takes. It must be unique in one config.     |
+| `profiles[*].label`                             | The name shown in the startup log. Without it, codelens joins the group names.                |
+| `profiles[*].{groups/categories}[*].id`         | An identifier. It must be unique in its own list, and it must not be `all`.                   |
+| `profiles[*].{groups/categories}[*].label`      | The name shown in the page. Your own text is shown as written.                                |
+| `profiles[*].{groups/categories}[*].match`      | Path globs. An item joins the entry it matches. Required for groups, optional for categories. |
+| `profiles[*].{groups/categories}[*].hue`, `sat` | The color of the entry, in HSL. The defaults are 214 and 50.                                  |
+| `profiles[*].categories[*].defaultOn`           | Set it to `false` and the category is off in the legend at first. Readers can turn it on.     |
+| `profiles[*].ignore`                            | Extra paths to skip. It is merged with `--exclude`.                                           |
+
+Notes:
+
+- Glob paths are relative to the repository root. `**` crosses directories. `*` and `?` stay within one segment. `{a,b}` matches either one.
+- A pattern without `/` matches that name at any depth. `/foo` counts from the repository root. `foo/` means the directory and everything inside it.
+- The config accepts `//` and `/* */` comments and trailing commas.
+- Without `categories`, codelens uses six built-in ones. They are application code, tests, scripts, docs, config and generated code. Of these, "docs", "config" and "generated code" are off at first.
+- A profile name that the config does not define falls back to a built-in profile. If neither has the name, codelens reports an error.
 
 ## Counting rules
 
-- The tool honors `.gitignore` by default. If the directory is not a git repository, the tool applies equivalent ignore rules instead. `--no-gitignore` turns this off.
-- The tool always skips dependency and build directories, such as `node_modules`, `dist`, `build`, `coverage`, `.venv`, `__pycache__` and `target`.
-- `--exclude` and the config's `ignore` apply to both views. The tool does not count excluded directories, and the calendar does not show them.
-- The tool skips binary files, files larger than 3MB and empty files. If the tool cannot read a file, it skips that file and reports the count in the startup log. Line counts are physical lines; the newline at the end of a file does not count as one more line.
-- The calendar puts each commit in the day of its commit time (committer date). This matches the `--days` filter. "Changed lines" means insertions plus deletions.
-- Merge commits, empty commits and commits that only change file modes or binaries have no line counts. They still appear in the commit list and count as commits.
-- If you run the tool on a subdirectory of a repository, both views count that subdirectory only and resolve paths relative to it.
+- codelens filters by `.gitignore` by default. If the directory is not a git repository, codelens applies equal ignore rules. `--no-gitignore` turns the filter off.
+- codelens always skips dependency and build directories such as `node_modules`, `dist`, `build`, `coverage`, `.venv`, `__pycache__` and `target`.
+- `--exclude` and the config's `ignore` affect both views. An excluded directory has no line counts and does not appear in the calendar.
+- codelens skips binary files, files larger than 3MB and empty files. It skips a file it cannot read and reports the number in the startup log. Line counts are physical lines. The newline at the end of a file does not add a line.
+- The calendar puts each commit in the day of its commit time (committer date). `--days` filters by the same time. "Changed lines" means insertions plus deletions.
+- Merge commits, empty commits and commits that only change file modes or binaries have no line counts. They still appear in the commit list, and they count as commits.
+- When you run codelens on a subdirectory of a repository, both views count that subdirectory only and resolve paths relative to it.
 
 ## Known limits
 
-- The change calendar needs git. A repository without commits, or without git, leaves the calendar empty. The lines view still works.
+- The change calendar needs git. Without commits or without git, the calendar is empty. The lines view still works.
+- The treemap draws at most 6000 rectangles. It does not show the rest.
 - Line counts say nothing about code complexity.
-- The treemap draws at most 6000 rectangles. The rest are not shown.
-- The calendar is padded to whole weeks. A window that does not start or end on a week boundary shows a few extra days without data, with a paler background.
 
 ## Languages
 
-The page follows the browser language. Simplified Chinese, English, Japanese and Korean are built in. Other languages fall back to English. Append `?lang={langCode}` to the URL to override the language, for example `?lang=zh` or `?lang=ko`.
+The page follows the browser language. Simplified Chinese, English, Japanese and Korean are built in. English is the default. Append `?lang={langCode}` to the URL to override the language, for example `?lang=zh` or `?lang=ko`.
 
 ## Development
 

package/README.zh.md

@@ -23,7 +23,7 @@ npm install -g @h5l0/codelens
 codelens
 ```
 
-无需配置。数据在启动时生成，只提供给本机浏览器，不写入被统计的仓库。
+无需配置。启动时生成数据，默认不写入硬盘。
 
 ## 两个视图
 
@@ -44,93 +44,103 @@ codelens
 ```
 codelens [目录] [选项]
 
---profile <名称|文件>  配置档，见下节，内置 all、web
---config <文件>        配置文件，默认 <目录>/codelens.config.json
+--profile <名称|文件>  预设，见下节，内置 all、web
+--config <文件>        配置，默认 <目录>/codelens.config.json
 --days <天数>          日历时间跨度，0 表示全部历史（默认 120）
 --exclude <glob>       额外忽略的路径，可重复
 --port <端口>          监听端口，默认 5178，被占用时向后尝试
---host <地址>          监听地址，默认 127.0.0.1；监听其他地址时页面对同网段可见
+--host <地址>          监听地址，默认 127.0.0.1。监听其他地址时，页面对同网段可见
 --no-open              不自动打开浏览器
---no-gitignore         不按 .gitignore 过滤，只跳过内置的重目录
+--no-gitignore         不按 .gitignore 过滤，只跳过内置的依赖与构建目录
 --dump <目录>          只写出 data.json 与 loc.json 后退出，不启动服务
 --dev                  开发模式，用 Vite 托管前端源码并热更新
 -h, --help             显示帮助
 -v, --version          显示版本
 ```
 
-## 配置档
+## 预设（profile）
 
-`--profile` 决定切分仓库的维度：
+预设用于控制统计的划分方式。改动日历按**分组**（`groups`）给提交上色。行数视图按**分类**（`categories`）给文件上色。
 
-1. 指向 json 文件：`--profile ./my-profile.json`；
-2. 取 `codelens.config.json` 里 `profiles` 下的档名，位置可用 `--config` 改：`--profile web`。
+`--profile` 后面可以写文件，也可以写预设名：
 
-内置两档：
+```bash
+codelens --profile ./my-profile.json   # 用这个文件当预设
+codelens --profile web                 # 用配置里的 web 预设
+```
+
+codelens 自带两个预设：
 
-| 名称 | 作用 |
-| --- | --- |
-| `all` | 默认档，不分组，整个仓库一起统计 |
-| `web` | `frontend/`、`web/`、`client/`、`ui/` 等算前端，其余算后端 |
+| 名称    | 页面上显示为   | 作用                                                             |
+| ------- | -------------- | ---------------------------------------------------------------- |
+| `all`   | 全部           | 默认预设，不分组，统计整个仓库。                                 |
+| `web`   | 前后端         | `frontend/`、`web/`、`client/`、`ui/` 算前端。其余目录算后端。   |
 
-### 配置文件格式
+### 配置
+
+配置用于控制程序默认行为，可包含一组预设。
+默认加载工作区根目录的配置文件：`codelens.config.json`，用 `--config` 可以指定别的文件。
 
 ```jsonc
 {
-  "profiles": {
-    "modules": {
-      "label": "按模块",
-      // 改动日历的分组：命中的文件算进该组，按数组顺序取第一个命中的。
-      // 最后一个用 ["**"] 兜底，就能得到「A / 其余」这种两分效果。
-      "groups": [
+  "profiles": [
+    {
+      "id": "modules",
+      "label": "按模块",                          // 显示在启动日志里
+      "groups": [                                 // 改动日历的分组配色，取第一个命中的
         { "id": "core", "label": "核心", "hue": 214, "sat": 58, "match": ["src/core/**"] },
         { "id": "web", "label": "界面", "hue": 152, "sat": 46, "match": ["src/web/**"] },
-        { "id": "other", "label": "其他", "hue": 32, "sat": 62, "match": ["**"] }
+        { "id": "rest", "label": "其余", "hue": 32, "sat": 62, "match": ["**"] }
       ],
-      // 行数视图的分类：决定图例与配色，省略 match 的那一项是兜底类。
-      "categories": [
+      "categories": [                             // 行数视图的分类配色与图例
         { "id": "core", "label": "核心代码", "hue": 214, "sat": 58, "match": ["src/core/**"] },
         { "id": "test", "label": "测试", "hue": 152, "sat": 46, "defaultOn": false, "match": ["**/*.test.ts"] },
         { "id": "app", "label": "其他代码", "hue": 220, "sat": 20 }
       ],
-      // 在 .gitignore 之外额外忽略的路径
-      "ignore": ["data/**", "**/*.snap"]
-    }
-  }
+      "ignore": ["data/**", "**/*.snap"]          // 额外跳过的路径
+    },
+  ]
 }
 ```
 
-字段说明：
-
-- `groups[].match`、`categories[].match`、`ignore` 使用仓库相对路径的 glob：`**` 跨目录，`*` 不跨目录，`?` 匹配单个字符，`{a,b}` 择一；不含 `/` 的模式匹配任意层级的同名项，`/foo` 从仓库根起算，`foo/` 表示目录及其全部内容。
-- 配置文件允许 `//`、`/* */` 注释与尾随逗号。
-- `groups[].id` 不能是保留的 `all`，同一档里不能重复。
-- `hue`、`sat` 是 HSL 颜色分量，用于分组色与分类色，缺省为 214、50。
-- `categories[].defaultOn` 为 `false` 表示该分类在页面图例里默认关闭；内置分类中「生成代码」「文档」「配置」默认关闭。
-
-不写 `categories` 时使用内置六类：应用代码、测试、脚本、文档、配置、生成代码。
-
-配置里没有的档名回退到内置档：仓库里放一份只定义自定义档的 `codelens.config.json`，`--profile all`、`--profile web` 依然可用。两边都没有的档名才报错。
+| 字段                                            | 作用                                                              |
+| ----------------------------------------------- | ----------------------------------------------------------------- |
+| `profiles[*].id`                                | 预设名，`--profile` 指定名称。同一份配置里不能重复。             |
+| `profiles[*].label`                             | 启动日志里显示的预设名。不写时用各分组名拼出来。                  |
+| `profiles[*].{groups/categories}[*].id`         | 标识。同一份列表里不能重复，也不能叫 `all`。                      |
+| `profiles[*].{groups/categories}[*].label`      | 页面上显示的名字。你写的名字会原样显示。                          |
+| `profiles[*].{groups/categories}[*].match`      | 路径 glob。文件命中哪一条，就归入那一项。分组必填，分类可以省略。 |
+| `profiles[*].{groups/categories}[*].hue`、`sat` | 这一项的颜色，用 HSL 表示。默认 214 和 50。                       |
+| `profiles[*].categories[*].defaultOn`           | 设为 `false` 时，这个分类在图例里默认关闭。读者可以自己打开。     |
+| `profiles[*].ignore`                            | 额外跳过的路径。它会和 `--exclude` 合并。                         |
+
+说明：
+
+- glob 的路径相对仓库根目录。`**` 跨目录。`*` 和 `?` 只在单段里匹配。`{a,b}` 表示任选一个。
+- 不含 `/` 的模式匹配任意层级的同名项。`/foo` 从仓库根算起。`foo/` 表示目录及其全部内容。
+- 配置里可以写 `//`、`/* */` 注释和尾随逗号。
+- 不写 `categories` 时，codelens 用内置的六类。它们是应用代码、测试、脚本、文档、配置、生成代码。其中「文档」「配置」「生成代码」默认关闭。
+- 配置里没有的预设名会回退到内置预设。两边都没有就报错。
 
 ## 统计规则
 
-- 默认遵守仓库的 `.gitignore`；目录不是 git 仓库时改用等价的忽略规则。`--no-gitignore` 关闭该过滤。
-- 始终跳过 `node_modules`、`dist`、`build`、`coverage`、`.venv`、`__pycache__`、`target` 等依赖与构建目录。
-- `--exclude` 与配置里的 `ignore` 对两个视图同时生效：被排除的目录既不统计行数，也不计入改动日历。
-- 二进制文件、超过 3MB 的文件、空文件不统计；读不出的文件只跳过它，并在启动日志里给出数量。行数为物理行数，文件末尾换行不计一行。
-- 改动日历按提交时间（committer date）归入所在天，与 `--days` 的过滤规则一致；改动行数 = 新增 + 删除。
-- 合并提交、空提交、只改权限或只动二进制的提交没有行数，但仍出现在提交列表里并计入提交数。
-- 对仓库的子目录运行时，两个视图都只统计该子目录，路径也相对它计算。
+- 默认按仓库的 `.gitignore` 过滤。目录不是 git 仓库时，codelens 改用等价的忽略规则。`--no-gitignore` 可以关掉这个过滤。
+- codelens 始终跳过 `node_modules`、`dist`、`build`、`coverage`、`.venv`、`__pycache__`、`target` 这类依赖和构建目录。
+- `--exclude` 和配置里的 `ignore` 对两个视图都生效。被排除的目录不统计行数，也不出现在改动日历里。
+- 二进制文件、超过 3MB 的文件、空文件都不统计。读不出的文件会被跳过，数量写在启动日志里。行数按物理行数算，文件末尾的换行不算一行。
+- 改动日历按提交时间（committer date）把提交放到当天。`--days` 用的是同一个时间。改动行数是新增行数加删除行数。
+- 合并提交、空提交、只改权限的提交、只改二进制的提交都没有行数。它们仍然出现在提交列表里，也计入提交数。
+- 在仓库的子目录里运行时，两个视图只统计这个子目录，路径也相对它计算。
 
 ## 已知限制
 
 - 改动日历依赖 git：没有提交或没有 git 时日历为空，行数视图仍可用。
-- 行数不代表代码复杂度。
 - 树形图一次最多绘制 6000 个方块，超出部分不显示。
-- 日历按整周补齐，窗口首尾不足一周时会多画出几天没有数据的格子（底色更白）。
+- 行数不代表代码复杂度。
 
 ## 多语言
 
-页面语言跟随浏览器，内置简体中文、English、日本語、한국어，其余回落到英文。地址后加 `?lang={langCode}` 可临时覆盖，例如 `?lang=en`。
+页面语言跟随浏览器，内置简体中文、English、日本語、한국어，默认英文。地址后加 `?lang={langCode}` 可临时覆盖，例如 `?lang=en`。
 
 ## 开发
 

package/dist/cli/index.js

@@ -102,19 +102,23 @@ async function main() {
     });
     console.log(`codelens ${version()}`);
     log('repo', root);
-    log('profile', `${profile.name} (${profile.label})${profile.configPath ? ` · ${profile.configPath}` : ''}`);
+    log('profile', `${profile.name} (${profile.label})`);
+    if (profile.configPath) {
+        log('config', profile.configPath);
+    }
     const loc = await readLoc(root, profile, args.useGitignore);
     const scanLabel = loc.scan.mode === 'git' ? 'git index, filtered by .gitignore' : 'directory walk';
-    log('files', `${f(loc.data.totals.files)} files · ${f(loc.data.totals.lines)} lines (${scanLabel})`);
+    log('files', `${f(loc.data.totals.files)} files, ${f(loc.data.totals.lines)} lines (${scanLabel})`);
     if (loc.data.skipped.unreadable > 0) {
         log('warn', `${f(loc.data.skipped.unreadable)} files could not be read and were skipped`);
     }
-    if (profile.groups.length > 0) {
-        log('groups', profile.groups.map((group) => `${group.label}=${group.match.join(' ')}`).join('  '));
-    }
+    // 分组一行一个，规则长了也不会挤成一条
+    profile.groups.forEach((group, index) => {
+        log(index === 0 ? 'groups' : '', `${group.label}=${group.match.join(' ')}`);
+    });
     const calendar = await readCalendar(root, profile, args.days);
     log('calendar', calendar.range.min
-        ? `${calendar.range.min} ~ ${calendar.range.max} · ${calendar.totals.days} days with commits`
+        ? `${calendar.range.min} ~ ${calendar.range.max} (${calendar.totals.days} days with commits)`
         : 'no commits in this range');
     if (args.dump) {
         const outDir = resolve(args.dump);

package/dist/core/profile.js

@@ -1,7 +1,8 @@
 // ---------------------------------------------------------------------------
-// 配置档
-// --profile 选择一份配置：内置的 all（不区分）与 web（常见前后端目录），
-// 或在 codelens.config.json（也可用 --profile 直接指向 json 文件）里自定义，
+// 预设
+// --profile 选择一份预设：内置的 all（不区分）与 web（常见前后端目录），
+// 或在配置 codelens.config.json（也可用 --profile 直接指向 json 文件）里自定义。
+// 配置的 profiles 是数组，每项带 id，它就是 --profile 后面写的名字。
 // 用 groups 划分前后端等分组，用 categories 划分模块与文件类别。
 // 内置项的 label 是英文，labelKey 供页面按语言覆盖；用户配置的 label 原样使用。
 // ---------------------------------------------------------------------------
@@ -78,9 +79,9 @@ export const DEFAULT_CATEGORIES = [
     { id: 'app', label: 'Application code', labelKey: 'category.app', hue: 214, sat: 58 },
 ];
 // ---------------------------------------------------------------------------
-// 内置配置档
+// 内置预设
 // ---------------------------------------------------------------------------
-/** 未配置的兜底档：不做任何分组，整个仓库一起统计。 */
+/** 未配置的兜底预设：不做任何分组，整个仓库一起统计。 */
 const PROFILE_ALL = { label: 'All', labelKey: 'profile.all' };
 /** 常见前后端目录布局：前端目录归前端，其余归后端。 */
 const PROFILE_WEB = {
@@ -208,6 +209,25 @@ function parseEntry(value, where) {
     }
     return entry;
 }
+function parseProfiles(value, where) {
+    if (value === undefined) {
+        return [];
+    }
+    if (!Array.isArray(value)) {
+        fail(where, 'must be an array');
+    }
+    const seen = new Set();
+    return value.map((item, i) => {
+        const at = `${where}[${i}]`;
+        const obj = asObject(item, at);
+        const id = asString(obj.id, `${at}.id`);
+        if (seen.has(id)) {
+            fail(where, `contain a duplicate id: ${id}`);
+        }
+        seen.add(id);
+        return { id, entry: parseEntry(obj, at) };
+    });
+}
 function readJson(path) {
     let text;
     try {
@@ -279,10 +299,23 @@ function stripJsonc(text) {
     }
     return out;
 }
+/** 同一份列表里的 id 必须唯一，也不能占用保留名。 */
+function checkIds(defs, where) {
+    const seen = new Set();
+    for (const def of defs) {
+        if (seen.has(def.id)) {
+            fail(where, `contain a duplicate id: ${def.id}`);
+        }
+        if (RESERVED_IDS.has(def.id)) {
+            fail(where, `must not use the reserved id: ${def.id}`);
+        }
+        seen.add(def.id);
+    }
+}
 /**
- * 按名字解析配置档：
- * 1. 名字指向 json 文件时直接当档用；
- * 2. 否则先找配置文件里的 profiles[名字]，再找内置档。
+ * 按名字解析预设：
+ * 1. 名字指向 json 文件时直接当预设用；
+ * 2. 否则先找配置的 profiles 里 id 同名的一项，再找内置预设。
  */
 export function loadProfile(opts) {
     const { root, name } = opts;
@@ -298,13 +331,14 @@ export function loadProfile(opts) {
     }
     else if (opts.configPath || exists(configPath)) {
         const file = asObject(readJson(configPath), configPath);
-        const profiles = file.profiles === undefined ? {} : asObject(file.profiles, `profiles of ${configPath}`);
-        if (hasOwn(profiles, name)) {
-            entry = parseEntry(profiles[name], `profiles.${name} of ${configPath}`);
+        const profiles = parseProfiles(file.profiles, `profiles of ${configPath}`);
+        const found = profiles.find((item) => item.id === name);
+        if (found) {
+            entry = found.entry;
             usedConfig = configPath;
         }
         else if (hasOwn(BUILTIN_PROFILES, name)) {
-            // 配置里没有这一档就回退内置档：仓库里放了一份自定义配置，
+            // 配置里没有这个预设就回退内置预设：仓库里放了一份自定义配置，
             // 不该让默认的 `codelens` / `--profile web` 直接跑不起来
             entry = BUILTIN_PROFILES[name];
         }
@@ -316,35 +350,24 @@ export function loadProfile(opts) {
         entry = BUILTIN_PROFILES[name];
     }
     else {
-        throw new Error(`no profile named ${name}; available: ${names(undefined, BUILTIN_PROFILES)}`);
+        throw new Error(`no profile named ${name}; available: ${names([], BUILTIN_PROFILES)}`);
     }
     const groups = entry.groups ?? [];
-    const ids = new Set();
-    for (const group of groups) {
-        if (ids.has(group.id)) {
-            fail(`groups of ${usedConfig ?? name}`, `contain a duplicate id: ${group.id}`);
-        }
-        if (RESERVED_IDS.has(group.id)) {
-            fail(`groups of ${usedConfig ?? name}`, `must not use the reserved id: ${group.id}`);
-        }
-        ids.add(group.id);
-    }
-    for (const category of entry.categories ?? []) {
-        if (RESERVED_IDS.has(category.id)) {
-            fail(`categories of ${usedConfig ?? name}`, `must not use the reserved id: ${category.id}`);
-        }
-    }
+    const categories = entry.categories ?? DEFAULT_CATEGORIES;
+    // 分组与分类各用一套 id：一个给日历配色，一个给树形图配色，两边重名不算冲突
+    checkIds(groups, `groups of ${usedConfig ?? name}`);
+    checkIds(categories, `categories of ${usedConfig ?? name}`);
     return {
         name,
         label: entry.label ?? (groups.length > 0 ? groups.map((group) => group.label).join(' / ') : 'All'),
         groups,
-        categories: entry.categories ?? DEFAULT_CATEGORIES,
+        categories,
         ignore: [...(entry.ignore ?? []), ...opts.exclude],
         configPath: usedConfig,
     };
 }
 function names(profiles, builtin) {
-    return [...Object.keys(profiles ?? {}), ...Object.keys(builtin)].join(', ');
+    return [...profiles.map((item) => item.id), ...Object.keys(builtin)].join(', ');
 }
 function isProfileFile(name) {
     return name.endsWith('.json') || name.includes('/') || name.includes('\\');
@@ -357,7 +380,7 @@ function exists(path) {
         return false;
     }
 }
-/** 供帮助信息使用：列出内置配置档。 */
+/** 供帮助信息使用：列出内置预设。 */
 export function builtinProfileNames() {
     return Object.keys(BUILTIN_PROFILES);
 }