Pinvou/pinvou-agent / pinvou3-app/src-tauri/resources/common/bundle/dingtalk-skills/dws
dws
Unverified【何时用:仅当用户明确指向钉钉/DingTalk(钉钉文档、钉钉日程等)时使用;泛指做文档/表格/待办/审批默认走本地工具,不要误用钉钉】用 dws CLI 管理钉钉:AI表格/AI搜问(找人首选)/目标管理(Agoal)/组织大脑/日历/通讯录/群聊与机器人消息/待办/审批/智能合同/考勤/日志(日报周报)/DING消息/钉钉文档/云盘/Markdown文件/HTML文件/AI听记/邮箱/在线电子表格(axls)/知识库/白板/开放平台文档/个人IM与OA事件订阅。用户要求操作上述钉钉产品时使用。
references/products/doc/doc-permission.md
View on GitHub# doc permission(文档权限:add / update / list)
> **前置条件(MUST READ):** 执行本命令前,必须先用 `read` 读取以下文件:
> 1. [`../doc.md`](../doc.md) — 命令路由 + 场景索引 + 意图判断 + 工作流
> **关键区分**:
> - "把**某篇文档**授权给某人" → `doc permission add`(节点级,包括「我的文档」下的文档都支持)
> - "把**某个知识库**整体授权给某人" → `wiki member add`(容器级,但**「我的文档」个人空间不支持**)
---
## doc permission add(节点级授权)
```
Usage:
dws doc permission add [flags]
Example:
dws doc permission add --node <DOC_ID> --users uid1 --role READER
dws doc permission add --node <DOC_ID> --users uid1,uid2 --role EDITOR
dws doc permission add --node "https://alidocs.dingtalk.com/i/nodes/<DOC_UUID>" --users uid1 --role MANAGER
Flags:
--node string 目标文档/文件夹的 ID 或 URL (必填)
--users string 被授权的用户 userId 列表,逗号分隔 (必填,单次最多 30 个)
--role string 授予的角色 (必填,大小写不敏感): MANAGER (管理者) / EDITOR (可编辑) / DOWNLOADER (可下载) / READER (可阅读)
--workspace string 所属知识库 ID (选填,仅用于辅助构造返回的 docUrl,业务实际依赖 nodeId)
```
> **重要约束**:
>
> - 仅支持 USER 类型授权。
> - 角色值大小写不敏感(CLI 内部统一规范化为大写):`MANAGER` / `EDITOR` / `DOWNLOADER` / `READER`(`OWNER` 不可通过此接口添加)。
> - 操作者需在该节点具备「可编辑(EDITOR)」及以上角色(OWNER / MANAGER / EDITOR)。
> - 授权对象是文档节点本身,不需要也不应该用 `wiki member add`(那个是知识库容器级授权)。
---
## doc permission update(修改权限)
```
Usage:
dws doc permission update [flags]
Example:
dws doc permission update --node <DOC_ID> --users uid1 --role EDITOR
dws doc permission update --node <DOC_ID> --users uid1,uid2 --role READER
Flags:
--node string 目标文档/文件夹的 ID 或 URL (必填)
--users string 目标用户 userId 列表,逗号分隔 (必填,单次最多 30 个)
--role string 新角色 (必填,大小写不敏感): MANAGER / EDITOR / DOWNLOADER / READER
--workspace string 所属知识库 ID (选填)
```
---
## doc permission list(列出权限)
```
Usage:
dws doc permission list [flags]
Example:
dws doc permission list --node <DOC_ID>
dws doc permission list --node <DOC_ID> --limit 50
dws doc permission list --node <DOC_ID> --filter-role EDITOR
Flags:
--node string 目标文档/文件夹的 ID 或 URL (必填)
--workspace string 所属知识库 ID (选填)
--limit int 返回成员数上限,默认 30,最大 200
--filter-role string 按角色过滤(逗号分隔): OWNER / MANAGER / EDITOR / DOWNLOADER / READER (选填)
```
> 接口不支持游标分页,使用 `--limit` 一次性拉取。
## 关键说明
- `--role` / `--filter-role` 建议传全大写枚举值:`MANAGER` / `EDITOR` / `DOWNLOADER` / `READER`(`OWNER` 仅出现在 list 结果与 `--filter-role` 中,不可通过 add 授予)。
- `--users` 单次最多 30 个 userId,逗号分隔。
- 需要 userId 时,使用 `dws contact user search --query "<姓名>"`(跨产品命令)取得。
## 上下文传递
| 从返回中提取 | 用于 |
|-------------|------|
| `dws contact user search` 的 `userId` | `permission add/update` 的 `--users` |
| [`./doc-search.md`](./doc-search.md) / [`./doc-list.md`](./doc-list.md) 的 `nodeId` | 三命令的 `--node` |
## 常用模板
```bash
# 查看谁有权限
dws doc permission list --node <DOC_ID> --format json
# 按角色过滤查看
dws doc permission list --node <DOC_ID> --filter-role EDITOR --format json
# 拉取更多结果(默认 30,最大 200)
dws doc permission list --node <DOC_ID> --limit 200 --format json
# 给单人开 READER 权限
dws doc permission add --node <DOC_ID> --users <uid1> --role READER --format json
# 给多人开 EDITOR 权限(最多 30 个 uid)
dws doc permission add --node <DOC_ID> --users <uid1>,<uid2>,<uid3> --role EDITOR --format json
# 设为管理者
dws doc permission add --node <DOC_ID> --users <uid1> --role MANAGER --format json
# 修改某人角色(READER → EDITOR)
dws doc permission update --node <DOC_ID> --users <uid1> --role EDITOR --format json
# 通过 alidocs URL 直接授权
dws doc permission add --node "https://alidocs.dingtalk.com/i/nodes/<DOC_UUID>" --users <uid1> --role READER --format json
```
## 参考
- [`../doc.md` §意图判断](../doc.md#意图判断)(如何路由到本命令族)
- `dws contact user search`(取 userId 的入口,跨产品命令)
- [`../wiki.md`](../wiki.md)(知识库容器级授权 `wiki member add`,与本节点级权限相区分)
Related skills
| Skill | Stars | Updated | Works with | Status | Install |
|---|---|---|---|---|---|
| slack-gif-creatoranthropics/skillsKnowledge and utilities for creating animated GIFs optimized for Slack. Provides constraints, validation tools, and animation concepts. Use when users request animated GIFs for Slack like "make me a GIF of X doing Y for Slack." | Stars: 198k | Updated | Claude CodeCodex | Verified | Install |
| ponytailDietrichGebert/ponytailLazy senior dev mode for any coding task: the smallest change that fully solves it, and a reply a busy human understands in one read. | Stars: 194k | Updated | Claude CodeCodex | Verified | Install |
| ponytail-debtDietrichGebert/ponytailHarvest every shortcut: comment into one debt ledger, so deferrals get tracked instead of forgotten. One-shot report. | Stars: 194k | Updated | Claude CodeCodex | Verified | Install |
| ponytail-debtDietrichGebert/ponytailList every `shortcut:` comment (and older `ponytail:` ones) as a debt ledger. One-shot report, changes nothing. Use for "ponytail debt", "what did ponytail defer", "list the shortcuts", /ponytail-debt. | Stars: 194k | Updated | Claude CodeCodex | Verified | Install |