TansrConfig

type TansrConfig = {
  $schemaVersion: 1;
  audit?: {
     dir?: string;
     enabled?: boolean;
  };
  budget?: {
     maxTotalTokens?: number;
     maxUsd?: number;
     onExceeded: "block" | "warn";
  };
  effort?: "max" | "low" | "medium" | "high";
  fallbacks: Record<string, string[]>;
  hooks?: {
     allowManagedHooksOnly?: boolean;
     disableAllHooks?: boolean;
     PermissionDenied?: {
        hooks: (
           | {
           command: ...[];
           timeoutMs?: ... | ...;
           type: "command";
         }
           | {
           headers?: ... | ...;
           timeoutMs?: ... | ...;
           type: "http";
           url: string;
        })[];
        matcher?: string;
     }[];
     PermissionRequest?: {
        hooks: (
           | {
           command: ...[];
           timeoutMs?: ... | ...;
           type: "command";
         }
           | {
           headers?: ... | ...;
           timeoutMs?: ... | ...;
           type: "http";
           url: string;
        })[];
        matcher?: string;
     }[];
     PostToolUse?: {
        hooks: (
           | {
           command: ...[];
           timeoutMs?: ... | ...;
           type: "command";
         }
           | {
           headers?: ... | ...;
           timeoutMs?: ... | ...;
           type: "http";
           url: string;
        })[];
        matcher?: string;
     }[];
     PreToolUse?: {
        hooks: (
           | {
           command: ...[];
           timeoutMs?: ... | ...;
           type: "command";
         }
           | {
           headers?: ... | ...;
           timeoutMs?: ... | ...;
           type: "http";
           url: string;
        })[];
        matcher?: string;
     }[];
     SessionEnd?: {
        hooks: (
           | {
           command: ...[];
           timeoutMs?: ... | ...;
           type: "command";
         }
           | {
           headers?: ... | ...;
           timeoutMs?: ... | ...;
           type: "http";
           url: string;
        })[];
        matcher?: string;
     }[];
     SessionStart?: {
        hooks: (
           | {
           command: ...[];
           timeoutMs?: ... | ...;
           type: "command";
         }
           | {
           headers?: ... | ...;
           timeoutMs?: ... | ...;
           type: "http";
           url: string;
        })[];
        matcher?: string;
     }[];
     Stop?: {
        hooks: (
           | {
           command: ...[];
           timeoutMs?: ... | ...;
           type: "command";
         }
           | {
           headers?: ... | ...;
           timeoutMs?: ... | ...;
           type: "http";
           url: string;
        })[];
        matcher?: string;
     }[];
     UserPromptSubmit?: {
        hooks: (
           | {
           command: ...[];
           timeoutMs?: ... | ...;
           type: "command";
         }
           | {
           headers?: ... | ...;
           timeoutMs?: ... | ...;
           type: "http";
           url: string;
        })[];
        matcher?: string;
     }[];
  };
  locale?: string;
  mcpServers?: Record<string,
     | {
     args?: string[];
     command: string;
     cwd?: string;
     enabled?: boolean;
     env?: Record<string, string>;
     load?: "lazy" | "eager";
     pool?: {
        connections?: number;
        maxInflightPerConnection?: number;
        queueTimeoutMs?: number;
     };
     reconnect?: {
        enabled?: boolean;
        initialBackoffMs?: number;
        maxAttempts?: number | null;
        maxBackoffMs?: number;
     };
     toolAllowlist?: string[];
     transport: "stdio";
   }
     | {
     enabled?: boolean;
     headers?: Record<string, string>;
     load?: "lazy" | "eager";
     pool?: {
        connections?: number;
        maxInflightPerConnection?: number;
        queueTimeoutMs?: number;
     };
     reconnect?: {
        enabled?: boolean;
        initialBackoffMs?: number;
        maxAttempts?: number | null;
        maxBackoffMs?: number;
     };
     toolAllowlist?: string[];
     transport: "http";
     url: string;
  }>;
  modelAliases: {
     fast?: string;
     main?: string;
     reasoning?: string;
  };
  outputStyle?: string;
  permissions?: {
     allow?: string[];
     ask?: string[];
     classifier?: {
        callBudget?: number | "off";
        enabled?: boolean;
        tightenOutsideAuto?: boolean;
     };
     defaultMode?:   | "default"
        | "acceptEdits"
        | "plan"
        | "bypassPermissions"
        | "auto"
        | "dontAsk";
     deny?: string[];
     disableBaselineProtection?: boolean;
     projectAskBudget?: number | "off";
     recommendedRules?: boolean;
  };
  policy?: {
     trust?: {
        keys: Record<string, string>;
        unsignedPolicy?: "accept" | "reject";
     };
  };
  providers: Record<string, {
     auth?: {
        env: string;
     };
     baseUrl: string;
     capability?: {
        background?: boolean;
        defaultContextWithoutModifier?: number;
        effectiveContext?: number;
        hostedTools?: string[];
        inputModalities: {
           document: "supported" | "rejected" | "silently_dropped";
           image: "supported" | "rejected" | "silently_dropped";
        };
        maxContext: number;
        maxOutput?: number;
        modelModifiers: string[];
        promptCaching: {
           maxBreakpoints?: number;
           minCacheableTokens?: number;
           mode: "explicit" | "implicit" | "ignored";
           ttlSeconds?: number;
        };
        quirks: {
           claudeModelNameMapping: boolean;
           countTokensEndpoint?: boolean;
           maxTokensExcludesReasoning?: boolean;
           minTimeoutMs?: number;
           modelsEndpoint?: boolean;
           stopSequences?: "ignored" | "honored" | "misreported_end_turn";
           streamUsageLocation?: "message_start" | "message_delta" | "both";
           systemRoleInMessages: boolean;
           unknownModelFallback: boolean;
        };
        reasoning?: boolean;
        sampling: {
           temperature?: {
              clampEpsilon: number;
              max: number;
              maxExclusive: boolean;
              min: number;
              minExclusive: boolean;
           };
           temperatureFixed?: number;
           temperatureRange?: [number, number];
        };
        thinking: {
           budgetMaxTokens?: number;
           budgetTokens: "ignored" | "honored";
           cannotDisable: boolean;
           effortParam?: string;
           mustEchoBack: boolean;
           signatureShape?: "opaque" | "always_empty" | "absent";
           toggleValues: string[];
        };
        thinkingOptional?: boolean;
        toolChoice: boolean;
        vision: boolean;
     };
     models: Record<string, string>;
     pricing?: Record<string, {
        cachedInputPerMillion?: number;
        inputPerMillion: number;
        outputPerMillion: number;
        peakMultiplier?: number;
        tiers?: {
           cachedInputPerMillion?: number;
           inputPerMillion: number;
           outputPerMillion: number;
           upToInputTokens?: number;
        }[];
     }>;
     protocol: "anthropic" | "openai" | "openai-responses" | "twp";
  }>;
  sandbox?: {
     allowWrite?: string[];
     mode?: "off" | "on" | "required";
     network?: "allow" | "deny";
  };
  semanticIndex?: {
     branch?: string;
     repoId?: string;
     timeoutMs?: number;
     topK?: number;
     url?: string;
  };
  telemetry: {
     enabled: boolean;
  };
  ui?: {
     theme?: "dark" | "light" | "high-contrast" | "colorblind";
  };
  verify?: {
     command?: string;
     timeoutMs?: number;
  };
  workspaceTrust?: {
     enforce?: boolean;
  };
};

五层合并后的完整配置(TansrConfigSchema 推导)。

属性

$schemaVersion

$schemaVersion: 1;

---

audit?

optional audit?: {
  dir?: string;
  enabled?: boolean;
};

dir?

optional dir?: string;

enabled?

optional enabled?: boolean;

---

budget?

optional budget?: {
  maxTotalTokens?: number;
  maxUsd?: number;
  onExceeded: "block" | "warn";
};

maxTotalTokens?

optional maxTotalTokens?: number;

maxUsd?

optional maxUsd?: number;

onExceeded

onExceeded: "block" | "warn";

---

effort?

optional effort?: "max" | "low" | "medium" | "high";

---

fallbacks

fallbacks: Record<string, string[]>;

---

hooks?

optional hooks?: {
  allowManagedHooksOnly?: boolean;
  disableAllHooks?: boolean;
  PermissionDenied?: {
     hooks: (
        | {
        command: ...[];
        timeoutMs?: ... | ...;
        type: "command";
      }
        | {
        headers?: ... | ...;
        timeoutMs?: ... | ...;
        type: "http";
        url: string;
     })[];
     matcher?: string;
  }[];
  PermissionRequest?: {
     hooks: (
        | {
        command: ...[];
        timeoutMs?: ... | ...;
        type: "command";
      }
        | {
        headers?: ... | ...;
        timeoutMs?: ... | ...;
        type: "http";
        url: string;
     })[];
     matcher?: string;
  }[];
  PostToolUse?: {
     hooks: (
        | {
        command: ...[];
        timeoutMs?: ... | ...;
        type: "command";
      }
        | {
        headers?: ... | ...;
        timeoutMs?: ... | ...;
        type: "http";
        url: string;
     })[];
     matcher?: string;
  }[];
  PreToolUse?: {
     hooks: (
        | {
        command: ...[];
        timeoutMs?: ... | ...;
        type: "command";
      }
        | {
        headers?: ... | ...;
        timeoutMs?: ... | ...;
        type: "http";
        url: string;
     })[];
     matcher?: string;
  }[];
  SessionEnd?: {
     hooks: (
        | {
        command: ...[];
        timeoutMs?: ... | ...;
        type: "command";
      }
        | {
        headers?: ... | ...;
        timeoutMs?: ... | ...;
        type: "http";
        url: string;
     })[];
     matcher?: string;
  }[];
  SessionStart?: {
     hooks: (
        | {
        command: ...[];
        timeoutMs?: ... | ...;
        type: "command";
      }
        | {
        headers?: ... | ...;
        timeoutMs?: ... | ...;
        type: "http";
        url: string;
     })[];
     matcher?: string;
  }[];
  Stop?: {
     hooks: (
        | {
        command: ...[];
        timeoutMs?: ... | ...;
        type: "command";
      }
        | {
        headers?: ... | ...;
        timeoutMs?: ... | ...;
        type: "http";
        url: string;
     })[];
     matcher?: string;
  }[];
  UserPromptSubmit?: {
     hooks: (
        | {
        command: ...[];
        timeoutMs?: ... | ...;
        type: "command";
      }
        | {
        headers?: ... | ...;
        timeoutMs?: ... | ...;
        type: "http";
        url: string;
     })[];
     matcher?: string;
  }[];
};

allowManagedHooksOnly?

optional allowManagedHooksOnly?: boolean;

disableAllHooks?

optional disableAllHooks?: boolean;

PermissionDenied?

optional PermissionDenied?: {
  hooks: (
     | {
     command: ...[];
     timeoutMs?: ... | ...;
     type: "command";
   }
     | {
     headers?: ... | ...;
     timeoutMs?: ... | ...;
     type: "http";
     url: string;
  })[];
  matcher?: string;
}[];

PermissionRequest?

optional PermissionRequest?: {
  hooks: (
     | {
     command: ...[];
     timeoutMs?: ... | ...;
     type: "command";
   }
     | {
     headers?: ... | ...;
     timeoutMs?: ... | ...;
     type: "http";
     url: string;
  })[];
  matcher?: string;
}[];

PostToolUse?

optional PostToolUse?: {
  hooks: (
     | {
     command: ...[];
     timeoutMs?: ... | ...;
     type: "command";
   }
     | {
     headers?: ... | ...;
     timeoutMs?: ... | ...;
     type: "http";
     url: string;
  })[];
  matcher?: string;
}[];

PreToolUse?

optional PreToolUse?: {
  hooks: (
     | {
     command: ...[];
     timeoutMs?: ... | ...;
     type: "command";
   }
     | {
     headers?: ... | ...;
     timeoutMs?: ... | ...;
     type: "http";
     url: string;
  })[];
  matcher?: string;
}[];

SessionEnd?

optional SessionEnd?: {
  hooks: (
     | {
     command: ...[];
     timeoutMs?: ... | ...;
     type: "command";
   }
     | {
     headers?: ... | ...;
     timeoutMs?: ... | ...;
     type: "http";
     url: string;
  })[];
  matcher?: string;
}[];

SessionStart?

optional SessionStart?: {
  hooks: (
     | {
     command: ...[];
     timeoutMs?: ... | ...;
     type: "command";
   }
     | {
     headers?: ... | ...;
     timeoutMs?: ... | ...;
     type: "http";
     url: string;
  })[];
  matcher?: string;
}[];

Stop?

optional Stop?: {
  hooks: (
     | {
     command: ...[];
     timeoutMs?: ... | ...;
     type: "command";
   }
     | {
     headers?: ... | ...;
     timeoutMs?: ... | ...;
     type: "http";
     url: string;
  })[];
  matcher?: string;
}[];

UserPromptSubmit?

optional UserPromptSubmit?: {
  hooks: (
     | {
     command: ...[];
     timeoutMs?: ... | ...;
     type: "command";
   }
     | {
     headers?: ... | ...;
     timeoutMs?: ... | ...;
     type: "http";
     url: string;
  })[];
  matcher?: string;
}[];

---

locale?

optional locale?: string;

---

mcpServers?

optional mcpServers?: Record<string,
  | {
  args?: string[];
  command: string;
  cwd?: string;
  enabled?: boolean;
  env?: Record<string, string>;
  load?: "lazy" | "eager";
  pool?: {
     connections?: number;
     maxInflightPerConnection?: number;
     queueTimeoutMs?: number;
  };
  reconnect?: {
     enabled?: boolean;
     initialBackoffMs?: number;
     maxAttempts?: number | null;
     maxBackoffMs?: number;
  };
  toolAllowlist?: string[];
  transport: "stdio";
}
  | {
  enabled?: boolean;
  headers?: Record<string, string>;
  load?: "lazy" | "eager";
  pool?: {
     connections?: number;
     maxInflightPerConnection?: number;
     queueTimeoutMs?: number;
  };
  reconnect?: {
     enabled?: boolean;
     initialBackoffMs?: number;
     maxAttempts?: number | null;
     maxBackoffMs?: number;
  };
  toolAllowlist?: string[];
  transport: "http";
  url: string;
}>;

---

modelAliases

modelAliases: {
  fast?: string;
  main?: string;
  reasoning?: string;
};

fast?

optional fast?: string;

main?

optional main?: string;

reasoning?

optional reasoning?: string;

---

outputStyle?

optional outputStyle?: string;

---

permissions?

optional permissions?: {
  allow?: string[];
  ask?: string[];
  classifier?: {
     callBudget?: number | "off";
     enabled?: boolean;
     tightenOutsideAuto?: boolean;
  };
  defaultMode?:   | "default"
     | "acceptEdits"
     | "plan"
     | "bypassPermissions"
     | "auto"
     | "dontAsk";
  deny?: string[];
  disableBaselineProtection?: boolean;
  projectAskBudget?: number | "off";
  recommendedRules?: boolean;
};

allow?

optional allow?: string[];

ask?

optional ask?: string[];

classifier?

optional classifier?: {
  callBudget?: number | "off";
  enabled?: boolean;
  tightenOutsideAuto?: boolean;
};

classifier.callBudget?

optional callBudget?: number | "off";

classifier.enabled?

optional enabled?: boolean;

classifier.tightenOutsideAuto?

optional tightenOutsideAuto?: boolean;

defaultMode?

optional defaultMode?:
  | "default"
  | "acceptEdits"
  | "plan"
  | "bypassPermissions"
  | "auto"
  | "dontAsk";

deny?

optional deny?: string[];

disableBaselineProtection?

optional disableBaselineProtection?: boolean;

projectAskBudget?

optional projectAskBudget?: number | "off";

recommendedRules?

optional recommendedRules?: boolean;

---

policy?

optional policy?: {
  trust?: {
     keys: Record<string, string>;
     unsignedPolicy?: "accept" | "reject";
  };
};

trust?

optional trust?: {
  keys: Record<string, string>;
  unsignedPolicy?: "accept" | "reject";
};

trust.keys

keys: Record<string, string>;

trust.unsignedPolicy?

optional unsignedPolicy?: "accept" | "reject";

---

providers

providers: Record<string, {
  auth?: {
     env: string;
  };
  baseUrl: string;
  capability?: {
     background?: boolean;
     defaultContextWithoutModifier?: number;
     effectiveContext?: number;
     hostedTools?: string[];
     inputModalities: {
        document: "supported" | "rejected" | "silently_dropped";
        image: "supported" | "rejected" | "silently_dropped";
     };
     maxContext: number;
     maxOutput?: number;
     modelModifiers: string[];
     promptCaching: {
        maxBreakpoints?: number;
        minCacheableTokens?: number;
        mode: "explicit" | "implicit" | "ignored";
        ttlSeconds?: number;
     };
     quirks: {
        claudeModelNameMapping: boolean;
        countTokensEndpoint?: boolean;
        maxTokensExcludesReasoning?: boolean;
        minTimeoutMs?: number;
        modelsEndpoint?: boolean;
        stopSequences?: "ignored" | "honored" | "misreported_end_turn";
        streamUsageLocation?: "message_start" | "message_delta" | "both";
        systemRoleInMessages: boolean;
        unknownModelFallback: boolean;
     };
     reasoning?: boolean;
     sampling: {
        temperature?: {
           clampEpsilon: number;
           max: number;
           maxExclusive: boolean;
           min: number;
           minExclusive: boolean;
        };
        temperatureFixed?: number;
        temperatureRange?: [number, number];
     };
     thinking: {
        budgetMaxTokens?: number;
        budgetTokens: "ignored" | "honored";
        cannotDisable: boolean;
        effortParam?: string;
        mustEchoBack: boolean;
        signatureShape?: "opaque" | "always_empty" | "absent";
        toggleValues: string[];
     };
     thinkingOptional?: boolean;
     toolChoice: boolean;
     vision: boolean;
  };
  models: Record<string, string>;
  pricing?: Record<string, {
     cachedInputPerMillion?: number;
     inputPerMillion: number;
     outputPerMillion: number;
     peakMultiplier?: number;
     tiers?: {
        cachedInputPerMillion?: number;
        inputPerMillion: number;
        outputPerMillion: number;
        upToInputTokens?: number;
     }[];
  }>;
  protocol: "anthropic" | "openai" | "openai-responses" | "twp";
}>;

---

sandbox?

optional sandbox?: {
  allowWrite?: string[];
  mode?: "off" | "on" | "required";
  network?: "allow" | "deny";
};

allowWrite?

optional allowWrite?: string[];

mode?

optional mode?: "off" | "on" | "required";

network?

optional network?: "allow" | "deny";

---

semanticIndex?

optional semanticIndex?: {
  branch?: string;
  repoId?: string;
  timeoutMs?: number;
  topK?: number;
  url?: string;
};

branch?

optional branch?: string;

repoId?

optional repoId?: string;

timeoutMs?

optional timeoutMs?: number;

topK?

optional topK?: number;

url?

optional url?: string;

---

telemetry

telemetry: {
  enabled: boolean;
};

enabled

enabled: boolean;

---

ui?

optional ui?: {
  theme?: "dark" | "light" | "high-contrast" | "colorblind";
};

theme?

optional theme?: "dark" | "light" | "high-contrast" | "colorblind";

---

verify?

optional verify?: {
  command?: string;
  timeoutMs?: number;
};

command?

optional command?: string;

timeoutMs?

optional timeoutMs?: number;

---

workspaceTrust?

optional workspaceTrust?: {
  enforce?: boolean;
};

enforce?

optional enforce?: boolean;

本文是否有帮助?

有帮助没帮助