@realakagi/lawmcp 0.5.5 → 0.6.0

package/README.md

@@ -18,16 +18,18 @@ LawMCP 更适合把 AI 当成“会调用检索工具的研究助理”，而不
 
 | 工作场景 | 您可以这样问 | LawMCP 会做什么 |
 | --- | --- | --- |
-| 类案初筛 | “帮我检索近三年北京法院关于竞业限制补偿金的案例。” | 调用 AlphaLawyer 案例检索，返回标题、法院、案号、裁判日期和摘要线索。 |
-| 案例细读 | “打开第 3 个案例，看看法院怎么认定违约金过高。” | 根据检索结果读取案例详情，便于继续追问裁判观点和事实认定。 |
+| 类案初筛 | “帮我检索近三年北京法院关于竞业限制补偿金的案例。” | 调用 AlphaLawyer 案例检索，返回标题、法院、案号、裁判日期和摘要线索。 |
+| 多案例观点对比 | “先找钢材加价款相关案例，只看每个案例的法院认为。” | 只提取检索结果里的“法院认为”内容，减少一次查看多个案例时的上下文占用。 |
+| 案例细读 | “打开第 3 个案例，看看法院怎么认定违约金过高。” | 根据检索结果读取案例详情，便于继续追问裁判观点和事实认定。 |
 | 精准组合检索 | “排除保险公司，只看管理人责任纠纷中一审全部或部分支持的案例。” | 使用高级条件组合检索，适合更精确的类案研究。 |
 | 法规定位 | “查一下现行有效的民事诉讼法相关法规。” | 检索中国大陆法规，并可继续查看法规详情。 |
 | 长法规找条文 | “在民法典里找和抵押预告登记有关的命中条文。” | 只返回法规内命中的相关条文，减少整部法规带来的阅读噪音。 |
 
 常见使用方式：
 
-- 写诉状、答辩状、代理词、法律意见书前，先让 AI 拉取候选案例。
-- 做类案检索时，让 AI 围绕“案由、法院、裁判结果、争议焦点”继续追问。
+- 写诉状、答辩状、代理词、法律意见书前，先让 AI 拉取候选案例。
+- 一次比较多个候选案例时，先看“法院认为”，有价值时再打开完整详情。
+- 做类案检索时，让 AI 围绕“案由、法院、裁判结果、争议焦点”继续追问。
 - 需要在同一轮对话里同时查看案例和法规，减少在数据库、文档和聊天窗口之间切换。
 - 对 AI 生成的法律分析保持谨慎，让关键结论尽量回到可检索的案例或法规文本上。
 
@@ -209,19 +211,23 @@ npx -y @realakagi/lawmcp doctor
 帮我检索北京法院近三年关于竞业限制补偿金的案例，优先看劳动争议案件。
 ```
 
-```text
-打开第 2 个案例，帮我归纳法院支持或不支持违约金的理由。
-```
-
-```text
-检索现行有效的民事诉讼法相关法规，并列出与管辖权异议有关的条文线索。
-```
+```text
+打开第 2 个案例，帮我归纳法院支持或不支持违约金的理由。
+```
+
+```text
+先检索钢材加价款相关案例，每条只返回法院认为，暂时不要展开完整详情。
+```
+
+```text
+检索现行有效的民事诉讼法相关法规，并列出与管辖权异议有关的条文线索。
+```
 
 ```text
 找管理人责任纠纷中一审全部或部分支持的案例，排除保险公司相关案件。
 ```
 
-不同 AI 客户端展示 MCP 工具的方式不同。默认服务名通常是 `lawmcp`；如果客户端需要您手动选择工具，请选择 LawMCP 提供的案例检索、案例详情、法规检索或法规详情能力。
+不同 AI 客户端展示 MCP 工具的方式不同。默认服务名通常是 `lawmcp`；如果客户端需要您手动选择工具，请选择 LawMCP 提供的案例检索、案例法院认为、案例详情、法规检索或法规详情能力。
 
 ## 安全提醒
 
@@ -266,9 +272,10 @@ LawMCP 授权用于校验您是否有权使用 LawMCP。AlphaLawyer 登录态用
 
 下面内容主要给技术同事、运维同事或需要手动调试 MCP 的用户查看。普通使用时不需要记住这些工具名和参数。
 
-- `search_cases`：按一个或多个关键词检索案例，支持分页与一次多页。
-- `advanced_search_cases`：按 AlphaLawyer 查询表达式检索案例，适合字段组合、层级条件和排除词。
-- `get_case_detail`：根据检索结果里的案例编号 `jid` 查看详情。
+- `search_cases`：按一个或多个关键词检索案例，支持分页与一次多页。
+- `advanced_search_cases`：按 AlphaLawyer 查询表达式检索案例，适合字段组合、层级条件和排除词。
+- `search_case_court_opinions`：检索案例并只返回列表条目中的“法院认为”内容，适合先比较多个案例的裁判理由。
+- `get_case_detail`：根据检索结果里的案例编号 `jid` 查看详情。
 - `search_laws`：按一个或多个关键词检索中国大陆法规，支持分页与一次多页。
 - `advanced_search_laws`：按 AlphaLawyer 查询表达式检索中国大陆法规，适合字段组合、层级条件和排除词。
 - `get_law_hit_articles`：根据法规编号 `lid` 和关键词，只返回该法规内命中的相关条文。
@@ -317,11 +324,33 @@ LawMCP 授权用于校验您是否有权使用 LawMCP。AlphaLawyer 登录态用
 }
 ```
 
-`query` 使用 AlphaLawyer 网页端表达式，例如 `字段:值`、`字段_层级:值`、同组 OR 的 `A||B`、多条件英文逗号拼接。MCP 会兼容部分常见网页展示名，例如将“法院认为”兼容为 `法院观点`，将“代理律师”“律师事务所”“裁判时间”分别兼容为 `律师`、`律所`、`裁判日期`。普通关键词检索优先使用 `search_cases`。
-
-### 法规关键词检索
-
-```json
+`query` 使用 AlphaLawyer 网页端表达式，例如 `字段:值`、`字段_层级:值`、同组 OR 的 `A||B`、多条件英文逗号拼接。MCP 会兼容部分常见网页展示名，例如将“法院认为”兼容为 `法院观点`，将“代理律师”“律师事务所”“裁判时间”分别兼容为 `律师`、`律所`、`裁判日期`。普通关键词检索优先使用 `search_cases`。
+
+### 案例法院认为检索
+
+```json
+{
+  "keywords": ["钢材加价款", "厦门"],
+  "page": 1,
+  "pageSize": 5,
+  "limit": 10
+}
+```
+
+也可以直接传 AlphaLawyer 查询表达式：
+
+```json
+{
+  "query": "案由_0:买卖合同纠纷,法院认为:加价款",
+  "limit": 10
+}
+```
+
+该工具只返回案例摘要和 `courtOpinion.text`，默认会清洗 AlphaLawyer 高亮 HTML。适合先看多条结果的裁判理由，再决定是否调用 `get_case_detail` 拉取全文。
+
+### 法规关键词检索
+
+```json
 {
   "keywords": ["民事诉讼法"],
   "field": "标题",