如何为命令行应用存储脚本元数据以关联文件与API ID？

针对你遇到的同名不同ID脚本本地存储冲突问题，以下是几种实用的解决方案：

1. 文件名嵌入ID #

直接将脚本ID作为文件名的一部分，避免同名冲突。比如：

• 脚本1（ID:3）存储为 Sample Script_3（可根据脚本类型添加后缀，如Sample Script_3.sh）
• 脚本2（ID:4）存储为 Sample Script_4

操作逻辑：
拉取脚本时自动将ID拼接在文件名后；上传脚本时从文件名中提取ID用于API调用。

• 优点：无需额外配置，直观易懂，版本控制系统可直接识别不同文件
• 缺点：文件名会增加ID后缀，手动编辑时需注意不要误改ID部分

2. 按ID创建子目录 #

为每个脚本ID单独创建子目录，目录名使用ID，子目录内保留脚本原名：

scripts/
├─ 3/
│  └─ Sample Script
└─ 4/
   └─ Sample Script

操作逻辑：
拉取时先检查对应ID的目录是否存在，不存在则创建，再将脚本存入目录；上传时根据目录名获取ID。

• 优点：完全保留脚本原名，目录结构清晰区分不同ID的脚本
• 缺点：目录层级增加，命令行操作时路径较长，可通过别名或脚本简化路径输入

3. 本地元数据映射文件 #

在本地维护一个JSON或YAML格式的映射文件（比如script-mapping.json），记录脚本ID与本地文件的对应关系：

{
  "3": "./scripts/Sample Script_v1",
  "4": "./scripts/Sample Script_v2"
}

操作逻辑：
拉取脚本时先查询映射文件，若已有同名记录则提示用户重命名或自动生成后缀，更新映射；上传时通过映射文件根据本地文件找到对应ID。

• 优点：文件名可灵活自定义，不依赖ID嵌入，适合需要个性化命名的场景
• 缺点：需额外维护映射文件，要处理文件丢失、同步等问题，拉取/上传时需读写该文件

4. 利用文件扩展属性（限类Unix系统） #

在类Unix系统中，给文件添加扩展属性存储脚本ID，比如：

# 给文件添加ID属性
xattr -w script.id 3 "Sample Script"
# 读取文件ID属性
xattr -p script.id "Sample Script"

操作逻辑：
拉取脚本后设置扩展属性；上传前读取属性获取ID。

• 优点：文件名保持纯净，无额外后缀或目录
• 缺点：跨平台兼容性差（Windows不支持），多数版本控制系统不会同步文件扩展属性，存在属性丢失风险

方案推荐 #

• 追求简单直接：优先选择文件名嵌入ID
• 需要严格保留脚本原名：选择按ID创建子目录
• 需要自定义文件名：选择本地元数据映射文件

内容的提问来源于stack exchange，提问作者Phandal