dsh-output-styles 0.3.2 → 0.4.0

package/CHANGELOG.md

@@ -4,6 +4,21 @@ All notable changes to this project are documented in this file. The format
 follows [Keep a Changelog](https://keepachangelog.com/en/1.1.0/), and the
 project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
 
+## [0.4.0] - 2026-08-16
+
+### Added
+
+- **Renderer registry (`output.render.*` protocol)**: `ctx.outputRenderers` service with reversible `register()` / `list()` / `resolve()` / `renderText()`. A renderer is `{ id, match (tool/content-type), priority, presenter }` — the presenter is a pure function (args → display data, no DOM). Every render request passes the `output.render/before` waterfall first (listeners transform `{ text, context }` and must call `next()`), then the rule table, then matching renderers in priority order. Built-in renderers: `concise` and `step-by-step`.
+- **Per-session/per-tool style rules**: `rules: [{ match: { tool, contentType, session }, style, priority }]` in Config and the new `output-style-rules` settings section (validated at write time; unknown renderer ids fail loudly at render time).
+- **`/export` command**: renders the current session's message surface (official `deriveEventMessage` projection) to Markdown or sanitized HTML through the renderer pipeline — `/export [markdown|html] [--renderer=<id>]`. Every render keeps `{ original, rendered, rendererId, changed }`, so rendered output and its session-log source reconstruct together.
+- `sanitizeText` / `toMarkdown` / `toHtml` / `renderExport` pure functions with extreme-case coverage (tags, control characters, huge inputs).
+- Renderer protocol reference: `docs/renderer-protocol.md` (+ 中文).
+
+### Changed
+
+- `/style` command and per-session persistence are fully unchanged (0.3.x compatible).
+- Five-language READMEs: renderer protocol section, two new Config rows, `/export` reference; test count updated to 107.
+
 ## [0.3.2] - 2026-08-15
 
 ### Fixed

package/README.es.md

@@ -6,6 +6,8 @@
 
 [![License](https://img.shields.io/badge/license-Apache--2.0-blue.svg)](LICENSE)
 [![CI](https://github.com/PerryLink/dsh-output-styles/actions/workflows/ci.yml/badge.svg)](https://github.com/PerryLink/dsh-output-styles/actions/workflows/ci.yml)
+[![npm version](https://img.shields.io/npm/v/dsh-output-styles)](https://www.npmjs.com/package/dsh-output-styles)
+[![npm downloads](https://img.shields.io/npm/dm/dsh-output-styles)](https://www.npmjs.com/package/dsh-output-styles)
 [![Node](https://img.shields.io/badge/node-%5E22.19%20%7C%7C%20%3E%3D24-brightgreen.svg)](#)
 [![DSH](https://img.shields.io/badge/deepseek--harness-0.1.0--rc.6-4d6bfe.svg)](#)
 [![TypeScript](https://img.shields.io/badge/TypeScript-strict-3178c6.svg)](#)
@@ -107,7 +109,12 @@ Todo ajuste es un campo `Config` de Schemastery validado (los valores inválidos
 | `truncationMarker` | `"\n\n[style truncated]"` | Marcador añadido en el punto de truncado. |
 | `includeBuiltins` | `true` | Incluye el `styles/` incluido en el paquete como la capa de menor prioridad. |
 | `watchStyles` | `true` | Recarga la biblioteca cuando un archivo de estilo cambia en disco. |
+| `rules` | `[]` | Reglas de renderizado por sesión/herramienta: `[{ match: { tool?, contentType?, session? }, style, priority? }]` — `style` nombra un id de renderer (los integrados coinciden con los nombres de estilo). |
+| `enableExport` | `true` | Registrar el comando `/export` (exportación de sesión a Markdown/HTML, con renderers). |
 
+## 🎨 Protocolo de renderers
+
+El protocolo `output.render.*` convierte la capa de presentación en un punto de extensión. Un renderer es un **presenter puro** — `presenter(text, context)` mapea argumentos a datos de presentación y nunca toca el DOM — emparejado por nombre de herramienta y tipo de contenido, ordenado por prioridad. Los plugins de terceros se registran con `ctx.outputRenderers.register({ id, match, priority, presenter })` (register devuelve el disposer, propiedad del ctx.effect del llamador). Cada renderizado pasa primero por el waterfall `output.render/before` (los listeners deben llamar `next()`), luego por la tabla de reglas (por sesión/herramienta: `rules: [{ match: { tool: 'bash' }, style: 'concise' }]`, editable en la sección de ajustes `output-style-rules`). Renderers integrados: `concise` (compresión de espacios + truncado con presupuesto) y `step-by-step` (numeración uniforme de pasos). Auditabilidad: cada resultado lleva `{ original, rendered, rendererId, changed }`; el original es el propio registro de sesión y la aplicación de renderers es determinista. `/export [markdown|html] [--renderer=<id>]` exporta la sesión actual por el mismo pipeline. Especificación completa: docs/renderer-protocol.md (inglés) / docs/renderer-protocol.zh.md.
 ## 📚 Biblioteca de estilos
 
 <details>
@@ -193,6 +200,14 @@ Lanzamientos: hacer push de una etiqueta `v*` cuyo sufijo coincida con la versi
 
 La estructura sigue [omdsh-dev/plugin-template](https://github.com/omdsh-dev/plugin-template): `src/index.ts` (metadatos del plugin), `src/config.ts` (esquema), `src/runtime.ts` (servicio de runtime + activación), `src/invariant.ts` (invariantes), `src/client/` (selector web), `styles/` (estilos integrados).
 
+## 👥 Contribuyentes
+
+Gracias a todas las personas que han contribuido a este proyecto:
+
+- [@PerryLink](https://github.com/PerryLink) — autor y mantenedor: arquitectura del plugin, biblioteca de estilos, instalación del bundle, selector web, documentación en cinco idiomas y herramientas de CI/publicación.
+
+¿Encontraste un error o tienes una idea? Abre un [issue](https://github.com/PerryLink/dsh-output-styles/issues) o envía un [pull request](https://github.com/PerryLink/dsh-output-styles/pulls) — las contribuciones en cualquier idioma son bienvenidas.
+
 ## 📄 Licencia
 
 [Apache-2.0](LICENSE) © 2026 dsh-output-styles contributors

package/README.ja.md

@@ -6,6 +6,8 @@
 
 [![License](https://img.shields.io/badge/license-Apache--2.0-blue.svg)](LICENSE)
 [![CI](https://github.com/PerryLink/dsh-output-styles/actions/workflows/ci.yml/badge.svg)](https://github.com/PerryLink/dsh-output-styles/actions/workflows/ci.yml)
+[![npm version](https://img.shields.io/npm/v/dsh-output-styles)](https://www.npmjs.com/package/dsh-output-styles)
+[![npm downloads](https://img.shields.io/npm/dm/dsh-output-styles)](https://www.npmjs.com/package/dsh-output-styles)
 [![Node](https://img.shields.io/badge/node-%5E22.19%20%7C%7C%20%3E%3D24-brightgreen.svg)](#)
 [![DSH](https://img.shields.io/badge/deepseek--harness-0.1.0--rc.6-4d6bfe.svg)](#)
 [![TypeScript](https://img.shields.io/badge/TypeScript-strict-3178c6.svg)](#)
@@ -107,7 +109,12 @@ flowchart LR
 | `truncationMarker` | `"\n\n[style truncated]"` | 切り詰め位置に付加されるマーカー。 |
 | `includeBuiltins` | `true` | パッケージ同梱の `styles/` を最優先度の低いレイヤーとして含めます。 |
 | `watchStyles` | `true` | スタイルファイルがディスク上で変更されたときにライブラリを再読み込みします。 |
+| `rules` | `[]` | セッション/ツール別の描画ルール：`[{ match: { tool?, contentType?, session? }, style, priority? }]`——`style` はレンダラー id（ビルトインはスタイル名と同名）。 |
+| `enableExport` | `true` | `/export` コマンドを登録（Markdown/HTML セッション書き出し、レンダラー対応）。 |
 
+## 🎨 レンダラープロトコル
+
+`output.render.*` プロトコルはプレゼンテーション層を拡張点にします。レンダラーは**純粋な presenter**——`presenter(text, context)` が引数を表示データに写し、DOM には触れません——ツール名とコンテンツタイプでマッチし、優先度で並びます。サードパーティは `ctx.outputRenderers.register({ id, match, priority, presenter })` で登録（register は disposer を返し、呼び出し側の ctx.effect が所有）。各レンダーはまず `output.render/before` waterfall（リスナーは必ず `next()`）を通り、次にルール表（セッション/ツール別：`rules: [{ match: { tool: 'bash' }, style: 'concise' }]`、設定画面 `output-style-rules` で編集可）。ビルトインは `concise`（空白圧縮 + 予算切り詰め）と `step-by-step`（手順の連番化）。監査可能：各結果は `{ original, rendered, rendererId, changed }` を持ち、原文はセッションログそのもので決定論的に再構築できます。`/export [markdown|html] [--renderer=<id>]` は同じパイプラインで現在のセッションを書き出します。完全な仕様：docs/renderer-protocol.md（英語）/ docs/renderer-protocol.zh.md。
 ## 📚 スタイルライブラリ
 
 <details>
@@ -193,6 +200,14 @@ pnpm pack            # dsh plugin add 用の tarball
 
 構成は [omdsh-dev/plugin-template](https://github.com/omdsh-dev/plugin-template) に従います：`src/index.ts`（プラグインメタデータ）、`src/config.ts`（スキーマ）、`src/runtime.ts`（ランタイムサービス + アクティベーション）、`src/invariant.ts`（不変条件）、`src/client/`（Web ピッカー）、`styles/`（組み込みスタイル）。
 
+## 👥 コントリビューター
+
+本プロジェクトに貢献してくださったすべての方に感謝します：
+
+- [@PerryLink](https://github.com/PerryLink) — 作者兼メンテナー：プラグインアーキテクチャ、スタイルライブラリ、bundle インストール、Web ピッカー、5 言語ドキュメント、CI/リリースツール。
+
+バグやアイデアがあれば [issue](https://github.com/PerryLink/dsh-output-styles/issues) や [pull request](https://github.com/PerryLink/dsh-output-styles/pulls) をどうぞ。どの言語での貢献も歓迎します。
+
 ## 📄 ライセンス
 
 [Apache-2.0](LICENSE) © 2026 dsh-output-styles contributors

package/README.ko.md

@@ -6,6 +6,8 @@
 
 [![License](https://img.shields.io/badge/license-Apache--2.0-blue.svg)](LICENSE)
 [![CI](https://github.com/PerryLink/dsh-output-styles/actions/workflows/ci.yml/badge.svg)](https://github.com/PerryLink/dsh-output-styles/actions/workflows/ci.yml)
+[![npm version](https://img.shields.io/npm/v/dsh-output-styles)](https://www.npmjs.com/package/dsh-output-styles)
+[![npm downloads](https://img.shields.io/npm/dm/dsh-output-styles)](https://www.npmjs.com/package/dsh-output-styles)
 [![Node](https://img.shields.io/badge/node-%5E22.19%20%7C%7C%20%3E%3D24-brightgreen.svg)](#)
 [![DSH](https://img.shields.io/badge/deepseek--harness-0.1.0--rc.6-4d6bfe.svg)](#)
 [![TypeScript](https://img.shields.io/badge/TypeScript-strict-3178c6.svg)](#)
@@ -107,7 +109,12 @@ flowchart LR
 | `truncationMarker` | `"\n\n[style truncated]"` | 잘린 지점에 추가되는 마커. |
 | `includeBuiltins` | `true` | 패키지 내장 `styles/`를 최저 우선순위 계층으로 포함합니다. |
 | `watchStyles` | `true` | 디스크에서 스타일 파일이 변경되면 라이브러리를 다시 로드합니다. |
+| `rules` | `[]` | 세션/도구별 렌더 규칙：`[{ match: { tool?, contentType?, session? }, style, priority? }]`——`style` 은 렌더러 id（내장은 스타일과 동명）。 |
+| `enableExport` | `true` | `/export` 명령 등록（Markdown/HTML 세션 내보내기、렌더러 인식）。 |
 
+## 🎨 렌더러 프로토콜
+
+`output.render.*` 프로토콜은 프레젠테이션 계층을 확장점으로 만듭니다。렌더러는 **순수 presenter**——`presenter(text, context)` 가 인자를 표시 데이터로 매핑하고 DOM 에는 손대지 않습니다——도구 이름과 콘텐츠 타입으로 매칭되고 우선순위로 정렬됩니다。서드파티는 `ctx.outputRenderers.register({ id, match, priority, presenter })` 로 등록합니다（register 는 disposer 를 반환、호출자의 ctx.effect 소유）。모든 렌더는 먼저 `output.render/before` waterfall（리스너는 반드시 `next()`）을 거친 뒤 규칙표（세션/도구별：`rules: [{ match: { tool: 'bash' }, style: 'concise' }]`、설정 페이지 `output-style-rules` 에서 편집）를 적용합니다。내장 렌더러는 `concise`（공백 압축 + 예산 절단）와 `step-by-step`（단계 일련번호）입니다。감사 가능：모든 결과는 `{ original, rendered, rendererId, changed }` 를 가지며 원문은 세션 로그 그 자체로 결정적으로 재구성됩니다。`/export [markdown|html] [--renderer=<id>]` 는 같은 파이프라인으로 현재 세션을 내보냅니다。전체 규격：docs/renderer-protocol.md（영어）/ docs/renderer-protocol.zh.md。
 ## 📚 스타일 라이브러리
 
 <details>
@@ -193,6 +200,14 @@ pnpm pack            # dsh plugin add용 tarball
 
 구조는 [omdsh-dev/plugin-template](https://github.com/omdsh-dev/plugin-template)를 따릅니다: `src/index.ts`(플러그인 메타데이터), `src/config.ts`(스키마), `src/runtime.ts`(런타임 서비스 + 활성화), `src/invariant.ts`(불변식), `src/client/`(웹 피커), `styles/`(내장 스타일).
 
+## 👥 기여자
+
+이 프로젝트에 기여해 주신 모든 분께 감사드립니다:
+
+- [@PerryLink](https://github.com/PerryLink) — 작성자이자 메인테이너: 플러그인 아키텍처, 스타일 라이브러리, 번들 설치, 웹 피커, 5개 언어 문서, CI/릴리스 도구.
+
+버그나 아이디어가 있으신가요? [issue](https://github.com/PerryLink/dsh-output-styles/issues) 또는 [pull request](https://github.com/PerryLink/dsh-output-styles/pulls)를 보내 주세요. 어떤 언어의 기여든 환영합니다.
+
 ## 📄 라이선스
 
 [Apache-2.0](LICENSE) © 2026 dsh-output-styles contributors

package/README.md

@@ -6,6 +6,8 @@
 
 [![License](https://img.shields.io/badge/license-Apache--2.0-blue.svg)](LICENSE)
 [![CI](https://github.com/PerryLink/dsh-output-styles/actions/workflows/ci.yml/badge.svg)](https://github.com/PerryLink/dsh-output-styles/actions/workflows/ci.yml)
+[![npm version](https://img.shields.io/npm/v/dsh-output-styles)](https://www.npmjs.com/package/dsh-output-styles)
+[![npm downloads](https://img.shields.io/npm/dm/dsh-output-styles)](https://www.npmjs.com/package/dsh-output-styles)
 [![Node](https://img.shields.io/badge/node-%5E22.19%20%7C%7C%20%3E%3D24-brightgreen.svg)](#)
 [![DSH](https://img.shields.io/badge/deepseek--harness-0.1.0--rc.6-4d6bfe.svg)](#)
 [![TypeScript](https://img.shields.io/badge/TypeScript-strict-3178c6.svg)](#)
@@ -34,6 +36,9 @@
 | ⚙️ **Project default over settings** | Sessions that never selected one fall back to `output-style.style` from the DSH settings seam, then to `defaultStyle`. |
 | 🖱️ **Web picker** | A `dsh.client` entry (`dsh-output-styles/client`) decorates the host `/style` command with a projection-backed popup picker. |
 | 📊 **Session projection** | A `style` projection (`{ options, currentValue }`) for the Web UI, folded from settled commands in the session log. |
+| 🎨 **Renderer registry (`output.render.*`)** | `ctx.outputRenderers` lets any plugin register a presenter — `{ id, match (tool/content-type), presenter, priority }` — applied through the `output.render/before` waterfall (listeners must `next()`). Built-in renderers: `concise`, `step-by-step`. Registration is reversible and owned by the caller's `ctx.effect`. |
+| 🧾 **Per-session/per-tool rules** | `rules: [{ match: { tool: 'bash' }, style: 'concise' }]` — first matching rule (by priority) names the renderer; `match.session` scopes a rule to one session. Editable through the `output-style-rules` settings section. |
+| 📤 **`/export`** | Renders the current session's message surface to Markdown or sanitized HTML through the render pipeline (`/export [markdown|html] [--renderer=<id>]`); every render keeps its original text beside the rendered one, and the original always stays reconstructable from the session log. |
 | 🧯 **Fail loud, skip cleanly** | Misconfiguration throws at load; a bad style file is skipped with a warning and never breaks the profile. |
 | 🌐 **Five-language docs** | EN · 中文 · 日本語 · 한국어 · Español. |
 
@@ -107,6 +112,8 @@ Every tunable is a validated Schemastery `Config` field (invalid values fail the
 | `truncationMarker` | `"\n\n[style truncated]"` | Marker appended at the truncation point. |
 | `includeBuiltins` | `true` | Include the package's bundled `styles/` as the lowest-priority layer. |
 | `watchStyles` | `true` | Reload the library when a style file changes on disk. |
+| `rules` | `[]` | Per-session/per-tool render rules: `[{ match: { tool?, contentType?, session? }, style, priority? }]` — `style` names a renderer id (built-ins mirror the style names). |
+| `enableExport` | `true` | Register the `/export` command (Markdown/HTML session export, renderer-aware). |
 
 ## 📚 Style library
 
@@ -158,6 +165,31 @@ Entries accept `keep-coding-instructions` and `force-for-plugin` exactly as Clau
 | `/style Diagrams first` | Multi-word names are the whole remainder |
 | `/style off` | Restore the project default (settings default, then `defaultStyle`) |
 | `/style nope` | `error: unknown output style "nope" (available: …)` |
+| `/export` | Render the current session to Markdown through the renderer pipeline |
+| `/export html` | Render to sanitized HTML |
+| `/export --renderer=concise` | Render with one renderer forced (rules bypassed) |
+
+## 🎨 Renderer protocol
+
+The `output.render.*` protocol turns the presentation layer into an extension point. A renderer is a **pure presenter** — `presenter(text, context)` maps args to display data, never touches the DOM — matched by tool name and content type, ordered by priority:
+
+```ts
+// Third-party plugin registering a custom renderer (register() returns the disposer)
+ctx.effect(() => ctx.outputRenderers.register({
+  id: 'sql-table',
+  name: 'SQL table compactor',
+  description: 'Truncates oversized SQL result sets to the head plus a row count.',
+  match: [{ tool: 'sql', contentType: 'text' }],
+  priority: 20,
+  presenter: (text, context) => compactRows(text, 50),
+}))
+```
+
+- **Waterfall first**: every render request passes through `output.render/before` (`{ text, context }`) — listeners transform the request and **must call `next()`**; returning without it short-circuits the pipeline.
+- **Rules**: `rules: [{ match: { tool: 'bash' }, style: 'concise' }]` names the renderer for matching requests (tool, content type, or exact session); ties break by `priority`, then rule order. Rules live in cordis.yml and the `output-style-rules` settings section.
+- **Built-ins**: `concise` (whitespace compaction + budget truncation) and `step-by-step` (consistent step numbering) — ids mirror the two headline style names.
+- **Auditability**: every render result carries `{ original, rendered, rendererId, changed }`. The rendered text is what surfaces; the original text is the session log itself, and the render application is deterministic — so rendered output and its source always reconstruct together.
+- Full protocol reference (including a worked third-party example): [docs/renderer-protocol.md](docs/renderer-protocol.md) (中文: [docs/renderer-protocol.zh.md](docs/renderer-protocol.zh.md)).
 
 ## 🖱️ Web picker
 
@@ -183,7 +215,7 @@ Screened against the DSH ecosystem before development (2026-08 snapshot): no `st
 ```sh
 pnpm install
 pnpm run typecheck   # both tsc projects
-pnpm test            # vitest — 93 tests
+pnpm test            # vitest — 107 tests
 pnpm run verify      # typecheck + tests + self-contained (the prepublishOnly gate)
 pnpm run build       # lib/ artifacts (host + client bundles)
 pnpm pack            # tarball for dsh plugin add
@@ -193,6 +225,36 @@ Releases: pushing a `v*` tag whose suffix matches the `package.json` version tri
 
 Structure follows the [omdsh-dev/plugin-template](https://github.com/omdsh-dev/plugin-template): `src/index.ts` (plugin metadata), `src/config.ts` (schema), `src/runtime.ts` (runtime service + activation), `src/invariant.ts` (invariants), `src/client/` (Web picker), `styles/` (built-ins).
 
+## 👥 Contributors
+
+Thanks to everyone who helped build this project:
+
+- [@PerryLink](https://github.com/PerryLink) — author and maintainer: plugin architecture, style library, bundle install, Web picker, five-language docs, and CI/release tooling.
+
+Found a bug or an idea? Open an [issue](https://github.com/PerryLink/dsh-output-styles/issues) or send a [pull request](https://github.com/PerryLink/dsh-output-styles/pulls) — contributions in any language are welcome.
+
+## PerryLink DSH Plugin Family
+
+This project is one of the [15 DeepSeek Harness plugins](https://github.com/PerryLink) maintained by [PerryLink](https://github.com/PerryLink). If this one helps you, the others likely will too:
+
+| Plugin | One-liner |
+|---|---|
+| [dsh-mcp-panel](https://github.com/PerryLink/dsh-mcp-panel) | Read-only MCP runtime panel: /mcp command + Settings tab with status, tools and errors |
+| [dsh-doublecheck](https://github.com/PerryLink/dsh-doublecheck) | Engineering-discipline guard: requirements grill, test gates, adversary review |
+| [dsh-background-agents](https://github.com/PerryLink/dsh-background-agents) | Durable background child agents with a Web UI sidebar, messaging and interrupt |
+| [dsh-lsp-actions](https://github.com/PerryLink/dsh-lsp-actions) | LSP diagnostics, formatting, completion, code actions and rename over language servers |
+| **[dsh-output-styles](https://github.com/PerryLink/dsh-output-styles)** | Claude Code outputStyles-equivalent runtime style switching |
+| [dsh-checkpoint-rewind](https://github.com/PerryLink/dsh-checkpoint-rewind) | Claude Code /rewind-equivalent: snapshots, session forks, one-shot restore |
+| [dsh-permission-rules](https://github.com/PerryLink/dsh-permission-rules) | Claude Code-style declarative allow/deny/ask permission rules with audit |
+| [dsh-auto-review](https://github.com/PerryLink/dsh-auto-review) | Second-model auto-review on the approval chain, fail-closed by default |
+| [dsh-memento](https://github.com/PerryLink/dsh-memento) | Approval-gated cross-session memory: ctx.memory seam + SQLite + memory tool |
+| [dsh-skill-pack-security](https://github.com/PerryLink/dsh-skill-pack-security) | Security-audit skill pack: secret scan, dependency and supply-chain review |
+| [dsh-session-pin](https://github.com/PerryLink/dsh-session-pin) | Pin sessions in the Web sidebar with durable ordering |
+| [dsh-composer-history](https://github.com/PerryLink/dsh-composer-history) | Terminal-style input history for the web composer: arrows, Ctrl+R search |
+| [dsh-github](https://github.com/PerryLink/dsh-github) | GitHub PR/issues integration for DSH, every write gated by approval |
+| [dsh-plugin-guide](https://github.com/PerryLink/dsh-plugin-guide) | Plugin-development knowledge base as an on-demand agent skill |
+| [dsh-claude-move](https://github.com/PerryLink/dsh-claude-move) | Migrate Claude Code sessions, memory, skills and CLAUDE.md into DSH |
+
 ## 📄 License
 
 [Apache-2.0](LICENSE) © 2026 dsh-output-styles contributors

package/README.zh.md

@@ -6,6 +6,8 @@
 
 [![License](https://img.shields.io/badge/license-Apache--2.0-blue.svg)](LICENSE)
 [![CI](https://github.com/PerryLink/dsh-output-styles/actions/workflows/ci.yml/badge.svg)](https://github.com/PerryLink/dsh-output-styles/actions/workflows/ci.yml)
+[![npm version](https://img.shields.io/npm/v/dsh-output-styles)](https://www.npmjs.com/package/dsh-output-styles)
+[![npm downloads](https://img.shields.io/npm/dm/dsh-output-styles)](https://www.npmjs.com/package/dsh-output-styles)
 [![Node](https://img.shields.io/badge/node-%5E22.19%20%7C%7C%20%3E%3D24-brightgreen.svg)](#)
 [![DSH](https://img.shields.io/badge/deepseek--harness-0.1.0--rc.6-4d6bfe.svg)](#)
 [![TypeScript](https://img.shields.io/badge/TypeScript-strict-3178c6.svg)](#)
@@ -107,7 +109,12 @@ flowchart LR
 | `truncationMarker` | `"\n\n[style truncated]"` | 截断点追加的标记。 |
 | `includeBuiltins` | `true` | 将包内置 `styles/` 作为最低优先级层纳入。 |
 | `watchStyles` | `true` | 风格文件在磁盘上变化时重载风格库。 |
+| `rules` | `[]` | 按会话/按工具的渲染规则：`[{ match: { tool?, contentType?, session? }, style, priority? }]`——`style` 指定渲染器 id（内置与风格同名）。 |
+| `enableExport` | `true` | 注册 `/export` 命令（Markdown/HTML 会话导出，渲染器感知）。 |
 
+## 🎨 渲染器协议
+
+`output.render.*` 协议把呈现层变成扩展点。渲染器是**纯 presenter**——`presenter(text, context)` 把参数映射为展示数据、绝不碰 DOM——按工具名与内容类型匹配、按优先级排序：第三方插件经 `ctx.outputRenderers.register({ id, match, priority, presenter })` 注册（register 返回 disposer，归调用方 ctx.effect）。每次渲染先过 `output.render/before` waterfall（监听器必须 `next()`），再走规则表（按会话/按工具：`rules: [{ match: { tool: 'bash' }, style: 'concise' }]`，设置页 `output-style-rules` 可编辑）。内置渲染器 `concise`（空白折叠 + 预算截断）与 `step-by-step`（步骤统一编号）。可审计：每个结果携带 `{ original, rendered, rendererId, changed }`，原始文本即会话日志、渲染确定可重建。`/export [markdown|html] [--renderer=<id>]` 经同一流水线导出当前会话。完整协议：docs/renderer-protocol.md（英文）/ docs/renderer-protocol.zh.md。
 ## 📚 风格库
 
 <details>
@@ -193,6 +200,36 @@ pnpm pack            # 供 dsh plugin add 使用的 tarball
 
 结构遵循 [omdsh-dev/plugin-template](https://github.com/omdsh-dev/plugin-template)：`src/index.ts`（插件元数据）、`src/config.ts`（schema）、`src/runtime.ts`（运行时服务与激活）、`src/invariant.ts`（不变量）、`src/client/`（Web 选择器）、`styles/`（内置风格）。
 
+## 👥 贡献者
+
+感谢每一位为本项目做出贡献的人：
+
+- [@PerryLink](https://github.com/PerryLink) — 作者与维护者：插件架构、风格库、bundle 安装、Web 选择器、五语文档与 CI/发布工具链。
+
+发现 bug 或有想法？欢迎提交 [issue](https://github.com/PerryLink/dsh-output-styles/issues) 或 [pull request](https://github.com/PerryLink/dsh-output-styles/pulls)，任何语言的贡献都欢迎。
+
+## PerryLink DSH 插件家族
+
+本项目是 [PerryLink](https://github.com/PerryLink) 维护的 [15 个 DeepSeek Harness 插件](https://github.com/PerryLink)之一。如果你觉得这个插件有用，其余的很可能同样有用：
+
+| 插件 | 一句话说明 |
+|---|---|
+| [dsh-mcp-panel](https://github.com/PerryLink/dsh-mcp-panel) | 只读 MCP 运行时面板：/mcp 命令 + 设置页，状态/工具/错误一览 |
+| [dsh-doublecheck](https://github.com/PerryLink/dsh-doublecheck) | 工程纪律守门：需求审讯、测试证据门、对抗评审 |
+| [dsh-background-agents](https://github.com/PerryLink/dsh-background-agents) | 持久化后台子代理：Web 侧边栏进度、随时留言与打断 |
+| [dsh-lsp-actions](https://github.com/PerryLink/dsh-lsp-actions) | 基于语言服务器的诊断/格式化/补全/代码动作/重命名 |
+| **[dsh-output-styles](https://github.com/PerryLink/dsh-output-styles)** | 对标 Claude Code outputStyles 的运行时风格切换 |
+| [dsh-checkpoint-rewind](https://github.com/PerryLink/dsh-checkpoint-rewind) | 对标 Claude Code /rewind：快照、会话 fork、一键回退 |
+| [dsh-permission-rules](https://github.com/PerryLink/dsh-permission-rules) | Claude Code 风格声明式 allow/deny/ask 权限规则，带审计 |
+| [dsh-auto-review](https://github.com/PerryLink/dsh-auto-review) | 审批链上的第二模型自动审查，默认 fail-closed |
+| [dsh-memento](https://github.com/PerryLink/dsh-memento) | 带审批门的跨会话记忆：ctx.memory + SQLite + memory 工具 |
+| [dsh-skill-pack-security](https://github.com/PerryLink/dsh-skill-pack-security) | 安全审计技能包：密钥扫描、依赖与供应链审查 |
+| [dsh-session-pin](https://github.com/PerryLink/dsh-session-pin) | 在 Web 侧边栏置顶会话，持久排序 |
+| [dsh-composer-history](https://github.com/PerryLink/dsh-composer-history) | Web 作曲器终端式输入历史：方向键、Ctrl+R 搜索 |
+| [dsh-github](https://github.com/PerryLink/dsh-github) | DSH 的 GitHub PR/issue 集成，所有写操作经审批门 |
+| [dsh-plugin-guide](https://github.com/PerryLink/dsh-plugin-guide) | 插件开发知识库，随 bundle 安装的按需 agent 技能 |
+| [dsh-claude-move](https://github.com/PerryLink/dsh-claude-move) | 把 Claude Code 会话、记忆、技能和 CLAUDE.md 迁入 DSH |
+
 ## 📄 License
 
 [Apache-2.0](LICENSE) © 2026 dsh-output-styles contributors

package/docs/renderer-protocol.md

@@ -0,0 +1,134 @@
+# output.render.* — the dsh-output-styles renderer protocol
+
+> 中文版见 [renderer-protocol.zh.md](renderer-protocol.zh.md)。Style switching stays fully
+> compatible; this document covers the presentation layer added in 0.4.0.
+
+The renderer protocol turns output presentation into an extension point: any
+plugin can register a **renderer** — a pure function that maps raw
+model-visible text to display text — and the harness-facing surfaces of this
+plugin (`/export`, the `ctx.outputRenderers.renderText` service) apply them
+through one auditable pipeline.
+
+## Renderer contract
+
+```ts
+interface OutputRenderer {
+  id: string                 // kebab-case, unique in the registry
+  name: string               // human-readable
+  description: string        // one sentence
+  match: RendererMatch[]     // [] = matches everything
+  priority: number           // higher wins; ties break by registration order
+  presenter: (text: string, context: RenderContext) => string  // PURE — no DOM, no I/O
+}
+
+interface RendererMatch {
+  tool?: string | string[]           // tool names; '*' = any; omitted = any
+  contentType?: 'text' | 'markdown' | 'html' | ContentType[]
+}
+
+interface RenderContext {
+  tool: string               // '' for assistant/user prose
+  contentType: ContentType
+  sessionId?: string
+  meta?: Record<string, string>
+}
+```
+
+Rules the registry enforces (fail-loud):
+
+- Invalid renderers (bad id grammar, missing fields, non-function presenter,
+  non-finite priority) throw at registration and never enter the registry.
+- Duplicate ids throw; `register()` returns a disposer that removes exactly
+  that registration — reversibility is the caller's `ctx.effect` job.
+
+## Render pipeline
+
+```text
+renderText(text, context)
+  → output.render/before waterfall   (listeners transform {text, context}, MUST next())
+  → rule table (first match by priority)
+      ├─ rule hit → the named renderer applies (explicit; no other renderer runs)
+      └─ no hit  → every matching renderer applies in priority order (composition)
+  → { original, rendered, rendererId?, changed }
+```
+
+- The waterfall listener contract is the ordinary Cordis waterfall semantics:
+  a listener that returns without calling `next()` short-circuits the whole
+  pipeline — do that only on purpose.
+- A rule naming an unregistered renderer fails loudly at render time (the
+  registry can gain and lose renderers at runtime; silent fallback would
+  hide drift).
+
+## Built-in renderers
+
+| id | Behavior |
+| --- | --- |
+| `concise` | Collapses whitespace runs and blank-line stacks, caps the presented text at a budget with a `[truncated]` marker. |
+| `step-by-step` | Renumbers list items (dashes, bullets, or digits) consistently from 1; leaves prose untouched. |
+
+Their ids mirror the two headline style names, so a rule like
+`{ match: { tool: 'bash' }, style: 'concise' }` reads naturally.
+
+## Per-session / per-tool rules
+
+```yaml
+# cordis.yml, under the dsh-output-styles row
+config:
+  rules:
+    - match: { tool: bash }
+      style: concise
+    - match: { tool: read, contentType: text }
+      style: step-by-step
+      priority: 5
+    - match: { session: "session-id-here" }
+      style: step-by-step
+```
+
+Matching is exact (no globs except `'*'` for any tool); `match.session`
+scopes a rule to one session. Rules can also be edited in the settings UI
+(`output-style-rules` namespace), where the same shape is validated at
+write time.
+
+## Auditability
+
+Presentation never destroys the source:
+
+- every result object carries `original` beside `rendered`;
+- the original text of an exported conversation is the session log itself —
+  `/export` projects it through the official `deriveEventMessage` surface
+  rule, the same rule the harness uses to build model requests;
+- the render application is deterministic (same rules + same renderers in the
+  same order), so the rendered output and its source reconstruct together.
+
+## Worked third-party example
+
+```ts
+// my-plugin/renderers.ts
+export const tableCompactor = {
+  id: 'sql-table',
+  name: 'SQL table compactor',
+  description: 'Truncates oversized SQL result sets to the head plus a row count.',
+  match: [{ tool: 'sql', contentType: 'text' }],
+  priority: 20,
+  presenter: (text: string): string => {
+    const rows = text.split('\n')
+    if (rows.length <= 50) return text
+    return [...rows.slice(0, 50), `… ${rows.length - 50} more rows`].join('\n')
+  },
+}
+
+// my-plugin/index.ts
+export function apply(ctx: Context): void {
+  const renderers = ctx.get('outputRenderers')   // optional: dsh-output-styles may be absent
+  if (renderers !== undefined) {
+    ctx.effect(() => renderers.register(tableCompactor))
+  }
+}
+```
+
+## Consuming the pipeline
+
+```ts
+const result = await ctx.outputRenderers.renderText(rawText, { tool: 'sql', contentType: 'text' })
+// { original, rendered, rendererId, changed } — log both halves wherever you surface it.
+```

package/docs/renderer-protocol.zh.md

@@ -0,0 +1,125 @@
+# output.render.* —— dsh-output-styles 渲染器协议
+
+> English version: [renderer-protocol.md](renderer-protocol.md)。`/style` 切换行为完全兼容；
+> 本文档只覆盖 0.4.0 新增的呈现层。
+
+渲染器协议把输出呈现变成扩展点：任何插件都可以注册一个**渲染器**——把原始模型可见文本
+映射为展示文本的纯函数——本插件面向外部的表面（`/export`、`ctx.outputRenderers.renderText`
+服务）统一经一条可审计的流水线应用它们。
+
+## 渲染器契约
+
+```ts
+interface OutputRenderer {
+  id: string                 // kebab-case，注册表内唯一
+  name: string               // 人类可读名称
+  description: string        // 一句话说明
+  match: RendererMatch[]     // [] = 匹配一切
+  priority: number           // 数值越大越优先；平局按注册顺序
+  presenter: (text: string, context: RenderContext) => string  // 纯函数——无 DOM、无 I/O
+}
+
+interface RendererMatch {
+  tool?: string | string[]           // 工具名；'*' = 任意；缺省 = 任意
+  contentType?: 'text' | 'markdown' | 'html' | ContentType[]
+}
+
+interface RenderContext {
+  tool: string               // assistant/user 散文为 ''
+  contentType: ContentType
+  sessionId?: string
+  meta?: Record<string, string>
+}
+```
+
+注册表强制执行的规则（失败大声）：
+
+- 非法渲染器（id 语法错、缺字段、presenter 非函数、priority 非有限数）在注册时抛错，
+  绝不进入注册表。
+- id 重复抛错；`register()` 返回 disposer，精确移除本次注册——可逆性由调用方的
+  `ctx.effect` 负责。
+
+## 渲染流水线
+
+```text
+renderText(text, context)
+  → output.render/before waterfall   （监听器转换 {text, context}，必须 next()）
+  → 规则表（按优先级取第一条命中）
+      ├─ 规则命中 → 只应用该规则指定的渲染器（显式，其余渲染器不参与）
+      └─ 未命中   → 按优先级依次应用所有匹配的渲染器（组合）
+  → { original, rendered, rendererId?, changed }
+```
+
+- waterfall 监听器契约就是普通 Cordis waterfall 语义：不调用 `next()` 就返回会短路整条
+  流水线——只在有意为之的时候这样做。
+- 规则指向未注册渲染器时在渲染期响亮失败（注册表在运行期可增删渲染器；静默回退会掩盖漂移）。
+
+## 内置渲染器
+
+| id | 行为 |
+| --- | --- |
+| `concise` | 折叠空白串与空行堆，在预算处截断并加 `[truncated]` 标记。 |
+| `step-by-step` | 把列表项（短横线、圆点或数字）统一从 1 重新编号；散文保持原样。 |
+
+两个 id 与两大招牌风格同名，因此规则
+`{ match: { tool: 'bash' }, style: 'concise' }` 读起来很自然。
+
+## 按会话 / 按工具规则
+
+```yaml
+# cordis.yml，dsh-output-styles 行的 config 下
+config:
+  rules:
+    - match: { tool: bash }
+      style: concise
+    - match: { tool: read, contentType: text }
+      style: step-by-step
+      priority: 5
+    - match: { session: "session-id-here" }
+      style: step-by-step
+```
+
+匹配是精确匹配（除 `'*'` 表示任意工具外没有通配符）；`match.session` 把规则限定在一个会话。
+规则也可以在设置页编辑（`output-style-rules` 命名空间），同一形状在写入时校验。
+
+## 可审计性
+
+呈现绝不销毁来源：
+
+- 每个结果对象在 `rendered` 旁边携带 `original`；
+- 导出会话的原始文本就是会话日志本身——`/export` 经官方 `deriveEventMessage` surface
+  规则投影它，与 harness 构建模型请求用的是同一条规则；
+- 渲染应用是确定性的（同样的规则 + 同样顺序的渲染器），因此渲染输出与其来源总是一起重建。
+
+## 第三方示例（完整）
+
+```ts
+// my-plugin/renderers.ts
+export const tableCompactor = {
+  id: 'sql-table',
+  name: 'SQL table compactor',
+  description: 'Truncates oversized SQL result sets to the head plus a row count.',
+  match: [{ tool: 'sql', contentType: 'text' }],
+  priority: 20,
+  presenter: (text: string): string => {
+    const rows = text.split('\n')
+    if (rows.length <= 50) return text
+    return [...rows.slice(0, 50), `… ${rows.length - 50} more rows`].join('\n')
+  },
+}
+
+// my-plugin/index.ts
+export function apply(ctx: Context): void {
+  const renderers = ctx.get('outputRenderers')   // 可选依赖：dsh-output-styles 可能未挂载
+  if (renderers !== undefined) {
+    ctx.effect(() => renderers.register(tableCompactor))
+  }
+}
+```
+
+## 消费流水线
+
+```ts
+const result = await ctx.outputRenderers.renderText(rawText, { tool: 'sql', contentType: 'text' })
+// { original, rendered, rendererId, changed } —— 在任何展示它的地方把两半都记下来。
+```