参考与运维 Reference & Admin

术语对照、FAQ、常查资料,以及尚未上线的运维能力路线图。 English · ← 回到分类


1. Glossary 术语对照表

跨语言统一沿用此表,不随意造词。

中文English说明
数字员工 / 智能体AI Agent / Digital Worker可自主执行任务的 AI 工作者
团队Team多 Agent 的组合
技能Skill可复用技能包
计算单位 / 积分Compute Unit (CU)模型推理计量货币
组织Organization计费与成员治理主体
订阅Subscription / Plan会员计划(Free…Enterprise)
市场Marketplace数字资产交易市场
任务Task一个待执行的工作单元
评审Review交付物评审流程

对比表:见 Overview 对比章节。


2. FAQ 常见问题

默认登录账号是什么?如何修改?

初次启动后打开 http://localhost:8056,默认账号 admin@markus.local / markus123。首次登录的迎接向导会引导你设置真实姓名、邮箱和新密码,请务必替换掉默认凭据。

端口被占了怎么办?

  • 桌面 / npm 方式:后端 API 默认 :8056,Web UI 内置。
  • 源码方式:后端 API :8056、前端 Vite Dev :8057。
  • Hub 市场站(markus-hub):API :3003、Vite 客户端 :5174。

端口等系统参数均可在 Web 设置的设置页面调整,无需编辑配置文件。

数据存在哪里?需要额外装数据库吗?

不需要。平台默认使用本地 SQLite,数据落在本机,开箱即用。Hub 市场站默认数据库位于 ~/.markus-hub/hub.db(首次启动自动创建并迁移)。

文档中的各种问题怎么排查?

  • 端口占用 → 换端口或结束占用进程(见上)。
  • 数据异常 → 检查 ~/.markus-hub/ 下的本地数据文件与日志。
  • 启动失败 → 用 markus start 查看输出,确认 Node.js 22+ / pnpm 9+ 版本满足环境要求。

如何配置 LLM 模型?

一切在 Web UI 的设置页面可视化完成,无需编辑任何配置文件或环境变量。支持任意常用供应商:Anthropic / OpenAI / Google / DeepSeek / MiniMax / Ollama / SiliconFlow / Moonshot 等,添加供应商与 API Key 即可。

如何升级到新版本?

  • 桌面版:从 GitHub Releases 下载新版安装包覆盖安装。
  • npm 方式:npm install -g @markus-global/cli 重装。
  • 源码方式:git pull && pnpm install && pnpm build。

3. 路线图 Roadmap

以下运维能力尚未上线,上线后会补齐对应页面,敬请关注:

方向内容
Errors 错误码错误码与排查
Changelog版本变更记录
CLI 运维markus CLI、系统控制、审计
组织治理组织、成员、角色、预算
计费 BillingSubscription / CU / Invoice / Credits 对齐
部署与日志云部署、日志、外部服务开通

相关阅读:安装部署见 系统安装 →;计费与订阅入门见 Markus Hub 市场 →;外部平台接入(官方支持飞书)见 飞书集成 →。