dsh-plugin-t-expert 0.4.64 → 0.4.70

package/CHANGELOG.md

@@ -16,7 +16,95 @@
 > 发布时**不要再跑 `npm version`**（那会把已提交好的版本又升一级，发出去的号与 CHANGELOG、tag 就对不上），
 > 只补一个 annotated tag（`git tag -a`，因为 `git push --follow-tags` 只推带注释的 tag）。
 
-## [0.4.64] — 未发布
+## [0.4.70] — 未发布
+
+**README 对齐实现，并去掉本机开发那套** —— 面向用户的门面只说用户要听的话。
+
+### 变更
+
+- 「安装」不再分「本机开发 / 维护者（file: 装到 profile）」与「发布到 npm 之后（普通用户）」
+  两条路，只留 **DSH Web / CLI**（`dsh plugin --profile web add dsh-plugin-t-expert`）与
+  **DSH Desktop**（插件市场）两种；`~/web/t-team/tz.sh` 那套维护者流程从面向公众的文档里移除。
+- 依赖表述与实际解耦：原文写死 `^0.1.5-rc.1 || ^0.1.6-alpha.2 || ^0.1.7-rc.1`，而
+  peerDependencies 实际就是 `>=0.1.5-rc.1`（无上界），改为与 package.json 一致。
+- 修正三处与实现矛盾的描述：设置页是**三个标签**（专家 / 分类 / 技能），不是两个；
+  自建专家与自建分类的入口是「插件列表 → T专家 → 对应标签」，不再是「设置 → 专家 / 分类」
+  （面板 2026-09-28 起就搬去插件信息页了，旧文案一直没跟上）。
+- 删掉「技能开关」章节末尾的实现细节段（包装 `ctx.skills` / 动态 inject 那些）——
+  面向用户的 README 不需要，源码里写得更清楚。
+- `tools/verify.mjs`：原「README 说明设置页只有专家 / 分类两个标签」那条断言把数字写死了，
+  可客户端早就是三个 —— 它靠着 README 里一句无关的「两个标签都带计数」蒙混过关。
+  改成**直接读 `settings.jsx` 的标签集合**再与 README 对照，实现变了这里就红。
+
+## [0.4.69] — 未发布
+
+**发布不再把开发历史推上 GitHub** —— 远端只收一条无父提交的发布快照，本地历史永不出本机。
+
+背景（2026-10-06 实测）：远端 `main` 已改成「只有一条 `--orphan` 起点的无父快照」，但发布链
+还在用 `git push --follow-tags`，而 tag 是**带父链**的 —— 实测复现：分支推送被 non-fast-forward
+拒绝、命令退出码为 1，脚本于是打印「推送失败」，看起来像什么都没推上去，**可 tag 已经推成功了**，
+从远端 clone 顺着它就能看到全部 288 条开发提交。
+
+### 变更
+
+- `ops/tz.sh`：3/6 末尾新增「发布快照」步骤 —— 用 `git commit-tree` 造一条**无父提交**的快照
+  （树 = 本次发布提交的树），把 tag 重指到它，并让 `refs/heads/github` 指向它；4/6 改成
+  `git push -f origin refs/heads/github:refs/heads/main` + `git push origin refs/tags/v$target`。
+  两条推送各自失败都只 warn，不影响 npm 发布。`--no-push` 逃生口保留，跳过时打印补推命令。
+- `ops/git-hooks/pre-push`（新增）：pre-push 保险闸 —— 拒收「交给 `refs/heads/main` 的带父提交」
+  与「指向带父链提交的 tag」，提示里报出**沿父链回溯有多少条提交**。
+  安装：`git config core.hooksPath ops/git-hooks`。
+- `tools/verify.mjs`：原「默认推送」断言改写成四条 —— 不再执行 `--follow-tags`（判定跳过注释行，
+  因为脚本里有意保留着当初为什么踩坑的记录）、有快照逻辑、tag 落在快照上、`--no-push` 逃生口仍在；
+  另加一条守住保险闸。自检项数 548 → 552，`.github/workflows/ci.yml` 的数字同步跟齐。
+- 文档与提示语同步：`ops/README.md`、`skills/t-expert-manager/SKILL.md`、
+  `references/ops-reference.md`、`tools/sync-from-workbuddy.mjs` 的收尾提示。
+
+## [0.4.68] — 未发布
+
+**OBS 凭据可入库，同步链路不再卡在上传** —— 为「一条提示词跑完整同步（含上传）」扫掉唯一的人工前置。
+
+- `tools/obs-credentials.mjs`（新增）：OBS 凭据的读写收敛到一个模块 —— **环境变量优先**，
+  缺失时回退 `~/.dsh/.credentials.yaml` 的 `refs` 段（DSH 官方凭据库）。只做该段的浅解析，
+  不为两个键引一整个 YAML 依赖。抽公共模块是为了避免解析逻辑两处各写一份、日后漂移
+  （判重逻辑重复的坑在 `import-workbuddy.py` 上已经踩过一次）。
+- `tools/set-obs-credentials.mjs`（新增）：一次性写入凭据库。交互式输入**隐藏回显**
+  （密钥不打屏、不进对话历史）；写前自动备份 `.bak-obs-<时间戳>`（600 权限），
+  写后回读校验、**校验失败自动回滚** —— 凭据库是宿主的文件，写坏会连带其它凭据一起读不出。
+  另有 `--show`（遮蔽查看现状）与 `--from-env`（非交互）两种用法。
+- `tools/upload-obs.mjs`：签名处改为调用共享模块；「两个来源都没有就报错」仍是最终兜底，
+  错误信息里直接给出两条可操作的路子。
+
+## [0.4.67] — 未发布
+
+**单文件专家也有头像了** —— 308 位 `<分区>/<slug>.md` 形态的专家补上头像。
+
+- `lib/index.js` 的 `avatars()` 支持第二种形态：没有包目录的单文件专家去**分区级**
+  `<root>/<分区>/avatars/<slug>.webp` 取图（此前 `packDir === undefined` 直接跳过，
+  生成了也显示不出来）。
+- `tools/gen_avatars.py`：支持单文件形态（落盘到分区级目录）、`--model` 切换模型、
+  单文件 / 目录两种形态自动识别。
+
+### prompt 教训（已写进脚本注释）
+
+往 prompt 里塞 `no grid, no collage, no multiple faces, no contact sheet…` 一连串负向词
+**完全适得其反** —— 扩散模型把它们当正向内容，画出「一张图排满几十个小头像」的拼贴画。
+改成一句短正向描述 `Portrait of one single person, professional headshot, {style}, plain solid background`
+之后，Kolors / Z-Image-Turbo 都 100% 出单人肖像。
+
+头像合计 **608 张**（目录形态 300 + 单文件 308）。
+
+
+
+**verify 补一条断言**：locale 描述里的名册数必须与实际一致 —— 防再次出现「package.json 改了、
+locale 还写旧数字」这类漏改。自检项数 547 → 548。
+
+
+
+**修正插件描述里的名册数字** —— `locale/zh.json` 与 `locale/en.json` 的 description 还写着
+「323 位专家」，而 `package.json` 的英文 description 早已是 623（上次更新数字时只改了英文、漏了两处 locale）。
+
+
 
 **修 #6 优化其实没生效的问题** —— `enabledSet` 每次渲染都 `new Set(...)`、引用恒变，
 导致 `visible` 的 `useMemo` 依赖恒变、每次都重算（白加一层 memo）。

package/README.md

@@ -7,37 +7,25 @@ dsh-plugin-t-expert 插件：包含 **22 个分类 / 623 位专家**的名册（
 | 做什么 | 怎么做 |
 | --- | --- |
 | 用专家 | 输入框打 `@` → 按分类分组的菜单 → 选中的专家作为引用 chip 进本轮对话；模型也可自行 `summon_t_expert` |
-| 管名册 | 插件列表 → T专家 → **专家** 标签（看提示词 / 新建自建专家 / 分类管理） |
+| 管名册 | 插件列表 → T专家 → **专家** 标签（看提示词 / 新建自建专家）、**分类** 标签（自建分类增删改） |
 | 管技能 | 插件列表 → T专家 → **技能** 标签（关掉的技能不进模型目录，少占上下文） |
 
 ## 安装
 
-**本机开发 / 维护者（file: 装到 profile）**：
-
-```bash
-# 工作区根运行，菜单里选对应插件的「8 安装/重装」。
-bash ~/web/t-team/tz.sh
-# 或直接走完整子命令（默认探测 profile=web，本机没桌面 electron 就用这个）：
-bash ~/web/t-team/tz.sh install
-# 卸载
-bash ~/web/t-team/tz.sh uninstall
-```
-
-**发布到 npm 之后（普通用户）**：
+**DSH Web / CLI**：
 
 ```bash
 dsh plugin --profile web add dsh-plugin-t-expert
 ```
 
-DSH Desktop 请在插件市场里搜 `dsh-plugin-t-expert` 安装（`--profile desktop` 由 Electron 应用独占，
-CLI 会被拒绝 —— 任何插件都一样）。
+**DSH Desktop**：在**插件市场**里搜 `dsh-plugin-t-expert` 安装。
 
-- 依赖：DSH 宿主 `^0.1.5-rc.1 || ^0.1.6-alpha.2 || ^0.1.7-rc.1`（0.1.7-rc.1 实测可用）；Node `^22.19.0 || >=24`；`pnpm` 在 PATH 上。
+- 依赖：DSH 宿主 `>=0.1.5-rc.1`；Node `^22.19.0 || >=24`；`pnpm` 在 PATH 上。
 - 装完**重启 DSH** 即可用；第一次怎么上手见下面的「快速上手」。
 
 ## 快速上手
 
-1. **看名册**：插件列表 → T专家 的详情页里就是管理面板（**专家** / **分类** 两个标签）。
+1. **看名册**：插件列表 → T专家 的详情页里就是管理面板（**专家** / **分类** / **技能** 三个标签）。
 2. **用一位专家**：输入框打 `@`，按分类挑一位，它以引用 chip 进入本轮对话；也可以直接说"让 XX 专家看看"，
    由模型调 `summon_t_expert`。
 
@@ -45,17 +33,17 @@ CLI 会被拒绝 —— 任何插件都一样）。
 
 | 位置 | 是什么 |
 | --- | --- |
-| 插件列表 → T专家 | 管理面板，两个标签：**专家**（提示词 / 新建自建专家）、**分类**（自建分类增删改）。2026-09-28 起不再占「设置」里的分区 |
+| 插件列表 → T专家 | 管理面板，**三个标签**：**专家**（提示词 / 新建自建专家）、**分类**（自建分类增删改）、**技能**（模型可调用技能的开关）。2026-09-28 起不再占「设置」里的分区 |
 | 输入框 `@` | 按分类分组的专家菜单，选中即插入引用 chip |
-| 输入区「T专家」按钮 | 浮层标签：**专家 / 技能**（默认停在**专家**）；专家 / 技能两个标签带计数（该标签里的总条数，不随搜索框变化）。原「任务」标签已在 0.3.x 迁出（T专家 不再做定时任务，由 `dsh-helper-patch` 接管） |
+| 输入区「T专家」按钮 | 浮层标签：**专家 / 技能**（默认停在**专家**）。分类在这里只作为专家列表的分组，没有独立标签页 —— 增删改分类请去插件信息页。两个标签都带计数（该标签里的总条数，不随搜索框变化）。原「任务」标签已在 0.3.x 迁出（T专家 不再做定时任务，由 `dsh-helper-patch` 接管） |
 | 会话标题栏徽章 | 后台任务只读面板（当前会话及其子代理的任务：状态、退出码、耗时）；只在真有任务在跑时亮起并给出数量，**面板绝不自动展开**，可拖动、位置记在本机 |
 
 ## 专家
 
 - 名册随包发布，启动时与 `~/.t-team/` 对齐（按条目送达，见「数据目录」）。
-- **自建专家**：设置 → 专家 → 「＋ 新建专家」，写在 `customRoot`（默认 `~/.t-team/custom/<分类>/<slug>.md`），
+- **自建专家**：插件列表 → T专家 → **专家** 标签 → 「＋ 新建专家」，写在 `customRoot`（默认 `~/.t-team/custom/<分类>/<slug>.md`），
   与内置名册分开 —— 内置名册升级时整棵替换，自建的不受影响；归到官方分类名下也安全（分类只是归属）。
-- **自建分类**：设置 → 分类 → 目录名（小写 ASCII）+ 显示名。官方分类只读；删除自建分类时若里面还有专家会被拒绝。
+- **自建分类**：插件列表 → T专家 → **分类** 标签 → 目录名（小写 ASCII）+ 显示名。官方分类只读；删除自建分类时若里面还有专家会被拒绝。
 
 | 工具 | 作用 |
 | --- | --- |
@@ -63,7 +51,7 @@ CLI 会被拒绝 —— 任何插件都一样）。
 | `summon_t_expert` | 召唤 1 位专家：以它的完整人格跑一个子代理并返回结果 |
 | `summon_t_experts` | 并行召唤多位（最多 8 位、并发 4；部分失败仍返回成功的结果） |
 
-## 技能开关（2026-09-28 从 dsh-plugin-skill-gate 并入）
+## 技能开关
 
 面板第三个标签页：**关掉的技能不再进入每次请求的 `<available_skills>` 清单**，从而少占上下文。
 不改任何 `SKILL.md`，也不把文件移出扫描目录 —— 斜杠菜单里仍可手动点（与官方
@@ -77,12 +65,6 @@ CLI 会被拒绝 —— 任何插件都一样）。
 - 名单在 `~/.dsh/skill-gate.json`（**沿用原插件的路径**：并入时没改，所以已有开关状态直接沿用）。
   改完下一轮模型请求即生效，不必重启。
 
-实现：宿主启动时包装 `ctx.skills.snapshot / list / get`，把名单里技能的 `modelInvocable` 置 false
-（`dsh-tool-skill` 生成目录时本来就会 `filter(isModelInvocable)`）。装配代码在 `lib/skill-gate/`，
-remote 入口 `lib/skill-gate-remote.js`（wire 名仍是 `skillGate`，客户端信封同步）。
-⚠️ 用**动态** `ctx.inject(["skills"])` 而不是静态 inject：静态依赖会让「宿主缺 skills 服务」变成
-整个插件不激活 —— 连专家名册与召唤一起没。
-
 ## 数据与目录
 
 **全部数据都在你本机**：不连任何网络服务、不做遥测；名册与中文译文都随包分发，运行时不向上游拉取。
@@ -107,7 +89,7 @@ remote 入口 `lib/skill-gate-remote.js`（wire 名仍是 `skillGate`，客户
 | 现象 | 原因与处理 |
 | --- | --- |
 | 召唤不了某位专家 | 它没在名册里、或已被停用：插件列表 → T专家 的**专家**标签里核对 |
-| 改完插件看不到变化 | 客户端与宿主代码都要重启 DSH 才生效；插件列表 → T专家 的卡片副标题有当前版本号（`· v0.3.x`）可核对 |
+| 更新后没看到新版本 | 重启 DSH 才生效；插件列表 → T专家 的卡片副标题带当前版本号，可核对是否已更新到新版 |
 
 ## 卸载与反馈