跳到主内容

dsh-focus-chat 使用指南

给 DSH Web 界面新增「聚焦对话」标签页,将每轮助手的工具调用与思考折叠成可展开的单行摘要,便于快速回看对话进展。

本文为派生内容(基于 wiki / faq / compatibility_json 自动组装),非 AI 即时创作。

本文由本站基于该插件已收录的字段自动派生(wiki / faq / compatibility_json / readme),非 AI 即时创作。每节末尾标源字段。

快速上手

dsh-focus-chat

— 源: plugin_wiki.wiki_content

安装与验证

dsh plugin --profile web add @dingyi222666/dsh-focus-chat

复制以上命令在 DSH Web Profile 内运行。安装完成后在「插件列表」启用即可。

— 源: plugins.install

关键要点

  • dsh plugin 相当于给 web profile 加一个依赖。bundle 型插件需要在 profile 的 dsh.profile.bundles 里出现它的完整包名才会被加载(新版本 dsh 会自动加;如果你的版本没加,请手动补上);bundle patch 在下次启动时生效。
  • 用仓库源码启动的 CLI 时,请直接调用 bin(node --import tsx/esm apps/cli/src/bin.ts ...)。
  • **键控槽位是独占的,不是共享的。**聊天的行通过 conversation.chat.node、tool.call.toolview、conversation.chat.turnTail 这类槽位渲染。这些槽位由聊天入口自己声明,槽位系统在加载期拒绝重复声明——冲突本身就是设计在说话。插件既不能往聊天对话流里插自己的行,甚至连声明聊天自己的槽位都不行。
  • **插件不能复用聊天的渲染代码。**跨 bundle 边界导入另一个插件包的值是被禁止的(bundle purity 门禁),所以没有任何办法借用聊天的组件——每一行都只能用共享原语和公开快照自己画。
  • 唯一合法的插入点是 conversation.view 列表槽——整个消息界面。这就是为什么插件自带一整个视图,而不是去改聊天视图的显示方式。

— 源: plugin_wiki.readme_zh (fallback readme_raw)

常见问题

安装后需要做什么额外配置吗?

不需要。插件通过 cordis.patch.yml 在 Web 配置里挂载一个 bundle,重启 dsh web 后会自带「聚焦对话」标签页,无需任何手动配置项。

它会修改原本的聊天视图吗?

不会。插件刻意只在自己的标签页里渲染,不修改聊天视图本身,也不触碰 DSH 的源码 —— 因为聊天视图内部对第三方插件是封闭的。

它会向模型发送请求或改变 KV 缓存吗?

不会。该视图完全基于浏览器侧已有的对话快照做派生,不发起任何模型请求,也不会影响 KV 缓存行为。

支持 Node CLI 端的 DSH 吗?

不支持。插件 package.json 中 dsh.client.platform 显式声明为 web,只面向浏览器端的 Web GUI,Node CLI 不会加载它。

其他插件给聊天视图加的工具卡片会在聚焦视图出现吗?

不会出现。聚焦视图使用内置的工具卡片渲染器,不渲染第三方插件扩展的卡片,但工具内容本身会正常展开。

— 源: plugin_wiki.faq_json

兼容性

  • DSH: >= 0.1.0-rc.6
  • Node: 未声明

— 源: plugin_wiki.compatibility_json

踩坑提醒

安装前请审阅上游仓库;本指南基于已收录字段自动派生,可能滞后于最新版本。如发现与官方文档冲突,请以上游为准。

— 来源:通用规则