dsh-vscode-bridge-he 1.0.4 → 1.0.5

package/README.md

@@ -1,53 +1,100 @@
-# DSH VSCode Bridge
-
-Adds a bridge between VS Code and the current DSH conversation.
-
-- VS Code right-click on a selection → `DSH: 发送选中代码到 DSH 对话`
-- VS Code right-click on a file in the Explorer → `DSH: 发送文件路径到 DSH 对话`
-- DSH receives an `@absolute/path` reference (plus `(line N)` / `(lines A-B)` for a selection) and inserts it at the current composer caret. It does **not** auto-send the message.
-
-## Architecture
-
-```text
-VS Code extension
-  └─ HTTP POST /dsh-vscode/attach (Bearer token)
-       └─ DSH Host plugin (this package)
-            └─ SSE /dsh-vscode/events
-                 └─ DSH browser plugin
-                      └─ conversation.input.left → InputActions.insertText()
-```
-
-The Host half writes its endpoint and token to `~/.dsh/vscode-bridge.json` (override with `DSH_VSCODE_BRIDGE_FILE`). The VS Code extension reads that file automatically, so no manual token copying is needed. The token file is regenerated when the DSH process/plugin starts.
-
-When no DSH conversation is open, attachments are queued in memory and flushed to the next browser session that connects.
-
-## DSH-side install
-
-This directory is a local DSH bundle. Install it with:
-
-```text
-plugin_manager install_bundle target=C:\...\dsh-vscode-bridge
-```
-
-After installation, refresh the DSH page once (the client plugin and its injected bridge config are added to the page boot). The bundle is enabled in the profile and survives restarts.
-
-## Endpoints
-
-| Method | Path | Auth | Purpose |
-| --- | --- | --- | --- |
-| POST | `/dsh-vscode/attach` | Bearer token | Queue/deliver one reference |
-| GET | `/dsh-vscode/events` | `token` + `channel` query | SSE stream for the browser half |
-| GET | `/dsh-vscode/config` | same-origin page (or Desktop's authenticated forwarded request) | Supplies the browser half with the current token/channel |
-| GET | `/dsh-vscode/health` | none | Connection/queue status for the VS Code status command |
-
-The DSH Desktop renderer runs at `dsh-app://app/` and forwards non-asset
-requests to the Host with its authentication cookie, so the browser half uses
-relative `/dsh-vscode/*` URLs and works both in the Desktop window and in a
-normal browser tab.
-
-## Notes
-
-- Paths are sent as absolute paths so DSH does not depend on its workspace matching the VS Code workspace.
-- The prompt section `vscode-references` teaches the model that `(lines A-B)` means an inclusive 1-based range to read.
-- The browser half renders nothing; it only subscribes and inserts.
-- The bridge is loopback-only by design.
+# DSH VSCode Bridge
+
+Send a VS Code selection or a file path into the conversation you already have open in
+[DeepSeek Harness](https://github.com/deepseek-ai/deepseek-harness) (DSH) — as an `@path`
+reference, inserted at the composer caret. It does **not** send the message for you.
+
+> **This package is only the DSH half.** It needs the companion VS Code extension to do
+> anything; installing this alone gives you an idle bridge. Both halves are in the
+> [repository](https://github.com/heyitaowml-ctrl/dsh-vscode-bridge):
+> `dsh-vscode-bridge/` (this package) and `vscode-dsh-bridge/` (the extension).
+
+## Install
+
+**1 · DSH half** — one command, then refresh the DSH page once:
+
+```sh
+dsh plugin --profile <profile> add dsh-vscode-bridge-he
+```
+
+**2 · VS Code half** — pick one:
+
+- **Extensions view:** open VS Code → Extensions → `…` → **Install from VSIX…** → choose
+  [`dist/dsh-vscode-bridge.vsix`](https://github.com/heyitaowml-ctrl/dsh-vscode-bridge/raw/master/dist/dsh-vscode-bridge.vsix)
+- **Terminal:**
+  ```sh
+  code --install-extension dsh-vscode-bridge.vsix
+  ```
+
+Reload the VS Code window afterwards (`Ctrl+Shift+P` → **Developer: Reload Window**); the
+commands appear under **DSH** in the editor and Explorer context menus.
+
+The extension discovers the Host by itself: DSH writes its endpoint and token to
+`~/.dsh/vscode-bridge.json` (override with `DSH_VSCODE_BRIDGE_FILE`) on every start, so
+there is no token to copy by hand.
+
+### Finding out whether the extension is connected
+
+The composer shows a small `⚠ VS Code 未连接` pill until the extension has sent its first
+reference. It disappears on first use and stays hidden afterwards; the `×` dismisses it for
+the current page.
+
+Zero references is the only signal the Host has, so the pill cannot tell "extension not
+installed" apart from "installed but never used" — it deliberately says *not connected*
+rather than *not installed*. If you have just installed the extension and the pill stays,
+reload the VS Code window.
+
+## Usage
+
+- Select lines, right-click in the editor → **DSH: 发送选中代码到 DSH 对话**
+- Right-click a file or folder in the Explorer → **DSH: 发送文件路径到 DSH 对话**
+- Switch back to DSH: the reference is already at the caret, and nothing has been sent.
+
+```text
+@C:\project\src\main.ts (lines 12-28)
+@C:\project\src\main.ts
+@"C:\project\my folder\main.ts" (line 7)
+```
+
+Line markers are inclusive and 1-based; the prompt section `vscode-references` tells the
+model to read that range rather than guess.
+
+## Architecture
+
+```text
+VS Code extension
+  └─ HTTP POST /dsh-vscode/attach (Bearer token)
+       └─ DSH Host plugin (this package)
+            └─ SSE /dsh-vscode/events
+                 └─ DSH browser plugin
+                      └─ conversation.input.left → InputActions.insertText()
+```
+
+When no DSH conversation is open, attachments are queued in memory and flushed to the next
+browser session that connects.
+
+## Endpoints
+
+| Method | Path | Auth | Purpose |
+| --- | --- | --- | --- |
+| POST | `/dsh-vscode/attach` | Bearer token | Queue or deliver one reference |
+| GET | `/dsh-vscode/events` | `token` + `channel` query | SSE stream consumed by the browser half |
+| GET | `/dsh-vscode/config` | same-origin page | Supplies the browser half with the current token/channel |
+| GET | `/dsh-vscode/health` | none | Connection, queue and `attachments` count for the status command |
+
+`/health` and the SSE `hello` frame both report `attachments` (how many references the
+extension has ever sent to this Host instance) and `lastAttachAt`. That pair drives the
+composer hint above.
+
+## Notes
+
+- Paths are sent absolute, so DSH does not have to share a workspace with VS Code.
+- The browser half renders nothing except the connection hint.
+- **The bridge is loopback-only by design.** The Host binds locally, every request carries a
+  per-process bearer token, and the token file is regenerated on each start.
+- This package is unrelated to [`dsh-vscode-bridge`](https://www.npmjs.com/package/dsh-vscode-bridge)
+  on npm, which is a different plugin by a different author.
+
+## License
+
+MulanPSL-2.0

package/client.js

@@ -1,10 +1,12 @@
 window.__ModuleLoader__.load({
-  id: '@local/dsh-vscode-bridge',
+  id: 'dsh-vscode-bridge-he',
   factory(require) {
     const React = require('react');
 
     const RETRY_MS = 500;
     const MAX_SEEN = 200;
+    // Where the install hint points. Kept in sync with the README's Install section.
+    const INSTALL_DOC_URL = 'https://github.com/heyitaowml-ctrl/dsh-vscode-bridge#install';
 
     /**
      * Invisible composer participant: it owns the SSE subscription for the
@@ -26,6 +28,14 @@ window.__ModuleLoader__.load({
       // insertion add a separator only when the current draft needs one.
       const draft = props.useInput((snapshot) => snapshot.draft);
 
+      // How many references the VS Code extension has ever sent to this Host
+      // instance. `null` means the SSE handshake has not answered yet.
+      // Zero is the only honest signal we have: it cannot tell "extension not
+      // installed" apart from "installed but never used", so the hint says
+      // 未连接 (not connected) rather than 未安装 (not installed).
+      const [attachments, setAttachments] = React.useState(null);
+      const [dismissed, setDismissed] = React.useState(false);
+
       const queueRef = React.useRef([]);
       const seenRef = React.useRef(new Set());
       const timerRef = React.useRef(null);
@@ -130,6 +140,7 @@ window.__ModuleLoader__.load({
                 }
               }
               queueRef.current.push(item.text);
+              setAttachments((current) => (current === null ? 1 : current + 1));
               flushRef.current();
             } catch (error) {
               console.warn('[dsh-vscode-bridge] invalid attachment event', error);
@@ -139,6 +150,12 @@ window.__ModuleLoader__.load({
             try {
               const hello = JSON.parse(event.data);
               console.info('[dsh-vscode-bridge] connected', hello);
+              const reported = Number(hello?.attachments ?? 0);
+              setAttachments((current) => {
+                const known = Number.isFinite(reported) && reported > 0 ? reported : 0;
+                if (current === null) return known;
+                return Math.max(current, known);
+              });
             } catch {
               // A malformed hello is not worth surfacing.
             }
@@ -163,7 +180,64 @@ window.__ModuleLoader__.load({
         };
       }, [sessionId]);
 
-      return null;
+      if (dismissed || attachments === null || attachments > 0) return null;
+
+      // Small, theme-neutral pill: it inherits the surrounding text colour and
+      // only lowers its own opacity, so it stays readable in light and dark.
+      return React.createElement(
+        'span',
+        {
+          style: {
+            display: 'inline-flex',
+            alignItems: 'center',
+            gap: 2,
+            height: 22,
+            padding: '0 2px 0 8px',
+            marginRight: 4,
+            fontSize: 11,
+            lineHeight: '22px',
+            borderRadius: 999,
+            border: '1px solid currentColor',
+            opacity: 0.6,
+            whiteSpace: 'nowrap',
+          },
+        },
+        React.createElement(
+          'a',
+          {
+            href: INSTALL_DOC_URL,
+            target: '_blank',
+            rel: 'noreferrer noopener',
+            title: '还没收到过 VS Code 扩展发来的引用。没装过就点这里看安装步骤；装过的话，请在 VS Code 里执行 Developer: Reload Window。',
+            style: { color: 'inherit', textDecoration: 'none', cursor: 'pointer' },
+            onClick: (event) => event.stopPropagation(),
+          },
+          '⚠ VS Code 未连接',
+        ),
+        React.createElement(
+          'button',
+          {
+            type: 'button',
+            title: '不再提示',
+            'aria-label': 'dismiss the VS Code extension hint',
+            onClick: (event) => {
+              event.preventDefault();
+              event.stopPropagation();
+              setDismissed(true);
+            },
+            style: {
+              border: 'none',
+              background: 'transparent',
+              color: 'inherit',
+              cursor: 'pointer',
+              fontSize: 13,
+              lineHeight: '18px',
+              padding: '0 4px',
+            },
+          },
+          '×',
+        ),
+      );
     }
 
     return {

package/index.js

@@ -206,6 +206,7 @@ export function apply(ctx) {
   let sequence = 0;
   let lastClientId;
   let lastSessionId;
+  let lastAttachAt;
   let published = false;
   let publishing = false;
   let publishAttempts = 0;
@@ -386,6 +387,7 @@ export function apply(ctx) {
       ...attachment,
     };
     item.text = formatAttachmentText(item);
+    lastAttachAt = item.receivedAt;
     const outcome = deliver(item);
     void publishBridgeFile();
     info(`attachment ${item.id}: ${item.kind} ${item.absolutePath}${item.startLine === undefined ? '' : ` lines ${item.startLine}-${item.endLine}`} delivered=${String(outcome.delivered)}`);
@@ -455,6 +457,8 @@ export function apply(ctx) {
         connected: true,
         sessionId: sessionId ?? null,
         queued: queue.length,
+        attachments: sequence,
+        lastAttachAt: lastAttachAt ?? null,
       })}\n\n`);
     } catch {
       removeClient(client.id);
@@ -518,6 +522,8 @@ export function apply(ctx) {
       queued: queue.length,
       sessionId: lastSessionId ?? null,
       configFetches,
+      attachments: sequence,
+      lastAttachAt: lastAttachAt ?? null,
     });
   };
 

package/package.json

@@ -1,6 +1,6 @@
-{
+{
   "name": "dsh-vscode-bridge-he",
-  "version": "1.0.4",
+  "version": "1.0.5",
   "type": "module",
   "description": "Send a VS Code selection or file path into the open DSH conversation as an @path reference, without sending the message.",
   "license": "MulanPSL-2.0",