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

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

vscode/src/codeReader/diff/blockDiff.test.ts

@@ -232,3 +232,17 @@ describe('diffBlockTrees', () => {
     expect(diff.removed[0].after).toBeUndefined()
   })
 })
+
+describe('改了挂在块上的注释', () => {
+  it('改的是讲这块的注释：这块算修改、自己改了，「注释」一行逐词标；一行译文的卡片标在它下面那几行（rows）上', async () => {
+    const before = await python('import os\n\n# 讲 load\ndef load(path):\n    # 先检查\n    return path\n')
+    const after = await python('import os\n\n# 讲 load，改过\ndef load(path):\n    # 先检查一下\n    return path\n')
+    const diff = diffBlockTrees(before, after)
+    const [, load] = after.blocks
+    const [returned] = load.children
+    expect(diff.stats).toEqual({ add: 0, mod: 1, del: 0 })
+    expect(diff.blocks[load.anchor]).toMatchObject({ change: 'mod', own: true, marks: { rows: { changed: { 1: { value: { markdown: expect.any(Array) } } } } } })
+    expect(diff.blocks[returned.anchor]).toMatchObject({ change: 'mod', own: true, marks: { rows: { changed: { 0: { value: { markdown: expect.any(Array) } } } } } })
+    expect(diff.blocks[returned.anchor].marks).not.toHaveProperty('translation')
+  })
+})

vscode/src/codeReader/diff/viewDiff.ts

@@ -54,7 +54,7 @@ export interface RowDiff {
   items?: ItemsDiff
 }
 
-/** 一块自己的内容（不算子块）改了哪些：属性表逐行，一行译文逐截，摊开实参的表逐行，说明逐词。 */
+/** 一块自己的内容（不算子块）改了哪些：属性表（一行译文的卡片是下面那几行 rows，「注释」一行）逐行，一行译文逐截，摊开实参的表逐行，说明逐词。 */
 export interface BlockMarks {
   rows?: RowsDiff
   translation?: TextDiff
@@ -114,6 +114,7 @@ export function removedView(view: BlockView): BlockView {
     translation: textWithoutSource(view.translation),
     ...(view.table && { table: tableWithoutSource(view.table) }),
     ...(view.doc && { doc: view.doc }),
+    ...(view.rows && { rows: view.rows.map(rowWithoutSource) }),
   }
 }
 
@@ -315,6 +316,7 @@ export function blockMarks(before: BlockView, after: BlockView): BlockMarks | un
   const translation = textDiff(before.translation, after.translation)
   const table = itemsDiff(before.table?.items, after.table?.items)
   const doc = textDiff(before.doc ?? { markdown: '' }, after.doc ?? { markdown: '' })
-  const marks: BlockMarks = { ...(translation && { translation }), ...(table && { table }), ...(doc && { doc }) }
+  const rows = rowsDiff(before.rows ?? [], after.rows ?? [])
+  const marks: BlockMarks = { ...(translation && { translation }), ...(table && { table }), ...(doc && { doc }), ...(rows && { rows }) }
   return Object.keys(marks).length > 0 ? marks : undefined
 }