dsh-plugin-github-issues 0.4.7 → 0.6.0

package/README.md

@@ -8,12 +8,14 @@ English | [中文](docs/README.zh.md)
 [![license](https://img.shields.io/npm/l/dsh-plugin-github-issues.svg)](LICENSE)
 
 Adds a GitHub Issues work surface to [DeepSeek Harness](https://github.com/deepseek-ai/deepseek-harness):
-browse issues from your repositories and Projects v2 boards, read their details, and hand one to the
+browse issues from your repositories, read their details, and hand one to the
 agent. A handoff opens a new Session in the matching Workspace and stages the issue as an
 attachment-style card inside the composer; sending turns that card into the issue's task prompt.
 Handed-over issues show which Sessions own them, can be entered, and can be unlinked; one issue may be
 worked in several Sessions.
 
+![The GitHub panel with the fixed cascade toolbar and the detail pane](assets/panel.png)
+
 It is **read-only**: the plugin never writes to GitHub.
 
 ## Install
@@ -52,19 +54,14 @@ tarball (`dsh-plugin-github-issues.tgz`), installable by path.
 - DSH Desktop with a Web GUI (developed and verified against `0.2.1-rc.3`).
 - A [`gh`](https://cli.github.com/) CLI logged in for the GitHub host you use:
   `gh auth login`. The token stays in the OS keychain and is never written into this package's config.
-- Projects v2 support additionally needs the `read:project` scope, once:
-
-  ```sh
-  gh auth refresh -h github.com -s read:project
-  ```
-
-  Without it the panel still works; the project picker explains what is missing.
+- The panel is repository-scoped: pick an organization and a repository (a default is selected for
+  you), then narrow by milestone, assignee and state.
 
 ## What you get
 
 | Surface | Where | What |
 |---|---|---|
-| GitHub panel | left rail icon → main panel | organization → project/repository → assignee → state cascade (remembered across restarts), search, list, and a detail pane (body, milestone progress, labels, priority, assignees, linked/mentioned PRs with checks and review state) |
+| GitHub panel | left rail icon → main panel | organization → repository → **milestone** → assignee → state cascade (remembered across restarts) in one fixed toolbar; a default organization/repository is selected for you, the milestone dropdown lists only that repository's milestones, and only the list scrolls (search stays above it, the detail pane scrolls independently with body, milestone progress, labels, priority, assignees, linked/mentioned PRs and checks) |
 | Issues right column | right sidebar tab | the same filtered issue list beside the Conversation, for drag-and-drop handoff |
 | Composer card | inside the input box | the staged issue: `[GitHub] owner/repo#number ×`. Type extra instructions or nothing; send converts the card into the issue prompt |
 | Linked chip | composer dock under the input | the Session's linked issue: state dot (green open / red closed) + `owner/repo#number`; click for a detail popover, remove to unlink |
@@ -74,8 +71,9 @@ tarball (`dsh-plugin-github-issues.tgz`), installable by path.
 ## Use
 
 1. Click the **GitHub** icon in the left rail.
-2. Pick an organization, a Projects v2 board or a repository, then an assignee/state filter. The
-   selection is remembered in the profile's UI state (not in the plugin config).
+2. Pick an organization and a repository (the first one is selected automatically), then a milestone,
+   assignee and state. The selection is remembered in the profile's UI state (not in the plugin
+   config).
 3. Click a row for the detail pane. `owner/repo#number` opens GitHub in the browser.
 4. Hand an issue over:
    - **One-click** in the detail: **Hand to agent** / **New session for this issue** opens a new
@@ -114,8 +112,11 @@ Settings → GitHub → Prompt template. Variables: `{{repo}}`, `{{number}}`, `{
 ## Limitations
 
 - Read-only: no comments, label/assignee/state writes.
-- Projects v2 needs `read:project`; priority falls back project field → organization Issue Field →
-  `P0`–`P4` labels.
+- The list uses the repository's exact `issues` connection, so state, assignee and milestone filters
+  are applied by GitHub (and the total is authoritative); milestone filtering sends the milestone
+  number through `filterBy.milestoneNumber`.
+- Milestone choices come from the selected repository's full milestone list (open and closed).
+- Priority falls back organization Issue Field → `P0`–`P4` labels when no project field is present.
 - The list polls every 60–120 s while visible; use **Refresh** for an immediate update.
 - The detail pane first asks for the body only and lazily loads cross-referenced PRs, so the slow
   timeline never blocks the pane.

package/docs/README.zh.md

@@ -6,11 +6,13 @@
 [![npm](https://img.shields.io/npm/v/dsh-plugin-github-issues.svg)](https://www.npmjs.com/package/dsh-plugin-github-issues)
 
 给 [DeepSeek Harness](https://github.com/deepseek-ai/deepseek-harness) 增加一个 GitHub Issue 工作区：
-按组织 / Projects v2 项目 / 仓库浏览 Issue，查看详情，并把 Issue 交给 Agent。交办会在匹配的
+按组织 / 仓库浏览 Issue，查看详情，并把 Issue 交给 Agent。交办会在匹配的
 Workspace 里新开一个 Session，并在输入框内以"附件卡片"的形式暂存这个 Issue；点击发送时卡片会
 转成 Issue 的提示词。已交办的 Issue 会显示处理它的 Session，可以进入，也可以解除关联；同一个
 Issue 可以关联多个 Session。
 
+![GitHub 面板：固定筛选栏 + 独立滚动的详情栏](../assets/panel.png)
+
 插件对 GitHub **只读**，不会写入任何内容。
 
 ## 安装
@@ -48,19 +50,13 @@ dsh plugin --profile <name> add /path/to/dsh-plugin-github-issues
 
 - DSH Desktop（Web GUI；开发与验证于 `0.2.1-rc.3`）。
 - 已登录的 `gh` CLI：`gh auth login`。token 留在系统钥匙串，不会写进插件配置。
-- 需要 Projects v2 时一次性补权限：
-
-  ```sh
-  gh auth refresh -h github.com -s read:project
-  ```
-
-  没有该权限时面板照常工作，项目选择器会说明缺什么。
+- 面板以仓库为范围：先选组织、再选仓库（会自动选中默认项），然后按里程碑、assignee、状态收窄。
 
 ## 功能
 
 | 界面 | 位置 | 内容 |
 |---|---|---|
-| GitHub 面板 | 左侧栏图标 → 主面板 | 组织 → 项目/仓库 → assignee → 状态 级联筛选（记住上次选择）、搜索、列表、详情（正文、Milestone 进度、标签、优先级、assignee、关联/提及 PR 的 checks 与 review） |
+| GitHub 面板 | 左侧栏图标 → 主面板 | 组织 → 仓库 → **里程碑** → assignee → 状态 级联筛选（记住上次选择）固定在一行；组织和仓库会自动选中默认项，里程碑下拉只列当前仓库的里程碑；只有列表滚动，搜索在列表上方固定；详情栏独立滚动（正文、Milestone 进度、标签、优先级、assignee、关联/提及 PR 的 checks 与 review） |
 | Issues 右栏 | 右侧栏页签 | 与对话同屏的同一份筛选列表，用于拖拽交办 |
 | 输入框卡片 | 输入框内部 | 暂存的 Issue：`[GitHub] owner/repo#number ×`。可以补充自己的文字，也可以不写；发送时卡片转成提示词 |
 | 已关联 chip | 输入框下方 dock | 当前 Session 关联的 Issue：状态圆点（open 绿 / closed 红）+ `owner/repo#number`；点击看详情，× 解除关联 |
@@ -70,8 +66,8 @@ dsh plugin --profile <name> add /path/to/dsh-plugin-github-issues
 ## 使用
 
 1. 点击左侧栏 **GitHub** 图标。
-2. 选择组织、Projects v2 板或仓库，再选 assignee/状态。选择会记在 profile 的 UI 状态里（不在插件
-   配置中）。
+2. 选择组织和仓库（默认自动选中第一个），再选里程碑、assignee 和状态。选择会记在 profile 的
+   UI 状态里（不在插件配置中）。
 3. 点一行查看详情；点 `owner/repo#number` 在浏览器打开 GitHub。
 4. 交办：
    - 详情里点「交给 Agent」/「再开一个 Session」：在匹配的 Workspace 新开 Session，输入框内出现
@@ -104,7 +100,10 @@ dsh plugin --profile <name> add /path/to/dsh-plugin-github-issues
 ## 限制
 
 - 只读：不发评论、不改标签/指派/状态。
-- Projects v2 需要 `read:project`；优先级回退顺序：项目字段 → 组织 Issue Field → `P0`–`P4` 标签。
+- 列表使用仓库的 `issues` 连接，状态、assignee、里程碑都由 GitHub 服务端过滤（总数也是权威的）；
+  里程碑通过 `filterBy.milestoneNumber` 按编号过滤。
+- 里程碑的可选项来自当前仓库的完整里程碑列表（含已关闭）。
+- 优先级回退顺序：组织 Issue Field → `P0`–`P4` 标签（不再读取 Projects v2 项目字段）。
 - 列表可见时每 60–120 秒轮询一次；需要立刻更新点「刷新」。
 - 详情先请求正文，交叉引用 PR 懒加载，慢的 timeline 不阻塞面板。
 - "发送时卡片转提示词"依赖 composer 的 DOM（原生发送按钮 / 回车），DSH 升级后需要重新核对。