全部指南
指南

用 Markdown 和来源证据制作项目知识图谱

导入明确关系,核对来源行,测试有向路径,并交付便携 HTML、SVG、Mermaid 与 CSV。从浏览器开始,无需安装依赖。

快速开始

让 AI 助手帮你完成

将这段提示粘贴到你正在使用的 AI 助手中:

使用 Project Atlas Studio,根据我已确认笔记制作本地图谱。保留明确关系方向、每份来源路径、行号及准确摘录,不从共同出现推断链接。从浏览器开始,检查导入警告,测试已知有向路径和反向空路径,保存并重新打开便携 HTML 与 Project JSON。交付前审核完整项目 SVG、Mermaid、CSV 及嵌入来源隐私。不调用付费 API、不远程扫描、不公开发布。

什么是关联来源的项目图谱?

Project Atlas Studio v1.0.0 将已审核 Markdown 链接或结构化 JSON 转为可在本地编辑的关系图。节点表示决策、人物、文档、里程碑或风险;每个节点和关系都保留来源、行号及摘录。搜索、类型筛选、有向或无向路径查询帮助读者浏览已记录连接。单独内容包价格为 US$4.99;浏览器编辑及导出无需 API 密钥或付费服务。

它检查来源引用一致性,不判断声明真假或推断依赖是否合理。它不扫描目录、不从普通散文推断关系、不修改原始来源文件,也不提供共享访问控制。便携图谱包含来源文字,分享前应审核。

编写方向明确且可以解释的链接

在现代浏览器打开包内 studio.html,阅读 references/notes.md,并将以下虚构 Markdown 保存为 launch.md。一级标题通过“ | ”分隔稳定标识、标签、类型、状态与摘要,定义一个实体。其后的每个 [[target-id|relationship label]] 都属于该实体,直到下一个标题;链接可以指向另一个导入文件的实体。

  • 这里 launch → review 表示“发布依赖审核”,review → checklist 表示“审核使用清单”。不要为美化布局而反转箭头。重复出现的名字若没有明确链接,不会建立关系。
  • Import Markdown 最多接收 20 个小文件。浏览器上传每份不超过 20 KB;规范化来源每份最多 16,000 字符,总计最多 80 份来源、80 个实体、180 个关系及 500 KB 来源文字。大型档案应先拆分或筛选。
# [launch] Autumn launch | milestone | open | Release after the recorded review.
Needs [[review|depends on]].
# [review] Design review | decision | active | Inspect the supplied design.
Uses [[checklist|uses]].
# [checklist] Review checklist | document | done | The supplied acceptance checklist.

分别检查关系证据与节点证据

选择 Import Markdown,导入 launch.md,检查三个实体。打开 launch 到 review 的关系,将路径、行号与准确摘录同文件第 2 行对照;再检查 review 到 checklist 的第 4 行。匹配行只能证明摘录在那里存在,不证明关系在事实或语义上正确。

缺失目标、自指链接和标题之前的链接会产生警告并被省略。应审核警告,不把部分导入图误认为完整。重复标识、无效状态及结构化来源不一致会导致导入被拒绝,当前项目保持原状。

测试一条已知路径与一条受方向影响的空结果

审核全图前清除搜索与筛选。空路径表示当前数据在所选方向设置下没有记录该路径,不证明现实项目不存在依赖。关系影响实际工作时,应打开每条边的来源,并向负责人核对含义。

五行虚构示例的预期结果
查询模式预期结果
launch → checklist · 正向沿箭头launch → review → checklist · 三个实体
checklist → launch · 反向沿箭头没有已记录的有向路径
checklist → launch · 探索忽略箭头方向checklist → review → launch · 已忽略方向

保存可编辑成果并审核完整导出

修改标签、摘要与生命周期状态,再用撤销/重做检查变化。同时保存 Project JSON 和便携图谱,重新打开便携 HTML,核对修改与证据仍在。实体与连接表单会在第 1 行创建一条新来源记录;需要保留原文件行号时,应导入原始 Markdown。浏览器修改不会重写原笔记。

检查 SVG、Mermaid、实体 CSV 与关系 CSV。即使界面处于筛选状态,导出仍包含完整项目。CSV 会中和开头的电子表格公式前缀;JSON 保留原始填写值。这些处理不会使机密来源适合公开。向他人交付前审核所有嵌入来源。

可选:生成可重复的本地交付

浏览器已足够完成首次成果。需要可重复文件交付时,可选 Node.js 18 及以上 CLI 仅使用标准库,不调用外部服务。在完整安装目录执行以下命令,生成内置虚构项目。处理自有项目时,将输入换成下载的 Project JSON,并选择新输出目录;已有目录受保护。

  • 打开生成的 index.html,将关系图同 project.json 及两份 CSV 对照,按 delivery-manifest.json 核对各文件 SHA-256。清单匹配证明文件完整性,不证明来源笔记真实。
  • 较大关系图可使用搜索、缩放或可访问实体列表。在窄屏检查交付,保留已确认来源档案与未解决矛盾;公网托管和来源治理仍属独立工作。
node scripts/build.mjs --input examples/default.json --output ./my-atlas
全部指南