@crabcloud/skills 0.1.4 → 0.1.5
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.
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
---
|
|
2
2
|
name: crabcloud
|
|
3
|
-
description: Manage the user's Crab Cloud personal cloud account and agent tokens through the `crab` CLI — check identity/subscription/credits, list and revoke authorized agent tokens, and re-authorize with specific scopes or scope groups. Use this skill whenever the user asks about their Crab Cloud account ("我的账号信息", "who am I on crabcloud"), wants to see or clean up authorized agents/tokens ("看看我授权了哪些 agent", "revoke that old token", "撤销那个旧令牌"), manages their contacts ("我的联系人", "把 zhangsan 加到联系人", "我的邀请码"), or asks how to connect their coding agent to Crab Cloud — even if they never say "crab" or "Crab Cloud" explicitly. Contacts are managed with `crab contacts …` in this skill; email lives in the crabcloud-mail skill (crab mail …)
|
|
3
|
+
description: Manage the user's Crab Cloud personal cloud account and agent tokens through the `crab` CLI — check identity/subscription/credits, list and revoke authorized agent tokens, and re-authorize with specific scopes or scope groups. Use this skill whenever the user asks about their Crab Cloud account ("我的账号信息", "who am I on crabcloud"), wants to see or clean up authorized agents/tokens ("看看我授权了哪些 agent", "revoke that old token", "撤销那个旧令牌"), manages their contacts ("我的联系人", "把 zhangsan 加到联系人", "我的邀请码"), or asks how to connect their coding agent to Crab Cloud — even if they never say "crab" or "Crab Cloud" explicitly. Contacts are managed with `crab contacts …` in this skill; email lives in the crabcloud-mail skill (crab mail …), the Drive in crabcloud-storage (crab storage …), and collab in crabcloud-collab (crab collab …).
|
|
4
4
|
---
|
|
5
5
|
|
|
6
6
|
# Crab Cloud（平台 / 账号域）
|
|
@@ -10,8 +10,8 @@ Crab Cloud 是用户的个人云底座：账号、订阅与积分是平台层，
|
|
|
10
10
|
（`~/.config/crabcloud/credentials.json`，0600），服务端只存令牌哈希、全程审计。
|
|
11
11
|
本 skill 覆盖**平台、账号域与联系人**（`crab contacts …`）；邮箱见
|
|
12
12
|
`crabcloud-mail` skill（`crab mail …`），
|
|
13
|
-
云盘见 `crabcloud-storage` skill（`crab storage
|
|
14
|
-
|
|
13
|
+
云盘见 `crabcloud-storage` skill（`crab storage …`）；协作见
|
|
14
|
+
`crabcloud-collab` skill（`crab collab …`）。
|
|
15
15
|
|
|
16
16
|
## 第一步：确认 CLI 可用
|
|
17
17
|
|
|
@@ -45,7 +45,7 @@ Crab Cloud 是用户的个人云底座：账号、订阅与积分是平台层，
|
|
|
45
45
|
|
|
46
46
|
积分命令需 `credits.read` scope（`account` 组含它）：退出码 4 报缺该 scope 时，
|
|
47
47
|
引导 `crab login --scopes account` 重新授权。积分额度一律以**积分数**表述
|
|
48
|
-
|
|
48
|
+
（**1 积分 = $1**，仅价格类口径用美元）；充值/下单是 Web 会话能力，CLI/Agent
|
|
49
49
|
令牌不动账——用户要充值时引导网页账单页（crabcloud.cc/account/billing）。
|
|
50
50
|
拿不准令牌 id 时先 `crab tokens list` 核对；`revoke` 只接受列表里的 id。
|
|
51
51
|
|
|
@@ -76,11 +76,11 @@ Crab Cloud 是用户的个人云底座：账号、订阅与积分是平台层，
|
|
|
76
76
|
不要怂恿用户一次性给全量 scope。`--scopes` 支持组名（`mail` = 读写搜删四项
|
|
77
77
|
整组）与单个 scope 混用；组目录见 `crab help`，可用组：account / mail /
|
|
78
78
|
storage（云盘，含素材与附件）/ collab / contacts。
|
|
79
|
-
-
|
|
80
|
-
用网页（crabcloud.cc），不要编造命令或输出；联系人已上线，用 `crab contacts`
|
|
79
|
+
- 如实转述能力边界，不要编造命令或输出：联系人用 `crab contacts`
|
|
81
80
|
（list / add / rm / invite / invitees；scope contacts.read/write，程序消费加
|
|
82
|
-
`--json`）处理；邮箱请求转交 `crabcloud-mail`
|
|
83
|
-
skill
|
|
81
|
+
`--json`）处理；邮箱请求转交 `crabcloud-mail` skill，云盘请求转交
|
|
82
|
+
`crabcloud-storage` skill，协作请求转交 `crabcloud-collab` skill
|
|
83
|
+
（`crab collab …`，已上线）。
|
|
84
84
|
- 账号安全操作（修改密码、登录设备/会话的查看与吊销）**有意不开放给 agent
|
|
85
85
|
通道**：改密对令牌持有者是账号接管面，会话属于"人的浏览器会话"。用户让
|
|
86
86
|
agent 做这些时，如实说明并引导到网页个人中心（crabcloud.cc/account）操作，
|
|
@@ -83,6 +83,10 @@ skill 覆盖协作域的 agent 通道；账号/令牌管理见 `crabcloud` skill
|
|
|
83
83
|
补一条更正记录，不要试图「撤回」。
|
|
84
84
|
- **摘要是可变当前态**：表达「现在进展到哪」，不是流水账；每次推送记录后若
|
|
85
85
|
摘要已过时，顺手 `crab collab task summary` 刷新，让不看全程的人一眼看懂。
|
|
86
|
+
- **空间级管理走网页端**：改名/归档/调整自分配存储/扩容（任务+20、成员+5）/
|
|
87
|
+
移除成员是 owner 的网页操作，Agent 令牌一律被服务端拒绝——用户要这些时如实
|
|
88
|
+
说明并引导网页端，**不要换姿势重试**；建独立空间（`collab space create`）与
|
|
89
|
+
邀请成员（`collab invite`）例外，Agent 可执行。
|
|
86
90
|
- **建独立空间是付费动作（5 积分）**：先向用户复述名称与自分配存储（默认
|
|
87
91
|
500MB，占订阅总池），确认后再执行；`collab space create` 不要当作顺手操作。
|
|
88
92
|
- **邀请有前置**：目标必须是联系人簿里已关联的平台用户（`crab contacts add`
|
|
@@ -7,8 +7,8 @@ description: Read, search and send the user's Crab Cloud platform email (usernam
|
|
|
7
7
|
|
|
8
8
|
用户的 Crab Cloud 账号自带平台邮箱 `username@crabcloud.cc`（用户名即地址本地部分）。
|
|
9
9
|
本 skill 覆盖邮箱域的 agent 通道；账号/令牌管理见 `crabcloud` skill。云盘见
|
|
10
|
-
`crabcloud-storage` skill（`crab storage
|
|
11
|
-
|
|
10
|
+
`crabcloud-storage` skill（`crab storage …`），协作见 `crabcloud-collab` skill
|
|
11
|
+
（`crab collab …`）。
|
|
12
12
|
|
|
13
13
|
## 第一步：确认可用
|
|
14
14
|
|
|
@@ -32,6 +32,9 @@ description: Read, search and send the user's Crab Cloud platform email (usernam
|
|
|
32
32
|
| 只看未读 | `crab mail list --unread` |
|
|
33
33
|
| 翻页 | `crab mail list --cursor <nextCursor>`（列表末尾会提示） |
|
|
34
34
|
| 读某封邮件 | `crab mail read <id>`（自动置已读；正文 + 操作记录） |
|
|
35
|
+
| 标回未读 | `crab mail unread <id>` |
|
|
36
|
+
| 看各文件夹总量/未读、本月收发 | `crab mail folders`（判断「有没有新邮件」先看这个，别翻列表） |
|
|
37
|
+
| 看邮箱操作流（谁读过/谁代发） | `crab mail activity`（最近 50 条，审计源） |
|
|
35
38
|
| 找邮件 | `crab mail search <关键词>`（主题/发件人/收件人/正文，不含废纸篓） |
|
|
36
39
|
| 发邮件 | `crab mail send --to a@x.cc --subject "..." --body "..."`（长正文用 `--body-file`） |
|
|
37
40
|
| 发邮件带附件 | `crab mail send … --attach <云盘id\|文件名>[,…]`（引用云盘已有对象，不复制，≤10 个；先 `crab storage ls` 核对对象，文件名需精确唯一命中） |
|
|
@@ -44,7 +47,7 @@ description: Read, search and send the user's Crab Cloud platform email (usernam
|
|
|
44
47
|
## 计费口径（必须如实转述）
|
|
45
48
|
|
|
46
49
|
- **平台内互发免费**：收件人也是 `@crabcloud.cc` 地址时不消耗积分。
|
|
47
|
-
- **外部出站
|
|
50
|
+
- **外部出站 0.02 积分/封（$0.02）**：发送前向用户复述收件人与计费；退出码 7 = 积分不足，
|
|
48
51
|
告知用户不要自动重试。
|
|
49
52
|
- 发送结果会报告 `消耗积分` 与失败数；部分失败时失败部分的积分自动退回
|
|
50
53
|
（`发送:partial` 标记）。
|
|
@@ -57,7 +60,9 @@ description: Read, search and send the user's Crab Cloud platform email (usernam
|
|
|
57
60
|
`id/folder/fromAddr/to/subject/snippet/isUnread/hasAttachments/createdAt`；
|
|
58
61
|
- `mail read --json` → 完整正文 + `attachments`（id/filename/mimeType/sizeBytes）
|
|
59
62
|
+ `actors`（谁读过/谁代发，审计源）；
|
|
60
|
-
- `mail send --json` → `{ message, chargedCredits, failedExternal }
|
|
63
|
+
- `mail send --json` → `{ message, chargedCredits, failedExternal }`；
|
|
64
|
+
- `mail folders --json` → `{ address, folders: [{ folder, total, unread }], month: { received, sent, outbound } }`；
|
|
65
|
+
- `mail activity --json` → 条目含 `action（read/drafted/sent）/ actorType / actorLabel / subject / messageId / createdAt`。
|
|
61
66
|
|
|
62
67
|
## 纪律
|
|
63
68
|
|
|
@@ -47,6 +47,7 @@ skill。
|
|
|
47
47
|
| 云盘钥匙管理 | `crab storage key`（查状态）/ `--remember`（解锁一次并记住，之后免口令）/ `--forget`（清除）——见下节 |
|
|
48
48
|
| 删除 | `crab storage rm <id\|文件名>`（进回收站，7 天后自动清理）→ `restore` 恢复 / `purge` 彻底删除 |
|
|
49
49
|
| 看水位 | `crab storage quota`（三来源分项 + 回收站占用 + 对象计数） |
|
|
50
|
+
| 看云盘操作流 | `crab storage activity`（读取/上传/删除/建分享，最近 50 条） |
|
|
50
51
|
|
|
51
52
|
`<id|文件名>`：文件名全库精确唯一命中时自动解析为 id（回收站内同样可解析，
|
|
52
53
|
restore/purge 直接用文件名即可）；命中多个或查不到时按字面当 id 用——拿不准
|
|
@@ -60,6 +61,7 @@ restore/purge 直接用文件名即可）；命中多个或查不到时按字面
|
|
|
60
61
|
- `storage ls --json` → `{ objects: [...], nextOffset, total }`，条目含
|
|
61
62
|
`id / source / filename / mimeType / sizeBytes / categoryId / tags / isPublic / createdAt`；
|
|
62
63
|
- `storage quota --json` → `{ usedBytes, quotaBytes, bySource: { files, media, mail }, trashBytes, counts }`；
|
|
64
|
+
- `storage activity --json` → 条目含 `action（object.read/object.uploaded/object.deleted/share.created）/ actorType / actorLabel / objectId / objectName / createdAt`；
|
|
63
65
|
- `upload` / `categories` / `tags` / `shares` 的 `--json` 同构（单对象 / 分类数组 /
|
|
64
66
|
标签数组 / 分享数组）。
|
|
65
67
|
|
package/package.json
CHANGED