better-dsh 0.2.5 → 0.3.0-a

package/docs/80_upstream-docs-and-skills/hermes-dev-skill/src/i18n/zh-Hans/user-guide/skills/bundled/github/github-github-repo-management.md

@@ -1,534 +0,0 @@
----
-title: "Github 仓库管理 — 克隆/创建/fork 仓库；管理远程、发布"
-sidebar_label: "Github 仓库管理"
-description: "克隆/创建/fork 仓库；管理远程、发布"
----
-
-{/* This page is auto-generated from the skill's SKILL.md by website/scripts/generate-skill-docs.py. Edit the source SKILL.md, not this page. */}
-
-# Github 仓库管理
-
-克隆/创建/fork 仓库；管理远程、发布。
-
-## Skill 元数据
-
-| | |
-|---|---|
-| 来源 | 内置（默认安装） |
-| 路径 | `skills/github/github-repo-management` |
-| 版本 | `1.1.0` |
-| 作者 | Hermes Agent |
-| 许可证 | MIT |
-| 平台 | linux, macos, windows |
-| 标签 | `GitHub`, `Repositories`, `Git`, `Releases`, `Secrets`, `Configuration` |
-| 相关 skill | [`github-auth`](/user-guide/skills/bundled/github/github-github-auth), [`github-pr-workflow`](/user-guide/skills/bundled/github/github-github-pr-workflow), [`github-issues`](/user-guide/skills/bundled/github/github-github-issues) |
-
-## 参考：完整 SKILL.md
-
-:::info
-以下是 Hermes 在触发此 skill 时加载的完整 skill 定义。这是 agent 在 skill 激活时所看到的指令内容。
-:::
-
-# GitHub 仓库管理
-
-创建、克隆、fork、配置和管理 GitHub 仓库。每个章节优先展示 `gh` 命令，然后是 `git` + `curl` 的备用方案。
-
-## 前提条件
-
-- 已通过 GitHub 认证（参见 `github-auth` skill）
-
-### 初始化设置
-
-```bash
-if command -v gh &>/dev/null && gh auth status &>/dev/null; then
-  AUTH="gh"
-else
-  AUTH="git"
-  if [ -z "$GITHUB_TOKEN" ]; then
-    if [ -f ~/.hermes/.env ] && grep -q "^GITHUB_TOKEN=" ~/.hermes/.env; then
-      GITHUB_TOKEN=$(grep "^GITHUB_TOKEN=" ~/.hermes/.env | head -1 | cut -d= -f2 | tr -d '\n\r')
-    elif grep -q "github.com" ~/.git-credentials 2>/dev/null; then
-      GITHUB_TOKEN=$(uv run python3 "${HERMES_HOME:-$HOME/.hermes}/skills/github/github-auth/scripts/git-credential-token.py")
-    fi
-  fi
-fi
-
-# Get your GitHub username (needed for several operations)
-if [ "$AUTH" = "gh" ]; then
-  GH_USER=$(gh api user --jq '.login')
-else
-  GH_USER=$(curl -s -H "Authorization: token $GITHUB_TOKEN" https://api.github.com/user | python3 -c "import sys,json; print(json.load(sys.stdin)['login'])")
-fi
-```
-
-如果已在某个仓库内：
-
-```bash
-REMOTE_URL=$(git remote get-url origin)
-OWNER_REPO=$(echo "$REMOTE_URL" | sed -E 's|.*github\.com[:/]||; s|\.git$||')
-OWNER=$(echo "$OWNER_REPO" | cut -d/ -f1)
-REPO=$(echo "$OWNER_REPO" | cut -d/ -f2)
-```
-
----
-
-## 1. 克隆仓库
-
-克隆使用纯 `git` 命令——两种方式完全一致：
-
-```bash
-# Clone via HTTPS (works with credential helper or token-embedded URL)
-git clone https://github.com/owner/repo-name.git
-
-# Clone into a specific directory
-git clone https://github.com/owner/repo-name.git ./my-local-dir
-
-# Shallow clone (faster for large repos)
-git clone --depth 1 https://github.com/owner/repo-name.git
-
-# Clone a specific branch
-git clone --branch develop https://github.com/owner/repo-name.git
-
-# Clone via SSH (if SSH is configured)
-git clone git@github.com:owner/repo-name.git
-```
-
-**使用 gh（简写）：**
-
-```bash
-gh repo clone owner/repo-name
-gh repo clone owner/repo-name -- --depth 1
-```
-
-## 2. 创建仓库
-
-**使用 gh：**
-
-```bash
-# Create a public repo and clone it
-gh repo create my-new-project --public --clone
-
-# Private, with description and license
-gh repo create my-new-project --private --description "A useful tool" --license MIT --clone
-
-# Under an organization
-gh repo create my-org/my-new-project --public --clone
-
-# From existing local directory
-cd /path/to/existing/project
-gh repo create my-project --source . --public --push
-```
-
-**使用 git + curl：**
-
-```bash
-# Create the remote repo via API
-curl -s -X POST \
-  -H "Authorization: token $GITHUB_TOKEN" \
-  https://api.github.com/user/repos \
-  -d '{
-    "name": "my-new-project",
-    "description": "A useful tool",
-    "private": false,
-    "auto_init": true,
-    "license_template": "mit"
-  }'
-
-# Clone it
-git clone https://github.com/$GH_USER/my-new-project.git
-cd my-new-project
-
-# -- OR -- push an existing local directory to the new repo
-cd /path/to/existing/project
-git init
-git add .
-git commit -m "Initial commit"
-git remote add origin https://github.com/$GH_USER/my-new-project.git
-git push -u origin main
-```
-
-在组织下创建：
-
-```bash
-curl -s -X POST \
-  -H "Authorization: token $GITHUB_TOKEN" \
-  https://api.github.com/orgs/my-org/repos \
-  -d '{"name": "my-new-project", "private": false}'
-```
-
-### 从模板创建
-
-**使用 gh：**
-
-```bash
-gh repo create my-new-app --template owner/template-repo --public --clone
-```
-
-**使用 curl：**
-
-```bash
-curl -s -X POST \
-  -H "Authorization: token $GITHUB_TOKEN" \
-  https://api.github.com/repos/owner/template-repo/generate \
-  -d '{"owner": "'"$GH_USER"'", "name": "my-new-app", "private": false}'
-```
-
-## 3. Fork 仓库
-
-**使用 gh：**
-
-```bash
-gh repo fork owner/repo-name --clone
-```
-
-**使用 git + curl：**
-
-```bash
-# Create the fork via API
-curl -s -X POST \
-  -H "Authorization: token $GITHUB_TOKEN" \
-  https://api.github.com/repos/owner/repo-name/forks
-
-# Wait a moment for GitHub to create it, then clone
-sleep 3
-git clone https://github.com/$GH_USER/repo-name.git
-cd repo-name
-
-# Add the original repo as "upstream" remote
-git remote add upstream https://github.com/owner/repo-name.git
-```
-
-### 保持 Fork 同步
-
-```bash
-# Pure git — works everywhere
-git fetch upstream
-git checkout main
-git merge upstream/main
-git push origin main
-```
-
-**使用 gh（快捷方式）：**
-
-```bash
-gh repo sync $GH_USER/repo-name
-```
-
-## 4. 仓库信息
-
-**使用 gh：**
-
-```bash
-gh repo view owner/repo-name
-gh repo list --limit 20
-gh search repos "machine learning" --language python --sort stars
-```
-
-**使用 curl：**
-
-```bash
-# View repo details
-curl -s \
-  -H "Authorization: token $GITHUB_TOKEN" \
-  https://api.github.com/repos/$OWNER/$REPO \
-  | python3 -c "
-import sys, json
-r = json.load(sys.stdin)
-print(f\"Name: {r['full_name']}\")
-print(f\"Description: {r['description']}\")
-print(f\"Stars: {r['stargazers_count']}  Forks: {r['forks_count']}\")
-print(f\"Default branch: {r['default_branch']}\")
-print(f\"Language: {r['language']}\")"
-
-# List your repos
-curl -s \
-  -H "Authorization: token $GITHUB_TOKEN" \
-  "https://api.github.com/user/repos?per_page=20&sort=updated" \
-  | python3 -c "
-import sys, json
-for r in json.load(sys.stdin):
-    vis = 'private' if r['private'] else 'public'
-    print(f\"  {r['full_name']:40}  {vis:8}  {r.get('language', ''):10}  ★{r['stargazers_count']}\")"
-
-# Search repos
-curl -s \
-  "https://api.github.com/search/repositories?q=machine+learning+language:python&sort=stars&per_page=10" \
-  | python3 -c "
-import sys, json
-for r in json.load(sys.stdin)['items']:
-    print(f\"  {r['full_name']:40}  ★{r['stargazers_count']:6}  {r['description'][:60] if r['description'] else ''}\")"
-```
-
-## 5. 仓库设置
-
-**使用 gh：**
-
-```bash
-gh repo edit --description "Updated description" --visibility public
-gh repo edit --enable-wiki=false --enable-issues=true
-gh repo edit --default-branch main
-gh repo edit --add-topic "machine-learning,python"
-gh repo edit --enable-auto-merge
-```
-
-**使用 curl：**
-
-```bash
-curl -s -X PATCH \
-  -H "Authorization: token $GITHUB_TOKEN" \
-  https://api.github.com/repos/$OWNER/$REPO \
-  -d '{
-    "description": "Updated description",
-    "has_wiki": false,
-    "has_issues": true,
-    "allow_auto_merge": true
-  }'
-
-# Update topics
-curl -s -X PUT \
-  -H "Authorization: token $GITHUB_TOKEN" \
-  -H "Accept: application/vnd.github.mercy-preview+json" \
-  https://api.github.com/repos/$OWNER/$REPO/topics \
-  -d '{"names": ["machine-learning", "python", "automation"]}'
-```
-
-## 6. 分支保护
-
-```bash
-# View current protection
-curl -s \
-  -H "Authorization: token $GITHUB_TOKEN" \
-  https://api.github.com/repos/$OWNER/$REPO/branches/main/protection
-
-# Set up branch protection
-curl -s -X PUT \
-  -H "Authorization: token $GITHUB_TOKEN" \
-  https://api.github.com/repos/$OWNER/$REPO/branches/main/protection \
-  -d '{
-    "required_status_checks": {
-      "strict": true,
-      "contexts": ["ci/test", "ci/lint"]
-    },
-    "enforce_admins": false,
-    "required_pull_request_reviews": {
-      "required_approving_review_count": 1
-    },
-    "restrictions": null
-  }'
-```
-
-## 7. Secrets 管理（GitHub Actions）
-
-**使用 gh：**
-
-```bash
-gh secret set API_KEY --body "your-secret-value"
-gh secret set SSH_KEY < ~/.ssh/id_rsa
-gh secret list
-gh secret delete API_KEY
-```
-
-**使用 curl：**
-
-通过 API 设置 secret 需要使用仓库公钥加密——步骤较为繁琐：
-
-```bash
-# Get the repo's public key for encrypting secrets
-curl -s \
-  -H "Authorization: token $GITHUB_TOKEN" \
-  https://api.github.com/repos/$OWNER/$REPO/actions/secrets/public-key
-
-# Encrypt and set (requires Python with PyNaCl)
-python3 -c "
-from base64 import b64encode
-from nacl import encoding, public
-import json, sys
-
-# Get the public key
-key_id = '<key_id_from_above>'
-public_key = '<base64_key_from_above>'
-
-# Encrypt
-sealed = public.SealedBox(
-    public.PublicKey(public_key.encode('utf-8'), encoding.Base64Encoder)
-).encrypt('your-secret-value'.encode('utf-8'))
-print(json.dumps({
-    'encrypted_value': b64encode(sealed).decode('utf-8'),
-    'key_id': key_id
-}))"
-
-# Then PUT the encrypted secret
-curl -s -X PUT \
-  -H "Authorization: token $GITHUB_TOKEN" \
-  https://api.github.com/repos/$OWNER/$REPO/actions/secrets/API_KEY \
-  -d '<output from python script above>'
-
-# List secrets (names only, values hidden)
-curl -s \
-  -H "Authorization: token $GITHUB_TOKEN" \
-  https://api.github.com/repos/$OWNER/$REPO/actions/secrets \
-  | python3 -c "
-import sys, json
-for s in json.load(sys.stdin)['secrets']:
-    print(f\"  {s['name']:30}  updated: {s['updated_at']}\")"
-```
-
-注意：对于 secret 管理，`gh secret set` 要简便得多。如果需要设置 secret 但 `gh` 不可用，建议仅为此操作安装它。
-
-## 8. 发布（Releases）
-
-**使用 gh：**
-
-```bash
-gh release create v1.0.0 --title "v1.0.0" --generate-notes
-gh release create v2.0.0-rc1 --draft --prerelease --generate-notes
-gh release create v1.0.0 ./dist/binary --title "v1.0.0" --notes "Release notes"
-gh release list
-gh release download v1.0.0 --dir ./downloads
-```
-
-**使用 curl：**
-
-```bash
-# Create a release
-curl -s -X POST \
-  -H "Authorization: token $GITHUB_TOKEN" \
-  https://api.github.com/repos/$OWNER/$REPO/releases \
-  -d '{
-    "tag_name": "v1.0.0",
-    "name": "v1.0.0",
-    "body": "## Changelog\n- Feature A\n- Bug fix B",
-    "draft": false,
-    "prerelease": false,
-    "generate_release_notes": true
-  }'
-
-# List releases
-curl -s \
-  -H "Authorization: token $GITHUB_TOKEN" \
-  https://api.github.com/repos/$OWNER/$REPO/releases \
-  | python3 -c "
-import sys, json
-for r in json.load(sys.stdin):
-    tag = r.get('tag_name', 'no tag')
-    print(f\"  {tag:15}  {r['name']:30}  {'draft' if r['draft'] else 'published'}\")"
-
-# Upload a release asset (binary file)
-RELEASE_ID=<id_from_create_response>
-curl -s -X POST \
-  -H "Authorization: token $GITHUB_TOKEN" \
-  -H "Content-Type: application/octet-stream" \
-  "https://uploads.github.com/repos/$OWNER/$REPO/releases/$RELEASE_ID/assets?name=binary-amd64" \
-  --data-binary @./dist/binary-amd64
-```
-
-## 9. GitHub Actions 工作流
-
-**使用 gh：**
-
-```bash
-gh workflow list
-gh run list --limit 10
-gh run view <RUN_ID>
-gh run view <RUN_ID> --log-failed
-gh run rerun <RUN_ID>
-gh run rerun <RUN_ID> --failed
-gh workflow run ci.yml --ref main
-gh workflow run deploy.yml -f environment=staging
-```
-
-**使用 curl：**
-
-```bash
-# List workflows
-curl -s \
-  -H "Authorization: token $GITHUB_TOKEN" \
-  https://api.github.com/repos/$OWNER/$REPO/actions/workflows \
-  | python3 -c "
-import sys, json
-for w in json.load(sys.stdin)['workflows']:
-    print(f\"  {w['id']:10}  {w['name']:30}  {w['state']}\")"
-
-# List recent runs
-curl -s \
-  -H "Authorization: token $GITHUB_TOKEN" \
-  "https://api.github.com/repos/$OWNER/$REPO/actions/runs?per_page=10" \
-  | python3 -c "
-import sys, json
-for r in json.load(sys.stdin)['workflow_runs']:
-    print(f\"  Run {r['id']}  {r['name']:30}  {r['conclusion'] or r['status']}\")"
-
-# Download failed run logs
-RUN_ID=<run_id>
-curl -s -L \
-  -H "Authorization: token $GITHUB_TOKEN" \
-  https://api.github.com/repos/$OWNER/$REPO/actions/runs/$RUN_ID/logs \
-  -o /tmp/ci-logs.zip
-cd /tmp && unzip -o ci-logs.zip -d ci-logs
-
-# Re-run a failed workflow
-curl -s -X POST \
-  -H "Authorization: token $GITHUB_TOKEN" \
-  https://api.github.com/repos/$OWNER/$REPO/actions/runs/$RUN_ID/rerun
-
-# Re-run only failed jobs
-curl -s -X POST \
-  -H "Authorization: token $GITHUB_TOKEN" \
-  https://api.github.com/repos/$OWNER/$REPO/actions/runs/$RUN_ID/rerun-failed-jobs
-
-# Trigger a workflow manually (workflow_dispatch)
-WORKFLOW_ID=<workflow_id_or_filename>
-curl -s -X POST \
-  -H "Authorization: token $GITHUB_TOKEN" \
-  https://api.github.com/repos/$OWNER/$REPO/actions/workflows/$WORKFLOW_ID/dispatches \
-  -d '{"ref": "main", "inputs": {"environment": "staging"}}'
-```
-
-## 10. Gists
-
-**使用 gh：**
-
-```bash
-gh gist create script.py --public --desc "Useful script"
-gh gist list
-```
-
-**使用 curl：**
-
-```bash
-# Create a gist
-curl -s -X POST \
-  -H "Authorization: token $GITHUB_TOKEN" \
-  https://api.github.com/gists \
-  -d '{
-    "description": "Useful script",
-    "public": true,
-    "files": {
-      "script.py": {"content": "print(\"hello\")"}
-    }
-  }'
-
-# List your gists
-curl -s \
-  -H "Authorization: token $GITHUB_TOKEN" \
-  https://api.github.com/gists \
-  | python3 -c "
-import sys, json
-for g in json.load(sys.stdin):
-    files = ', '.join(g['files'].keys())
-    print(f\"  {g['id']}  {g['description'] or '(no desc)':40}  {files}\")"
-```
-
-## 快速参考表
-
-| 操作 | gh | git + curl |
-|--------|-----|-----------|
-| 克隆 | `gh repo clone o/r` | `git clone https://github.com/o/r.git` |
-| 创建仓库 | `gh repo create name --public` | `curl POST /user/repos` |
-| Fork | `gh repo fork o/r --clone` | `curl POST /repos/o/r/forks` + `git clone` |
-| 仓库信息 | `gh repo view o/r` | `curl GET /repos/o/r` |
-| 编辑设置 | `gh repo edit --...` | `curl PATCH /repos/o/r` |
-| 创建发布 | `gh release create v1.0` | `curl POST /repos/o/r/releases` |
-| 列出工作流 | `gh workflow list` | `curl GET /repos/o/r/actions/workflows` |
-| 重跑 CI | `gh run rerun ID` | `curl POST /repos/o/r/actions/runs/ID/rerun` |
-| 设置 secret | `gh secret set KEY` | `curl PUT /repos/o/r/actions/secrets/KEY`（需加密） |

package/docs/80_upstream-docs-and-skills/hermes-dev-skill/src/i18n/zh-Hans/user-guide/skills/bundled/media/media-gif-search.md

@@ -1,106 +0,0 @@
----
-title: "Gif Search — 通过 curl + jq 搜索/下载 Tenor GIF"
-sidebar_label: "Gif Search"
-description: "通过 curl + jq 搜索/下载 Tenor GIF"
----
-
-{/* This page is auto-generated from the skill's SKILL.md by website/scripts/generate-skill-docs.py. Edit the source SKILL.md, not this page. */}
-
-# Gif Search
-
-通过 curl + jq 搜索/下载 Tenor GIF。
-
-## Skill 元数据
-
-| | |
-|---|---|
-| 来源 | 内置（默认安装） |
-| 路径 | `skills/media/gif-search` |
-| 版本 | `1.1.0` |
-| 作者 | Hermes Agent |
-| 许可证 | MIT |
-| 平台 | linux, macos, windows |
-| 标签 | `GIF`, `Media`, `Search`, `Tenor`, `API` |
-
-## 参考：完整 SKILL.md
-
-:::info
-以下是 Hermes 在触发该 skill 时加载的完整 skill 定义。这是 agent 在 skill 激活时所看到的指令内容。
-:::
-
-# GIF Search（Tenor API）
-
-通过 Tenor API 使用 curl 直接搜索和下载 GIF，无需额外工具。
-
-## 使用场景
-
-适用于查找反应 GIF、创建视觉内容以及在聊天中发送 GIF。
-
-## 配置
-
-在环境中设置 Tenor API 密钥（添加到 `~/.hermes/.env`）：
-
-```bash
-TENOR_API_KEY=your_key_here
-```
-
-在 https://developers.google.com/tenor/guides/quickstart 免费获取 API 密钥 —— Google Cloud Console Tenor API 密钥免费且具有较高的速率限制。
-
-## 前置条件
-
-- `curl` 和 `jq`（macOS/Linux 标准工具）
-- `TENOR_API_KEY` 环境变量
-
-## 搜索 GIF
-
-```bash
-# 搜索并获取 GIF URL
-curl -s "https://tenor.googleapis.com/v2/search?q=thumbs+up&limit=5&key=${TENOR_API_KEY}" | jq -r '.results[].media_formats.gif.url'
-
-# 获取较小的预览版本
-curl -s "https://tenor.googleapis.com/v2/search?q=nice+work&limit=3&key=${TENOR_API_KEY}" | jq -r '.results[].media_formats.tinygif.url'
-```
-
-## 下载 GIF
-
-```bash
-# 搜索并下载排名第一的结果
-URL=$(curl -s "https://tenor.googleapis.com/v2/search?q=celebration&limit=1&key=${TENOR_API_KEY}" | jq -r '.results[0].media_formats.gif.url')
-curl -sL "$URL" -o celebration.gif
-```
-
-## 获取完整元数据
-
-```bash
-curl -s "https://tenor.googleapis.com/v2/search?q=cat&limit=3&key=${TENOR_API_KEY}" | jq '.results[] | {title: .title, url: .media_formats.gif.url, preview: .media_formats.tinygif.url, dimensions: .media_formats.gif.dims}'
-```
-
-## API 参数
-
-| 参数 | 说明 |
-|-----------|-------------|
-| `q` | 搜索查询（空格用 `+` 进行 URL 编码） |
-| `limit` | 最大结果数（1-50，默认 20） |
-| `key` | API 密钥（来自 `$TENOR_API_KEY` 环境变量） |
-| `media_filter` | 过滤格式：`gif`、`tinygif`、`mp4`、`tinymp4`、`webm` |
-| `contentfilter` | 安全级别：`off`、`low`、`medium`、`high` |
-| `locale` | 语言：`en_US`、`es`、`fr` 等 |
-
-## 可用媒体格式
-
-每个结果在 `.media_formats` 下包含多种格式：
-
-| 格式 | 使用场景 |
-|--------|----------|
-| `gif` | 完整质量 GIF |
-| `tinygif` | 小型预览 GIF |
-| `mp4` | 视频版本（文件体积更小） |
-| `tinymp4` | 小型预览视频 |
-| `webm` | WebM 视频 |
-| `nanogif` | 微型缩略图 |
-
-## 注意事项
-
-- 对查询进行 URL 编码：空格用 `+`，特殊字符用 `%XX`
-- 在聊天中发送时，`tinygif` URL 更轻量
-- GIF URL 可直接用于 markdown：`![alt](https://github.com/NousResearch/hermes-agent/blob/main/skills/media/gif-search/url)`