@agentunion/fastaun-browser 0.5.1 → 0.5.3
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.
- package/CHANGELOG.md +570 -504
- package/_packed_docs/CHANGELOG-validators.md +134 -131
- package/_packed_docs/CHANGELOG.md +570 -504
- package/_packed_docs/INDEX.md +65 -52
- package/_packed_docs/KITE_DOCS_GUIDE.md +23 -18
- 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
- package/_packed_docs/aun-perf-audit-critical-bugs.md +315 -0
- package/_packed_docs/cli/AUN-CLI/350/256/276/350/256/241/346/226/207/346/241/243.md +263 -261
- package/_packed_docs/cli/CLI/346/211/213/345/206/214.md +328 -328
- package/_packed_docs/protocol/00-/346/200/273/350/247/210/344/270/216/345/210/206/345/261/202.md +2 -2
- 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
- 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
- package/_packed_docs/protocol/03-Gateway-/350/277/236/346/216/245/346/250/241/345/274/217.md +8 -5
- package/_packed_docs/protocol/06-/346/234/215/345/212/241/345/215/217/350/256/256.md +18 -19
- 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
- package/_packed_docs/protocol/08-AUN-E2EE-Group.md +293 -294
- package/_packed_docs/protocol/08-AUN-E2EE.md +12 -10
- package/_packed_docs/protocol/10-Group-/345/255/220/345/215/217/350/256/256.md +183 -60
- package/_packed_docs/protocol/11-Storage-/345/255/220/345/215/217/350/256/256.md +4 -4
- 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
- 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
- package/_packed_docs/protocol/README.md +7 -6
- package/_packed_docs/protocol/aun-docs-guide.md +5 -4
- package/_packed_docs/protocol/index.md +9 -8
- 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
- package/_packed_docs/protocol//351/231/204/345/275/225A-/346/234/257/350/257/255/350/241/250.md +13 -13
- 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
- package/_packed_docs/sdk/02-WebSocket/345/215/217/350/256/256.md +15 -13
- package/_packed_docs/sdk/03-/346/240/270/345/277/203/346/246/202/345/277/265.md +20 -1
- package/_packed_docs/sdk/04-/350/277/236/346/216/245/344/270/216/350/256/244/350/257/201.md +26 -18
- package/_packed_docs/sdk/05-E2EE/345/212/240/345/257/206/351/200/232/344/277/241.md +33 -34
- package/_packed_docs/sdk/06-API/346/211/213/345/206/214.md +274 -4
- package/_packed_docs/sdk/07-/351/224/231/350/257/257/345/244/204/347/220/206.md +41 -13
- package/_packed_docs/sdk/08-/346/234/200/344/275/263/345/256/236/350/267/265.md +28 -12
- package/_packed_docs/sdk/09-group-rpc-manual.md +237 -142
- package/_packed_docs/sdk/09-message-rpc-manual.md +50 -28
- package/_packed_docs/sdk/09-payload-reference.md +3 -3
- package/_packed_docs/sdk/09-storage-rpc-manual.md +1 -1
- package/_packed_docs/sdk/AUN_DOCS_GUIDE.md +12 -9
- 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
- package/_packed_docs/sdk/INDEX.md +29 -28
- package/_packed_docs/sdk/Notify/351/200/232/347/237/245/346/226/271/346/241/210.md +6 -2
- package/dist/agent-md.d.ts.map +1 -1
- package/dist/agent-md.js +18 -9
- package/dist/agent-md.js.map +1 -1
- package/dist/bundle.js +1084 -272
- package/dist/client/delivery.d.ts +4 -0
- package/dist/client/delivery.d.ts.map +1 -1
- package/dist/client/delivery.js +174 -7
- package/dist/client/delivery.js.map +1 -1
- package/dist/client/v2-e2ee.d.ts.map +1 -1
- package/dist/client/v2-e2ee.js +79 -8
- package/dist/client/v2-e2ee.js.map +1 -1
- package/dist/client.d.ts +27 -1
- package/dist/client.d.ts.map +1 -1
- package/dist/client.js +118 -12
- package/dist/client.js.map +1 -1
- package/dist/facades.d.ts +6 -0
- package/dist/facades.d.ts.map +1 -1
- package/dist/facades.js +213 -33
- package/dist/facades.js.map +1 -1
- package/dist/group-index.d.ts +105 -0
- package/dist/group-index.d.ts.map +1 -0
- package/dist/group-index.js +252 -0
- package/dist/group-index.js.map +1 -0
- package/dist/index.d.ts +1 -0
- package/dist/index.d.ts.map +1 -1
- package/dist/index.js +1 -0
- package/dist/index.js.map +1 -1
- package/dist/keystore/index.d.ts +15 -0
- package/dist/keystore/index.d.ts.map +1 -1
- package/dist/keystore/indexeddb-shared.d.ts +7 -1
- package/dist/keystore/indexeddb-shared.d.ts.map +1 -1
- package/dist/keystore/indexeddb-shared.js +63 -2
- package/dist/keystore/indexeddb-shared.js.map +1 -1
- package/dist/keystore/indexeddb-token-store.d.ts +3 -1
- package/dist/keystore/indexeddb-token-store.d.ts.map +1 -1
- package/dist/keystore/indexeddb-token-store.js +22 -1
- package/dist/keystore/indexeddb-token-store.js.map +1 -1
- package/dist/tools/cross-sdk-agent.js +3 -1
- package/dist/tools/cross-sdk-agent.js.map +1 -1
- package/dist/transport.d.ts +2 -1
- package/dist/transport.d.ts.map +1 -1
- package/dist/transport.js +17 -31
- package/dist/transport.js.map +1 -1
- package/dist/version.d.ts +1 -1
- package/dist/version.js +1 -1
- 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` |
|
|
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
|
|
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` | 各命令组实现 |
|