PerryLink/dsh-legal-intake

dsh-legal-intake

官方仓库。 本包唯一官方仓库，由 PerryLink 维护；其他账号下的同名仓库与本项目无关。Apache-2.0。

法务需求 EML 收件、线程去重与台账导出。

状态：alpha / 公开合成 / partial / not counted / 非 GA。 不含客户证据、客户数据，也不作生产可用声明。

English · 简体中文 · Español · Português · हिन्दी

dsh plugin --profile <profile> add dsh-legal-intake

⭐ 如果它帮到了你，点个 star 会让下一个人更容易找到它；没有任何功能被 star 解锁。

工作流：本地输入 → 插件 → 本地输出；不需要调用模型。

本地真实测试运行；不调用模型或网络。

一句话

把收到的法务需求 EML 邮件按线程去重、判断需求类型，再导出一份 Excel 台账。

适合 / 不适合

• 适合：几十封客户或供应商发来的 EML 法务需求，需要按 Message-ID / 线程去重，再整理成一份能交给同事复核的台账。
• 不适合：需要自动连邮箱收信、或需要替你做法律意见与审批结论的场景；本包只在本地读取你给出的文件。

输入

• EML 纯文本（UTF-8）：至少包含 Subject、From、Message-ID，Thread-Id 可选；缺少前两个会报 E_LEGAL_EML_INVALID。
• 附件清单 JSON：只写每个附件的 name / sha256 / size 元数据，不读取附件内容本身。
• 自带样例在 samples/quickstart/input/：3 封合成 EML + 1 份附件清单，合计远小于 500 KB。
• 工具不设硬性文件上限；建议单批 ≤50 封邮件、附件清单 ≤200 行，便于人工复核。
• 需求类型按 NDA / MSA / CONTRACT_REVIEW / DISPUTE / COMPLIANCE / OTHER 归类。

输出

• 终端摘要：读了几封、几条新需求、几条重复被跳过、入库前体检发现几个问题。
• 台账：$DSH_HOME/storages/dsh-legal-intake/exports/intake-ledger.xlsx，工作表 Requests，一行一个需求。
• 原 EML 与附件清单不会被修改；导入结果同时写入本地 storage domain。

示例

直接复制这句话：

我有一封客户发来的法务需求邮件和附件清单，帮我按线程去重、判断需求类型，再导出一份台账。

也可以自己跑（真实运行，截图即来自这条命令）：

node samples/quickstart/run.mjs

合成 EML → 金标 samples/quickstart/expected/result.json；命令与哈希见 screenshots.json。

权限

• 读：你指定的 EML 文件与附件清单（由会话读取后作为参数传入）；不读其他目录
• 写：$DSH_HOME/storages/dsh-legal-intake（exports/intake-ledger.xlsx）；不改原文件
• 联网：否（源码中没有 HTTP / DNS / WebSocket 调用）
• 外部系统：无（不连接邮箱、OA 或云服务，不上传数据）

写文件的工具标 R1（本地写），只读工具标 R0；逐项见下方工具表。

FAQ

装不上怎么办？

确认 DSH >=0.2.1-rc.3 <0.4.0、Node >=24.9 <25，并用全新的 DSH_HOME 重试；完整步骤见 TROUBLESHOOTING.md。

同一封邮件为什么只入库一次？

去重按 Message-ID 做，同一封重发邮件会被计入「重复」而不是新需求；legal.intake_doctor 还会同时提示重复的 Message-ID 和重复的 Thread-Id。

附件清单对不上会怎样？

体检会给出 E_LEGAL_ATTACHMENT_DUPLICATE（同名附件）和 E_LEGAL_ATTACHMENT_EMPTY（0 字节）；按提示改清单即可，不会改动原附件。

能处理我的真实邮件吗？

可以本地运行，但本包是 alpha、只用公开/合成数据验证，不构成法律意见；使用真实邮件前请脱敏并保留复核人。

会联网或上传邮件吗？

不会。解析、去重与导出台账都在本机完成。

版本

• 当前版本：0.1.0-alpha.11（与 package.json 一致）
• 测试：node --test test/*.test.mjs 全绿（13 个用例，0 失败）

安装

安装并验证：

dsh plugin --profile <profile> add dsh-legal-intake
dsh --profile <profile> --dump-config | grep dsh-legal-intake

卸载：

dsh plugin --profile <profile> remove dsh-legal-intake

安装通道

推荐 npm；其他通道用于固定版本或离线。

• npm（推荐）: dsh plugin --profile <profile> add dsh-legal-intake
• git 通道: dsh plugin --profile <profile> add github:PerryLink/dsh-legal-intake
• tarball: pnpm pack then dsh plugin --profile <profile> add ./dsh-legal-intake-<version>.tgz
• 1024 商店: npm i -g dsh1024 then dsh1024 plugin --profile <profile> add dsh-legal-intake

它做什么

法务需求 EML 收件、线程去重与台账导出。 在 DeepSeek Harness 本地运行；下表就是实际工具面，示例使用真实命令面。

输入和输出都留在本地，不上传。

工具

工具名是稳定 API；说明已本地化。

工具	用途	风险
legal.intake	解析 EML 请求，分类请求类型，并按 Message-ID/线程去重	R1 local write
legal.export_ledger	将请求台账导出为 xlsx	R1 local write
legal.intake_doctor	入库前的 EML 体检：缺头、重复 Message-ID/线程、空附件	R0
legal.conflict_check	新事项与既有事项的当事人冲突预检（只读）	R0

快速开始

dsh plugin --profile <profile> add dsh-legal-intake
dsh --profile <profile> --dump-config | grep dsh-legal-intake

验收

fixture 支撑的验收行

输入: fixtures/public/mit/sample_nda.txt

命令: pnpm test

验收行:

req_id	metric	threshold	actual	pass	source	counted
SKU-09-A01	邮件入库（50）	50/50	50	true	public/synthetic	false

这是 fixture 支撑的验收行，不是客户运行；没有编造输出。

边界

• 仅公开/合成样例；不含客户数据或客户证据。
• alpha/partial、not counted，不作 GA 或生产可用声明。
• 除非工具明确说明，否则不调用模型、不联网。
• 每个工具的精确边界见工具表与 ACCEPTANCE.csv。

公开样例

• samples/quickstart/：随 npm 包一起发布的合成样例（3 封 EML + 附件清单 + 金标），node samples/quickstart/run.mjs --check 可直接复现金标。
• fixtures/：仅仓库内保留的公开 fixture；ACCEPTANCE.csv 记录公开检查，除 PS1-QS01 外全部 counted=false。

开发

pnpm install --frozen-lockfile
pnpm build && pnpm lint && pnpm typecheck && pnpm test

兼容性

维度	状态
Harness	dsh >=0.2.1-rc.3 <0.3.0
Node	>=24.9.0 <25
Platforms	All; local files only
数据	No network, no model call, no upload

权限与数据

• 本地运行；不联网、不调用模型、不上传。
• 只使用公开/合成 fixture；不含客户数据或客户证据。
• alpha/partial；not counted，不作 GA 或生产可用声明。

相关项目

兄弟包与家族索引： dsh-legal-clause · dsh-contract-suite

相关核查器（英文表）: Related checkers.

• 故障排查（英文）
• 领域索引
• Checker 家族
• 主线家族

家族

Package	npm
dsh-einvoice	npm
dsh-docx-redline	npm
dsh-policy-ledger	npm
dsh-ghg	npm
dsh-bankrec	npm
dsh-ap-three-way	npm
dsh-ifc-qto	npm
dsh-qms-capa	npm
dsh-legal-intake	npm
dsh-legal-clause	npm
dsh-freight-audit	npm
dsh-hs-candidate	npm
dsh-travel-recon	npm
dsh-pim-lint	npm
dsh-eval-pack	npm
dsh-finops-suite	npm
dsh-contract-suite	npm

Package	npm
dsh-aqua-input-check	npm
dsh-archive-check	npm
dsh-bid-ca-precheck	npm
dsh-bid-qual-check	npm
dsh-contract-stance	npm
dsh-customs-doc-check	npm
dsh-demurrage-ledger	npm
dsh-drill-script-check	npm
dsh-eia-guide-check	npm
dsh-emergency-plan	npm
dsh-essay-rubric-check	npm
dsh-evidence-check	npm
dsh-export-ctl-check	npm
dsh-fmea-table-check	npm
dsh-forecast-penalty	npm
dsh-gongwen-flow-check	npm
dsh-gongwen-word-check	npm
dsh-guard-plan-qc	npm
dsh-hazchem-check	npm
dsh-hazplan-check	npm
dsh-hidden-risk-map	npm
dsh-hs-classify	npm
dsh-icd-rule-check	npm
dsh-lawcite-adapter	npm
dsh-lc-doc-check	npm
dsh-learning-gap-check	npm
dsh-medrec-qc	npm
dsh-nsfc-form-check	npm
dsh-nurse-record-check	npm
dsh-origin-rvc-check	npm
dsh-ota-review-check	npm
dsh-paper-doc-adapter	npm
dsh-permit-report-check	npm
dsh-pipeline-check	npm
dsh-pleading-draft	npm
dsh-policy-brief-draft	npm
dsh-power-loss-split	npm
dsh-power-ticket-check	npm
dsh-ppap-check	npm
dsh-protest-deadline	npm
dsh-railway-window	npm
dsh-repair-order-qc	npm
dsh-review-reply-check	npm
dsh-rulefile-check	npm
dsh-safety-brief-check	npm
dsh-site-log-check	npm
dsh-soe-decision-check	npm
dsh-soilwater-check	npm
dsh-sop-sync-check	npm
dsh-spc-gbt-adapter	npm
dsh-tender-extract	npm
dsh-tender-matrix	npm
dsh-warranty-calc	npm
dsh-auto-review	npm
dsh-autotier	npm
dsh-budget	npm
dsh-cert-mcp	npm
dsh-checkpoint-rewind	npm
dsh-claude-move	npm
dsh-click	npm
dsh-composer-history	npm
dsh-data-quality	npm
dsh-defend	npm
dsh-doublecheck	npm
dsh-draw	npm
dsh-fast	npm
dsh-fund-research	npm
dsh-industry-research	npm
dsh-laya	npm
dsh-library	npm
dsh-local-ai	npm
dsh-lsp-actions	npm
dsh-mask	npm
dsh-mcp-panel	npm
dsh-memento	npm
dsh-observe	npm
dsh-output-styles	npm
dsh-permission-rules	npm
dsh-plugin-guide	npm
dsh-plugin-upgrade	npm
dsh-reach	npm
dsh-research-report	npm
dsh-score	npm
dsh-session-sync	npm
dsh-talk	npm
dsh-test-drive	npm
dsh-translate	npm
	npm
	npm
	npm
	npm
	npm

许可证

Apache-2.0. See LICENSE, NOTICE, THIRD-PARTY-NOTICES.