# 文件与权限

> 团队文件夹、文件夹规则，以及服务器如何以提问者的身份检查 AI 打开的每个文件。

公司的资料都放在服务器上的一个团队文件夹里。文件夹规则决定谁能看到什么。AI 能看到的内容，永远不会超过提问的那个人。

## 团队文件夹

| 文件夹 | 谁能看到 | 用途 |
|---|---|---|
| `shared/` | 按规则决定，通常是所有人 | 全公司的文件 |
| `groups/<group>/` | 该小组，以及规则另外加入的人 | 小组的文件，例如销售或财务；小组自己的技能放在其中的 `skills/` 里 |
| `projects/<project>/` | 按规则决定 | 有自己文件夹和指示的工作 |
| `skills/` | 所有人可读；技能管理者可写 | 团队技能和团队规则 |
| `users/<id>/` | 只有本人 | 个人文件和个人技能 |

## 如何决定访问权限

服务器上由一个权限函数决定每一次访问。操作系统会阻止 AI 绕过它。

- 你无法打开的文件是**看不见的**，而不是显示“拒绝访问”。文件、AI 的回答、搜索、预览、版本历史、回收站和实时更新，都遵循同一条规则。
- 一个人的权限来自文件上方**最近一条点名此人的规则**。针对个人的规则优先于针对小组的规则。如果一个人属于多个小组，以权限最大的那个为准。
- 更改**立即**生效。AI 每次调用工具时都会重新读取权限。
- 收回权限，不会删除之前已经引用过某个文件的回答。

## 共享文件夹

所有者和管理员可以像在 Google Drive 里一样共享文件夹：**文件 › 文件夹的 ⋯ › 共享**，或 **管理 › 文件夹权限 › 共享**。两者打开的是同一个对话框。

1. **添加人员和小组**

   输入名字。每个人或小组可以设为**查看者**或**编辑者**。**移除权限**也在同一个菜单里。

2. **检查一般权限**

   **受限**：只有列出的人能打开。也可以设为整个团队，作为**查看者**或**编辑者**。没有自己设置的文件夹，会显示它从上一层文件夹继承的权限，并提供**去那里更改**。

3. **保存前检查**

   对话框会列出谁将获得或失去权限。在你保存之前，什么都不会改变。授予更多权限之前会先询问你；如果某项限制会把上一层文件夹允许的人挡在外面，也会先询问你。

![共享“Marketing”：添加人员和小组；有权限的人中 Sam Ortiz 是查看者，Dana Brooks 是来自“budget”的编辑者并带有“去那里更改”，所有者和管理员是管理者；下面是一般权限“受限”和设置 › 限制权限](../../images/zh/files/share-dialog.webp "文件夹的共享对话框")

权限是叠加的，就像在 Google Drive 中一样：一个文件夹给出的权限，会加在上层文件夹给出的权限之上。比上层更低的角色无法选择；这一行会说明更高的角色来自哪里（“编辑者，来自“全公司共享””）。

如果要让某个文件夹的权限低于上层文件夹，请打开**设置 › 限制权限**。之后，只有在那里添加的人员和小组才能打开它。**权限已移除**会列出能打开上层文件夹、但不能打开这个文件夹的人；点**添加**可以把其中一人作为查看者加回来。再次关闭限制时，任何低于上层文件夹的角色都会提升到上层的级别。

所有者和管理员始终可以打开团队文件夹，但他们不是成员的项目除外。他们显示为一行**管理者**。

> **注意:** 在让权限变为叠加的那次更新之后，有些文件夹会按名字列出其中的人（标记为**在文件夹调整时添加**），文件夹权限页面也会显示一次性通知，列出这些人。按名字添加的人，即使之后离开了小组，也仍然保留访问权限。**管理 › 小组**和这个人的页面会在保存前提醒这一点，并提供**立即移除**。

**管理 › 文件夹权限 › 文件夹**只列出与所在上层文件夹共享方式不同的文件夹，名称与文件中显示的相同；把人挡在外面的文件夹会标为**受限**。**共享**会打开该文件夹的共享对话框。项目文件夹只占一行：项目的成员要在项目中更改。

![管理 › 文件夹权限 › 文件夹：列出共享方式不同的文件夹，每个都显示谁能访问以及共享按钮](../../images/zh/files/folder-permissions.webp "文件夹权限中的文件夹列表")

**某人能打开什么**针对某一个人（因此也就是他的 AI）显示每个文件夹是查看者还是编辑者以及原因，并列出他打不开的文件夹。

> **警告:** `skills/` 里存放的是每位成员的 AI 都会遵循的说明。拥有那里的写入权限，就意味着成为技能管理者。在 AI 把内容保存到 `skills/` 之前，服务器会请一个人确认。小组的 `groups/<group>/skills/` 也是一样：该小组每位成员的 AI 都会遵循它，而任何可以写入该小组文件夹的成员都能更改它。

![某人能打开什么：每个文件夹显示查看者或编辑者及原因，下面是他打不开的文件夹](../../images/zh/files/by-person.webp "某人能打开什么")

## 使用文件

![文件页面：团队文件夹，包含全公司共享、小组、项目、团队技能和个人](../../images/zh/files/files.webp "文件页面")

![手机上的文件：最近的文件、团队文件夹、项目文件夹、我的文件和回收站](../../images/zh/files/files-phone.webp "手机上的文件")

- **上传**：在文件页面上传文件或整个文件夹。
- **版本历史**：每次更改都会保留一个版本，你可以打开或恢复它。
- **回收站**：**文件 › 回收站**按名称和原来所在的位置，列出你可以恢复的内容（“price-sheet.xlsx · 全公司共享 › 销售”）。被删除过不止一次的文件只显示为一行，里面有它的各个副本：**恢复**会找回最新的那份，打开这一行则可以恢复其他任何副本。如果列表里有其他人删除的内容，**我删除的**只显示你删除的。超过团队的保留期限后（管理 › 团队设置，默认 30 天），条目会被永久删除；每一行都会写明删除时间。
- **格式**：AI 可以读取 PDF、Office 和 HWP/HWPX 文件中的文字，并把照片和扫描页当作图片来看（管理员可以关闭这一功能）。Linux 服务器不运行 OCR。
- **确认**：当 AI 要把受限内容写到更多人能看到的地方时，服务器会先询问。

## HTML 转 PDF

HTML 文件（例如 AI 写的报价单或报告）可以变成和页面看起来一样的 PDF：保留它的颜色和背景、合并的表格单元格、页面自己的 `@page` 规则中的页面大小和页边距（没有指定时为 A4），以及分页。

- **在预览中**：打开 `.html` 文件，在预览顶部点**另存为 PDF**。PDF 会以相同名称保存在页面旁边，通知中会附上它的链接。同一页面的第二个 PDF 会保存为 `name (2).pdf`，绝不会覆盖第一个。在你只能读取的文件夹中，PDF 会改为下载。在手机上，这个操作在 **⋯** 菜单里。
- **让 AI 来做**：“把 quote.html 转成 PDF”。AI 会直接打印这个页面，不会把它改写成 Markdown。
- **PDF 用到什么**：页面本身，以及它通过相对路径引用的、团队文件夹中的图片、样式表和字体。网址永远不会被加载：网络图片会显示为灰色方块，和预览中一样。请把图片保存到团队文件夹里，并用路径引用它。页面中的脚本不会运行，所以由脚本绘制的部分会缺失；请把这部分写成普通的 HTML。
- **限制**：最多 200 页、50 MB，每页大约一分钟。一台服务器同时只制作几个 PDF，其余的会排队等待。
- **在哪里可用**：服务器在其转换沙箱中用无界面的 Chromium 打印，不联网。Linux 服务器在安装了 Debian 的 `chromium` 软件包后才有它（开发环境会安装它，用开发环境制作的托管服务器镜像也会安装）。在 Linux 服务器上，每次打印都有自己的内存限制，与其他转换分开，服务器至少需要 3 GB 内存（6 GB 起可以同时打印两个）。没有浏览器或内存不足的服务器不会显示这个操作，AI 也会说明它无法打印 HTML。管理员可以用 `MYCEL_HTML_PDF_BROWSER` 指定浏览器（[环境变量](/docs/reference/environment.md)（英文））。

完整说明：[安全与权限](https://github.com/trina-app/trina-ax/blob/main/docs/security-and-permissions.md)（英文）和[权限模型（韩文）](https://github.com/trina-app/trina-ax/blob/main/docs/PERMISSIONS.md)。
