120 lines
2.5 KiB
Markdown
120 lines
2.5 KiB
Markdown
---
|
|
name: feishu-perm
|
|
description: |
|
|
Feishu permission management for documents and files. Activate when user mentions sharing, permissions, collaborators.
|
|
---
|
|
|
|
# Feishu Permission Tool
|
|
|
|
Single tool `feishu_perm` for managing file/document permissions.
|
|
|
|
## Actions
|
|
|
|
### List Collaborators
|
|
|
|
```json
|
|
{ "action": "list", "token": "ABC123", "type": "docx" }
|
|
```
|
|
|
|
Returns: members with member_type, member_id, perm, name.
|
|
|
|
### Add Collaborator
|
|
|
|
```json
|
|
{
|
|
"action": "add",
|
|
"token": "ABC123",
|
|
"type": "docx",
|
|
"member_type": "email",
|
|
"member_id": "user@example.com",
|
|
"perm": "edit"
|
|
}
|
|
```
|
|
|
|
### Remove Collaborator
|
|
|
|
```json
|
|
{
|
|
"action": "remove",
|
|
"token": "ABC123",
|
|
"type": "docx",
|
|
"member_type": "email",
|
|
"member_id": "user@example.com"
|
|
}
|
|
```
|
|
|
|
## Token Types
|
|
|
|
| Type | Description |
|
|
| ---------- | ----------------------- |
|
|
| `doc` | Old format document |
|
|
| `docx` | New format document |
|
|
| `sheet` | Spreadsheet |
|
|
| `bitable` | Multi-dimensional table |
|
|
| `folder` | Folder |
|
|
| `file` | Uploaded file |
|
|
| `wiki` | Wiki node |
|
|
| `mindnote` | Mind map |
|
|
|
|
## Member Types
|
|
|
|
| Type | Description |
|
|
| ------------------ | ------------------ |
|
|
| `email` | Email address |
|
|
| `openid` | User open_id |
|
|
| `userid` | User user_id |
|
|
| `unionid` | User union_id |
|
|
| `openchat` | Group chat open_id |
|
|
| `opendepartmentid` | Department open_id |
|
|
|
|
## Permission Levels
|
|
|
|
| Perm | Description |
|
|
| ------------- | ------------------------------------ |
|
|
| `view` | View only |
|
|
| `edit` | Can edit |
|
|
| `full_access` | Full access (can manage permissions) |
|
|
|
|
## Examples
|
|
|
|
Share document with email:
|
|
|
|
```json
|
|
{
|
|
"action": "add",
|
|
"token": "doxcnXXX",
|
|
"type": "docx",
|
|
"member_type": "email",
|
|
"member_id": "alice@company.com",
|
|
"perm": "edit"
|
|
}
|
|
```
|
|
|
|
Share folder with group:
|
|
|
|
```json
|
|
{
|
|
"action": "add",
|
|
"token": "fldcnXXX",
|
|
"type": "folder",
|
|
"member_type": "openchat",
|
|
"member_id": "oc_xxx",
|
|
"perm": "view"
|
|
}
|
|
```
|
|
|
|
## Configuration
|
|
|
|
```yaml
|
|
channels:
|
|
feishu:
|
|
tools:
|
|
perm: true # default: false (disabled)
|
|
```
|
|
|
|
**Note:** This tool is disabled by default because permission management is a sensitive operation. Enable explicitly if needed.
|
|
|
|
## Permissions
|
|
|
|
Required: `drive:permission`
|