gog docs sed 实战指南在终端用 sed 语法批量查找替换与格式化 Google Docs【免费下载链接】gogcliGoogle Workspace in your terminal.项目地址: https://gitcode.com/GitHub_Trending/gogcl/gogcli本文围绕gog docs sed命令展开讲解 gogcliGoogle Workspace in your terminal如何把 Unix sed 的表达式模型s/pattern/replacement/g应用到 Google Docs 文档上实现正则查找替换、富文本格式化、表格操作、图片替换、段落寻址与批量流水线处理。读完本文你将掌握单条与批量 sed 表达式的完整语法、Sedmat 花括号格式化 DSL、常用安全选项与输出格式并能结合源码理解其执行原理与适用边界。命令总览面向 Google Docs 的 sed 引擎gog docs sed是 gogcli 提供的一类以文本为中心的文档编辑命令其定位在命令参考中一句话即可概括Regex find/replace (sed-style: s/pattern/replacement/g)。它允许你在终端里用类似 Unix sed 的表达式直接修改 Google Docs 文档且不局限于纯文本替换——通过 Sedmat DSL 还可以在替换文本的同时附加粗体、斜体、颜色、字号、超链接、标题样式等富文本格式甚至创建表格、合并单元格、替换图片。基本用法引自 命令参考gog docs (doc) sed docId [expression] [flags]其中docId是必填位置参数文档 IDexpression是可选的位置参数sed 表达式其余表达式可通过-e/-f/stdin 提供。该命令挂在gog docs之下父命令见 gog docs完整命令索引见 Command index。表达式从哪来位置参数、-e、-f 与 stdin从 入口实现 的collectExpressions方法可以看到表达式按以下优先级收集位置参数gog docs sed docId s/foo/bar/-e, --expressions可重复的标志每个值是一条表达式gog docs sed docId -e s/a/b/ -e s/c/d/g-f, --file file从一个文件读取表达式每行一条表达式#开头的行为注释空行会被忽略见parseExpressionLinesstdin当以上来源都没有提供表达式、且 stdin 不是终端即通过管道或 heredoc 输入时自动从 stdin 读取同样按每行一条、#注释解析如果四种来源都为空命令会直接返回 usage 错误no sed expressions provided。配合管道与 heredoc 的典型用法echo s/foo/{b}bar/ | gog docs sed DOC_ID gog docs sed DOC_ID EOF s/title/{ht}My Report/ s/draft/{b cgreen}final/ EOF多条表达式提交时命令会进入批量模式runBatch见 docs_sed.go能够走原生 API 的纯文本替换会被合并进同一次BatchUpdateDocument调用其余类型表格、图片、段落寻址、位置插入等按类别依次执行最后统一输出统计。五大 sed 命令s / d / a / i / y表达式解析层定义在 internal/docssed/parser.goCommand类型支持五种操作见CommandSubstitute/CommandDelete/CommandAppend/CommandInsert/CommandTransliterate。s替换substitutions/pattern/replacement/ # 只替换第一个匹配 s/pattern/replacement/g # 全局替换所有匹配 s/pattern/replacement/i # 忽略大小写 s/pattern/replacement/2 # 只替换第 N 个匹配N 次命中 s/pattern/replacement/m # 多行模式^/$ 匹配行边界 s/pattern/replacement/gi # 组合标志标志位g全局、i忽略大小写、m多行、数字N仅第 N 次命中可以组合第 N 次命中的语义由NthMatch字段承载在 parser.go 的Expression结构体中可看到NthMatch int。值得注意的实现细节命令在判定能否走原生替换时要求global为真且nthMatch 0见 docs_sed.go即单次命中第 N 次替换必须走手动路径因为 Google Docs API 的ReplaceAllText无法表达只替换第 N 个匹配。d删除匹配行d/pattern/d删除所有包含该 pattern 的行段落。实现上由ParagraphPlanner.PlanDelete生成删除计划再逆序构造DeleteContentRange请求见 docs_sed_commands.go。a 与 i在匹配行后追加 / 前插入a/pattern/new text/ # 在匹配行后追加 i/pattern/new text/ # 在匹配行前插入两者共用runInsertAroundMatch通过before布尔值区分前后由ParagraphPlanner.PlanInsert生成DeleteContentRange InsertText请求序列。y字符转写transliteratey/abc/xyz/ # a→x, b→y, c→zy将源字符集中的每个字符按位置替换为目标字符。实现上逐字符生成ReplaceAllText精确匹配、大小写敏感请求并合并到一次批量更新中见 docs_sed_commands.go。反向引用$1 与 替换文本支持正则捕获组反向引用\1~\9会被转换为 Go 正则的${1}~${9}同时支持表示整个匹配s/(important)/{b}$1/ # 捕获 加粗 s/([A-Z]{2,})/{b}$1/g # 加粗所有全大写单词 s/([^])/{i}$1/g # 给引号内文本加斜体 s/hello/{b}/ # 整个匹配位置插入^ $ ^$面向整篇文档的特殊 pattern 提供三种语义s/^$/Initial content/ # 仅当文档为空时写入初始内容 s/^/Prepended text\n/ # 在文档开头插入prepend s/$/\nAppended text/ # 在文档末尾插入append其特殊行为在runPositionalInsert中有详细处理s/^$//作用于非空文档时等价于清空全部内容会构造DeleteContentRange删除 body 全部区间空文档且 replacement 非空则在索引 1 处插入。^在开头插入、$在末尾最后一个换行前插入。由于这类表达式会改变文档状态在批量模式中被单独归类为exprCatPositional串行执行见 docs_sed.go。Sedmat用花括号 DSL 附加富文本格式纯文本替换只是第一步。gog docs sed集成了SedmatSed-like Document Formatting——一套面向 Google Docs 的 sed 风格格式化 DSL用花括号{keyvalue}作为规范语法同时保留 Markdown 简写。替换文本中带花括号前缀时命令不会走原生替换而是进入手动格式化路径最终由 helpers 中的buildTextStyleRequests/buildParagraphStyleRequests翻译为UpdateTextStyle、UpdateParagraphStyle、CreateParagraphBullets等 Docs API 请求。布尔格式标志键长名效果bbold粗体iitalic斜体_underline下划线-strike删除线#code等宽字体Courier New 灰色背景^sup上标,sub下标wsmallcaps小型大写字母用!取反可移除格式{!b}去粗体、{!i}去斜体。花括号默认放在文本前放在文本后效果相同也可前后同时使用s/text/{b}hello/ # 花括号在前默认 s/text/hello{b}/ # 花括号在后——结果相同 s/text/{cred}warning{b}/ # 前 后 s/hello/{b}hello/ # 粗体 s/world/{i _}world/ # 斜体 下划线 s/note/{b i}note/ # 粗体 斜体 s/draft/{-}draft/ # 删除线 s/code/{#}code/ # 等宽 s/TM/{^}TM/ # 上标 s/H2O/H2O — {,}2/ # 下标 s/Title/{w}Title/ # 小型大写 s/loud/{!b}loud/ # 移除粗体代码样式在实现中映射为WeightedFontFamily{Courier New} 0.95 灰度的BackgroundColor见 docs_sed_helpers.go 的codeBackgroundGrey常量。键值属性keyvalue键长名值效果ccolorhex/颜色名文字颜色zbghex/颜色名背景高亮ffont字体名字体族ssizept字号uurlURL超链接hheading1-6/t/s标题级别t标题、s副标题aalignleft/center/right段落对齐lleadingpt行距nindentpt缩进oopacity0-100文字透明度kkerningpt字距pspacingbefore,after段落间距pteeffectname文字效果xwidthpx图片宽度yheightpx图片高度示例注意 URL 中的/需要转义为\/因为它是 sed 表达式分隔符s/error/{cred}error/ # 红色文字 s/warning/{z#FFFF00}warning/ # 黄色高亮 s/title/{fGeorgia s24}title/ # Georgia 24pt s/heading/{h2}heading/ # Heading 2 s/TITLE/{ht}TITLE/ # 文档标题样式 s/click here/{uhttps:\/\/example.com}click here/ # 超链接 s/para/{acenter}para/ # 居中 s/note/{p12,6}note/ # 段前 12pt、段后 6pt s/fine/{o50}fine/ # 50% 透明度组合用法s/heading/{b fMontserrat s18}heading/ s/title/{h3 fPlayfairDisplay s22 c#333333}title/ s/link/{b i uhttps:\/\/example.com}link/颜色支持#RRGGBB与#RGB简写实现中由parseHexColor统一展开为 0.0~1.0 的 RGB 浮点并映射到ForegroundColor/BackgroundColor见 docs_sed_helpers.goheading会映射为HEADING_1~HEADING_6的NamedStyleType。清除全部格式s/messy/{0}messy/ # 剥离所有格式书签与内部链接s/Chapter 1/{ch1}Chapter 1/ # 创建书签锚点 s/see chapter 1/{u#ch1}see chapter 1/ # 链接到书签实现上link:前缀的链接若以#开头会被解析为BookmarkId否则解析为普通Url见 docs_sed_helpers.go。结构命令分页符 / 表格 / 复选框 / 图片s/PAGEBREAK/{p}PAGEBREAK/ # 分页符 s/COLBREAK/{c}COLBREAK/ # 分栏符 s/SECBREAK/{s}SECBREAK/ # 分节符 s/placeholder/{T4x3}placeholder/ # 4 行 × 3 列表格 s/placeholder/{T4x3:header}placeholder/ # 带表头行 s/task/{check}task/ # 未勾选复选框 s/done/{checky}done/ # 已勾选 s/todo/{checkn}todo/ # 显式未勾选 s/placeholder/{imghttps:\/\/example.com\/photo.jpg}placeholder/ s/placeholder/{imghttps:\/\/example.com\/photo.jpg x400}placeholder/ s/placeholder/{imghttps:\/\/example.com\/photo.jpg x200 y68}placeholder/x/y尺寸会转换为docs.SizePT 单位随图片插入请求下发见 docs_sed_helpers.go 的buildImageSizeSpec。Markdown 简写语法为兼容习惯Sedmat 同时支持经典 Markdown 简写推荐优先使用花括号语法标题s/text/# Heading 1/ s/text/## Heading 2/ s/text/### Heading 3/ # 直至 ###### Heading 6行内样式s/text/**bold**/ s/text/*italic*/ s/text/***bold italic***/ s/text/~~strikethrough~~/ s/text/monospace/ s/text/__underline__/ s/text/^{superscript}/ s/text/~{subscript}/链接与图片s/text/link text/ s/placeholder/alt/ s/placeholder/alt/列表s/text/- bullet item/ # 无序列表项 s/text/1. numbered item/ # 有序列表项 s/text/ - nested bullet/ # 嵌套项每级缩进 2 空格 s/text/- [ ] unchecked checkbox/ # 未勾选复选框 s/text/- [x] checked checkbox/ # 已勾选复选框块级元素、代码块、脚注、管道表格s/text/---/ # 水平分隔线 s/text/ blockquote text/ # 引用块 s/text/\ncode line 1\ncode line 2\n/ # 代码块 s/text/Some claim[^1]/ # 脚注引用 s/FOOTNOTE/[^1]: Source citation/ # 脚注内容 s/placeholder/| Col A | Col B |\n| data1 | data2 |/ # 管道表格实现细节blockquote会生成带左侧 3pt 灰色边框、36pt 缩进与 12pt 内边距的段落样式对应blockquoteBorderWidthPt/blockquoteIndentPt/blockquotePaddingPt常量见 docs_sed_helpers.go嵌套列表通过在文本前预置\t再调用CreateParagraphBullets的方式让 Docs 自动识别层级见buildNestedListText相关注释与bulletPresetDisc/bulletPresetNumbered常量。表格操作单元格寻址、增删行列与合并表格按文档顺序 1 起始编号|-1|表示最后一张表|*|表示所有表。表达式形态为s/|表号|单元格寻址/替换/。单元格引用s/|1|[1,1]/{b}Header/ # 第 1 张表第 1 行第 1 列 s/|1|[2,3]/value/ # 第 2 行第 3 列 s/|1|[1,*]/{b}/ # 整行加粗通配符 * s/|1|[*,2]/data/ # 整列写入行或列用0或在显示中以通配符标注表示对整个行/列操作。整格替换、子模式替换均通过CellPlanner规划后生成删除插入请求见 docs_sed_table_cells.go对同一张表的连续整格替换会被合并为一次API 调用runBatchCellReplace。增删行与列s/|1|[1,0]// # 追加一行 s/|1|[0,1]// # 追加一列合并与拆分单元格s/|1|[1,1:1,3]/merge/ # 合并第 1 行第 1~3 列 s/|1|[2,2]/split/ # 拆分已合并单元格删除表格s/|1|// # 删除第一张表 s/|*|// # 删除所有表图片引用按序号或 alt 文本替换图片可以通过引用标记定位!(N)按序号文档顺序 1 起始负数从末尾数![regex]按 alt 文本正则匹配s/!(1)/!(https:\/\/new.png)/ # 替换第 1 张图片 s/!(-1)// # 删除最后一张图片 s/!(*)/!(https:\/\/placeholder.png)/g # 替换全部图片 s/![logo]/!(https:\/\/new-logo.png)/ # 按 alt 文本匹配替换批量模式中图片替换被归类为exprCatImage逐条独立执行且每条执行前会等待约 500ms失败后重试前等待 2s以避免 Google 图片抓取的限流问题见 docs_sed.go 与注释。段落寻址按段落编号精确打击除了按内容匹配还可以用地址前缀按段落编号定位1 起始。先用结构命令查看段落编号gog docs structure DOC_ID # 显示带编号的文档结构 gog docs cat DOC_ID -N # cat 输出带 [N] 前缀然后按编号操作gog docs sed DOC_ID 5d # 删除第 5 段 gog docs sed DOC_ID 3,7d # 删除第 3~7 段 gog docs sed DOC_ID $d # 删除最后一段 gog docs sed DOC_ID 5s/.*/New text/ # 替换第 5 段全部文本 gog docs sed DOC_ID 3,7s/old/new/g # 在第 3~7 段内替换 gog docs sed DOC_ID 5a/New line/ # 在第 5 段后追加 gog docs sed DOC_ID 3i/Before text/ # 在第 3 段前插入 gog docs sed DOC_ID $a/Last line/ # 在最后一段后追加地址语法地址含义N第 N 段1 起始N,M第 N 段到第 M 段$最后一段N,$第 N 段到文档末尾寻址逻辑由ResolveAddress与PlanAddressedDelete/Append/Insert实现删除/插入请求逆序构造以保持 Docs 索引稳定见 docs_sed_commands.go。带地址的表达式在批量模式中归为exprCatAddressed串行执行。多 Tab 文档支持--tab标志可指定 Tab 标题或 ID使段落寻址作用于指定 Tabgog docs structure DOC_ID --tab Sheet1 gog docs sed DOC_ID --tab Sheet1 3d底层请求会携带TabId字段见buildAddressMutationRequests中的TabId: tabID。批量模式与 Seed Format 工作流创建一个.sed文件每行一条表达式#注释# format-doc.sed s/QQQ_TITLE/{ht}Report Title/ s/QQQ_AUTHOR/{i cgray}John Doe/ s/QQQ_DATE/2026-02-22/ # 应用 gog docs sed DOC_ID -a account -f format-doc.sed批量模式下表达式先由classifyExprForBatch分类exprCatAddressed/Positional/Image/Command/Cell/TableCreate/Native/Manual共 9 类见 docs_sed.go再按类别调度原生文本替换合成一次批量请求位置插入、寻址、图片、表格等需要独立执行。最终输出形如status ok docId DOC_ID expressions 3 replaced N经典的模板填充流水线Seed Format清空文档gog docs clear DOC_ID -a account用位置插入写入种子内容gog docs sed DOC_ID -f seed.sed -a account格式化gog docs sed DOC_ID -f format.sed -a account此工作流非常适合模板文档 占位符替换的报告自动生成场景。完整 Flags 参考以下为该命令的完整标志表来自 命令参考其中kong.helpFlag/kong.VersionFlag为 CLI 框架内置类型Flag类型默认值说明--access-tokenstring直接使用提供的 access token绕过已存储的 refresh tokentoken 约 1 小时过期-a--account--acctstring账户邮箱、别名或auto用于已认证的 Google API 命令--clientstringOAuth client 名称选择已存储的凭据与 token 桶--colorstringauto彩色输出auto|always|never--disable-commandsstring逗号分隔的禁用命令列表支持点路径-n--dry-run--dryrun--noop--previewbool不实际修改打印计划操作并成功退出--enable-commandsstring逗号分隔的启用命令前缀列表支持点路径限制 CLI--enable-commands-exactstring逗号分隔的精确启用命令列表支持点路径父命令不会启用子命令-e--expressions[]string额外的 sed 表达式可重复-f--filestring从文件读取 sed 表达式每行一条#注释-y--force--assume-yes--yesbool跳过破坏性命令的确认--gmail-no-sendboolfalse阻止 Gmail 发送操作Agent 安全-h--helpkong.helpFlag显示上下文相关的帮助--homestring覆盖 gogcli 的 config/data/state/cache 根目录等价于GOG_HOME-j--json--machineboolfalse以 JSON 输出到 stdout适合脚本--no-input--non-interactive--noninteractivebool绝不提示改为失败退出适合 CI-p--plain--tsvboolfalse输出稳定、可解析的纯文本TSV无颜色--quota-projectstring用于计费的 Google Cloud 项目发送X-Goog-User-Project某些 API 在--access-token或 ADC 场景下要求--readonlyboolfalse运行时阻止变更类 API 请求auth add也只会请求只读 OAuth scope--results-onlyboolJSON 模式下只输出主要结果丢弃nextPageToken等信封字段--select--pick--projectstringJSON 模式下选择逗号分隔的字段尽力而为支持点路径--tabstring用于段落寻址的 Tab 标题或 ID-v--verbosebool启用详细日志--versionkong.VersionFlag打印版本并退出--wrap-untrustedboolfalseJSON/raw 输出中为抓取的文本字段包裹外部不可信内容标记必用的安全选项-n / --dry-run预演模式。runDryRun不需要任何 Google API 调用因此无需认证即可执行会逐条打印每个表达式的序号、类型、合法性正则编译失败会标ERROR、表达式形态与花括号格式化摘要最后输出dry-run: N expressions parsed, no changes made见 docs_sed_dryrun.go。类型包括delete、append-after、insert-before、transliterate、cell、create table、image、positional、brace、native、manual。批量修改文档前强烈建议先跑一次 dry-run。--readonly运行时拦截一切变更类 API 请求可放心用于 Agent 场景。--no-inputCI 场景下避免卡在交互提示直接失败退出。输出格式默认输出 TSV 风格键值对status\tok、docId\tID、replaced\tN单条 native 替换还会输出native\ttrue。-j / --json输出 JSON 对象含status、docId及额外字段适合脚本消费见sedOutputOK的 JSON 分支docs_sed_helpers.go。-p / --plain / --tsv强制无颜色的稳定文本输出。源码执行路径与测试验证从源码结构看gog docs sed的完整调用链为DocsSedCmd.Run ├─ collectExpressions # 位置参数 / -e / -f / stdin ├─ parseFullExpr # docssed.Parse → Enrich → sedExprFromSemantic ├─ DryRun ? runDryRun # 离线预演 ├─ runSingle # 单表达式寻址→命令→表格→位置→单元格→建表→图片→native→manual └─ runBatch # 多表达式分类后按类别批量调度核心解析与执行被抽象在独立的internal/docssed包中parser.go负责语法解析、semantic.go负责语义补全Enrich、brace.go/markdown.go/image.go/match.go负责各子语法、*_plan.go负责生成 Docs API 请求计划、executor.go负责执行批量更新。命令层通过docssed.NewServiceExecutor(docsSvc)包装 Docs API 客户端见 docs_sed_helpers.go。测试覆盖同样充分命令层有docs_sed_commands_test.go、docs_sed_regex_test.go、docs_sed_images_test.go、docs_sed_brace_command_test.go、docs_sed_integration_test.go约 32 个集成用例、docs_sed_integration_edge_test.go、docs_sed_boost2/boost3/boost3b_test.go等覆盖正则替换、图片替换、花括号命令、表格操作、批量执行与边界情况解析层在internal/docssed/parser_test.go、brace_test.go、markdown_test.go、image_test.go、semantic_test.go、table_create_plan_test.go等中有对应单测。这些测试文件是理解命令各分支行为的良好起点。使用边界与注意事项原生 vs 手动路径纯文本全局替换走 Google Docs 原生ReplaceAllTextSearchByRegex: true大小写敏感匹配一条表达式一次 API 往返而带格式花括号/Markdown、第 N 次命中替换、表格、图片等表达式必须走手动路径逐条获取文档再计算索引成本更高。批量时原生表达式会被合并手动表达式则逐条执行。URL 转义表达式以/作为分隔符URL 中的/必须写成\/。图片替换的限流处理图片表达式逐条执行且内置 500ms 间隔与 2s 重试批量替换大量图片耗时较长属预期行为。地址与位置表达式改变文档状态寻址段落与^/$/^$位置插入在批量模式中只能串行执行因为它们依赖最新的文档索引。认证实际修改文档需要已认证的 Google 账户-a指定账户或使用auto--dry-run则不需要。总体而言gog docs sed是 gogcli 中文本管线能力最完整的文档编辑命令它把 Unix 用户熟悉的 sed 心智模型原样搬到 Google Docs再通过 Sedmat DSL 补齐富文本、表格、图片等文档专有能力配合-f批量文件与--dry-run预演可以安全地嵌入脚本、CI 与 Agent 自动化流程中。【免费下载链接】gogcliGoogle Workspace in your terminal.项目地址: https://gitcode.com/GitHub_Trending/gogcl/gogcli创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考