用途:为仓库中的示例、演示、任务、测试、文档和生成的 ontology 内容提供已批准的人名,避免自行编造。
数据来源:唯一来源为 data/reference/FNF-2026-06-01-01002-0268.csv,列为 FirstName、LastName、FullName、FirstNameNative、LastNameNative、FullNameNative、Gender、Language。默认使用 FullName;仅当用户明确要求原生文字或特定区域显示文本时才使用 FullNameNative。
使用方式:先根据任务确定所需人名的角色与数量,未指定数量时取示例或测试所需的最小数量。可用 shell 命令查看前几个已批准姓名:awk -F, 'NR > 1 { print $3 }' data/reference/FNF-2026-06-01-01002-0268.csv | head;随机抽样可用:awk -F, 'NR > 1 { print rand() "\t" $3 }' data/reference/FNF-2026-06-01-01002-0268.csv | sort -n | cut -f2- | head -n 5。若 CSV 中出现含逗号或引号的姓名,应改用正规 CSV 解析器。
场景适配:不同实体使用不同姓名;同一场景内保持姓名稳定,确保查询、预期结果、文档与样例一致。除非文件有严格 ASCII 约定,否则不要改动拼写;需要 ASCII 时从 CSV 中选择本身兼容 ASCII 的姓名。邮箱和 ID 可通用,如 customer001@example.com。
替换与验证:替换姓名时需同步更新样例实例、查询提示与匹配、预期测试字符串、渲染文档或生成内容源文件、目录示例或学习材料;源内容变化后重新生成编译产物:npm run catalogue:build 和 npm run learn:build。完成前验证每个姓名存在于 CSV 的 FullName 列,搜索已移除的占位名确保无残留,运行相关测试,生成目录或学习输出变化时运行 npm run build。
限制:不得编造人名;所有姓名必须来自指定 CSV;未提供该 CSV 时无法使用。