dsh-github-picker

by bitxeno

0 UI 增强github收录于 08-21

输入框右下角 GitHub 图标打开当前仓库的 issue/PR 搜索弹窗，数据来自本机 gh CLI，点选即以 URL 或 @owner/repo#number 形式插入引用。

Composer GitHub picker: click the GitHub icon at the bottom-right of the input box to search the workspace repository''s issues and pull requests via the gh CLI, and insert the reference as a URL or @owner/repo#number mention.

安装

$ dsh plugin --profile web add github:bitxeno/dsh-github-picker

GitHub 源码安装：首次需按提示配置 allowBuilds 构建授权后重试

安装与环境配置指引、插件开发教程见 DSH 中文社区文档 ↗

安装即在你的机器上以你的权限运行第三方代码——它可读写文件、使用凭据、访问网络，DSH 的工具审批不会为插件代码加沙箱。「检测到 manifest」仅代表发现 dsh.bundle / dsh.plugin 清单，不构成兼容性或安全审查；安装前请审阅源码，不熟悉的插件先在不含密钥的环境试用。

English | 简体中文

DeepSeek Harness Web GUI 的 GitHub Issue 与 Pull Request 引用插件。点击输入框右下角的 GitHub 图标，即可搜索当前工作区仓库的 Issue 与 PR，并插入引用文本——GitHub URL，或 @owner/repo#编号 提及。

dsh-github-picker 在 DeepSeek Harness Web GUI 中的效果

安装与更新

dsh plugin --profile web add dsh-github-picker

已有安装用同一条命令即可更新到最新版本；需要固定版本时在包名后追加 @<版本>。安装后重启 dsh web。

用法

点击输入框右下角的 GitHub 图标。弹窗列出仓库最近的 Issue 和 PR——每页 12 条，滚动到底部自动加载下一页，直至取完全部结果（无上限）——输入关键字即时本地过滤（数字前缀优先）。点击行插入引用；Esc 或点击弹窗外任意处关闭。搜索失败（未安装 gh、未登录、限流、网络错误、仓库未解析）时显示一行本地化提示，而不是静默关闭。

每行显示 GitHub 官方状态图标、标题和 #编号：

状态	图标
打开的 Issue	`issue-opened`（绿）
已关闭的 Issue	`issue-closed`（紫）
打开的 PR	`git-pull-request`（绿）
Draft PR	`git-pull-request-draft`（灰）
已关闭未合并的 PR	`git-pull-request-closed`（红）
已合并的 PR	`git-merge`（紫）

选中后按插入格式落稿：

@owner/name#125                                 # 格式 ref（默认）
https://github.com/owner/name/issues/125        # 格式 url

Agent 开始执行前，Host 会扫描草稿中的 GitHub 引用——URL、@owner/repo#编号、裸 #编号——并为每个引用注入一条简短消息：

<github-reference repo="owner/name" number="125" />

插件只传递仓库与编号，从不拉取 Issue 正文。

数据来源

只使用 gh CLI：复用本机 gh 登录态，调用 gh api search/issues（一次查询同时返回 Issue 和 PR）。不涉及设备流、OAuth App 或任何已保存凭据。仓库通过工作区 git remote get-url origin（https、ssh、git@ 形式）自动解析；无法解析时弹窗会提示如何添加 remote。

设置

插件卡片（标题「GitHub 引用」，英文界面为 "GitHub Picker"）位于官方插件配置页。它显示 gh 连接状态（gh auth status 报告的已登录帐号）与插入格式（@owner/repo#编号 或 GitHub URL）。这是唯一的设置项：没有「启用」开关——选择器始终可用——也没有结果上限。

配置

Host 插件配置写入所选 profile 的 cordis.patch.yml：

- id: dsh-github-picker
  config:
    searchTimeoutMs: 15000
    repoCacheTtl: 30000

searchTimeoutMs——数据源调用超时（默认 15000 毫秒）。
repoCacheTtl——仓库解析结果按工作区缓存时长（默认 30000 毫秒）。

修改 Host 配置后需重启 dsh web；纯客户端改动只需刷新浏览器。

开发

pnpm install
pnpm run check

检查阶梯为 typecheck + 测试 + 构建，每个源文件 100% 覆盖率；lib/ 随仓库提交，profile 安装无需构建。安装本地检出时，在 ~/.dsh/profiles/web/package.json 中加入依赖与 dsh.profile.bundles，执行 pnpm install 后重启 dsh web。插件以 /plugins/dsh-github-picker/client.js 提供服务，网关路由 /api/githubPicker/*。