Monochrome

使用文档

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

一、云端模式（推荐）

网站部署在云端后自动进入云端模式：笔记、会话、留言都同步到服务器，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。
• 留言板：公开留言，无需口令。
• 统计：关键指标 + 14 天趋势 + 明细（基于本地数据）。

六、常见问题

现象	原因 / 解决
提示 401 访问口令错误	设置里填的口令不对；管理员口令 = Cloudflare 的 ACCESS_TOKEN
提示 503 服务暂不可用	AI 提供商未配置或 ID 不对（管理员聊天用 default）
403 error 1010	非浏览器访问被 Cloudflare 拦截，正常浏览器无影响
页面还是旧版	强刷 Ctrl+F5 或隐身窗口
聊天没反应	先确认口令正确 + 提供商已配置；再检查模型名是否该服务商支持