Mood Atlas · 开始使用

把说不清的不对劲，
变成看得见的轨迹

这是一个记录情绪的网页应用。它没有服务器、也没有后台账号系统 —— 你的记录只存在两个地方：你自己的浏览器，和你自己的 GitHub 私有仓库。

为什么要配 GitHub？
因为没有任何服务器替你保管数据，所以需要你自己准备一个"云端抽屉"。GitHub 的私有仓库免费、稳定、只有你能看，正好合适。全过程大约 3 分钟，只做一次。配完之后手机和电脑就能看到同一份记录。
不想配也可以。跳过下面全部步骤，直接开始记 —— 数据会存在当前这个浏览器里，照样能用。只是换设备、清缓存后会丢，也没法手机电脑同步。

第一部分 · 准备云端抽屉

1

注册一个 GitHub 账号

打开 github.com/signup，用邮箱注册，免费。已经有账号就跳到下一步。

注册完请记住你的用户名（登录后在右上角头像里能看到，形如 your-name）。

2

新建一个私有仓库

仓库就是那个"抽屉"。直接打开 github.com/new，然后：

  1. Repository name 填 mood-atlas-sync（也可以自己取名，但要和后面填进设置里的一致）
  2. 下面选 Private（私有）—— 一定要选这个，否则任何人都能看到你的记录
  3. 勾上 Add a README file
  4. 点绿色按钮 Create repository
建好之后什么都不用管，页面关掉就行。记录会自动以 情绪记录.json 的形式存进去。
3

生成一把只能开这个抽屉的钥匙

网页需要一把"钥匙"（GitHub 叫 access token）才能往仓库里写数据。打开 这个链接 直达创建页（若跳到登录页，登录后再点一次），然后：

  1. Token name 随便填，比如 mood-atlas
  2. Expiration（有效期）选一个长一点的，比如 1 年。到期后重新生成一把换上即可
  3. Repository access 选 Only select repositories，在下拉里勾选刚才建的 mood-atlas-sync
  4. 展开 Permissions → Repository permissions，找到 Contents 这一项，右边下拉改成 Read and write（读写）
  5. 拉到最下点 Generate token，再确认一次
  6. 页面会显示一串以 github_pat_ 开头的长字符 —— 立刻复制下来
注意：这串字符只会完整显示这一次，关掉页面就再也看不到了。先粘到备忘录里存着，或者直接去做第 4 步。万一丢了也不要紧，回来重新生成一把新的就行。

第二部分 · 连上应用

4

在网页里填一次

回到情绪地图页面，点右上角 设置，找到「GitHub 云同步」那一块，确认标签停在 个人空间，然后：

  1. GitHub 用户名：填你的用户名。也可以留空 —— 待会点「测试连接」会自动识别并帮你填好
  2. 私有仓库名：填 mood-atlas-sync（和第 2 步取的名字一致）
  3. 访问令牌：粘贴第 3 步复制的那串字符
  4. 勾上 启用同步 和 保存后自动同步
  5. 点 测试连接，看到"已连上"就成了；再点一次 立即同步
令牌只存在你这台设备的浏览器里，不会上传到任何第三方服务器。它也只能碰你勾选的那一个仓库，别的都动不了。
5

手机上也配一次，就同步了

用手机浏览器打开同一个网址，同样进「设置」，用同一个用户名、同一个仓库名、同一把令牌再填一次。填完就能看到电脑上记过的全部内容了。

顺手可以装成 App：

"配置一次"不是登录 —— 每台设备、每个浏览器都要各自填一次。填完之后，大家读写的都是云端那同一份数据。

第三部分 · 可选功能

A

让 AI 帮你整理（可选）

应用里的「AI 帮填」可以把你随手写的一段话自动拆成心情、睡眠、标签这些字段，也能在开头给你一句基于历史记录的开场白。这需要一个 DeepSeek 的 API Key：

  1. 去 platform.deepseek.com 注册
  2. 在 API keys 页面创建一个 key，复制
  3. 回到应用「设置 → AI」，粘贴进去
Key 同样只存在你的浏览器里，请求直接从你的设备发给 DeepSeek。用量按 DeepSeek 的计费走，不用也完全不影响记录功能。
B

和朋友共用一份记录（可选）

设置里的「共享空间」是独立的第二套配置，用来和别人共用同一份记录（比如情侣、室友、互相监督的搭子）。做法：

  1. 由其中一个人按第 2、3 步再建一个仓库，比如叫 mood-atlas-shared，并生成一把只勾选这个仓库的令牌
  2. 把「用户名 + 仓库名 + 这把令牌」发给同伴
  3. 各自在设置里切到 共享空间 标签填进去，再填一个昵称
填了昵称之后，你在共享空间记的每一笔都会带上"记录人"，时间轴里也能看出是谁写的。
个人空间和共享空间互不影响 —— 私人记录留在个人空间，别人看不到。

常见问题

我的数据到底存在哪儿？谁能看到？

存在你自己 GitHub 账号下那个私有仓库的 情绪记录.json 里，以及你本机浏览器的缓存里。这个网页本身不带服务器，作者、也包括发你链接的人，都看不到你的记录。

测试连接提示"仓库不存在"？

三个地方对一下：仓库名拼写是否一致、仓库是否真的建好了、以及第 3 步生成令牌时有没有在 Only select repositories 里勾中这个仓库。

提示"令牌无效"？

多半是权限没给够或者已过期。回到令牌页面确认 Contents 是 Read and write；过期的话重新生成一把，粘贴替换即可。

令牌复制的时候弄丢了怎么办？

没影响。回 GitHub 重新生成一把新的，旧的删掉就行。仓库里的数据不会丢。

换手机 / 重装浏览器，记录会没吗？

只要配过同步就不会 —— 新设备上重新填一次那三项，数据会自动从云端拉回来。另外「设置」里也能导出一份 JSON 备份自己收着。

同一天记了两次会怎样？

同一天只保留一条，后来填得更完整的那条会覆盖前一条。想改当天的内容，直接再记一笔即可。