chore: sync latest workspace updates

.pi/agent/skills/quark-sign-skill/SKILL.md

@@ -0,0 +1,114 @@
+---
+name: quark-sign-skill
+description: 夸克网盘自动签到。支持通过 URL 参数执行每日签到获取容量奖励，零外部依赖（Python 标准库即可运行）。
+---
+
+# 夸克网盘签到
+
+自动执行夸克网盘每日签到，获取容量奖励。
+
+## 触发场景
+
+- 用户提到「夸克签到」「夸克网盘签到」「签到」且上下文明确指向夸克网盘
+- 用户要求配置夸克网盘自动签到
+
+## 前置要求
+
+- Python 3.7+（已预装）
+- 夸克网盘签到 URL（从夸克 App 或网页获取）
+
+## 获取签到 URL
+
+1. 打开夸克网盘 App 或网页版
+2. 进入「容量管理」或「签到」页面
+3. 浏览器开发者工具 → Network → 找到类似 `growth/sign` 或 `growth/reward_record` 的请求
+4. 复制完整 URL（包含 `kps`、`sign`、`vcode` 参数）
+
+URL 格式示例：
+```
+https://drive-m.quark.cn/1/clouddrive/capacity/growth/reward_record?kps=xxx&sign=yyy&vcode=zzz
+```
+
+## 使用方式
+
+### 方式一：直接运行（推荐）
+
+如果 skill 目录下已配置了默认 `config.json`，无需任何参数即可运行：
+
+```bash
+python scripts/quark_sign.py
+```
+
+### 方式二：直接传 URL
+
+```bash
+python scripts/quark_sign.py --url "你的完整URL"
+```
+
+### 方式三：配置文件
+
+```bash
+# 1. 复制示例配置并编辑
+cp config.json.example ~/.config/quark_sign.json
+# 填入你的 URL
+
+# 2. 运行
+python scripts/quark_sign.py --config ~/.config/quark_sign.json
+```
+
+### 方式四：环境变量
+
+```bash
+export QUARK_SIGN_URL="你的完整URL"
+python scripts/quark_sign.py
+```
+
+## 常用命令
+
+```bash
+# 执行签到
+python scripts/quark_sign.py --url "URL"
+
+# 仅检查今日是否已签到
+python scripts/quark_sign.py --url "URL" --check
+
+# 查看签到信息
+python scripts/quark_sign.py --url "URL" --info
+```
+
+## 输出示例
+
+```
+🚀 执行签到...
+✅ 签到成功！获得 100.00 MB
+```
+
+```
+🚀 执行签到...
+ℹ️ 今日已签到过，无需重复签到
+```
+
+## 默认配置
+
+skill 目录下已内置 `config.json`，作为默认 URL 来源。URL 查找优先级：
+
+1. `--url` 参数
+2. `--config` 指定的配置文件
+3. 环境变量 `QUARK_SIGN_URL`
+4. skill 内置 `config.json`（默认使用）
+
+## 注意事项
+
+- URL 中的 `kps` 和 `sign` 参数有有效期，如失效需重新获取
+- 签到奖励通常为 100MB~1GB 不等，随机发放
+- 脚本支持 `requests` 库（如已安装）或纯 Python 标准库（零依赖）
+- 默认配置适合个人使用，多用户场景建议各自使用 `--config` 或 `--url`
+
+## 配置 cron 定时任务
+
+```bash
+# 每天 9 点自动签到
+crontab -e
+# 添加：
+0 9 * * * python3 /path/to/quark-sign-skill/scripts/quark_sign.py --config /root/.config/quark_sign.json >> /var/log/quark_sign.log 2>&1
+```

.pi/agent/skills/quark-sign-skill/config.json

@@ -0,0 +1,3 @@
+{
+  "url": "https://drive-m.quark.cn/1/clouddrive/capacity/growth/reward_record?kps=Tj6VYdauGenq2rmPE33ohRAtDymhNFX6jKshCB38E3zVZiDAcGttvmkoAgTNU4n%252B8d7JiORQFKb%252F%252BEU524TsTfP1zN4ZWMXH5UMsxTD%252BLuW%252F8w%253D%253D&sign=Tj7N%252BNUA%252ByXE53C%252FPtR0xBpqepeIHSWt9RtzS66kyDIp9MNlfHO2OJ7zvOZQeK5QuAg%253D&vcode=1780291057288&_size=10&uc_param_str=dnfrpfbivessbtbmnilauputogpintnwmtsvcppcprsnnnchmicckp&fr=android&pf=3300&bi=37280&ve=10.2.3.104&ss=411x833&la=zh&ut=Tj5VTPsW0B0jX%2BOb3U5q%2BcX97R%2Bo%2FcYuH5nOtiswJy9O9Q%3D%3D&nt=6&nw=5G&mt=qUMBdVdLPFs5VQKefOxlxCMt4YMRf%2FRe&sv=release&pr=qk_clouddrive&ch=kkcloud%40store_xiaomi&mi=22127RK46C&kp=Tj6VYdauGenq2rmPE33ohRAtDymhNFX6jKshCB38E3zVZiDAcGttvmkoAgTNU4n%2B8d7JiORQFKb%2F%2BEU524TsTfP1zN4ZWMXH5UMsxTD%2BLuW%2F8w%3D%3D"
+}

.pi/agent/skills/quark-sign-skill/config.json.example

@@ -0,0 +1,3 @@
+{
+  "url": "https://drive-m.quark.cn/1/clouddrive/capacity/growth/reward_record?kps=...&sign=...&vcode=..."
+}

.pi/agent/skills/quark-sign-skill/scripts/quark_sign.py

@@ -0,0 +1,178 @@
+#!/usr/bin/env python3
+"""
+夸克网盘自动签到脚本
+
+用法:
+    python quark_sign.py --url "你的夸克URL" [--check]
+    python quark_sign.py --config ~/.config/quark_sign.json
+"""
+import argparse
+import json
+import os
+import sys
+from urllib.parse import urlparse, parse_qs, unquote
+
+# 尝试导入 requests，如果没有则使用 urllib
+HAS_REQUESTS = True
+try:
+    import requests
+except ImportError:
+    HAS_REQUESTS = False
+    import urllib.request
+    import urllib.parse
+    import urllib.error
+    import ssl
+
+
+class QuarkSign:
+    BASE_URL = "https://drive-m.quark.cn/1/clouddrive/capacity/growth"
+
+    def __init__(self, url: str):
+        self.params = self._extract_params(url)
+        if not self.params.get("kps") or not self.params.get("sign"):
+            raise ValueError("URL 中缺少 kps 或 sign 参数，请检查 URL 是否完整")
+
+    def _extract_params(self, url: str) -> dict:
+        parsed = urlparse(url)
+        params = parse_qs(parsed.query)
+        return {k: unquote(v[0]) for k, v in params.items()}
+
+    def _build_query(self, extra: dict = None) -> dict:
+        q = {
+            "pr": "ucpro",
+            "fr": "android",
+            "kps": self.params.get("kps"),
+            "sign": self.params.get("sign"),
+            "vcode": self.params.get("vcode", "1780291057288"),
+        }
+        if extra:
+            q.update(extra)
+        return q
+
+    def _post(self, endpoint: str, data: dict = None, params: dict = None) -> dict:
+        url = f"{self.BASE_URL}/{endpoint}"
+        query = self._build_query(params)
+
+        if HAS_REQUESTS:
+            resp = requests.post(url, json=data or {}, params=query, timeout=10)
+            return resp.json()
+        else:
+            # 使用 urllib  fallback
+            full_url = url + "?" + urllib.parse.urlencode(query)
+            payload = json.dumps(data or {}).encode("utf-8")
+            req = urllib.request.Request(
+                full_url,
+                data=payload,
+                headers={"Content-Type": "application/json"},
+                method="POST",
+            )
+            ctx = ssl.create_default_context()
+            with urllib.request.urlopen(req, context=ctx, timeout=10) as resp:
+                return json.loads(resp.read().decode("utf-8"))
+
+    def _get(self, endpoint: str, params: dict = None) -> dict:
+        url = f"{self.BASE_URL}/{endpoint}"
+        query = self._build_query(params)
+
+        if HAS_REQUESTS:
+            resp = requests.get(url, params=query, timeout=10)
+            return resp.json()
+        else:
+            full_url = url + "?" + urllib.parse.urlencode(query)
+            req = urllib.request.Request(full_url, method="GET")
+            ctx = ssl.create_default_context()
+            with urllib.request.urlopen(req, context=ctx, timeout=10) as resp:
+                return json.loads(resp.read().decode("utf-8"))
+
+    def sign(self) -> dict:
+        """执行签到"""
+        return self._post("sign", data={"sign_cyclic": True})
+
+    def info(self) -> dict:
+        """获取签到信息"""
+        return self._get("sign", params={"_size": 1})
+
+    def reward_info(self) -> dict:
+        """获取奖励记录"""
+        return self._get("reward_record", params={"_size": 10})
+
+
+def format_reward(reward_bytes: int) -> str:
+    if reward_bytes >= 1024 ** 3:
+        return f"{reward_bytes / (1024 ** 3):.2f} GB"
+    return f"{reward_bytes / (1024 ** 2):.2f} MB"
+
+
+def main():
+    parser = argparse.ArgumentParser(description="夸克网盘自动签到")
+    parser.add_argument("--url", help="夸克网盘分享/签到 URL（包含 kps 和 sign 参数）")
+    parser.add_argument("--config", "-c", help="配置文件路径（JSON 格式）")
+    parser.add_argument("--check", action="store_true", help="仅检查签到状态，不执行签到")
+    parser.add_argument("--info", action="store_true", help="显示签到信息")
+    args = parser.parse_args()
+
+    # 获取 URL
+    url = args.url
+    if not url and args.config:
+        with open(os.path.expanduser(args.config)) as f:
+            cfg = json.load(f)
+            url = cfg.get("url")
+    if not url:
+        # 尝试环境变量
+        url = os.environ.get("QUARK_SIGN_URL")
+    if not url:
+        # 尝试读取默认配置（skill 内置）
+        script_dir = os.path.dirname(os.path.abspath(__file__))
+        default_cfg = os.path.join(script_dir, "..", "config.json")
+        if os.path.exists(default_cfg):
+            with open(default_cfg) as f:
+                cfg = json.load(f)
+                url = cfg.get("url")
+    if not url:
+        print("❌ 请提供 URL：--url、--config 或环境变量 QUARK_SIGN_URL")
+        print("   提示：可在 skill 目录下创建 config.json 写入默认 URL")
+        sys.exit(1)
+
+    try:
+        qs = QuarkSign(url)
+    except ValueError as e:
+        print(f"❌ {e}")
+        sys.exit(1)
+
+    if args.info:
+        print("📋 获取签到信息...")
+        info = qs.info()
+        print(json.dumps(info, indent=2, ensure_ascii=False))
+        return
+
+    if args.check:
+        print("🔍 检查签到状态...")
+        info = qs.info()
+        data = info.get("data", {})
+        if data.get("sign_daily"):
+            print("✅ 今日已签到")
+        else:
+            print("⏳ 今日未签到")
+        return
+
+    # 执行签到
+    print("🚀 执行签到...")
+    result = qs.sign()
+
+    status = result.get("status")
+    code = result.get("code")
+    msg = result.get("message", "")
+    data = result.get("data", {})
+
+    if data and status == 200:
+        reward = data.get("sign_daily_reward", 0)
+        print(f"✅ 签到成功！获得 {format_reward(reward)}")
+    elif "repeat" in msg.lower() or code == 44210:
+        print("ℹ️ 今日已签到过，无需重复签到")
+    else:
+        print(f"❌ 签到失败: {msg} (code={code}, status={status})")
+        sys.exit(1)
+
+
+if __name__ == "__main__":
+    main()

.pi/agent/skills/skills/add-llm-provider.md

@@ -1,57 +0,0 @@
----
-name: add-llm-provider
-description: Checklist for adding a new LLM provider to packages/ai. Covers core types, provider implementation, lazy registration, model generation, the full test matrix, coding-agent wiring, and docs.
----
-
-# Adding a New LLM Provider (packages/ai)
-
-A new provider touches multiple files. Work through these steps in order.
-
-## 1. Core Types (`packages/ai/src/types.ts`)
-
-- Add API identifier to `Api` type union (e.g. `"bedrock-converse-stream"`).
-- Create options interface extending `StreamOptions`.
-- Add mapping to `ApiOptionsMap`.
-- Add provider name to `KnownProvider` type union.
-
-## 2. Provider Implementation (`packages/ai/src/providers/`)
-
-Create a provider file exporting:
-
-- `stream<Provider>()` returning `AssistantMessageEventStream`.
-- `streamSimple<Provider>()` for `SimpleStreamOptions` mapping.
-- Provider-specific options interface.
-- Message/tool conversion functions.
-- Response parsing that emits standardized events (`text`, `tool_call`, `thinking`, `usage`, `stop`).
-
-## 3. Provider Exports and Lazy Registration
-
-- Add a package subpath export in `packages/ai/package.json` pointing at `./dist/providers/<provider>.js`.
-- Add `export type` re-exports in `packages/ai/src/index.ts` for provider option types that should remain available from the root entry.
-- Register the provider in `packages/ai/src/providers/register-builtins.ts` via lazy loader wrappers; do not statically import provider implementation modules there.
-- Add credential detection in `packages/ai/src/env-api-keys.ts`.
-
-## 4. Model Generation (`packages/ai/scripts/generate-models.ts`)
-
-- Add logic to fetch/parse models from the provider source.
-- Map to the standardized `Model` interface.
-
-## 5. Tests (`packages/ai/test/`)
-
-- Always add the provider to `stream.test.ts` with at least one representative model, even if it reuses an existing API impl such as `openai-completions`.
-- Add the provider to the broader matrix where applicable: `tokens.test.ts`, `abort.test.ts`, `empty.test.ts`, `context-overflow.test.ts`, `unicode-surrogate.test.ts`, `tool-call-without-result.test.ts`, `image-tool-result.test.ts`, `total-tokens.test.ts`, `cross-provider-handoff.test.ts`.
-- For `cross-provider-handoff.test.ts`, add at least one provider/model pair. If the provider exposes multiple model families (e.g. GPT and Claude), add at least one pair per family.
-- For non-standard auth, create a utility (e.g. `bedrock-utils.ts`) with credential detection.
-
-## 6. Coding Agent (`packages/coding-agent/`)
-
-- `src/core/model-resolver.ts`: add default model ID to `defaultModelPerProvider`.
-- `src/core/provider-display-names.ts`: add API-key login display name so `/login` and related UI show the provider for built-in API-key auth.
-- `src/cli/args.ts`: add env var documentation.
-- `README.md`: add provider setup instructions.
-- `docs/providers.md`: add setup instructions, env var, and `auth.json` key.
-
-## 7. Documentation
-
-- `packages/ai/README.md`: add to providers table, document options/auth, add env vars.
-- `packages/ai/CHANGELOG.md`: add entry under `## [Unreleased]`.