配置

环境变量（推荐）

export CLS_ENDPOINT=ap-guangzhou.cls.tencentcs.com
export CLS_TOPIC_ID=your-topic-id
export CLS_SERVICE_NAME=dsh-agent

### 插件配置文件

编辑 `$DSH_HOME/profiles/
/cordis.patch.yml`：

```yaml
- id: cls-observability
  config:
    endpoint: ap-guangzhou.cls.tencentcs.com
    topicId: your-topic-id
    # 强鉴权：SecretId + SecretKey
    secretId: your-secret-id
    secretKey: your-secret-key
    # 或免鉴权（弱鉴权）：仅提供纯数字 UIN（与 SecretId/SecretKey 二选一）
    # uin: "100000000000"
    serviceName: dsh-agent
    captureContent: true
    batchMaxSize: 32
    flushIntervalMs: 5000
    debug: false

显式插件配置优先于环境变量。

配置项

设置	默认值	说明
`enabled`	`true`	禁用采集但不卸载插件
`endpoint`	`CLS_ENDPOINT`	CLS API 接入点
`topicId`	`CLS_TOPIC_ID`	CLS 日志主题 ID
`secretId`	`CLS_SECRET_ID`	腾讯云 SecretId（强鉴权，与 `uin` 二选一）
`secretKey`	`CLS_SECRET_KEY`	腾讯云 SecretKey（强鉴权，与 `uin` 二选一）
`uin`	`CLS_UIN`	免鉴权（弱鉴权）上报的腾讯云 UIN（纯数字，与 SecretId/SecretKey 二选一）
`serviceName`	`deepseek-harness`	服务名
`captureContent`	`true`	捕获 prompts/responses/tool 内容（设为 `false` 关闭）
`contentMaxChars`	`128000`	单个内容属性最大字符数
`batchMaxSize`	`32`	每批上报最大 span 数
`maxBatchBytes`	`10485760`	每批上报最大字节数（10MB）。必须小于 SDK 的 19MB 硬限制，否则整批会在本地被拒
`maxQueueSize`	`2048`	队列上限，超限丢弃最旧 span
`flushIntervalMs`	`5000`	定时刷新间隔（毫秒）
`retryTimes`	`3`	上报重试次数
`debug`	`false`	启用调试日志

tencentcloud-agentobs-sdk-dsh

安裝

說明文件

配置

环境变量（推荐）

配置项