# debug-logs/

> skill 开发/调试期间产生的 API 探测、测试输出、日志归档
> 
> 2026-04-20 从仓库根目录 16 个散落文件整理而来

## 📂 目录结构

```
debug-logs/
├── probe-api/       TikHub / VOC API schema 探测样本（4 文件 · 217 KB）
├── probe-xhs/       小红书 API 探测日志 & 响应（4 文件 · 9.5 KB）
├── gateway/         网关/深度请求 probe 日志（5 文件 · 1.6 KB）
└── e2e/             端到端测试输出样本（3 文件 · 21 KB）
```

## 📋 文件清单

### `probe-api/` · API schema 探测
| 文件 | 用途 |
|---|---|
| `probe-schema.json` | TikHub 完整 API schema dump（104 KB） |
| `probe-search.json` | 搜索接口完整响应样本（104 KB） |
| `probe-user.json` | 用户接口响应样本（7.3 KB） |
| `probe-douyin-search.json` | 抖音搜索响应样本（1.2 KB） |

### `probe-xhs/` · 小红书探测
| 文件 | 用途 |
|---|---|
| `xhs-probe.log` / `xhs-probe2.log` | 小红书 API 探测过程日志 |
| `xhs-search-probe.json` / `xhs-search-probe.log` | 搜索接口探测响应 + 日志 |

### `gateway/` · 网关/深度 probe
| 文件 | 用途 |
|---|---|
| `gateway-arch-probe.log` | 网关架构探测日志 |
| `scope-probe.log` | 权限 scope 探测 |
| `test-gateway.log` | 网关连通性测试 |
| `422-detail.log` | 422 错误详情记录 |
| `probe-deep.log` | 深度探测日志 |

### `e2e/` · 端到端测试
| 文件 | 用途 |
|---|---|
| `e2e-1-search.json` | E2E 测试步骤 1：search 输出 |
| `e2e-2-note-detail.json` | E2E 测试步骤 2：note-detail 输出（20.7 KB） |
| `sample-search.json` | 搜索样本 |

## ⚠️ 注意事项

- **脚本硬编码路径**：`scripts/tools/probe-tikhub-douyin3.js:33` 用 `fs.writeFileSync('probe-douyin-search.json', ...)` 写入**当前工作目录**（即仓库根目录）。再次执行该脚本会在**根目录**重新生成 `probe-douyin-search.json`，不会自动写入本子目录。需要时手动移进 `probe-api/`。
- **类型**：全部为**临时调试产物**，不影响 skill 本体运行，可随时删除。
- **Git**：未写入 `.gitignore`，可按需添加（建议 `debug-logs/**/*.log` 和 `debug-logs/**/*.json`）。

## 🔄 其他整理（同一次）

| 迁出位置 | 迁入位置 | 文件数 |
|---|---|---:|
| `docs/tikhub-vs-chanmama-comparison.html` + 对应 .md | `docs/api-research/` | 2 |
| `docs/VOC工作坊方案-两天一夜.html` + workshop-client-checklist.md | `docs/workshop/` | 2 |
| `docs/voc-forward-403-决策报告.md` | `docs/debug-notes/` | 1 |