4.2 Browser 与 cypher-shell：两个交互工具的分工

4.2 Browser 与 cypher-shell：两个交互工具的分工

本节摘要：人要跟图对话，两个官方工具各有性格：Browser 是网页端的图形化探索器，结果长成图、适合理解结构与调试；cypher-shell 是终端里的轻客户端，能接管道、跑脚本、进 CI。本节对照两者能力边界，给出"什么时候用哪个"的判断表，并各演示一组进阶用法。

1.3 节我们已经见过它们的安装与初见。本节把视角从"能用"提升到"用得顺"：日常开发里两个工具是互补的，各干各的活。

Browser：探索与理解的座舱

Browser 的核心价值是可视化反馈：查询结果直接画成节点连线图，点一个节点能展开它的关系，图结构的变化一眼可见。三个提升效率的用法：

// 用法一：可视化 + 限制规模——先看形状再写正式查询
MATCH (p:Person {name: 'Tom Hanks'})-[:ACTED_IN]->(m:Movie)
OPTIONAL MATCH (m)<-[:ACTED_IN]-(c:Person)
RETURN p, m, c LIMIT 30
​

graph 视图：以 Hanks 为中心的演员-电影网
点击任一电影节点 → 侧栏显示属性 → 双击可继续展开关系
​

// 用法二：参数交互——:param 存变量，反复调试不必重打参数
:param name => 'Keanu Reeves'
MATCH (p:Person {name: $name})-[:ACTED_IN]->(m)
RETURN m.title LIMIT 5
​

用法三：左上角收藏栏保存常用查询，一键重跑；
       结果区导出 CSV/GRAPH JSON，交给下游做二次分析。
​

Browser 的可视化默认不设行数上限时会拖死页面——探索图务必带上 LIMIT，先画局部再看全局，这个习惯在大图上是保命的。

cypher-shell：脚本与无人值守的主力

终端客户端的价值在可自动化：能吃 stdin、能出 CSV、退出码可判——天然适合定时任务与流水线：

# 交互模式
cypher-shell -a neo4j://localhost:7687 -u neo4j -p secret

# 脚本模式：从文件执行，结果落盘，检查退出码
cypher-shell -a neo4j://localhost:7687 -u neo4j -p secret \
  --format plain \
  -f daily-report.cypher > report_$(date +%F).csv

if %errorlevel% neq 0 echo 查询失败，触发告警
​

-- daily-report.cypher：昨天的订单量与异常库存
MATCH (o:Order)
WHERE o.createdAt >= date() - duration('P1D')
RETURN count(o) AS 昨日订单数;
MATCH (p:Product)
WHERE p.stock < 10
RETURN p.sku AS 低库存, p.stock AS 剩余;
​

--format plain 出制表符分隔的纯文本，Excel 与 awk 都能直接吃。定时任务配好退出码检查，查询失败当天就能知道——这就是它比"人肉登 Browser 看一眼"可靠的地方。

分工判断表

一句话版本：画给人看用 Browser，喂给机器用 cypher-shell。两者读的是同一个库、跑的是同一套 Cypher，切换没有认知成本。

配合演练：一次完整的巡检脚本

把本章两件工具串成一次真实工作流：先用 Browser 定位"哪些 Person 节点没有任何 KNOWS 关系"（探索期），再把结论固化成脚本（自动化期）：

// 探索期（Browser）：孤儿节点的形状先看看
MATCH (p:Person)
WHERE NOT (p)--()
RETURN p LIMIT 25
​

确认形状后固化，巡检脚本孤岛检测段：
​

-- orphan-check.cypher（cypher-shell 每日执行）
MATCH (p:Person)
WHERE NOT (p)--()
RETURN count(p) AS 孤儿节点数;
​

$ cypher-shell ... -f orphan-check.cypher
孤儿节点数
12
退出码 0 → 巡检通过，12 写入日报
若阈值告警则脚本内比较后 exit 1
​

这套"Browser 定型、脚本固化"的双段工作流适用于所有周期性任务：先交互式把查询调对，再交给无人值守——省下的是每天人工巡检的十分钟，更重要的是盯住了人盯不住的那一天。

远程连接与安全口径

两个工具都会连远程库，几个安全习惯值得从第一天养成：

1. 不在命令行明文传密码：cypher-shell 支持 --prompt-for-password 交互输入
2. Browser 面对公网时挂反代加 TLS，引擎侧开启 HTTPS
3. 用 3.5 的专用账号登录工具，不用超管
4. 公司内网批量脚本统一走 cypher-shell + 专用巡检账号
​

远程连接只是把 -a 的地址从本机换成服务器地址，其余操作完全一致——这也意味着本册所有练习都可以在任何一台远程实例上完成。