@rezti/dsh-rez-suite 0.1.55 → 0.1.57

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
@@ -11,19 +11,27 @@ description: wecom-cli 业务技能的公共前置检查、获取机器人及授
11
11
 
12
12
  ## Step 1:检查 CLI 安装与版本
13
13
 
14
- ReZ-TI suite 已依赖 `@wecom/cli@1.1.0`(随 `dsh plugin add @rezti/dsh-rez-suite` 装进 profile)。**优先用 profile 里的二进制**,不要用 Homebrew 全局 `0.1.x`(没有 `mail` / 完整 `auth`)。
14
+ ReZ-TI suite 已依赖 `@wecom/cli@1.1.0`(随 suite 装进 profile)。**优先用 profile 里的二进制**,不要用 Homebrew 全局 `0.1.x`(没有 `mail` / 完整 `auth`)。
15
+
16
+ **禁止** `npm install -g @wecom/cli`、禁止 `npm i @wecom/cli`。Windows 员工机沙箱 `workspace-write` 不能写 `AppData\Local\npm-cache`,会 EPERM,而且装到全局也找不到 suite 自带的 1.1。找不到命令时让用户点网页**左下角「升级」**,不要自己装 npm 包。
17
+
18
+ 调用顺序(Windows 用 PowerShell / cmd 均可):
15
19
 
16
20
  ```bash
21
+ # 1) suite 写入的环境变量(推荐)
22
+ node "$REZ_WECOM_CLI" --version
23
+ # Windows: node $env:REZ_WECOM_CLI --version
24
+
25
+ # 2) 房间内垫片(Glob 能搜到)
26
+ .agents/bin/wecom-cli --version
27
+ # Windows: .agents\bin\wecom-cli.cmd --version
28
+
29
+ # 3) 仅当上面都没有时
17
30
  wecom-cli --version
18
- # 若输出是 0.1.x,或 which wecom-cli 指向 /opt/homebrew,改用:
19
- # npx --no-install wecom-cli --version
20
- # 或:node "$(node -p \"require('path').join(require('path').dirname(require.resolve('@wecom/cli/package.json')),'bin/wecom.js')\")" --version
21
31
  ```
22
32
 
23
33
  - 命令成功,且版本号不低于 `1.1.0` → 继续 Step 2。
24
- - 命令不存在、执行报错或版本仍低于 `1.1.0` → **不要** `npm install -g @wecom/cli`(容易仍被旧 PATH 盖住)。请用户重装 suite:`dsh plugin --profile web add @rezti/dsh-rez-suite@<当前版>`。仅当 suite 依赖确实缺失时,才可:`npm i @wecom/cli@1.1.0 --prefix "$HOME/.local"` 并把 `$HOME/.local/bin` 放到 PATH **最前**。
25
-
26
- 安装/重装后重新执行 `wecom-cli --version`;仍失败或版本仍低于 `1.1.0` 时停止业务操作,并把错误告知用户。
34
+ - 命令不存在、执行报错或版本仍低于 `1.1.0` → **停止**,告诉用户点左下角升级 ReZ-TI 插件。不要 npm、不要 npx、不要改沙箱去装全局包。
27
35
 
28
36
  ## Step 2:检查授权状态
29
37
 
@@ -19,7 +19,7 @@
19
19
 
20
20
  1. 先问清是 **产品拍摄图** 还是 **公司品牌规范 / VI**。产品用 Wiki **首次创建标题**(不用会变的 Odoo/销售名);品牌/VI 是公司级,不绑 SKU。
21
21
  2. 打开 Nextcloud `Documents/Standards/INDEX.yaml`,再按相对 uri 读路径规则。产品拼 `Marketing/Inbox/{分类}/{首次创建标题}/photo/shot|clean/`(Wiki 缺 NC RAW / Publish / Git 3D 就说「Wiki 未归档」,不要猜路径)。品牌/VI 拼 `Marketing/Inbox/Brand/guideline|vi/shot|clean/`。
22
- 3. 没有官方 Comfy MCP(`mcp__comfy*`)就说未开通,不要自写 WebSocket。规范 PDF / psd/ai 源文件用回形针,不要塞进官方对话。
22
+ 3. 没有官方 Comfy MCP(`mcp__comfy*`)就说未开通,不要自写 WebSocket。规范 PDF / psd/ai 源文件用回形针,不要塞进官方对话。看图请调 `mcp__vision__view_image`,不要改网页模型;认 PDF 用 Nextcloud `parse_document`,不要把 PDF 当图。
23
23
 
24
24
  ## 拍摄入库(TAPD `1154488930001001218`)
25
25
 
@@ -22,7 +22,7 @@ description: 人事助理。引导员工自己领取本机安装包、申请各
22
22
 
23
23
  没有 GitHub 权限:找人事要包,不要下未知来源的安装程序。
24
24
 
25
- **发包装时说清楚:** zip/exe 只是启动壳,第一次会从外网下 Node、**pnpm**、dsh,再装钉死的 suite(现在 `0.1.48`)。不是装完就能离线用。长期分发走 CI artifact,不要把仓里 `deploy/dist/` 当主渠道。
25
+ **发包装时说清楚:** zip/exe 只是启动壳,第一次会从外网下 Node、**pnpm**、dsh,再装 npm 上已满 24 小时的最新 suite。刚发的包要等一天;当天要用就点网页左下角「升级」。不是装完就能离线用。长期分发走 CI artifact,不要把仓里 `deploy/dist/` 当主渠道。
26
26
 
27
27
  回形针上传走 npm `@rezti/dsh-web-file-uploader`,装进 suite 即可。不要再单独从 GitHub add。
28
28
 
@@ -30,7 +30,7 @@ description: 人事助理。引导员工自己领取本机安装包、申请各
30
30
 
31
31
  1. 解压 zip,把 **ReZ-TI Harness** 拖进「应用程序」。
32
32
  2. 若提示无法打开 / 已损坏:让对方双击包里的 **首次打开.command**,或在终端执行 `xattr -cr "/Applications/ReZ-TI Harness.app"`,再**右键 → 打开**。
33
- 3. 第一次会弹出终端:下载 Node、安装 pnpm 和稳定 dsh、拉 **0.1.48** suite。不是装完就能离线用。
33
+ 3. 第一次会弹出终端:下载 Node、安装 pnpm 和稳定 dsh、拉 npm 上已满 24 小时的最新 suite。不是装完就能离线用。当天要用新功能:点左下角「升级」。
34
34
  4. 浏览器打开 `http://127.0.0.1:3080/`。失败看 `~/Library/Application Support/ReZ-TI/harness/logs/harness.log`。
35
35
 
36
36
  ### Windows
@@ -42,6 +42,14 @@ description: 人事助理。引导员工自己领取本机安装包、申请各
42
42
 
43
43
  密钥写在本机 `~/.dsh`(Windows `%USERPROFILE%\.dsh`)。不要删这份目录。
44
44
 
45
+ ### 日常升级(已装完,不要重装 EXE)
46
+
47
+ exe / App **只是启动壳**。插件升级点网页**左下角「升级」**,等它重载。不要 `latest`,不要让员工自己 `npm install`。
48
+
49
+ - 不必为升 suite 重装 Setup.exe。密钥还在 `%USERPROFILE%\.dsh`。
50
+ - 只有启动脚本坏了、黑窗口一闪、或人事发了新安装包时,才覆盖装 EXE。先关黑窗口,任务管理器结束 `powershell` / `node`。
51
+ - 同事在企微跟机器人说话要进 Harness:设置 → 插件 → ReZ-TI → **企业微信**,给该房间填 BotID + Secret;网页必须开着;聊的是那个智能机器人,不是普通客服。查邮件是另一条(官方 wecom-cli,先 `auth init`),不要 `npm i -g`。
52
+
45
53
  ## 填到哪
46
54
 
47
55
  | 用途 | 填哪里 | 面板字段(中文) |