gogcli 文档建议清单全解析：用 `gog docs suggestions list` 列出 Google Docs 待处理的插入与删除建议-北京尧图网络

gogcli 文档建议清单全解析用gog docs suggestions list列出 Google Docs 待处理的插入与删除建议【免费下载链接】gogcliGoogle Workspace in your terminal.项目地址: https://gitcode.com/GitHub_Trending/gogcl/gogcli导读gog docs suggestions list是 gogcliGoogle Workspace in your terminal提供的只读命令用于把 Google Docs 文档中建议模式下尚未被采纳或拒绝的文本建议Text Suggestion——包括插入insertion与删除deletion——一次性枚举出来。在多人审阅、内容审批、AI 协作编辑等场景中它可以帮你快速定位一篇文档里所有待决的修订点并以表格、TSV 或 JSON 的形式交给脚本做进一步处理。读完本文你将掌握该命令的完整参数、输出格式、多 Tab 文档处理方式以及它在 gogcli 源码中的实现原理。命令概览位置、别名与使用语法gog docs suggestions list是gog docs suggestions子命令组下的唯一子命令其父命令是 gog docs suggestions完整命令树为gog docs → gog docs suggestions → gog docs suggestions list。gog docs (doc) suggestions list (ls) docId [flags]其中doc是docs的别名括号内为可用别名list有别名ls因此以下两种写法等价gog docs suggestions list docId gog docs suggestions ls docId命令用途一句话概括为列出文档中待处理的文本插入与删除建议List pending text insertions and deletions。它是纯只读操作不会对文档内容做任何修改天然适合纳入--readonly保护下的自动化巡检流程。必填参数docIddocId是唯一的位置参数positional argument类型为string含义是目标 Google Docs 文档的 ID。从源码看internal/cmd/docs_suggestions.go参数定义如下type DocsSuggestionsListCmd struct { DocID string arg: name:docId help:Doc ID Tab string name:tab help:Tab title or ID (omit for the first tab) }运行前Run方法会调用normalizeGoogleID(strings.TrimSpace(c.DocID))对入参做归一化处理googleid.go传入纯 ID如1AbC...xyz时原样使用传入 Google 文档分享链接时自动提取 ID支持以下 URL 形态https://docs.google.com/document/d/id/edithttps://drive.google.com/file/d/id/view无https://前缀的粘贴文本如docs.google.com/document/d/...sites.google.com/d/id/...等站点编辑器链接若归一化后为空字符串直接返回empty docId错误对应测试 TestDocsSuggestionsList_EmptyDocID。可选参数--tab--tab用于在包含多个标签页Tab的 Google Docs 文档中指定目标标签页可传标签页标题或标签页 ID省略时默认作用于第一个标签页。其底层行为internal/cmd/docs_suggestions.go值得留意未指定--tab时请求不带includeTabsContent参数直接读取文档默认内容指定--tab后请求会附加IncludeTabsContent(true)将文档所有标签页内容一次性拉回再通过 findTab 按 ID 精确匹配其次按标题大小写不敏感匹配找不到时报错并列出所有可用标签标题tab not found: Review (available: Overview, Review, ...)找到后通过projectRawDocumentTab把目标标签页内容投影为独立文档再枚举建议因此最终结果中的索引位置均以该标签页自身内容为基准。findTab匹配时会对嵌套子标签做展平处理flattenTabs递归遍历ChildTabs见 docs_tabs.go。输出格式详解默认表格输出默认输出是带表头的表格各列以 Tab 分隔交给终端渲染为对齐表格SUGGESTION ID KIND SEGMENT START END TEXT suggestion-1 insertion body 1 6 draft各列含义列说明SUGGESTION ID建议 ID对应 Google Docs API 中SuggestedInsertionIds/SuggestedDeletionIds里的标识符KIND建议类型insertion插入或deletion删除SEGMENT建议所在片段正文为body页眉为header:id页脚为footer:id脚注为footnote:idSTART/END建议在所属片段内的起止索引基于 Google Docs API 的偏移量TEXT与建议关联的文本删除建议通常携带被删文本结构类元素为空TSV 稳定输出--plain / --tsv加-p/--plain/--tsv后去掉表头只输出稳定、可解析的 TSV 数据无颜色、无装饰适合awk、cut或 CI 管道直接消费gog docs suggestions list docId --plain文本字段会经过 docsTSVField 转义把\、\t、\r、\n分别替换为\\、\t、\r、\n的字面序列保证多行文本不会被拆散成多行记录对应测试 TestDocsSuggestionsList_Text期望输出中文本a\tb\n以转义形式呈现。JSON 输出--json / -j / --machine加-j/--json/--machine后输出为结构化 JSON便于程序处理{ documentId: 1AbC...xyz, tabId: , suggestions: [ { suggestionId: suggestion-1, kind: insertion, segment: body, startIndex: 1, endIndex: 6, text: draft } ] }输出信封字段说明internal/cmd/docs_suggestions.godocumentId文档 ID与传入的docId对应tabId目标标签页 ID未指定--tab或文档无多标签时为空字符串suggestions建议条目数组每项字段与表格列一一对应。若结合--results-only则 JSON 模式只保留suggestions主体、丢弃documentId/tabId等信封字段便于脚本直接迭代建议数组若结合--select别名--pick/--project可进一步做字段投影。这两者都是 gogcli 的全局 JSON 输出选项详见下方 Flags 表。完整 Flags 参考除位置参数docId和--tab外该命令继承 gogcli 全部全局标志这些标志也同时出现在父命令 gog docs suggestions 上Flag类型默认值说明--access-tokenstring直接使用给定的访问令牌绕过存储的刷新令牌令牌约 1 小时过期-a/--account/--acctstring认证的 Google API 命令使用的账号邮箱、别名或auto--clientstringOAuth 客户端名称选择存储的凭据令牌桶--colorstringauto颜色输出auto\|always\|never--disable-commandsstring逗号分隔的禁用命令列表支持点路径-n/--dry-run/--dryrun/--noop/--previewbool不执行更改打印预期动作并以成功退出--enable-commandsstring逗号分隔的启用命令前缀列表支持点路径限制 CLI 可用范围--enable-commands-exactstring逗号分隔的精确启用命令列表点路径下父命令不会自动启用子命令-y/--force/--assume-yes/--yesbool跳过破坏性命令的确认提示--gmail-no-sendboolfalse阻止 Gmail 发送操作Agent 安全-h/--helpkong.helpFlag显示上下文相关帮助--homestring覆盖 gogcli 的 config/data/state/cache 根目录等价于GOG_HOME-j/--json/--machineboolfalse向 stdout 输出 JSON最适合脚本--no-input/--non-interactive/--noninteractivebool绝不交互式提示失败直接报错适合 CI-p/--plain/--tsvboolfalse向 stdout 输出稳定、可解析的文本TSV无颜色--quota-projectstring用于计费 API 用量的 Google Cloud 项目以X-Goog-User-Project头发送部分 API 在--access-token或 ADC 模式下要求此项--readonlyboolfalse在运行时阻止所有变更类 API 请求auth add也只会请求只读 OAuth 范围--results-onlyboolJSON 模式只输出主结果丢弃nextPageToken等信封字段--select/--pick/--projectstringJSON 模式下按逗号分隔选择字段尽力而为支持点路径。多数命令推荐使用--fields-v/--verbosebool开启详细日志--versionkong.VersionFlag打印版本并退出--wrap-untrustedboolfalseJSON/raw 输出中为拉取的文本字段包裹外部不可信内容标记与 Agent / 自动化场景相关的重要标志--readonly本命令本身就是只读操作加上该标志后整个进程还会被强制运行在只读模式运行时阻止一切变更类 API 请求适合在自动化巡检或 Agent 环境中作为双保险。--no-input非交互模式任何需要人工确认的环节直接失败而非挂起等待是 CI 管道的标准选择。--json--results-only--select组合使用可把输出裁剪到脚本真正需要的字段。实现原理它到底是怎么枚举建议的数据来源SUGGESTIONS_INLINE视图命令通过 Google Docs API 的Documents.Get拉取文档并强制指定SuggestionsViewMode(SUGGESTIONS_INLINE)internal/cmd/docs_suggestions.go。该视图会把文档中所有带建议的文本以内联形式返回——即正文仍然保留原始文本同时在每个受影响的元素上附带SuggestedInsertionIds/SuggestedDeletionIds列表。测试代码对这一点做了严格校验docs_suggestions_test.go请求 URL 中的suggestionsViewMode必须是SUGGESTIONS_INLINE且默认请求未指定--tab不得携带includeTabsContent。覆盖范围不止正文enumerateDocsSuggestionsinternal/cmd/docs_suggestions.go会遍历文档的多个独立片段每一段都单独枚举SEGMENT 前缀来源body文档正文header:id页眉按 ID 排序输出保证结果稳定footer:id页脚footnote:id脚注sortedDocsMapKeys对 map 键排序后再遍历确保同样的文档永远产生相同顺序的输出。元素类型全覆盖在段落内部枚举器会递归处理所有类型的ParagraphElementdocs_suggestions.goTextRun普通文本携带实际内容AutoText自动文本ColumnBreak分栏符DateElement日期元素Equation公式FootnoteReference脚注引用HorizontalRule水平分隔线InlineObjectElement内联对象如嵌入图片还会合并InlineObjectsmap 上的建议PageBreak分页符Person人员智能芯片RichLink富链接卡片对于非文本元素text字段为空字符串但仍保留建议 ID 与起止索引。除此之外以下结构级建议同样会被捕获对应测试 TestEnumerateDocsSuggestions表格表格结构SuggestedInsertionIds、行结构、单元格结构及其内部内容的建议会逐层合并继承目录TableOfContents目录整体及其内部内容的建议章节分隔符SectionBreak列表List通过doc.Listsmap 关联Bullet.ListId捕获列表级建议定位对象PositionedObject包括段落当前的PositionedObjectIds与SuggestedPositionedObjectIds中新增的对象。相邻片段合并逻辑appendDocsSuggestionRange中有一个关键优化docs_suggestions.go当同一个建议 ID 的条目结束索引恰好等于新片段的开始索引即建议在原文中是连续相邻的时会把新片段追加到已有条目的EndIndex与Text上而不是新建一条。这样一个跨多个 TextRun 的连续插入建议会被合并成一条完整记录。测试中的典型用例docs_suggestions_test.go文本helStartIndex 1-4与loStartIndex 4-6都挂着建议 IDinsert最终合并为{SuggestionID: insert, Kind: insertion, Segment: body, StartIndex: 1, EndIndex: 6, Text: hello}——这正好说明为什么一条跨 run 的建议能汇总成一段完整文本。同一个 ID 若重复出现在不同位置测试里的nested则会各自保留为独立条目。错误处理请求失败时若底层错误属于文档不存在类别isDocsNotFound见 docs_helpers.go命令会返回友好错误doc not found or not a Google Doc (idid)文档对象为空时返回doc not found。这提示我们该命令仅适用于 Google Docs 类型的文档传入非文档 ID 或无权访问的文档都会得到明确报错。典型使用场景1. 快速盘点一篇文档的所有待决建议gog docs suggestions list 1AbC...xyz输出中的每一行就是一条待处理的建议KIND为insertion的是建议新增的内容KIND为deletion的是建议删除的内容。配合SEGMENT列可以区分建议来自正文、页眉还是脚注。2. 只查看多标签文档的某一个标签页gog docs suggestions list 1AbC...xyz --tab Review按标题或标签页 ID 定位SEGMENT与索引均以该标签页内容为基准。3. 交给脚本做后续分析# TSV 模式提取所有插入建议的文本 gog docs suggestions list 1AbC...xyz --plain | awk -F\t $2insertion {print $6} # JSON 模式统计待处理建议数量 gog docs suggestions list 1AbC...xyz --json | jq .suggestions | length4. 在 CI / Agent 环境中安全执行gog docs suggestions list 1AbC...xyz --json --results-only --no-input --readonly--readonly确保整个进程不可能发起任何变更请求--no-input避免因交互提示卡死流水线。关联资源父命令gog docs suggestions命令索引docs/commands/README.md核心实现internal/cmd/docs_suggestions.go单元测试internal/cmd/docs_suggestions_test.go标签页查找逻辑internal/cmd/docs_tabs.go文档 ID 归一化internal/cmd/googleid.goGoogle 服务装配入口internal/cmd/service_helpers.go小结gog docs suggestions list用一条命令把 Google Docs 中分散在各处、内嵌在 API 结构里的待处理建议汇总成统一的清单无论是人工审阅还是脚本自动化都能直接消费。理解它的三个关键点——SUGGESTIONS_INLINE视图、正文/页眉/页脚/脚注四类片段全覆盖、以及相邻建议合并逻辑——就能准确解读输出并将其可靠地嵌入你的文档审阅与内容自动化工作流。【免费下载链接】gogcliGoogle Workspace in your terminal.项目地址: https://gitcode.com/GitHub_Trending/gogcl/gogcli创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考

gogcli 文档建议清单全解析：用 `gog docs suggestions list` 列出 Google Docs 待处理的插入与删除建议

相关推荐

华为交换机VLAN+Trunk实战：部门网络隔离与ACL安全配置

高效部署AnolisOS：虚拟机镜像导入与配置实战

STM32CubeIDE Attach 在线调试：不下载不复位的现场排查指南

更多资讯

GitLab CI/CD实现测试左移的DevOps实践

Home Assistant 中 Snooz 白噪音机关闭过渡（transition_off）动作完整指南

Spring Boot依赖管理：starter-parent与dependencies对比

PyWxDump：一封律师函下的微信数据库解密项目，3 步核实仓库现状

Lightdash 组织级 Limits 深度解析：查询行数与 CSV/Excel 导出单元格上限的组织级覆盖机制

k-skill 项目 korean-character-count 技能深度解析：基于 Intl.Segmenter 的确定性韩文计数合同与 NEIS 兼容字节计算

今日更新

AWS无服务器应用开发指南：从Lambda到SAM的架构与实践

SpringBoot+Vue人事系统实战：解决HR数据断点与事务一致性

MATLAB手写紧束缚模型计算石墨烯能带结构

本周精选

AI驱动的自动化专利分析平台技术解析

LeetCode-Go 题解：1252. Cells with Odd Values in a Matrix（奇数值单元格计数）双解法剖析

在线答疑系统Java毕设实战：Spring Boot前后端分离与状态流转

本月热门

基于YOLO的焊缝缺陷检测：从数据标注到工业部署全流程实践

分布式服务的决策记录

创业产品的首版范围

读完文章，想聊聊您的网站？