﻿京东商品链接与优惠券验证员工端
版本：0.3.18-internal-controlled

一、适用范围

1. 本版本按内部受控方式发布。0.3.18 沿用 0.3.17 已完成的 Windows 7 SP1 x64、Chrome 109 和 360 开启状态基线，新增无命令窗口的本机连接程序、明确的连接结果提示和真实版本上报；既有钉钉身份连接和京东任务规则保持不变。
2. Chrome/Edge 扩展与本机执行端通信。
3. 精确绑定员工已登录京东的浏览器 Profile。
4. 河源正式站已接入，员工点击“连接本机”自动完成设备连接，不输入绑定码。

二、内部受控发布说明

1. 本版本按负责人确认采用手动加载浏览器扩展，不通过 Chrome Web Store 或 Edge 扩展商店分发。
2. 当前版本未使用商业 Authenticode 公司代码签名，仅允许从公司正式员工页面下载并在公司内部电脑使用，不得对外转发。Windows 显示“未知发布者”时须核对下载来源和 SHA-256；安全软件拦截时必须停止安装并联系管理员，不得关闭防护或自行加入白名单。
3. 未经审核的真实京东领券规则不得进行真实点击。出现验证码、短信或风险验证时必须停止并由员工在京东官方页面处理。

三、安装顺序

1. 将整个员工端目录复制到 Windows 可写目录，不要放在临时文件夹。
2. 员工以本人 Windows 用户双击最外层“Install-Employee.cmd”。该入口由 Win7 兼容原生程序直接完成安装，不依赖 PowerShell、计划任务 XML、脚本目录变量或另外安装 Windows Management Framework；随后等待扩展接通，并使用登记的浏览器 Profile 打开文案系统。员工包的“App\config\deployment.json”已包含完整部署配置，不需要输入服务器、公钥、扩展 ID 或登录探测参数。遇到旧版计划任务组件时会自动改用当前用户开机自启兼容模式，不需要员工处理。
3. 如果尚未加载扩展，安装器会自动打开指定浏览器的扩展管理页和 extension 目录。在扩展页开启开发者模式，选择“加载已解压的扩展程序”，再选择已打开的 extension 目录，然后保留命令窗口等待自动继续。
4. 扩展测试 ID 已固定为 jpibmonipgnihhggooafjnpjjhlahjni，不需要员工抄写或输入扩展 ID。扩展修复收入“App\Employee-Maintenance.cmd”。
5. 确认员工已在目标浏览器 Profile 中自行登录京东。不得将密码、Cookie 或 Token 填入本软件。
6. 使用钉钉员工身份登录 `https://wenan.kaituo8.cn`，进入“03 商品验证”后点击“连接本机员工端”。浏览器首次会询问是否打开本机程序，员工确认一次后完成设备连接并立即启动常驻执行端。连接程序不打开命令窗口，会用本机提示框明确显示“连接成功”、“已连接”或失败原因。
7. 管理员可打开“App\Employee-Maintenance.cmd”选择“检查连接状态”；全部通过才显示“执行链路已就绪”。
8. 管理员在同一维护工具选择“导出报修文件”，由原生程序在 logs\acceptance 生成可发回的 ZIP。验收包只包含就绪状态、扩展通信状态和公网健康状态，不包含员工姓名、京东密码、Cookie、Token、设备令牌或私钥。

四、人工处理与自动继续

1. 出现京东未登录、验证码、短信验证或账号风险页时，程序保留原任务并在员工前端显示本人待处理事项。
2. 员工只在原京东任务页完成官方登录或安全验证；程序检测到恢复后自动继续，不得绕过平台验证。
3. 优惠券页要求移动端扫码时，程序自动跳过该优惠券步骤，记录 `QR_REQUIRED`，不计为验证通过。
4. 目标券无法唯一确认、商品 SKU 不一致或人工处理超过原任务截止时间时，必须安全结束对应操作，不得强制继续。

五、卸载

管理员打开“App\Employee-Maintenance.cmd”并选择“卸载员工端”。程序会先用本机设备签名向服务端登记撤销，服务端确认后才停止常驻进程和开机自启，并将旧设备配置、本地作业和浏览器活动记录归档到 backup，再解除 Native Messaging、清理旧版扩展策略和本机连接协议；安装配置、日志和历史备份继续保留。完成卸载后允许重新安装并建立新的设备身份。若存在已发送或待确认的真实领券动作，卸载会被拒绝并保留只读对账通道，完成对账后再卸载。
