Skip to main content
P

dsh-session-norms

phoenixlucky/dsh-session-norms

Normalized transcript view: renders every turn, message and tool call of the current Session in one consistent, copyable format.

Install

dsh plugin --profile web add github:phoenixlucky/dsh-session-norms

README

WJ 会话规范 · Session norms

为 DeepSeek Harness 增加一个会话视图标签页,把当前会话的记录整理成统一格式: 按「轮次」分组,逐条显示用户消息、助手回复与工具调用(名称、参数、结果状态、时间), 并提供「复制 Markdown」,方便导出或贴到文档里。

同时按同一套规范统一「对话」页里 Markdown 的排版观感(标题层级、段落与列表节奏、 代码块、引用、表格),并让表格收进阅读列:表头浅底、隔行浅底、单元格可换行, 列特别多时才在表格内部横向滚动,不会再把整段对话撑出页面横向滚动条。每条已定稿的 助手回复在操作行里多一个「复制为 Markdown」按钮,复制的是模型写下的原始 Markdown 源码(表格、列表、代码块、引用都保持原样)。

Adds a conversation view tab that lays the current session out in one consistent format: turns as sections, then every user message, assistant reply and tool call with its arguments, result status and time. A Copy Markdown button exports the same transcript as Markdown. The same standard also normalizes the Markdown typography of the Chat view (headings, paragraphs, lists, code, quotes, tables): tables fit the reading column, dollar pairs that only looked like formulas go back to plain text, and each settled assistant reply gains a Copy as Markdown action that copies the model's original Markdown source.

  • 包名 / package: @tinyforge/dsh-session-norms
  • 版本 / version: 1.4.5
  • 许可证 / license: MIT

安装 / Install

从 npm 安装。插件页「添加插件」里输入包名即可,也可以直接跑命令:

dsh plugin --profile desktop add @tinyforge/dsh-session-norms

旧的无作用域包 dsh-session-norms 已弃用,请改装带作用域的 @tinyforge/dsh-session-norms。 The old unscoped package dsh-session-norms is deprecated; install @tinyforge/dsh-session-norms instead.

装好后重启 DSH,会话上方的视图标签栏里会多出「会话规范」。

固定版本的 Git 安装和本地目录安装仍然可用,但它们不参与在线更新(见下一节):

# 尝鲜尚未发布的提交
dsh plugin --profile desktop add git+https://github.com/phoenixlucky/dsh-session-norms.git#v1.4.5

# 本地开发目录(Windows 使用绝对路径)
dsh plugin --profile desktop add E:\path\to\dsh-session-norms

更新 / Update

只有从 npm 注册表安装的组合包可以在线更新:打开「插件」页 → 本插件详情,下面的版本区块列出比当前版本新的版本,点更新到 x.y.z 即可;工具栏的刷新会重新检查一遍。

从 Git(git+…、github:)或本地 link: / 路径安装的包不显示版本区块——DSH 的更新只为注册表安装准备:它先用 pnpm view 问注册表有哪些新版本,再用 pnpm add 名字@版本 安装,没有 Git 的更新通道。这类安装按固定版本重装:

dsh plugin --profile desktop remove @tinyforge/dsh-session-norms
dsh plugin --profile desktop add git+https://github.com/phoenixlucky/dsh-session-norms.git#v1.4.5

使用 / Usage

  1. 打开任意会话,点会话上方的 会话规范 标签页。
  2. 顶部显示轮次、消息、工具调用、错误数量;正文按「第 N 轮」分组。
  3. 超长消息与工具调用默认折叠,点「展开全文」查看;点「复制 Markdown」导出整份记录。 工具行的参数按 JSON 重新缩进显示,结果展示完整内容并按需展开,两者都直接取自 已加载的会话数据,不受宿主侧 200 字符预览的限制。
  4. 「对话」页本身不需要切换:插件挂载后,Markdown 正文的标题、段落、列表、代码块、 引用与表格即按统一规则呈现(深浅色都跟随主题变量)。表格铺满阅读列并与正文对齐, 表头与隔行使用浅一层的底色;两列表格始终铺满阅读列(与输入框同宽)。 三列及以上的表格先按表格排,脚本按实际宽度判断:放不下或阅读列窄于 600px 时 切成「每条记录一张卡片」,表头文案变成字段标签,不再出现横向滚动条。
  5. 每条已定稿的助手回复末尾,操作行里有一个 复制为 Markdown 图标按钮, 点击即可把该条回复的原始 Markdown(含表格、列表、代码块)复制到剪贴板。

结构 / Layout

部分说明
index.js宿主侧:把会话事件折叠成规范化记录,并通过会话投影(sessionNorms)发给界面。
client.js浏览器侧:注册 conversation.view 的 norms 视图、已定稿助手操作行里的「复制为 Markdown」、多语言文案和排版样式。
locale/*.json插件列表里显示的标题与说明。
icon.webp插件列表与详情页的图标(512×512,25 KiB,DSH 的图标预算上限是 256 KiB)。
scripts/release.mjs维护者发版脚本:检查、测试、改版本、提交、打标签、发布、推送。

行为 / Behavior

  • 只读:不写入会话事件、不改变会话数据。
  • 数据来源:宿主侧把 sessionProjections 声明为必注入,等投影注册表就绪后才注册 sessionNorms;否则条目可能在注册表出现之前就激活,静默跳过注册,界面会一直停在 「正在汇总当前会话…」。注册失败只让本视图为空,不影响 DSH 启动。
  • 增量:汇总跟随已提交的会话事件(turn/start、user/message、assistant/message、 tool/call、tool/result、turn/end),随回合推进自动刷新。
  • 有界:最多保留最近 200 行,单条消息文本最多 3000 字符,超出时在视图底部提示。
  • 工具行的完整内容:宿主侧只发布参数与结果的短预览(200 / 240 字符),让投影体积不随 工具输出膨胀;因此工具行渲染时按 callId 从 useChat 的已加载快照里取回完整参数与 结果。折叠状态只渲染取回文本的前 320 字符或前 8 行(两者先到为准),展开才把剩余内容 放进 DOM —— 既不会因为 CSS 截断而看不到尾巴,也不至于让一条 200KB 的工具结果在挂载时 就被排版。快照里没有该调用时(例如调用已滑出加载窗口)自动回退到宿主预览。
  • 排版层:只注入样式,不接管渲染器——不注册 conversation.chat.node 的 keyed cell, 因此 Markdown 渲染、工具行、助手操作按钮和主题切换都保持内置行为。样式挂载在 conversation.session.header.utilities(嵌入布局时回退到 conversation.composer.dock), 规则作用域为 Markdown 根节点的 CSS Modules 类([class*="_markdown_"]), 深浅色全部取自 --dsw-alias-* 主题变量。
  • 表格:铺满阅读列,单元格可收缩换行,表头与隔行使用主题的浅层底色;列的最小宽度 合计超过阅读列时,滚动限制在表格自身的滚动容器内,页面不再出现横向滚动条。
  • 窄栏自适应:表格容器铺满阅读列并居中,与正文和输入框同宽,不再缩成一条或伸到 左侧留白;产品内置的「宽表撑到两侧留白」也会被收回阅读列。两列表格始终铺满宽度; 三列及以上的表格由脚本按实际布局宽度判断,放不下或阅读列窄于 600px 时把表头写到 单元格的 data-sn-label 上并切成「标签 + 值」卡片,不再出现横向滚动条。脚本只加 属性,不改动或重排产品节点;已经处于正确形态的表格不会被再次改写——切换形态会让 表格高度瞬变,浏览器据此收紧滚动范围,把刚滚到底的阅读位置弹回中间。判断所需宽度 时把表格副本放到屏外测量,因此滚动位置不受影响。
  • 价格不是公式:成对的 $ 会被渲染器当成行内公式,一句话里出现两个金额就会变成两段 公式——字号放大、换成衬线体、美元符号消失。脚本把「源码里含中日韩文字」的公式判定为 误判的正文,给它写上 data-sn-tex,样式再按 $源码$ 以正文的字体和字号还原;真正的 公式($E=mc^2$)和块级公式照旧由 KaTeX 排版,无障碍朗读用的 MathML 保留。同样只加 属性,不改写渲染出的节点,流式新增的内容也会被补上。
  • 复制为 Markdown:在 conversation.chat.assistant-actions 里追加一个图标按钮,从 useChat 读取该条已定稿回复的文本块并原样写入剪贴板;流式输出和中断内容没有 messageId,因此不显示按钮。按钮失败时不提示成功,1.8 秒后恢复原图标。
  • 跟随主题:颜色全部取自 --dsw-alias-* 主题变量,自动适配浅色/深色; 文案跟随界面语言(中文 / English)。

兼容性 / Compatibility

已在 DeepSeek Harness 0.2.2-alpha.2 上验证,engines.dsh 声明为 >=0.2.2-alpha.2 <0.3.0-0。其他版本未验证。

卸载 / Uninstall

在「插件」页面停用并卸载 @tinyforge/dsh-session-norms 即可,视图标签页会同时消失。

开发 / Development

test/host-test.mjs 检查宿主侧:inject 声明、投影注册契约、折叠出的行与预算; test/render-test.mjs 用 React SSR 对浏览器侧做静态渲染检查:

npm test                                        # 两侧都跑
node test/host-test.mjs <events.jsonl>           # 追加真实会话事件流检查
node test/render-test.mjs <projection.json>      # 追加真实会话投影数据检查

<projection.json> 是 .dsh/storages/session_projcache/sessions/ 下某个会话的缓存; <events.jsonl> 是解压后的会话日志(每行一个事件)。DSH_PROFILE_DIR 可指定提供 react 的 profile 目录。

发版 / Release

scripts/release.mjs 把发版串成一条命令:确认工作区干净且在 main、跑上面的渲染检查、改版本号(package.json 与本文开头的「版本 / version」一行)、提交、打 v<版本> 标签、发布到 npm,最后推送提交和标签。

npm run release patch                  # 1.2.2 → 1.2.3
npm run release minor                  # → 1.3.0
npm run release 1.4.0                  # 指定版本
npm run release patch -- --dry-run     # 只打印将要执行的步骤,不写文件、不发包

其他开关:--no-publish(只提交和打标签)、--no-push、--skip-tests、--otp <code>(npm 要求一次性密码时)、--offline(跳过注册表与登录检查,离线试跑时用)。

脚本会在动任何文件之前检查:版本确实比当前新、v<版本> 标签不存在、该版本还没被发布、npm login 有效。发布失败时本地的提交和标签会保留,按它打印的命令补一次 npm publish 与 git push --follow-tags 即可。手工发版是同一套动作:npm version <patch|minor|major> → git push --follow-tags → npm publish。

发布出去的包只含 package.json 的 files 白名单里的文件(index.js、client.js、cordis.patch.yml、locale、icon.webp、README.md、LICENSE),scripts/ 和 test/ 不进包。

Related plugins