dsh-blockworld-theme

DSH Blockworld

一个为 DeepSeek Harness Web GUI 设计的方块世界皮肤插件。它不只是更换背景和图标：每个会话都会把真实的上下文、工具、Skill、MCP 与压缩轨迹装配成一座可检查的西方幻想城邦。

本项目不是 Minecraft 官方产品，也未获 Mojang 或 Microsoft 认可。发布包不包含 Minecraft 官方纹理、图标、声音、商标或其他游戏资产。画面由本项目的原创程序化像素方块绘制，声音由浏览器实时合成。

它如何建城

• 首次 request/header 把系统提示词铺成永久地基。
• 官方 projectedTokens / contextWindow 投影驱动城堡从地基、门楼、主堡、城墙、塔楼成长到完整城垛；95% 后轮廓停止扩大，转为红石警戒。
• 用户消息铺路和增加楼层，助手消息点亮房间、补齐墙体与屋顶。
• Shell、Terminal 与 Subprocess 建成铁匠铺；文件工具建成工坊仓库；Web/Search 建成观星台；Code/LSP 建成建筑师公会；Plan/Todo/Interaction 建成市政厅。
• 实际加载的 Skill 建成法师图书塔。Skill catalog 只进入清单，不会被误判为已加载。
• mcp__<server>__<tool> 的首次真实调用建成 MCP 传送门；重复调用最多升级三级，之后只增加铭牌计数。
• Compaction 将旧结构沉入地下档案馆；活动城堡按新的官方投影缩小，历史压缩仍可检查。
• Session ID 稳定决定地形、城区槽位与变体：同一会话刷新完全复现，不同会话形成不同城邦。

界面与隐私

启用后，会话标题栏出现“城堡 + 上下文百分比”按钮。抽屉默认关闭，并通过 Portal 锚定在 [data-conversation-scroll] 中：宽屏从中央会话列右侧展开，窄屏变成中央列底部面板。它不会注册或替换 DSH 的 details，因此项目文件树和其他右侧栏插件保持原样。

城堡 Canvas 可以点击，旁边同时提供完整的键盘建筑清单。羊皮纸卷轴默认只显示名称、状态、调用次数和估算占用；系统提示词、消息、工具 Schema、工具参数/结果、Skill 正文与 MCP 明细只有主动展开才显示。隐私遮罩会立即隐藏原文和项目路径。

总容量及系统、工具、消息三大分类读取 DSH 官方 contextPressure 与 contextBreakdown 投影；单项数字使用本地字符权重并明确标记为 ~ 估算。

安装

需要支持插件 bundle 的 DeepSeek Harness Web profile。发布后可从 npm 安装：

dsh plugin --profile web add @zebbkira/dsh-blockworld

也可以直接安装本地仓库进行开发：

dsh plugin --profile web add E:\dsh-blockworld-theme

首次安装保持关闭。打开 DSH 的“设置 → 常规 → 方块世界”，选择“跟随系统昼夜”“昼间城邦”或“夜间城邦”即可启用。设置会原子保存到 $DSH_HOME/blockworld-state.json，localStorage 只承担当前浏览器的快速缓存。

卸载插件后，主题注册、会话投影、Slot、监听器和插件样式会随 Cordis/客户端加载器一并撤回。

公开状态格式

interface BlockworldStateV1 {
  version: 1
  theme: 'off' | 'system' | 'day' | 'night'
  motion: 'system' | 'full' | 'reduced'
  sound: { enabled: boolean; volume: number }
  privacyMask: boolean
}

Host 提供同源 GET /blockworld/state 与 PUT /blockworld/state，写入请求上限 32 KiB。浏览器侧独立注册 blockworld Conversation View target，只消费 DSH 的公开 session event 与 token-meter 投影，不导入 trajectory 或其他插件的内部组件。

开发与验证

pnpm install
pnpm run typecheck
pnpm test
pnpm run build
pnpm run pack:check

测试覆盖状态校验与原子写入、32 KiB 路由上限、公开事件折叠、Skill catalog/加载区分、MCP 命名、工具城区分类、三级升级、容量阶段、确定性布局、压缩遗迹、抽屉关闭/焦点恢复、隐私遮罩、原文展开、文件树共存和运行中建造帧。

License

MIT. See LICENSE.