@downcity/agent 1.1.35 → 1.1.43

package/bin/config/DowncitySchema.js.map

@@ -1 +1 @@
-{"version":3,"file":"DowncitySchema.js","sourceRoot":"","sources":["../../src/config/DowncitySchema.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"DowncitySchema.js","sourceRoot":"","sources":["../../src/config/DowncitySchema.ts"],"names":[],"mappings":"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"}

package/bin/config/EnvFile.d.ts

@@ -0,0 +1,31 @@
+/**
+ * Agent 配置域 Env 文件工具模块。
+ *
+ * 职责说明（中文）
+ * - 负责 `.env` / `.env.example` 这类项目配置文件的轻量解析与补齐。
+ * - 服务于 agent 项目初始化与配置维护流程，避免把文本拼接逻辑散落到业务模块。
+ *
+ * 边界说明（中文）
+ * - 这里只处理配置文件文本结构，不负责把值注入运行时 `process.env`。
+ * - 当前能力以 agent 项目配置场景为中心，不追求成为通用 shell env 解析库。
+ */
+import type { EnvFileEntry } from "../types/common/EnvFile.js";
+/**
+ * 解析 Env 文本中已经声明的变量键名集合。
+ *
+ * 关键点（中文）
+ * - 会忽略空行与注释行。
+ * - 仅识别 `KEY=value` 的基础形式，足够覆盖当前 agent 配置初始化流程。
+ */
+export declare function parseEnvKeys(content: string): Set<string>;
+/**
+ * 仅在目标文件缺失指定键时追加 Env 条目。
+ *
+ * 关键点（中文）
+ * - 已存在的键默认保持不变，只有显式列入 `overwriteKeys` 才会覆写。
+ * - 当目标文件原本为空时，会自动补一行总标题注释，便于用户识别来源。
+ * - `entries` 中的空键名会被自动忽略，避免写入无效行。
+ * - 该函数默认服务项目初始化阶段，因此输出格式偏向“可读、可手改”。
+ */
+export declare function appendMissingEnvEntries(filePath: string, sectionTitle: string, entries: EnvFileEntry[], overwriteKeys?: Set<string>): Promise<void>;
+//# sourceMappingURL=EnvFile.d.ts.map

package/bin/config/EnvFile.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"EnvFile.d.ts","sourceRoot":"","sources":["../../src/config/EnvFile.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAGH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,2BAA2B,CAAC;AAG9D;;;;;;GAMG;AACH,wBAAgB,YAAY,CAAC,OAAO,EAAE,MAAM,GAAG,GAAG,CAAC,MAAM,CAAC,CAUzD;AAED;;;;;;;;GAQG;AACH,wBAAsB,uBAAuB,CAC3C,QAAQ,EAAE,MAAM,EAChB,YAAY,EAAE,MAAM,EACpB,OAAO,EAAE,YAAY,EAAE,EACvB,aAAa,CAAC,EAAE,GAAG,CAAC,MAAM,CAAC,GAC1B,OAAO,CAAC,IAAI,CAAC,CAiDf"}

package/bin/config/EnvFile.js

@@ -0,0 +1,89 @@
+/**
+ * Agent 配置域 Env 文件工具模块。
+ *
+ * 职责说明（中文）
+ * - 负责 `.env` / `.env.example` 这类项目配置文件的轻量解析与补齐。
+ * - 服务于 agent 项目初始化与配置维护流程，避免把文本拼接逻辑散落到业务模块。
+ *
+ * 边界说明（中文）
+ * - 这里只处理配置文件文本结构，不负责把值注入运行时 `process.env`。
+ * - 当前能力以 agent 项目配置场景为中心，不追求成为通用 shell env 解析库。
+ */
+import fs from "fs-extra";
+import { escapeRegExp } from "../utils/string/EscapeRegExp.js";
+/**
+ * 解析 Env 文本中已经声明的变量键名集合。
+ *
+ * 关键点（中文）
+ * - 会忽略空行与注释行。
+ * - 仅识别 `KEY=value` 的基础形式，足够覆盖当前 agent 配置初始化流程。
+ */
+export function parseEnvKeys(content) {
+    const out = new Set();
+    for (const rawLine of String(content || "").split(/\r?\n/)) {
+        const line = String(rawLine || "").trim();
+        if (!line || line.startsWith("#"))
+            continue;
+        const matched = line.match(/^([A-Za-z_][A-Za-z0-9_]*)\s*=/);
+        if (!matched)
+            continue;
+        out.add(matched[1]);
+    }
+    return out;
+}
+/**
+ * 仅在目标文件缺失指定键时追加 Env 条目。
+ *
+ * 关键点（中文）
+ * - 已存在的键默认保持不变，只有显式列入 `overwriteKeys` 才会覆写。
+ * - 当目标文件原本为空时，会自动补一行总标题注释，便于用户识别来源。
+ * - `entries` 中的空键名会被自动忽略，避免写入无效行。
+ * - 该函数默认服务项目初始化阶段，因此输出格式偏向“可读、可手改”。
+ */
+export async function appendMissingEnvEntries(filePath, sectionTitle, entries, overwriteKeys) {
+    const normalizedFilePath = String(filePath || "").trim();
+    if (!normalizedFilePath)
+        return;
+    const normalizedEntries = Array.isArray(entries)
+        ? entries.filter((item) => Boolean(String(item?.key || "").trim()))
+        : [];
+    const writableOverwriteKeys = overwriteKeys || new Set();
+    let existing = "";
+    if (await fs.pathExists(normalizedFilePath)) {
+        existing = await fs.readFile(normalizedFilePath, "utf-8");
+    }
+    const existingKeys = parseEnvKeys(existing);
+    let nextContent = existing;
+    const appendedEntries = [];
+    for (const entry of normalizedEntries) {
+        if (!existingKeys.has(entry.key)) {
+            appendedEntries.push(entry);
+            continue;
+        }
+        if (!writableOverwriteKeys.has(entry.key))
+            continue;
+        const linePattern = new RegExp(`^${escapeRegExp(entry.key)}\\s*=.*$`, "gm");
+        if (linePattern.test(nextContent)) {
+            nextContent = nextContent.replace(linePattern, `${entry.key}=${entry.value}`);
+        }
+    }
+    if (appendedEntries.length > 0) {
+        const lines = [];
+        if (!nextContent.trim()) {
+            lines.push("# Downcity 环境变量");
+        }
+        lines.push("", `# ${String(sectionTitle || "").trim()}`);
+        for (const entry of appendedEntries) {
+            lines.push(`${entry.key}=${entry.value}`);
+        }
+        let chunk = lines.join("\n");
+        if (nextContent && !nextContent.endsWith("\n")) {
+            chunk = `\n${chunk}`;
+        }
+        nextContent = `${nextContent}${chunk}\n`;
+    }
+    if (appendedEntries.length > 0 || !(await fs.pathExists(normalizedFilePath))) {
+        await fs.writeFile(normalizedFilePath, nextContent, "utf-8");
+    }
+}
+//# sourceMappingURL=EnvFile.js.map

package/bin/config/EnvFile.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"EnvFile.js","sourceRoot":"","sources":["../../src/config/EnvFile.ts"],"names":[],"mappings":"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"}

package/bin/config/ExecutionBinding.d.ts

@@ -1,27 +1,46 @@
 /**
- * ExecutionBinding：项目执行绑定解析与校验。
+ * 项目执行绑定解析与校验模块。
  *
- * 关键点（中文）
- * - 项目只有一条执行路径：`execution.type = "api"`。
- * - 所有 create / start / runtime 读写都通过这里统一解析。
- * - 避免解析逻辑散落在多个模块中。
+ * 职责说明（中文）
+ * - 统一负责从 `downcity.json` 中读取 agent 的执行目标定义。
+ * - 负责提供最小的存在性判断、主模型读取与错误断言，避免调用方重复解析结构。
+ * - 让初始化、配置装配、运行时启动都复用同一套执行目标解释规则。
+ *
+ * 边界说明（中文）
+ * - 这里只解析配置结构，不负责验证模型是否真实存在于平台模型池中。
+ * - 当前只接受 agent 包已经落地支持的执行绑定格式。
  */
 import type { DowncityConfig } from "../types/config/DowncityConfig.js";
 import type { ExecutionBindingConfig } from "../types/config/ExecutionBinding.js";
 /**
  * 读取项目执行绑定。
+ *
+ * 关键点（中文）
+ * - 当前只接受 `execution.type = "api"` 且存在非空 `modelId` 的配置。
+ * - 若结构不满足最小要求，则返回 `null`，由调用方决定是兜底还是报错。
  */
 export declare function readProjectExecutionBinding(config: DowncityConfig): ExecutionBindingConfig | null;
 /**
  * 读取项目绑定的主模型 ID。
+ *
+ * 关键点（中文）
+ * - 当项目尚未声明可用执行目标时，返回空字符串而不是抛错。
+ * - 适合用于展示层或非强制校验场景读取默认值。
  */
 export declare function readProjectPrimaryModelId(config: DowncityConfig): string;
 /**
  * 判断项目是否存在执行目标。
+ *
+ * 关键点（中文）
+ * - 该函数只判断结构是否合法，不判断目标模型是否可运行。
  */
 export declare function hasProjectExecutionTarget(config: DowncityConfig): boolean;
 /**
  * 断言项目已经声明执行目标。
+ *
+ * 关键点（中文）
+ * - 适合在配置加载完成后的早期阶段调用，尽早暴露缺失执行目标的问题。
+ * - 失败时抛出稳定错误文案，便于 CLI 和上层界面直接展示。
  */
 export declare function assertProjectExecutionTarget(config: DowncityConfig): void;
 //# sourceMappingURL=ExecutionBinding.d.ts.map

package/bin/config/ExecutionBinding.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"ExecutionBinding.d.ts","sourceRoot":"","sources":["../../src/config/ExecutionBinding.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,kCAAkC,CAAC;AACvE,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,oCAAoC,CAAC;AAEjF;;GAEG;AACH,wBAAgB,2BAA2B,CACzC,MAAM,EAAE,cAAc,GACrB,sBAAsB,GAAG,IAAI,CAU/B;AAED;;GAEG;AACH,wBAAgB,yBAAyB,CAAC,MAAM,EAAE,cAAc,GAAG,MAAM,CAGxE;AAED;;GAEG;AACH,wBAAgB,yBAAyB,CAAC,MAAM,EAAE,cAAc,GAAG,OAAO,CAEzE;AAED;;GAEG;AACH,wBAAgB,4BAA4B,CAAC,MAAM,EAAE,cAAc,GAAG,IAAI,CAKzE"}
+{"version":3,"file":"ExecutionBinding.d.ts","sourceRoot":"","sources":["../../src/config/ExecutionBinding.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,kCAAkC,CAAC;AACvE,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,oCAAoC,CAAC;AAEjF;;;;;;GAMG;AACH,wBAAgB,2BAA2B,CACzC,MAAM,EAAE,cAAc,GACrB,sBAAsB,GAAG,IAAI,CAU/B;AAED;;;;;;GAMG;AACH,wBAAgB,yBAAyB,CAAC,MAAM,EAAE,cAAc,GAAG,MAAM,CAGxE;AAED;;;;;GAKG;AACH,wBAAgB,yBAAyB,CAAC,MAAM,EAAE,cAAc,GAAG,OAAO,CAEzE;AAED;;;;;;GAMG;AACH,wBAAgB,4BAA4B,CAAC,MAAM,EAAE,cAAc,GAAG,IAAI,CAKzE"}

package/bin/config/ExecutionBinding.js

@@ -1,13 +1,21 @@
 /**
- * ExecutionBinding：项目执行绑定解析与校验。
+ * 项目执行绑定解析与校验模块。
  *
- * 关键点（中文）
- * - 项目只有一条执行路径：`execution.type = "api"`。
- * - 所有 create / start / runtime 读写都通过这里统一解析。
- * - 避免解析逻辑散落在多个模块中。
+ * 职责说明（中文）
+ * - 统一负责从 `downcity.json` 中读取 agent 的执行目标定义。
+ * - 负责提供最小的存在性判断、主模型读取与错误断言，避免调用方重复解析结构。
+ * - 让初始化、配置装配、运行时启动都复用同一套执行目标解释规则。
+ *
+ * 边界说明（中文）
+ * - 这里只解析配置结构，不负责验证模型是否真实存在于平台模型池中。
+ * - 当前只接受 agent 包已经落地支持的执行绑定格式。
  */
 /**
  * 读取项目执行绑定。
+ *
+ * 关键点（中文）
+ * - 当前只接受 `execution.type = "api"` 且存在非空 `modelId` 的配置。
+ * - 若结构不满足最小要求，则返回 `null`，由调用方决定是兜底还是报错。
  */
 export function readProjectExecutionBinding(config) {
     const execution = config.execution;
@@ -25,6 +33,10 @@ export function readProjectExecutionBinding(config) {
 }
 /**
  * 读取项目绑定的主模型 ID。
+ *
+ * 关键点（中文）
+ * - 当项目尚未声明可用执行目标时，返回空字符串而不是抛错。
+ * - 适合用于展示层或非强制校验场景读取默认值。
  */
 export function readProjectPrimaryModelId(config) {
     const execution = readProjectExecutionBinding(config);
@@ -32,12 +44,19 @@ export function readProjectPrimaryModelId(config) {
 }
 /**
  * 判断项目是否存在执行目标。
+ *
+ * 关键点（中文）
+ * - 该函数只判断结构是否合法，不判断目标模型是否可运行。
  */
 export function hasProjectExecutionTarget(config) {
     return readProjectExecutionBinding(config) !== null;
 }
 /**
  * 断言项目已经声明执行目标。
+ *
+ * 关键点（中文）
+ * - 适合在配置加载完成后的早期阶段调用，尽早暴露缺失执行目标的问题。
+ * - 失败时抛出稳定错误文案，便于 CLI 和上层界面直接展示。
  */
 export function assertProjectExecutionTarget(config) {
     if (hasProjectExecutionTarget(config))

package/bin/config/ExecutionBinding.js.map

@@ -1 +1 @@
-{"version":3,"file":"ExecutionBinding.js","sourceRoot":"","sources":["../../src/config/ExecutionBinding.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAKH;;GAEG;AACH,MAAM,UAAU,2BAA2B,CACzC,MAAsB;IAEtB,MAAM,SAAS,GAAG,MAAM,CAAC,SAAS,CAAC;IACnC,IAAI,CAAC,SAAS,IAAI,OAAO,SAAS,KAAK,QAAQ;QAAE,OAAO,IAAI,CAAC;IAC7D,IAAI,SAAS,CAAC,IAAI,KAAK,KAAK;QAAE,OAAO,IAAI,CAAC;IAC1C,MAAM,OAAO,GAAG,MAAM,CAAC,SAAS,CAAC,OAAO,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE,CAAC;IACvD,IAAI,CAAC,OAAO;QAAE,OAAO,IAAI,CAAC;IAC1B,OAAO;QACL,IAAI,EAAE,KAAK;QACX,OAAO;KACR,CAAC;AACJ,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,yBAAyB,CAAC,MAAsB;IAC9D,MAAM,SAAS,GAAG,2BAA2B,CAAC,MAAM,CAAC,CAAC;IACtD,OAAO,SAAS,CAAC,CAAC,CAAC,SAAS,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,CAAC;AAC5C,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,yBAAyB,CAAC,MAAsB;IAC9D,OAAO,2BAA2B,CAAC,MAAM,CAAC,KAAK,IAAI,CAAC;AACtD,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,4BAA4B,CAAC,MAAsB;IACjE,IAAI,yBAAyB,CAAC,MAAM,CAAC;QAAE,OAAO;IAC9C,MAAM,IAAI,KAAK,CACb,gGAAgG,CACjG,CAAC;AACJ,CAAC"}
+{"version":3,"file":"ExecutionBinding.js","sourceRoot":"","sources":["../../src/config/ExecutionBinding.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAKH;;;;;;GAMG;AACH,MAAM,UAAU,2BAA2B,CACzC,MAAsB;IAEtB,MAAM,SAAS,GAAG,MAAM,CAAC,SAAS,CAAC;IACnC,IAAI,CAAC,SAAS,IAAI,OAAO,SAAS,KAAK,QAAQ;QAAE,OAAO,IAAI,CAAC;IAC7D,IAAI,SAAS,CAAC,IAAI,KAAK,KAAK;QAAE,OAAO,IAAI,CAAC;IAC1C,MAAM,OAAO,GAAG,MAAM,CAAC,SAAS,CAAC,OAAO,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE,CAAC;IACvD,IAAI,CAAC,OAAO;QAAE,OAAO,IAAI,CAAC;IAC1B,OAAO;QACL,IAAI,EAAE,KAAK;QACX,OAAO;KACR,CAAC;AACJ,CAAC;AAED;;;;;;GAMG;AACH,MAAM,UAAU,yBAAyB,CAAC,MAAsB;IAC9D,MAAM,SAAS,GAAG,2BAA2B,CAAC,MAAM,CAAC,CAAC;IACtD,OAAO,SAAS,CAAC,CAAC,CAAC,SAAS,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,CAAC;AAC5C,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,yBAAyB,CAAC,MAAsB;IAC9D,OAAO,2BAA2B,CAAC,MAAM,CAAC,KAAK,IAAI,CAAC;AACtD,CAAC;AAED;;;;;;GAMG;AACH,MAAM,UAAU,4BAA4B,CAAC,MAAsB;IACjE,IAAI,yBAAyB,CAAC,MAAM,CAAC;QAAE,OAAO;IAC9C,MAAM,IAAI,KAAK,CACb,gGAAgG,CACjG,CAAC;AACJ,CAAC"}

package/bin/config/Gitignore.d.ts

@@ -0,0 +1,21 @@
+/**
+ * Agent 配置域 `.gitignore` 维护模块。
+ *
+ * 职责说明（中文）
+ * - 负责在 agent 项目初始化阶段把必要的忽略规则补进 `.gitignore`。
+ * - 让项目配置与运行时状态目录的忽略策略留在 `config/` 语义域内统一维护。
+ *
+ * 边界说明（中文）
+ * - 这里只做最小化补丁写入，不负责 `.gitignore` 的复杂排序、分组或格式整理。
+ * - 当前主要服务项目初始化流程，不追求抽象成通用 Git 文本编辑器。
+ */
+/**
+ * 确保 `.gitignore` 中存在指定规则。
+ *
+ * 关键点（中文）
+ * - 只会在末尾追加缺失规则，不会重排用户已有内容。
+ * - 返回值用于告诉调用方本次是新建、更新还是无需修改。
+ * - 设计目标是“尽量少打扰用户已有文件结构”。
+ */
+export declare function ensureGitignoreEntry(projectRoot: string, entry: string): Promise<"created" | "updated" | "unchanged">;
+//# sourceMappingURL=Gitignore.d.ts.map

package/bin/config/Gitignore.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Gitignore.d.ts","sourceRoot":"","sources":["../../src/config/Gitignore.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAKH;;;;;;;GAOG;AACH,wBAAsB,oBAAoB,CACxC,WAAW,EAAE,MAAM,EACnB,KAAK,EAAE,MAAM,GACZ,OAAO,CAAC,SAAS,GAAG,SAAS,GAAG,WAAW,CAAC,CAyB9C"}

package/bin/config/Gitignore.js

@@ -0,0 +1,46 @@
+/**
+ * Agent 配置域 `.gitignore` 维护模块。
+ *
+ * 职责说明（中文）
+ * - 负责在 agent 项目初始化阶段把必要的忽略规则补进 `.gitignore`。
+ * - 让项目配置与运行时状态目录的忽略策略留在 `config/` 语义域内统一维护。
+ *
+ * 边界说明（中文）
+ * - 这里只做最小化补丁写入，不负责 `.gitignore` 的复杂排序、分组或格式整理。
+ * - 当前主要服务项目初始化流程，不追求抽象成通用 Git 文本编辑器。
+ */
+import fs from "fs-extra";
+import path from "node:path";
+/**
+ * 确保 `.gitignore` 中存在指定规则。
+ *
+ * 关键点（中文）
+ * - 只会在末尾追加缺失规则，不会重排用户已有内容。
+ * - 返回值用于告诉调用方本次是新建、更新还是无需修改。
+ * - 设计目标是“尽量少打扰用户已有文件结构”。
+ */
+export async function ensureGitignoreEntry(projectRoot, entry) {
+    const normalizedProjectRoot = path.resolve(String(projectRoot || "").trim() || ".");
+    const normalizedEntry = String(entry || "").trim();
+    if (!normalizedEntry)
+        return "unchanged";
+    const gitignorePath = path.join(normalizedProjectRoot, ".gitignore");
+    const hasGitignore = await fs.pathExists(gitignorePath);
+    const existingContent = hasGitignore
+        ? await fs.readFile(gitignorePath, "utf-8")
+        : "";
+    const normalizedLines = existingContent
+        .split(/\r?\n/)
+        .map((line) => String(line || "").trim());
+    if (normalizedLines.includes(normalizedEntry)) {
+        return "unchanged";
+    }
+    const chunks = existingContent ? [existingContent] : [];
+    if (existingContent && !existingContent.endsWith("\n")) {
+        chunks.push("\n");
+    }
+    chunks.push(`${normalizedEntry}\n`);
+    await fs.writeFile(gitignorePath, chunks.join(""), "utf-8");
+    return hasGitignore ? "updated" : "created";
+}
+//# sourceMappingURL=Gitignore.js.map

package/bin/config/Gitignore.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"Gitignore.js","sourceRoot":"","sources":["../../src/config/Gitignore.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,OAAO,EAAE,MAAM,UAAU,CAAC;AAC1B,OAAO,IAAI,MAAM,WAAW,CAAC;AAE7B;;;;;;;GAOG;AACH,MAAM,CAAC,KAAK,UAAU,oBAAoB,CACxC,WAAmB,EACnB,KAAa;IAEb,MAAM,qBAAqB,GAAG,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,WAAW,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE,IAAI,GAAG,CAAC,CAAC;IACpF,MAAM,eAAe,GAAG,MAAM,CAAC,KAAK,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE,CAAC;IACnD,IAAI,CAAC,eAAe;QAAE,OAAO,WAAW,CAAC;IAEzC,MAAM,aAAa,GAAG,IAAI,CAAC,IAAI,CAAC,qBAAqB,EAAE,YAAY,CAAC,CAAC;IACrE,MAAM,YAAY,GAAG,MAAM,EAAE,CAAC,UAAU,CAAC,aAAa,CAAC,CAAC;IACxD,MAAM,eAAe,GAAG,YAAY;QAClC,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,aAAa,EAAE,OAAO,CAAC;QAC3C,CAAC,CAAC,EAAE,CAAC;IACP,MAAM,eAAe,GAAG,eAAe;SACpC,KAAK,CAAC,OAAO,CAAC;SACd,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,MAAM,CAAC,IAAI,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC;IAE5C,IAAI,eAAe,CAAC,QAAQ,CAAC,eAAe,CAAC,EAAE,CAAC;QAC9C,OAAO,WAAW,CAAC;IACrB,CAAC;IAED,MAAM,MAAM,GAAG,eAAe,CAAC,CAAC,CAAC,CAAC,eAAe,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;IACxD,IAAI,eAAe,IAAI,CAAC,eAAe,CAAC,QAAQ,CAAC,IAAI,CAAC,EAAE,CAAC;QACvD,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IACpB,CAAC;IACD,MAAM,CAAC,IAAI,CAAC,GAAG,eAAe,IAAI,CAAC,CAAC;IACpC,MAAM,EAAE,CAAC,SAAS,CAAC,aAAa,EAAE,MAAM,CAAC,IAAI,CAAC,EAAE,CAAC,EAAE,OAAO,CAAC,CAAC;IAC5D,OAAO,YAAY,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,SAAS,CAAC;AAC9C,CAAC"}

package/bin/config/Paths.d.ts

@@ -6,7 +6,21 @@
  * - 与 SOUL 一起作为静态 prompt 入口。
  */
 export declare const PROFILE_MD_FILE_CANDIDATES: readonly ["PROFILE.md"];
+/**
+ * 返回项目主 `PROFILE.md` 的标准路径。
+ *
+ * 关键点（中文）
+ * - 当前始终返回候选列表中的第一优先级文件。
+ * - 调用方可把该路径视为初始化时默认写入位置。
+ */
 export declare function getProfileMdPath(cwd: string): string;
+/**
+ * 返回 `PROFILE.md` 的全部候选路径。
+ *
+ * 关键点（中文）
+ * - 便于后续扩展多候选命名时保持调用方逻辑不变。
+ * - 当前虽然只有一个候选值，仍统一暴露数组接口。
+ */
 export declare function getProfileMdCandidatePaths(cwd: string): string[];
 /**
  * SOUL.md 候选文件名（按优先级从高到低）。
@@ -16,16 +30,72 @@ export declare function getProfileMdCandidatePaths(cwd: string): string[];
  * - 统一由 Paths 模块暴露，避免调用方散落硬编码。
  */
 export declare const SOUL_MD_FILE_CANDIDATES: readonly ["SOUL.md"];
+/**
+ * 返回项目主 `SOUL.md` 的标准路径。
+ *
+ * 关键点（中文）
+ * - 当前始终返回候选列表中的第一优先级文件。
+ * - 与 `PROFILE.md` 一样，属于静态 system prompt 入口文件。
+ */
 export declare function getSoulMdPath(cwd: string): string;
+/**
+ * 返回 `SOUL.md` 的全部候选路径。
+ *
+ * 关键点（中文）
+ * - 供探测逻辑统一遍历候选文件名。
+ * - 保留数组形式便于后续新增兼容命名。
+ */
 export declare function getSoulMdCandidatePaths(cwd: string): string[];
+/**
+ * 返回项目主配置文件 `downcity.json` 的路径。
+ */
 export declare function getDowncityJsonPath(cwd: string): string;
+/**
+ * 返回项目运行时状态根目录 `.downcity` 的路径。
+ */
 export declare function getDowncityDirPath(cwd: string): string;
+/**
+ * 返回项目内 schema 快照文件路径。
+ *
+ * 关键点（中文）
+ * - 初始化流程会把本地 schema 副本写到这里，供编辑器联想与校验。
+ */
 export declare function getDowncitySchemaPath(cwd: string): string;
+/**
+ * 返回 `.downcity/config` 目录路径。
+ *
+ * 关键点（中文）
+ * - 用于存放项目级额外配置快照或未来扩展的辅助配置文件。
+ */
 export declare function getDowncityConfigDirPath(cwd: string): string;
+/**
+ * 返回项目日志目录路径。
+ */
 export declare function getLogsDirPath(cwd: string): string;
+/**
+ * 返回项目缓存目录路径。
+ *
+ * 关键点（中文）
+ * - 当前使用隐藏命名 `.cache`，避免与用户业务目录混淆。
+ */
 export declare function getCacheDirPath(cwd: string): string;
+/**
+ * 返回 profile 运行态目录路径。
+ */
 export declare function getDowncityProfileDirPath(cwd: string): string;
+/**
+ * 返回 profile 主记忆文件路径。
+ *
+ * 关键点（中文）
+ * - 该文件通常承载主画像或核心长期 profile 信息。
+ */
 export declare function getDowncityProfilePrimaryPath(cwd: string): string;
+/**
+ * 返回 profile 补充记忆文件路径。
+ *
+ * 关键点（中文）
+ * - 该文件用于存放不适合进入主 profile 的补充材料。
+ */
 export declare function getDowncityProfileOtherPath(cwd: string): string;
 /**
  * Memory 根目录（V2）。
@@ -53,10 +123,34 @@ export declare function getDowncityMemoryDailyPath(cwd: string, date: string): s
  * - 调度任务属于项目 runtime 本地状态，因此放在项目 `.downcity/` 下。
  */
 export declare function getDowncityScheduleDbPath(cwd: string): string;
+/**
+ * 返回项目运行时数据目录路径。
+ */
 export declare function getDowncityDataDirPath(cwd: string): string;
+/**
+ * 返回项目内全部 agent 实例目录的根路径。
+ *
+ * 关键点（中文）
+ * - 单项目虽然通常只有一个 agent 入口，但底层仍按 agentId 分层组织。
+ */
 export declare function getDowncityAgentsRootDirPath(cwd: string): string;
+/**
+ * 返回指定 agent 的运行态目录路径。
+ *
+ * 关键点（中文）
+ * - `agentId` 会做 URL 编码，避免特殊字符污染文件系统结构。
+ */
 export declare function getDowncityAgentDirPath(cwd: string, agentId: string): string;
+/**
+ * 返回指定 agent 的 session 根目录路径。
+ */
 export declare function getDowncitySessionRootDirPath(cwd: string, agentId: string): string;
+/**
+ * 返回指定 session 的运行态目录路径。
+ *
+ * 关键点（中文）
+ * - `sessionId` 同样会做 URL 编码，保证路径可安全持久化。
+ */
 export declare function getDowncitySessionDirPath(cwd: string, agentId: string, sessionId: string): string;
 /**
  * Session Messages（会话消息，唯一事实源）。
@@ -66,12 +160,51 @@ export declare function getDowncitySessionDirPath(cwd: string, agentId: string,
  * - compact 会把被折叠的原始段写入 `messages/archive/*`（可审计）
  */
 export declare function getDowncitySessionMessagesDirPath(cwd: string, agentId: string, sessionId: string): string;
+/**
+ * 返回 session 消息事实源文件路径。
+ *
+ * 关键点（中文）
+ * - 当前唯一事实源是 `messages.jsonl`，所有历史组装都应基于它。
+ */
 export declare function getDowncitySessionMessagesPath(cwd: string, agentId: string, sessionId: string): string;
+/**
+ * 返回 session 历史元信息文件路径。
+ *
+ * 关键点（中文）
+ * - 该文件保存 compaction、更新时间、SDK 配置等附加元信息。
+ */
 export declare function getDowncitySessionHistoryMetaPath(cwd: string, agentId: string, sessionId: string): string;
+/**
+ * 返回 session 消息归档目录路径。
+ *
+ * 关键点（中文）
+ * - compaction 时被折叠的原始消息段会写入该目录，便于审计和回溯。
+ */
 export declare function getDowncitySessionMessagesArchiveDirPath(cwd: string, agentId: string, sessionId: string): string;
+/**
+ * 返回指定归档文件的完整路径。
+ *
+ * 关键点（中文）
+ * - `archiveId` 会做 URL 编码，避免 compaction 生成的标识污染文件名。
+ */
 export declare function getDowncitySessionMessagesArchivePath(cwd: string, agentId: string, sessionId: string, archiveId: string): string;
+/**
+ * 返回项目公开静态资源目录路径。
+ */
 export declare function getDowncityPublicDirPath(cwd: string): string;
+/**
+ * 返回项目任务目录路径。
+ *
+ * 关键点（中文）
+ * - 该目录用于存放任务相关的本地文件与运行时数据。
+ */
 export declare function getDowncityTasksDirPath(cwd: string): string;
+/**
+ * 返回项目调试目录路径。
+ *
+ * 关键点（中文）
+ * - 当前使用隐藏目录 `.debug`，避免与用户显式业务目录冲突。
+ */
 export declare function getDowncityDebugDirPath(cwd: string): string;
 /**
  * Chat 元信息目录（由 chat plugin runtime 维护）。
@@ -96,7 +229,19 @@ export declare function getDowncityChannelDirPath(cwd: string): string;
  * - 采用单文件 JSON（`meta.json`）存储映射表与最近路由信息。
  */
 export declare function getDowncityChannelMetaPath(cwd: string): string;
+/**
+ * 返回 chat 元信息目录路径。
+ *
+ * 关键点（中文）
+ * - 用于按 sessionId 存放最近聊天路由快照与附加索引信息。
+ */
 export declare function getDowncityChatMetaDirPath(cwd: string): string;
+/**
+ * 返回指定 session 的 chat 元信息文件路径。
+ *
+ * 关键点（中文）
+ * - 文件名按 `sessionId` 编码，避免不同会话之间互相覆盖。
+ */
 export declare function getDowncityChatMetaPath(cwd: string, sessionId: string): string;
 /**
  * Chat 会话目录（按 sessionId 组织）。

package/bin/config/Paths.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"Paths.d.ts","sourceRoot":"","sources":["../../src/config/Paths.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"Paths.d.ts","sourceRoot":"","sources":["../../src/config/Paths.ts"],"names":[],"mappings":"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"}