@chestnut23/dsh-conversation-outline 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 lzbaclz
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,113 @@
+# dsh-conversation-outline
+
+![banner](assets/banner.png)
+
+[![npm](https://img.shields.io/badge/npm-%40chestnut23%2Fdsh--conversation--outline-cb3837)](https://www.npmjs.com/package/@chestnut23/dsh-conversation-outline)
+[![license](https://img.shields.io/badge/license-MIT-2fbf8f)](LICENSE)
+[![node](https://img.shields.io/badge/node-%5E22.19%20%7C%7C%20%3E%3D24-5FA04E?logo=nodedotjs)](https://nodejs.org/)
+[![stars](https://img.shields.io/github/stars/lzbaclz/dsh-conversation-outline.svg)](https://github.com/lzbaclz/dsh-conversation-outline)
+[![dsh plugin](https://img.shields.io/badge/dsh-plugin-4d6bfe)](https://github.com/deepseek-ai/DeepSeek-Harness)
+
+[简体中文](README.zh.md) · [Usage](docs/usage.md) · [Troubleshooting](docs/troubleshooting.md) · [Security](docs/security.md) · [Publishing Guide](docs/publishing-guide.md) · [Design Spec](docs/implementation-spec.md)
+
+**Find any question. Jump to any answer.**
+
+Long agent conversations scroll forever. `dsh-conversation-outline` is a
+Codex-style **conversation outline** for [DeepSeek Harness](https://github.com/deepseek-ai/DeepSeek-Harness) Web:
+a slim, always-visible **right-edge rail** — one bar per question, like a minimap of the
+conversation — that **expands on hover** into a preview panel of every question's opening
+words. Click a bar or a row and you are teleported to that message in the Chat view, with
+a flash highlight so you cannot miss it. Bilingual zh-CN / en.
+
+## Highlights
+
+- **Right-edge rail (minimap)** — thin, pinned to the right edge, one bar per question in
+  chronological order. Out of the way while you read; >60 questions fold into a `+N` marker.
+- **Hover to preview** — hover the rail and the panel slides out with each question's
+  opening words (single-line truncated), `#turn` badge and `HH:MM` time. Collapses 240 ms
+  after you move away; tap-to-pin on touch, `Esc` closes. Pure overlay — your content
+  never shifts.
+- **Click-to-jump** — switches to the Chat view (even from Trajectory), scrolls to the
+  message and flashes it for 1.8 s. Respects `prefers-reduced-motion`.
+- **Search & load older** — case-insensitive filtering, plus paging into older history.
+- **Live** — new questions appear while the session runs; follows the current session and
+  collapses on switch.
+- **Zero dependencies at runtime** — the browser bundle imports only React (the platform
+  modules); everything else is inlined and purity-checked at build time.
+
+## Install
+
+**Prerequisites**: [DeepSeek Harness](https://github.com/deepseek-ai/DeepSeek-Harness)
+(`dsh` available); Node.js `^22.19` or `>=24`; pnpm 10+.
+If you run DSH via `npx`, prefix the commands with `npx -p @deepseek-ai/dsh `.
+
+```sh
+# 1) GitHub (works right now — recommended)
+dsh plugin --profile web add github:lzbaclz/dsh-conversation-outline
+
+# 2) npm (published under our own scope; the unscoped name belongs to an
+#    unrelated project — always install the @chestnut23 scope)
+dsh plugin --profile web add @chestnut23/dsh-conversation-outline
+
+# 3) from source (local development)
+git clone https://github.com/lzbaclz/dsh-conversation-outline.git
+cd dsh-conversation-outline
+pnpm install && pnpm dev:types && pnpm build
+dsh plugin --profile web add "link:$(pwd)"
+```
+
+> **Zero build scripts on the GitHub path**: the built `lib/` is committed to this repo
+> (`.gitignore` deliberately does not ignore it), so a `github:` install fetches
+> ready-to-load artifacts — no `prepare` script, no profile `allowBuilds` configuration.
+> **Name warning**: an unrelated project owns the *unscoped* npm name
+> `dsh-conversation-outline`. This plugin is only published as
+> `@chestnut23/dsh-conversation-outline` — always install the scoped name (or the
+> GitHub path above).
+
+**After installing**: restart the DSH Web service and refresh the page (`link:` installs
+just need a page refresh after `pnpm build`). Confirm with:
+
+```sh
+dsh plugin --profile web list
+```
+
+Upgrade with the same `add` command (optionally pin a version:
+`@chestnut23/dsh-conversation-outline@0.1.0`).
+
+## Usage
+
+Install, restart, open any session that already has messages — a thin strip appears on
+the right edge. Hover it to preview questions, click a bar or a row to jump, search to
+filter, `Load older` to page through history. Full walkthrough:
+[docs/usage.md](docs/usage.md). Something's not showing up? [Troubleshooting](docs/troubleshooting.md).
+
+## Preview
+
+> Real-screenshot placeholder: after installing, drop a screenshot of the rail + panel
+> at `assets/ui.png` and it will appear here.
+
+![Conversation outline](assets/ui.png)
+
+## Development
+
+```sh
+pnpm dev:types   # symlink @deepseek-ai type packages (one-time)
+pnpm typecheck   # host + client dual tsc programs
+pnpm build       # tsc(host) → tsc(client) → tsdown bundles lib/client.js
+pnpm verify      # offline smoke: manifest/exports/patch/bundle shape + pure-logic asserts
+```
+
+Client-only changes hot-reload: `pnpm exec tsdown --watch` rewrites `lib/client.js`, and
+the DSH client HMR chain (or a plain page refresh) picks it up. Host/manifest changes
+need a service restart. Scratch-profile testing recipe:
+[docs/implementation-spec.md §4.2](docs/implementation-spec.md).
+
+## Talk to us
+
+Issues are welcome any time: [open one](https://github.com/lzbaclz/dsh-conversation-outline/issues).
+Questions, feature ideas, screenshots of what you built with it — all good.
+
+## License
+
+MIT — see [LICENSE](LICENSE). Client-only plugin: no telemetry, no extra network calls
+([security notes](docs/security.md)).

package/README.zh.md

@@ -0,0 +1,105 @@
+# dsh-conversation-outline
+
+![banner](assets/banner.png)
+
+[![npm](https://img.shields.io/badge/npm-%40chestnut23%2Fdsh--conversation--outline-cb3837)](https://www.npmjs.com/package/@chestnut23/dsh-conversation-outline)
+[![license](https://img.shields.io/badge/license-MIT-2fbf8f)](LICENSE)
+[![node](https://img.shields.io/badge/node-%5E22.19%20%7C%7C%20%3E%3D24-5FA04E?logo=nodedotjs)](https://nodejs.org/)
+[![stars](https://img.shields.io/github/stars/lzbaclz/dsh-conversation-outline.svg)](https://github.com/lzbaclz/dsh-conversation-outline)
+[![dsh plugin](https://img.shields.io/badge/dsh-plugin-4d6bfe)](https://github.com/deepseek-ai/DeepSeek-Harness)
+
+[English](README.md) · [使用文档](docs/usage.md) · [常见问题](docs/troubleshooting.md) · [安全说明](docs/security.md) · [发布指南](docs/publishing-guide.md) · [设计规格](docs/implementation-spec.md)
+
+**找到任何一次提问，一键跳回任何一处回答。**
+
+智能体的长对话滚起来没完。`dsh-conversation-outline` 是
+[DeepSeek Harness](https://github.com/deepseek-ai/DeepSeek-Harness) Web 的 **Codex 风格「会话大纲」插件**：
+界面右侧一条**常驻细竖条**——每个问题一根小横条，像一张会话的 minimap——**鼠标悬停**即展开
+预览面板，列出每个问题开头的几个字。点一下横条或某一行，直接瞬移到 Chat 视图里的那条消息，
+并高亮闪烁让你不会看漏。界面中英双语（zh-CN / en）。
+
+## 亮点
+
+- **右侧细条（minimap）**——紧贴右边缘的窄竖条，按时间顺序每个问题一根小横条。
+  平时不占地方、不影响阅读；超过 60 个问题折叠为顶部 `+N` 标记。
+- **悬停预览**——鼠标移到细条上，面板滑出：每个问题开头几个字（单行截断）、`#轮次`
+  徽标与 `HH:MM` 时间。移开 240ms 后自动收起；触屏点击可固定面板，`Esc` 关闭。
+  纯覆盖层，**正文布局纹丝不动**。
+- **点击跳转**——即使停在「轨迹」视图也会自动切回聊天视图，滚动定位并闪烁 1.8s，
+  尊重 `prefers-reduced-motion`。
+- **搜索 & 加载更早**——大小写不敏感过滤 + 翻历史分页。
+- **实时**——会话进行中新问题自动出现；跟随当前会话，切换即收起。
+- **运行时零依赖**——浏览器包只引用 React 等平台公共模块，其余全部内联并在构建期
+  过「纯度门」检查。
+
+## 安装
+
+**前置要求**：已安装 [DeepSeek Harness](https://github.com/deepseek-ai/DeepSeek-Harness)
+（`dsh` 命令可用）；Node.js `^22.19` 或 `>=24`；pnpm 10+。
+通过 `npx` 运行 DSH 的话，给下面命令加上 `npx -p @deepseek-ai/dsh ` 前缀。
+
+```sh
+# 1) GitHub（现在就能装，推荐）
+dsh plugin --profile web add github:lzbaclz/dsh-conversation-outline
+
+# 2) npm（发布在你自己的 scope 下；无 scope 的同名包属于另一个无关项目，
+#    务必安装 @chestnut23 scope）
+dsh plugin --profile web add @chestnut23/dsh-conversation-outline
+
+# 3) 从源码（本地开发）
+git clone https://github.com/lzbaclz/dsh-conversation-outline.git
+cd dsh-conversation-outline
+pnpm install && pnpm dev:types && pnpm build
+dsh plugin --profile web add "link:$(pwd)"
+```
+
+> **GitHub 路径零构建脚本**：本仓库把构建产物 `lib/` 一并提交（`.gitignore` 故意不忽略），
+> `github:` 安装拿到的就是可直接加载的产物——不需要 `prepare` 脚本，也不需要 profile
+> 里的 `allowBuilds` 配置。
+> **名称提醒**：npm 上**无 scope 的** `dsh-conversation-outline` 属于另一个无关项目；
+> 本插件只以 `@chestnut23/dsh-conversation-outline` 发布，请务必安装带 scope 的名字
+> （或走上面的 GitHub 路径）。
+
+**安装之后**：重启 DSH Web 服务并刷新页面（`link:` 安装只需在 `pnpm build` 后刷新）。
+确认插件在 profile 里：
+
+```sh
+dsh plugin --profile web list
+```
+
+升级用同一条 `add` 命令（可钉版本：`@chestnut23/dsh-conversation-outline@0.1.0`）。
+
+## 使用
+
+装好重启后，打开任何一个已有消息的会话，右侧边缘会出现细竖条：悬停预览问题、点击跳转、
+搜索过滤、`加载更早` 翻历史。完整走查：[docs/usage.md](docs/usage.md)。
+没看到？先看 [常见问题](docs/troubleshooting.md)。
+
+## 界面预览
+
+> 真实截图占位：装好后把细条 + 面板的截图放到 `assets/ui.png`，就会显示在这里。
+
+![会话大纲](assets/ui.png)
+
+## 开发
+
+```sh
+pnpm dev:types   # 符号链接 @deepseek-ai 类型（一次性）
+pnpm typecheck   # host + client 双 tsc program
+pnpm build       # tsc(host) → tsc(client) → tsdown 打包 lib/client.js
+pnpm verify      # 离线冒烟：manifest/exports/patch/产物形状 + 纯逻辑断言
+```
+
+纯客户端改动可热更新：`pnpm exec tsdown --watch` 持续重写 `lib/client.js`，DSH 的客户端
+HMR 链（或简单刷新页面）即可生效。host / manifest 改动需要重启服务。scratch profile
+测试配方：[docs/implementation-spec.md §4.2](docs/implementation-spec.md)。
+
+## 一起聊聊
+
+随时欢迎提 issue：[点这里](https://github.com/lzbaclz/dsh-conversation-outline/issues)。
+问题、点子、你用这个插件做了什么、截图——都欢迎。
+
+## License
+
+MIT——见 [LICENSE](LICENSE)。纯客户端插件：无遥测、无额外网络请求
+（[安全说明](docs/security.md)）。

package/assets/banner.svg

@@ -0,0 +1,106 @@
+<svg xmlns="http://www.w3.org/2000/svg" width="1280" height="360" viewBox="0 0 1280 360" role="img" aria-label="dsh-conversation-outline banner">
+  <defs>
+    <linearGradient id="bg" x1="0" y1="0" x2="1" y2="1">
+      <stop offset="0" stop-color="#0b1020"/>
+      <stop offset="0.55" stop-color="#0e1630"/>
+      <stop offset="1" stop-color="#12204a"/>
+    </linearGradient>
+    <linearGradient id="title" x1="0" y1="0" x2="1" y2="0">
+      <stop offset="0" stop-color="#8fa8ff"/>
+      <stop offset="1" stop-color="#4d6bfe"/>
+    </linearGradient>
+    <radialGradient id="glow" cx="0.75" cy="0.35" r="0.6">
+      <stop offset="0" stop-color="#4d6bfe" stop-opacity="0.22"/>
+      <stop offset="1" stop-color="#4d6bfe" stop-opacity="0"/>
+    </radialGradient>
+  </defs>
+
+  <rect width="1280" height="360" fill="url(#bg)"/>
+  <rect width="1280" height="360" fill="url(#glow)"/>
+
+  <!-- subtle dot grid -->
+  <g fill="#ffffff" opacity="0.04">
+    <circle cx="60" cy="60" r="1.6"/><circle cx="160" cy="60" r="1.6"/><circle cx="260" cy="60" r="1.6"/>
+    <circle cx="360" cy="60" r="1.6"/><circle cx="460" cy="60" r="1.6"/><circle cx="560" cy="60" r="1.6"/>
+    <circle cx="60" cy="150" r="1.6"/><circle cx="160" cy="150" r="1.6"/><circle cx="260" cy="150" r="1.6"/>
+    <circle cx="360" cy="150" r="1.6"/><circle cx="460" cy="150" r="1.6"/><circle cx="560" cy="150" r="1.6"/>
+    <circle cx="60" cy="240" r="1.6"/><circle cx="160" cy="240" r="1.6"/><circle cx="260" cy="240" r="1.6"/>
+    <circle cx="360" cy="240" r="1.6"/><circle cx="460" cy="240" r="1.6"/><circle cx="560" cy="240" r="1.6"/>
+    <circle cx="60" cy="330" r="1.6"/><circle cx="160" cy="330" r="1.6"/><circle cx="260" cy="330" r="1.6"/>
+    <circle cx="360" cy="330" r="1.6"/><circle cx="460" cy="330" r="1.6"/><circle cx="560" cy="330" r="1.6"/>
+  </g>
+
+  <!-- left: chips (generous pill widths so no font metric can overflow) -->
+  <g font-family="'Helvetica Neue', Helvetica, Arial, sans-serif">
+    <rect x="56" y="60" rx="12" height="24" width="152" fill="#4d6bfe" opacity="0.16"/>
+    <circle cx="74" cy="72" r="3.4" fill="#6f8dff"/>
+    <text x="86" y="77" font-size="12.5" fill="#9db4ff" font-weight="600">DSH · Web Plugin</text>
+
+    <rect x="224" y="60" rx="12" height="24" width="112" fill="#ffffff" opacity="0.08"/>
+    <text x="240" y="77" font-size="12.5" fill="#b8c4e8">zh-CN / EN</text>
+
+    <rect x="352" y="60" rx="12" height="24" width="64" fill="#2fbf8f" opacity="0.16"/>
+    <text x="368" y="77" font-size="12.5" fill="#5fd6ab" font-weight="600">MIT</text>
+
+    <!-- title -->
+    <text x="52" y="158" font-size="38" font-weight="800" fill="url(#title)" letter-spacing="0">dsh-conversation-outline</text>
+    <text x="54" y="198" font-size="19" font-weight="600" fill="#dfe6ff">会话大纲 · Conversation Outline</text>
+    <text x="54" y="234" font-size="14.5" fill="#93a2cc">Find any question. Jump to any answer.</text>
+    <text x="54" y="258" font-size="14.5" fill="#6d7ba3">A Codex-style right-edge rail for DeepSeek Harness Web.</text>
+  </g>
+
+  <!-- right: app window illustration -->
+  <g transform="translate(716 34)">
+    <!-- window frame -->
+    <rect x="0" y="0" width="516" height="292" rx="16" fill="#0d1428" stroke="#22315c" stroke-width="1.5"/>
+    <rect x="0" y="0" width="516" height="34" rx="16" fill="#101a34"/>
+    <rect x="0" y="18" width="516" height="16" fill="#101a34"/>
+    <circle cx="22" cy="17" r="5" fill="#ff5f57"/>
+    <circle cx="42" cy="17" r="5" fill="#febc2e"/>
+    <circle cx="62" cy="17" r="5" fill="#28c840"/>
+    <rect x="140" y="10" width="236" height="14" rx="7" fill="#1b2a52"/>
+
+    <!-- chat bubbles -->
+    <rect x="30" y="56" width="196" height="30" rx="10" fill="#16224a"/>
+    <rect x="30" y="94" width="146" height="30" rx="10" fill="#16224a"/>
+    <rect x="30" y="132" width="216" height="30" rx="10" fill="#16224a"/>
+    <!-- assistant block -->
+    <rect x="30" y="182" width="322" height="16" rx="8" fill="#1d2b58"/>
+    <rect x="30" y="204" width="282" height="16" rx="8" fill="#1d2b58"/>
+    <rect x="30" y="226" width="302" height="16" rx="8" fill="#1d2b58"/>
+    <!-- highlighted (jump target) bubble with flash glow -->
+    <rect x="30" y="132" width="216" height="30" rx="10" fill="none" stroke="#6f8dff" stroke-width="2.4"/>
+    <rect x="26" y="128" width="224" height="38" rx="14" fill="none" stroke="#4d6bfe" stroke-opacity="0.35" stroke-width="6"/>
+
+    <!-- hover panel -->
+    <rect x="272" y="52" width="212" height="200" rx="12" fill="#111a38" stroke="#26386e" stroke-width="1.4"/>
+    <rect x="284" y="64" width="188" height="14" rx="7" fill="#8fa8ff"/>
+    <rect x="284" y="88" width="188" height="22" rx="8" fill="#182650" stroke="#233368" stroke-width="1"/>
+    <circle cx="296" cy="99" r="4" fill="#4d6bfe"/>
+    <rect x="306" y="94" width="110" height="10" rx="5" fill="#2c3f7c"/>
+    <!-- panel rows -->
+    <rect x="284" y="120" width="188" height="26" rx="8" fill="#0e1836"/>
+    <rect x="294" y="128" width="24" height="10" rx="5" fill="#4d6bfe"/>
+    <rect x="326" y="128" width="120" height="10" rx="5" fill="#31447f"/>
+    <rect x="284" y="152" width="188" height="26" rx="8" fill="#0e1836"/>
+    <rect x="294" y="160" width="24" height="10" rx="5" fill="#4d6bfe"/>
+    <rect x="326" y="160" width="96" height="10" rx="5" fill="#31447f"/>
+    <rect x="284" y="184" width="188" height="26" rx="8" fill="#0e1836"/>
+    <rect x="294" y="192" width="24" height="10" rx="5" fill="#4d6bfe"/>
+    <rect x="326" y="192" width="140" height="10" rx="5" fill="#31447f"/>
+    <rect x="284" y="220" width="188" height="20" rx="8" fill="#0e1836"/>
+    <rect x="294" y="226" width="140" height="8" rx="4" fill="#22315c"/>
+
+    <!-- right-edge rail -->
+    <rect x="492" y="70" width="12" height="160" rx="6" fill="#0a0f20" stroke="#22315c" stroke-width="1"/>
+    <rect x="494" y="76" width="8" height="6" rx="3" fill="#2c3f7c"/>
+    <rect x="494" y="86" width="8" height="6" rx="3" fill="#2c3f7c"/>
+    <rect x="494" y="96" width="8" height="6" rx="3" fill="#6f8dff"/>
+    <rect x="494" y="106" width="8" height="6" rx="3" fill="#2c3f7c"/>
+    <rect x="494" y="116" width="8" height="6" rx="3" fill="#2c3f7c"/>
+    <rect x="494" y="126" width="8" height="6" rx="3" fill="#2c3f7c"/>
+    <rect x="494" y="136" width="8" height="6" rx="3" fill="#2c3f7c"/>
+    <rect x="494" y="146" width="8" height="6" rx="3" fill="#2c3f7c"/>
+    <rect x="494" y="156" width="8" height="6" rx="3" fill="#2c3f7c"/>
+  </g>
+</svg>

package/cordis.patch.yml

@@ -0,0 +1,12 @@
+# dsh-conversation-outline bundle patch: mounts the plugin row into the host
+# composition of a dsh profile. The plugin is client-only (all UI lives in the
+# browser bundle); this host row exists so the roster scan finds the package
+# and the composition has a resolvable plugin body.
+#
+# `name` must stay in sync with package.json `name` (the npm package is scoped
+# because the unscoped name was taken by an unrelated package). Quoted because
+# `@` is a reserved YAML indicator and cannot open a plain scalar.
+- insert:
+    - id: dsh-conversation-outline
+      name: '@chestnut23/dsh-conversation-outline'
+      config: {}