READMESource: main@3ba2f7c7
Second Pass · 第二遍
一条写完的回答,两种读法;每条论断,都对得上原文。
Second Pass 是一个 DeepSeek Harness Web 插件。它不重新回答用户的问题,而是把当前会话里一条已完成的 assistant 回答当作唯一事实来源,做成两种更容易进入的形态:
- 网页:可阅读、可交互、可逐条核对的单页;
- 视频:带旁白和字幕的短片,适合完整看一遍。
每一份产物都带核对清单:覆盖了哪些 claim、哪些被省略、哪些数字/名称/日期需要回原文核对。
0.9.0 极简编辑版式(2026-11-14)
这一版重做「点着看」的视觉系统,目标是安静、清楚、有编辑判断,而不是把元素堆满。

- 单一左对齐阅读栏:1120px 页面容器、760px 内容栏;标题、导语、正文、组件共用一条左轴。
- 标题降级:从居中衬线
92px改为左对齐无衬线clamp(38px, 5.2vw, 64px),字距收紧,中文不被拦腰断词;移动端 34–44px。 - 去掉装饰:删除纸张噪点、顶部径向渐变、花饰
✦✦✦、居中大留白、宽屏来源浮标;只保留细线、编号和一种朱砂强调色。 - 颜色收敛:近白纸色 + 近黑墨色 + 单一朱砂色;正文与辅助文字使用高对比度 token。
- 组件变平:卡片、KPI、步骤、引用、callout 统一为细边框、无阴影、无 hover 抬升;引用保留编辑式衬线。
- 减少动效:取消标题 clip-path 和滚动 reveal,首屏与打印内容始终完整可见;目录/核对交互不变。
- 保留功能:目录、滚动进度、暗色、核对模式、生成发送草稿都保留。
参考与取舍见 docs/PAGE-DESIGN.md。
0.8.1 页面语言去黑话(2026-11-14)
- 页面 prompt 的目标读者改为“聪明但不熟悉这个领域的人”:先解释“是什么、为什么重要、跟我有什么关系”。
- 明确禁止照搬原文句子和段落结构:除数字、专有名词、必要的短引用外,必须用自己的话重写。
- 行业黑话/缩写/抽象词先换日常说法;必须保留时在首次出现处用一句人话解释;禁止“抓手、赋能、闭环、链路、范式、落地、颗粒度、底层逻辑”等词。
- 分析阶段的 terms 会作为“术语解释参考”送进页面 prompt,不再只是装饰。
- 真实生成验证:页面正文无上述黑话命中;示例从“流程/链路”改成了读者能复述的动作说明。
- 快速测试 120/120;打包产物更新为 0.8.1。
0.8.0 核对结果生成发送草稿(2026-11-14)
- 页面核对模式新增「生成发送草稿」:把当前勾选、未勾选和证据异常条目整理成一段摘要,直接放入当前会话的输入框。
- 只生成草稿,绝不自动发送:不会触发 assistant 回合,也不会调用提交;用户检查后自己按发送。
- 新页面使用核对面板内的按钮;早先生成的旧页面在页面工具栏提供同样的「生成发送草稿」回退按钮。
- 输入框已有文字时保留原内容并在光标处插入;输入框正在提交时拒绝生成。
- 跨会话作品库页面如果当前输入框属于另一个会话,会提示先打开对应会话。
- 快速测试 120/120;打包产物更新为 0.8.0。
0.7.2 运行目录惰性创建(2026-11-14)
.second-pass-runtime不再在插件激活时创建;只有首次真正发起影片任务时才准备临时目录,并清理旧任务残留。- 只使用 Page 或只浏览作品库时,不会再留下空的
.second-pass-runtime。 - 打包产物更新为 0.7.2。
0.7.1 操作栏与初始化修正(2026-11-14)
- 消息动作条恢复为纯图标按钮,去掉可见的“第二遍”文字;提示与
aria-label保留。 - 作品库改为首次需要时才初始化,避免插件激活时的无谓磁盘 I/O,也消除了快速退出测试中的目录竞争。
- 当前测试仍为 117/117;打包产物更新为 0.7.1。
0.7.0 证据、作品库与交付质量(2026-11-13)
- Evidence-first ledger:每条 claim 带逐字原文 quote;Host 做 exact/normalized 校验、数字/单位/极性检查,只有“证据通过 + 页面/影片实际落点”才算 verified;模型自报的
coveredClaimIds只保留为 declared,不再直接显示绿色。 - 持久作品库:页面、影片、WebVTT、poster、证据账本、核对状态与可选原文快照写入 DSH 数据目录;重启后可从“作品库”找回、继续核对、导出 ZIP。核对状态不再只存在当前 iframe。
- 无障碍:侧栏小字对比度、核对筛选
aria-pressed、动态计数 live region、弹窗背景 inert、唯一“定位”标签、影片<track>字幕与文字稿;页面正文保持 axe 0 violation。 - 图片性能:页面图片上限降到 2.5MB/张、8MB 总量;超过 800KB 尝试 ffmpeg 压到 1600px WebP,失败保留原图并记录 warning。
- 可配置:DSH 设置支持
quality(standard/fast)、aspect(landscape/portrait)、voice、pageTheme、ttsProvider(edge/piper)、source/作品库配额等;默认仍为 1280×720 / 24fps / edge 在线配音。 - 影片扩展:可选 9:16 竖版、快速模式(明确跳过 animatic/双渲染并在 QA 中标注)、本地 Piper TTS(真实 binary 未随包提供);标准模式仍是原来的 animatic + 双渲染。
- 生成恢复:JSON 解析失败会做一次修复重试;长原文有可配置 budget(默认 120k 字符),不再把无限长的回答直接送进 context。
- 工程:新增 100+ 快速测试、静态 a11y 回归与 GitHub Actions;CSP hash、文件白名单和任务超时继续保留。
0.6.1 安全与可靠性加固(2026-11-12)
- Page:CSP 从内联脚本改为 shell SHA-256;正文经过 fail-closed allowlist sanitizer;事件属性、外部资源、
javascript:、任意data-file被清理。 - 文件桥:只打开原文 source allow-list 中、workspace 内的相对路径;全屏 PageView 保留同一 iframe,核对进度和滚动位置不丢。
- 一致性:切会话/消息会 abort 旧请求;服务端 analysis 绑定 source,客户端传入的 analysis 不再能串台或命中旧缓存。
- Film:storyboard 放入异步 job;渲染串行;对
CAPTURE_TRANSIENT_BROWSER有限重试;job 暴露code/detail,硬超时 15 分钟;job 与 asset 同生命周期。 - QA:拒绝静音/不可听旁白、未归一化音轨、错误 codec/采样率/帧率、空字幕;横版 640×360 / 竖版 360×640 animatic、双渲染与 WebVTT 均有生产检查。
- 交互:生成必须由用户显式发起,切换标签不会偷偷开始渲染;下载不再依赖子组件的共享 action ref。
0.6.0 收敛为两种形态(2026-11-10)
这一版是产品减法:
- 移除「说清楚」和「画出来」两个选项,只保留网页和视频;
- 移除对应的前端视图、图表/流程图生成链路和 dagre 依赖;
- 分析 prompt、状态接口、format 路由都只接受
page/film; - 旧的两种产物不再出现在新会话里;已打开页面需要重新生成。
为什么:视频和网页已经覆盖“读完 + 看完”两个主要场景;保留四个入口会让选择成本和维护面都变大。
它做什么
| 形态 | 产出 | 读者目标 | 交互 |
|---|---|---|---|
| 01 点着看 | 自包含单页 HTML | 按自己的顺序读、点开文件、核对 claim | 目录、滚动进度、核对模式、原文图片/文件、TOC、暗色 |
| 02 看一遍 | MP4 + WebVTT | 数分钟内看完整条回答 | 播放、分镜跳转、字幕下载、横版/竖版 animatic、双渲染 QA |
01 点着看
- 自包含 HTML,离线可打开;CSP 使用 shell 脚本 SHA-256,模型内联脚本、事件处理器和外部导航被阻止。
- 原文图片自动内嵌(最多 8 张、单张 2.5MB、总计 8MB;大图优先用 ffmpeg 压成 WebP)。
- 原文文件链接变成可点按钮;路径经过 workspace 与源文件白名单校验后,在 DSH 右侧栏打开。
- 底部 核对模式:每条 claim 显示逐字原文 quote,区分“证据已核验 / 仅模型声明 / 原文无依据 / 与原文冲突 / 未覆盖”;勾选状态保存到作品库。页面和影片都可以从“作品库”重新打开。
- 模型只写语义正文;版式、目录、滚动进度、暗色和交互由 Host 设计系统接管。
02 看一遍
- VO-first:先 TTS 测真实时长,再排画面;不猜时间。
- animatic 预览关:成片前生成低清预览(横版 640×360 / 竖版 360×640),校验尺寸、可听旁白和时长。
- 双渲染帧回归:最终渲染两次,优先 framemd5 逐帧一致;GPU 字体抗锯齿导致的微小差异回退到逐帧 SSIM(阈值 0.995),交付首版并记录 warning。
- loudnorm 到 -16 LUFS / -1.5 dBTP;Audio 必须是 AAC 48kHz;测不到可听旁白则拒绝交付。
- WebVTT 字幕由 TTS 词边界生成;FilmView 会把 VTT 挂成原生
<track>,也提供文字稿。 - ffprobe 交付契约:默认 1280×720 / 24fps / H.264 / AAC 48kHz / 双声道;可选 720×1280 竖版;corrupt、缺轨或超时都会失败。
fast模式会跳过 animatic 与双渲染,QA 明确写animatic:false/determinism:'skipped',不会假装通过。- HyperFrames 渲染串行执行,并对
CAPTURE_TRANSIENT_BROWSER做有限自动重试。 - 代价:一条片约 3 倍渲染时间;任务硬超时 15 分钟。
安装
从本地路径安装:
dsh plugin --profile web add ./dsh-second-pass
或安装 0.9.0 打包产物:
dsh plugin --profile web add ./dsh-second-pass-0.9.0.tgz
然后重启当前 dsh web。Host 半侧(分析 prompt、页面外壳、影片路由)在启动时加载;只改浏览器端时 DSH 的 client HMR 会自动热换。
使用
- 打开任意会话里一条已完成的回答;
- 悬停动作条,点 第二遍;
- 右侧栏出现两个选项:点着看 / 看一遍;
- 选择形态后,点空状态里的「从这一级开始」生成;影片标准模式通常需要几分钟(含 animatic 与双渲染),快速模式约 1–2 分钟;点击标签本身不会偷偷开始渲染。
- 生成后点「作品库」可重新打开、继续核对或导出 ZIP;作品会写入 DSH 数据目录,不随标签页关闭而消失。
真实产物
架构
assistant-actions (第二遍按钮)
│
▼
rightbar tab · StudioTab ─── POST /dsh-second-pass/api/*
│ │
│ ├─ 从 DSH session log 取原文
│ ├─ ctx.agentDefaultModel + ctx.llm
│ ├─ analyze → claims + 建议形态
│ ├─ page → 自包含 HTML(CSP hash + allowlist)
│ └─ film job → storyboard + TTS + HyperFrames + ffmpeg QA
▼
PageView iframe · FilmView <video> · fidelity ledger
- Host 半侧:ESM Cordis 插件;Node 内置模块 +
@deepseek-ai/schemastery(仅 Config 校验)+ 可选 CLI 工具。 - Browser 半侧:DSH lazy-CJS 模块格式,单文件
lib/client.js。
设计原则
- 原文不改:不重新回答,只改写/呈现;事实来源唯一。
- 可核对:claim id 贯穿分析、页面和核对清单。
- 本地优先:文字、页面、影片画面和作品库都在本机;默认影片配音使用 edge-tts 在线服务,可配置本地 Piper。
- 少而深:两个形态都做到可交付,而不是四个浅入口。
验证摘要
- 快速测试 120/120 通过(session、路由、Page、evidence verifier、library、sanitizer、路径白名单、图片压缩、字幕/响度解析、影片参数与 a11y 静态回归等)。
- 影片真实链路已跑通:英文多幕与中文单幕均生成过 H.264/AAC MP4;当前环境中文 1 幕含 640×360 animatic、双渲染 framemd5、loudnorm、可听旁白与 WebVTT 检查。0.7.0 另验证了 portrait fast 与默认 landscape standard;HyperFrames + Chrome 在重负载下仍有瞬时失败概率,渲染层已串行化并有限重试。
- 真实 DSH 页面验证:模型返回 7 条带逐字 quote 的 claim,页面生成 7/7 “证据+落点”核验;作品库保存、核对状态与 ZIP 导出通过。
- Page 设计:1440 / 620 / 390 实测,320–1440 无横向溢出;核对模式键盘/焦点陷阱可用。
- 页面文件按钮已加路径白名单,并在真实 DSH 侧栏打开过工作区文件;图片以 data URL 内嵌。
已知边界
- 页面内容由模型生成;Host 负责版式与交互。模型自带的
<style>/<script>、事件属性、javascript:、外部资源与任意data-file会被清理并记录。 - Page 图片上限:8 张 / 2.5MB 单张 / 8MB 总计;超过 800KB 尝试压缩。文件按钮只在 DSH 内有效;独立下载的 HTML 仍可显示图片但不能打开工作区文件。
- 影片默认 1280×720 / 24fps,可配置 720×1280 竖版;default edge 配音需联网;标准模式三次渲染让单条片约 3 倍耗时,fast 模式跳过关卡。
- animatic 是 draft 渲染后缩到横版 640×360 / 竖版 360×640;双渲染是全片视频帧 framemd5,GPU 字体抗锯齿差异走逐帧 SSIM,音频单独 QA。
- 作品库持久保存在 DSH 数据目录(默认
$DSH_HOME/second-pass-library);配额可配置。Piper 本地 TTS 需要用户自行安装 binary 与模型;真实 piper 尚未在本机验证。音频描述(audio description)仍只提供文字稿/字幕,不提供独立 AD 音轨。源文字长于maxSourceChars时会在调用模型前拒绝并提示。
文档
开发
npm install
npm run build # 输出 lib/client.js
npm test # 快速单测
npm run test:film # 真实影片端到端(需要 edge-tts / hyperframes / ffmpeg)
许可
MIT。Third-party notices 见 THIRD_PARTY_NOTICES.md。
No comments yet. Be the first to write one.