hunter118/dsh-s7r

S7R — 为 DeepSeek Harness 重新构想的 System 7

CI
Release
License: MIT
DSH: 0.1.1-rc.2

S7R 是一个为 DeepSeek Harness Web UI 打造的原创 System 7 时代工作站外壳。它将真实的 DSH Agent、Workspace、文件、终端、工具和持久化历史转化为一个协调的多窗口桌面，而不是在聊天页面上套一层复古皮肤。

S7R 是桌面环境。Knowledge Desk 是它的 Workspace、Agent 和对话应用。

一个展开的 S7R 桌面，Knowledge Desk 自然地与 Agent、Finder、Monitor 和 Clock 重叠

以原生 1× 放大率展开的 1024 × 768。Knowledge Desk 始终是工作流的中心，同时活动 Agent、Finder、Monitor、Clock、桌面别名和 Trash 共存于同一个持久化桌面上。

DSH 仍然是唯一事实来源。S7R 不会将对话复制到自己的聊天数据库中，不会启动无关的 shell 服务器，也不会暴露任意主机路径。它呈现 DSH 已经拥有的能力，并且只在浏览器中保留桌面偏好设置——窗口位置、别名、显示选择、Scrapbook 卡片以及类似的 UI 状态。

[!IMPORTANT]
S7R 已发布包的运行时基线是当前 npm 版本，即 DSH 0.1.1-rc.2。S7R 0.9.4 已针对 rc.2 包图进行类型检查，通过其官方 CLI 安装，并在干净的 Web 配置文件中进行了浏览器测试。与 0.1.0-rc.7 和 0.1.0-rc.8 的兼容性得以保留。单独的 0.1.2-alpha.1 预览版移除了此适配器所使用的 client-runtime/APIProxy 生成，目前尚不支持。请参阅兼容性。

功能一览

| 领域 | 功能 |
| --- | --- |
| Workspaces | 向 DSH 注册真实文件夹，记住最近的文件夹，并将选定的 Workspace 用作 Agent、Finder、Preview、TextEdit、Terminal 和 Find 的文件系统边界。 |
| Knowledge Desk | 明确当前 Workspace；按 Workspace/状态对 Agent 进行分组和筛选；按最近使用/名称/状态排序；以及创建、重新打开、重命名、导出、归档、恢复 Agent，或将 Agent 放置到桌面上。 |
| Agent 窗口 | 流式传输真实的 DSH 输出和推理，显示工具和附件，接受引导/取消操作，重新加载持久化历史，并可选择安全地渲染已完成的 Markdown。 |
| 原生 DSH 控件 | 公开所选 Agent 的真实模型/推理路由、Agent 预设、斜杠命令模式、项目 Skills 以及只读的插件加载器清单，而不虚构并行的 S7R 设置。 |
| Agent 预设信纸 | 从已安装的 DSH Agent 预设创建新的 Workspace 所属 Agent，仅需可选的名称和开场提示词。 |
| 上下文与时间线 | 显示提供方报告的上下文长度和压力，估算内容占比，请求压缩或携带摘要的继任者，并公开完整事件流，将相邻块折叠为连续片段。 |
| 文件 | 提供 Workspace 范围内的 Finder、冲突感知的纯文本编辑、图像/PDF 预览，以及将可移植路径拖放到 Agent 中。主机路径在每次请求时都会再次验证。 |
| 终端 | 打开一个所有者作用域的 DSH 终端，运行 /bin/zsh -f -i，即使没有打开任何 Agent 窗口也可使用，保留低延迟输出并显示可见的命令确认。 |
| 查找 | 以独立作用域搜索文件/文件夹名称、源内容、可见消息或所有持久化的 Agent 事件，然后打开匹配的文件、Agent 或时间线位置。 |
| 监控与通知 | 结合实时 Agent 状态、后台任务、上下文压力、主机 CPU/活动 RAM 以及 DSH 进程 RSS；当 Agent 完成时显示极简通知。 |
| 桌面 | 恢复窗口几何位置和 z 顺序；支持 Workspace、Agent、Finder 项和剪贴簿别名；框选；组拖动；以及可逆的仅别名废纸篓。 |
| 上下文帮助 | 添加键盘可访问的右键菜单和可选的延迟气泡帮助，其位置在精确 1×/2× 放大下保持清晰且有界。 |
| 剪贴簿与配件 | 捕获可编辑的对话卡片，支持一键复制和桌面放置；包括时钟和一个合法洗牌、始终可解的 4×4 拼图。 |
| 显示与壁纸 | 提供适应浏览器或固定逻辑工作区、10px/12px 位图 UI 母版、精确 1×/2× 放大、单色或克制色彩的系统 UI、预览滤镜、协调的蓝绿色内置图案、无缝猫图案，以及处理后的导入壁纸。 |
| 凭据 | 仅读取 DSH 的已配置/来源/可写状态，并通过 DSH 的环回凭据服务写入 DEEPSEEK_API_KEY；保存的密钥绝不会返回给页面。 |

要求

- Node.js 22.19+ 或 24+
- DeepSeek Harness 0.1.1-rc.2（当前 npm latest）
- 用于 DSH 配置文件插件管理和源码开发的 pnpm
- 基于现代 Chromium 的 DSH Web UI 浏览器是主要测试目标

安装

预构建发布版

从最新的 GitHub Release下载 dsh-s7r-0.9.4.tgz，然后将其安装到 DSH Web 配置文件中：

dsh plugin --profile web add ./dsh-s7r-0.9.4.tgz
dsh --profile web --dump-config
dsh web

打开 DSH 打印的环回 URL，通常为 http://127.0.0.1:3080。
该 Release 还包含 SHA256SUMS。在 macOS 上使用以下命令验证下载的归档文件：

shasum -a 256 -c SHA256SUMS

在 Linux 上，使用 sha256sum -c SHA256SUMS。

从源码安装

git clone https://github.com/hunter118/dsh-s7r.git
cd dsh-s7r
pnpm install --frozen-lockfile
pnpm check
pnpm build
dsh plugin --profile web add .
dsh web

移除或替换

dsh plugin --profile web remove dsh-s7r

在添加不同的 tarball 之前，先移除已安装的版本。S7R 的浏览器本地显示、桌面和 Scrapbook 偏好设置可能会保留在该浏览器配置文件中；真实的 DSH Workspace 文件和会话日志不会被移除。

首次运行

1. 打开 S7R → Settings…。如果 DSH 尚未从其启动环境中接收到 DEEPSEEK_API_KEY，请在此处保存。S7R 可以报告已配置/来源/可写状态，但无法读回已存储的值。
2. 选择 File → Choose Folder…。原生 DSH 选择器会在 Agent 开始工作之前将该外部目录注册为 Workspace。
3. 使用 Knowledge Desk 创建、搜索、重新打开、重命名、归档/恢复或导出 Agent。
4. 使用 File → New from Stationery… 从真实的 DSH Agent Preset 开始，或使用 S7R → DSH Control Center… 检查活动模型、命令/模式、Skills 和插件清单。
5. 使用 File → New Terminal 打开 zsh，即使 Finder 和所有 Agent 窗口都已关闭。
6. 开启 Help → Show Balloon Help 以获得延迟的悬停/焦点说明，并打开 S7R Guide… 查看简明的工作流参考。

诸如 Command-N 和 Command-W 之类的浏览器自有快捷键有意不予宣传，因为页面无法可靠地覆盖浏览器标签页。

Knowledge Desk 与 Agent

Knowledge Desk 既是 Workspace 启动器，也是 Agent 浏览器。其标题栏和突出显示的 Workspace 行使当前文件夹一目了然，New Agent Here 始终使用该选择。Agent 一侧默认显示当前 Workspace，可以扩展到所有 Workspace，按运行状态筛选，按最近使用/名称/状态排序，并将结果按其 Workspace 分组。打开现有结果会将窗口重新连接到真实的 DSH SessionRuntime，而不是创建第二条聊天记录。

一个展开的 Agent 工作区，包含渲染后的对话、Context Inspector、Finder、Monitor 和 Clock

Agent 始终处于上下文中：其 Markdown 对话和 Context Inspector 共享前台，而 Finder、实时系统压力、Clock、Knowledge Desk 和桌面对象仍可在其后方使用。

Agent 的生命周期是刻意明确的：

1. New Agent 在选定的 Workspace 中启动。关闭其窗口只会关闭视图。
2. Open 返回到同一个持久化的 DSH 会话，包括其历史事件。
3. Rename 更改面向人类的标题，而不更改会话 ID。
4. Export 生成完整的 Markdown 转录以及机器可读的 JSON 事件归档。
5. 归档 会在不删除 Agent 的 DSH 日志的情况下将其隐藏在 S7R 中；已归档视图可以将其恢复。
6. 桌面 会创建一个可重新打开的别名。移除该别名不会归档或删除 Agent。

每个 Agent 窗口都保留一个紧凑的单行工具栏：

- 上下文 在可用时打开提供方报告的 token 长度/百分比、用户/助手/推理/工具/工作区材料的估算占比、75%/90% 警告、立即压缩 以及 使用当前摘要新建 Agent。占比是基于字符的诊断信息，而非虚假的 token 核算。
- 时间线 打开完整的实时或冷持久化事件账本。相邻的同类型事件（如 assistant/chunk）会折叠为可展开的连续段。
- 其他… 提供重命名、完整的 Markdown/JSON 导出、可逆归档、桌面放置以及持久化的 Markdown 渲染开关。

已完成的输出可以安全地渲染标题、强调、行内/围栏代码、列表、引用和表格。流式输出在消息完成前保持纯文本，原始 HTML 永远不会被注入，LaTeX 保持为源文本。渲染开关按浏览器配置文件生效，且永远不会重写已存储的对话数据。彩色 Emoji 显示为单色像素字体符号或短文本，以保持视觉一致性。

流式输出仅在读者已经接近底部时才跟随最新输出。向上滚动会保持阅读位置稳定；新输出 ↓ 按钮会提示有新内容，并按需返回实时边缘。

原生 DSH 控件与 Agent 预设信纸

S7R → DSH 控制中心… 是所选 Agent 公共 DSH 服务之上的适配器，而非第二个配置数据库。它显示并应用真实的提供方模型/推理路由，允许 DSH 的预设仅在 Agent 仍为空时更改，列出 Agent 作用域的斜杠命令（包括由其预设注册的模式），通过与编辑器相同的调用路径公开项目技能，并报告加载器的完整插件清单。DSH rc.2 将插件清单发布为只读，因此 S7R 有意不绘制无法安全提交的开关。

文件 → 从信纸新建… 是一个刻意保持小巧的、基于 DSH Agent 预设构建的信纸簿。选择一个工作区和已安装的预设，可选地提供显示名称和开场提示，然后 S7R 请求 DSH 以该组合创建 Agent。预设描述和损坏/本地状态来自 DSH；S7R 不创建任何与之竞争的模板格式。

一个真实的 zsh 终端与原生 DSH 命令和模式、查找、知识台以及监视器重叠

同一个扩展桌面可以在 DSH 的原生命令界面之上运行一个真实的工作区作用域 zsh 终端，同时查找、知识台和监视器在下方继续运行。

工作区、访达、文本编辑和预览
选择文件夹使用 DSH 的原生选择器，并将该外部目录注册为工作区；S7R 不限于启动 Web UI 时所在的文件夹。最近使用过的有效工作区可在下次访问时重新打开。随后，Finder 通过 DSH 读取所选会话的规范根目录，每个主机路径都会被重新解析，若逃逸出该根目录则会被拒绝。

- 双击目录进行导航；Open in Terminal 在该目录启动 zsh。
- 文本和源文件在 TextEdit 中打开。保存时会携带上次读取的文件系统版本，因此外部编辑会被报告为冲突，而不是被静默覆盖。
- 图像和 PDF 在 Preview 中打开。PDF 使用 PDF.js 在本地栅格化；页面、缩放、适应以及临时的 Inspect Original 控件不会修改文件。
- 将 Finder 项目拖到桌面上可创建别名，或拖入 Agent 以插入其路径。Agent 工作区内的路径变为 ./relative/path；外部路径保持绝对路径。

Display 可通过有序的 1 位黑/白抖动或直接亮度灰度来过滤 Preview 图像和 PDF 页面。过滤会被缓存、非破坏性，且绝不会重写源文件。

Terminal

Terminal 使用官方 DSH 终端服务和 shell 后端，命令为 /bin/zsh -f -i。DSH 负责进程生成、沙箱策略、回滚缓冲、信号发送、终端身份以及 Agent 所有权。S7R 会立即确认提交的行，并在不重叠读取的情况下轮询保留的前台输出。

File → New Terminal 独立于可见的 Agent 和 Finder 窗口工作。当不存在活动所有者时，S7R 会在当前/最近的工作区中创建一个全新的空白所有者，因此终端不会因缺少 Knowledge Desk 会话而失败。从 Finder 执行 Open in Terminal 会从所显示的目录启动。

DSH rc.2 是面向行的：它不暴露原始浏览器按键流，也不支持生成后 PTY 调整大小。因此，Terminal 的行为类似于响应式的真实行控制台，而不是 xterm 风格的原始附加终端。

Find、Timeline 和 Monitor

File → Find… 具有独立的搜索深度：

- Names — 仅搜索文件和文件夹名称；适用于无需读取文件内容的导航。
- Source contents — 活动工作区内的文本/代码，跳过隐藏目录和 node_modules。
- Conversation messages — 跨持久化 Agent 的可见用户和助手消息。
- All Agent events — 完整的冷事件流，包括工具、推理、块和上下文记录。

匹配项会路由到 Finder/TextEdit/Preview、Agent 或确切的 Timeline 事件。遍历在 5,000 个文件处停止，跳过隐藏目录和 node_modules 目录，每个源文件最多读取 1 MiB，并最多返回 200 个结果。

Monitor 结合了：

- Agents — 实时状态（RUNNING、IDLE 或终止状态）、模型、最新事件时间以及提供方报告的上下文压力。
- Background — 可能在 Agent 窗口关闭后继续运行的 DSH 作业。
- 系统 — 全主机 CPU 和活动 RAM，以及 DSH 进程 RSS，以免将进程内存与整机压力混为一谈。

在 macOS 上，非活动/文件缓存页面会从活动 RAM 中排除，因此可复用的缓存不会显示为应用程序压力。最小化的桌面通知仅在 Agent 进入已完成状态时出现；选择其中一个会打开该 Agent。Monitor 显示在上方的桌面概览中，而不是作为独立的全屏面板呈现。

桌面工作流

窗口边界、z 顺序、缩放/折叠状态、桌面别名、可逆的 Agent 归档、废纸篓和 Markdown 偏好设置在重新加载后仍会保留。终端窗口是有意为之的例外，因为序列化的窗口无法安全地重新附加到由所有者作用域限定的活动 PTY。

菜单栏跟随活动应用程序：File 和 View 仅显示相关命令，而 Window 则在打开的窗口和最近活动的 Agent 之间切换。S7R → Settings… 控制 Window 显示 1–9 个 Agent（默认 5 个）。Tile Windows 会记录平铺前的精确几何布局，而 Restore Previous Layout 即使在反复平铺后也能将其恢复。

工作区、Agent、Finder 项目和单个 Scrapbook 卡片都可以成为桌面对象。拖动空白桌面区域可框选多个别名；然后拖动任意选中项即可移动整组，同时保持其布局。打开别名会路由到其真实对象，而不是浏览器本地副本。

上下文菜单可用于空白桌面区域、桌面别名、废纸篓、Knowledge Desk Agent/Workspace 行以及 Finder 条目。根据对象不同，它们提供 Open、DSH Controls、Finder/Workspace 放置、重命名/导出/归档、相对或绝对路径复制、桌面放置以及 Get Info。这些菜单中的删除操作仅影响 S7R 别名或其可逆的 Agent 归档层；Finder 的菜单绝不会删除真实文件。

文件夹在桌面上有两种明确含义：

- Finder Alias 在其现有 Workspace 中打开该目录。
- Workspace Alias 将该目录注册为 Workspace 并连接其 Agent。

Delete/Backspace 或将项目拖放到废纸篓上，只会将别名移入 S7R 的可逆废纸篓。Put Away 会将其恢复；Special → Empty Trash… 仅永久丢弃别名。真实文件、Workspace、Agent 日志和 Scrapbook 卡片绝不会被桌面废纸篓删除。

拖放到 Agent 中的路径，如果位于该 Agent 的 Workspace 内，会成为可移植的 ./relative/path 引用，否则保持为绝对路径。

Help → Show Balloon Help 会在标记的控件上启用延迟显示的黄色说明。该偏好设置在本地持久保存。气球提示也会在键盘焦点时出现，在输入/点击/滚动或菜单/对话框打开时消失，在桌面边缘会翻转并限制位置，并且基于逻辑坐标计算，因此精确的 2× 放大不会使偏移量加倍。

Scrapbook 和桌面辅助工具
添加到剪贴簿会将一条消息捕获到浏览器本地的可编辑卡片中，同时保留其来源 Agent 引用。捕获链接会立即呈现为已访问样式状态作为反馈，每张卡片都支持一键复制，并且可以将单张卡片放置到桌面上，而无需打开整个剪贴簿。

时钟是一个实时模拟/数字桌面配件。拼图是一个原创的 4×4 滑动数字实现；打乱只执行合法移动，因此生成的每个棋盘都是可解的。

系统应用程序和偏好设置位于其工作流菜单中。时钟和拼图作为桌面配件保留在 S7R 应用程序菜单中。

显示与壁纸

展开的显示控件，包含 Cat 壁纸、拼图、剪贴簿、知识桌、访达、监视器和时钟

显示已直接滚动到壁纸处理部分，同时无缝 Cat 平铺、可解拼图、剪贴簿工具栏、知识桌、访达、监视器和时钟表明显示更改不会暂停桌面的其余部分。

显示分为四个方面：

- 逻辑工作区： 适应浏览器会根据当前视口重新计算可用桌面；经典 512×342、紧凑 640×480、标准 832×624 和扩展 1024×768 保留固定的时代风格工作区。
- 界面尺寸： 紧凑 10px 和舒适 12px 是独立的位图母版。它们的语义小号文本也分别切换为原生 8px 或 10px 母版。菜单、标题栏、控件、间距、滚动条和默认窗口尺寸都会一起变化，而不仅仅是放大文本。
- 像素放大： 1× 或精确 2× 整数布局放大。适应浏览器在 2× 下先将逻辑工作区减半，然后再放大，并且指针增量会映射回逻辑坐标。
- 内容滤镜： 预览图像和栅格化 PDF 页面可以分别独立使用有序 1 位黑白抖动或直接灰度。对话图像和源文件保持不变。

经典圆点是默认壁纸。桌面灰色、细条纹、无缝 Cat 和导入图像也可用。Cat 和导入图像会被采样到真正的低分辨率网格上，经过滤镜处理，并烘焙为整数最近邻 PNG。导入内容会累积在命名的下拉库中，并可以按像素尺寸平铺或填充桌面。重新渲染提供 1px 或 2px 块；处理完成后不会保留原始导入文件。

持久化与数据所有权

| 所有者 | 数据 |
| --- | --- |
| DSH | Agents、对话/事件日志、工作区注册、文件、终端所有者/进程、工具、凭据和后台作业。 |
| S7R 浏览器配置文件 | 显示偏好设置、处理后的导入壁纸、剪贴簿卡片、窗口和桌面布局、别名废纸篓、可逆 S7R 归档、Markdown 偏好设置和气球帮助设置。 |
浏览器本地记录是有版本的；格式错误的记录会以失败关闭方式处理，已知的旧格式会显式迁移。关闭 Agent 窗口绝不会删除其 DSH 会话。清除浏览器站点数据会重置 S7R 的本地桌面自定义设置，但不会删除 DSH 对话或 Workspace 文件。

安全模型

- 凭据状态和变更使用 DSH 官方的仅限回环服务；从浏览器的角度来看，存储的密钥是只写的。
- 包特定的主机 RPC 通过回环授权，并验证标识符。
- 每个文件请求都限制在选定的活动或持久化 Workspace 根目录之下。
- 保存现有文件需要提供上一次读取返回的版本。
- 二进制读取上限为 25 MiB。
- 终端 ID 通过 DSH 保持所有者作用域。
- Markdown 渲染从受限语法创建 React 节点，绝不注入原始 HTML。

请按照 SECURITY.md 中所述，私下报告凭据泄露、路径遍历、不安全写入、终端所有权错误或注入问题。

兼容性与已知限制

此版本已针对官方 DeepSeek Harness 提交 b150a551b8d465e31e418e1b2eaf5e79bbb7d28e（0.1.1-rc.2，验证于 2026-08-29）进行了运行时测试。该插件保留其显式的 rc.7/rc.8 对等分支，而默认不发布的 0.1.2-alpha.1 客户端架构被记录为不受支持，而不是被静默接受。确切的适配器接缝和验证结果记录在 COMPATIBILITY.md 中。

- DSH rc.2 具有固定的后端 PTY 尺寸，不支持调整大小方法或原始浏览器字节流。
- TextEdit 是一个健壮的纯文本/代码编辑器，不是语言服务器或语法高亮 IDE。
- Preview 可渲染光栅 PDF 页面，但没有可选择的 PDF 文本层。
- DSH 公开了 archive，但没有公开的 unarchive API。因此，S7R 对新操作使用可逆的本地隐藏/归档层；较旧的 DSH 原生归档 ID 无法通过受支持的接缝恢复。
- S7R 客户端有意替换根插槽；原生 DSH 界面仍然安装，但不会混入模拟桌面。

开发

pnpm install --frozen-lockfile
pnpm check
pnpm pack

pnpm check 运行严格的主机/客户端 TypeScript 检查、68 个确定性测试以及生产主机/客户端打包。PDF.js 及其 worker 实现已嵌入，因此 Preview 不需要 CDN 或运行时网络依赖。

项目参考：

- 架构
- 兼容性说明
- 产品与设计规范
- 开发说明
- 变更日志
- 贡献指南

许可证与资产来源
S7R 采用 MIT 许可证。它是一个独立项目，与 Apple Inc. 或 DeepSeek 无关联，也未获得其认可。不包含任何 Apple  artwork、系统文件、专有字体、声音、截图或提取的资源。图标和图案均为原创的 CSS/文本构建；Cat 壁纸是由 S7R 本地灰度管线处理的原创生成位图。

浏览器捆绑包包含来自 Fusion Pixel Font 的简体中文比例和等宽 8px/10px/12px 字体（依据 SIL OFL 1.1）以及 PDF.js（依据 Apache-2.0）。版权声明和完整许可证文本包含在 THIRD_PARTY_NOTICES.md 和 THIRD_PARTY_LICENSES/ 中。