skills 安全与部署最佳实践：如何做到 API Key 不入库、0600 权限与独立虚拟环境（含完整避坑清单）-平芜编程栈

【免费下载链接】skills

开源了Codex Skills等集合，大部分是自己实际需要搞得，需要的自取。欢迎star

项目地址：https://gitcode.com/gh_mirrors/skills24/skills

skills是一个 Claude Code Skills 集合，包含变声、转写、YouTube 上传、网盘发布等多个自动化技能。本文带你快速掌握 skills 部署中的三大安全要点：API Key 不入库、敏感文件 0600 权限、独立虚拟环境，并附上一份实操避坑清单，让你的自动化脚本安全又省心。

一、API Key 不入库：三种主流做法

技能脚本天然会接触 API Key、Bot Token、OAuth Token 等敏感信息。skills 仓库内置了三套互不冲突的隔离方式，可按需选用。

做法 1：配置模板 + .gitignore（推荐新手）

以 image-generator 为例，仓库只提交占位符模板，真实密钥写在本地文件里：

cp ~/.claude/skills/image-generator/config.json.example ~/.claude/skills/image-generator/config.json

模板文件 config.json.example 中是your-gemini-api-key-here这类占位符
本地生成的config.json已被.gitignore忽略，不会提交到版本库
文档中明确提醒："不要将包含真实 API Key 的配置文件提交到版本库"（见 image-generator/SKILL.md）

做法 2：secrets.env 独立密钥文件

quark-mswnlz-publisher 把 Telegram Bot Token、群组 ID 等全部放进QuarkPanTool/config/secrets.env（已 gitignore），脚本启动时自动加载，无需手动export：

# QuarkPanTool/config/secrets.env TELEGRAM_BOT_TOKEN=123456:ABC-DEF... TELEGRAM_CHANNEL_ID=@your_channel

加载逻辑见 mswnlz_publish.py。该 Skill 的安全要求写得很直白（SKILL.md 安全要求）：

⚠️ 永远不要将 Token 硬编码在脚本中；永远不要将 Token 提交到 Git 仓库；不要在聊天中粘贴或回显 Token。

做法 3：环境变量优先

text-to-speech 的 MiniMax 密钥从环境变量MINIMAX_API_KEY读取，配置文件只写api_key_env变量名（见 tts_config.json）
youtube-tracker 的 YouTube Data APIapiKey单独放在本机 state 配置中，仓库内示例文件只保留空值

二、0600 权限：给敏感文件上"保险锁"

0600表示仅文件所有者可读写，是 Token 类文件的推荐权限。skills 中有两处真实实现可以直接抄作业。

1. OAuth Token 写入即锁定权限

youtube-publisher 在认证时写入 Token 文件，采用"创建时指定 + 显式 chmod 双保险"（见 authenticate.ts）：

fs.writeFileSync(TOKEN_PATH, JSON.stringify(token, null, 2), { mode: 0o600 }); fs.chmodSync(TOKEN_PATH, 0o600);

对应变更记录见 references/CHANGELOG.md。手动检查权限的命令：

chmod 600 ~/.claude/skills/youtube-publisher/scripts/token.json ls -l token.json # 应显示 -rw-------

2. 本机密钥档案强制 0600

miniMax 声音克隆脚本写入本机音色档案后强制降权，并用回归测试断言权限必须为0o600（见 test_minimax_voice_clone.py）：

path.chmod(stat.S_IRUSR | stat.S_IWUSR) # 即 0600，仅所有者可读写

🔒 经验总结：凡是包含 Token、API Key、Cookie 的文件，一律chmod 600；目录建议700。

三、独立虚拟环境：技能之间互不打架

不同 Skill 的 Python 依赖经常互相冲突（如 torch 版本、FunASR 与 Python 3.11 的兼容问题）。skills 的做法是每个重型 Skill 一个独立 venv：

Skill	虚拟环境	说明
audiocut-keyword	`funasr_env_310/`	固定 Python 3.10，预装 torch 2.10.0 + funasr 1.3.0，解决 3.11 兼容性问题
quark-mswnlz-publisher	`QuarkPanTool/.venv/`	安装 aligo、playwright 等，编排器直接调用`.venv/bin/python`

创建方式很简单：

python3.10 -m venv ~/.claude/skills/audiocut-keyword/funasr_env_310 source ~/.claude/skills/audiocut-keyword/funasr_env_310/bin/activate pip install torch funasr -i https://pypi.tuna.tsinghua.edu.cn/simple

💡 好处：升级 A 技能的依赖不会破坏 B 技能；node_modules/、.venv/等目录也应加入.gitignore，不入库。

四、部署避坑清单 🧯

#	坑	正确姿势	出处
1	API Key 写进脚本或提交仓库	用配置模板 + gitignore，或`secrets.env`/ 环境变量	image-generator/SKILL.md、quark-mswnlz-publisher/SKILL.md
2	Token 文件权限过宽	写入时`mode: 0o600`+`chmod`双保险	authenticate.ts
3	依赖装到全局环境导致冲突	每技能独立`venv`，固定 Python 版本	audiocut-keyword/README.md
4	新 Google 项目报`403 Access Denied`	在 OAuth Audience 里添加Test User	youtube-publisher/SETUP.md
5	桌面应用报`Redirect URI mismatch`	选 Desktop app 类型，不要配置 redirect URI	SETUP.md 故障表
6	字幕上传失败	在 Data access 添加`youtube.force-ssl`scope 后重新`--auth`	SETUP.md
7	VPS 上跑自动化被扫爆	改 SSH 端口 + 密钥登录 + Fail2ban + UFW	vps-security-hardening
8	上传前不预览导致误操作	先用`--dry-run`预览，确认后再执行	youtube-publisher/SKILL.md