---
name: "skill_log_get_logs"
description: "需要从飞书, FTP, 用户反馈, meego 等途径下载日志时, 使用该技能. tools for download ap md log."
version: "1.0.0"
author: "bytedance"
tags:
  - aplog, ap log, bugreport
  - mdlog, modemlog
  - download, 下载
categories:
  - development
  - debugging
dependencies: [skill_log_keyword_mdlog,skill_log_workflow,skill_doc_lark_access_workflow]
paths_required:
  - ${TOOLS_BASE}
---


### 从 FTP 获取日志

```
FTP Server: ftp://115.190.10.20/
Username: ftp4base
Password: YEoj4ycaol@Babi1
```

*See `resources/ftp_config.md` for configuration.*

- 如果只是下载 FTP 日志, 继续使用本技能即可.
- 如果需要通过 SSH 登录 Ocean FTP 服务器、在服务器侧处理日志、把 `/UL/log/...` 映射成 `/mnt/vsftp/test/...`、或者为功耗日志做零拷贝 staging, 转到 [skill_log_ocean_ftp](file:///home/bytedance/disk4T/jieli/modem_proc_ext/skills/log_workflow/skill_log_ocean_ftp/SKILL.md).


### 从飞书获取日志
- 依赖 lark-cli 飞鼠CLI 工具. 参考: [lark-cli](https://bytedance.larkoffice.com/docx/WnHkdJQM6oGpQFxm9i7ckVdenSh)
- FTP 日志一般保存在 /UL/log/ 目录下, 如果只提供了 /log/... 路径, 并且找不到, 记得尝试主动添加 /UL 前缀.
- 如果用户给的是飞书 `docx/wiki/sheet/whiteboard` 链接, 或者先要进入飞书文档里找附件/白板/日志入口, **先执行** [skill_doc_lark_access_workflow](../skill_doc_lark_access_workflow/SKILL.md), 完成 `auth status -> auth login(device flow) -> docs +fetch/whiteboard +query` 的闭环后, 再继续本技能.



#### 首次使用时安装工具, 不要重复安装

- agent 安装

```
请帮我, 以 npm 方式, 安装飞书CLI, 并添加到Path路径.
GitHub - larksuite/cli: The official Lark/Feishu CLI tool, maintained by the larksuite team — built 
```
- 手动安装
```bash
# 安装 CLI
npm install -g @larksuite/cli

# 安装 CLI SKILL（必需）
npx skills add larksuite/cli -y -g
```

#### 使用方式
- 需要指定群名, 要下载的文件名. 否则agent 找不到. 
- 如果用户已经说“我授权了”, 也不能直接假定 agent 侧可读飞书；必须按 `skill_doc_lark_access_workflow` 中的流程检查 `lark-cli auth login --device-code` 是否已成功结束, 并再次执行 `lark-cli auth status --verify`.


### 从黄雀用户反馈系统下载日志
- 依赖 OFD 工具. 参考: [OFD](https://bytedance.larkoffice.com/wiki/GOX1wi0SdiC0cdkRziucRlAwnJf)

#### 首次使用时安装工具, 不要重复安装
```bash
#使用以下命令进行全局安装：
# 推荐使用全局安装
npm install -g @byted/ofd --registry=https://bnpm.byted.org

# 使用以下命令进行SKILL安装:
# SKILL名称 ocean-user-feedback-diagnose
npx @byted/skills add git@code.byted.org:liushengheng.ryuu/OFD.git
```

#### 使用方式
```bash

#快速上手
#OFD 的使用非常直观。最基础的用法是直接在命令后附上黄雀日志详情页的 URL。
# 提供一个黄雀日志的 URL
ofd "http://siskin.bytedance.net/feedback/detail/11067896?product=Obric"
```


### 查找本地电脑上的日志

```bash
find "${DOWNLOADS_DIR:-$HOME/Downloads}" \( -type f -o -type d \) \
  \( -name "aplog*" -o -name "bugreport-*.txt" -o -name "*.qdss" -o -name "*.qmdl" -o -name "*.hdf" -o -name "logcat*" -o -name "log_*" \) \
  -newermt "2026-03-13 00:00:00" ! -newermt "2026-03-13 23:59:59" \
  -printf "%TY-%Tm-%Td %TH:%TM:%TS\t%p\n"
```

| Path | Description |
|------|-------------|
| `${DOWNLOADS_DIR:-$HOME/Downloads}` | Default download directory |
| `${ARCHIVE_DIR}` | Primary log archive |
| `${ARCHIVE_DIR2}` | Secondary log archive |

*See `resources/local_log_storage.md` for current configuration.*