dsh-vscode-mode 0.20.2 → 0.20.3

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "dsh-vscode-mode",
-  "version": "0.20.2",
+  "version": "0.20.3",
   "description": "DSH 上的类 VSCode 编码体验：Monaco 编辑器（文件页签/QuickOpen/状态栏，可驻 DSH 0.1.5+ 官方右侧 Sidebar 与对话同屏）+ 命令栏（Ctrl+Shift+P）与可扩展指令系统 + VS Code 兼容代码片段（.code-snippets 全局/项目，IntelliSense 展开）+ Agent 编辑差异审查（整文件差异/采纳/拒绝/归档/回滚）+ SVN 集成（侧栏变更面板/日志弹窗/并排差异）+ 语言服务器（LSP）智能（跳转定义/引用/hover/大纲 + VSIX 扩展市场安装），状态持久化到工作区旁车，界面状态（页签/光标/侧栏/编辑 Tab/导航历史）镜像到 DSH home 跨重启恢复",
   "icon": "assets/icon.svg",
   "keywords": [

package/src/client/reviewBar.ts

@@ -0,0 +1,85 @@
+/**
+ * 官方差异栏派生视图：位置、导航提示、失效说明与 Keep 提示的唯一来源。
+ * 计数口径分离：待审是「记录数」，可跳转是「块数」，两者不同源，
+ * 全部块失效时必须给出可操作叙事，不能只留一句「无法定位」。
+ * 作者 ddj 2026年10月27号
+ */
+
+/** 官方差异栏输入：全部来自 EditorView dock 快照，不读取磁盘或 RPC。 */
+export interface ReviewBarInput {
+  /** 可定位（非 stale）的差异块数 */
+  jumps: number
+  /** 无法定位的历史差异块数 */
+  stale: number
+  /** 当前差异块索引（0 基） */
+  index: number
+  /** 编辑器内容是否已就绪；未就绪时不得断言差异失效 */
+  ready: boolean
+  /** 当前文件的官方待审记录数 */
+  pendingRecords: number
+  /** 当前记录是否可 Keep（detail.capability.keep） */
+  canKeep: boolean
+}
+
+/** 官方差异栏派生文案；调用方只负责渲染，不再自行拼装计数与提示。 */
+export interface ReviewBarView {
+  /** 差异位置文案，如 `2 / 6`、`无可跳转`、`载入中` */
+  position: string
+  /** 上一个差异按钮提示（兼作禁用原因） */
+  navPrevTitle: string
+  /** 下一个差异按钮提示（兼作禁用原因） */
+  navNextTitle: string
+  /** 失效说明，空串表示不显示 */
+  notice: string
+  /** 说明级别：warn 表示需要用户决策 */
+  noticeTone: 'info' | 'warn'
+  /** Keep 按钮提示 */
+  keepHint: string
+  /** 待审计数提示 */
+  pendingTitle: string
+}
+
+/** @private @author ddj 2026年10月27号 @param value 任意计数输入 @returns 非负整数，NaN/负数/非数字归零 */
+function safeCount(value: unknown): number {
+  const parsed = Number(value)
+  return Number.isFinite(parsed) && parsed > 0 ? Math.floor(parsed) : 0
+}
+
+/** @private @author ddj 2026年10月27号 @returns 无差异可跳转时的 Keep 提示 */
+function fullStaleKeepHint(): string {
+  return '保留该记录的全部改动并结案：这些改动已不在文件中，记录将被标记为已采纳（不改写磁盘）'
+}
+
+/**
+ * 派生差异栏文案。
+ * @public
+ * @author ddj 2026年10月27号
+ * @param input 差异计数、就绪状态与 Keep 能力
+ * @returns 栏内位置、导航提示与失效说明
+ */
+export function reviewBarView(input: ReviewBarInput): ReviewBarView {
+  const jumps = safeCount(input.jumps)
+  const stale = safeCount(input.stale)
+  const index = safeCount(input.index)
+  const pendingTitle = `${safeCount(input.pendingRecords)} 条官方待审记录` + (input.ready ? `，本文件可跳转 ${jumps} 处` : '')
+  const keepHint = jumps === 0 && stale > 0 && input.canKeep ? fullStaleKeepHint() : '保留当前记录的未处理修改'
+
+  // 载入期所有块天然 stale，此时只能报告进度，不能断言改动已失效。
+  if (input.ready !== true) {
+    return { position: '载入中', navPrevTitle: '文件载入中', navNextTitle: '文件载入中', notice: '', noticeTone: 'info', keepHint, pendingTitle }
+  }
+
+  if (jumps > 0) {
+    const at = Math.min(index + 1, jumps)
+    const notice = stale > 0 ? `${stale} 处历史差异无法定位（其余 ${jumps} 处可跳转），展开详情查看原始增删。` : ''
+    return { position: `${at} / ${jumps}`, navPrevTitle: '上一个差异', navNextTitle: '下一个差异', notice, noticeTone: 'info', keepHint, pendingTitle }
+  }
+
+  if (stale > 0) {
+    const reason = '该记录的改动已不在当前文件中，无可跳转差异'
+    const notice = `本记录 ${stale} 处改动均已不在当前文件中（被后续编辑覆盖或已撤销）；可点 Keep 结案（只标记已采纳，不改写磁盘），或展开详情核对原始增删。`
+    return { position: '无可跳转', navPrevTitle: reason, navNextTitle: reason, notice, noticeTone: 'warn', keepHint, pendingTitle }
+  }
+
+  return { position: '—', navPrevTitle: '当前文件没有可定位差异', navNextTitle: '当前文件没有可定位差异', notice: '', noticeTone: 'info', keepHint, pendingTitle }
+}

package/src/client/sessionError.ts

@@ -36,3 +36,15 @@ export function sessionMissingDetail(): string {
   return '该会话可能正被其他 DSH 实例（桌面端 / Web 端）占用，或尚未在当前实例激活。' +
     '请在持有该会话的一端查看，或在本端打开该会话后重试。'
 }
+
+/**
+ * 把任意错误文本归一为可展示文案：会话缺失类替换为终态提示，其余原样返回。
+ * 差异栏等狭窄区域共用，避免裸「会话不存在」与业务提示混排。
+ * @author ddj 2026年10月27号
+ * @param text 任意错误文本（host 业务 error、异常 message 等原始形态）
+ * @returns 会话缺失为「标题：详情」，其他错误为原文本，空值返回空串
+ */
+export function sessionErrorText(text: unknown): string {
+  if (isSessionMissingError(text)) return sessionMissingTitle() + '：' + sessionMissingDetail()
+  return String(text ?? '')
+}

package/src/client/styles/editor.css

@@ -304,6 +304,7 @@
 [data-edrv-diff-dock-shell] .edrv-reviewbar button:focus-visible { outline: 2px solid var(--dsw-alias-brand-primary, #3b63d9); outline-offset: 2px; }
 [data-edrv-diff-dock-shell] .edrv-review-notice { padding: 7px 12px; border-top: 1px solid var(--dsw-alias-border-l1, #e5e9ef); color: var(--dsw-alias-label-secondary, #697586); font-size: 11px; overflow-wrap: anywhere; }
 [data-edrv-diff-dock-shell] .edrv-review-error { color: var(--dsw-alias-state-error-primary, #b64043); }
+[data-edrv-diff-dock-shell] .edrv-review-notice-warn { color: var(--dsw-alias-state-warning-primary, #a86a1f); }
 [data-edrv-diff-dock-shell] .edrv-review-body { border-top: 1px solid var(--dsw-alias-border-l1, #e5e9ef); max-height: min(240px, 30vh); overflow: auto; padding: 8px 12px; }
 @container edrv-review (max-width: 420px) {
   .edrv-reviewbar .edrv-review-heading { gap: 6px; padding-inline: 10px; }

package/src/client/ui/EditorView.ts

@@ -127,7 +127,10 @@ import { buildBpMenu } from '../dap/bpMenu.js'
 import { clampToolbarPosition, loadToolbarPosition, saveToolbarPosition } from '../dap/toolbarDrag.js'
 import { editorModelPathOf } from '../dap/modelPath.js'
 import { dapTrace } from '../dap/trace.js'
-import { isSessionMissingError, sessionMissingDetail, sessionMissingTitle } from '../sessionError.js'
+import { isSessionMissingError, sessionErrorText, sessionMissingDetail, sessionMissingTitle } from '../sessionError.js'
+
+/** 官方差异读取失败前缀：仅用于清理同源陈旧错误，不吞并保存类错误。@author ddj 2026年10月27号 */
+const REVIEW_LOAD_ERROR = '官方差异读取失败：'
 
 /**
  * 只在 Lua 注解类型槽开启注释自动建议；跨文件/离开类型槽立即恢复默认。
@@ -588,7 +591,9 @@ export function EditorView(props) {
         if (!result.ok) throw new Error(result.error)
         setOfficialRecords((previous) => JSON.stringify(previous) === JSON.stringify(page.page.items) ? previous : page.page.items)
         setOfficialDetail((previous) => JSON.stringify(previous) === JSON.stringify(result.detail) ? previous : result.detail)
-      } catch (cause) { if (!controller.signal.aborted) setError('官方差异读取失败：' + String(cause)) }
+        // 读取成功后清除同源陈旧错误，避免会话恢复后仍挂着上一次失败提示。
+        setError((previous) => (typeof previous === 'string' && previous.startsWith(REVIEW_LOAD_ERROR) ? null : previous))
+      } catch (cause) { if (!controller.signal.aborted) setError(REVIEW_LOAD_ERROR + String(cause)) }
     }
     void loadReview()
     return () => controller.abort()
@@ -4482,12 +4487,13 @@ export function EditorView(props) {
    * @returns 含布局及操作回调的差异快照
    */
   const officialFile = review.page?.overview?.coveredPaths.find((path) => sameFile(path, active))
+  const rawReviewError = review.error || error
   const buildDockSnapshot = () => ({
     mode: editorDockMode(active),
     official: officialFile ? { sessionId, page: review.page, path: officialFile,
       pending: sum.files.find((file) => sameFile(file.path, active))?.pending ?? 0,
       detail: officialDetail, records: officialRecords, onSelect: setSelectedReview } : null,
-    reviewError: review.error || error,
+    reviewError: rawReviewError ? sessionErrorText(rawReviewError) : undefined,
     layout,
     pendingRegions,
     staleRegions,
@@ -4507,6 +4513,7 @@ export function EditorView(props) {
     onRefresh: reloadFile,
     activePath: active,
     diffIdx: contentReady ? diffIdx : 0,
+    contentReady,
     diffTotal: displayDiffTotal(contentReady, pendingRegions.length, sum.files.find((file) => sameFile(file.path, active))?.pending ?? 0),
     fileIdx,
     fileTotal: sum.pendingFiles.length,

package/src/client/ui/OfficialDiffBar.tsx

@@ -2,6 +2,7 @@ import React from 'react'
 import { Button, Menu } from '@deepseek-ai/dsh-client-ui-primitives'
 import type { ReviewDetail, ReviewItem, ReviewPage } from '../../shared/review.js'
 import { ReviewLedger } from './OfficialReview.js'
+import { reviewBarView } from '../reviewBar.js'
 
 export interface OfficialBarProps {
   official: { sessionId: string; path: string; pending: number; detail?: ReviewDetail; records?: ReviewItem[]; page: ReviewPage; onSelect: (id: string) => void }
@@ -9,6 +10,8 @@ export interface OfficialBarProps {
   pendingRegions?: unknown[]
   staleRegions?: unknown[]
   diffIdx?: number
+  /** 编辑器内容是否就绪；未就绪时不得断言差异失效 */
+  contentReady?: boolean
   fileTotal?: number
   fileIdx?: number
   allPendingCount?: number
@@ -61,7 +64,8 @@ export function OfficialDiffBar(props: OfficialBarProps): React.ReactElement {
   const detail = official.detail
   const records = official.records ?? []
   const count = pendingRegions.length
-  const position = count ? `${Math.min(diffIdx + 1, count)} / ${count}` : '—'
+  const view = reviewBarView({ jumps: count, stale: staleRegions.length, index: diffIdx, ready: props.contentReady === true,
+    pendingRecords: official.pending, canKeep: detail?.capability.keep === true })
 
   /** @private @author ddj 2026年10月27号 @returns Close current popup without changing selection. */
   function closeMenu(): void { setMenu(null) }
@@ -69,9 +73,9 @@ export function OfficialDiffBar(props: OfficialBarProps): React.ReactElement {
   function selectRecord(id: string): void { official.onSelect(id); closeMenu() }
   /** @private @author ddj 2026年10月27号 @param tab Existing launcher tab. @returns Open existing overview, never create another review entry. */
   function openOverview(tab: string): void { props.onOpenLauncher(tab); closeMenu() }
-  /** @private @author ddj 2026年10月27号 @param mark Navigation icon. @param label Accessible action. @param action Existing callback. @param disabled Whether navigation is unavailable. @returns Compact keyboard-focusable navigation control. */
-  function navButton(mark: Mark, label: string, action: () => void, disabled: boolean): React.ReactElement {
-    return <Button size="sm" variant="ghost" className="edrv-review-icon" aria-label={label} title={label} disabled={disabled} onClick={action}>{barIcon(mark)}</Button>
+  /** @private @author ddj 2026年10月27号 @param mark Navigation icon. @param label Accessible action. @param action Existing callback. @param disabled Whether navigation is unavailable. @param title Hover reason, defaults to the label. @returns Compact keyboard-focusable navigation control. */
+  function navButton(mark: Mark, label: string, action: () => void, disabled: boolean, title?: string): React.ReactElement {
+    return <Button size="sm" variant="ghost" className="edrv-review-icon" aria-label={label} title={title || label} disabled={disabled} onClick={action}>{barIcon(mark)}</Button>
   }
 
   const recordTrigger = <Button size="sm" variant="ghost" className="edrv-review-record" aria-label="选择官方差异记录" aria-haspopup="menu" aria-expanded={menu === 'records'} disabled={!records.length} onClick={() => setMenu(menu === 'records' ? null : 'records')}>
@@ -85,7 +89,7 @@ export function OfficialDiffBar(props: OfficialBarProps): React.ReactElement {
     <div className="edrv-review-heading">
       <span className="edrv-review-filemark">{barIcon('file')}</span>
       <span className="edrv-review-filename" title={props.activePath}>{name}</span>
-      <span className="edrv-review-pending" title={`${official.pending} 条官方待审记录`}>待审 <strong>{official.pending}</strong></span>
+      <span className="edrv-review-pending" title={view.pendingTitle}>待审 <strong>{official.pending}</strong></span>
       <Menu open={menu === 'records'} anchor={recordTrigger} items={records.map((item) => ({ id: item.id, label: `轮次 ${item.turn} / 事件 ${item.seq}` }))} selectedId={detail?.item.id} onSelect={selectRecord} onClose={closeMenu} side="top" align="end" portal compact autoFocus />
     </div>
     <div className="edrv-review-tools">
@@ -94,18 +98,18 @@ export function OfficialDiffBar(props: OfficialBarProps): React.ReactElement {
         {navButton('right', '下一个差异文件', props.onNextFile, !props.fileTotal)}
       </div>
       <div className="edrv-review-nav edrv-review-blocknav" role="group" aria-label="差异导航">
-        {navButton('up', '上一个差异', props.onPrevDiff, !count)}
-        <span className="edrv-review-position" aria-live="polite">{position}</span>
-        {navButton('down', '下一个差异', props.onNextDiff, !count)}
+        {navButton('up', '上一个差异', props.onPrevDiff, !count, view.navPrevTitle)}
+        <span className="edrv-review-position" aria-live="polite">{view.position}</span>
+        {navButton('down', '下一个差异', props.onNextDiff, !count, view.navNextTitle)}
       </div>
       <div className="edrv-review-actions">
         <Button size="sm" variant="ghost" className="edrv-review-undo" icon={barIcon('undo')} onClick={props.onUndoFile} disabled={props.reviewBatchBusy || !detail?.capability.undo} title={detail?.capability.reason}>Undo</Button>
-        <Button size="sm" variant="primary" className="edrv-review-keep" icon={barIcon('check')} onClick={props.onAcceptFile} disabled={props.reviewBatchBusy || !detail?.capability.keep} title="保留当前记录的未处理修改">Keep</Button>
+        <Button size="sm" variant="primary" className="edrv-review-keep" icon={barIcon('check')} onClick={props.onAcceptFile} disabled={props.reviewBatchBusy || !detail?.capability.keep} title={detail?.capability.keep ? view.keepHint : detail?.capability.reason}>Keep</Button>
         <Button size="sm" variant="ghost" className="edrv-review-details" onClick={() => setExpanded(!expanded)} aria-expanded={expanded} aria-label={expanded ? '收起差异' : '展开差异'} title={expanded ? '收起差异' : '展开差异'}>详情{barIcon(expanded ? 'up' : 'down')}</Button>
         <Menu open={menu === 'more'} anchor={moreTrigger} items={[{ id: 'pending', label: '差异总览' }, { id: 'archive', label: '归档 / 历史' }]} onSelect={openOverview} onClose={closeMenu} side="top" align="end" portal compact autoFocus />
       </div>
     </div>
-    {detail && staleRegions.length > 0 ? <div className="edrv-review-notice" role="status">{staleRegions.length} 处历史差异无法定位，展开详情查看原始增删。</div> : null}
+    {detail && view.notice ? <div className={view.noticeTone === 'warn' ? 'edrv-review-notice edrv-review-notice-warn' : 'edrv-review-notice'} role="status">{view.notice}</div> : null}
     {props.reviewError ? <div className="edrv-review-notice edrv-review-error" role="alert">{props.reviewError}</div> : null}
     {expanded ? <div className="edrv-review-body"><ReviewLedger key={`${official.sessionId}:${official.path}`} sessionId={official.sessionId} first={official.page} path={official.path} /></div> : null}
   </div>