Byted Data Deepresearch Structured2markdown

⚠️ 强制规则

• 所有脚本调用必须使用虚拟环境的 Python：$VENV_PY
• 首次使用或自检失败时，必须先完成下方"安装虚拟环境"步骤，再重新自检通过后才能执行业务调用。
• 禁止直接使用系统 python3，避免依赖污染或版本不匹配。
• 调用时间较长, 禁止因为等待时间过长而结束任务.

0. 凭证检测（环境准备前先检查）

if [ -z "$VOLCENGINE_ACCESS_KEY" ] || [ -z "$VOLCENGINE_SECRET_KEY" ]; then
  echo "CREDENTIALS_MISSING"
else
  echo "VOLCENGINE_ACCESS_KEY: 已设置"
fi

• 若输出 CREDENTIALS_MISSING：必须向用户索取凭证，输出：

  🔑 需要配置火山引擎访问凭证，请提供：

  • AccessKey（AK）：
  • SecretKey（SK）：

• 用户提供后，将其存入 shell 变量 VOLC_AK_INPUT / VOLC_SK_INPUT，后续所有命令附加 --ak "$VOLC_AK_INPUT" --sk "$VOLC_SK_INPUT"。
• 若凭证已存在（VOLCENGINE_ACCESS_KEY / VOLCENGINE_SECRET_KEY 已设置），无需询问，直接进入自检。
• 需要记住AK/SK的内容, 防止频繁向用户询问。

A. 离线自检（不触网，每次执行前先跑）

SCRIPTS_DIR=$(dirname "$(find ~ -maxdepth 8 -name "data2md.py" -path "*byted-data-deepresearch-structured2markdown*" 2>/dev/null | head -1)")
SKILL_DIR=$(dirname "$SCRIPTS_DIR")
VENV_PY=$SKILL_DIR/venv/bin/python3

# 1) 检查虚拟环境是否存在
test -f $VENV_PY && echo "venv OK" || echo "venv 不存在，请先执行安装步骤"

# 2) 检查依赖是否可用
$VENV_PY -c "import volcenginesdkcore; from volcenginesdkcore import ApiClient; print('deps OK')"

# 3) 检查 volcengine-python-sdk 版本（必须 >= 4.0.43）
$VENV_PY -c "from importlib.metadata import version; print(version('volcengine-python-sdk'))"

自检全部通过（无报错）后，才可执行后续业务调用。

安装虚拟环境（自检失败时执行）

SCRIPTS_DIR=$(dirname "$(find ~ -maxdepth 8 -name "data2md.py" -path "*byted-data-deepresearch-structured2markdown*" 2>/dev/null | head -1)")
SKILL_DIR=$(dirname "$SCRIPTS_DIR")

# 1. 创建虚拟环境（仅首次）
python3 -m venv $SKILL_DIR/venv

# 2. 安装依赖
$SKILL_DIR/venv/bin/pip install 'volcengine-python-sdk>=4.0.43'

已知缺陷提醒：volcengine-python-sdk 的 4.0.1～4.0.42（含）历史版本内置重试机制存在缺陷，强烈建议使用 >=4.0.43。

如系统缺少 python3-venv：apt update && apt install python3-venv -y，再重新执行上述步骤。

目标

为用户提供“数据转文档”能力：

1. 通过“命令1”上传Excel/CSV文件，触发数据转文档任务。

交互逻辑

当本 Skill 被触发时：执行以下步骤将数据转换为文档

Step 1：触发数据转文档任务

$VENV_PY \
  $SCRIPTS_DIR/data2md.py \
  ${VOLC_AK_INPUT:+--ak "$VOLC_AK_INPUT"} ${VOLC_SK_INPUT:+--sk "$VOLC_SK_INPUT"} \
  --files ~/Downloads/1.csv,~/Downloads/2.csv, --output test.md

参数说明