# 配置

## 修改 profile 默认参数

本包在 profile 中插入 id 为 `adaptive-max-tokens` 的插件行。需要覆盖参数时，在该 profile 的 `cordis.patch.yml` 中增加：

```yaml
- id: adaptive-max-tokens
  config:
    maxOutputTokens: 384000
    effectiveContextWindow: 1000000
    safetyTokens: 32768
    minOutputTokens: 16384
    pendingWeight: 1
    log: true
```

DSH 对插件行的 `config` 整体替换，请保留所有需要的键。`maxOutputTokens` 可省略，此时使用当前适配器的默认值；其余模块级默认值分别为 1,000,000、16,000、16,000、1、true。安装包显式设置的是上方日常使用参数。

参数必须为有效整数，`pendingWeight` 是至少为 1 的有限数值，`log` 必须为布尔值。`safetyTokens` 必须小于配置的上下文窗口；若指定 `maxOutputTokens`，它不得小于 `minOutputTokens`。

窗口和输出上限应按实际使用的模型配置。插件读取适配器声明的上限，不会向服务器查询真实硬容量。

## 按预设启用

默认 bundle 对整个 profile 生效。如只想用于特定自定义预设：

1. 安装本包以提供可解析的模块。
2. 在 profile 自己的 `cordis.patch.yml` 中禁用 bundle 插入的全局行：

   ```yaml
   - id: adaptive-max-tokens
     disabled: true
   ```

3. 将以下插件行加入目标自定义预设的 **agent 插件列表**（替换该预设中原有的手动版本）。它是插件行，不是另一个顶层 bundle patch：

   ```yaml
   - id: adaptive-max-tokens
     name: dsh-adaptive-max-tokens
     config:
       maxOutputTokens: 384000
       effectiveContextWindow: 1000000
       safetyTokens: 32768
       minOutputTokens: 16384
       pendingWeight: 1
       log: true
   ```

两个支持版本的自定义预设存放方式不同，请沿用自己实例现有的预设结构，不要直接改 DSH 安装目录里的官方预设。同一 agent 只启用一份本插件。

配置保存后，在任务空闲时重启对应实例并开始新会话。正在进行的会话可能保留旧预设。

## 如何确认生效

默认日志包含 `[adaptive-max-tokens] armed:`。发生输出预算或路由变化时，会记录 `maxTokens`、`ceiling`、输入估算和 `budget`。日志并非每次请求都重复打印。

更可靠的依据是新会话实际请求记录里的 `maxTokens`。短会话保持模型原有上限属于正常行为；只有剩余预算不足时才收缩。

本插件不修改官方压缩设置。若官方压力阈值提前触发压缩，它仍会照常执行。

参考：[DSH 官方打包与配置层说明](https://github.com/deepseek-ai/deepseek-harness/blob/master/docs/user/develop/basic/publish.md)。