文档

Web 控制台

Web 控制台

Memo 提供浏览器端控制台,用于聊天和运行时管理。 它支持多 workspace 项目管理和并发实时会话(单个 server 进程上限 20)。

启动 Web 模式#

memo web --host 127.0.0.1 --port 5494 --open

常用参数:

  • --host <value>
  • --port <value>
  • --open / --no-open
  • --static-dir <path>(自定义 web-ui 静态资源目录)

如果从源码仓库运行,请先构建:

pnpm run build

npm 分发包已包含所需 web 资源。

登录与认证配置#

  • 默认认证配置路径:~/.memo/server.yaml
  • 自定义路径:MEMO_SERVER_CONFIG
  • 登录页读取:
    • auth.username
    • auth.password

首次运行 memo web 时,会自动创建 server.yaml,包含随机初始密码和认证密钥。

主要区域#

  • Chat:会话时间线、工具动作、审批与轮次状态。
  • Projects:添加项目、浏览目录、创建/删除会话。
  • MCP Servers(侧边栏):新增/编辑/删除/登录/登出与激活开关。
  • Skills(侧边栏):创建/删除 skill、查看详情与激活开关。
  • Settings:Web 偏好设置与账户信息。

激活态持久化#

Web 端的激活状态变更会写入 Memo 配置:

  • MCP 激活集合:~/.memo/config.toml 中的 active_mcp_servers
  • Skills 激活集合:~/.memo/config.toml 中的 active_skillsSKILL.md 绝对路径)

Skill 激活状态会直接影响新会话系统提示中的 skill 注入结果。

运行说明#

  • 当首选端口被占用时,memo web 会自动尝试下一个可用端口。
  • 修改 server.yaml 认证信息后,需要重启 web server 进程。
  • MCP/skills 配置更新后,通过刷新/重载并新建会话可立即生效。