@rezti/dsh-rez-suite 0.1.50 → 0.1.52

package/CHANGELOG.md

@@ -5,12 +5,22 @@
 升级：
 
 ```bash
-dsh plugin --profile web add @rezti/dsh-rez-suite@0.1.50
+dsh plugin --profile web add @rezti/dsh-rez-suite@0.1.52
 ```
 
-不要用裸 `plugin update`，不要写 `latest`（新 profile 有 24 小时发布冷却，当天可能装不上）。不要装 **0.1.46**（GitHub 子依赖会被 DSH 拦住）。
+不要用裸 `plugin update`，不要写 `latest`（新 profile 有 24 小时发布冷却，当天可能装不上）。不要装 **0.1.46**（GitHub 子依赖会被 DSH 拦住）。不要装 **0.1.51**（误用 `npm publish` 把 `workspace:` 打进包了）。
 
-发版顺序：`wechat@0.1.16` → `suite@0.1.50`。
+发版顺序：`wechat@0.1.16` → `suite@0.1.52`。**必须用 `pnpm publish`**（会把 `workspace:` 写成真实版本），不要用 `npm publish`。
+
+## 0.1.52 — 2026-08-20
+
+- **安装修复**：0.1.51 报 `ERR_PNPM_WORKSPACE_PKG_NOT_FOUND`。请装 0.1.52。内容同 0.1.51（官方 wecomcli references 整包 + 房间仍 BotID/Secret）。
+
+## 0.1.51 — 2026-08-20
+
+- **企微办公技能补全 references**：官方 `wecomcli-*` 整包种进房间（含 `references/` / `assets/` / `scripts/`），种子不再只拷 `SKILL.md`。办公授权继续 `wecom-cli auth init`（可扫码）；**房间消息通道仍用设置页 BotID + Secret**，不改成扫码。
+- CLI 请用 `@wecom/cli >=1.1.0`（`0.1.x` 命令面不同）。
+- **勿装**：本版 npm 包依赖含 `workspace:`，员工 profile 装不上。
 
 ## 0.1.50 — 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.50`。员工机安装包仍钉已发布的 suite，不要顺手改审批镜像 `SUITE_VERSION`。
+发版顺序（必做）：先发 `@rezti/dsh-rez-wechat@0.1.16` → `@rezti/dsh-rez-suite@0.1.52`。**发 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 因此装不上）。
 
-员工机不要 `SUITE_VERSION=latest`：新 profile 默认 `minimumReleaseAge: 1440`，当天发的包可能装不到。钉死 `0.1.48`，或把 profile 的 `minimumReleaseAge` 改成 `0`。
+员工机不要 `SUITE_VERSION=latest`：新 profile 默认 `minimumReleaseAge: 1440`，当天发的包可能装不到。钉死版本，或把 profile 的 `minimumReleaseAge` 改成 `0`。
 
 ```bash
 # 第一次 / 升级（钉死版本，避开 24h 发布冷却）
-dsh plugin --profile web add @rezti/dsh-rez-suite@0.1.50
+dsh plugin --profile web add @rezti/dsh-rez-suite@0.1.52
 ```
 
 本版改了什么：见 [CHANGELOG.md](./CHANGELOG.md)。

package/lib/client.d.ts

@@ -7367,16 +7367,16 @@ declare const zh: {
   readonly 'audit.empty': "暂无记录";
   readonly 'changelog.current': "当前 {version}";
   readonly 'changelog.upgrade': "升级：";
-  readonly 'board.hint': "合同 Account 拆两室：媒体走「发布」，电商走「电商」（一期只阿里巴巴国际站；Amazon 等有号）。不是独立后台。密钥不在这里。";
+  readonly 'board.hint': "合同 Account 拆两室：媒体走「发布」，电商走「电商」（一期只阿里巴巴国际站；Amazon 等有号）。看板要搭在本页签，不是独立后台。页签壳不算完成。密钥不在这里。";
   readonly 'board.people': "People / 权限";
   readonly 'board.peopleHint': "继续 Odoo 员工帐号（公司/记录规则）+ 企业微信一房间一 bot。不新建权限库，不改 Odoo 权限组。";
   readonly 'board.role': "当前 Harness 身份：{role}（只决定侧栏房间）";
   readonly 'board.media': "媒体连接";
   readonly 'board.mediaHint': "内容/社媒在「发布」工作间（Post editor）。不建图库。";
   readonly 'board.ecommerce': "电商平台";
-  readonly 'board.ecommerceHint': "Listing 在「电商」工作间。一期只有阿里巴巴国际站。渠道商品 ID 写回 Odoo，库存从 Odoo 推到阿里。Amazon 没有号，标后续。";
+  readonly 'board.ecommerceHint': "Listing 在「电商」工作间。一期只有阿里巴巴国际站。同一 SKU 可挂多条链接，已有链接仍可关联继续发。渠道商品 ID 写回 Odoo，库存从 Odoo 推到阿里。Amazon 没有号，标后续。";
   readonly 'board.rag': "RAG";
-  readonly 'board.ragHint': "基于已有 Dify，知识库对接 Nextcloud 锁死路径（Standards + Marketing/Publish）。Harness 不做推理。";
+  readonly 'board.ragHint': "发布用 Dify 知识库要对齐 Nextcloud 锁死路径（Standards + Marketing/Publish）。实例已有，不要另装；知识库搭建是发布需求一部分，不要当基线跳过。Harness 不做推理。";
   readonly 'board.inbox': "Message inbox";
   readonly 'board.inboxHint': "一期只做 WhatsApp Business，会话落到 Odoo（浙江雷泽，Business 号已有）。不用官方收费模块，走社区 add-on（OCA mail_gateway_whatsapp）。禁止自写 Meta 客户端。生产安装另开窗口。";
   readonly 'board.col.source': "来源";

package/lib/client.js

@@ -251,16 +251,16 @@ const zh = {
 	"audit.empty": "暂无记录",
 	"changelog.current": "当前 {version}",
 	"changelog.upgrade": "升级：",
-	"board.hint": "合同 Account 拆两室：媒体走「发布」，电商走「电商」（一期只阿里巴巴国际站；Amazon 等有号）。不是独立后台。密钥不在这里。",
+	"board.hint": "合同 Account 拆两室：媒体走「发布」，电商走「电商」（一期只阿里巴巴国际站；Amazon 等有号）。看板要搭在本页签，不是独立后台。页签壳不算完成。密钥不在这里。",
 	"board.people": "People / 权限",
 	"board.peopleHint": "继续 Odoo 员工帐号（公司/记录规则）+ 企业微信一房间一 bot。不新建权限库，不改 Odoo 权限组。",
 	"board.role": "当前 Harness 身份：{role}（只决定侧栏房间）",
 	"board.media": "媒体连接",
 	"board.mediaHint": "内容/社媒在「发布」工作间（Post editor）。不建图库。",
 	"board.ecommerce": "电商平台",
-	"board.ecommerceHint": "Listing 在「电商」工作间。一期只有阿里巴巴国际站。渠道商品 ID 写回 Odoo，库存从 Odoo 推到阿里。Amazon 没有号，标后续。",
+	"board.ecommerceHint": "Listing 在「电商」工作间。一期只有阿里巴巴国际站。同一 SKU 可挂多条链接，已有链接仍可关联继续发。渠道商品 ID 写回 Odoo，库存从 Odoo 推到阿里。Amazon 没有号，标后续。",
 	"board.rag": "RAG",
-	"board.ragHint": "基于已有 Dify，知识库对接 Nextcloud 锁死路径（Standards + Marketing/Publish）。Harness 不做推理。",
+	"board.ragHint": "发布用 Dify 知识库要对齐 Nextcloud 锁死路径（Standards + Marketing/Publish）。实例已有，不要另装；知识库搭建是发布需求一部分，不要当基线跳过。Harness 不做推理。",
 	"board.inbox": "Message inbox",
 	"board.inboxHint": "一期只做 WhatsApp Business，会话落到 Odoo（浙江雷泽，Business 号已有）。不用官方收费模块，走社区 add-on（OCA mail_gateway_whatsapp）。禁止自写 Meta 客户端。生产安装另开窗口。",
 	"board.col.source": "来源",
@@ -414,16 +414,16 @@ const en = {
 	"audit.empty": "No records",
 	"changelog.current": "Now {version}",
 	"changelog.upgrade": "Upgrade:",
-	"board.hint": "Account connections split into two rooms: media in 发布, ecommerce in 电商 (phase 1: Alibaba.com only; Amazon waits for an account). Not a separate admin site. Secrets stay off this board.",
+	"board.hint": "Account connections split into two rooms: media in 发布, ecommerce in 电商 (phase 1: Alibaba.com only; Amazon waits for an account). This settings tab is the board to build; the shell is not done. Not a separate admin site. Secrets stay off this board.",
 	"board.people": "People / permissions",
 	"board.peopleHint": "Keep Odoo employee accounts (company / record rules) plus one WeCom AI bot per room. No new ACL database. Do not change Odoo groups.",
 	"board.role": "Current Harness identity: {role} (sidebar rooms only)",
 	"board.media": "Media connections",
 	"board.mediaHint": "Content / social lives in the 发布 room (Post editor). No media library.",
 	"board.ecommerce": "Ecommerce platforms",
-	"board.ecommerceHint": "Listings live in the 电商 room. Phase 1 is Alibaba.com. Write channel product IDs back to Odoo and push stock Odoo → Alibaba. Amazon is later until we have an account.",
+	"board.ecommerceHint": "Listings live in the 电商 room. Phase 1 is Alibaba.com. One SKU can have many links; an existing URL does not block associating another. Write channel product IDs back to Odoo and push stock Odoo → Alibaba. Amazon is later until we have an account.",
 	"board.rag": "RAG",
-	"board.ragHint": "Reuse Dify. Index Nextcloud locked paths (Standards + Marketing/Publish). Harness does not run embeddings.",
+	"board.ragHint": "Publish knowledge bases on existing Dify must index Nextcloud locked paths (Standards + Marketing/Publish). Do not reinstall Dify or treat baseline 0867 as done. Harness does not run embeddings.",
 	"board.inbox": "Message inbox",
 	"board.inboxHint": "Phase 1 is WhatsApp Business into Odoo (Zhejiang ReZ-TI; WABA already exists). Skip the paid official module; reuse OCA mail_gateway_whatsapp. No homemade Meta client. Production install needs a separate window.",
 	"board.col.source": "Source",
@@ -994,6 +994,34 @@ function ChannelTable({ kind, lang }) {
 //#endregion
 //#region src/changelog.ts
 const SUITE_CHANGELOG = [
+	{
+		version: "0.1.52",
+		date: "2026-08-20",
+		sections: [{
+			title: {
+				zh: "安装修复",
+				en: "Install fix"
+			},
+			items: [{
+				zh: "0.1.51 报 ERR_PNPM_WORKSPACE_PKG_NOT_FOUND（npm publish 把 workspace: 打进包）。请装 0.1.52。内容同 0.1.51：wecomcli references 整包；房间仍 BotID+Secret。",
+				en: "0.1.51 failed with ERR_PNPM_WORKSPACE_PKG_NOT_FOUND because npm publish left workspace: deps. Install 0.1.52. Same content as 0.1.51: full wecomcli references; room bots still BotID+Secret."
+			}]
+		}]
+	},
+	{
+		version: "0.1.51",
+		date: "2026-08-20",
+		sections: [{
+			title: {
+				zh: "企微办公技能补全",
+				en: "WeCom office skill pack"
+			},
+			items: [{
+				zh: "官方 wecomcli-* 整包种进房间（含 references）。办公用 wecom-cli auth init（可扫码）；房间消息通道仍设置页 BotID+Secret，不改扫码。请装 @wecom/cli >=1.1.0。勿装本版：依赖含 workspace:。",
+				en: "Vendor full upstream wecomcli-* skills including references. Office auth stays wecom-cli auth init (QR OK); room chat still uses settings BotID+Secret. Use @wecom/cli >=1.1.0. Do not install this version: published with workspace: deps."
+			}]
+		}]
+	},
 	{
 		version: "0.1.50",
 		date: "2026-08-20",

package/lib/index.js

@@ -3276,7 +3276,7 @@ const WECOM_CLI_CATALOG = [
 		label: "会议"
 	},
 	{
-		id: "email",
+		id: "mail",
 		label: "邮件"
 	},
 	{
@@ -8390,13 +8390,16 @@ function defaultSharedTemplatesRoot() {
 function seedSharedSkills(dest, written) {
 	const root = defaultSharedTemplatesRoot();
 	for (const name of readdirSync(root).sort()) {
-		const src = join(root, name, "SKILL.md");
-		if (!existsSync(src)) continue;
-		const rel = join(".agents", "skills", name, "SKILL.md");
-		const target = join(dest, rel);
-		mkdirSync(dirname(target), { recursive: true });
-		writeFileSync(target, readFileSync(src));
-		written.push(rel);
+		const skillDir = join(root, name);
+		if (!statSync(skillDir).isDirectory()) continue;
+		if (!existsSync(join(skillDir, "SKILL.md"))) continue;
+		for (const abs of listFiles(skillDir)) {
+			const rel = join(".agents", "skills", name, relative(skillDir, abs));
+			const target = join(dest, rel);
+			mkdirSync(dirname(target), { recursive: true });
+			writeFileSync(target, readFileSync(abs));
+			written.push(rel);
+		}
 	}
 }
 function listFiles(root) {

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.50",
-  "version": "0.1.50",
+  "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",
   "type": "module",
   "engines": {
     "node": "^22.19.0 || >=24.0.0"

package/src/boss/seed.ts

@@ -192,13 +192,18 @@ export function defaultSharedTemplatesRoot(): string {
 function seedSharedSkills(dest: string, written: string[]): void {
   const root = defaultSharedTemplatesRoot()
   for (const name of readdirSync(root).sort()) {
-    const src = join(root, name, 'SKILL.md')
-    if (!existsSync(src)) continue
-    const rel = join('.agents', 'skills', name, 'SKILL.md')
-    const target = join(dest, rel)
-    mkdirSync(dirname(target), { recursive: true })
-    writeFileSync(target, readFileSync(src))
-    written.push(rel)
+    const skillDir = join(root, name)
+    if (!statSync(skillDir).isDirectory()) continue
+    if (!existsSync(join(skillDir, 'SKILL.md'))) continue
+    // Official wecomcli-* skills ship references/assets/scripts next to SKILL.md.
+    for (const abs of listFiles(skillDir)) {
+      const relInside = relative(skillDir, abs)
+      const rel = join('.agents', 'skills', name, relInside)
+      const target = join(dest, rel)
+      mkdirSync(dirname(target), { recursive: true })
+      writeFileSync(target, readFileSync(abs))
+      written.push(rel)
+    }
   }
 }
 

package/src/changelog.ts

@@ -20,6 +20,36 @@ export interface ChangelogRelease {
 }
 
 export const SUITE_CHANGELOG: readonly ChangelogRelease[] = [
+  {
+    version: '0.1.52',
+    date: '2026-08-20',
+    sections: [
+      {
+        title: { zh: '安装修复', en: 'Install fix' },
+        items: [
+          {
+            zh: '0.1.51 报 ERR_PNPM_WORKSPACE_PKG_NOT_FOUND（npm publish 把 workspace: 打进包）。请装 0.1.52。内容同 0.1.51：wecomcli references 整包；房间仍 BotID+Secret。',
+            en: '0.1.51 failed with ERR_PNPM_WORKSPACE_PKG_NOT_FOUND because npm publish left workspace: deps. Install 0.1.52. Same content as 0.1.51: full wecomcli references; room bots still BotID+Secret.',
+          },
+        ],
+      },
+    ],
+  },
+  {
+    version: '0.1.51',
+    date: '2026-08-20',
+    sections: [
+      {
+        title: { zh: '企微办公技能补全', en: 'WeCom office skill pack' },
+        items: [
+          {
+            zh: '官方 wecomcli-* 整包种进房间（含 references）。办公用 wecom-cli auth init（可扫码）；房间消息通道仍设置页 BotID+Secret，不改扫码。请装 @wecom/cli >=1.1.0。勿装本版：依赖含 workspace:。',
+            en: 'Vendor full upstream wecomcli-* skills including references. Office auth stays wecom-cli auth init (QR OK); room chat still uses settings BotID+Secret. Use @wecom/cli >=1.1.0. Do not install this version: published with workspace: deps.',
+          },
+        ],
+      },
+    ],
+  },
   {
     version: '0.1.50',
     date: '2026-08-20',

package/src/client/locales.ts

@@ -121,16 +121,16 @@ export const zh = {
   'audit.empty': '暂无记录',
   'changelog.current': '当前 {version}',
   'changelog.upgrade': '升级：',
-  'board.hint': '合同 Account 拆两室：媒体走「发布」，电商走「电商」（一期只阿里巴巴国际站；Amazon 等有号）。不是独立后台。密钥不在这里。',
+  'board.hint': '合同 Account 拆两室：媒体走「发布」，电商走「电商」（一期只阿里巴巴国际站；Amazon 等有号）。看板要搭在本页签，不是独立后台。页签壳不算完成。密钥不在这里。',
   'board.people': 'People / 权限',
   'board.peopleHint': '继续 Odoo 员工帐号（公司/记录规则）+ 企业微信一房间一 bot。不新建权限库，不改 Odoo 权限组。',
   'board.role': '当前 Harness 身份：{role}（只决定侧栏房间）',
   'board.media': '媒体连接',
   'board.mediaHint': '内容/社媒在「发布」工作间（Post editor）。不建图库。',
   'board.ecommerce': '电商平台',
-  'board.ecommerceHint': 'Listing 在「电商」工作间。一期只有阿里巴巴国际站。渠道商品 ID 写回 Odoo，库存从 Odoo 推到阿里。Amazon 没有号，标后续。',
+  'board.ecommerceHint': 'Listing 在「电商」工作间。一期只有阿里巴巴国际站。同一 SKU 可挂多条链接，已有链接仍可关联继续发。渠道商品 ID 写回 Odoo，库存从 Odoo 推到阿里。Amazon 没有号，标后续。',
   'board.rag': 'RAG',
-  'board.ragHint': '基于已有 Dify，知识库对接 Nextcloud 锁死路径（Standards + Marketing/Publish）。Harness 不做推理。',
+  'board.ragHint': '发布用 Dify 知识库要对齐 Nextcloud 锁死路径（Standards + Marketing/Publish）。实例已有，不要另装；知识库搭建是发布需求一部分，不要当基线跳过。Harness 不做推理。',
   'board.inbox': 'Message inbox',
   'board.inboxHint': '一期只做 WhatsApp Business，会话落到 Odoo（浙江雷泽，Business 号已有）。不用官方收费模块，走社区 add-on（OCA mail_gateway_whatsapp）。禁止自写 Meta 客户端。生产安装另开窗口。',
   'board.col.source': '来源',
@@ -288,16 +288,16 @@ export const en: Record<RezKey, string> = {
   'audit.empty': 'No records',
   'changelog.current': 'Now {version}',
   'changelog.upgrade': 'Upgrade:',
-  'board.hint': 'Account connections split into two rooms: media in 发布, ecommerce in 电商 (phase 1: Alibaba.com only; Amazon waits for an account). Not a separate admin site. Secrets stay off this board.',
+  'board.hint': 'Account connections split into two rooms: media in 发布, ecommerce in 电商 (phase 1: Alibaba.com only; Amazon waits for an account). This settings tab is the board to build; the shell is not done. Not a separate admin site. Secrets stay off this board.',
   'board.people': 'People / permissions',
   'board.peopleHint': 'Keep Odoo employee accounts (company / record rules) plus one WeCom AI bot per room. No new ACL database. Do not change Odoo groups.',
   'board.role': 'Current Harness identity: {role} (sidebar rooms only)',
   'board.media': 'Media connections',
   'board.mediaHint': 'Content / social lives in the 发布 room (Post editor). No media library.',
   'board.ecommerce': 'Ecommerce platforms',
-  'board.ecommerceHint': 'Listings live in the 电商 room. Phase 1 is Alibaba.com. Write channel product IDs back to Odoo and push stock Odoo → Alibaba. Amazon is later until we have an account.',
+  'board.ecommerceHint': 'Listings live in the 电商 room. Phase 1 is Alibaba.com. One SKU can have many links; an existing URL does not block associating another. Write channel product IDs back to Odoo and push stock Odoo → Alibaba. Amazon is later until we have an account.',
   'board.rag': 'RAG',
-  'board.ragHint': 'Reuse Dify. Index Nextcloud locked paths (Standards + Marketing/Publish). Harness does not run embeddings.',
+  'board.ragHint': 'Publish knowledge bases on existing Dify must index Nextcloud locked paths (Standards + Marketing/Publish). Do not reinstall Dify or treat baseline 0867 as done. Harness does not run embeddings.',
   'board.inbox': 'Message inbox',
   'board.inboxHint': 'Phase 1 is WhatsApp Business into Odoo (Zhejiang ReZ-TI; WABA already exists). Skip the paid official module; reuse OCA mail_gateway_whatsapp. No homemade Meta client. Production install needs a separate window.',
   'board.col.source': 'Source',

package/src/wecom-cli.ts

@@ -39,7 +39,7 @@ export const WECOM_CLI_CATALOG: readonly WecomCliModule[] = [
   { id: 'todo', label: '待办' },
   { id: 'calendar', label: '日程' },
   { id: 'meeting', label: '会议' },
-  { id: 'email', label: '邮件' },
+  { id: 'mail', label: '邮件' },
   { id: 'disk', label: '微盘' },
   { id: 'message', label: '消息' },
   { id: 'media', label: '媒体文件' },

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

@@ -1,5 +1,9 @@
 # 官方 wecom-cli Skills 来源
 
-`wecomcli-*` 目录里的 `SKILL.md` 来自 [WecomTeam/wecom-cli](https://github.com/WecomTeam/wecom-cli)（MIT）。不要手改这些文件；升级时重新拉取。
+`wecomcli-*` 目录（含 `SKILL.md`、`references/`、`assets/`、`scripts/`）来自 [WecomTeam/wecom-cli](https://github.com/WecomTeam/wecom-cli)（MIT）。不要手改这些文件；升级时重新拉取整棵目录。
+
+官方安装还会跑 `npx skills add WeComTeam/wecom-cli`；本仓改成房间种子注入，效果等价，但必须整包拷贝，不能只留 `SKILL.md`。
 
 雷泽自己的索引是 `wecom-office/SKILL.md`。
+
+运行时 CLI：`npm i -g @wecom/cli@>=1.1.0`，然后 `wecom-cli auth init`。`0.1.x` 命令面不同，不要混用。

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

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

package/templates/shared/wecomcli-calendar/references/calendar-agenda.md

@@ -0,0 +1,224 @@
+# calendar schedules list / get — 查看日程安排
+
+查看近期日程安排或获取日程详情。只读操作，不修改任何日程。
+
+> **只给时间/日期时必须用 `list` [REQUIRED]**：用户只提供了时间/日期（如"19号那条"）而没有日程主题关键词时，必须走本文档的 `list` 按时间浏览，禁止把日期当关键词喂给 `search`。
+
+> **模糊查询同时拉会议 [REQUIRED]**：若本次是"会 / xx会 / 有什么会 / 最近有哪些会"等模糊查询（见 [SKILL.md 查询消歧](../SKILL.md)），除拉日程 `list` 外，必须同时 `读取 wecomcli-meeting 技能` 用相同时间范围拉会议 `list`，把两边结果合并、分「（会议）」「（日程）」两部分汇总展示（同一场会议按主题 + 时间去重）——不论日程是否查到都要查会议。明确是日程 / 安排（不带在线会议特征）时只查日程。
+
+## 命令
+
+### list — 读取日程列表
+
+```bash
+# 查看今天日程
+wecom-cli calendar schedules list --json '{"begin_time": "2026-04-07 00:00:00", "end_time": "2026-04-07 23:59:59"}'
+
+# 查看本周日程
+wecom-cli calendar schedules list --json '{"begin_time": "2026-04-06 00:00:00", "end_time": "2026-04-12 23:59:59"}'
+```
+
+**参数：**
+
+| 参数 | 类型 | 必填 | 说明 |
+|------|------|:----:|------|
+| `begin_time` | string | 否 | 查询开始时间（格式 YYYY-MM-DD HH:mm:ss）。必须与 `end_time` 同时传入或同时省略，禁止单独传入其中一个。 |
+| `end_time` | string | 否 | 查询结束时间（格式 YYYY-MM-DD HH:mm:ss）。必须与 `begin_time` 同时传入或同时省略，禁止单独传入其中一个；同时传入时，`end_time` 必须晚于 `begin_time`。 |
+
+> **时间参数约束**：`begin_time` 和 `end_time` 必须**同时存在**或**同时为空**，禁止只传其中一个。两者同时传入时，`end_time` 必须严格晚于 `begin_time`，否则视为非法参数。
+>
+> **查询窗口上限：当前时刻前后 30 天 [REQUIRED]**：`schedules list` 仅支持查询**当前时刻前后 30 天以内**的日程，超出范围的部分服务端不返回。
+> - 用户给的时间范围部分或完全超出窗口（`begin_time` 早于「今天 - 30 天」或 `end_time` 晚于「今天 + 30 天」）时，**直接告知用户「日程查询仅支持当前时刻前后 30 天范围内，请重新给一个更短的时间范围」**，等用户重新提供时间后再调用。
+>
+> **未指定时间时的默认范围策略 [REQUIRED]**：调用前先显式计算好时间范围再传入，不依赖服务端默认值——
+> - 用户已明确时间（如"今天"、"本周"、"4月15日到4月20日"）→ 直接映射为 `begin_time`/`end_time`。
+> - 用户未明确时间（如"查一下我的日程"、"看看我的安排"）→ **默认策略：今天起未来 7 天**（`begin_time = 今天 00:00:00`，`end_time = 7 天后 23:59:59`），无需追问。
+> - 用户说"最近"或"近期" → 使用"过去 3 天到未来 7 天"（`begin_time = 3 天前 00:00:00`，`end_time = 7 天后 23:59:59`）。
+> - 用户只提供了模糊但有意义的范围（如"上个月"）→ 解析为对应日期范围。
+
+**返回**：`schedule_list[]` 数组，每项字段如下：
+
+| 字段 | 类型 | 说明 |
+|------|------|------|
+| `schedule_id` | string | 日程 ID |
+| `subject` | string | 日程主题 |
+| `begin_time` | string | 开始时间（YYYY-MM-DD HH:mm:ss） |
+| `end_time` | string | 结束时间（YYYY-MM-DD HH:mm:ss） |
+| `attendees` | object[] | 参与人列表，格式 `[{"userid": "USERID", "name": "englishname(name)"}]` |
+| `meeting_room` | object | 会议室信息，含 `meeting_room_id` + `meeting_room_name` |
+| `location` | string | 日程地点 |
+| `meeting` | object | 在线会议信息（关联了会议时才有），含 `meeting_id`/`meeting_code` |
+| `description` | string | 日程描述 |
+| `creator_name` | string | 日程创建者名字 |
+| `allow_self_join` | bool | 是否允许非参与人主动加入日程 |
+| `is_all_day` | bool | 是否全天事件（`true` 是 / `false` 否） |
+| `repeat_rule` | object | 重复规则（`is_repeat=false` 时无此字段或为空），见下表 |
+| `reminders` | object | 提醒设置，含 `is_remind`（是否开启，bool，`true` 是 / `false` 否）和 `reminder_time`（int[]，与开始时间的差值秒数，负数为提前提醒） |
+| `timezone` | object | 时区信息，含 `timezone_id`（IANA 标识，如 `Asia/Shanghai`，优先使用）和 `timezone_offset`（UTC 偏移量秒数，`timezone_id` 为空时使用） |
+
+**`repeat_rule` 子字段（list 返回）：**
+
+| 字段 | 类型 | 说明 |
+|------|------|------|
+| `is_repeat` | bool | 是否重复日程 |
+| `repeat_type` | string | 重复类型：`daily`/`weekly`/`monthly`/`monthly_on_the_nth_day`/`yearly`/`yearly_on_the_nth_day`/`work_day` |
+| `repeat_flag` | string[] | 重复标记，数组，可选值：`leap_month`（闰月）、`never_ends`（永不结束） |
+| `repeat_time` | int | 重复次数，`0` 表示无限 |
+| `repeat_interval` | int | 重复间隔 |
+| `repeat_until` | string | 重复截止时间（格式 YYYY-MM-DD HH:mm:ss） |
+| `repeat_week_of_month` | string[] | 每月第几周，数组，可选值：`first`/`second`/`third`/`fourth`/`last` |
+| `repeat_day_of_week` | string[] | 每周周几，数组，可选值：`MO`/`TU`/`WE`/`TH`/`FR`/`SA`/`SU` |
+| `repeat_month_of_year` | int[] | 每年哪几个月，数组，取值范围：1~12 |
+| `repeat_day_of_month` | int[] | 每月哪几天，数组，取值范围：1~31 |
+| `is_custom` | bool | 是否自定义重复 |
+| `exception` | object[] | 例外日程列表，每项含 `begin_time`/`end_time`/`flag`/`except_schedule_id` |
+
+### get — 读取日程详情
+
+```bash
+wecom-cli calendar schedules get --json '{"schedule_ids": ["<schedule_id1>", "<schedule_id2>"]}'
+```
+
+**参数：**
+
+| 参数 | 类型 | 必填 | 说明 |
+|------|------|:----:|------|
+| `schedule_ids` | string[] | 是 | 日程 ID 列表，支持传入一个或多个 |
+
+**返回**：`schedule_list[]` 数组，每项字段如下：
+
+| 字段 | 类型 | 说明 |
+|------|------|------|
+| `schedule_id` | string | 日程 ID |
+| `subject` | string | 日程主题 |
+| `begin_time` | string | 开始时间（YYYY-MM-DD HH:mm:ss） |
+| `end_time` | string | 结束时间（YYYY-MM-DD HH:mm:ss） |
+| `attendees` | object[] | 参与人列表，格式 `[{"userid": "USERID", "name": "englishname(name)"}]`，直接取 `name` 展示，禁止展示 userid |
+| `meeting_room` | object | 会议室信息，含 `meeting_room_id` + `meeting_room_name` |
+| `location` | string | 日程地点 |
+| `meeting` | object | 在线会议信息（关联了会议时才有），含 `meeting_id`/`meeting_code` |
+| `description` | string | 日程描述 |
+| `creator_name` | string | 日程创建者名字 |
+| `allow_self_join` | bool | 是否允许非参与人主动加入日程 |
+| `is_all_day` | bool | 是否全天事件（`true` 是 / `false` 否） |
+| `repeat_rule` | object | 重复规则（`is_repeat=false` 时无此字段或为空），见下表 |
+| `reminders` | object | 提醒设置，含 `is_remind`（是否开启，bool，`true` 是 / `false` 否）和 `reminder_time`（int[]，与开始时间的差值秒数，负数为提前提醒） |
+| `timezone` | object | 时区信息，含 `timezone_id`（IANA 标识，如 `Asia/Shanghai`，优先使用）和 `timezone_offset`（UTC 偏移量秒数，`timezone_id` 为空时使用） |
+
+**`repeat_rule` 子字段：**
+
+| 字段 | 类型 | 说明 |
+|------|------|------|
+| `is_repeat` | bool | 是否重复日程 |
+| `repeat_type` | string | 重复类型：`daily`/`weekly`/`monthly`/`monthly_on_the_nth_day`/`yearly`/`yearly_on_the_nth_day`/`work_day` |
+| `repeat_flag` | string[] | 重复标记，数组，可选值：`leap_month`（闰月）、`never_ends`（永不结束） |
+| `repeat_time` | int | 重复次数，`0` 表示无限 |
+| `repeat_interval` | int | 重复间隔 |
+| `repeat_until` | string | 重复截止时间（格式 YYYY-MM-DD HH:mm:ss） |
+| `repeat_week_of_month` | string[] | 每月第几周，数组，可选值：`first`/`second`/`third`/`fourth`/`last` |
+| `repeat_day_of_week` | string[] | 每周周几，数组，可选值：`MO`/`TU`/`WE`/`TH`/`FR`/`SA`/`SU` |
+| `repeat_month_of_year` | int[] | 每年哪几个月，数组，取值范围：1~12 |
+| `repeat_day_of_month` | int[] | 每月哪几天，数组，取值范围：1~31 |
+| `is_custom` | bool | 是否自定义重复 |
+| `exception` | object[] | 例外日程列表，每项含 `begin_time`/`end_time`/`flag`/`except_schedule_id` |
+
+## 输出格式
+
+将结果整理为顺序的日程列表（**禁止使用 markdown 表格**，每条日程作为独立条目顺序输出，按开始时间升序排序）：
+
+```
+（会议）
+1. 产品评审
+   时间：4月7日 10:00-11:00
+   参与人：王五、赵六、钱七
+
+（日程）
+1. 站会
+   时间：4月7日 09:30-09:45
+   参与人：张三、李四
+
+共 2 场，其中会议 1 场、日程 1 场
+```
+
+> 上例为"模糊会议查询"（日程 + 会议都查）且**两类同时存在**时的呈现：合并日程 `list` 与会议 `list` 的结果，按是否含在线会议链接分成「（会议）」「（日程）」两个部分（来自会议 `list` 或 `meeting.meeting_code` 非空者归会议），同一场会议两边都出现时按"主题 + 时间"去重，末尾给汇总；若本次结果只有单一类别（全是会议或全是日程），则不分部分、不加「（会议）」/「（日程）」标题，按普通列表直接展示；普通"看日程"查询也可不分部分、省略汇总行。
+
+**展示规则：**
+- 每个条目 **只展示三项：主题、时间、参与人**（不展示地点、会议室等其他字段）。
+- **时间默认省略年份**（只到月日）；仅当日程年份与当前年份不同（跨年）时，才在月日前带上年份。
+- **昨天 / 今天 / 明天**的日程，时间行在月日前加相对词（如 `明天 6月11日 14:00-15:00`）；其余日期按月日展示。
+- **超过 10 条时只展示前 10 条**，并在末尾告知"还有 N 条，需要查看更多吗？"。
+- 参与人原样取接口返回的 `attendees[].name` 展示（完全与接口返回的格式保持一致，如返回 `zhangsan(张三)` 就展示 `zhangsan(张三)`），禁止展示 userid、schedule_id。
+- **会议 / 日程 分两部分展示**：判断依据是该日程是否带有会议链接——`meeting.meeting_code` 有值（非空）归为「会议」，为空 / 不存在归为「日程」。**仅当本次结果中同时存在「会议」和「日程」两类时**，才把结果分成「（会议）」和「（日程）」两个部分分别展示（每部分内按开始时间升序、逐条只列主题/时间/参与人）；**当结果只有单一类别时**（全是会议或全是日程），不分部分、不展示「（会议）」/「（日程）」标题，按普通列表直接展示即可。`search`/`list`/`get` 返回均含 `meeting` 字段，可直接判断，无需额外调用其它接口补 `get`。
+
+**模糊"会议"查询的汇总 [REQUIRED]**：当本次是"查会议/xx会"等需归类的查询（见 [SKILL.md 查询消歧](../SKILL.md)）时，在列表末尾追加一行汇总：`共 N 场，其中会议 X 场、日程 Y 场`。
+
+**时区标注**：日程 `timezone.timezone_offset != 28800`（非东八区）时，按 [SKILL.md 输出格式规范](../SKILL.md) 的时区标注规则在时间后带上时区，如 `14:00-15:00（纽约时间 UTC-5）`。
+
+### 周期日程标注规则 [REQUIRED]
+
+列表中存在 `repeat_rule.is_repeat=true` 的日程时，必须在该日程的**主题后追加**周期频率标注（不另起新字段，保持每个条目仍只有主题/时间/参与人三项），格式如下：
+
+```
+1. 每周站会（每周一次，截止 2026-12-31）
+   时间：4月7日（周一）09:00-09:30
+   参与人：张三、李四
+```
+
+**`repeat_type` 枚举值 → 可读文案映射：**
+
+| `repeat_type` | 含义 | 展示文案示例 |
+|:---:|------|------|
+| `daily` | 每天 | 每天一次 |
+| `weekly` | 每周 | 每周一次 |
+| `monthly` | 每月 | 每月一次 |
+| `monthly_on_the_nth_day` | 每月第N天 | 每月一次 |
+| `yearly` | 每年 | 每年一次 |
+| `yearly_on_the_nth_day` | 每年第N天 | 每年一次 |
+| `work_day` | 每个工作日 | 每工作日一次 |
+| 其他（`is_custom=true`） | 自定义 | 自定义周期 |
+
+**时间范围展示规则：**
+- `repeat_until` 非空 → 展示"截止 {repeat_until 的日期部分}"
+- `repeat_until` 为空 且 `repeat_time=0` → 展示"无截止"
+- `repeat_time > 0` → 展示"共 {repeat_time} 次"
+
+## 典型场景
+
+### 1. 查看今日日程
+
+```
+用户：今天有什么安排？
+→ 调用 list（today 00:00-23:59）
+→ 按开始时间升序，顺序输出每条日程（主题/时间/参与人），超过 10 条只展示前 10 条
+```
+
+### 2. 未指定时间范围，使用默认策略
+
+```
+用户：帮我看看我的日程安排
+→ 未指定时间范围，直接使用默认策略：今天起未来 7 天（无需追问）
+   begin_time = 今天 00:00:00，end_time = 7 天后 23:59:59
+→ 调用 list，按开始时间升序顺序输出每条日程（主题/时间/参与人）
+```
+
+### 3. 查看详情（需要周期规则、会议链接等）
+
+```
+用户：这个周会是每周开吗？
+→ 先从 list/search 结果中拿到 schedule_id
+→ 调用 get 获取详情，展示 repeat_rule
+```
+
+## 提示
+
+- 无日程时告知用户"今天日程清空"。
+- **查询窗口上限 [REQUIRED]**：`schedules list` 仅覆盖当前时刻前后 30 天以内。用户给的时间范围超出窗口时，直接告知用户超出可查范围、请重新给一个更短的时间范围，等用户重新提供后再调用。
+- **顺序列表展示**：每条日程作为独立条目顺序输出，禁止 markdown 表格，每个条目只含主题/时间/参与人。超过 10 条只展示前 10 条，并告知"还有 N 条，需要查看更多吗？"。
+- `list` 和 `get` 均返回 `repeat_rule`，可直接判断是否周期日程；`meeting`（含 `meeting_id`/`meeting_code`）在 `search`/`list`/`get` 中均直接返回，判断会议形态无需额外补 `get`。
+- **周期日程必须说明 [REQUIRED]**：结果中只要存在 `repeat_rule.is_repeat=true` 的日程，必须在该日程**主题后追加**周期频率（由 `repeat_type` 推导）和时间范围（由 `repeat_until`/`repeat_time` 推导）标注，保持条目仍只含主题/时间/参与人三项。禁止仅展示日程条目而不说明其为周期日程。
+- **参与人展示**：`list` 返回的 `attendees` 格式为 `[{"userid": "USERID", "name": "englishname(name)"}]`，直接取 `name` 字段展示，禁止展示 userid，无需反查通讯录。
+
+## 参考
+
+- [wecomcli-calendar](../SKILL.md) — 日程技能主文档
+- [calendar-search](calendar-search.md) — 按关键词搜索日程