注释
- 这是一项预览功能。
- 预览功能不适合生产使用且功能可能受限。 这些功能在正式发布之前可供使用，以便客户可以抢先体验并提供反馈。
本文介绍 Dataverse CLI 中提供的命令。 每个命令都支持列出 --help 其用法、选项和示例的选项。 返回数据的命令支持在 --json 脚本中有用的原始 JSON 输出选项。
以下全局选项可用于任何命令：
| 选项 | Description |
|---|---|
--log-level <level> |
设置日志记录级别：Trace、、Debug、InformationWarning、或ErrorCritical。 默认值：Warning。 |
--log-file |
登录到临时目录中的文件，而不是控制台。 |
--context <value> |
追加到 User-Agent 的操作上下文。 还可以设置 DATAVERSE_OPERATION_CONTEXT 环境变量。 |
| Command | Description |
|---|---|
api describe |
描述 API |
api invoke |
按名称调用 API |
api list |
列出可发现 API |
api request |
发送经过身份验证的 HTTP 请求 |
auth create |
创建新的身份验证配置文件 |
auth list |
列出所有身份验证配置文件 |
auth remove |
删除身份验证配置文件 |
auth select |
选择活动身份验证配置文件 |
auth who |
显示当前身份验证配置文件 |
data associate |
通过关系链接两条记录 |
data count |
对表中的记录进行计数 |
data create |
创建新记录 |
data delete |
删除记录 |
data describe |
描述实体的架构 |
data disassociate |
删除两条记录之间的关系 |
data get |
按 ID 或备用键检索单个记录 |
data query |
执行 OData、FetchXML 或 SQL 查询 |
data update |
更新现有记录 |
data upload |
将文件上传到现有记录上的文件列 |
data upsert |
通过备用键创建或更新记录 |
erp batch cancel |
取消财务和运营批处理作业 |
erp batch list |
列出财务和运营批处理作业 |
install |
安装特定版本或更新到最新版本 |
mcp |
启动 Dataverse 或 ERP 的 MCP 服务器 |
mcp allow |
允许将应用作为 MCP 客户端 |
org list |
列出所有可访问的环境 |
org who |
显示当前组织和用户信息 |
skill delete |
从 Dataverse 中删除技能 |
skill download |
从 Dataverse 下载技能 |
skill list |
列出环境中的活动技能 |
skill upload |
将技能上传到 Dataverse |
注释
许多命令支持将 --target <dataverse\|erp> 操作路由到 Dataverse（默认值）或链接的 Finance and Operations （ERP） 环境的选项。 连接到环境的命令支持 --environment <url> （-env） 选项来替代当前配置文件的环境 URL。
api describe 命令
显示单个 API 的元数据。 对于 Dataverse 自定义 API，输出在元数据提供时包括请求参数和响应属性说明。
默认情况下，Dataverse 名称不推荐使用。 可以在窗体 erp:ServiceGroup/Service/Operation中使用 ERP 限定的名称。
api describe 参数
| Parameter | Description |
|---|---|
--target |
根据 dataverse 或 erp. 解析不限定的名称。 |
--service-group |
仅 ERP。 将操作查找范围缩小到一个服务组。 |
--service |
仅 ERP。 将操作查找范围缩小到一个服务。 |
--environment |
重写 Dataverse 环境 URL。 |
--json |
输出原始 JSON。 |
api describe 示例
dataverse api describe sample_CustomAPIExample
dataverse api describe msdyn_DoesKBExist
dataverse api describe GetUserSessionInfo --target erp --service-group UserSessionService --service AifUserSessionService
api invoke 命令
按名称调用发现的 API。 对参数使用 name=value 语法。 如果值包含空格，请引用整个标记。 某些 Dataverse API 接受其内容本身为 JSON 的字符串参数。 在这种情况下，请使用 shell 的正常引用和转义规则将 JSON 文本作为值传递。
默认情况下，JSON 响应以友好文本格式呈现，保留输出属性名称。 用于 --json 保留原始 JSON 有效负载。
api invoke 参数
| Parameter | Description |
|---|---|
--target |
根据 dataverse 或 erp. 解析不限定的名称。 |
--service-group |
仅 ERP。 将操作查找范围缩小到一个服务组。 |
--service |
仅 ERP。 将操作查找范围缩小到一个服务。 |
--param |
以 name=value 窗体形式添加命名参数。 重复。 |
--bind |
实体绑定 Dataverse API 的绑定路径。 |
--method、-X |
重写推断的 HTTP 方法。 |
--body |
使用原始 JSON 正文而不是命名参数。 |
--body-file |
从文件读取原始 JSON 正文。 |
--header、-H |
在 key:value 窗体中添加 HTTP 标头。 |
--include、-i |
包括响应状态和标头。 |
--environment |
重写 Dataverse 环境 URL。 |
--json |
输出原始 JSON 而不是友好文本。 |
api invoke 示例
调用 Dataverse 函数。 此示例演示如何使用 Dynamics 365 Contact Center CCaaS_GetPresence 函数。
dataverse api invoke CCaaS_GetPresence ApiVersion=1.0
使用参数值中的空格调用 Dataverse AISummarize 操作 ：
dataverse api invoke AISummarize "Text=The customer reported intermittent login failures..."
调用 ERP 自定义服务：
dataverse api invoke GetUserSessionInfo --target erp --service-group UserSessionService --service AifUserSessionService
api list 命令
列出可发现 API，例如 Dataverse 自定义 API 和 ERP 可调用的服务终结点。 结果显示 API 标识、友好名称、种类和说明（如果可用）。 可以传递可选查询词来筛选结果。
api list 参数
| Parameter | Description |
|---|---|
--target |
要搜索的目标系统： dataverse （默认）或 erp。 |
--service-group |
仅 ERP。 筛选为单个服务组。 |
--service |
仅 ERP。 筛选为单个服务。 |
--limit |
要返回的最大 API 数。 默认值：50。 |
--page |
分页结果时，基于 1 的页码。 默认值：1。 |
--environment |
重写 Dataverse 环境 URL。 |
--json |
输出原始 JSON。 |
api list 示例
dataverse api list
dataverse api list invoice --target dataverse
dataverse api list --target erp GetUserSessionInfo
dataverse api list --target erp --service-group UserSessionService --service AifUserSessionService
api request 命令
将经过身份验证的原始 HTTP 请求发送到 Dataverse 或 ERP。 当需要完全控制路径、方法、标头和正文时，请使用此命令。
api request 参数
| Parameter | Description |
|---|---|
--target |
目标系统： dataverse 或 erp。 必填。 |
--path |
请求路径。 必填。 |
--method、-X |
HTTP 方法。 默认值： GET或 POST 提供正文时。 |
--body |
内联 JSON 请求正文。 |
--body-file |
包含 JSON 对象请求正文的文件。 |
--header、-H |
在 key:value 窗体中添加 HTTP 标头。 |
--include、-i |
包括响应状态和标头。 |
--environment |
重写 Dataverse 环境 URL。 |
api request 示例
dataverse api request --target dataverse --path /api/data/v9.2/sample_CustomAPIExample --body "{\"Input\":\"value\"}"
dataverse api request --target erp --path /api/services/UserSessionService/AifUserSessionService/GetUserSessionInfo --body "{}"
auth create 命令
创建新的身份验证配置文件。
auth create 参数
使用这些参数指定命令的行为 auth create 。
| Parameter | Description |
|---|---|
--environment、-env |
要进行身份验证的 Dataverse 环境的 URL。 |
--name、-n |
配置文件的可选名称。 稍后使用名称选择配置文件。 |
--cloud、-ci |
目标云：Public、、UsGovUsGovHigh或UsGovDodChina。 |
--deviceCode、-dc |
对于没有浏览器的环境，请使用设备代码身份验证流。 |
--username、-un |
用户名和密码身份验证的用户名。 |
--password、-p |
用户名和密码身份验证的密码。 |
--applicationId、-id |
服务主体（SPN）身份验证的应用程序（客户端）ID。 |
--clientSecret、-cs |
用于服务主体身份验证的客户端机密。 |
--certificateDiskPath、-cdp |
用于基于证书的身份验证 的 .pfx 证书文件的路径。 |
--certificatePassword、-cp |
证书的密码。 |
--tenant、-t |
租户 ID。 服务主体身份验证所必需的。 |
--managedIdentity、-mi |
使用Azure托管标识。 |
--githubFederated、-ghf |
使用GitHub Actions联合身份验证。 |
--azureDevOpsFederated、-adof |
使用Azure DevOps联合身份验证。 |
--clientid、-cid |
要使用的自定义Microsoft Entra应用客户端 ID，而不是默认的 Dataverse CLI 应用。 |
--no-default-environment |
不要将环境设置为默认值。 |
--accept-cleartext-caching |
允许 Linux 上的纯文本令牌缓存。 |
auth create 示例
以下示例演示如何使用 auth create 命令。
交互式身份验证
此命令将打开浏览器或系统对话框以获取其他信息。
dataverse auth create --environment https://myorg.crm.dynamics.com
命名配置文件
创建具有特定名称的配置文件。
dataverse auth create --environment https://myorg.crm.dynamics.com --name prod
设备代码流
将设备代码流用于没有浏览器的环境。
dataverse auth create --environment https://myorg.crm.dynamics.com --deviceCode
具有客户端机密的服务主体
如果需要无人参与身份验证，例如在 CI/CD 管道或其他自动化脚本中，无法进行交互式登录，请使用服务主体。 提供有权访问环境的应用注册的应用程序 ID、客户端密码和租户 ID。
dataverse auth create --applicationId <appId> --clientSecret <secret> --tenant <tenantId>
自定义 Entra 应用客户端 ID
使用自己的应用注册，而不是默认应用注册。
dataverse auth create --environment https://myorg.crm.dynamics.com --clientid <your-app-guid>
auth list 命令
列出所有身份验证配置文件。
--json添加原始 JSON 输出。
auth list 示例
dataverse auth list
dataverse auth list --json
auth remove 命令
删除一个或多个身份验证配置文件。
auth remove 参数
| Parameter | Description |
|---|---|
--index、-i |
删除具有指定基于 1 的索引的配置文件，如中 auth list所示。 |
--name、-n |
删除具有指定名称的配置文件。 |
--all |
删除所有配置文件。 |
auth remove 示例
dataverse auth remove --index 1
dataverse auth remove --name prod
dataverse auth remove --all
auth select 命令
选择活动身份验证配置文件。 在没有选项的情况下运行命令以列出所有配置文件。
auth select 参数
| Parameter | Description |
|---|---|
--index、-i |
按基于 1 的索引选择配置文件，如中 auth list所示。 |
--name、-n |
按名称选择配置文件。 |
auth select 示例
打开交互式选取器。 使用箭头键或类型筛选：
dataverse auth select
按索引或名称选择配置文件：
dataverse auth select --index 1
dataverse auth select --name prod
auth who 命令
显示当前活动身份验证配置文件。
--json添加原始 JSON 输出。
auth who 示例
dataverse auth who
dataverse auth who --json
data associate 命令
通过导航属性（关系）关联两条记录。 仅 Dataverse 支持此命令。
data associate 参数
| Parameter | Description |
|---|---|
--table、-t |
主记录的实体集名称。 必填。 |
--id、-i |
主记录的 GUID。 必填。 |
--relationship、-rel |
导航属性名称。 必填。 |
--related |
相关表的实体集名称。 必填。 |
--related-id |
相关记录的 GUID。 必填。 |
--environment、-env |
重写环境 URL。 |
--json |
输出原始 JSON。 |
data associate 示例
dataverse data associate --table accounts --id <guid> --relationship contact_customer_accounts --related contacts --related-id <related-guid>
data count 命令
对表中的记录进行计数，可以选择进行筛选。
data count 参数
| Parameter | Description |
|---|---|
--table、-t |
实体集名称。 必需，除非使用 --fetchxml。 |
--filter、-f |
OData $filter 表达式。 |
--fetchxml |
复杂计数的 FetchXML 聚合查询。 |
--target |
路由到 dataverse （默认）或链接 erp 环境。 |
--cross-company |
仅 ERP。 在所有公司中计数。 默认值：用户的默认公司。 |
--environment、-env |
重写环境 URL。 |
--json |
输出原始 JSON。 |
data count 示例
dataverse data count --table accounts
dataverse data count --target erp --table Currencies --filter "CurrencyCode eq 'AED'"
data create 命令
在 Dataverse 表中创建新记录。 使用 @odata.bind 语法设置查阅列。
data create 参数
| Parameter | Description |
|---|---|
--table、-t |
实体集名称。 必填。 |
--data、-d |
包含字段值的 JSON 对象。 |
--data-file |
包含记录数据的 JSON 文件的路径。 |
--return、-r |
返回完整创建的记录。 |
--target |
路由到 dataverse （默认）或链接 erp 环境。 |
--environment、-env |
重写环境 URL。 |
--json |
输出原始 JSON。 |
data create 示例
dataverse data create --table accounts --data '{"name":"Contoso"}'
dataverse data create --table contacts --data '{"firstname":"Alice","parentcustomerid_account@odata.bind":"accounts(<guid>)"}'
Tip
用于 --data-file 复杂的 JSON。 用于 --return --json 获取完整创建的记录。
data delete 命令
通过主键或备用键删除单个记录。
data delete 参数
| Parameter | Description |
|---|---|
--table、-t |
实体集名称。 必填。 |
--id、-i |
记录 GUID。 |
--key、-k |
备用键。 |
--no-confirm |
跳过确认提示。 |
--target |
路由到 dataverse （默认）或链接 erp 环境。 |
--environment、-env |
重写环境 URL。 |
--json |
输出原始 JSON。 |
data delete 示例
dataverse data delete --table accounts --id 00000000-0000-0000-0000-000000000001 --no-confirm
data describe 命令
描述 OData 实体的架构。 对于 Dataverse，命令使用驱动调用EntityDefinitions(LogicalName='<table>')，以及设置时--include actions的第二次调用customapis。$expand--include 内置 Dataverse 操作（例如 Assign 且 SetState 未枚举）。 对于 ERP，单个调用将 /Metadata/PublicEntities 属性、绑定操作和导航一起返回。
data describe 参数
| Parameter | Description |
|---|---|
--target |
目标： dataverse （默认值）或 erp。 |
--table、-t |
必填。 对于 Dataverse，逻辑名称，例如 account。 对于 ERP，实体集名称，例如 BatchJobs。 |
--include |
要包括、entity、properties、actionsrelations或all的节的逗号分隔列表。 别名： attributes=properties， 。 relationships=relations ERP 的默认值： all. Dataverse 的默认值： entity,properties。 |
--json |
输出原始 JSON。 |
data describe 示例
dataverse data describe --table account
dataverse data describe --target dataverse --table account --include all
dataverse data describe --target erp --table BatchJobs
data disassociate 命令
删除两条记录之间的关系。 仅 Dataverse 支持此命令。
data disassociate 参数
| Parameter | Description |
|---|---|
--table、-t |
主记录的实体集名称。 必填。 |
--id、-i |
主记录的 GUID。 必填。 |
--relationship、-rel |
导航属性名称。 必填。 |
--related-id |
相关记录的 GUID，用于多对多关系。 省略此参数以清除查找。 |
--environment、-env |
重写环境 URL。 |
--json |
输出原始 JSON。 |
data disassociate 示例
dataverse data disassociate --table accounts --id <guid> --relationship contact_customer_accounts --related-id <related-guid>
data get 命令
按其 ID（主键）或备用键检索单个记录。
data get 参数
| Parameter | Description |
|---|---|
--table、-t |
实体集名称。 必填。 |
--id、-i |
记录 GUID （主键）。 |
--key、-k |
例如 "col='val'"，备用键。 |
--select、-s |
以逗号分隔的列列表（$select）。 |
--expand、-x |
相关记录的 OData $expand 表达式。 |
--target |
路由到 dataverse （默认）或链接 erp 环境。 |
--environment、-env |
重写环境 URL。 |
--json |
输出原始 JSON。 |
data get 示例
dataverse data get --table accounts --id 00000000-0000-0000-0000-000000000001
dataverse data get --target erp --table Currencies --key "CurrencyCode='AED'" --select "CurrencyCode,Name"
data query 命令
对 Dataverse 表执行 OData、FetchXML 或 SQL 查询。
data query 参数
| Parameter | Description |
|---|---|
--table、-t |
要查询的实体集名称。 OData 查询所必需的。 |
--select、-s |
以逗号分隔的列列表（$select）。 |
--filter、-f |
OData $filter 表达式。 |
--orderby、-o |
OData $orderby 表达式。 |
--top |
要返回的最大记录数（1-5000）。 |
--expand、-x |
相关记录的 OData $expand 表达式。 |
--fetchxml |
内联 FetchXML 查询。 |
--fetchxml-file |
包含 FetchXML 查询的文件的路径。 |
--sql |
SQL SELECT 查询（预览版）。 |
--sql-file |
包含 SQL 查询的文件的路径。 |
--all、-a |
按照分页检索所有记录。 |
--max-records |
使用 --all时要检索的最大记录数。 默认值：100000。 |
--target |
路由到 dataverse （默认）或链接 erp 环境。 |
--cross-company |
仅 ERP。 跨所有公司进行查询。 默认值：用户的默认公司。 |
--environment、-env |
重写环境 URL。 |
--json |
输出原始 JSON。 |
data query 示例
dataverse data query --table accounts --select "name,revenue" --filter "revenue gt 1000000"
dataverse data query --fetchxml "<fetch><entity name='account'><attribute name='name'/></entity></fetch>"
dataverse data query --sql "SELECT name, revenue FROM account WHERE revenue > 1000000"
dataverse data query --target erp --table Currencies --select "CurrencyCode,Name" --top 10
了解详细信息
data update 命令
更新现有记录上的一个或多个字段，这些字段由其 ID 或备用键标识。 使用 @odata.bind 语法设置查阅列。
data update 参数
| Parameter | Description |
|---|---|
--table、-t |
实体集名称。 必填。 |
--id、-i |
记录 GUID。 |
--key、-k |
备用键。 |
--data、-d |
包含要更新的字段的 JSON 对象。 |
--data-file |
包含更新数据的 JSON 文件的路径。 |
--return、-r |
返回完整更新的记录。 |
--target |
路由到 dataverse （默认）或链接 erp 环境。 |
--environment、-env |
重写环境 URL。 |
--json |
输出原始 JSON。 |
data update 示例
dataverse data update --table accounts --id 00000000-0000-0000-0000-000000000001 --data '{"name":"Contoso (updated)"}'
data upload 命令
将本地文件上传到现有记录上的 Dataverse 文件列。 除非指定 --mode，否则此命令会根据文件大小自动选择单个请求或分块上传。 在自动模式下，128 MB 以下的文件在单个请求中上传，较大的文件使用分块上传。 省略 --mime-type时，该命令会从文件扩展名推断 MIME 类型。 未知扩展默认为 application/octet-stream.
data upload 参数
| Parameter | Description |
|---|---|
--table、-t |
表架构或逻辑名称，例如 account。 必填。 该命令从元数据解析实体集。 |
--id、-i |
记录 GUID。 必填。 |
--column、-c |
文件列属性名称。 必填。 |
--file、-f |
本地文件的路径。 必填。 |
--mode、-m |
上传策略： auto （默认值）， small或 chunk。 |
--mime-type |
显式 MIME 类型。 默认值：从文件扩展名推断。 |
--overwrite |
覆盖现有文件。 默认情况下，如果列不为空，命令将失败。 |
--environment、-env |
重写环境 URL。 |
--json |
输出原始 JSON。 |
data upload 示例
dataverse data upload --table account --id <guid> --column new_document --file report.pdf
dataverse data upload -t account -i <guid> -c new_document -f photo.jpg --overwrite
dataverse data upload -t account -i <guid> -c new_document -f big.bin --mode chunk
data upsert 命令
如果记录不存在，则创建记录;如果不存在，请对其进行更新。 记录由备用键标识。 了解如何使用备用键引用记录
data upsert 参数
| Parameter | Description |
|---|---|
--table、-t |
实体集名称。 必填。 |
--key、-k |
备用键。 必填。 |
--data、-d |
包含字段值的 JSON 对象。 |
--data-file |
JSON 文件的路径。 |
--update-only |
如果记录不存在（If-Match: *则失败）。 |
--create-only |
如果记录已存在（If-None-Match: *），则失败。 |
--return、-r |
返回操作后的完整记录。 |
--target |
路由到 dataverse （默认）或链接 erp 环境。 |
--environment、-env |
重写环境 URL。 |
--json |
输出原始 JSON。 |
data upsert 示例
dataverse data upsert --table accounts --key "accountnumber='ACC-100'" --data '{"name":"Contoso"}'
erp batch cancel 命令
按其 RecId取消财务和运营批处理作业。 用于 erp batch list 查找 RecId.
erp batch cancel 示例
dataverse erp batch cancel <recid>
erp batch list 命令
列出链接到 Dataverse 环境的 Finance 和 Operations 实例上的批处理作业。 该命令需要连接到具有链接财务和操作实例的 Dataverse 环境的身份验证配置文件。 财务和操作 URL 从当前 Dataverse 连接自动派生。
erp batch list 参数
| Parameter | Description |
|---|---|
--company |
按法律实体（dataAreaId例如 USMF）进行筛选。 |
--status |
按状态筛选：Waiting、、FinishedExecuting、Error或Cancelled。 |
--top |
要返回的最大结果数。 默认值：20。 |
--caption |
按标题进行筛选（不区分大小写的子字符串匹配）。 |
--json |
输出原始 JSON。 |
erp batch list 示例
dataverse erp batch list
dataverse erp batch list --status Waiting
dataverse erp batch list --status Executing --top 20
install 命令
安装 Dataverse CLI 的特定版本，或更新到最新版本。 该命令可检测是全局安装的还是正在使用 npx 并相应地安装 CLI。
install 示例
安装最新版本：
dataverse install latest
安装特定版本：
dataverse install 1.0.0
mcp 命令
启动连接到环境的模型上下文协议 （MCP） 服务器，以便 Claude Desktop 等 AI 助手可以与数据交互。 从 URL 自动检测目标：Dataverse URL 启动 Dataverse MCP 服务器，财务和运营 URL（例如 https://myorg.operations.dynamics.com，启动 ERP MCP 服务器）。
mcp 语法
dataverse mcp <orgUrl> [options]
参数 <orgUrl> 是组织 URL，例如 https://myorg.crm.dynamics.com。
mcp 参数
| Parameter | Description |
|---|---|
--validate |
在不启动服务器的情况下验证 MCP 终结点和身份验证设置。 |
--log-level |
设置日志记录级别：Trace、、Debug、InformationWarning、或ErrorCritical。 默认值：Warning。 |
--log-file |
登录到临时目录中的文件。 |
--preview |
使用预览 MCP 终结点（api/mcp_preview 而不是 api/mcp）。 ERP 不支持。 |
mcp 示例
验证设置（建议的第一步）：
dataverse mcp https://myorg.crm.dynamics.com --validate
使用 stdio 传输启动服务器：
dataverse mcp https://myorg.crm.dynamics.com
使用预览终结点，或启用调试文件日志记录：
dataverse mcp https://myorg.crm.dynamics.com --preview
dataverse mcp https://myorg.crm.dynamics.com --log-level Debug --log-file
mcp allow 命令
确保Microsoft Entra应用程序位于 Dataverse MCP 中，允许当前配置文件环境的客户端列表。 此命令是 先决条件中所述的手动管理员步骤的替代方法。 经过身份验证的用户必须在目标环境中拥有 Dataverse 管理员权限。
mcp allow 语法
dataverse mcp allow <appId> [options]
参数 <appId> 是允许作为 GUID 的应用程序（客户端）ID。
mcp allow 参数
| Parameter | Description |
|---|---|
--erp |
允许链接的 Finance 和 Operations 实例上的应用程序，而不是 Dataverse。 |
mcp allow 示例
dataverse mcp allow 0c412cc3-0dd6-449b-987f-05b053db9457
dataverse mcp allow 0c412cc3-0dd6-449b-987f-05b053db9457 --erp
注释
财务和运营会缓存 AOS 中的允许列表，因此新允许的应用 ID 最多可能需要五分钟才能生效。
org list 命令
列出可以访问的所有环境。
org list 参数
| Parameter | Description |
|---|---|
--filter |
按搜索词筛选环境列表。 |
--json |
输出原始 JSON。 |
org list 示例
dataverse org list
dataverse org list --filter contoso
dataverse org list --json
org who 命令
使用活动身份验证配置文件显示有关当前组织和用户的信息。 该 env 命令是 . 的 org别名。
org who 参数
| Parameter | Description |
|---|---|
--environment、-env |
重写环境 URL。 |
--json |
输出原始 JSON。 |
org who 示例
dataverse org who
dataverse org who --environment https://myorg.crm.dynamics.com
dataverse org who --json
skill 命令
管理存储在连接环境中的 Dataverse 技能（可重用指令集（ SKILL.md 文件和其资源文件）AI 代理使用。 顶级 skill 命令针对环境提供创建、读取、更新和删除操作。 在本地，技能存储在以下 .claude/skills/<name>/。
注释
技能创作和评估命令（例如make，update和geteval）独立于这些命令。 有关详细信息，请运行 dataverse workspace skill --help。
skill delete 命令
从活动 Dataverse 环境中删除技能及其所有资源。 用于 skill list 查找技能唯一名称。
dataverse skill delete new_lead-qualification
skill download 命令
将一个或多个技能从活动 Dataverse 环境下载到磁盘。 该命令下载 SKILL.md 文件和所有资源文件，保留目录结构。 用于 skill list 查找技能唯一名称。
| Parameter | Description |
|---|---|
--all |
从环境中下载所有活动技能。 不能与技能唯一名称结合使用。 |
--output、-o |
输出的基目录。 默认值：.claude/skills/。 其中 --all，每个技能都写入 <path>/<name>/其中。 |
--json |
将技能内容输出为 JSON，而无需写入文件。 （可选）指定要写入的文件路径。 |
dataverse skill download new_lead-qualification
dataverse skill download --all --output ./skills
skill list 命令
列出连接的 Dataverse 环境中的所有活动技能。
| Parameter | Description |
|---|---|
--resources、-r |
此外，列出每个技能的资源文件。 |
--json |
输出为 JSON。 （可选）指定要写入的文件路径。 |
dataverse skill list
dataverse skill list --resources
skill upload 命令
将一个或多个技能从磁盘上传到活动 Dataverse 环境。 该命令支持目录、 .zip 文件、 .skill 文件和 .md 文件。
可以将解析为.claude/skills/<name>/或显式<path>传递给目录或文件的技能<name>。
| Parameter | Description |
|---|---|
--all |
上传所有技能。.claude/skills/ 不能与技能名称或路径结合使用。 |
--json |
将结果输出为 JSON。 （可选）指定要写入的文件路径。 |
dataverse skill upload lead-qualification
dataverse skill upload ./my-skill.zip
dataverse skill upload --all