@rezti/dsh-rez-suite 0.1.52 → 0.1.53

package/CHANGELOG.md

@@ -5,12 +5,16 @@
 升级：
 
 ```bash
-dsh plugin --profile web add @rezti/dsh-rez-suite@0.1.52
+dsh plugin --profile web add @rezti/dsh-rez-suite@0.1.53
 ```
 
 不要用裸 `plugin update`，不要写 `latest`（新 profile 有 24 小时发布冷却，当天可能装不上）。不要装 **0.1.46**（GitHub 子依赖会被 DSH 拦住）。不要装 **0.1.51**（误用 `npm publish` 把 `workspace:` 打进包了）。
 
-发版顺序：`wechat@0.1.16` → `suite@0.1.52`。**必须用 `pnpm publish`**（会把 `workspace:` 写成真实版本），不要用 `npm publish`。
+发版顺序：`wechat@0.1.16` → `suite@0.1.53`。**必须用 `pnpm publish`**（会把 `workspace:` 写成真实版本），不要用 `npm publish`。
+
+## 0.1.53 — 2026-08-20
+
+- **suite 自带 `@wecom/cli@1.1.0`**：装 suite 即带办公 CLI（含 `mail`）。启动时把其 bin 插到 PATH 最前，避开 Homebrew 全局 `0.1.9`。房间消息仍设置页 BotID+Secret；办公授权仍 `wecom-cli auth init`（可扫码）。
 
 ## 0.1.52 — 2026-08-20
 

package/README.md

@@ -2,17 +2,17 @@
 
 雷泽插件的**唯一安装入口**。Odoo / 企微 / HA / TAPD / GSC / 企查查（仅法务助理房间） / 天眼查（仅老板） / 工作区（老板三室 + 全员助理）都由这一包拉齐，不要再逐个 `plugin add`，**不要**再装 `@rezti/dsh-rez-boss-desk`。
 
-发版顺序（必做）：先发 `@rezti/dsh-rez-wechat@0.1.16` → `@rezti/dsh-rez-suite@0.1.52`。**发 suite 必须用 `pnpm publish`**（会把 `workspace:` 写成真实版本），不要用 `npm publish`。员工机安装包仍钉已发布的 suite，不要顺手改审批镜像 `SUITE_VERSION`。
+发版顺序（必做）：先发 `@rezti/dsh-rez-wechat@0.1.16` → `@rezti/dsh-rez-suite@0.1.53`。**发 suite 必须用 `pnpm publish`**（会把 `workspace:` 写成真实版本），不要用 `npm publish`。员工机安装包仍钉已发布的 suite，不要顺手改审批镜像 `SUITE_VERSION`。
 
 设置里选身份后，左侧自己出现对应房间（全员三助理；工程师另加实验室；运营另加设计、发布、电商；老板另加搞钱/产品/运营），不必手动添加工作区。实验室：大模型写 YAML、调 MCP、给下载链接。
 
-回形针走 npm 包 `@rezti/dsh-web-file-uploader@0.2.3`（不要 GitHub：DSH 会拦子依赖 git，0.1.46 因此装不上）。
+回形针走 npm 包 `@rezti/dsh-web-file-uploader@0.2.3`（不要 GitHub：DSH 会拦子依赖 git，0.1.46 因此装不上）。suite 自带 `@wecom/cli@1.1.0`（企微办公；不要依赖 Homebrew 全局 0.1.x）。
 
 员工机不要 `SUITE_VERSION=latest`：新 profile 默认 `minimumReleaseAge: 1440`，当天发的包可能装不到。钉死版本，或把 profile 的 `minimumReleaseAge` 改成 `0`。
 
 ```bash
 # 第一次 / 升级（钉死版本，避开 24h 发布冷却）
-dsh plugin --profile web add @rezti/dsh-rez-suite@0.1.52
+dsh plugin --profile web add @rezti/dsh-rez-suite@0.1.53
 ```
 
 本版改了什么：见 [CHANGELOG.md](./CHANGELOG.md)。

package/lib/client.js

@@ -994,6 +994,20 @@ function ChannelTable({ kind, lang }) {
 //#endregion
 //#region src/changelog.ts
 const SUITE_CHANGELOG = [
+	{
+		version: "0.1.53",
+		date: "2026-08-20",
+		sections: [{
+			title: {
+				zh: "自带 wecom-cli 1.1",
+				en: "Bundled wecom-cli 1.1"
+			},
+			items: [{
+				zh: "suite 依赖 @wecom/cli@1.1.0，装插件即带 mail/auth。PATH 优先用 profile 里的二进制，避开 Homebrew 0.1.9。房间仍 BotID+Secret；办公 auth init 可扫码。",
+				en: "Suite depends on @wecom/cli@1.1.0 (mail/auth). Prefers the profile binary over Homebrew 0.1.9. Room bots still BotID+Secret; office auth init can QR."
+			}]
+		}]
+	},
 	{
 		version: "0.1.52",
 		date: "2026-08-20",

package/lib/index.js

@@ -4,8 +4,8 @@ import { dirname, join, relative } from "node:path";
 import { REZ_CREDENTIAL_REFS, REZ_DEFAULT_CONNECTIONS, REZ_SYSTEMS, lastMcpStartError, loadRezConnections, mergeConnections, readManagedCredential, secretConfigured, startMcpWhenSecret, writeManagedCredential } from "@rezti/dsh-rez-sso";
 import { existsSync, mkdirSync, readFileSync, readdirSync, realpathSync, renameSync, statSync, writeFileSync } from "node:fs";
 import { spawn, spawnSync } from "node:child_process";
-import { DatabaseSync } from "node:sqlite";
 import { fileURLToPath } from "node:url";
+import { DatabaseSync } from "node:sqlite";
 //#region ../../node_modules/.pnpm/@deepseek-ai+cosmokit@1.8.2/node_modules/@deepseek-ai/cosmokit/lib/index.js
 /** Return true when a value is `null` or `undefined`. */
 function isNullable(value) {
@@ -3236,6 +3236,9 @@ function saveConfig(config) {
 * TAPD bug 1154488930001000054: missing MCP row was treated as “no WeCom”.
 * Official CLI v1.1+ opened 通讯录 / 在线文档 etc. for every company size
 * (https://github.com/WecomTeam/wecom-cli). Kelvin enabled those modules.
+*
+* Suite depends on @wecom/cli@1.1.0 so the profile gets a modern binary.
+* Prefer that over a global Homebrew 0.1.x that lacks `mail` / `auth`.
 */
 /** Official @wecom/cli >=1.1 catalog. Do not invent extra HTTP APIs. */
 const WECOM_CLI_CATALOG = [
@@ -3294,18 +3297,22 @@ const WECOM_CLI_CATALOG = [
 ];
 const MODULE_LABELS = WECOM_CLI_CATALOG.map((row) => row.label).join("/");
 const HINT_MISSING = [
-	`未安装官方 wecom-cli（@wecom/cli >=1.1）。企微办公能力（${MODULE_LABELS}）走 CLI，不是 MCP。`,
-	"安装：npm i -g @wecom/cli ，然后 wecom-cli auth init。",
-	"官方已面向各规模企业开放通讯录等能力，不要再说「超过 10 人只能用文档」。",
-	"不要因为 rez_status 没有 wechat MCP 行就说没有企微能力。"
+	`未找到可用的 wecom-cli >=1.1（企微办公：${MODULE_LABELS}）。`,
+	"suite 已依赖 @wecom/cli@1.1.0：请重装 @rezti/dsh-rez-suite，或确认 profile 的 node_modules 里有 @wecom/cli。",
+	"不要用 Homebrew 全局 0.1.x（没有 mail/auth）。不要因为没有 wechat MCP 就说没有企微能力。"
+].join("");
+const HINT_OUTDATED = [
+	"PATH 上的 wecom-cli 过旧（<1.1，没有 mail 等子命令）。",
+	"请用 suite 自带的 @wecom/cli@1.1.0：重装 suite，或把 profile node_modules/.bin 放在 PATH 最前。",
+	"不要 npm i -g 覆盖到旧 Homebrew 路径前面仍是 0.1.9。"
 ].join("");
 const HINT_UNAUTH = [
-	"已安装 wecom-cli，尚未授权。跑 wecom-cli auth init。",
+	"已安装 wecom-cli >=1.1，尚未授权。跑 wecom-cli auth init（可扫码）。",
 	`授权后可用：${MODULE_LABELS}。本企业已开通这些品类。`,
 	"CLI 报某模块未授权才说该能力未开通；不要说「没有企微 MCP」，也不要说 10 人限制。"
 ].join("");
 const HINT_OK = [
-	`企微办公能力走 wecom-cli >=1.1（${MODULE_LABELS}）。本企业已开通。`,
+	`企微办公能力走 wecom-cli >=1.1（${MODULE_LABELS}）。本企业已开通。suite 已带 @wecom/cli。`,
 	"按房间里官方 wecomcli-* 技能执行，命令以 wecom-cli <模块> --help 为准。",
 	"不要用旧帮助中心「超过 10 人只能用文档」的说法。CLI 报未授权才说该模块未开通。",
 	"设置页 BotID+Secret 只是房间消息通道。不要把没有 mcp__wechat__* 当成没有企微能力。"
@@ -3313,8 +3320,32 @@ const HINT_OK = [
 function wecomCliCatalog() {
 	return WECOM_CLI_CATALOG.map((row) => ({ ...row }));
 }
+/** Resolve suite-bundled @wecom/cli binary; undefined if not installed next to suite. */
+function resolveWecomCliBin() {
+	const require = createRequire(import.meta.url);
+	try {
+		const bin = join(dirname(require.resolve("@wecom/cli/package.json")), "bin", "wecom.js");
+		if (existsSync(bin)) return bin;
+	} catch {}
+	const here = dirname(fileURLToPath(import.meta.url));
+	for (const candidate of [
+		join(here, "..", "node_modules", "@wecom", "cli", "bin", "wecom.js"),
+		join(here, "..", "..", "node_modules", "@wecom", "cli", "bin", "wecom.js"),
+		join(here, "..", "..", "..", "node_modules", "@wecom", "cli", "bin", "wecom.js")
+	]) if (existsSync(candidate)) return candidate;
+}
+/** Put suite-bundled wecom-cli ahead of global Homebrew 0.1.x on PATH. */
+function ensureWecomCliOnPath() {
+	const bin = resolveWecomCliBin();
+	if (bin === void 0) return void 0;
+	const dir = dirname(bin);
+	const pathKey = process.platform === "win32" ? "Path" : "PATH";
+	const parts = (process.env[pathKey] ?? "").split(process.platform === "win32" ? ";" : ":").filter(Boolean);
+	if (parts[0] !== dir) process.env[pathKey] = [dir, ...parts.filter((p) => p !== dir)].join(process.platform === "win32" ? ";" : ":");
+	return bin;
+}
 function defaultWecomCliRunner(argv) {
-	const result = spawnSync("wecom-cli", argv, {
+	const result = spawnSync(resolveWecomCliBin() ?? "wecom-cli", argv, {
 		encoding: "utf8",
 		timeout: 4e3,
 		env: process.env
@@ -3331,6 +3362,15 @@ function looksUnauthorized(text, status) {
 	if (status !== 0) return true;
 	return /未授权|未登录|未初始化|not (logged|auth)|unauthorized|请先.*auth|auth init/i.test(text);
 }
+/** 0.1.x has no mail; 1.1 help lists mail. */
+function isWecomCliModern(helpOrVersionText) {
+	const text = helpOrVersionText.toLowerCase();
+	if (/\b0\.1\.\d+\b/.test(text) && !/\b1\.\d+\.\d+\b/.test(text)) return false;
+	if (/\bunrecognized subcommand\b/.test(text)) return false;
+	if (/\bmail\b/.test(text)) return true;
+	if (/\b1\.\d+\.\d+\b/.test(text) || /wecom-cli\s*\(?\s*1\./i.test(helpOrVersionText)) return true;
+	return false;
+}
 function withCatalog(partial) {
 	return {
 		...partial,
@@ -3338,34 +3378,48 @@ function withCatalog(partial) {
 	};
 }
 function probeWecomCli(run = defaultWecomCliRunner) {
+	const bin = resolveWecomCliBin();
 	const help = run(["--help"]);
 	if (help.errorCode === "ENOENT") return withCatalog({
 		installed: false,
 		authorized: false,
-		hint: HINT_MISSING
+		hint: HINT_MISSING,
+		bin
 	});
 	const helpText = help.stdout + help.stderr;
 	if (help.status !== 0 && helpText.trim().length === 0) return withCatalog({
 		installed: false,
 		authorized: false,
-		hint: HINT_MISSING
+		hint: HINT_MISSING,
+		bin
+	});
+	const version = run(["--version"]);
+	const versionText = version.stdout + version.stderr;
+	if (!isWecomCliModern(helpText + "\n" + versionText)) return withCatalog({
+		installed: false,
+		authorized: false,
+		hint: HINT_OUTDATED,
+		bin
 	});
 	const auth = run(["auth", "show"]);
 	const text = auth.stdout + auth.stderr;
 	if (auth.errorCode === "ENOENT") return withCatalog({
 		installed: false,
 		authorized: false,
-		hint: HINT_MISSING
+		hint: HINT_MISSING,
+		bin
 	});
 	if (looksUnauthorized(text, auth.status)) return withCatalog({
 		installed: true,
 		authorized: false,
-		hint: HINT_UNAUTH
+		hint: HINT_UNAUTH,
+		bin
 	});
 	return withCatalog({
 		installed: true,
 		authorized: true,
-		hint: HINT_OK
+		hint: HINT_OK,
+		bin
 	});
 }
 //#endregion
@@ -8911,6 +8965,7 @@ function delegatedHost(ctx, getConfig) {
 	};
 }
 function apply(ctx, config) {
+	ensureWecomCliOnPath();
 	let current = () => normalize(config);
 	const syncWorkspaces = mountRezWorkspaces(ctx, () => current().role);
 	const syncQcc = mountQccMcp(ctx);

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@rezti/dsh-rez-suite",
-  "description": "ReZ-TI one-package install for DeepSeek Harness. Update with: dsh plugin --profile web add @rezti/dsh-rez-suite@0.1.52",
-  "version": "0.1.52",
+  "description": "ReZ-TI one-package install for DeepSeek Harness. Update with: dsh plugin --profile web add @rezti/dsh-rez-suite@0.1.53",
+  "version": "0.1.53",
   "type": "module",
   "engines": {
     "node": "^22.19.0 || >=24.0.0"
@@ -47,6 +47,7 @@
     "@rezti/dsh-rez-token-manager": "^0.1.4",
     "@rezti/dsh-rez-wechat": "^0.1.16",
     "@rezti/dsh-web-file-uploader": "0.2.3",
+    "@wecom/cli": "1.1.0",
     "@modelcontextprotocol/sdk": "^1.30.0",
     "zod": "^4.4.3"
   },

package/src/changelog.ts

@@ -20,6 +20,21 @@ export interface ChangelogRelease {
 }
 
 export const SUITE_CHANGELOG: readonly ChangelogRelease[] = [
+  {
+    version: '0.1.53',
+    date: '2026-08-20',
+    sections: [
+      {
+        title: { zh: '自带 wecom-cli 1.1', en: 'Bundled wecom-cli 1.1' },
+        items: [
+          {
+            zh: 'suite 依赖 @wecom/cli@1.1.0，装插件即带 mail/auth。PATH 优先用 profile 里的二进制，避开 Homebrew 0.1.9。房间仍 BotID+Secret；办公 auth init 可扫码。',
+            en: 'Suite depends on @wecom/cli@1.1.0 (mail/auth). Prefers the profile binary over Homebrew 0.1.9. Room bots still BotID+Secret; office auth init can QR.',
+          },
+        ],
+      },
+    ],
+  },
   {
     version: '0.1.52',
     date: '2026-08-20',

package/src/index.ts

@@ -28,6 +28,7 @@ import { TokenManager } from './token-manager.ts'
 import { rezConfigTool, rezEsphomeCompileTool, rezStatusTool } from './tools.ts'
 import type { RezConfig } from './protocol.ts'
 import { workspaceGuidanceFor, mountRezWorkspaces } from './boss/mount.ts'
+import { ensureWecomCliOnPath } from './wecom-cli.ts'
 import { liveSelfUpdate } from './self-update.ts'
 import { mountTianyanchaMcp } from './tianyancha.ts'
 import { mountQccMcp, QCC_COMPANY_MCP_URL } from './qcc.ts'
@@ -149,6 +150,8 @@ function delegatedHost(ctx: Context, getConfig: () => RezConfig): McpHost {
 }
 
 export function apply(ctx: Context, config?: RezConfig): void {
+  // Prefer suite-bundled @wecom/cli@1.1 over global Homebrew 0.1.x (no mail).
+  ensureWecomCliOnPath()
   let current: () => RezConfig = () => normalize(config)
   const syncWorkspaces = mountRezWorkspaces(ctx, () => current().role)
   const syncQcc = mountQccMcp(ctx)

package/src/wecom-cli.ts

@@ -3,9 +3,16 @@
  * TAPD bug 1154488930001000054: missing MCP row was treated as “no WeCom”.
  * Official CLI v1.1+ opened 通讯录 / 在线文档 etc. for every company size
  * (https://github.com/WecomTeam/wecom-cli). Kelvin enabled those modules.
+ *
+ * Suite depends on @wecom/cli@1.1.0 so the profile gets a modern binary.
+ * Prefer that over a global Homebrew 0.1.x that lacks `mail` / `auth`.
  */
 
 import { spawnSync } from 'node:child_process'
+import { existsSync } from 'node:fs'
+import { dirname, join } from 'node:path'
+import { createRequire } from 'node:module'
+import { fileURLToPath } from 'node:url'
 
 export interface WecomCliModule {
   id: string
@@ -17,6 +24,8 @@ export interface WecomCliStatus {
   authorized: boolean
   modules: WecomCliModule[]
   hint: string
+  /** Absolute path preferred for agent shell (suite-bundled). */
+  bin?: string
 }
 
 export interface WecomCliRunResult {
@@ -48,20 +57,25 @@ export const WECOM_CLI_CATALOG: readonly WecomCliModule[] = [
 const MODULE_LABELS = WECOM_CLI_CATALOG.map((row) => row.label).join('/')
 
 const HINT_MISSING = [
-  `未安装官方 wecom-cli（@wecom/cli >=1.1）。企微办公能力（${MODULE_LABELS}）走 CLI，不是 MCP。`,
-  '安装：npm i -g @wecom/cli ，然后 wecom-cli auth init。',
-  '官方已面向各规模企业开放通讯录等能力，不要再说「超过 10 人只能用文档」。',
-  '不要因为 rez_status 没有 wechat MCP 行就说没有企微能力。',
+  `未找到可用的 wecom-cli >=1.1（企微办公：${MODULE_LABELS}）。`,
+  'suite 已依赖 @wecom/cli@1.1.0：请重装 @rezti/dsh-rez-suite，或确认 profile 的 node_modules 里有 @wecom/cli。',
+  '不要用 Homebrew 全局 0.1.x（没有 mail/auth）。不要因为没有 wechat MCP 就说没有企微能力。',
+].join('')
+
+const HINT_OUTDATED = [
+  'PATH 上的 wecom-cli 过旧（<1.1，没有 mail 等子命令）。',
+  '请用 suite 自带的 @wecom/cli@1.1.0：重装 suite，或把 profile node_modules/.bin 放在 PATH 最前。',
+  '不要 npm i -g 覆盖到旧 Homebrew 路径前面仍是 0.1.9。',
 ].join('')
 
 const HINT_UNAUTH = [
-  '已安装 wecom-cli，尚未授权。跑 wecom-cli auth init。',
+  '已安装 wecom-cli >=1.1，尚未授权。跑 wecom-cli auth init（可扫码）。',
   `授权后可用：${MODULE_LABELS}。本企业已开通这些品类。`,
   'CLI 报某模块未授权才说该能力未开通；不要说「没有企微 MCP」，也不要说 10 人限制。',
 ].join('')
 
 const HINT_OK = [
-  `企微办公能力走 wecom-cli >=1.1（${MODULE_LABELS}）。本企业已开通。`,
+  `企微办公能力走 wecom-cli >=1.1（${MODULE_LABELS}）。本企业已开通。suite 已带 @wecom/cli。`,
   '按房间里官方 wecomcli-* 技能执行，命令以 wecom-cli <模块> --help 为准。',
   '不要用旧帮助中心「超过 10 人只能用文档」的说法。CLI 报未授权才说该模块未开通。',
   '设置页 BotID+Secret 只是房间消息通道。不要把没有 mcp__wechat__* 当成没有企微能力。',
@@ -79,8 +93,46 @@ export function parseWecomCliHelpModules(helpText: string): WecomCliModule[] {
   })
 }
 
+/** Resolve suite-bundled @wecom/cli binary; undefined if not installed next to suite. */
+export function resolveWecomCliBin(): string | undefined {
+  const require = createRequire(import.meta.url)
+  try {
+    const pkgJson = require.resolve('@wecom/cli/package.json')
+    const bin = join(dirname(pkgJson), 'bin', 'wecom.js')
+    if (existsSync(bin)) return bin
+  } catch {
+    // not hoisted next to this module
+  }
+  // Fallbacks when published layout differs
+  const here = dirname(fileURLToPath(import.meta.url))
+  for (const candidate of [
+    join(here, '..', 'node_modules', '@wecom', 'cli', 'bin', 'wecom.js'),
+    join(here, '..', '..', 'node_modules', '@wecom', 'cli', 'bin', 'wecom.js'),
+    join(here, '..', '..', '..', 'node_modules', '@wecom', 'cli', 'bin', 'wecom.js'),
+  ]) {
+    if (existsSync(candidate)) return candidate
+  }
+  return undefined
+}
+
+/** Put suite-bundled wecom-cli ahead of global Homebrew 0.1.x on PATH. */
+export function ensureWecomCliOnPath(): string | undefined {
+  const bin = resolveWecomCliBin()
+  if (bin === undefined) return undefined
+  const dir = dirname(bin)
+  const pathKey = process.platform === 'win32' ? 'Path' : 'PATH'
+  const current = process.env[pathKey] ?? ''
+  const parts = current.split(process.platform === 'win32' ? ';' : ':').filter(Boolean)
+  if (parts[0] !== dir) {
+    process.env[pathKey] = [dir, ...parts.filter((p) => p !== dir)].join(process.platform === 'win32' ? ';' : ':')
+  }
+  return bin
+}
+
 export function defaultWecomCliRunner(argv: string[]): WecomCliRunResult {
-  const result = spawnSync('wecom-cli', argv, {
+  const bundled = resolveWecomCliBin()
+  const cmd = bundled ?? 'wecom-cli'
+  const result = spawnSync(cmd, argv, {
     encoding: 'utf8',
     timeout: 4000,
     env: process.env,
@@ -99,27 +151,44 @@ function looksUnauthorized(text: string, status: number | null): boolean {
   return /未授权|未登录|未初始化|not (logged|auth)|unauthorized|请先.*auth|auth init/i.test(text)
 }
 
+/** 0.1.x has no mail; 1.1 help lists mail. */
+export function isWecomCliModern(helpOrVersionText: string): boolean {
+  const text = helpOrVersionText.toLowerCase()
+  if (/\b0\.1\.\d+\b/.test(text) && !/\b1\.\d+\.\d+\b/.test(text)) return false
+  if (/\bunrecognized subcommand\b/.test(text)) return false
+  if (/\bmail\b/.test(text)) return true
+  if (/\b1\.\d+\.\d+\b/.test(text) || /wecom-cli\s*\(?\s*1\./i.test(helpOrVersionText)) return true
+  return false
+}
+
 function withCatalog(partial: Omit<WecomCliStatus, 'modules'>): WecomCliStatus {
   return { ...partial, modules: wecomCliCatalog() }
 }
 
 export function probeWecomCli(run: WecomCliRunner = defaultWecomCliRunner): WecomCliStatus {
+  const bin = resolveWecomCliBin()
   const help = run(['--help'])
   if (help.errorCode === 'ENOENT') {
-    return withCatalog({ installed: false, authorized: false, hint: HINT_MISSING })
+    return withCatalog({ installed: false, authorized: false, hint: HINT_MISSING, bin })
   }
   const helpText = help.stdout + help.stderr
   if (help.status !== 0 && helpText.trim().length === 0) {
-    return withCatalog({ installed: false, authorized: false, hint: HINT_MISSING })
+    return withCatalog({ installed: false, authorized: false, hint: HINT_MISSING, bin })
+  }
+
+  const version = run(['--version'])
+  const versionText = version.stdout + version.stderr
+  if (!isWecomCliModern(helpText + '\n' + versionText)) {
+    return withCatalog({ installed: false, authorized: false, hint: HINT_OUTDATED, bin })
   }
 
   const auth = run(['auth', 'show'])
   const text = auth.stdout + auth.stderr
   if (auth.errorCode === 'ENOENT') {
-    return withCatalog({ installed: false, authorized: false, hint: HINT_MISSING })
+    return withCatalog({ installed: false, authorized: false, hint: HINT_MISSING, bin })
   }
   if (looksUnauthorized(text, auth.status)) {
-    return withCatalog({ installed: true, authorized: false, hint: HINT_UNAUTH })
+    return withCatalog({ installed: true, authorized: false, hint: HINT_UNAUTH, bin })
   }
-  return withCatalog({ installed: true, authorized: true, hint: HINT_OK })
+  return withCatalog({ installed: true, authorized: true, hint: HINT_OK, bin })
 }

package/templates/shared/wecom-cli.SOURCE.md

@@ -6,4 +6,4 @@
 
 雷泽自己的索引是 `wecom-office/SKILL.md`。
 
-运行时 CLI：`npm i -g @wecom/cli@>=1.1.0`，然后 `wecom-cli auth init`。`0.1.x` 命令面不同，不要混用。
+运行时 CLI：suite 依赖钉 `@wecom/cli@1.1.0`（随插件进 profile）。启动时把其 `bin` 目录插到 PATH 最前，避开 Homebrew 全局 `0.1.x`。授权：`wecom-cli auth init`。`wecomcli-shared` 的安装步骤已改成「重装 suite」，不要再引导 `npm i -g`。

package/templates/shared/wecom-office/SKILL.md

@@ -28,5 +28,5 @@ description: 企业微信办公能力索引。官方 wecom-cli v1.1+ 已面向
 2. 先读 `wecomcli-shared`，再读对应 `wecomcli-*`。子命令以 `wecom-cli <模块> --help` 为准。
 3. CLI 返回未授权 / 无权限，才说**该模块未开通**。不要总结成「当前系统没有企业微信 MCP」，也不要说「超过 10 人没有通讯录」。
 4. 设置页 **BotID + Secret** 是房间**消息通道**（同事在企微跟哪个 bot 说话进哪个 Harness 房间）。**继续用手填绑定，不要改成扫码。**
-5. 办公 API 另走 `wecom-cli auth init`（官方支持扫码，也可 `--manual`）。两套凭证不要混。
+5. 办公 API：suite 已带 `@wecom/cli@1.1.0`。授权跑 `wecom-cli auth init`（可扫码）。若 PATH 上是 Homebrew `0.1.9`，改用 profile / `npx --no-install wecom-cli`。两套凭证不要混。
 6. 未另批前不要群发、不要改通讯录结构、不要对外发邮件。

package/templates/shared/wecomcli-shared/SKILL.md

@@ -11,18 +11,19 @@ description: wecom-cli 业务技能的公共前置检查、获取机器人及授
 
 ## Step 1：检查 CLI 安装与版本
 
+ReZ-TI suite 已依赖 `@wecom/cli@1.1.0`（随 `dsh plugin add @rezti/dsh-rez-suite` 装进 profile）。**优先用 profile 里的二进制**，不要用 Homebrew 全局 `0.1.x`（没有 `mail` / 完整 `auth`）。
+
 ```bash
 wecom-cli --version
+# 若输出是 0.1.x，或 which wecom-cli 指向 /opt/homebrew，改用：
+# npx --no-install wecom-cli --version
+# 或：node "$(node -p \"require('path').join(require('path').dirname(require.resolve('@wecom/cli/package.json')),'bin/wecom.js')\")" --version
 ```
 
-- 命令成功，且输出中的版本号不低于 `1.1.0` → 继续 Step 2。
-- 命令不存在、执行报错或版本号低于 `1.1.0` → 执行安装/升级：
-
-```bash
-npm install -g @wecom/cli
-```
+- 命令成功，且版本号不低于 `1.1.0` → 继续 Step 2。
+- 命令不存在、执行报错或版本仍低于 `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 **最前**。
 
-安装完成后重新执行 `wecom-cli --version`；仍失败或版本仍低于 `1.1.0` 时停止业务操作，并把错误告知用户。
+安装/重装后重新执行 `wecom-cli --version`；仍失败或版本仍低于 `1.1.0` 时停止业务操作，并把错误告知用户。
 
 ## Step 2：检查授权状态