✨ feat(vscode): 代码阅读的调用与构造：跨多行写的调用排成「新建 / 调用 名字 · N 个参数」一行，实参摊成参数 / 值表；Python 查被调用名字的定义分新建和调用，查到后刷新

vscode/src/codeReader/editor/previewEditor.ts

@@ -1,7 +1,7 @@
 import type { CustomTextEditorProvider, Disposable, TextDocument, TextDocumentShowOptions, Uri, WebviewPanel } from 'vscode'
 import type { ClaudeImage } from '../../cc/spawnClaude'
 import type { BlockView } from '../blockView'
-import type { RuleLocation, RuleReference, WorkspaceIndex } from '../contract'
+import type { BlockKind, RuleLocation, RuleReference, WorkspaceIndex } from '../contract'
 import type { DefinitionStart, IndexedName, NameSources } from '../nameResolution'
 import type { CodeQa } from '../qa/codeQa'
 import type { CodeReaderRegistry } from '../registry'
@@ -14,13 +14,14 @@ import type { ExtensionToWebview, Reveal, WebviewToExtension } from './messages'
 import { commands, Range, window, workspace, WorkspaceEdit } from 'vscode'
 import { logger } from '../../logging/logger'
 import { webviewHtml, webviewUiRoot } from '../../webview/html'
+import { DocumentCallees } from '../calleeKinds'
 import { blockReplacement } from '../editText'
 import { locate } from '../folderStore'
 import { DocumentNames, resolveNames } from '../nameResolution'
 import { askPrompt, followUpPrompt } from '../qa/prompt'
 import { DocumentLookups } from '../ruleLookups'
 import { definitionAction } from './definitionAction'
-import { findDefinitions, languageDefinitions, pickDefinition, ruleDefinitions } from './definitions'
+import { definitionKind, findDefinitions, languageDefinitions, pickDefinition, ruleDefinitions } from './definitions'
 import { DefinitionSources } from './definitionSources'
 import { documentMessage } from './documentMessage'
 import { NavigationContext, OCCURRENCES_CONTEXT } from './occurrenceNavigation'
@@ -131,6 +132,8 @@ class Preview {
   private readonly names: DocumentNames
   /** 库规则问的名字的定义查到了什么：查到的变了就重发文档 */
   private readonly lookups: DocumentLookups
+  /** 调用的名字定义成哪种块（分新建还是调用）：查到的变了就重发文档 */
+  private readonly callees: DocumentCallees
 
   constructor(
     private readonly document: TextDocument,
@@ -154,6 +157,7 @@ class Preview {
         this.post({ type: 'displayNames', version, names })
     })
     this.lookups = new DocumentLookups(() => this.schedulePush())
+    this.callees = new DocumentCallees(() => this.schedulePush())
     this.disposables = [
       panel.webview.onDidReceiveMessage((msg: WebviewToExtension) => this.handleMessage(msg)),
       panel.onDidChangeViewState(() => {
@@ -223,9 +227,10 @@ class Preview {
     const { languageId, version } = this.document
     const source = this.document.getText()
     const session = this.lookups.session()
+    const callees = this.callees.session()
     const { message, displayNames } = await documentMessage({ languageId, version, getText: () => source }, this.registry, this.runtime, (text) => {
       logger.add({ level: 'warn', source: 'codeReader', message: `${this.document.uri.fsPath}：${text}` })
-    }, session.lookup)
+    }, session.lookup, callees.calleeKind)
     if (request !== this.latest || !this.ready)
       return
     this.definitions.remember(message.version, message.blocks)
@@ -237,9 +242,24 @@ class Preview {
     if (version === this.document.version) {
       this.names.resolve(version, report => resolveNames(displayNames, message.blocks, this.nameSources(), report))
       this.lookups.resolve(version, session.requests(), this.lookupSources())
+      this.callees.resolve(version, callees.requests(), offset => this.calleeKind(offset))
     }
   }
 
+  /** 这份文档里 offset 处名字的定义是哪种块：语言扩展查到的几处定义里第一处认得出的；语言扩展没答是 undefined。 */
+  private async calleeKind(offset: number): Promise<BlockKind | null | undefined> {
+    const { document } = this
+    const found = await languageDefinitions(document.uri, document.positionAt(offset))
+    if (found.length === 0)
+      return undefined
+    for (const location of found) {
+      const kind = await definitionKind(location, languageId => this.registry.languageFor(languageId), this.runtime)
+      if (kind)
+        return kind
+    }
+    return null
+  }
+
   /** 这份文档里 offset 处名字的定义（语言扩展查的）落在哪儿。 */
   private async definitionStarts(offset: number): Promise<DefinitionStart[]> {
     const { document } = this
@@ -284,6 +304,7 @@ class Preview {
     clearTimeout(this.timer)
     this.names.dispose()
     this.lookups.dispose()
+    this.callees.dispose()
     for (const disposable of this.disposables)
       disposable.dispose()
   }