dsh-crossterm 0.8.7 → 0.8.8

package/CHANGELOG.md

@@ -1,5 +1,19 @@
 # dsh-crossterm 变更记录
 
+## 0.8.8 — 2026-10-19
+
+### 「维护者」一栏只给维护端看
+
+- **问题**：0.8.5 加的「维护者」行任何设备装上插件都会显示负责人是谁，而这是维护端信息，
+  别的机器不需要看到。
+- **判断规则**：新增导出纯函数 `maintainerVisible(term, doc)` —— 本机 `nodeId` 必须命中
+  `MAINTAINERS.md` 机器可读注释里的 `current` 或 `assistant` 条目（负责人与助手同机时都算
+  「本机授权端」）；配置 `maintainerDevices`（`bus.js` DEFAULTS 新增，默认 `[]`）可额外放行设备。
+- **接口**：`GET /crossterm/api/about` 的 `maintainers` 增加 `visible`（布尔）与 `me`（本机 nodeId），
+  客户端据此决定渲不渲染该行；负责人换机器只改 `MAINTAINERS.md` 的 `current.nodeId`，不用改代码。
+- **测试**：`F:\dsh\001X\crossterm-work\probe-maintainer-visible.mjs` 15 项全过
+  （维护端可见、其他设备不可见、助手同机可见、显式授权可见、换机后本机隐藏、无文档/无 nodeId/cfg 为 null 等边界）。
+
 ## 0.8.7 — 2026-10-19
 
 ### 修 0.8.6 的回归：云端设备列表整个消失

package/README.md

@@ -28,19 +28,23 @@ A 终端看不到 B 终端里有哪个会话、在干什么，也没法把一条
 > `locatePkgJson()` 对子路径行返回 undefined），而插件页顶部标题与这一行共用同一份 `locale/zh.json` 的 meta，
 > 所以它单独做总开关，标题带「（总开关）」；卡片头用 `shortTitle` 显示短名「跨端互通」。
 
-**本版更新（0.8.7）**
+**本版更新（0.8.8）**
 
-- **修 0.8.6 的回归**：0.8.6 装上后卡片「云端设备」整块消失，接口报
-  `layout is not defined`（路由里把 `layout` 声明在 `try` 块内、块外又用了它）。
-  0.8.7 已修；本来就还没升 0.8.6 的设备可以直接装 0.8.7。
-- **合并逻辑变成可测的纯函数**：`mergeDevices({ old, fresh, selfId, ownerDevice })` 负责
-  「老总线镜像 + 新布局心跳」的合并、排除本机、补管理员/成员角色、按心跳倒序，
-  路由不再自己拼装，配套 20 项单测。
-- **离线时间排序口径统一**：`annotateDevices()` 把 `at → lastSeen → updatedAt` 归一成毫秒，
-  列表按它倒序，不会再把 ISO 字符串和毫秒时间戳混着比。
-- 纯展示与拼装修复，装上重启即可，不用改配置。
+- **「维护者」一栏只给维护端看**：以前任何设备装上插件都能看到负责人是谁；现在只在维护端显示 ——
+  本机 `nodeId` 必须出现在 `MAINTAINERS.md` 的负责人/助手条目里（两者在同一台机器上时都算），
+  或用配置 `maintainerDevices` 显式放行。其他设备上这行直接不渲染。
+- **换机器只改一个字段**：负责人换机器时，把 `MAINTAINERS.md` 里 `current.nodeId` 改成新机器，
+  旧机器下次刷新卡片自动隐藏，不用改代码。
+- 纯展示改动，装上重启即可，不用改配置。
 
-**上一版（0.8.6）**
+**上一版（0.8.7）**
+
+- **修 0.8.6 的回归**：0.8.6 装上后卡片「云端设备」整块消失（接口报 `layout is not defined`）；
+  0.8.7 已修，没升 0.8.6 的设备可直接装 0.8.7。
+- **合并逻辑变成可测的纯函数**：`mergeDevices({ old, fresh, selfId, ownerDevice })`，配套 20 项单测。
+- **离线时间排序口径统一**：`at → lastSeen → updatedAt` 先归一毫秒再排。
+
+**更早（0.8.6 / 0.8.5 / 0.8.2 / 0.8.0）**
 
 - **云端设备只列「别人」**：卡片里那行不再显示本机（自己已经在「当前终端」一栏），
   只列同一账号下的其他设备。
@@ -50,8 +54,6 @@ A 终端看不到 B 终端里有哪个会话、在干什么，也没法把一条
   离线设备一律「未知」；现在按 `updatedAt → at → lastSeen` 依次取。
 - `term_list` 的云端行也带角色。
 
-**更早（0.8.5 / 0.8.2 / 0.8.0）**
-
 - 0.8.5：负责人留痕 `MAINTAINERS.md`、运行日志可轮转（5 MB 压 `logs/archive/` 留 20 份）、
   卡片「维护者」行与「运行日志」按钮、`GET /crossterm/api/logs`。
 - 0.8.2：死信按 20s/1m/5m/15m/1h 退避，8 次后进 `dead/`；收件人写设备名会回退「最近活跃会话」；

package/client/client.js

@@ -482,7 +482,7 @@ window.__ModuleLoader__.load({
 							label: "当前终端",
 							value: status ? `${status.node}（${status.nodeId}）· ${status.hostname}` : "",
 						}),
-						about && about.maintainers
+						about && about.maintainers && about.maintainers.visible === true
 							? h(FriendlyRow, {
 								label: "维护者",
 								value: maintainersText(about),

package/lib/bus.js

@@ -23,7 +23,7 @@ import path from 'node:path'
 import crypto from 'node:crypto'
 import { rotateIfNeeded } from './logs.js'
 
-export const VERSION = '0.8.7'
+export const VERSION = '0.8.8'
 
 /** DSH 的家目录：与宿主其它状态（sessions / profiles）同一个根，多终端天然共享 */
 export function dshHome() {
@@ -79,6 +79,9 @@ const DEFAULTS = {
   backupSessionsPerRun: 20,
   backupAttachmentsPerRun: 20,
   attachmentBackupEnabled: true,
+  // 卡片「维护者」一栏只在维护端显示：默认按 MAINTAINERS.md 里的 nodeId 判断，
+  // 这里可以额外放行别的设备（例如用户授权过的本机另装环境）。
+  maintainerDevices: [],
   baiduAppFile: '',
   baiduAuthFile: '',
   cloudStateFile: '',

package/lib/web.js

@@ -506,7 +506,28 @@ function readMaintainers() {
   return readMaintainersDoc(ROOT)
 }
 
-function aboutOf() {
+/**
+ * 「维护者」只给维护端看：本机 nodeId 必须出现在 MAINTAINERS.md 的
+ * 负责人/助手条目里，或用配置 `maintainerDevices` 额外授权；其他设备一律不给这行。
+ */
+export function maintainerVisible(term, doc) {
+  if (!doc) return false
+  const self = String((term && term.nodeId) || '')
+  if (!self) return false
+  const allow = new Set()
+  const add = (item) => {
+    if (item && item.nodeId) allow.add(String(item.nodeId))
+  }
+  add(doc.current)
+  add(doc.assistant)
+  try {
+    const extra = term && term.cfg && Array.isArray(term.cfg.maintainerDevices) ? term.cfg.maintainerDevices : []
+    for (const item of extra) allow.add(String(item))
+  } catch { /* ignore */ }
+  return allow.has(self)
+}
+
+function aboutOf(term) {
   if (aboutCache && aboutCache.version === VERSION) return aboutCache
   let meta = {}
   try {
@@ -524,6 +545,7 @@ function aboutOf() {
       description: doc.description || '',
     }
   })
+  const maintainers = readMaintainers()
   aboutCache = {
     name: PKG,
     version: VERSION,
@@ -532,7 +554,9 @@ function aboutOf() {
     shortTitle: meta.shortTitle || meta.title || PKG,
     description: meta.description || '',
     components,
-    maintainers: readMaintainers(),
+    maintainers: maintainers
+      ? { ...maintainers, visible: maintainerVisible(term, maintainers), me: String((term && term.nodeId) || '') }
+      : null,
     changelog: readChangelog(),
   }
   return aboutCache
@@ -578,7 +602,7 @@ export function registerWeb(ctx, term, log) {
             path: '/crossterm/api/about',
             handler: (req, res) => {
               try {
-                json(res, 200, { ok: true, ...aboutOf() })
+                json(res, 200, { ok: true, ...aboutOf(term) })
               } catch (error) {
                 json(res, 200, { ok: false, message: String((error && error.message) || error) })
               }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "dsh-crossterm",
-  "version": "0.8.7",
+  "version": "0.8.8",
   "description": "跨端互通：同一 DSH 账号下的会话、终端、设备之间互通 —— 特征码链、内联邮件、云端中转站与自动备份",
   "type": "module",
   "main": "./lib/index.js",