# 10 - 知识界面方案固化

## 结论

本项目当前采用以下知识界面架构：

```text
Cytoscape HTML Atlas = 主入口和交互式知识图谱
Markdown = 知识仓库和长期沉淀
普通 HTML 报告 = 专题阅读页
Graphviz SVG = 静态图谱备选
Obsidian Canvas = 未来可选视觉层
```

当前正式主入口：

- `../research-atlas-cytoscape.html`

## 为什么选择 Cytoscape HTML Atlas

经过对比，Cytoscape 版最符合当前需求：

1. 节点可以可靠点击，不依赖 `file://` 下不稳定的 SVG 链接。
2. 支持拖拽、缩放、平移，更像知识图谱。
3. 能保留“左侧章节目录 + 中央图谱 + 右侧详情”的翻书式阅读体验。
4. 比 Obsidian Canvas 更容易控制密度和展示风格。
5. 比 Graphviz 更适合交互。
6. 比纯 Markdown 更适合快速吸收和回到主线。

## 当前知识界面分工

### 1. Cytoscape HTML Atlas

文件：`../research-atlas-cytoscape.html`

用途：

- 日常打开项目时的第一入口
- 查看主线与分支关系
- 点击节点快速恢复上下文
- 判断当前阶段、挂起分支、待验证问题
- 从图谱跳转到相关 Markdown 文档

适合场景：

- 想快速回到主线
- 想知道现在研究到哪里
- 想判断一个分支是否应该继续
- 想减少 Markdown 阅读压力

### 2. Markdown 知识仓库

目录：`./`

用途：

- 保存阶段性结论
- 保存证据来源
- 保存决策日志
- 保存实验池
- 保存原则、标准和复盘制度

原则：

- Markdown 不作为日常阅读入口
- Markdown 是事实和结论的长期存储层
- 关键内容应在 Cytoscape Atlas 中有摘要节点

### 3. 专题 HTML 报告

示例：`../marketplace-comparison.html`

用途：

- 承载一个专题的完整调研阅读体验
- 用于比 Markdown 更舒服地查看大段对比、证据和表格

适合场景：

- 平台对比
- 支付资质专题
- 选品专题
- 履约专题
- 广告模型专题

### 4. Graphviz SVG

文件：

- `../research-atlas-graphviz.html`
- `./atlas-graph.dot`
- `./atlas-graph.svg`

定位：静态图谱备选，不作为当前主入口。

原因：

- 图谱布局和箭头更可靠
- 但在 `file://` 环境下 SVG 原生链接点击不稳定
- 更适合生成静态关系图，不适合承担主要交互

### 5. Obsidian Canvas

文件：`../ecommerce-atlas.canvas`

定位：未来可选视觉层，不作为当前主入口。

原因：

- 适合自由拖拽和人工整理
- 但在 MacBook 下操作和密度控制不如当前 Cytoscape HTML
- 暂时避免额外工具学习成本


## 文件命名规则

后续新增项目文件默认使用直观中文命名，降低阅读和回忆成本。

```text
Markdown：编号-中文主题名.md
HTML：中文主题名.html
主入口：项目知识图谱.html / 项目总览.html / 支付方式决策地图.html
```

执行规则：

1. Markdown 保留编号用于排序，例如 `16-独立站支付接入商基准对比.md`。
2. HTML 优先服务阅读体验，不强制编号，例如 `独立站支付接入商基准对比.html`。
3. 老文件暂不主动重命名，避免打断已有链接；后续可单独做一次中文化迁移。
4. 新增专题时，文件名应让一个月后的我们不用打开文件也能猜到内容。

## 后续维护规则

### 新增主线节点时

需要同步更新：

1. `../research-atlas-cytoscape.html` 中的 `chapters`
2. `../research-atlas-cytoscape.html` 中的 `edges`
3. 必要时更新 `positions`
4. 对应 Markdown 文档或专题 HTML

### 新增分支节点时

需要判断：

- 它属于哪个主线节点？
- 为什么打开？
- 当前状态是什么？
- 何时回到主线？
- 是否有对应文档？

### 每次调研后

优先更新顺序：

1. 相关 Markdown 文档记录证据和结论
2. Cytoscape Atlas 更新节点摘要和状态
3. 如专题内容较大，再生成专题 HTML 报告

## 状态规范

Cytoscape Atlas 中节点状态暂定为：

```text
main    当前主线
wait    挂起 / 待验证
branch  待展开分支
watch   观察
no      暂缓 / 当前不做
```

含义：

- `main`: 当前确定在主线上的内容
- `wait`: 已认可但暂时暂停，或需要后续验证
- `branch`: 可展开探索，但不是当前主线承诺
- `watch`: 未来可能有用，当前观察
- `no`: 当前阶段不做，不代表永久否定

## 当前图谱主线

```text
认知拓展
  -> 支付与资质
  -> 选品
  -> 履约
  -> 落地页与广告
  -> 数据复盘
  -> AI Agent 飞轮
```

## 当前图谱分支

支付与资质：

- PayPal
- Stripe / 海外主体
- MoR Checkout

选品：

- 数字商品
- 轻量实物

落地页与广告：

- 独立站矩阵，当前暂缓

知识管理：

- Obsidian Canvas，观察

## 待优化项

1. 将 Cytoscape.js 从 CDN 改为本地依赖，避免网络不可用。
2. 把图谱数据从 HTML 中拆成独立 JSON 文件，便于维护。
3. 增加章节阅读模式，保留翻书体验。
4. 增加搜索或过滤功能，例如只看待验证、只看暂缓、只看支付分支。
5. 后续根据真实调研内容扩展节点，而不是为了图谱好看而扩展。

## 当前使用建议

日常打开：

```text
../research-atlas-cytoscape.html
```

如果要看完整专题：

```text
../marketplace-comparison.html
```

如果要查证据和结论原文：

```text
./03-evidence-log.md
./01-stage-conclusions.md
./04-decision-log.md
```

## 2026-05-29 清理记录

已清理旧试验 HTML 入口：

- `../research-dashboard.html`
- `../research-atlas.html`
- `../research-atlas-graphviz.html`

当前保留的正式入口：

- `../research-atlas-cytoscape.html`

当前保留的专题报告：

- `../marketplace-comparison.html`

说明：Graphviz 和 Obsidian Canvas 的思路保留为历史参考，但不作为当前主入口维护。