zhbcher/dsh-plugin-lark

README 摘要

dsh-plugin-lark — DeepSeek Harness 飞书接入插件（薄架构） 在 DSH Web 界面（设置 → 插件 →「飞书接入」标签页）提供 扫码新建机器人 + 扫码授权 + 监听器管理 ， 不再需要手动敲 lark-cli 命令，也不用去开放平台手动配置。 两大能力 1. 新建飞书机器人（推荐） ：面板点「新建机器人」→ 手机扫码登录开放平台 → 工具自动完成 创建应用 → 开机器人能力 → 导入权限 → 订阅消息事件 → 发布版本 → 约 30-60 秒拿到新机器人凭证并自动写入 lark-cli → 自动启动监听器 → 直接可用（一次扫码即连接）。 底层用 feishu-bot-bootstrap（headless + events-jsonl 事件流）。 2. 用户身份授权（可选） ：需要以个人身份访问日历/文档/邮件等资源时再扫码授权（lark-cli 设备流）。 安装（npm） 依赖： lark-cli （PATH 中可用）、 dsh 、Chrome/Edge（扫码新建机器人用）、飞书开放平台账号。 环境变量（均可覆盖，默认已通用化）： 变量 默认 说明 LARK BRIDGE DIR /.dsh/lark-bridge 网关目录（内含 lark bridge.py + manage lark bridge.sh ，随包自带） DSH WORK DIR 任务工作目录（网关侧） LARK CLI BIN lark-cli (PATH) lark-cli 路径 LARK BOT NAME DeepSeek Harness 助手 新建机器人的应用名 架构（薄插件设计） - 插件只做「授权 + 面板 + 进程管理」， 不做消息收发 ，与 DSH 核心解耦 → 升级影响最小 - 消息收发逻辑仍在 /Users/zhoubo/GP/lark-bridge/lark bridge.py ，可独立运行/排障 文件 文件 说明 package.json 插件包声明； dsh.client 声明前端 bundle lib/index.js 服务端 Cordis 插件： /api/lark/ 路由 lib/client.js 前端面板（手写 ModuleLoader bundle 格式） test/harness.mjs 后端自测（mock ctx，不启动 Web） API（服务端，前缀 /api/lark ） 方法/路径 说明 GET /status 应用/授权/监听器/工作目录 总状态 POST /bot/create 启动「扫码新建机器人」（feishu-bot-bootstrap headless） GET /bot/create/status 新建流程状态（二维码 URL、步骤进度、结果、错误） GET /bot/create/qr.p…

分类