Skip to content

About

智筛 Agent · HSD 图号助手 —— Windows 单机图片与 AI 设计文件对应编号工具:本机图像匹配、人工复核、非破坏性输出副本,不联网、无账号。

Topics

Resources

Stars

0 stars

Watchers

0 watching

Forks

Repository files navigation

HSD 图号助手

v1.28.6 已上线。图号近重复原稿转单项核对,素材精修失败保留原结果,云端为普通操作留出请求容量。上传或库选多张图案后,可逐张选择「主图」或「周围装饰」。14 种排法都支持在主图周围的可用空间放置装饰。丝带首稿默认直接用选中的图案和底图排版。主动开启 AI 搭配时,普通请求仅发送本地提取的配色和排版信息。明确选中并通过校验的案例可作为唯一的图片参考。AI 搭配遇到明确审核拒绝时,可在原草稿点击「改用本地合成」。详见项目进度。

v1.28.2 增加了草稿失效素材标识和恢复入口。Windows 和 Linux 各通过 248 项专项测试,线上通过同草稿更换素材并下载的检查。

v1.28.1 的任务恢复和资源可靠性变更,以及当时的完整测试,见质量收尾记录。

按用户要求移除丝带精修,页面只保留“选素材 → 排版与底图 → 生成 → 下载”。换素材或排版后可生成独立新作品,旧作品及历史下载在保留期内保持。素材提取的单图精修继续保留。v1.28.0移除记录及以下旧版精修描述保留为历史说明。

当前网站为 v1.28.6 / b9d27746(2026-11-09)。发布的三个附件已读回校验。打开丝带设计 · Linux Release

已整合 codex/ribbon-layout-understanding:新作品使用 v3 排版,补充散点、场景、边饰和分区行为,图案用途可明确选择;34张私有公司案例与公开程序演示分开呈现。历史作品继续使用原引擎和原下载。分支原始验证记录保留,不替代本轮整合验收。

已整合 codex/ribbon-background-refine 的原文执行契约:每条要求对应具体目标和操作,图片编辑保留原句,明确参数由程序核对。结果可展开查看本次要求;v3参数已应用不代表物理效果或图片语义已通过独立验证。原底纹专项记录保留为历史。

v1.26.3修复精修期间因云服务正常重启而反复要求登录的问题:同一服务器的有效登录可跨正常重启保持,八小时后仍须重新登录。首次升级仍需登录一次。短暂断线保留作品与输入;旧页面凭证安全更新,不重复提交已接受的精修。交付进度及验证边界见修复记录。

v1.26.0历史升级版本为 v1.26.0 / 2ac893a1(2026-11-06)。新版14种排法使用独立旋转、保持主辅比例的整组适配,以及真实可区分的三档密度;左右、上下和三段分区可分别选底纹,上下边饰可选完整边饰条。新作品继续下载一个循环PNG单元,原人物、文字、旧版本及下载均受保护。细节见排法合同。

丝带精修侧栏、修改输入、目标选择和次数提示已从新版工作台移除。历史版本可查看、下载和回退;新精修请求明确拒绝,不触发模型调用。需要不同效果时生成新作品,正式尺寸、原素材、归属及版本绑定下载规则保持。

v1.25.0 新建丝带作品改为循环短图:高度和DPI沿用内部规格,宽度按完整图案组和底纹周期自动计算。默认下载一个原尺寸PNG,可按需「查看连续效果」及接缝位置,不额外下载长条。两端、整幅和分区保留完整面板语义并显示说明;旧作品的长条、尺寸、版本和下载保持。底纹会实际修循环并做多尺度检查;问题保留提示,可更换或精修底纹,工程检查不代表印刷验收。已上线,实施和验证边界见循环短图记录和14排法说明。

丝带排版提供14种可生成的选择,原6种保留,另有上下边饰、组合循环、整幅定位、大小交替、两端留白、左右分区、上下分区、正倒交替。排版旁可点「查看案例」,13张公司例图配简单说明;查看不改变选择、不调用模型、不占精修次数。例图是教学参考,不会自动成为生产素材;完整场景/整幅造型需要自己提供完整素材。图片经登录接口从服务器私有目录读取,不随公开源码或Release分发。

图片与 AI 设计文件对应编号工具,支持 Windows 本机、局域网共享,以及独立启用的 Linux HTTPS 员工服务。用户确认的范围:固定 XLSX 模板 A 列编号/B 列图片;HSD + 四位新流水号;保留已有编号;只对成功匹配的空白编号行填号;疑难项人工复核;非破坏性输出副本。

管理员从“Key 账本 → 员工访问码 · 登录管理”进入访问码页面,可增加、停用或删除多个访问码。原有配置码继续有效;所有已启用的码都可登录员工入口,不能进入管理员分区,也不会共享不同浏览器的任务。新增码保存后不回显,重启后保留;停用只影响后续登录,已经登录的会话按原规则到期。功能已整合至v1.15.0,说明见 访问码功能验证。

v1.26.0历史交付:v1.26.0 / 2ac893a1(2026-11-06已上线)。打开网站,输入原访问码后新建作品测试新版;保留期内的旧版本继续使用原引擎和文件。Release及三份源码附件已发布。Windows全量3094项通过、56项跳过;Linux丝带相关813项通过,补充公共代码153项通过、2项跳过。真实图片验收4次请求中3次成功、1次被服务拒绝,拒绝未自动重试、未扣成功精修次数;另有3次文字规划成功。这是有限实测,不代表通用成功率或印刷质量。具体范围及50小时到期清理核对见本版验收记录。

v1.24.0修复两端主图比例和切换作品显示旧图,增加可恢复删除;更多排法在弹层选择,图库每页最多36项,精确相同上传复用。新首稿可启用“AI搭配底纹与装饰”,原人物和文字仍由程序原样排入;案例旁明确点击“用于AI首稿参考”后,生成时才发送该图给Seedream,普通查看不发送。取消AI可沿用所选底图直接合成。相关测试、实测范围和限制见工作台升级记录。

新建丝带作品按图案的可见内容计算大小与完整组循环,保持比例、文字和装饰;可选疏朗、均衡、饱满,默认均衡。勾选“柔和底纹,突出主图”会减轻背景干扰,取消可恢复原色。先选好完整设计,再选适合的排法:文字可用单排重复;组合循环第一张作主图、其余稍小;上下边饰需自行选入小配饰。旧作品继续原布局,要用新引擎请新建作品;已保存版本、正式下载和两次成功精修保持。微小调整若实际像素未变化,系统提示并不扣成功次数。样本对照、图库规律和限制见本轮设计质量记录。

v1.22.1 优化上传和图片浏览:丝带上传每成功一张即显示,失败保留已完成部分;素材库使用轻量预览,正式原图和下载不变。素材提取增删选图保留已有预览,图片校验和打包避免长时间占用其他员工的状态锁;相同结果重复下载复用已校验的 ZIP。修复上传写库失败的文件清理、动图静默变首帧、重做排队失败卡住等问题。逐项审查、受控前后数据和验证边界见质量与速度记录。

2026-11-02 17:22网站已更新为1.22.1+4fde97fe。Windows全量2657通过、56跳过;Linux首轮超时,重跑按用户要求停止,未完成完整验收。上线健康、配置保护及自制图片上传/原像素/缩略图/员工隔离检查通过;不将基础上线检查等同完整Linux验收。

丝带支持多图案上传/库选、14种候选排版、库选或AI底图、首稿、两次成功精修、父版本回退和指定版本PNG下载。当前管理页沿用DeepSeek+Seedream,保存配置不发出请求;OpenAI适配仍保留但当前页面不开放选择。云站内部来源配置为300DPI、RGB、11811×520px;v1.25.0新作品仅继承其高度、DPI等规格,实际循环宽度另存于版本。旧11811×520长条和2400×600演示配置保持历史原样。正式印刷效果需业务验收。完整说明见丝带使用与接入。

AI底图可输入具体要求,也可留空随机。DeepSeek根据文字、图案名称和顺序规划修改;Seedream生成底图或编辑独立图案/底图;程序合成原尺寸丝带并保存版本。当前不把图片发送给DeepSeek审图,也不让Seedream直接重画超范围的长条母版。没有模型配置仍可使用原素材生成首稿;明确的本地测试模式不当作真实模型结果。真实联调及验证边界见模型工作流记录。

v1.22.0已上线并发布版本附件:Windows/Linux相关回归各572通过、1跳过;自制图案完成4次真实模型请求、两次精修、回退和三版本原尺寸下载核对。模型仍会增加纹理或额外底纹,工程接通不等于印花、文字配色保真或无缝效果已通过业务验收。

v1.19.3 为质量审核版:修复素材任务卡住、精修期间同批不可下载、失败批次无法一键重试、上传后查询失败无法恢复等问题,新增未登录存活探针 /healthz、访问日志、只读健康检查、配置备份脚本与一分钟质量门禁 tools/quality_gate.py。清单见质量审核报告,线上状态见项目现状,运维操作见运维与备份。v1.19.4 把云端保留期从 3 天缩短为 50 小时(约两天),旧的未到期任务在升级时按新窗口重新计算。

流程为“导入 → 自动查找与核验 → 仅处理剩余疑难项 → 摘要确认并导出”。主机已启用 AI 且有可用 Key 时,DeepSeek 从完整的安全预览库查找对应图片,同时由本机独立匹配并核验;AI 关闭或无可用 Key 时沿用完整本机流程。可靠匹配由服务端按本机证据直接通过,不要求员工逐张查看;没有疑问项时直接进入摘要。模型的相同建议不等于自动通过,发布包不预置 AI 业务自动通过资格。v1.6.0 起不设表格、ZIP、HTTP 上传、单个 AI 与展开总量的固定字节上限及压缩比限制;实际容量仍受磁盘、内存和网络影响,保留文件数量、图像像素及归档有效性检查。

素材提取

员工选择或拖入PNG/JPG/WebP,开始提取后查看实时阶段、累计用时和已处理数量。每张原图仍先由Seedream清理、DeepSeek定位,再由Seedream逐个提取;密集设计使用放大局部参考,长条比例不合适时回退完整原图。保留完整输出画布和透明通道,不本地裁边、删白色内容或放大4096;仍最多8路、32MP参考预算。

结果卡片直接提供“下载、精修、舍弃”。生成结果无需先确认即可下载单张PNG或全部未舍弃素材ZIP。可下载只表示文件可获取,不代表已人工审核或画质合格;下载不写确认记录。舍弃只隐藏当前结果、不物理删除,可在“已舍弃”中恢复。图号助手原有审核及导出流程不变。

“精修”仅将当前这一张结果再交给已配置的Seedream一次,要求保持构图、人物、文字、配色和完整设计,提升清晰度和细腻程度,不加描边。精修不再清理整图、不调用DeepSeek定位,不自动重试或追加精修;默认提取也不自动精修。透明输入保留透明背景,不透明输入保持原背景。模型仍可能改变细节,不能保证恢复原图没有的内容。

成功后用新结果替换当前卡片,保持原位置并标记“已精修”;点击图片查看精修前后对比。保留直接前一版供对比,上传原图始终保留。精修失败、停止或提交异常保留旧结果供下载;计费状态未知时不盲重发,再次精修需明确确认。50 小时保留及任务归属、源图/输出完整性检查保持。

识别时一个不可用范围不会使其他可用范围全部失败;跳过数量在批次记录中说明。只有已确认返回、但定位判定失败时才自动再识别一次,第二次去掉坐标尺参考;未知计费不自动重发。失败原图的“自动重试”会重新执行这张原图的清理、识别与生成,可能再次产生调用费用。精修过程中保留结果列表与图片对照;正在精修的这一项暂不可下载,其余已完成且未舍弃的素材仍可下载。

列表使用640px轻量预览,放大和下载使用完整PNG,局部操作保留已有图片节点。常规说明默认折叠,真实问题仍可见;其他设计的失败记录集中在“本批记录与问题”。详情提示:“如需再次优化,可选择精修,或自行使用 GPT 图像模型处理。”这是员工自行处理建议,不会自动上传到GPT。

每批累计用时不因切换图片或阶段重置;已知本张设计总数时显示真实处理比例,不伪造模型内部进度。漏提取仍可从原图框选补提。Key由管理员在“Key账本”配置,员工无需配置;服务器暂存 50 小时(约两天),员工下载到自己电脑,不使用OSS。

效果边界: 所有生成及精修结果仍未取得独立画质资格。可直接下载不等于自动核验、生产合格或文字配色完全一致。本轮使用合成样例及模拟接口验证功能,不追加付费模型调用;真实效果由员工自测。

v1.12.0 Linux 云服务器网页

本节记录云服务的运行方式和隔离配置;证书、原站健康、真实上传下载、关闭与最终测试结果以 v1.12.0 云部署记录 中的实际验收为准。

员工打开 HTTPS 页面,输入管理员分发的员工访问码,上传自己电脑的 .xlsx 和 AI .zip,确认本批起始号;系统自动处理后只审核疑难项,确认摘要并下载 ZIP 到自己的电脑。原电脑文件保留,服务器不接 OSS,也不会把员工上传的原始文档发送给 DeepSeek。管理员统一管理云实例的 Key,员工不需要填写。

服务器会暂存每批上传、预览和输出。仅云模式在处理进入可审核、完成或失败状态后保留 50 小时(约两天);成功编辑、换候选或再次处理会刷新保留期。清理器约每分钟检查,只清本服务有签名登记、归属和路径验证通过的 uploads/、employee_outputs/、jobs/ 与 task_records/ 对应批次;素材提取使用独立的 material_tasks/ 签名记录及同样的 50 小时保留和活动保护。运行、排队、操作、预览或下载期间不清。下载完成不等于浏览器已落盘,不触发立即删除。签名异常、链接或无法确认归属的目录保守保留;停机时不运行清理,崩溃遗留运行任务在重启后重新开始保留期。清理不触及 Key、累计用量和 Windows/LAN 历史记录。

云入口与 Windows/LAN 入口分开。python -m hsd_tool.cloud_server 使用 Python 3.12 和单个 Gunicorn worker,不能用增加 worker、重载或多实例共享目录扩容。正常 TERM 收敛 HTTP 与已接受的后台工作并保存任务。云模式同版本重启后,持有原浏览器私有恢复 Cookie 的员工须重新输入访问码,才可恢复保留期内本人任务;中断任务明确报错,不自动重跑 AI。已完成结果仍经过输入/输出校验再下载。换浏览器、丢失 Cookie、超过 50 小时或版本/实现改变不提供旧批次恢复;升级前请完成并下载。v1.26.3起,登录会话仍最长八小时,同实例正常重启不再使其提前失效;首次迁移及主要凭据更换需要重新登录。

部署配置示例在 deploy/cloud.env.example、systemd 服务、专属挂载 和 Nginx 站点。这些模板不能直接覆盖原站配置;实际域名/IP、证书与端口需先核对。云入口只接收来自 loopback 代理、匹配公开 Host 和 HTTPS 协议的请求,代理必须覆盖客户端地址头。代理连接不提供主机权限,云端禁止文件选择、任意主机路径导入、打开结果目录、退出工具和旧主机设置接口。

配置 用途
HSD_PUBLIC_ORIGIN 精确 HTTPS 源地址,本次目标 https://39.106.45.116:8443
HSD_BIND_PORT 仅监听 loopback 的后台端口,默认 8830
HSD_DATA_DIR 专属挂载卷中的上传、缓存、结果和私有记录目录
HSD_SETTINGS_DIR 服务私有的加密设置与累计用量目录
HSD_CREDENTIAL_KEY_FILE 与设置目录分开的 32 字节 AES-256-GCM 机器私钥文件路径
HSD_EMPLOYEE_CODE_FILE 员工访问码文件路径,默认至少 16 位;不沿用公开的 LAN 默认码
HSD_EMPLOYEE_CODE_MIN_LENGTH 可选实例设置,默认 16;1–64 的整数,仅用于管理员明确选定的访问码
HSD_ADMIN_CREDENTIAL_FILE 独立云管理员账号与 PBKDF2 密码哈希文件路径;没有内置默认云口令

环境文件只写地址、路径和非敏感的实例长度设置,不写 API Key、密码或访问码。显式长度设置只影响当前实例,不改变可见字符检查、登录限流或管理权限。私钥和凭据文件由部署时创建,目录/文件归属服务用户、权限为 0700/0600;Linux 供应商 Key 用 AES-256-GCM 加密,不回退明文或仅会话保存。Windows 仍使用 DPAPI,原 Windows 密文不能直接复制到 Linux。只有已登录管理员可配置Key、使用DeepSeek账本或单独的火山方舟查看接口;员工和普通配置接口不返回密钥。新云主机不带 AI 业务自动通过资格,迁移部署不会扩大模型发送范围或放行条件。

同机原站 80/443、应用和数据库保持,新增独立用户、目录、Python 环境、systemd 服务及 HTTPS 8443 站点。已选资源隔离配置为:预分配 15 GiB 的独立 ext4 数据卷(2026-10-29 由 12 GiB 扩容)、CPU 配额 1 核、内存上限 2 GiB;挂载失败禁止服务回退写根盘。文件不设固定字节上限,但超过卷可用空间或内存能力仍会失败;这些配置不构成任意批次容量或速度承诺。Nginx 不缓存私有结果,关闭请求体缓冲,必要请求体临时文件落本项目卷中。

当前选择同 IP 不同端口,浏览器 Cookie 不按端口隔离;随机名称、HTTPS、HttpOnly、Origin 校验和服务端权限不等于完全 Cookie 隔离。用户已知此边界,后续应改独立域名。不要为本项目修改原站业务配置、数据库或对外入口。

v1.9.0 AI 查找与本机核验

启用主机现有 AI 开关即可采用新流程,员工无需额外选择模式或重新填写 Key。AI 请求保留全部符合条件的单画板候选预览,查询图片按组发送;长条图保留完整概览和覆盖全图的顺序分段。库过大而不能完整发送时,不截掉候选制造唯一答案,而是保留原因并由本机继续处理。文件名、目录顺序、行号和样本答案均不作为检索或通过依据。

本机独立验证不以 AI 建议缩小候选库,也不把模型的 same 变成本机强证据。图案、颜色、完整内容、竞争与文件归属仍按原条件验证;AI 与当前候选不一致时明确提示。模型失败、限流或无有效建议时,只保留有效的本机结果;本机核验失败或任何输入发生变化时不能用 AI 建议导出。并行阶段分别显示 AI 组数和本机图片数量,不合成为整批百分比;两路结束、重新校验后才公布最终结果。

剩余疑难项仍可按需补跑原有二次复核,资格及放行规则不变;全库查找与二次复核的用量分别展示。两种模型意见都不取代原文件、已有编号和导出校验。当前资格签名绑定 13 个模块,含 ai_first、appearance_cache 与 cancellation;旧资格不能沿用,也不据现有 60 图回归或合成控制声明通用准确率。10.12 批次留待后续,不用于本版验收。

本版真实执行结果、失败与验证边界见 v1.9.0 验收记录。此前实验中的模型检索时间不等于本版整批耗时,不把阶段相加或并行时间混报为员工整体提速。

v1.8.0 处理与下载

以下保留 v1.8.0 的历史实现和验收事实;当前流程以本页 v1.9.0 说明为准。

本版复用同一匹配任务中已按像素内容摘要、尺寸和处理参数绑定的尺度图、内容边界、颜色统计及粗搜索结果,减少精细验证的重复计算。临时复用数据有独立的实现版本与内存预算,任务结束即释放;不按文件名、大小或修改时间认定相同,也不跨任务复用旧 AI 意见。像素算术减少临时数组,只在已有条件足以否定候选时跳过不影响结论的昂贵计算;颜色、局部差异、完整覆盖、竞争判断与通过门槛保持。

CPU 匹配、AI 等待和导出使用独立调度:CPU 1 个 worker、AI 批次协调 2 个、全局 AI 案例 2 个、导出 1 个。只有候选集合不重叠的独立案例才并发,结果按稳定案例顺序校验和写回。Key 数量不增加并发额度;429 触发全池 60 秒冷却,已启动请求等待收敛,未启动的案例保留明确记录。本地可靠批次或 AI 关闭时不排在其他批次的模型等待之后。

下载 ZIP 和结果文件夹只包含“已编号AI”及唯一一份编号 Excel。对应关系、待处理清单、匹配依据、AI 计划与每次成功/失败尝试移入主机私有 task_records/<任务ID>/;正常退出清理临时缓存后仍保留,既不加入员工下载包,也不提供跨员工读取入口。未处理和跳过数量继续在摘要显示,表格原行保持原状;部分导出、摘要确认、源文件和完整性复验不变。

实测耗时、首次/重复处理口径、合成 AI 等待与验证限制见 v1.8.0 性能验收记录。实际 DeepSeek 等待与网络传输不能用合成延迟替代;本版没有调整模型、价格估算或图片发送范围。匹配与复核实现变化使旧资格按原规则失效,保留原有加密 Key 和设置。

后续隔离实验已真实测试 DeepSeek 从全 60 个候选中寻找对应关系:模型阶段三轮中位数 41.462 秒,另有 41.352 秒编码准备;第三轮出现映射偏离和归属冲突,合成歧义控制也出现错误的明确相同建议。实验不改变线上 v1.8.0 或自动通过资格,不给出整批提速百分比,详见 DeepSeek 全候选检索实验。

同机真实 60 图首次处理中位数 274.407 → 156.918 秒,重复处理 279.059 → 158.481 秒,全部 21 轮仍为 53 自动 / 7 人工,完整判定无回归差异。导出阶段中位数 32.842 → 17.759 秒,ZIP 增大 1.02%;六图合成批的两员工真实 HTTP 计算、导出及下载总墙钟中位数 54.408 → 24.023 秒。各数字范围不同,不相加为业务工时;没有真实 DeepSeek 提速或独立业务准确率结论。786 项 Python 测试、四份 Node 检查及实际 Windows 便携程序验收通过。

员工界面

  • 左侧「功能」栏固定列出全部功能:图号助手、素材提取;点击在同一页面切换并保留各自任务,窄屏自动变为横向标签。素材提取原顶部入口已移入侧栏。
  • 导入页为「左侧表单 + 右侧三步清单」布局:宽屏双列、窄屏自动堆叠;上传模式的表格与压缩包是拖放区,可拖入文件也可点击选择。本机模式另有文件夹与保存位置;模板、文件要求和原件保护说明集中在“文件要求与帮助”。
  • 上传显示实际上传进度,后台显示当前阶段及该阶段进度;排队显示位置,不把单阶段百分比当作整批百分比。
  • 有疑问时默认只列出需要处理的项目,状态行突出剩余数量。主区域用于图片对照和确认、换候选、跳过;长条图上下排列,可放大。全部结果、已完成及已跳过可按需查看。
  • 图号疑难项可打开“批量确认”,对照当前筛选中可处理的图片与候选,明确勾选后一次提交。默认不勾选;缺图、损坏、多画板、重复预览、文件或编号冲突仍需单独处理。整组成功才记为人工确认,整组可撤销,不改变自动通过条件。
  • AI 建议保留“需人工确认”标记;具体差异、文件异常及复核对象与当前选择不同的提示保持可见,完整复核说明与技术依据展开查看。
  • 摘要默认显示可导出、新增编号、未处理/跳过和结果获取方式,点击“确认并导出”即可;未完成行保持原状。通过方式分类和本批 AI 用量位于“处理详情”。完成页突出下载/打开结果和处理下一批。
  • 主机管理员从右上角“主机管理”进入独立“管理员分区 · DeepSeek”,管理 AI 开关和多个 Key;管理员页不再展示费用统计和实时调试;共享地址、访问码及退出工具仍在主机管理。员工端无这些管理权限,服务端同样拦截。

前后界面、交互测量与验证范围见 v1.5.0 界面验收记录。合成 UI 状态只验证展示与交互,不用于 AI 资格或匹配准确率验收;业务截图只保存在本机,不加入仓库或发布包。

Windows 运行与历史便携构建

Linux 服务使用上方独立云入口;下面保留远端 v1.11.0 的 Windows 源码运行与便携构建/验收命令模板,不表示本轮已构建或验证该 Windows 发布包。使用 Python 3.12;在项目目录执行:

py -3.12 -m venv .venv
.\.venv\Scripts\python.exe -m pip install -r requirements-dev.txt
.\.venv\Scripts\python.exe -m hsd_tool
.\.venv\Scripts\python.exe -m pytest tests -q
.\build.ps1

v1.11.0 便携构建输出位于 dist/v1.11.0/,解压发布包后双击其中的 exe。默认只监听 127.0.0.1,随机本地端口,界面资源均离线加载。局域网员工入口需要下文的显式启动参数。本机匹配无需联网;启用 DeepSeek 查找与复核时需要联网并产生 API 费用。无需安装 Illustrator 来读取已有 PDF 兼容预览;不能渲染的 AI 会明确列为异常。

便携包验收需要本机已有 测试样本/10月表格.xlsx 和 测试样本/10.10.zip,不会把它们加入发布包。先启动刚构建的 exe,使用独立数据目录并保持 AI 复核关闭;在另一 PowerShell 窗口运行验收:

& '.\dist\v1.11.0\HSD图号助手\HSD图号助手.exe' --no-browser --port 8804 --data-dir '.\tmp\v191_portable_data'
.\.venv\Scripts\python.exe tools\verify_portable.py http://127.0.0.1:8804 --bundle 'dist\v1.11.0\HSD图号助手' --data-dir tmp\v191_portable_data --work tmp\v191_packaged_validation
.\.venv\Scripts\python.exe tools\prepare_delivery.py --result 'tmp\v191_packaged_validation\验收结果.json' --notes 'tmp\v191_packaged_validation\验收说明.txt'

verify_portable.py 核对实际运行的冻结程序及构建指纹,用缺号副本验证编号、表格局部更新、原稿不变和导出 AI 的原始字节。prepare_delivery.py 需验收成功后运行;先根据真实验收结果编写 --notes 指定的说明文件。它会再次校验构建一致性,生成 交付/v1.11.0/ 下的 ZIP 和 SHA256。验收后若改动构建输入,应重新构建并验收。这组命令验证本机匹配与打包导出;新并行流程、真实接口与员工隔离须另行验收,不自动取得 AI 业务放行资格,不将合成结果冒充60张业务回归。

安装包与内网 AI 网关

远端 v1.11.0 保留 Windows 安装与绿色版构建说明;本轮未验证其安装包,不把该说明当作 v1.12.0 新 Windows 包的交付证明。历史附件以对应 Release 实际文件为准。Inno Setup 脚本默认按当前用户安装到 %LOCALAPPDATA%\Programs\HSD图号助手,无需管理员权限,包含开始菜单、可选桌面快捷方式和卸载入口;静默参数为 /VERYSILENT /SUPPRESSMSGBOXES /NORESTART。历史制作方式:

powershell -NoProfile -ExecutionPolicy Bypass -File .\build.ps1
& "$env:LOCALAPPDATA\Programs\Inno Setup 6\ISCC.exe" .\installer\HSD图号助手.iss

员工直接使用下方共享网页即可共用主机 Key,无需在员工电脑安装程序或复制加密配置。可选内网网关用于各电脑独立运行程序的另一种部署方式:DPAPI 密文不能跨电脑复用;已保存本机 Key 或 DEEPSEEK_API_KEY 优先于网关。当前共享网站继续使用原主机保存的 Key 直连供应商,未启用网关。

可选网关监听明确的内网 IPv4,使用 Bearer 令牌及体积检查,上游不跟随重定向;其代码及部署模板见下方文档。本轮审查发现全库查找的客户端工厂与网关 endpoint 参数尚不兼容,查找客户端仍固定官方地址,因此不可把该路径视为已验收。不要为共享网页另行启用网关;现用主机保存 Key 的路径不受此问题影响。

完整部署步骤、防火墙规则和排查表见 安装与内网网关部署。

局域网员工上传与下载

历史 Windows v1.10.1 员工入口为 192.168.0.156:8820,管理员登录入口为 /admin。当时实际 EXE、36 项生产输入、1216 个运行文件及线上静态资源已核对,原 2 个 DPAPI Key 继续共用,设置文件未改变;旧版 8819 留有一批未导出任务。旧会话不因 v1.12.0 云部署自动迁移。实际历史验收与限制见 v1.10.1 同步上线记录。

历史记录:v1.8.0 已在 http://192.168.0.106:8818/ 上线;实际 EXE、静态资源、原已保存且启用的 Key 复用及两个独立会话上传至下载已验证,设置文件未改变,仍为无业务资格的评估模式。防火墙仅开放当版 EXE、TCP 8818、192.168.0.106 与来源 192.168.0.0/24,旧 8816 服务未改动。详见 v1.8.0 上线验收记录。当时的本机 HTTP 测试不代表已从另一台实体电脑验证。

历史记录:2026-10-19 的 v1.7.0 员工入口为 http://192.168.0.106:8816/,管理员入口为同地址 /admin,当时由160地址改为106地址,使用独立任务目录并保留旧实例。这是旧版本上线事实,不代表当前新版已在该地址运行。

员工选择自己电脑上的 XLSX 和 AI ZIP,确认本批起始号,上传后自动处理;仅处理疑难项,确认摘要并导出后下载 ZIP。处理页可“停止本批”,等待后台确认后再处理下一批。已发送的 AI 请求不能保证撤销,停止不免除实际用量。上传响应中断先核对请求 ID,不重复启动整批;下载失败保留当前页面。云模式支持上文的同浏览器恢复,Windows/LAN 仍不提供重登或重启恢复;同浏览器多页面继续校验版本。管理员管理 Key 不意味着取得其他员工任务权限。

当前地址对应的员工服务参数模板(先填写实际输入、输出及原 AI 配置目录,不可原样执行;服务已运行时不要重复启动):

& '.\dist\v1.11.0\HSD图号助手\HSD图号助手.exe' --lan '192.168.0.156/24' --lan-input-root 'D:/主机测试素材' --lan-output-root 'D:/主机测试结果' --port 8820 --data-dir "$env:LOCALAPPDATA/HSD图片编号工具-员工服务-v110" --settings-dir 'D:/主机实际AI配置目录'

--settings-dir 必须指向原工具实际保存 DPAPI 配置的目录,并使用原 Windows 用户运行;不要新建同名空目录。Codex 与普通终端的 %LOCALAPPDATA% 可能映射不同位置,设置看似丢失时先核对实际目录,无需复制密钥。--data-dir 保存隔离的 uploads、jobs、employee_outputs 与持久私有 task_records,不进入 Git。两个主机兼容路径根须分开,输入根预先存在;员工不填写主机路径。

上传、单AI和展开总量没有固定字节/压缩比上限;仍保留实际磁盘、格式、归档有效性、每批1–500个AI、归档10000项、工作簿20000内部部件及图片4000万像素等检查。有限磁盘、内存、网络和队列仍影响可处理规模。

员工访问码在主机管理查看,可由启动参数指定;不要发送整个 instance.json 或密钥。普通员工只能访问自己的任务、预览、本批用量和结果。管理员使用独立账号登录,可在局域网管理共享 Key;员工访问码不授予管理员权限。后台累计账本和诊断不在简洁管理页展示,任务归属不因管理员登录而改变。

Windows 防火墙仅允许本版程序、指定接口/端口和来源子网:

New-NetFirewallRule -DisplayName 'HSD-Agent-v110-8820' -Direction Inbound -Action Allow -Protocol TCP -LocalAddress '192.168.0.156' -LocalPort 8820 -RemoteAddress '192.168.0.0/24' -Profile Any -Program 'D:\智筛Agent\dist\v1.11.0\HSD图号助手\HSD图号助手.exe'

防火墙规则只允许实际新版 exe、指定接口/端口及员工子网,不关闭防火墙、不映射公网。实际启动、防火墙与异机连通状态应分别核对,不能用本机 HTTP 检查代替第二台实体电脑验证。停止服务前先确认所有任务与下载完成。原始资料只上传到这台局域网主机,DeepSeek只接收已授权的查找/复核预览,不接收XLSX/ZIP/AI原件。

管理员分区:AI 开关与 API Key

打开 /admin 登录,或由主机从“主机管理”进入。左侧导航只有三项:Key 账本(DeepSeek、火山方舟、员工访问码配置及 Key 查看)、功能区(图号助手与素材提取入口)、帮助。DeepSeek 配置只有一份,图号助手与素材提取共用,改一次两边同时生效;素材清理的火山方舟配置从“Key 账本”进入独立页面 /admin/material;“功能区”素材入口直接进入使用界面。

批量输入每行一个 Key,最多100个,默认遮罩,可点击“显示/隐藏”核对,提交前立即清空;原有 Key 保留。支持标签、启停和删除,普通列表不回显 Key 或尾号;账本的显式例外见下文。保存成功不代表接口验证成功。Windows 逐 Key 用当前用户 DPAPI 加密;环境变量 Key 只能启停。处理中的任务仍禁止修改配置,其他页面先改会返回409,必须点击“刷新设置”核对,不能静默覆盖。

页面每30秒仅请求 Key 设置/状态,隐藏或离开后停止,返回时读取最新状态;不再请求调试与累计费用接口。后台刷新不禁用正在输入的控件,也不替换标签输入和删除确认;遇到配置冲突保留编辑现场,等待显式刷新。

每次新的 AI 请求从当前可用的 Key 中等概率随机选择,所有员工共用;不按添加顺序轮流,也不固定分配给某位员工。连续请求可以选中同一个 Key,短时间内不保证每个 Key 使用次数相等;停用、暂停、冷却或本次重试已排除的 Key 不参与选择。

认证/余额异常会暂停 Key,修复后可先停用再启用;网络/服务故障按原 Key 重试,每组/案例总尝试最多2次。429继续触发全池60秒冷却,多 Key 不扩大官方额度,也不增加现有并发量。后台累计用量、脱敏诊断及任务私有完整记录仍保留,模型请求、匹配和导出规则均未改变。Key 分配实现纳入原有资格签名,切换实现后旧 AI 条件自动通过资格失效,须按原流程重新验证;不会自动激活。

进入 /admin 先要用管理员账号登录。Windows/LAN 沿用原管理员账号;云实例使用部署时私有凭据文件里的独立账号与密码哈希,不提供内置默认云口令。密码由管理员保管,仓库、文档和发布包都不记录明文。未登录时 /admin 只显示登录表单,/api/admin/* 返回 401;登录会话最长 8 小时,服务重启后失效;同一地址 60 秒内连续 10 次失败会被暂时拒绝。页面右上角有“退出登录”。

管理员可以在局域网内其他电脑打开同一批设置:主机以 --lan 启动并保持运行,其他电脑浏览器访问 http://主机IP:端口/admin,输入账号密码即可看到同一批 Key、标签和开关,不需要员工访问码。管理员数据始终保存在那台主机上,请统一使用主机地址,不要打开各台电脑本机的 /admin(那是本机独立的数据)。主机专属操作——选择文件、打开结果目录、退出工具——仍只允许在主机本机执行。管理员页面与登录走明文 HTTP,只应在可信内网使用。

页面底部“查看或复制 Key”默认收起,展开才从 /api/admin/ledger 获取明文与标签;默认遮罩,可显示或复制。收起、退出、登录失效和离开页面均销毁账本内容;退出失败不会显示为成功退出。账本受登录会话限制、响应 no-store、不写日志;显示后的截图、录屏或旁观仍会暴露密钥。火山方舟Key使用独立的按需查看/复制入口,不混入此账本;其他普通接口及员工端不回显Key。

Windows v1.10.1 历史验证见 同步上线记录;历史界面验证见 v1.9.1 管理页验收记录。这些记录不代替本次 Linux 云服务的上线验收。

DeepSeek 设置与数据范围

  1. 由主机管理员展开右上角“主机管理”,进入“管理员分区 · DeepSeek”,批量添加Key并保存 AI 开关;员工浏览器沿用主机设置,不需要填写。
  2. 普通 Key 列表仅显示标签和状态;已登录管理员的独立账本允许显示和复制密钥。批量输入在提交前清空,清空输入不删除已有 Key。Windows 使用当前用户 DPAPI 加密保存,不写入日志、导出结果或 Git;保存成功不表示接口已验证可用。
  3. 导入后自动进行全库 AI 查找与本机独立核验;没有可用 Key 或开关关闭时执行完整本机匹配。资格提示仅约束模型意见能否条件通过,不影响本机证据完整的直接通过。
  4. 只处理剩余疑难项,查看查找建议、当前候选与本机原因,再确认或跳过;如页面提供“对此批运行 AI 复核”,可以按需补跑原二次复核。两种用量分开。请求失败、额度不足、限流、网络异常或响应无效不抹掉有效本机结果,也不把模型建议当作已确认。

模型固定为 deepseek-flash,仅由运行工具的主机后端调用 DeepSeek。全库查找发送可处理的表格图片、全部安全单画板候选预览、完整概览和覆盖全图的长条顺序分段,使用每次任务随机映射并独立打乱的匿名 ID;查询分组不删减候选库,不提供文件名、行号或旧匹配答案。按需二次复核继续发送真实可信竞争候选,有可验证几何时附同尺度对照与覆盖位置图;该旧复核路径超过五个可信竞争候选仍交人工。原始 XLSX、ZIP、AI 文件以及本机文件路径不发送给 DeepSeek;局域网上传到主机是另一条数据路径。图片中本来包含的文字仍属于图片内容,会随预览发送并被当作数据而非指令。

重复预览、文件归属或编号冲突、损坏/无法读取的预览、多画板等硬异常不能交模型解除;不安全的候选不进入全库查找。无可信候选、关键细节不清楚、本地颜色/内容矛盾或模型改选不能凭 AI 意见放行。独立本机核验支持的另一候选仍以其自身证据决定状态,并明确展示与 AI 的不一致。源文件或比较图片变化使旧结果无效,须重新导入。关闭 AI 后继续使用纯本机流程。开发者可通过 DEEPSEEK_API_KEY 环境变量提供密钥,本机保存的密钥优先;清除本机密钥不会删除环境变量。

管理员分区已移除费用估算界面,后台继续保留累计账本;员工的“处理详情”仍只显示本批用量。按已知 token 用量和程序记录的峰值单价,以 USD 保守估算,不是账单,实际费用以 DeepSeek 账单为准。请求用量未知时会单独提示次数,费用统计不完整,不将未知费用记作零。本版不设置费用上限或达到某金额后自动停止的开关。

价格依据于 2026-10-15 核对的 DeepSeek 官方价格表:deepseek-flash 峰值价格为每百万输入 token 缓存命中 US$0.006、缓存未命中 US$0.30,每百万输出 token US$1.20。本工具统一用峰值单价估算,不推测实际调用时段折扣;价格可能调整,估算不替代账单。

模块

  • workbook.py:流式读取 WPS 图片与行号,ZIP/XML 定点更新空白编号,不经普通表格引擎重保存。
  • matching.py / matching_verification.py:安全读取 AI 文件夹/ZIP,渲染预览;通过几何、像素、颜色、实测周期及完整内容覆盖等证据核验,记录两条通道各自的依据。
  • ai_policy.py / ai_images.py / ai_client.py:复核资格、预览与完整分段、后台 DeepSeek 请求及结构化响应校验。
  • ai_first.py:匿名全库预览检索、严格解析候选建议及独立用量/完整尝试记录,不改变匹配或编号状态。
  • ai_settings.py / ai_usage.py / ai_registry.py / ai_workflow.py:加密设置、用量记录、限定场景验证资格与后台任务。
  • service.py:任务状态、编号规划、人工确认、文件校验、事务式导出。
  • server.py / uploads.py:本机/受限局域网接口、员工上传与任务归属、结果下载、主机原生文件选择窗口。
  • gateway.py:内网 AI 网关,持有唯一一份 Key,校验客户端令牌后转发查找与复核请求。
  • admin_auth.py:管理员分区的账号口令校验、会话有效期与登录限速。
  • static/:中文导入、复核、导出界面。

编号与文件名冲突采用保守处理,不覆盖原件。新编号只规避当前表格中的已用号;跨批次起始号由员工确认。缺图和跳过行不会分配新号。输出保留完整工作簿,其余 XLSX 内部部件原字节复制。

匹配与自动通过

历史 v1.3.0 从正式 v1.2.0 的 44 自动 / 16 人工基线实施通用优化,未混入本机另一份未发布的 47 自动 / 13 人工开发稿。当前仍不使用文件名、行号、目录顺序或旧核验答案作为生产依据。

自动通过不是单一分数阈值,而是多证据交叉验证的结果:

  • 几何通道:保留特征点、仿射与内部像素检查;对插值保护区排除的薄边缘,独立验证两侧真实像素后才计入覆盖。
  • 纹样通道:先粗筛,再用较高分辨率和细尺度/相位检查。像素误差、变化面积、最差区域、颜色及完整原稿覆盖必须一起通过,不直接降低门槛。
  • 完整内容:匹配的局部不能代表整份原稿。只有实测成立的周期才能解释重复区域,新增图案、颜色或实心局部差异仍阻断通过。
  • 唯一性与归属:完整比较所有原稿,真正接近的竞争候选保留人工;仅共享局部图案的弱候选不抢占可靠对应,也不按排除法分配剩余文件。

阈值由像素误差的物理含义与正例、易混淆反例的实测间隔确定,不针对某批样本调参,也不使用文件名、行号或样本答案作为匹配依据。

AI 的“相同”意见不等于通过。全库查找协议只返回候选建议,不提供自动通过资格;本版自动通过来自独立本机核验。按需二次复核仍使用 v2 逐候选协议,要求每个候选独立回答,当前候选的差异不能写成其他候选的差异;漏项、虚构候选、检查项与结论矛盾都不放行。只有相应场景取得有效独立业务资格且全部条件通过时,该旧复核路径才可能条件自动通过。本版不预置、不新增激活;签名现绑定 13 个模块,旧实现资格失效。模型自报置信度不参与放行,不能用改选建议补齐缺失证据或解除冲突。

摘要的“处理详情”分别显示本机自动、AI 条件通过与员工确认。接口的 stats.auto 包含前两者,stats.ai_auto 是其中 AI 条件通过的子集,不能相加重复统计,也不能把自动结果称为人工确认。

AI 评估与资格激活

开发者先用合成图验证接口、错误降级与反例边界,再用未参与调试的独立业务留出批次验证。标签应在查看模型输出前独立冻结,不能使用模型自己的判断作为答案;所有计划案例及失败都要保留。现有 60 张业务回归映射只用于历史回归,不能充当新的独立业务验证。

以下命令使用本机已经保存的设置,不接受命令行密钥。准备合成图和标签,不调用 API:

.\.venv\Scripts\python.exe tools\run_ai_evaluation.py --synthetic --out tmp\deepseek_prepare_01 --settings-dir "$env:LOCALAPPDATA\HSD图片编号工具" --prepare-only

真实合成评估使用另一个空目录并去掉 --prepare-only;会发送生成的测试预览并产生费用。程序输出标签、完整调用记录和摘要,不会激活业务自动通过。合成测试结果仅证明该批测试的表现,不代表真实业务准确率。

.\.venv\Scripts\python.exe tools\run_ai_evaluation.py --synthetic --out tmp\deepseek_live_01 --settings-dir "$env:LOCALAPPDATA\HSD图片编号工具"

对独立人工标签与真实调用记录进行本机验证,不再调用 API:

.\.venv\Scripts\python.exe tools\validate_ai_review.py --labels tmp\business_holdout\labels.json --observations tmp\business_holdout\observations.json --output tmp\business_holdout\validation-report.json

每个可激活类别必须有至少两个独立留出批次,包含人工独立核验的真实业务批次;每批均有正例、反例/不确定例和实际通过的正确正例。合计至少两个有效正例、五个反例,覆盖颜色变化、局部替换、额外内容、局部相同和近重复五类,并且全部记录中零错误自动通过。脚本会验证真实调用、实际模型、案例与图片/候选/源文件指纹,拒绝遗漏失败、重复分组或混用模型的记录。

审核达标报告后,给同一验证命令显式添加 --activate --data-dir "$env:LOCALAPPDATA\HSD图片编号工具",才会在指定工具数据目录签名保存资格。仅 synthetic_known_truth 合成标签或 reference_map 历史映射不能激活;不得改写来源标签绕过要求。资格仅覆盖通过的模型和类别,7 天后到期;提示词/协议或相关复核实现变化后失效,实际模型不匹配时不放行。失效后回到评估建议与人工确认。具体数据契约见 CONTRACTS.md。

开发验证

v1.5.0 上线后另通过实际8815服务验收:两个独立浏览器会话的合成上传,各1张自动通过、0次人工确认,导出HSD0007/HSD0031并下载,ZIP完整性、AI原字节、WPS非目标内容及10次跨会话404均通过,10.672秒。此运行共用实际已启用的AI配置,原有57次累计记录在验收前后保持,没有新增API调用;不同于先前独立关闭AI配置的便携验收,也不构成新的DeepSeek真实接口验证。入口与目录映射排查见上文;实际报告及截图仅保存在本机。

v1.5.0 本轮只验收界面与交互,当前已通过三份 Node 断言(AI 展示、员工上传下载 UI、交互不变量)及 5 项合成 UI fixture 测试。覆盖仅疑难项、自动直摘要、分类统计不重复、候选局部更新、焦点/展开/滚动保持、搜索防抖、保存失败重试、409 冲突、跳过撤销、任务缓存边界和失效会话停止轮询。它们是纯 DOM/模拟接口验证,不代表实际浏览器耗时、另一台电脑连通或 AI 业务验证;完整检查及实际打包结果见 本轮验收记录。

以下保留历史版本的原始验证范围:

v1.4.0 员工上传下载升级:全套507项测试通过,最后调整LAN图片缓存后143项LAN/员工API复测通过;员工与AI前端断言和脚本语法检查通过。tools/verify_employee_portable.py 用实际冻结程序的局域网HTTP接口模拟两个独立浏览器会话:同名文件上传后分别自动匹配、确认摘要并下载HSD0007/HSD0031,10次跨会话任务/图片/下载访问均404,ZIP完整性、AI原字节、WPS非目标部件及原输入保护均通过。耗时11.187秒,AI请求0;此为合成图流程验收,不是业务准确率验证,也不是第二台实体电脑连通测试。8807员工实例已运行并复用主机保存且启用的AI配置,旧8805实例保留原任务。

历史 Windows 便携程序可按以下模板重复验收;示例保留远端 v1.11.0 路径,不表示本轮已交付新 Windows 包。--work 指定新的空目录,并填写待测包的实际路径、主机地址与空闲端口;工具只生成合成图和专用关闭AI的设置,不使用主机密钥:

.\.venv\Scripts\python.exe tools\verify_employee_portable.py --exe 'dist/v1.11.0/HSD图号助手/HSD图号助手.exe' --host '<主机当前IPv4>' --prefix 24 --port 8808 --work tmp/employee_portable_new

v1.3.1 局域网升级:全套416项测试通过,随后新增1项访问码隔离测试,并复测88项局域网测试通过,共覆盖417个不同用例。局域网测试包括认证、会话过期、Host/Origin/CSRF、目录与链接边界、管理权限和共享任务版本冲突。两份前端脚本语法检查及AI渲染断言通过。Windows便携程序已通过指定局域网接口启动和合成图片“导入→自动匹配→摘要→编号导出”的实际流程检查,原始合成输入与导出AI哈希核对通过。当前主机保存的AI设置保持启用且已配置,本次验证未调用DeepSeek。尚未在另一台物理电脑上验证连通,也未新增业务准确率或自动通过量结论。

v1.3.0 在正式 v1.2.0 基线上完成通用证据优化,冻结实现后再运行同一份原始60张输入:

指标 v1.2.0 v1.3.0
本地自动通过 44 53
仍需人工判断 16 7
无候选 0 0
AI 新增自动 0 0
自动项对旧参考映射偏离 0 0

原16张中12张通过新增证据直接自动:3张独立几何边缘验证、9张高精度/周期与完整原稿纹样验证。原自动项另有3张因未解释实心区域或高精度变化面积尚未通过而转回人工,净少审9张。剩余7张包括前景色差、圆点/条纹像素及完整内容验证不足;没有以改标签或确认按钮计入提升。已有映射只是回归核验,不能证明业务整体准确率。

另在开发前冻结了两批合成控制,共44案例/46行,14正例、32禁止自动项。旧版12自动中有3项错误,新版9自动中错误0;原9个正确自动均保留,5个正例仍人工,未新增正例自动。该控制集证明安全缺口修补与原正确自动保持,未证明未见图案的自动覆盖量提高。输入、标签及运行前后实现哈希均复核一致,未对照控制答案修改实现。工具为 tools/validate_matching_generalization.py,业务输入与冻结结果不进Git。

全套350项测试通过,随后新增1项调用中实现变更检查及相关10项复测通过(共351个不同用例已覆盖);服务端最终原因说明调整后37项服务/AI导出测试复测通过,另有纯Node渲染断言和两份JS语法检查。匹配专项51项通过。最终Windows便携程序启动/依赖自检通过,五模块源代码与冻结实现签名一致;60张仍为53自动/7人工,两个缺号格正确生成,原稿SHA256与WPS其他工作簿字节保持。验收不需人工确认任何匹配,不将缺号副本导出计为新的自动提升。

v2真实接口合成协议检查14例全部成功:4正例中3个严格同图,10反例中0个严格同图;已知用量峰值估算US$0.00862464,非账单,AI生产自动放行0。该次协议观察发生在调用时实现签名强制项补全前,记录原样保留,不能补签激活;最终签名记录结构另经无调用准备和自动测试验证。它不是独立人工业务验收。

源代码60张回归导入4.467秒、匹配288.753秒;最终便携导入4.753秒、匹配275.778秒、自动处理282.060秒、导出7.179秒。46行控制21.704→66.231秒。新增完整性和较高分辨率验证增加计算成本,没有宣称算法提速;源回归运行时还有其他检查,不与旧版直接推算性能倍数。员工实际审核耗时未测,不能据图片张数推算整批节省时间。新业务批次由员工试用并核对,10.12继续保留到后续。

本轮浏览器自动审批因URL策略拒绝本机页面读取,未尝试其他浏览器或绕过;最终页面未做实时视觉验收。API、服务和纯JS逻辑检查不代替实际窗口/按钮位置的视觉验证。

以下是历史版本记录:

v1.2.0 本轮实测:263 项自动测试通过;最终 Windows 便携程序启动、依赖与源码/冻结实现指纹自检通过,60 张回归和无损导出校验通过。正式基线与升级后均为 44 自动 / 16 人工,AI 新增自动 0。16 项真实 DeepSeek 请求全部成功,模型判断相同 1、不确定 2、不同 13;这些意见不是独立核验答案。本轮没有减少必须人工判断的图片数量,业务自动通过资格未激活。

便携版本轮导入 9.701 秒、本机匹配 228.465 秒、AI 复核 122.908 秒,总自动处理 361.081 秒,导出 9.971 秒;运行期间另有自动测试,不能用于宣称性能提升。员工真实审核耗时未测。本批已知用量按峰值估算 US$0.0215811,非账单。便携导出验收单独清空表格副本的两个编号格,并人工确认一项来验证新增编号,不计为自动通过提升。原始输入、导出 AI 原稿、两格编号和其他工作簿字节均独立核验。

浏览器已跑通可靠批次直达摘要、歧义确认、跳过、撤销和部分导出。随后更新了面板布局与仅剩无法处理项时的摘要跳转;最后一次布局尺寸复测因浏览器控制连接超时未完成,不能将最终按钮位置称为已实测。现有 60 张的参考映射不代表独立业务准确率,未使用留待后续验证的 10.12 批次。

自动测试覆盖编号边界、重复归属、恶意/异常路径、源文件变化、无损导出、WPS 图像保留、图像匹配、长条与重复纹样、缩放与画板留白、局部改动与颜色改动等场景。真实样本是用户提供的测试资料,不放入发布包。

v1.1.1 本机验收:自动测试 69 项通过、1 项跳过(缺业务样本);合成场景 11 项正例全部自动通过、3 项易混淆反例全部转人工;端到端(合成样本)跑通导入 → 自动匹配 → 摘要 → 导出。

v1.2.0 真实 DeepSeek API 合成评估(2026-10-15,两个不同种子批次,共 14 例):4 个正例中,3 例给出明确 same,1 例为 uncertain;10 个反例中,严格 same 为 0。“严格 same”要求候选有效、五项核验均为 true 且无差异,不能只看一个相同标签。这是已知真值合成图的有限测试;本轮没有生产自动放行,不构成独立人工业务验证资格,也不据此推算真实业务准确率或审核数量下降。

历史 60 张真实业务样本实测(同一份输入,同一台机器;本次 AI 复核不据此宣称提升):

指标 v1.0.0 v1.1.1
自动通过 33 44
人工审核 27 16
无候选 0 0
自动通过错误 0 0

自动通过的错误数用仓库已有的样本核验映射逐行比对,两侧都是 0; 60 行的第一候选也都命中该映射。两版的映射只用于核验,不参与产品匹配。

仓库不包含业务样本,没有本地样本时相关实物样本测试会跳过,其余测试使用程序生成的数据。相似度是外观接近程度,不是准确率。

使用 --no-browser --port 8787 --data-dir <独立测试目录> 启动测试实例。开发服务器与发布版使用同一业务逻辑。

本机数据

以下恢复限制适用于 Windows/LAN;Linux 云模式以本页上文的 v1.13.0 私有恢复策略为准。默认本机设置、加密密钥、用量、验证资格、日志、临时图片和 AI 提取文件保存在 %LOCALAPPDATA%/HSD图片编号工具。员工服务使用独立 --data-dir 保存上传副本、任务与结果,--settings-dir 复用主机的 AI 设置、用量及资格。jobs 中的临时匹配素材可清理,task_records 中的私有对应关系、待处理清单、匹配依据及 AI 尝试记录在正常退出后保留;这些文件不加入下载包或发布包,也不等于任务可以恢复。任务仅在本次进程内管理,同一有效浏览器会话刷新可恢复自己的任务;更换浏览器、重新登录或服务退出后无法找回任务下载入口。请及时下载并妥善保存结果;主机上的上传副本和结果由管理员另行管理,不能将任务缓存清理理解为上传原稿已全部删除。本机路径模式仍输出到员工指定位置,原件不改。仍不包含员工账号、统一号码库或后台收件功能。业务预览、调用记录、验证标签、密钥与资格文件不进入 Git 或发布包。

版本保存

本仓库是后续修改的版本记录来源。完成修改后运行相关检查、提交并推送到 GitHub;可交付版本添加版本标签,并将 Windows 程序上传到对应 Release。源码进入 Git,业务样本、导出结果、缓存和本地环境不进入 Git。

仓库原有提交历史保留;从 v1.0.0 开始用于当前图片编号工具。后续协作约定见 AGENTS.md。

v1.6.0 大文件处理

上传通过认证后直接写入本批隔离目录并同步计算 SHA256,避免先落系统临时文件再整份复制。入队后复用可信接收哈希,仍独立校验表格快照、扫描后的源 ZIP 和导出前后的原件。AI 预览按文件路径读取,工作簿图片及非目标部件使用固定缓冲流式处理;目标工作表仍按原方式定点修改。下载打包逐字节校验输出,复用已独立验证的 AI 副本哈希,减少一遍读取。具体实测与边界见 v1.6.0 验收记录。

本次实现签名包含新增归档读取模块,旧 AI 自动通过资格按原规则失效,仍需当前实现的正式验证;已保存的 Key 与设置保留,不扩大原稿向 DeepSeek 发送范围。

About

智筛 Agent · HSD 图号助手 —— Windows 单机图片与 AI 设计文件对应编号工具:本机图像匹配、人工复核、非破坏性输出副本,不联网、无账号。

Topics

Resources

Stars

0 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages