npx skills环境变量配置：INSTALL_INTERNAL_SKILLS与telemetry设置全攻略

【免费下载链接】skills The open agent skills tool - npx skills 项目地址: https://gitcode.com/GitHub_Trending/ad/skills

npx skills是一款强大的开源agent skills工具，通过简单的命令行操作即可管理各类技能插件。本文将详细介绍如何通过环境变量配置来控制内部技能显示和遥测数据收集，帮助你打造个性化的工具使用体验。

一、INSTALL_INTERNAL_SKILLS：解锁内部技能的秘密开关

1.1 什么是内部技能？

内部技能是npx skills中一组特殊的功能模块，默认情况下处于隐藏状态。这些技能通常包含实验性特性或高级功能，适合有一定经验的用户探索和使用。

1.2 如何启用内部技能？

要显示内部技能，只需设置INSTALL_INTERNAL_SKILLS环境变量。该变量支持多种取值：

• 1：启用内部技能（推荐使用）
• true：启用内部技能
• yes：启用内部技能

以下是在不同操作系统中设置环境变量的方法：

Windows系统（命令提示符）

set INSTALL_INTERNAL_SKILLS=1

macOS/Linux系统（bash/zsh）

export INSTALL_INTERNAL_SKILLS=1

1.3 如何禁用内部技能？

如果你想恢复默认设置，隐藏内部技能，可以将变量设置为以下值：

• 0：禁用内部技能
• false：禁用内部技能
• 或者直接删除该环境变量

1.4 代码中的实现逻辑

在项目源码中，内部技能的显示逻辑主要通过src/skills.ts文件实现：

const envValue = process.env.INSTALL_INTERNAL_SKILLS;
// 检查环境变量是否设置为启用状态
const showInternal = envValue === '1' || envValue === 'true' || envValue === 'yes';

测试用例src/add.test.ts也验证了不同取值的效果：

it('should show internal skills when INSTALL_INTERNAL_SKILLS=1', () => {
  process.env.INSTALL_INTERNAL_SKILLS = '1';
  // 测试逻辑...
});

it('should return false when INSTALL_INTERNAL_SKILLS is not set', () => {
  delete process.env.INSTALL_INTERNAL_SKILLS;
  // 测试逻辑...
});

二、telemetry设置：掌控你的数据隐私

2.1 什么是telemetry？

Telemetry（遥测）是npx skills收集匿名使用数据的功能，帮助开发者了解工具的使用情况，从而改进产品质量和用户体验。所有收集的数据都是匿名的，不会包含个人身份信息。

2.2 如何禁用telemetry？

如果你关心隐私问题，可以通过以下任一环境变量完全禁用telemetry：

• DISABLE_TELEMETRY=1：禁用遥测
• DO_NOT_TRACK=1：遵循行业标准的隐私保护设置

设置方法示例：

Windows系统

set DISABLE_TELEMETRY=1

macOS/Linux系统

export DO_NOT_TRACK=1

2.3 代码中的telemetry控制逻辑

Telemetry的控制逻辑在src/telemetry.ts中实现：

// 检查是否应该发送遥测数据
function shouldTrack(): boolean {
  return !process.env.DISABLE_TELEMETRY && !process.env.DO_NOT_TRACK;
}

// 发送遥测数据的函数
async function track(event: string, properties: Record<string, string> = {}) {
  if (!shouldTrack()) return;
  
  // 遥测数据发送逻辑...
  fetch(`${TELEMETRY_URL}?${params.toString()}`).catch(() => {});
}

三、实用场景与最佳实践

3.1 开发环境配置

对于开发者，建议启用内部技能以便探索最新功能：

# 启用内部技能并禁用遥测（开发环境）
export INSTALL_INTERNAL_SKILLS=1
export DISABLE_TELEMETRY=1

3.2 生产环境配置

对于日常使用，建议保持默认设置（禁用内部技能，启用遥测）：

# 恢复默认设置
unset INSTALL_INTERNAL_SKILLS
unset DISABLE_TELEMETRY
unset DO_NOT_TRACK

3.3 临时启用特定功能

如需临时使用内部技能，可以在命令前直接设置环境变量：

# 临时启用内部技能执行命令
INSTALL_INTERNAL_SKILLS=1 npx skills add some-internal-skill

四、常见问题解答

Q1: 设置环境变量后需要重启终端吗？

A1: 是的，环境变量设置后需要重启终端才能生效，或者你可以在当前终端中执行source ~/.bashrc（Linux/macOS）或重新打开命令提示符（Windows）。

Q2: 如何永久设置这些环境变量？

A2: 可以将export命令添加到你的shell配置文件中（如~/.bashrc、~/.zshrc），或者在Windows系统中通过"系统属性→高级→环境变量"对话框进行设置。

Q3: 禁用telemetry会影响工具功能吗？

A3: 不会，禁用telemetry只会停止数据收集，不会影响任何核心功能的正常使用。

通过本文介绍的环境变量配置，你可以轻松掌控npx skills的行为，无论是探索内部技能还是保护个人隐私，都能找到适合自己的设置方案。如有更多疑问，可以查阅项目的官方文档或提交issue获取帮助。

【免费下载链接】skills The open agent skills tool - npx skills 项目地址: https://gitcode.com/GitHub_Trending/ad/skills