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. 注意事项
- 改完必须重启应用:客户端 bundle 只在启动时加载,
Ctrl+F5不够。 - 不要和旧的三个独立包共存(
dsh-workspace-tools/dsh-image-port/dsh-startup-screen),装本包时一并卸载。 - 端口冲突:工作区工具 57391、图片端口 57355,被占用会顺延;图片端口页的「重新检测」会扫 57355–57366。
- 同版本号重打包不会重装:
dsh plugin add见版本相同会跳过解包,升改动必须递增version(或build.mjs stage打戳)。 - 子页顺序:皮肤先 apply(置
window.__hosSubpagesHost),其余子项在setTimeout(0)里判断该标记后注册,卸载皮肤会自动退回各自的分节。 - 启动动画的音频:
sub\startup-screen\lib\assets\里只有六段台词,缺bgm.mp3与两段音效,缺失时静默降级,可自行放入。 - 子页注册表要自己建:
registerHosSubpage()里if (!Array.isArray(window.__hosSubpages)) window.__hosSubpages = []不能省。子项的apply可能早于皮肤面板首次渲染;只读不建会被误判成「没有皮肤」→ 退回settings.section,左侧导航多出一行「启动动画」、页顶却少这个标签(1.0.0 的实际故障,1.0.1 已修)。 - 客户端半边是拼装产物:
client.js由scripts\compose-suite.mjs生成,手改会在下次重跑时丢失。 - 卸载顺序:先
dsh plugin remove dsh-harness-os再重启;回收站与dsh-startup.json不会被删(数据与插件分离)。 - 喂给主进程的颜色分主题写:
--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,并保留上游启动动画作者署名。
No comments yet. Be the first to write one.