✨ feat(vscode): 代码阅读加「问 AI」，块下面问 Claude Code，问答存进 .spx 挂在块下

vscode/src/codeReader/editor/messages.ts

@@ -4,6 +4,8 @@
 
 import type { FileAttribute } from '../attributes'
 import type { BlockView } from '../blockView'
+import type { AnchorStep } from '../qa/anchor'
+import type { RunningAsk } from '../qa/asks'
 import type { Excluded } from './blockFilter'
 
 export type { Excluded }
@@ -44,11 +46,40 @@ export interface DocumentMessage {
   reveal?: Reveal
 }
 
+/** 问过的一次（给预览看的）：问题、回答（Markdown）、什么时候问的（ISO 时间）。 */
+export interface QaEntryView {
+  id: string
+  question: string
+  answer: string
+  createdAt: string
+}
+
+/** 挂在一块上的问答。where 是记号拆回的各层（种类和名字），块找不到了时写它原来在哪。 */
+export interface QaThreadView {
+  anchor: string
+  where: AnchorStep[]
+  entries: QaEntryView[]
+}
+
+/**
+ * 这份文件的问答：available 为假时文件不在工作区文件夹里、问答没地方存，不给「问 AI」；
+ * running 是正在答的问题（页面重新加载后靠它接上）。
+ */
+export interface QaMessage {
+  type: 'qa'
+  available: boolean
+  threads: QaThreadView[]
+  running: RunningAsk[]
+}
+
 /**
  * reveal：已经开着的预览滚到某处（同 DocumentMessage.reveal）
  * definitionProbed：id 那次 probeDefinition 的回答，found 表示 VS Code 查得到定义
  * occurrencesFound：id 那次 findOccurrences 的回答，语言扩展没答（或没装）就是空的
  * filter：整个工作区共用的块筛选；ready 后先于第一份文档发一次，之后任何一个预览改了都发给所有预览
+ * qa：这份文件的问答；ready 后发一次，问答、正在答的问题变了再发
+ * answer：askId 那个问题的回答长了（text 是到现在为止的全文）、或换了在做的事
+ * answerEnd：askId 那个问题答完了：done 带最终的回答、存下的那条的 id 和会话 id（追问接着这个会话），failed 带给人看的原因，stopped 是被叫停
  */
 export type ExtensionToWebview
   = | DocumentMessage
@@ -56,6 +87,9 @@ export type ExtensionToWebview
     | { type: 'definitionProbed', id: number, found: boolean }
     | { type: 'occurrencesFound', id: number, occurrences: Occurrence[] }
     | { type: 'filter', excluded: Excluded }
+    | QaMessage
+    | { type: 'answer', askId: string, text: string, activity?: string }
+    | { type: 'answerEnd', askId: string, status: 'done' | 'failed' | 'stopped', text?: string, error?: string, entryId?: string, sessionId?: string }
 
 /**
  * edit：把 startLine..endLine 这几行整行替换成 text（扩展端给每行补回原来的缩进）
@@ -65,6 +99,9 @@ export type ExtensionToWebview
  * goToDefinition：⌘ / Ctrl + 点击，跳到 offset 处名字的定义
  * findOccurrences：单击带下标的名字，问它在这份文档里出现在哪几处；id、version 同 probeDefinition
  * setFilter：改块筛选（整份替换），扩展端记下后发 filter 给所有预览
+ * ask：问 anchor 那块代码；askId 由 webview 起，回答的消息带回去；resume 是追问时上一次的会话 id
+ * stopAsk：叫停 askId 那个问题，这次不存
+ * deleteQa：删掉 anchor 那块下面的一次问答（已经理解了）
  */
 export type WebviewToExtension
   = | { type: 'ready' }
@@ -75,3 +112,6 @@ export type WebviewToExtension
     | { type: 'probeDefinition', id: number, version: number, offset: number }
     | { type: 'goToDefinition', version: number, offset: number }
     | { type: 'findOccurrences', id: number, version: number, offset: number }
+    | { type: 'ask', askId: string, anchor: string, question: string, resume?: string }
+    | { type: 'stopAsk', askId: string }
+    | { type: 'deleteQa', anchor: string, entryId: string }