@cubeai/dsh-feishu-channels 0.0.0-stage → 0.2.0

package/docs/ui-revamp-plan.md

@@ -0,0 +1,263 @@
+# 飞书频道 UI / 应用配置改造 — 可行性分析
+
+> 日期：2026-11-04  
+> 范围：在现有 `@cubeai/dsh-feishu-channels` 上调整设置入口、频道页、添加账号流程、扫码建应用后的配置、账号展示与账号设置。
+
+## 实施状态（2026-11-04）
+
+- 1–4、6 已实现；`pnpm test` 93 项通过，`pnpm run check` 通过。
+- `settings.section` 已无 `feishu-channel`；侧边栏仍保留 `任务 | 频道 | 飞书频道`。
+- 扫码 begin 已用真实飞书接口验证，QR URL 包含 `name`、`createOnly=true`、`addons`。
+- 应用配置 provisioning（名称/权限/重定向 URL）已实现；真实写入结果需要用户扫码创建测试账号后读取 `config.provisioning`。
+- 真实测试确认：缺少 `application:application:patch` 时写入失败；补上该权限后 v7 返回 success，5 个重定向 URL 全部写入，保留该操作。
+
+## 1. 总结论
+
+| # | 需求 | 可行性 | 关键说明 |
+|---|---|---|---|
+| 1 | 去掉 DSH 设置里的“飞书频道”，全部移到频道页 | **可** | 删除 `settings.section` 注册；频道页承载账号/设置/待批准 |
+| 2 | 频道页标题换成“添加飞书账号”按钮；右侧图标按钮去掉 | **可** | 用自绘账号页替换官方任务树头部，最直接 |
+| 3 | 点击按钮直接弹“配置飞书”对话框 | **可** | 频道页持有 `BindModal` 状态，不经过设置页 |
+| 4 | 对话框改名、只留快捷绑定、加“频道名称” | **可** | 隐藏手动页签/表单；`settings.name` 贯穿 QR 和账号保存 |
+| 5 | 新建 App 用输入名称、加两个权限、加 5 个重定向 URL | **部分可** | 名称/权限可在扫码确认页预填；重定向 URL 只能走应用管理 OpenAPI，存在平台限制，需真机验证 |
+| 6 | 添加后立即显示账号名；加“设置”按钮；显示 App ID/Secret | **可** | 账号来自 `/channels` 的 `accounts`，不依赖首条消息；Secret 只做掩码展示 |
+
+**结论：可以按这个方向改。** 1–4、6 是纯插件内改造；5 的“名称/权限”可以做预填，5 的“重定向 URL”要接受平台可能拒绝的事实，并准备降级提示。
+
+---
+
+## 2. 第 5 项：飞书平台能力核查
+
+### 2.1 名称：可以预填，不能保证锁定
+
+飞书 SDK 的 `registerApp` 支持 `appPreset.name`，它会被编码成二维码 URL 的 `name` 参数：
+
+```text
+verification_uri_complete?name=<输入的名称>
+```
+
+SDK 文档明确说明：这是**预填**，用户扫码后仍可在飞书确认页修改；最终名称以用户提交的为准。
+
+因此：
+
+- 我们在二维码 URL 里带上用户输入的“频道名称”，飞书建应用页会默认填好。
+- 创建成功后可以**尝试**调用 `application/v7/applicationBase.patch` 改名（`i18ns[].name`），但该接口文档注明“仅支持开发者后台创建的自建应用，不包含通过机器人助手等其他渠道创建的自建应用”，对扫码创建的 PersonalAgent **可能被拒绝**。
+- 不能承诺“用户在确认页无法改”。如果必须 100% 锁定，平台没有提供这个能力。
+
+### 2.2 权限：可在扫码确认页预填（addons）
+
+SDK 的 `registerApp` 支持 `addons.scopes`：
+
+```js
+addons: {
+  scopes: {
+    tenant: ['im:message'],
+    user: ['im:message.send_as_user'],
+  },
+}
+```
+
+SDK 会把 `addons` 做 `JSON → gzip → base64url`，放到二维码 URL 的 `addons` 参数。飞书确认页会把这些权限作为**增量**预填，用户确认后生效。
+
+注意：
+
+- SDK 注明：`addons` 需要平台灰度开启；未开启时整个参数会被忽略，走默认模板。
+- 平台目录里不存在的权限名会被静默丢弃；SDK 不校验名称。
+- 创建后可以再**尝试** `application/v7/applicationConfig.patch` 的 `scope.add_scopes`（`tenant` / `user`）作为兜底；该接口同样有“仅开发者后台应用”的限制，可能失败。
+- 建议绑定完成后调用 `application/v6/application.get` 校验实际 scopes；缺失时在账号设置里显示警告，不阻断绑定。
+
+### 2.3 重定向 URL：只能走应用管理 OpenAPI，且有限制
+
+`addons` **不支持** `security.*`（SDK 明确说敏感配置被拒绝）。重定向 URL 只能通过应用管理 API 写入：
+
+- 首选：`application/v7/applicationConfig.patch`
+  - `security.add.redirect_urls: string[]`
+  - 文档：修改重定向 URL 后立即生效。
+- 兜底：`application/v6/application.patch`
+  - `security.redirect_urls: string[]`（全量覆盖，需要先读现有列表并做并集）。
+- 名称兜底：`application/v7/applicationBase.patch`（`i18ns[].name`）。
+
+**关键风险：**
+
+- v7 文档注明：**仅支持开发者后台创建的自建应用，不包含通过机器人助手等其他渠道创建的自建应用**。扫码创建的 PersonalAgent 是否被归入“其他渠道”，需要真实应用验证。
+- 如果 v6/v7 都拒绝，插件没有合规的公开 API 可以替用户写入重定向 URL。
+- 降级方案（推荐）：
+  - 保存“待写入”的 5 个 URL；
+  - 在账号设置里显示“平台未允许自动写入”的提示和“复制全部 URL”按钮；
+  - 用户可在飞书开发者后台手动粘贴。
+- 不建议用用户浏览器 Cookie 去调开发者后台私有接口；不稳定且有安全风险。
+
+### 2.4 要写入的常量
+
+```js
+const FEISHU_REDIRECT_URLS = [
+  'http://127.0.0.1:3080/api/dsh-remote-feishu/oauth/callback',
+  'http://localhost:3080/api/dsh-remote-feishu/oauth/callback',
+  'http://127.0.0.1:32123/api/dsh-remote-feishu/oauth/callback',
+  'http://127.0.0.1:8731/api/oauth/callback',
+  'https://www.cubeai.com:6443/cubeaispace-dsh1-1234567890-dsh/api/dsh-remote-feishu/oauth/callback',
+]
+```
+
+按用户要求只添加，不校验这些地址是否可访问。
+
+### 2.5 建议的扫码 URL 参数
+
+```text
+name=<频道名称>
+createOnly=true
+source=dsh-feishu-channels
+addons=<gzip+base64url({ scopes: { tenant:['im:message'], user:['im:message.send_as_user'] } })>
+```
+
+保留当前 `begin` / `poll` 流程；域名仍固定 `accounts.feishu.cn`，Lark 租户继续拒绝。
+
+---
+
+## 3. 1–4、6 的界面与数据方案
+
+### 3.1 去掉设置页
+
+- 删除 `ctx.slots.inject('settings.section', ...)` 注册。
+- DSH 设置左侧不再出现“飞书频道”。
+- 频道页承载：
+  - 添加账号（BindModal）
+  - 账号列表/状态/接收开关
+  - 账号设置（AccountInspector）
+  - 待批准访问请求
+  - 诊断/重连/移除
+- `SettingsPage` 的账号/待批准/设置逻辑拆到频道页；`BindModal`、`AccountInspector` 保留复用。
+
+### 3.2 频道页布局
+
+```text
+[ 添加飞书账号 ]                    ← 左侧显式按钮；无“飞书频道”标题
+[待批准访问请求 ...]                ← 有则显示
+
+[飞书 logo] 飞书账号1   [已连接] [接收开关] [设置]
+  ├─ 会话标题 A                      10:32
+  ├─ 会话标题 B                      10:28
+  └─ 还没有会话，给机器人发一条消息
+
+[飞书 logo] 飞书账号2   [已停止] [接收开关] [设置]
+  └─ ...
+```
+
+- 页签本身的标签仍叫“飞书频道”（侧边栏 tab），去掉的是**页签内容里的标题行**。
+- 右侧官方树自带的 icon 添加按钮不再出现，因为不再渲染官方树头部。
+- 账号行名称来自 `account.name`（用户输入），不依赖首条消息或 LLM 标题。
+- 每个账号行有“设置”按钮，直接打开 `AccountInspector` 弹窗。
+
+### 3.3 数据来源
+
+- `/channels` 返回的 `channels[0].accounts`：账号列表，包含名称/状态/是否接收。
+- `/channels` 返回的 `groups[0].sessions`：会话列表；按 `session.channel === account.id` 归到账号下。
+- 新账号即使没有会话，也从 `accounts` 立即渲染，无需等消息。
+- `channelRefresh` 继续作为账号/会话的刷新 store；`onConnected` 后调用 `invalidate()`。
+
+### 3.4 BindModal 调整
+
+- 标题：`添加飞书账号`（不再拼“配置 飞书”）。
+- 删除页签栏与手动配置表单；`tab` 固定为 `qr`。
+- 顶部新增“频道名称”输入：
+  - 默认 `飞书账号${现有账号数 + 1}`；
+  - 写入 `settings.name`；
+  - QR `start` 请求带上该名称；
+  - 账号保存后名称即账号/频道名称。
+- 保留现有的工作区/模型/权限/预设/命令权限/扫码/刷新/取消逻辑。
+- 扫码开始前仍要求 workspace/model/permission 有效（与当前一致）。
+
+### 3.5 AccountInspector 增加 App ID / App Secret
+
+在现有字段顶部增加只读区：
+
+```text
+应用信息
+  App ID:     cli_xxx
+  App Secret: ••••••••   [已保存]
+```
+
+- 服务端 `accountView` 增加：
+  - `appId: config.appId`
+  - `hasAppSecret: Boolean(config.appSecretRef || config.appSecret)`
+  - `provisioning?: { checkedAt, nameOk, scopesMissing, redirectMissing }`
+- **不返回真实 Secret**；界面只显示掩码和“已保存”。
+- 如果用户需要“显示/复制 Secret”，需要另开一个受宿主认证保护的高敏接口；不建议默认开放。
+
+### 3.6 名称与账号保存
+
+- `settings.name` 由 BindModal 输入，QR `start` 传给 `PairingHub`。
+- `PairingHub` 的 `extra` 保存 settings；成功后 manager `connect` 的 `normalizeAccountSettings` 会持久化 `name`。
+- 账号 `account.name` 直接用于频道行名称；LLM 会话标题仍只影响会话行标题。
+- 如果名称为空，服务端回退到 `飞书账号 N`。
+
+---
+
+## 4. 需要改动的文件/接口
+
+### Host
+
+| 文件 | 改动 |
+|---|---|
+| `src/channels/qr/feishu.js` | `beginFeishuQr` 接收 `{name, addons}`；装饰 QR URL（`name`/`addons`/`createOnly`/`source`） |
+| `src/channels/qr/hub.js` | 把 `session.extra` 传给 `begin`；保持现有 poll/refresh/cancel |
+| `src/channels/feishu-provision.js`（新） | 应用管理：v7 config patch（scopes + redirect URLs）、v6 patch 兜底、v7 base 改名兜底、v6 get 校验 |
+| `src/manager.js` | `connectNow` 在保存凭据后调用 provisioning；`accountView` 返回 appId/hasAppSecret/provisioning；错误只记安全码 |
+| `src/channels/meta.js` | 若需要，增加应用配置相关字段（一般不用） |
+
+### Client
+
+| 文件/组件 | 改动 |
+|---|---|
+| `client.js` `apply` | 删除 `settings.section` 注册；保留 `sidebar.workspaces`/`sidebar.session.row.leading` |
+| 新 `FeishuChannelPage` | 账号页：添加按钮、账号行、会话、待批准、设置弹窗 |
+| `BindModal` | 标题/单页签/频道名称/旧逻辑保留 |
+| `AccountInspector` | 增加 App ID / App Secret 掩码 / provisioning 警告 |
+| `ChannelOfficialView` | 不再作为主视图；其会话/官方树逻辑可移除或保留为内部组件 |
+| locale | 新增/调整 `bind.title`、`account.name`、`app.id`、`app.secret`、`provisioning.*` 等 |
+
+### 不建议
+
+- 不建议修改 `dsh-im-connect`。
+- 不建议用 DOM 注入去改官方开发者后台页面。
+- 不建议把真实 App Secret 返回浏览器。
+
+---
+
+## 5. 实施阶段与工期
+
+| 阶段 | 内容 | 预估 |
+|---|---|---|
+| A | 数据/API：accountView appId/secret 掩码/provisioning；QR 参数 | 1.5 天 |
+| B | 应用配置 provisioning（v7/v6、校验、降级提示） | 2–3 天 |
+| C | 频道页重构：去设置页、账号行、会话、待批准、弹窗 | 3–4 天 |
+| D | BindModal 单页签/名称字段 | 1 天 |
+| E | AccountInspector App 信息 | 0.5 天 |
+| F | 测试（Host/Client）+ 真实飞书扫码验证 | 2–3 天 |
+| | **合计** | **10–13 人天** |
+
+第 5 项的真实应用验证是关键路径；如果 v7/v6 都拒绝 redirect URL，需要走降级提示。
+
+---
+
+## 6. 需要你确认的点
+
+1. **App 名称**：接受“扫码确认页预填 + 创建后尝试改名，但用户仍可在飞书确认页修改”吗？平台没有强制锁定能力。
+2. **重定向 URL**：若飞书拒绝自动写入（很可能只对开发者后台应用开放），接受“账号设置里显示未写入 + 复制全部 URL”作为降级吗？还是要强制要求开发者后台创建的应用？
+3. **App Secret**：只做掩码展示（推荐），还是需要“显示/复制真实 Secret”？后者要新增高敏接口。
+4. **频道页形态**：改为自绘账号/会话列表，替代官方任务树头部，因此会失去官方树的“分组方式/按工作区”等富交互；会保留搜索、打开会话、重命名、归档、删除等核心操作。可以接受吗？
+
+确认后我按 A→F 实施，先做 1–4、6，再做第 5 项的 provisioning 和真机验证。
+
+---
+
+## 参考
+
+- 本地 SDK 注册能力：`node_modules/@larksuiteoapi/node-sdk/README.zh.md`（`registerApp`、`appPreset`、`addons`）
+- 本地 SDK 类型：`node_modules/@larksuiteoapi/node-sdk/types/index.d.ts`
+  - `applicationConfig.patch`（v7，`scope.add_scopes`、`security.add.redirect_urls`）
+  - `applicationBase.patch`（v7，`i18ns[].name`）
+  - `application.patch`（v6，`security.redirect_urls`）
+- 飞书 v7 配置文档：<https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/application-v7/application-v7/application-config/patch>
+- 扫码注册流程与 `name` 预填：<https://github.com/multica-ai/multica/blob/f41fae6b08fb734afcbd13205c0b3203dd0bc9c6/server/internal/integrations/lark/registration.go>
+- 飞书 CLI 一键建机器人逆向调研：<https://github.com/op7418/codepilot/blob/1ae6d76de6993377dab961eacf04927babd99eb1/docs/research/feishu-cli-one-click-bot.md>

package/docs/verification.md

@@ -0,0 +1,120 @@
+# Verification
+
+## Current automated status (2026-11-04)
+
+- Package installed from `/home/hls/dev/dsh-remote-feishu/dsh-feishu-channels`
+  into the `web` profile as a local link.
+- Host plugin row is active (`Config.listConfigs` reports `feishu-channel`).
+- Host log `~/.dsh/dsh-feishu-channels/gateway.log` shows:
+  - `API 已注册 /api/dsh-feishu-channels`
+  - `apply 完成`
+  - `initEnabled`
+  - `attachMappedSessions`
+- `pnpm test` passes 94 tests.
+- `pnpm run check` passes (syntax, isolation, manifest, locale metadata).
+- After the page loaded the new Client module, live slot inspection reports:
+  - `settings.section` has **no** `feishu-channel` occupant (the settings entry was removed).
+  - `sidebar.session.row.leading` occupant `feishu-channel-session-channel`, order 10, active.
+- `conversation.composer` chain entry should appear after a page refresh; it replaces the
+  normal composer for `dfc:` sessions with a read-only Feishu notice.
+- The Client module therefore loaded and executed `apply` without a slot crash.
+- The shared tab bar itself is rendered inside the sidebar wrapper and is not exposed by
+  slot inspection; it still needs the visual check below.
+- Code-level coexistence evidence:
+  - A harness using the **real `dsh-im-connect@1.0.12` `SessionSwitcher`** with both a
+    `channels` tab and our `feishu` tab renders `任务 | 频道 | 飞书频道` and switches
+    content for all three tabs.
+  - Our own `SessionSwitcher` harness renders `任务 | 飞书频道`, inserts a foreign
+    `channels` tab at order 20, and keeps `飞书频道` at order 30.
+
+## Real Feishu provisioning verification (2026-11-04)
+
+- Two test accounts were created by QR: `新智能体1号` and `新智能体2号`.
+- Both received the requested name and scopes:
+  - `im:message`
+  - `im:message.send_as_user`
+- Initial redirect-URL writes failed with Feishu business code `99991672`:
+  `application:application:patch` was missing.
+- The app was updated through Feishu's existing-app QR flow to add
+  `application:application:patch`.
+- Re-running the v7 config patch returned `code: 0, msg: success`; all five
+  redirect URLs were then present in `application.v6.application.get`.
+- Conclusion: keep the redirect-URL write step, with
+  `application:application:patch` included in the QR addons for new accounts.
+  Existing accounts can use **重新检查应用配置** after adding the permission.
+
+## Visual confirmation
+
+The user confirmed the live tab bar on 2026-11-04:
+
+- Sidebar: **任务 | 频道 | 飞书频道** (im-connect and this plugin both enabled).
+- The settings entry was removed in the follow-up UI revamp; live slot inspection confirms
+  `settings.section` has no `feishu-channel` occupant.
+- Real Feishu QR/message acceptance is still pending a user scan; this is the remaining
+  verification item.
+
+The Client module is loaded (see the live slot evidence above). Remaining page checks:
+
+1. **Settings nav**: no **飞书频道** entry.
+2. **Sidebar**: `任务 | 频道 | 飞书频道` when im-connect is also enabled; only
+   `任务 | 飞书频道` when it is disabled.
+3. **Channel tab**: left side has only **添加飞书账号**; no content title, folder group,
+   or right-side icon add button.
+4. **Add dialog**: title **添加飞书账号**; only QR binding; no manual fields or
+   **快捷绑定** text; has **频道名称** with default `飞书账号1`.
+5. **Account row**: after scanning, the entered name appears immediately, with status,
+   receive switch, and **设置**.
+6. **Account settings**: **飞书App信息** shows App ID/App Secret in one row; App ID is
+   copyable; App Secret is masked and can be shown/copied. The check result is collapsible.
+7. **Feishu session composer**: opening a `dfc:` session removes the text input/send
+   button and shows the current account model as read-only text; switch models in
+   account settings and the display follows. While a turn is running, a **Stop
+   generating** button asks for confirmation before cancelling the turn. The current
+   session row is highlighted in the channel list.
+8. **No console error** such as `slot entry crashed` or a blank sidebar.
+
+If the sidebar is blank or the tabs are wrong, disable this bundle in Plugin Manager
+first (the official sidebar returns immediately), then report the browser console
+error. Do not uninstall `dsh-im-connect`.
+
+## Slot-level checks (no browser needed)
+
+```text
+cordis_inspect_query client Slots.listSubTree { "root": "settings.section" }
+→ occupants must NOT include { id: "feishu-channel" }
+
+cordis_inspect_query client Slots.listSubTree { "root": "sidebar.session.row.leading" }
+→ occupants should include { id: "feishu-channel-session-channel" }
+```
+
+If these entries do not appear, the page has not loaded the new Client module; refresh
+first.
+
+## Real Feishu acceptance
+
+1. Open the **飞书频道** tab → **添加飞书账号** → enter a name → scan the QR code.
+2. After the account appears, open **设置** and verify App ID / App Secret show and copy.
+3. Inspect `config.provisioning` in `~/.dsh/dsh-feishu-channels/channels.json`:
+   - If all five redirect URLs are present, keep the redirect write step.
+   - If Feishu rejects them, remove the redirect write operation and its UI hint.
+4. Send a private message to the bot; the first user is the owner.
+5. Verify: text reply, group @ mention, image, file, approval card, question card,
+   slash commands, receive off/on, diagnostics, remove account.
+6. Add a second Feishu account with a different app; verify sessions do not mix.
+7. Keep im-connect enabled but with its Feishu account removed/disabled. Do not use the
+   same App ID in both plugins.
+
+## Commands
+
+```bash
+cd /home/hls/dev/dsh-remote-feishu/dsh-feishu-channels
+pnpm test
+pnpm run check
+```
+
+## Known limits
+
+- Visual verification requires the user; this environment has no browser control.
+- Registry v1 is private to the im-connect/new-plugin coexistence convention.
+- Codex UI sidebars are not wrapped in v1.
+- Same Feishu App ID in both plugins is a platform-level conflict.

package/icon.svg

@@ -0,0 +1,17 @@
+<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 64 64" width="64" height="64" role="img" aria-label="DSH Feishu Channel">
+  <defs>
+    <linearGradient id="dfc-bg" x1="8" y1="6" x2="56" y2="58" gradientUnits="userSpaceOnUse">
+      <stop stop-color="#3370ff"/>
+      <stop offset="1" stop-color="#00b8a9"/>
+    </linearGradient>
+    <linearGradient id="dfc-plane" x1="24" y1="22" x2="44" y2="44" gradientUnits="userSpaceOnUse">
+      <stop stop-color="#ffffff"/>
+      <stop offset="1" stop-color="#dce9ff"/>
+    </linearGradient>
+  </defs>
+  <rect x="4" y="4" width="56" height="56" rx="16" fill="url(#dfc-bg)"/>
+  <path d="M17 22.5c0-3.59 2.91-6.5 6.5-6.5h17c3.59 0 6.5 2.91 6.5 6.5v13c0 3.59-2.91 6.5-6.5 6.5H32l-8.8 7.1c-.98.79-2.45.09-2.45-1.16V42.2A6.5 6.5 0 0 1 17 36z" fill="#ffffff" opacity=".16"/>
+  <path d="M17 22.5c0-3.59 2.91-6.5 6.5-6.5h17c3.59 0 6.5 2.91 6.5 6.5v13c0 3.59-2.91 6.5-6.5 6.5H32l-8.8 7.1c-.98.79-2.45.09-2.45-1.16V42.2A6.5 6.5 0 0 1 17 36z" fill="none" stroke="#ffffff" stroke-width="2.5" stroke-linejoin="round"/>
+  <path d="M24 30.5h16M24 36.5h10" stroke="#ffffff" stroke-width="2.5" stroke-linecap="round" opacity=".92"/>
+  <path d="M40.5 22.5 27 31.8l6.1 3.1 2.1 7.5 5.3-19.9z" fill="url(#dfc-plane)" stroke="#2b5fdc" stroke-width="1.2" stroke-linejoin="round" opacity=".96"/>
+</svg>

package/locale/en.json

@@ -0,0 +1,6 @@
+{
+  "meta": {
+    "title": "DSH Feishu Channel",
+    "description": "Connect a Feishu bot to the local DeepSeek Harness."
+  }
+}

package/locale/zh.json

@@ -0,0 +1,6 @@
+{
+  "meta": {
+    "title": "DSH飞书频道",
+    "description": "将飞书机器人接入本机 DeepSeek Harness。"
+  }
+}

package/package.json

@@ -1,6 +1,78 @@
 {
   "name": "@cubeai/dsh-feishu-channels",
-  "version": "0.0.0-stage",
-  "stub": true,
-  "description": "Temporary package placeholder for staged publishing"
-}
+  "version": "0.2.0",
+  "description": "DSH飞书频道 — 将飞书机器人接入本机 DeepSeek Harness。",
+  "type": "module",
+  "main": "src/index.js",
+  "exports": {
+    ".": "./src/index.js",
+    "./client": "./client.js",
+    "./cordis.patch.yml": "./cordis.patch.yml",
+    "./package.json": "./package.json",
+    "./locale/*.json": "./locale/*.json",
+    "./icon": "./icon.svg"
+  },
+  "files": [
+    "src",
+    "client.js",
+    "cordis.patch.yml",
+    "locale",
+    "icon.svg",
+    "README.md",
+    "LICENSE",
+    "NOTICE",
+    "docs"
+  ],
+  "keywords": [
+    "dsh",
+    "dsh-plugin",
+    "feishu",
+    "im",
+    "飞书"
+  ],
+  "author": "huolongshe",
+  "license": "Apache-2.0",
+  "engines": {
+    "node": "^22.19.0 || >=24.0.0"
+  },
+  "dsh": {
+    "bundle": {
+      "patch": "./cordis.patch.yml"
+    },
+    "client": {
+      "platform": "web",
+      "inject": [
+        "@deepseek-ai/dsh-client-locale",
+        "@deepseek-ai/dsh-client-ui-slots",
+        "@deepseek-ai/dsh-client-ui-primitives"
+      ]
+    }
+  },
+  "dependencies": {
+    "@deepseek-ai/schemastery": "^3.18.2",
+    "@larksuiteoapi/node-sdk": "^1.36.0",
+    "qrcode": "^1.5.4"
+  },
+  "peerDependencies": {
+    "@deepseek-ai/cordis": "^4.0.2",
+    "@deepseek-ai/dsh-agent": "^0.2.1-rc.2",
+    "@deepseek-ai/dsh-client-locale": "^0.2.1-rc.2",
+    "@deepseek-ai/dsh-client-ui-primitives": "^0.2.1-rc.2",
+    "@deepseek-ai/dsh-client-ui-slots": "^0.2.1-rc.2",
+    "@deepseek-ai/dsh-host-webserver": "^0.2.1-rc.2",
+    "@deepseek-ai/schemastery": "^3.18.2"
+  },
+  "scripts": {
+    "check": "node scripts/check.js",
+    "test": "node --test tests/*.test.mjs"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://openi.pcl.ac.cn/dsh/dsh-feishu-channels.git"
+  },
+  "homepage": "https://openi.pcl.ac.cn/dsh/dsh-feishu-channels",
+  "publishConfig": {
+    "access": "public",
+    "registry": "https://registry.npmjs.org/"
+  }
+}

package/src/channels/connection-state.js

@@ -0,0 +1,12 @@
+/** Maps the Feishu adapter's status text to the account view state. */
+const readyStates = new Set(['长连接已建立']);
+const connectingStates = new Set(['连接中']);
+
+export function connectionState(status) {
+  if (readyStates.has(status)) return 'connected';
+  if (connectingStates.has(status)) return 'connecting';
+  if (status === '已停止') return 'stopped';
+  if (status === '未连接' || status === '已断开') return 'disconnected';
+  if (status === '连接失败' || status === '连接失败，请查看本机日志' || status === '连接错误') return 'error';
+  return 'unknown';
+}

package/src/channels/diagnostics.js

@@ -0,0 +1,77 @@
+export class DiagnosticError extends Error {
+    reason;
+    httpStatus;
+    platformCode;
+    constructor(reason, httpStatus, platformCode) {
+        super(reason);
+        this.reason = reason;
+        this.httpStatus = httpStatus;
+        this.platformCode = platformCode;
+    }
+}
+export async function probe(id, signal, run) {
+    const started = Date.now();
+    try {
+        signal.throwIfAborted();
+        await run();
+        signal.throwIfAborted();
+        return { id, status: 'passed', reason: 'ok', durationMs: Date.now() - started };
+    }
+    catch (error) {
+        const failure = error instanceof DiagnosticError ? error : new DiagnosticError(signal.aborted ? signal.reason?.name === 'TimeoutError' ? 'timeout' : 'cancelled' : 'network');
+        return { id, status: ['cancelled', 'missing-context', 'not-connected', 'unsupported', 'changed'].includes(failure.reason) ? 'unverified' : 'failed', reason: failure.reason, durationMs: Date.now() - started,
+            ...(failure.httpStatus === undefined ? {} : { httpStatus: failure.httpStatus }), ...(failure.platformCode === undefined ? {} : { platformCode: failure.platformCode }) };
+    }
+}
+/** 新请求、不跟随重定向、限制回包大小；调用方负责平台业务码与必要字段校验。 */
+export async function diagnosticJson(url, signal, body, headers, fetcher = fetch) {
+    const response = await fetcher(url, { method: body === undefined ? 'GET' : 'POST', headers: { 'content-type': 'application/json', ...headers }, body: body === undefined ? undefined : JSON.stringify(body), signal, redirect: 'error' });
+    if (!response.ok) {
+        await response.body?.cancel();
+        const status = response.status;
+        throw new DiagnosticError(status === 401 ? 'auth' : status === 403 ? 'permission' : status === 429 ? 'rate-limit' : status >= 500 ? 'server' : 'rejected', status);
+    }
+    if (!response.body)
+        throw new DiagnosticError('invalid-response');
+    const reader = response.body.getReader();
+    const chunks = [];
+    let size = 0;
+    try {
+        for (;;) {
+            const { done, value } = await reader.read();
+            if (done)
+                break;
+            size += value.length;
+            if (size > 65536)
+                throw new DiagnosticError('invalid-response');
+            chunks.push(value);
+        }
+        let result;
+        try {
+            result = JSON.parse(Buffer.concat(chunks).toString('utf8'));
+        }
+        catch {
+            throw new DiagnosticError('invalid-response');
+        }
+        if (!result || typeof result !== 'object' || Array.isArray(result))
+            throw new DiagnosticError('invalid-response');
+        return result;
+    }
+    finally {
+        await reader.cancel().catch(() => undefined);
+        reader.releaseLock();
+    }
+}
+export function requireDiagnostic(value) {
+    if (!value)
+        throw new DiagnosticError('invalid-response');
+}
+export function platformResult(code, authCodes = []) {
+    if (!(typeof code === 'number' || typeof code === 'string' && /^-?\d+$/.test(code)))
+        throw new DiagnosticError('invalid-response');
+    const numeric = Number(code);
+    if (!Number.isFinite(numeric))
+        throw new DiagnosticError('invalid-response');
+    if (numeric !== 0)
+        throw new DiagnosticError(authCodes.includes(numeric) ? 'auth' : numeric === 429 ? 'rate-limit' : 'rejected', undefined, numeric);
+}

package/src/channels/factory.js

@@ -0,0 +1,20 @@
+import { createFeishuChannel } from './feishu.js'
+
+/**
+ * Only the Feishu platform is supported by this plugin.
+ * The manager still passes a platform id; unknown ids are rejected.
+ */
+export function createChannelAdapter(id, config, log, _stateDir, options) {
+  if (id !== 'feishu') return undefined
+  const adapter = createFeishuChannel('feishu', {
+    appId: config.appId,
+    appSecret: config.appSecret,
+    host: options?.host,
+  }, log)
+  if (!adapter) return undefined
+  return {
+    ...adapter,
+    id: options?.accountId ?? adapter.id,
+    label: options?.accountLabel ?? adapter.label,
+  }
+}