dsh-prompt-refine 0.1.0

package/src/client.ts

@@ -0,0 +1,387 @@
+// client.ts —— 浏览器侧 client 半入口
+//
+// 只有一个注册点:`conversation.input.right`(list slot,发送按钮左侧)。
+// 该组件自己负责:✨ 按钮 + 弹窗(用 React Portal 挂到 document.body)。
+//
+// ⚠️ 关键教训:不要注册 `conversation` 这类 single slot —— 会被
+// ui-conversation 占用,重复注册会让整个 client 插件加载失败
+// ("single slot already has a registration")。
+//
+// 交互:
+//   点 ✨ → 读草稿 + 最近历史 → POST /dsh-prompt-refine/suggest
+//        → 弹窗列 3 条建议(可勾选)→ 采纳 → inputActions.setDraft(新草稿)
+//        → 关弹窗,用户自己按发送键(不抢发送权)
+
+declare global {
+  interface Window {
+    __ModuleLoader__: {
+      load(info: {
+        id: string
+        factory: (
+          require: (mod: string) => unknown,
+        ) => {
+          name: string
+          inject: string[]
+          apply: (ctx: unknown) => void
+        }
+      }): void
+    }
+  }
+}
+
+function makeFactory(): (require: (mod: string) => unknown) => unknown {
+  return (require) => {
+    const React = require('react') as {
+      createElement: (type: unknown, props?: Record<string, unknown> | null, ...children: unknown[]) => unknown
+      useState: <T>(init: T | (() => T)) => [T, (v: T | ((p: T) => T)) => void]
+      useEffect: (fn: () => void | (() => void), deps?: unknown[]) => void
+      Fragment: unknown
+    }
+    const h = React.createElement
+    // ⚠️ createPortal 在 react-dom(不是 react-dom/client —— 那里只有 createRoot)
+    const { createPortal } = require('react-dom') as {
+      createPortal: (node: unknown, container: Element) => unknown
+    }
+
+    const name = 'dsh-prompt-refine'
+    const inject: string[] = ['slots']
+
+    // ===== Portal 宿主(模块级,只创建一次)=====
+    let portalHost: HTMLElement | null = null
+    function getPortalHost(): HTMLElement {
+      if (portalHost === null || !portalHost.isConnected) {
+        portalHost = document.createElement('div')
+        portalHost.id = 'dsh-prompt-refine-portal'
+        document.body.appendChild(portalHost)
+      }
+      return portalHost
+    }
+
+    // ===== 样式(全部用 DSH 语义 token,暗色自动适配)=====
+    const S = {
+      btn: {
+        padding: 0, width: '32px', height: '32px', borderRadius: '8px',
+        border: '1px solid var(--dsw-alias-border-l2)', background: 'transparent',
+        color: 'var(--dsw-alias-label-secondary)', cursor: 'pointer',
+        display: 'inline-flex', alignItems: 'center', justifyContent: 'center',
+        fontSize: '15px', lineHeight: 1,
+      },
+      overlay: {
+        position: 'fixed', inset: 0, background: 'rgba(0,0,0,0.55)',
+        display: 'flex', alignItems: 'center', justifyContent: 'center',
+        zIndex: 9999, padding: '20px',
+      },
+      modal: {
+        background: 'var(--dsw-alias-bg-layer-1)', borderRadius: '14px',
+        width: '100%', maxWidth: '560px', maxHeight: '86vh', overflowY: 'auto',
+        boxShadow: '0 20px 60px rgba(0,0,0,0.28)',
+        border: '1px solid var(--dsw-alias-border-l2)', color: 'var(--dsw-alias-label-primary)',
+      },
+      header: { padding: '18px 22px 14px', borderBottom: '1px solid var(--dsw-alias-border-l2)' },
+      title: { fontSize: '16px', fontWeight: 600, margin: '0 0 4px' },
+      subtitle: { fontSize: '13px', color: 'var(--dsw-alias-label-secondary)', margin: 0 },
+      original: {
+        margin: '14px 22px 0', padding: '10px 12px',
+        background: 'var(--dsw-alias-bg-layer-1, rgba(0,0,0,0.04))', borderRadius: '8px',
+        fontSize: '13px', color: 'var(--dsw-alias-label-secondary)',
+        borderLeft: '3px solid var(--dsw-alias-label-tertiary)',
+      },
+      originalLabel: {
+        fontSize: '10px', color: 'var(--dsw-alias-label-tertiary)',
+        textTransform: 'uppercase', letterSpacing: '0.5px', marginBottom: '4px',
+      },
+      list: { padding: '14px 22px' },
+      row: {
+        display: 'flex', gap: '12px', padding: '12px',
+        border: '1px solid var(--dsw-alias-border-l2)', borderRadius: '10px',
+        marginBottom: '8px', cursor: 'pointer',
+      },
+      rowOn: {
+        borderColor: 'var(--dsw-alias-state-business-primary)',
+        background: 'var(--dsw-alias-interactive-bg-active, rgba(37,99,235,0.08))',
+      },
+      rowBody: { flex: 1, minWidth: 0 },
+      tag: {
+        display: 'inline-block', fontSize: '11px', padding: '2px 7px',
+        borderRadius: '4px', fontWeight: 500, marginBottom: '6px',
+      },
+      tagScope: { background: 'var(--dsw-alias-state-error-secondary)', color: 'var(--dsw-alias-state-error-primary)' },
+      tagFormat: { background: 'rgba(217,119,6,0.14)', color: '#d97706' },
+      tagConstraint: { background: 'rgba(37,99,235,0.14)', color: 'var(--dsw-alias-state-business-primary)' },
+      tagClarity: { background: 'rgba(5,150,105,0.16)', color: 'var(--dsw-alias-state-success-primary)' },
+      tagOther: { background: 'rgba(128,128,128,0.16)', color: 'var(--dsw-alias-label-secondary)' },
+      issue: { fontSize: '13.5px', margin: '0 0 8px', lineHeight: 1.45 },
+      patch: {
+        fontSize: '12.5px', color: 'var(--dsw-alias-label-secondary)',
+        background: 'rgba(128,128,128,0.08)', padding: '7px 10px', borderRadius: '6px', margin: 0,
+        fontFamily: 'ui-monospace, "SF Mono", Consolas, monospace',
+        border: '1px dashed var(--dsw-alias-border-l2)',
+      },
+      preview: {
+        margin: '0 22px 14px', padding: '10px 12px',
+        background: 'rgba(128,128,128,0.08)', borderRadius: '8px', fontSize: '13px',
+      },
+      previewLabel: {
+        fontSize: '10px', color: 'var(--dsw-alias-label-tertiary)',
+        textTransform: 'uppercase', letterSpacing: '0.5px', marginBottom: '6px',
+        display: 'flex', justifyContent: 'space-between',
+      },
+      previewCount: { color: 'var(--dsw-alias-state-business-primary)', fontWeight: 600 },
+      previewText: { lineHeight: 1.6 },
+      added: {
+        background: 'rgba(5,150,105,0.16)', color: 'var(--dsw-alias-state-success-primary)',
+        padding: '1px 5px', borderRadius: '3px', margin: '0 2px', fontWeight: 500,
+      },
+      footer: {
+        padding: '14px 22px', borderTop: '1px solid var(--dsw-alias-border-l2)',
+        display: 'flex', justifyContent: 'space-between', alignItems: 'center', gap: '12px',
+      },
+      hint: { fontSize: '12px', color: 'var(--dsw-alias-label-tertiary)' },
+      btnSec: {
+        padding: '8px 14px', borderRadius: '8px',
+        border: '1px solid var(--dsw-alias-border-l2)', background: 'transparent',
+        color: 'var(--dsw-alias-label-primary)', cursor: 'pointer', fontSize: '14px',
+      },
+      btnPri: {
+        padding: '8px 14px', borderRadius: '8px', border: 'none',
+        background: 'var(--dsw-alias-state-business-primary)',
+        color: 'var(--dsw-alias-button-info-fill, #fff)', cursor: 'pointer',
+        fontSize: '14px', fontWeight: 600,
+      },
+      skel: {
+        height: '58px', background: 'rgba(128,128,128,0.14)',
+        borderRadius: '10px', marginBottom: '8px',
+      },
+      tip: { textAlign: 'center', fontSize: '13px', color: 'var(--dsw-alias-label-secondary)', padding: '8px 0' },
+      err: { padding: '16px 22px', fontSize: '13px', color: 'var(--dsw-alias-state-error-primary)' },
+      warn: { padding: '0 22px 10px', fontSize: '12px', color: 'var(--dsw-alias-state-warn-primary, #d97706)' },
+    } as const
+
+    function tagStyle(tag: string): Record<string, string> {
+      switch (tag) {
+        case 'scope': return S.tagScope as unknown as Record<string, string>
+        case 'format': return S.tagFormat as unknown as Record<string, string>
+        case 'constraint': return S.tagConstraint as unknown as Record<string, string>
+        case 'clarity': return S.tagClarity as unknown as Record<string, string>
+        default: return S.tagOther as unknown as Record<string, string>
+      }
+    }
+
+    interface Item { tag: string; issue: string; patch: string }
+
+    // ===== 主组件:按钮 + 弹窗 =====
+    function PromptRefineControl(props: Record<string, unknown>): unknown {
+      const useInput = props.useInput as ((sel: (s: { draft: string }) => unknown) => unknown) | undefined
+      const useChat = props.useChat as ((sel: (s: { legacy: { nodes: unknown[] } }) => unknown) => unknown) | undefined
+      const inputActions = props.inputActions as { setDraft?: (s: string) => void } | undefined
+
+      // hooks 必须无条件调用(顺序稳定)
+      const draftNow = ((useInput ? useInput(s => s.draft) : '') as string) ?? ''
+      const nodes = ((useChat ? useChat(s => s.legacy.nodes) : []) as unknown[]) ?? []
+
+      const [host] = React.useState<HTMLElement>(() => getPortalHost())
+      const [open, setOpen] = React.useState(false)
+      const [phase, setPhase] = React.useState<'loading' | 'result' | 'error' | 'empty'>('loading')
+      const [reqDraft, setReqDraft] = React.useState('')
+      const [items, setItems] = React.useState<Item[]>([])
+      const [checked, setChecked] = React.useState<boolean[]>([])
+      const [errMsg, setErrMsg] = React.useState('')
+      const [usedModel, setUsedModel] = React.useState('')
+
+      // 从最近消息里提取历史(user: content[].type='text';assistant: blocks[].kind='text')
+      const collectHistory = (): Array<{ role: 'user' | 'assistant'; content: string }> => {
+        const out: Array<{ role: 'user' | 'assistant'; content: string }> = []
+        for (let i = nodes.length - 1; i >= 0 && out.length < 6; i--) {
+          const n = nodes[i] as {
+            kind?: string
+            content?: Array<{ type?: string; text?: string }>
+            blocks?: Array<{ kind?: string; text?: string }>
+          } | undefined
+          if (!n) continue
+          if (n.kind === 'user') {
+            const text = (n.content ?? []).filter(b => b && b.type === 'text').map(b => b.text ?? '').join('').trim()
+            if (text) out.unshift({ role: 'user', content: text.slice(0, 500) })
+          } else if (n.kind === 'assistant') {
+            const text = (n.blocks ?? []).filter(b => b && b.kind === 'text').map(b => b.text ?? '').join('').trim()
+            if (text) out.unshift({ role: 'assistant', content: text.slice(0, 500) })
+          }
+        }
+        return out
+      }
+
+      const request = (): void => {
+        const d = draftNow.trim()
+        if (!d) {
+          setReqDraft(''); setPhase('empty'); setOpen(true)
+          return
+        }
+        setReqDraft(d); setItems([]); setChecked([]); setErrMsg(''); setUsedModel('')
+        setPhase('loading'); setOpen(true)
+
+        const history = collectHistory()
+        fetch('/dsh-prompt-refine/suggest', {
+          method: 'POST',
+          headers: { 'Content-Type': 'application/json' },
+          body: JSON.stringify({ draft: d, history }),
+        })
+          .then(r => r.json())
+          .then((data: { ok?: boolean; suggestions?: Item[]; error?: string; usedModel?: string }) => {
+            const list = Array.isArray(data?.suggestions) ? data.suggestions.slice(0, 3) : []
+            if (data?.ok && list.length > 0) {
+              setItems(list)
+              // 默认勾选前两条(第 3 条留给用户判断)
+              setChecked(list.map((_, i) => i < 2))
+              setUsedModel(data.usedModel ?? '')
+              setErrMsg(data.error ?? '')
+              setPhase('result')
+            } else {
+              setErrMsg(data?.error ?? '未知错误')
+              setPhase('error')
+            }
+          })
+          .catch((e: unknown) => {
+            setErrMsg('网络错误: ' + (e instanceof Error ? e.message : String(e)))
+            setPhase('error')
+          })
+      }
+
+      // Esc 关闭
+      React.useEffect(() => {
+        if (!open) return
+        const onKey = (e: KeyboardEvent): void => { if (e.key === 'Escape') setOpen(false) }
+        window.addEventListener('keydown', onKey)
+        return () => { window.removeEventListener('keydown', onKey) }
+      }, [open])
+
+      const close = (): void => setOpen(false)
+      const apply = (): void => {
+        const patches: string[] = []
+        for (let i = 0; i < items.length; i++) {
+          if (checked[i] && items[i]?.patch) patches.push(items[i].patch)
+        }
+        const next = reqDraft + patches.join('')
+        if (inputActions?.setDraft) inputActions.setDraft(next)
+        setOpen(false)
+      }
+
+      const button = h('button', {
+        type: 'button',
+        title: '优化提示词',
+        'aria-label': '优化提示词',
+        style: S.btn as unknown as Record<string, string>,
+        onClick: (e: { stopPropagation: () => void; preventDefault: () => void }) => {
+          e.stopPropagation(); e.preventDefault(); request()
+        },
+        onMouseDown: (e: { preventDefault: () => void }) => e.preventDefault(),
+      }, '✨')
+
+      if (!open || !host) return button
+
+      // ---- 弹窗内容 ----
+      const selected: string[] = []
+      for (let i = 0; i < items.length; i++) if (checked[i] && items[i]?.patch) selected.push(items[i].patch)
+      const selectedCount = checked.filter(Boolean).length
+
+      let body: unknown
+      if (phase === 'empty') {
+        body = h('div', { style: S.err, children: '请先在输入框写点内容,再点 ✨ 优化。' })
+      } else if (phase === 'loading') {
+        body = h('div', { style: { padding: '18px 22px' }, children: [
+          h('div', { style: S.skel }), h('div', { style: S.skel }), h('div', { style: S.skel }),
+          h('div', { style: S.tip, children: '正在结合上下文分析…' }),
+        ] })
+      } else if (phase === 'error') {
+        body = h('div', { style: S.err, children: '⚠ ' + (errMsg || '出错了') })
+      } else {
+        // 建议行(抽成变量,避免深层嵌套写错括号)
+        const rows = items.map((s, i) => h('label', {
+          key: i,
+          style: { ...(S.row as object), ...(checked[i] ? (S.rowOn as object) : {}) } as Record<string, string>,
+          children: [
+            h('input', {
+              type: 'checkbox', checked: !!checked[i],
+              onChange: (e: { target: { checked: boolean } }) => {
+                setChecked(prev => { const n = [...prev]; n[i] = e.target.checked; return n })
+              },
+              style: { marginTop: '2px', width: '16px', height: '16px', accentColor: 'var(--dsw-alias-state-business-primary)', cursor: 'pointer' },
+            }),
+            h('div', { style: S.rowBody, children: [
+              h('span', { style: tagStyle(s.tag) as unknown as Record<string, string>, children: s.tag }),
+              h('p', { style: S.issue, children: s.issue }),
+              s.patch ? h('p', { style: S.patch, children: s.patch }) : null,
+            ] }),
+          ],
+        }))
+
+        // 预览行(原草稿 + 绿色高亮的补丁)
+        const previewChildren: unknown[] = [h('span', { key: 'draft', children: reqDraft })]
+        selected.forEach((p, i) => {
+          previewChildren.push(h('span', { key: 'p' + i, style: S.added as unknown as Record<string, string>, children: p }))
+        })
+
+        body = h(React.Fragment, null, [
+          h('div', { style: S.original, children: [
+            h('div', { style: S.originalLabel, children: '原文' }),
+            h('div', { children: reqDraft }),
+          ] }),
+          h('div', { style: S.list, children: rows }),
+          h('div', { style: S.preview, children: [
+            h('div', { style: S.previewLabel, children: [
+              h('span', { children: '采纳后预览' }),
+              h('span', { style: S.previewCount, children: `已选 ${selectedCount} / ${items.length}` }),
+            ] }),
+            h('div', { style: S.previewText, children: previewChildren }),
+          ] }),
+          errMsg ? h('div', { style: S.warn, children: '提示:' + errMsg }) : null,
+          h('div', { style: S.footer, children: [
+            h('span', { style: S.hint, children: (usedModel ? usedModel + ' · ' : '') + 'Esc 关闭' }),
+            h('div', { style: { display: 'flex', gap: '8px' }, children: [
+              h('button', { type: 'button', style: S.btnSec as unknown as Record<string, string>, onClick: close, children: '跳过' }),
+              h('button', { type: 'button', style: S.btnPri as unknown as Record<string, string>, onClick: apply,
+                children: selectedCount > 0 ? `采纳 ${selectedCount} 条并填入` : '填入原文' }),
+            ] }),
+          ] }),
+        ])
+      }
+
+      const overlay = h('div', {
+        style: S.overlay as unknown as Record<string, string>,
+        onClick: (e: { target: unknown; currentTarget: unknown }) => { if (e.target === e.currentTarget) close() },
+        children: h('div', {
+          style: S.modal as unknown as Record<string, string>,
+          onClick: (e: { stopPropagation: () => void }) => e.stopPropagation(),
+          children: [
+            h('div', { style: S.header, children: [
+              h('div', { style: S.title, children: '✨ 提示词优化建议' }),
+              h('p', { style: S.subtitle, children: phase === 'result' ? `发现 ${items.length} 处可以更精确` : '正在结合上下文生成建议' }),
+            ] }),
+            body,
+          ],
+        }),
+      })
+
+      return h(React.Fragment, null, [button, createPortal(overlay, host)])
+    }
+
+    function apply(ctx: unknown): void {
+      const c = ctx as {
+        slots: {
+          inject(slot: string, gen: () => unknown): void
+          register(opts: Record<string, unknown>, component: unknown): unknown
+        }
+      }
+      // 唯一注册点:发送按钮左侧的 list slot
+      c.slots.inject('conversation.input.right', () => c.slots.register(
+        { name: 'conversation.input.right', id: 'dsh-prompt-refine-button', order: 10 },
+        PromptRefineControl,
+      ))
+    }
+
+    return { name, inject, apply }
+  }
+}
+
+window.__ModuleLoader__.load({
+  id: 'dsh-prompt-refine',
+  factory: makeFactory(),
+})

package/src/dsh-prompt-refine.ts

@@ -0,0 +1,24 @@
+// dsh-prompt-refine.ts —— host 半入口
+//
+// 注册 HTTP 端点 → 让 client 半的弹窗能调过来 → 我们用 ctx.llm.stream()
+// 调用当前配置好的模型,返回 3 条优化建议。
+
+import type { Context } from '@deepseek-ai/cordis'
+import { registerHttpRoutes } from './host'
+
+export const name = 'dsh-prompt-refine'
+
+// 需要 webServer 注册 HTTP 端点
+// 需要 llm 服务在 handler 被调用时已经存在(用 lazy inject,声明在 apply 里)
+export const inject = ['webServer']
+
+export function apply(ctx: Context): void {
+  // 注册 HTTP 路由(注册时不需要 llm,handler 里才需要)
+  registerHttpRoutes(ctx)
+
+  // lazy inject llm:确保 llm 服务存在 + 监听它 ready
+  // 这样即使 webServer 先就绪、llm 后就绪也能工作
+  ctx.inject(['llm'], (llmCtx) => {
+    console.log('[dsh-prompt-refine] llm 服务已就绪,可以处理优化请求')
+  })
+}

package/src/host.ts

@@ -0,0 +1,239 @@
+// host.ts —— 暴露 HTTP 端点,client 调过来我们再调 ctx.llm.stream()
+//
+// 端点:
+//   POST /dsh-prompt-refine/suggest
+//     body: SuggestRequest (JSON)
+//     resp: SuggestResponse (JSON)
+//
+// 关键点:
+//   - LLM 调用用官方 ctx.llm.stream();消息必须用 createUserMessage 等
+//     工厂函数构造(Message.content 是 ContentBlock[] 不是 string)
+//   - 模型缺省时读用户 settings.yaml 的 agent-default-model(开箱即用)
+//   - 失败时降级到兜底建议,前端永远有东西可显示
+
+import { readFile } from 'node:fs/promises'
+import { homedir } from 'node:os'
+import { join } from 'node:path'
+import type { IncomingMessage, ServerResponse } from 'node:http'
+import type { Context } from '@deepseek-ai/cordis'
+import { createUserMessage, createAssistantMessage } from '@deepseek-ai/dsh-llm'
+import type { Message, StreamChunk } from '@deepseek-ai/dsh-llm'
+import type { SuggestRequest, SuggestResponse, Suggestion } from './shared/types'
+import { SYSTEM_PROMPT, buildUserMessage, parseSuggestions } from './shared/prompt'
+
+export const ROUTE_PREFIX = '/dsh-prompt-refine'
+
+/** ctx.llm 的最小可用子集 */
+interface LlmLike {
+  stream(options: {
+    provider: string
+    model: string
+    system?: string
+    messages: Message[]
+  }): AsyncIterable<StreamChunk>
+}
+
+/** 读请求体 */
+function readBody(req: IncomingMessage): Promise<string> {
+  return new Promise((resolve, reject) => {
+    const chunks: Buffer[] = []
+    req.on('data', c => chunks.push(c as Buffer))
+    req.on('end', () => resolve(Buffer.concat(chunks).toString('utf8')))
+    req.on('error', reject)
+  })
+}
+
+/** 写 JSON 响应 */
+function sendJson(res: ServerResponse, status: number, body: unknown): void {
+  res.writeHead(status, { 'Content-Type': 'application/json; charset=utf-8' })
+  res.end(JSON.stringify(body))
+}
+
+/** 拿到 llm 服务(懒注入:即使它晚于 webServer 就绪也能等到) */
+function resolveLlm(ctx: Context): Promise<LlmLike> {
+  return new Promise<LlmLike>((resolve, reject) => {
+    try {
+      ctx.inject(['llm'], (llmCtx) => {
+        const llm = (llmCtx as unknown as { llm?: LlmLike }).llm
+        if (!llm) {
+          reject(new Error('ctx.llm 不存在'))
+          return
+        }
+        resolve(llm)
+      })
+    } catch (err) {
+      reject(err)
+    }
+  })
+}
+
+/**
+ * 读用户 settings.yaml 里的 agent-default-model,拿到默认 provider/model。
+ * 用逐行扫描而不是 YAML 库:结构固定,避免引入依赖。
+ */
+async function resolveDefaultModel(): Promise<{ provider: string; model: string }> {
+  const fallback = { provider: 'deepseek-official', model: 'deepseek-v4-flash' }
+  try {
+    const home = process.env.DSH_HOME ?? join(homedir(), '.dsh')
+    const text = await readFile(join(home, 'settings.yaml'), 'utf8')
+    const lines = text.split(/\r?\n/)
+    // 找到 agent-default-model: 之后的缩进块
+    let i = lines.findIndex(l => /^agent-default-model\s*:/.test(l))
+    if (i < 0) return fallback
+    let provider = ''
+    let model = ''
+    for (i += 1; i < lines.length; i++) {
+      const line = lines[i]
+      // 遇到下一个顶层 key(非缩进、非空)就结束
+      if (/^\S/.test(line)) break
+      const pm = line.match(/^\s+provider\s*:\s*(\S+)/)
+      const mm = line.match(/^\s+model\s*:\s*(\S+)/)
+      if (pm) provider = pm[1]
+      if (mm) model = mm[1]
+    }
+    if (provider && model) return { provider, model }
+    return fallback
+  } catch {
+    return fallback
+  }
+}
+
+/**
+ * 调一次 LLM,拼出完整文本。
+ * Message 用官方工厂函数构造。
+ */
+async function callLlm(
+  ctx: Context,
+  req: { draft: string; history: readonly { role: 'user' | 'assistant'; content: string }[]; provider: string; model: string },
+): Promise<string> {
+  const llm = await resolveLlm(ctx)
+
+  // 历史消息 → 官方 Message 对象
+  const historyMessages: Message[] = req.history.map(m => m.role === 'user'
+    ? createUserMessage({
+      content: [{ type: 'text', text: m.content }],
+      source: { kind: 'user' },
+    })
+    : createAssistantMessage({
+      content: [{ type: 'text', text: m.content }],
+      source: { provider: req.provider, model: req.model },
+    }))
+
+  // 当前草稿作为最后一条 user 消息
+  const draftMessage = createUserMessage({
+    content: [{ type: 'text', text: buildUserMessage([], req.draft) }],
+    source: { kind: 'user' },
+  })
+
+  const stream = llm.stream({
+    provider: req.provider,
+    model: req.model,
+    system: SYSTEM_PROMPT,
+    messages: [...historyMessages, draftMessage],
+  })
+
+  let out = ''
+  let lastError = ''
+  for await (const chunk of stream) {
+    if (chunk.type === 'text-delta' && typeof chunk.text === 'string') {
+      out += chunk.text
+    } else if (chunk.type === 'finish') {
+      const reason = chunk.reason as { kind?: string; failure?: { message?: string } } | undefined
+      if (reason?.kind === 'error') lastError = reason.failure?.message ?? '未知模型错误'
+    }
+  }
+  if (!out && lastError) throw new Error(`模型调用失败: ${lastError}`)
+  return out
+}
+
+/** 兜底建议 —— LLM 挂掉或解析失败时给用户一个能用的结果 */
+function fallbackSuggestions(): Suggestion[] {
+  return [
+    { tag: 'clarity', issue: '请补充更多背景信息(语言、目标、约束)', patch: '请补充:编程语言 / 目标读者 / 期望长度' },
+    { tag: 'format', issue: '请指定输出格式(代码 / 表格 / 列表 / 段落)', patch: '请用 Markdown 格式返回' },
+    { tag: 'constraint', issue: '请说明边界条件或偏好', patch: '请不要使用外部依赖' },
+  ]
+}
+
+/** 注册 HTTP 路由 */
+export function registerHttpRoutes(ctx: Context): void {
+  const webServer = (ctx as unknown as {
+    webServer?: {
+      register(route: {
+        kind: string
+        path: string
+        handler: (req: IncomingMessage, res: ServerResponse) => Promise<void>
+      }): () => void
+    }
+  }).webServer
+  if (!webServer) {
+    console.log('[dsh-prompt-refine] webServer 服务不可用,HTTP 端点未注册')
+    return
+  }
+
+  webServer.register({
+    kind: 'prefix',
+    path: ROUTE_PREFIX,
+    handler: async (req, res) => {
+      const url = (req.url ?? '/').split('?')[0]
+      const method = req.method ?? 'GET'
+      const suggestPath = ROUTE_PREFIX + '/suggest'
+
+      if (url !== suggestPath || method !== 'POST') {
+        sendJson(res, 404, { ok: false, error: `not found: ${method} ${url}` })
+        return
+      }
+
+      try {
+        const body = await readBody(req)
+        const parsed = JSON.parse(body) as Partial<SuggestRequest>
+        const draft = typeof parsed.draft === 'string' ? parsed.draft.trim() : ''
+        const history = Array.isArray(parsed.history)
+          ? parsed.history.filter((m): m is { role: 'user' | 'assistant'; content: string } =>
+            !!m && typeof (m as { content?: unknown }).content === 'string'
+            && ((m as { role?: unknown }).role === 'user' || (m as { role?: unknown }).role === 'assistant'),
+          )
+          : []
+
+        if (!draft) {
+          sendJson(res, 400, { ok: false, error: 'draft 不能为空' } satisfies SuggestResponse)
+          return
+        }
+
+        // 模型:显式传入优先,否则读用户配置
+        const explicit = typeof parsed.provider === 'string' && typeof parsed.model === 'string'
+          && parsed.provider && parsed.model
+        const resolved = explicit
+          ? { provider: parsed.provider as string, model: parsed.model as string }
+          : await resolveDefaultModel()
+
+        console.log(`[dsh-prompt-refine] 建议请求: draft=${draft.length}字, history=${history.length}条, model=${resolved.provider}/${resolved.model}`)
+
+        try {
+          const rawOutput = await callLlm(ctx, { draft, history, ...resolved })
+          const suggestions = parseSuggestions(rawOutput)
+          sendJson(res, 200, {
+            ok: true,
+            suggestions,
+            usedModel: `${resolved.provider}/${resolved.model}`,
+          } satisfies SuggestResponse)
+        } catch (err) {
+          const msg = err instanceof Error ? err.message : String(err)
+          console.log(`[dsh-prompt-refine] LLM 调用或解析失败: ${msg}`)
+          sendJson(res, 200, {
+            ok: true,
+            suggestions: fallbackSuggestions(),
+            error: '模型调用失败,已用兜底建议: ' + msg,
+            usedModel: `${resolved.provider}/${resolved.model}`,
+          } satisfies SuggestResponse)
+        }
+      } catch (err) {
+        sendJson(res, 500, {
+          ok: false,
+          error: '服务器错误: ' + (err instanceof Error ? err.message : String(err)),
+        } satisfies SuggestResponse)
+      }
+    },
+  })
+  console.log('[dsh-prompt-refine] HTTP 端点已注册: POST ' + ROUTE_PREFIX + '/suggest')
+}