> ## Documentation Index
> Fetch the complete documentation index at: https://docs.42plugin.com/llms.txt
> Use this file to discover all available pages before exploring further.

# 常见问题

> 使用活水插件的常见问题解答

## 安装相关

### 如何安装 42plugin CLI？

复制命令到终端执行：

```bash theme={null}
# macOS / Linux
curl -fsSL https://get.42plugin.com/cli | bash

# Windows (PowerShell)
irm https://get.42plugin.com/cli.ps1 | iex
```

### 安装失败怎么办？

1. 检查网络连接
2. 确认已登录：`42plugin auth --status`
3. 尝试重新安装：`42plugin install <name> --force`

### 如何更新 CLI？

```bash theme={null}
42plugin upgrade
```

### 如何批量更新已安装的插件？

```bash theme={null}
# 检查哪些插件有可用更新
42plugin update --check

# 一键更新所有插件
42plugin update
```

## 认证相关

### 如何切换账号？

```bash theme={null}
42plugin auth --logout
42plugin auth
```

### 验证码过期怎么办？

验证码有效期为 15 分钟。如果过期，请重新执行 `42plugin auth` 获取新的验证码。

### 登录失败怎么办？

1. 检查网络连接
2. 确认验证码输入正确
3. 尝试重新登录
4. 访问 [42plugin.com](https://42plugin.com) 检查账号状态

## 搜索相关

### AI 智能搜索是什么？

AI 智能搜索使用自然语言理解技术，让你用日常语言描述需求，AI 会推荐最匹配的插件。

```bash theme={null}
42plugin search "我想做心理学文献综述" --ai
```

免费用户每天 42 次 AI 搜索，[Pro 用户](/pro)每天 420 次。

### 普通搜索和 AI 搜索有什么区别？

* **普通搜索**：基于关键词匹配，适合知道具体插件名或关键词的场景
* **AI 搜索**：基于语义理解，适合用自然语言描述需求的场景

## 插件相关

### 什么是活水指数？

活水指数（42score）是用于评估插件文档质量和完整性的综合评分系统，基于插件质量进行评估。评分维度包括：

* 描述清晰：插件描述的长度、清晰度、使用场景说明；
* 内容丰富：正文长度、结构化程度、标题层级、列表、表格、链接；
* 示例充实：代码块数量、语言标注、示例章节、用法说明、输出结果；
* 规范程度：frontmatter 完整性，以及是否符合AgentSkill等规范；
* 可信来源：来源、License 类型等。

帮助用户快速识别文档完善、示例丰富的优质插件，也为创作者提供插件文档优化方向。分数越高代表插件质量越好。

### 全局安装和项目安装有什么区别？

* **全局安装**：存放在 `~/.claude/`，对所有项目生效
* **项目安装**：存放在 `./.claude/`，仅当前项目生效

### 如何卸载插件？

```bash theme={null}
42plugin uninstall <plugin-name>
```

详见[卸载插件](/install/cli-uninstall)。

## 技能评估相关

### 42eval 是什么？

42eval 是 42plugin CLI 内置的技能评估套件，用数据量化每个技能的实际贡献。它通过断言测试 + 盲测对比，回答「这个技能到底值不值得用」。

详见[技能评估套件](/builtin/42plugin-eval)。

### 如何开启 42eval？

```bash theme={null}
42plugin builtin enable 42plugin-eval
```

需要 CLI 版本 0.3.9 或更高。

### delta（增量）怎么看？

delta 是用了技能后，断言通过率比不用技能高出多少。> 30% 为优秀，20–30% 为良好，10–20% 为及格，\< 10% 说明技能可能需要重新设计。

### 不会写断言怎么办？

在 Claude Code 中输入 `/42plugin-eval`，AI 会帮你自动生成断言。你只需要告诉 AI 想测试什么场景，它会输出 5–6 条断言供你挑选和修改。

## Pro 相关

### 免费版和 Pro 版有什么区别？

| 功能         | 免费版    | Pro 版（199 元/年） |
| ---------- | ------ | -------------- |
| AI 语义搜索    | 42 次/天 | 420 次/天        |
| 智能推荐       | 5 次/天  | 420 次/天        |
| 插件安装       | 42 次/天 | 无限             |
| 插件发布       | 公开     | 公开 + 私有        |
| 42skill 生成 | 1 次/天  | 42 次/天         |

详见 [Pro 与组织版](/pro)。

### 如何查看我的使用配额？

```bash theme={null}
42plugin status
```

### 组织版适合什么场景？

组织版适合团队协作场景，支持成员管理、无限私有插件、共享套包等功能。适合需要在团队内统一管理和分享插件的企业和组织。