2.6 KiB
2.6 KiB
name, description
| name | description |
|---|---|
| inspect-shz-logs | 通过有界的只读命令检查和跟踪 SHZ 后端的本地、测试及生产日志。适用于 Codex 在 shz-backend 项目中从本地 backend.log 或测试/生产环境的 backend、error、info 和 user 日志诊断启动失败、异常、请求行为、定时任务或运行时事件。 |
检查 SHZ 日志
使用随附脚本，不要手动拼接 SSH 命令。每次首次读取都保持范围有界；只有用户明确要求实时监控时，才跟踪日志。
检查本地日志
读取最后 200 行：
.codex/skills/inspect-shz-logs/scripts/view.sh local 200
交互式跟踪本地日志：
.codex/skills/inspect-shz-logs/scripts/view.sh local 200 --follow
检查生产日志
读取主应用日志：
.codex/skills/inspect-shz-logs/scripts/view.sh online backend 200
读取当前错误日志：
.codex/skills/inspect-shz-logs/scripts/view.sh online error 200
online 是现有的生产环境名称，仍受支持。production 是等效别名。
只选择一种日志类型：backend、error、info 或 user。只有在明确的实时监控请求中，才能将 --follow 作为最后一个参数添加。
检查测试日志
读取测试环境主应用日志：
.codex/skills/inspect-shz-logs/scripts/view.sh test backend 200
读取当前测试环境错误日志：
.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 覆盖端点和日志目录。
进行关键词分析时，获取有界窗口并在本地过滤，例如：
.codex/skills/inspect-shz-logs/scripts/view.sh online error 1000 | rg -i 'exception|error|failed'
根据日志诊断
- 确认请求涉及本地、测试还是生产行为。
- 从相关日志读取最近 100–300 行。
- 只有在时间戳或堆栈跟踪需要更多上下文时，才扩展到脚本允许的 5,000 行上限。
- 关联时间戳、线程名称、异常原因和相邻请求。
- 报告证据和可能原因，不得暴露令牌、密码、个人数据或无关日志内容。
将测试和生产访问视为只读。不得通过此 skill 重启服务、编辑文件、部署代码、截断日志或执行任意远程命令。
只有在检查服务器身份、路径或支持的日志类型时，才阅读 references/log-locations.md。