A Very Curious Map
Discovering Worlds, From the Outside In.
“外头站着”是从个人记录生长出来的人生探索地图。它不是人生 KPI、公共众包库或装备数据库,而是帮助每个人用小投入持续遇见未知世界的 Discovery Engine。每个 Git Fork 都是一张彼此独立的个人地图:入口和体验留在自己的 Fork,值得分享的“种草信号”再反馈给上游,由各自主人决定是否加入。页面采用四层结构:
- 领域地图(Domain):由
data/domains.json定义稳定的能力与兴趣世界,汇总对应入口和装备。 - 世界谱系(Cluster):由
data/domain-clusters.json将领域组织为科学、工程、手艺、艺术、身体、生活、人文与系统八组,避免大量未来领域变成无结构清单。 - 精选入口(Gateway):个人入口优先读取
content/gateways/*.md,也兼容外部 Muse;跨领域推荐读取data/gateway-recommendations.json。入口可以是产品、套装、课程、体验、参访或零成本练习,不等于全部装备。 - 入口路线图(Roadmap):由
data/gateway-roadmaps.json定义 Gate 打开后的首次体验、里程碑、可选分支与替代方案;详情页使用#gateway/<id>深链接。 - 探索指南(Guide):由
data/gateway-guides.json为每个入口补充吸引力、15 分钟体验、第一次成功、三个核心概念与值得花钱的条件。构建时强制校验每个入口都必须拥有指南,避免退化成只有定义的百科卡片。 - 装备图谱(Gear):作为入口落地后的可选佐证,递归读取
content/gear/**/*.md或外部 Muse,记录实际拥有或曾经拥有的资产。data/gear-reconciliation.json用于补录尚未建档的装备、状态变更及多领域覆盖。
三者关系为:一个领域可以包含多个入口和多件装备;一个入口归属一个主领域;一件装备可以通过 domain_overrides 支持多个领域。装备目录分类仅用于档案管理,不再冒充能力领域。
推荐入口有三层意图,不混在一起:
- 值得了解:系统推荐,适合围观和比较,不代表你想买。
- 愿望清单:你在浏览器里主动收藏;保存在本机
localStorage,不会写回 Muse。 - 计划入手:明确形成购买意图的个人入口,才使用
owned-planned状态。
每条推荐都要说明入口类型、价值、购买边界、替代方案、路线图、官方链接和核验日期。产品只是入口的一种;当课程、借用、体验或练习更合适时,不强行生成商品。
每个入口必须先回答:
- 为什么好玩:它会让什么原本不可见的世界突然变得可观察。
- 最低成本怎么试:给出 10–25 分钟、通常零成本的具体动作。
- 第一次成功是什么:用可观察结果替代“了解一下”。
- 先懂哪三个概念:只给足以改善第一次体验的知识,不先堆课程。
- 什么时候值得花钱:只有实践已经暴露真实瓶颈时才建议升级。
精选入口支持按“最值得探索”“最快获得反馈”和“最低投入”排序,也可使用“给我一个 15 分钟入口”从当前筛选范围内直接开始一次探索。
领域允许留白。没有入口和装备的领域会标记为“待探索”,继续保留在领域地图和导航中;留白表示未来可能性,不会自动生成虚假的 Gate、装备或评分。
导出器只使用页面所需的白名单字段,不会把序列号、IMEI、MAC、发票位置等私密识别信息写入网页数据。
Fork 后直接告诉 AI“把某某记录为我的 Gateway”。AI 会读取仓库中的 AGENTS.md,按 content/gateways/_TEMPLATE.md 创建个人入口,并完成构建与隐私检查。
第一次使用时,编辑 data/library.json:把两个 *_source 设为 repository,再把三个 include_* 开关设为 false,即可从不继承原作者入口和装备历史的空白地图开始;也可以保留推荐种子,逐步形成自己的判断。完整说明见 docs/FORK-YOUR-MAP.md。
如果自己的体验可能适合原作者,可以提交一条 Gateway 反馈。反馈不会自动进入原作者的地图。
更新仓库内个人记录或 Muse Memory 后重新生成数据:
npm run build随后可直接打开 index.html。项目同时生成:
data.json:便于调试或其他程序读取。data.js:让页面在不启动本地服务器时也能直接读取数据。
生成可公开部署的脱敏数据(移除本机 file:// 路径、源文件名和购买渠道):
npm run build:public
npm run verify:public部署到 av.cm 前必须使用这个公开构建,不要直接发布普通 npm run build 生成的本地数据。
生产站点的搜索引擎入口由 robots.txt、sitemap.xml、页面 canonical、Open Graph/Twitter 元信息和 JSON-LD 结构化数据共同维护。公开内容发生实质变化时,同步更新 sitemap.xml 的 lastmod。
也可以用静态服务器预览:
python3 -m http.server 4173Fork 不需要安装 Muse:把个人入口放在 content/gateways/ 即可。原作者仍可使用 iCloud Drive 的 Muse/memory;需要覆盖外部位置时可设置:
MUSE_MEMORY_DIR:整个 Memory 根目录。MUSE_GATEWAY_DIR:World Gateway 条目目录。MUSE_GEAR_DIR:装备档案目录。
构建器依次选择显式环境变量、data/library.json 中的来源偏好,再进行仓库/Muse 自动探测;任何缺失的外部目录都会安全回到可为空的仓库目录。
个人 Gateway Markdown 是每个 Fork 的主要真相源,data/domains.json 是领域定义的真相源,data/gateway-recommendations.json 是可选推荐种子的真相源,data/gateway-guides.json 保留成熟入口的深度探索指南。新的个人入口可以把完整的首次体验指南写在同一份 Markdown front matter 中,不需要同时修改多个 JSON 文件。对于尚未建档的装备、已确认但待回写的状态或一件装备跨越多个领域的情况,维护 data/gear-reconciliation.json;其余新增记录无需修改前端,只需再次运行构建命令。