Melior

使用文档

Melior 的使用说明。遇到问题先看这里。

一、云端模式（推荐）

网站部署在云端后自动进入云端模式：笔记、会话、留言都同步到服务器，AI 请求由服务器转发（密钥不暴露）。

1. 点左下角「设置」→ 填「访问口令」→ 保存。
2. 「对话模型」可留空（用口令绑定的默认模型），也可手动填模型名。
3. 回到聊天页发消息即可。首次切换口令后等待 1~2 秒同步。

二、口令说明

口令 = 访问凭证，不同口令可绑定不同 AI 提供商（用户越多越方便管理）：

• 管理员口令：在 Cloudflare 控制台设置的 ACCESS_TOKEN，可进入「设置 → 云端管理」维护提供商和口令列表；管理员聊天默认使用 ID 为 default 的提供商。
• 普通口令：由管理员在「云端管理 → 口令 → 提供商」中创建。每个口令绑定一个提供商，聊天自动使用该提供商的密钥。
• 口令填错会提示「访问口令错误」（401）；提供商未配置会提示 503。

三、云端管理（管理员）

1. 打开「设置」，访问口令填管理员口令，展开「云端管理」。
2. AI 提供商表格：ID 填 default 等唯一标识，填写 Base URL（如 https://open.bigmodel.cn/api/paas/v4）、API Key。保存后即可用。
3. 口令 → 提供商表格：加行，口令、提供商 ID、主模型（必填，直接输入模型名）、副模型（可选）、备注（如"给某同学"）。保存后该口令即可聊天。
4. API Key 留空保存 = 不改（保留旧值）；删行保存 = 删除。删除提供商前请确认没有口令还在用它。

四、本地模式（自己电脑上用）

在 localhost 打开（或手动开启本地模式）时，AI 直连服务商，需要自己填「接口地址 / API Key / 对话模型」。本地模式不涉及口令。

五、功能速览

• AI 聊天：流式输出、语音输入（按住空格/按钮）、联网搜索、推理档位、引用笔记、保存为笔记。
• 笔记：富文本编辑、置顶、搜索、导出 .md。
• 留言板：公开留言，无需口令。
• 论坛：注册账号发帖回帖、楼中楼、点赞、附件上传（详见第七节）。
• 寄存柜：小型网盘——上传文件换 5 位取件码，凭码取件下载（详见第八节）。
• 仪表盘：系统状态（服务器 / 数据库 / 附件存储 / 网络趋势）+ 本地数据概览。

六、侧边栏

• 拖拽排序：侧边栏导航条目可按住拖动，松手即换位，顺序自动保存。
• 新对话：打开 AI 聊天时，导航与设置之间会出现「新对话」快捷入口（平时位置留白，偶有一句闲话）。
• 底部：左下角依次是「文档」（使用说明）与「设置」，一条细线隔开。
• 折叠：顶部按钮把侧边栏收成窄条，图标悬停仍有提示。
• 移动端：侧边栏收起为底部通栏导航（首页 / AI 聊天 / 论坛 / 更多 / 个人）；笔记、留言、设置、文档都在「更多」里。

七、论坛

• 身份：论坛用独立账号（昵称 + 密码 + 邀请码），在「个人」页注册/登录；不登录也能看帖，发帖、回复、点赞、上传需要登录。
• 发帖：顶栏「发帖」→ 标题（≤80 字）+ 正文（≤2000 字，支持 Markdown）+ 分类 + 附件（≤10 个，单文件 ≤500MB）。
• 回复：详情页底部有常驻回复条（Enter 发送 / Shift+Enter 换行，≤1000 字），可带表情和图片。
• 楼中楼：点某一楼的「回复」，底部回复条进入目标模式（显示"回复 @昵称"，可 ✕ 取消），回复挂在该楼下面；同目标再点一次即取消；目标模式上限 300 字。
• 删除：自己的帖子/回复随时可删；管理员可置顶、删除任意帖子与回复（登录 + 设置里填管理员口令）。

八、寄存柜

• 上传：寄存柜首页「上传文件」→ 选文件（可多选，单文件 ≤100MB）→ 选有效期限（1 天 / 7 天 / 30 天 / 永久）→ 选存储空间（Bitiful / B2 / Filebase / Tigris，各自独立额度）→ 开始上传，可随时取消。
• 取件码：上传完成生成 5 位取件码（去掉了 0/O/1/I/L，避免看错），结果卡可直接复制。
• 取件：寄存柜首页「取件」→ 输入 5 位取件码 → 显示文件名 / 大小 / 期限 → 下载（限速，可复制取件链接）。
• 过期：1 天 / 7 天 / 30 天的文件到期自动清理；「永久」的文件不过期，需要清理时由管理员删除记录。
• 限制：上传 / 下载 / 删除有频率限制，操作太频繁会提示稍后再试（429）。

九、常见问题

现象	原因 / 解决
提示 401 访问口令错误	设置里填的口令不对；管理员口令 = Cloudflare 的 ACCESS_TOKEN
提示 503 服务暂不可用	AI 提供商未配置或 ID 不对（管理员聊天用 default）
403 error 1010	非浏览器访问被 Cloudflare 拦截，正常浏览器无影响
页面还是旧版	强刷 Ctrl+F5 或隐身窗口
聊天没反应	先确认口令正确 + 提供商已配置；再检查模型名是否该服务商支持
论坛删不掉自己的帖子	详情页底部「删除」按钮；若未显示说明未登录或不是作者本人
留言板删除按钮不显示	在设置页填管理员口令后回到留言板刷新即可；留言删除只认管理员
寄存柜上传失败	文件超过 100MB 会被拒；缤纷云（Bitiful）禁止 apk/ipa；操作太频繁会 429，稍等再试
取件提示没有这个取件码	取件码写错 / 文件已过期被清理 / 之前选的是永久但记录被管理员删除
取件码里没有 0/O/1	故意去掉了容易看错的字符，只有 2-9 和 A-Z（除 I/L）