[FEATURE]: Plugin sources for the composer's @ mention popup (Desktop and TUI)

未关闭
#65,155 1 条评论 0 个 reaction 已指派 0 人 在 GitHub 查看

维护者通常 1 天内回复

还没有人认领这个 Issue。

评估

难度
5/5
预计耗时
一周以上
新手友好度
12/100
Issue 类型
功能
描述清晰度
基本清楚
活跃度
活跃
技术栈
typescript

调研方向

This is a design proposal for a MentionSource registry in the GUI and a matching TUI API, so the first step is agreeing on the shape with maintainers rather than coding. Relevant context is the existing @ popup, which lists files, agents, skills and sessions, and how an @ file mention is turned into a chip on Desktop and a mention part in the TUI. Related issues #62368, #65154 and #51209 should be read first, since they overlap on the composer and plugin APIs. Done would mean an accepted API design and a plan for both clients.

由索引模型根据 Issue 内容生成。

描述

area/plugins type/feature version/v2
Summary

Let plugins add their own results to the composer's @ mention popup, in both Desktop and the TUI. Today @ lists files, agents, skills and sessions, and all of these are built in.

Use case

opencode-gh-search searches the GitHub PRs and issues of the session's repo. Right now it's a /pr and /issue slash command that opens a dialog. What users actually want is to type @ while writing, then something like #123 or @fix login, and pick a PR inline the way they'd pick a file.

To build that today, a plugin would need its own popup and its own key handling:

  • In the TUI, plugins can't add parts to the prompt, so the plugin types a URL into it.
  • In Desktop, it attaches a chip. Neither works on the new-session screen (#65154).
Proposal

A MentionSource registry (GUI) and a matching TUI API. For example:

ctx.add(MentionSource, {
  id: "github",
  label: "GitHub",                 // group header in the popup
  // Called as the user types after `@`; results show next to files and agents.
  search: async ({ query, directory, signal }) => [
    { id: "pr:123", title: "Fix login", description: "#123 · open", icon: "github",
      part: { type: "note", label: "app#123", subject: "https://github.com/…/pull/123", href: "…" } },
  ],
})
  • Results show up in the existing @ popup, with the host's keys and styling.
  • Picking one inserts the item's part the way an @ file mention does: a chip on Desktop, a mention part in the TUI.
  • directory is the session's or the draft's directory, so it also works before the first message.
Related
  • #62368: TUI plugin autocomplete with its own trigger character. This issue asks for sources in the existing @ popup instead, on both clients.
  • #65154: the GUI plugin API has no access to the new-session draft's directory or composer.
  • #51209: expose the V2 TUI composer to plugins.
主要语言
TypeScript
星标
227k
派生
30.7k
平均合并
3 小时 57 分钟
30 天内合并 PR
484

环境准备

从这里开始

  1. 先读完整个 Issue,再读项目的贡献指南。
  2. 在 Issue 下留言说明你要接手 —— 这能避免两个人做同样的事。
  3. Fork 仓库,在一个分支上完成修改。
  4. 提交 Pull Request,并在描述里引用这个 Issue 编号。

anomalyco/opencode 的其他 Issue

查看 anomalyco/opencode 的全部 Issue

相似的 Issue

更多 TypeScript Issue

把新 issue 发到你的邮箱

精选适合新手参与的 GitHub issue 摘要。