dsh-plugin-sprig 0.0.0-stage → 1.0.0

package/README.md

@@ -1,3 +1,42 @@
-# Temporary Holding Version
+# dsh-plugin-sprig
 
-This version is a temporary placeholder for this package. An operational version to replace this has been submitted for review and is awaiting a staged release.
+DSH client plugin that turns selected conversation text into a [Sprig](https://github.com/thatwzzh/sprig) explanation card.
+
+Select text in a DSH conversation → the native quote bar becomes **Copy / Quote / Explain with Sprig**.
+
+## Install
+
+```bash
+dsh plugin add dsh-plugin-sprig
+```
+
+Or from DSH settings → **Plugins → Add plugin** and paste `dsh-plugin-sprig`.
+
+Then make sure **Sprig is running** and **cross-app selection is enabled** in Sprig's settings, and refresh the DSH page (or start a new session).
+
+## What it does
+
+- Reuses DSH's own `quote` surface (same key, lower priority) instead of adding a second right-click menu that duplicates the native Copy.
+- Sends at most **one real user/assistant message either side** of the selection — `<system-reminder>`, `available_skills`, and context nodes are filtered out, capped at 1800 characters.
+- Delivers the payload to a **running Sprig** over the local bridge on `127.0.0.1:53917`. Sprig creates the card and explains.
+- Sprig carries the source with the explanation, so a selection inside a DSH answer still knows which conversation it came from.
+
+## Requirements
+
+- Sprig running on the same machine, with **cross-app selection** enabled.
+- DSH **Web UI**. The terminal/CLI does not work — there is no browser surface to hook into.
+
+## Limitations
+
+- The plugin hooks DSH's internal quote surface. A major DSH upgrade may change that surface and require an update here.
+- The bridge listens on loopback only, has no token, and can only create explanation cards. It never reads local data.
+- Request logs go to `/tmp/sprig-bridge.log`.
+
+## Links
+
+- Repo: [thatwzzh/sprig](https://github.com/thatwzzh/sprig) · plugin source at [`dsh-plugins/sprig`](https://github.com/thatwzzh/sprig/tree/main/dsh-plugins/sprig)
+- Sprig site: [sprig-site.app.workbuddy.host](https://sprig-site.app.workbuddy.host/?sharecode=HVF3SOVDGG)
+
+## License
+
+MIT

package/client.js

@@ -0,0 +1,210 @@
+/**
+ * DSH Client 插件：把「复制 / 引用 / 用知枝解释」合并到 DSH 原有的选词操作条。
+ *
+ * 做法：复用 message-quotes 的 selection 交互（由它 request.open() 打开 quote 表面），
+ * 但把 key='quote' 的表面替换成同时包含三个操作的组件，避免右键时和原生 Copy 菜单叠在一起。
+ */
+window.__ModuleLoader__.load({
+  id: '@local/sprig',
+  factory(require) {
+    const React = require('react')
+    const h = React.createElement
+    const BRIDGE = 'http://127.0.0.1:53917/v1/explain'
+
+    // 只取用户/助手真实对话；system-reminder、技能清单、注入上下文不参与解释。
+    const SYSTEM_REMINDER = /<system-reminder>[\s\S]*?<\/system-reminder>/gi
+    const AVAILABLE_SKILLS = /<available_skills>[\s\S]*?<\/available_skills>/gi
+
+    function cleanText(raw) {
+      return String(raw || '')
+        .replace(SYSTEM_REMINDER, '')
+        .replace(AVAILABLE_SKILLS, '')
+        .trim()
+    }
+
+    function nodeText(node) {
+      if (!node) return ''
+      if (node.kind === 'user' || node.kind === 'steering') {
+        return cleanText((node.content || [])
+          .filter(block => block && block.type === 'text' && typeof block.text === 'string')
+          .map(block => block.text)
+          .join('\n'))
+      }
+      if (node.kind === 'assistant') {
+        return cleanText((node.blocks || [])
+          .filter(block => block && block.kind === 'text' && typeof block.text === 'string')
+          .map(block => block.text)
+          .join('\n'))
+      }
+      // context（系统注入）、tool、command 等节点不是对话上下文
+      return ''
+    }
+
+    function roleLabel(node) {
+      if (!node) return '消息'
+      if (node.kind === 'assistant') return '助手'
+      return '用户'
+    }
+
+    function excerptAround(text, selection, limit) {
+      if (text.length <= limit) return text
+      const index = text.indexOf(selection)
+      if (index < 0) return text.slice(0, limit) + '…'
+      const before = Math.max(0, Math.floor((limit - selection.length) / 2))
+      const start = Math.max(0, index - before)
+      const head = start > 0 ? '…' : ''
+      const tail = start + limit < text.length ? '…' : ''
+      return head + text.slice(start, start + limit) + tail
+    }
+
+    function buildContext(nodes, selection) {
+      const items = (nodes || [])
+        .filter(node => node && (node.kind === 'user' || node.kind === 'steering' || node.kind === 'assistant'))
+        .map(node => ({ node, text: nodeText(node) }))
+        .filter(item => item.text.length > 0)
+
+      if (items.length === 0) return ''
+      const matched = items.findIndex(item => item.text.includes(selection))
+      const center = matched >= 0 ? matched : items.length - 1
+      const indexes = []
+      if (center - 1 >= 0) indexes.push(center - 1)
+      indexes.push(center)
+      if (center + 1 < items.length) indexes.push(center + 1)
+
+      const blocks = []
+      let remaining = 1800
+      for (const index of indexes) {
+        if (remaining < 80) break
+        const item = items[index]
+        const selected = index === center
+        const budget = Math.min(selected ? 1000 : 400, remaining - 20)
+        const text = excerptAround(item.text, selection, budget)
+        const block = `【${roleLabel(item.node)}】\n${text}`
+        if (block.length <= remaining) {
+          blocks.push(block)
+          remaining -= block.length
+        }
+      }
+      return blocks.join('\n\n').slice(0, 1800)
+    }
+
+    const baseButton = {
+      height: 26,
+      padding: '0 11px',
+      borderRadius: 7,
+      border: '1px solid var(--dsw-alias-border, rgba(127,127,127,.35))',
+      background: 'var(--dsw-alias-bg-elevated, #fff)',
+      color: 'var(--dsw-alias-text-primary, #111)',
+      font: '12px -apple-system, system-ui, sans-serif',
+      cursor: 'pointer',
+      whiteSpace: 'nowrap',
+    }
+
+    function SelectionActions({ dismiss, readText, clearSelection, inputActions, useSession, useChat, sessionId }) {
+      const enabled = useSession(s => !s.removed && (s.subagent === null || s.subagent.address.mode === 'continuable'))
+      const nodes = useChat(snapshot => (snapshot && snapshot.legacy ? snapshot.legacy.nodes : []))
+      const [busy, setBusy] = React.useState(false)
+      const [message, setMessage] = React.useState('')
+
+      React.useEffect(() => {
+        if (!enabled) dismiss()
+      }, [enabled, dismiss])
+      if (!enabled) return null
+
+      const currentText = () => {
+        const text = readText()
+        if (text === null || !text.trim()) {
+          dismiss()
+          return null
+        }
+        return text
+      }
+
+      const copy = async () => {
+        const text = currentText()
+        if (text === null) return
+        try {
+          await navigator.clipboard.writeText(text)
+          clearSelection()
+          dismiss()
+        } catch (error) {
+          setMessage('复制失败')
+        }
+      }
+
+      const quote = () => {
+        const text = currentText()
+        if (text === null) return
+        if (!inputActions.insertQuote(text)) {
+          setMessage('当前会话不能引用')
+          return
+        }
+        clearSelection()
+        dismiss()
+      }
+
+      const explain = async () => {
+        const selection = currentText()
+        if (selection === null) return
+        setBusy(true)
+        setMessage('')
+        try {
+          const response = await fetch(BRIDGE, {
+            method: 'POST',
+            headers: { 'Content-Type': 'application/json' },
+            body: JSON.stringify({
+              selection,
+              context: buildContext(nodes, selection),
+              title: 'DSH 对话',
+              appName: 'DeepSeek Harness',
+              sessionID: String(sessionId || ''),
+              messageRole: 'assistant',
+            }),
+          })
+          if (!response.ok) throw new Error(`HTTP ${response.status}`)
+          clearSelection()
+          dismiss()
+        } catch (error) {
+          setMessage('知枝未运行，或本机 bridge 被占用；先打开知枝再试')
+          setBusy(false)
+        }
+      }
+
+      return h('div', { style: { display: 'flex', alignItems: 'center', gap: 8 } },
+        h('button', {
+          type: 'button',
+          style: baseButton,
+          onPointerDown: event => event.preventDefault(),
+          onClick: copy,
+        }, '复制'),
+        h('button', {
+          type: 'button',
+          style: baseButton,
+          onPointerDown: event => event.preventDefault(),
+          onClick: quote,
+        }, '引用'),
+        h('button', {
+          type: 'button',
+          style: { ...baseButton, fontWeight: 500 },
+          disabled: busy,
+          onPointerDown: event => event.preventDefault(),
+          onClick: explain,
+        }, busy ? '正在发送…' : '用知枝解释'),
+        message ? h('span', { style: { fontSize: 11, opacity: 0.7, maxWidth: 260 } }, message) : null)
+    }
+
+    return {
+      inject: ['slots'],
+      apply(ctx) {
+        // key 复用 quote：不新增表面，直接替换为三合一的选词操作条。
+        ctx.slots.inject('conversation.chat.text-interaction', () => ctx.slots.register({
+          name: 'conversation.chat.text-interaction',
+          key: 'quote',
+          // message-quotes 已以 priority 0 占了 quote；同一 key 必须用更低的 priority
+          // 才能覆盖（slot 规则：数值越低越优先渲染）。
+          priority: -10,
+        }, SelectionActions))
+      },
+    }
+  },
+})

package/cordis.patch.yml

@@ -0,0 +1,4 @@
+- insert:
+    - id: sprig-dsh
+      name: '@local/sprig'
+      config: {}

package/docs/DETAIL.md

@@ -0,0 +1,18 @@
+# 知枝选词解释
+
+在 DSH 对话里选中文字后，原来的「引用」操作条会变成 **复制 / 引用 / 用知枝解释** 三个按钮，不再额外弹一个和原生 Copy 重叠的右键菜单。
+
+- 插件只读取选中文字，以及选中消息前后各最多一条**真实用户/助手消息**；系统注入的 `<system-reminder>`、技能清单、context 节点会被过滤，上下文总长 ≤1800 字。
+- 通过本机 `127.0.0.1:53917` 的 bridge 发送给 **正在运行的知枝**，由知枝建卡并流式解释。
+- 不会把内容上传到第三方；上下文只在本机 DSH 和知枝之间传递。
+
+## 前置条件
+
+1. 知枝已启动（菜单栏有图标）。
+2. 知枝设置里启用了「启用跨应用划词」。
+3. 选中 DSH 中已展示的用户内容或已完成的 Assistant 文本；工具、注入上下文、流式输出不参与选区交互。
+
+## 限制
+
+- 这是 DSH Client 插件，只出现在 Web UI；终端/CLI 不生效。
+- 知枝退出后按钮会提示「知枝未运行」，重试即可。

package/icon.svg

@@ -0,0 +1,4 @@
+<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 64 64">
+  <rect width="64" height="64" rx="14" fill="#2f6feb"/>
+  <path d="M32 13l4.2 13.8L50 31l-13.8 4.2L32 49l-4.2-13.8L14 31l13.8-4.2z" fill="#fff"/>
+</svg>

package/index.js

@@ -0,0 +1,2 @@
+/** Host half of the Sprig bundle; the Client module owns selection UI. */
+export function apply() {}

package/locale/en.json

@@ -0,0 +1,7 @@
+{
+  "meta": {
+    "title": "Sprig selection explain",
+    "description": "Select text in a DSH conversation and send it with nearby messages to the local Sprig app for an explanation card. Sprig must be running.",
+    "detail": "docs/DETAIL.md"
+  }
+}

package/locale/zh.json

@@ -0,0 +1,7 @@
+{
+  "meta": {
+    "title": "知枝选词解释",
+    "description": "选中 DSH 对话里的文字，点「用知枝解释」，把选区、相邻对话上下文和来源发送到本机知枝生成解释卡片。需要知枝正在运行。",
+    "detail": "docs/DETAIL.md"
+  }
+}

package/package.json

@@ -1,6 +1,53 @@
 {
   "name": "dsh-plugin-sprig",
-  "version": "0.0.0-stage",
-  "stub": true,
-  "description": "Temporary package placeholder for staged publishing"
-}
+  "version": "1.0.0",
+  "description": "DSH client plugin: send selected conversation text to Sprig and get a source-aware explanation card.",
+  "type": "module",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/thatwzzh/sprig.git",
+    "directory": "dsh-plugins/sprig"
+  },
+  "homepage": "https://github.com/thatwzzh/sprig/tree/main/dsh-plugins/sprig",
+  "bugs": {
+    "url": "https://github.com/thatwzzh/sprig/issues"
+  },
+  "keywords": [
+    "dsh",
+    "dsh-plugin",
+    "sprig",
+    "selection",
+    "explain",
+    "macos"
+  ],
+  "exports": {
+    ".": "./index.js",
+    "./client": "./client.js",
+    "./locale/*.json": "./locale/*.json",
+    "./icon": "./icon.svg"
+  },
+  "files": [
+    "index.js",
+    "client.js",
+    "cordis.patch.yml",
+    "locale/*.json",
+    "docs",
+    "icon.svg",
+    "README.md"
+  ],
+  "dsh": {
+    "bundle": {
+      "patch": "./cordis.patch.yml"
+    },
+    "client": {
+      "platform": "web",
+      "immediately": true,
+      "inject": [
+        "@deepseek-ai/dsh-client-ui-conversation",
+        "@deepseek-ai/dsh-client-ui-chat",
+        "@deepseek-ai/dsh-message-quotes"
+      ]
+    }
+  }
+}