HybridStats

数据上报指南

在园艺插件 0.4.0 版本后新增了基于金山文档多维表的数据上报统计功能。此功能可以在收获时自动上报杂交结果到预先设置的文档中。

使用步骤

1. 创建统计用的多维表格

进入金山文档首页，点击左上角新建按钮，选择应用服务-多维表格，点击+号即可创建空白多维表格。

2. 创建统计脚本

点击文档上方菜单栏右侧的开发按钮，选择新建脚本，将以下统计脚本代码复制粘贴到新建的脚本中并点击保存。

/**
 * 园艺统计脚本 v1.0 (2024/04/06)
 * 请务必先清空生成的示例脚本
 */
function main() {
  let seed = Context.argv.seed
  let result = Context.argv.result
  let name = Context.argv.name
  if (!name) name = undefined

  dataPush(getSheetID(), seed, result, name)
}
main()

function dataPush(sheetid, seed, result, name) {
  let date = new Date()
  Application.Record.CreateRecords({
    SheetId: sheetid,
    Records: [{
      fields: {
        日期: date.toLocaleDateString('zh-cn'),
        时间: date.toLocaleTimeString('zh-cn'),
        玩家: name,
        种子: seed,
        杂交结果: result
      }
    }]
  })
  console.log('数据已录入')
}

function getSheetID() {
  let Sheets = Array.from(Application.Sheet.GetSheets())
  let sheet = Sheets.find(s => s.name === '园艺统计表')
  if (sheet) return sheet.id
  return sheetCreate()
}

function sheetCreate() {
  let sheet = Application.Sheet.CreateSheet({
    Name: '园艺统计表',
    Fields: [
      { name: '日期', type: 'Date' },
      { name: '时间', type: 'Time' },
      {
        name: '玩家',
        type: 'SingleSelect',
        autoAddItem: true,
        items: [{ value: '光之战士' }],
        defaultValue: "光之战士",
        defaultValueType: "Normal",
      },
      {
        name: '种子',
        type: 'SingleSelect',
        autoAddItem: true,
        items: [{ value: 'null' }]
      },
      {
        name: '杂交结果',
        type: 'SingleSelect',
        autoAddItem: true,
        items: [{ value: '杂交失败' }],
        defaultValue: "杂交失败",
        defaultValueType: "Normal",
      }
    ],
    Views: [
      { name: '统计数据', type: 'Grid' }
    ],
  })
  console.log('园艺统计表已创建')
  return sheet.id;
}

点击运行按钮，此时应该会创建一个新的名为“园艺统计表”的数据表，内部有一条测试用的数据。

3. 获取脚本webhook地址与令牌

1. 点击脚本文件右侧的 ··· 按钮，选择 复制脚本webhook ，即可获取到脚本地址；
2. 点击脚本编辑器右上角的脚本令牌按钮，根据提示操作即可获取个人脚本令牌。

注意：脚本令牌仅在创建时对本人可见，请妥善保存。同时令牌有效期为180天，请注意及时延期。

4. 配置ACT插件

在插件右侧的杂交结果统计栏中填写相关参数：

• 地址: 填入上面获取到的脚本webhook地址（必填）
• 令牌: 填入上面获取到的个人脚本令牌（必填）
• 昵称: 填入您的昵称（可留空，默认昵称为“光之战士”）

5. 测试上报

点击插件配置下方的测试上报按钮，此时ACT日志应显示杂交结果上报成功。

前往轻维表页面，此时表格视图中应有一条刚刚上报的测试数据，内容为 昵称-测试种子-杂交失败。至此，园艺统计功能配置完成，可以开始愉快种地啦！

隐私政策

1. 为了上报您的杂交状况，本插件会收集以下信息用于上报：

• 使用的种子；
• 杂交结果；
• 设置的玩家昵称。 以上信息仅会发送到您填写的地址中，不会留存于我们的服务器上。

2. 设置中的昵称仅用于标识不同玩家，您可以随意填写。