参考与运维 Reference & Admin
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、系统控制、审计 |
| 组织治理 | 组织、成员、角色、预算 |
| 计费 Billing | Subscription / CU / Invoice / Credits 对齐 |
| 部署与日志 | 云部署、日志、外部服务开通 |
相关阅读:安装部署见 系统安装 →;计费与订阅入门见 Markus Hub 市场 →;外部平台接入(官方支持飞书)见 飞书集成 →。