Documentation
README
bear-trace · 文献溯源
一个任务:讲清楚一个问题是怎么走到今天的,通过向前挖掘来完成。大多数综述是向前平铺的;这个技能顺着传承线向后追,让你看见每一步为什么发生。
先读 references/sci-cli.md——CLI 检测步骤、用法和铁律。
再读 references/output-system.md——三层输出体系和 HTML 外壳规范。
Flags
- 默认:向前追溯 3 层
-d N:追溯 N 层(1 到 5);默认 3 层约 4–5 次检索,5 层约 7–8 次
步骤(固定顺序)
Step 0 — 确认 CLI 可用
运行 sci --version。未安装就给安装命令并停止;认证错误就提示 sci init 并停止。
Step 1 — 锚定当前里程碑
如果输入是主题,先 sci search 找到当前的标志性工作作为起点。如果输入是一篇具体论文,直接用它作为锚点。
如果用户输入具体论文,先用标题、DOI 或作者年份做精确检索确认锚点。确认不到时,不要凭记忆补论文信息;改为把输入当作主题处理,并在检索缺口里说明未确认到种子论文。
Step 2 — 逐层向前追溯
从锚点出发,每层单独做一次 sci search:它依赖的方法是什么、解决的前驱问题是什么、建立在哪些奠基性结论上。每层是独立的检索,不是记忆推断。层数由 -d 决定,默认 3 层。
深度溯源意味着多次检索,告知用户"本次将执行约 N 次检索"后直接开始,不等待确认。
每条传承边必须标注关系类型:
- 方法来源:后文使用或改造了前文方法
- 问题来源:后文延续了前文提出的问题
- 证据来源:后文建立在前文结论或数据上
- 领域转折:后文改变了研究对象、尺度或解释框架
This is the opening of the README. Read the full README on GitHub.