superslash-rico/dsh-plugin-slashx-gateway ↗★ 0
dsh-plugin-slashx-gateway
DeepSeek Harness host bundle that implements slashx.request.v1 and slashx.response.v1
AI 분석
用于在 SlashX 中连接自建 HTTP 服务。适合需要处理长任务、视频生成或大文件处理的用户。安装必要条件为 Node.js 22.19+ 及含 ApiProxy 的 web profile。
설치
$
npx -p @deepseek-ai/dsh dsh plugin --profile web add github:superslash-rico/dsh-plugin-slashx-gatewaySlashX 连接配置
在 SlashX 中先使用“自建 HTTP 服务”连接：
- Endpoint：
https://harness.example.com/slashx-provider/v1/run - Auth：Bearer Token
- Secret：与
SLASHX_GATEWAY_TOKEN相同 - Async callback：建议开启，尤其是生成视频、处理大文件或长 Agent 任务时
- Timeout：同步任务应不小于 Gateway 的预期执行时长
能力探测：
curl -H "Authorization: Bearer $SLASHX_GATEWAY_TOKEN" \
https://harness.example.com/slashx-provider/v1/capabilities
健康检查：
curl https://harness.example.com/healthz
配置
| 环境变量 | 默认值 | 说明 |
|---|---|---|
SLASHX_GATEWAY_HOST | 127.0.0.1 | 仅支持 127.0.0.1 或显式的 0.0.0.0；生产推荐回环 + 反代 |
SLASHX_GATEWAY_PORT | 3090 | Gateway 端口 |
SLASHX_GATEWAY_TOKEN | 无 | 必填，至少 32 字符 |
SLASHX_GATEWAY_PUBLIC_BASE_URL | 无 | 本地生成物对 SlashX 可访问的 HTTPS Origin；未设置时仅能返回已有远程 URL |
SLASHX_GATEWAY_STATE_ROOT | 当前目录下 .deepseek-harness/slashx-gateway | 会话工作区、运行账本和制品目录 |
SLASHX_GATEWAY_AGENT_PRESET | Harness 默认 | 新 Session 使用的 Harness Agent Preset |
SLASHX_GATEWAY_REQUEST_TIMEOUT_MS | 300000 | 同步 Harness Turn 上限，1 秒到 1 小时 |
SLASHX_GATEWAY_MAX_REQUEST_BYTES | 16777216 | JSON 请求体上限 |
SLASHX_GATEWAY_MAX_MEDIA_BYTES | 26214400 | 单个输入媒体及单个输出制品上限 |
SLASHX_GATEWAY_MAX_TOTAL_MEDIA_BYTES | 52428800 | 单请求全部输入媒体上限 |
SLASHX_GATEWAY_MAX_CONVERSATION_BYTES | 1073741824 | 单个用户 + Agent + 会话工作区累计上限 |
SLASHX_GATEWAY_MAX_PRINCIPAL_BYTES | 5368709120 | 单个用户 + Agent 跨会话工作区累计上限 |
SLASHX_GATEWAY_MAX_WORKSPACE_BYTES | 21474836480 | 所有会话工作区累计上限 |
SLASHX_GATEWAY_MAX_ARTIFACT_STORE_BYTES | 2147483648 | 未过期签名制品累计字节上限 |
SLASHX_GATEWAY_MAX_STORED_ARTIFACTS | 10000 | 未过期签名制品数量上限 |
SLASHX_GATEWAY_MAX_ARTIFACT_BYTES_PER_RUN | 104857600 | 单个 run 可发布的本地制品累计上限 |
SLASHX_GATEWAY_MAX_ARTIFACTS_PER_RUN | 20 | 单个 run 可发布的本地制品数量上限 |
SLASHX_GATEWAY_ASSET_TTL_SECONDS | 86400 | 签名制品 URL 有效期 |
SLASHX_GATEWAY_MAX_CONCURRENT_RUNS | 4 | 同时执行的 Harness Turn 上限 |
SLASHX_GATEWAY_MAX_QUEUED_RUNS | 100 | 全局待执行 run 上限；超过后返回可重试的 GATEWAY_BUSY |
SLASHX_GATEWAY_MAX_RUN_LEDGER_ENTRIES | 100000 | 文件账本最多保留的 run 数；满额时拒绝新 run |
SLASHX_GATEWAY_MAX_RUN_LEDGER_ENTRIES_PER_PRINCIPAL | 10000 | 单个用户 + Agent 的账本上限，避免独占全局账本 |
SLASHX_GATEWAY_RUN_RETENTION_SECONDS | 2592000 | 已完成 run 的账本保留期；不自动删除结果不确定的 run |
SLASHX_GATEWAY_ALLOW_HTTP_MEDIA | 0 | 仅开发环境确有需要时设为 1 |
SLASHX_GATEWAY_PRIVATE_MEDIA_HOSTS | 空 | 逗号分隔的精确私网媒体域名白名单；不要填写通配符 |
SLASHX_GATEWAY_PUBLIC_BASE_URL 不能包含认证信息。生产环境应使用 HTTPS；HTTP 只用于
本机或受控开发环境。