快速了解
它能做什么
通过健康、鉴权、核心 API 及可选写入操作的 HTTP 冒烟检查,验证 Mobius 部署是否可用。
本站提供的是中文说明,不代表该项目或 Plugin 自身提供中文界面;语言支持请以上游文档为准。
选择前先看
适合在 Mobius 后端部署或重启后、用户反馈服务异常时,以及修改后端代码后使用。可在服务器上运行 `npm run test:self-test`,也可调用本地管理员自检端点。结果会标记每项检查为通过、失败或跳过,并输出完整 JSON 报告。
适合谁
需要验收 Mobius 部署或排查基础服务可用性的运维人员和开发者。
常见任务
- 在部署或重启后确认 Mobius 后端可用。
- 排查服务打不开或 API 报错的反馈。
- 在后端改动后执行回归冒烟测试。
- 选择性验证记忆的创建、读取和删除流程。
权限与数据
读取 Mobius 服务端点;部分检查需要管理员鉴权,可选模式会执行写入。
权限- CLI 方式需要服务器 Shell 访问权限;HTTP 方式需要访问本地管理员端点。
- HTTP 端点需要管理员 Bearer 令牌。
- 读取健康状态、鉴权、项目、模型、任务、扩展、搜索、群聊、会话和语音配置响应。
- 可选写入模式会创建、列出并删除一条记忆;上传检查也仅在写入模式下执行。
- 正在运行的 Mobius 后端,文档默认通过 localhost 的 33316 端口访问。
- HTTP 端点需要管理员 Bearer 令牌。
局限
- 仅适用于 Mobius 及文档中列出的端点。
- 可选写入检查会修改并删除测试数据。
- 检查失败后仍需根据该项错误信息进一步排查。
- 随附源码可用许可证限制商业使用;商业使用需另行获得许可。
DSHub 已核对
- 已完整捕获固定版本的技能文档。
- 源代码提交已固定。
- 文档说明了 CLI 与 HTTP 调用方式、检查范围、结果含义和可选写入模式。
DSHub 未核对
- DSHub 未运行自检,也未确认在线 Mobius 部署。
- 随附证据未声明 Harness 版本范围。
固定版本安装
主要操作
这个独立 Skill没有 DSH Plugin 安装操作,请根据源码文档使用真实交付方式。
维护者原文
Skill 使用说明
name: mobius-self-test description: Mobius 自我测试能力。部署后自动跑、也可手动跑一组 HTTP 冒烟(健康/鉴权/核心读 API/语音配置, 可选写往返), 快速确认重新部署后系统是否真的可用。当你怀疑系统异常、或刚部署完需要验收时使用。
何时使用
- 刚部署/重启完 Mobius 后端,需要确认服务正常
- 用户反馈"系统好像坏了"、"打不开"、"接口报错"
- 用户要求"跑个自检"、"检查下服务"
- 自我迭代修改后端代码后,验证没有破坏基本功能
触发方式
1. CLI(服务器上直接跑)
cd /app/mobius
npm run test:self-test
带写往返(建 memory → 列 memory → 删 memory):
MOBIUS_SELF_TEST_WRITE=1 npm run test:self-test
2. HTTP 端点(agent/网页可触发)
curl -sS http://localhost:33316/api/admin/self-test \
-H "Authorization: Bearer <admin-token>"
怎么看结果
✅= 通过,❌= 失败,⏭= 跳过- 末行
SELF_TEST_JSON包含完整 JSON 报告 - 部署后自检日志:
/data/logs/self-test.log - 全
✅且exit 0= 系统正常 - 有
❌→ 逐个检查失败项的错误信息
检查项目
| # | 类别 | 端点 | 说明 |
|---|---|---|---|
| 1 | 健康 | GET /api/health |
{"status":"ok"} |
| 2 | 健康 | GET /api/v2/health |
版本信息 |
| 3 | 鉴权 | GET /api/auth/config |
认证配置 |
| 4 | 鉴权 | GET /api/auth/me |
system token |
| 5 | 核心读 | GET /api/projects |
项目列表 |
| 6 | 核心读 | GET /api/sessions/model-options |
模型列表 |
| 7 | 核心读 | GET /api/tasks/recent |
最近任务 |
| 8 | 核心读 | GET /api/extensions |
扩展列表 |
| 9 | 搜索 | GET /api/search?q=test |
全局搜索 |
| 10 | 群聊 | GET /api/conversations |
群聊列表 |
| 11 | 会话 | GET /api/sessions?limit=5 |
会话列表 |
| 12 | 语音 | GET /api/assistant/tts/voices |
TTS 配置 |
| 13 | 上传 | POST /api/upload |
文件上传 (仅 write) |
| 14 | SSE | GET /api/sessions/:id/events |
流式连接 + 首事件 |
| 15 | 写 | POST→DELETE /api/memories |
往返 (仅 write) |
部署后自动自检
server.js 启动后自动跑(MOBIUS_SELF_TEST_ON_BOOT=0 可关闭):
- 延迟 5s(等 server 完全就绪)
- 结果 append 到
/data/logs/self-test.log - 失败绝不阻塞/崩 server
有意识地管理
安装与管理
前置条件与目标 Profile
目标: mobius Profile
交付方式: Skill 文件 — https://raw.githubusercontent.com/nutshellai-tech/mobius/1eb8750d2d9012e1f50a18f7c60c2ad040c04889/skills/mobius-self-test/SKILL.md。
兼容性与访问范围
For a running Mobius backend with server or admin API access: Not declared in supplied evidence。
风险事实
证据与编辑审查Manifest、Bundle patch、分发与新鲜度
不可变证据
审查状态与源码活动
在核对来源内容和不可变发布记录后,已由人工批准发布。AI 参与了内容草稿生成,最终发布决定由人工完成。
人工审查于 2026/9/4 UTC 11:48。GitHub 事实核对日期: 2026/9/3 UTC 15:47。
自当前证据基线以来,没有记录到重要源码变化。