# 先定位问题在哪一层

保留材料和错误证据，选择低风险、可逆的排查动作。

## 常见问题速查

| 现象 | 先检查 | 下一步 |
| --- | --- | --- |
| 网站加载失败 | 网络与目录加载状态 | 重试相同筛选或读 GitHub 目录 |
| 下载后没有 Bot | 是否只完成网站下载 | 在宿主当前配置导入入口预览与确认 |
| 合集无法导入 | 单文件是否超过200个 Bot | 选单角色或发布分片，并查宿主总量限制 |
| 读不到邮件或文件 | 工具、账号授权与材料可读性 | 提供脱敏材料或补齐任务所需授权 |
| 中文模式有英文指令 | 是否为带来源适配 | 阅读适配说明，指定产物语言 |
| SHA-256 不匹配 | 卡片与下载是否同一发布 | 停止导入，获取一致版本或发布快照 |
| 产物完整但缺少证据 | 来源和验收条件是否齐全 | 补材料并列出未知、冲突 |

读不到文件时，把以下两行公开虚构文本直接贴给当前 Agent，请它只复述两条事实并标行号。不要放入客户资料。

```text
1｜虚构项目：纸飞机；目标周五交草稿。
2｜桌面测试通过；手机测试未开始。
```

若复述正确，记录“粘贴文本可读；原文件读取仍未验证”，保存这次结果。下一步只查原文件路径、格式或授权；若文本也失败，保留报错定位模型或会话问题。条件未变时不盲目重试，不重置已成功的步骤。

## 提交可复现反馈

```text
公开反馈（请脱敏）
页面或公开Bot ID：
模板版本 / 语言 / 内容修订：
宿主版本（涉及导入时）：
时间与最小步骤：
预期结果：
实际结果和错误码：
可公开小样例：
敏感资料处理状态（如适用，不写敏感值）：
不包含：账号、密钥、私有对话、客户材料
```

角色详情反馈入口会预填公开 Bot ID、模板版本和来源。提交前仍需检查自己添加的材料，不公开完整私有日志。

若已误贴敏感资料，先处理暴露：凭据在对应服务侧撤销或轮换，删除聊天不等于凭据失效；客户资料按实际服务删除或限制访问，并确认暴露范围。反馈只记录处理状态与必要的范围说明，不再次粘贴敏感值。

## 保留工作后再恢复

1. 保存草稿、下载文件和必要的脱敏错误信息。
2. 区分网站、格式、宿主导入、模型和账号问题。
3. 先重试读取或用小样例复现，避免用重置替代定位。
4. 运行实例按宿主当前文档处理，记录实际结果。

## 三个容易误解的问题

| 问题 | 回答 |
| --- | --- |
| 打开来源链接会安装吗？ | 不会，原站条件与操作另行适用。 |
| 能运行就代表账号任务认证吗？ | 不能，格式检查与真实账号验收不同。 |
| Bot 自动共享私有记忆吗？ | 配置不传记忆，使用明确授权资料包交接。 |

- [公开问题列表](https://github.com/Harzva/awesome-bot/issues)

## 参考来源

来源核对日期: 2026-10-25

- [网站与反馈说明](https://github.com/Harzva/awesome-bot/blob/main/README.md)
- [导入与验证范围](https://github.com/Harzva/awesome-bot/blob/main/INTEGRATION.md)
- [摘要不一致处理](https://github.com/Harzva/awesome-bot/blob/main/docs/agent-integration.md)