如何为豆包智能体知识库分配外部访客只读权限？
功能定位：为什么需要“访客只读”
在豆包里，智能体知识库（下称知识库）默认仅创建者可见。一旦你需要把选定的资料开放给外部合作方——例如让广告代理查阅品牌手册，却又不希望他们改动或下载——就必须启用“访客只读”这一独立权限位。它位于豆包权限模型的最下游，仅高于“禁止访问”，可显著降低因误操作或恶意抓取带来的泄密风险。
与“团队成员可编辑”相比，访客只读有三条硬边界：①不可新增/删除文件；②不可看到评论与批注；③无法调用插件市场里的第三方动作。经验性观察：当访客超过 50 人同时在线检索时，知识库查询延迟会由亚秒级升至 2–4 秒，因此官方在 UI 上隐藏了“批量生成访客链接”的入口，需手动逐个添加。
功能定位：为什么需要“访客只读”
前置检查：版本、容量与合规
1. 版本与平台差异
截至当前的最新版本（v7.4.2），访客只读权限已在 Android / iOS / Windows / macOS 四端同步上线，但入口深度不同；网页版暂仅支持查看，不可配置权限。
2. 容量配额
单个知识库上限 50 GB，访客下载行为被完全阻断，因此流量不计入你的“共享流量包”。但若访客触发高清预览（4K 图片、1080p 视频），仍消耗创建者账号的“高速通道”额度，峰值约 0.5 GB/小时/人，需留意。
3. 合规红线
上传含个人信息的文件前，须完成“可撤销训练”开关的二次确认；否则即使访客只读，也可能因字节跳动内部合规抽检被临时冻结整个知识库。
三端最短操作路径
Android / iOS
- 打开豆包 App → 底栏「智能体」→ 选择目标分身 → 右上角「···」→「知识库管理」。
- 点击「权限」→「添加访客」→ 输入对方抖音号或手机号 → 角色选「只读」→ 发送邀请。
- 对方在「消息-系统通知」里接受后，即可在「好友-访客列表」中看到知识库入口。
Windows / macOS
- 桌面端左侧栏「我的智能体」→ 双击分身 → 顶部「知识库」→ 右侧「权限」图标（锁形）。
- 在弹窗切到「访客」标签 → 点击「+」→ 输入账号 → 权限滑块拖到「只读」→ 确定。
- 若需批量邀请，可先在飞书多维表里维护账号清单，复制整列后粘贴至输入框，系统会自动逐行识别。
提示：桌面端支持拖拽文件夹批量设置权限，移动端只能单文件操作。
回退与例外：如何临时升级或回收
在项目制场景里，常见“先只读后临时编辑”的需求。豆包目前不允许访客自升降权限，必须由创建者手动操作：权限面板 → 选中用户 → 角色切换至“协作者”→ 二次短信验证后即可。经验性观察：升级后 5 分钟内，访客侧需重新拉取索引，期间搜索会提示“数据同步中”，最长不超过 180 秒。
若需立即回收权限，直接删除访客账号即可，对方客户端将实时踢出并清空本地缓存。若只想阻断新增文件可见，可保留访客身份但关闭“同步更新”开关，历史已缓存内容仍可离线查看，直到对方手动清除 App 数据。
回退与例外：如何临时升级或回收
与分身 Bot 的协同：最小权限原则
很多用户会把知识库挂接在「分身 Bot」上，再嵌入抖音直播间。此时访客实际通过 Bot 间接访问知识库，权限仍以“访客只读”为天花板。若你在 Bot 的「系统提示词」里写了“请根据知识库回答”，但忘记把访客加入知识库，Bot 会返回“知识库未授权”的兜底文案，造成直播翻车。
警告：Bot 的「公开搜索」开关与知识库权限是并集关系，切勿以为关闭开关就能代替访客授权。
故障排查：访客无法访问的 4 类高频原因
| 现象 | 最可能根因 | 验证步骤 | 处置 |
|---|---|---|---|
| 提示“知识库不存在” | 访客未接受邀请 | 让访客检查「系统通知」 | 重新发送邀请 |
| 封面可见，点进文件空白 | 文件被设为“内部” | 创建者查看文件右侧小图标是否带“内”字 | 批量选中→切换为“外部可见” |
| 视频预览转圈 | 高速通道额度耗尽 | 设置-账号-高速通道余量 | 购买加油包或次日重置 |
| 安卓端闪退 | MIUI 14 系统 WebView 冲突 | 系统设置→应用→豆包→清除缓存 | 升级系统 WebView 至最新 |
适用/不适用场景清单
- 适用：渠道培训材料、品牌手册、公开论文库、直播 FAQ、售后视频教程。
- 不适用：含个人身份信息（PII）的客户档案、需双方协同编辑的报价单、实时更新的股价模型、大于 500 MB 的未压缩视频原片（访客预览会卡顿）。
最佳实践 6 条
- 先建「测试库」邀请自己小号体验，确认无空白文件后再正式开放。
- 对同一项目建「内部完整库」与「访客只读库」双库隔离，用飞书多维表定期同步差异，避免误把内部文件拖进只读库。
- 每季度用「权限体检」工具（桌面端 设置-安全-权限体检）一键回收已离职外部伙伴的访客身份。
- 若文件大于 200 MB，先在本地压缩至 720p 再上传，可节省约 40% 高速通道流量。
- 直播高峰前 30 分钟，提前把高频问答 PDF 置顶，降低 Bot 检索延迟。
- 对合规敏感文件，开启「即时遗忘」开关，并设置 7 天自动失效，到期后访客端自动清空缓存。
FAQ：访客只读权限常见疑问
访客人数上限是多少？
经验性观察：单库同时在线访客超过 50 人时查询延迟明显，官方未公开硬上限，建议分库分流。
可以禁止访客复制文字吗？
目前只读权限仅屏蔽下载与编辑，文字选中仍可用；如需防复制，可把敏感页转成图片再上传。
访客能否把文件转发给其他人？
访客无法在 App 内生成新分享链接，但可截图或录屏；敏感内容建议加水印并定期更换。
删除访客后，对方本地缓存多久清空？
立即踢出并置灰入口，已缓存文件在对方下次重启 App 后彻底清空，最长不超过 24 小时。
可以一次性导入企业微信通讯录吗？
目前仅支持飞书多维表批量粘贴，企业微信需先导出为 Excel 再复制粘贴。
总结与下一步行动
豆包智能体知识库的访客只读权限，用一句口诀记：“先双库隔离，再逐个加人，开预览不开下载，季度体检回收。” 完成本文三步验证后，你可立即在测试库邀请同事小号，确认 30 分钟无异常后再把正式链接发给外部伙伴。若后续需要协同编辑，再手动升级为“协作者”并开启操作日志，即可在效率与安全之间取得平衡。
展望未来版本，经验性观察显示官方正在灰度“访客水印+动态失效”组合功能，预计将在 v7.5 前后扩大开放；建议提前在测试库体验，以便功能全量上线后第一时间接入。