@agentunion/fastaun-browser 0.5.1 → 0.5.2

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 (50) hide show
  1. package/CHANGELOG.md +548 -518
  2. package/_packed_docs/CHANGELOG-validators.md +134 -131
  3. package/_packed_docs/CHANGELOG.md +548 -518
  4. package/_packed_docs/INDEX.md +51 -44
  5. package/_packed_docs/KITE_DOCS_GUIDE.md +19 -16
  6. package/_packed_docs/agent.md//350/277/234/347/250/213agent.md/347/274/223/345/255/230/344/270/216etag/351/200/217/344/274/240/346/226/271/346/241/210.md +169 -116
  7. package/_packed_docs/aun-perf-audit-critical-bugs.md +315 -0
  8. package/_packed_docs/cli/AUN-CLI/350/256/276/350/256/241/346/226/207/346/241/243.md +263 -261
  9. package/_packed_docs/cli/CLI/346/211/213/345/206/214.md +328 -328
  10. package/_packed_docs/protocol/00-/346/200/273/350/247/210/344/270/216/345/210/206/345/261/202.md +2 -2
  11. package/_packed_docs/protocol/00A-/350/256/276/350/256/241/345/216/237/345/210/231-/344/270/272Agent/350/200/214/347/224/237.md +1 -1
  12. package/_packed_docs/protocol/01-/350/272/253/344/273/275/344/270/216/345/207/255/350/257/201/345/215/217/350/256/256-auth.md +39 -16
  13. package/_packed_docs/protocol/03-Gateway-/350/277/236/346/216/245/346/250/241/345/274/217.md +8 -5
  14. package/_packed_docs/protocol/06-/346/234/215/345/212/241/345/215/217/350/256/256.md +18 -19
  15. package/_packed_docs/protocol/07-/351/224/231/350/257/257/347/240/201/344/270/216/347/212/266/346/200/201/346/234/272.md +1 -1
  16. package/_packed_docs/protocol/08-AUN-E2EE-Group.md +293 -294
  17. package/_packed_docs/protocol/08-AUN-E2EE.md +12 -10
  18. package/_packed_docs/protocol/10-Group-/345/255/220/345/215/217/350/256/256.md +85 -89
  19. package/_packed_docs/protocol/11-Storage-/345/255/220/345/215/217/350/256/256.md +4 -4
  20. package/_packed_docs/protocol/15-/347/246/273/347/272/277/346/216/250/351/200/201/351/200/232/347/237/245/345/215/217/350/256/256.md +1 -1
  21. package/_packed_docs/protocol/16-/347/263/273/347/273/237/347/233/256/345/275/225/344/277/235/346/212/244/346/226/271/346/241/210.md +177 -177
  22. package/_packed_docs/protocol/README.md +4 -4
  23. package/_packed_docs/protocol/aun-docs-guide.md +2 -2
  24. package/_packed_docs/protocol/index.md +4 -4
  25. package/_packed_docs/protocol//350/215/211/346/241/210-/346/213/222/347/273/235/344/277/241/345/217/267/345/215/217/350/256/256.md +1 -1
  26. package/_packed_docs/protocol//351/231/204/345/275/225A-/346/234/257/350/257/255/350/241/250.md +13 -13
  27. package/_packed_docs/protocol//351/231/204/345/275/225L-E2EE/345/256/236/347/216/260/346/214/207/345/215/227.md +9 -9
  28. package/_packed_docs/sdk/02-WebSocket/345/215/217/350/256/256.md +15 -13
  29. package/_packed_docs/sdk/04-/350/277/236/346/216/245/344/270/216/350/256/244/350/257/201.md +26 -18
  30. package/_packed_docs/sdk/05-E2EE/345/212/240/345/257/206/351/200/232/344/277/241.md +33 -34
  31. package/_packed_docs/sdk/06-API/346/211/213/345/206/214.md +22 -17
  32. package/_packed_docs/sdk/07-/351/224/231/350/257/257/345/244/204/347/220/206.md +11 -7
  33. package/_packed_docs/sdk/09-group-rpc-manual.md +135 -114
  34. package/_packed_docs/sdk/09-message-rpc-manual.md +50 -28
  35. package/_packed_docs/sdk/09-payload-reference.md +3 -3
  36. package/_packed_docs/sdk/09-storage-rpc-manual.md +1 -1
  37. package/_packed_docs/sdk/AUN_DOCS_GUIDE.md +11 -10
  38. package/_packed_docs/sdk/E2EE_V2/346/266/210/346/201/257/351/200/232/344/277/241/346/227/266/345/272/217/345/233/276.md +3 -2
  39. package/_packed_docs/sdk/INDEX.md +15 -14
  40. package/_packed_docs/sdk/Notify/351/200/232/347/237/245/346/226/271/346/241/210.md +6 -2
  41. package/dist/agent-md.d.ts.map +1 -1
  42. package/dist/agent-md.js +18 -9
  43. package/dist/agent-md.js.map +1 -1
  44. package/dist/bundle.js +104 -24
  45. package/dist/client/v2-e2ee.d.ts.map +1 -1
  46. package/dist/client/v2-e2ee.js +78 -7
  47. package/dist/client/v2-e2ee.js.map +1 -1
  48. package/dist/version.d.ts +1 -1
  49. package/dist/version.js +1 -1
  50. package/package.json +1 -1
@@ -1,331 +1,331 @@
1
- # AUN CLI 手册
2
-
3
- ## 位置与入口
4
-
5
- AUN CLI 是 Python SDK 的命令行工具,源码位于:
6
-
7
- ```text
8
- D:\modelunion\kite\aun-sdk-core\python\src\aun_cli
9
- ```
10
-
11
- 仓库内相对路径为 `python/src/aun_cli`。安装入口在 `python/pyproject.toml`:
12
-
13
- ```toml
14
- [project.scripts]
15
- aun = "aun_cli.main:app"
16
- ```
17
-
18
- 开发环境可直接运行:
19
-
20
- ```powershell
21
- cd D:\modelunion\kite\aun-sdk-core\python
22
- pip install -e .
23
- aun --help
24
- ```
25
-
26
- 也可以不安装包,直接指定 `PYTHONPATH`:
27
-
28
- ```powershell
29
- $env:PYTHONPATH="D:\modelunion\kite\aun-sdk-core\python\src"
30
- python -m aun_cli --help
31
- ```
32
-
33
- ## 全局用法
34
-
35
- ```text
36
- aun [全局选项] <command> [参数]
37
- ```
38
-
39
- 全局选项:
40
-
41
- | 选项 | 说明 |
42
- |------|------|
43
- | `--profile, -p` | 仅本次命令使用指定 profile |
44
- | `--json` | 输出 JSON,适合脚本 |
45
- | `--debug` | 启用 debug 日志 |
46
- | `--no-color` | 禁用彩色输出 |
47
- | `--timeout, -t` | 操作超时秒数,默认 30 |
48
- | `--version, -V` | 显示版本 |
49
- | `--install-completion` | 安装当前 shell 的补全脚本,Typer 自动提供 |
50
- | `--show-completion` | 输出补全脚本,Typer 自动提供 |
51
- | `--help` | 显示帮助 |
52
-
53
- CLI 不提供 `--gateway` 选项;Gateway 发现由 SDK 处理。
54
-
55
- 非 JSON 模式会先打印当前 `profile`、`aid`、`active_group` 和 `trace`,命令结束时可能输出 RPC summary。脚本里建议使用 `--json`。
56
-
57
- ## 配置与 Profile
58
-
59
- 默认配置文件为 `~/.aun/cli.toml`。常用命令:
60
-
61
- ```powershell
62
- aun profile create dev --aid alice.agentid.pub
63
- aun profile switch dev
64
- aun profile current
65
- aun profile list
66
-
67
- aun config set timeout 60
68
- aun config get timeout
69
- aun config list
70
- ```
71
-
72
- `profile` 也挂在 `config` 下,`aun config profile list/current/create/switch` 与根级 `aun profile ...` 使用同一套实现。
73
-
74
- 当前 profile 的核心字段:
75
-
76
- | 字段 | 说明 |
77
- |------|------|
78
- | `aid` | 默认操作身份 |
79
- | `aun_path` | 本地身份、密钥、日志等数据目录 |
80
- | `active_group` | 默认群组;省略 group_id 时使用 |
81
- | `debug` / `trace` / `timeout` | 调试、trace 和超时配置 |
82
-
83
- 有效 profile 选择顺序:
84
-
85
- ```text
86
- --profile > AUN_PROFILE > 当前终端标签页状态 > default.profile
87
- ```
88
-
89
- ## 身份命令
90
-
91
- | 命令 | 用法 |
92
- |------|------|
93
- | `aun register <aid>` | 注册新 AID,并写入当前 profile |
94
- | `aun login [aid]` | 加载本地身份、认证并连接一次 |
95
- | `aun whoami` | 查看当前 profile / AID / 数据目录 |
96
- | `aun identity list` | 列出本地身份 |
97
- | `aun identity check <aid>` | 检查本地身份材料和远端注册状态 |
98
-
99
- 示例:
100
-
101
- ```powershell
102
- aun register alice.agentid.pub
103
- aun login alice.agentid.pub
104
- aun whoami
105
- aun identity check alice.agentid.pub
106
- ```
107
-
108
- ## P2P 消息命令
109
-
110
- | 命令 | 用法 |
111
- |------|------|
112
- | `aun send <target-aid> <message>` | 发送 P2P 消息,默认加密 |
113
- | `aun send <target-aid> -` | 从 stdin 读取消息 |
114
- | `aun pull [--from aid] [--limit N] [--after-seq N]` | 拉取离线消息 |
115
- | `aun ack <sender-aid> --seq N` | 确认消息 seq |
116
- | `aun listen [--from aid] [--group group_id]` | 实时监听 P2P 和群消息 |
117
-
118
- 示例:
119
-
120
- ```powershell
121
- aun send bob.agentid.pub "hello"
122
- Get-Content .\msg.txt | aun send bob.agentid.pub -
123
- aun pull --limit 20
124
- aun listen --from bob.agentid.pub
125
- ```
126
-
127
- ## 群组命令
128
-
129
- | 命令 | 用法 |
130
- |------|------|
131
- | `aun group create <name> [--members a,b] [--group-name name]` | 创建群;成功后自动设为 active group |
132
- | `aun group use <group-id>` | 设置当前 active group |
133
- | `aun group current` | 查看当前 active group |
134
- | `aun group send [group-id] <message>` | 发送群消息;省略 group-id 时使用 active group |
135
- | `aun group list` | 列出已加入群 |
136
- | `aun group info [group-id]` | 查看群详情 |
137
- | `aun group members [group-id]` | 查看成员 |
138
- | `aun group invite [group-id] <aid...>` | 邀请成员 |
139
- | `aun group add-member [group-id] <aid> [--role member|admin]` | 直接添加成员 |
140
- | `aun group kick [group-id] <aid>` | 移除成员 |
141
- | `aun group leave [group-id]` | 退出群 |
142
- | `aun group dissolve [group-id]` | 解散群 |
143
- | `aun group bind [group-id] [--group-name name]` | 为匿名群补齐 group_aid;`bind-aid` 是公开别名 |
144
- | `aun group transfer [group-id] <new-owner>` | 转移群主 |
145
- | `aun group complete-transfer [group-id]` | 完成转让后的 group.fs rekey |
146
-
147
- `aun group add_member` 是 `aun group add-member` 的公开兼容别名。
148
-
149
- 示例:
150
-
151
- ```powershell
152
- aun group create "项目讨论组" --members bob.agentid.pub,carol.agentid.pub
153
- aun group current
154
- aun group send "大家好"
155
- aun group members
156
- aun group add-member dave.agentid.pub --role member
157
- ```
158
-
159
- ## 群文件系统命令
160
-
161
- `aun group fs` 对应 `group.fs.*` 和 SDK `client.group.fs`。裸路径使用当前 active group;完整 group path 也可直接传入。
162
-
163
- | 命令 | 用法 |
164
- |------|------|
165
- | `aun group fs ls [path] [-l]` | 列出目录 |
166
- | `aun group fs find [path] [--name "*.md"] [--type f]` | 查找节点 |
167
- | `aun group fs stat <path>` | 查看节点 |
168
- | `aun group fs lstat <path>` | 查看链接本身 |
169
- | `aun group fs mkdir <path> [-p]` | 创建目录 |
170
- | `aun group fs rm <path> [-r] [--force]` | 删除节点 |
171
- | `aun group fs cp <src> <dst> [-r] [--force]` | 上传、下载或远程复制 |
172
- | `aun group fs mv <src> <dst> [--force]` | 远程移动 |
173
- | `aun group fs df [path]` | 查看用量 |
174
- | `aun group fs setfacl <path> -m role:admin:<perms>` | 群主授予群自有区 admin 角色 ACL |
175
- | `aun group fs setfacl <path> -x role:admin` | 群主撤销群自有区 admin 角色 ACL |
176
- | `aun group fs getfacl <path>` | 查看群自有区角色 ACL |
177
- | `aun group fs mount <path> [--readonly/--readwrite]` | 挂载成员数据区 |
178
- | `aun group fs umount <path>` | 卸载成员数据区 |
179
-
180
- 示例:
181
-
182
- ```powershell
183
- aun group fs mkdir /docs -p
184
- aun group fs cp .\README.md /docs/README.md
185
- aun group fs ls /docs -l
186
- aun group fs setfacl /docs -m role:admin:rwx
187
- aun group fs getfacl /docs
188
- aun group fs cp /docs/README.md .\downloaded.md
189
- ```
190
-
191
- 群自有区写入需要使用当前 `group_identity` 对应的 `group_aid` 身份签名时,可通过 `--as <group-aid>` 指定操作者。`setfacl/getfacl` 只允许当前 group owner 调用;当前只支持 `role:admin` 角色 ACL,权限位对外显示为 POSIX 视图 `rwx`。
192
-
193
- ## Storage VFS 命令
194
-
195
- `aun fs` 是普通 Storage VFS 入口,路径格式为 `<AID>:/path`。裸路径自动使用当前 profile AID。
196
-
197
- | 命令 | 用法 |
198
- |------|------|
199
- | `aun fs ls <path> [-l]` | 列目录 |
200
- | `aun fs stat <path> [-L]` | 查看节点,`-L` 跟随链接 |
201
- | `aun fs cat <path>` | 输出文件内容 |
202
- | `aun fs cp <src> <dst>` | 本地/远程上传下载或远程复制 |
203
- | `aun fs mv <src> <dst>` | 同 AID 内原子移动 |
204
- | `aun fs rm <path> [-r]` | 删除 |
205
- | `aun fs ln -s <target> <link-path>` | 创建软链 |
206
- | `aun fs mkdir <path> [-p]` | 创建目录 |
207
- | `aun fs touch <path> [-p] [--no-create] [--mtime TS]` | 创建空文件或更新时间戳 |
208
- | `aun fs df <aid:>` | 查看用量 |
209
- | `aun fs quota [aid:]` | 查看配额 |
210
- | `aun fs du <path> [-h] [--max-depth N]` | 汇总路径占用 |
211
- | `aun fs find <path> [--name PATTERN] [--type f|d|l]` | 查找 |
212
- | `aun fs chmod +r <path>` / `aun fs chmod o-r <path>` | 设置 public/private |
213
- | `aun fs setfacl <path> -m aid:<AID>:<perms>` / `-x aid:<AID>` | 设置或移除 ACL |
214
- | `aun fs getfacl <path>` | 查看 ACL |
215
- | `aun fs mount/approve/reject/umount ...` | 挂载生命周期 |
216
- | `aun fs token issue/revoke/ls ...` | 访问 token 管理 |
217
-
218
- 示例:
219
-
220
- ```powershell
221
- aun fs mkdir alice.agentid.pub:/docs -p
222
- aun fs touch alice.agentid.pub:/docs/empty.txt --mtime 1700000000
223
- aun fs cp .\a.txt alice.agentid.pub:/docs/a.txt
224
- aun fs cat alice.agentid.pub:/docs/a.txt
225
- aun fs token issue alice.agentid.pub:/docs/a.txt
226
- ```
227
-
228
- ## 对象存储兼容命令
229
-
230
- `aun storage` 是对象级快捷入口,适合低层调试和兼容旧用法:
231
-
232
- ```powershell
233
- aun storage ls docs/
234
- aun storage info docs/a.txt
235
- aun storage upload .\a.txt --name docs/a.txt --force
236
- aun storage download docs/a.txt -o .\a.txt --force
237
- aun storage delete docs/a.txt
238
- ```
239
-
240
- 新应用优先使用 `aun fs`。
241
-
242
- ## Collab 命令
243
-
244
- `aun collab` 操作版本化协作目录:
245
-
246
- | 命令 | 用法 |
247
- |------|------|
248
- | `aun collab ls-files <collab-root>` | 列出文档 |
249
- | `aun collab create <root> <doc> <source>` | 创建文档 |
250
- | `aun collab show <root> <doc> [--rev N] [-o file]` | 查看版本 |
251
- | `aun collab commit <root> <doc> <source> --onto N` | 提交版本 |
252
- | `aun collab merge <root> <doc> <source> --onto N` | 三方合并 |
253
- | `aun collab log <root> <doc>` | 历史 |
254
- | `aun collab diff <root> <doc> --from A --to B` | 差异 |
255
- | `aun collab revert <root> <doc> --rev N` | 回退 |
256
- | `aun collab clone <src> <dest> [--reroot]` | 克隆 |
257
- | `aun collab prune/gc/reflog ...` | 清理和审计 |
258
- | `aun collab ls-remote <group-aid>` | 列群内协作目录 |
259
- | `aun collab unregister <group-aid> <root>` | 取消群注册 |
260
- | `aun collab tag create/list/show/diff/restore/rm/prune ...` | 目录级标签 |
261
-
262
- 示例:
263
-
264
- ```powershell
265
- aun collab create alice.agentid.pub:/repo notes.md .\notes.md
266
- aun collab show alice.agentid.pub:/repo notes.md -o .\notes.md
267
- aun collab commit alice.agentid.pub:/repo notes.md .\notes.md --onto 1 --message "update"
268
- ```
269
-
270
- ## agent.md、密钥、诊断和压测
271
-
272
- agent.md:
273
-
274
- ```powershell
275
- aun agentmd upload
276
- aun agentmd download bob.agentid.pub
277
- aun agentmd check bob.agentid.pub --max-unsynced-days 1
278
- ```
279
-
280
- `upload_agent_md`、`download_agent_md`、`check_agent_md` 是 `upload`、`download`、`check` 的公开兼容别名。
281
-
282
- 密钥:
283
-
284
- ```powershell
285
- aun keys list
286
- aun keys rotate --type spk
287
- aun keys change-seed --old-seed .seed --new-seed "new-seed"
288
- ```
289
-
290
- 诊断:
291
-
292
- ```powershell
293
- aun status
294
- aun ping bob.agentid.pub --count 3
295
- aun doctor
296
- aun logs --tail 100
297
- aun logs --follow
298
- ```
299
-
300
- 压测:
301
-
302
- ```powershell
1
+ # AUN CLI 手册
2
+
3
+ ## 位置与入口
4
+
5
+ AUN CLI 是 Python SDK 的命令行工具,源码位于:
6
+
7
+ ```text
8
+ D:\modelunion\kite\aun-sdk-core\python\src\aun_cli
9
+ ```
10
+
11
+ 仓库内相对路径为 `python/src/aun_cli`。安装入口在 `python/pyproject.toml`:
12
+
13
+ ```toml
14
+ [project.scripts]
15
+ aun = "aun_cli.main:app"
16
+ ```
17
+
18
+ 开发环境可直接运行:
19
+
20
+ ```powershell
21
+ cd D:\modelunion\kite\aun-sdk-core\python
22
+ pip install -e .
23
+ aun --help
24
+ ```
25
+
26
+ 也可以不安装包,直接指定 `PYTHONPATH`:
27
+
28
+ ```powershell
29
+ $env:PYTHONPATH="D:\modelunion\kite\aun-sdk-core\python\src"
30
+ python -m aun_cli --help
31
+ ```
32
+
33
+ ## 全局用法
34
+
35
+ ```text
36
+ aun [全局选项] <command> [参数]
37
+ ```
38
+
39
+ 全局选项:
40
+
41
+ | 选项 | 说明 |
42
+ |------|------|
43
+ | `--profile, -p` | 仅本次命令使用指定 profile |
44
+ | `--json` | 输出 JSON,适合脚本 |
45
+ | `--debug` | 启用 debug 日志 |
46
+ | `--no-color` | 禁用彩色输出 |
47
+ | `--timeout, -t` | 操作超时秒数,默认 30 |
48
+ | `--version, -V` | 显示版本 |
49
+ | `--install-completion` | 安装当前 shell 的补全脚本,Typer 自动提供 |
50
+ | `--show-completion` | 输出补全脚本,Typer 自动提供 |
51
+ | `--help` | 显示帮助 |
52
+
53
+ CLI 不提供 `--gateway` 选项;Gateway 发现由 SDK 处理。
54
+
55
+ 非 JSON 模式会先打印当前 `profile`、`aid`、`active_group` 和 `trace`,命令结束时可能输出 RPC summary。脚本里建议使用 `--json`。
56
+
57
+ ## 配置与 Profile
58
+
59
+ 默认配置文件为 `~/.aun/cli.toml`。常用命令:
60
+
61
+ ```powershell
62
+ aun profile create dev --aid alice.agentid.pub
63
+ aun profile switch dev
64
+ aun profile current
65
+ aun profile list
66
+
67
+ aun config set timeout 60
68
+ aun config get timeout
69
+ aun config list
70
+ ```
71
+
72
+ `profile` 也挂在 `config` 下,`aun config profile list/current/create/switch` 与根级 `aun profile ...` 使用同一套实现。
73
+
74
+ 当前 profile 的核心字段:
75
+
76
+ | 字段 | 说明 |
77
+ |------|------|
78
+ | `aid` | 默认操作身份 |
79
+ | `aun_path` | 本地身份、密钥、日志等数据目录 |
80
+ | `active_group` | 默认群组;值使用目标态 `group_aid`,省略 `group_id` 兼容参数时使用 |
81
+ | `debug` / `trace` / `timeout` | 调试、trace 和超时配置 |
82
+
83
+ 有效 profile 选择顺序:
84
+
85
+ ```text
86
+ --profile > AUN_PROFILE > 当前终端标签页状态 > default.profile
87
+ ```
88
+
89
+ ## 身份命令
90
+
91
+ | 命令 | 用法 |
92
+ |------|------|
93
+ | `aun register <aid>` | 注册新 AID,并写入当前 profile |
94
+ | `aun login [aid]` | 加载本地身份、认证并连接一次 |
95
+ | `aun whoami` | 查看当前 profile / AID / 数据目录 |
96
+ | `aun identity list` | 列出本地身份 |
97
+ | `aun identity check <aid>` | 检查本地身份材料和远端注册状态 |
98
+
99
+ 示例:
100
+
101
+ ```powershell
102
+ aun register alice.agentid.pub
103
+ aun login alice.agentid.pub
104
+ aun whoami
105
+ aun identity check alice.agentid.pub
106
+ ```
107
+
108
+ ## P2P 消息命令
109
+
110
+ | 命令 | 用法 |
111
+ |------|------|
112
+ | `aun send <target-aid> <message>` | 发送 P2P 消息,默认加密 |
113
+ | `aun send <target-aid> -` | 从 stdin 读取消息 |
114
+ | `aun pull [--from aid] [--limit N] [--after-seq N]` | 拉取离线消息 |
115
+ | `aun ack <sender-aid> --seq N` | 确认消息 seq |
116
+ | `aun listen [--from aid] [--group group_id]` | 实时监听 P2P 和群消息;`group_id` 是兼容参数名,值使用 `group_aid` |
117
+
118
+ 示例:
119
+
120
+ ```powershell
121
+ aun send bob.agentid.pub "hello"
122
+ Get-Content .\msg.txt | aun send bob.agentid.pub -
123
+ aun pull --limit 20
124
+ aun listen --from bob.agentid.pub
125
+ ```
126
+
127
+ ## 群组命令
128
+
129
+ | 命令 | 用法 |
130
+ |------|------|
131
+ | `aun group create <name> [--members a,b] [--group-name name]` | 创建群;成功后自动设为 active group |
132
+ | `aun group use <group-id>` | 设置当前 active group |
133
+ | `aun group current` | 查看当前 active group |
134
+ | `aun group send [group-id] <message>` | 发送群消息;省略 group-id 时使用 active group |
135
+ | `aun group list` | 列出已加入群 |
136
+ | `aun group info [group-id]` | 查看群详情 |
137
+ | `aun group members [group-id]` | 查看成员 |
138
+ | `aun group invite [group-id] <aid...>` | 邀请成员 |
139
+ | `aun group add-member [group-id] <aid> [--role member|admin]` | 直接添加成员 |
140
+ | `aun group kick [group-id] <aid>` | 移除成员 |
141
+ | `aun group leave [group-id]` | 退出群 |
142
+ | `aun group dissolve [group-id]` | 解散群 |
143
+ | `aun group bind [group-id] [--group-name name]` | 为匿名群补齐 group_aid;`bind-aid` 是公开别名 |
144
+ | `aun group transfer [group-id] <new-owner>` | 转移群主 |
145
+ | `aun group complete-transfer [group-id]` | 完成转让后的 group.fs rekey |
146
+
147
+ `aun group add_member` 是 `aun group add-member` 的公开兼容别名。
148
+
149
+ 示例:
150
+
151
+ ```powershell
152
+ aun group create "项目讨论组" --members bob.agentid.pub,carol.agentid.pub
153
+ aun group current
154
+ aun group send "大家好"
155
+ aun group members
156
+ aun group add-member dave.agentid.pub --role member
157
+ ```
158
+
159
+ ## 群文件系统命令
160
+
161
+ `aun group fs` 对应 `group.fs.*` 和 SDK `client.group.fs`。裸路径使用当前 active group;完整 group path 也可直接传入。
162
+
163
+ | 命令 | 用法 |
164
+ |------|------|
165
+ | `aun group fs ls [path] [-l]` | 列出目录 |
166
+ | `aun group fs find [path] [--name "*.md"] [--type f]` | 查找节点 |
167
+ | `aun group fs stat <path>` | 查看节点 |
168
+ | `aun group fs lstat <path>` | 查看链接本身 |
169
+ | `aun group fs mkdir <path> [-p]` | 创建目录 |
170
+ | `aun group fs rm <path> [-r] [--force]` | 删除节点 |
171
+ | `aun group fs cp <src> <dst> [-r] [--force]` | 上传、下载或远程复制 |
172
+ | `aun group fs mv <src> <dst> [--force]` | 远程移动 |
173
+ | `aun group fs df [path]` | 查看用量 |
174
+ | `aun group fs setfacl <path> -m role:admin:<perms>` | 群主授予群自有区 admin 角色 ACL |
175
+ | `aun group fs setfacl <path> -x role:admin` | 群主撤销群自有区 admin 角色 ACL |
176
+ | `aun group fs getfacl <path>` | 查看群自有区角色 ACL |
177
+ | `aun group fs mount <path> [--readonly/--readwrite]` | 挂载成员数据区 |
178
+ | `aun group fs umount <path>` | 卸载成员数据区 |
179
+
180
+ 示例:
181
+
182
+ ```powershell
183
+ aun group fs mkdir /docs -p
184
+ aun group fs cp .\README.md /docs/README.md
185
+ aun group fs ls /docs -l
186
+ aun group fs setfacl /docs -m role:admin:rwx
187
+ aun group fs getfacl /docs
188
+ aun group fs cp /docs/README.md .\downloaded.md
189
+ ```
190
+
191
+ 群自有区写入需要使用当前 `group_identity` 对应的 `group_aid` 身份签名时,可通过 `--as <group-aid>` 指定操作者。`setfacl/getfacl` 只允许当前 group owner 调用;当前只支持 `role:admin` 角色 ACL,权限位对外显示为 POSIX 视图 `rwx`。
192
+
193
+ ## Storage VFS 命令
194
+
195
+ `aun fs` 是普通 Storage VFS 入口,路径格式为 `<AID>:/path`。裸路径自动使用当前 profile AID。
196
+
197
+ | 命令 | 用法 |
198
+ |------|------|
199
+ | `aun fs ls <path> [-l]` | 列目录 |
200
+ | `aun fs stat <path> [-L]` | 查看节点,`-L` 跟随链接 |
201
+ | `aun fs cat <path>` | 输出文件内容 |
202
+ | `aun fs cp <src> <dst>` | 本地/远程上传下载或远程复制 |
203
+ | `aun fs mv <src> <dst>` | 同 AID 内原子移动 |
204
+ | `aun fs rm <path> [-r]` | 删除 |
205
+ | `aun fs ln -s <target> <link-path>` | 创建软链 |
206
+ | `aun fs mkdir <path> [-p]` | 创建目录 |
207
+ | `aun fs touch <path> [-p] [--no-create] [--mtime TS]` | 创建空文件或更新时间戳 |
208
+ | `aun fs df <aid:>` | 查看用量 |
209
+ | `aun fs quota [aid:]` | 查看配额 |
210
+ | `aun fs du <path> [-h] [--max-depth N]` | 汇总路径占用 |
211
+ | `aun fs find <path> [--name PATTERN] [--type f|d|l]` | 查找 |
212
+ | `aun fs chmod +r <path>` / `aun fs chmod o-r <path>` | 设置 public/private |
213
+ | `aun fs setfacl <path> -m aid:<AID>:<perms>` / `-x aid:<AID>` | 设置或移除 ACL |
214
+ | `aun fs getfacl <path>` | 查看 ACL |
215
+ | `aun fs mount/approve/reject/umount ...` | 挂载生命周期 |
216
+ | `aun fs token issue/revoke/ls ...` | 访问 token 管理 |
217
+
218
+ 示例:
219
+
220
+ ```powershell
221
+ aun fs mkdir alice.agentid.pub:/docs -p
222
+ aun fs touch alice.agentid.pub:/docs/empty.txt --mtime 1700000000
223
+ aun fs cp .\a.txt alice.agentid.pub:/docs/a.txt
224
+ aun fs cat alice.agentid.pub:/docs/a.txt
225
+ aun fs token issue alice.agentid.pub:/docs/a.txt
226
+ ```
227
+
228
+ ## 对象存储兼容命令
229
+
230
+ `aun storage` 是对象级快捷入口,适合低层调试和兼容旧用法:
231
+
232
+ ```powershell
233
+ aun storage ls docs/
234
+ aun storage info docs/a.txt
235
+ aun storage upload .\a.txt --name docs/a.txt --force
236
+ aun storage download docs/a.txt -o .\a.txt --force
237
+ aun storage delete docs/a.txt
238
+ ```
239
+
240
+ 新应用优先使用 `aun fs`。
241
+
242
+ ## Collab 命令
243
+
244
+ `aun collab` 操作版本化协作目录:
245
+
246
+ | 命令 | 用法 |
247
+ |------|------|
248
+ | `aun collab ls-files <collab-root>` | 列出文档 |
249
+ | `aun collab create <root> <doc> <source>` | 创建文档 |
250
+ | `aun collab show <root> <doc> [--rev N] [-o file]` | 查看版本 |
251
+ | `aun collab commit <root> <doc> <source> --onto N` | 提交版本 |
252
+ | `aun collab merge <root> <doc> <source> --onto N` | 三方合并 |
253
+ | `aun collab log <root> <doc>` | 历史 |
254
+ | `aun collab diff <root> <doc> --from A --to B` | 差异 |
255
+ | `aun collab revert <root> <doc> --rev N` | 回退 |
256
+ | `aun collab clone <src> <dest> [--reroot]` | 克隆 |
257
+ | `aun collab prune/gc/reflog ...` | 清理和审计 |
258
+ | `aun collab ls-remote <group-aid>` | 列群内协作目录 |
259
+ | `aun collab unregister <group-aid> <root>` | 取消群注册 |
260
+ | `aun collab tag create/list/show/diff/restore/rm/prune ...` | 目录级标签 |
261
+
262
+ 示例:
263
+
264
+ ```powershell
265
+ aun collab create alice.agentid.pub:/repo notes.md .\notes.md
266
+ aun collab show alice.agentid.pub:/repo notes.md -o .\notes.md
267
+ aun collab commit alice.agentid.pub:/repo notes.md .\notes.md --onto 1 --message "update"
268
+ ```
269
+
270
+ ## agent.md、密钥、诊断和压测
271
+
272
+ agent.md:
273
+
274
+ ```powershell
275
+ aun agentmd upload
276
+ aun agentmd download bob.agentid.pub
277
+ aun agentmd check bob.agentid.pub --max-unsynced-days 1
278
+ ```
279
+
280
+ `upload_agent_md`、`download_agent_md`、`check_agent_md` 是 `upload`、`download`、`check` 的公开兼容别名。
281
+
282
+ 密钥:
283
+
284
+ ```powershell
285
+ aun keys list
286
+ aun keys rotate --type spk
287
+ aun keys change-seed --old-seed .seed --new-seed "new-seed"
288
+ ```
289
+
290
+ 诊断:
291
+
292
+ ```powershell
293
+ aun status
294
+ aun ping bob.agentid.pub --count 3
295
+ aun doctor
296
+ aun logs --tail 100
297
+ aun logs --follow
298
+ ```
299
+
300
+ 压测:
301
+
302
+ ```powershell
303
303
  aun bench send bob.agentid.pub --count 100 --concurrency 4
304
- aun bench group-send group.agentid.pub/10042 --count 100 --concurrency 4
304
+ aun bench group-send 10042.agentid.pub --count 100 --concurrency 4
305
305
  aun bench group send --count 100
306
306
  ```
307
-
308
- `aun bench group_send` 是 `aun bench group-send` 的公开兼容别名。
309
-
310
- ## 退出码
311
-
312
- | 退出码 | 含义 |
313
- |--------|------|
314
- | 0 | 成功 |
315
- | 1 | 通用错误 |
316
- | 2 | 参数错误 |
317
- | 3 | 认证失败 |
318
- | 4 | 连接失败 |
319
- | 5 | 超时 |
320
- | 6 | 权限不足 |
321
- | 7 | 目标不存在 |
322
-
323
- ## 相关实现文件
324
-
325
- | 文件 | 说明 |
326
- |------|------|
327
- | `python/src/aun_cli/main.py` | 根应用和命令注册 |
328
- | `python/src/aun_cli/config.py` | CLI 配置、profile、标签页状态 |
329
- | `python/src/aun_cli/adapter.py` | SDK 会话桥接、错误映射、RPC summary |
330
- | `python/src/aun_cli/output.py` | 输出格式 |
331
- | `python/src/aun_cli/commands/*.py` | 各命令组实现 |
307
+
308
+ `aun bench group_send` 是 `aun bench group-send` 的公开兼容别名。
309
+
310
+ ## 退出码
311
+
312
+ | 退出码 | 含义 |
313
+ |--------|------|
314
+ | 0 | 成功 |
315
+ | 1 | 通用错误 |
316
+ | 2 | 参数错误 |
317
+ | 3 | 认证失败 |
318
+ | 4 | 连接失败 |
319
+ | 5 | 超时 |
320
+ | 6 | 权限不足 |
321
+ | 7 | 目标不存在 |
322
+
323
+ ## 相关实现文件
324
+
325
+ | 文件 | 说明 |
326
+ |------|------|
327
+ | `python/src/aun_cli/main.py` | 根应用和命令注册 |
328
+ | `python/src/aun_cli/config.py` | CLI 配置、profile、标签页状态 |
329
+ | `python/src/aun_cli/adapter.py` | SDK 会话桥接、错误映射、RPC summary |
330
+ | `python/src/aun_cli/output.py` | 输出格式 |
331
+ | `python/src/aun_cli/commands/*.py` | 各命令组实现 |