Skip to content

Commit d5cdb55

Browse files
committed
docs(lark-wiki): correct the --as default-identity claim
The skill doc claimed wiki list/copy shortcuts default to --as user, but the CLI --as default is `auto` (no --as commonly resolves to bot, listing the app's spaces instead of the user's). Running `wiki +space-list` without --as therefore returns app-scoped data, contradicting the doc. Following the established lark-mail convention (concise user-centric guidance, not a precedence essay): - add a short "优先使用 user 身份" section to SKILL.md - fix the --as rows in lark-wiki-space-list / node-list / node-copy references to show the real `auto` default and steer to --as user Change-Id: I539f8d622c1bbad57f8a64c2fc7b7ecc0dfe2116
1 parent 14a3213 commit d5cdb55

4 files changed

Lines changed: 7 additions & 3 deletions

File tree

skills/lark-wiki/SKILL.md

Lines changed: 4 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -18,6 +18,10 @@ metadata:
1818
> - 遇到“部门 + --as bot”时,禁止先调用 `lark-cli wiki members create` 试错;直接说明该路径不可行。
1919
> - 如果用户明确要求“以 bot 身份运行”,且目标是部门,必须停下说明 bot 路径无法完成,不要静默切到 `--as user`
2020
21+
## 身份选择:优先使用 user 身份
22+
23+
知识空间和节点都是用户的个人资源,**策略上应优先显式使用 `--as user`**(CLI 的 `--as` 默认值为 `auto`,不带 `--as` 时常被解析成 `bot`,列出的是应用所属空间而非用户的)。仅当用户明确要求“应用 / bot 视角”时才用 `--as bot`(仍受上面的成员管理硬限制约束)。
24+
2125
## 快速决策
2226

2327
- 用户给的是知识库 URL(`.../wiki/<token>`),且后续要查成员/加成员/删成员:先调用 `lark-cli wiki spaces get_node --params '{"token":"<wiki_token>"}'` 获取 `space_id`,后续成员接口统一使用 `space_id`

skills/lark-wiki/references/lark-wiki-node-copy.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -27,7 +27,7 @@ lark-cli wiki +node-copy \
2727
| `--title` | No | New title for the copied node. Omit to keep the original title |
2828
| `--yes` | **Yes** | Confirm the high-risk operation. Without this flag the shortcut refuses to send the API request |
2929
| `--format` | No | Output format: `json` (default) / `pretty` / `table` / `csv` / `ndjson` |
30-
| `--as` | No | Identity: `user` or `bot` (default: `user`) |
30+
| `--as` | No | Identity `user`/`bot` (default `auto`); wiki is user-centric → pass `--as user` |
3131

3232
> At least one of `--target-space-id` or `--target-parent-node-token` must be provided.
3333

skills/lark-wiki/references/lark-wiki-node-list.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -38,7 +38,7 @@ lark-cli wiki +node-list --space-id <SPACE_ID> --format pretty
3838
| `--page-all` | bool | No | `false` | Automatically paginate through all pages (capped by `--page-limit`) |
3939
| `--page-limit` | int | No | 10 | Max pages with `--page-all` (0 = unlimited) |
4040
| `--format` | enum | No | `json` | `json` / `pretty` / `table` / `csv` / `ndjson` |
41-
| `--as` | enum | No | `user` | Identity: `user` or `bot` |
41+
| `--as` | enum | No | `auto` | Identity `user`/`bot`; wiki is user-centric → pass `--as user` (`my_library` requires `--as user`) |
4242

4343
## Output
4444

skills/lark-wiki/references/lark-wiki-space-list.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -31,7 +31,7 @@ lark-cli wiki +space-list --format table
3131
| `--page-all` | bool | `false` | Automatically paginate through all pages (capped by `--page-limit`) |
3232
| `--page-limit` | int | 10 | Max pages with `--page-all` (0 = unlimited) |
3333
| `--format` | enum | `json` | `json` / `pretty` / `table` / `csv` / `ndjson` |
34-
| `--as` | enum | `user` | Identity: `user` or `bot` |
34+
| `--as` | enum | `auto` | Identity `user`/`bot`; wiki is user-centric → pass `--as user` |
3535

3636
## Output
3737

0 commit comments

Comments
 (0)