DSH HUB
HomePlugin StorePlugin PacksCommunityRankingsResourcesPublish Guide
Plugin source
Back to catalog

Avisitort /

Avisitort/dsh-harness-os

Topic repository only

This plugin has no description yet.

★ 0 Stars0 Forks0 IssuesN/A Community rating0 Confirmed installs
View on GitHub
READMESource: main@f3b71b73

Harness OS 整体插件(dsh-harness-os 1.0.3)

代码与安装包都在 suite/ 目录;本文件是包内 README 的副本。

一个包、一次安装、一个设置入口。Harness OS 是主项,另外三个是它的子项:

子项 原包名 子版本 干什么
Harness OS(主项) dsh-harness-os 0.5.16 整套皮肤:主题变量、发丝机框、等宽读数、准星罗盘;浅色 / 深色两条独立分支
启动动画 dsh-startup-screen 1.6.0-hos.17 六幕开机序列:黑幕标识 → 过曝洗白 → 档案底板 → 交互授权 → 欢迎访问
工作区工具 dsh-workspace-tools 0.6.1 新建工作区自动命名、改名只改显示名、一键打开本地文件夹、回收站、会话移动
图片端口 dsh-image-port 0.1.3 输入框「图片」按钮 + 本机 HTTP 投喂端口,把图片送进任意会话

装好之后设置里只有一行「Harness OS」,页顶是标签栏:

外观 | 插件 | 启动动画 | 工作区工具 | 图片端口
  • 「外观」:皮肤的启用开关、强调色(橙 / 红 / 蓝)、机框、减弱动效。
  • 「插件」:总览。本包四个子项可一键切到对应标签;第三方插件(侧边卡片、背景)给「打开」,替你在左侧导航里点一下。
  • 其余三个标签:各子项自己的设置页,页底都列着该子项的全部自定义接口。

0. 功能

0.1 皮肤(主项,sub/harness-os)

能力 说明
浅色纸感 / 深色石板两套令牌 明暗各一套 --hos-*,跟随 DSH 的主题属性;属性挂哪一层都认(syncDark() 归一成 body[data-hos-dark])
发丝机框(chassis) 四周 26px 边框 + 定位角 + 拖拽区,可与原生窗口标题带对齐;可关
原生标题带/侧栏配色 通过 --dsw-specific-sidebar-fill 喂给 Electron 主进程,浅色给浅色值、深色给深色值
强调色 橙 #ff7500 / 红 / 蓝三选一,同时驱动阶段条、准星、运行状态
减弱动效 关掉罗盘旋转与信号轨迹,跟随系统「减少动态效果」自动减弱
子页标签容器 设置页顶部标签栏;子项注册进来的设置页挂在这里,插件没装就不显示该标签

0.2 启动动画(sub/startup-screen)

能力 说明
六幕序列 黑幕 DeepSeek 标识 → 过曝洗白 → 暖白档案底板 → 交互式访问授权 → 读取核验 → 欢迎访问
触发时机 session(仅新会话)/ always(每次启动)
可改参数 身份名称、身份 ID、机构中英文、权限等级、明暗主题、强调色、玻璃质感、速度、声音、BGM 音量与闪避
配置文件 ~\.dsh\dsh-startup.json(UTF-8 无 BOM),也可用设置页改
素材降级 缺台词 → TTS 念白;缺音效/BGM → WebAudio 合成音;不报错、不阻塞启动

0.3 工作区工具(sub/workspace-tools)

能力 说明
新建工作区自动命名 在索引根目录(默认 D:\deepseek\workspaces)生成 ws-YYYYMMDD-HHmmss-<4位hex> 目录并注册,应用端显示名默认「工作区 MM-DD HH:MM」
改名只改显示名 调宿主 workspace.setTitle(),磁盘目录不动;旧版会真改目录 + 留 junction 的逻辑已删除
一键打开本地文件夹 工作区右键、会话右键、设置页行内三处入口,spawn explorer.exe <path>(macOS open / Linux xdg-open)
回收站 删会话先进回收站(文件级,带备份),可还原 / 彻底删除 / 清空;默认保留 60 天
会话移动 把会话挪到另一个工作区,改写其 cwd;活动中的会话排队到空闲再执行
修复 /repair 重建回收站目录、统一规范路径、滚动清理备份;/heal 把 workspace.json 里的旧路径修回实际路径

0.4 图片端口(sub/image-port)

能力 说明
输入框图片按钮 在 composer 左侧加「图片」按钮,走宿主隐藏的 <input type="file">,临时把 accept 改成图片
本机 HTTP 投喂 POST /image(JSON base64 / multipart / 裸图三种都收),把图塞进指定会话或最新会话
会话列表 GET /sessions,供设置页下拉选择目标会话
鉴权 默认无 token 仅本机;设了 DSH_IMAGE_PORT_TOKEN 后必须带 Authorization: Bearer 或 x-image-port-token
设置页自检 扫 57355–57366 找在线端口,一键发一张 8×8 测试图,显示返回字节数

0.5 一个入口

设置 → Harness OS
  外观 | 插件 | 启动动画 | 工作区工具 | 图片端口

「插件」标签是本包四个子项 + 本机第三方插件(侧边卡片、背景)的总览:子项给「切到本页」,第三方给「打开」(替你在左侧导航点一下)。每个子页页底都列着该子项的全部自定义接口与用法。

1. 目录

packages\suite\
  package.json          一个 dsh.bundle.patch + 一个 dsh.client(三个 UI 依赖取并集)
  cordis.patch.yml      只插一行:dsh-harness-os
  index.js              主项入口:用 ctx.plugin() 把三个子项的 Host 半边挂进同一个 fiber
  client.js             一个 ModuleLoader bundle(id 必须等于包名),四个子项按顺序内联
  sub\harness-os\       皮肤 Host
  sub\startup-screen\   启动动画 Host + splash.css/js + assets(line-1..6.mp3,公开分发前见 CREDITS.md 第 3 节)
  sub\workspace-tools\  工作区工具 Host(HTTP 57391 起)
  sub\image-port\       图片端口 Host(HTTP 57355 起)+ menu-preview.png
  plugins\              打完的 tgz
  CREDITS.md            引用、来源与授权(上游署名 + 素材限制)

client.js 由 scripts\compose-suite.mjs 生成。**改子项的客户端代码要改 sub\ 里的源再重跑脚本**,不要直接编辑 client.js。

2. 安装 / 升级 / 卸载

# 打包(在工作区根目录)
node build.mjs pack

# 安装 + 自动卸掉合包前的三个旧包
node build.mjs install

# 核对
node build.mjs verify

手工等价命令:

dsh plugin --profile desktop add "D:\deepseek\主题\packages\suite\plugins\dsh-harness-os-1.0.2.tgz"
dsh plugin --profile desktop remove dsh-workspace-tools
dsh plugin --profile desktop remove dsh-image-port
dsh plugin --profile desktop remove dsh-startup-screen

必须卸掉旧的三个包:它们各自还带着一份 client bundle 与一套 HTTP 端口,同时装着会出现两份「工作区工具」设置页、两套端口监听。build.mjs install 已经替你做了。

改完记得重启 DeepSeek Harness(客户端 bundle 不走 HMR,刷新页面不够)。

3. 子项的自定义接口(保留不变)

3.1 工作区工具(HTTP,默认 57391,DSH_WORKSPACE_TOOLS_PORT 覆盖,被占用时自增最多 12 次)

方法 路径 说明
GET / 插件名、版本、回收站保留天数、端口、待办数
GET /ping 健康检查
GET /workspaces 工作区索引:{workspaceId,title,path,exists,folder} + 根目录
POST /workspace/new 新建工作区:Host 生成 ws-<时间戳>-<4hex>、mkdir 并注册
POST /workspace/title 只改显示名(ws.setTitle),磁盘不动;旧别名 /rename-workspace 仍可用
POST /open-folder 打开资源管理器:body 里给 path / workspaceId / sessionId 任一
POST /trash/session、/delete-session 删除会话 → 回收站(带备份)
GET /trash 回收站列表(过期项自动清理)
POST /trash/restore 从回收站恢复
POST /trash/purge 彻底删除单个条目(不可恢复)
POST /trash/empty 清空回收站
POST /move-session 会话移到另一个工作区
POST /repair 重建回收站目录、统一规范化路径
POST /heal 按真实路径修 workspace.json

浏览器侧:localStorage["dsh-workspace-tools:palette"] = {bg,panel,text,accent} → :root{--wt-bg,--wt-panel,--wt-text,--wt-accent};--wt-danger 可选。

3.2 图片端口(HTTP,默认 57355,DSH_IMAGE_PORT / DSH_IMAGE_PORT_TOKEN 覆盖)

方法 路径 说明
GET /、/health {name,version,endpoint,auth};auth 为 none 或 token
GET /sessions 可投喂会话列表 + defaultSessionId
GET /debug/graph clientModules 依赖图
POST /sessions 新建会话
POST /image 投喂图片:`{image:{data,mediaType,name}, sessionId?, prompt?, mode?:'queue'

只绑 127.0.0.1;只接受 PNG / JPEG / WebP / GIF;404 回 {code:'not-found'}。

3.3 皮肤(浏览器)

localStorage["dsh-harness-os:settings"] = {enabled, accent:'orange'|'red'|'blue', chassis, reduceMotion}; body[data-hos] 上覆盖 --hos-bg / --hos-bg-2 / --hos-bg-3 / --hos-ink / --hos-ink-soft / --hos-muted / --hos-hair / --hos-accent; 暗色同时接受 body[data-hos][data-ds-dark-theme] 与 body[data-hos][data-hos-dark](后者的值由 syncDark() 归一,主题属性挂在哪一层都能命中)。

3.4 启动动画(HTTP + 配置)

方法 路径 说明
GET/POST /dsh-startup/config 读写 ~\.dsh\dsh-startup.json(UTF-8 无 BOM)
GET /dsh-startup/splash.css、/splash.js 首屏资源
GET /dsh-startup/asset/<name>.mp3 line-1..6 台词;bgm / sfx-tick / sfx-ticks-run 缺失时自动降级为合成音

4. 注意事项

  1. 改完必须重启应用:客户端 bundle 只在启动时加载,Ctrl+F5 不够。
  2. 不要和旧的三个独立包共存(dsh-workspace-tools / dsh-image-port / dsh-startup-screen),装本包时一并卸载。
  3. 端口冲突:工作区工具 57391、图片端口 57355,被占用会顺延;图片端口页的「重新检测」会扫 57355–57366。
  4. 同版本号重打包不会重装:dsh plugin add 见版本相同会跳过解包,升改动必须递增 version(或 build.mjs stage 打戳)。
  5. 子页顺序:皮肤先 apply(置 window.__hosSubpagesHost),其余子项在 setTimeout(0) 里判断该标记后注册,卸载皮肤会自动退回各自的分节。
  6. 启动动画的音频:sub\startup-screen\lib\assets\ 里只有六段台词,缺 bgm.mp3 与两段音效,缺失时静默降级,可自行放入。
  7. 子页注册表要自己建:registerHosSubpage() 里 if (!Array.isArray(window.__hosSubpages)) window.__hosSubpages = [] 不能省。子项的 apply 可能早于皮肤面板首次渲染;只读不建会被误判成「没有皮肤」→ 退回 settings.section,左侧导航多出一行「启动动画」、页顶却少这个标签(1.0.0 的实际故障,1.0.1 已修)。
  8. 客户端半边是拼装产物:client.js 由 scripts\compose-suite.mjs 生成,手改会在下次重跑时丢失。
  9. 卸载顺序:先 dsh plugin remove dsh-harness-os 再重启;回收站与 dsh-startup.json 不会被删(数据与插件分离)。
  10. 喂给主进程的颜色分主题写:--dsw-specific-sidebar-fill 会被 preload 探针读走、用来画 Windows 顶部「应用/编辑」标题带和侧栏填充,网页侧改不到主进程。这条以前写成不分主题的 body[data-hos]{…:#25303c},浅色外观下顶部与侧栏就留黑框(1.0.1 的实际故障);现在浅色 var(--hos-bg,#dedbd4)、暗色 #25303c 各一条,切换时由 syncDark() 归一。

5. 版本

层 版本
整体包 dsh-harness-os 1.0.3
皮肤子项 0.5.16
启动动画子项 1.6.0-hos.17
工作区工具子项 0.6.1
图片端口子项 0.1.3

子版本只用于追溯,安装与升级只认整体包版本。

6. 引用与致谢

完整版见 CREDITS.md(随包分发)。要点:

部分 来源 许可
皮肤、工作区工具、图片端口 本仓原创(TinyNian/dsh-harness-os) MIT
启动动画 fork 自 QIFANAI/dsh-startup-screen,原始作者沈宏宏 MIT
宿主与扩展点 DeepSeek Harness 及 @deepseek-ai/dsh-client-ui-* 见宿主仓库
启动动画台词 line-1..5.mp3 自 DeepSeek 官方宣传片截取 不可再分发,公开渠道发布前删除(见 CREDITS.md 第 3 节)
终幕欢迎语 line-6.mp3 上游作者本人录制 MIT(随本项目)
「DeepSeek」「深度求索」及鲸鱼标识 深度求索公司 商标,本插件为社区作品,无隶属关系

再分发时必须保留 LICENSE 与 CREDITS.md,并保留上游启动动画作者署名。

—/ 5

No ratings yet

Manifest verification required

Commit f3b71b731eb1

Community comments

No comments yet. Be the first to write one.

DSH HUB

A community index for DSH plugins. Not an official GitHub or DeepSeek AI product.

CommunityResourcesAPIAbout