专注简报 shunshoudesi/dsh-focus-brief

dsh-focus-brief

把智能体每轮的回答压成一张结果卡：一句结论（点开换全文）+ 几个默认收起的信息块—— 需要你确认 / 关键数据 / 产出文件 / 结论建议 / 风险提醒。块的骨架写死在本地，内容由模型按同一份回答格式契约填，不额外调用模型。

安装（npm 一行命令）：

dsh plugin --profile web add dsh-focus-brief

桌面端把 --profile web 换成 --profile desktop；也可以在 DSH 的「设置 → 插件市场」里搜 dsh-focus-brief 一键安装（市场按仓库名去 npm 取同名包，两边现在都有）。
装完重启 DSH，会话标题栏就会多出一个「专注」标签。

不想走 npm 也能从源码直装：dsh plugin --profile web add github:shunshoudesi/dsh-focus-brief。

专注视图：整摞收起

为什么需要它

智能体的回答是一段又长又平的正文：结论埋在中间，要你拍板的事散在末尾，产出文件混在叙述里。
你于是要么全读，要么漏。这个插件的做法不是再问一次模型「帮我总结一下」——那是一条额外的调用、一份额外的等待、一份可能不准的摘要；它把「哪里是重点」写进模型本来就要产出的那条回答的格式契约里，本地再按同一份规格解析。契约是接口，本地是解析器。原本要写的字还是那些字，只是按固定的骨架摆好。

两个座位

| 座位 | 出现在哪 | 长什么样 |
| 会话视图「专注」 | 会话标题栏，官方「对话」「轨迹」旁边多一个「专注」标签 | 整页每轮一张结果卡：你的原话（官方那条蓝底黑字气泡，一字不改）+ 一张回答卡 |
| 重点小卡 | 普通对话视图里，每轮回答下方 | 折叠的一行：契约标题 + 要点 / 待你确认 计数；点开看要点与被问到的事 |

两边读同一份解析结果（同一份契约规格），互不干扰，随时切回「对话」。

三级展开

1. 整摞收起（默认）：五个块叠成一摞标题行；只有「需要你确认」永远排在第一位——它是唯一「看完必须动手」的块。
2. 展开整摞：「展开 N 个信息块」只把标题行铺开，每块内容仍然收起：没点开就不进 DOM。
3. 点开一块：只有那一块把内容放出来。项数超过预览条数的块（需要你确认 4 / 关键数据 4 / 产出文件 5 / 结论建议 5 / 风险提醒 3），底部多出一行两颗按钮——左边「还有 N 个 ›」⇄「只看前 M 个」（可来回），右边「收起这块」。

展开整摞：每块仍收起点开产出文件：还有 N 个 + 收起这块

普通对话视图里的重点小卡（第二张座位）：

重点小卡（展开态）

安装

从 npm 装（推荐，插件市场的「一键安装」走的也是这条）：

dsh plugin --profile web add dsh-focus-brief
dsh plugin --profile desktop add dsh-focus-brief # 桌面端

不想走 npm 也能从 GitHub 源码直装（绕过 registry，直接从仓库打包）：

dsh plugin --profile web add github:shunshoudesi/dsh-focus-brief
dsh plugin --profile desktop add github:shunshoudesi/dsh-focus-brief # 桌面端

两条都实测过：npm view dsh-focus-brief version 返回 0.3.0；pnpm add github:shunshoudesi/dsh-focus-brief 也能取到 0.3.0，且都只装包内白名单那 7 个文件。

装到本仓库的本地源码（开发时，不经过 git）：

plugin_manager { action: "install_bundle", target: "<本仓库根的绝对路径>" }

装完重启 DSH：宿主半（投影 + 契约 + 解析器）要重启进程才加载；之后只改客户端半时，刷新页面即可（focusView 仍是 v7，不用清缓存）。

不想装也能先看效果：preview.html 是一份独立预览（不用开 DSH），数据来自真实会话、配色是 DSH 主题 token 的真实取值、样式是插件实际注入的那份 CSS。

兼容与运行要求

| 项 | 值 |
| DSH | 0.2.0-rc.2（0.2.x）——只在 0.2.0-rc.2 上验过，其它预发行版未验证 |
| profile | web / desktop |
| Node | ≥ 20.18 |
| 运行时依赖 | 无（只用官方的会话投影、slots、locale 服务与 react） |
| 权限 | 只读取会话事件与系统提示。不读工作区文件、不发网络请求、无遥测 |
| 数据来源 | 产出文件、状态、工具调用次数来自真实会话事件，不靠模型复述 |

仓库结构

.
├── index.js # 宿主半：两条会话投影 + 回答格式契约 + 契约解析器 ├── client.js # 客户端半：专注视图的座位、卡片渲染、自己的极简 markdown 渲染 ├── cordis.patch.yml # bundle patch ├── package.json # 插件清单（dsh.bundle / dsh.client / dsh.compatibility） ├── preview.html # 不用开 DSH 也能看的独立预览（真实数据 + 真实主题 token） ├── docs/ │ ├── screenshots/ # README 与插件市场用的截图（演示轮次，不含真实会话内容） │ └── submission.md # 插件市场收录：提交模板与仓库侧待办 ├── scripts/ # 全部验证脚本（可复跑；node scripts/<name>.mjs） ├── .tmp/ # 一次性中间产物（截图页、抽取的主题包）——已 gitignore ├── LICENSE # Apache-2.0 ├── README.md # 本文件 ├── MANUAL.md # 实现与验证手册：卡片结构、契约与解析器、十道闸门与实测数字、边界 └── CHANGELOG.md # 版本记录

已知限制

- 契约靠模型自觉。模型不按契约写（或按得不精确）时，那一轮卡片退化成「标题 + 一句结论 + 回答全文」，信息不丢，只是没有块。本机 208 轮历史语料大多是契约下发之前写的，所以块很少（29/208 轮写过契约段， 82 轮一个块都没有）——看旧轮次时这是预期行为，不是坏了。
- 只在 0.2.0-rc.2 上验过。宿主换大版本时，投影与座位 API 需要重新对齐。
- 卡片上不带执行日志。工具调用时间线仍在官方的「轨迹」视图里，这里只留「N 次工具调用」这类计数。
- 块内超过预览条数的项默认不渲染，点「还有 N 个 ›」才铺开（这是故意的：把默认体积压住）。
- 附件图不渲染。客户端座位拿不到附件渲染接口，只有图片没有文字的轮次会留一个占位标记。

详细文档

- MANUAL.md —— 卡片结构、契约与解析器的全部规则、十道回归闸门与它们的实测数字、体积与对比度实测、已知边界、重启刷新后的验收清单。
- CHANGELOG.md —— 版本记录。
- docs/submission.md —— 插件市场收录用的提交材料。

收录

仓库已加 dsh-plugin topic：DSH 内置的「设置 → 插件市场」按这个 topic 搜仓库（搜索实测已命中本仓库），官网 dsh-plugin.org 数据同源。
仓库名与 npm 包名一致（dsh-focus-brief），市场的一键安装拼的就是 dsh plugin --profile web add dsh-focus-brief，并会去 npm 读 dsh.bundle.patch 判断是不是标准 bundle 插件——两者都已就位。
收录要求、提交模板与验收命令见 docs/submission.md。

Listed on dsh-plugin.org

Listed on dsh-plugin.org

许可证

Apache-2.0