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. 适合需要免终端、免复杂配置快速创建和绑定飞书应用的用户。
インストール
$
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 / port | 127.0.0.1 / 3001 | 监听地址与端口。默认只监听本机 |
token | feishu888 | 访问口令,默认就是 feishu888,请改成你自己的;设成 '' 则不需要口令。打开页面会先要口令(登录后浏览器记住 30 天,也可用 ?k= 直接进) |
envFile | ~/.config/dsh-feishu.env | 凭据写入位置(按行更新,只动 FEISHU_APP_ID / FEISHU_APP_SECRET / FEISHU_TENANT,其它键与注释原样保留,文件权限 600)。留空 = 不写文件,凭据显示在页面上供手动配置 |
stateFile | ~/.dsh/feishu-bind-state.json | 绑定记录,重启后绿勾仍在 |
serviceUnit | dsh-feishu.service | 绑定成功后重启的 systemd user 单元;留空 = 不自动重启 |
logFile | 空 | 桥日志路径,用于判断"已接线";留空则按 serviceUnit 的运行状态判断 |
appId | 空 | 指定既有应用(更新+重新授权);留空取 env 里的 |
forceCreate | false | 强制每次扫码新建应用 |
从别的设备访问
插件默认只听本机。要让手机/其它电脑打开这个页面,把它接到你能访问的地址上(端口转发或反向代理,规则自定),
然后在浏览器打开那个地址即可。若该地址可能被他人访问,请务必设置 token,访问时带上 ?k=。
使用流程
- 浏览器打开
http://127.0.0.1:3001/→ 先输入口令(默认feishu888)→ 自动出现二维码; - 飞书 App 扫码 →(首次)确认应用名称 → 授权;已有应用会显示更新内容并重新授权;
- 页面转圈"已授权,正在写入凭据并重启桥…",随后变成 ✓ 已绑定,桥已接线;
- 之后在飞书里私聊机器人即可,消息自动进入 dsh;
- 换绑:刷新页面(或点绿勾)→ 新二维码 → 再扫一次即可。