网页使用
第一次使用：留下今天的学习进展
从公共地图选一个节点，保存自己的笔记或部分进度，刷新后继续。网页记录不需要先安装本地助手。
MAPFLOW GUIDES
选择一篇使用教程。
从网页学习、角色互动或模型费用中，找到你现在需要的说明。
在网页中开始
浏览地图、保存笔记和手工记录进度，无需先安装 Node.js、Skill 或 MCP。
网页使用
独立酒馆：找到角色和当前对话
分清角色卡与会话，保存自己的角色，找到当前那段互动，并在发送前确认模型与费用。
网页使用
模型、费用与中断：发送前看哪里
分清现金额度、平台积分与自填Key，区分回复、执行状态和费用依据；结果未知时先核对原请求。
连接本地 Agent（可选）
需要让电脑上的助手读取或维护地图时，再按以下教程安装与授权。
认识 MapFlow
核心理念
@mapflow-publish/mcp 是运行在你电脑上的连接器，把 Agent 和自己的 MapFlow 账号连起来，学习数据保留在账号中。
认识 MapFlow
学习地图
地图把一个技能或方向拆成学习路线；节点代表具体知识与能力；关系表示前置、并列和递进。
认识 MapFlow
节点与学习状态
公共地图提供路线参考。加入个人地图后，每个人的完成状态保存在自己的副本中，不影响公共地图或他人进度。
开始接入
快速开始
准备 Node.js 18+、MapFlow 账号和支持 MCP 的 Agent。
开始接入
安装 Skill
先安装 Skill，让 Agent 理解树、节点、块与布局规则。--global 安装到当前电脑；只用于当前项目时可以去掉它。
开始接入
配置 MCP
在终端运行连接器。第一次运行会下载并启动授权流程。也可在 Agent 的 MCP 设置中填写同一命令。
开始接入
首次授权
1. 浏览器打开 MapFlow 授权页，先登录自己的账号。
管理地图
Agent 能做什么
mapflow.whoami：确认当前账号和授权。
管理地图
读取地图与学习进度
让 Agent 先读取真实地图与进度，再建议下一步。可以说：“我现在有哪些地图，哪张地图应该继续学习？”
管理地图
修改地图与节点
可以补充节点、修改标题和说明、调整关系或整理分组。写操作会改变个人地图；指令中说明目标、范围，以及是否允许删除或移动内容。
管理地图
管理学习进度
本地 Agent 可以直接修改地图内容和节点进度。请它记录学完的节点、需要复习的内容和下一步。
管理地图
Claude Code
注册连接器后，可以让 Claude Code 读取学习进度或整理节点。
管理地图
其他 Agent
通用 MCP 配置：command 填 npx，args 填 @mapflow-publish/mcp。客户端会执行同一连接命令。
账号与安全
授权与 Token
Token（访问令牌）位于 ~/.mapflow/token，服务器保存摘要。令牌代表账号授权，不要共享或提交到 Git。
账号与安全
常见问题
找不到 npx：安装 Node.js 18 或更高版本，再重新打开终端。