知拾使用指南

账号与登录

登录可使用用户名或登录邮箱，昵称仅用于展示。网站邀请用于创建账号，空间邀请用于加入协作，两者的用途不同。

• 注册方式或邀请不清楚时，查看网站邀请与空间邀请。
• 忘记密码、收不到邮件或链接暂时无法验证时，按邮件与链接处理步骤操作；临时错误可用原链接重试，请求频繁时等待倒计时。
• 邮箱验证、修改密码与退出设备，见账号设置和退出登录说明。

网站管理员：部署后的设置顺序

新安装使用本地文件存储，默认关闭注册。先确认自己的账号和文件操作可用，再按需要接入云存储、邀请成员或配置邮件。

1. 用初始化账号登录。使用部署时设置的管理员邮箱和密码，项目没有通用默认密码。登录后在账号设置中完善个人信息；以后修改密码也在这里完成，修改初始化配置不会重设现有账号。
2. 确认文件能保存和读取。在文件库上传一个小文件并下载核对。默认本地存储即可使用；需要云存储时再按下方说明配置。
3. 需要多人使用时开启邀请。先由部署维护者设置可访问的 HTTPS 网站地址，再到网站管理 → 用户与注册选择“邀请注册”并保存。生成的链接需要自行发送给对应用户，不会自动发送邮件。
4. 需要邮件功能时再配置 SMTP。邮件服务在服务器配置，公开注册策略在网页中设置。确认受控邮箱能收到验证或找回邮件、链接地址正确后，再选择“公开注册”。仅保存 SMTP 配置不会自动开放注册。

本机 HTTP 试用适合管理员登录和文件操作；生产模式的邀请链接、邮件功能需先设置 HTTPS 网站地址。只使用自己的账号时，可以一直保持关闭注册。管理员自己的 AI 服务也需要在个人设置中单独配置。

网站邀请的独立搜索、翻页和撤销，以及停用影响、紧急停用和恢复交接，见网站账号与邀请管理。

文件存储：默认本地，云服务按需配置

默认把文件保存到部署服务器的数据卷，无需填写云服务密钥。网页中的“本地服务器”指部署服务器，不是访问者的电脑。

1. 管理员进入网站管理 → 文件存储，按实际服务填写存储桶、区域、端点和访问密钥。
2. 测试连接并保存配置，然后在列表中点击“启用所选位置”。测试通过、保存配置和启用上传位置是三个不同步骤。
3. 上传一个新文件，确认当前上传位置及文件读取结果。切换只影响后续上传，旧附件仍从原位置读取。

保留旧服务中的文件、对应配置和凭据。Docker 部署需保留完整的数据卷；云存储使用的加密密钥也随数据保存，应与数据库、附件一起备份。更换存储服务不能替代完整备份。

云存储访问密钥填在文件存储页面；个人 AI 的 API Key 填在 AI 服务页面，两者不能互用。

常见问题

没有 AI API Key，可以先使用吗？

可以先记录灵感、上传和编辑文件。需要生成、总结或整理需求时，再连接个人 AI 服务。购买网页聊天会员不一定包含 API 调用权限，请向对应供应商确认。

为什么没有注册入口，或收不到找回邮件？

是否开放注册由网站管理员决定。新安装默认关闭；邀请注册需要管理员提供的有效链接。邮件功能还依赖正确的网站地址和实际投递情况。请先按邮件与链接处理步骤核对；仍有问题时联系管理员或通过问题反馈说明情况。

为什么配置保存后，实际使用没有变化？

检查 AI 供应商是否已设为当前，以及对话选中了哪个模型；检查云存储是否已单独启用。注册方式需点击“保存策略”。服务器环境变量修改后，需要按对应部署方式重新加载应用配置。

上传提示额度或磁盘不足，应该找谁处理？

成员可先清理不再需要的资料；回收站中的资料仍计入额度。管理员可在“用户与注册”中调整账号额度。服务器剩余空间不足则需部署维护者处理，增加账号额度不会增加服务器磁盘容量。