DSH Instance Manager
0.14.0 起,用户可见名称统一为「分身」;本文与技术文档内部仍沿用「实例」这个技术称谓(英文界面仍是 Instance)。
一个可启用/停用的 DSH 插件,把桌面端变成「分身」工作台。
平台:Windows x64。插件依赖 Electron 桌面壳、Windows 原生目录选择器与
taskkill,其它平台暂不支持。
实例 = 独立内核副本 + 独立插件副本 + 独立配置 + 固定端口 + 可自选存储位置。它不绑定工作区,用来隔离并行项目;在实例里创建的工作区与会话会按会话记录归属,并在桌面端与其它实例中显示徽标。
行为(桌面端 vs 实例内)
| 桌面端(当前运行的 DSH 桌面应用) | 实例内(由本插件启动的 DSH) | |
|---|---|---|
| 侧边栏 | 一级入口「实例」(自绘 outline 图标,风格与原生一致)+ 运行中数量徽标 | 不显示「实例」入口;左上角品牌替换为实例图标 + 实例名 |
| 分身列表 | 标题区是一张 960 内容列宽、与检索框同款背景的包裹条:左侧第一行 20px「分身」、第二行小字「管理相互隔离的 DSH 分身:独立内核、独立插件与固定端口」+ 行内 ⓘ(可悬停说明);右侧是「刷新」「新建分身」按钮(新增在最右);包裹条最下方是通栏四段筛选「全部 N / 运行中 N / 已停止 N / 错误 N」——无状态色、只有文字与数量;整条是浅内凹槽(inset 阴影),选中项用与标题栏相同的底色「浮起」并带一层极淡描边,未选中的三项则像陷在槽里,下方是整行搜索框;卡片 = 1:1 图标 + 名称 + 简介 +「局域网」「网页/桌面」徽标 + 右侧状态条;图标按钮启动(实心三角)/停止(方块),运行中额外出现重启;拖拽排序(握柄在右侧状态条旁,不占左缘);双击(已停止→设置,运行中→打开) | — |
| 实例设置 | 修改后自动保存(约 700ms 防抖,标题下显示「已自动保存」等状态;没有底部保存/返回按钮)、图标(1:1,点击直接选择本地图片;行尾有「获取提示词」按钮:打开关键词弹窗(6 组、共 145 个:风格/构图与形状/色彩/质感与光影/语义与用途/应用类型),可不选、可多选,确认后按六段模板生成完整提示词并复制到剪贴板)、名称/描述、访问方式(网页 / 桌面;选「桌面」时下方显示「桌面运行库」状态与下载按钮)、端口、局域网、自动打开、插件(两行入口:「可添加 N 个」+「添加插件」、「已添加 N 个」+「管理插件」,点进各自子页:添加页按「实验性 / 已安装」分组、行尾是加号;管理页可启停/移除,并展示内置插件配置说明;两页都使用插件自己的图标,无图标时回退通用 glyph;插件行不画分隔线/外框,靠行间距与 hover 底色区分;名称在上(14px)、介绍在下(13px 浅色),没有 dsh.title 的插件名称回退为包名、介绍回退为包描述;管理页「内置插件配置」固定在所有已添加插件上方,空态提示居中)、数据(内核版本+重建、存储目录+迁移,按钮在行右侧)、删除(按钮在行右侧) |
— |
| 插件页 | 原生插件页(全局唯一的插件安装入口) | 原生「已安装」标签页;本插件移除了自己追加的「插件库」标签,并隐藏右上角「添加插件」的右半下拉;点击「添加插件」弹出 DSH 原生样式提示(请到主端口实例设置中添加) |
| 工作区 / 会话 | 会话级归属徽标、非本实例归属横幅;聚焦窗口时自动同步:window focus / visibilitychange(visible) / pageshow 触发一次 POST /sync(200ms 防抖),host 读取工作区索引并重放 domain/changed;空闲时完全不轮询。「工作区」右侧图标组有刷新按钮(手动 /sync + 原生 store 刷新,带旋转反馈) |
同左;会话归属本实例时不显示横幅 |
| 浏览器标签 | — | 页面标题 = 实例名;标签图标 = 实例图标:客户端会替换页面里所有 link[rel*=icon] / shortcut icon / apple-touch-icon 的 href 与 type(含原生那条鲸鱼),并按 iconVersion 更新 URL |
| 桌面窗口 | — | 「桌面」访问方式:启动、双击运行中卡片、点设置里的「打开」时,由插件启动一个独立 Electron 窗口加载实例 Web UI——标题 = 实例名,窗口/任务栏图标 = 实例图标(从页面 favicon 光栅化后 win.setIcon);关闭窗口不影响实例,停止实例会自动关窗。首次使用需下载 Electron 运行时(约 158 MB,缓存在 ~/.dsh/instances/_runtime,所有实例共用,可在设置里手动下载);顶部 34px 自绘条最左侧是「返回 DeepSeek Harness」按钮:最小化实例窗口并拉起桌面端本体,实例窗口保留在任务栏(再次双击卡片或打开实例会恢复并聚焦);收起/展开侧边栏按钮同时识别「收起侧边栏」与「打开侧边栏」两种 aria-label,收起后仍能再展开;窗口无系统标题栏,顶部是 34px 自绘条:左侧「收起/展开侧边栏」按钮、右侧最小化/最大化/关闭,中间可拖动移动窗口,双击最大化;窗口/任务栏图标跟随页面 favicon 更新(实例自定义图标生成后自动替换,最多轮询 30 秒) |
| 选文件夹 | Windows 原生选择器 | Windows 原生选择器(实例 profile 由本插件固定为 native 选择器后端) |
| 内核 | 跟随桌面端当前内核 | 创建时复制并锁定版本,桌面升级只提示「可重建」 |
状态色:灰=已停止,黄=启动中,绿=运行中,红=错误。会话徽标外框也按会话状态高亮:运行=品牌色(发光)、等待输入=橙、错误=红、完成=绿、空闲=灰。实例未被归属的会话保持原生状态点。
图标:设置页点击图标直接打开本地文件选择(PNG/JPG,自动裁 1:1、≤512KB);行尾「获取提示词」打开关键词弹窗:分 6 组共 145 个关键词,可不选/多选;确认后 host 用 icon-prompt.md 的六段模板(角色 / 使用场景 / 设计语义与应用信息 / 关键词约束 / 输出约束 / 自审与审查,占位符 {{name}}、{{description}}、{{keywords}})替换生成完整提示词并复制到剪贴板;不选关键词时写「无额外偏好」的兜底句。host 提供 GET /icon-keywords、POST /build-icon-prompt(仅桌面端);/generate-icon、/icon-prompt 保留给外部 AI 工具,界面不提供生成入口。
使用
桌面端侧边栏「实例」→「新建实例」:填名称、描述、存储位置(必填,默认
~/.dsh/instances,可用「选择目录」调起 Windows 原生选择器)、可选端口(留空自动分配)、局域网开关、启动后自动打开浏览器开关。创建后不会自动启动。卡片右侧图标按钮:启动 / 停止;运行中还会显示「重启」。拖动卡片右侧(状态条左侧)的握柄可排序(顺序保存在 registry,跨重启保留)。双击已停止的卡片进入设置;双击运行中的卡片打开实例地址。
设置页:点击图标直接选择本地图片(PNG/JPG,自动裁 1:1);图标行最右侧「获取提示词」会打开关键词弹窗(可不选/多选,6 组共 145 个),确认后生成并复制完整提示词。访问方式可选「网页」或「桌面」;选「桌面」时同一区块会显示「桌面运行库」状态(已就绪/未安装/下载中)和「下载运行库」按钮,首次点「打开」也会自动下载(约 158 MB,一次即可,所有实例共用)。「插件」区是两行入口:
- 「可添加 N 个」→「添加插件」子页:标题「将插件添加到「实例名」」,按「实验性 / 已安装」分组,行尾是描边方形的「+」按钮,点击即添加;实验性插件来自实例内核(只写配置、不复制文件),社区插件复制独立副本。
- 「已添加 N 个」→「管理插件」子页:标题「「实例名」的插件」;顶部固定「内置插件配置」说明(内置配置存在实例自己的 profile 里,运行时可在实例的插件页修改),下方是可启停、移除的插件列表;没有插件时显示居中的「还没有添加插件。」
「数据」区含内核版本、重建内核、存储目录与迁移;「删除」为普通区块(不再红字高亮)。端口 / 局域网 / 自动打开 / 存储位置迁移均「下次启动生效」,插件修改需重启实例。
在实例里:侧边栏「插件」仍可启停原生插件;「添加插件」会提示回桌面端实例设置页操作。创建工作区仍使用 Windows 原生文件夹选择器。
跨端同步:在实例里创建/重命名工作区、创建会话后,桌面端与其它实例无需刷新即可看到(后台比较 revision 后调用原生
sessions.refresh()/workspaces.refresh())。如果没等到自动同步,点「工作区」右侧的刷新按钮立即重拉。
数据位置
存储位置在创建时选择,默认 ~/.dsh/instances/<id>/:
~/.dsh/instances/_runtime/electron/44.7.0/ # 桌面窗口共用的 Electron 运行时(首次使用下载,约 158 MB)
<存储位置>/<id>/instance.json # 单实例记录(含 storageDir / profileName / kernelVersion / order / accessMode)
<存储位置>/<id>/kernel/<version>/ # 内核副本(约 405MB,创建时从 app.asar 解出)
<存储位置>/<id>/profile/ # 实例 profile(package.json / cordis.patch.yml / node_modules 插件副本)
<存储位置>/<id>/library.json # 创建时的桌面插件库快照
<存储位置>/<id>/logs/instance.log # 运行日志(时间/事件/退出码)
<存储位置>/<id>/icon.png | icon.svg # 实例图标(只保留一种)
~/.dsh/profiles/inst-<id> # 指向 <存储位置>/<id>/profile 的 junction(DSH 按 profile 名解析)
~/.dsh/instances/registry.json # 实例记录索引(全局)
~/.dsh/instances/desktop.json # 桌面端宿主标记(内核来源/运行时路径)
~/.dsh/instances/attribution/<id>.json # 会话级归属(schemaVersion 4;每个实例写自己的文件,避免多进程互相覆盖)
删除实例会删除 <存储位置>/<id>/、profile 入口与它的归属文件,保留工作区与会话。旧版 attribution.json(工作区级)只读兼容,不再写入;旧实例(v0.2.0 及更早)不做迁移。
实现要点
纯插件实现(host + client 两半),不修改 DSH 源码;通过
plugin_manager安装为 profile bundle(指向本仓库的 junction),可在「插件」页整体停用。内核复制:桌面端主进程以 Electron-as-node 运行一次性复制脚本,从
app.asar/dsh(含app.asar.unpacked)读出到<存储位置>/<id>/kernel/<version>,约 405MB / 1.7 万文件。实例启动:
<runtime>/node …/@deepseek-ai/dsh/lib/bin.js --profile inst-<id> --host 127.0.0.1 --port <port> --no-open,stdout/stderr 写日志,解析dsh web: <url>并轮询健康检查(≤90s)。局域网开启时追加--trusted-host/--public-url。原生文件夹选择器:创建实例 profile 时写入受管 cordis patch 块——停用自适应的
directory-picker行,插入@deepseek-ai/dsh-host-directory-picker-native与@deepseek-ai/dsh-client-ui-directory-picker-native;每次启动前重新确保该块存在。这样即使实例绑定在局域网地址,也使用 Windows 原生 IFileOpenDialog。工作区跨进程同步(惰性):host 侧
workspace-sync.js不再轮询,只在客户端触发时(POST /sync,由窗口聚焦/可见/页面显示事件触发)读一次<DSH_HOME>/storages/workspace.json,把其它进程写入的工作区状态合并进本进程的workspaceRegistry(state+table.records、rebuildEntities、补索引会话 header):sessionIds取并集(保留本进程刚创建、文件快照还没落盘的会话,避免聚焦同步后会话掉进「未分组」)、workspaceIds保留本进程多出的工作区;聚焦触发的/sync会重放整份合并快照(全局 put + 每条工作区记录 put),即使某个客户端漏掉过一次增量(比如标签页在后台)也会被修正,不会把会话掉到「未分组」;宿主启动时的隐式同步仍只重放真正变化的记录,并且增量同步从不删除记录(删除只在下次宿主启动时随文件生效)。插件只读该文件,绝不写它。host 需注入workspaceRegistry、sessionPersistence服务才能拿到该对象。会话级归属:实例内插件用
ctx.on('session/created', …, { global: true })把新出现的空白会话放进内存 pending(不落盘);再用ctx.on('session/event', …)监听,只有该会话在本实例里真正开始对话(turn/start或user/message)时才写入归属文件(schemaVersion 4,session.id+session.header.cwd+createdAt)。原因是 DSH 会复用命名空白会话(dsh-session的 "reusing the named blank Session"):如果空白草稿一出现就归因,桌面端随后复用同一会话继续对话会继承实例徽标。pending 只保留 24 小时;parentSession(子智能体)与createdAt早于本进程启动的会话一律忽略;旧 v2/v3 归属文件静默忽略(不备份、不迁移),历史误归属自动失效。归属只记录会话,不改绑工作区;桌面端合并读取所有实例的归属文件,按sessionOrigins提供给客户端。跨端刷新:host 新增极轻量
GET /revision(只返回revisionDigest())与POST /sync(惰性、单飞);可见窗口每 3s 比较一次 revision,发现变化才同步(解决「网页端/后台可见但未聚焦」窗口不更新的问题),窗口聚焦/可见/页面显示时仍防抖调用/sync,成功后刷新原生 store(sessions.refresh();workspaces控制器没有 refresh,侧栏由 host 重放的domain/changed经原生 feed 推送),因此无需常驻轮询。聚焦同步后会追加两次单发/sync(1.5s、5s)再刷一次原生 store,覆盖跨进程写入的延迟。/state仅在启动/停止等忙时与手动刷新时使用。插件管理(桌面端):
GET /instance-plugins返回实例插件、桌面安装库与实验性插件目录;POST /add-plugin、POST /set-plugin-enabled、POST /remove-plugin。社区插件在实例停止时复制依赖闭包、改 profiledsh.profile.bundles与dependencies(可添加列表按dependencies ∪ bundles扫描,桌面端停用的插件也可添加)(原生插件页以此判断「已安装」);实验性@deepseek-ai/dsh-*插件来自实例内核、桌面端本就提供,因此只写配置、不复制文件。实例内的插件安装入口被客户端拦截,改为原生样式提示。图标:host 保存
icon.png/icon.svg之一并返回iconContentType;GET /icon按扩展名返回 content-type;POST /generate-icon立即返回并启动后台任务(重复请求提示「图标生成中,请稍后再试」),模型调用带强约束 system prompt、120s 超时与一次「修复重试」(把非法输出回喂、要求只输出完整<svg>),stripSvgReply/sanitizeSvg去代码围栏、截取首个<svg>、补齐xmlns/viewBox并移除脚本/外链;instanceView通过iconGenerating/iconError暴露任务状态。客户端在applyBranding中同步实例页标题、favicon 类型与左上角品牌。插件图标:桌面端扫描插件库时读取包内
package.json的icon相对路径(svg/png/jpg/webp/gif,≤256KiB)转 data URL,带 60s 缓存;添加/管理子页与后续插件管理直接使用插件自己的图标,无图标时回退中性 glyph(与原生插件页一致)。桌面窗口(v0.10.0):
shell/是一个极简 Electron 应用(无边框BrowserWindow加载实例 URL、标题与 AppUserModelID 由环境变量传入;frame:false+ 自绘 34px 顶栏(收起侧边栏 / 最小化 / 最大化 / 关闭,-webkit-app-region:drag),preload 暴露__dshShellIPC;页面 favicon 轮询 30s +page-favicon-updated,画到 256×256 canvas 后win.setIcon、外链交给系统浏览器、加载失败显示内置错误页);host/shell.js负责下载/解压/校验 Electron 运行时(npmmirror→GitHub 双源、DSH_INSTANCE_SHELL_DIR可覆盖用于测试)、spawn时删掉继承来的ELECTRON_RUN_AS_NODE、退出/关闭用taskkill /T;host/index.js用SHELLS表管理每实例窗口,instanceView暴露shell/shellError,POST /open-shell、/close-shell、/prepare-shell-runtime三个路由;停止实例、停用插件、桌面退出都会先关窗。公开服务:桌面端宿主通过
ctx.provide('instanceManager', service)暴露统一接口(listInstances/getInstance/listPlugins/listCatalog/setPluginEnabled/addPlugin/removePlugin),并发出instance-manager/changed事件(registry.changed/plugins.changed)。插件描述符统一为{ id, instanceId, instanceName, name, title, description, version, source, enabled, removable, experimental, icon, tags },供后续「插件管理」类插件直接消费。标题栏与布局:实例页与插件页共用 960 内容列;标题容器用
div+ 显式margin/background/border重置,避免第三方主题对header的全局样式把标题做成独立卡片并脱离内容列。浏览器标签图标:
applyBranding每轮都会把页面上所有 icon link 改写到/plugins/instance-manager/icon?id=…&v=…(没有自定义图标时回退为实例首字母的 data URI),因此原生鲸鱼图标会被覆盖。横幅/徽标:空闲会话行走
sidebar.session.row.leading槽位(1:1 实例图标 + 按状态着色的圆角外框);运行/等待/错误等非空闲行由原生状态点占据该槽,客户端用 MutationObserver 在对应[data-row-key="session:<id>"]行上注入同款徽标并隐藏原生状态点(双击打开归属实例)。另在会话悬浮卡提供归属行、在会话输入区顶部提供归属横幅。配置继承:创建时把桌面端
cordis.patch.yml原样复制一份作为基线,此后互不影响(已验证未知 override id 会被忽略)。桌面端退出 / 插件停用时停止所有由它启动的实例;启动时清理残留(僵死 pid 标记为已停止)。
首次加载失败(宿主接口不可达)时,客户端会在
shell.overlay槽显示固定错误浮层并提供「重试」按钮:此时/state尚未成功、面板还没注册,这是唯一能触达用户的入口;「重试」按钮会重新加载页面(宿主仍不可达时继续按 5s→30s 退避),成功后自动注册界面。日志脱敏:写入
instances/<id>/logs/instance.log的 URL 一律把token/access_token换成***;/state只在桌面端返回内存中的运行 URL,实例模式与/session不返回。实例插件副本随宿主版本自动刷新:启动实例时比较 profile 内
@local/dsh-instance-manager版本与宿主自身版本,不同则删除重拷(旧实例不会卡在旧插件版本)。
分身身份(v0.17.0)
- 会话徽标语义改为「最近执行者」:归因在首次执行时写
createdAt,此后每次turn/start/user/message刷新executedAt;合并多个分身的归属文件时,同一会话取executedAt最新者。会话行徽标、悬停卡与输入区横幅统一显示「最近执行:<分身名>」。 - 桌面端主进程也会记录自己的执行(
attribution/__desktop__.json,实例名「主端」):在桌面端继续过的会话,徽标会切回主端,不再错误地停留在原分身。 - 助手回复信息栏(「用量 … tok」与时间之间)新增身份:分身自绘 outline 图标(三条圆角横线,与侧栏入口同一图形)+ 名称;桌面端执行的回复显示「主端」。实现方式:
conversation.chat.assistant-actions槽位只拿到{ messageId, sessionId },组件在该条消息的[data-turn-tail]内定位[class*="endInfo"],把身份元素插入到用量与时间之间;跨端同步后按最新归因重绘。 - 尺寸(v0.17.1):信息栏身份图标与左侧「用量」图标一致——
.im-executor svg{width/height:calc(15px + var(--dsh-content-font-delta,0px))},间距 4px、行高 28px,随内容字号缩放;探针新增断言「identity icon size == usage icon size」。 - 验证:
ITER4 PASS(归因 v4:桌面执行写主端后徽标消失、executedAt 递增)、_work/probe-executor.mjsPASS(真实会话 3 条回复:身份注入在用量右侧、名称「分身甲」、徽标标题「最近执行:分身甲」;移除归因后显示「主端」且徽标消失)、ITER8 UI PASS回归。 - 生效:host 归因改动需重启 DSH;客户端刷新页面即可;已打开的实例窗口需重开。
Surface 契约(v1,插件列表装饰器对接)
分身设置页的两个插件子页(添加 / 管理)在列表区域暴露 插件列表 Surface 契约 v1 的 data-* 属性,供 plugin-manager-plus 这类装饰器识别并增强(改名/简介/图标/标签/搜索/添加到分身)。分身管理不依赖装饰器存在,装饰器关闭后 DOM 恢复原样。
| 位置 | 属性 |
|---|---|
列表区域根(div.im-plugin-surface,只包列表,不含返回/标题/hint/notice) |
data-plugin-surface="instance"、data-plugin-surface-version="1"、data-plugin-caps="rename desc tags icon search clone"、data-plugin-scope="instance:<实例 id>" |
每个列表容器(ul.im-plugin-list) |
data-plugin-list |
每张卡片根(li.im-plugin-row) |
data-plugin-package="<npm 包名>"、data-plugin-kind="package"、data-plugin-status="running|disabled" |
| 卡片槽位 | data-plugin-icon(图标容器)、data-plugin-title(名称唯一文本节点)、data-plugin-desc(有简介时才渲染)、data-plugin-actions(操作区) |
硬约束:只加属性——文本、布局、事件、样式表与既有行为均不变;属性写在 JSX props 里,React 重渲染自动保留;不使用 hash 类名做契约;分身子页不声明 order/batch/uninstall/install-guard(未实现的语义不写进 caps)。data-plugin-scope 只用于区分分身,装饰器的标签/覆盖仍按包名全局共享。
验证:_work/probe-surface.mjs(新增)逐行断言 surface 根、caps 精确集合、scope、data-plugin-list、卡片 package/title/icon/actions/kind/status/desc,并确认「内置插件配置」仍在列表上方、列表保持 960 列宽;截图 _work/ui-shots-surface/01-add-surface.png、02-manage-surface.png。原有 ui-iter8 UI 探针(视觉/两行/删除确认/获取提示词等)保持通过。
开发 / 安装
# 在 DSH 桌面端执行插件安装(本仓库已安装过一次,源目录即安装目录)
plugin_manager action: install_bundle target: <本仓库目录>
从 tarball / 仓库安装(推荐公开分发方式):
cd instance-manager
npm pack # 生成 local-dsh-instance-manager-<version>.tgz
plugin_manager action: install_bundle target: .\local-dsh-instance-manager-<version>.tgz
package.json的files必须覆盖所有运行时文件;npm pack前会自动运行scripts/verify-pack-files.mjs(也可手动node scripts/verify-pack-files.mjs),漏列host/shell.js这类打包事故会直接报错。安装包为
@local/scope 且private: true,可通过目录 / tarball 安装,但不能npm publish;如需公开发布到 npm,需要改包名与private,并同步host/index.js里的PLUGIN_PACKAGE。源文件:
package.json、cordis.patch.yml(插入instance-manager一行)、host/index.js(Host 插件,含/state、/revision、/sync等路由)、host/workspace-sync.js(跨进程工作区同步)、host/shell.js(Electron 运行时下载/窗口进程)、shell/(极简 Electron 桌面壳)、client.js(Web 客户端 bundle,含 3s revision 心跳与设置页)、icon-prompt.md(AI 图标提示词模板,六段结构,含{{name}}/{{description}}/{{keywords}}占位符)、locale/*.json、assets/icon.svg。客户端改动用 HMR 可见;host 改动需要重启 DSH 桌面端(已安装包是指向本目录的 junction)。
离线验证脚本(不属于交付物):
_work/mgr-iter10.mjs(桌面窗口:运行时探测、开窗/关窗/停止自动关窗、坏运行时错误上报)、_work/ui-iter8.mjs(headless Edge:迭代 9 三处修复 + 迭代 10 桌面访问项 + 布局/同步回归)、_work/ui-iter7.mjs(两行工具栏与 960 列对齐、双徽标、无左侧握柄、空闲零轮询、聚焦同步侧栏改名、忙时短轮询、插件子页两行)、_work/probe-real-lib.mjs(真实桌面插件库 title/description 兜底)、_work/ui-iter6.mjs(两行工具栏与 960 列对齐、双徽标、setting 自动保存、插件自身图标)、_work/mgr-wsmerge.mjs(合并式工作区同步:保留本地新会话、只有变化才发事件、滞后快照不删本地工作区)、_work/mgr-iter4.mjs(图标后台任务、归属 v3 只记新会话;用Object.defineProperty(process.versions,'electron',…)模拟桌面环境)、_work/ui-iter5.cjs、_work/probe-favicon.cjs(实例模式独立 web 宿主:标题/品牌/全部 icon link 替换)、_work/ui-iter4.cjs,以及历史轮次的mgr-iter1/2/3、ui-iter1/2/3/4/5、ui-badge、ui-picker。截图在_work/ui-shots-iter6等目录。
打包(v0.17.2 修复)
- 已修复:
files漏列host/shell.js导致 tarball / 插件市场安装时ERR_MODULE_NOT_FOUND(本地 link 安装不受影响所以一直没暴露)。现在files含host/shell.js与docs/plugin-surface-v1.md。 - 新增
scripts/verify-pack-files.mjs并挂到prepack:发布前静态校验所有运行时文件(host 入口的./xxx.js、shell/*、locale、图标、提示词、Surface 契约)都存在且被files覆盖,漏文件直接失败。校验成功时静默,失败输出缺失清单。 npm pack产物 15 个文件(含host/shell.js);已在临时DSH_HOME的 profile 里用 tarball 安装并import()Host 入口验证通过。
已验证
第二十一轮(打包修复,v0.17.2):
node scripts/verify-pack-files.mjs通过;npm pack --dry-run共 15 个文件且含host/shell.js、docs/plugin-surface-v1.md;tarballlocal-dsh-instance-manager-0.17.2.tgz在临时 profile 中pnpm add安装后,nodeESMimport()host/index.js→IMPORT OK dsh-instance-manager function inject=["webServer","workspaceRegistry","sessionPersistence","connection"](修复前该导入报ERR_MODULE_NOT_FOUND: host/shell.js)。第二十轮(分身身份,v0.17.0):
node --checkhost/index.js/client.js全绿;mgr-iter4→ITER4 PASS(归因「最近执行者」:session/created不再订阅、turn/start写executedAt且后续执行递增、桌面写attribution/__desktop__.json后徽标消失、删除后恢复);_work/probe-executor.mjs→EXECUTOR PROBE PASS(fixture 复制真实会话session-91ed6cd6…:3 条回复的「用量 … tok」右侧出现分身图标 +「分身甲」,title「最近执行:分身甲」,移除归因后变「主端」且徽标消失;截图_work/ui-shots-executor/01-assistant-identity.png、02-desktop-fallback.png);ITER8 UI PASS回归。第十九轮(标题栏改版,v0.16.4):
node --check client.js通过(balance final depth 0);ITER8 UI PASS新增断言:分段筛选条位于标题卡底部(head y=22 h=122,seg y=93 h=38)、四段计数「全部1/运行中0/已停止1/错误0」、刷新按钮仍在标题操作区(aria-label「刷新列表」)、搜索框位于标题卡下方(y=158);其余既有断言全部通过。第十八轮(迭代 15,v0.16.0):
node --checkhost/index.js/client.js全绿;ITER4 PASS(归因 v4:空白草稿在session/created后不落盘、session/event的turn/start才写入;旧 v2 文件静默忽略;parentSession/旧会话/未使用草稿均不归因);ITER8 UI PASS(关键词 145 个/6 组、复制内容含六段 + 浏览器与 SVG 文件要求、空选择兜底、选中 chip 背景为label-primary、弹窗标题固定、复制提示等)。第十七轮(迭代 14,v0.15.0):
node --checkhost/index.js/client.js全绿;ITER8 UI PASS新增「获取提示词」弹窗断言:6 个关键词分组、145 个关键词、单选/多选切换、复制内容含六段结构 + 分身名称/简介 + 选中的「极简/蓝色系/磨砂」、空选择时出现「无额外偏好」兜底句、复制后弹窗关闭并提示已复制、滚动关键词时标题保持可见;mgr-iter4的/icon-prompt断言更新为六段模板后ITER4 PASS。第十六轮(迭代 13,v0.13.0):
node --check六文件全绿;SHELL PROBE PASS新增backMinimized:true(点返回后窗口最小化而非关闭,5 个顶栏按钮);SHELL REAL PAGE PASS(真实页面返回最小化、侧栏收起/展开正常);HEARTBEAT PROBE PASS(不派发 focus,仅靠 3s/revision心跳:11 次 revision 探测 → 2 次/sync,外部写入的工作区出现在侧栏);ITER8 UI PASS新增「复制提示词」按钮存在且右对齐(right=rowRight=1304)、点击显示占位提示;ITER11 UI PASS、ITER4 PASS回归通过。第十四轮(评审修复,v0.11.0):
node --check六个文件全绿;FIXES PASS(并发/start只启动一个进程、第二次返回alreadyStarting;/stop等待进程退出并清空 pid;日志与 registry 脱敏为token=***;/state只返回可用的运行 URL;重建失败保留旧内核;emoji 名称通过;端口越界拒绝;重复 reorder 拒绝;越权/icon403;数组 registry/attribution 备份容错;创建失败回滚目录;创建中 cancel/delete 清理干净);mgr-iter4、WSMERGE回归通过;SHELL PROBE与SHELL REAL PAGEPASS(窗口尺寸持久化、最大化图标随状态切换、中英双语、官方data-windows-titlebar窗框兼容);ITER8 UI PASS;ITER11 UI PASS(侧栏运行中角标、错误状态条可点开设置、卡片键盘 Enter、英文界面刷新按钮、首载失败浮层提示并可重试恢复)。第一轮:创建 → 复制内核(0.2.1-rc.3)→ 生成 profile → 启动 → 健康检查 200 → 停止 → 删除;实例进程无残留、端口无占用。实例内插件库添加/移除、归属写入与清理、headless Edge 全流程截图。
第二轮(迭代 1):存储位置必填 + 自定义目录(内核/profile/日志全部落在所选目录,profile 入口为 junction)、受管选择器补丁与 Windows 原生选择器 worker、工作区跨进程同步(1~2 秒内出现)、实例插件写入 profile 依赖后原生「已安装」可列出、设置页可滚动到底;
ITER1 PASS、ITER1 UI PASS、PICKER PROBE PASS。第三轮(迭代 2):
node --check全绿;ITER2 PASS(会话级归属文件合并、revision 变化、排序、accessMode、1:1 图标版本、桌面端插件增删启停、删除时清理归属文件);ITER2 UI PASS(卡片 1:1/状态条/图标按钮/单击无效/双击进设置、拖拽排序、设置内插件添加-停用-复用-移除、实例页标题与 favicon、原生「已安装」仍可用、添加插件弹窗提示且下拉半隐藏);BADGE PROBE PASS(真实持久化会话行 16×16 圆角描边徽标 + 归属悬浮行 + 会话横幅)。第四轮(迭代 3):
node --check全绿;ITER3 PASS(SVG 图标生成与 content-type、实验性插件只写不复制、/restart仅运行中且 pid 变化、会话归属 hook、删除清理);ITER3 UI PASS(实例页与插件页等宽、运行中卡片重启+停止双按钮、设置「网页/桌面」「数据」「删除」布局、AI 图标弹窗预填模板、添加弹窗 760px 且分「实验性/已安装」、实例页.im-brand=实例图标+名称、原生 wordmark 隐藏、favicon type)。第六轮(迭代 5):
node --check全绿;ITER5 UI PASS(标题与内容列同列 378=378、搜索框 582px 与筛选栏同一行相邻、工作区刷新按钮 20×20 且点击后 busy、设置两行入口「可添加 1 个 / 已添加 0 个」、添加子页标题/分组/加号、点击加号后写 profile bundles+dependencies 且 notice「已添加「终端」,重启实例后生效。」、管理子页标题/启停状态/内置插件配置);ITER5 FAVICON PASS(实例模式页面标题=实例名、品牌=实例名、全部 3 条 icon link 都被改写到/plugins/instance-manager/icon?id=inst-ui5&v=…、content-type 正确);mgr-iter4回归ITER4 PASS。第五轮(迭代 4):
node --check全绿;ITER4 PASS(后台图标任务:生成立即返回、重复拒绝、修复重试calls=2、失败保留旧图标、xmlns 注入;归属 v3:只记新会话、旧 v2 丢弃、旧会话/缺 createdAt/子代理会话忽略);ITER4 UI PASS(标题栏与卡片同列 378=378、状态小字+info 逐字提示、启动按钮 36px + 实心三角 18px 无圆环、插件分区栏全部2/实验性2/已安装0与切区过滤、AI 点生成后立即关闭并后台提示、实例页品牌/favicon 回归)。第七轮(迭代 6,v0.7.0):
node --check全绿;mgr-iter4回归ITER4 PASS;ITER6 UI PASS17 项(标题无状态小字且与内容列同列 364=364、筛选在搜索上方且搜索占满整行 960、卡片「局域网」「网页」双徽标、info 提示逐字、编辑后 1.8s 内「已自动保存」且 host 已写入、添加子页标题/960 左对齐/「图标演示插件」使用其 SVG 图标/「终端」回退 glyph、管理子页标题与图标)。第八轮(迭代 7,v0.8.0):
node --check全绿;mgr-iter4回归ITER4 PASS;ITER7 UI PASS12 项(header 与 960 列同列 365=365、筛选在搜索上方、卡片双徽标、左侧无握柄且图标贴左 12px、空闲 4s 内/state0 次/sync0 次、聚焦触发一次/sync且侧栏外部改名出现「惰性同步工作区」、启动中保留 1s 短轮询且完成后归零、插件子页两行无 meta 行且名称 14px)。第九轮(迭代 8,v0.9.0):
node --check全绿;WSMERGE PASS10 项(滞后快照保留本地新会话、无变化不发事件、其它进程新增会话时记录取并集并补索引 header、新增工作区全局 put、本地新建工作区不被滞后快照删除、增量同步不发 deleted);ITER7 UI PASS与mgr-iter4回归通过;插件添加/管理子页去掉行分隔线与外框,改为间距 + hover 底色。第十一轮(迭代 10,v0.10.0):
node --check全绿;ITER10 PASS(DSH_INSTANCE_SHELL_DIR指向测试运行时:hello.shellRuntime.installed=true、/prepare-shell-runtime就绪、/open-shell从preparing到ready、日志记录 shell pid、/close-shell关闭、再次打开仍就绪、/stop自动关窗、坏运行时通过shellError上报且 host 不崩溃);ITER8 UI PASS20 项(新增:设置里「桌面」可选、「桌面运行库」状态行存在);mgr-iter4回归通过。第十三轮(迭代 10.2,v0.10.2):
node --check全绿;SHELL REAL PAGE PASS新增侧栏按钮自测(sidebarToggle: 收起侧边栏 → 打开侧边栏 → 收起侧边栏,收起后可再展开);ITER8 UI PASS;「添加插件」行尾按钮改为无填充、1px 描边的 30px 方按钮。第十二轮(迭代 10.1,v0.10.1):
node --check全绿;SHELL PROBE PASS(独立页面:自绘栏 4 按钮、#root下移 34px、shell-icon 256x256);SHELL REAL PAGE PASS(真实 DSH 页面:栏存在、4 按钮、rootTop 34、无系统边框);SESSION SYNC PASS(真实会话目录 + projcache + 工作区记录写入 fixture home,聚焦/sync后侧栏出现「会话同步测试」工作区与会话行、行上徽标存在,follow-up 同步生效);mgr-iter4、WSMERGE回归通过。第十轮(迭代 9,v0.9.1):
node --check全绿;ITER8 UI PASS18 项(新增@fixture/dsh-desc-only:无dsh.title时行标题=包名、介绍=包描述且仍为两行;管理页空态文字居中x=364,w=960;「内置插件配置」在空态与已添加插件行上方y=130 < 228;其余工具栏/徽标/贴左/零轮询/聚焦同步回归全过);mgr-iter4回归ITER4 PASS;REAL LIBRARY PASS(真实桌面 profile 的 8 个社区插件:7 条为「包名 + npm 描述」两行、0 条标题=描述)。第十五轮(迭代 11,v0.12.0):
node --check全绿;SHELL PROBE/SHELL REAL PAGE PASS(顶栏新增最左「返回 DeepSeek Harness」按钮,共 5 个按钮;返回会隐藏当前窗口并拉起/聚焦桌面端,再点实例「打开」时通过 stdinshow复用同一窗口);ITER8 UI PASS新增两项(管理子页内点删除立即弹出「移除插件?」确认框;点设置页图标直接触发本地文件选择、不再出现 AI 菜单/对话框);ITER11 UI PASS(侧栏运行中角标改为 14px 圆形、用label-primary/bg-base反转色,深色主题下不再发白变宽;设置页图标框 72×72 无内边距、无缝隙)。
已知限制 / 后续
- 桌面窗口需要首次下载 Electron 运行时(约 158 MB,仅 Windows x64);第三方 Electron 首次运行可能触发 SmartScreen;下载失败会回退到浏览器打开并记录
shellError。 - 桌面窗口的任务栏图标来自页面 favicon:实例图标生成/替换后会自动更新,但 Windows 任务栏可能缓存旧图标,重开窗口即可。
- 归属徽标只对可交互会话行渲染(与原生一致:空白草稿行不渲染 leading 槽);运行中会话行依赖 DOM 注入,原生 DOM 大改时需要同步调整选择器。徽标只出现在实例内新建的会话上:从桌面端创建、在实例里打开/继续的会话不会被标成该实例的会话(旧版误标记录随 schema v3 失效)。
- 局域网访问 UI 与参数已实现,但未做真实第二设备联调。
- 实例插件库来自桌面端当前已安装的插件(实时扫描 profile
dependencies ∪ bundles;桌面端装了但停用的插件也能添加,与原生「已安装插件」口径一致;无dsh元数据的 helper 依赖会被跳过),社区插件「添加」仍以复制独立副本的方式实现,安装大插件会有一次复制开销。 - 存储位置迁移只在停止状态可用;迁移后旧目录清空。
- 同步策略(迭代 8,v0.9.0):窗口聚焦/可见/显示时按需同步,host 采用合并而不是覆盖(见上),因此聚焦回来后新建会话不会掉进「未分组」;增量同步不删记录,其它窗口删除的工作区要到下次宿主启动才消失。空闲时没有网络轮询(不请求
/state、/sync),也没有对工作区文件的文件观察;窗口聚焦/可见/显示时被动同步一次,workspaces侧栏由 host 重放的domain/changed更新。限制:两个窗口并排时只有聚焦的那个更新;长时间停留在同一窗口不自动刷新;启动/停止/AI 图标进行中才有 1 秒短轮询。客户端仍保留 1.5s 的轻量 DOM tick(扫描会话行徽标、纠正标题/favicon/品牌,不发网络请求),以及 body 级 MutationObserver,后续可收敛到侧栏容器。 - AI 生成图标入口已移除:设置页点击图标直接选择本地 PNG/JPG;行尾「获取提示词」只负责生成/复制提示词,不直接调用模型(/generate-icon、/icon-prompt 接口保留给外部工具)。
- 与 billion-context 的兼容:开启「局域网访问」后实例页面的 origin 是局域网 IP,bili 面板要求本机回环或在其配置里打开
security.adminRelay: true(bili 官方远程访问路径),因此面板会显示「远程地址无法访问本机代理」。要么关闭局域网访问让实例走 127.0.0.1,要么按 bili 配置开启 relay;本插件不替第三方改配置。 - 旧实例(v0.2.0 及更早)无向前兼容:归属改用按实例文件后,旧实例的工作区级归属不再显示(用户已确认开发前会删除旧实例)。
No comments yet. Be the first to write one.