@baimingtao/lbs-agent 1.0.0

package/extensions/skills/optional/productivity/canvas/scripts/canvas_api.py

@@ -0,0 +1,160 @@
+#!/usr/bin/env python3
+"""Canvas LMS API CLI for Hermes Agent.
+
+A thin CLI wrapper around the Canvas REST API.
+Authenticates using a personal access token from environment variables.
+
+Usage:
+  python canvas_api.py list_courses [--per-page N] [--enrollment-state STATE]
+  python canvas_api.py list_assignments COURSE_ID [--per-page N] [--order-by FIELD]
+"""
+
+import argparse
+import json
+import os
+import sys
+
+import requests
+
+CANVAS_API_TOKEN = os.environ.get("CANVAS_API_TOKEN", "")
+CANVAS_BASE_URL = os.environ.get("CANVAS_BASE_URL", "").rstrip("/")
+
+
+def _check_config():
+    """Validate required environment variables are set."""
+    missing = []
+    if not CANVAS_API_TOKEN:
+        missing.append("CANVAS_API_TOKEN")
+    if not CANVAS_BASE_URL:
+        missing.append("CANVAS_BASE_URL")
+    if missing:
+        hermes_env = os.path.join(
+            os.environ.get("HERMES_HOME", os.path.expanduser("~/.hermes")), ".env"
+        )
+        print(
+            f"Missing required environment variables: {', '.join(missing)}\n"
+            f"Set them in {hermes_env} or export them in your shell.\n"
+            "See the canvas skill SKILL.md for setup instructions.",
+            file=sys.stderr,
+        )
+        sys.exit(1)
+
+
+def _headers():
+    return {"Authorization": f"Bearer {CANVAS_API_TOKEN}"}
+
+
+def _paginated_get(url, params=None, max_items=200):
+    """Fetch all pages up to max_items, following Canvas Link headers."""
+    results = []
+    while url and len(results) < max_items:
+        resp = requests.get(url, headers=_headers(), params=params, timeout=30)
+        resp.raise_for_status()
+        results.extend(resp.json())
+        params = None  # 后续页面的链接 URL 中包含了参数
+        url = None
+        link = resp.headers.get("Link", "")
+        for part in link.split(","):
+            if 'rel="next"' in part:
+                url = part.split(";")[0].strip().strip("<>")
+    return results[:max_items]
+
+
+# =========================================================================
+# 命令
+# =========================================================================
+
+
+def list_courses(args):
+    """List enrolled courses."""
+    _check_config()
+    url = f"{CANVAS_BASE_URL}/api/v1/courses"
+    params = {"per_page": args.per_page}
+    if args.enrollment_state:
+        params["enrollment_state"] = args.enrollment_state
+    try:
+        courses = _paginated_get(url, params)
+    except requests.HTTPError as e:
+        print(f"API error: {e.response.status_code} {e.response.text}", file=sys.stderr)
+        sys.exit(1)
+    output = [
+        {
+            "id": c["id"],
+            "name": c.get("name", ""),
+            "course_code": c.get("course_code", ""),
+            "enrollment_term_id": c.get("enrollment_term_id"),
+            "start_at": c.get("start_at"),
+            "end_at": c.get("end_at"),
+            "workflow_state": c.get("workflow_state", ""),
+        }
+        for c in courses
+    ]
+    print(json.dumps(output, indent=2))
+
+
+def list_assignments(args):
+    """List assignments for a course."""
+    _check_config()
+    url = f"{CANVAS_BASE_URL}/api/v1/courses/{args.course_id}/assignments"
+    params = {"per_page": args.per_page}
+    if args.order_by:
+        params["order_by"] = args.order_by
+    try:
+        assignments = _paginated_get(url, params)
+    except requests.HTTPError as e:
+        print(f"API error: {e.response.status_code} {e.response.text}", file=sys.stderr)
+        sys.exit(1)
+    output = [
+        {
+            "id": a["id"],
+            "name": a.get("name", ""),
+            "description": (a.get("description") or "")[:500],
+            "due_at": a.get("due_at"),
+            "points_possible": a.get("points_possible"),
+            "submission_types": a.get("submission_types", []),
+            "html_url": a.get("html_url", ""),
+            "course_id": a.get("course_id"),
+        }
+        for a in assignments
+    ]
+    print(json.dumps(output, indent=2))
+
+
+# =========================================================================
+# 命令行解析器
+# =========================================================================
+
+
+def main():
+    parser = argparse.ArgumentParser(
+        description="Canvas LMS API CLI for Hermes Agent"
+    )
+    sub = parser.add_subparsers(dest="command", required=True)
+
+    # --- list_courses ---
+    p = sub.add_parser("list_courses", help="List enrolled courses")
+    p.add_argument("--per-page", type=int, default=50, help="Results per page (default 50)")
+    p.add_argument(
+        "--enrollment-state",
+        default="",
+        help="Filter by enrollment state (active, invited_or_pending, completed)",
+    )
+    p.set_defaults(func=list_courses)
+
+    # --- list_assignments ---
+    p = sub.add_parser("list_assignments", help="List assignments for a course")
+    p.add_argument("course_id", help="Canvas course ID")
+    p.add_argument("--per-page", type=int, default=50, help="Results per page (default 50)")
+    p.add_argument(
+        "--order-by",
+        default="",
+        help="Order by field (due_at, name, position)",
+    )
+    p.set_defaults(func=list_assignments)
+
+    args = parser.parse_args()
+    args.func(args)
+
+
+if __name__ == "__main__":
+    main()

package/extensions/skills/optional/productivity/here-now/SKILL.md

@@ -0,0 +1,217 @@
+---
+name: here.now
+description: 将静态站点发布到 {slug}.here.now，并将私有文件存储在云端 Drive 中以供 agent 间传递。
+version: 1.15.3
+author: here.now
+license: MIT
+prerequisites:
+  commands: [curl, file, jq]
+platforms: [macos, linux]
+metadata:
+  hermes:
+    tags: [here.now, herenow, publish, deploy, hosting, static-site, web, share, URL, drive, storage]
+    homepage: https://here.now
+    requires_toolsets: [terminal]
+---
+
+# here.now
+
+here.now 允许 agent 发布网站并将私有文件存储在云端 Drive 中。
+
+使用 here.now 主要有两项功能：
+
+- **Sites**：在 `{slug}.here.now` 发布网站和文件。
+- **Drives**：在云文件夹中存储私有的 agent 文件。
+
+## 当前文档
+
+**在回答有关 here.now 的功能、特性或工作流程的问题之前，请阅读最新文档：**
+
+→ **https://here.now/docs**
+
+阅读文档的时机：
+
+- 在对话中首次涉及 here.now 相关交互时
+- 当用户询问如何执行某项操作时
+- 当用户询问哪些功能可行、受支持或被推荐时
+- 在告知用户某项功能不受支持之前
+
+需要查阅最新文档的主题（不要仅依赖本地技能文本）：
+
+- Drives 及 Drive 共享
+- 自定义域名
+- 支付与支付门槛
+- fork
+- 代理路由和服务变量
+- handles 和 links
+- 限制与配额
+- SPA routing
+- 错误处理与修复
+- 功能可用性
+
+**如果文档与实际 API 行为不一致，请以实际 API 行为为准。**
+
+如果获取文档失败或超时，请继续使用本地技能以及实际的 API/脚本输出。在进行实际操作时，请优先参考实际的 API 行为。
+
+## 要求
+
+- 必需的二进制文件：`curl`, `file`, `jq`
+- 可选的环境变量：`$HERENOW_API_KEY`
+- 可选的 Drive token 变量：`$HERENOW_DRIVE_TOKEN`
+- 可选的凭证文件：`~/.herenow/credentials`
+- 技能辅助脚本路径：
+  - `${HERMES_SKILL_DIR}/scripts/publish.sh` 用于发布站点
+  - `${HERMES_SKILL_DIR}/scripts/drive.sh` 用于私有 Drive 存储
+
+## 创建站点
+
+```bash
+PUBLISH="${HERMES_SKILL_DIR}/scripts/publish.sh"
+bash "$PUBLISH" {file-or-dir} --client hermes
+```
+
+输出实际的 URL（例如 `https://bright-canvas-a7k2.here.now/`）。
+
+在底层，这是一个分为三步的流程：创建/更新 -> 上传文件 -> 完成。在“完成”步骤成功之前，站点不会上线。
+
+如果没有 API key，这将创建一个会在 24 小时后过期的**匿名站点**。
+如果保存了 API key，则该站点是永久的。
+
+**文件结构：** 对于 HTML 站点，请将 `index.html` 放置在你要发布目录的根目录下，而不是子目录中。该目录的内容将成为站点的根目录。例如，发布包含 `my-site/index.html` 的 `my-site/` 目录 —— 不要发布包含 `my-site/` 的父文件夹。
+
+你也可以发布不含任何 HTML 的原始文件。单个文件会获得功能丰富的自动查看器（支持图片、PDF、视频、音频）。多个文件会生成自动目录列表，包含文件夹导航和图片库。
+
+## 更新现有站点
+
+```bash
+PUBLISH="${HERMES_SKILL_DIR}/scripts/publish.sh"
+bash "$PUBLISH" {file-or-dir} --slug {slug} --client hermes
+```
+
+更新匿名站点时，脚本会自动从 `.herenow/state.json` 加载 `claimToken`。可以通过传递 `--claim-token {token}` 来覆盖。
+
+身份验证更新需要已保存的 API key。
+
+## 使用 Drive
+
+当用户希望为 agent 文件（文档、上下文、记忆、计划、资产、媒体、研究、代码以及其他任何不应发布为网站但需持久保存的内容）提供私有云存储时，请使用 Drive。
+
+每个已登录的账号都有一个名为 `My Drive` 的默认 Drive。
+
+```bash
+DRIVE="${HERMES_SKILL_DIR}/scripts/drive.sh"
+bash "$DRIVE" default
+bash "$DRIVE" ls "My Drive"
+bash "$DRIVE" put "My Drive" notes/today.md --from ./notes/today.md
+bash "$DRIVE" cat "My Drive" notes/today.md
+bash "$DRIVE" share "My Drive" --perms write --prefix notes/ --ttl 7d
+```
+
+使用带作用域的 Drive token 进行 agent 间的文件传递。如果你收到 `herenow_drive` 共享块，请将其 `token` 用作对 `api_base` 请求的 `Authorization: Bearer <token>`，如果存在 `pathPrefix` 则需予以遵守，并在写入时保留 ETags。`pathPrefix` 为 `null` 表示拥有对整个 Drive 的访问权限。如果该技能可用，首选 `drive.sh`；否则直接调用列出的 API 操作。
+
+## API key 存储
+
+发布脚本会从以下来源读取 API key（以首次匹配的为准）：
+
+1. `--api-key {key}` 标志（仅限 CI/脚本使用 —— 避免在交互式环境中使用）
+2. `$HERENOW_API_KEY` 环境变量
+3. `~/.herenow/credentials` 文件（推荐 agent 使用）
+
+要存储 key，请将其写入凭证文件：
+
+```bash
+mkdir -p ~/.herenow && echo "{API_KEY}" > ~/.herenow/credentials && chmod 600 ~/.herenow/credentials
+```
+
+**重要**：收到 API key 后，请立即自行运行上述命令将其保存。不要要求用户手动执行。在交互式会话中，避免通过 CLI 标志（例如 `--api-key`）传递 key；凭证文件是首选的存储方式。
+
+切勿将凭证或本地状态文件（`~/.herenow/credentials`, `.herenow/state.json`）提交到版本控制系统中。
+
+## 获取 API key
+
+要从匿名（24小时）升级为永久站点：
+
+1. 向用户索要其电子邮箱地址。
+2. 请求一次性登录验证码：
+
+```bash
+curl -sS https://here.now/api/auth/agent/request-code \
+  -H "content-type: application/json" \
+  -d '{"email": "user@example.com"}'
+```
+
+3. 告诉用户：“请检查收件箱中来自 here.now 的登录验证码，并将其粘贴到此处。”
+4. 验证该验证码并获取 API key：
+
+```bash
+curl -sS https://here.now/api/auth/agent/verify-code \
+  -H "content-type: application/json" \
+  -d '{"email":"user@example.com","code":"ABCD-2345"}'
+```
+
+5. 自行保存返回的 `apiKey`（不要让用户代为执行）：
+
+```bash
+mkdir -p ~/.herenow && echo "{API_KEY}" > ~/.herenow/credentials && chmod 600 ~/.herenow/credentials
+```
+
+## 状态文件
+
+每次创建/更新站点后，脚本都会在工作目录的 `.herenow/state.json` 中写入数据：
+
+```json
+{
+  "publishes": {
+    "bright-canvas-a7k2": {
+      "siteUrl": "https://bright-canvas-a7k2.here.now/",
+      "claimToken": "abc123",
+      "claimUrl": "https://here.now/claim?slug=bright-canvas-a7k2&token=abc123",
+      "expiresAt": "2026-02-18T01:00:00.000Z"
+    }
+  }
+}
+```
+
+在创建或更新站点之前，你可以检查此文件以查找之前的 slug。
+请将 `.herenow/state.json` 仅视为内部缓存。
+切勿将此本地文件路径作为 URL 提供，也不要将其作为身份验证模式、过期时间或认领 URL 的可靠依据。
+
+## 应当告知用户的内容
+
+对于已发布的站点：
+
+- 始终分享当前脚本运行生成的 `siteUrl`。
+- 读取并遵循脚本 stderr 中的 `publish_result.*` 信息以确定身份验证模式。
+- 当 `publish_result.auth_mode=authenticated` 时：告知用户该站点是**永久的**并已保存到其账户中。无需认领 URL。
+- 当 `publish_result.auth_mode=anonymous` 时：告知用户该站点**将在 24 小时后过期**。分享认领 URL（如果 `publish_result.claim_url` 不为空且以 `https://` 开头），以便他们能永久保留该站点。警告用户认领 token 仅返回一次，无法恢复。
+- 切勿让用户检查 `.herenow/state.json` 来获取认领 URL 或身份验证状态。
+
+对于 Drives：
+
+- 不要将 Drive 文件描述为公开 URL。
+- 告知用户，除非通过带作用域的 token 共享，否则 Drive 中的内容是私有的。
+- 当与另一个 agent 共享访问权限时，请首选具有较窄 `pathPrefix` 和较短 TTL 的带作用域 token。
+
+## publish.sh 选项
+
+| 标志 | 说明 |
+| ---------------------- | -------------------------------------------- |
+| `--slug {slug}` | 更新现有站点，而不是创建新站点 |
+| `--claim-token {token}` | 覆盖用于匿名更新的认领 token |
+| `--title {text}` | 查看器标题（非 HTML 站点） |
+| `--description {text}` | 查看器描述 |
+| `--ttl {seconds}` | 设置过期时间（仅限已验证身份） |
+| `--client {name}` | 用于归属标记的 agent 名称（例如 `hermes`） |
+| `--base-url {url}` | API 基础 URL（默认：`https://here.now`） |
+| `--allow-nonherenow-base-url` | 允许将身份验证信息发送到非默认的 `--base-url` |
+| `--api-key {key}` | 覆盖 API key（首选凭证文件） |
+| `--spa` | 启用 SPA routing（为未知路径提供 index.html） |
+| `--forkable` | 允许他人 fork 此站点 |
+
+## Beyond publish.sh
+
+有关 Drive 操作，请使用 `drive.sh` 或 Drive API。如需更广泛的账户和站点管理功能 —— 删除、元数据、密码、支付、域名、handles、links、变量、代理路由、fork、复制等 —— 请参阅最新文档：
+
+→ **https://here.now/docs**
+
+完整文档：https://here.now/docs