✨ feat(vscode): 代码阅读的注释挂到它讲的代码块上成「注释」一行，重写注释改用技能一句话加结构化结果

- 普通注释不再单独成卡片：同一层挂到后面最近的块（隔空行也算），后面没有挂到前面那块，整层没代码挂到父块；只有文件开头隔着空行的注释、模块 docstring、//!、@file 单独成「文件开头的说明」
- 各语言（Python、TypeScript、Rust、Shell、Dockerfile）建好树后统一调 attachComments；块的编辑范围连着挂上的注释，差异、跳转、钉住卡片都按它
- 宿主统一给每张卡片（语言卡片、翻译插件的属性表、库规则卡片、一行译文的语句卡片）插「注释」一行，排在名称、说明后面
- TypeScript 的 JSDoc 也能当常量、变量的说明；sqlx、React 不再单独处理前面的注释
- 「重写注释」每块都有：提示只发 /ecc:writing-code-comments 路径:起-止，模型只读、按 --json-schema 交 body，没交结构化正文就失败不写；扩展换掉块前面的注释或在块上面新写一段

vscode/src/codeReader/contract.ts

@@ -9,6 +9,7 @@ export type { Node }
  * directive 往后给构建文件（Dockerfile）：directive 文件开头给构建工具看的解析指令（`# syntax=…`），stage 一个构建阶段（FROM 和它后面的指令），
  * run 构建时执行的命令，copy 往镜像里复制文件，setting 一条设置（工作目录、运行身份、端口……），label 镜像的标签，
  * health 健康检查，start 容器启动时执行的命令。
+ * comment 是讲整个文件的注释（文件开头的说明）；别的注释不单独成块，挂在它讲的块上（见 BlockShape.comments）。
  */
 export type BlockKind
   = | 'import' | 'function' | 'class' | 'enum' | 'exception' | 'type' | 'field' | 'const' | 'variable'
@@ -489,11 +490,17 @@ export interface BlockShape {
   /** 这一块对应的语法树节点（整条语句）。 */
   node: Node
   /**
-   * 块自己那一段（预览讲的就是它）：复合语句只到主体开始之前，其余是整条语句。编辑时宿主给的是整块：头部连同各子块、结尾。
+   * 块自己那一段（预览讲的就是它）：复合语句只到主体开始之前，其余是整条语句。编辑时宿主给的是整块：头部连同各子块、讲它的注释、结尾。
    * 块自己的说明（facts.doc、TextBlock.doc）也算在里面：JSDoc 往上延到注释开头，docstring、属性 docstring 往下延到字符串结尾。
    */
   header: SourceSpan
   children: CodeBlock[]
+  /**
+   * 讲这块的普通注释（不是说明），照源码顺序：同一层里它前面的注释（中间隔空行也算），这一层最后一块代码后面的注释，
+   * 子块一块代码都没有时子块里的注释。由 attachComments（languages/shared.ts）挂上；预览排成卡片上的「注释」一行，
+   * 块的编辑范围连同这几段注释。只有文件开头的说明单独成块（kind 'comment'）。
+   */
+  comments?: CommentBlock[]
   /**
    * 语言自己报的筛选属性，和宿主推出的通用属性（见 COMMON_ATTRIBUTES）合在一起：通用词表以外的属性（Rust 的 unsafe: 'true'），
    * 或 facts 表达不了的通用属性值（Kotlin 的 access: 'internal'，盖过从 facts 推出的）。kind 总是块的种类，这里填了不算。
@@ -562,6 +569,12 @@ export interface TextBlock extends BlockShape {
 
 export type CodeBlock = TextBlock | FactBlock
 
+/**
+ * 一段注释：相邻行同一写法的行注释合成的一段（node 是第一条，头部盖住全部），一条块注释，或 Python 当注释用的字符串。
+ * 文件开头的说明是单独的一块；别的挂在它讲的块上（BlockShape.comments）。
+ */
+export interface CommentBlock extends TextBlock { kind: 'comment' }
+
 /** 着色用的词性，源码着色和译文着色共用。 */
 export type TokenRole
   = | 'keyword' // 流程关键字：import from export if else for return try catch await …
@@ -707,6 +720,8 @@ export interface LanguageAdapter {
   toBlocks: (root: Node, source: string, languageId: string) => CodeBlock[]
   /** 给语法树叶子节点定词性：源码着色用它，译文里照抄的词也按它着色、按它认出能查定义的名字。 */
   tokenRole: (leaf: Node) => TokenRole
+  /** 行注释的记号（`#`、`//`）：「重写注释」给还没有注释的块新写一段时用它；不填就不能新写。 */
+  lineComment?: string
   /** node 是写在表达式里的遍历（推导式、生成器表达式）时给出它的结构，别的节点没有；没有这种写法的语言不填。 */
   iteration?: (node: Node) => IterationFacts | undefined
   /** node 是一次调用（含新建对象）时给出它的结构，别的节点没有；没给的语言不展开调用，照常一行译文。 */
@@ -792,7 +807,10 @@ export interface Translator {
   languageIds: string[]
   /** 译文用的语言（BCP 47 的语言部分，例如 'zh'）：库规则按它挑自己的词表。 */
   displayLanguage: string
-  /** 只翻 header 那一段；注释块给去掉注释符号的 Markdown 原文，跨几行写的调用连着摊开实参的表。 */
+  /**
+   * 只翻 header 那一段；注释块（文件开头的说明、挂在块上的注释 BlockShape.comments）给去掉注释符号的 Markdown 原文，
+   * 跨几行写的调用连着摊开实参的表。
+   */
   translate: (block: TextBlock, document: SourceDocument) => TextTranslation
   /** 函数、类、枚举、导入、常量、变量块 → 属性表。 */
   describe: (block: FactBlock, document: SourceDocument) => PropertyRow[]
@@ -929,12 +947,15 @@ export interface KindBadge { label: string, color: ThemeColor, icon: KindIconNam
 export type RuleBlock = RuleCard | RuleFacts | RuleOmit
 
 /**
- * 这块讲在了别的卡片里，不再单独成块：React 文件开头的 "use client" 讲成了组件卡片上的「客户端组件」标签，
- * 组件上面的 JSDoc 讲成了卡片的「说明」。预览不画它；它不能有子块（有子块时宿主当规则没认）。
+ * 这块讲在了别的卡片里，不再单独成块：React 文件开头的 "use client" 讲成了组件卡片上的「客户端组件」标签。
+ * 预览不画它；它不能有子块，也不能挂着注释（BlockShape.comments，注释没地方放），有时宿主当规则没认。
  */
 export interface RuleOmit { omit: true }
 
-/** 规则自己的卡片：一张属性表。种类（badge）决定筛选和边框色；卡片左边的图标是语言的概念再加这个种类、以及 concepts。用词归规则。 */
+/**
+ * 规则自己的卡片：一张属性表。种类（badge）决定筛选和边框色；卡片左边的图标是语言的概念再加这个种类、以及 concepts。用词归规则。
+ * 原块的「注释」一行（BlockShape.comments）由宿主插进 rows，规则不用管。
+ */
 export interface RuleCard {
   /** 种类 id，写成「规则 id.名字」（sqlalchemy.table）：筛选的 kind 属性值就是它，筛选记住的也是它，要稳定。 */
   kind: string
@@ -954,8 +975,8 @@ export interface RuleCard {
    */
   attributes?: BlockAttributes
   /**
-   * 并进这一块的子块（原块 children 里的对象本身）：不再单独成块，内容由 rows 讲。
-   * 没并进来的子块（方法、别的成员、规则不讲的注释）不管写在哪，都照源码顺序照常是这一块的子块，也照常交给各规则看。
+   * 并进这一块的子块（原块 children 里的对象本身）：不再单独成块，内容由 rows 讲（讲子块的注释在子块的 comments 里，跟着并进来）。
+   * 没并进来的子块（方法、别的成员）不管写在哪，都照源码顺序照常是这一块的子块，也照常交给各规则看。
    * 这一块的编辑范围同别的块，是原块整条语句（类就是整个类），盖住留下的子块：它编辑时预览不画这些子块，同一行不会同时在两处能改。
    */
   absorbs: CodeBlock[]