dsh-card-export
v0.1.4
Published
Report and conversation export for DeepSeek Harness: renders any Markdown report (fact-check reports get a summary card plus a full verbatim long image) and any DSH session excerpt into shareable PNG images. Zero npm dependencies — it drives the Chromium-
Maintainers
Readme
dsh-card-export
English: README.md · 本文为中文版
把 Markdown 报告和 DSH 对话导出成可分享的图片。DeepSeek Harness 插件,含两个技能。
零 npm 依赖:不内置浏览器、不下载 Chromium,直接用机器上已有的 Chromium 系浏览器(Edge → Chrome → Brave/Chromium/Vivaldi),失败降级 PDF,再不行交付 HTML。
目录
它是什么
两件事,一套渲染底座:
- 报告 → 两张图:任意 Markdown 报告,只要走
report预设(默认就是它),都会产出**短图(结论)+ 长图(完整原文)**两张。 - 对话 → 一张图:DSH 会话里选定的一段对话变成消息流长图,含用户指令与助手回答,思考块与工具调用可选。
只有显式指定 --preset generic 时才是单张(适合非报告类文档:随笔、说明、清单)。
只做渲染,不做内容加工:报告里没写的,图上不会有;对话里没说的,图上也不会补。
两个技能
| 技能 | 中文名 | 缩写 | 做什么 |
|---|---|---|---|
| report-card | 报告图片化导出 | RPC | 任意 Markdown 报告 → 短图(结论)+ 长图(完整报告) |
| transcript-card | 对话内容图片化导出 | TSC | DSH 会话片段 → 消息流长图 |
report-card:为什么是两张图
- 短图——在尽量小的版面给出足够信息。结论由模型读完报告后撰写(
--brief),渲染器只排版;没给 brief 就退化为「原文提取」,并在图上标明。 - 长图——严格按原报告的结构、顺序、内容逐段还原:不重组、不删减、不改写、不替作者总结。
产物由预设决定,不按报告内容区分:report(默认)=两张,generic(显式指定)=一张。来自 dsh-fact-check 的报告是 report 预设下的另一种皮肤:短图里多出档位徽标、甲乙双轨、断言分档;长图仍是报告原文。这套皮肤的识别依据就是报告自己的二级标题(## 一句话结论 / ## 哪些是真的 / ## 来源 命中任意两段),所以那条耦合归 fact-check 的报告模板所有,不归本插件。英文报告同样适用:等价锚点是 One-line verdict / What is true, what is false / Sources,走上同一套皮肤、同一套判定语义,只是标签整套换成英文(Confirmed / Likely true / Unconfirmed / False / Unverifiable,以及页脚、小节标题、禁引用警示)。语言由报告自己的二级标题判定,--lang zh|en 可强制;中文产物与改造前逐字节一致。
五个非裁决骨架也会有短图结论,但方式不同:不解析结构、不造档位,只把该骨架自己声明的「结论段」抬到短图上——释义取 ## 一句话定义、地图取 ## 核心发现、指标卡取 ## 数值、因果取 ## 主因(没有就退到 ## 落地概率 或 ## 因果链)、对照取 ## 分场景结论,标签写成「骨架名 · 段名」。识别门槛是该骨架独有的标题命中 ≥2 段,共享标题(## 定界、## 来源、## 缺口、## 可比性检验)不参与;认不出就完全退回原来的普通文档。详图里有固定语义槽的那几段换成强化块:指标卡的 ## 数值 → 数字卡、地图的 ## 确定性分层 → 分层条、因果的被排除成因 / 对照的 ## 不可比 / 释义的 ## 常见误解 → 灰底块。换的只是摆放方式,文字仍逐字来自原文,也不重排。识别表与强化表都在 lib/modes/skeletons.mjs,是一张声明式表,不是五套解析器。这张表来自上游:fact-check 在 reference/skeleton-anchors.json 里自己声明,并由它的 lint-skill 断言与 SKILL.md 的标题保持一致(标题改名会变红);本插件优先读它,读不到(旧版本、或包没带 reference/)就用内置的同内容副本,内置表也认不出就逐字退回普通文档——三级降级,FACT_CHECK_ANCHORS=<路径> 可显式指定。匹配规则照抄上游的 stripTrailingParenThenExact:先剥标题末尾的括号说明,再全等比较,不做前缀或子串(否则 边界 会误吞 边界与反例);来源 只留给裁决,定界 / 缺口 / 可比性检验 任何骨架都不许用来识别。
transcript-card:忠实于你看到的
装了 GenUI 的环境里,对话中的 ```dsh-ui 块显示为卡片。导出的忠实目标是你在 DSH 里看到的样子,所以默认按卡片渲染:
| 层级 | 触发 | 图上表现 | |---|---|---| | ① 渲染成卡片 | 能解析、组件受支持 | 卡片(callout / list / keyvalue / table / stat / badge / steps / …) | | ② 单条原文兜底 | 某条组件认不出 | 「未识别组件,原样保留」+ 该条 JSON,其他条目照常渲染 | | ③ 整块原文兜底 | JSON 解析失败、items 为空 | 整块退回代码块,一字不改 |
想看原始 JSON:--no-render-ui。
环境要求
- Node.js ≥ 22.15(会话日志是 zstd 压缩的,
node:zlib从 22.15 才有 zstd) - Chromium 系浏览器之一(用于栅格化):Edge / Chrome / Brave / Chromium / Vivaldi
- DSH(插件形态),或直接调用
tools/下的 CLI(不装插件也能跑)
没有浏览器也能用,但只能拿到 PDF 或 HTML——见降级链。
安装
作为 DSH 插件
dsh plugin --profile desktop add dsh-card-export本地开发用 link: 安装(改源码重启即生效,市场会显示「本地开发」):
dsh plugin --profile desktop add T:\dsh-card-export装完重启 DSH,技能目录里会出现 report-card 与 transcript-card。
不装插件,直接当 CLI 用
git clone https://github.com/7starsseeker/dsh-card-export.git
cd dsh-card-export
node tools/doctor.mjs # 先看这台机器能出什么用法
导出报告
# 先看解析结果(不出图)
node tools/render-report.mjs report.md --out ./out --dump
# 出短图 + 长图
node tools/render-report.mjs report.md --out ./out --png --width 960
# 带模型撰写的摘要(推荐)
node tools/render-report.mjs report.md --out ./out --brief brief.json --png
# 只要 HTML(无浏览器环境)
node tools/render-report.mjs report.md --out ./outbrief.json 形如:
{
"conclusion": "一句话:这份报告到底在说什么",
"points": ["该知道的第 1 件事", "第 2 件事", "第 3 件事"],
"numbers": [{ "label": "指标名", "value": "61% → 84%" }],
"caveat": "本次覆盖不到的边界"
}导出对话
# 先看有哪些轮次、各类事件多少条
node tools/render-transcript.mjs session.v4.jsonl.zstd --out ./out --dump
# 最近 3 轮
node tools/render-transcript.mjs <session> --out ./out --last 3 --png
# 指定轮次 / 事件区间
node tools/render-transcript.mjs <session> --out ./out --turns 2-5 --png
node tools/render-transcript.mjs <session> --out ./out --seq 120-260 --png
# 引用式定位:从「这段」到「那段」
node tools/render-transcript.mjs <session> --out ./out --from "第一句原文" --to "最后一句原文" --png会话文件在 <DSH_HOME>/sessions/<workspace>/<session-id>/session.v4.jsonl.zstd。
显示档位
对齐客户端「工作步骤展示」(settings.transcript.*):
| --level | 导出内容 |
|---|---|
| compact 简洁 | 每轮只留最后一条回答 + 用户指令 |
| standard 标准(默认) | 所有助手回答 + 用户指令;过程收起 |
| detailed 详细 | + 工具调用(名称与参数摘要) |
| verbose 完全展开 | + 思考全文 + 工具结果 |
超长图:默认整张;要分段需你确认
默认产物永远是一张完整长图。 渲染不会自己切分。
内容确实过长(> 12000px)时,结果里会多一个 tooLong 块(高度 + 每条分隔线的位置 + 一句待确认的问题)。技能会在对话里问你要不要切,得到答复才执行:
node tools/crop-image.mjs 图.png --lines # 只看线位置(随时可跑)
node tools/crop-image.mjs 图.png --at 7,11 --confirmed # 用户同意后:在第 7、11 条线处切
node tools/crop-image.mjs 图.png --max 5000 --confirmed # 每段尽量 ≤ 5000px--confirmed 是硬闸门:不带它一律拒绝执行(退出码 3,不产出任何文件),报错里会把「高度 / 线数 / 计划几刀」列出来,正是要拿去问用户的内容。裁切沿线上切、线本身整行丢弃,接缝不留灰边。
切点落在内容块边界,不会从半句话或半张表格中间断开;单块超一页时独占一张。
配置
可选的用户配置在包外(升级不丢):
Windows %LOCALAPPDATA%\dsh-card-export\config.json
其它 $XDG_CONFIG_HOME/dsh-card-export/config.json{ "skills": { "report-card": true, "transcript-card": true } }按技能 id 启停;设为 false 后该技能不再出现在技能目录里(省上下文)。用 CLI 改:
node tools/config.mjs --list
node tools/config.mjs --disable transcript-card
node tools/config.mjs --init首装探测结果写在同目录 readiness.json(真实渲染一次 PNG、一次 PDF 得出的能力结论,含是否装了 dsh-fact-check)。
它是怎么工作的
Markdown 报告 ──┐
├─► 解析(标题锚定 / 块级)─► HTML(C 皮肤)─► 浏览器 CLI 截图 ─► PNG
DSH 会话日志 ───┘ │
└─► 失败 ─► PDF ─► HTML降级链
Edge(Win11 默认)→ Chrome → Brave / Chromium / Vivaldi
↓ 全都没有或渲染失败
PDF(无高度上限,按 A4 排版)
↓ 还不行
HTML(自行截图或打印)容器场景:Linux 路径同样在探测链内;首轮失败若命中沙箱特征(No usable sandbox / /dev/shm),自动追加 --no-sandbox --disable-dev-shm-usage 重试一次。这两个参数降低隔离强度,只在撞墙时启用,不作默认。
不猜数据
- 汇报解析按固定二级标题锚定,不要求报告改版;
- 会话里
user/message混着 6 类注入内容(runtime-context / skill-catalog / plugin:* / time-context / tool-jobs / compact-checkpoint),只有source.kind === 'user'才算真人输入; - 真人消息不带
turn字段,轮次按turn/start序号推导。
自己验证
npm run smoke # 十二组自检,484 项断言
npm run doctor # 渲染能力诊断(真实出图一次)十二组分别覆盖:渲染器探测与容器重试判据、首装探测与建议矩阵、报告解析与 brief 两种来源、对话解析与四档位、dsh-ui 卡片与三级兜底、fact-check 探测与「不推销」约束、fact-check 2.0.0 契约(锚点逐字、缺段判定、前置块与附录段落图)、插件契约与按需启停、分隔线识别与裁切、报告内容完整性(逐行核对)、Markdown 语法对照与 HTML 检测、数学公式与版式属性。
能力边界
| 边界 | 具体表现 |
|---|---|
| 只渲染,不改写 | 不做摘要、不做推断、不改判定。报告里的错别字、错口径会原样出现在图上。 |
| 短图质量取决于 brief | 渲染器不会总结;不给 brief 就只有「原文提取」,图上会标明。 |
| 缺段不补 | 报告缺 一句话结论/哪些是真的/来源 时仍出图,缺的段在长图末尾列出。 |
| Markdown 子集 | 支持:标题 #–#####、Setext ===、段落、有序/无序列表(含续行与嵌套)、表格(含 \| 转义与无首尾竖线写法)、引用、围栏代码、分隔线、行内粗体/斜体/删除线/代码/链接/自动链接/图片引用/[n] 角标。不支持:列表内嵌表格(会被拍平)、脚注、数学公式、HTML 直通(一律转义)。 |
| 图片默认不内嵌 | 图上出占位标记(名字/尺寸/体积)。--with-images 才内嵌本地附件,单张上限 3 MB。 |
| 字体不打包 | 吃系统字栈,跨机器字形有差异。 |
| DSH 专用 | 对话导出依赖 session.v4.jsonl.zstd 的字段;宿主升级若改字段会明确报错(选不到事件),不会静默出错图。 |
| 默认整张 | 输出永远是一张长图,渲染不自行切分。要分段必须你确认后由 crop-image.mjs --confirmed 执行(沿图上分隔线裁)。 |
图里不写操作提示
图上只放事实(例如 [图片] xxx.png · 1200×840 · 18 KB(本次未导出))。什么没进图、各多少条、用哪个参数能包含——这些在命令行 stderr 给出,由技能要求在对话里转述给用户,不占图面。
项目结构
lib/
index.js 插件:挂载 + 技能注册 + 后台首装探测
first-run.mjs 幂等首装探测(readiness.json)
user-config.mjs 包外用户配置(按技能 id 启停)
render/
rasterize.mjs 浏览器探测 → PNG / PDF / HTML
check.mjs 真实能力探测 + 建议矩阵
blank-height.mjs 只读量底部空白,用来修正截图高度(不裁图)
modes/
markdown.mjs 通用 Markdown 块解析与逐块渲染
skin-report.mjs 报告类共用皮肤(C:冷白 + 单一蓝)
report.mjs 报告入口:预设识别、brief、分隔线
verdict.mjs 事实核查报告:短图 / 长图
transcript.mjs 对话:会话解析、范围选取、消息流渲染
dsh-ui.mjs dsh-ui 迷你卡片渲染器(含三级兜底)
skills/
report-card/SKILL.md
transcript-card/SKILL.md
tools/ doctor / config / render-* / smoke-*
cases/ 两份样张 + brief 范例贡献
见 CONTRIBUTING.md。安全相关问题见 SECURITY.md,发版流程见 RELEASING.md。
许可证
Apache License 2.0。第三方组件说明见 NOTICE。
模板与 CSS 为本仓库原创;审美取向参考过 guizang 设计技能(AGPL-3.0-only),但未复制其任何文件、样式或文档文本。
