一、裁判文书网的“能用”与“好用”之间

做诉讼的同行应该都有这种体验：打开裁判文书网，输入关键词，等十秒钟，页面转圈，然后弹出一个验证码。换几个关键词再搜，又是一轮验证码。

不是说裁判文书网不好 - 它免费公开了海量判决数据，对法律行业的意义怎么强调都不为过。但它的检索体验确实让人头疼：响应慢、验证码频繁、高级检索功能有限、不能批量导出、不能全文检索后按关联度智能排序。

有没有办法把裁判文书“搬”到自己电脑上，用本地搜索引擎来查？

有。cncases/cases这个开源项目做到了 - 它把超过8500万份裁判文书转换成可离线搜索的数据库，在你的电脑上跑一个本地Web搜索服务。搜索速度快、无验证码、支持全文检索和CSV批量导出，而且完全免费。

这篇文章不是技术文档 - 我会用法律人能理解的语言，讲清楚这个工具能做什么、怎么装、用起来是什么体验、以及它最适合哪些场景。

二、这个工具到底是什么

2.1 一句话概括

cncases/cases是一个用Rust语言写的裁判文书本地搜索引擎。你下载原始数据（约102G压缩包），用工具转成数据库（约200G），再建索引（15-150G，取决于是否开全文索引），然后打开浏览器访问本地地址就能搜了。

2.2 它跟裁判文书网的区别

最重要的区别不是功能，是可控性。在裁判文书网上，你每次检索的参数、浏览记录、导出需求，都受限于网站的功能设计。本地版让你可以按自己的方式组织检索策略 - 比如先用案由筛选缩小范围，再用全文检索定位关键段落，最后把相关判例导出做类案分析。

2.3 技术架构（你不需要懂，但了解一下有底气）

底层用了Tantivy全文搜索引擎（类似于Elasticsearch但更轻量），中文分词用了Jieba。数据存储用RocksDB。Web界面用Rust的Axum框架搭建。

这些技术细节对使用没有影响 - 你只需要知道它跑起来很稳、搜索很快、中文分词准确。

三、配置全流程：从下载到第一次搜索

整个配置分四步，耗时主要取决于你的网络速度和电脑性能。

第一步：下载原始数据（102G）

原始数据约102G，包含超过8500万份裁判文书的压缩包。项目提供了两种下载方式：

• BT下载： 项目仓库里有种子文件810air.torrent，用BT客户端下载。推荐有公网IP的用户使用，速度较快。
• 百度网盘： 链接在项目README里，提取码4QrB。适合有百度网盘会员的用户。

下载后注意：不要解压子文件。数据是以ZIP格式分卷压缩的，工具会直接读取ZIP内容。

这一步最耗时间 - 102G的数据量，网速一般的话可能需要挂机下载一两天。

第二步：数据转换（生成约200G数据库）

下载完成后，打开终端，进入工具目录，运行：

  
  
  
  

      
  
  
  
  

   
   
   
   

    
    
    
    

     
     
     
     

      1
     
     
     
     
    
    
    
    
    
    
    
    

     
     
     
     

      ./convert config.toml
     
     
     
     
    
    
    
    
   
   
   
   

这一步将ZIP压缩包中的CSV数据解析并写入RocksDB数据库。耗时数小时，但支持断点续传 - 如果中途断了，重新运行会自动从上次的位置继续。

第三步：创建索引

  
  
  
  

      
  
  
  
  

   
   
   
   

    
    
    
    

     
     
     
     

      1
     
     
     
     
    
    
    
    
    
    
    
    

     
     
     
     

      ./index config.toml
     
     
     
     
    
    
    
    
   
   
   
   

这一步建立搜索索引。有两个选项：

• 不含全文索引： 索引约15.5G，耗时数小时。适合只需要按标题、案号、法院、案由等结构化字段搜索的场景。
• 含全文索引： 索引约150G，耗时十几个小时。适合需要搜索裁判文书正文全文的场景。

建议第一次先不开全文索引，跑通流程验证搜索功能正常后，再考虑是否加全文索引。

第三步半：配置文件说明

config.toml是核心配置文件，几个关键参数：

  
  
  
  

      
  
  
  
  

   
   
   
   

    
    
    
    

     
     
     
     

      1
     
     
     
     
     
     
     
     

      2
     
     
     
     
     
     
     
     

      3
     
     
     
     
     
     
     
     

      4
     
     
     
     
     
     
     
     

      5
     
     
     
     
    
    
    
    
    
    
    
    

     
     
     
     

      db = "./rocksdb"                # 数据库路径，确保所在磁盘有足够空间
index_path = "./search_index"   # 索引路径
index_with_full_text = false    # 是否建全文索引
addr = "127.0.0.1:8081"        # 服务地址
raw_data_path = "./"            # 原始ZIP数据所在路径
     
     
     
     
    
    
    
    
   
   
   
   

如果你想让局域网内其他电脑也能访问（比如团队共享），把addr改成0.0.0.0:8081。

第四步：启动搜索服务

  
  
  
  

      
  
  
  
  

   
   
   
   

    
    
    
    

     
     
     
     

      1
     
     
     
     
    
    
    
    
    
    
    
    

     
     
     
     

      ./main config.toml
     
     
     
     
    
    
    
    
   
   
   
   

浏览器打开http://127.0.0.1:8081，看到搜索界面就成功了。

硬件要求速查

你的办公电脑大概率能满足最低要求。如果磁盘空间不够，可以考虑外接一块移动硬盘。

四、用起来：搜索实操与技巧

4.1 基本搜索

打开Web界面，在搜索框输入关键词，支持：

• 默认搜索： 按关键词匹配标题+案由+法院等结构化字段
• 全文搜索（需开全文索引）：搜索裁判文书正文中的任意词汇
• 法律依据搜索： 按引用的法条搜索，比如输入“民法典第1046条”，找出所有引用该条文的判例
• 案由搜索： 按案由分类浏览

4.2 法律依据搜索：最实用的功能

这是我认为最实用的功能。做类案检索时，核心逻辑就是“找到援引了同一条法律条文的类似判例”。在裁判文书网上做这件事需要先确定案由、再筛选法院层级、再一个个打开看引用了哪些法条 - 很慢。

在cncases里，直接在法律依据搜索框输入法条名称，比如：

• “民法典第五百七十七条” → 找出所有引用违约责任条款的判例
• “劳动合同法第四十六条” → 找出所有涉及经济补偿的劳动争议判例
• “消费者权益保护法第五十五条” → 找出所有涉及三倍赔偿的消费维权判例

这个功能的价值在于：你不需要先猜法院怎么判，而是直接看法院在哪些情况下引用了这条法律、怎么解释的、判决结果是什么。

4.3 CSV导出：批量做类案分析

搜索结果可以导出为CSV文件，最多一次导出10000条。每条记录包含：标题、案号、法院、案由、裁判日期等结构化字段。

导出后的CSV可以导入Excel做统计分析 - 比如：

• 某个法院在最近三年对某类案件的判决倾向
• 某种案由在不同地区的裁判金额分布
• 某条法律条文被引用的频率和场景分布

4.4 响应式设计

Web界面支持移动端访问。在手机上打开同一局域网内的地址，可以随时检索。在法院等开庭的间隙，拿出手机快速查几个相关判例，这体验比用裁判文书网App好不少。

五、实务场景：三个最适用的工作流

场景一：诉讼前的类案检索

这是最直接的应用场景。接到新案子后，做类案检索的标准流程：

1. 在cncases里用“案由搜索”锁定案件类型
2. 用“法律依据搜索”找到引用同一法条的类似判例
3. 按法院层级、裁判日期筛选
4. 导出CSV，在Excel里按判决结果分类统计
5. 选取最接近的3-5个判例作为参考，写入代理词或法律意见书

整个过程在半小时内可以完成。以前在裁判文书网上做同样的事，光验证码就可能打断你三四次。

场景二：常年法律顾问的风险预警

如果你做常年法律顾问，可以用这个工具做行业风险监控：

1. 定期检索客户所在行业的典型纠纷判例
2. 按裁判日期排序，关注最新的判决趋势
3. 如果发现某类纠纷近期判决明显增多或判决方向有变化，及时提醒客户

比如一个做电商的客户，你可以每季度检索一次“电子商务+消费者权益”相关的判例，看法院对“七天无理由退货”的适用范围有没有新的解释。

场景三：法律研究的数据支撑

写论文或做课题时，cncases的批量导出和数据统计功能特别实用。可以快速统计某个法律问题的判例趋势 - 比如“近五年劳动争议中竞业限制条款的裁判支持率变化”。

六、局限性：这些事它做不到

工具很好用，但有几个客观限制要说清楚：

数据不全。 数据来源是马克数据网的爬虫抓取，不是裁判文书网的官方全量导出。部分文书可能缺失，尤其是近一两年新发布的判例。对需要最新判例的场景，还是要去裁判文书网或商业数据库查。

没有智能分析。 这是一个纯粹的搜索引擎，不会帮你归纳裁判规则、不会自动生成类案报告、不会做判决结果预测。这些需要配合AI工具来做 - 把cncases搜出的结果喂给Claude做分析，是一个很自然的组合。

部署门槛对普通律师来说偏高。 虽然不需要写代码，但102G下载+数小时转换+十几个小时索引，这个时间投入不是每个律师都愿意承受的。如果你的律所有IT支持，建议让IT统一部署，律师通过局域网访问。

不能替代商业数据库。 北大法宝、威科先行等商业数据库提供的不只是搜索 - 还有法条沿革、裁判规则归纳、实务指南等增值内容。cncases解决的是“快速搜到判例原文”这个问题，不是“全方位法律研究”。

七、如果你决定装：几个省时间的建议

建议一：先用外接硬盘测试。 102G下载+200G转换+150G索引，对电脑自带硬盘压力不小。外接一块1T的移动硬盘，全部装在上面，不占用工作电脑的存储空间。

建议二：周末挂机跑转换和索引。 转换需要数小时，索引需要十几个小时。周五下班前启动，周一早上来看结果。

建议三：先不开全文索引。 结构检索（按案由、法院、法条等字段搜索）已经能满足大部分需求。等确认结构检索满足不了你的时候，再加全文索引。

建议四：和AI工具配合使用。 cncases负责搜，Claude负责分析 - 把搜到的判例原文喂给Claude，让它总结裁判规则、提取争议焦点、对比不同判例的差异。这才是效率最大化的用法。

八、裁判文书检索的未来

裁判文书网在进步 - 去年做了界面改版，检索速度也有改善。但官方数据库和本地离线搜索不是替代关系，是互补关系。

官方数据库的优势是数据全、更新及时。本地离线搜索的优势是速度快、可定制、能和其他工具联动。一个好的法律检索策略，应该是两者都用 - 需要最新判例去官网，需要深度搜索用本地，需要智能分析接AI。

cncases这个项目还有一个更长远的意义：它证明了公开的裁判文书数据可以被转化成真正好用的工具。8500万份文书不是只能“存在那里” - 它们可以被索引、被检索、被分析、被用来支撑每一个法律判断。

📚 参考文献

• cncases/cases — 中国裁判文书网本地搜索系统（1031 Stars）
• Tantivy搜索引擎 — Rust全文搜索引擎
• 马克数据网 — 裁判文书数据来源
• 裁判文书网 — 官方裁判文书公开平台

⚠️ 免责声明：本文内容仅为提供信息之目的，不构成法律建议。文中提及的开源工具和第三方数据来源，作者不对其数据完整性、准确性或合法性作任何保证。使用裁判文书数据应遵守相关法律法规和平台使用协议。本文作者及平台不对因依赖本文内容而导致的任何损失承担责任。

📝 法律AI工具