前言¶
在 DeepSeek Harness（DSH）里做 Web 向的智能体或小型工具时，界面往往要重复搭顶栏、侧栏、主题和表格骨架。每开一个新项目都要从零拼一遍，开工前的体力消耗很大。blank-workbench 是维护者 lilinshuei 发布的 DSH 客户端类插件：用参数化生成器产出单文件 HTML 工作台，内联样式与脚本，零运行时外部依赖，适合作为「先能看、再填业务」的基座。社区目录见 SkillHub 插件页，源码与说明在 GitHub。
这是什么¶
blank-workbench（npm 包名 blank-workbench，当前发布版本 1.0.0）定位是：一句话生成能直接用的单文件工作台——20+ 通用组件、明暗主题、响应式布局，双击 HTML 即可在浏览器打开。它是骨架而不是完整业务系统：概览页带组件示范，其余导航模块默认为空占位，由你复制卡片、统计、表格等片段往里填。
插件本体除 template.html、scaffold.cjs 外，还包含 SKILL.md（组件清单与扩展说明）、lib/index.js（DSH 适配层）和 cordis.patch.yml（挂载声明）。许可证为 MIT。
核心功能¶
下面各点均来自仓库 README，可与本地安装后的 SKILL.md 对照。
单文件交付¶
HTML、CSS、JS 全部内联在同一份文件里。发给别人或离线打开时，不会出现「样式没加载」这类外链依赖问题。仓库声明运行时外部依赖为零，查看产物只需现代浏览器。
20+ 通用组件¶
内置卡片、统计、标签、表格、折叠、按钮、空状态、工具条等常用片段，复制到对应视图区域即可使用。默认不引入图表库；需要图表需自行引入并接受联网或本地打包的成本。
明暗主题与记忆¶
颜色走 CSS 变量，切换即时生效，选择会通过 localStorage 记住。
响应式外壳¶
PC 端为顶栏加侧栏；视口宽度 ≤820px 时自动变为横向滚动的 tab，避免整页横向溢出。
参数化生成¶
通过 scaffold.cjs 一次传入标题、导航模块名、主题色和输出路径，默认生成一份可用的概览页；导航第一项映射到带完整组件示范的「概览」，其余为占位。
安装与启用¶
插件以当前 DSH 进程权限运行。安装前建议浏览 GitHub 源码与 MIT 许可证，确认符合你的环境策略。DSH 生态采用「一切皆插件」思路；SkillHub 等为社区目录，与 DeepSeek / 幻方无官方从属关系。
npm 一行安装（推荐）¶
包已发布到 npm registry。在终端执行：
dsh plugin --profile web add blank-workbench
若使用 DSH 桌面端，将上述命令中的 web 换成 desktop。装完后重启 DSH，新会话即可调用。在桌面端「添加插件」窗口里，只填包名 blank-workbench，不要粘贴整条命令。
从 GitHub 安装¶
需要跟踪仓库最新提交，或 npm 拉取不畅时：
dsh plugin --profile web add github:lilinshuei/blank-workbench
安装完成后，Skill 最终路径为 ~/.dsh/skills/blank-workbench/SKILL.md（手动拷贝目录时亦同）。
典型用法¶
先做生成，再打开验证，最后在 HTML 里填业务。生成器需要 Node.js；package.json 中 engines 要求 node >= 20。
1、生成一份工作台¶
node scaffold.cjs --title "我的项目看板" --nav "概览,任务,成员,报表" --accent "#10b981" --out "项目看板.html"
第一项「概览」会带完整组件示范，其余模块名对应空占位视图。
2、在浏览器中检查¶
在 Windows 上可用：
start "" "项目看板.html"
确认明暗主题切换、导航显隐，以及在较窄宽度下无多余横向滚动。
3、填入业务内容¶
在对应 .view 区域复制 .card、.stat、.table 等结构即可。README 明确底线：不要引入 CDN，以保持离线可用。
适用场景与注意¶
适合： 需要快速得到一个可演示、可分享的单文件看板或工具外壳；智能体或脚本在本地生成 HTML 后再人工迭代模块内容；强调零遥测、本地执行、不上报使用数据的场景（仓库安全说明中写明了零遥测、无内置统计、不访问外部接口）。
能力边界： 不提供后端、账号、权限与持久化数据存储；模块内容需自行实现；图表等非内置能力需自己接入。
环境： 生成依赖 Node.js；浏览依赖现代浏览器；插件逻辑在 DSH 会话中按你本机权限执行，勿在未审阅源码的情况下装到高敏感环境。
同维护者系列： 仓库 README 还列出了 novel-atlas、pc-privacy-shield 等其它 Skill，属同一作者生态，可按需单独选用。
结尾¶
blank-workbench 把「重复搭 UI 壳」收成一条 scaffold.cjs 命令和一份可双击的 HTML，适合作为 DSH Web 向开发的起步模板。目录与元数据：SkillHub · blank-workbench；源码与详细说明：github.com/lilinshuei/blank-workbench。
