dsh-plugin-look-up 0.1.1 → 0.2.0

package/README.md

@@ -1,86 +1,96 @@
 # dsh-plugin-look-up
 
-macOS-style **Look Up** inside [DeepSeek Harness](https://github.com/deepseek-ai/deepseek-harness) chat: select a word in any conversation, click the small **Look Up / 查词** chip, and read the definition in a card anchored to the selection.
+macOS **Look Up** inside [DeepSeek Harness](https://github.com/deepseek-ai/deepseek-harness) chat: select a word in any message, and read the **complete Dictionary.app entry** in a card anchored to the selection — senses, examples, grammar labels, etymology, and the dictionary's own typography.
 
-The definitions come from the **dictionaries you already have in Dictionary.app** — the same local, offline data macOS Look Up reads. No network request, no API key, no accessibility permission.
+Everything comes from the dictionaries you already have installed in Dictionary.app. No network, no API key, no accessibility permission.
 
-![version](https://img.shields.io/npm/v/dsh-plugin-look-up) ![license](https://img.shields.io/npm/l/dsh-plugin-look-up)
+![Full macOS Dictionary entry](https://raw.githubusercontent.com/huanglianqi/dsh-plugin-look-up/main/docs/preview-english.jpg)
 
-## What it looks like
+## What you get
 
-```
-选中 “serendipity”  ──►  [ 🔍 查词 ]  ──►  ┌─────────────────────────────┐
-                                            │ serendipity            ✕   │
-                                            │ ˌsɛr(ə)nˈdɪpɪti            │
-                                            │ noun formal                │
-                                            │ ① uncountable (luck) …     │
-                                            │ ② countable …              │
-                                            ├─────────────────────────────┤
-                                            │ macOS 系统词典 · 本地查询    │
-                                            │        复制   在词典中打开  │
-                                            └─────────────────────────────┘
-```
+- **Full entries, not a summary.** The card renders the same HTML entry and the same `DefaultStyle.css` macOS Dictionary uses, so examples and secondary senses are not flattened away.
+- **Multiple dictionaries.** A word that appears in several local dictionaries gets tabs (for example the bilingual 牛津英汉汉英词典 and New Oxford American Dictionary). The system's default pick comes first when its headword matches the query; for an English word that collides with a Chinese pinyin entry, the English entry is moved up.
+- **Offline and local.** Definitions are read from local dictionary bundles. The only process boundary is a local helper executable.
+- **Theme aware.** The entry is rendered in a sandboxed iframe with `color-scheme` following the DSH light/dark theme; the card itself uses the DSH theme tokens.
+
+| Bilingual entry | Chinese entry (light) |
+| --- | --- |
+| ![Bilingual entry](https://raw.githubusercontent.com/huanglianqi/dsh-plugin-look-up/main/docs/preview-bilingual.jpg) | ![Chinese entry](https://raw.githubusercontent.com/huanglianqi/dsh-plugin-look-up/main/docs/preview-chinese.jpg) |
 
 ## Requirements
 
 - macOS 11 or newer.
-- DSH Desktop (or the DSH Web GUI served on the same Mac).
-- At least one dictionary installed in **Dictionary.app** (Oxford, 现代汉语词典, 新华字典, 牛津英汉汉英词典 … all work). Check with Dictionary.app → Settings → Dictionaries.
+- DSH Desktop, or the DSH Web GUI served on the same Mac.
+- At least one dictionary installed in **Dictionary.app** (Oxford, 现代汉语词典, 新华字典, 牛津英汉汉英词典 … all work).
 
 ## Install
 
-From the DSH plugin CLI:
-
 ```bash
-dsh plugin --profile <profile> add dsh-plugin-look-up
+dsh plugin --profile <profile> add dsh-plugin-look-up@0.2.0
 ```
 
-Or install the bundle manually in DSH: **Settings → Plugins → add** and give the package name `dsh-plugin-look-up`, then enable the **Look Up** row.
+Or install the bundle in DSH: **Settings → Plugins → add** `dsh-plugin-look-up@0.2.0`, enable the **Look Up** row, and restart DSH once so the new Host and Client modules load.
 
-The package ships a small signed universal helper (`bin/dsh-lookup-dict`, arm64 + x86_64). Nothing is compiled on install.
+The package ships a signed universal helper (`bin/dsh-lookup-dict`, arm64 + x86_64). Nothing is compiled on install.
 
 ## Use
 
-1. Select a word or a short phrase in a chat message.
-2. Click the **查词 / Look Up** chip that appears next to the selection.
-3. Read the definition; **Escape**, an outside click, or scrolling closes the card.
-4. `复制` copies the word; `在词典中打开` opens the full entry in Dictionary.app through the `dict:` URL scheme.
-
-The card follows the DSH theme (light/dark, Dream Skin tokens) and the active UI language (中文 / English).
+1. Select a word or short phrase in a chat message.
+2. Click the **查词 / Look Up** chip next to the selection.
+3. Switch dictionaries with the tabs above the entry.
+4. `Escape`, an outside click, or scrolling closes the card. `复制单词` copies the word; `在词典中打开` opens the full entry in Dictionary.app.
 
 ## How it works
 
-| Layer | Responsibility |
+| File | Responsibility |
 | --- | --- |
-| `client.js` | Reads the current selection, places the chip/card on `shell.overlay`, renders definitions. |
-| `index.js` | Host routes under `/plugin/look-up/*`: loopback-only, bounded JSON body, in-memory cache. |
-| `bin/dsh-lookup-dict` | Objective-C helper calling `DCSCopyTextDefinition` from DictionaryServices — the same API behind Look Up. |
+| `client.js` | Selection pill, dictionary tabs, sandboxed iframe, theme detection, dismissal. |
+| `index.js` | Loopback-only Host routes, cache, and a fan-out to one helper per dictionary. |
+| `bin/dsh-lookup-dict` | One DictionaryServices `DCSCopyDefinitionMarkup` call, plus the dictionary's `DefaultStyle.css`. |
 
-Only the selected word is passed to the helper. The helper reads local dictionary data and prints JSON. There is no telemetry, no network call, and the route rejects non-loopback hosts.
+The markup API is a private DictionaryServices entry point. It is **not stable when several dictionaries are queried in one process** (some streamed or auxiliary bundles fault inside the framework), so the helper performs exactly one markup call per process and the Host runs a few helpers in parallel. It also takes a trailing `CFURLRef *` out-parameter that returns the dictionary's stylesheet; leaving that uninitialized makes the framework write through garbage.
+
+Only dictionaries that expose a local bundle URL are queried. The default entry is always included; for Latin words the Host additionally asks the bilingual Oxford and the two Oxford English dictionaries, and for Chinese words the modern-Chinese and bilingual dictionaries.
 
 ### Why not the native Look Up panel?
 
-The system definition panel belongs to the Electron shell: DSH runs its Host in an Electron `utilityProcess` without `webContents`, and the renderer preload exposes a fixed action whitelist, so a plugin cannot call `webContents.showDefinitionForSelection()`. A native helper can *display* the panel, but it steals keyboard focus and dismisses itself when the user clicks back into DSH — a poor fit for a chat overlay. This plugin instead reproduces the content and the interaction inside the conversation, using the same dictionaries.
+The system panel belongs to the Electron shell: DSH runs its Host in an Electron `utilityProcess` without `webContents`, and the renderer preload exposes a fixed action whitelist, so a plugin cannot call `webContents.showDefinitionForSelection()`. A native helper can display the panel, but it steals keyboard focus and dismisses itself when the user clicks back into DSH — a poor fit for a chat overlay. The card reproduces the native content and stylesheet inside the conversation instead.
+
+## Privacy
+
+The selected word is passed to a local helper executable. The helper reads local dictionary bundles and prints JSON. There is no telemetry and no network call; the routes reject non-loopback hosts.
+
+## Limits
+
+- macOS only.
+- Only dictionaries installed and enabled in Dictionary.app are used; streamed/partially downloaded dictionaries are skipped.
+- Audio pronunciation buttons and cross-reference links in the entry HTML are inert; images that point into the dictionary bundle are not proxied.
+- A word with no entry in any local dictionary shows “no entry”.
 
 ## Development
 
 ```bash
 npm run build:helper   # rebuild + re-sign bin/dsh-lookup-dict
+npm test               # Host route tests (real dictionary lookups)
 npm run check          # syntax-check the two entry points
 ```
 
-Source of the helper: [`native/dsh-lookup-dict.m`](native/dsh-lookup-dict.m). The ad-hoc signature is applied by the build script; no Developer ID is required for local execution.
-
 ## 中文说明
 
-在 DSH 对话里选中一个单词，点击旁边出现的「查词」小胶囊，就在原位弹出释义卡片。词条来自本机「词典」App 里已安装的词典（牛津、现代汉语词典、新华字典等），与 macOS 的 Look Up 同源，**完全离线**，不联网、不需要 API key、不需要辅助功能权限。
+在 DSH 对话里选中单词，点击「查词」，直接在原位展开 **完整的 macOS 系统词典词条**：义项、例句、词性、词源，排版和「词典」App 本体一致。
 
-- 系统要求：macOS 11+，DSH Desktop 或同一台 Mac 上的 DSH Web GUI。
-- 安装：`dsh plugin --profile <profile> add dsh-plugin-look-up`。
-- 关闭：Esc、点击卡片外、滚动页面。
-- 复制 / 在词典中打开（走 `dict:` URL scheme）。
+- 词条来自本机「词典」App 已安装的本地词典；同一个词命中多本词典时，卡片顶部会出现词典标签页。
+- 默认优先显示系统默认词典；英文词如果误命中中文拼音词条（例如 `run`），会把英文词典排到前面。
+- 完全离线，不联网、不需要 API key、不需要辅助功能权限。
+- Esc、点击卡片外、滚动页面关闭；支持「复制单词」和「在词典中打开」。
+
+安装：
+
+```bash
+dsh plugin --profile <profile> add dsh-plugin-look-up@0.2.0
+```
 
-已知边界：Electron 的系统释义面板无法被第三方插件直接调用（Host 在 utilityProcess 里，渲染层 preload 只暴露固定动作白名单），所以这里用同一个系统词典数据在对话内复刻了交互。
+已知边界：原生 Look Up 面板无法被第三方插件直接调用（Host 在 Electron utilityProcess 里，渲染层 preload 只暴露固定动作白名单），所以用同一份系统词典数据和词典自带样式在对话内复刻；词典里的发音按钮和交叉引用链接不可交互。
 
 ## License
 

package/client.js

@@ -18,7 +18,7 @@ window.__ModuleLoader__.load({
     const LOOKUP_URL = '/plugin/look-up/lookup'
     const OPEN_URL = '/plugin/look-up/open'
     const MAX_WORD_LENGTH = 64
-    const CARD_WIDTH = 380
+    const CARD_WIDTH = 420
 
     /** Runtime copy; the package locale files carry only the plugin metadata. */
     const STRINGS = {
@@ -121,9 +121,9 @@ window.__ModuleLoader__.load({
 }
 .dlu-head {
   display: flex;
-  align-items: flex-start;
-  gap: 10px;
-  padding: 13px 12px 9px 16px;
+  align-items: center;
+  gap: 8px;
+  padding: 9px 10px 7px 12px;
 }
 .dlu-titles { min-width: 0; }
 .dlu-word {
@@ -171,6 +171,42 @@ window.__ModuleLoader__.load({
 .dlu-body p { margin: 0 0 9px; }
 .dlu-body p:last-child { margin-bottom: 0; }
 .dlu-body b, .dlu-body strong { font-weight: 640; }
+.dlu-body.is-frame { padding: 0; overflow: hidden; }
+.dlu-tabs {
+  flex: 1;
+  min-width: 0;
+  display: flex;
+  gap: 4px;
+  padding: 0;
+  overflow-x: auto;
+  scrollbar-width: none;
+}
+.dlu-dict-label {
+  flex: 1;
+  min-width: 0;
+  font-size: 11px;
+  color: var(--dsw-alias-label-secondary, GrayText);
+  white-space: nowrap;
+  overflow: hidden;
+  text-overflow: ellipsis;
+}
+.dlu-tabs::-webkit-scrollbar { display: none; }
+.dlu-tab {
+  flex: none;
+  height: 24px;
+  padding: 0 9px;
+  border: 0;
+  border-radius: 6px;
+  background: transparent;
+  color: var(--dsw-alias-label-secondary, GrayText);
+  font: 550 11px/1 -apple-system, BlinkMacSystemFont, "PingFang SC", sans-serif;
+  white-space: nowrap;
+  cursor: pointer;
+}
+.dlu-tab:hover { background: var(--dsw-alias-interactive-bg-hover, rgba(127,127,127,.14)); color: var(--dsw-alias-label-primary, CanvasText); }
+.dlu-tab.is-active { background: var(--dsw-alias-interactive-bg-active, rgba(127,127,127,.2)); color: var(--dsw-alias-label-primary, CanvasText); }
+.dlu-tab:focus-visible { outline: 2px solid var(--dsw-alias-brand-primary, Highlight); outline-offset: 1px; }
+.dlu-frame { display: block; width: 100%; border: 0; background: transparent; }
 .dlu-empty {
   color: var(--dsw-alias-label-secondary, GrayText);
   font-size: 13px;
@@ -346,6 +382,90 @@ window.__ModuleLoader__.load({
       return { phonetic, paragraphs: paragraphs.length > 0 ? paragraphs : [body] }
     }
 
+    /** `cjk`, `latin`, or `other`. */
+    function scriptOf(text) {
+      if (/[\u3400-\u9fff\u3040-\u30ff\uac00-\ud7af]/u.test(text)) return 'cjk'
+      if (/[A-Za-z\u00c0-\u024f]/u.test(text)) return 'latin'
+      return 'other'
+    }
+
+    /** Keep the system default (when its headword matches the query) near the top. */
+    function sortEntries(entries, word) {
+      const queryScript = scriptOf(word)
+      const scored = entries.map((entry, index) => {
+        const titleScript = scriptOf(entry.title || entry.dictionary || '')
+        let score = 0
+        if (titleScript === queryScript) score += 10
+        if (entry.default === true) score += 5
+        if (!/thesaurus|同义|同義/iu.test(entry.dictionary || '')) score += 2
+        if (/Oxford|牛津/iu.test(entry.dictionary || '')) score += 1
+        return { entry, score, index }
+      })
+      scored.sort((a, b) => b.score - a.score || a.index - b.index)
+      return scored.map((item) => item.entry)
+    }
+
+    /** Compact tab label from the dictionary name / short name. */
+    function shortLabel(entry) {
+      const full = String(entry.dictionary || '').trim()
+      const short = String(entry.shortName || '').trim()
+      if (full.length > 0 && full.length <= 18) return full
+      if (short.length > 0) return short.length <= 22 ? short : `${short.slice(0, 20)}…`
+      return full.length <= 26 ? full : `${full.slice(0, 24)}…`
+    }
+
+    /** Resolved theme, using the shell's marker and the page background as fallbacks. */
+    function isDarkTheme() {
+      const root = document.documentElement
+      const body = document.body
+      if (root.hasAttribute('data-ds-dark-theme') || body.hasAttribute('data-ds-dark-theme')) return true
+      if (root.classList.contains('dark') || body.classList.contains('dark')) return true
+      if (root.getAttribute('data-theme') === 'dark' || body.getAttribute('data-theme') === 'dark') return true
+      try {
+        const background = getComputedStyle(body).backgroundColor
+        const match = /rgba?\((\d+),\s*(\d+),\s*(\d+)/u.exec(background)
+        if (match !== null) return (Number(match[1]) + Number(match[2]) + Number(match[3])) / 3 < 128
+      } catch {
+        // fall through to the system preference
+      }
+      try { return window.matchMedia('(prefers-color-scheme: dark)').matches } catch { return false }
+    }
+
+    /** The dictionary's own CSS with a transparent, card-sized frame around it. */
+    function frameDocument(entry, dark) {
+      const theme = dark
+        ? { scheme: 'dark', text: '#eef2f8', secondary: '#9aa6b8', scroll: 'rgba(255,255,255,.18)' }
+        : { scheme: 'light', text: '#101828', secondary: '#475467', scroll: 'rgba(15,23,42,.18)' }
+      const nativeCss = String(entry.css || '')
+      const fallbackCss = nativeCss === ''
+        ? `<style>
+.entry, .semb, .se1, .se2, .gramb, .eg, .ex, .def, .trans, .msDict { display: block; }
+.semb, .se2 { margin: .35em 0 .35em 1em; }
+.hw, .hg, .hwg { font-weight: 650; }
+.ph, .pr, .prx { color: ${theme.secondary}; font-family: ui-monospace, "SF Mono", Menlo, monospace; }
+.eg, .ex { color: ${theme.secondary}; font-style: italic; }
+</style>`
+        : ''
+      return `<!doctype html><html><head><meta charset="utf-8">${fallbackCss}<style>${nativeCss}</style><style>
+:root { color-scheme: ${theme.scheme}; }
+html, body { margin: 0 !important; padding: 0 !important; background: transparent !important; height: auto !important; min-height: 0 !important; }
+body {
+  padding: 2px 16px 14px !important;
+  color: ${theme.text};
+  font-size: 13.5px;
+  line-height: 1.62;
+  overflow-wrap: anywhere;
+  -webkit-font-smoothing: antialiased;
+}
+a { color: inherit; text-decoration: none; pointer-events: none; }
+img, svg, table { max-width: 100% !important; }
+img { height: auto; }
+::-webkit-scrollbar { width: 8px; height: 8px; }
+::-webkit-scrollbar-thumb { background: ${theme.scroll}; border-radius: 4px; }
+::-webkit-scrollbar-track { background: transparent; }
+</style></head><body>${String(entry.html || '')}</body></html>`
+    }
+
     /** Re-render whenever the locale dictionary or active locale changes. */
     function useLocaleVersion(locale) {
       const [, setVersion] = useState(0)
@@ -362,6 +482,8 @@ window.__ModuleLoader__.load({
       const [opening, setOpening] = useState(false)
       const cardRef = useRef(null)
       const requestRef = useRef(0)
+      const frameRef = useRef(null)
+      const [frameHeight, setFrameHeight] = useState(0)
 
       useEffect(() => {
         cardRef.current = card
@@ -387,10 +509,38 @@ window.__ModuleLoader__.load({
           status: 'loading',
           result: null,
           code: null,
+          active: 0,
           position: cardPosition(selection.rect)
         })
       }, [])
 
+      // The iframe is cross-document but same-origin, so its real height is
+      // readable without running scripts inside the dictionary HTML.
+      const measureFrame = useCallback(() => {
+        const frame = frameRef.current
+        if (frame === null) return
+        let doc = null
+        try { doc = frame.contentDocument } catch { doc = null }
+        if (doc === null || doc.documentElement === null) return
+        const body = doc.body
+        const last = body !== null ? body.lastElementChild : null
+        const padding = body !== null ? Number.parseFloat(getComputedStyle(body).paddingBottom) || 0 : 0
+        const contentBottom = last !== null ? last.getBoundingClientRect().bottom : 0
+        const measured = Math.max(
+          contentBottom > 0 ? contentBottom + padding + 2 : 0,
+          body !== null ? body.scrollHeight : 0
+        )
+        const height = Math.ceil(measured)
+        if (height <= 0) return
+        const current = cardRef.current
+        const limit = Math.max(160, Math.min((current !== null ? current.position.maxHeight : 360) - 36, 560))
+        setFrameHeight(Math.min(height + 2, limit))
+      }, [])
+
+      useEffect(() => {
+        setFrameHeight(0)
+      }, [card === null ? null : card.requestId, card === null ? null : card.active])
+
       // Ask the Host once per opened card.
       useEffect(() => {
         if (card === null || card.status !== 'loading') return undefined
@@ -413,11 +563,19 @@ window.__ModuleLoader__.load({
         })
           .then((response) => response.json())
           .then((data) => {
-            if (data !== null && typeof data === 'object' && data.ok === true) {
-              settle({ status: 'ready', result: data })
-            } else {
-              settle({ status: 'error', code: data !== null && typeof data === 'object' ? data.code ?? 'failed' : 'failed' })
+            if (data !== null && typeof data === 'object' && data.ok === true && Array.isArray(data.entries) && data.entries.length > 0) {
+              settle({
+                status: 'ready',
+                active: 0,
+                result: { ...data, entries: sortEntries(data.entries, data.word ?? card.word) }
+              })
+              return
+            }
+            if (data !== null && typeof data === 'object' && data.ok === true && typeof data.definition === 'string') {
+              settle({ status: 'ready', active: 0, result: { ...data, entries: [] } })
+              return
             }
+            settle({ status: 'error', code: data !== null && typeof data === 'object' ? data.code ?? 'failed' : 'failed' })
           })
           .catch((error) => {
             settle({ status: 'error', code: error !== null && error !== undefined && error.name === 'AbortError' ? 'timeout' : 'failed' })
@@ -540,7 +698,14 @@ window.__ModuleLoader__.load({
       }, [])
 
       const result = card !== null && card.status === 'ready' ? card.result : null
-      const parsed = result !== null ? parseDefinition(result.definition, result.word ?? card.word) : null
+      const entries = result !== null && Array.isArray(result.entries) ? result.entries : []
+      const activeIndex = card !== null && Number.isInteger(card.active)
+        ? Math.min(Math.max(card.active, 0), Math.max(0, entries.length - 1))
+        : 0
+      const activeEntry = entries.length > 0 ? entries[activeIndex] ?? entries[0] : null
+      const fallbackText = result !== null && entries.length === 0 ? String(result.definition ?? result.text ?? '') : ''
+      const parsed = fallbackText !== '' ? parseDefinition(fallbackText, result.word ?? card.word) : null
+      const dark = isDarkTheme()
 
       const errorText = (() => {
         if (card === null || card.status !== 'error') return ''
@@ -586,10 +751,34 @@ window.__ModuleLoader__.load({
               }
             },
             h('div', { className: 'dlu-head' },
-              h('div', { className: 'dlu-titles' },
-                h('div', { className: 'dlu-word' }, result !== null ? result.word ?? card.word : card.word),
-                parsed !== null && parsed.phonetic !== '' ? h('div', { className: 'dlu-phonetic' }, parsed.phonetic) : null
-              ),
+              entries.length > 1
+                ? h('div', { className: 'dlu-tabs', role: 'tablist' },
+                    entries.map((entry, index) => h('button', {
+                      key: `${entry.id || entry.dictionary}-${index}`,
+                      type: 'button',
+                      role: 'tab',
+                      'aria-selected': index === activeIndex,
+                      className: `dlu-tab${index === activeIndex ? ' is-active' : ''}`,
+                      title: entry.dictionary || undefined,
+                      onMouseDown: (event) => {
+                        event.preventDefault()
+                        event.stopPropagation()
+                      },
+                      onClick: (event) => {
+                        event.stopPropagation()
+                        setCard((current) => current !== null ? { ...current, active: index } : current)
+                      }
+                    }, shortLabel(entry)))
+                  )
+                : entries.length === 1
+                  ? h('span', {
+                      className: 'dlu-dict-label',
+                      title: activeEntry.dictionary || undefined
+                    }, activeEntry.dictionary || t('source'))
+                  : h('div', { className: 'dlu-titles' },
+                      h('div', { className: 'dlu-word' }, card.word),
+                      parsed !== null && parsed.phonetic !== '' ? h('div', { className: 'dlu-phonetic' }, parsed.phonetic) : null
+                    ),
               h('button', {
                 type: 'button',
                 className: 'dlu-close',
@@ -599,7 +788,10 @@ window.__ModuleLoader__.load({
                 onClick: () => setCard(null)
               }, ICON_CLOSE)
             ),
-            h('div', { className: 'dlu-body', style: { maxHeight: `${card.position.maxHeight}px` } },
+            h('div', {
+              className: `dlu-body${entries.length > 0 ? ' is-frame' : ''}`,
+              style: entries.length > 0 ? undefined : { maxHeight: `${card.position.maxHeight}px` }
+            },
               card.status === 'loading'
                 ? h('div', { className: 'dlu-loading' },
                     h('span', null, t('loading')),
@@ -613,12 +805,41 @@ window.__ModuleLoader__.load({
               card.status === 'error'
                 ? h('div', { className: 'dlu-empty is-error' }, errorText)
                 : null,
-              card.status === 'ready' && parsed !== null
+              card.status === 'ready' && activeEntry !== null
+                ? h('iframe', {
+                    ref: frameRef,
+                    className: 'dlu-frame',
+                    title: activeEntry.dictionary || card.word,
+                    sandbox: 'allow-same-origin',
+                    srcDoc: frameDocument(activeEntry, dark),
+                    style: { height: `${frameHeight > 0 ? frameHeight : 220}px` },
+                    onLoad: () => {
+                      // The iframe is a separate document; forward Escape so
+                      // the card can be dismissed while the entry has focus.
+                      try {
+                        const doc = frameRef.current !== null ? frameRef.current.contentDocument : null
+                        if (doc !== null) {
+                          doc.addEventListener('keydown', (event) => {
+                            if (event.key === 'Escape') setCard(null)
+                          })
+                        }
+                      } catch {
+                        // cross-document access is best-effort
+                      }
+                      measureFrame()
+                      window.setTimeout(measureFrame, 160)
+                    }
+                  })
+                : null,
+              card.status === 'ready' && activeEntry === null && parsed !== null
                 ? parsed.paragraphs.map((paragraph, index) => h('p', { key: index }, paragraph))
                 : null
             ),
             h('div', { className: 'dlu-foot' },
-              h('span', { className: 'dlu-source' }, t('source')),
+              h('span', {
+                className: 'dlu-source',
+                title: activeEntry !== null && activeEntry.dictionary !== '' ? activeEntry.dictionary : undefined
+              }, activeEntry !== null && activeEntry.dictionary !== '' ? activeEntry.dictionary : t('source')),
               card.status === 'ready'
                 ? h('button', {
                     type: 'button',

package/index.js

@@ -2,14 +2,19 @@
  * dsh-plugin-look-up — Host half.
  *
  * The browser half owns the interaction; this half owns the only privileged
- * step: asking macOS for a definition. `bin/dsh-lookup-dict` is a small signed
- * universal helper that calls DictionaryServices' `DCSCopyTextDefinition`, the
- * same local dictionary data macOS Look Up reads. The Host never needs network
- * access, accessibility permission, or an Apple Events grant.
+ * step: asking macOS for full dictionary entries. `bin/dsh-lookup-dict` is a
+ * small signed universal helper that renders one entry through
+ * DictionaryServices (the same content macOS Dictionary shows), including the
+ * dictionary's own stylesheet. The Host never needs network access,
+ * accessibility permission, or an Apple Events grant.
+ *
+ * One helper process performs one dictionary lookup: the private markup API is
+ * not stable when several dictionaries are queried in one process, so the Host
+ * fans out to a few dictionary-specific helpers in parallel and merges them.
  *
  * Routes (loopback only, same-origin JSON):
  *   GET  /plugin/look-up/health          → mount, platform and helper status
- *   POST /plugin/look-up/lookup {word}   → { ok, word, definition } | { ok:false, code }
+ *   POST /plugin/look-up/lookup {word}   → { ok, word, entries[] } | { ok:false, code }
  *   POST /plugin/look-up/open   {word}   → open the word in Dictionary.app
  */
 
@@ -35,11 +40,20 @@ const MANIFEST = JSON.parse(readFileSync(new URL('./package.json', import.meta.u
 const HELPER_PATH = fileURLToPath(new URL('./bin/dsh-lookup-dict', import.meta.url))
 const MAX_WORD_LENGTH = 64
 const MAX_BODY_BYTES = 8 * 1024
-const MAX_CACHE_ENTRIES = 256
-const HELPER_TIMEOUT_MS = 5000
+const HELPER_TIMEOUT_MS = 8000
+const MAX_HELPER_BUFFER = 8 * 1024 * 1024
+const MAX_ENTRIES = 6
+const MAX_HTML_BYTES = 2 * 1024 * 1024
+const MAX_CSS_BYTES = 512 * 1024
+const CACHE_BUDGET_BYTES = 24 * 1024 * 1024
+
+/** Dictionary name fragments queried in addition to the system default. */
+const LATIN_FILTERS = ['牛津英汉', 'New Oxford American', 'Oxford Dictionary of English']
+const CJK_FILTERS = ['现代汉语规范', '牛津英汉', '商務新詞典']
 
-/** In-memory definition cache; definitions are immutable for a given word. */
+/** In-memory definition cache, bounded by total bytes as entries are large. */
 const cache = new Map()
+let cacheBytes = 0
 
 /** Whether the packaged helper exists and is executable. */
 function helperStatus() {
@@ -61,8 +75,8 @@ export function loopbackHost(req) {
   const host = req.headers.host
   if (typeof host !== 'string' || host === '') return false
   if (host.startsWith('[')) return host.startsWith('[::1]')
-  const name = host.split(':')[0]
-  return name === '127.0.0.1' || name === 'localhost'
+  const namePart = host.split(':')[0]
+  return namePart === '127.0.0.1' || namePart === 'localhost'
 }
 
 /**
@@ -111,55 +125,120 @@ async function readJson(req) {
   return parsed
 }
 
-/** Store one result in the definition cache, evicting the oldest entry. */
+/** Store one result in the definition cache, evicting the oldest entries. */
 function remember(word, value) {
-  cache.set(word, value)
-  if (cache.size > MAX_CACHE_ENTRIES) {
+  const bytes = Buffer.byteLength(JSON.stringify(value))
+  if (bytes > 4 * 1024 * 1024) return
+  const previous = cache.get(word)
+  if (previous !== undefined) cacheBytes -= previous.bytes
+  cache.set(word, { value, bytes })
+  cacheBytes += bytes
+  while (cacheBytes > CACHE_BUDGET_BYTES && cache.size > 1) {
     const oldest = cache.keys().next().value
-    if (oldest !== undefined) cache.delete(oldest)
+    if (oldest === undefined) break
+    const entry = cache.get(oldest)
+    if (entry !== undefined) cacheBytes -= entry.bytes
+    cache.delete(oldest)
+  }
+}
+
+/** `latin`, `cjk`, or `other`, used to choose which dictionaries to ask. */
+function scriptOf(word) {
+  if (/[\u3400-\u9fff\u3040-\u30ff\uac00-\ud7af]/u.test(word)) return 'cjk'
+  if (/[A-Za-z\u00c0-\u024f]/u.test(word)) return 'latin'
+  return 'other'
+}
+
+/**
+ * Run one helper process: the system default entry or one named dictionary.
+ * @param word - a normalized word.
+ * @param filter - dictionary name fragment, or null for the system default.
+ * @returns the parsed helper payload, or null when it failed or missed.
+ */
+async function runHelper(word, filter) {
+  const args = filter === null ? [word, '--entries'] : [word, '--dictionary', filter]
+  try {
+    const { stdout } = await execFileAsync(HELPER_PATH, args, {
+      timeout: HELPER_TIMEOUT_MS,
+      maxBuffer: MAX_HELPER_BUFFER,
+      encoding: 'utf8',
+      windowsHide: true
+    })
+    const parsed = JSON.parse(stdout.trim())
+    return parsed !== null && typeof parsed === 'object' ? parsed : null
+  } catch {
+    // A helper that cannot find the dictionary exits 0 with an empty list; a
+    // crash or timeout only loses this one perspective.
+    return null
+  }
+}
+
+/** Validate and bound one helper entry. */
+function normalizeEntry(entry, isDefault) {
+  if (entry === null || typeof entry !== 'object' || typeof entry.html !== 'string') return null
+  if (entry.html.length === 0 || entry.html.length > MAX_HTML_BYTES) return null
+  return {
+    dictionary: typeof entry.dictionary === 'string' ? entry.dictionary : '',
+    shortName: typeof entry.shortName === 'string' ? entry.shortName : '',
+    title: typeof entry.title === 'string' ? entry.title : '',
+    id: typeof entry.id === 'string' ? entry.id : '',
+    html: entry.html,
+    css: typeof entry.css === 'string' ? entry.css.slice(0, MAX_CSS_BYTES) : '',
+    default: isDefault
   }
 }
 
+/** Merge entries by dictionary entry id, preferring a named duplicate over `System default`. */
+function mergeEntries(entries) {
+  const merged = new Map()
+  for (const entry of entries) {
+    const key = entry.id !== '' ? entry.id : `${entry.dictionary}\u0000${entry.title}`
+    const previous = merged.get(key)
+    if (previous === undefined) {
+      merged.set(key, entry)
+      continue
+    }
+    const keepDefault = previous.default || entry.default
+    const preferred = previous.default && !entry.default ? entry : previous
+    merged.set(key, { ...preferred, default: keepDefault })
+  }
+  return [...merged.values()].slice(0, MAX_ENTRIES)
+}
+
 /**
- * Ask the macOS helper for one definition.
+ * Ask the macOS helper(s) for one word.
  * @param word - a normalized word.
  * @returns a client-facing result object.
  */
 async function lookupWord(word) {
   const cached = cache.get(word)
-  if (cached !== undefined) return cached
+  if (cached !== undefined) return cached.value
 
   if (process.platform !== 'darwin') return { ok: false, code: 'unsupported', word }
   if (helperStatus() !== 'ok') return { ok: false, code: 'helper-missing', word }
 
-  let stdout
-  try {
-    const result = await execFileAsync(HELPER_PATH, [word], {
-      timeout: HELPER_TIMEOUT_MS,
-      maxBuffer: 1024 * 1024,
-      encoding: 'utf8',
-      windowsHide: true
-    })
-    stdout = result.stdout
-  } catch (error) {
-    if (error?.code === 'ETIMEDOUT' || error?.killed === true) return { ok: false, code: 'timeout', word }
-    // The helper reports "no entry" as JSON with exit code 0, so a thrown
-    // error here means the process itself failed. Some spawn errors still
-    // carry usable stdout, but we do not trust partial output.
-    return { ok: false, code: 'helper-failed', word }
-  }
+  const script = scriptOf(word)
+  const filters = script === 'latin' ? LATIN_FILTERS : script === 'cjk' ? CJK_FILTERS : []
+  const payloads = await Promise.all([runHelper(word, null), ...filters.map((filter) => runHelper(word, filter))])
 
-  let parsed
-  try {
-    parsed = JSON.parse(stdout.trim())
-  } catch {
-    return { ok: false, code: 'helper-failed', word }
+  const entries = []
+  for (const payload of payloads) {
+    if (payload === null || payload.ok !== true || !Array.isArray(payload.entries)) continue
+    const isDefault = payload.default === true
+    for (const raw of payload.entries) {
+      const entry = normalizeEntry(raw, isDefault)
+      if (entry !== null) entries.push(entry)
+    }
   }
 
-  const result = parsed.ok === true
-    ? { ok: true, word, definition: String(parsed.definition ?? ''), source: 'DictionaryServices' }
-    : { ok: false, code: typeof parsed.error === 'string' ? parsed.error : 'no-entry', word }
-  if (result.ok) remember(word, result)
+  if (entries.length === 0) return { ok: false, code: 'no-entry', word }
+  const result = {
+    ok: true,
+    word,
+    entries: mergeEntries(entries),
+    source: 'DictionaryServices'
+  }
+  remember(word, result)
   return result
 }
 
@@ -210,7 +289,9 @@ async function serve(ctx, req, res) {
       version: MANIFEST.version,
       platform: process.platform,
       helper: helperStatus(),
+      helperVersion: 4,
       cacheEntries: cache.size,
+      cacheBytes,
       clientRegistered: clientBundle !== undefined,
       clientBundle: clientBundle ?? null
     })

package/locale/en.json

@@ -1,6 +1,6 @@
 {
   "meta": {
     "title": "Look Up",
-    "description": "Select a word in chat and read macOS system-dictionary definitions in place — offline, no network."
+    "description": "Select a word in chat and read the complete macOS Dictionary entry — senses, examples and the dictionary's own typography — offline, with no network."
   }
 }

package/locale/zh.json

@@ -1,6 +1,6 @@
 {
   "meta": {
     "title": "查词",
-    "description": "在对话里选中单词，就地查看 macOS 系统词典释义——离线、不联网。"
+    "description": "在对话里选中单词，就地阅读完整的 macOS 系统词典词条——义项、例句和词典原生排版，离线、不联网。"
   }
 }

package/native/dsh-lookup-dict.m

@@ -1,21 +1,31 @@
 /**
- * dsh-lookup-dict — tiny macOS system-dictionary bridge for dsh-plugin-look-up.
+ * dsh-lookup-dict — macOS system-dictionary bridge for dsh-plugin-look-up.
  *
- * Reads the definition of one word from the dictionaries the user configured in
- * Dictionary.app by calling DictionaryServices' public `DCSCopyTextDefinition`.
- * That is the same local, offline data source macOS Look Up uses; no network,
- * no accessibility permission, no Apple Events.
+ * One process performs exactly one DictionaryServices `DCSCopyDefinitionMarkup`
+ * call and returns the full entry HTML plus the dictionary's own
+ * `DefaultStyle.css`. That is the same content and stylesheet macOS Dictionary
+ * renders, so the in-chat card can show the complete entry.
+ *
+ * The private markup function takes two trailing pointers after the range (a
+ * reserved slot and a `CFURLRef *` for the stylesheet). Leaving them
+ * uninitialized makes the framework write through garbage and crash.
  *
  * Usage:
- *   dsh-lookup-dict <word>   -> one JSON object on stdout
- *   dsh-lookup-dict --version-> "1"
+ *   dsh-lookup-dict <word>                          -> the system default entry
+ *   dsh-lookup-dict <word> --dictionary <substring> -> first matching dictionary
+ *   dsh-lookup-dict --version                       -> "4"
  *
- * Exit codes: 0 when a JSON object was written (including `ok:false`),
- * 2 on usage errors. Output is always valid JSON otherwise.
+ * Exit codes: 0 when JSON was written (including `ok:false`), 2 on usage errors.
  */
 
 #import <Foundation/Foundation.h>
 #import <CoreServices/CoreServices.h>
+#include <dlfcn.h>
+
+typedef CFStringRef (*MarkupFn)(DCSDictionaryRef, CFStringRef, CFRange, void *, CFURLRef *);
+typedef CFTypeRef (*AvailableFn)(void);
+typedef CFStringRef (*NameFn)(DCSDictionaryRef);
+typedef CFStringRef (*ShortNameFn)(DCSDictionaryRef);
 
 static void write_json(NSDictionary *payload) {
     NSError *error = nil;
@@ -28,10 +38,84 @@ static void write_json(NSDictionary *payload) {
     fputc('\n', stdout);
 }
 
+static NSString *body_of(NSString *html) {
+    NSRange open = [html rangeOfString:@"<body>"];
+    NSRange close = [html rangeOfString:@"</body>"];
+    if (open.location == NSNotFound || close.location == NSNotFound || close.location <= open.location) return html;
+    return [html substringWithRange:NSMakeRange(open.location + open.length, close.location - open.location - open.length)];
+}
+
+static NSString *first_match(NSString *text, NSString *pattern) {
+    NSRegularExpression *regex = [NSRegularExpression regularExpressionWithPattern:pattern options:0 error:nil];
+    NSTextCheckingResult *match = [regex firstMatchInString:text options:0 range:NSMakeRange(0, text.length)];
+    if (match == nil || match.numberOfRanges < 2) return nil;
+    return [text substringWithRange:[match rangeAtIndex:1]];
+}
+
+static NSString *sanitize_fragment(NSString *html) {
+    NSRegularExpression *blocks = [NSRegularExpression regularExpressionWithPattern:@"<(script|iframe|object|embed)\\b[\\s\\S]*?</\\1\\s*>" options:NSRegularExpressionCaseInsensitive error:nil];
+    NSString *clean = [blocks stringByReplacingMatchesInString:html options:0 range:NSMakeRange(0, html.length) withTemplate:@""];
+    NSRegularExpression *handlers = [NSRegularExpression regularExpressionWithPattern:@"\\s+on[a-zA-Z]+\\s*=\\s*(\"[^\"]*\"|'[^']*')" options:0 error:nil];
+    clean = [handlers stringByReplacingMatchesInString:clean options:0 range:NSMakeRange(0, clean.length) withTemplate:@""];
+    return [clean stringByReplacingOccurrencesOfString:@"javascript:" withString:@"about:blank#"];
+}
+
+/** The dictionary's stylesheet, delivered by the markup call itself. */
+static NSString *read_style(CFURLRef url) {
+    if (url == NULL) return @"";
+    NSData *data = [NSData dataWithContentsOfURL:(__bridge NSURL *)url];
+    if (data == nil) return @"";
+    NSString *css = [[NSString alloc] initWithData:data encoding:NSUTF8StringEncoding];
+    if (css == nil) css = [[NSString alloc] initWithData:data encoding:NSUnicodeStringEncoding];
+    return css ?: @"";
+}
+
+/** `<...>/Name.dictionary/Contents/Resources/DefaultStyle.css` -> `Name`. */
+static NSString *dictionary_name_from_style(CFURLRef url) {
+    if (url == NULL) return @"System dictionary";
+    NSString *path = [(__bridge NSURL *)url path];
+    NSRange marker = [path rangeOfString:@".dictionary/"];
+    if (marker.location == NSNotFound) return @"System dictionary";
+    NSString *prefix = [path substringToIndex:marker.location];
+    NSString *name = [prefix lastPathComponent];
+    return name.length > 0 ? name : @"System dictionary";
+}
+
+/** First dictionary whose display name contains `filter`; NULL when absent. */
+static DCSDictionaryRef find_dictionary(AvailableFn available, NameFn name_of, NSString *filter) {
+    if (available == NULL || name_of == NULL) return NULL;
+    CFTypeRef dictionaries = available();
+    if (dictionaries == NULL) return NULL;
+
+    CFIndex count = 0;
+    const void **values = NULL;
+    if (CFGetTypeID(dictionaries) == CFSetGetTypeID()) {
+        count = CFSetGetCount((CFSetRef)dictionaries);
+        values = malloc(sizeof(void *) * (size_t)count);
+        CFSetGetValues((CFSetRef)dictionaries, values);
+    } else if (CFGetTypeID(dictionaries) == CFArrayGetTypeID()) {
+        count = CFArrayGetCount((CFArrayRef)dictionaries);
+        values = malloc(sizeof(void *) * (size_t)count);
+        for (CFIndex i = 0; i < count; i++) values[i] = CFArrayGetValueAtIndex((CFArrayRef)dictionaries, i);
+    }
+
+    DCSDictionaryRef found = NULL;
+    for (CFIndex i = 0; i < count; i++) {
+        DCSDictionaryRef candidate = (DCSDictionaryRef)values[i];
+        CFStringRef name = name_of(candidate);
+        if (name != NULL && [(__bridge NSString *)name containsString:filter]) {
+            found = candidate;
+            break;
+        }
+    }
+    free(values);
+    return found;
+}
+
 int main(int argc, const char *argv[]) {
     @autoreleasepool {
         if (argc > 1 && strcmp(argv[1], "--version") == 0) {
-            fputs("1\n", stdout);
+            fputs("4\n", stdout);
             return 0;
         }
         if (argc < 2) {
@@ -39,12 +123,16 @@ int main(int argc, const char *argv[]) {
             return 2;
         }
 
-        NSString *raw = [[NSString alloc] initWithUTF8String:argv[1]];
-        if (raw == nil) {
-            write_json(@{@"ok": @NO, @"error": @"encoding"});
-            return 0;
+        NSString *word = [[[NSString alloc] initWithUTF8String:argv[1]] stringByTrimmingCharactersInSet:[NSCharacterSet whitespaceAndNewlineCharacterSet]];
+        BOOL entries_mode = NO;
+        NSString *filter = nil;
+        if (argc > 2 && strcmp(argv[2], "--entries") == 0) {
+            entries_mode = YES;
+        } else if (argc > 3 && strcmp(argv[2], "--dictionary") == 0) {
+            entries_mode = YES;
+            filter = [[NSString alloc] initWithUTF8String:argv[3]];
         }
-        NSString *word = [raw stringByTrimmingCharactersInSet:[NSCharacterSet whitespaceAndNewlineCharacterSet]];
+
         if (word.length == 0) {
             write_json(@{@"ok": @NO, @"error": @"empty"});
             return 0;
@@ -54,26 +142,71 @@ int main(int argc, const char *argv[]) {
             return 0;
         }
 
-        CFRange range = CFRangeMake(0, (CFIndex)word.length);
-        CFStringRef copied = DCSCopyTextDefinition(NULL, (__bridge CFStringRef)word, range);
-        if (copied == NULL) {
-            write_json(@{@"ok": @NO, @"error": @"no-entry", @"word": word});
+        MarkupFn markup = (MarkupFn)dlsym(RTLD_DEFAULT, "DCSCopyDefinitionMarkup");
+        AvailableFn available = (AvailableFn)dlsym(RTLD_DEFAULT, "DCSCopyAvailableDictionaries");
+        NameFn name_of = (NameFn)dlsym(RTLD_DEFAULT, "DCSDictionaryGetName");
+        ShortNameFn short_name_of = (ShortNameFn)dlsym(RTLD_DEFAULT, "DCSDictionaryGetShortName");
+        if (markup == NULL) {
+            write_json(@{@"ok": @NO, @"error": @"no-markup-api"});
+            return 0;
+        }
+
+        CFStringRef word_ref = CFStringCreateWithCString(NULL, word.UTF8String, kCFStringEncodingUTF8);
+        if (word_ref == NULL) {
+            write_json(@{@"ok": @NO, @"error": @"encoding"});
             return 0;
         }
+        CFRange range = CFRangeMake(0, CFStringGetLength(word_ref));
 
-        NSString *definition = (__bridge_transfer NSString *)copied;
-        NSString *trimmed = [definition stringByTrimmingCharactersInSet:[NSCharacterSet whitespaceAndNewlineCharacterSet]];
-        if (trimmed.length == 0) {
-            write_json(@{@"ok": @NO, @"error": @"no-entry", @"word": word});
+        // 0.1.x compatibility: the old Host calls the helper without a mode
+        // flag and expects the flat plain-text definition.
+        if (!entries_mode) {
+            CFStringRef plain = DCSCopyTextDefinition(NULL, word_ref, range);
+            if (plain == NULL) {
+                write_json(@{@"ok": @NO, @"error": @"no-entry", @"word": word});
+            } else {
+                write_json(@{@"ok": @YES, @"word": word, @"definition": (__bridge_transfer NSString *)plain});
+            }
             return 0;
         }
 
-        write_json(@{
-            @"ok": @YES,
-            @"word": word,
-            @"definition": trimmed,
-            @"source": @"DictionaryServices"
-        });
+        DCSDictionaryRef dictionary = NULL;
+        NSString *dictionary_name = nil;
+        NSString *short_name = @"";
+
+        if (filter != nil) {
+            dictionary = find_dictionary(available, name_of, filter);
+            if (dictionary == NULL) {
+                write_json(@{@"ok": @YES, @"word": word, @"entries": @[]});
+                return 0;
+            }
+            CFStringRef name = name_of != NULL ? name_of(dictionary) : NULL;
+            if (name != NULL) dictionary_name = (__bridge NSString *)name;
+            CFStringRef short_ref = short_name_of != NULL ? short_name_of(dictionary) : NULL;
+            if (short_ref != NULL) short_name = (__bridge NSString *)short_ref;
+        }
+
+        CFURLRef style_url = NULL;
+        CFStringRef copied = markup(dictionary, word_ref, range, NULL, &style_url);
+        if (copied == NULL) {
+            write_json(@{@"ok": @YES, @"word": word, @"entries": @[]});
+            return 0;
+        }
+
+        NSString *html = (__bridge_transfer NSString *)copied;
+        NSString *title = first_match(html, @"<d:entry[^>]*\\bd:title=\"([^\"]*)\"");
+        NSString *identifier = first_match(html, @"<d:entry[^>]*\\bid=\"([^\"]*)\"");
+        if (dictionary_name.length == 0) dictionary_name = dictionary_name_from_style(style_url);
+
+        NSDictionary *entry = @{
+            @"dictionary": dictionary_name ?: @"System dictionary",
+            @"shortName": short_name,
+            @"title": title ?: word,
+            @"id": identifier ?: @"",
+            @"html": sanitize_fragment(body_of(html)),
+            @"css": read_style(style_url)
+        };
+        write_json(@{@"ok": @YES, @"word": word, @"entries": @[entry], @"default": filter == nil ? @YES : @NO});
     }
     return 0;
 }

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "dsh-plugin-look-up",
-  "version": "0.1.1",
-  "description": "macOS Look Up inside DSH chat: select a word and read system-dictionary definitions in place, offline.",
+  "version": "0.2.0",
+  "description": "Full macOS Dictionary entries inside DSH chat: select a word and read the complete system-dictionary entry, offline.",
   "type": "module",
   "license": "MIT",
   "author": "huanglianqi",
@@ -41,6 +41,7 @@
     "bin/dsh-lookup-dict",
     "native/dsh-lookup-dict.m",
     "scripts/build-helper.sh",
+    "docs/*.jpg",
     "README.md",
     "LICENSE"
   ],