dsh-context-picker

dsh-context-picker

DeepSeek Harness 的可扩展上下文选择器。它保留 DSH 原有输入方式，在聊天输入框输入 @ 即可选择：

• 剪贴板文本
• 剪贴板图片
• 当前 DSH 会话的最近用户／AI 消息
• 其他插件注册的上下文，例如 dsh-file-manager 当前 Monaco 选区

选择结果在输入框中显示为原子 ref chip，可以和普通文字混排。插件不修改 DeepSeek Harness 源码，也不替换内置的文件／会话 @ 引用源。

安装与开发

git submodule update --init --recursive
pnpm install --frozen-lockfile
pnpm test
pnpm dev

pnpm dev 使用仓库内隔离的 .tmp/dsh-home 启动 Web Profile。发布构建和测试方式沿用 dsh-file-manager 的独立 Bundle 工作流。

剪贴板范围

浏览器通过系统 Clipboard API 读取剪贴板，因此能读取在其他进程、其他应用或文件工具中复制的文本和图片。浏览器仍可能要求 HTTPS／本机安全上下文、页面焦点和一次用户授权；操作系统或浏览器拒绝权限时，对应候选不会出现，其他 Provider 不受影响。

候选菜单打开时，剪贴板内容只暂存在浏览器内存。只有用户真正选择候选后，插件才把快照提交给 DSH Host；发送动作会等待该快照持久化完成。

Provider SDK

第三方 Web 插件只依赖 dsh-context-picker/provider 的类型，并把 Provider 注册到 ctx.contextPicker：

import type { ContextPickerProvider } from 'dsh-context-picker/provider'
import type {} from 'dsh-context-picker/client'

const provider: ContextPickerProvider = {
  id: 'my-editor',
  label: 'My Editor selection',
  candidates(sessionId, { query, signal }) {
    signal.throwIfAborted()
    return [{
      key: 'active-selection',
      revision: 'buffer-v42',
      label: 'Current selection',
      content: { type: 'text', text: 'selected text', language: 'typescript' },
      appearance: 'file',
    }]
  },
}

ctx.inject(['contextPicker'], (scope) => {
  scope.effect(() => scope.contextPicker.registerProvider(provider))
})

Provider 只负责给出不可变候选，不需要知道输入框、ref URI、Host 存储或模型消息格式。完整边界和生命周期见架构说明。

数据与限额

• 文本默认每个快照最多 256 KiB UTF-8。
• 一条直接用户消息默认最多展开 12 个不同 ref。
• 最近消息默认显示 12 条，只包括直接用户消息和 AI 消息，不包括插件合成上下文。
• 图片复用 DSH ctx.attachments 的格式校验、规范化、内容寻址存储和消息总量限制。
• 快照位于 $DSH_HOME/context-picker/v1/snapshots，ID 是规范化快照的 SHA-256。

配置项位于 cordis.patch.yml，也可在 DSH Bundle 配置中覆盖。

License

MIT