仓库链接卡片 zengxiaolou/dsh-github-link

dsh-github-link

dsh-github-link

DSH 插件：把对话区回复里的仓库 URL（GitHub / GitLab / Gitee）变成「可悬停的信息卡片」，点击后直接在 DSH 右侧栏自带的浏览器标签页里打开。

它不改 GenUI（@changfenhuang/dsh-genui）本体：截图里那套结论块 / 指标卡 / 表格由 GenUI 渲染，本插件只给它的链接和裸 URL 补上 hover 与点击行为，所以 GenUI 升级不会把这层改动冲掉。

作用范围

只在对话正文里生效（[data-conversation-content]，即 Conversation 外壳的对话区：
助手回复、GenUI 块、工具卡片）。菜单、会话列表、左侧工作区树、右侧栏标签页里的链接一律不装饰 —— 那些地方的链接属于各自功能，本插件不接管。

判定在事件入口完成（inConversation()）：mouseover / click 的目标不在对话区内就直接返回，
连 preventDefault 都不做。悬浮卡片本身挂在 document.body 上，单独放行，否则鼠标从链接移到卡片会被判成「离开对话区」而收起。

行为

| 场景 | hover | 点击 |
| 对话区内 GenUI 块里的链接（data-genui 内） | 出卡片 | 拦截 → 右侧栏浏览器 |
| 对话区内回复正文里的裸 URL（https://github.com/a/b） | 出卡片 | 拦截 → 右侧栏浏览器 |
| 对话区内普通 markdown 链接（宿主自己渲染） | 出卡片 | 不拦截，交给宿主的 linkOpening 设置 |
| 对话区外（菜单 / 会话列表 / 工作区 / 右栏） | 无 | 不拦截，插件完全不介入 |
| 任意情况下 ⌘/Ctrl/Shift/Alt + 点击 | — | 不拦截，走系统浏览器 |

卡片内容：仓库全名、来源（GitHub / GitLab / Gitee）、公开/私有/归档标记、简介（3 行截断）、星标 / 复刻 / 开放议题、主语言、许可证、Topics、最近活动，以及底部两个按钮：

| 按钮 | 出现条件 | 行为 |
| 在 DSH 打开 PR | 仅 github.com 的 PR，且 dsh-github-flow 的 github-pr tab 已注册 | 右栏 PR 面板打开这条 PR：sidebarRight.openTab('github-pr', { params: { repo, number } }) + layout.openRightbar(true, false) |
| 复制 clone | 有仓库路径时 | 写 git clone https://<host>/<fullName>.git |

两个按钮都不走「打开网页」：点按钮只做各自那件事，点卡片/链接才在右侧栏浏览器打开 PR 页面。
按钮是否出现，按「页面里真有那个 tab 类型」判定（sidebarRightTabs.get('github-pr')），没有就整颗按钮不渲染——不做点了没反应的死按钮。

当 URL 指向 issue / PR / MR 时，额外显示该条目的标题、状态（开启中 / 已关闭 / 已合并）与作者：

https://github.com/facebook/react/issues/1
→ react/react · 议题 #1 · [已关闭] Run each test in its own · 由 benjamn

数据从哪来

GET /github-link/card?url=<encoded>（host 半注册在同一个 web server 上），按主机分派：

| 主机 | 上游 | 认证 |
| github.com | api.github.com | GITHUB_TOKEN / GH_TOKEN，否则本机 gh auth token（60/h → 5000/h） |
| gitlab.com | gitlab.com/api/v4 | 匿名即可（支持多级 group 路径） |
| gitee.com | gitee.com/api/v5 | 匿名即可 |

- 成功结果缓存 10 分钟，失败 60 秒；缓存上限 400 条。
- 只接受上述三个主机的仓库形 URL；/marketplace、/explore、/orgs 等保留路径直接忽略。
- issue/PR 明细是 best-effort：拉不到就只显示仓库卡片，不会让整张卡失败。
拒绝 sec-fetch-site: cross-site 的请求，避免被别的网页当成查询代理。

点击是怎么走到「内置浏览器」的

用的就是 DSH 自己的右侧栏页面服务：

ctx.get('sidebarRight').openTab('browser', { params: { url } })

和 sidebar_open 工具、以及聊天里普通链接的默认行为是同一个 API；browser 类型不存在时自动退回 window.open。

自检：客户端半到底加载了没有

client 半是从页面的 boot payload 注入的，改完 client.js 后只有「刷新后的窗口」才会带上它。
这个进程看不到那个窗口，所以插件自己上报：

| 路由 | 用途 |
| GET /github-link/status | client.loaded 是否为真、最近一次 hello 的时间/协议/UA、打开与回退计数、缓存大小 |
| POST /github-link/hello | client 半每次页面加载上报一次，带 location.protocol |
| POST /github-link/event | client 半在打开链接时上报 open 或 fallback |

loaded 只认真正的页面（dsh-app: 或 http(s):）：用 curl 之类直接 POST 一个不带 protocol 的 hello 会返回 loaded: false 并提示这是探测，不会被误判成「已生效」。

curl -s http://127.0.0.1:50845/github-link/status | jq .client

桌面壳的形状（为什么 GitHub 能显示）

这版 Desktop 的主窗口加载的是 dsh-app://app/，preload 在同源主框架下才暴露完整的 window.dshDesktop（protocolVersion: 1 + browser 桥）。侧栏浏览器据此选择 Electron <webview> 而不是 ，所以 github.com 的 x-frame-options: deny 不影响它。

插件的请求也按这个前提解析：走 document.baseURI 的相对路径（github-link/card），由壳的非静态路径转发送到 Host，保持同源；不用 __DSH_TRANSPORT__.streamBaseUrl （那是另一个 origin，会变成跨域 POST）。

已知限制

右侧栏浏览器在 Desktop 应用里走 Electron <webview>（真实 Chromium 视图），三者都正常显示；如果用普通浏览器打开 dsh web 的地址，那里是 sandboxed ，而 github.com 会发 x-frame-options: deny，页面会被浏览器拦掉。此时点击仍会算成功打开，但内容为空——用 Desktop 应用即可。

文件

- index.js — host 半：/github-link/card 路由、三主机 URL 解析、各自的上游读取、token、缓存。
- client.js — client 半：document 级 hover/click 委派、浮动卡片、PR 面板按钮、复制 clone、sidebarRight 打开。
- cordis.patch.yml — 插入 github-link 装载行。
- locale/{zh,en}.json — 插件市场/设置里的标题与描述。

改动生效方式

- client 半：刷新一次 GUI 页面（新模块在下次 boot 注入）。
- host 半：在插件市场里把 GitHub 链接卡片 关一次再开，或重启 DSH；进程内 ESM 缓存不会自己更新。

卸载

插件市场里停用或移除 dsh-github-link 即可；profile 只是把它软链到本目录。