smallwhitelin/dsh-feishu-bind ↗★ 0

dsh-feishu-bind

浏览器扫码绑定飞书机器人 for DeepSeek Harness(dsh):访问一个本机网页就能看到二维码,扫码即建/绑定飞书应用并自动写凭据、重启桥,刷新或点绿勾即可换码重绑。零重依赖(自带的飞书设备码流程)。Browser-based QR binding portal for a dsh Feishu bot — no terminal, no dsh web surface required. 适合需要免终端、免复杂配置快速创建和绑定飞书应用的用户。

パッケージ
dsh-feishu-bind
互換性
未検証
Cordis ピア範囲
*
バージョン
0.2.5
ライセンス
MIT
最終更新
2026/09/24

インストール

$npx -p @deepseek-ai/dsh dsh plugin --profile web add github:smallwhitelin/dsh-feishu-bind

ドキュメント

README 全文を読む ↗

配置

所有配置都有默认值;要改就在 profile 的 cordis.patch.yml 里按 id 覆盖(不改插件自带的 patch):

- id: feishu-bind
  config:
    host: '127.0.0.1'        # 只监听本机
    port: 3001               # 本机端口
    token: 'feishu888'       # 访问口令(默认 feishu888,务必改成自己的;空串=不需要口令)
    envFile: '~/.config/dsh-feishu.env'        # 凭据写这里(你的桥读的 EnvironmentFile)
    stateFile: '~/.dsh/feishu-bind-state.json' # 绑定记录(重启后绿勾仍在)
    serviceUnit: 'dsh-feishu.service'          # 绑定成功后重启的 systemd user 单元
    logFile: ''              # 桥日志路径;留空 = 按服务状态判断是否已接线
    appId: ''                # 指定 cli_xxx → 更新该应用;留空 = 用 env 里的;都没有 = 新建
    appName: 'DSH Agent'     # 授权页预填的应用名
    appDesc: 'DeepSeek Harness 飞书机器人'
    autoRestart: true        # 授权后自动重启桥
    forceCreate: false       # true = 每次扫码都新建应用
字段默认说明
host / port127.0.0.1 / 3001监听地址与端口。默认只监听本机
tokenfeishu888访问口令,默认就是 feishu888,请改成你自己的;设成 '' 则不需要口令。打开页面会先要口令(登录后浏览器记住 30 天,也可用 ?k= 直接进)
envFile~/.config/dsh-feishu.env凭据写入位置(按行更新,只动 FEISHU_APP_ID / FEISHU_APP_SECRET / FEISHU_TENANT,其它键与注释原样保留,文件权限 600)。留空 = 不写文件,凭据显示在页面上供手动配置
stateFile~/.dsh/feishu-bind-state.json绑定记录,重启后绿勾仍在
serviceUnitdsh-feishu.service绑定成功后重启的 systemd user 单元;留空 = 不自动重启
logFile空桥日志路径,用于判断"已接线";留空则按 serviceUnit 的运行状态判断
appId空指定既有应用(更新+重新授权);留空取 env 里的
forceCreatefalse强制每次扫码新建应用

从别的设备访问

插件默认只听本机。要让手机/其它电脑打开这个页面,把它接到你能访问的地址上(端口转发或反向代理,规则自定), 然后在浏览器打开那个地址即可。若该地址可能被他人访问,请务必设置 token,访问时带上 ?k=。

使用流程

  1. 浏览器打开 http://127.0.0.1:3001/ → 先输入口令(默认 feishu888)→ 自动出现二维码;
  2. 飞书 App 扫码 →(首次)确认应用名称 → 授权;已有应用会显示更新内容并重新授权;
  3. 页面转圈"已授权,正在写入凭据并重启桥…",随后变成 ✓ 已绑定,桥已接线;
  4. 之后在飞书里私聊机器人即可,消息自动进入 dsh;
  5. 换绑:刷新页面(或点绿勾)→ 新二维码 → 再扫一次即可。