Bitzsoft.Integrations.LegalDatabase.Pkulaw 1.0.0-alpha.10

Bitzsoft.Integrations.LegalDatabase.Pkulaw

北大法宝法规案例库集成 — 支持 SSO 跳转、AlphaData API、AlphaGPT 接入，并可选启用 REST API 检索。

功能特性

• 三种 SSO 访问模式：标准登录（MD5 签名）、AlphaData API（RSA-SHA256 签名）、AlphaGPT（RSA 加密）
• REST API 检索：配置 ApiToken 后额外支持法律法规 / 司法案例检索与文档详情
• 动态能力标志：Capabilities 随 ApiToken 配置变化（仅 AccessUrl 或 All）
• 统一接口：实现 ILegalDatabaseProvider，与其他法律数据库供应商无缝替换

安装

.NET CLI

dotnet add package Bitzsoft.Integrations.LegalDatabase.Pkulaw

PackageReference

<PackageReference Include="Bitzsoft.Integrations.LegalDatabase.Pkulaw" Version="1.0.0" />

配置

appsettings.json

{
  "LegalDatabase": {
    "Pkulaw": {
      "UserName": "your-login-username",
      "PrivateKey": "your-md5-private-key",
      "LibId": "law",
      "LoginUrl": "https://login.pkulaw.com/",
      "AiUrl": "https://ai.pkulaw.com/apps/lawyerAssist/search?channel=nav_ad",
      "AlphaDataApiUrl": "https://opendata.alphalawyer.cn/gateway/getToken",
      "AlphaDataAppId": "your-alpha-data-app-id",
      "AlphaDataPrivateKey": "your-pkcs8-rsa-private-key",
      "AlphaGptApiUrl": "https://similar.alphalawyer.cn/ai/api/v1/login/third",
      "AlphaGptOfficeId": "your-office-id",
      "AlphaGptPublicKey": "your-rsa-public-key",
      "ApiBaseUrl": "https://api.pkulaw.com/",
      "ApiToken": "your-rest-api-token"
    }
  }
}

访问模式按优先级自动选择：配置 AlphaDataAppId + AlphaDataPrivateKey 用 AlphaData；配置 AlphaGptPublicKey + AlphaGptOfficeId 用 AlphaGPT；否则用标准登录。

注册服务

从 IConfiguration 绑定（推荐）

using Bitzsoft.Integrations.LegalDatabase.Pkulaw;

builder.Services.AddBitzsoftPkulawLegalDatabase(
    builder.Configuration.GetSection("LegalDatabase:Pkulaw"));

委托配置

builder.Services.AddBitzsoftPkulawLegalDatabase(options =>
{
    // 标准登录模式
    options.UserName = "your-login-username";
    options.PrivateKey = "your-md5-private-key";

    // 如需 API 检索
    options.ApiToken = "your-rest-api-token";
});

使用示例

生成 SSO 访问链接

using Bitzsoft.Integrations.LegalDatabase;

public class LoginController : ControllerBase
{
    private readonly ILegalDatabaseProvider _provider;

    public LoginController(ILegalDatabaseProvider provider) => _provider = provider;

    [HttpGet("login/pkulaw")]
    public async Task<IActionResult> Login(string userId)
    {
        var access = await _provider.GenerateAccessUrlAsync(userId);
        return Redirect(access.Url);
    }
}

法律检索（配置 ApiToken 后可用）

using Bitzsoft.Integrations.LegalDatabase.Enums;

if ((_provider.Capabilities & LegalDatabaseCapabilities.Search) != 0)
{
    // 法规检索
    var laws = await _provider.SearchAsync("民法典", LegalSearchType.Law, 1, 20);

    // 案例检索
    var cases = await _provider.SearchAsync("合同纠纷", LegalSearchType.Case, 1, 20);

    Console.WriteLine($"共 {cases.TotalCount} 条案例");
    foreach (var doc in cases.Items)
        Console.WriteLine($"{doc.Id}  {doc.Title}");
}

文档详情（配置 ApiToken 后可用）

var doc = await _provider.GetDocumentAsync("DOC-123456");
Console.WriteLine(doc.Title);
Console.WriteLine(doc.Summary);

请求审计

内置 Bitzsoft.Integrations.RequestLogging 出站请求记录管道，记录每次调用北大法宝 API 的请求与响应，默认使用 NullRequestLogStore 不持久化。

// 默认：启用记录管道但不持久化（日志丢弃）
services.AddBitzsoftPkulawLegalDatabase(options => { /* ... */ });

// 持久化：宿主注册 IRequestLogStore 实现后，所有出站请求自动落库
services.AddRequestLogging<MyRequestLogStore>(opts =>
{
    opts.MaxInMemoryBodyBytes = 64 * 1024; // 仅控制内存/加密临时文件切换，不截断正文
    opts.SensitiveFields.Add("PrivateKey");
});
services.AddBitzsoftPkulawLegalDatabase(options => { /* ... */ });

依赖

相关包

• Bitzsoft.Integrations.LegalDatabase -- 法规案例库抽象层
• Bitzsoft.Integrations.LegalDatabase.All -- 全部 12 家供应商聚合包
• Bitzsoft.Integrations.SsoRedirect -- SSO 跳转配置驱动管道