@huanlin/dsh-focus-chat 0.1.23

package/README.md

@@ -0,0 +1,73 @@
+# dsh-focus-chat
+
+[![npm version](https://img.shields.io/npm/v/@huanlin/dsh-focus-chat.svg)](https://www.npmjs.com/package/@huanlin/dsh-focus-chat)
+
+English | [中文](README.zh.md)
+
+A plugin for the dsh web GUI that adds a **focus chat** tab — a condensed, Claude Code–style way to read a conversation.
+
+## Screenshots
+
+| Off — the normal chat view | On — the focus chat view |
+| --- | --- |
+| ![Off: the normal chat view](screenshots/before.png) | ![On: the focus chat view](screenshots/after.png) |
+
+Instead of watching every step live, one assistant turn collapses into a single summary line:
+
+> Thought for 36s, loaded 3 context items, ran 2 shell commands, edited 8 files, read 17 files, listed 18 directories
+
+…and the whole turn can fold into one `Worked for Xm Ys` line. Click any line to expand the full detail — tool cards, thinking, context injections, produced files, copy/fork actions — all drawn the same way as the normal chat rows. Your mid-turn interjections split the fold into per-stretch lines, each carrying its own duration, and a stopped turn reads `Stopped after X` instead of "worked". A background-task settlement — a tool-jobs `notice` injection like `bash pnpm install [status: completed]` — classifies into the summary line's `N background jobs` segment instead of riding it as a verbatim `injected …` account; expanding the line still shows the full notice body. File operations (edits / reads) never carry a failure tally on the summary line — `edited N files` reads the outcome — only command execution and other tools annotate failures.
+
+Switch to it whenever you want the "what happened?" view, and flip back for the full transcript.
+
+## Install
+
+```sh
+# Install from npm (requires dsh >= 0.1.2-alpha.1)
+dsh plugin --profile web add @huanlin/dsh-focus-chat
+# Restart dsh web; the tab mounts automatically
+dsh web
+```
+
+Then open the Focus chat tab in any conversation.
+
+Notes:
+
+- `dsh plugin` behaves like adding a dependency to your web profile. A bundle plugin is loaded once its full package name appears in the profile's `dsh.profile.bundles` list (adds automatically on recent dsh builds; add it manually if your build does not); the bundle patch applies on the next boot.
+- With the repo source-launched CLI, run the args through the bin directly (`node --import tsx/esm apps/cli/src/bin.ts ...`).
+
+## Why a separate tab, and not a patch into the chat view?
+
+Short answer: the chat view's internals aren't open to third-party plugins — by design — and this plugin deliberately never touches dsh's own source. Concretely:
+
+- **Keyed slots are owned, not shared.** The chat's rows render through slots like `conversation.chat.node`, `tool.call.toolview`, and `conversation.chat.turnTail`. Those slots are declared by the chat entries themselves, and the slot system rejects a second declaration at load time — the conflict *is* the design speaking. A plugin cannot insert its own rows into the chat transcript, and cannot even *declare* the chat's own slots.
+- **Plugins can't reuse the chat's renderer code.** Importing values from another plugin package across the bundle boundary is forbidden (the bundle purity gate), so there's no way to borrow the chat's components — every row has to be drawn from the shared primitives and the public snapshot.
+- **The only legal insertion point is the `conversation.view` list slot** — the whole message surface. That's why the plugin ships its own complete view instead of changing how the chat view displays.
+
+If you want the chat view itself to behave differently, that's an in-repo change to the chat package — exactly what this plugin avoids.
+
+## What's missing
+
+Focus chat is a faithful reading surface, not a second chat view:
+
+- **No Inspect / details-panel deep links.** The chat's Inspect affordance needs internals plugins can't touch. The tool cards render the same content, just without the jump-to-details button.
+- **Third-party tool-card extensions don't render here.** Cards that other plugins add to the chat view won't appear in the focus view; the built-in card renderers are used instead.
+- **Folding is per consecutive tool-run.** Any visible content between two runs (a reply, a command, your interjection) keeps them separate.
+- **Inline file links need the optional file-mentions service** — the same off switch the chat view uses.
+
+## Development
+
+> This build targets the dsh v0.1.2-alpha.1 client surface. The new `@deepseek-ai/*` packages it needs are not on npm yet: after `yarn install`, junction/symlink each `@deepseek-ai/dsh-*` entry in `node_modules` to the matching `packages/<group>/<pkg>` directory of a built dsh checkout — that supplies both the types and the runtime for `yarn typecheck` / `yarn test`.
+
+- `yarn run build` — builds the browser bundle and the Node half.
+- `src/client/focus-model.ts` — the pure logic (folding, merging, row models); `src/client/FocusView.tsx` — the view.
+- `yarn test` — behavior tests; `yarn run typecheck` — type gate.
+- A `--dev` `dsh web` server hot-reloads rebuilt bundles — `yarn run build` alone is usually enough to see changes.
+
+## Model Experience
+
+None. The view is a pure client derivation over the already-logged conversation snapshot; nothing here reaches a model request.
+
+#### KV Cache effect
+
+None; this package neither assembles nor sends provider requests.

package/README.zh.md

@@ -0,0 +1,71 @@
+# dsh-focus-chat
+
+[![npm version](https://img.shields.io/npm/v/@huanlin/dsh-focus-chat.svg)](https://www.npmjs.com/package/@huanlin/dsh-focus-chat)
+
+[English](README.md) | 中文
+
+一个给 dsh Web GUI 的插件，加了一个 **聚焦对话** 标签页——用 Claude Code 的方式精简地读对话。
+
+## 截图
+
+| 关闭——普通聊天视图 | 开启——聚焦对话视图 |
+| --- | --- |
+| ![关闭：普通聊天视图](screenshots/before.png) | ![开启：聚焦对话视图](screenshots/after.png) |
+
+不再一步步盯着过程，一个助手回合会收成一条摘要行：
+
+> 思考了 36 秒，载入了 3 项上下文，运行了 2 个命令，编辑了 8 次，读取了 17 个文件，列出了 18 个目录
+
+整回合还能再收成一条 `工作了 X 分 Y 秒` 行。点任何一行都能展开成完整细节——工具卡片、思考、上下文注入、产物、复制/fork 操作——全部和普通聊天行同款画法。中途插话会把折叠按段切开，每段带自己的时长；被停止的回合显示 `用户 X 后停止` 而不是"工作了"。后台任务的结算通知（tool-jobs 的 `bash pnpm install [status: completed]` 这类 `notice` 注入）会归入摘要行的 `后台任务 N 个` 段，而不是原样写一条 `注入了 …`；展开该行仍能看到完整的通知正文。文件操作（编辑/读写）的失败不会写进摘要行——`edited N files` 读的是结果，只有命令和其他工具才带失败标注。
+
+想看"刚才到底发生了什么"就切过来，想看完整过程就切回聊天视图。
+
+## 安装
+
+```sh
+# 从 npm 安装（需要 dsh >= 0.1.0-rc.6）
+dsh plugin --profile web add @huanlin/dsh-focus-chat
+# 重启 dsh web，标签页自动挂载
+dsh web
+```
+
+然后打开任意对话里的 聚焦对话 标签页。
+
+说明：
+
+- `dsh plugin` 相当于给 web profile 加一个依赖。bundle 型插件需要在 profile 的 `dsh.profile.bundles` 里出现它的完整包名才会被加载（新版本 dsh 会自动加；如果你的版本没加，请手动补上）；bundle patch 在下次启动时生效。
+- 用仓库源码启动的 CLI 时，请直接调用 bin（`node --import tsx/esm apps/cli/src/bin.ts ...`）。
+
+## 为什么要单独一个标签页？为什么不直接改聊天视图？
+
+一句话：聊天视图的内部对第三方插件是封闭的——这是设计如此——而且这个插件刻意不碰 dsh 自己的源码。具体来说：
+
+- **键控槽位是独占的，不是共享的。**聊天的行通过 `conversation.chat.node`、`tool.call.toolview`、`conversation.chat.turnTail` 这类槽位渲染。这些槽位由聊天入口自己声明，槽位系统在加载期拒绝重复声明——冲突本身就是设计在说话。插件既不能往聊天对话流里插自己的行，甚至连声明聊天自己的槽位都不行。
+- **插件不能复用聊天的渲染代码。**跨 bundle 边界导入另一个插件包的值是被禁止的（bundle purity 门禁），所以没有任何办法借用聊天的组件——每一行都只能用共享原语和公开快照自己画。
+- **唯一合法的插入点是 `conversation.view` 列表槽**——整个消息界面。这就是为什么插件自带一整个视图，而不是去改聊天视图的显示方式。
+
+想让聊天视图本身换个行为，那是聊天包仓库内的改动——正是这个插件要避免的。
+
+## 缺什么
+
+聚焦对话是忠实的阅读界面，不是第二个聊天视图：
+
+- **没有 Inspect / 详情面板深链。**聊天的 Inspect 入口依赖插件够不到的内部机制；工具卡片内容一样，只是没有"跳去详情"的按钮。
+- **别的插件给聊天加的工具卡片扩展在这里不渲染。**聚焦视图用内置的卡片渲染。
+- **折叠按连续工具轮次。**两段之间有任何可见内容（回复、命令、你的插话）就保持分开。
+- **行内文件链接依赖可选的文件提及服务**——和聊天视图同一个开关。
+
+## 开发
+
+- `yarn run build` — 产出浏览器 bundle 和 Node 半边。
+- `src/client/focus-model.ts` — 纯逻辑（折叠、合并、行模型）；`src/client/FocusView.tsx` — 视图。
+- `yarn test` — 行为测试；`yarn run typecheck` — 类型门禁。
+- `--dev` 的 `dsh web` 会自动热加载重建的 bundle——改完 `yarn run build` 一般就能看到效果。
+
+## 模型体验
+
+无。该视图是对已记录对话快照的纯客户端派生，这里没有任何内容进入模型请求。
+
+#### KV Cache 影响
+
+无；该包既不组装也不发送提供方请求。

package/cordis.patch.yml

@@ -0,0 +1,7 @@
+# The dsh-focus-chat bundle patch: one browser plugin row added to the web
+# profile composition. Applied after the web-app bundle's own patch layer;
+# the row joins the dshClient roster, so the modules node half serves
+# lib/client.js into the boot graph and the browser shows the 聚焦 tab.
+- insert:
+    - id: ui-focus
+      name: '@huanlin/dsh-focus-chat'