@pioneer_zmc/dsh-workbench 0.2.1

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 pioneer
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,98 @@
+# SpecDev Workbench 0.2.1
+
+English | [简体中文](README.zh.md)
+
+Choose a DSH project, read business documents and workflows, or ask a bundled Skill to arrange an independent room for one business.
+
+## Download and install
+
+### npm channel (0.2.1 preparation; not published yet)
+
+The npm package is `@pioneer_zmc/dsh-workbench`; the existing GitHub package remains `@specdev/dsh-workbench`. Product name, plugin ID, routes and data paths stay the same. Use these commands only after npm publication. See the verification boundaries below.
+
+### Windows Desktop
+
+Save work, exit via the menu or tray, and confirm the background instance ended. Use the bundled Desktop CLI and the actual Desktop DSH_HOME; leave it unset if it was unset before. This example demonstrates a custom root only. CLI and Desktop must share the same root; the variable affects this terminal and its children only.
+
+~~~powershell
+$DesktopDir = 'C:\Apps\DSH' # Replace with the actual installation directory
+$env:DSH_HOME = 'C:\DSHData\desktop' # Custom-root example; existing users keep their actual root
+& "$DesktopDir\resources\runtime\cli\bin\dsh.cmd" plugin --profile desktop add '@pioneer_zmc/dsh-workbench@0.2.1' '--registry=https://registry.npmjs.org/'
+& "$DesktopDir\DeepSeek Harness.exe"
+~~~
+
+Before upgrading, record the installed package and custom plugin configuration. Remove only an actually installed package with the same bundled CLI's `plugin --profile desktop remove <installed-package>`: GitHub 0.2.x uses `@specdev/dsh-workbench`, earlier releases use `@specdev/dsh-archify-manage`, and npm uses `@pioneer_zmc/dsh-workbench`. Then add, verify the original custom configuration, and restart from the same environment. Do not install old and new packages together or clear data roots. Migration of every old version has not been tested.
+
+The sidebar opens SpecDev Workbench in the central panel. Choose a project and use Return to chat to restore the conversation.
+
+### Web
+
+Stop the corresponding instance and keep its original data root and Web CLI. Apply the same installed-package removal and configuration checks using the web profile.
+
+~~~sh
+dsh plugin --profile web add @pioneer_zmc/dsh-workbench@0.2.1 --registry=https://registry.npmjs.org/
+~~~
+
+Restart that Web instance. The sidebar opens a new tab with project names and full paths, preserving chat. Create a workspace and refresh an empty list; retry read failures. Both states retain manual configuration. This task does not create a second Web installation, so this command is not evidence of a tested Web install.
+
+### GitHub fallback (original package identity)
+
+[Original-identity 0.2.1 package](https://github.com/pioneer666-user/specdev-workbench/releases/download/v0.2.1/specdev-dsh-workbench-0.2.1.tgz) · [Original Release](https://github.com/pioneer666-user/specdev-workbench/releases/tag/v0.2.1). Download to a path without spaces and use the appropriate profile's `plugin add <local-tgz-path>`. This existing asset remains `@specdev/dsh-workbench` and must not coexist with the new npm identity. The old [0.2.0 Release](https://github.com/pioneer666-user/specdev-workbench/releases/tag/v0.2.0) remains available.
+
+## Features
+
+- One independent room per business: realistic or fairy base, overview and walking modes, indoor/outdoor passage.
+- Twelve furniture assets and rendered thumbnails: bookshelf, desk, table lamp, notice board, display stand, vase, plant, book stack, bed, reading chair, low cabinet and floor lamp. Select items in the catalog and copy the list to your chat.
+- Furniture with document capabilities can bind that business's registered documents and workflows. Reading pauses walking; closing resumes in place. Decorative assets do not promise sitting, sleeping, light switches or free drag placement.
+- Project/business navigation, interactive workflows, node explanations, pinned source evidence and historical reading. Saving a version only adds an annotated Git tag to committed content.
+- Whole-building overview and walking remain available. Three bundled skills: [specdev-business](skills/specdev-business/SKILL.md), [specdev-building](skills/specdev-building/SKILL.md), [specdev-room](skills/specdev-room/SKILL.md).
+
+## First use
+
+1. Select a DSH workspace at a Git repository root. Existing `docs/specdev` projects can be browsed directly. Otherwise agree business requirements with the AI and use specdev-business to register documents and workflows first.
+2. In that project's chat, say:
+
+> Use specdev-room to create a room for this business.
+
+The Skill guides business, style and arrangement choices, reads the current catalog, writes only `docs/specdev/<businessId>/room.json` and invokes the read-only validator. It does not generate models, business documents, new workflows or choose a default project.
+
+3. Open the sidebar entry, choose the project/business, enter the room, inspect the overview and read bound material while walking. Refresh after configuration changes.
+
+The management UI only writes snapshot tags, without changing business files, branches or commits. Skills write project files only within your authorization.
+
+## Breaking changes from 0.1.x
+
+Current npm package: `@pioneer_zmc/dsh-workbench`. Plugin/sidebar ID: `specdev-workbench`. Client module: `@pioneer_zmc/dsh-workbench/client`. Pages/APIs use `/specdev-workbench`; data uses `docs/specdev`, six formal `specdev/*/1` schemas, SpecDev building formats and `specdev/` snapshot tags. Old archify-maker/archify-house skills become specdev-business/specdev-building, with specdev-room added.
+
+Only the new root, formats and tags are read. There is no automatic migration or old URL/skill alias; old bookmarks are not guaranteed. Old files and tags remain intact. Agree migration separately for each old project; do not bulk rename. Registered material can retain its original repository path.
+
+## Limits and verification
+
+The new npm identity candidate still requires this task’s isolated loading check, independent review and publication. Its identity changes are not covered by the old GitHub package byte-equivalence claim; the remaining implementation reuses existing evidence.
+
+No in-page furniture editing/saving, arbitrary scaling, wall placement, nested supports, jumping/stairs in independent rooms, cross-room links or sitting/sleeping animation. Floor placement and one level of tabletop support are supported; style is a soft recommendation. The CLI checks configuration, placement, bindings and registered material reading. Workflow checks stop at JSON syntax and do not prove diagram compilation/rendering.
+
+The 0.2.1 candidate was verified on Windows / DSH Desktop 0.2.0-rc.2 for the central entry, project ownership, room reading, internal navigation and chat draft retention. The three skills were confirmed discoverable with readable bodies and references through the host’s normal viewer. The final release package changes only the READMEs; runtime files match that tested candidate, and the final package was not reinstalled. Existing Web installation/use evidence covers 0.2.0 on Windows / DSH 0.1.6-alpha.2. The 0.2.1 source entry passed its 12 relevant regression checks; a separate isolated newer Web host check covered 0.2.0-rc.2. This does not claim installation of the final 0.2.1 package on every Web host. Other platforms and later host versions are unverified. A separate DSH_HOME isolates plugin/business data; Electron preferences, caches, single-instance behavior and protocol registration may still be shared within the account.
+
+## Build and sample
+
+Node.js ≥22. From this repository root, run sequentially:
+
+~~~sh
+npm install
+node node_modules/typescript/bin/tsc --noEmit
+node scripts/build.mjs
+npm pack --pack-destination .
+~~~
+
+Produces `pioneer_zmc-dsh-workbench-0.2.1.tgz`. The renderer and read-only validators are bundled; no private research repository is needed.
+
+~~~sh
+node sample/generate.mjs ./local-artifacts/demo-project
+~~~
+
+The target must not exist. See [sample/README.md](sample/README.md), then open the generated directory as a DSH workspace. Optional checks `node scripts/smoke.mjs` and `node scripts/check-save.mjs` run serially in generated samples without using your business project.
+
+## License and acknowledgments
+
+Plugin code, twelve self-created furniture models, generated textures and rendered thumbnails use [MIT](LICENSE). See [furniture sources](web/assets/furniture/SOURCES.md). Bundled [Archify license](vendor/archify-renderer/archify/LICENSE), [third-party notices](vendor/archify-renderer/archify/THIRD_PARTY_NOTICES.md) and [Three.js provenance](web/assets/three/VERSION.md) retain upstream attribution. Thanks to DSH and the upstream projects.

package/README.zh.md

@@ -0,0 +1,100 @@
+# SpecDev 工作台 0.2.1
+
+简体中文 | [English](README.md)
+
+在 DSH 中选择项目，浏览业务、资料与流程图，也可以用 Skill 为一个业务布置能行走、能读资料的独立房间。
+
+## 下载与安装
+
+### npm 渠道（0.2.1 发布准备，尚未发布）
+
+新 npm 包名为 `@pioneer_zmc/dsh-workbench`，旧 GitHub 包名为 `@specdev/dsh-workbench`。产品名称、插件 ID、页面地址和数据路径不变。下面命令须在 npm 正式发布后使用；本轮安装/加载证据及未验证边界见末尾说明。
+
+### Windows 桌面
+
+先保存任务，从菜单或托盘正常退出并确认后台实例结束。使用桌面随包 CLI，沿用桌面实际 DSH_HOME；原来未设置就保持未设置，不为安装切换数据根。下面只演示自选根；CLI 与桌面必须使用同一个根，此变量只影响当前终端及子进程。
+
+~~~powershell
+$DesktopDir = 'C:\Apps\DSH' # 替换为实际桌面安装目录
+$env:DSH_HOME = 'C:\DSHData\desktop' # 仅自选根示例；已有用户沿用实际根
+& "$DesktopDir\resources\runtime\cli\bin\dsh.cmd" plugin --profile desktop add '@pioneer_zmc/dsh-workbench@0.2.1' '--registry=https://registry.npmjs.org/'
+& "$DesktopDir\DeepSeek Harness.exe"
+~~~
+
+升级前记录原包名及自定义插件配置。仅对实际安装的包执行同一随包命令的 `plugin --profile desktop remove <原包名>`：旧 GitHub 0.2.x 为 `@specdev/dsh-workbench`，更早身份为 `@specdev/dsh-archify-manage`；已有 npm 包为 `@pioneer_zmc/dsh-workbench`。移除后再 add，核对原自定义配置并从同一环境重启。不同时安装新旧包，不清空数据根，不承诺所有旧版本已实测无损迁移。
+
+侧栏「SpecDev 工作台」在中央面板展开，选择项目后进入业务，使用「返回聊天」回到原会话。
+
+### Web
+
+停止对应实例，沿用原数据根和 Web CLI；旧包移除及配置核对要求同上，profile 使用 web。
+
+~~~sh
+dsh plugin --profile web add @pioneer_zmc/dsh-workbench@0.2.1 --registry=https://registry.npmjs.org/
+~~~
+
+安装后重启对应 Web 实例。侧栏「SpecDev 工作台 ↗」在新标签列出项目名称和完整路径，原聊天保留。空清单先回 DSH 创建工作区并刷新；读取失败可重试，均保留手动配置入口。本轮不另建 Web 安装环境，以上命令不作为 Web 实装通过证据。
+
+### GitHub 备用下载（原身份包）
+
+[旧身份0.2.1安装包](https://github.com/pioneer666-user/specdev-workbench/releases/download/v0.2.1/specdev-dsh-workbench-0.2.1.tgz) · [原Release](https://github.com/pioneer666-user/specdev-workbench/releases/tag/v0.2.1)。下载至无空格路径，用对应 profile 的 `plugin add <本地tgz路径>` 安装；此旧附件仍是 `@specdev/dsh-workbench`，不能与 npm 新身份包并存。旧0.2.0 [Release](https://github.com/pioneer666-user/specdev-workbench/releases/tag/v0.2.0) 保留。
+
+## 本版能力
+
+- 一个业务的独立房间：写实/童话两种底座，总览/行走双视角，门内外通行。
+- 十二款家具与真实缩略图图鉴：书架、书桌、台灯、告示牌、展示台、花瓶、盆栽、书堆、床、阅读椅、矮柜、落地灯；图鉴勾选后复制清单回聊天。
+- 具备资料能力的家具可绑定当前业务已登记的文档和流程图；阅读时暂停行走，关闭后原位恢复。其他家具是摆设，不承诺坐卧、灯光开关或任意拖摆。
+- 项目/业务目录、交互流程图、节点说明和固定提交源码证据；版本条回看历史，保存版本只为已提交内容添加附注Git标签。
+- 保留整栋建筑总览与行走。三份Skill：[specdev-business](skills/specdev-business/SKILL.md)、[specdev-building](skills/specdev-building/SKILL.md)、[specdev-room](skills/specdev-room/SKILL.md)。
+
+## 第一次使用
+
+1. 在DSH选择Git仓库顶层工作区。已有 `docs/specdev` 项目可直接浏览；没有业务资料时，先与AI确认业务，再用specdev-business登记说明和流程图。
+2. 在该项目会话里说：
+
+> 用 specdev-room，为这个业务建一个房间。
+
+Skill会引导确认业务、风格与布置方式，读取当前家具目录，写唯一 `docs/specdev/<业务ID>/room.json` 并调用只读校验。它不替你生成模型、业务正文或新流程图，也不默认一个项目。
+
+3. 点侧栏工作台，选择项目和业务，进入房间；总览中看布局，行走中阅读已绑定资料。配置修改后刷新页面。
+
+管理页面唯一写操作是保存快照标签，不改业务文件、分支或提交；AI技能只在你的授权范围内写项目文件。
+
+## 0.1.x升级边界
+
+现行 npm 包 `@pioneer_zmc/dsh-workbench`，插件/侧栏ID `specdev-workbench`，客户端模块 `@pioneer_zmc/dsh-workbench/client`。页面和API前缀改为 `/specdev-workbench`，资料根为 `docs/specdev`，六类正式schema为 `specdev/*/1`，建筑格式及快照标签也改为SpecDev命名。旧技能archify-maker/archify-house改为specdev-business/specdev-building，新加specdev-room。
+
+只读新根、新格式和新标签，不自动迁移旧项目，不保证旧书签可用，不注册旧URL或技能别名；旧数据和标签保留。每个旧项目需另行约定迁移，不能直接批量改名。已登记资料路径可继续指向仓库内原位置。
+
+## 限制与验证
+
+npm 新身份候选尚待本轮隔离加载、独立审查及正式发布；其必要身份修改不能套用旧 GitHub 包的全字节一致结论。其余实现复用既有验收。
+
+不支持页内家具编辑/保存、任意缩放、墙挂、嵌套承载、跳跃上下楼、跨房连接或坐卧动画。支持地面摆放及一层桌面承载，风格是软推荐。CLI核对配置、摆放、绑定和登记资料读取；流程图只读到JSON语法，不等于图编译/渲染验证。
+
+0.2.1候选已在 Windows / DSH Desktop 0.2.0-rc.2 验收中央入口、项目归属、房间阅读、内部导航和聊天草稿保留；三技能通过宿主正常查看入口确认可发现、正文及参考文件可读。最终发布包仅README变化，运行文件与该实测候选相同，未重新安装最终包。Web既有真实安装/使用覆盖0.2.0发布包、Windows / DSH 0.1.6-alpha.2；0.2.1源码入口相关单档回归12项通过，另有新版Web宿主0.2.0-rc.2隔离验证，不能据此宣称0.2.1最终包已在所有Web宿主安装。其他平台及后续宿主版本未验证。独立DSH_HOME隔离插件/业务数据，同账户Electron偏好、缓存、单实例及协议仍可能共用。
+
+## 源码构建与示例
+
+Node.js ≥22。在本仓库根目录依次运行：
+
+~~~sh
+npm install
+node node_modules/typescript/bin/tsc --noEmit
+node scripts/build.mjs
+npm pack --pack-destination .
+~~~
+
+生成 `pioneer_zmc-dsh-workbench-0.2.1.tgz`。渲染器及只读校验已随包，不依赖外部研究仓。
+
+~~~sh
+node sample/generate.mjs ./local-artifacts/demo-project
+~~~
+
+目标目录必须不存在；示例说明见 [sample/README.md](sample/README.md)。将生成目录作为DSH工作区打开。
+
+可按需串行运行 `node scripts/smoke.mjs`、`node scripts/check-save.mjs`，会创建独立示例，不操作你的项目。
+
+## 许可与致谢
+
+插件及十二款自制家具的模型、生成纹理、渲染缩略图采用 [MIT](LICENSE)，家具逐项来源见 [SOURCES](web/assets/furniture/SOURCES.md)。保留 [Archify许可证](vendor/archify-renderer/archify/LICENSE)、[第三方声明](vendor/archify-renderer/archify/THIRD_PARTY_NOTICES.md) 与 [Three.js版本来源](web/assets/three/VERSION.md)。感谢DSH插件宿主及上游项目。

package/client.js

@@ -0,0 +1,122 @@
+// Web 保留新标签入口；桌面用宿主中央面板承载同一项目选择页。
+window.__ModuleLoader__.load({
+  id: '@pioneer_zmc/dsh-workbench/client',
+  factory(require) {
+    const React = require('react')
+    const desktop = window.location?.protocol === 'dsh-app:' && window.location?.hostname === 'app'
+    const entryStyle = { display: 'block', padding: '8px', width: '100%', color: 'inherit', textDecoration: 'none' }
+    return {
+      inject: desktop ? ['slots', 'layout'] : ['slots'],
+      apply(ctx) {
+        let panelRegistered = false
+        const panelStops = new Set()
+        const panelAvailable = () => panelRegistered && typeof ctx.layout?.selectPanel === 'function'
+        const unavailable = (error) => `工作台入口无法使用：${error?.message || '宿主面板方法不可用'}。`
+
+        function ManageEntry() {
+          const [error, setError] = React.useState('')
+          if (!desktop) return React.createElement('a', {
+            href: '/specdev-workbench/workspaces', target: '_blank', rel: 'noopener',
+            title: 'SpecDev 工作台', 'aria-label': 'SpecDev 工作台', style: entryStyle,
+          }, 'SpecDev 工作台 ↗')
+          return React.createElement(React.Fragment, null,
+            React.createElement('button', {
+              type: 'button', title: 'SpecDev 工作台', 'aria-label': 'SpecDev 工作台',
+              style: { ...entryStyle, background: 'none', border: 0, textAlign: 'left', cursor: 'pointer' },
+              onClick() {
+                try {
+                  if (!panelAvailable()) throw new Error('宿主面板方法不可用')
+                  ctx.layout.selectPanel('specdev-workbench')
+                  setError('')
+                } catch (cause) { setError(unavailable(cause)) }
+              },
+            }, 'SpecDev 工作台'),
+            error && React.createElement('p', { role: 'alert' }, error))
+        }
+
+        function WorkbenchPanel() {
+          const frameRef = React.useRef(null)
+          const [error, setError] = React.useState('')
+          React.useLayoutEffect(() => {
+            const frame = frameRef.current
+            let active = true
+            let detachDocument = () => {}
+            const sameAuthority = (url) => url.protocol === window.location.protocol
+              && url.hostname === window.location.hostname && url.port === window.location.port
+              && url.username === '' && url.password === ''
+            const internalPath = (url) => url.pathname === '/specdev-workbench'
+              || url.pathname.startsWith('/specdev-workbench/')
+            const onLoad = () => {
+              if (!active) return
+              detachDocument()
+              detachDocument = () => {}
+              try {
+                const doc = frame.contentDocument
+                if (!doc) throw new Error('无法访问工作台页面')
+                const current = new URL(doc.defaultView.location.href)
+                if (!sameAuthority(current) || !internalPath(current)) throw new Error('工作台页面来源不符合要求')
+                const onClick = (event) => {
+                  if (!active || event.defaultPrevented || event.button !== 0
+                    || event.ctrlKey || event.metaKey || event.shiftKey || event.altKey) return
+                  try {
+                    if (frame.contentDocument !== doc) return // 换文档到 load 之间的旧事件也无效。
+                    const target = event.target?.nodeType === 3 ? event.target.parentElement : event.target
+                    const link = target?.closest?.('a[href]')
+                    if (!link || link.hasAttribute('download')) return
+                    const url = new URL(link.href, doc.baseURI)
+                    if (!sameAuthority(url) || !internalPath(url)) return
+                    event.preventDefault()
+                    frame.contentWindow.location.assign(url.href)
+                  } catch (cause) { if (active) setError(unavailable(cause)) }
+                }
+                doc.addEventListener('click', onClick)
+                detachDocument = () => { doc.removeEventListener('click', onClick) }
+                setError('')
+              } catch (cause) { if (active) setError(unavailable(cause)) }
+            }
+            frame.addEventListener('load', onLoad)
+            const stop = () => {
+              if (!active) return
+              active = false
+              frame.removeEventListener('load', onLoad)
+              detachDocument()
+              panelStops.delete(stop)
+            }
+            panelStops.add(stop)
+            return stop
+          }, [])
+          return React.createElement('section', {
+            'aria-label': 'SpecDev 工作台',
+            style: { display: 'flex', flexDirection: 'column', height: '100%', minHeight: 0, overflow: 'hidden' },
+          },
+          React.createElement('div', { style: { flexShrink: 0, padding: '8px', paddingInlineStart: 'max(8px, var(--dsh-frame-leading-clearance, 0px))' } },
+            React.createElement('button', {
+              type: 'button', onClick() {
+                try {
+                  if (!panelAvailable()) throw new Error('宿主面板方法不可用')
+                  ctx.layout.selectPanel(null)
+                } catch (cause) { setError(unavailable(cause)) }
+              },
+            }, '返回聊天'),
+            error && React.createElement('p', { role: 'alert' }, error)),
+          React.createElement('iframe', {
+            ref: frameRef, src: '/specdev-workbench/workspaces', title: 'SpecDev 项目选择与资料阅读',
+            style: { flex: 1, minHeight: 0, width: '100%', border: 0 },
+          }))
+        }
+
+        if (desktop) ctx.slots.inject('main', () => {
+          const unregister = ctx.slots.register({ name: 'main', key: 'specdev-workbench' }, WorkbenchPanel)
+          panelRegistered = true
+          return () => {
+            panelRegistered = false
+            for (const stop of [...panelStops]) stop()
+            unregister()
+          }
+        })
+        ctx.slots.inject('sidebar.footer.action', () =>
+          ctx.slots.register({ name: 'sidebar.footer.action', id: 'specdev-workbench', order: 100 }, ManageEntry))
+      },
+    }
+  },
+})

package/cordis.patch.yml

@@ -0,0 +1,8 @@
+# 本组合包贡献的插件行。repoRoot 默认未配置（空串）：插件正常加载，
+# 页面给出配置指引；用户在自己 profile 的 cordis.patch.yml 里按 id 覆盖本行
+# （需重述该行全部键），保存后重启 DSH 生效。
+- insert:
+    - id: specdev-workbench
+      name: '@pioneer_zmc/dsh-workbench'
+      config:
+        repoRoot: ''