dsh-recovery-right-wbr7

追偿权纠纷（R7）DSH 插件：向 DeepSeek Harness（DSH）注册运行时技能 recovery-right-wbr7。

中文摘要　面向中国大陆追偿权纠纷的起诉准备与内部办案工作流：识别追偿路线，核验主体、合同、担保权利、履责资金、时间程序五条链，产出九份法院版式文书（DOCX），并可导出 PDF 与逐页图片，全程带质量门。条件未闭合时暂停，不生成可直接提交的文书。产出是律师内部工作底稿，须经执业律师复核；本插件不向法院提交任何材料。

English summary　A DSH plugin that registers the runtime skill recovery-right-wbr7, a filing-preparation workflow for recovery-right (recourse) disputes in mainland China. It produces nine court-format documents (DOCX) with optional PDF and per-page image export behind quality gates, and pauses when prerequisites are not closed. Output is internal working material that a licensed lawyer must review; the plugin files nothing with any court. Python dependencies are locked wheels shipped in the package and installed offline.

支持范围与验证状态 / Support and verification status

平台 / Platform	包内 wheel	状态 / Status
macOS 13+，Apple Silicon (arm64)	有	首轮验收平台。原始 R7 已在 DSH 0.2.1-rc.5 上合成出件。
macOS 13+，Intel (x86_64)	有	wheel 已覆盖，原生出件待测。
Windows x64	有	wheel 已覆盖，原生出件待测；步骤见 skills/recovery-right-wbr7/WINDOWS-TEST.md。
Linux	无完整 wheel	不支持，入口退出 4。

• 解释器：仅 CPython 3.12 或 3.13。其他版本或实现时入口退出 4，不会改用别的 Python。
• 本仓库是插件广场试点候选，尚未经过市场审核（this is a pilot candidate that has not been through marketplace review）；除上表第一行外，不要把其余平台视为已验证。

English: first-round acceptance covers Apple Silicon only. Wheels for Intel Mac and Windows x64 are bundled, but native document production there is not yet tested. Linux has no complete wheel set and is unsupported. CPython 3.12 or 3.13 only.

安装 / Install

1. 使用独立的 DSH web profile。 新建一个专用于本插件的 profile，不要装进已有工作 profile。记下 DSH 版本号与机器架构（macOS 可用 uname -m，Windows 可用 echo %PROCESSOR_ARCHITECTURE%），反馈问题时一并提供。

2. 从 GitHub 源安装，并固定到完整的 40 位提交 SHA。 先把下面命令里的占位符 <40-HEX-COMMIT-SHA> 换成发布说明给出的完整提交 SHA（40 位十六进制），再执行；占位符原样执行不会成功。

   dsh plugin --profile web add 'github:Sven-Mirana/dsh-recovery-right-wbr7#<40-HEX-COMMIT-SHA>'
   

   • 单引号是必需的（# 之后的内容否则会被 shell 当作注释或特殊字符）；Windows PowerShell 同样支持单引号。
   • 不要使用分支名、标签或缩写 SHA。
   • --profile web 指向第 1 步的独立 web profile。命令行参数以 DSH CLI 官方参考为准：https://github.com/deepseek-ai/deepseek-harness/blob/master/apps/cli/reference/README.md。

3. 安装后技能根目录是 <插件安装目录>/skills/recovery-right-wbr7，下文记作 <技能根>。

4. 用包自带 CLI 完成 setup 与 doctor（<PY> 是 CPython 3.12 或 3.13 的解释器）：

   <PY> <技能根>/adapter/rr_host.py where
   <PY> <技能根>/adapter/rr_host.py setup
   <PY> <技能根>/adapter/rr_host.py doctor --verify-integrity
   

   where 中 platform_key 为 null 表示当前解释器或平台不在支持矩阵内。setup 只从包内 wheel 离线解包并逐文件核对 SHA-256：不使用 pip，不联网，不写入宿主 site-packages。

5. PDF 与页面图片需要外置渲染前提（DOCX 五门不需要）：

   • LibreOffice：自行从 https://www.libreoffice.org/download/ 安装到标准位置，或用环境变量 RR_HOST_SOFFICE 指向 soffice。作者实测版本 26.8.2。
   • 字体：macOS 使用系统自带 Songti SC / Heiti SC；Windows 需合法安装 仿宋_GB2312 与 黑体。本包不附带字体。
   • 检查：<PY> <技能根>/adapter/rr_host.py render-status。setup 通过不代表渲染就绪。

安装包展开后约 83 MB（主要是 17 个锁定 wheel）。

Install (English)

1. Use a separate DSH web profile dedicated to this plugin rather than an existing working profile. Note your DSH version and machine architecture (uname -m on macOS, echo %PROCESSOR_ARCHITECTURE% on Windows) and include them when reporting issues.

2. Install from the GitHub source pinned to a full 40-character commit SHA. First replace the placeholder <40-HEX-COMMIT-SHA> with the full commit SHA from the release notes, then run:

   dsh plugin --profile web add 'github:Sven-Mirana/dsh-recovery-right-wbr7#<40-HEX-COMMIT-SHA>'
   

   The single quotes are required; Windows PowerShell accepts single quotes as well. Do not use a branch name, a tag or an abbreviated SHA. See the DSH CLI reference: https://github.com/deepseek-ai/deepseek-harness/blob/master/apps/cli/reference/README.md.

3. The skill root is <plugin install dir>/skills/recovery-right-wbr7 (<skill-root> below). Run setup and doctor with the bundled CLI, where <PY> is a CPython 3.12 or 3.13 interpreter:

   <PY> <skill-root>/adapter/rr_host.py where
   <PY> <skill-root>/adapter/rr_host.py setup
   <PY> <skill-root>/adapter/rr_host.py doctor --verify-integrity
   

   setup unpacks only the wheels shipped in the package and checks every file against its SHA-256: no pip, no network, nothing written to the host site-packages. A platform_key of null in where means the interpreter or platform is outside the support matrix.

4. PDF and page-image export needs external prerequisites (the DOCX gates do not): install LibreOffice yourself from https://www.libreoffice.org/download/ or point RR_HOST_SOFFICE at soffice; fonts are the system Songti SC / Heiti SC on macOS, and 仿宋_GB2312 plus 黑体 (lawfully installed) on Windows. No fonts are bundled. Check with <PY> <skill-root>/adapter/rr_host.py render-status.

5. Uninstall: remove the plugin from that profile (or delete the dedicated profile), then delete the runtime directory and its sibling .deps and .lo-profile directories reported by where (by default under <home>/.recovery-right-runtime/).

写入位置 / Where files are written

内容	默认位置	覆盖方式
运行包	<用户目录>/.recovery-right-runtime/<树哈希前12位>	RR_HOST_RUNTIME_ROOT
受控依赖	<运行包目录>.deps/	RR_HOST_DEPS_ROOT
LibreOffice 专用配置	<运行包目录>.lo-profile	随运行包目录

实际路径以 where 的输出为准。插件入口本身只注册技能，不联网、不调用模型、不写文件。

使用 / Usage

在已加载本插件的 profile 中调用技能 recovery-right-wbr7。业务规则与质量门以技能自带的 SKILL.md 和运行包内文档为准。命令行等价入口：

<PY> <技能根>/adapter/rr_host.py deliver <盲稿md目录> <输出根目录>     # 五门 → 九 PDF → 全部页 PNG，首错即停
<PY> <技能根>/adapter/rr_host.py pipeline <盲稿md目录> <输出docx目录>  # 只做 DOCX 五门

退出码：0 通过；2 用法错误；3 质量门不通过；4 受控依赖、解释器/平台或 LibreOffice 不可用。非 0 时请按 RR-HOST / FAIL 行原文处理，不要靠删改正文或版式过门。案件材料与产物请放在插件目录之外。

卸载 / Uninstall

1. 在该 profile 中移除本插件（或直接删除这个专用 profile）。
2. 删除运行时目录：先运行 where 记下 runtime 与 deps，再删除运行包目录及同级的 .deps、.lo-profile 目录。默认都在 <用户目录>/.recovery-right-runtime/ 下；若设置过 RR_HOST_RUNTIME_ROOT / RR_HOST_DEPS_ROOT，删除对应目录。
3. LibreOffice 与字体是独立安装的，是否保留自行决定。输出目录中的文书不会被卸载动作删除。

仓库内容与完整性 / Contents and integrity

• lib/index.js、cordis.patch.yml、skills/** 与上游发行包 dsh-recovery-right-wbr7-3.1.3-wb-r7.tgz（SHA-256 061a4e75575c796a27ddfbd392f1f08081f194a98d0a762bb202c4fb935f5fb0）逐字节相同。
• 本仓库相对发行包只新增：README.md、根 LICENSE、THIRD-PARTY-NOTICES.md、locale/en.json、locale/zh.json、icon.svg、.gitattributes、tests/，以及 package.json 中的 files 项、exports 的 ./locale/*.json 映射和 repository、homepage 元数据。没有 lifecycle 脚本。
• .gitattributes 禁止换行转换，因为发行文件受 SHA-256 绑定；请勿在检出后改写这些文件。
• 自测（不安装依赖，不联网）：node tests/selftest.mjs <发行包tgz路径>；加 --setup 时会在临时目录内以独立的 RR_HOST_RUNTIME_ROOT / RR_HOST_DEPS_ROOT 运行 setup 与 doctor。

许可 / License

GPL-3.0-only，全文见 LICENSE。随包 wheel 的许可见 THIRD-PARTY-NOTICES.md；运行包内的 NOTICE 与 LICENSE-PROVENANCE.json 继续适用。