DSH 私密模式

PDSH（Private DeepSeek Harness）是 DeepSeek Harness 的第三方插件。当前 0.2.1 版本提供侧栏显示遮挡、局部身份替换和 macOS Desktop 页面截图工作台，发布锚点为 v0.2.1。它不创建隔离会话，也不是数据防泄露工具。

功能

• 侧栏标题： 帽子眼镜按钮立即切换工作区和会话标题的灰条遮挡，也识别原生“新会话”占位行；搜索结果只遮标题与工作区名。
• 显示身份： 在官方插件设置中选择本地昵称、离线生成或本地光栅头像，也可以保留账号头像。只改变侧栏外观，不修改账号资料。
• 截图工作台（macOS Desktop）： 帽子右侧的相机点击后先采样当前整个可见的 DSH 页面（包括当时展开或收起的侧栏），再打开编辑器。可重拍、标注遮挡区域、调整背景/边距，并复制或保存 PNG。界面跟随 DSH 的主题、字体、圆角与控件语义；照片、渐变与选色光谱保留为编辑内容颜色。截图不写入插件配置。
• 更新提示： 打开自身插件详情时才探测 GitHub 稳定 tag；发现更高版本后，版本号旁出现上箭头。确认后由官方插件管理器安装固定提交，不自动重启。预发行版本不会触发稳定版提示。

边界： 标题原文仍在宿主 DOM、无障碍树和数据中。截图工作台的“隐私遮罩”只在拍摄前尝试给已识别的侧栏标题和身份放置占位符；聊天内容、菜单、路径、日志、请求和其他窗口并不自动遮挡。打开工作台前请检查原始截图与最终导出。DOM 页面取像不包含系统窗框；圆角和阴影由工作台后加。可见的 iframe/webview/视频暂不支持，资源不完整或取像时窗口尺寸改变会拒绝截图，不输出缺块画面；窗口结构不被识别时跳过建议区域。

安装与使用

目标宿主：DeepSeek Harness 0.1.7-rc.2。侧栏入口和标题识别是该构建的 DOM 适配，不声明兼容其他版本。PDSH 不修改或重签官方应用。

在 插件 → 添加插件 → GitHub 仓库地址中填入 https://github.com/daftAI2026/PDSH，建议固定 v0.2.1 对应提交；已安装的旧版可通过版本号旁的更新提示确认升级。安装第三方插件即运行其代码，请先审查来源与依赖。官方机制见打包与安装指南。

截图兼容性状态： v0.2.0 的系统截图路径并不等价于参考实验的页面取像。v0.2.1 已改为渲染器内的全视口 DOM 栅格化，不要求屏幕录制权限或 CDP 启动参数；它不是 Electron 合成器的逐像素截图。源码合同与浏览器样例取像已验证；安装后的 Desktop 工作台完整交互仍待验收。v0.2.1 带此已知限制发布，tag 不代表已完成桌面兼容验证。生产使用前请先在独立 profile 验证；需要已验收的显示功能时可保留 v0.1.1。

• 搜索旁帽子：即时切换标题遮挡；相机：立即截取当前窗口并在截图完成后打开工作台。
• 插件 → DSH 私密模式：开关和“头像来源”选项即时保存；昵称勾选或 Enter 保存，Esc 放弃编辑。控件提示沿用桌面端 Tooltip 样式与交互。
• 语言跟随 设置 → 通用设置 → 语言，不另存语言偏好，也不翻译自定义昵称。
• Git 推送不会更新已安装插件；替换包后按宿主提示重启。不要用外部 CLI 修改正在由 Desktop 独占的 desktop profile。

开发

src/host/            Cordis 配置与官方设置接线
src/shared/          Host/Client 共享验证与文案
src/client/          设置、侧栏适配、更新入口与生命周期
src/client/capture/  截图工作台编辑、背景、遮挡、导出与 DSH 主题样式
locale/              官方离线发现的中英文包元信息
tests/               配置、DOM、样式来源、视口取像和生命周期合同

手写源码与测试均为 TypeScript/TSX。根目录 index.js、client.js、client.js.map 是生成并随包提交的宿主运行产物，不能简单改名为 .ts。可见 UI 规则及 DSH token 来源见 style-sources.json；协作边界见 AGENTS.md。

pnpm install --frozen-lockfile
pnpm test
pnpm run bundle
pnpm release:check # 仅在提交完成、工作树清洁时运行

Node/jsdom 测试和浏览器页面取像成功都不能替代安装后的 Desktop UI 验收。发布稳定 tag 前应在目标版本验证相机位置、主题明暗、资源/嵌入内容失败反馈、截图/重拍/复制/保存、停用恢复、搜索展开和侧栏折叠；不得破坏用户主 profile。

许可

PDSH 使用 MIT；复用资源的许可见 THIRD_PARTY_NOTICES.md。PDSH 不是 DeepSeek 官方插件，@daftai/pdsh 也未在 npm 发布。