开发者指南

// 计算意愿值
calculateWillingness(message: Message): number

// 检查是否应该回应
shouldRespond(message: Message): boolean

// 更新意愿值配置
updateWillingnessConfig(config: WillingnessConfig): void

// 添加记忆
addMemory(session: string, content: string, importance?: number): Promise<void>

// 获取相关记忆
getRelevantMemories(session: string, query: string, limit?: number): Promise<Memory[]>

// 清理旧记忆
cleanupOldMemories(session: string, olderThan?: number): Promise<number>

// 发送请求到模型
sendModelRequest(prompt: string, options?: ModelRequestOptions): Promise<ModelResponse>

// 获取可用适配器列表
getAvailableAdapters(): Adapter[]

// 切换默认适配器
setDefaultAdapter(adapterName: string): boolean

// 验证响应内容
validateResponse(response: string, context: ValidationContext): Promise<ValidationResult>

// 添加自定义验证器
addValidator(validator: Validator): void

// 获取验证统计信息
getValidationStats(): ValidationStats

// 注册新工具
registerTool(tool: Tool): void

// 执行工具
executeTool(toolName: string, params: any): Promise<ToolResult>

// 检查工具权限
checkToolPermission(userId: string, toolName: string): boolean

// src/index.ts
import { Context, Schema } from 'koishi'

// 定义插件配置结构
export interface Config {
  message: string
}

// 定义配置模式
export const Config: Schema<Config> = Schema.object({
  message: Schema.string().default('Hello, world!').description('欢迎消息'),
})

// 插件主函数
export function apply(ctx: Context, config: Config) {
  // 注册命令
  ctx.command('hello')
    .action(() => config.message)

  // 访问 YesImBot API
  const yesimbot = ctx.yesimbot
  if (yesimbot) {
    // 使用 YesImBot API
    ctx.middleware((session, next) => {
      // 在这里处理消息
      return next()
    })
  }
}

// 创建自定义验证器
import { Validator, ValidationContext, ValidationResult } from 'yesimbot'

export class CustomValidator implements Validator {
  name = 'CustomValidator'
  priority = 10

  async validate(response: string, context: ValidationContext): Promise<ValidationResult> {
    // 实现验证逻辑
    const isValid = /* 验证逻辑 */

    return {
      valid: isValid,
      reason: isValid ? '' : '验证失败的原因',
      modified: isValid ? response : '修改后的响应'
    }
  }
}

// 注册验证器
export function apply(ctx: Context) {
  const verifier = ctx.yesimbot.verifier
  verifier.addValidator(new CustomValidator())
}

// 创建自定义工具
import { Tool, ToolParams, ToolResult } from 'yesimbot'

export class CustomTool implements Tool {
  name = 'CustomTool'
  description = '这是一个自定义工具'
  parameters = {
    query: {
      type: 'string',
      description: '查询参数'
    }
  }

  async execute(params: ToolParams): Promise<ToolResult> {
    const { query } = params

    // 实现工具逻辑
    const result = /* 工具执行逻辑 */

    return {
      success: true,
      data: result,
      message: '工具执行成功'
    }
  }
}

// 注册工具
export function apply(ctx: Context) {
  const toolSystem = ctx.yesimbot.toolSystem
  toolSystem.registerTool(new CustomTool())
}

// 创建自定义适配器
import { Adapter, ModelRequestOptions, ModelResponse } from 'yesimbot'

export class CustomAdapter implements Adapter {
  name = 'CustomAdapter'
  type = 'custom'
  priority = 5
  weight = 1

  async initialize(config: any): Promise<boolean> {
    // 初始化适配器
    return true
  }

  async sendRequest(prompt: string, options: ModelRequestOptions): Promise<ModelResponse> {
    // 实现请求逻辑
    const response = /* 发送请求到自定义 API */

    return {
      content: response,
      usage: {
        promptTokens: 0,
        completionTokens: 0,
        totalTokens: 0
      },
      raw: response
    }
  }
}

// 注册适配器
export function apply(ctx: Context) {
  const adapterSystem = ctx.yesimbot.adapterSystem
  adapterSystem.registerAdapter(new CustomAdapter())
}