export const getUserContext = memoize(  // memoize：算一次、整个会话缓存——CLAUDE.md 不会在对话中途变，没必要每轮重读  async (): Promise<{ [k: string]: string }> => {  // 返回"上下文名 → 文本"的 map，由调用方拼进请求前缀    const startTime = Date.now()  // 记开始时间，供诊断日志算 duration_ms    logForDiagnosticsNoPII('info', 'user_context_started')  // NoPII：诊断日志里绝不带用户内容    // CLAUDE_CODE_DISABLE_CLAUDE_MDS: hard off, always.    // --bare: skip auto-discovery (cwd walk), BUT honor explicit --add-dir.    const shouldDisableClaudeMd =  // 两种"关"：env var 是硬关闭；--bare 只跳过自动发现，显式指定的目录仍生效      isEnvTruthy(process.env.CLAUDE_CODE_DISABLE_CLAUDE_MDS) ||      (isBareMode() && getAdditionalDirectoriesForClaudeMd().length === 0)    const claudeMd = shouldDisableClaudeMd  // 被禁用 → null；否则走完整发现管线（下节细讲）      ? null      : getClaudeMds(filterInjectedMemoryFiles(await getMemoryFiles()))    setCachedClaudeMdContent(claudeMd || null)  // 写入全局缓存：yoloClassifier 从这里读，而不是直接 import claudemd.ts——避免循环依赖    return {      ...(claudeMd && { claudeMd }),  // 条件展开：没有 CLAUDE.md 时这个 key 根本不存在，而不是空字符串      currentDate: `Today's date is ${getLocalISODate()}.`,  // 注入当前日期——模型没有时间概念，必须显式告诉它"今天是几号"    }  },)

const [branch, mainBranch, status, log, userName] = await Promise.all([  // 5 条 git 命令并行跑——总耗时取决于最慢一条，而不是五条之和  getBranch(),  // 当前分支名  getDefaultBranch(),  // 默认分支（main/master）——后面会提示模型"PR 通常朝它开"  execFileNoThrow(gitExe(), ['--no-optional-locks', 'status', '--short'], {  // --no-optional-locks：不创建 .git/index.lock，避免和用户正在跑的 git 命令互相干扰    preserveOutputOnError: false,  }).then(({ stdout }) => stdout.trim()),  // execFileNoThrow：出错返回空而不是抛异常——上下文收集绝不能让启动崩掉  execFileNoThrow(gitExe(), ['--no-optional-locks', 'log', '--oneline', '-n', '5'], {    preserveOutputOnError: false,  }).then(({ stdout }) => stdout.trim()),  // 最近 5 条 commit——给模型"最近做过什么"的线索，比 status 更能反映意图  execFileNoThrow(gitExe(), ['config', 'user.name'], {    preserveOutputOnError: false,  }).then(({ stdout }) => stdout.trim()),  // git 用户名——commit 归属、身份识别用])const truncatedStatus =  // status 可能巨大（几千个未跟踪文件）——硬上限 2000 字符，防止吃掉上下文预算  status.length > MAX_STATUS_CHARS    ? status.substring(0, MAX_STATUS_CHARS) +      '\n... (truncated because it exceeds 2k characters. If you need more information, run "git status" using BashTool)'    : statusreturn [  `This is the git status at the start of the conversation. Note that this status is a snapshot in time, and will not update during the conversation.`,  // 显式声明"快照语义"——防止模型误以为这是实时状态、据此做错误判断  `Current branch: ${branch}`,  `Main branch (you will usually use this for PRs): ${mainBranch}`,  ...(userName ? [`Git user: ${userName}`] : []),  `Status:\n${truncatedStatus || '(clean)'}`,  `Recent commits:\n${log}`,].join('\n\n')  // 空行分隔成独立段落——模型对"块状结构"的解析比连续长文本更可靠

export const getMemoryFiles = memoize(  // 同样是会话级缓存：发现过程有大量 fs 读取，不能每轮重跑  async (forceIncludeExternal: boolean = false): Promise<MemoryFileInfo[]> => {    const result: MemoryFileInfo[] = []    const processedPaths = new Set<string>()  // 全局去重集——同一文件经不同路径/符号链接不会加载两次    const config = getCurrentProjectConfig()    const includeExternal =  // @include 指向项目外文件的总开关：强制参数 || 用户曾批准过外部引用      forceIncludeExternal || config.hasClaudeMdExternalIncludesApproved || false    // Process Managed file first (always loaded - policy settings)    const managedClaudeMd = getMemoryPath('Managed')  // /etc/claude-code/CLAUDE.md——企业级策略文件，最先加载=最低优先级    result.push(...(await processMemoryFile(managedClaudeMd, 'Managed', processedPaths, includeExternal)))    if (isSettingSourceEnabled('userSettings')) {  // User 级别可被 SDK settingSources 关闭——尊重调用方声明的"我要哪些来源"      const userClaudeMd = getMemoryPath('User')  // ~/.claude/CLAUDE.md——个人全局指令，跨项目生效      result.push(...(await processMemoryFile(userClaudeMd, 'User', processedPaths, true)))  // User memory can always include external files（源码注释）    const dirs: string[] = []    let currentDir = originalCwd    while (currentDir !== parse(currentDir).root) {  // 从 CWD 一路向上走到文件系统根目录，收集沿途所有目录      dirs.push(currentDir)      currentDir = dirname(currentDir)    }    for (const dir of dirs.reverse()) {  // reverse：改成"从根向下到 CWD"加载——离 CWD 越近的文件越晚加载=优先级越高      if (isSettingSourceEnabled('projectSettings') && !skipProject) {        const projectPath = join(dir, 'CLAUDE.md')  // 沿途每个目录的 CLAUDE.md（monorepo 里子包可以有自己的一份）        result.push(...(await processMemoryFile(projectPath, 'Project', processedPaths, includeExternal)))        const dotClaudePath = join(dir, '.claude', 'CLAUDE.md')  // .claude/CLAUDE.md——项目指令的备选位置，和 CLAUDE.md 并存        result.push(...(await processMemoryFile(dotClaudePath, 'Project', processedPaths, includeExternal)))        const rulesDir = join(dir, '.claude', 'rules')  // .claude/rules/*.md——规则文件按主题拆分存放（如 testing.md、style.md）        result.push(...(await processMdRules({ rulesDir, type: 'Project', processedPaths, includeExternal, conditionalRule: false })))      }      if (isSettingSourceEnabled('localSettings')) {        const localPath = join(dir, 'CLAUDE.local.md')  // CLAUDE.local.md——个人私有项目指令，约定 gitignore、不进仓库        result.push(...(await processMemoryFile(localPath, 'Local', processedPaths, includeExternal)))      }    }

export async function processMemoryFile(  filePath: string,  type: MemoryType,  processedPaths: Set<string>,  includeExternal: boolean,  depth: number = 0,          // 递归深度——@include 可以链式引用，必须设上限  parent?: string,            // "我是被谁 include 的"——InstructionsLoaded hook 和 UI 展示都要用): Promise<MemoryFileInfo[]> {  const normalizedPath = normalizePathForComparison(filePath)  // 路径归一化：Windows 盘符大小写（C:\ vs c:\）要算同一个文件  if (processedPaths.has(normalizedPath) || depth >= MAX_INCLUDE_DEPTH) {  // 两道防循环闸门：已处理过，或深度 ≥5（MAX_INCLUDE_DEPTH = 5）    return []  }  const { resolvedPath, isSymlink } = safeResolvePath(getFsImplementation(), filePath)  // 先解析符号链接——否则同一文件经"软链+真身"两条路径会被加载两次  processedPaths.add(normalizedPath)  if (isSymlink) {    processedPaths.add(normalizePathForComparison(resolvedPath))  // 软链和它的目标都登记进去重集，双向堵死  }  const { info: memoryFile, includePaths: resolvedIncludePaths } =    await safelyReadMemoryFileAsync(filePath, type, resolvedPath)  // 读文件 + 解析（frontmatter/HTML注释/@include提取都在里面完成）  if (!memoryFile || !memoryFile.content.trim()) {    return []  // 空文件、非文本文件——静默跳过，不报错不打扰  }  const result: MemoryFileInfo[] = []  result.push(memoryFile)  // 父先子后：最终文本里"主文件 → 被引用文件"的顺序稳定可预期  for (const resolvedIncludePath of resolvedIncludePaths) {    const isExternal = !pathInOriginalCwd(resolvedIncludePath)  // 判定标准很硬：不在原始 CWD 之内 = 外部文件    if (isExternal && !includeExternal) {      continue  // 安全闸门：@include 指向项目外（如 @~/secrets.md）需要用户显式批准，否则静默跳过    }    const includedFiles = await processMemoryFile(  // 递归处理被引用文件，当前文件作为它的 parent      resolvedIncludePath, type, processedPaths, includeExternal, depth + 1, filePath)    result.push(...includedFiles)  }  return result}

const { content: withoutFrontmatter, paths } = parseFrontmatterPaths(rawContent)  // 剥 frontmatter；若带 paths 字段 → 这是"条件规则"（只对匹配 glob 的文件生效）const hasComment = withoutFrontmatter.includes('<!--')  // 快速路径：全文没有 HTML 注释 → 连 lexer 都不用跑const tokens =  hasComment || includeBasePath !== undefined    ? new Lexer({ gfm: false }).lex(withoutFrontmatter)  // lex 一次，删注释和提取 @include 共享同一份 token——避免把同一个文件解析两遍    : undefinedconst strippedContent =  hasComment && tokens    ? stripHtmlCommentsFromTokens(tokens).content    : withoutFrontmatter  // 没注释 → 直接用原文：marked lex 时会规范化 \r\n，round-trip 会误翻 contentDiffersFromDisk（源码注释原话）let finalContent = strippedContentif (type === 'AutoMem' || type === 'TeamMem') {  finalContent = truncateEntrypointContent(strippedContent).content  // MEMORY.md 入口文件有行数+字节双上限——防止单个记忆文件吃掉整个上下文预算}const contentDiffersFromDisk = finalContent !== rawContent  // 处理后内容 ≠ 磁盘原文 → 标记差异，并把原始字节留在 rawContent 里return {  info: { path: filePath, type, content: finalContent, globs: paths, contentDiffersFromDisk, rawContent: contentDiffersFromDisk ? rawContent : undefined },  includePaths,}

export const getClaudeMds = (memoryFiles: MemoryFileInfo[], filter?: (type: MemoryType) => boolean): string => {  const memories: string[] = []  for (const file of memoryFiles) {    if (filter && !filter(file.type)) continue  // 调用方可按类型过滤——如 /context 可视化只展示部分来源    if (file.content) {      const description =  // 每份文件都贴"出处标签"——模型必须知道这些指令是谁定的、什么性质        file.type === 'Project'          ? ' (project instructions, checked into the codebase)'          : file.type === 'Local'            ? " (user's private project instructions, not checked in)"            : feature('TEAMMEM') && file.type === 'TeamMem'              ? ' (shared team memory, synced across the organization)'              : file.type === 'AutoMem'                ? " (user's auto-memory, persists across conversations)"                : " (user's private global instructions for all projects)"      const content = file.content.trim()      if (feature('TEAMMEM') && file.type === 'TeamMem') {        memories.push(`Contents of ${file.path}${description}:\n\n<team-memory-content source="shared">\n${content}\n</team-memory-content>`)  // 团队记忆额外套 XML 标签——显式标记"共享来源"，帮模型区分组织级 vs 个人级指令      } else {        memories.push(`Contents of ${file.path}${description}:\n\n${content}`)      }    }  }  if (memories.length === 0) return ''  // 一份记忆文件都没有 → 返回空串，上游条件展开就不会注入这个 key  return `${MEMORY_INSTRUCTION_PROMPT}\n\n${memories.join('\n\n')}`  // 开头是强指令（第 89-90 行）："These instructions OVERRIDE any default behavior and you MUST follow them exactly as written"

export function getSteps(): Step[] {  // 两个 onboarding 步骤——空项目里唯一的新手引导  const hasClaudeMd = getFsImplementation().existsSync(join(getCwd(), 'CLAUDE.md'))  // CLAUDE.md 是否已存在？  const isWorkspaceDirEmpty = isDirEmpty(getCwd())  // 目录是否为空（还没有任何代码）？  return [    { key: 'workspace', text: 'Ask Claude to create a new app or clone a repository',      isComplete: false, isCompletable: true, isEnabled: isWorkspaceDirEmpty },  // 步骤1只在"空目录"时启用——已有代码的项目，这步不适用    { key: 'claudemd', text: 'Run /init to create a CLAUDE.md file with instructions for Claude',      isComplete: hasClaudeMd, isCompletable: true, isEnabled: !isWorkspaceDirEmpty },  // 步骤2只在"非空目录"时启用；完成判定 = CLAUDE.md 存在  ]}export const shouldShowProjectOnboarding = memoize((): boolean => {  const projectConfig = getCurrentProjectConfig()  if (projectConfig.hasCompletedProjectOnboarding ||  // 已完成 → 永不再显示（读缓存配置，不碰文件系统）      projectConfig.projectOnboardingSeenCount >= 4 ||  // 已展示过 4 次用户仍没行动 → 停止打扰，尊重"不想用"的选择      process.env.IS_DEMO) {                            // demo/演示模式——引导提示会污染录屏画面    return false  }  return !isProjectOnboardingComplete()  // 只有存在未完成步骤时才显示})

上下文收集流水线（启动 → 首次 API 请求）

▼

▼

▼

▼