详细介绍

MemorySkill - ArkOps-Ai 对话记忆 Skill

基于向量检索的 ArkOps-Ai 对话记忆 Skill，使用 DashVector 和 qwen3-vl-embedding 模型实现玩家与 AI 对话的语义记忆功能。

功能特性

✅ 对话记忆保存 - 自动保存玩家与 AI 的对话记录
✅ 语义搜索 - 基于向量相似度检索相关对话
✅ 玩家筛选 - 按玩家名称筛选对话记录
✅ 时间戳记录 - 自动记录对话发生时间
✅ 1024维度向量 - 使用 qwen3-vl-embedding 生成高质量向量

快速开始

1. 环境要求

Java 21
PurpurMC 1.21.1
ArkOps-Ai 插件 v2.0.0+
DashVector 服务
阿里云 DashScope API Key

2. 配置

在 plugins/ArkOps-Ai/skills/MemorySkill/ 目录下创建 memory_config.properties：

# DashVector 配置
dashvector.api_key=YOUR_DASHVECTOR_API_KEY
dashvector.endpoint=YOUR_DASHVECTOR_CLUSTER_ENDPOINT
dashvector.collection=arkops_memory
dashvector.dimension=1024

# DashScope 配置
dashscope.api_key=YOUR_DASHSCOPE_API_KEY
dashscope.embedding_model=qwen3-vl-embedding

3. 编译部署

mvn clean package

将生成的 MemorySkill-3.0.0.jar 放入：

plugins/ArkOps-Ai/skills/

4. 重启服务器

启动服务器后检查日志：

[ArkOps-Ai] 已注册 Skill: Memory Skill v3.0.0 by DreamArk Studio

使用方法

保存对话

当玩家分享重要信息时，AI 可以调用：

{
  "tool": "save_conversation",
  "args": {
    "player": "Tan",
    "content": "我喜欢玩 Minecraft，特别是建筑和红石"
  }
}

获取对话记录

按玩家筛选

{
  "tool": "get_conversations",
  "args": {
    "player": "Tan",
    "limit": 5
  }
}

语义搜索

{
  "tool": "get_conversations",
  "args": {
    "query": "玩家喜欢什么游戏",
    "limit": 10
  }
}

组合搜索

{
  "tool": "get_conversations",
  "args": {
    "player": "Tan",
    "query": "建筑",
    "limit": 5
  }
}

字段说明

字段	类型	说明
`id`	STRING	自动生成的唯一标识符
`player`	STRING	玩家名称
`content`	STRING	对话内容
`time`	LONG	时间戳（毫秒）

技术架构

向量数据库: DashVector
嵌入模型: qwen3-vl-embedding (1024维度)
相似度算法: 余弦相似度
开发框架: ArkOps-Ai Skill API
构建工具: Maven

项目结构

MemorySkill/
├── src/main/java/com/dreamarkstudio/memoryskill/
│   └── MemorySkill.java          # 主实现类
├── pom.xml                       # Maven 配置
├── README.md                     # 项目文档
└── target/
    └── MemorySkill-3.0.0.jar     # 构建产物

开发信息

版本: 3.0.0
包名: com.dreamarkstudio.memoryskill
作者: DreamArk Studio
许可证: MIT

注意事项

确保 DashVector 服务正常运行
DashScope API Key 需要正确配置
向量维度固定为 1024，与嵌入模型匹配
对话内容会自动进行向量化处理
支持语义搜索和精确筛选

故障排除

常见问题

Skill 未注册
- 检查 jar 文件是否在正确目录
- 确认 ArkOps-Ai 插件版本兼容
向量生成失败
- 检查 DashScope API Key 配置
- 确认网络连接正常
数据库连接失败
- 检查 DashVector API Key 和 Endpoint
- 确认 Collection 是否存在

许可证

⚠️ 该 Skill 仍处于开发与内部测试阶段，暂未开放使用。

感谢您的关注，请耐心等待后续发布。

如果您对本项目感兴趣，可以联系 DreamArkMC@163.com 申请参加内测。

MemorySkill