npm - @baimingtao/lbs-agent - Versions diffs - 1.0.0 - Mend

@baimingtao/lbs-agent 1.0.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (1114) hide show

package/extensions/skills/builtin/email/himalaya/references/message-composition.md ADDED Viewed

@@ -0,0 +1,199 @@
+# 使用 MML (MIME Meta Language) 撰写邮件
+Himalaya 使用 MML 来撰写邮件。MML 是一种简单的基于 XML 的语法，可编译为 MIME 邮件。
+## 基本邮件结构
+一封邮件由一系列**邮件头** (headers) 和一个**邮件正文** (body) 组成，中间由空行分隔：
+```
+From: sender@example.com
+To: recipient@example.com
+Subject: Hello World
+This is the message body.
+```
+## 邮件头
+常用的邮件头：
+- `From`: 发件人地址
+- `To`: 主要收件人
+- `Cc`: 抄送收件人
+- `Bcc`: 密送收件人
+- `Subject`: 邮件主题
+- `Reply-To`: 回复地址（如果与发件人不同）
+- `In-Reply-To`: 正在回复的邮件 ID
+### 地址格式
+```
+To: user@example.com
+To: John Doe <john@example.com>
+To: "John Doe" <john@example.com>
+To: user1@example.com, user2@example.com, "Jane" <jane@example.com>
+```
+## 纯文本邮件正文
+简单的纯文本邮件：
+```
+From: alice@localhost
+To: bob@localhost
+Subject: Plain Text Example
+Hello, this is a plain text email.
+No special formatting needed.
+Best,
+Alice
+```
+## 使用 MML 撰写富文本邮件
+### 多部分邮件 (Multipart Messages)
+可选的 text/html 部分：
+```
+From: alice@localhost
+To: bob@localhost
+Subject: Multipart Example
+<#multipart type=alternative>
+This is the plain text version.
+<#part type=text/html>
+<html><body><h1>This is the HTML version</h1></body></html>
+<#/multipart>
+```
+### 附件
+添加附件文件：
+```
+From: alice@localhost
+To: bob@localhost
+Subject: With Attachment
+Here is the document you requested.
+<#part filename=/path/to/document.pdf><#/part>
+```
+使用自定义名称添加附件：
+```
+<#part filename=/path/to/file.pdf name=report.pdf><#/part>
+```
+添加多个附件：
+```
+<#part filename=/path/to/doc1.pdf><#/part>
+<#part filename=/path/to/doc2.pdf><#/part>
+```
+### 内嵌图片 (Inline Images)
+将图片以内嵌方式插入：
+```
+From: alice@localhost
+To: bob@localhost
+Subject: Inline Image
+<#multipart type=related>
+<#part type=text/html>
+<html><body>
+<p>Check out this image:</p>
+<img src="cid:image1">
+</body></html>
+<#part disposition=inline id=image1 filename=/path/to/image.png><#/part>
+<#/multipart>
+```
+### 混合内容（正文 + 附件）
+```
+From: alice@localhost
+To: bob@localhost
+Subject: Mixed Content
+<#multipart type=mixed>
+<#part type=text/plain>
+Please find the attached files.
+Best,
+Alice
+<#part filename=/path/to/file1.pdf><#/part>
+<#part filename=/path/to/file2.zip><#/part>
+<#/multipart>
+```
+## MML 标签参考
+### `<#multipart>`
+将多个部分组合在一起。
+- `type=alternative`: 相同内容的不同表现形式
+- `type=mixed`: 独立的部分（正文 + 附件）
+- `type=related`: 相互引用的部分（HTML + 图片）
+### `<#part>`
+定义邮件的某个部分。
+- `type=<mime-type>`: 内容类型（例如 `text/html`, `application/pdf`）
+- `filename=<path>`: 要添加为附件的文件路径
+- `name=<name>`: 附件的显示名称
+- `disposition=inline`: 以内嵌方式显示，而不是作为附件显示
+- `id=<cid>`: 用于在 HTML 中引用的 Content ID
+## 从命令行 (CLI) 撰写
+### 交互式撰写
+打开你的 `$EDITOR`：
+```bash
+himalaya message write
+```
+### 回复（打开编辑器并引用原邮件）
+```bash
+himalaya message reply 42
+himalaya message reply 42 --all  # reply-all
+```
+### 转发
+```bash
+himalaya message forward 42
+```
+### 通过 stdin 发送
+```bash
+cat message.txt | himalaya template send
+```
+### 从命令行预填邮件头
+```bash
+himalaya message write \
+  -H "To:recipient@example.com" \
+  -H "Subject:Quick Message" \
+  "Message body here"
+```
+## 提示
+- 编辑器会打开一个模板；请填写邮件头和正文。
+- 保存并退出编辑器即可发送；不保存退出则取消发送。
+- 发送时，MML 部分会被编译为正确的 MIME 结构。
+- 使用 `himalaya message export --full` 可以检查已接收邮件的原始 MIME 结构。

package/extensions/skills/builtin/github/DESCRIPTION.md ADDED Viewed

@@ -0,0 +1,3 @@
+---
+description: 使用 `gh` CLI 和终端中的 `git` 来管理仓库、Pull Request、代码审查、Issue 以及 CI/CD pipeline 的 GitHub workflow 技能。
+---

package/extensions/skills/builtin/github/codebase-inspection/SKILL.md ADDED Viewed

@@ -0,0 +1,116 @@
+---
+name: codebase-inspection
+description: "使用 pygount 检查代码库：LOC、语言、比例。"
+version: 1.0.0
+author: Hermes Agent
+license: MIT
+platforms: [linux, macos, windows]
+metadata:
+  hermes:
+    tags: [LOC, Code Analysis, pygount, Codebase, Metrics, Repository]
+    related_skills: [github-repo-management]
+prerequisites:
+  commands: [pygount]
+---
+# 使用 pygount 进行代码库检查
+使用 `pygount` 分析代码库的代码行数、语言构成、文件数量以及代码与注释的比例。
+## 何时使用
+- 用户要求计算 LOC（代码行数）
+- 用户想要查看代码库的语言构成
+- 用户询问代码库的规模或组成
+- 用户想要了解代码与注释的比例
+- 一般性的“这个代码库有多大”的问题
+## 前置条件
+```bash
+pip install --break-system-packages pygount 2>/dev/null || pip install pygount
+```
+## 1. 基本摘要（最常用）
+获取包含文件数量、代码行数和注释行数的完整语言构成分析：
+```bash
+cd /path/to/repo
+pygount --format=summary \
+  --folders-to-skip=".git,node_modules,venv,.venv,__pycache__,.cache,dist,build,.next,.tox,.eggs,*.egg-info" \
+  .
+```
+**重要提示：** 务必使用 `--folders-to-skip` 排除依赖项和构建目录，否则 pygount 将遍历这些目录，导致耗时极长或程序卡死。
+## 2. 常见的文件夹排除项
+根据项目类型进行调整：
+```bash
+# Python projects
+--folders-to-skip=".git,venv,.venv,__pycache__,.cache,dist,build,.tox,.eggs,.mypy_cache"
+# JavaScript/TypeScript projects
+--folders-to-skip=".git,node_modules,dist,build,.next,.cache,.turbo,coverage"
+# General catch-all
+--folders-to-skip=".git,node_modules,venv,.venv,__pycache__,.cache,dist,build,.next,.tox,vendor,third_party"
+```
+## 3. 按特定语言过滤
+```bash
+# Only count Python files
+pygount --suffix=py --format=summary .
+# Only count Python and YAML
+pygount --suffix=py,yaml,yml --format=summary .
+```
+## 4. 详细的逐文件输出
+```bash
+# Default format shows per-file breakdown
+pygount --folders-to-skip=".git,node_modules,venv" .
+# Sort by code lines (pipe through sort)
+pygount --folders-to-skip=".git,node_modules,venv" . | sort -t$'\t' -k1 -nr | head -20
+```
+## 5. 输出格式
+```bash
+# Summary table (default recommendation)
+pygount --format=summary .
+# JSON output for programmatic use
+pygount --format=json .
+# Pipe-friendly: Language, file count, code, docs, empty, string
+pygount --format=summary . 2>/dev/null
+```
+## 6. 解读结果
+摘要表格的各列含义：
+- **Language** — 检测到的编程语言
+- **Files** — 该语言的文件数量
+- **Code** — 实际代码行数（可执行/声明性）
+- **Comment** — 作为注释或文档的行数
+- **%** — 占总量的百分比
+特殊的伪语言：
+- `__empty__` — 空文件
+- `__binary__` — 二进制文件（图像、编译文件等）
+- `__generated__` — 自动生成的文件（通过启发式算法检测）
+- `__duplicate__` — 内容完全相同的文件
+- `__unknown__` — 无法识别的文件类型
+## 常见陷阱
+1. **务必排除 .git, node_modules, venv** — 如果不使用 `--folders-to-skip`，pygount 会遍历所有内容，在处理庞大的依赖树时可能需要数分钟甚至导致卡死。
+2. **Markdown 显示代码行数为 0** — pygount 会将所有的 Markdown 内容归类为注释，而不是代码。这是预期内的正常行为。
+3. **JSON 文件显示的代码计数偏低** — pygount 对 JSON 行数的统计可能偏向保守。若需要准确的 JSON 行数，请直接使用 `wc -l`。
+4. **大型 monorepos** — 对于非常庞大的代码库，建议使用 `--suffix` 指定特定语言，而不是扫描所有内容。

package/extensions/skills/builtin/github/github-auth/SKILL.md ADDED Viewed

@@ -0,0 +1,247 @@
+---
+name: github-auth
+description: "GitHub 身份验证设置：HTTPS token、SSH key、gh CLI 登录。"
+version: 1.1.0
+author: Hermes Agent
+license: MIT
+platforms: [linux, macos, windows]
+metadata:
+  hermes:
+    tags: [GitHub, Authentication, Git, gh-cli, SSH, Setup]
+    related_skills: [github-pr-workflow, github-code-review, github-issues, github-repo-management]
+---
+# GitHub 身份验证设置
+此 skill 用于设置身份验证，以便 agent 能够操作 GitHub repositories、PR、issues 和 CI。它涵盖两种方式：
+- **`git` (始终可用)** — 使用 HTTPS personal access token 或 SSH key
+- **`gh` CLI (如果已安装)** — 提供更丰富的 GitHub API 访问权限，且身份验证流程更简单
+## 检测流程
+当用户要求你操作 GitHub 时，请先运行此检查：
+```bash
+# Check what's available
+git --version
+gh --version 2>/dev/null || echo "gh not installed"
+# Check if already authenticated
+gh auth status 2>/dev/null || echo "gh not authenticated"
+git config --global credential.helper 2>/dev/null || echo "no git credential helper"
+```
+**决策树：**
+1. 如果 `gh auth status` 显示已通过身份验证 → 一切正常，所有操作均可使用 `gh`
+2. 如果 `gh` 已安装但未通过身份验证 → 使用下方的 "gh auth" 方法
+3. 如果 `gh` 未安装 → 使用下方的 "仅使用 git" 方法（无需 sudo）
+---
+## 方法 1：仅使用 Git 进行身份验证（无 gh，无 sudo）
+此方法适用于任何已安装 `git` 的机器。无需 root 权限。
+### 选项 A：使用 Personal Access Token 进行 HTTPS 认证（推荐）
+这是通用性最强的方法 — 处处适用，无需配置 SSH。
+**第 1 步：创建 personal access token**
+告诉用户访问：**https://github.com/settings/tokens**
+- 点击 "Generate new token (classic)"
+- 为其命名，例如 "hermes-agent"
+- 选择权限范围（scopes）：
+  - `repo`（完整的 repository 访问权限 — 读取、写入、push、PR）
+  - `workflow`（触发和管理 GitHub Actions）
+  - `read:org`（如果需要操作 organization 的 repo）
+- 设置过期时间（90 天是个不错的默认值）
+- 复制 token — 它不会再次显示
+**第 2 步：配置 git 以存储 token**
+```bash
+# Set up the credential helper to cache credentials
+# "store" saves to ~/.git-credentials in plaintext (simple, persistent)
+git config --global credential.helper store
+# Now do a test operation that triggers auth — git will prompt for credentials
+# Username: <their-github-username>
+# Password: <paste the personal access token, NOT their GitHub password>
+git ls-remote https://github.com/<their-username>/<any-repo>.git
+```
+输入一次凭据后，它们就会被保存并在未来的所有操作中重复使用。
+**替代方案：cache helper（凭据会在内存中过期）**
+```bash
+# Cache in memory for 8 hours (28800 seconds) instead of saving to disk
+git config --global credential.helper 'cache --timeout=28800'
+```
+**替代方案：在 remote URL 中直接设置 token（按 repo 划分）**
+```bash
+# Embed token in the remote URL (avoids credential prompts entirely)
+git remote set-url origin https://<username>:<token>@github.com/<owner>/<repo>.git
+```
+**第 3 步：配置 git 身份**
+```bash
+# Required for commits — set name and email
+git config --global user.name "Their Name"
+git config --global user.email "their-email@example.com"
+```
+**第 4 步：验证**
+```bash
+# Test push access (this should work without any prompts now)
+git ls-remote https://github.com/<their-username>/<any-repo>.git
+# Verify identity
+git config --global user.name
+git config --global user.email
+```
+### 选项 B：SSH Key 身份验证
+适合偏好使用 SSH 或已经设置好 SSH key 的用户。
+**第 1 步：检查现有的 SSH key**
+```bash
+ls -la ~/.ssh/id_*.pub 2>/dev/null || echo "No SSH keys found"
+```
+**第 2 步：如有需要，生成一个 key**
+```bash
+# Generate an ed25519 key (modern, secure, fast)
+ssh-keygen -t ed25519 -C "their-email@example.com" -f ~/.ssh/id_ed25519 -N ""
+# Display the public key for them to add to GitHub
+cat ~/.ssh/id_ed25519.pub
+```
+告诉用户在以下地址添加公钥：**https://github.com/settings/keys**
+- 点击 "New SSH key"
+- 粘贴公钥内容
+- 为其设置一个标题，例如 "hermes-agent-<machine-name>"
+**第 3 步：测试连接**
+```bash
+ssh -T git@github.com
+# Expected: "Hi <username>! You've successfully authenticated..."
+```
+**第 4 步：配置 git 对 GitHub 使用 SSH**
+```bash
+# Rewrite HTTPS GitHub URLs to SSH automatically
+git config --global url."git@github.com:".insteadOf "https://github.com/"
+```
+**第 5 步：配置 git 身份**
+```bash
+git config --global user.name "Their Name"
+git config --global user.email "their-email@example.com"
+```
+---
+## 方法 2：gh CLI 身份验证
+如果已安装 `gh`，它可以一步处理 API 访问和 git 凭据。
+### 交互式浏览器登录（桌面端）
+```bash
+gh auth login
+# Select: GitHub.com
+# Select: HTTPS
+# Authenticate via browser
+```
+### 基于 Token 的登录（无图形界面 / SSH 服务器）
+```bash
+echo "<THEIR_TOKEN>" | gh auth login --with-token
+# Set up git credentials through gh
+gh auth setup-git
+```
+### 验证
+```bash
+gh auth status
+```
+---
+## 不使用 gh 调用 GitHub API
+当 `gh` 不可用时，你仍然可以使用 `curl` 和 personal access token 访问完整的 GitHub API。其他 GitHub skill 也是通过这种方式实现备用机制的。
+### 为 API 调用设置 Token
+```bash
+# Option 1: Export as env var (preferred — keeps it out of commands)
+export GITHUB_TOKEN="<token>"
+# Then use in curl calls:
+curl -s -H "Authorization: token $GITHUB_TOKEN" \
+  https://api.github.com/user
+```
+### 从 Git 凭据中提取 Token
+如果已配置 git 凭据（通过 `credential.helper store`），则可以提取 token：
+```bash
+# Read from git credential store
+grep "github.com" ~/.git-credentials 2>/dev/null | head -1 | sed 's|https://[^:]*:\([^@]*\)@.*|\1|'
+```
+### 辅助工具：检测身份验证方式
+在任何 GitHub 工作流开始时使用此模式：
+```bash
+# Try gh first, fall back to git + curl
+if command -v gh &>/dev/null && gh auth status &>/dev/null; then
+  echo "AUTH_METHOD=gh"
+elif [ -n "$GITHUB_TOKEN" ]; then
+  echo "AUTH_METHOD=curl"
+elif _hermes_env="${HERMES_HOME:-$HOME/.hermes}/.env"; [ -f "$_hermes_env" ] && grep -q "^GITHUB_TOKEN=" "$_hermes_env"; then
+  export GITHUB_TOKEN=$(grep "^GITHUB_TOKEN=" "$_hermes_env" | head -1 | cut -d= -f2 | tr -d '\n\r')
+  echo "AUTH_METHOD=curl"
+elif grep -q "github.com" ~/.git-credentials 2>/dev/null; then
+  export GITHUB_TOKEN=$(grep "github.com" ~/.git-credentials | head -1 | sed 's|https://[^:]*:\([^@]*\)@.*|\1|')
+  echo "AUTH_METHOD=curl"
+else
+  echo "AUTH_METHOD=none"
+  echo "Need to set up authentication first"
+fi
+```
+---
+## 故障排查
+| 问题 | 解决方案 |
+| --------- | ---------- |
+| `git push` 要求输入密码 | GitHub 已禁用密码验证。请使用 personal access token 作为密码，或切换至 SSH |
+| `remote: Permission to X denied` | Token 可能缺少 `repo` 权限范围 — 请使用正确的权限范围重新生成 |
+| `fatal: Authentication failed` | 缓存的凭据可能已过期 — 请运行 `git credential reject` 然后重新验证 |
+| `ssh: connect to host github.com port 22: Connection refused` | 尝试通过 HTTPS 端口使用 SSH：在 `~/.ssh/config` 中添加 `Host github.com`，并设置 `Port 443` 和 `Hostname ssh.github.com` |
+| 凭据未持久化 | 检查 `git config --global credential.helper` — 必须设置为 `store` 或 `cache` |
+| 多个 GitHub 账号 | 在 `~/.ssh/config` 中针对不同的主机别名使用不同的 SSH key，或者按 repo 使用带凭据的 URL |
+| `gh: command not found` + 无 sudo | 使用上方无需安装的方法 1（仅使用 git） |

package/extensions/skills/builtin/github/github-auth/scripts/gh-env.sh ADDED Viewed

@@ -0,0 +1,66 @@
+#!/usr/bin/env bash
+# GitHub environment detection helper for Hermes Agent skills.
+#
+# Usage (via terminal tool):
+#   source skills/github/github-auth/scripts/gh-env.sh
+#
+# After sourcing, these variables are set:
+#   GH_AUTH_METHOD  - "gh", "curl", or "none"
+#   GITHUB_TOKEN    - personal access token (set if method is "curl")
+#   GH_USER         - GitHub username
+#   GH_OWNER        - repo owner  (only if inside a git repo with a github remote)
+#   GH_REPO         - repo name   (only if inside a git repo with a github remote)
+#   GH_OWNER_REPO   - owner/repo  (only if inside a git repo with a github remote)
+# --- Auth detection ---
+GH_AUTH_METHOD="none"
+GITHUB_TOKEN="${GITHUB_TOKEN:-}"
+GH_USER=""
+if command -v gh &>/dev/null && gh auth status &>/dev/null 2>&1; then
+    GH_AUTH_METHOD="gh"
+    GH_USER=$(gh api user --jq '.login' 2>/dev/null)
+elif [ -n "$GITHUB_TOKEN" ]; then
+    GH_AUTH_METHOD="curl"
+elif _hermes_env="${HERMES_HOME:-$HOME/.hermes}/.env"; [ -f "$_hermes_env" ] && grep -q "^GITHUB_TOKEN=" "$_hermes_env" 2>/dev/null; then
+    GITHUB_TOKEN=$(grep "^GITHUB_TOKEN=" "$_hermes_env" | head -1 | cut -d= -f2 | tr -d '\n\r')
+    if [ -n "$GITHUB_TOKEN" ]; then
+        GH_AUTH_METHOD="curl"
+    fi
+elif [ -f "$HOME/.git-credentials" ] && grep -q "github.com" "$HOME/.git-credentials" 2>/dev/null; then
+    GITHUB_TOKEN=$(grep "github.com" "$HOME/.git-credentials" | head -1 | sed 's|https://[^:]*:\([^@]*\)@.*|\1|')
+    if [ -n "$GITHUB_TOKEN" ]; then
+        GH_AUTH_METHOD="curl"
+    fi
+fi
+# Resolve username for curl method
+if [ "$GH_AUTH_METHOD" = "curl" ] && [ -z "$GH_USER" ]; then
+    GH_USER=$(curl -s -H "Authorization: token $GITHUB_TOKEN" \
+        https://api.github.com/user 2>/dev/null \
+        | python3 -c "import sys,json; print(json.load(sys.stdin).get('login',''))" 2>/dev/null)
+fi
+# --- Repo detection (if inside a git repo with a GitHub remote) ---
+GH_OWNER=""
+GH_REPO=""
+GH_OWNER_REPO=""
+_remote_url=$(git remote get-url origin 2>/dev/null)
+if [ -n "$_remote_url" ] && echo "$_remote_url" | grep -q "github.com"; then
+    GH_OWNER_REPO=$(echo "$_remote_url" | sed -E 's|.*github\.com[:/]||; s|\.git$||')
+    GH_OWNER=$(echo "$GH_OWNER_REPO" | cut -d/ -f1)
+    GH_REPO=$(echo "$GH_OWNER_REPO" | cut -d/ -f2)
+fi
+unset _remote_url
+# --- Summary ---
+echo "GitHub Auth: $GH_AUTH_METHOD"
+[ -n "$GH_USER" ]       && echo "User: $GH_USER"
+[ -n "$GH_OWNER_REPO" ] && echo "Repo: $GH_OWNER_REPO"
+[ "$GH_AUTH_METHOD" = "none" ] && echo "⚠ Not authenticated — see github-auth skill"
+export GH_AUTH_METHOD GITHUB_TOKEN GH_USER GH_OWNER GH_REPO GH_OWNER_REPO