shz-backend/.codex/skills/inspect-shz-logs/SKILL.md

---
name: inspect-shz-logs
description: 通过有界的只读命令检查和跟踪 SHZ 后端的本地、测试及生产日志。适用于 Codex 在 shz-backend 项目中从本地 backend.log 或测试/生产环境的 backend、error、info 和 user 日志诊断启动失败、异常、请求行为、定时任务或运行时事件。
---

# 检查 SHZ 日志

使用随附脚本，不要手动拼接 SSH 命令。每次首次读取都保持范围有界；只有用户明确要求实时监控时，才跟踪日志。

## 检查本地日志

读取最后 200 行：

```bash
.codex/skills/inspect-shz-logs/scripts/view.sh local 200
```

交互式跟踪本地日志：

```bash
.codex/skills/inspect-shz-logs/scripts/view.sh local 200 --follow
```

## 检查生产日志

读取主应用日志：

```bash
.codex/skills/inspect-shz-logs/scripts/view.sh online backend 200
```

读取当前错误日志：

```bash
.codex/skills/inspect-shz-logs/scripts/view.sh online error 200
```

`online` 是现有的生产环境名称，仍受支持。`production` 是等效别名。

只选择一种日志类型：`backend`、`error`、`info` 或 `user`。只有在明确的实时监控请求中，才能将 `--follow` 作为最后一个参数添加。

## 检查测试日志

读取测试环境主应用日志：

```bash
.codex/skills/inspect-shz-logs/scripts/view.sh test backend 200
```

读取当前测试环境错误日志：

```bash
.codex/skills/inspect-shz-logs/scripts/view.sh test error 200
```

测试环境与生产环境使用相同的四种日志类型。默认测试服务器是 SSH 端口 `22` 上的 `root@47.111.103.66`；服务器布局变化时，可使用 `SHZ_TEST_SSH_HOST`、`SHZ_TEST_SSH_PORT` 和 `SHZ_TEST_LOG_DIR` 覆盖端点和日志目录。

进行关键词分析时，获取有界窗口并在本地过滤，例如：

```bash
.codex/skills/inspect-shz-logs/scripts/view.sh online error 1000 | rg -i 'exception|error|failed'
```

## 根据日志诊断

1. 确认请求涉及本地、测试还是生产行为。
2. 从相关日志读取最近 100–300 行。
3. 只有在时间戳或堆栈跟踪需要更多上下文时，才扩展到脚本允许的 5,000 行上限。
4. 关联时间戳、线程名称、异常原因和相邻请求。
5. 报告证据和可能原因，不得暴露令牌、密码、个人数据或无关日志内容。

将测试和生产访问视为只读。不得通过此 skill 重启服务、编辑文件、部署代码、截断日志或执行任意远程命令。

只有在检查服务器身份、路径或支持的日志类型时，才阅读 [references/log-locations.md](references/log-locations.md)。