中文名转 Slug

要解决的具体问题

在处理中文客户名或标题时，直接使用原字符串作为文件名、URL path 片段或本地草稿 key，容易遇到两类问题：

• 路径非法字符：如 /、\、空格等，会导致文件保存失败或路由解析报错。
• 可读性差：中文直接塞进 URL 或文件名，后续检索和维护不便。

中文名转 Slug 针对这两个痛点，提供轻量转换能力，把中文客户名或标题转成 URL/文件名安全的 slug，同时保证可读性。

技能如何工作

该技能基于 transliteration 库实现音译，再通过 slugify 规则处理输出。核心能力包括：

• 安全字符输出：结果仅含字母、数字与连字符等 slug 安全字符，过滤危险符号。
• 分隔符合并：连续分隔符合并为单个 -，首尾无 -，避免冗余。
• 空串回落：输入为空时返回 untitled，防止生成非法路径。

关键步骤分三步：

1. 安装依赖 transliteration。
2. 在导出附件文件名或路由 path 处调用 toSafeSlug/toFileSlug。
3. 自测验证：如“上海示例公司”转成可读拉丁 slug，空串返回 untitled。

适用边界与注意点

该技能聚焦本地可读性转换，不覆盖以下场景：

• 不做全站 SEO 策略：不涉及站点级 slug 优化或重定向规则。
• 不做短链服务：不生成短链或管理链接跳转。

使用时需避免两类错误：

• 直接把中文塞进 URL 却声称已 slug 化，未经过转换。
• 保留空格、/、\ 等危险字符，导致路径或 URL 非法。