人民法院一张网自动立案（安全、幂等、可复核版）
适用范围
当前稳定目标包括：（1）民事一审、已准备诉状、法人或自然人原告/被告；（2）首次执行案件，执行依据为账户“我的案件”可唯一匹配的民商事生效裁判，执行标的可为金钱给付、行为、财产性权益、动产或不动产。两类流程均支持单名或多名代理人。其他立案类型不得套用码值，应先扩展适配器并完成独立回归。
最终“提交立案”是律师本人对外作出的程序行为。本 skill 只把草稿推进到复核/提交页，生成复核文件和截图，绝不代点最终提交。
内部代码目录（填写前强制检索）
references/lookup/courts.json 保存人民法院在线服务当前返回的最高人民法院、31 个省级行政区及新疆生产建设兵团法院目录；references/lookup/causes.json 保存官网前端映射的刑事、民事、行政、国家赔偿和执行五类案由。目录只含公共配置，不含真实案件、当事人、登录态或草稿信息。
每次生成逐案配置前，必须先用本地目录精确反查，禁止凭记忆手填代码，也禁止在多条结果中默认取第一条。民事一审只允许使用 0300 组并优先选择叶子案由：
node scripts/lookup-taxonomy.js court "法院全称" --province 省级代码 --exact --unique
node scripts/lookup-taxonomy.js cause "案由全称" --group 0300 --leaf-only --exact --unique
案由名称可能在不同层级或不同类别重复；返回不唯一时，必须结合 groupCode、完整 path 和 leaf 明确选择。正式写入草稿时还必须复核网页当前返回的法院 ID、名称及案由 ID、名称；网页与本地快照不一致时立即停止写入，运行只读刷新命令后重新核对：
node scripts/refresh-taxonomy.js --state-dir /绝对路径/私有状态目录
刷新命令只读取法院配置接口，不创建、修改、删除或提交任何案件。完整字段、数据源和异常说明见 references/lookup/README.md。目录覆盖五类案由不等于本 skill 承诺办理五类案件；稳定写入范围仍以“适用范围”为准。
强制流程
- 民事一审复制
config/case.example.json，首次执行复制config/case.execution.example.json，在案件私有目录形成逐案配置。不得把真实案件信息写回 skill。 - 先按“内部代码目录”精确、唯一反查法院和案由，再一次性核对法院、案由码、标的金额、当事人、法定代表人、代理人、电子送达、送达地址唯一匹配文字、签名版本、法律援助和材料映射。法人原告还必须有与该主体对应的法定代表人身份证明书或负责人身份证明书，并映射到“当事人身份证明”。
- 运行预检：
node scripts/zxfw.js preflight --config /绝对路径/case.json
- 登录（每一个新立案流程必须从本步开始，默认扫码；也可选账号密码）：
扫码登录：node scripts/zxfw.js login --config /绝对路径/case.json
账号密码登录：先仅在当次运行环境中设置 ZXFW_USERNAME、ZXFW_PASSWORD，再运行：
node scripts/zxfw.js login --config /绝对路径/case.json --login-method password --headed
login 默认强制生成当次新二维码，不得因本地存在旧 token 而跳过。看到 QR_IMAGE=... 后立即把二维码展示给用户，由用户本人扫码。展示后不得等待用户文字回复“已扫码”：必须保持命令在后台每2秒轮询登录状态，60秒未完成时自动刷新二维码并继续轮询，确认登录成功后自动继续流程。不得打印 token。
账号密码不得写入逐案配置、skill、日志或命令行参数。密码模式强制打开可见浏览器，自动填写账号和密码后停留在登录页并输出截图回执。图形验证码属于网站的人机校验：默认由用户本人在页面完成；若代理拟根据当次截图或纯本地 OCR 识别并通过标准输入回送验证码，必须在验证码已显示、即将填写和点击登录时取得用户即时确认。一次性验证码不得写入配置、状态或日志，不得调用第三方打码服务。
法院登录页使用自定义 UNI-INPUT。仅让原生输入框显示四位字符并不代表登录模型已同步：提交前必须把完整验证码同步到唯一的 loginParam.yzm，且脱敏请求诊断中的 yzm 长度必须为 4；字段未唯一匹配时拒绝提交。
未记录 loginConfirmedAt（旧状态兼容 qrLoginConfirmedAt）时，start/prepare/verify/preview 必须拒绝运行并要求先执行 login。同一案件后续步骤可复用该次已确认登录态。
- 准备草稿：
node scripts/zxfw.js prepare --config /绝对路径/case.json
命令可安全重跑：本地状态保存 layyid；每个远端写入步骤都先查重、后复核。普通 PDF 上传完成后，按配置的唯一地址和唯一签名引入送达地址确认书。出现冲突立即停止，不做覆盖。
- 独立复核：
node scripts/zxfw.js verify --config /绝对路径/case.json
- 打开预览页并截图：
node scripts/zxfw.js preview --config /绝对路径/case.json --headed
-
律师依据
review.json、预览截图和网页逐项核对后，本人决定是否提交。 -
任务结束前必须盘点本次运行创建或触及的全部草稿。只保留一份经完整验收的目标案件草稿；本次产生的空壳、未完成和重复草稿必须列入不可篡改的删除计划。用户已明确授权清理的，执行计划并重新读取列表复核；尚未授权的，必须展示计划并请求确认，不得静默遗留或宣称任务完成。收尾报告必须写明完整草稿保留数、空壳/未完成/重复草稿删除数和回查结果。
建议每案显式指定独立的 --state-dir。该目录含登录态、断点、上传回执和删除计划，不得放入同步盘或发布包。
核心字段规则
dsrlx是主体类型码：自然人1501_000011-1、法人1501_000011-2、非法人组织1501_000011-3；稳定写入当前只启用前两类。cdsrlx是主体类型中文名：自然人、法人或非法人组织。ssdw是诉讼地位：原告1501_030109-1、被告1501_030109-2、第三人1501_030109-5。- 首次执行的
ssdw必须使用执行专用码：申请执行人1501_100225-1、被执行人1501_100225-2，不得复用民事一审原告/被告码。 - 首次执行类型为
1501_000001-1002；民商事执行依据类别为1501_11400101-1。必须先读取账户可选的原审案件并以完整案号唯一匹配，不得手工猜测案件内部 ID、法院 ID 或案标识。 - 执行标的类型：金钱给付
1501_100279-1、行为1501_100279-3、财产性权益1501_100279-4、动产1501_100279-5、不动产1501_100279-6。行为/权利/动产/不动产字段每项最多300字。 - 执行依据、执行标的、执行请求和执行理由均存在
data.zxyjs[0]；原审案件关联信息同时存在data.layy.ys*字段。两处必须分别回读复核。 - 执行材料类目：执行申请书
11800016-2、执行依据文书11800016-8、授权委托书及代理人身份证明11800016-9、申请人身份材料11800016-1、送达地址确认书11800016-254、收款账户确认书11800016-36。非金钱给付案件不得为凑齐类目虚构收款账户。 - 2026-08-28 的所谓“直连接口失败”，实际原因是把
dsrlx错写为yg并把法人码塞进dwxz。纠正字段后原告可在重新加载的前端正常显示。前端保存被告捕获到的 POST body 本身也是同一接口和上述字段结构。 - 代理人关联原告必须按
ssdw=1501_030109-1查找，不能再按dsrlx='yg'查找。 - 多名代理人按“身份证号＋被代理主体证照号/身份证号”查重和关联，不再假定系统只有一条预填律师记录。执业律师码为
1501_000013-1；当事人的近亲属或工作人员码为1501_000013-3。 - 委托代理的当前权威码为
1501_100434-3。旧示例中的1501_000014-3不得继续使用。 authorizationScope=general/special仅用于配置、复核清单和授权材料映射。当前民事一审页面不提供一般/特别授权输入项，接口会接受但详情不持久化dlqx/cdlqx，不得宣称该项已结构化落库；以授权委托书为准。- 草稿详情的案件主记录在
data.layy，当事人在data.dsrs，代理人在data.dlrs，材料类别在data.sscls。不得从data.fymc/data.laay误读。 - 当前法院模板通过
/api/v3/pz/layymb/{fyId}/{ajlx}获取。恢复已有草稿时，必须在页面组件创建前同时写入layyParam、layyStep、layyInfo和splaTemplate；否则后端虽完整，预览页仍会空白。 - 同意电子送达时，
deliveryConfirmation.addressMatch必须在账户预留地址中唯一命中；电子签名也必须按signatureVersion唯一命中，未指定版本时账户中必须恰好一份签名。不得默认取第一条地址或签名。 - “引入送达地址确认书”不是普通 PDF 上传：先查询预留送达地址和电子签名，再调用
/api/v3/layy/ssclfj/upload由法院后端生成 PDF；每次运行前后都必须确认该类目恰好一份。 - 民事一审中的退费账户确认书必须上传到“其他材料”（
11800016-3），不得放入执行案件使用的“收款账户确认书”（11800016-36）。配置错误应在连接法院前失败。 - 法人原告的“法定代表人身份证明书”或“负责人身份证明书”必须上传到“当事人身份证明”（
11800016-1），不得放入“委托代理人材料”或“其他材料”。配置使用documentType=legal_representative_or_responsible_person_identity_proof；存在多个法人原告时，还必须用partyIdentifier写明对应原告的统一社会信用代码。缺失或分类错误应在连接法院前失败。
验收门槛
- 后端
data.layy的法院、案由、案由码、标的金额与配置一致。 - 首次执行必须另行确认
data.zxyjs恰好一条，执行依据类别、终审案号、作出单位、执行标的类型及内容、执行请求、执行理由与配置完全一致；data.layy.ys*原审关联字段也必须一致。 - 每个预期法人按“诉讼地位＋统一社会信用代码”、自然人按“诉讼地位＋身份证号”恰好匹配一条；主体类型和所有核心字段一致。
- 每个预期代理人按身份证号恰好匹配一条，且
bdlrid/bdlrMc指向配置指定主体；代理人类型、委托代理类型、手机、现住址、法律援助、电子送达均落库。一般/特别授权范围只核对授权材料，不以详情接口空字段判失败。 - 每个配置材料在正确类别恰好匹配一份；同名多份立即失败。
- 送达地址确认书类别必须恰好一份；使用本 skill 引入时，回执须记录所选地址 ID、签名 ID 和生成文件 ID。
- 配置材料不得同时残留在其他类别；发现跨类目同名材料立即失败，不以总材料数代替逐项核对。
- 法人原告必须恰当配置法定代表人/负责人身份证明书，且远端“当事人身份证明”类别中能唯一匹配该文件。
prepare/verify通过只能输出CASE_DATA_VERIFIED=1和DRAFT_CLOSEOUT_REQUIRED=1，不得提前宣称整个任务已就绪。只有全部门槛通过，且本次产生的空壳、未完成和重复草稿已删除并回查为零，代理才可以报告READY_FOR_LAWYER_REVIEW=1。
安全要求
- token、删除计划、完整运行状态均写入私有状态目录，权限 600；日志自动遮蔽证件号、手机号、token 和 OSS 凭证。
- 法院接口和 OSS 上传复用已登录浏览器的受控网络上下文，以兼容本机系统证书链；不得用
NODE_TLS_REJECT_UNAUTHORIZED=0或全局关闭 TLS 校验。 - 不使用跨项目的
/tmp/*.json或全局通配符清理。每案使用独立caseKey和状态目录。 - 不得自动删除既存真实案件草稿。但本次产生的空壳、未完成和重复草稿也不得静默遗留：必须先运行
delete-drafts.js --plan --ids ...，让律师核对计划及确认码，获得明确授权后以原计划执行并回查；草稿内容变化后旧计划自动失效。 - 不把真实案件配置、签名 URL、临时 OSS 凭证或状态文件发布到 SkillHub。
- 发布 SkillHub 前必须扫描整个发布包，确认不含真实账号、密码、手机号、证件号、Token、案件名称、当事人名称、案号、本机路径、运行截图或会话状态；测试数据只能使用明确虚构的示例值。
故障处理
CONFIG_CHANGED：已有草稿后配置发生变化；使用新caseKey或人工核对现有草稿，禁止直接覆盖。PARTY_DUPLICATE/PARTY_CONFLICT：停止；不得自动猜测保留哪一条。MATERIAL_EXISTING_UNVERIFIED：服务器已有同名文件但无本地回执；人工核对后处理，不盲目跳过或覆盖。TOKEN_MISSING/LOGIN_TIMEOUT：扫码模式重新生成二维码，由本人扫码；密码模式检查账号密码后，由本人重新完成验证码与登录按钮。- 网站组件或接口字段变化：保存诊断证据，更新适配器并先在可删除的真实测试草稿回归；禁止把一次探测脚本直接加入稳定清单。
- 当事人详情不回显请求中的
fyId，法人zcddjd当前会被接受但详情返回空；二者均不得列入持久化核心字段。必须另行核验data.layy.fyid、主体地址和证照号。
实网回归状态
2026-08-29 已用一个不提交的真实民事一审草稿完成 2.0.1 回归：基础草稿断点恢复、案由和金额、两名法人当事人、律师代理、11 份普通 PDF、送达地址确认书引入、模板恢复、预览及幂等重跑全部通过。
2026-08-30 又以一个不提交的上海民事一审真实草稿完成 2.1.0 主体/代理回归：法人原告、法人被告、自然人被告、预填执业律师和新增当事人工作人员均已落库并经详情接口回读。自然人全部核心字段持久化；新增第二代理人使用 /api/v3/layy/dlr POST 一次成功。一般/特别授权范围未持久化，已按页面能力改为材料复核事项。
2026-09-01 已用一个不提交的真实首次执行目标草稿完成 2.3.0 回归：账户“我的案件”中终审案号唯一匹配、民商事执行依据、行为类执行标的、执行请求和理由、自然人申请执行人、法人被执行人、预填律师补全、7 份普通 PDF、送达地址确认书生成、模板恢复和预览均通过后端与页面双重复核。第二次完整运行全部查重跳过，未重复创建当事人、上传材料或生成送达确认书；登录态过期后按“展示新二维码—后台轮询—扫码成功自动续跑”规则完成重新认证。全程未点击最终“提交立案”。
2026-09-16 已完成账号密码登录实网回归：律师用户密码登录页自动填写账号密码，验证码经本地识别后在同一会话回送；完整四位验证码同步到 loginParam.yzm，登录接口返回“认证成功”，并验证登录后的案件列表、消息和日历接口正常。未创建、修改或提交任何案件草稿。
主体组合矩阵、实网试错和非阻断差异详见 references/party-agent-matrix-and-pitfalls-2026-08-30.md；旧版审计详见 references/legacy-audit-2026-08-29.md。
