page-harness-dsh
DeepSeek Harness 插件：从 DSH 启动 page-harness 分享预览，以便团队成员查看正在运行的页面
插件会安装到这里；不确定时保持 web。
npx -y @deepseek-ai/dsh plugin --profile web add page-harness-dsh@0.1.3Page Harness Dsh 以 page-harness-dsh 发布，当前版本为 0.1.3。Plugin Hub 会校验它的 manifest，并保存精确安装来源，便于复现安装结果。
把正在运行的网页嵌进 DeepSeek Harness 对话右侧，支持取点引用、在线编辑批注、一键团队分享评审：
从 npm 安装，或在本仓库构建后按目录安装：
dsh plugin --profile web add page-harness-dsh
npm ci && npm run build
dsh plugin --profile web add /absolute/path/to/page-harness/dsh-plugin
重启 dsh web，强制刷新浏览器。通过 npm 安装插件时会自动安装 page-harness CLI 依赖，无需另外全局安装。插件会优先使用同一仓库的 dist/cli.js，其次使用依赖包里的 CLI；也可以在设置里填 cliPath。
page_harness_preview，右栏自动打开并刷新。HTML 文件由插件在本机起的静态服务提供；也可以传 dev server 端口或 URL。npm run dev、vite、python -m http.server、flask run、uvicorn、node server.js 等）时，按上面的结果执行；万一它没打开预览，这一轮结束时插件找到对应端口就自动打开，找不到就在对话里提示。index.html）或端口。page_harness_notes 读取并修改。预览用 previewPort（默认 17994）和 previewPort + 1，静态文件服务只监听 127.0.0.1，优先用 previewPort + 2。iframe 地址是「浏览器访问 DSH 用的主机名 + 这两个端口」：
浏览器和 DSH 在同一台机器，或通过 SSH 转发访问：预览只监听 127.0.0.1。SSH 转发时把预览的两个端口也转过去，例如
ssh -L 3080:127.0.0.1:3080 -L 17994:127.0.0.1:17994 -L 17995:127.0.0.1:17995 your-host
从其他地址打开 DSH（公网 IP、域名）：预览监听 0.0.0.0，安全组要放行这两个端口。远程浏览器必须先用嵌入令牌换 Cookie，否则页面返回 403。令牌只出现在 --json 的 ready 行里，由插件放进 iframe，不会写进普通日志。
page-harness 只允许 DSH 页面的源（第一次调用插件接口时记录）嵌入预览，取点引用也只发给这个源。HTTPS 页面不能嵌入 HTTP 预览。
page_harness_share，对话里出现分享卡片。| 工具 | 作用 |
|---|---|
page_harness_preview | 在右栏预览网页（path，默认 index.html；或 url）。再次调用会刷新 |
page_harness_notes | 读取预览上未解决的意见 |
page_harness_share | 启动分享预览（url，可选 project，默认当前会话的工作目录）。同一页面重复调用会复用 |
page_harness_status | 查看是否在运行和分享链接 |
page_harness_stop | 停止分享 |
同一时间只运行一个分享预览；换一个页面会先停掉旧的。dsh web 退出或重启时会一起停掉。
page-harness 用两个相邻端口：分享端口 port（页面）和 port + 1（邀请链接、意见面板）。同事要能访问这两个端口。
| 配置 | 默认 | 说明 |
|---|---|---|
previewPort | 17994 | 右栏预览端口。本机或 SSH 转发时只监听 127.0.0.1；从其他地址打开 DSH 时监听 0.0.0.0，并用嵌入令牌限制访问。控制端口是它 +1 |
port | 17990 | 分享端口，控制端口是它 +1 |
host | 0.0.0.0 | 监听地址 |
publicHost | 空 | 同事访问用的主机名或 IP。云主机填公网 IP 或域名；留空用本机第一个局域网地址 |
publicScheme | http | 前面有 TLS 终止时选 https |
withAgent | false | 同时启用本机 Agent CLI。默认只评审 |
cliPath | 空 | dist/cli.js 路径，留空自动查找 |
在云主机上：安全组放行 port 和 port + 1，并把 publicHost 设为公网地址。
403；邀请换来的是带签名的评审者 Cookie，评审者碰不到 Agent。/page-harness 接口只接受同源 JSON POST。cd dsh-plugin
npm test
lib/host.js 是 Host 入口（工具、/page-harness 接口、设置），lib/preview.js 管理 page-harness 子进程，lib/page-preview.js 和 lib/static.js 负责右栏预览，lib/client.js 是右栏面板、标题栏按钮、侧栏按钮和对话卡片。右栏不用 DSH 自带的详情栏（它限宽 300–520px），而是挂在 shell.overlay 里、贴在窗口右侧，并给 DSH 主框架留出同样宽的右边距。改 Host 后重启 dsh web；改 Client 后强制刷新即可。