🐛 fix(vscode): 代码阅读把 Python 赋值后面的字符串当变量说明，其余单独的字符串显示成注释

vscode/src/codeReader/contract.ts

@@ -131,6 +131,11 @@ export interface DeclaratorFacts {
 export interface VariableFacts {
   /** 只有模块顶层（Python 还有类主体）的声明有。 */
   access?: Access
+  /**
+   * 变量自己的说明，同 FunctionFacts.doc：Python 是模块、类主体里紧跟在这条赋值后面的字符串（属性 docstring，字符串节点；
+   * 中间可以隔空行和赋值行尾的注释）。它算在块的头部里，不再单独成一块。
+   */
+  doc?: Node
   /** 一条语句声明几个变量（`let a = 1, b = 2`）就有几项。 */
   declarators: DeclaratorFacts[]
 }
@@ -155,7 +160,7 @@ export interface BlockShape {
   node: Node
   /**
    * 块自己显示 / 编辑的那一段：复合语句只到主体开始之前，其余是整条语句。
-   * 函数、类的说明（facts.doc）也算在里面：JSDoc 往上延到注释开头，docstring 往下延到字符串结尾。
+   * 块自己的说明（facts.doc、TextBlock.doc）也算在里面：JSDoc 往上延到注释开头，docstring、属性 docstring 往下延到字符串结尾。
    */
   header: SourceSpan
   children: CodeBlock[]
@@ -174,12 +179,19 @@ export interface VariableBlock extends BlockShape { kind: 'const' | 'variable',
 export type FactBlock = FunctionBlock | ClassBlock | ImportBlock | VariableBlock
 
 /** 带说明（facts.doc）的块。 */
-export type DocumentedBlock = FunctionBlock | ClassBlock
+export type DocumentedBlock = FunctionBlock | ClassBlock | VariableBlock
 
 export type TextKind = Exclude<BlockKind, FactBlock['kind']>
 
 /** 预览成一行译文的块。 */
-export interface TextBlock extends BlockShape { kind: TextKind }
+export interface TextBlock extends BlockShape {
+  kind: TextKind
+  /**
+   * 块自己的说明，同 VariableFacts.doc：Python 字段（类主体里带注解的赋值）后面紧跟的属性 docstring（字符串节点）。
+   * 算在块的头部里；预览在一行译文下面按 Markdown 显示（Translator.doc）。
+   */
+  doc?: Node
+}
 
 export type CodeBlock = TextBlock | FactBlock