@libai168/dsh-tool-google-sheets

面向 DeepSeek Harness 的 Google Sheets API v4 有界只读插件。它与 Google Drive 插件独立安装，工具统一使用不会冲突的 gsheets_direct_* 前缀。

工具

• gsheets_direct_auth_test：使用指定 spreadsheet ID 读取元数据验证访问权限。
• gsheets_direct_get_spreadsheet：读取标题、区域、时区和受限的工作表属性，不请求完整网格数据。
• gsheets_direct_get_values：读取单个 A1 range，并限制行数、列数和 cell 总数。
• gsheets_direct_batch_get_values：一次 values:batchGet 读取最多 20 个 A1 range。

插件不会开放 values.update、values.append、spreadsheets.batchUpdate、外部导入、Apps Script 或任意自定义 API 地址。

配置

可以配置短期 access token，或配置 OAuth refresh 所需的三个字段：

plugins:
  dsh-tool-google-sheets:
    accessToken: ${GOOGLE_ACCESS_TOKEN}
    # 或同时配置：
    # clientId: ${GOOGLE_CLIENT_ID}
    # clientSecret: ${GOOGLE_CLIENT_SECRET}
    # refreshToken: ${GOOGLE_REFRESH_TOKEN}

请求只允许访问 https://sheets.googleapis.com/v4 和 https://oauth2.googleapis.com/token。工具不会返回 token 或完整 Google 错误响应。

限制

• 每次 batch 最多 20 个 range。
• A1 range 最多 200 个字符。
• 单个 range 默认最多 1000 行、100 列和 100000 个 cell。
• batch 默认最多返回 100000 个 cell。

本地检查方式见 DEVELOPMENT.md。