保持共享库存 v2 与旧版可读普通日志,从真实入口派生启停;隔离扩展日志并保护恢复时的合法后续写入。修复 Windows 库存/日志原子替换及目标锁的短时共享冲突,不删除原数据、不抢占活锁、不重放事务。 补充安全探针诊断与仅公共下载内容的 CI 缓存,Profile 和安装状态仍逐次隔离。准备 CLI 0.3.0 / DSH 0.6.0,npm 发布另行执行。 最终提交的 CLI 三平台、DSH 14 项矩阵及 12 份启停场景摘要均通过。Windows 新 RC 依赖准备仍接近限额,作为 CI 准备稳定性风险保留。 Signed-off-by: XiaoSeS <87064762+XiaoSeS@users.noreply.github.com>
41 KiB
0. 固定兼容基线与贯通
- 0.1 固定 DSH 发行版、peer/Node 范围、构建格式,记录源码与发行产物对应。(固定 RC.2 研发与验收组合;官方标签/源码清单与三个 npm 包的完整性及 55 个本地文件核对通过,见 verification.md。正式支持与发布门禁仍归 10.1/10.4/10.5。)
- 0.2 验证独立 Bundle、Host/Client、Remote 生成产物与 Client 显式挂载,不修改官方 api-remotes。
- 0.3 验证 main/sidebar.panellist、bundle 配置保存、依赖重载和 disposer。(Linux 原生配置重启持久化、干净 Bundle 页面/Host 双端生命周期及订阅释放通过;当前包 Windows 两轮 Bundle 生命周期复核通过,见 verification.md。不代表 0.1 的正式版本基线或三平台验收完成。)
- 0.4 实测 Registry 匿名列表、详情、版本、SKILL.md、评论和下载;记录安全审核匿名拒绝及可选模块能力。(本地开源预览实例通过,见 verification.md;非当前工作树部署或 SaaS 验收。)
- 0.5 验证可信用户/项目根、自定义 DSH_HOME 与 Host 策略;在隔离临时目录放置测试夹具验证发现接口,不依赖插件安装事务。
1. 原生包与服务边界
- 1.1 同仓库 plugins/dsh 建立独立包,包含 Host/Client/patch/Remote 产物和许可证。
- 1.2 增加无 CLI main/process.exit/登录读取副作用的内部消费入口,保持 CLI 兼容。
- 1.3 实现 Registry 地址与可选 Tab 配置、sourceRevision、错误归一、RemoteResult 映射与清理。(配置重启持久化、来源切换与晚到响应隔离、Host 释放和 HTTP 错误矩阵已有证据;补齐广场结构化提示及 Retry-After 等待,当前 Windows 实包验证通过,见 verification.md。)
2. 浏览与详情
- 2.1 实现浏览/已安装两个 Tab、独立详情子页面和左上返回,保留列表、筛选、滚动与焦点。(Linux 干净包导航记录及当前 Windows 实包导航回归通过,见 verification.md;完整窄屏与错误场景仍归 2.5。)
- 2.2 实现真实目录范围、搜索、精确版本详情和安全 Markdown,无假分页/指标。(当前 Windows 实包的 55 匹配/20 返回、固定版本真实请求、安全渲染和详情窄屏通过,结合此前搜索与真实 Registry 契约证据;见 verification.md。)
- 2.3 实现详情/版本/安全审核/评论及 auto/show/hide;区分探测与正文懒加载,不改服务端访问政策。(Host 请求矩阵、浏览器成功/空集合/拒绝/错误、配置即时切换与重启持久化见 verification.md;不扩展平台或 SaaS 支持声明。)
- 2.4 实现本地已安装投影、两个范围、部分失败与离线固定版本详情。(实现与 Linux 实机证据见 verification.md;其他平台及其余异常界面仍由 5.3/5.4 验收。)
- 2.5 完成窄屏、键盘、加载/无数据/拒绝/网络错误和返回会话。(广场状态及 390px 真实安装/升级/卸载回归、详情/抽屉键盘和返回焦点、结构化错误提示通过;证据见 verification.md。不代表宿主移动端导航或完整无障碍认证。)
3. 安装核心与操作协议
- 3.1 实现可信目标、完整包下载、归档/指纹/DSH 格式校验,首次安装不覆盖。(目标/策略/格式、归档和原生安装定向检查 76 tests / 322 assertions 通过;结合真实 Host 用户/项目安装及完整资源核验,见 verification.md。恢复全矩阵仍归 3.4/5.2。)
- 3.2 下载前锁内幂等检查、提交前重校验、锁顺序与 inventory CAS;同 key 恢复 operation。(操作存储/锁/清单定向回归及已有原生并发实机文件证据通过,见 verification.md;不替代 3.4/5.2 全故障矩阵。ce310918b 跨平台 CI 新发现两个进程恢复同一过期清单锁时丢记录;已确定性复现并修复临界区重叠,新增有界等待;最终共享 CLI 703 项回归通过(inventory-stale-lock-result.json),修复提交
9d6c91205的六项跨平台 CI 全部通过(ci-9d6c91205-result.json),本项关闭。) - 3.3 实现升级/卸载 prepare-execute、5 分钟 plan TTL、来源/项目/记录变化失效和参数重放检查。(计划与完整目标升级定向回归及实际 Host 双目标升级/恢复证据通过,见 verification.md;不替代 5.2 全故障矩阵。)
- 3.4a 共享核心加入可等待事务观察器、确定 backup/staging 路径和提交后告警;统一 CLI/插件 canonical lock helper,避免双重取锁。
- 3.4 实现本地原子操作日志、正常关闭和崩溃恢复核验,未解决恢复状态阻止新写。(当前 Linux 真实强杀/恢复矩阵、日志及关闭排空 65 tests / 805 assertions 通过;结合 Windows 实际 Host 强杀恢复,见 verification.md。5.2 场景清单及平台门禁仍分别验收。)
4. 升级与卸载
- 4.1 主动检查更新,保留版本比较、同版本不同内容和未知顺序阻断;不自动检查全部条目。(见 verification.md及“交付缺口核对”。)
- 4.2 实现精确完整目标集合升级;用户确认全部允许目标,其他 Agent/项目和共享来源阻断。(计划与完整目标升级定向回归及实际 Host 双目标升级/恢复证据通过,见 verification.md;不替代 5.2 全故障矩阵。)
- 4.3 升级复用受保护替换与备份恢复;allowTargetDrift:false、锁内版本/所有权/目标集 CAS。(计划与完整目标升级定向回归及实际 Host 双目标升级/恢复证据通过,见 verification.md;不替代 5.2 全故障矩阵。)
- 4.4 新增精确单目标卸载,不直接使用 Agent 范围删除;目录缺失只接受 ENOENT。
- 4.5 实现同盘隔离、清单提交与恢复,逻辑卸载完成但残留清理失败单独反馈。(真实权限拒绝、清理残留恢复及此前 Host 重启恢复证据见 verification.md;完整故障边界继续由 5.2 验收。)
- 4.6 失效记录清理须独立明确确认,不删除未知目录,不影响其他 targets 或远端技能。
- 4.7 完成升级计划和卸载确认 UI,刷新本地列表/详情,文件与发现/加载结果分开显示。(见 verification.md及两项键盘焦点修复;完整故障和平台矩阵仍由 5.2/5.4 验收。)
5. 验证与交付
- 5.1 运行插件 typecheck/lint/tests/build;共享 CLI 改动运行 make test-cli、make typecheck-cli、make lint-cli、make build-cli。
- 5.2 完成生命周期分册的并发、故障注入、恢复、响应丢失和完整性验收矩阵。(§7.1 提交边界及 §9 业务场景逐项关联源码测试/实机证据,见 verification.md;平台支持仍单独受 5.4 限制,不声明所有平台全故障组合通过。)
- 5.3 实际 DSH 浏览器验证导航、Tab 配置、安装、更新检查、升级和卸载;通过插件在测试目录安装并使用至少一个带资源技能。(逐项证据及独立审计见 verification.md;真实 Registry 模型使用、其他平台/远程与剩余对话验收仍分别保留。)
- 5.4 干净 tarball 在 Linux/Windows DSH Web 验证,远程单用户明确在 Host 落盘。macOS 按用户决定延后验证,不阻塞本轮验收,也不计为已支持平台。(历史 Linux/Windows 搜索条目与窄屏实包回归通过;最终候选 6b998d95 已在独立 Rocky Linux Host 经本机浏览器真实完成用户/项目两范围安装,文件与本机不落盘观测见 remote-host-acceptance-result.json。尚需最终候选 Windows Web 对新增会话依赖及操作详情的针对性回归;Host CI 不代替该浏览器出口。)
- 5.5 如增补后端接口则完成 API/后端对应检查;不擅自放开匿名审核。(已有路由的 OpenAPI 补齐、27 项后端测试和生成类型核对见 verification.md;无权限策略变更,不替代部署或 SaaS 验收。)
- 5.6 更新中英文指南、限制/恢复说明、包与平台证据;review 后回写 verification.md。(见 verification.md;环境及发布门禁继续由 5.4、7.4、9.5、10.x 验收。)
6. 首期对话交互(追加范围)
- 6.1 M0 验证官方工具注册、搜索/安装 ToolView、运行中状态、toolCallId 与异步操作引用协议。(官方工具执行、真实卡片及流事件阶段证据、当前 10 tests / 99 assertions 见 verification.md;真实模型与停止按钮仍归 6.6。)
- 6.2 注册只读搜索工具和显式安装工具,共用 Host 服务及稳定 requestKey;不实现对话自动升级卸载。(当前工具/历史契约测试及真实 Host ToolView、来源失效和双入口并发证据通过,见 verification.md;真实模型行为仍由 6.6 验收。)
- 6.3 搜索卡片、详情抽屉与广场共享详情内容、Tab 配置、目标选择及安装状态。(广场与抽屉复用 DetailContent/InstallControl;见 verification.md。真实模型交互仍由 6.5/6.6 验收。)
- 6.4 安装自定义结果卡片、历史快照、当前状态核验、来源/项目过期保护与双入口并发去重。(当前工具/历史契约测试及真实 Host ToolView、来源失效和双入口并发证据通过,见 verification.md;真实模型行为仍由 6.6 验收。)
- 6.5 补充对话搜索卡片、详情抽屉与安装结果的界面设计图,并完成实机交互验收。(实际宿主界面图、整条候选点击、键盘/窄屏及结果卡片证据见 verification.md。)
- 6.6 验证只搜索不写入、明确安装、歧义选择、关闭抽屉、取消工具等待、断线重开和失效记录行为。(七项要求与真实模型/历史浏览器证据逐项映射,见 verification.md;不扩展平台或模型安全保证。)
- 6.7 补齐 Host 重启后历史搜索卡片的显式“重新查看详情”:从可信会话历史重建候选、重新核验来源和版本、签发新引用;旧安装授权不继承。已补齐显式重开与可信历史校验,192 项全量测试及真实持久会话重启浏览器验收通过,见 verification.md。
7. 共享契约补齐(实施依赖)
- 7.1 先建立持久 hostInstanceId、OperationContext、requestDigest 和已接受记录查重顺序,再开放写入口;增加过期 token/来源变化/重启后的同 key 恢复测试。(持久记录与 Host 提交顺序核对、来源切换后的原回执保留及重启重试测试通过;见 verification.md。不替代真实模型或平台验收。)
- 7.2 实现 openConversationDetail/acknowledgeConversationDetail 与原搜索引用到已查看固定版本的关联;多版本歧义阻断,不静默解析 latest。(实现及定向测试已补齐早期验证记录中的缺口,见“交付缺口核对”。)
- 7.3 安装工具仅返回 accepted;结果卡片从共享 OperationStore/getOperation 展示终态,历史来源、主机、时间来自原快照。(接受成功仅为 accepted;拒绝为 not-confirmed,见“交付缺口核对”。)
- 7.4 按 acceptance.md 逐组留证;阶段顺序以 implementation-design.md 第 9 节为准,日志恢复不后置到写入口上线以后。
- 7.5 补齐 lifecycle-design.md §9 与 interface-design.md §5.2 的操作结果展示:原日志投影受影响目标、旧新版本及安全告警,四个入口复用安全详情。最终候选 6b998d95 的双目标升级成功与中断恢复两条真实 Host 链路通过,包含重启后原 operationId 查询、UI 新版/未知版本文案、完整文件和清单核验;插件 201 项测试通过,见 operation-details-host-result.json。验证使用原标签页、同 origin 的有效入口显式重新进入,不代表自动重连;官方 RC.2 无插件同端口重启的空白页问题保留至 10.1/10.5 兼容出口。不得透传事务内部路径或原始异常,不以当前清单状态冒充原操作结果。
8. 原生机制落地检查
- 8.1 核对并固定 npm 包、Host/Remote、面板和工具 ID;检测已安装参考插件的同名冲突,不替换其工具/视图。(Loader 冲突已修正;固定参考包 0.2.16 的 Host 与浏览器两轮共存通过,工具及视图对象未被替换,见 verification.md。不代表参考插件全部业务或真实模型选择已验收。)
- 8.2 验证工具逐参数 schema 的额外字段和互斥输入校验、exec.callId/agent 归属,禁止模型提供文件路径。(官方 defineTool 执行包装及 Host 契约定向测试通过,见 verification.md;模型意图判断仍归 6.6。)
- 8.3 验证 ToolView preparing/start/result、纯 presentationMeta 重放、未知 schemaVersion 的保守展示。(官方流式/持久事件驱动的 Windows 实机三阶段、纯元数据结果及未知历史刷新验证见 verification.md;不代表真实模型行为已验收。)
- 8.4 共享 OperationStore 对同一操作合并可见订阅;单次在途查询、隐藏暂停与重新可见刷新,重载释放资源。(Windows 实包双卡片单次在途查询、隐藏/显示及三轮重载证据通过,见 verification.md。)
- 8.5 检查 Host bundle 的导入闭包与 Client external;在干净 tarball 验证 Remote 生成物及无 CLI/Bun 运行依赖。(包检查、无可执行工具 PATH 的 Node 安装恢复、实际 tarball Host/Remote/浏览器加载证据见 verification.md;不替代三平台或公开发行包验证。)
上述细化归属原 M0–M4,执行顺序与 E01–E07 切片见 engineering-blueprint.md,不视作新增产品范围。
9. 发布与 API 同步
- 9.1 建立独立插件发布工作流及版本标识,隔离现有 CLI、镜像和 Chart 发布触发条件。(工作流及发布策略本地验证通过,见 verification.md;未执行远程 CI、配置发布环境或实际发布,候选与公开包验收仍归 9.5。)
- 9.2 完成插件 README 的实际构建、tarball 安装、升级、禁用与回退命令,并在目标 DSH 发行版验证。(RC.2 开发产物安装/替换/回退、待恢复事务回退及两轮 Plugins 开关验收已通过;双语指南与实际打包复核见 verification.md。正式发布包和跨正式插件版本的支持承诺仍由 9.5/10.5 验收。)
- 9.3 维护 Registry 公共 OpenAPI 与匿名契约测试,明确新增接口及已有接口复用范围。(DTO/原始流/下载跳转注解、实际 /v3/api-docs 断言与生成类型同步通过;见 verification.md。无新增路由,不替代部署实例验收。)
- 9.4 提供 SaaS 同步变更清单,分别记录开源与 SaaS 必需/可选能力结果;未同步不声明兼容。(registry-api-contract.md §3.2–3.4 给出实际变更范围、分实例状态与执行交接;SaaS 明确未验证,不声明已兼容。)
- 9.5 完成候选包和已发布包的干净安装检查、兼容矩阵、发布说明与回退演练。
执行方式见 release-guide.md;服务端契约与同步顺序见 registry-api-contract.md。
10. DSH 兼容性
- 10.1 以 0.2.0-rc.2 为首选候选完成 M0;通过后固定唯一首版 DSH 基线及对应发行依赖、Node 和生成器。存在必需能力缺口时先评估并更新基线决策。
- 10.2 在现有宿主适配器集中处理上下文/发现/Remote/UI 差异,业务安装核心不按 DSH 版本分叉。(当前源码边界核对与定向回归见 verification.md;首版不增加多版本分支。)
- 10.3 实现版本与能力判定、未验证版本写入限制、项目级/入口降级和用户提示。(自动化测试及双入口/配置 Windows 实机证据见 verification.md;不替代正式支持基线、三平台或真实模型验收。)
- 10.4 建立单一 DSH 基线的平台 CI 矩阵及隔离 Profile 夹具。最终代码提交
9d6c91205的 Linux/macOS/Windows × Node 24.2/24 六项 CI 通过并归档 ci-9d6c91205-result.json。macOS 产品验收仍按用户决定延后,CI 通过不声明产品支持。多版本兼容和新发行版前瞻检查不作为首版任务。 - 10.5 根据通过结果确定精确 peers/engines 和唯一宿主支持基线;验证宿主升级、依赖混装、插件回退与日志兼容。
11. 已确认紧凑头像原型落地
- 11.1 接入局部 shadcn/Radix 组件与 DSH 主题,复用宿主 React/React DOM,验证无全局样式污染。
- 11.2 实现 232px 卡片、首字符头像、真实可选统计及分页来源/旧来源两种模式,补充契约与边界测试。
- 11.3 统一详情、已安装和对话控件风格,加入明确安装确认,保留现有安装/升级/卸载/恢复协议。
- 11.4 插件完整检查与隔离真实 DSH 浏览器回归,记录实际覆盖、预览入口及未验证项。(213 项测试通过;Linux RC.2 隔离 Registry 的分页、异常、生命周期、主题与共存验证通过,最终 v3 快速回归通过。Windows/macOS 新 UI 和 SaaS 验收不在本轮覆盖范围,见 verification.md。)
实现顺序为目录契约与组件适配、页面接入、自动检查、真实宿主验收。改动限定于 plugins/dsh 和本 OpenSpec;不修改 CLI 安装事务、服务端权限或登录流程。截图、运行日志和测试安装包保存到仓库外,规格只保留摘要。
12. refined-v2 视觉原型落地
- 12.1 还原 192px 卡片、38px 头像、紧凑工具栏与关闭入口,保留来源辨识。
- 12.2 全部下拉接入局部主题的 shadcn/Radix Select,详情内容卡与版本/评论/状态页完整还原。
- 12.3 自动检查与真实 DSH 验收:尺寸、主题、标签、分页、Select、嵌套弹层及安装生命周期;更新验证记录。
本轮不修改 Host/API 或安装事务,不引入原型示例数据与缺少接口支持的分类功能。
13. 指定版本与安装管理产品化
- 13.1 广场选择精确版本重新获取详情及 token,对话提供经验证的广场入口,保留冲突和升级保护。
- 13.2 安装当前状态与历史回执分离,已安装卡片强化层级,干净终态操作记录折叠,异常与恢复入口常显。
- 13.3 修复隔离预览版本数据一致性,验证选择版本、确认、状态变化、历史记录及深浅主题。
14. 详情操作侧栏与公开标签
- 14.1 已安装详情的读取、更新检查和时间集中右侧卡片,缩小辅助文字。
- 14.2 接入真实公开标签目录与服务器筛选,紧凑单选标签及分页/来源/不可用保护。
- 14.3 定向契约测试、完整插件检查及真实宿主筛选/侧栏验证。(来源晚响应由自动测试验证;当前预览 Profile 禁止编辑 Host 配置,来源切换的浏览器用例未执行,见 verification.md。)
15. 对话卡片与完整演示
- 15.1 对话搜索专属紧凑卡片、操作栏间距与来源时间层级,安装结果状态分层。
- 15.2 补齐隔离演示会话用户消息与说明,明确演示边界;真实宿主验证详情、确认、取消与窄屏。
16. 人工反馈:无需打开详情的对话安装
- 16.1 分离真实展示与 Host 安装核验,支持未展示的有效搜索引用,保留精确版本及上下文保护。
- 16.2 补充边界测试与独立评审,运行完整插件检查。
- 16.3 新包真实 Host 不打开详情实际安装,核对 completed、库存、文件哈希及 DSH 发现;单独记录免费模型验收结果。
- 16.4 同步 OpenSpec 并整理人工发现、方案、实现和效果案例,链接仓库外原始证据。
17. 紧凑安装状态卡与技能中心入口
- 17.1 实现状态标识、简洁成功卡及安装记录折叠,保留异常和历史状态边界。
- 17.2 侧栏改为技能中心并使用专用 SVG,内部品牌及标识保持一致。
- 17.3 自动检查与独立状态评审;真实宿主浅深主题、窄屏、记录展开及导航只读验证,更新预览和证据。
18. 技能中心加载骨架
- 18.1 来源、目录首次加载及详情加载保留布局,加入主题骨架与减少动画支持。
- 18.2 核对真实Host响应,检查延迟/错误/后台刷新及深浅窄屏,更新预览和验证记录。
19. 人工反馈:只展示核心安装信息
- 19.1 安装回执压缩为身份、版本范围、状态与一句结果,统一核验入口,技术记录默认折叠。
- 19.2 验证历史状态、必要异常提示及展开收起,更新真实预览与证据。
20. 配置入口绑定修复
- 20.1 配置表单绑定真实 Host entry ID,增加构建产物契约测试。
- 20.2 验证真实插件详情可读取和编辑 Registry 地址,保留原来源及会话。
21. 配置页视觉优化
- 21.1 复用shadcn卡片和表单控件,优化分组、间距、状态反馈及加载占位。
- 21.2 验证构建、真实宿主深浅主题和窄屏、未保存修改重置,更新预览。
22. 来源连接测试与小号按钮
- 22.1 实现草稿地址只读连接测试、总超时、取消与结果隔离,缩小配置页按钮。
- 22.2 增加接口和状态测试,验证真实宿主成功/失败及无配置写入,更新预览。
23. 部署文档与PR材料收尾
- 23.1 归档研究、运行结果与旧设计资产,保留正式设计图和可复用回归测试,修复引用。
- 23.2 完善部署、验证与回退说明,校验正式文档及包内容。
24. PR评审问题修复
- 24.1 安装范围独立降级,保留共享清单异常保护;已安装引用生命周期与列表保持一致。
- 24.2 安全收尾无写入意图的中断安装;幂等安装使用只读历史基线核验发现状态。
- 24.3 统一接口与回执折叠文档,补边界回归并完成插件和共享核心检查。
25. 0.1.0合并与独立npm发布
- 25.1 确定0.1.0候选、可发布manifest、空默认来源及正式npm安装文档,保留平台限制。
- 25.2 提交清理与修复,最终PR提交CI通过后合并并记录main提交。
- 25.3 从确定的合并提交构建候选,完成干净DSH验收、包校验与发布权限核验。
- 25.4 确认精确发布候选后创建独立tag,经审批发布npm,校验公开包并执行干净安装回归。
26. 正式包验收后的兼容性与历史回执修复
- 26.1 明确支持同一 DSH RC.2 下的 Cordis 4.0.4/Loader 1.0.5 与 Cordis 4.0.5/Loader 1.0.6 两组组合,保持未知及混装依赖拒绝写入。
- 26.2 兼容测试分别覆盖保留基线和普通新装,核对实际 Host 解析路径与当前清单,避免只检查顶层 peer。
- 26.3 历史安装回执在原操作归属验证通过后,以当前来源 revision 查询库存和导航;来源/会话/项目变化及旧写引用仍拒绝。
- 26.4 补齐重启、来源切换、逆序响应、已升级/卸载及零重复写入回归,并复测真实 Host 与页面。
- 26.5 更新支持说明、验收摘要及 PR;本修复阶段未升级版本号或发布 npm,正式补丁交付见第 27 节。
27. 0.1.1 补丁版本发布与公开包验收
- 27.1 固定
0.1.1manifest 与安装文档,更新发布说明和兼容范围,保留0.1.0已知问题与验收边界。 - 27.2 从最终提交以冻结锁安装依赖,完成插件完整检查、OpenSpec 严格校验、72 文件包审查及私人路径扫描,记录候选校验值。
- 27.3 最终提交六组 CI 通过,按授权创建
dsh-v0.1.1并执行专用 npm 发布;上传成功,工作流后续公开读取超时已记录并完成事后校验,未重复发布;未发布 CLI、镜像或 Chart。 - 27.4 下载 npm
0.1.1公开包并核对latest、manifest、完整性与全部交付文件;公开读取传播延迟单独记录,不重复上传。 - 27.5 公开包干净安装、15 项页面/重启用例、直接选择第二项安装及正式 0.1.0→0.1.1 升级通过;旧回执核验和导航通过;不调用模型、不以本地模拟市场代表生产或 SaaS。
- 27.6 回写最终提交、CI 与公开包验收结果,保留原技能、清单、操作日志和可恢复安装包;未验证平台明确列出。
28. 搜索候选的本来源安装状态
- 28.1 复用可信安装投影,向对话搜索返回按来源、namespace/slug 匹配的范围、版本、异常及查询时间;本地读取失败降级未知,上下文变化拒绝旧结果。
- 28.2 技能广场与对话卡片展示紧凑状态,兼容旧历史;会话/来源隔离与安装管理后的缓存失效保持一致。
- 28.3 验证多范围、多版本、其他来源/命名空间、异常记录、不完整查询、历史快照与无敏感路径;插件构建、typecheck、lint 及 295 项测试通过,浏览器组件夹具 12 项检查通过。不作为正式包已发布声明。
- 28.4 提供 SaaS Agent 交接 Prompt,区分服务端 HTTP 适配与本机安装状态识别,列出必需/可选接口及独立部署验收要求。
- 28.5 候选包在隔离 Linux DSH 0.2.0-rc.2 中完成真实工具搜索、双范围安装、外源及异常状态检查、页面安装/升级/卸载后标记刷新、来源切换和重启历史重放;8 个阶段快照及 9 项宿主页面检查通过。探针说明见集成测试 README;SaaS、Windows/macOS Host 验收尚未执行。
- 28.6 使用真实 astron-code-latest 完成搜索识别、明确项目安装及重新搜索复查,3 轮对话、6 次模型请求通过;跨项目记录未泄漏,真实安装文件和资源已核对,完整模型对话保留并经浏览器核验。仍使用本地市场数据,不扩大为真实 SaaS 或线上技能执行验收。
29. 0.2.1 默认正式 Registry
- 29.1 使用公开 npm 0.2.0 对正式域名执行真实 DSH 固定版本安装,核验文件、fingerprint、inventory、搜索安装状态和 DSH 发现;9 项浏览器检查及真实卸载后的库存/搜索清空与发现消失通过,日期版升级按 unknown-order 阻断且文件不变。本轮不调用模型。
- 29.2 Host Schema 缺省为正式域名,保留显式空白断开和自定义来源;同步双语文档及连接契约。
- 29.3 配置边界测试、完整插件检查(299 项测试)、OpenSpec 校验及 0.2.1 干净候选默认来源验收通过(74 个文件一致、3 项浏览器检查);已有显式来源从 0.2.0 升级后的 11 个技能文件、metadata、inventory、历史会话逐字节保留及状态识别通过;空白保存后重启仍断开通过,自定义来源保存与重启保留以及页面连接测试通过。
- 29.4 完成 PR、六组 CI、专用 npm 发布及公开 0.2.1 包核对和安装验收;保留既有技能与对话。
30. 市场操作、详情阅读与范围确认
- 30.1 卡片整体导航、独立安装管理操作、多范围选择和中文内建标签;未安装记录不占状态区。
- 30.2 Markdown frontmatter 隐藏与阅读样式;移除全局可选模块重查按钮;详情与 Tab 有界缓存及旧凭据恢复。
- 30.3 未指定范围的对话安装先展示选择 UI,保持显式范围安装和幂等写入保护。
- 30.4 开源版本 API 增加可下载过滤与全局排序,分页和 total 保持一致;更新生成契约与 SaaS 同步说明。
- 30.5 完成插件、后端、浏览器及真实模型对话验收,记录范围和未验证边界;本轮不部署 SaaS、不发布 npm。
31. 直接安装确认与输入框旁原生范围选项
- 31.1 市场和对话降级入口使用紧凑确认弹窗,保留原安装事务、取消及焦点恢复。
- 31.2 接入宿主 userQuestions 非计时问答;准确范围回答才提交,取消、异常、上下文变化与重复调用安全处理。
- 31.3 补齐行为测试、真实 DSH 浏览器与真实模型验收,更新协议、文档和验证边界。
32. 安装弹窗向右扩展进度
- 32.1 确认后保留弹窗,左侧固定信息、右侧精简进度;窄屏堆叠、减少动态和焦点处理。
- 32.2 复用原幂等请求与操作读取,结束状态刷新去重,后台核验保留卡片内容。
- 32.3 完成完整插件检查、真实 DSH 延迟安装浏览器验证和预览更新,记录证据。
33. 当前安装状态、范围与卸载入口
- 33.1 当前库存优先,已完成历史回执退出安装控制区;已有安装优先选中对应范围。
- 33.2 精简范围文案,详情和弹窗补齐目标明确的卸载/管理入口,保留原确认保护。
- 33.3 用户级安装、范围切换、卸载、历史回执与再次安装的真实浏览器回归及完整插件检查。
34. 原地卸载与精简确认弹窗
- 34.1 市场与已安装列表卸载原地打开弹窗;详情卸载不再跳转其他详情页。
- 34.2 复用原核验、计划、幂等请求和恢复逻辑,统一 Radix 样式与精简内容。
- 34.3 完整插件检查与真实浏览器取消、确认、范围、焦点、窄屏、真实文件及恢复预览验收。
35. 选定版本升级与完整更新验收
目标:修复详情切换到较新版本后缺少升级入口,保留已有最新版本升级和完整目标事务。假设:切换只读,不自动执行;只支持可靠比较的向上升级,不支持降级。影响插件 Host 类型化方法、版本详情、升级确认、库存缓存和文档,不修改 SaaS 或 CLI 事务规则。
- 35.1 增加精确选定版本检查/计划接口,旧最新版接口保持兼容,固定版本不可退回 latest。
- 35.2 详情升级入口与精简原地确认;相同、旧版、不可排序和不可访问版本明确反馈。
- 35.3 Host 绑定、候选固定、取消、失败与 UI 状态测试;完整构建和 OpenSpec 校验。
- 35.4 真实本地版本安装→非最新版定向升级→最新版升级,核对文件、metadata、库存、取消与保护行为;保留可人工 review 的预览。
36. 0.3.0 合并与 npm 发布
- 36.1 同步主线,独立评审和最终检查通过后合并 PR(#986)。
- 36.2 使用
dsh-v0.3.0tag 执行官方 npm 发布工作流;上传后等待扫描完成,独立验证公开包与 CI tarball 一致。 - 36.3 公开包完成官方隔离 Profile 安装及生命周期验收;现有预览升级并核对会话和技能文件保留。
37. Issue #981:DSH 双 RC 兼容
- 37.1 显式支持
0.2.0-rc.2与0.2.1-rc.2,要求 Host、Client 及核心模块同版,未知或混装继续拒绝写入。 - 37.2 固定共同格式生成器,运行时协议由对应 Host 提供,补齐共同 RPC ABI 与严格参数、返回及取消契约测试。
- 37.3 更新兼容矩阵和新 RC CI 入口,保留旧版平台/Node 及 Cordis 回归。
- 37.4 同一冻结候选在两版官方 Host 上完成严格 peer 安装、生命周期及浏览器交互验证;用户/项目两个范围均完成安装、升级、卸载及取消核验。
- 37.5 独立完整 diff Review、运行时代码 CI 与验收证据闭环;结果和平台边界见 acceptance.md。候选仍未发布,合并与 npm 发布另行授权。
38. 0.3.1 兼容修复发布
- 38.1 将包版本及双语安装、发布说明更新为
0.3.1,完成候选检查与发布准备 PR(#995)。 - 38.2 使用
dsh-v0.3.1和专用工作流发布 npm,核对实际上传产物、公开版本和完整性。 - 38.3 从 npm 下载公开包,完成隔离 DSH 安装与关键操作复验,并记录已验证平台及未验范围。
39. 使用此技能
- 39.1 完成真实宿主输入框与技能发现研究,更新产品、接口和正式需求;创建并维护本地 Trellis 任务。
- 39.2 Host 提供只读使用核验,绑定当前来源、记录、范围与会话,核验文件完整性、实际技能与用户调用规则。
- 39.3 已安装卡片/详情/安装成功提供统一入口;保留原生草稿和附件、回到会话并聚焦,不自动发送。
- 39.4 补齐竞态与阻止分支测试,完成完整插件检查及两版真实 DSH 浏览器验收。
- 39.5 独立 Review、清理公开 diff 并保存任务证据,回写验证结果;本期不发布 npm。
40. 技能专属使用案例:固定文件协议
- 40.1 对照官方资料与本机 WorkBuddy 文件,区分已验证的多案例元数据与尚未核实的内部 API/刷新机制。
- 40.2 确认固定
.skillhub/examples.json、单份随包发布、自动识别、无 Web 编辑入口及无效协议按普通文件处理;替代此前缓存/独立刷新方案。 - 40.3 更新需求、设计和领域术语,补齐正式验收场景;本轮仅文档调整。
- 40.4 冻结 JSON schema、有效/空样例、边界限制和按语言标签组织的 id/title/prompt 多语言案例对象、{{skill}} 替换与明确回退规则;明确复用文件 API、拟新增 Remote/预检投影、内部 metadata 上传处理与旧消费者不透明兼容策略。见 skill-examples-design.md;这里只完成设计,不表示代码或跨版本验收通过。
- 40.5 实现共享核心指纹/目录/发布规则与 CLI、Web、服务端包处理一致性;覆盖升级、卸载、同步、恢复及套件。
- 40.6 实现当前安装版本的案例读取、模板选择和自定义草稿衔接,不新增独立刷新和自动发送。
- 40.7 完成跨端生命周期、双 DSH 基线、旧技能和旧消费者兼容验证,记录实际支持边界与剩余缺口。
40执行与SaaS交接补充
- 40.8 确定开源P0–P5执行范围、依赖和验收,提供SaaS增量交接Prompt;本项完成仅代表方案交付。
- 40.9 【后续,非本轮开源门禁】SaaS Agent核对真实仓库并提交差异表/适配PR,完成测试环境与新消费者联验;部署与生产验收另记,不纳入当前开源本地完成状态。
执行权威见 skill-examples-execution-plan.md,协议见 skill-examples-design.md;40.5–40.7开源实现与本地验收已完成,详见 verification.md;SaaS、原生 Windows/macOS、真实模型及发布保持独立验收。
41. 原生新对话与输入框案例选择
-
41.1 确认技能中心新建同工作区对话、对话入口保留当前会话、输入框上方案例区与取消/无案例边界,同步正式设计与场景。
-
41.2 核对两版官方会话创建/导航和输入框 slot,落实所有入口的统一内联选择、严格安装身份重读、去重与导航失效保护。
-
41.3 完成相关行为测试、插件完整检查和双基线真实浏览器验证;保留原会话草稿/附件并确认无发送/模型调用,更新预览与结果。
-
41.4 对每语种20条、最长标题/正文进行真实宿主布局压力验证,确保固定操作区、列表独立滚动、行高不压缩、长词不横向溢出;检查矮窗口与窄窗口。
-
41.5 修复模板填入空输入框时多出首行空白;验证已有换行、中文/emoji、原生引用及附件保留,完成双 RC 浏览器复验。
-
41.6 最终独立评审修复对话详情弹层阻挡案例选择及 Windows 分隔符 ZIP 目录识别;补相应回归,核对最终产物与正式协议。
42. 对话管理已安装技能
-
42.1 确认默认用户级、项目级高级入口、多份时选择,以及按安装位置独立更新的产品范围。
-
42.1a 冻结逐位置库存、迁移、旧消费者与恢复契约,完成实现设计评审。
-
42.1b 适配共享核心、CLI、同步及套件,验证不同位置版本与未选位置不变。
-
42.2 实现当前来源安装查询与检查更新工具,保留范围、异常状态及历史引用边界。
-
42.3 实现原生目标选择、更新/卸载确认与统一结果卡,复用 Host 和安装核心。
-
42.4 完成取消、并发、过期上下文、本地修改和来源隔离回归,以及双 RC 浏览器验证。
-
42.5 独立记录真实模型验收、更新操作说明和验证结果;发布另行安排。
-
42.6 人工评审:区分查询列表、更新检查与简洁结果条;严格验证全部历史卡片按钮,增加显式只读刷新且不自动重绑写入。
-
42.7 人工验收反馈:移除正常结果常驻刷新和冗余说明,压缩安装行、更新检查与终态回执;保留失效重查及安全确认,验证实际宿主展示。
-
42.8 按已批准原型实现同技能分组、组内位置选择、紧凑尺寸和场景按钮策略;验证异步切换、确认目标、旧引用保护与双 RC 实际交互。
-
42.9 真实 DSH 多技能双列布局,验证菜单边界及窄屏;交替按钮与真实模型后续轮次,验证新查询、历史引用及更新/取消隔离。
-
42.10 修复真实 DSH 更多菜单展开挤乱按钮行的问题,验证多卡/窄屏/缩放、键盘与原目标操作矩阵,打开正确的真实模型会话供人工验收。
-
42.11 统一单份/双份安装卡片三行布局与正常等高,列表按6条展开;真实混合多卡验证深浅/窄屏/菜单及目标标识。
-
42.12 修复同名技能使用阻断提示挤乱操作行;保留精确安装目标保护,验证生效安装使用、取消及草稿/文件不变。
43. 当前会话技能可用性诊断
- 43.1 明确只读诊断、来源边界、未知状态和紧凑交互(skill-availability-design.md)。
- 43.2 实现 Host 诊断与只读对话工具,保留完整性、发现和调用策略的独立事实。
- 43.3 管理卡片提供按选定安装位置检查的紧凑入口。
- 43.4 边界测试、双 RC 宿主与浏览器组件验证;另补2轮真实模型与同会话 DSH 浏览器诊断入口,边界见 verification.md。
44. 受管理安装的技能启停
-
44.1 调研官方发现/调用机制与社区方案,完成双RC Provider级移出/恢复实验;不代表完整Host或真实模型验收。
-
44.2 评审安装级产品范围、状态及生命周期设计;冻结库存协议、迁移、历史 CLI 实测边界和配套发布顺序。
-
44.3 在隔离环境验证双RC完整Host的目录监听、缓存、同名回退和双调用入口;不支持配置明确阻止或标注未确认。
-
44.4 实现共享核心按位置停用/恢复、事务恢复及更新/卸载/重装/同步/套件联动,验证旧消费者不误写。
-
44.5 实现Host计划/确认/执行、页面及对话入口;沿用精确目标与历史引用保护,紧凑显示结果。
-
44.6 验证并发、失败恢复、来源切换、文件修改、目标占用、共享归属及 Linux 进程强杀恢复。
-
44.6a 发布前补充原生 Windows/macOS 文件转换与恢复验证;Linux 通过不替代跨平台验收。
-
44.7 完成双RC真实浏览器和真实模型验收,确认无自动发送、无外部安装误操作,保存独立证据。
-
44.8 独立评审、文档同步、清理差异并归档;CLI/DSH发布与SaaS适配另行安排。
-
44.9 人工澄清:官网链接改由详情API返回可选webUrl,移除插件设置/本地拼接,验证空值隐藏并提供SaaS交接;SaaS部署另行验收。
45. 使用优先与二级安装管理
-
45.1 明确日常按技能聚合、位置管理二级化、使用目标只读核验及原确认不变的方案。
-
45.2 实现Host唯一实际可用安装选择和未知/竞态/取消边界。
-
45.3 统一市场、已安装、详情与对话查询卡,保留二级完整管理能力。
-
45.4 独立评审、插件检查和真实DSH新对话/案例取消/填入/管理验证已通过;原安装保留。旧草稿往返人工核对受宿主侧栏隔离会话不可见限制,自动保护测试已通过,待补人工证据。
-
45.5 按人工反馈取消管理弹窗,统一详情内联管理,修复确认层被背景卡片覆盖并验证。
46. 已安装技能统一检查更新
-
46.1 确定主动统一检查、逐项更新与位置边界。
-
46.2 实现有界只读检查、上下文失效、进度汇总与筛选。
-
46.3 接入详情逐位置更新,保持原确认与库存变更失效。
-
46.4 测试、独立评审与真实DSH预览验收。
-
46.5 优化统一检查的全量库存重复读取与同技能resolve重复请求,保留精确目标与上下文保护。
-
46.6 完成10/100/500位置规模测量、独立复审和真实DSH新协议回归。
47. CLI 0.3.0 / DSH 0.6.0 配套发布收尾
- 47.1 按启停设计 §7 完成严格 v2 兼容修复和发布说明;正常查询/管理兼容 CLI 0.2.0,明确旧版显式覆盖/删除语义,不要求用户同步升级。
- 47.2 在原生 Windows/macOS 补技能入口转换、五阶段核心进程强制终止恢复及两版 Host 独立启停场景;明确核心恢复不等于 Host 强杀恢复。
- 47.3 补旧对话草稿往返保护的真实浏览器证据,核对候选完整性、旧公开包升级和真实新旧包同 HOME 交替操作、停用默认保护及未发布 v3 安全转换;拒写不计兼容通过。
- 47.4 完成发布准备 PR、独立评审与 CI,先发布 CLI 0.3.0 并验证,再发布 DSH 0.6.0;核对公开字节、安装与保留原技能。
- 47.5 同步路线图 #998 的已完成、暂缓及后续范围,记录最终发布结果与证据边界。