dsh-session-accordion 0.0.0-stage → 2.5.6

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 DSH Jack
+
+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

@@ -1,3 +1,379 @@
-# Temporary Holding Version
+# DSH 会话交互折叠功能 · DSH Session Turn Accordion
 
-This version is a temporary placeholder for this package. An operational version to replace this has been submitted for review and is awaiting a staged release.
+[![awesome-dsh-plugin](https://img.shields.io/badge/awesome--dsh--plugin-已收录-brightgreen)](https://github.com/awesome-dsh-plugin/awesome-dsh-plugin)
+[![dshbase](https://img.shields.io/badge/dshbase-已收录-blue)](https://dshbase.com/zh/plugins/dsh-session-accordion/)
+[![license](https://img.shields.io/github/license/ayuanxx-max/dsh-session-accordion)](LICENSE)
+[![release](https://img.shields.io/github/v/release/ayuanxx-max/dsh-session-accordion)](https://github.com/ayuanxx-max/dsh-session-accordion/releases)
+[![stars](https://img.shields.io/github/stars/ayuanxx-max/dsh-session-accordion)](https://github.com/ayuanxx-max/dsh-session-accordion/stargazers)
+
+> **30 秒理解**：把 DSH 会话里每一轮对话折叠成一行（时间胶囊 + 问题摘要），只保留最新一条展开。纯客户端插件，不改核心。
+>
+> 兼容 DSH Desktop / Web；安装见下方「安装」，卸载见「卸载」。
+
+![会话管理示意](docs/images/session-management.svg)
+
+**会话折叠**
+
+![会话折叠演示](docs/images/demo-accordion.gif)
+
+**分叉树排列**
+
+![分叉树演示](docs/images/demo-forktree.gif)
+
+📖 **[会话管理指南（折叠 + 分叉树组合用法）](docs/session-management-guide.md)**
+
+
+## 平台支持与路线图
+
+| 平台 | 状态 |
+| --- | --- |
+| **Windows 11（DSH Desktop）** | ✅ **稳定运行**（当前版本） |
+| Ubuntu | 🧪 **测试中**，尚未承诺稳定 |
+| macOS | 📋 **计划中** |
+
+> 修复与功能调整的**优先级按评论 / 留言的反馈量排序**——遇到问题请直接开 issue 或留言，
+> 同类反馈越多越先修。欢迎提交你所在平台的环境信息。
+
+### 相关插件
+
+- [dsh-session-fork-tree](https://github.com/ayuanxx-max/dsh-session-fork-tree) —— 分叉会话以树状排列在侧边栏
+- [awesome-dsh-plugin](https://github.com/awesome-dsh-plugin/awesome-dsh-plugin) —— DSH 插件精选列表
+
+
+把 DSH Web 会话里的每一次交互压成一行，只保留最近一次展开；点提问行展开，执行过程另行单独点开。
+
+Fold every interaction in a DSH Web chat into a single line and keep only the latest one open. Click a question row to expand it; the execution process opens only when you click its own header.
+
+[中文](#中文) · [English](#english)
+
+---
+
+## 中文
+
+### 这是什么
+
+一个 DSH（DeepSeek Harness）客户端插件。它不修改 `app.asar`、不碰核心 UI 源码，只在渲染层做三件事：
+
+1. 每个历史交互整轮收起，折叠成**固定一行**：左侧时间胶囊 `MM-DD HH:mm` + 单行提问摘要（超出省略）。
+2. 只保留**最近一次交互**展开；打开任何会话、切换工作区/会话、产生新交互，都会把展开态重置到最近一条（之前手动展开的也会被收起）。
+3. 点折叠行 → 该轮展开，同时把其它已展开的轮收起；再点提问 → 收回去。
+
+执行过程（思考、工具调用、步骤）不跟着展开：核心本身在回答结束时会收起过程，只有你单独点「过程摘要」那一行才会展开。
+
+### 效果
+
+```
+┌──────────────────────────────────────────────────────────┐
+│ 10-28 13:12   把这批日志按时间排序、去重，然后…        › │   ← 折叠（一行）
+├──────────────────────────────────────────────────────────┤
+│ 10-28 12:58   帮我看下 esp32 的引脚冲突                  › │
+├──────────────────────────────────────────────────────────┤
+│ 你的提问（全文）                                          │   ← 展开（最近一次）
+│ …回答正文…                                                │
+│ ▸ 12 步 · 思考 8s · 工具 4 次（点开才展开）               │
+└──────────────────────────────────────────────────────────┘
+```
+
+### 安装
+
+**npm（推荐）**
+
+```bash
+# 桌面版（profile=desktop）
+dsh plugin --profile desktop add dsh-session-accordion@2.5.6
+
+# 或免全局安装
+npx -y @deepseek-ai/dsh plugin --profile desktop add dsh-session-accordion@2.5.6
+
+# Web UI（profile=web）
+dsh plugin --profile web add dsh-session-accordion@2.5.6
+```
+
+安装后**完全退出 DSH 再启动**；卸载：
+
+```bash
+dsh plugin --profile desktop remove dsh-session-accordion
+```
+
+> 以下为源码方式（开发 / 离线环境）：
+
+
+前置：能跑 DSH Web UI 的宿主 —— Windows / macOS 桌面版，或 Linux 上的 `dsh web`。profile 名随宿主不同：桌面版默认 `desktop`，`dsh web` 默认 `web`，自定义 profile 用你自己的名字。
+
+#### Windows（PowerShell）
+
+```powershell
+git clone https://github.com/ayuanxx-max/dsh-session-accordion.git
+$repo = (Resolve-Path .\dsh-session-accordion).Path
+$nm = "$env:USERPROFILE\.dsh\profiles\desktop\node_modules"
+New-Item -ItemType Junction -Path "$nm\dsh-session-accordion" -Target $repo
+```
+
+#### Linux / macOS（bash）
+
+```bash
+git clone https://github.com/ayuanxx-max/dsh-session-accordion.git
+repo="$(cd dsh-session-accordion && pwd)"
+profile="${DSH_PROFILE:-web}"        # 桌面版改成 desktop
+mkdir -p "$HOME/.dsh/profiles/$profile/node_modules"
+ln -sfn "$repo" "$HOME/.dsh/profiles/$profile/node_modules/dsh-session-accordion"
+```
+
+> **符号链接必须是绝对路径**：相对路径在 profile 目录变化后会失效。
+> 也可以一条命令完成（含 package.json 备份与合并）：`bash scripts/install.sh --profile web --apply`。
+> Windows 对应：`powershell -ExecutionPolicy Bypass -File scripts\install.ps1 -Profile desktop -Apply`。
+
+#### 方式 B：直接装 Release 包（无符号链接，Linux 下最省事）
+
+```bash
+# pnpm 会把这枚 tarball 复制进 profile，不依赖符号链接 / junction
+dsh plugin --profile web add /path/to/dsh-session-accordion-2.5.3.tgz
+# 再把 "dsh-session-accordion" 加进 dsh.profile.bundles，重启 DSH
+```
+
+> 升级时下载新 tarball 再执行一次即可，不需要 `git pull`。
+
+#### 登记到 profile（三种系统相同）
+
+```jsonc
+// ~/.dsh/profiles/<profile>/package.json
+{
+  "dependencies": {
+    "dsh-session-accordion": "link:/absolute/path/to/dsh-session-accordion"
+  },
+  "dsh": {
+    "profile": {
+      "bundles": ["dsh-session-accordion"]
+    }
+  }
+}
+```
+
+4. **完全退出 DSH 再启动**（profile 层改动，刷新网页无效）。
+5. 设置 → 对话 → **工作步骤收起时机 = 回答结束后**（插件依赖这个前置，过程才会自动收起）。
+
+> 复制进 `node_modules` 也能用，但链接方式升级最省事：`git pull` 后重启即可。
+
+### 卸载
+
+1. 从 `package.json` 的 `dependencies` 与 `dsh.profile.bundles` 中删掉 `dsh-session-accordion`。
+2. 删掉链接：Windows `Remove-Item node_modules\dsh-session-accordion`；Linux/macOS `rm ~/.dsh/profiles/<profile>/node_modules/dsh-session-accordion`（只删链接，不动源码）。
+3. 重启 DSH。
+
+### 工作原理
+
+| 关键点 | 说明 |
+| --- | --- |
+| 挂载点 | 客户端插件（`dsh.client`，`platform: web`，`immediately: true`），随 Web 应用加载一次，天然覆盖所有工作区与会话 |
+| 轮次分组 | 聊天流容器 `[data-slot="conversation.chat.flow"]` 下，每个渲染节点带 `[data-chat-turn="<turnId>"]`；同 turnId 归为一轮 |
+| 提问识别 | 轮内包含 `class` 以 `_bubble` 结尾的元素（用户/steering 气泡共用）的节点 |
+| 过程识别 | `data-chat-flow-kind="turn-process"` 的节点，其内部 `button[aria-expanded]` 是核心原生折叠开关 |
+| 折叠方式 | 给整轮除提问外的节点打 `data-ac-hidden`（`display:none`），提问行用伪元素画时间胶囊与摘要，原内容 `visibility:hidden` |
+| 状态 | 按 `turnId` 存在内存 `Map`；未知轮次默认「最后一轮展开」，因此切换会话、历史回看都自动收敛 |
+| 时间 | 优先读 React fiber 上的 `props.node.data.time`（不受悬停影响），退回原生时钟文本，都没有就不显示 |
+| 自愈 | `MutationObserver` + 1.5 秒兜底巡检，React 重渲染后重新贴状态 |
+
+设计取向：**只叠加，不侵入**。核心的折叠状态、流式输出、滚动锚定都不接管；结构认不出时插件什么都不做，只在 console 打一条 `warn`。
+
+### 诊断
+
+页面 DevTools Console：
+
+```js
+__acReport()
+```
+
+输出每一轮的 `id / expanded / stamp / summary / items`。结构变化（DSH 升级后 DOM 改名）时，看这个能立刻定位是「分组失败」还是「时间取不到」。
+
+### 兼容性
+
+| 平台 / 引擎 | 状态 | 说明 |
+| --- | --- | --- |
+| Windows（DSH 桌面版，Electron/Chromium） | ✅ 主力验证 | 本轮开发基准 |
+| macOS（桌面版；Tauri/WebView 需较新内核） | ✅ 设计兼容 | 只用标准 `mask-image` + 内联 SVG，无平台 API |
+| Ubuntu / Debian 等 Linux（Chrome / Edge / Chromium） | ✅ CI 验证安装链路 | 安装脚本、打包、安装冒烟测试跑在 `ubuntu-latest` 上 |
+| Linux 上的 Firefox | ⚠️ 未实测 | 用到 `mask-image`（Firefox 支持无前缀写法）；最坏情况只失去渐隐，不影响折叠 |
+
+- **时区**：时间胶囊用浏览器时区。Linux 服务器多为 UTC，此时显示的是 UTC；在 Console 执行
+  `window.__dshAccordion = { timeZone: 'Asia/Shanghai' }` 后刷新页面即可覆盖。
+- **动态效果**：尊重系统"减少动态效果"（`prefers-reduced-motion`），开启后不播放展开淡入。
+- **字体**：时间胶囊与摘要列按像素定宽，Ubuntu / SF 字体下宽度略有差异，不影响布局。
+
+### 已知限制
+
+- 依赖 DSH 聊天面板的内部 DOM 属性（`data-chat-turn` 等），属**非公开契约**，上游改版可能失效；失效时插件静默不动作，不会破坏界面。
+- 折叠行是自绘的一行，行内链接需先展开再点。
+- 时间取自提问节点的事件时间；极少数节点没有 `time` 时不显示时间，只显示摘要。
+- 未发布到 npm，按上面的本地 link 方式安装。
+
+### 同类项目
+
+DSH 生态里已有若干「回合折叠」插件，取舍不同：
+
+| 项目 | 形态 | 与本项目的差别 |
+| --- | --- | --- |
+| [a179-sanae/dsh-auto-collapse](https://github.com/a179-sanae/dsh-auto-collapse) | 把正文之间的思考/工具/上下文合成二级折叠，保留原生回合摘要 | 答案始终可见；不限制同时展开的轮数 |
+| [leon-zym/dsh-fold-turns](https://github.com/leon-zym/dsh-fold-turns) | 完成回合折成一行 `Worked for …`，保留用户消息与回答 | 已标记弃用（DSH 0.1.5+ 原生支持过程折叠） |
+| [tntcannon5000/dsh-chat-fold](https://github.com/tntcannon5000/dsh-chat-fold) | 在最终回答上方插入 disclosure | 回答不隐藏；不是手风琴 |
+| **本项目** | **整轮（提问 + 回答 + 过程）压成一行，只允许一条展开** | 空间优先：点开才看该轮内容 |
+
+选择建议：想「一眼扫完所有答案」用上面那类；想「一屏看完整个会话骨架、按需展开」用本项目。
+
+### 许可证
+
+MIT，见 [LICENSE](LICENSE)。
+
+---
+
+## English
+
+### What it is
+
+A client plugin for DSH (DeepSeek Harness). It never edits `app.asar` or any core UI source; it only layers three behaviours on top of the rendered transcript:
+
+1. Every finished interaction collapses into **one fixed line**: a time pill (`MM-DD HH:mm`) plus a single-line summary of your question, ellipsized when long.
+2. Only the **latest interaction** stays open; opening any session, switching workspace/session, or starting a new turn resets the open state to the newest turn (manual expansions are folded too).
+3. Clicking a collapsed row expands that turn and folds any other open turn; clicking the question again folds it back.
+
+The execution process (thinking, tool calls, steps) does not expand with the turn: DSH folds it when the answer completes, and it opens only when you click its own summary row.
+
+### What it looks like
+
+```
+┌──────────────────────────────────────────────────────────┐
+│ 10-28 13:12   Sort these logs by time, dedupe, then…   › │   ← folded (one line)
+├──────────────────────────────────────────────────────────┤
+│ 10-28 12:58   Check the ESP32 pin conflicts             › │
+├──────────────────────────────────────────────────────────┤
+│ Your full question                                       │   ← expanded (latest)
+│ …answer body…                                            │
+│ ▸ 12 steps · 8s thinking · 4 tool calls (click to open)  │
+└──────────────────────────────────────────────────────────┘
+```
+
+### Install
+
+Prerequisite: a host that runs the DSH Web UI — the Windows/macOS desktop app, or `dsh web` on Linux. The profile name depends on the host: `desktop` for the desktop app, `web` for `dsh web`, or your own name for a custom profile.
+
+#### Windows (PowerShell)
+
+```powershell
+git clone https://github.com/ayuanxx-max/dsh-session-accordion.git
+$repo = (Resolve-Path .\dsh-session-accordion).Path
+$nm = "$env:USERPROFILE\.dsh\profiles\desktop\node_modules"
+New-Item -ItemType Junction -Path "$nm\dsh-session-accordion" -Target $repo
+```
+
+#### Linux / macOS (bash)
+
+```bash
+git clone https://github.com/ayuanxx-max/dsh-session-accordion.git
+repo="$(cd dsh-session-accordion && pwd)"
+profile="${DSH_PROFILE:-web}"        # use desktop for the desktop app
+mkdir -p "$HOME/.dsh/profiles/$profile/node_modules"
+ln -sfn "$repo" "$HOME/.dsh/profiles/$profile/node_modules/dsh-session-accordion"
+```
+
+> **The symlink must use an absolute path**; a relative target breaks as soon as the profile directory moves.
+> One-shot alternative (backs up and merges `package.json`): `bash scripts/install.sh --profile web --apply`.
+> Windows equivalent: `powershell -ExecutionPolicy Bypass -File scripts\install.ps1 -Profile desktop -Apply`.
+
+#### Option B: install the release tarball (no symlink / junction)
+
+```bash
+# pnpm copies the tarball into the profile; no symlink or junction involved
+dsh plugin --profile web add /path/to/dsh-session-accordion-2.5.3.tgz
+# then add "dsh-session-accordion" to dsh.profile.bundles and restart DSH
+```
+
+> To upgrade, download the new tarball and run the command again; no `git pull` needed.
+
+#### Register in the profile (same on every OS)
+
+```jsonc
+// ~/.dsh/profiles/<profile>/package.json
+{
+  "dependencies": {
+    "dsh-session-accordion": "link:/absolute/path/to/dsh-session-accordion"
+  },
+  "dsh": {
+    "profile": {
+      "bundles": ["dsh-session-accordion"]
+    }
+  }
+}
+```
+
+4. **Quit DSH completely and start it again** (profile-layer change; refreshing the page is not enough).
+5. Settings → Chat → **When to collapse work details = On completion**. The plugin relies on this so the process folds by itself.
+
+> Copying the repo into `node_modules` also works, but a symlink keeps upgrades to `git pull` + restart.
+
+### Uninstall
+
+1. Remove `dsh-session-accordion` from `dependencies` and `dsh.profile.bundles`.
+2. Remove the link: Windows `Remove-Item node_modules\dsh-session-accordion`; Linux/macOS `rm ~/.dsh/profiles/<profile>/node_modules/dsh-session-accordion` (the link only; the source directory stays).
+3. Restart DSH.
+
+### How it works
+
+| Point | Detail |
+| --- | --- |
+| Mount | A client plugin (`dsh.client`, `platform: web`, `immediately: true`) loaded once with the web app, so it covers every workspace and session |
+| Turn grouping | Inside `[data-slot="conversation.chat.flow"]`, each rendered node carries `[data-chat-turn="<turnId>"]`; nodes sharing a turn id form one turn |
+| User node | The node whose subtree contains an element with a class ending in `_bubble` (user and steering bubbles share it) |
+| Process node | The node with `data-chat-flow-kind="turn-process"`; its `button[aria-expanded]` is the built-in fold control |
+| Folding | Marks every non-user node of the turn with `data-ac-hidden` (`display:none`); the user row draws its pill and summary with pseudo-elements while the real bubble is `visibility:hidden` |
+| State | An in-memory `Map` keyed by `turnId`; unknown turns default to "last one expanded", which is why session switches and history reloads converge on their own |
+| Timestamp | Read from the React fiber (`props.node.data.time`) first, then the native clock text; nothing is invented if neither exists |
+| Self-healing | `MutationObserver` plus a 1.5 s safety sweep re-applies state after React re-renders |
+
+Design stance: **layer, never invade**. Core folding, streaming output and scroll anchoring stay untouched; when the structure cannot be recognised the plugin does nothing and logs a single `warn`.
+
+### Diagnostics
+
+In the page DevTools console:
+
+```js
+__acReport()
+```
+
+It prints `id / expanded / stamp / summary / items` per turn. After an upstream UI change this tells you immediately whether grouping failed or the timestamp went missing.
+
+### Compatibility
+
+| Platform / engine | Status | Notes |
+| --- | --- | --- |
+| Windows (DSH desktop, Electron/Chromium) | ✅ primary target | Development baseline |
+| macOS (desktop app; Tauri/WebView needs a recent engine) | ✅ designed to work | Standard `mask-image` plus inline SVG only, no platform APIs |
+| Ubuntu / Debian and other Linux (Chrome / Edge / Chromium) | ✅ install path verified in CI | installer, packaging and install smoke test run on `ubuntu-latest` |
+| Firefox on Linux | ⚠️ not exercised | uses `mask-image` (Firefox ships the unprefixed property); worst case the fade is lost, folding still works |
+
+- **Time zone**: the time pill uses the browser time zone. A Linux server is often UTC, so rows show UTC;
+  run `window.__dshAccordion = { timeZone: 'Asia/Shanghai' }` in the console and reload to override.
+- **Motion**: respects `prefers-reduced-motion`; the expand fade is skipped when it is enabled.
+- **Fonts**: pill and summary columns are pixel-sized, so Ubuntu/SF fonts shift widths slightly without breaking the layout.
+
+### Known limitations
+
+- Relies on internal DOM attributes of the DSH chat panel (`data-chat-turn`, …). That is a **private contract** and may break on an upstream redesign; the plugin then fails safe by doing nothing.
+- The folded row is self-drawn, so links inside a question need one click to expand first.
+- Timestamps come from the question node's event time; the rare node without `time` shows a summary only.
+- Not published to npm; install it through the local link shown above.
+
+### Similar projects
+
+The DSH ecosystem already has a few turn-folding plugins. They make a different trade-off:
+
+| Project | Shape | Difference from this one |
+| --- | --- | --- |
+| [a179-sanae/dsh-auto-collapse](https://github.com/a179-sanae/dsh-auto-collapse) | Merges reasoning/tool/context blocks between prose into a secondary disclosure, keeping the native turn summary | The answer always stays visible; several turns can be open at once |
+| [leon-zym/dsh-fold-turns](https://github.com/leon-zym/dsh-fold-turns) | Folds a completed turn into a `Worked for …` row, keeping the user message and answer | Marked deprecated (DSH 0.1.5+ folds processes natively) |
+| [tntcannon5000/dsh-chat-fold](https://github.com/tntcannon5000/dsh-chat-fold) | Inserts a disclosure above the final answer | The answer stays visible; not an accordion |
+| **This project** | **Folds the whole turn (question + answer + process) into one row and allows only one open turn** | Space first: click a row to read that turn |
+
+Pick the former if you want to skim every answer at once; pick this one if you want the whole session skeleton on one screen and open turns on demand.
+
+### License
+
+MIT, see [LICENSE](LICENSE).

package/client.js

@@ -0,0 +1,477 @@
+/**
+ * DSH 轮次手风琴（整轮折叠 / 提问单行摘要 / 日期时间 / 会话级重置）
+ *
+ * 行为（全工作区 / 全会话）：
+ *   1. 打开任何会话：只展开**最近一条**交互，历史交互各占一行
+ *      （时间胶囊 + 提问摘要 + chevron），过程与回答全部隐藏；
+ *   2. 产生新交互：新的一轮自动展开，之前所有展开的轮次（包括手动展开的）一律折叠；
+ *   3. 切换工作区/会话：状态整体重置，仍然只展开最近一条。
+ *
+ * 唯一展开态由 `expandedId`（单个 turnId）表示；会话切换/历史消失/新轮追加
+ * 三种事件都会把 `expandedId` 重新指向列表最后一条。
+ *
+ * 时间来源：React fiber 的 `props.node.data.time` → 原生 `*_timeStart` 文本 → 无。
+ *
+ * 安全阀：结构认不出就不动作；异常只 warn；不改核心配置、不碰 app.asar。
+ */
+window.__ModuleLoader__.load({
+  id: 'dsh-session-accordion',
+  factory() {
+    const STYLE_ID = 'dsh-auto-collapse-style';
+    const FLOW_SEL = '[data-slot="conversation.chat.flow"]';
+    const ITEM_SEL = '[data-chat-turn]';
+    const HIDE_ATTR = 'data-ac-hidden';
+    const LINE_ATTR = 'data-ac-line';
+    const USER_ATTR = 'data-ac-user';
+    const TEXT_ATTR = 'data-ac-text';
+    const TIME_ATTR = 'data-ac-time';
+    const FRESH_ATTR = 'data-ac-fresh';
+
+    const CHEVRON = 'url("data:image/svg+xml,' +
+      '%3Csvg%20xmlns=%27http://www.w3.org/2000/svg%27%20width=%2712%27%20height=%2712%27' +
+      '%20viewBox=%270%200%2024%2024%27%20fill=%27none%27%20stroke=%27%23909090%27' +
+      '%20stroke-width=%272%27%20stroke-linecap=%27round%27%20stroke-linejoin=%27round%27' +
+      '%3E%3Cpolyline%20points=%279%206%2015%2012%209%2018%27/%3E%3C/svg%3E")';
+
+    /** 当前会话说：唯一展开的 turnId；null = 全部折叠。 */
+    let expandedId = null;
+    /** 上一帧看到的 turnId 序列，用来判定「追加 / 消失 / 新会话」。 */
+    let seenIds = [];
+    /** 上一帧的聊天流容器，容器换人 = 换了会话视图。 */
+    let flowRef = null;
+
+    const textCache = new WeakMap();
+    let pending = false;
+    let started = false;
+    let logged = false;
+
+    function ensureStyle() {
+      if (document.getElementById(STYLE_ID) !== null) return;
+      const tag = document.createElement('style');
+      tag.id = STYLE_ID;
+      tag.textContent = [
+        '[' + HIDE_ATTR + '="1"]{display:none!important}',
+
+        '[' + LINE_ATTR + '="1"]{position:relative;height:2em;margin:1px 0;overflow:hidden;',
+        '  cursor:pointer;border-radius:8px;transition:background-color .12s ease;',
+        '  background-repeat:no-repeat;background-position:right 9px center;background-size:12px 12px;',
+        '  background-image:' + CHEVRON + '}',
+        '[' + LINE_ATTR + '="1"]>*{visibility:hidden!important}',
+
+        '[' + LINE_ATTR + '="1"]::before{content:attr(' + TIME_ATTR + ');position:absolute;',
+        '  left:8px;top:50%;transform:translateY(-50%);width:86px;text-align:center;',
+        '  font-size:11px;line-height:18px;border-radius:999px;white-space:nowrap;',
+        '  font-variant-numeric:tabular-nums;letter-spacing:.02em;',
+        '  color:var(--dsw-alias-label-tertiary,#9aa0a6);',
+        '  background:rgba(127,127,127,.16);pointer-events:none}',
+        '[' + LINE_ATTR + '="1"]:not([' + TIME_ATTR + '])::before{content:none}',
+
+        '[' + LINE_ATTR + '="1"]::after{content:attr(' + TEXT_ATTR + ');position:absolute;',
+        '  left:104px;right:28px;top:50%;transform:translateY(-50%);',
+        '  font-size:.92em;line-height:1.5em;white-space:nowrap;overflow:hidden;',
+        '  text-overflow:ellipsis;color:var(--dsw-alias-label-secondary,#c9c9c9)}',
+        '[' + LINE_ATTR + '="1"]:not([' + TIME_ATTR + '])::after{left:12px}',
+
+        '[' + LINE_ATTR + '="1"]:hover{background-color:rgba(127,127,127,.10)}',
+        '[' + LINE_ATTR + '="1"]:hover::after{color:var(--dsw-alias-label-primary,#fff)}',
+        '[' + LINE_ATTR + '="1"]:active{background-color:rgba(127,127,127,.18)}',
+
+        '@keyframes dsh-ac-fade{from{opacity:0;transform:translateY(-3px)}to{opacity:1;transform:none}}',
+        '[' + FRESH_ATTR + '="1"]{animation:dsh-ac-fade .16s ease-out}',
+        '[' + LINE_ATTR + '="1"]::after{-webkit-font-smoothing:antialiased;-moz-osx-font-smoothing:grayscale}',
+        '@media (prefers-reduced-motion:reduce){[' + FRESH_ATTR + '="1"]{animation:none!important}}',
+      ].join('');
+      (document.head || document.documentElement).appendChild(tag);
+    }
+
+    function findFlow() {
+      const flows = document.querySelectorAll(FLOW_SEL);
+      let best = null;
+      let bestCount = 0;
+      for (let i = 0; i < flows.length; i++) {
+        const count = flows[i].querySelectorAll(ITEM_SEL).length;
+        if (count > bestCount) {
+          best = flows[i];
+          bestCount = count;
+        }
+      }
+      if (best !== null) return best;
+      const items = document.querySelectorAll(ITEM_SEL);
+      if (items.length === 0) return null;
+      return items[0].parentElement;
+    }
+
+    function groups(flow) {
+      const all = flow.querySelectorAll(ITEM_SEL);
+      const out = [];
+      const byId = new Map();
+      for (let i = 0; i < all.length; i++) {
+        const el = all[i];
+        if (el.closest(ITEM_SEL) !== el) continue;
+        const id = el.getAttribute('data-chat-turn');
+        if (!id) continue;
+        let group = byId.get(id);
+        if (group === undefined) {
+          group = { id, items: [] };
+          byId.set(id, group);
+          out.push(group);
+        }
+        group.items.push(el);
+      }
+      return out;
+    }
+
+    function pick(group) {
+      let process = null;
+      for (let i = 0; i < group.items.length; i++) {
+        const el = group.items[i];
+        if (el.getAttribute('data-chat-flow-kind') !== 'turn-process') continue;
+        if (process === null || el.querySelector('button[aria-expanded]') !== null) process = el;
+      }
+      let user = null;
+      for (let i = 0; i < group.items.length; i++) {
+        const el = group.items[i];
+        if (el === process) continue;
+        if (el.querySelector('[class*="_bubble"]') !== null) {
+          user = el;
+          break;
+        }
+      }
+      if (user === null) {
+        for (let i = 0; i < group.items.length; i++) {
+          if (group.items[i] !== process) {
+            user = group.items[i];
+            break;
+          }
+        }
+      }
+      if (user === null) user = group.items[0];
+      return {
+        process,
+        user,
+        rest: group.items.filter(function (el) {
+          return el !== user;
+        }),
+      };
+    }
+
+    function pad2(value) {
+      return value < 10 ? '0' + value : String(value);
+    }
+
+    /** Optional time-zone override: window.__dshAccordion = { timeZone: 'Asia/Shanghai' }. */
+    function timeZoneOf() {
+      try {
+        const cfg = window.__dshAccordion;
+        return cfg && typeof cfg.timeZone === 'string' && cfg.timeZone ? cfg.timeZone : '';
+      } catch (err) {
+        return '';
+      }
+    }
+
+    function fmtTime(value) {
+      if (value === undefined || value === null) return '';
+      let ms;
+      if (value instanceof Date) ms = value.getTime();
+      else if (typeof value === 'number') ms = value < 1e12 ? value * 1000 : value;
+      else ms = new Date(String(value)).getTime();
+      if (!isFinite(ms)) return '';
+      const d = new Date(ms);
+      if (isNaN(d.getTime())) return '';
+      const zone = timeZoneOf();
+      if (zone) {
+        try {
+          const parts = new Intl.DateTimeFormat('en-CA', {
+            timeZone: zone, month: '2-digit', day: '2-digit',
+            hour: '2-digit', minute: '2-digit', hour12: false,
+          }).formatToParts(d);
+          const pick = function (type) {
+            for (let i = 0; i < parts.length; i++) {
+              if (parts[i].type === type) return parts[i].value;
+            }
+            return '';
+          };
+          const out = pick('month') + '-' + pick('day') + ' ' + pick('hour') + ':' + pick('minute');
+          if (/^[0-9]{2}-[0-9]{2} [0-9]{2}:[0-9]{2}$/.test(out)) return out;
+        } catch (err) {
+          // unknown zone or no Intl support (older WebView): fall through to local time
+        }
+      }
+      return pad2(d.getMonth() + 1) + '-' + pad2(d.getDate()) + ' ' +
+        pad2(d.getHours()) + ':' + pad2(d.getMinutes());
+    }
+
+    function fiberTime(el) {
+      let fiber = null;
+      const keys = Object.keys(el);
+      for (let i = 0; i < keys.length; i++) {
+        if (keys[i].indexOf('__reactFiber$') === 0 || keys[i].indexOf('__reactInternalInstance$') === 0) {
+          fiber = el[keys[i]];
+          break;
+        }
+      }
+      let depth = 0;
+      while (fiber !== null && fiber !== undefined && depth < 40) {
+        const props = fiber.memoizedProps;
+        if (props !== null && typeof props === 'object') {
+          if (props.node && props.node.data && props.node.data.time !== undefined) return props.node.data.time;
+          if (props.time !== undefined && typeof props.time === 'number') return props.time;
+        }
+        fiber = fiber.return;
+        depth += 1;
+      }
+      return undefined;
+    }
+
+    function clockText(user) {
+      const clocks = user.querySelectorAll('[class*="_timeStart"],[class*="_timeEnd"]');
+      for (let i = 0; i < clocks.length; i++) {
+        const text = (clocks[i].textContent || '').trim();
+        if (text) return text;
+      }
+      return '';
+    }
+
+    function stampOf(user, bubble) {
+      const stamp = fmtTime(fiberTime(bubble !== null ? bubble : user));
+      if (stamp) return stamp;
+      const native = clockText(user);
+      if (!native) return '';
+      if (/^\d{1,2}[:：]\d{2}/.test(native)) {
+        const now = new Date();
+        return pad2(now.getMonth() + 1) + '-' + pad2(now.getDate()) + ' ' + native;
+      }
+      return native;
+    }
+
+    function summaryOf(bubble, fallback) {
+      const source = bubble !== null ? bubble : fallback;
+      if (source === null) return '';
+      const raw = source.textContent || '';
+      const cached = textCache.get(source);
+      if (cached !== undefined && cached.len === raw.length) return cached.text;
+      let node = null;
+      try {
+        node = source.cloneNode(true);
+      } catch (err) {
+        node = null;
+      }
+      let text = raw;
+      if (node !== null) {
+        const junk = node.querySelectorAll('[class*="_actions"],[class*="_action"],[class*="_toolbar"]');
+        for (let i = 0; i < junk.length; i++) {
+          if (junk[i].parentNode !== null) junk[i].parentNode.removeChild(junk[i]);
+        }
+        text = node.textContent || '';
+      }
+      text = text.replace(/\s+/g, ' ').trim();
+      if (text.length > 180) text = text.slice(0, 180) + '…';
+      textCache.set(source, { len: raw.length, text });
+      return text;
+    }
+
+    function markFresh(el) {
+      if (el.getAttribute(FRESH_ATTR) === '1') return;
+      el.setAttribute(FRESH_ATTR, '1');
+      setTimeout(function () {
+        el.removeAttribute(FRESH_ATTR);
+      }, 200);
+    }
+
+    function resetState() {
+      expandedId = null;
+      seenIds = [];
+      flowRef = null;
+    }
+
+    /**
+     * 依据「容器变化 / 历史消失 / 新轮追加」决定当前唯一展开的轮次。
+     * @returns 本轮 turnId 序列（供渲染使用）
+     */
+    function trackExpanded(flow, list) {
+      const ids = list.map(function (group) {
+        return group.id;
+      });
+      if (flow === null || ids.length === 0) {
+        resetState();
+        return ids;
+      }
+      const last = ids[ids.length - 1];
+      if (flow !== flowRef) {
+        expandedId = last;
+      } else {
+        const prev = seenIds;
+        let missing = false;
+        for (let i = 0; i < prev.length; i++) {
+          if (ids.indexOf(prev[i]) === -1) {
+            missing = true;
+            break;
+          }
+        }
+        let appended = prev.length > 0 && ids.length > prev.length;
+        if (appended) {
+          for (let i = 0; i < prev.length; i++) {
+            if (ids[i] !== prev[i]) {
+              appended = false;
+              break;
+            }
+          }
+        }
+        if (missing || appended) {
+          expandedId = last;
+        } else if (expandedId !== null && ids.indexOf(expandedId) === -1) {
+          expandedId = last;
+        } else if (expandedId === null && prev.length === 0) {
+          expandedId = last;
+        }
+      }
+      flowRef = flow;
+      seenIds = ids;
+      return ids;
+    }
+
+    function apply() {
+      ensureStyle();
+      const flow = findFlow();
+      if (flow === null) {
+        resetState();
+        return 0;
+      }
+      // `conversation.chat.flow` 是 display:contents 锚点：它自己没有盒子，
+      // getClientRects() 恒为空，可见性只能靠行节点探测。
+      const probe = flow.querySelector(ITEM_SEL);
+      if (probe === null || probe.getClientRects().length === 0) {
+        resetState();
+        return 0;
+      }
+      const list = groups(flow);
+      trackExpanded(flow, list);
+      if (!logged && list.length > 0) {
+        logged = true;
+        console.info('[auto-collapse] active: turns=' + list.length + ' expanded=' + expandedId);
+      }
+      for (let i = 0; i < list.length; i++) {
+        const group = list[i];
+        const expanded = group.id === expandedId;
+        const parts = pick(group);
+        const user = parts.user;
+        if (user !== null) {
+          user.setAttribute(USER_ATTR, '1');
+          user.removeAttribute(HIDE_ATTR);
+          if (expanded) {
+            user.removeAttribute(LINE_ATTR);
+            user.removeAttribute(TEXT_ATTR);
+            user.removeAttribute(TIME_ATTR);
+          } else {
+            const bubble = user.querySelector('[class*="_bubble"]');
+            user.setAttribute(LINE_ATTR, '1');
+            const stamp = stampOf(user, bubble);
+            if (stamp) user.setAttribute(TIME_ATTR, stamp);
+            else user.removeAttribute(TIME_ATTR);
+            const body = summaryOf(bubble, user);
+            user.setAttribute(TEXT_ATTR, body || '（无正文）');
+          }
+        }
+        for (let j = 0; j < parts.rest.length; j++) {
+          const el = parts.rest[j];
+          if (expanded) {
+            if (el.hasAttribute(HIDE_ATTR)) {
+              el.removeAttribute(HIDE_ATTR);
+              markFresh(el);
+            }
+          } else {
+            el.setAttribute(HIDE_ATTR, '1');
+          }
+        }
+      }
+      return list.length;
+    }
+
+    function toggle(el) {
+      const id = el.getAttribute('data-chat-turn');
+      if (!id) return;
+      expandedId = expandedId === id ? null : id;
+      apply();
+    }
+
+    function onClick(event) {
+      const target = event.target;
+      if (!(target instanceof Element)) return;
+      if (target.closest('a,button') !== null) return;
+      const line = target.closest('[' + LINE_ATTR + '="1"]');
+      if (line !== null) {
+        event.preventDefault();
+        toggle(line);
+        return;
+      }
+      const user = target.closest('[' + USER_ATTR + '="1"]');
+      if (user === null) return;
+      const selection = window.getSelection();
+      if (selection !== null && String(selection).length > 0) return;
+      toggle(user);
+    }
+
+    function schedule() {
+      if (pending) return;
+      pending = true;
+      requestAnimationFrame(function () {
+        pending = false;
+        try {
+          apply();
+        } catch (err) {
+          console.warn('[auto-collapse] apply failed', err);
+        }
+      });
+    }
+
+    function report() {
+      const flow = findFlow();
+      if (flow === null) return { flow: false, expandedId };
+      return {
+        flow: true,
+        expandedId,
+        turns: groups(flow).map(function (group) {
+          const parts = pick(group);
+          const bubble = parts.user === null ? null : parts.user.querySelector('[class*="_bubble"]');
+          return {
+            id: group.id,
+            expanded: group.id === expandedId,
+            stamp: parts.user === null ? '' : stampOf(parts.user, bubble),
+            summary: parts.user === null ? '' : summaryOf(bubble, parts.user).slice(0, 60),
+            items: group.items.length,
+          };
+        }),
+      };
+    }
+
+    function start() {
+      if (started) return;
+      started = true;
+      ensureStyle();
+      document.addEventListener('click', onClick, true);
+      try {
+        new MutationObserver(schedule).observe(document.documentElement, {
+          childList: true,
+          subtree: true,
+        });
+      } catch (err) {
+        console.warn('[auto-collapse] observer unavailable', err);
+      }
+      setInterval(schedule, 1500);
+      setTimeout(schedule, 300);
+      window.__acReport = report;
+      console.info('[auto-collapse] ready — window.__acReport() 查看结构诊断');
+    }
+
+    return {
+      inject: [],
+      apply() {
+        try {
+          start();
+        } catch (err) {
+          console.warn('[auto-collapse] start failed', err);
+        }
+      },
+    };
+  },
+});

package/cordis.patch.yml

@@ -0,0 +1,4 @@
+# Loader patch for the dsh-session-accordion bundle.
+- insert:
+    - id: session-accordion
+      name: 'dsh-session-accordion'

package/index.js

@@ -0,0 +1,8 @@
+/**
+ * Host half of dsh-session-accordion.
+ *
+ * The whole feature lives in the Client half (client.js); the Host needs no
+ * services, no timers and no state, so this entry exists only to keep the
+ * bundle composable.
+ */
+export function apply() {}

package/package.json

@@ -1,6 +1,56 @@
 {
   "name": "dsh-session-accordion",
-  "version": "0.0.0-stage",
-  "stub": true,
-  "description": "Temporary package placeholder for staged publishing"
-}
+  "version": "2.5.6",
+  "private": false,
+  "description": "DSH Web chat turn accordion: every interaction folds into one line, only the newest turn opens, and session switches or new turns reset the open state.",
+  "type": "module",
+  "license": "MIT",
+  "keywords": [
+    "dsh",
+    "deepseek-harness",
+    "cordis",
+    "plugin",
+    "chat",
+    "accordion",
+    "collapse",
+    "transcript"
+  ],
+  "exports": {
+    ".": "./index.js",
+    "./client": "./client.js"
+  },
+  "files": [
+    "index.js",
+    "client.js",
+    "cordis.patch.yml",
+    "README.md",
+    "LICENSE",
+    "scripts/install.sh",
+    "scripts/install.ps1",
+    "scripts/check.mjs"
+  ],
+  "dsh": {
+    "bundle": {
+      "patch": "./cordis.patch.yml"
+    },
+    "client": {
+      "platform": "web",
+      "immediately": true,
+      "inject": []
+    }
+  },
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/ayuanxx-max/dsh-session-accordion.git"
+  },
+  "homepage": "https://github.com/ayuanxx-max/dsh-session-accordion#readme",
+  "bugs": {
+    "url": "https://github.com/ayuanxx-max/dsh-session-accordion/issues"
+  },
+  "engines": {
+    "node": ">=18"
+  },
+  "publishConfig": {
+    "access": "public"
+  }
+}

package/scripts/check.mjs

@@ -0,0 +1,79 @@
+// Cross-platform manifest sanity check, run by CI on Linux, macOS and Windows.
+// Fails on Windows-only assumptions (CRLF text, bad casing, missing files) so a
+// Linux checkout cannot silently break.
+import fs from 'node:fs';
+import path from 'node:path';
+import process from 'node:process';
+
+const root = process.cwd();
+const fail = [];
+const ok = [];
+const read = (rel) => fs.readFileSync(path.join(root, rel), 'utf8');
+const exists = (rel) => fs.existsSync(path.join(root, rel));
+
+const pkg = JSON.parse(read('package.json'));
+
+// 1. Package identity (marketplaces require kebab-case).
+if (!/^[a-z0-9]+(-[a-z0-9]+)*$/.test(pkg.name)) fail.push(`package name is not kebab-case: ${pkg.name}`);
+else ok.push(`name ${pkg.name}`);
+
+if (!/^\d+\.\d+\.\d+$/.test(pkg.version)) fail.push(`version is not semver: ${pkg.version}`);
+else ok.push(`version ${pkg.version}`);
+
+// 2. Declared files must exist with exact casing (Linux is case-sensitive).
+for (const rel of pkg.files || []) {
+  const hit = fs.existsSync(path.join(root, rel));
+  if (!hit) fail.push(`files[] entry missing: ${rel}`);
+}
+ok.push(`files[] entries ${pkg.files.length}`);
+
+// 3. Entry points resolve.
+const exportsMap = pkg.exports || {};
+for (const [key, target] of Object.entries(exportsMap)) {
+  const rel = String(target).replace(/^\.\//, '');
+  if (!exists(rel)) fail.push(`export "${key}" points at a missing file: ${rel}`);
+}
+if (!exportsMap['./client']) fail.push('missing "./client" export (the dsh client half)');
+else ok.push('client export');
+
+// 4. dsh bundle + client manifest.
+const patch = pkg.dsh?.bundle?.patch;
+if (!patch) fail.push('dsh.bundle.patch is not declared');
+else if (!exists(patch)) fail.push(`dsh.bundle.patch points at a missing file: ${patch}`);
+else ok.push(`bundle patch ${patch}`);
+
+if (pkg.dsh?.client?.platform !== 'web') fail.push('dsh.client.platform must be "web"');
+else ok.push('client platform web');
+
+// 5. Text files must be LF + BOM-free so a Linux checkout and the npm tarball
+//    behave the same as the Windows worktree.
+const textFiles = ['client.js', 'index.js', 'cordis.patch.yml', 'package.json', 'README.md', 'LICENSE', 'scripts/install.sh'];
+for (const rel of textFiles) {
+  if (!exists(rel)) continue;
+  const buf = fs.readFileSync(path.join(root, rel));
+  if (buf[0] === 0xef && buf[1] === 0xbb && buf[2] === 0xbf) fail.push(`BOM found: ${rel}`);
+  const crlf = buf.indexOf(Buffer.from('\r\n'));
+  if (crlf !== -1 && !rel.endsWith('.ps1')) fail.push(`CRLF found in ${rel} (expected LF)`);
+}
+ok.push(`checked ${textFiles.length} text files for BOM/CRLF`);
+
+// 6. No Windows-absolute paths leaked into machine-readable files.
+for (const rel of ['package.json', 'cordis.patch.yml', 'client.js', 'index.js']) {
+  if (!exists(rel)) continue;
+  if (/[A-Za-z]:\\\\|[A-Za-z]:\\/.test(read(rel))) fail.push(`Windows absolute path in ${rel}`);
+}
+ok.push('no Windows absolute paths');
+
+// 7. POSIX installer must exist and use an absolute symlink target variable.
+const sh = exists('scripts/install.sh') ? read('scripts/install.sh') : '';
+if (!sh) fail.push('scripts/install.sh is missing');
+else if (!sh.includes('ln -sfn')) fail.push('scripts/install.sh does not create a symlink');
+else ok.push('posix installer present');
+
+for (const line of ok) console.log(`ok   ${line}`);
+for (const line of fail) console.error(`FAIL ${line}`);
+if (fail.length) {
+  console.error(`\n${fail.length} problem(s)`);
+  process.exit(1);
+}
+console.log('\nmanifest OK');

package/scripts/install.ps1

@@ -0,0 +1,70 @@
+# dsh-session-accordion - Windows installer (PowerShell 5.1+ / 7+).
+#
+# Usage:
+#   powershell -ExecutionPolicy Bypass -File scripts\install.ps1 [-Profile <name>] [-DryRun] [-Apply]
+#
+# Creates a junction in <profile>\node_modules and, with -Apply, patches the
+# profile package.json (a backup is written first). Never copies the repo.
+
+[CmdletBinding()]
+param(
+  [string]$Profile = $env:DSH_PROFILE,
+  [switch]$DryRun,
+  [switch]$Apply
+)
+
+$ErrorActionPreference = 'Stop'
+$repo = (Resolve-Path (Join-Path $PSScriptRoot '..')).Path
+$dshHome = if ($env:DSH_HOME) { $env:DSH_HOME } else { Join-Path $env:USERPROFILE '.dsh' }
+$pkgName = 'dsh-session-accordion'
+
+if (-not $Profile) {
+  if (Test-Path (Join-Path $dshHome 'profiles\desktop')) { $Profile = 'desktop' }
+  elseif (Test-Path (Join-Path $dshHome 'profiles\web')) { $Profile = 'web' }
+  else { throw "cannot detect a DSH profile under $dshHome\profiles; pass -Profile <name>" }
+}
+
+$profileDir = Join-Path $dshHome "profiles\$Profile"
+$pkgJson = Join-Path $profileDir 'package.json'
+$nodeModules = Join-Path $profileDir 'node_modules'
+$link = Join-Path $nodeModules $pkgName
+
+if (-not (Test-Path $profileDir)) { throw "profile not found: $profileDir" }
+if (-not (Test-Path $pkgJson)) { throw "package.json not found: $pkgJson" }
+
+Write-Output "repo    : $repo"
+Write-Output "profile : $Profile ($profileDir)"
+Write-Output "link    : $link"
+
+if ($DryRun) { Write-Output '-DryRun: nothing was changed'; return }
+
+if (-not (Test-Path $nodeModules)) { New-Item -ItemType Directory -Path $nodeModules | Out-Null }
+if (Test-Path $link) { Remove-Item $link -Recurse -Force }
+New-Item -ItemType Junction -Path $link -Target $repo | Out-Null
+Write-Output 'junction created'
+
+if ($Apply) {
+  Copy-Item $pkgJson "$pkgJson.bak-before-accordion" -Force
+  $data = Get-Content $pkgJson -Raw | ConvertFrom-Json
+  if (-not $data.dependencies) { $data | Add-Member -NotePropertyName dependencies -NotePropertyValue ([pscustomobject]@{}) }
+  $data.dependencies | Add-Member -NotePropertyName $pkgName -NotePropertyValue ("link:" + $repo) -Force
+  if (-not $data.dsh) { $data | Add-Member -NotePropertyName dsh -NotePropertyValue ([pscustomobject]@{}) }
+  if (-not $data.dsh.profile) { $data.dsh | Add-Member -NotePropertyName profile -NotePropertyValue ([pscustomobject]@{}) }
+  $bundles = @($data.dsh.profile.bundles) | Where-Object { $_ -and $_ -ne $pkgName }
+  $data.dsh.profile | Add-Member -NotePropertyName bundles -NotePropertyValue (@($bundles) + $pkgName) -Force
+  $json = $data | ConvertTo-Json -Depth 20
+  # UTF-8 without BOM: a BOM makes package.json unreadable for node/pnpm on Linux and macOS.
+  [IO.File]::WriteAllText($pkgJson, $json + "`n", (New-Object System.Text.UTF8Encoding($false)))
+  Write-Output "package.json patched (backup: $pkgJson.bak-before-accordion)"
+}
+
+Write-Output @"
+
+Next steps:
+  1. If -Apply was not used, add to the profile package.json:
+       dependencies:       "dsh-session-accordion": "link:<repo path>"
+       dsh.profile.bundles: "dsh-session-accordion"
+  2. Restart DSH completely.
+  3. Settings -> Chat -> "When to collapse work details" = On completion.
+  4. DevTools -> __acReport() for diagnostics.
+"@

package/scripts/install.sh

@@ -0,0 +1,95 @@
+#!/usr/bin/env bash
+# dsh-session-accordion — POSIX installer (Linux / macOS).
+#
+# Usage:
+#   bash scripts/install.sh [--profile <name>] [--dry-run] [--apply]
+#
+#   --profile <name>  DSH profile to install into. Default: $DSH_PROFILE,
+#                     else "web" when that profile exists, else "desktop".
+#   --dry-run         Print what would happen, change nothing.
+#   --apply           Also patch the profile package.json (needs `node`).
+#
+# The script only creates a symlink in <profile>/node_modules; it never copies
+# the repository, so `git pull` + a DSH restart is enough to upgrade.
+set -euo pipefail
+
+REPO="$(cd "$(dirname "${BASH_SOURCE[0]}")/.." && pwd)"
+DSH_HOME="${DSH_HOME:-$HOME/.dsh}"
+PROFILE="${DSH_PROFILE:-}"
+DRY_RUN=0
+APPLY=0
+PKG_NAME="dsh-session-accordion"
+
+while [ $# -gt 0 ]; do
+  case "$1" in
+    --profile) PROFILE="${2:-}"; shift 2 ;;
+    --dry-run) DRY_RUN=1; shift ;;
+    --apply) APPLY=1; shift ;;
+    -h|--help) sed -n '2,16p' "$0"; exit 0 ;;
+    *) echo "unknown argument: $1" >&2; exit 2 ;;
+  esac
+done
+
+if [ -z "$PROFILE" ]; then
+  if [ -d "$DSH_HOME/profiles/web" ]; then PROFILE="web"
+  elif [ -d "$DSH_HOME/profiles/desktop" ]; then PROFILE="desktop"
+  else echo "cannot detect a DSH profile under $DSH_HOME/profiles; pass --profile <name>" >&2; exit 1
+  fi
+fi
+
+PROFILE_DIR="$DSH_HOME/profiles/$PROFILE"
+PKG_JSON="$PROFILE_DIR/package.json"
+LINK="$PROFILE_DIR/node_modules/$PKG_NAME"
+
+[ -d "$PROFILE_DIR" ] || { echo "profile not found: $PROFILE_DIR" >&2; exit 1; }
+[ -f "$PKG_JSON" ] || { echo "package.json not found: $PKG_JSON" >&2; exit 1; }
+
+echo "repo    : $REPO"
+echo "profile : $PROFILE ($PROFILE_DIR)"
+echo "link    : $LINK"
+
+if [ "$DRY_RUN" = "1" ]; then
+  echo "--dry-run: nothing was changed"
+  exit 0
+fi
+
+mkdir -p "$PROFILE_DIR/node_modules"
+if [ -L "$LINK" ] || [ -e "$LINK" ]; then
+  echo "replacing existing $LINK"
+  rm -rf "$LINK"
+fi
+ln -sfn "$REPO" "$LINK"
+echo "symlink created"
+
+if [ "$APPLY" = "1" ]; then
+  if ! command -v node >/dev/null 2>&1; then
+    echo "warning: node not found on PATH; patch $PKG_JSON by hand (see notes below)" >&2
+  else
+    cp "$PKG_JSON" "$PKG_JSON.bak-before-accordion"
+    node - "$PKG_JSON" "$REPO" "$PKG_NAME" <<'NODE'
+const fs = require('fs');
+const [file, repo, name] = process.argv.slice(2);
+const pkg = JSON.parse(fs.readFileSync(file, 'utf8'));
+pkg.dependencies = pkg.dependencies || {};
+pkg.dependencies[name] = 'link:' + repo;
+pkg.dsh = pkg.dsh || {};
+pkg.dsh.profile = pkg.dsh.profile || {};
+const bundles = new Set(pkg.dsh.profile.bundles || []);
+bundles.add(name);
+pkg.dsh.profile.bundles = Array.from(bundles);
+fs.writeFileSync(file, JSON.stringify(pkg, null, 2) + '\n', 'utf8');
+console.log('package.json patched (backup: ' + file + '.bak-before-accordion)');
+NODE
+  fi
+fi
+
+cat <<'NOTE'
+
+Next steps:
+  1. Add the bundle to the profile when --apply was not used:
+       dependencies:      "dsh-session-accordion": "link:<repo path>"
+       dsh.profile.bundles: "dsh-session-accordion"
+  2. Restart DSH completely (profile-layer change; refreshing the page is not enough).
+  3. Settings -> Chat -> "When to collapse work details" = On completion.
+  4. Diagnostics: open DevTools and run __acReport().
+NOTE