text-note-batch

name	text-note-batch
description	TextNote 批次操作：在多個 DraftingView 中依文字內容搜尋 TextNote 並批次平移。適用於跨圖面統一調整法規文字、表格附註等重複出現的 TextNote 位置。觸發條件：使用者提到批次移動 TextNote、text note、跨視圖移動文字、批次文字調整、move text notes、batch text。工具：move_text_notes_in_views。

TextNote 批次操作

在多個 DraftingView 中依文字內容搜尋 TextNote 並批次平移。

Available Tools

工具	用途
move_text_notes_in_views	依文字子字串搜尋 TextNote，跨 DraftingView 批次平移

Workflow：批次移動 TextNote

Step 1：確認目標文字

從使用者的截圖或描述中辨識要移動的 TextNote 內容，擷取一段獨特的子字串作為 textMatch。

• 選擇足夠長的子字串以避免誤命中
• 例如：使用者選了「依內政部101年07月23日台內營字第1010806554號...」→ 用 "依內政部101年07月23日" 作為 textMatch

Step 2：dryRun 預覽

先用 dryRun: true 確認搜尋結果正確：

move_text_notes_in_views(
  textMatch: "目標文字子字串",
  deltaYMm: 5,
  dryRun: true
)

• 確認匹配的 view 數和 TextNote 數是否符合預期
• 若匹配過多，調整 textMatch 或加 viewNames 限縮範圍

Step 3：執行移動

確認無誤後，去掉 dryRun 執行：

move_text_notes_in_views(
  textMatch: "目標文字子字串",
  deltaYMm: 5
)

Step 4（選填）：限定特定 view

若只需要在部分 view 中操作：

move_text_notes_in_views(
  textMatch: "目標文字子字串",
  deltaYMm: 5,
  viewNames: ["面積比較表_A01", "面積比較表_A02"]
)

Parameters

move_text_notes_in_views

參數	說明	預設
textMatch	TextNote 文字內容子字串（不區分大小寫）	必填
deltaXMm	水平位移（mm），正=右、負=左	0
deltaYMm	垂直位移（mm），正=上、負=下	0
viewNames	限定搜尋的 DraftingView 名稱清單（選填）	全部 DraftingView
dryRun	true=僅搜尋不移動	false

Notes

• 搜尋範圍為所有 DraftingView（不含 template）
• 每個 view 開獨立 Transaction，可個別 Undo
• 子字串比對不區分大小寫
• 位移單位為 mm（內部自動轉換為 feet）
• 若 deltaXMm 和 deltaYMm 都為 0 且非 dryRun，會回報錯誤