koishi-plugin-class-score-system 1.0.0

package/src/services/server.ts

@@ -0,0 +1,93 @@
+import { Context } from 'koishi'
+import { ServerConfig } from '../models/database'
+import { CsmsApiService } from './api'
+
+export class ServerConfigService {
+  private ctx: Context
+
+  constructor(ctx: Context) {
+    this.ctx = ctx
+  }
+
+  async saveConfig(guildId: string, name: string, address: string, username: string, token: string): Promise<ServerConfig> {
+    const now = new Date()
+    
+    // 检查该群聊是否已有配置
+    const existingConfigs = await this.ctx.database.get('server_configs', { guildId })
+    
+    // 自动移除 /api/global_api.php 后缀
+    const baseUrl = address.replace(/\/api\/global_api\.php$/, '').replace(/\/$/, '')
+    
+    if (existingConfigs.length > 0) {
+      // 更新现有配置
+      await this.ctx.database.set('server_configs', { guildId }, {
+        name,
+        address: baseUrl,
+        username,
+        token,
+        updatedAt: now,
+      })
+      return { ...existingConfigs[0], name, address: baseUrl, username, token, updatedAt: now }
+    }
+    
+    // 创建新配置
+    const config = await this.ctx.database.create('server_configs', {
+      guildId,
+      name,
+      address: baseUrl,
+      username,
+      token,
+      createdAt: now,
+      updatedAt: now,
+    })
+    
+    return config
+  }
+
+  async getConfigByGuild(guildId: string): Promise<ServerConfig | null> {
+    const configs = await this.ctx.database.get('server_configs', { guildId })
+    return configs[0] || null
+  }
+
+  async getAllConfigs(): Promise<ServerConfig[]> {
+    return this.ctx.database.get('server_configs', {})
+  }
+
+  async deleteConfig(guildId: string): Promise<boolean> {
+    await this.ctx.database.remove('server_configs', { guildId })
+    return true
+  }
+
+  async createApiService(guildId: string): Promise<CsmsApiService | null> {
+    const config = await this.getConfigByGuild(guildId)
+    if (!config) return null
+    
+    return new CsmsApiService(this.ctx, config.address, config.token)
+  }
+
+  async validateConfig(address: string, username: string, token: string): Promise<{ valid: boolean; error?: string; actualUsername?: string }> {
+    try {
+      // 自动移除 /api/global_api.php 后缀
+      const baseUrl = address.replace(/\/api\/global_api\.php$/, '').replace(/\/$/, '')
+      const api = new CsmsApiService(this.ctx, baseUrl, token)
+      const result = await api.validateToken()
+      
+      if (result.valid) {
+        // 如果提供的用户名与实际登录的管理员用户名不同，给出提示
+        if (result.username && result.username !== username) {
+          return { 
+            valid: true, 
+            actualUsername: result.username,
+            error: `警告：提供的用户名 "${username}" 与实际登录的管理员 "${result.username}" 不一致` 
+          }
+        }
+        return { valid: true, actualUsername: result.username }
+      }
+      
+      return { valid: false, error: 'Token 验证失败，请检查 Token 是否正确' }
+    } catch (error: any) {
+      this.ctx.logger.error('验证服务器配置失败:', error)
+      return { valid: false, error: error.message }
+    }
+  }
+}

package/src/utils/constants.ts

@@ -0,0 +1,51 @@
+export const CONSTANTS = {
+  TOKEN_PATTERN: /^[A-Z0-9]+$/,
+  QQ_PATTERN: /^\d{5,12}$/,
+  SCORE_MIN: -1000,
+  SCORE_MAX: 1000,
+  RANKING_DEFAULT_LIMIT: 10,
+  RANKING_MAX_LIMIT: 50,
+  SCORE_LOGS_DEFAULT_LIMIT: 20,
+  SCORE_LOGS_MAX_LIMIT: 100,
+  USERNAME_MAX_LENGTH: 50,
+  DESCRIPTION_MAX_LENGTH: 255,
+}
+
+export const ERROR_MESSAGES = {
+  NO_SERVER_CONFIG: '未配置CSMS服务器，请先使用 /绑定服务器 命令配置',
+  INVALID_TOKEN: '无效的Token格式，Token必须由数字和英文大写字母组成',
+  INVALID_QQ: '无效的QQ号码格式',
+  INVALID_SCORE: '分数必须在 -1000 到 1000 之间',
+  INVALID_USERNAME: '用户名不能为空且长度不能超过50个字符',
+  INVALID_DESCRIPTION: '描述信息长度不能超过255个字符',
+  INVALID_LIMIT: '数量必须在 1 到 50 之间',
+  SERVER_NOT_FOUND: '服务器未找到',
+  USER_NOT_FOUND: '用户未找到',
+  USER_ALREADY_BOUND: '该QQ号已绑定其他用户',
+  USER_NOT_BOUND: '该QQ号未绑定任何用户',
+  API_REQUEST_FAILED: 'API请求失败',
+  INSUFFICIENT_PERMISSION: '权限不足，仅管理员可执行此操作',
+  BINDING_FAILED: '绑定失败',
+  UNBINDING_FAILED: '解除绑定失败',
+  CONFIGURATION_FAILED: '配置保存失败',
+} as const
+
+export const SUCCESS_MESSAGES = {
+  SERVER_CONFIGURED: '服务器配置成功',
+  SERVER_VALIDATED: '服务器配置验证成功',
+  QQ_BOUND: 'QQ绑定成功',
+  QQ_UNBOUND: 'QQ解除绑定成功',
+  SCORE_ADJUSTED: '积分调整成功',
+  USER_CREATED: '用户创建成功',
+} as const
+
+export const HELP_MESSAGES = {
+  BIND_SERVER: '绑定CSMS服务器\n用法：/绑定服务器 <服务器地址> <管理员用户名> <管理员Token>\n示例：/绑定服务器 https://example.com admin ABC123',
+  QUERY_SCORE: '查询积分\n用法：/查询积分 [用户名]\n示例：/查询积分 张三',
+  ADJUST_SCORE: '调整积分\n用法：/调整积分 <用户名> <分数> <原因>\n示例：/调整积分 张三 +5 表现优秀',
+  BIND_QQ: '绑定QQ\n用法：/绑定QQ <用户名>\n示例：/绑定QQ 张三',
+  VIEW_BINDING: '查看绑定\n用法：/查看绑定 [用户名]\n示例：/查看绑定 张三',
+  UNBIND_QQ: '解除绑定\n用法：/解除绑定 <QQ号>\n示例：/解除绑定 123456789',
+  RANKING: '排行榜\n用法：/排行榜 [数量]\n示例：/排行榜 10',
+  STATISTICS: '统计\n用法：/统计 [用户名]\n示例：/统计 张三',
+} as const

package/src/utils/formatter.ts

@@ -0,0 +1,172 @@
+import { CsmsUser, CsmsScoreLog } from '../services/api'
+
+export class Formatter {
+  // QQ 消息单条最大长度限制（留有余量）
+  private static readonly MAX_MESSAGE_LENGTH = 1800
+
+  static formatScoreInfo(user: CsmsUser, ranking?: number): string {
+    return [
+      `用户: ${user.username}`,
+      `排名: ${ranking || '未知'}`,
+      `总积分: ${user.total_score}`,
+      `累计加分: ${user.add_score}`,
+      `累计扣分: ${user.deduct_score}`,
+      `记录数: ${user.score_count}`,
+    ].join('\n')
+  }
+
+  static formatRanking(users: CsmsUser[]): string {
+    if (users.length === 0) {
+      return '暂无排名数据'
+    }
+
+    const lines = ['【积分排行榜】']
+    const displayUsers = users.slice(0, 20) // 最多显示20个
+
+    displayUsers.forEach((user, index) => {
+      const medal = index < 3 ? ['🥇', '🥈', '🥉'][index] : `${index + 1}.`
+      lines.push(`${medal} ${user.username}: ${user.total_score}分`)
+    })
+
+    if (users.length > 20) {
+      lines.push(`... 共 ${users.length} 人，显示前20名`)
+    }
+
+    return lines.join('\n')
+  }
+
+  /**
+   * 格式化排行榜（带实际排名，用于分页）
+   */
+  static formatRankingWithRank(users: CsmsUser[], startRank: number): string {
+    if (users.length === 0) {
+      return '暂无排名数据'
+    }
+
+    const lines = ['【积分排行榜】']
+
+    users.forEach((user, index) => {
+      const rank = startRank + index
+      const medal = rank <= 3 ? ['🥇', '🥈', '🥉'][rank - 1] : `${rank}.`
+      lines.push(`${medal} ${user.username}: ${user.total_score}分`)
+    })
+
+    return lines.join('\n')
+  }
+
+  static getMedal(index: number): string {
+    const medals = ['🥇', '🥈', '🥉']
+    return medals[index] || `${index + 1}.`
+  }
+
+  static formatScoreLogs(logs: CsmsScoreLog[]): string {
+    if (logs.length === 0) {
+      return '暂无积分记录'
+    }
+
+    const lines = ['【积分记录】']
+    const displayLogs = logs.slice(0, 10)
+
+    displayLogs.forEach((log) => {
+      const change = log.score_change > 0 ? `+${log.score_change}` : log.score_change
+      lines.push(`${change}分 - ${log.description}`)
+    })
+
+    if (logs.length > 10) {
+      lines.push(`... 共 ${logs.length} 条记录`)
+    }
+
+    return lines.join('\n')
+  }
+
+  static formatStatistics(user: CsmsUser, logs: CsmsScoreLog[]): string {
+    const lines = [
+      `【${user.username} 的统计信息】`,
+      `总积分: ${user.total_score}`,
+      `累计加分: ${user.add_score}`,
+      `累计扣分: ${user.deduct_score}`,
+      `记录数: ${user.score_count}`,
+      '最近积分记录:',
+    ]
+
+    const recentLogs = logs.slice(0, 5)
+    if (recentLogs.length > 0) {
+      recentLogs.forEach((log) => {
+        const change = log.score_change > 0 ? `+${log.score_change}` : log.score_change
+        lines.push(`${change}分 - ${log.description}`)
+      })
+    } else {
+      lines.push('暂无记录')
+    }
+
+    return lines.join('\n')
+  }
+
+  static formatAddScoreResult(result: any): string {
+    const status = result.success ? '积分调整成功' : '积分调整失败'
+    const summary = `成功: ${result.summary.success_count} 条，失败: ${result.summary.failed_count} 条`
+
+    const lines = [status, summary]
+
+    // 失败时显示错误原因
+    if (!result.success && result.message) {
+      lines.push(`原因: ${result.message}`)
+    }
+
+    if (result.details && result.details.length > 0) {
+      lines.push('详情:')
+      result.details.forEach((detail: any) => {
+        if (detail.success) {
+          const change = detail.score_change > 0 ? '+' : ''
+          lines.push(`[OK] ${detail.username}: ${change}${detail.score_change}分`)
+        } else {
+          lines.push(`[FAIL] ${detail.username}: ${detail.error || '失败'}`)
+        }
+      })
+    }
+
+    return lines.join('\n')
+  }
+
+  static formatDate(dateString: string): string {
+    const date = new Date(dateString)
+    return date.toLocaleString('zh-CN', {
+      year: 'numeric',
+      month: '2-digit',
+      day: '2-digit',
+      hour: '2-digit',
+      minute: '2-digit',
+    })
+  }
+
+  /**
+   * 安全发送消息，自动分割过长的消息
+   * 返回消息片段数组，由调用者处理发送
+   */
+  static splitMessage(message: string): string[] {
+    if (message.length <= this.MAX_MESSAGE_LENGTH) {
+      return [message]
+    }
+
+    const parts = message.split('\n')
+    const result: string[] = []
+    let currentPart = ''
+
+    for (const line of parts) {
+      if ((currentPart + '\n' + line).length > this.MAX_MESSAGE_LENGTH) {
+        if (currentPart) {
+          result.push(currentPart)
+        }
+        currentPart = line
+      } else {
+        currentPart = currentPart ? currentPart + '\n' + line : line
+      }
+    }
+
+    if (currentPart) {
+      result.push(currentPart)
+    }
+
+    return result
+  }
+}

package/src/utils/image.ts

@@ -0,0 +1,114 @@
+import { Context, h } from 'koishi'
+
+// 通用竖版图片生成函数
+export async function generateImage(
+  ctx: Context,
+  html: string,
+  options: { width?: number; height?: number } = {}
+): Promise<Buffer | null> {
+  const width = options.width || 450
+  const height = options.height || 800
+
+  try {
+    const page = await (ctx as any).puppeteer.page()
+
+    await page.setViewport({
+      width,
+      height,
+      deviceScaleFactor: 2,
+    })
+
+    await page.setContent(html, { waitUntil: 'networkidle0' })
+    await page.evaluateHandle('document.fonts.ready')
+
+    // 等待背景图片加载
+    await page.evaluate(() => {
+      return new Promise<void>((resolve) => {
+        const img = document.querySelector('body') as HTMLElement
+        if (img && img.style.backgroundImage) {
+          const bgImg = new Image()
+          bgImg.onload = () => resolve()
+          bgImg.onerror = () => resolve()
+          bgImg.src = img.style.backgroundImage.replace(/url\(['"]?(.+?)['"]?\)/, '$1')
+        } else {
+          resolve()
+        }
+      })
+    })
+
+    const screenshot = await page.screenshot({
+      type: 'png',
+      clip: { x: 0, y: 0, width, height },
+    })
+
+    return screenshot as Buffer
+  } catch (error) {
+    ctx.logger.error('生成图片失败:', error)
+    return null
+  }
+}
+
+// 发送图片（优先图片，失败回退文字）
+export async function sendImageOrText(
+  ctx: Context,
+  session: any,
+  html: string,
+  fallbackText: string,
+  options: { width?: number; height?: number } = {}
+): Promise<void> {
+  const image = await generateImage(ctx, html, options)
+  if (image) {
+    await session.send(h.image(image, 'image/png'))
+  } else {
+    await session.send(fallbackText)
+  }
+}
+
+// 通用基础模板样式
+export function getBaseStyles(): string {
+  return `
+    * { margin: 0; padding: 0; box-sizing: border-box; }
+    body {
+      font-family: -apple-system, BlinkMacSystemFont, 'Segoe UI', 'PingFang SC', 'Microsoft YaHei', sans-serif;
+      background: url('https://api.yppp.net/pe.php') center/cover no-repeat;
+      width: 450px;
+      min-height: 800px;
+      display: flex;
+      justify-content: center;
+      align-items: flex-start;
+      padding: 40px 0;
+    }
+    .container {
+      background: rgba(255, 255, 255, 0.5);
+      border-radius: 24px;
+      padding: 28px 24px;
+      width: 380px;
+      box-shadow: 0 10px 40px rgba(0, 0, 0, 0.15);
+      margin: 0 auto;
+    }
+    .title {
+      text-align: center;
+      font-size: 22px;
+      font-weight: bold;
+      color: #2c3e50;
+      margin-bottom: 20px;
+      padding-bottom: 12px;
+      border-bottom: 2px solid #3498db;
+    }
+    .content {
+      color: #555;
+      font-size: 14px;
+      line-height: 1.8;
+      white-space: pre-wrap;
+      word-break: break-all;
+    }
+    .footer {
+      text-align: center;
+      margin-top: 16px;
+      padding-top: 12px;
+      border-top: 1px solid rgba(0,0,0,0.1);
+      color: #95a5a6;
+      font-size: 10px;
+    }
+  `
+}

package/src/utils/index.ts

@@ -0,0 +1,3 @@
+export * from './constants'
+export * from './validator'
+export * from './formatter'

package/src/utils/validator.ts

@@ -0,0 +1,71 @@
+import { CONSTANTS, ERROR_MESSAGES } from './constants'
+
+export class Validator {
+  static validateToken(token: string): boolean {
+    return CONSTANTS.TOKEN_PATTERN.test(token)
+  }
+
+  static validateQq(qqNumber: string): boolean {
+    // 更宽松的验证：只要是数字或者包含数字的字符串即可
+    // 支持沙盒环境的用户ID格式
+    return qqNumber && qqNumber.length > 0 && /^\d+$/.test(qqNumber)
+  }
+
+  static validateScore(score: number): boolean {
+    return score >= CONSTANTS.SCORE_MIN && score <= CONSTANTS.SCORE_MAX
+  }
+
+  static validateUsername(username: string): boolean {
+    return username.length > 0 && username.length <= CONSTANTS.USERNAME_MAX_LENGTH
+  }
+
+  static validateDescription(description: string): boolean {
+    return description.length <= CONSTANTS.DESCRIPTION_MAX_LENGTH
+  }
+
+  static validateLimit(limit: number, max: number = CONSTANTS.RANKING_MAX_LIMIT): boolean {
+    return limit > 0 && limit <= max
+  }
+
+  static validateScoreWithMessage(score: number): string | null {
+    if (!this.validateScore(score)) {
+      return ERROR_MESSAGES.INVALID_SCORE
+    }
+    return null
+  }
+
+  static validateQqWithMessage(qqNumber: string): string | null {
+    if (!this.validateQq(qqNumber)) {
+      return ERROR_MESSAGES.INVALID_QQ
+    }
+    return null
+  }
+
+  static validateTokenWithMessage(token: string): string | null {
+    if (!this.validateToken(token)) {
+      return ERROR_MESSAGES.INVALID_TOKEN
+    }
+    return null
+  }
+
+  static validateUsernameWithMessage(username: string): string | null {
+    if (!this.validateUsername(username)) {
+      return ERROR_MESSAGES.INVALID_USERNAME
+    }
+    return null
+  }
+
+  static validateDescriptionWithMessage(description: string): string | null {
+    if (!this.validateDescription(description)) {
+      return ERROR_MESSAGES.INVALID_DESCRIPTION
+    }
+    return null
+  }
+
+  static validateLimitWithMessage(limit: number, max: number = CONSTANTS.RANKING_MAX_LIMIT): string | null {
+    if (!this.validateLimit(limit, max)) {
+      return `数量必须在 1 到 ${max} 之间`
+    }
+    return null
+  }
+}