Yash-Kavaiya/dsh-cxas

dsh-cxas

一个 DeepSeek Harness (DSH) 工具插件，将
CX Agent Studio Scripting API (CXAS SCRAPI)
命令行工具（cxas）封装为结构化的、面向模型的工具。它让 DSH
代理能够列出应用、拉取/推送应用、运行并导出评估、列出部署、
检查对话/追踪，以及与工具/回调/变量交互——
直接通过 cxas CLI 完成。

DeepSeek Harness 插件 · 类别：工具与能力 · 许可证：
Apache-2.0 · 使用 dsp CLI 安装：
dsp install dsh-cxas

它的功能

每个注册的工具都会构建一个 cxas  argv，在主机上将二进制文件作为
子进程运行，并返回一个规范化的结果，包含 exitCode、
stdout、stderr 和 command，以便模型能够推断失败原因
并继续执行。

| 工具 | 运行命令 |
|---|---|
| cxas_apps_list | cxas apps list |
| cxas_apps_get | cxas apps get  |
| cxas_create | cxas create  |
| cxas_delete | cxas delete  |
| cxas_pull | cxas pull  |
| cxas_push | cxas push |
| cxas_lint | cxas lint |
| cxas_deployments_list / cxas_deployments_create / cxas_deployments_promote | cxas deployments ... |
| cxas_run_eval | cxas run  |
| cxas_eval_report | cxas evals report |
| cxas_eval_export | cxas export  |
| cxas_push_eval | cxas push-eval  |
| cxas_conversations_list / cxas_conversations_get | cxas conversations ... |
| cxas_trace_list / cxas_trace_get | cxas trace ... |
| cxas_tools_list / cxas_tools_delete | cxas tools ... |
| cxas_callbacks_list | cxas callbacks list |
| cxas_variables_list | cxas variables list |
| cxas_help | cxas --help [topic] |
| cxas（透传） | 任意 cxas ... argv |

前提条件

1. 已安装 cxas-scrapi 并在 PATH 中：

pip install cxas-scrapi
cxas --help      # 验证其可运行

2. Google Cloud 应用默认凭据（或通过 SDK 使用服务账号
密钥）：

gcloud auth application-default login
gcloud config set project

挂载插件

需要重启。 如果 DSH Web 会话已在
http://127.0.0.1:3080 运行，你必须停止它，并使用 overlay 重新启动，以便
新工具出现。正在运行的服务器不会拾取新的 --patch。

方案 A — 快速 overlay（--patch）

从包含 dsh-cxas 的目录（例如工作区根目录）执行：

pnpm dsh web --patch C:/Users/yashk/Downloads/nvidia/NVIDIA-Nexus/dsh-cxas/cordis.yml
或者，如果 dsh 已安装（而非从源码运行）：
dsh web --patch C:/Users/yashk/Downloads/nvidia/NVIDIA-Nexus/dsh-cxas/cordis.yml

打开 http://127.0.0.1:3080，并让代理执行例如
“使用 cxas_apps_list 列出我项目中的应用。”如果端口 3080 已被
另一个实例占用，请添加 --port 3090 --no-open。
cordis.yml 中的插件 name 是一个 file:// URL——在 Windows 上，ESM
加载器会拒绝像 C:/... 这样的裸绝对路径。如果你移动了插件，
请更新 name，将其指向 src/index.ts 的 file:// URL。

方案 B——安装到 profile（bundle）

该包还声明了 dsh.bundle，因此可以永久安装：

dsh plugin --profile demo add ./dsh-cxas
dsh --profile demo

如果你从 git 安装，请参阅 发布 bundle 了解
构建脚本 / prepare 允许项的说明。

验证

一个独立的冒烟测试使用桩 tools 注册表驱动 apply()，并
检查插件是否注册了所有工具，以及 execute() 是否成功
调用真实的 cxas 二进制文件（无需 DSH 启动或凭据）：

from the deepseek-harness checkout root:
node --import tsx/esm C:/Users/yashk/Downloads/nvidia/NVIDIA-Nexus/dsh-cxas/test-load.mjs

预期：registered 24 tools、cxas_help exitCode=0，以及
cxas_apps_list、cxas_lint 和 cxas 透传的正确 argv。

配置

| 键 | 默认值 | 含义 |
|---|---|---|
| cxasBin | cxas | cxas 可执行文件的路径。 |
| project | — | 追加到接受该参数的命令的兜底 --project。 |
| location | — | 追加到接受该参数的命令的兜底 --location（例如 global）。 |
| timeoutMs | 120000 | 单次 cxas 调用的超时时间。 |

在你的 cordis.yml / cordis.patch.yml 的 config: 块中设置这些值。

注意事项与限制

- 该插件通过 shell 调用宿主机的 cxas 二进制文件；它不会自行捆绑或
向 Google Cloud 进行身份验证。
- 工具参数集是经过精选的子集。对于未映射的命令，请使用
cxas 透传工具（其 args 数组会原样传递），或者
先调用 cxas_help 以确认确切的标志。
- 映射的标志名称是针对当前 CLI 接口尽力而为的；如果某个标志
被拒绝，请查阅 cxas_help 并使用透传工具。

模型体验

间接地，通过它注册的工具 schema 体现：每个工具都会将其
名称、description 和参数 schema 贡献给组装后的系统提示词，并且
其 output.render 会生成面向模型的结果文本。除了工具目录本身之外，
不会注入额外的提示词部分。

KV 缓存影响

不会使可复用的前缀失效。该插件在启动时不添加任何请求前缀
内容；唯一对模型可见的文本是每次调用的工具描述和
结果内容，这取决于数据，且与先前的请求无关。