控制台指南

控制台地址:/console。登录即注册,首次登录自动开通租户。

控制台是侧栏分页式布局:左侧导航分五组——概览、构建(应用 · 人格库 · 知识库)、接入(设备 · API Keys · 试聊台)、观测(日志)、设置(模型设置 · 自带通道);顶栏常驻当前页标题、你的头像与邮箱、登出和官网/文档入口。手机上点左上角 ☰ 展开菜单。

2.1 起的全站通用交互:数据卡右上角有**「上次刷新 xx 秒前」和手动 ⟳;操作结果以右上角 toast 弹出;删除/撤销等危险操作一律先弹确认框**(Esc 或点遮罩即取消);列表为空时给引导按钮,加载中是骨架灰条。下面按导航顺序逐页导览。

登录 / 登出

打开 /console,未登录看到的就是登录卡:

• GitHub:点「用 GitHub 登录」→ 授权 → 跳回控制台。要求 GitHub 账号有已验证邮箱(平台以邮箱为身份主键,两种登录方式落到同一账号);
• 邮箱验证码:填邮箱 → 收 6 位码 → 5 分钟内填入。错 5 次锁定,需重新发码;
• 登录态 7 天有效;顶栏「登出」清除本浏览器的会话,回到登录卡。带着页面地址(如 #/kb)被请去登录的话,登录成功直接回到那一页。

概览(默认页)

登录后第一眼:四张统计卡——累计调用、近 7 天调用、应用数、设备数——各带底部趋势行(今天调用量、在线台数、配额余量),加近 7 天逐日柱状图、端点分布横条图(最近 200 条请求按端点聚合)和最近活动列表(最近 8 条请求:时间 · 端点 · 状态)。

本页每 30 秒自动刷新(切到后台页签自动暂停,回来立刻补一拍),数字变化时会跳动高亮一下——盯着它调一发 /v1/agent,看得见涨。每张卡也有手动 ⟳。每次 /v1/agent 调用计一次,几乎实时;某项读不出时该卡显示「—」,不影响其它卡。下方「快速开始」三步卡可直接跳到签 key、试聊和文档。

应用(构建)

一个应用 = 一个可发布的喵喵分身:绑提示词或人格、模型与知识库开关,再签它的专属 key——key 是谁,喵喵就是谁。

• 新建:填名称,直写提示词或选一个人格(都填以直写为准),可覆盖模型、开关知识库注入;每租户 ≤20 个;
• 编辑:点行内「编辑」开模态,可改名称、提示词/人格、模型、温度、知识库开关和工具白名单——web_search / get_time / calculator 三个复选,全勾 = 不限制,全不勾 = 全部禁用;保存即对之后的对话生效,已签的 App key 不用换;
• 签发 App key:点卡片上「签发 key」,明文只显示一次;App 级 key 只能对话不能管理(管理面一律 403);
• 删除:连带撤销它的全部 App key(在用客户端立刻 401),会话历史保留;
• 刚签出的 key 可点「用这个 key 去试聊台」一键带过去试。

人格库(构建)

给机器人定制人设(system prompt),存起来反复用:

• 新建:名称(≤200 字)+ 提示词(≤8000 字),可勾「设为本租户默认」;
• 编辑:点行内「编辑」改名称/提示词,保存对之后的对话生效,引用它的 persona_id 不变;
• 引用:机器侧调 /v1/agent 带 persona_id 即用对应人设;应用页里也能直接选人格;
• 设默认 / 删除:列表内操作。删除后引用该 id 的客户端自动回落默认人格(不报错);
• 人格属于租户,别的租户既看不到也引用不到。

知识库(构建)

传几篇资料,喵喵对话时自动检索引用(/v1/agent 默认开启,带 "kb":false 可关):

• 上传:标题 + 正文(纯文本/Markdown),入库自动分块,生效约数秒;单篇 ≤100KB,每租户 ≤50 篇;
• 分块预览:点文档行打开预览——看入库后到底切成了哪些块(按块号排序,预览上限 50 块)。检索按块算相似度,「答非所问」时先来这里看是不是切坏了;
• 检索测试:输入问题回车,返回 top5 片段 + 相似度分数(对话注入只取 score≥0.45 的片段,这里全亮出来方便调阈值感);
• 删除:删后喵喵立刻不再引用,不可恢复。

设备(接入)

把实体设备接进来:登记 → 拿一次性激活码(15 分钟有效,只显示一次,页面同时给出设备端 curl 示例)→ 设备拿码调 POST /v1/devices/activate 换它的专属设备 key。

• 绑定应用:登记时可选;绑了的设备说话即该应用人设;
• 绿点 = 5 分钟内有过对话/心跳;激活态是行内胶囊(已激活 / 待激活 / 码已过期),还有最后在线、固件版本;
• 编辑(改名/换绑):点行内「编辑」改设备名或换绑应用。注意:换绑只影响之后的激活继承——已激活在用的设备 key 不动,要让在用设备立刻换人设,请用「重发码」重新配对;
• 重发码 = 重新配对:旧码作废、旧设备 key 立刻撤销;删除同样连带撤 key;每租户 ≤100 台。

API Keys(接入)

• 签发:可设每分钟请求上限(缺省 60,0 = 不限流,上限 100000)。明文 sk-meow-… 只显示一次,立刻复制保存;
• 列表:每把 key 的前缀、归属(通用 = 全租户身份 / App·应用名 / 设备)、状态、创建时间、限流值——看不到明文(库里只有哈希);
• 撤销:该 key 下一个请求起 401;已撤销的留在列表里供审计;
• 刚签出的 key 可一键带去试聊台。

试聊台(接入)

浏览器直连 /v1/agent 流式对话,签完 key 不写一行代码先验通:

• 粘贴一把 key(从应用页/API Keys 页签发后可一键带过来)→ 打字 → Enter 发送(Shift+Enter 换行);
• key 只放进请求头,不落库、不外传;刷新页面即清空;
• 同一个控制台页签内是同一个会话(多轮记忆生效,切页回来记录还在),刷新即新会话;
• 填 App 级 key 即以该应用人设作答,通用 key 即租户默认行为。

日志(观测)

机器侧 /v1/* 每次请求一行元数据——端点、状态、时延、归属 App/设备、错误类。不含任何对话内容(后端就没记,只有长度与分类),保留 7 天自动清理。设备昨晚没回话?来这里看它是 4xx 还是 5xx。

• summary 大字:请求数、错误率、p50/p95 时延,随筛选范围(端点 / 近 1 小时~7 天)由服务端聚合;
• 自动刷新:默认每 15 秒拉一次(后台页签暂停),可关;「仅错误」只过滤表格行不改 summary 口径;
• 行展开:点任意行展开全部字段(会话 id、输入字符数、通道、日志 id 等)。

接口细节见日志文档。

模型设置(设置)

每租户级别的 LLM 配置,改完对之后的对话生效:

留空即回到平台默认值;这些配置不能通过 /v1/agent 请求体传,只能在这里改——你的调用方伪造不了。

自带通道(设置)

接你自己的 OpenAI 兼容端点(BYO,自己的账单):

• 保存:填 Base URL + 该端点的 API Key;key 服务端加密存储,保存后不再回显,只看得到末 4 位;改任何一项都需连同 Key 一起重新保存;
• 测试通道:真打一发最小补全,回报连通性与时延;
• 回落开关:BYO 失败时是否自动回落平台通道——回落会在对话流里发 provider_fallback 事件,绝不静默;
• 清除:回到平台通道。建议同时在「模型设置」页填该端点认识的模型名。

配置导出 / 导入(设置)

把本租户的人格 + 应用 + 模型设置导出成一份 JSON,在另一处导入复现——换环境一键搬过去、改坏了有回滚、做好一套想分享给别人也有门(对标 Dify 的配置可移植)。在「设置 · 模型设置」页底部的「配置导出 / 导入」区操作。

• 导出:点「导出配置」下载 meowbot-config.json。文件里只有三块:人格(名字 / 提示词 / 是否默认)、应用(名字 / 提示词 / 引用的人格名 / 模型 / 思考 / 温度 / 知识库开关 / 工具白名单)、模型设置(模型 / 思考 / 温度)。
• 绝不含密钥:API key、自带通道(BYO)的 key 一概不导出(迁移即泄密是红线);也不含知识库文档内容与设备(激活态不可迁,这些到新环境另行配置)。
• 应用的人格按名字记录:导出里 app 用 persona_ref(人格名字)而非内部 id——id 跨环境无意义,名字才可移植。导入时自动连回目标租户里的同名人格;连不到就留空(应用回落默认人格,不报错)。
• 导入:粘贴 JSON 或选文件,选模式后点「导入配置」:
  • 同名跳过(默认,安全):目标里已有同名人格 / 应用就保留不动,只补新增的;
  • 同名覆盖:同名的以导入内容为准(覆盖人格的提示词、应用的全部字段)。
• 逐项尽力而为:导入不是「全有或全无」——单项失败(如某应用字段超长)不影响其它项;结果摘要会如实列出导入成功数、跳过清单(同名 / 超配额)和错误清单。
• 配额仍生效:应用上限每租户 20 个、人格批量上限 200,导入超出的部分计入「跳过」。
• 隔离:导入永远写进你当前登录的租户,身份取自会话——JSON 里就算夹带别的租户标识也一概忽略,搬不到别人那里去。

机器侧也有对应接口:GET /v1/export、POST /v1/import(用租户通用 key;App 级 / 设备 key 一律 403)。详见 API 参考的 portable 分组。