@yadsh/dsh-draft-sessions 0.2.0

package/LICENSE

@@ -0,0 +1,22 @@
+MIT License
+
+Copyright (c) 2026 dsh-draft-sessions contributors
+
+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,207 @@
+# dsh-draft-sessions
+
+[![CI](https://github.com/xarleyn/dsh-plugins/actions/workflows/ci.yml/badge.svg)](https://github.com/xarleyn/dsh-plugins/actions/workflows/ci.yml)
+[![npm version](https://img.shields.io/npm/v/%40yadsh%2Fdsh-draft-sessions.svg)](https://www.npmjs.com/package/@yadsh/dsh-draft-sessions)
+[![npm downloads](https://img.shields.io/npm/dm/%40yadsh%2Fdsh-draft-sessions.svg)](https://www.npmjs.com/package/@yadsh/dsh-draft-sessions)
+[![Node.js](https://img.shields.io/node/v/%40yadsh%2Fdsh-draft-sessions.svg)](package.json)
+[![License: MIT](https://img.shields.io/badge/license-MIT-blue.svg)](LICENSE)
+
+Persistent, unsent future conversations for [DeepSeek Harness](https://github.com/deepseek-ai/deepseek-harness).
+
+`dsh-draft-sessions` is building the Cursor-like workflow where you can prepare several independent tasks, leave them unsent, and return to each task later without starting an agent.
+
+[Русский](README.ru.md) · [简体中文](README.zh-CN.md) · [Specification](SPEC.md) · [Architecture](docs/architecture.md) · [Roadmap](ROADMAP.md)
+
+## See it in action
+
+### With `@michengai/dsh-automation`
+
+Automation provides the optional cooperative tab host. When it is installed and active, Draft Sessions detects `__dshNativeTabs@1` and inserts `Drafts` between `Tasks` and `Scheduled`. There is no hard dependency on Automation and no load-order requirement.
+
+<p align="center">
+  <img src="docs/images/draft-sessions-hero.png" alt="Three independent draft sessions in a cooperative DeepSeek Harness sidebar tab" />
+</p>
+
+<p align="center"><em>With Automation installed, unsent tasks live in their own Drafts tab while Tasks and Scheduled keep their existing views.</em></p>
+
+### On stock DeepSeek Harness
+
+Without Automation or another compatible tab host, the standard workspace and session browser stays unchanged. Draft Sessions adds a footer action instead; clicking it opens the same draft list in a popover.
+
+<p align="center">
+  <img src="docs/images/draft-sessions-stock-fallback.jpg" alt="Draft Sessions footer action and popover on stock DeepSeek Harness" />
+</p>
+
+<p align="center"><em>The fallback uses the public sidebar footer slot and does not replace the stock workspace browser.</em></p>
+
+### Draft actions
+
+<p align="center">
+  <img src="docs/images/draft-sessions-actions.png" width="360" alt="Draft session actions rendered above the sidebar without clipping or extra scrolling" />
+</p>
+
+<p align="center"><em>Create a distinct draft with <code>+</code>, then rename, duplicate, or delete it from the row menu.</em></p>
+
+## Installation
+
+Install the published npm package by name:
+
+```bash
+dsh plugin --profile web add @yadsh/dsh-draft-sessions
+```
+
+Or build and install the package from a local monorepo checkout:
+
+```bash
+pnpm --filter @yadsh/dsh-draft-sessions build
+dsh plugin --profile web add ./plugins/dsh-draft-sessions
+```
+
+The published npm package is recommended when you do not need to modify the source.
+
+To remove the plugin:
+
+```bash
+dsh plugin --profile web remove @yadsh/dsh-draft-sessions
+```
+
+## The intended experience
+
+The original goal was to reproduce Cursor's inline draft experience: unsent tasks and ordinary sessions living together in one workspace tree.
+
+```text
+my-project
+├─ ● Fix auth middleware
+├─ ◌ Add Grafana dashboards       Draft
+├─ ◌ Refactor docker entrypoint   Draft
+└─ ● Implement notifications
+```
+
+That exact layout could not be reproduced through DSH's current public sidebar APIs without replacing the stock workspace browser. Draft Sessions keeps the important behavior—independent unsent tasks, exact text restoration, and conversion on the first accepted prompt—but exposes drafts in a cooperative `Drafts` tab when one is available, or through the stock sidebar footer popover otherwise.
+
+Each draft owns a real blank DSH Session, but its unsent text is stored separately on the Host. If that blank Session disappears after a restart, a new shell can be created and rebound without losing the task.
+
+```mermaid
+flowchart LR
+  UI["Sidebar draft row"] --> Composer["Standard DSH composer"]
+  Composer --> Draft["DraftRecord — text authority"]
+  Draft --> Session["Real blank DSH Session"]
+  Session -->|"first prompt accepted"| Normal["Normal DSH Session"]
+```
+
+## What works now
+
+- Host-backed JSON persistence under `$DSH_HOME/storages/dsh-draft-sessions/drafts.json`.
+- Strict typed `draftSessions.list/create/update/delete/rebind` Remote methods.
+- Independent workspace ordering and a configurable per-workspace limit.
+- Optimistic revisions that reject stale browser writes.
+- Atomic same-directory writes and strict durable-file validation.
+- Distinct blank Session creation with the id persisted only after success.
+- Missing Session detection and recovery rebinding without changing draft text.
+- Accepted-Send observation with finalization only after `blank: false`.
+- Rejected Send and blank slash-command preservation.
+- Exact composer restore through the official per-session InputHub facade.
+- Debounced optimistic autosave with a mandatory pre-switch flush.
+- Draft creation from the Drafts `+` action or `Ctrl/Cmd + Shift + N`; both flush the active draft before opening a distinct one.
+- A cooperative `Drafts` tab when the active sidebar host exposes `__dshNativeTabs@1`.
+- A stock `sidebar.footer.action` trigger and popover when the tab protocol is absent.
+- Portaled row menus, inline rename, duplicate, confirmed delete, keyboard navigation, and bounded drag reorder.
+- Safe active-draft deletion with a final autosave flush and recovery after a rejected delete.
+- Optional native-tab session filtering that hides draft shells without changing ordinary Sessions.
+- No registration in the single-slot `sidebar.workspaces`; stock UI, Archive Manager, and other browser owners keep full control.
+- Unit and DOM coverage for persistence, concurrency, lifecycle, composer, and sidebar behavior.
+
+The current implementation deliberately does not send prompts, modify ordinary Session history, or delete blank Sessions.
+
+## Requirements
+
+- Node.js `^22.19.0` or `>=24.0.0`
+- pnpm 10.4.1 for development
+- DeepSeek Harness `>=0.1.1-rc.2 <0.2.0` with the public `sidebar.footer.action` list slot
+
+The published rc.2 client is supported without patches. Sidebar tab hosts are detected through the optional versioned `__dshNativeTabs@1` cooperation protocol; the plugin falls back to the stock footer action instead of replacing the workspace browser.
+
+## Development
+
+From the monorepo root:
+
+```bash
+pnpm install --frozen-lockfile
+pnpm --filter @yadsh/dsh-draft-sessions check
+```
+
+Build and link the checkout into a Web profile:
+
+```bash
+pnpm --filter @yadsh/dsh-draft-sessions build
+dsh plugin --profile web add ./plugins/dsh-draft-sessions
+dsh --profile web --dump-config
+```
+
+## Releases
+
+This package uses independent Nx Version Plans from the monorepo. Add a plan with `pnpm release:plan`; maintainers publish verified tarballs through the shared [release workflow](../../docs/RELEASING.md).
+
+## Configuration
+
+The bundle inserts the `dsh-draft-sessions` Cordis row. Override it from the profile patch when needed:
+
+```yaml
+- id: dsh-draft-sessions
+  config:
+    # Blank uses $DSH_HOME/storages/dsh-draft-sessions/drafts.json
+    storagePath: ""
+    maxDraftsPerWorkspace: 50
+```
+
+## Current API
+
+```ts
+await ctx.remote.draftSessions.list({ workspaceId });
+
+await ctx.draftSessionLifecycle.create({
+  workspaceId,
+  text: "",
+});
+
+await ctx.draftSessionLifecycle.ensureShell(draft);
+
+await ctx.draftComposerBridge.open(draft);
+await ctx.draftComposerBridge.flush();
+
+await ctx.draftShortcutController.create(workspaceId);
+
+await ctx.remote.draftSessions.update({
+  id,
+  expectedRevision: 4,
+  text: "Add OTEL export",
+});
+
+await ctx.remote.draftSessions.rebind({
+  id,
+  expectedRevision: 5,
+  sessionId: replacementSessionId,
+});
+```
+
+The lifecycle service owns blank Session creation and recovery. The lower-level Remote methods remain available for storage operations; all mutations return the next `revision`, and a stale `expectedRevision` is rejected instead of silently overwriting another browser's edit.
+
+## Design boundaries
+
+- Draft text is authoritative in `DraftStore`; a blank Session is only an execution shell.
+- Creating a draft must never make a model request.
+- The first accepted prompt, not the Send button click, is the conversion boundary.
+- Ordinary DSH Sessions remain owned entirely by DSH.
+- Attachments are out of scope for v1; text and textual `@file` references come first.
+- Draft rows compose beside the single workspace-browser occupant; the plugin never disables or embeds `ui-workspace`.
+- Backing blank Sessions are excluded only from the workspace-browser slot, so the standard composer still receives the real current Session.
+
+See [SPEC.md](SPEC.md) for acceptance criteria and [docs/architecture.md](docs/architecture.md) for the lifecycle.
+
+## Contributing
+
+Issues and focused pull requests are welcome. Read [CONTRIBUTING.md](CONTRIBUTING.md) and run the package check before submitting a change.
+
+## License
+
+[MIT](LICENSE). This is an independent community project and is not affiliated with or endorsed by DeepSeek.

package/README.ru.md

@@ -0,0 +1,192 @@
+# dsh-draft-sessions
+
+[![CI](https://github.com/xarleyn/dsh-plugins/actions/workflows/ci.yml/badge.svg)](https://github.com/xarleyn/dsh-plugins/actions/workflows/ci.yml)
+[![npm version](https://img.shields.io/npm/v/%40yadsh%2Fdsh-draft-sessions.svg)](https://www.npmjs.com/package/@yadsh/dsh-draft-sessions)
+[![npm downloads](https://img.shields.io/npm/dm/%40yadsh%2Fdsh-draft-sessions.svg)](https://www.npmjs.com/package/@yadsh/dsh-draft-sessions)
+[![Node.js](https://img.shields.io/node/v/%40yadsh%2Fdsh-draft-sessions.svg)](package.json)
+[![License: MIT](https://img.shields.io/badge/license-MIT-blue.svg)](LICENSE)
+
+Постоянные неотправленные будущие диалоги для [DeepSeek Harness](https://github.com/deepseek-ai/deepseek-harness).
+
+Цель плагина — дать привычный по Cursor UX: можно подготовить несколько независимых задач, уйти из них без отправки и позже продолжить каждую с сохранённым текстом.
+
+[English](README.md) · [简体中文](README.zh-CN.md) · [Спецификация](SPEC.md) · [Архитектура](docs/architecture.md) · [План](ROADMAP.md)
+
+## Как это выглядит
+
+### С `@michengai/dsh-automation`
+
+Automation предоставляет опциональный host для совместных вкладок. Когда плагин установлен и активен, Draft Sessions обнаруживает `__dshNativeTabs@1` и добавляет `Drafts` между `Tasks` и `Scheduled`. Жёсткой зависимости от Automation и требований к порядку загрузки нет.
+
+<p align="center">
+  <img src="docs/images/draft-sessions-hero.png" alt="Три независимых черновика в отдельной вкладке DeepSeek Harness" />
+</p>
+
+### На штатном DeepSeek Harness
+
+Без Automation или другого совместимого tab host штатный browser workspaces и sessions остаётся без изменений. Draft Sessions добавляет кнопку в footer; по нажатию тот же список черновиков открывается в popover.
+
+<p align="center">
+  <img src="docs/images/draft-sessions-stock-fallback.jpg" alt="Кнопка Draft Sessions и popover на штатном DeepSeek Harness" />
+</p>
+
+Меню строки работает одинаково в обоих режимах и отображается поверх sidebar без дополнительного скролла:
+
+<p align="center">
+  <img src="docs/images/draft-sessions-actions.png" width="360" alt="Действия с черновиком поверх sidebar без обрезки и дополнительного скролла" />
+</p>
+
+## Установка
+
+Установка опубликованного npm-пакета по имени:
+
+```bash
+dsh plugin --profile web add @yadsh/dsh-draft-sessions
+```
+
+Или сборка и установка пакета из локального checkout монорепозитория:
+
+```bash
+pnpm --filter @yadsh/dsh-draft-sessions build
+dsh plugin --profile web add ./plugins/dsh-draft-sessions
+```
+
+Если изменять исходный код не требуется, рекомендуется опубликованный npm-пакет.
+
+Удаление плагина:
+
+```bash
+dsh plugin --profile web remove @yadsh/dsh-draft-sessions
+```
+
+## Задуманный сценарий
+
+Изначальная цель — полностью повторить inline-черновики Cursor, где неотправленные задачи и обычные sessions находятся в одном дереве workspace.
+
+```text
+my-project
+├─ ● Fix auth middleware
+├─ ◌ Add Grafana dashboards       Draft
+├─ ◌ Refactor docker entrypoint   Draft
+└─ ● Implement notifications
+```
+
+Точно повторить эту компоновку через текущие публичные sidebar API DSH не удалось без замены штатного workspace browser. Поэтому Draft Sessions сохраняет главное поведение — независимые неотправленные задачи, точное восстановление текста и превращение в обычную Session после первого принятого prompt, — но показывает черновики в совместной вкладке `Drafts`, если она доступна, или в popover штатного sidebar footer.
+
+Каждый draft связан с реальной blank Session DSH, а его неотправленный текст отдельно хранится на Host. Если blank Session исчезнет после перезапуска, плагин создаст новую оболочку и привяжет её к черновику без потери текста.
+
+## Что уже реализовано
+
+- Host-backed JSON-хранилище в `$DSH_HOME/storages/dsh-draft-sessions/drafts.json`.
+- Строгие Remote-методы `draftSessions.list/create/update/delete/rebind`.
+- Независимый порядок в workspace и настраиваемый лимит.
+- Optimistic revision: устаревшая запись из второго браузера не затирает свежую.
+- Атомарная запись файла и строгая проверка данных при загрузке.
+- Создание отдельной blank Session с сохранением id только после успеха.
+- Обнаружение исчезнувшей Session и recovery через замену без потери текста.
+- Финализация только после принятого Send и подтверждённого `blank: false`.
+- Сохранение draft при отклонённом Send и blank slash-командах.
+- Точное восстановление текста через официальный per-session InputHub.
+- Debounced optimistic autosave с обязательным flush перед переключением.
+- Создание через `+` в секции Drafts или `Ctrl/Cmd + Shift + N`; оба действия сначала сохраняют активный draft, затем открывают отдельный новый.
+- Отдельная вкладка `Drafts`, когда активный sidebar host предоставляет протокол `__dshNativeTabs@1`.
+- Штатная кнопка и popover через `sidebar.footer.action`, когда протокола вкладок нет.
+- Вынесенные поверх панелей row-меню, inline rename, duplicate, подтверждаемое удаление, клавиатурная навигация и ограниченный drag reorder.
+- Безопасное удаление активного draft с финальным autosave flush и восстановлением после отказа.
+- Опциональная фильтрация backing shell через протокол вкладок без изменения обычных Sessions.
+- Плагин не регистрируется в single-slot `sidebar.workspaces`; штатный browser, Archive Manager и другие владельцы сохраняют полный контроль.
+- Unit- и DOM-тесты persistence, concurrency, lifecycle, composer и sidebar.
+
+Текущий код не отправляет prompt, не изменяет историю обычных Sessions и не удаляет blank Sessions.
+
+## Требования
+
+- Node.js `^22.19.0` или `>=24.0.0`
+- pnpm 10.4.1 для разработки
+- DeepSeek Harness `>=0.1.1-rc.2 <0.2.0` с публичным list-slot `sidebar.footer.action`
+
+Опубликованный клиент rc.2 поддерживается без патчей. Sidebar host с вкладками определяется через опциональный версионированный протокол `__dshNativeTabs@1`; если его нет, плагин использует штатный footer action и не заменяет workspace browser.
+
+## Локальная разработка
+
+Из корня монорепозитория:
+
+```bash
+pnpm install --frozen-lockfile
+pnpm --filter @yadsh/dsh-draft-sessions check
+```
+
+Сборка и подключение checkout к Web profile:
+
+```bash
+pnpm --filter @yadsh/dsh-draft-sessions build
+dsh plugin --profile web add ./plugins/dsh-draft-sessions
+dsh --profile web --dump-config
+```
+
+## Релизы
+
+Пакет использует независимые Nx Version Plans монорепозитория. План добавляется командой `pnpm release:plan`; maintainers публикуют проверенные tarball через общий [release workflow](../../docs/RELEASING.md).
+
+## Настройки
+
+```yaml
+- id: dsh-draft-sessions
+  config:
+    storagePath: ""
+    maxDraftsPerWorkspace: 50
+```
+
+Пустой `storagePath` означает стандартный файл внутри `$DSH_HOME`.
+
+## Текущий API
+
+```ts
+await ctx.remote.draftSessions.list({ workspaceId });
+
+await ctx.draftSessionLifecycle.create({
+  workspaceId,
+  text: "",
+});
+
+await ctx.draftSessionLifecycle.ensureShell(draft);
+
+await ctx.draftComposerBridge.open(draft);
+await ctx.draftComposerBridge.flush();
+
+await ctx.draftShortcutController.create(workspaceId);
+
+await ctx.remote.draftSessions.update({
+  id,
+  expectedRevision: 4,
+  text: "Add OTEL export",
+});
+
+await ctx.remote.draftSessions.rebind({
+  id,
+  expectedRevision: 5,
+  sessionId: replacementSessionId,
+});
+```
+
+Lifecycle service отвечает за создание и восстановление оболочки blank Session. Низкоуровневые Remote-методы остаются доступны для операций с хранилищем; каждая mutation возвращает следующую `revision`, а устаревшая `expectedRevision` отклоняется вместо тихого перезаписывания правок из другого browser.
+
+## Главные границы дизайна
+
+- Источник истины для неотправленного текста — `DraftStore`.
+- Реальная blank Session служит execution shell для model/preset/permissions UI.
+- Создание draft никогда не запускает модель.
+- Draft превращается в обычную Session только после принятого первого prompt.
+- Attachments отложены до v2.
+- Draft-строки композируются рядом с single workspace-browser occupant; плагин не отключает и не встраивает `ui-workspace`.
+- Backing blank Sessions исключаются только из slot workspace browser, поэтому стандартный composer по-прежнему получает настоящую текущую Session.
+
+Полные критерии находятся в [SPEC.md](SPEC.md), последовательность следующих этапов — в [ROADMAP.md](ROADMAP.md).
+
+## Участие в разработке
+
+Issues и небольшие сфокусированные pull requests приветствуются. Перед отправкой изменений прочитайте [CONTRIBUTING.md](CONTRIBUTING.md) и запустите package check.
+
+## Лицензия
+
+[MIT](LICENSE). Это независимый community-проект, не связанный с DeepSeek и не одобренный компанией.

package/README.zh-CN.md

@@ -0,0 +1,207 @@
+# dsh-draft-sessions
+
+[![CI](https://github.com/xarleyn/dsh-plugins/actions/workflows/ci.yml/badge.svg)](https://github.com/xarleyn/dsh-plugins/actions/workflows/ci.yml)
+[![npm version](https://img.shields.io/npm/v/%40yadsh%2Fdsh-draft-sessions.svg)](https://www.npmjs.com/package/@yadsh/dsh-draft-sessions)
+[![npm downloads](https://img.shields.io/npm/dm/%40yadsh%2Fdsh-draft-sessions.svg)](https://www.npmjs.com/package/@yadsh/dsh-draft-sessions)
+[![Node.js](https://img.shields.io/node/v/%40yadsh%2Fdsh-draft-sessions.svg)](package.json)
+[![License: MIT](https://img.shields.io/badge/license-MIT-blue.svg)](LICENSE)
+
+为 [DeepSeek Harness](https://github.com/deepseek-ai/deepseek-harness) 提供可持久保存、尚未发送的未来对话。
+
+`dsh-draft-sessions` 致力于实现类似 Cursor 的工作流：你可以准备多个彼此独立的任务，暂时离开而不发送，并在之后回来继续编辑，而不会启动 agent。
+
+[English](README.md) · [Русский](README.ru.md) · [规范](SPEC.md) · [架构](docs/architecture.md) · [路线图](ROADMAP.md)
+
+## 效果展示
+
+### 搭配 `@michengai/dsh-automation`
+
+Automation 可作为可选的协作式标签页宿主。安装并启用后，Draft Sessions 会检测 `__dshNativeTabs@1`，并在 `Tasks` 与 `Scheduled` 之间插入 `Drafts`。Draft Sessions 不强制依赖 Automation，也不要求特定的加载顺序。
+
+<p align="center">
+  <img src="docs/images/draft-sessions-hero.png" alt="DeepSeek Harness 协作式侧边栏标签页中的三个独立草稿会话" />
+</p>
+
+<p align="center"><em>安装 Automation 后，未发送的任务会显示在独立的 Drafts 标签页中，Tasks 和 Scheduled 保持各自原有的视图。</em></p>
+
+### 原生 DeepSeek Harness
+
+如果没有 Automation 或其他兼容的标签页宿主，标准 workspace 和 session 浏览器不会改变。Draft Sessions 会在底部添加一个操作入口；点击后，同一个草稿列表会在浮层中打开。
+
+<p align="center">
+  <img src="docs/images/draft-sessions-stock-fallback.jpg" alt="原生 DeepSeek Harness 中的 Draft Sessions 底部入口和浮层" />
+</p>
+
+<p align="center"><em>该回退模式使用公开的侧边栏底部插槽，不会替换原生 workspace 浏览器。</em></p>
+
+### 草稿操作
+
+<p align="center">
+  <img src="docs/images/draft-sessions-actions.png" width="360" alt="显示在侧边栏上方且不会被裁剪或引入额外滚动的草稿会话操作" />
+</p>
+
+<p align="center"><em>使用 <code>+</code> 创建独立草稿，然后通过行菜单重命名、复制或删除。</em></p>
+
+## 安装
+
+按名称安装已发布的 npm 包：
+
+```bash
+dsh plugin --profile web add @yadsh/dsh-draft-sessions
+```
+
+或者从本地 monorepo checkout 构建并安装：
+
+```bash
+pnpm --filter @yadsh/dsh-draft-sessions build
+dsh plugin --profile web add ./plugins/dsh-draft-sessions
+```
+
+如果不需要修改源码，建议使用已发布的 npm 包。
+
+卸载插件：
+
+```bash
+dsh plugin --profile web remove @yadsh/dsh-draft-sessions
+```
+
+## 预期体验
+
+最初的目标是完整复现 Cursor 的行内草稿体验：未发送的任务与普通 session 一起显示在同一个 workspace 树中。
+
+```text
+my-project
+├─ ● Fix auth middleware
+├─ ◌ Add Grafana dashboards       Draft
+├─ ◌ Refactor docker entrypoint   Draft
+└─ ● Implement notifications
+```
+
+通过 DSH 当前公开的侧边栏 API，无法在不替换原生 workspace 浏览器的前提下完全复现这一布局。Draft Sessions 保留了最重要的行为——彼此独立的未发送任务、准确恢复文本，以及在第一个 prompt 被接受后转换为普通 Session——但会在可用时把草稿显示在协作式 `Drafts` 标签页中，否则通过原生侧边栏底部浮层显示。
+
+每个草稿都拥有一个真实的空白 DSH Session，但未发送的文本会单独存储在 Host 上。如果该空白 Session 在重启后消失，插件可以创建新的外壳并重新绑定，而不会丢失任务文本。
+
+```mermaid
+flowchart LR
+  UI["侧边栏草稿行"] --> Composer["标准 DSH 编辑器"]
+  Composer --> Draft["DraftRecord — 文本权威来源"]
+  Draft --> Session["真实的空白 DSH Session"]
+  Session -->|"第一个 prompt 被接受"| Normal["普通 DSH Session"]
+```
+
+## 当前功能
+
+- 在 `$DSH_HOME/storages/dsh-draft-sessions/drafts.json` 中使用 Host 端 JSON 持久化。
+- 严格类型化的 `draftSessions.list/create/update/delete/rebind` Remote 方法。
+- 各 workspace 独立排序，并支持配置每个 workspace 的数量上限。
+- 通过乐观 revision 拒绝来自其他浏览器的过期写入。
+- 同目录原子写入，并严格校验持久化文件。
+- 创建彼此独立的空白 Session，且仅在成功后保存其 id。
+- 检测丢失的 Session，并在不改变草稿文本的情况下恢复绑定。
+- 观察已接受的 Send，且仅在确认 `blank: false` 后完成草稿转换。
+- Send 被拒绝或执行空白 slash 命令时保留草稿。
+- 通过官方的 per-session InputHub facade 精确恢复编辑器内容。
+- 带防抖的乐观自动保存，切换前强制 flush。
+- 可通过 Drafts 中的 `+` 或 `Ctrl/Cmd + Shift + N` 创建草稿；两者都会先 flush 当前草稿，再打开一个新的独立草稿。
+- 当活动侧边栏宿主公开 `__dshNativeTabs@1` 时，提供协作式 `Drafts` 标签页。
+- 如果没有标签页协议，则提供原生 `sidebar.footer.action` 入口和浮层。
+- 行菜单通过 portal 显示，并支持行内重命名、复制、确认删除、键盘导航和受限拖拽排序。
+- 安全删除活动草稿：先完成最终自动保存，并在删除被拒绝时恢复。
+- 可选的原生标签页 session 过滤，可隐藏草稿外壳而不改变普通 Session。
+- 不注册到单插槽 `sidebar.workspaces`；原生 UI、Archive Manager 和其他浏览器所有者仍保留完整控制权。
+- persistence、concurrency、lifecycle、composer 和 sidebar 均有单元测试与 DOM 测试覆盖。
+
+当前实现不会主动发送 prompt、修改普通 Session 历史记录或删除空白 Session。
+
+## 要求
+
+- Node.js `^22.19.0` 或 `>=24.0.0`
+- pnpm 10.4.1（开发环境）
+- DeepSeek Harness `>=0.1.1-rc.2 <0.2.0`，并提供公开的 `sidebar.footer.action` 列表插槽
+
+已发布的 rc.2 客户端无需补丁即可支持。侧边栏标签页宿主通过可选且带版本的 `__dshNativeTabs@1` 协作协议检测；如果没有该协议，插件会回退到原生底部入口，而不会替换 workspace 浏览器。
+
+## 开发
+
+在 monorepo 根目录运行：
+
+```bash
+pnpm install --frozen-lockfile
+pnpm --filter @yadsh/dsh-draft-sessions check
+```
+
+构建项目并把当前 checkout 链接到 Web profile：
+
+```bash
+pnpm --filter @yadsh/dsh-draft-sessions build
+dsh plugin --profile web add ./plugins/dsh-draft-sessions
+dsh --profile web --dump-config
+```
+
+## 发布
+
+该包使用 monorepo 的独立 Nx Version Plans。通过 `pnpm release:plan` 添加计划；维护者通过共享的[发布流程](../../docs/RELEASING.md)发布已验证的 tarball。
+
+## 配置
+
+bundle 会插入 `dsh-draft-sessions` Cordis 配置行。需要时可在 profile patch 中覆盖：
+
+```yaml
+- id: dsh-draft-sessions
+  config:
+    # 留空时使用 $DSH_HOME/storages/dsh-draft-sessions/drafts.json
+    storagePath: ""
+    maxDraftsPerWorkspace: 50
+```
+
+## 当前 API
+
+```ts
+await ctx.remote.draftSessions.list({ workspaceId });
+
+await ctx.draftSessionLifecycle.create({
+  workspaceId,
+  text: "",
+});
+
+await ctx.draftSessionLifecycle.ensureShell(draft);
+
+await ctx.draftComposerBridge.open(draft);
+await ctx.draftComposerBridge.flush();
+
+await ctx.draftShortcutController.create(workspaceId);
+
+await ctx.remote.draftSessions.update({
+  id,
+  expectedRevision: 4,
+  text: "Add OTEL export",
+});
+
+await ctx.remote.draftSessions.rebind({
+  id,
+  expectedRevision: 5,
+  sessionId: replacementSessionId,
+});
+```
+
+lifecycle 服务负责创建与恢复空白 Session 外壳。底层 Remote 方法仍可用于存储操作；所有 mutation 都会返回新的 `revision`，过期的 `expectedRevision` 会被拒绝，而不会静默覆盖另一个浏览器中的编辑。
+
+## 设计边界
+
+- `DraftStore` 中的草稿文本是权威来源；空白 Session 只是执行外壳。
+- 创建草稿绝不能发起模型请求。
+- 转换边界是第一个 prompt 被接受，而不是点击 Send 按钮。
+- 普通 DSH Session 完全由 DSH 管理。
+- 附件不在 v1 范围内；优先支持文本和文本形式的 `@file` 引用。
+- 草稿行与单一 workspace-browser 占用者组合显示；插件不会禁用或嵌入 `ui-workspace`。
+- 支撑草稿的空白 Session 只会从 workspace-browser 插槽中排除，因此标准编辑器仍会收到真实的当前 Session。
+
+验收标准见 [SPEC.md](SPEC.md)，生命周期说明见 [docs/architecture.md](docs/architecture.md)。
+
+## 贡献
+
+欢迎提交 issue 和范围明确的 pull request。提交前请阅读 [CONTRIBUTING.md](CONTRIBUTING.md) 并运行 package check。
+
+## 许可证
+
+[MIT](LICENSE)。这是一个独立的社区项目，与 DeepSeek 无隶属关系，也未获得其官方认可。