koishi-plugin-zanwo

QQ 点赞插件，支持为自己或他人点赞，每次最多 50 个赞。

功能特性

• ✨ 支持为自己点赞（zanwo / 赞我）
• 👥 支持为他人点赞（zan），可使用 @ 提及或 QQ 号
• 🎯 自定义点赞数量（1-50），默认 50 个
• 🌐 支持陌生人点赞
• 🎨 自定义成功/失败提示语句（通过本地化配置）
• 📊 可选的匿名遥测数据收集（默认关闭）

安装

在 Koishi 控制台的插件市场搜索 zanwo 可直接安装。

使用方法

基础用法

zanwo              # 为自己点赞 50 次
赞我               # 同上（别名）
zan @某人          # 为某人点赞 50 次
zan 123456789      # 使用 QQ 号点赞

指定点赞数量

zanwo -c 20        # 为自己点赞 20 次
zan @某人 -c 30    # 为某人点赞 30 次
zan 123456789 -c 10  # 使用 QQ 号点赞 10 次

💡 点赞数量限制在 1-50 之间，超出范围会自动调整

配置项

| 配置项 | 类型 | 默认值 | 说明 | |--------|------|--------|------| | debug | boolean | false | 开启调试模式，输出详细日志 | | telemetry | boolean | false | 是否允许上报遥测数据（见下方说明） |

遥测数据收集说明

⚠️ 重要提示

从 v1.0.7 版本开始，本插件引入了可选的匿名遥测数据收集功能。

• 默认状态：遥测功能 默认关闭
• 选择加入：需要在插件配置中手动开启 telemetry 选项
• 随时关闭：可随时在配置中关闭，无需重启 Koishi

📊 收集的数据内容

我们收集以下 匿名 信息用于改进插件：

自动收集的信息

• 操作系统类型 Windows/Linux/macOS/其他
• 系统架构 x64/arm64/其他
• Node.js 版本 v18.0.0
• 插件版本：1.0.7.alpha-2

事件信息

• 插件初始化 插件启动时触发
• 命令使用情况
  • 命令名称（zanwo 或 zan）
  • 执行结果（成功/失败）
  • 点赞数量（1-50）
  • 执行轮数
  • 失败时的错误类型（截取前 80 字符）

🔒 隐私保护

我们 不会收集 以下敏感信息：

• ❌ QQ 号码、用户 ID
• ❌ 群号、频道号
• ❌ 消息内容
• ❌ IP 地址
• ❌ 任何可识别个人身份的信息
• ❌ 机器人账号信息

🇨🇳 数据存储

• 所有遥测数据存储在 中国大陆境内 的服务器
• 数据仅用于统计分析，改进插件功能和用户体验
• 不会向第三方分享、出售或用于商业目的

🎯 数据用途

收集这些数据帮助我们：

1. 了解插件在不同平台的运行情况
2. 优先修复影响范围最广的 bug
3. 根据使用频率优化功能
4. 评估新版本的稳定性

🛡️ 如何开启/关闭

开启遥测

1. 进入 Koishi 控制台
2. 找到 zanwo 插件配置
3. 勾选 telemetry 选项
4. 保存配置

关闭遥测

1. 取消勾选 telemetry 选项
2. 保存配置
3. 插件将立即停止数据上报

📝 透明度承诺

• 所有遥测代码开源，可在 src/telemetry.ts 中查看
• 遥测数据格式和内容完全透明
• 遵守相关法律法规和隐私政策

❓ 为什么默认关闭？

我们尊重用户隐私，认为数据收集应该是用户的 主动选择，而不是强制要求。只有在用户充分了解并同意的情况下，才会开启遥测功能。

本地化配置

插件支持自定义成功/失败提示语句，可在控制台 本地化 部分手动配置

常见问题

Q: 为什么点赞失败？

A: 可能的原因：

1. 对方未启用陌生人点赞
2. 网络连接问题

Q: 使用 @ 提及不生效？

A: 确保：

1. 使用正确的格式：zan @用户名
2. 在支持 @ 提及的平台使用
3. 或直接使用 QQ 号：zan @123456789

Q: 开启遥测会影响性能吗？

A: 不会。遥测请求是异步的，不会阻塞命令执行，即使网络失败也不会影响插件功能。

开发

# 安装依赖
yarn install

# 构建
yarn build

# 在 Koishi 中测试
yarn dev

反馈与贡献

• 问题反馈：Issues