数据模型

ActionResultModel

所有 Action 执行的标准化结果，底层为通过 PyO3 暴露的 Rust 结构体。

字段

字段	类型	默认值	说明
`success`	`bool`	`True`	执行是否成功
`message`	`str`	`""`	人类可读的结果描述
`prompt`	`Optional[str]`	`None`	给 AI 的下一步建议
`error`	`Optional[str]`	`None`	`success` 为 `False` 时的错误消息
`context`	`Dict[str, Any]`	`{}`	附加上下文数据

方法

方法	返回值	说明
`with_error(error)`	`ActionResultModel`	创建带错误信息的副本（设置 `success=False`）
`with_context(**kwargs)`	`ActionResultModel`	创建带更新上下文的副本
`to_dict()`	`Dict[str, Any]`	转换为字典

工厂函数

python

from dcc_mcp_core import success_result, error_result, from_exception, validate_action_result

# 带上下文的成功结果
result = success_result("创建了 5 个球体", prompt="使用 modify_spheres", count=5)

# 带可能解决方案的错误结果
error = error_result(
    "失败", "文件未找到",
    prompt="检查路径",
    possible_solutions=["确认文件存在", "检查权限"],
    path="/bad/path",
)

# 从异常字符串创建
exc_result = from_exception(
    "ValueError: bad input",
    message="导入失败",
    include_traceback=True,
)

# 验证/规范化任意值为 ActionResultModel
validate_action_result(result)                          # 直接通过
validate_action_result({"success": True, "message": "OK"})  # dict → ARM
validate_action_result("hello")                         # 包装为成功结果

SkillMetadata

从 SKILL.md 前置元数据解析的元数据。所有字段可读可写。

字段

字段	类型	默认值	说明
`name`	`str`	—	唯一标识符
`description`	`str`	`""`	人类可读描述
`tools`	`List[str]`	`[]`	所需工具权限
`dcc`	`str`	`"python"`	目标 DCC 应用
`tags`	`List[str]`	`[]`	分类标签
`scripts`	`List[str]`	`[]`	发现的脚本文件路径
`skill_path`	`str`	`""`	技能包目录的绝对路径
`version`	`str`	`"1.0.0"`	技能版本
`depends`	`List[str]`	`[]`	依赖的技能名称
`metadata_files`	`List[str]`	`[]`	metadata/ 目录中的文件

数据模型 ​

ActionResultModel ​

字段 ​

方法 ​

工厂函数 ​

SkillMetadata ​

字段 ​

数据模型

ActionResultModel

字段

方法

工厂函数

SkillMetadata

字段