用途:将结构化数据写入已有 Google 表格时,遵循一套安全流程,避免列位移或误写范围。
主要能力:检查工作簿与目标工作表、定位真实表头行、按表头名映射字段、校验目标区域、写入后回读验证对齐情况。提供工具包括 google_sheets_get、google_sheets_worksheets_list、google_sheets_values_get、google_sheets_values_batch_get、google_sheets_values_update、google_sheets_values_batch_update。
使用方式:需已安装并连接 Hyper MCP(https://app.hyperfx.ai/mcp),并在 https://app.hyperfx.ai/apps 启用 Google Sheets 集成。通过 MCP 客户端可用 search、describe、call;通过 Hyper CLI 可用 hyperai search、hyperai describe、hyperai call <name> --json '{...}'。流程为:先检查表结构,再读取足够上下文找到真实表头(如 range="Sheet1!A1:Z5"),按表头名建立映射,优先使用较窄的已验证区域写入,写入后必须回读 2-3 行确认字段落在正确表头下。除非用户明确需要公式,否则使用 RAW。
适用场景:向已有固定列的表格追加或更新记录,且表格含辅助列、标题行、合计、公式或合并标签等复杂结构。
限制:不得仅凭猜测的列字母写入;不得假设第 1 行是表头或 A 列是首个数据列;不得把 Total、Notes、公式、空列等当作真实表头;不得在未检查现有数据前大范围覆盖;未回读确认前不得声称成功;若所需表头缺失或含糊,应停止并询问用户。