像素工艺界面 OBdangshang07/dsh-craft-ui

DSH Craft UI

一款非官方、高还原度的 Minecraft 风格 DeepSeek Harness 界面与玩法增强层。它不会改变 Harness 对操作和状态的实际控制，只会将这些能力重新呈现为兼顾效率与游戏感的 HUD。

发布的软件包可以完全独立运行：其中包含采用 MIT 许可证的原创像素美术、采用 OFL-1.1 许可证的 Fusion Pixel 界面字体，以及通过 Web Audio 实时合成的提示音。软件包不包含 Minecraft 的纹理、声音、字体、徽标或其他 Mojang/Microsoft 文件。

功能变化

- 可随时还原的“主世界白昼”和“深板岩之夜”主题。
- 原创九宫格面板、按钮、工具提示、图标、物品槽和世界纹理。
- 内置 Fusion Pixel 简体中文 WOFF2 字体，离线环境下也能保持一致显示。
- 将上下文压力显示为经验值栏；遥测数据未知时会明确显示为不可用，不会虚构数值。
- 将正在运行的工具调用显示为物品栏和工具提示框。
- 将模型和服务提供方显示为装备，将推理强度显示为附魔。
- 将待办事项和计划显示为任务日志。
- 将 Harness 原生的活动目标栏改造成 Minecraft 任务面板，并为上下文经验值栏预留空间。
- 将子代理显示为同伴列表，将待处理交互显示为确认警告。
- 回合完成时显示“进度达成”提示。
- 提供原创合成的点击音和进度达成音，默认关闭。
- 在不替换原生操作及风险说明的前提下，为设置、确认、提问和计划审查界面应用 Minecraft 风格。
- 采用 Java 版风格的“选项”导航：居中的双列选项按钮、独立的 HUD 与资源包子页面，以及底部的“完成/返回”按钮，不再使用桌面应用式标签页和下拉框。

0.4.3「Windows 桌面适配」

- 设置、图片工作台、书签、HUD 与模型/推理弹窗避让 Windows 标题栏，覆盖三档缩放及窄屏、矮窗口。全屏时只有标题菜单不存在才释放空间；DSH 0.2.0 全屏后仍保留菜单，因此继续预留顶部区域。
- 在现有开放 ShadowRoot 内为“应用/编辑”标题菜单按钮添加像素外观，不替换节点、文字、点击处理、键盘导航和原生操作。关闭或卸载插件只移除自身样式，支持菜单延迟创建和替换。
- 弹窗允许原生标题菜单获得焦点，同时继续阻止焦点进入背后的对话；页面控件不充当窗口拖动区。

桌面端使用独立的 desktop 配置，在 craft-ui-canary 中安装不会自动同步。请先结束任务并完全退出桌面端，再使用客户端自带的命令入口（已验证 0.2.0-rc.2）。单独通过 npm 安装的 CLI 会拒绝管理此保留配置。在本仓库目录的 PowerShell 中执行（自定义安装位置需相应调整路径）：

& "$env:LOCALAPPDATA\Programs\DeepSeek Harness\resources\runtime\cli\bin\dsh.cmd" plugin --profile desktop add .generated/packs/dsh-craft-ui-0.4.3.tgz

随后重新打开客户端。原有 bundle 配置和会话仍由 DSH 管理，不替换 app.asar，也不要用 Web 配置覆盖桌面配置。操作系统弹出菜单、最小化/最大化/关闭按钮及系统对话框保持原生，不强行重绘。macOS/Linux 桌面外壳尚未验证。

0.4.0「地图与书签」

- 推理等级滑动条：默认启用 Minecraft 风格的分档滑条，包含方形石质滑块、绿色刻度、当前等级及恢复默认按钮。只使用当前模型实际公布的等级；支持拖动、点选档位、方向键和 Home/End。拖动预览不写入，松手或键盘操作完成后才应用到下一次请求。紧凑面板顶部提供独立的 模型 / 切换 ▾ 按钮，长模型名称不会挤掉切换入口。可在 Craft UI → 选项 → 推理等级控件 切回 旧版菜单，设置会保留；关闭主题也会恢复 DSH 原生控件。
- 对话内读图：标准 read_image 成功后展示地图框缩略图，回合末汇总已读取图片。保持读取时附件的比例和颜色，不把所有图片强制像素化。
- 地图工作台：单图查看、25–400% 缩放、拖动平移、左右同步对比、同尺寸滑杆对比，以及可切换的最近邻像素模式。
- 定点反馈：矩形框选、百分比坐标、说明文字与持久标注。反馈只追加到现有草稿，不自动发送、不重新附图。可以单独下载带框线的派生 PNG（最大 400 万像素/长边 4096），不覆盖源图。
- 会话书签册：收藏消息或摘录，记录约束、决定、问题、标签与个人备注；保留最近 20 次修订，可标记替代关系、读取来源原文、搜索、删除、导出与导入。

点击图片进入工作台；点击会话标题旁的书本打开书签册，也可以使用 AI 回复后的收藏按钮。三个功能可在 Craft UI → 地图与书签 分别关闭。界面沿用 Java 版风格按钮、地图木框、书本图标和双主题，不增加底部常驻 HUD。

书签和标注保存在当前 DSH profile 的 craft-notebooks/ 中，按 Session 身份隔离。每本最多 300 条、4 MiB；多窗口修改冲突会要求刷新，不静默覆盖。删除书签或清除素材不会删除原对话。JSON 备份只接受同一会话，导入前确认并重新核验来源；同 ID 跳过，旧修订和替代关系不恢复。导出文件包含消息摘录，请注意隐私。

范围说明：不接管 DSH 的聊天分组；原生折叠组仍由 DSH 控制，回合末提供默认可见的图片汇总。来源原文在书签册内按事件读取，不强制滚动主对话；收藏更早的消息需要先在对话中载入。分支会话不自动继承书签。不解析任意终端路径或远程 URL 为图片，也不增加模型调用。只有框线进入导出的 PNG，说明文字通过草稿反馈。0.5/0.6 的验收、产物历史、交接和文件回退尚未实施。

安装与开发

需要 Node.js 22 或更高版本，以及兼容的 DeepSeek Harness 版本。

pnpm install
pnpm run verify
pnpm pack --pack-destination .generated/packs
dsh plugin --profile craft-ui-canary add .generated/packs/dsh-craft-ui-0.4.3.tgz

该插件是一个 DSH Host + Client 组合包。cordis.patch.yml 会插入稳定的 bundle 层；客户端使用 Harness 已公开的主题、插槽、连接、会话和对话服务。

本地 Minecraft 物品模式

打开 Craft UI → 素材，粘贴你合法持有的 textures 或 items 目录绝对路径，然后选择 导入物品贴图。导入功能只能通过本机回环地址上的 Harness 连接使用。插件内置的界面边框、按钮、物品槽、状态栏和背景仍然使用原创美术；从该目录读取的内容仅限单个物品图标。

导入器会：

- 只读取预先定义的物品语义白名单，不会遍历或复制整个目录；
- 要求使用绝对目录路径，并通过 realpath 解析每个选中文件，拒绝符号链接及任何逃逸出所选目录的路径；
- 校验 PNG/IHDR 文件头、16–256 像素范围内的正方形 2 次幂尺寸，以及每个物品 64 KB 的大小上限；
- 计算所选文件的哈希，并将私有缓存保存到 $DSH_HOME/craft-ui/resource-packs/<sha256>；
- 只把选中的物品 PNG 作为受大小限制的 data URL 发送给本机浏览器；
- 不在新缓存清单中持久保存源目录路径，不向客户端暴露该路径，也不会把导入文件加入 npm tarball。

已识别的物品语义包括命令执行、文件编辑、搜索/读取、网络访问、图像处理、模型装备、目标、任务、子代理、确认和进度状态。运行时音频始终使用原创合成声音。

使用 清除缓存 可以删除全部 Craft UI 私有资源缓存，并恢复原创素材套件。

界面尺寸

Craft UI → 外观 → 界面尺寸 提供三档真实布局缩放：紧凑、标准和大号。该设置会同时缩放 HUD 与 Craft UI 面板，而不是只改变边框粗细。在狭窄视口中，界面会自动采用安全的响应式尺寸，确保 Harness 原生控件始终可以操作。

字体行为

客户端会在构建时嵌入 Fusion Pixel 10px Monospaced zh-Hans 的 WOFF2 文件，因此界面不依赖系统字体或在线字体服务。同一份经过审查的字体文件、SIL Open Font License 1.1 许可证文本及内置组件的许可证声明均包含在 assets/fonts/ 中。如果浏览器无法加载 WOFF2，样式表会回退到可读的系统等宽字体和中日韩字体。

在 DSH 0.2.1 中，启用 Craft UI 时会临时覆盖界面正文字体变量，不改写你保存的字体偏好。不覆盖代码和终端的原生字体变量、字号偏好；已有的明确像素化面板仍保留原有排版。关闭插件后恢复原生正文字体，主输入框继续保持像素字体和一致的光标行高。

无障碍与安全性

- 提供完整、减少和关闭三种动效模式；操作系统的“减少动态效果”偏好拥有最高优先级。
- 键盘焦点始终清晰可见。
- HUD 元素不会拦截指针操作，并会为原生任务、运行状态和操作控件动态避让。
- 响应式布局会优先隐藏非必要 HUD 元素，再缩小核心控件。
- 确认、提问和计划审查的实际行为始终由 Harness 管理。
- 禁用或卸载插件后，会恢复此前的 Harness 主题和文档配色方案。

兼容性

0.4.3 增加 Windows Desktop 0.2.0-rc.2 适配，并保留 Web 0.2.1-alpha.2 兼容（2026-10-16 核验）。使用客户端自带的 Electron/Node Host 和 Windows 构建的前端包，在隔离配置中测试。无头渲染器测试使用客户端实际菜单代码，但原生 IPC 为测试替身，不等同于实际 Electron 窗口及系统菜单的交互验收。随后经用户授权安装、重启，通过临时浏览器检查了实际桌面 Host 的插件加载与状态 RPC；仍不宣称完成原生系统菜单和桌面代理的端到端验收，也不要求升级 DSH。具体覆盖范围见 docs/COMPATIBILITY.md，素材边界见 docs/ASSET_POLICY.md。

保留 0.4.2 的多行目标编辑器、按实际面板定位的经验值栏、原生字体设置和响应式 HUD 适配。图片工作台、书签持久化和推理/模型选择测试不提交模型请求；旧版 Session 快照的兼容回退仍由自动化契约测试覆盖。

验证

pnpm run verify 会重新生成原创素材、嵌入所有运行时纹理及经过审查的字体、构建 Host 和 Client bundle、执行类型检查，并运行软件包契约与安全测试。随后，pnpm run audit:pack 会根据明确的文件白名单检查 npm tarball，验证打包字体和内嵌字体的哈希，并拒绝导入素材、缓存、压缩包、未经审查的字体/音频、源映射、异常 tar 条目类型和过大的内嵌二进制文件。打包后的客户端 bundle 大小预算为 900 KB。

许可证与商标

插件源代码和原创生成素材采用 MIT 许可证。Fusion Pixel Font 采用 SIL Open Font License 1.1；详见 assets/fonts/OFL.txt 和 THIRD_PARTY_NOTICES.md。Minecraft 是 Microsoft Corporation 的商标。本项目为非官方项目，与 Mojang 或 Microsoft 无关联，亦未获得其批准或赞助。用户有责任遵守 Minecraft EULA 以及其所导入资源包的许可证。