企业官网建设流程全解析

Inkstone 是运行在 Cloudflare Workers 上的自托管 Markdown 笔记本，内置双链、反向链接与关系图谱三大能力。你只需在笔记里写[[笔记标题]]，Inkstone 就会自动把笔记连成网，并生成一张可视化的个人知识图谱。本文带你从零搭好这套系统。

为什么选择 Inkstone 搭建知识图谱

Inkstone 把知识管理的核心三件套全部内置，无需任何插件：

更关键的是：笔记始终是普通 Markdown 文本，不锁死在私有格式里，随时可以导出。功能总览见 README_ZH.md。

第一步：写一条双链，让笔记开始"联网"

双链语法速查

在编辑器里直接输入即可：

• [[我的第一篇笔记]]—— 引用已有笔记
• [[我的第一篇笔记|打开或创建笔记]]—— 指定显示别名
• [[欢迎使用 Inkstone#Markdown 速查]]—— 直接跳到目标笔记的某个标题

两条贴心规则：

1. 目标笔记不存在也没关系。悬空的双链会以待创建状态存在，点击即可一键新建笔记——这正是"先记想法、后补内容"的工作流。
2. 代码块里的[[xxx]]不会被识别为双链，避免误伤代码示例。

双链的解析逻辑位于 markdown-utils.ts，预览渲染在 renderer.ts。每篇笔记最多解析 200 条双链，日常使用完全足够。

第二步：用反向链接追溯引用关系

打开任意一篇笔记，工作区底部就是反向链接面板（BacklinksPanel.tsx）：

• 面板按最近更新时间倒序列出所有引用了当前笔记的笔记，最多 50 条；
• 每条都展示引用处的上下文摘录——服务端会从原文中截取[[标题]]前后的一段文字（notes.ts），让你不点进去就知道"它是在什么语境下提到我的"；
• 点击任意一条即可跳转打开。

👉使用建议：写一篇"概念笔记"（如「分布式事务」），然后在多篇"实践笔记"里双链它。过段时间回到概念笔记，反向链接面板就是你的"引用索引"。

第三步：打开关系图谱，看清全貌

在命令面板中输入"打开关系图谱"即可呼出图谱（GraphPanel.tsx）。画布上：

• 节点大小= 该笔记的连接数（度），越大越"核心"；
• 箭头方向表示引用方向：A → B 表示 A 中写了[[B]]；
• 悬停节点会高亮它的所有连线，并显示入链/出链数量；
• 单击节点直接打开对应笔记；虚线圈节点是尚未创建的悬空双链，点击可立即创建。

服务端通过递归查询构建图谱数据，支持按文件夹、标签过滤，完整实现见 search.ts。

全局图谱 vs 局部图谱

顶部「图谱范围」开关切换两种模式：

小技巧：在图谱中右键任意节点 → "设为局部中心"，即可把该笔记变成局部图谱的中心（GraphPanel.tsx）。

图谱设置：调出最舒服的布局

点击设置齿轮可微调三项"物理参数"，设置会自动记住：

• 斥力（Repulsion）：节点间推开的力度，越大越分散；
• 连线距离（Link Distance）：相连节点的理想间距，越小越紧凑；
• 节点大小（Node Scale）：整体缩放节点直径。

外观选项还能按文件夹或标签着色、显示/隐藏箭头与标签、过滤孤立的笔记（没有任何双链的）和悬空链接。觉得乱了？一键"恢复默认"即可。

常见问题：图谱里为什么缺了某些笔记？

小结：三步搭好你的第二大脑

1. 写双链：随手[[相关笔记]]，让笔记彼此引用；
2. 看反链：从概念笔记出发，用反向链接面板追溯知识脉络；
3. 逛图谱：全局模式把握大局，局部模式深挖单一主题。

坚持"每篇新笔记至少双链一篇旧笔记"，几周后你的 Inkstone 就会长成一张越用越密的知识网。 🧠