dsh-inline-plugin:把 Agent 整理结果递进 Inline 阅读

前言

在 DeepSeek Harness(DSH)里和 Agent 聊技术文档、长对话,常见需求是「整理成一篇能慢慢读的文章」,并在阅读时随手对某句提问。Inline 是单文件阅读工具,正文与问答都在浏览器 localStorage 里,对外入口主要是存档 JSON。若只靠复制粘贴 Markdown,还要自己走导入流程;若希望 Agent 写好结构后直接进 Inline,就需要在 DSH 侧把材料转成 Inline 能识别的存档并递过去。下面介绍社区插件 dsh-inline-plugin(维护者 itzsu123,分类:模型推理)如何承担「准备材料」这一环,与 Agent 整理、Inline 阅读分工配合。

这是什么

dsh-inline-plugin 是给 DeepSeek Harness 增加的插件:在发给 Agent 的消息里带上 /inline 标记时,由 Agent 把内容整理成可读文章,插件再转成 Inline 能读的存档、复制到剪贴板并请求打开 Inline,你只需在页面里按一次 Ctrl+V 即可导入。npm 包名与 DSH 安装名均为 dsh-inline-plugin;源码与说明见 GitHub 仓库,社区目录页为 skillhub.cn/plugins/itzsu123/dsh-inline-plugin。许可为 MIT(README 与 package.json 一致)。

插件不修改 Inline 本身,只负责生成存档并写入剪贴板;真正写入 Inline 的是你粘贴那一次操作。

核心功能

触发方式:/inline 标记

在消息中带上 /inline,由模型判断是否调用插件注册的工具 inline_doc(日志示例:[inline-plugin] loaded! 工具 inline_doc 已注册(v0.3.2))。触发后大致三步:

  1. Agent 将内容整理成一篇可读文章(无需你再指定版式)。
  2. 浏览器弹出 Inline,文章对应的存档已在剪贴板。
  3. 在 Inline 页面按 Ctrl+V,文章导入;读时可选中任意句子,点「问」,答案出现在提问处。

示例说法(来自 README):

帮我把这篇技术文档整理成文章 /inline
把上面聊的内容整理一下 /inline
讲讲复利为什么反直觉 /inline

写法细则

  1. 标记前留一个空格,使其成为独立标记,并避免与 URL 路径中的 /inline 混淆。
  2. 不要放在消息最开头——桌面端会把行首 /xxx 当作命令处理。

正确与错误示例:

✔  把这篇整理成文章 /inline
✘  把这篇整理成文章/inline
✘  /inline
✘  把这篇整理成文章 inline

未带 /inline 的普通写作、问答、写代码不会触发。触发依赖模型判断,偶发遗漏时可在句中再说一次 /inline。

存档与剪贴板

Inline 识别带 v 和 html 字段的 JSON 存档,粘贴即导入,无需再走「选文件导入」。链路为:

Agent 写文章 → 插件转存档 + 复制 + 打开 Inline → 你按 Ctrl+V

粘贴必须由用户完成:浏览器安全模型不允许网页在无用户手势时读剪贴板。

DeepSeek API Key 传递

若 DSH 已配置 DeepSeek key,插件从 $DSH_HOME/.credentials.yaml 读取 DEEPSEEK_API_KEY,写入剪贴板存档的 api.key,Inline 导入后存入 localStorage。凭证只出现在剪贴板路径;落盘的 .inline.json 不含 key。

支持的 Markdown 子集

插件整理的文章会映射为 Inline 可用的 HTML 结构,支持的写法包括:

# 标题          →  h2
## 小标题       →  h3
- 列表 / 1. 列表
> 引用
代码块(三个反引号)
**粗体**  `行内代码`  [链接](url)

生成的是干净正文,不带预置问答;问题由你在阅读时自行提出。

安装与启用

插件以当前 DSH 进程权限运行,安装前建议查看 源码 与 MIT 许可证。

方式一:插件面板(推荐)

在 DSH 中打开「添加插件」,输入包名:

dsh-inline-plugin

来源可选「中国大陆镜像源」以加快下载。

方式二:命令行

dsh plugin --profile <你的 profile> add dsh-inline-plugin

方式三:从 GitHub 仓库安装(跟踪最新提交时)

dsh plugin --profile <你的 profile> add github:itzsu123/dsh-inline-plugin

装完后需重启 DSH,并新开一个对话。工具集在会话创建时固定,旧对话不会出现新装工具,属设计行为而非故障。

前提与注意

  • Inline 需为 2026-10-19 之后的新版。旧版不把剪贴板存档当导入,粘贴为普通文本,不会损坏数据,但不会自动导入。
  • DSH 中配置 DeepSeek key 时插件会一并带入 Inline;未配置则剪贴板存档不含 key,可在 Inline 内再填。
  • 插件「已打开 Inline」仅表示已请求打开,是否弹出由浏览器决定。
  • 「已打开 Inline」、剪贴板与 key 等说明均来自项目 README;package.json 当前版本为 0.3.6。

适用场景

适合已在 DSH 中用 Agent 消化长文、对话或链接,并希望用 Inline 边读边问的场景。不适合期望插件直接改写 Inline 内已有数据,或不需要 /inline 触发的普通问答。

DeepSeek Harness 生态强调「一切皆插件」;skillhub.cn 为社区目录,与 DeepSeek / 幻方无官方从属关系。

更多演示可参考 Inline 的 38 秒演示。安装与用法以 GitHub README 为准。

羽毛球分组比赛记分
小程序二维码

欢迎使用《羽毛球分组比赛记分》微信小程序

Xiaoye