接手陌生仓库，第一小时让 Codex 帮你找到路

/Users/mengmeng/work/legacy-crm

运营希望客户列表新增“最近跟进人”字段。
字段来自后端已有接口，如果没有则显示“-”。
今天只需要判断能不能改，不要求马上上线。

我知道这个项目可能是 React 写的，后端可能是 Node。
README 很久没更新，不能完全相信。
当前分支是 feature/customer-list-owner。

允许读取文件、查看 Git 状态、分析 package 配置、列出建议阅读顺序。
不要修改文件，不要安装依赖，不要推送，不要删除任何内容。

用户入口：src/pages/customers/index.tsx
路由入口：src/router/routes.ts
数据请求入口：src/services/customer.ts
接口类型入口：src/types/customer.ts
测试入口：src/pages/customers/__tests__/customer-list.test.tsx
构建入口：package.json scripts.build

高相关：直接渲染客户列表或定义列配置的文件
中相关：客户接口、类型、mock 数据、测试
低相关：样式、通用表格组件、国际化文案

- 确认客户列表页面是否仍在当前路由中使用。
- 确认后端返回里是否已有 recentlyFollowedBy 或类似字段。
- 确认表格列配置是否集中在一个文件里。
- 确认本地是否能跑起页面或至少通过类型检查。
- 确认新增字段为空时的展示规则。

目前能确定客户列表入口和列配置文件，能确认本地存在类型检查命令，但因为缺少 .env.local 无法启动页面。
今天可以先做代码级影响评估；真正改动前，需要向负责人确认接口字段名和本地环境变量。

仓库路径：
/Users/mengmeng/work/legacy-crm

当前任务：
我临时接手这个仓库。运营希望客户列表新增“最近跟进人”字段。
字段应该来自后端已有接口，如果为空就显示“-”。
今天只需要判断能不能改，以及改动可能涉及哪里，不要直接改代码。

已知线索：
- 这个项目可能是 React + Node，但我不确定。
- README 可能过期。
- 当前分支是 feature/customer-list-owner。
- 我不知道启动命令和测试命令。

请你只读仓库，不要修改文件，不要安装依赖，不要推送。
请先帮我找入口、识别技术栈、列关键目录，并给出一份可验证的首日检查清单。

{
  "scripts": {
    "dev": "vite --host 0.0.0.0",
    "build": "tsc && vite build",
    "test": "vitest run",
    "lint": "eslint src --ext .ts,.tsx"
  },
  "dependencies": {
    "@vitejs/plugin-react": "^4.2.1",
    "react": "^18.2.0",
    "antd": "^5.0.0",
    "axios": "^1.6.0"
  }
}

你是我的陌生仓库第一小时导航助手。请只读仓库，不要修改文件，不要安装依赖，不要推送，不要删除任何内容。

仓库路径：
[填入本地仓库路径]

我今天要判断的小需求：
[填入需求原话，包含页面、字段、规则、限制]

我已知但不确定的线索：
[填入 README、技术栈、分支、负责人留言等线索；不确定就标注“不确定”]

请按下面步骤工作：
1. 先检查当前分支、工作区是否有未提交修改、顶层目录结构。
2. 识别技术栈、启动入口、构建入口、测试入口。每个判断都要给出证据文件路径；如果只能猜，请标注“待确认”。
3. 找出这个需求最可能涉及的目录和文件，按高相关、中相关、低相关分组，并说明理由。
4. 输出一份“项目入口地图”，包括用户入口、路由入口、数据请求入口、类型或 schema 入口、测试入口、配置入口。
5. 输出一份“首日检查清单”，每一项都要能人工打勾验证。
6. 最后列出你不能确认的事情，以及我应该向同事或负责人追问的问题。

输出要求：
- 不要声称你已经完全理解代码库。
- 不要建议我立刻改代码。
- 不要只写泛泛总结。
- 所有结论尽量带文件路径或可验证线索。

如果文件太多，请先只看 README、package 配置、路由、入口文件、最近 20 次提交摘要和与需求关键词相关的文件，不要试图一次读完整个仓库。

陌生仓库第一小时导航结果

一、当前状态
- 当前分支：feature/customer-list-owner
- 工作区状态：存在未提交修改，涉及 src/pages/customers/CustomerList.tsx 和 src/services/customer.ts。建议先确认这些修改是谁做的，后续不要覆盖。
- 顶层目录初步判断：
  - src/：主要业务代码，证据是 src/main.tsx 和 src/pages/。
  - public/：静态资源。
  - tests/：端到端或集成测试，待进一步确认。
  - scripts/：项目脚本，可能包含构建或数据生成工具。

二、技术栈和入口
- 前端框架：React + Vite。证据：package.json 中有 react、@vitejs/plugin-react，且存在 vite.config.ts。
- UI 组件：Ant Design。证据：package.json 中有 antd，客户页里使用 Table。
- 语言：TypeScript。证据：tsconfig.json、src/main.tsx。
- 本地启动：pnpm dev 或 npm run dev，证据：package.json scripts.dev。实际使用哪个包管理器需要根据 lock 文件确认。
- 构建检查：package.json scripts.build = "tsc && vite build"。
- 测试：Vitest，证据：package.json scripts.test 和 vitest.config.ts。

三、项目入口地图
- 应用入口：src/main.tsx。负责挂载 React 应用。
- 路由入口：src/router/routes.tsx。客户列表路由指向 /customers。
- 客户列表页面：src/pages/customers/CustomerList.tsx。高相关，因为这里定义表格列。
- 客户数据请求：src/services/customer.ts。高相关，因为这里封装 getCustomerList。
- 客户类型定义：src/types/customer.ts。中高相关，因为 Customer 类型里可能需要确认是否已有 lastFollowerName 字段。
- Mock 数据：src/mocks/customer.ts。中相关，如果本地开发依赖 mock，需要同步字段。
- 测试入口：src/pages/customers/__tests__/CustomerList.test.tsx。中相关，用于确认新增列展示。

四、与“最近跟进人”需求的关系
高相关：
- src/pages/customers/CustomerList.tsx：直接渲染客户列表列配置，最可能新增展示列。
- src/services/customer.ts：需要确认接口返回字段是否透传。
- src/types/customer.ts：需要确认字段类型。

中相关：
- src/mocks/customer.ts：如果开发环境使用 mock，需要补样例数据。
- src/pages/customers/__tests__/CustomerList.test.tsx：可能需要补空值显示为“-”的测试。

低相关：
- src/components/DataTable.tsx：通用表格组件，除非列配置能力不足，否则不建议先改。
- src/styles/table.css：只有展示异常时再看。

五、首日检查清单
- [ ] 确认 /customers 路由仍然指向 src/pages/customers/CustomerList.tsx。
- [ ] 确认客户列表表格列配置是否集中在 CustomerList.tsx，而不是后端下发。
- [ ] 确认接口返回中是否已有最近跟进人字段；可能字段名包括 lastFollowerName、recentOwner、followUpOwner。
- [ ] 确认字段为空时现有代码是否已有统一的空值展示函数。
- [ ] 确认本地类型检查命令能否运行。
- [ ] 确认当前未提交修改是否属于别人，避免覆盖。
- [ ] 向业务或后端确认最终字段名和展示文案。

六、不能确认的事
- 不能确认 README 中的启动命令仍然有效，需要实际运行或询问维护者。
- 不能确认后端一定已有该字段，需要看接口样例或问后端。
- 不能确认这个页面是否还有旧版入口，需要通过路由和线上页面核对。

七、建议追问
- 最近跟进人展示姓名、昵称还是工号？
- 没有跟进人时是否固定显示“-”？
- 这个字段是否需要排序或筛选？
- 当前分支上的未提交修改是谁的？

已确认：
- 客户列表当前入口是 src/pages/customers/CustomerList.tsx。
- 列配置在前端维护。
- 存在类型检查命令，但本机缺少环境变量，暂未启动成功。

待确认：
- 后端字段名。
- 空值展示是否有统一规则。
- 当前分支两处未提交修改的归属。

今天能做的下一步：
- 先补充影响评估，不直接改代码。
- 找后端确认字段名。
- 找原负责人确认本地启动所需环境变量。