dsh-plugin-t-expert 0.4.51 → 0.4.53

package/CHANGELOG.md

@@ -16,6 +16,62 @@
 > 发布时**不要再跑 `npm version`**（那会把已提交好的版本又升一级，发出去的号与 CHANGELOG、tag 就对不上），
 > 只补一个 annotated tag（`git tag -a`，因为 `git push --follow-tags` 只推带注释的 tag）。
 
+## [0.4.53] — 未发布
+
+**面板与 @ 弹窗显示专家头像** —— 0.4.52 只做到数据链路，这一版接上最后一环。
+
+### 做法
+
+- **host**：`lib/index.js` 的 catalog 服务加 `avatars()` —— 扫本地各专家包的
+  `avatars/avatar.webp`，返回 `{ slug: dataUrl }`。**只含已下载过资源的专家**（没下载的本地
+  根本没这个文件，自然不在返回里），这正是「没下载过显示默认头像」的落地方式。
+- **remote**：`lib/remote.js` 加 `getAvatars` 描述符 + 转发方法，**并加进 `exposeRemoteMethods`
+  的装饰清单** —— 漏这一步 `remoteMethods()` 就扫不到它，verify 的「方法与描述符一一对应」会直接拦下。
+- **客户端**：`src/client/remote.js` 加配对的 direct 声明；`settings.jsx`（面板卡片）与
+  `summon.jsx`（@ 弹窗）各取一次头像 map，**有头像渲染 `<img>`、否则回退原来的 emoji / 分区图标**；
+  `css.js` 给两个头像圆各加 `img{width:100%;height:100%;border-radius:50%;object-fit:cover}`。
+- **代价**：只返回本地已有的那些，未下载过资源的专家不产生任何数据传输，列表加载不受影响。
+
+### 自检
+
+546/546（「卡片头像」那条断言已更新以反映新渲染）。
+
+
+
+**专家头像：从 WorkBuddy 取回、压成 128px WEBP，随资源包按需下发（不进 npm 包）。**
+
+### 背景
+
+WorkBuddy 的头像在**拉取阶段**就被丢弃了（`workbuddy-expert-fetch` 默认不保存头像，省 315 MB），
+面板此前只有 emoji。现在按用户口径加回来：**没下载过的专家显示默认（emoji），下载过的显示真实头像**。
+
+### 做法
+
+- **拉取**：`--only <281 位> --with-avatars --force`，只拉现役专家，已删的不拉。
+- **压缩**：新增 `tools/import-avatars.py` —— 取 `plugin.json` 的 `avatar` 字段指定的**主头像**，
+  压成 **128px WEBP**，统一命名为 `avatars/avatar.webp`，**原图一概不留**。
+  实测原图是 1024² PNG、约 200 KB～1.5 MB，压后 **3.4 KB/张**，281 位合计 **0.94 MB**。
+- **上云**（`pack-assets.mjs` 两处）：
+  ① `avatars` 列入**强制上云** —— 它只有 5 KB、远低于 50 KB 阈值，否则会被塞进 npm 包；
+  ② 附件本来就小（≤ 阈值）但含头像的包，**tar.gz 只装 avatars**，其余（skills 等）继续随 npm 包
+     发布、立即可用 —— 不因为一张头像就把整个包挪上云端。
+- **运行时**：`ASSET_DIRS` 加 `avatars`；解包逻辑不用改（它按 roster 的 `dirs` 走）。
+
+### 自检
+
+roster **181 → 289 条**（105 个「只装头像」的小包 + 若干含头像的大包），云端 174 MB；546/546。
+抽验 `marketing/seo-content-team` 的 sha256 与 OBS 元数据一致 ✓。
+
+### 遗留
+
+面板显示头像还差**客户端与 host 那一层**：浏览器读不到本地文件，需要 host 提供读取接口。
+
+### 教训
+
+本轮**又踩了一次「别单独手跑 `pack-assets.mjs`」** —— 附件早已 prune，它按「本地还能打包的包」
+重算，把 181 条 roster 清成了 281 条纯头像条目。靠 `git checkout -- data/roster.json` 恢复，
+再用 `assets.mjs fetch --all` 把附件拉回本地，才重新打对。
+
 ## [0.4.51] — 未发布
 
 **`upload-obs.mjs` 新增 `--delete-orphans`：清理删过专家后留在桶里的孤儿对象。**