mirror of
https://gitee.com/mateos/mateclaw.git
synced 2026-09-13 03:13:41 +08:00
141 lines
4.3 KiB
Java
141 lines
4.3 KiB
Java
package vip.mate.skill.model;
|
||
|
||
import com.baomidou.mybatisplus.annotation.*;
|
||
import lombok.Data;
|
||
|
||
import java.time.LocalDateTime;
|
||
|
||
/**
|
||
* 技能实体
|
||
* 技能实体：可扩展的功能模块
|
||
*
|
||
* @author MateClaw Team
|
||
*/
|
||
@Data
|
||
@TableName("mate_skill")
|
||
public class SkillEntity {
|
||
|
||
@TableId(type = IdType.ASSIGN_ID)
|
||
private Long id;
|
||
|
||
/** 技能名称 — immutable slug, used as primary identifier */
|
||
private String name;
|
||
|
||
/**
|
||
* RFC-042 §2.2 — locale-specific display name for zh-CN.
|
||
* {@code null} → UI falls back to {@code name}.
|
||
*/
|
||
@TableField(value = "name_zh", updateStrategy = FieldStrategy.ALWAYS)
|
||
private String nameZh;
|
||
|
||
/**
|
||
* RFC-042 §2.2 — locale-specific display name for en-US.
|
||
* {@code null} → UI falls back to {@code name}.
|
||
*/
|
||
@TableField(value = "name_en", updateStrategy = FieldStrategy.ALWAYS)
|
||
private String nameEn;
|
||
|
||
/** 技能描述 */
|
||
private String description;
|
||
|
||
/** 技能类型：builtin（内置）/ custom（自定义）/ mcp（MCP协议） */
|
||
private String skillType;
|
||
|
||
/** 技能图标（emoji 或 URL） */
|
||
private String icon;
|
||
|
||
/** 技能版本 */
|
||
private String version;
|
||
|
||
/** 技能作者 */
|
||
private String author;
|
||
|
||
/** 技能配置（JSON） */
|
||
@TableField(value = "config_json", updateStrategy = FieldStrategy.ALWAYS)
|
||
private String configJson;
|
||
|
||
/** 技能代码/脚本内容（旧字段，保留兼容） */
|
||
@TableField(value = "source_code", updateStrategy = FieldStrategy.ALWAYS)
|
||
private String sourceCode;
|
||
|
||
/**
|
||
* SKILL.md 完整内容 — 技能执行协议
|
||
* <p>
|
||
* 采用 SKILL.md 格式：YAML frontmatter + Markdown 正文。
|
||
* Agent 通过阅读此内容理解技能的用途、执行方式和注意事项。
|
||
* <p>
|
||
* 格式示例:
|
||
* <pre>
|
||
* ---
|
||
* name: pdf
|
||
* description: PDF 处理技能
|
||
* metadata: { "builtin_skill_version": "1.0" }
|
||
* ---
|
||
* # PDF Processing Guide
|
||
* ## Prerequisites
|
||
* ...（详细使用说明）
|
||
* </pre>
|
||
*/
|
||
@TableField(value = "skill_content", updateStrategy = FieldStrategy.ALWAYS)
|
||
private String skillContent;
|
||
|
||
/**
|
||
* RFC-090 Phase 2 — full parsed SKILL.md frontmatter as JSON.
|
||
* Source of truth (§14.6); existing columns (skill_type/icon/version/
|
||
* author) become index projections written by
|
||
* {@code SkillPackageResolver} after each resolve.
|
||
*/
|
||
@TableField(value = "manifest_json", updateStrategy = FieldStrategy.ALWAYS)
|
||
private String manifestJson;
|
||
|
||
/** 是否启用 */
|
||
private Boolean enabled;
|
||
|
||
/** 是否系统内置（不可删除） */
|
||
private Boolean builtin;
|
||
|
||
/** 标签（逗号分隔） */
|
||
private String tags;
|
||
|
||
/**
|
||
* Owning workspace. The DB column has existed since the baseline schema
|
||
* (default = 1) but the field was missing from the entity, so MyBatis
|
||
* Plus silently ignored both reads and writes. Surfacing it here lets
|
||
* binding-time tenancy checks see the value; default behavior on insert
|
||
* remains "fall through to the column DEFAULT" because the field stays
|
||
* {@code null} in the no-arg create path.
|
||
*/
|
||
private Long workspaceId;
|
||
|
||
/** 来源对话 ID（Agent 自治合成时记录） */
|
||
private String sourceConversationId;
|
||
|
||
/**
|
||
* RFC-023：安全扫描状态。
|
||
* NULL = 旧数据或手动创建（不受扫描约束），PASSED = 扫描通过，FAILED = 扫描拦截。
|
||
* listEnabledSkills 过滤条件：NULL 或 PASSED 才加载。
|
||
*/
|
||
private String securityScanStatus;
|
||
|
||
/**
|
||
* RFC-042 §2.3 — persisted JSON array of the last scan's findings
|
||
* ({@code [{ruleId,severity,category,title,description,filePath,
|
||
* lineNumber,snippet,remediation}]}). Populated by
|
||
* {@code SkillPackageResolver} after every scan so the admin UI can
|
||
* render "why blocked" without re-resolving.
|
||
*/
|
||
@TableField(value = "security_scan_result", updateStrategy = FieldStrategy.ALWAYS)
|
||
private String securityScanResult;
|
||
|
||
/** RFC-042 §2.3 — wall-clock time of the last scan write-back. */
|
||
private LocalDateTime securityScanTime;
|
||
|
||
@TableField(fill = FieldFill.INSERT)
|
||
private LocalDateTime createTime;
|
||
|
||
@TableField(fill = FieldFill.INSERT_UPDATE)
|
||
private LocalDateTime updateTime;
|
||
|
||
private Integer deleted;
|
||
}
|