@done-coding/cli-cc-switch 0.2.0 → 0.2.1-alpha.0

package/types/index.d.ts

@@ -15,16 +15,17 @@ export declare const buildChildEnv: (processEnv: NodeJS.ProcessEnv, profileEnv:
  * claude 透传参数）；handler 内从 process.argv 在子命令名边界后取**原始切片**
  * 喂给 runRouter —— 不消费 yargs 解析产物，守 REQ-1 逐字保真语义
  * （独立入口 dc-cc-switch / cc-router 行为与未注册前完全一致）。
- * meta 自身命令面（REQ-1）：--meta-profile=<name> / --meta-pick /
+ * meta 自身命令面（REQ-1）：--meta-profile=<name> / --meta-pick / --meta-silent /
  * --meta-help / --meta-version 由 runRouter 消费，[MUST NOT] 透传给 claude。
  */
 export declare const createAsSubcommand: () => CommandModule;
 
 /**
- * REQ-3 内置 deepseek 模板。键集合与 requirements REQ-3 表逐键一致；
- * ANTHROPIC_AUTH_TOKEN 恒为空字符串（绝不含真实 token）。
+ * 纯新装 starter（settings.json 源形态，键集合与旧 DEEPSEEK_TEMPLATE 语义
+ * 对齐；apiKey 恒为空字符串——绝不含真实 token，待用户填入）。
+ * profile 名 = `${provider}-${id}`（deepseek-flash / deepseek-pro）。
  */
-export declare const DEEPSEEK_TEMPLATE: ProfileConfig;
+export declare const DEEPSEEK_SETTINGS_TEMPLATE: Settings;
 
 /**
  * 找出值严格等于 `""` 的键（纯函数，可单测）。
@@ -48,22 +49,6 @@ export declare const maskValue: (v: string) => string;
  *  addmodel=添加模型 / providerlist=列提供商 / modellist=列模型 / generate=重建配置 / help / version */
 export declare type MetaAction = "run" | "profile" | "pick" | "setkey" | "addmodel" | "providerlist" | "modellist" | "generate" | "help" | "version";
 
-/** model：模型层（绑 provider，id 为该 provider 下局部标识 → profile 名 = `${provider}-${id}`） */
-export declare interface Model {
-    provider: string;
-    id: string;
-    /** 实际模型串（如 deepseek-v4-flash[1m]） */
-    name: string;
-    /** 附加 env 覆盖（如 pro 档 ANTHROPIC_DEFAULT_HAIKU_MODEL 用 flash） */
-    envExtraParams?: Record<string, string>;
-}
-
-/** model 配置文件结构（~/.done-coding/cc-switch/model.json，defaultProfile 为生成后 profile 名） */
-export declare interface ModelConfig {
-    defaultProfile: string;
-    models: Model[];
-}
-
 /**
  * 解析 argv（纯函数，可单测）。
  * meta 自身命令面（REQ-1）：--meta-profile=<name>（多个取最后一个生效）、
@@ -83,6 +68,8 @@ export declare interface ParsedArgv {
     modelName?: string;
     /** --meta-provider= 值（setkey/addmodel 的 provider 选择旁路，非独立动作） */
     providerId?: string;
+    /** --meta-silent：压制 output.* 输出（MCP/AI 调用避免污染上下文） */
+    silent: boolean;
     passthrough: string[];
 }
 
@@ -94,31 +81,28 @@ export declare interface Profile {
 
 /**
  * profile 配置文件唯一路径：~/.done-coding/cc-switch/profile.json
+ * （--meta-generate 编译快照，运行时单源读取）。
  * `~` 不写死具体用户，由 os.homedir() 解析当前用户 home。
  */
 export declare const PROFILE_PATH: string;
 
-/** profile 配置文件结构（~/.done-coding/cc-switch/profile.json） */
+/**
+ * profile 配置文件结构（~/.done-coding/cc-switch/profile.json，--meta-generate
+ * 编译快照；运行时单源读取）。defaultProfile/disabledDefault/output 由
+ * settings.json 编译携带，均可选。
+ */
 export declare interface ProfileConfig {
-    defaultProfile: string;
+    /** 可选：未配置 / 被 disabledDefault 禁用 → 交互 pick */
+    defaultProfile?: string;
+    /** 忽略已配默认，强制交互选择（缺省 false） */
+    disabledDefault?: boolean;
+    /** 输出行为控制（缺省 profileName=true） */
+    output?: {
+        profileName?: boolean;
+    };
     profiles: Record<string, Profile>;
 }
 
-/** provider：服务商层（url/apiKey 单点 + 可选附加 env，供 --meta-generate 消费） */
-export declare interface Provider {
-    /** 展示名（服务商名） */
-    name: string;
-    url: string;
-    apiKey: string;
-    /** 附加 env（如 CLAUDE_CODE_EFFORT_LEVEL=max），合并序 model > provider > 通用 */
-    envExtraParams?: Record<string, string>;
-}
-
-/** provider 配置文件结构（~/.done-coding/cc-switch/provider.json） */
-export declare interface ProviderConfig {
-    providers: Record<string, Provider>;
-}
-
 /**
  * 选择 profile（纯函数，可单测）。
  * 有 profileName 用之，否则用 cfg.defaultProfile。
@@ -130,4 +114,46 @@ export declare const selectProfile: (cfg: ProfileConfig, profileName?: string) =
     profile: Profile;
 };
 
+/**
+ * settings 配置文件结构（~/.done-coding/cc-switch/settings.json，唯一源，
+ * 含 apiKey → chmod 600）。注意与 env-guard 的 SETTINGS_PATH
+ * （~/.claude/settings.json，Claude Code 自身配置）同名不同物。
+ */
+export declare interface Settings {
+    defaultProfile?: string;
+    disabledDefault?: boolean;
+    output?: {
+        profileName?: boolean;
+    };
+    providers: Record<string, SettingsProvider>;
+}
+
+/**
+ * settings 源文件唯一路径：~/.done-coding/cc-switch/settings.json
+ * （唯一源：providers 嵌套 models + defaultProfile/disabledDefault/output）。
+ * 注意：与 Claude Code 的 ~/.claude/settings.json（env-guard SETTINGS_PATH）
+ * 同名不同物，勿混淆。
+ */
+export declare const SETTINGS_PATH: string;
+
+/** settings 源：模型（绑 provider，id 为该 provider 下局部标识 → profile 名 = `${provider}-${id}`） */
+export declare interface SettingsModel {
+    id: string;
+    /** 实际模型串（如 deepseek-v4-flash[1m]） */
+    name: string;
+    /** 附加 env 覆盖（如 pro 档 ANTHROPIC_DEFAULT_HAIKU_MODEL 用 flash） */
+    envExtraParams?: Record<string, string>;
+}
+
+/** settings 源：服务商（内嵌支持的模型；url/apiKey 单点） */
+export declare interface SettingsProvider {
+    /** 展示名（服务商名） */
+    name: string;
+    url: string;
+    apiKey: string;
+    /** 附加 env（如 CLAUDE_CODE_EFFORT_LEVEL=max），合并序 model > provider > 通用 */
+    envExtraParams?: Record<string, string>;
+    models: SettingsModel[];
+}
+
 export { }