> **说明：本文是历史累积的版本说明，按时间倒序记录，不随代码更新而回改。** > > 文中提到的宿主版本、扩展版本、基线哈希都以**当时**为准，**不代表当前状态**。判断当前兼容基线请只看： > - `assets/native-desktop/host-baseline.json` → 当前为 DSH Desktop **`2.0.18-beta.1`** > - `package.json` → `dsh.compatibility.dsh` > - 逐条改动摘要见 [CHANGELOG.md](../CHANGELOG.md) > > 因此像「已验证 DSH Desktop Beta 2.0.17-beta.2」这类旧条目属于历史事实，和当前基线不同是正常的。 ## 当前版本 0.1.49 商品浏览器移除详情存档、专注浏览按钮。网址栏、打开网页、重新加载合并到商品浏览器标题右侧，窄面板在同一标题区内自动换行，地址输入和回车打开仍沿用原逻辑。 日间使用雾白冰蓝、远景层次、柔和玻璃高光及阴影；夜间使用深青黑与青色微光，统一面板、输入框、文件管理、采集状态、设置及Agent区域的主题。日夜切换继续记住用户选择。此次仅修改前端，兼容已运行的0.1.48后台。 ## 当前版本 0.1.48 新产出集中到outputs/YYYY-MM-DD/品牌-序号，例如2026-10-27/顾家家居-01。单件商品的主图、细节图、JSON、详情原图、规格PNG和可编辑PPTX在同一商品目录内。再次采集同一商品会分配新的序号，保留原文件夹。每日CSV仍位于日期目录；整理已有文件时先校验、备份，再同步文件索引及汇总表的归档路径。文件管理按日期、商品文件夹分组，原有下载、改名、定位继续可用。 设置新增三种图片处理方式：无、云端模型、本地ComfyUI。无只关闭图片编辑，保留官方原图及视角；商品资料识别继续运行。云端支持阿里云百炼及OpenAI兼容图片编辑接口，需填写HTTPS服务URL、模型名、API密钥；旧阿里云配置自动沿用。密钥仅由后台保存在本机，不回传前端；留空保留已有密钥。本地ComfyUI需填写本机或局域网监听地址，默认http://127.0.0.1:8188，可检查连接；当前使用标准图生图节点及已安装的Checkpoint模型，须先运行ComfyUI并安装对应模型，不自动下载模型或安装节点。所有编辑结果都通过DSH图片路由核对，外观不一致则保留原图。 选片逐批保存已确认图片与回执，后续失败不会丢掉先前已核对的部件。优先核对详情部件，合格三分之四视角主图和两个独立部位齐全即可结束选片，减少无效模型请求。桌面补救使用完整页面信息确认SKU；不足单品时间预算时明确说明，仍按已有资料出卡。 ## 当前版本 0.1.47 单个商品处理上限不超过30分钟，包含预读取、图片处理、补救和归档，不是整个批次的总时限。最后预留1分钟用于本地出卡。 处理失败后记录真实原因；适合桌面处理的页面或选图问题由后台使用DSH已安装的mcp__wincu__windows_computer_use工具组尝试，最多2轮且累计最多10分钟，并受本商品剩余时间约束。工具、诊断或验证卡住也按时结束补救。只处理可确认属于本SKU的商品资料页面。 补救失败仍用本次已取得资料自动生成PNG和可编辑PPTX，清楚标明缺项及原失败原因；缺图使用“未取得”占位，不用重复主图裁切冒充细节。状态显示补救已用时、截止时间及已尝试轮数，批次数量中另列不完整出卡。普通失败出卡后按5分钟间隔继续；登录、验证、权限或平台限制时本地出卡后停止访问；用户主动停止时不再出卡。 ## 当前版本 0.1.46 后续采集的产出按北京时间保存到.sofa-monitor/outputs/YYYY-MM-DD。每日目录包含规格PNG、可编辑PPTX、主图、商品资料文件、当日汇总和采集资料子目录。跨日再次采集同一商品会保留前一天的文件；插件文件管理可按日期筛选，历史文件可下载、改名、定位。旧files与exports文件保持原位置。自定义归档位置也按日期保存采集归档。 安装备份位于.sofa-monitor/backups/install/YYYY-MM-DD，不再散落profile根目录。旧.sofa-monitor-install-backup-*为配置回退备份，可清理较早版本，建议保留最近两份。不要整夹删除.sofa-monitor、node_modules或DSH配置文件。PNG/PPTX成品可按需删除，但删除主图/原始资料会影响后续重新生成、核对和本地恢复。 ## 当前版本 0.1.45 文件管理提供图片列表、PPTX列表和图片缩略图。新规格卡自动同时保存PNG与可编辑PPTX，文字与图片可分别修改。旧PNG可在图片列表点击PPTX转换，PPTX列表支持下载、改名与定位。默认命名沿用品牌-型号-产品规格卡，扩展名为.pptx。 批次状态下方显示总用时，包含5分钟间隔，结束后保持不变。细节照片区域高度和卖点条目间距分别增加10%。网址栏预填京东首页，点击打开网页后访问，打开插件不自动连接助手。 ## 当前版本 0.1.44 保留0.1.43的失败隔离、逐图补核、5分钟默认间隔；修复任务标签页后台运行及先等后滚导致的详情模块加载超时。采集由用户启动时才打开可见任务页，打开工作台仍不自动连接助手。 ## 当前版本 0.1.43 批量默认间隔5分钟，每批最多10条。单品图片核对失败会保留阶段资料、计入失败并继续下一候选，不会把未核对的图片当成已完成；多图漏报确认最多拆成单图本地补核一次。真实权限、登录、模型路由不可用或平台访问限制仍停止批次。 ## 0.1.34 真实详情与语义选图 修复京东CSS背景详情图漏读和GIF下载不支持。最多保存64张详情原图，逐张读取图文与尺寸；GIF保留原动画并明确模型核对首帧。正式自动流程新增模型选片：读取主图区与详情图、挑同款同色完整45度主图和两个以上完整不同部件，按需Qwen清理或调整角度，再做外观核验。停止用固定主图三个区域凑细节。单次和批量使用同一交付规范、选图器及归档器。 ## 0.1.33 浏览器接口修复 安装脚本包含已核对的浏览器助手 0.3.6 与 DSH 0.2.1 兼容修复；仅修改匹配哈希的助手文件并保留备份。通过官方 Connection 传递 Peer 和取消信号，不读取或复制访问令牌，不清除平台暂停，不重跑失败任务。升级助手后若文件变更，脚本拒绝覆盖。 单次读取中途会保存 browser-capture.json（阶段资料，不是完成卡片）。详情加载完毕后在同一商品页补读参数，实际错误由 readDiagnostics.toolFailure 返回。 # 0.1.32：桌面适配与详情证据 适配已核对的 DSH Desktop 2.0.18-beta.1 / DSH 0.2.1-rc.2。安装脚本仅对精确版本和已知原文件哈希应用浏览器适配，先备份并校验，不强制覆盖其他改动。DSH 升级可能覆盖此本地适配；面板会分别检测桌面接口和外部助手，接口晚到时自动接入，打开面板时自动安排一次助手连接检查。宿主适配需要正常退出并重新启动 DSH 生效。 右上角入口固定显示“规格卡模板”；当前模板名称保留在提示信息中。 ## 商品详情本地存档 每个新自动任务依次读取官方参数和商品详情、保存原图、提交详情图给 DSH 的 DeepSeek V4.1 Flash 图片路由，再制卡和归档。单次立即启动，批量仍按商品间隔逐条运行。 - 原始详情保存在 `.sofa-monitor/product-tasks/<任务ID>/details/`。 - `index.html` 是无需联网的本地查询页；`snapshot.json` 保存参数原文、来源、原图索引、哈希及失败原因。 - `detail-original-XX.*` 是下载到的原始文件；长图分片仅用于模型阅读，不改动这些原文件。 - `review-prompt.txt` 和 `review.json` 保存实际阅读指令、供应商/模型路由、提交图片、原图哈希、切片坐标、返回原文和覆盖情况。 - 制卡成功后，这个 details 目录自动复制到用户设置的平台归档目录，和 product.json、规格卡放在一起。 - 浏览器区域的“详情存档”可在资源管理器定位本任务的 index.html；分析失败时也保留已下载内容。 每次最多存档24张原图、48MB，单图8MB；先挑选尺寸/规格标注图并覆盖详情尾部，再按原顺序下载，相邻下载间隔5秒，不并发或自动重试。模型最多阅读32个长图切片，优先尾部尺寸区和各图首尾，每次4张；相同字节只读一次，留下复用记录。未取得的图片、达到上限及无法辨认的图片均记录为不完整，不能声称整份详情已完整读取。详情原图缺失或模型分析失败时停止本条制卡，不跳过这一步直接报告成功。 ## 模型与自动化边界 “1017”在当前 DSH 中由界面标签插件显示，实际模型别名可能仍是 deepseek-flash。后台优先使用目录明确列出的1017 Flash路由，否则使用当前供应商的V4.1 Flash图片路由，并如实记录实际ID；不能把界面标签当成已独立验证的模型版本。模型不支持图片或能力未知时停止核对，不将文本占位算作已经查看图片。 Agent 只调用固定任务工具。详情图片交给 DSH LLM 和附件服务，返回的品牌、型号、尺寸、卖点必须带图片编号和原文。座深、座高、座宽分别识别；参数表已有值不会被图片识别覆盖；没有依据的数字保持缺失。网页和图片文字不得改变执行流程。 助手连接检查不读取商品页、不安装扩展或修改权限。登录、验证码、平台拒绝、403/429仍是实际阻断条件；本版本不绕过平台保护，也不承诺消除风控。 以下保留既有版本说明，冲突处以本节为准。 --- # 0.1.31 参数完整性与规格卡质量修正 最低后台版本0.1.31，沿用现有原生浏览宿主适配，无新增宿主修改。独立单次立即执行，批量商品间隔保持默认10分钟。 本版修复：选中颜色/款式不再冒充参数表；展开官方参数和查看全部参数；结构化字段不会再被顺序相反的高亮文案覆盖。采集已选尺寸、座深/坐深、座高/坐高、座宽/坐宽等独立字段，不能拿总高当座高或皮料厚度当整机尺寸。 在已有千问配置启用时，最多串行读取三张官方原图的明确参数文字，保留原文、单位、图片来源与识别记录；单位、数值或配置对应关系不明确就保留缺项。该步骤不改变原来的价格时间，不触发ComfyUI或AI放大。图片服务401/403/429后本条不继续请求该服务。 品牌、独立型号、面料、颜色、填充、尺寸分别归类。型号优先明确型号或标题中的型号，保留已有SKU后缀；货号另存，不把整段商品标题塞入型号单元格。图片中的57–110cm等数值不再被丢成“大坐深规格”。标题/型号加粗、卖点分组加粗、价格红色、座深/座高/座宽独立三行。 任务返回dataQuality和dataConflicts；参数缺项或页面口径冲突时，Agent必须明确报告，进度显示“已归档待补全”。批次partial统计资料未齐的卡片，completed仍统计已归档图片，不能把partial称为完整资料。 首启仅用本地已有资料修复旧自动规格卡，并在数据目录repairs/0.1.31备份原卡和原元数据；保留用户重命名和创建时间，不访问平台、不调用模型，不重跑采集任务。历史原始采集包保持原样，当前图片与CSV索引按新规则修正。数据目录中逐条绑定来源和采集时间的verified-parameters收据用于一次性人工核验补正，不参与后续在线采集的取数，不作为任何固定默认商品。 真实G513既有页面验证：新解析器读取10项官方参数，座深57cm，当前选中三电动3.15米；参数表电动位2个，存在口径冲突。座高和座宽未在该公开参数表中列出，本次没有编造。AUZU未重新访问，只用原有资料修正展示，缺项明确保留。 --- # 0.1.30 单次立即采集与读取修正 最低后台版本0.1.30，沿用0.1.29已安装的原生宿主适配，无新增宿主修改。独立手动单次采集立即执行；批量仍按设定间隔，默认10分钟。所有入口仍遵守互斥、平台暂停和SKU校验。29已有的平台暂停/解除状态保持，不因本次升级自动解除或重新暂停。 单次读取先核对助手当前页面，目标一致时复用，至多导航一次；参数缺失才打开官方栏目，有限等待页面就绪。任务与商品证据保存读取阶段、参数数量、图片数量和缺项警告。Agent只调用固定run，自动规范不再要求已移除的capture或手工start/finish步骤。 本次本地验证不访问京东；旧版成功记录不能代替新版真实在线验收。生产后台需正常退出并重新打开后检查版本，不应只凭前端页脚判断已生效。 --- # 0.1.29 平台访问保护与后台调度 此版本的后台最小版本为0.1.29。原生浏览器还需要随包assets/native-safety中的本地宿主适配（已验证DSH Desktop Beta 2.0.17-beta.2、Electron 44）。替换前备份bridge.cjs、carrier.cjs、tabs.cjs，新增access.cjs；DSH升级后须重新核对适配，不能直接覆盖不匹配版本。它不是纯插件即可跨任意电脑提供完整原生浏览器的实现。 升级首次启动时京东默认暂停。须由用户在正常浏览器确认平台恢复，在插件设置中解除暂停；解除只恢复创建新任务的能力，不重跑旧任务，单次立即执行；批量不跳过完整商品间隔。关闭错误提示不解除暂停。 后台调度使用DSH公开AgentRegistry.get和Agent.followup接口，通过最初会话派发后续固定工具调用。等待不发送模型请求；关闭面板后继续，退出DSH、会话销毁或权限拒绝时停止。正常DSH权限检查保留；不存储或复用已结束工具调用的令牌。 中央浏览器初始为空白，不自动恢复旧URL。宿主专用浏览分区默认阻止网络，获得本地有效访问状态后才允许浏览；验证跳转会暂停整个分区。本地事件流实时同步暂停状态，连接中断则关闭中央页面，重新连接也不重放旧URL。 本版没有在受限京东页面上做在线验收。真实平台连续十条的成功率仍须在平台恢复后另行验证，不能用本地模拟代替。 --- # 0.1.27 完整日夜主题与清爽界面 界面更新，最低兼容后台0.1.26。当前后台为0.1.26时只需重新加载界面，无需退出或重启DSH。规格卡模板0.1.2继续使用，采集与制卡后台没有改动。 修复产物预览区遗留的深色底色；补齐代码块、行内代码、输入框、菜单、文档预览和语法高亮的模式变量。DSH宿主可以保持另一种主题，插件内部独立切换，外部网页和DSH侧栏不改。主题变量来自当前SDK的公开语义色表并在插件根节点重新声明，避免继承宿主已计算的深色值。 参考澎湃OS的柔和表面、留白与卡片层次，调整圆角、轻阴影、标题与按钮。检查覆盖DSH真实Markdown、CodeBlock、InputBar组件的隔离状态，含四种宿主/插件主题组合、预览底色与文字对比度。原始宿主代码没有修改，测试入口不发送Agent消息、不连接京东。 # 0.1.26 图片模板与日夜外观 配套规格卡模板0.1.2，编辑协议3。五款内置布局分别设置3、3、2、3、2个独立细节位，单人位和多人位均适配，单人位左主图、右细节。自动任务在创建时保存选中模板，批次全程沿用同一快照；自动图片准备按模板所需数量执行。优先使用取得的官方图片，缺少独立细节时明确标注主图同源裁切，不制造图片或虚构卖点。输出固定1920×1080。 第一次加载时仅升级仍保持旧版原始几何的内置模板。保留名称、配色、隐藏状态、默认选择、辅助线和所有自定义/已编辑/已删除模板；迁移完成后不重复升级，不重绘历史产品图片。 工作台提供白天/夜间切换并保存选择，初始遵循系统配色；使用统一中性表面、柔和圆角与蓝色重点。主题作用于插件范围和原生对话组件公开色彩变量，不修改DSH宿主、网页或浏览器登录状态。大图打开、关闭和按钮反馈采用短过渡，尊重系统减少动画设置。原生网页定位和拖动分隔条不加位移动画。 # 0.1.25 模板编辑协议2 配套规格卡模板0.1.1。支持复制、删除、重复内容区块、独立细节图片、产品标题和非打印参考线。旧模板可直接加载；升级保留用户模板、商品、图片、归档和登录资料。新编辑器不会向旧协议后台写入。 # 0.1.24 统一模板与图片预览 配套独立插件“规格卡模板”0.1.0：五款内置版式、模板总览、重命名、复刻、隐藏/恢复、删除、拖动和拉伸画布区块、精确坐标、配色及真实商品预览。单品和批次在创建时保存模板快照，后续制卡必须使用该快照；修改默认模板影响下一任务。标准输出1920×1080、16:9。 模板库位于数据目录template-library/templates.json。用户模板与商品资料、浏览器登录分区分开；升级不会重置。模板使用受约束JSON，不执行代码。支持最多100个模板、每个最多30个区块，冲突采用版本校验，至少保留一个启用模板。单人位左主图、右细节，采用原有官方图片；不会凭空生成三分之四角度。 文件区列表/方格/缩略图只选中图片，产物展示区预览所选图片，点击产物图片才进入悬浮阅读。旧参考图入口、资源及独立预览状态已删除。 安装脚本新增-TemplatePackagePath参数，可通过DSH官方CLI一次安装两个本地包。后端及两个客户端均需重新加载后才算生效，安装不强退DSH。 # 沙发爬取 0.1.23 DSH Windows 商品研究工作台，保留中央原生浏览器、独立新会话、文件管理、1920×1080规格卡、悬浮图片阅读和可调区域。本版优先京东，其他平台待测并停用。 ## 本版修复 自动单品统一调用固定run执行器，后台完成官方读取、图片获取、具体卖点、制卡和归档，Agent不再自由选择方案或手写manifest。普通页面错误有限重试、跳过并继续下一条；真登录/验证码/权限失败只报告阻断，不提出确认问题。修复懒加载参数与重复派发；已完成任务重复启动直接返回原结果。 从本次官方参数生成具体卖点，不再以“官方图片细节1/2”代替。三张细节图都会保留；缺独立图片的同源裁切不会覆盖卖点。旧占位卡首次加载自动用已保存资料修复，不重新采集、不修改历史归档。 移除文件区展开和完成后自动放大；移除浏览器下方复制指令、长说明和浏览说明。顶部仅阶段短名、进度条与数量，活动时每秒更新。 ## 采集入口与执行 采集区仅保留平台、沙发品牌、商品数量、整批最长分钟、启动方式、检查并连接助手，以及唯一的按筛选条件搜索并采集按钮。助手按钮位于采集按钮上方；执行中同一主按钮可停止任务。关键词固定为沙发，移除随机、参数草案、旧链接队列、中央批次和重复制卡入口。数量1–10，分钟为大于0的安全整数，没有10分钟上限。 直接启动交给右侧独立DSH Agent；复制指令先等用户发送，后续仍由右侧Agent调度。未连接时尝试打开已有浏览器和助手界面，并核实连接，不把启动当成功。保持面板打开。 10表示希望新增10条商品规格卡，不是并行启动10个Agent。依次执行：品牌加沙发搜索 → 当前搜索页最多30个唯一候选链接 → 优先从未采集的链接 → 读取官方详情并过滤 → 单商品读取标题、品牌、型号、颜色、选中款式、规格、价格和图片 → 插件统一排版 → 文件管理与独立归档 → 平台汇总 → 下一条。 整批时限从执行器开始计时，包含助手连接、搜索、读取、制图、保存和调度等待。达到目标、时间到、主动停止、登录验证/拦截、候选耗尽或连续5条明确重复时结束。数量不足如实报告，不无限翻页或重复搜索凑数。离开面板不继续派发新步骤；后台重开标记中断，不自动恢复采集。宿主已开始的任意工具仍受DSH自己的取消及审批机制控制。 ## 汇总和去重 每个平台一份CSV，用Excel打开，按采集时间排列：时间、平台、标题、品牌、型号、颜色、规格、商品编号、来源链接、重复标记、备注、关联历史来源、归档目录和全部商品字段JSON。带UTF-8 BOM与公式转义。 同平台同SKU，或品牌、真实型号、非空颜色及非空规格全部相同，算明确重复；仍保存本次JSON和图片，并标记关联历史记录，不计新增。只同型号、同标题或配置不足只提醒可能相似，不自动删除。标题补位的型号不参与型号一致判断。分别显示新增、已保存、重复及备注。不同SKU可能是同一实物，缺失或错误的网页参数也不能保证识别，因此两批10条不能承诺为20款不同沙发。 优先未采集链接避免每批总从同样旧链接开始。连续5条明确重复停止，最多处理当前页30个候选，保证不会空转循环。 ## 保存位置 顶部设置使用DSH官方Windows文件夹选择器，为每个平台选择目录。选定目录下建立SofaMonitor-jd、SofaMonitor-taobao、SofaMonitor-tmall或SofaMonitor-xiaohongshu子目录。取消不改变配置，活动任务期间禁止更换；选择进行中禁止启动采集。 默认目录为当前Profile的 .sofa-monitor/exports/<平台>。京东内有京东-采集汇总.csv和captures/<采集时间>-<任务ID>/，每次分别保留product.json、标准命名主图和产品规格卡。相同SKU再采集有新的历史目录。改位置影响以后归档，旧文件不搬动，汇总仍保留旧路径。 跨批次索引是Profile内的collection-index.json，请连同归档一起备份；面板轮询不会发送完整历史。首次启动为已有且图片完整的商品补建归档。索引损坏停止读取，保留原文件，不静默清空去重历史。 文件管理仍从Profile的 .sofa-monitor/files 提供预览、改名与系统定位；所选平台目录保存独立历史副本。Agent中间素材位于当前DSH工作区的 SofaMonitor-outputs/<任务ID>。 ## 规格卡和文件 单次采集绑定中央当前京东商品，自动生成并保存，不逐条人工核对或入库。缺型号使用真实商品标题并标注；缺标题依次降级为页面标题和平台SKU；其他缺项标未标注。缺细节图以注明同源的主图裁切，缺主图用明确占位。不编造商品外观、不用评论参数、不放大2K、不用ComfyUI。 规格卡与主图命名为品牌-首个型号-产品规格卡.png和品牌-首个型号-主图.png，同名保留序号，可改名。文件区支持列表、方格、缩略图，显示创建时间、实际像素、大小和格式，并可定位。悬浮图片支持缩放、上一张/下一张和Esc。产物只显示参考图与产品规格图。 ## 加载与验证边界 共用版本仅在左下角显示，本版最低后台0.1.23。新增归档和去重需要正常退出再打开DSH一次，单独重新加载界面无法更新后台。未生效时禁用新采集入口。无宿主文件变更或新增宿主权限。 保留原生连接受控恢复、标签及缩放恢复和各区域拖动。检查覆盖真实PNG、存盘、重复计数、连续重复停止、目录变更和失败重试。独立界面的浏览器与Agent为测试替身，不等同于真实京东10条现场验收。 ## 当前版本 0.1.50 打开沙发爬取的“设置”，可在图片处理、存储设置和模板卡设置之间切换。模板卡设置集成原有模板总览、启用、编辑、预览和管理功能，使用已有模板库。沙发爬取右上角和 DSH 左侧不再显示独立模板入口。