277 lines
9.3 KiB
Bash
Executable File
277 lines
9.3 KiB
Bash
Executable File
#!/bin/sh
|
|
set -eu
|
|
|
|
# Install DWS agent skills from GitHub Releases into agent skill directories.
|
|
# Usage:
|
|
# curl -fsSL https://raw.githubusercontent.com/DingTalk-Real-AI/dingtalk-workspace-cli/main/scripts/install-skills.sh | sh
|
|
#
|
|
# Downloads dws-skills.zip from GitHub Releases and copies it under each target
|
|
# path using the same rules as build/npm/install.js installSkillsToHomes
|
|
# (AGENT_DIRS + parent-directory gate), with root defaulting to the current
|
|
# directory. Set DWS_SKILLS_ROOT=$HOME to match npm install layout exactly.
|
|
#
|
|
# Environment variables (optional):
|
|
# DWS_VERSION — release tag (default: latest)
|
|
# DWS_SKILLS_ROOT — base path for agent dirs (default: $PWD)
|
|
# DWS_GITEE_REPO — "owner/repo" on Gitee; resolve version + assets via the
|
|
# Gitee API instead of GitHub (China mirror)
|
|
|
|
REPO="DingTalk-Real-AI/dingtalk-workspace-cli"
|
|
# China mirror: Gitee repo "owner/repo". When set, version + asset URLs resolve via Gitee API.
|
|
GITEE_REPO="${DWS_GITEE_REPO:-}"
|
|
# Auto-fallback Gitee mirror used when GitHub is unreachable (see pick_source).
|
|
GITEE_FALLBACK_REPO="${DWS_GITEE_FALLBACK_REPO:-DingTalk-Real-AI/dingtalk-workspace-cli}"
|
|
VERSION="${DWS_VERSION:-latest}"
|
|
SKILL_NAME="dws"
|
|
ROOT="${DWS_SKILLS_ROOT:-$PWD}"
|
|
DWS_CACHE_ROOT="${DWS_CACHE_ROOT:-$HOME/.dws}"
|
|
|
|
# ── Helpers ──────────────────────────────────────────────────────────────────
|
|
|
|
need_cmd() {
|
|
if ! command -v "$1" >/dev/null 2>&1; then
|
|
printf '❌ Missing required command: %s\n' "$1" >&2
|
|
exit 1
|
|
fi
|
|
}
|
|
|
|
# Fetch a Gitee API endpoint, retrying transient 502/503 from Gitee's gateway.
|
|
gitee_api() {
|
|
_url="$1"
|
|
_try=1
|
|
while [ "$_try" -le 4 ]; do
|
|
if _resp="$(curl -fsSL "$_url" 2>/dev/null)" && [ -n "$_resp" ]; then
|
|
printf '%s' "$_resp"
|
|
return 0
|
|
fi
|
|
_try=$((_try + 1))
|
|
sleep 2
|
|
done
|
|
return 1
|
|
}
|
|
|
|
pick_source() {
|
|
[ -n "$GITEE_REPO" ] && return 0
|
|
[ "${DWS_NO_FALLBACK:-0}" = "1" ] && return 0
|
|
curl -fsS --connect-timeout 5 --max-time 12 -o /dev/null "https://github.com/${REPO}/releases/latest" 2>/dev/null && return 0
|
|
GITEE_REPO="$GITEE_FALLBACK_REPO"
|
|
printf ' ⚠ GitHub 不可达，自动切换国内 Gitee 镜像: %s\n' "$GITEE_REPO"
|
|
}
|
|
|
|
resolve_version() {
|
|
if [ "$VERSION" = "latest" ]; then
|
|
if [ -n "$GITEE_REPO" ]; then
|
|
# Gitee's /releases/latest and /releases endpoints are unreliable, so
|
|
# resolve the newest vN.N.N tag from the git tags endpoint instead.
|
|
VERSION="$(gitee_api "https://gitee.com/api/v5/repos/${GITEE_REPO}/tags" \
|
|
| grep -o '"name":[ ]*"v[0-9][0-9.]*"' \
|
|
| sed 's/.*"name":[ ]*"//;s/"$//' \
|
|
| grep -E '^v[0-9]+\.[0-9]+\.[0-9]+$' \
|
|
| sort -V | tail -1)"
|
|
else
|
|
VERSION="$(curl -fsSI "https://github.com/${REPO}/releases/latest" 2>/dev/null \
|
|
| grep -i '^location:' | sed 's|.*/tag/||;s/[[:space:]]*$//')"
|
|
fi
|
|
if [ -z "$VERSION" ]; then
|
|
printf '❌ Could not determine the latest version. Set DWS_VERSION explicitly.\n' >&2
|
|
exit 1
|
|
fi
|
|
fi
|
|
}
|
|
|
|
# Resolve a release asset's download URL by name (GitHub template vs Gitee API).
|
|
asset_url() {
|
|
_name="$1"
|
|
if [ -z "$GITEE_REPO" ]; then
|
|
printf '%s' "https://github.com/${REPO}/releases/download/${VERSION}/${_name}"
|
|
return 0
|
|
fi
|
|
gitee_api "https://gitee.com/api/v5/repos/${GITEE_REPO}/releases/tags/${VERSION}" \
|
|
| tr '}' '\n' \
|
|
| grep "\"name\":[ ]*\"${_name}\"" \
|
|
| grep -o '"browser_download_url":[ ]*"[^"]*"' \
|
|
| head -1 | sed 's/.*"browser_download_url":[ ]*"//;s/"$//'
|
|
}
|
|
|
|
extract_zip() {
|
|
archive="$1"
|
|
dest="$2"
|
|
if command -v unzip >/dev/null 2>&1; then
|
|
unzip -q "$archive" -d "$dest"
|
|
return 0
|
|
fi
|
|
if command -v tar >/dev/null 2>&1 && tar -xf "$archive" -C "$dest" >/dev/null 2>&1; then
|
|
return 0
|
|
fi
|
|
printf '❌ Missing required command: unzip (or tar with zip support)\n' >&2
|
|
exit 1
|
|
}
|
|
|
|
# One-line summary copy (2nd+ targets).
|
|
_copy_skill_summary() {
|
|
_src="$1"
|
|
_dest="$2"
|
|
_label="$3"
|
|
|
|
if [ -d "$_dest" ]; then
|
|
rm -rf "$_dest"
|
|
fi
|
|
|
|
mkdir -p "$_dest"
|
|
cp -R "$_src/"* "$_dest/" 2>/dev/null || cp -r "$_src/"* "$_dest/"
|
|
file_count="$(find "$_dest" -type f | wc -l | tr -d ' ')"
|
|
|
|
printf ' ✅ Skills → %s (%s files)\n' "$_label" "$file_count"
|
|
}
|
|
|
|
# Full copy with top-level listing (1st target).
|
|
_copy_skill() {
|
|
_src="$1"
|
|
_dest="$2"
|
|
_label="$3"
|
|
|
|
if [ -d "$_dest" ]; then
|
|
rm -rf "$_dest"
|
|
fi
|
|
|
|
mkdir -p "$_dest"
|
|
cp -R "$_src/"* "$_dest/" 2>/dev/null || cp -r "$_src/"* "$_dest/"
|
|
file_count="$(find "$_dest" -type f | wc -l | tr -d ' ')"
|
|
|
|
printf ' ✅ Skills → %s (%s files)\n' "$_label" "$file_count"
|
|
|
|
for entry in "$_dest"/*; do
|
|
entry_name="$(basename "$entry")"
|
|
if [ -d "$entry" ]; then
|
|
sub_count="$(find "$entry" -type f | wc -l | tr -d ' ')"
|
|
printf ' 📁 %s/ (%s files)\n' "$entry_name" "$sub_count"
|
|
else
|
|
printf ' 📄 %s\n' "$entry_name"
|
|
fi
|
|
done
|
|
}
|
|
|
|
# Same semantics as build/npm/install.js installSkillsToHomes (root = DWS_SKILLS_ROOT or PWD).
|
|
install_skills_to_root() {
|
|
skill_src="$1"
|
|
root="$2"
|
|
installed=0
|
|
idx=0
|
|
for agent_dir in \
|
|
".agents/skills" \
|
|
".claude/skills" \
|
|
".cursor/skills" \
|
|
".qoder/skills" \
|
|
".qoderwork/skills" \
|
|
".gemini/skills" \
|
|
".codex/skills" \
|
|
".github/skills" \
|
|
".windsurf/skills" \
|
|
".augment/skills" \
|
|
".cline/skills" \
|
|
".amp/skills" \
|
|
".kiro/skills" \
|
|
".trae/skills" \
|
|
".openclaw/skills" \
|
|
".hermes/skills"
|
|
do
|
|
base_dir="$root/$agent_dir"
|
|
parent_gate="$(dirname "$base_dir")"
|
|
if [ "$idx" -gt 0 ] && [ ! -e "$parent_gate" ]; then
|
|
idx=$((idx + 1))
|
|
continue
|
|
fi
|
|
dest="$base_dir/$SKILL_NAME"
|
|
if [ "$root" = "$HOME" ]; then
|
|
label="~/$agent_dir/$SKILL_NAME"
|
|
else
|
|
label="$root/$agent_dir/$SKILL_NAME"
|
|
fi
|
|
if [ "$installed" -eq 0 ]; then
|
|
_copy_skill "$skill_src" "$dest" "$label"
|
|
else
|
|
_copy_skill_summary "$skill_src" "$dest" "$label"
|
|
fi
|
|
installed=$((installed + 1))
|
|
idx=$((idx + 1))
|
|
done
|
|
if [ "$installed" -eq 0 ]; then
|
|
if [ "$root" = "$HOME" ]; then
|
|
flabel="~/.agents/skills/$SKILL_NAME"
|
|
else
|
|
flabel="$root/.agents/skills/$SKILL_NAME"
|
|
fi
|
|
_copy_skill "$skill_src" "$root/.agents/skills/$SKILL_NAME" "$flabel"
|
|
fi
|
|
}
|
|
|
|
# ── Main ─────────────────────────────────────────────────────────────────────
|
|
|
|
main() {
|
|
need_cmd curl
|
|
pick_source
|
|
resolve_version
|
|
|
|
printf '\n'
|
|
printf ' ┌──────────────────────────────────────┐\n'
|
|
printf ' │ DWS Skill Installer │\n'
|
|
printf ' │ DingTalk Workspace CLI │\n'
|
|
printf ' └──────────────────────────────────────┘\n'
|
|
printf '\n'
|
|
|
|
TMPDIR_WORK="$(mktemp -d)"
|
|
trap 'rm -rf "$TMPDIR_WORK"' EXIT INT TERM
|
|
|
|
ASSET_URL="$(asset_url dws-skills.zip)"
|
|
[ -n "$ASSET_URL" ] || { printf '❌ Could not resolve download URL for dws-skills.zip (version %s).\n' "$VERSION" >&2; exit 1; }
|
|
printf ' ⬇ Downloading skills from GitHub Releases: %s (%s)\n' "$REPO" "$VERSION"
|
|
curl -fsSL "$ASSET_URL" -o "$TMPDIR_WORK/dws-skills.zip"
|
|
extract_zip "$TMPDIR_WORK/dws-skills.zip" "$TMPDIR_WORK/extracted"
|
|
|
|
# Prefer the explicit mono/ subtree; fall back to legacy nested or zip root.
|
|
SKILL_SRC="$TMPDIR_WORK/extracted"
|
|
if [ -d "$TMPDIR_WORK/extracted/mono" ] && [ -f "$TMPDIR_WORK/extracted/mono/SKILL.md" ]; then
|
|
SKILL_SRC="$TMPDIR_WORK/extracted/mono"
|
|
elif [ -f "$TMPDIR_WORK/extracted/${SKILL_NAME}/SKILL.md" ]; then
|
|
SKILL_SRC="$TMPDIR_WORK/extracted/${SKILL_NAME}"
|
|
fi
|
|
|
|
if [ ! -f "$SKILL_SRC/SKILL.md" ]; then
|
|
printf ' ❌ Skill source not found in release asset\n' >&2
|
|
exit 1
|
|
fi
|
|
|
|
printf '\n'
|
|
printf ' Installing under root: %s\n' "$ROOT"
|
|
install_skills_to_root "$SKILL_SRC" "$ROOT"
|
|
|
|
# Cache multi/ (and a mono copy) under ~/.dws/skills so that subsequent
|
|
# `dws skill setup --mode multi|mono` invocations can find a source.
|
|
if [ -d "$TMPDIR_WORK/extracted/multi" ]; then
|
|
cache_dir="${DWS_CACHE_ROOT}/skills/multi"
|
|
rm -rf "$cache_dir"
|
|
mkdir -p "$cache_dir"
|
|
cp -R "$TMPDIR_WORK/extracted/multi/"* "$cache_dir/" 2>/dev/null || \
|
|
cp -r "$TMPDIR_WORK/extracted/multi/"* "$cache_dir/" 2>/dev/null || true
|
|
file_count="$(find "$cache_dir" -type f | wc -l | tr -d ' ')"
|
|
printf ' ✅ Cached multi skills → %s (%s files)\n' "$cache_dir" "$file_count"
|
|
fi
|
|
mono_cache="${DWS_CACHE_ROOT}/skills/mono"
|
|
rm -rf "$mono_cache"
|
|
mkdir -p "$mono_cache"
|
|
cp -R "$SKILL_SRC/"* "$mono_cache/" 2>/dev/null || \
|
|
cp -r "$SKILL_SRC/"* "$mono_cache/" 2>/dev/null || true
|
|
|
|
printf '\n'
|
|
printf ' 📖 Skill includes:\n'
|
|
printf ' • SKILL.md — Main skill with product overview and intent routing\n'
|
|
printf ' • references/ — Detailed product command references\n'
|
|
printf ' • scripts/ — Batch operation scripts for all products\n'
|
|
printf '\n'
|
|
printf ' ⚡ Requires: dws CLI installed and on $PATH\n'
|
|
printf ' Install: go install github.com/%s/cmd@latest\n' "$REPO"
|
|
printf '\n'
|
|
}
|
|
|
|
main
|