yingzaicc/dsh-editor-selection

README excerpt

dsh-editor-selection 让 DSH 理解"用户此刻在编辑器里看着什么"。当你在编辑器中选中某个文件或行区间,后续对话自动聚焦于它——通过 @path:10-25 的环境知会行注入,而不是把文件内容塞进上下文。 本插件是 通用编辑器选区服务 :协议与客户端种类无关,VS Code 桥只是第一个接入者(未来可接入 GoLand 等 IDE,见 DESIGN §13)。设计文档见 DESIGN.md (§0 决策记录 → §13 多客户端通用化)。本 README 只讲安装、使用与验证。 它做什么 / 不做什么 ✅ ❌ 捕获主选区的 绝对路径 + 行区间 (1-based) 读取或上传任何文件内容 在 agent 每步之前注入一行环境知会( agent/pre-step ,prepend) 把选区"附加"进对话历史 DSH 侧边栏 🔔 配对审批 + 设备吊销 任何云服务——全部本机回环 输入框下方环境 chip: [👁] @C:\...\app.ts:10-25 ,眼睛即隐私开关 反向导航(协议帧已保留,未实现) 架构(30 秒版) 信任策略与通知呈现是两个可替换接口( ConnectionPolicy / NotificationSink )——未来 DSH UI 嵌入 VS Code 时,"安装即信任",配对仪式整体退场。 构建 冒烟覆盖:产物形状(loader banner、双席位注册)、真实 TCP 回环上的 RFC6455 双端帧数学(掩码/126 长度/close 码)、经 registerUpgrade 的完整配对流(坏 token→4401、批准→一次性 token→干净交接、拒绝→4403)、焦点状态机(active/paused/stale/offline + 变更驱动抑制)、注入消息契约(time-context 同形、plugin 归因、deep-frozen)。 安装到本地 DSH 脚本做三件事:junction 包目录到 /.dsh/profiles/web/node modules/dsh-editor-selection 、写入 profile package.json 依赖、登记 dsh.profile.bundles 。 VS Code 侧 见 ../dsh-editor-selection-vscode/README.md 。要点:首次连接触发配对请求 → DSH 🔔 里确认 → token 入 SecretStorage,之后静默。 使用 - 眼睛开关(chip 上) :关=暂停共享(向 agent 注入一条一次性"已暂停"知会后保持沉默);开=恢复。状态持久化。 - 选中即聚焦 :有真实选区 → @绝对路径:起-止 ;光标停放无选择 → @绝对路径 (整个文件即焦点);光标不在任何文件里 → 焦点清…

Category