Dzx Name Token

按文件类型自动生成带有注释格式的 Name Token 标记，方便在代码中快速插入身份追踪签名。

📋 Changelog

v0.2.0 (2026-07-07)

• 🔧 修复 — 序列号起始值 startingNumber 配置现已生效
• 🔄 增强 — 修改 startingNumber 后计数器自动重置为新的起始值，无需手动干预
• ✅ 修正 — Token 操作标记统一使用 Add / Modify / Remove

v0.1.0 (初始发布)

• 🎉 首次发布，支持 22 种文件类型自动匹配
• 🏷️ 支持 Add / Modify / Remove 三种操作类型
• ⌨️ 快捷键 Ctrl+Shift+/ 一键插入

✨ 功能

• 🚀 一键插入 — 快捷键 Ctrl+Shift+/（Mac: Cmd+Shift+/）即可在光标位置插入 Token
• 🏷️ 操作标记 — 支持 Add / Modify / Remove 三种操作类型
• 📄 智能注释 — 根据文件类型自动匹配注释格式（//、#、;、<!-- --> 等）
• 🔢 自动编号 — 全局自增序列号，确保每个 Token 唯一
• ⚙️ 高度可配 — 用户 ID、前缀、文件映射均可自定义

📸 效果预览

按下快捷键，选择操作类型，Token 自动插入光标位置：

📦 安装

方式一：VS Code 扩展市场

1. 打开 VS Code，进入扩展面板（Ctrl+Shift+X）
2. 搜索 Dzx Name Token
3. 点击安装

方式二：本地安装 .vsix

# 下载 .vsix 文件后执行
code --install-extension Dzx-name-token-0.1.0.vsix

方式三：开发者模式

git clone <repo-url>
cd Dzx-name-token
npm install
npm run compile
# 按 F5 启动扩展开发宿主

🚀 快速开始

1. 打开任意文件，将光标移动到想要插入 Token 的位置
2. 按下 Ctrl+Shift+/（Mac: Cmd+Shift+/）
3. 在弹出的操作列表中选择：Add / Modify / Remove
4. Token 自动插入光标处

⚙️ 配置

在 VS Code 设置中搜索 nameToken：

{
  "nameToken.userId": "DAZHAO",
  "nameToken.tokenPrefix": "Start",
  "nameToken.startingNumber": 1,
  "nameToken.mappings": {
    "*.c":    { "prefix": "//",   "suffix": "//" },
    "*.py":   { "prefix": "#",    "suffix": "#" },
    "*.nasm": { "prefix": ";",    "suffix": ";" },
    "*.md":   { "prefix": "<!--", "suffix": "-->" },
    "*.bat":  { "prefix": "REM",  "suffix": "" }
  }
}

默认文件映射

C 风格注释 (//)

*.c *.h *.cpp *.asl *.asi *.uni *.vfr

井号注释 (#)

*.env *.py *.bash *.sh *.yaml *.yml *.inf *.fdf *.dec *.dsc *.mac *.inc *.s *.S

分号注释 (;)

*.nasm *.asm

HTML 注释 (<!-- -->)

*.md

Batch 注释 (REM)

*.bat

💡 以上为 UEFI / EDK2 开发常见文件类型的完整预设，开箱即用。

🎯 Token 格式

<注释前缀>[-<前缀>-<日期>-<用户ID><序号>-<操作>]<注释后缀>

⌨️ 快捷键

可在 keybindings.json 中自定义该快捷键。

📁 支持的文件类型

目前已适配 22 种文件类型，覆盖 C/C++、Python、Shell、YAML、汇编、UEFI EDK2（ASL/INF/FDF/DEC/DSC/UNI/VFR）等。你也可以通过 nameToken.mappings 配置添加更多文件类型。

📧 联系方式

如有问题或建议，欢迎联系：

• 📧 Email: dzx.dz.xu@gmail.com

📄 许可

MIT © dazhao