npm - dsh-output-styles - Versions diffs - 0.4.0 → 0.4.2 - Mend

dsh-output-styles 0.4.0 → 0.4.2

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (21) hide show

package/CHANGELOG.md +27 -0
package/README.es.md +167 -138
package/README.hi.md +246 -0
package/README.md +118 -136
package/README.pt.md +246 -0
package/README.zh.md +166 -159
package/lib/client.js +13 -3
package/lib/index.js +22 -8
package/lib/{invariant-B9LpUViP.js → invariant-CEWlfnrw.js} +42 -4
package/lib/invariant.js +1 -1
package/lib/types/client/index.d.ts +1 -1
package/lib/types/export.d.ts +2 -2
package/lib/types/index.d.ts +12 -12
package/lib/types/runtime.d.ts +3 -3
package/lib/types/runtime.d.ts.map +1 -1
package/lib/types/types.d.ts +1 -1
package/package.json +51 -46
package/src/client/index.ts +1 -1
package/src/runtime.ts +5 -2
package/README.ja.md +0 -217
package/README.ko.md +0 -217

package/README.md CHANGED Viewed

@@ -4,67 +4,58 @@
 **Claude Code `outputStyles` for DeepSeek Harness** — switch the model's output style at runtime, per session, durably.
-[![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)
+*`/style concise` — and every reply from now on is terse. `/style off` — back to the project default.*
+[![License](https://img.shields.io/badge/license-Apache%202.0-blue.svg)](LICENSE)
+[![DSH plugin](https://img.shields.io/badge/dsh-plugin-✅-green)](https://github.com/topics/dsh-plugin)
+[![Node](https://img.shields.io/badge/node-%5E22.19%20%7C%7C%20%3E%3D24-brightgreen.svg)](#)
+[![CI](https://img.shields.io/github/actions/workflow/status/PerryLink/dsh-output-styles/ci.yml?branch=main&label=CI)](https://github.com/PerryLink/dsh-output-styles/actions)
+[![Version](https://img.shields.io/github/v/tag/PerryLink/dsh-output-styles?label=version)](https://github.com/PerryLink/dsh-output-styles/releases)
 [![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)](#)
-🌐 [English](README.md) · [中文](README.zh.md) · [日本語](README.ja.md) · [한국어](README.ko.md) · [Español](README.es.md)
+[English](README.md) · [简体中文](README.zh.md) · [Español](README.es.md) · [Português](README.pt.md) · [हिन्दी](README.hi.md)
 </div>
 ---
-`/style concise` — and every reply from now on is terse. `/style step-by-step` — and the model narrates numbered steps. `/style off` — back to the project default. One command per session, persisted across restarts, zero changes to the agent loop.
+## Compatibility
-## ✨ Features
-| | |
+| Surface | Status |
 |---|---|
-| 🗂️ **Style library** | One Markdown file per style (`styles/*.md`); frontmatter for metadata, body = the model directive. `name` defaults to the file name and may contain spaces (`Diagrams first`). Six built-ins ship in the box, including Claude Code-parity `proactive` and `learning`. |
-| ⌨️ **`/style` command** | No argument lists styles (with descriptions) + current selection; `/style <name>` switches; `/style off` restores the project default. The whole remainder after `/style` is the style name. |
-| 💾 **Session-scoped persistence** | The choice lives in the `output_style` storage domain, keyed by sessionId — two sessions never interfere, and the choice survives restarts. |
-| 🧩 **System-prompt injection** | A `systemPrompt.section()` contribution (order 90) injects the current session's style body at every assembly; bodies are truncated at a configurable budget. |
-| 🎭 **Claude Code `keep-coding-instructions`** | Styles with `keep-coding-instructions: false` (the default, like Claude Code) replace the whole system prompt — for styles that leave software engineering behind. |
-| 📌 **Forced styles** | Claude Code's `force-for-plugin` (alias `force`) applies a style unconditionally, overriding any session selection; two forced styles fail the load. |
-| 🔁 **Claude Code compatibility** | Loads `outputStyles` JSON collections (`{ name, description, prompt }`), single entries or `settings.json`-style arrays; unparseable entries are skipped with a warning. |
-| 📚 **Layered directories** | `stylesDir` is a list; later directories override earlier ones (bundled `styles/` is the lowest layer, disable with `includeBuiltins: false`). |
-| 🔄 **Hot reload** | Style-file changes are picked up without restarting (`watchStyles: false` to opt out). |
-| ⚙️ **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. |
-## 🚀 Quick start
+| Harness | DeepSeek Harness `0.1.0-rc.8` |
+| Node | `^22.19.0 || >=24.0.0` |
+| Platforms | All (host + web client) |
+| Model | Any (system-prompt injection) |
+## What you get
+`dsh-output-styles` is the Claude Code `outputStyles` equivalent for DeepSeek Harness: a `/style` command that switches the model's output style at runtime, persisted per session, injected at every prompt assembly.
+- **Style library** — one Markdown file per style (`styles/*.md`); frontmatter for metadata, body = the model directive. Six built-ins ship in the box (`concise`, `explanatory`, `formal`, `learning`, `proactive`, `step-by-step`), including Claude Code-parity `proactive` and `learning`.
+- **`/style` command** — no argument lists styles (with descriptions) plus the current selection; `/style <name>` switches; `/style off` restores the project default.
+- **Session-scoped persistence** — the choice lives in the `output_style` storage domain, keyed by sessionId, and survives restarts.
+- **System-prompt injection** — a `systemPrompt.section()` contribution (order `sectionOrder`) injects the current session's style body at every assembly, truncated at a configurable budget.
+- **Claude Code parity** — `keep-coding-instructions`, `force-for-plugin` (`force` alias), `outputStyles` JSON compatibility, layered `stylesDir` directories, hot reload, and project-default fallback over the DSH settings seam.
+- **Renderer registry (`output.render.*`)** — `ctx.outputRenderers` lets any plugin register a pure presenter, applied through the `output.render/before` waterfall; built-in renderers `concise` and `step-by-step`.
+- **Per-session/per-tool rules** — `rules: [{ match: { tool: 'bash' }, style: 'concise' }]` name the renderer for matching requests; editable through the `output-style-rules` settings section.
+- **`/export`** — render the current session to Markdown or sanitized HTML through the render pipeline; every render keeps the original text beside the rendered one.
+## Quick start
 ```sh
-# 1. Install — the package is a bundle layer, so one command composes
-#    storage + storage-json + storage-domain + the plugin row:
-dsh plugin --profile <name> add dsh-output-styles
-# 2. Boot and switch
-dsh --profile <name>
-/style               # → output style off, then one line per style
-/style concise       # → switched to concise
-/style Diagrams first  # → names with spaces work too
-/style off           # → back to the project default
-```
+# 1. install the bundle into your profile
+dsh plugin --profile web add "github:PerryLink/dsh-output-styles#main"
-The layer is idempotent over web profiles (insert-by-id replaces same-id rows), which compose `storage` in box. For the Web picker, add the client row to the profile:
+# or from npm (published releases)
+dsh plugin --profile web add dsh-output-styles
-```yaml
-- id: output-styles-client
-  name: 'dsh-output-styles/client'
+# 2. restart and verify the row
+dsh --profile web --dump-config | grep -A3 'id: output-styles'
 ```
-## 🎬 Demo
+## Demo
 ```
 You > /style
@@ -83,7 +74,7 @@ You > 请只用一句话介绍你自己。
 AI  > 我是运行在 DeepSeek Harness 插件化平台上、基于 deepseek-v4-pro 模型的 AI 编码代理。
 ```
-## 🧠 How it works
+## How it works
 ```mermaid
 flowchart LR
@@ -98,69 +89,47 @@ flowchart LR
 Everything the model sees is reconstructable from the session log — no new session event type, no agent-loop changes. The style name comes from `command/run`, the exact injected text from `request/header`, and the provenance marker `{ kind: 'plugin', plugin: 'dsh-output-styles' }` rides in the domain record. Styles apply to the main conversation only; subagent sessions keep their own prompts (matching Claude Code).
-## ⚙️ Configuration
+## Install & uninstall
-Every tunable is a validated Schemastery `Config` field (invalid values fail the load):
+- **git channel** (latest `main`): `dsh plugin --profile web add "github:PerryLink/dsh-output-styles#main"` — the `prepare` script builds with production dependencies only.
+- **npm channel** (published releases): `dsh plugin --profile web add dsh-output-styles`.
+- **tarball channel**: `pnpm pack` in this repo, then `dsh plugin --profile web add ./dsh-output-styles-<version>.tgz`.
+- **uninstall**: `dsh plugin --profile web remove dsh-output-styles`.
-| Field | Default | Meaning |
-|---|---|---|
-| `stylesDir` | `[]` | Style-library directories, resolved against cwd; later entries override earlier ones. `[]` = the bundled `styles/` only. A bare string is a single-directory list. |
-| `maxStyleChars` | `4000` | Style-body budget (code points, ≥ 1); longer bodies are truncated with a marker. |
-| `defaultStyle` | `''` | Style for sessions that never selected one (and no settings default exists); `''` = no style. |
-| `compatJson` | `true` | Load Claude Code `outputStyles` JSON entries (single objects or arrays). |
-| `sectionOrder` | `90` | Order of the injected section (0 = persona, 100–199 = tool guidance). |
-| `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
-<details>
-<summary><code>styles/concise.md</code></summary>
-```markdown
----
-name: concise
-description: Terse, direct answers — minimal prose, no preamble.
-whenToUse: Daily coding work, tool-heavy sessions, or when prompt length matters.
-keep-coding-instructions: true
----
-You are in the concise output style for this conversation.
-- Lead with the direct answer; skip preamble, restatements, and filler.
-- 回答语言跟随用户语言：中文提问用中文回答，英文提问用英文回答。
-```
-</details>
+## Configuration
-Frontmatter fields:
+All tunables are Schemastery `Config` fields (changeable from cordis.yml). Invalid values fail the load.
-| Field | Default | Meaning |
+| Key | Default | Meaning |
 |---|---|---|
-| `name` | file name | Switch target; letters, digits, spaces, and hyphens (no leading/trailing space; `off` is reserved). |
-| `description` | — (required) | One sentence shown in listings and the picker. |
-| `whenToUse` | — | Optional guidance appended to listings. |
-| `keep-coding-instructions` | `false` | Keep the harness prompt (identity, persona, tool guidance) when `true`; replace it entirely when `false` (Claude Code semantics). |
-| `force-for-plugin` | `false` | Claude Code's field: apply unconditionally, overriding any session selection; `force` is accepted as an alias, and at most one style may set it. |
-<details>
-<summary>Claude Code <code>outputStyles</code> JSON (<code>compatJson: true</code>)</summary>
-```json
-{ "name": "explain", "description": "Explain like a teacher.", "prompt": "Teach in small steps." }
-```
-Entries accept `keep-coding-instructions` and `force-for-plugin` exactly as Claude Code writes them. Legacy `settings.json` arrays (`[{ … }, { … }]`) load as-is; bad entries are skipped with a warning.
-</details>
+| `stylesDir` | `[]` | Style-library directories, resolved against cwd; later entries override earlier ones. `[]` = the bundled `styles/` only |
+| `maxStyleChars` | `4000` | Style-body budget (≥ 1); longer bodies are truncated with a marker |
+| `defaultStyle` | `''` | Style for sessions that never selected one (and no settings default exists); `''` = no style |
+| `compatJson` | `true` | Load Claude Code `outputStyles` JSON entries (single objects or arrays) |
+| `sectionOrder` | `90` | Order of the injected section (0 = persona, 100–199 = tool guidance) |
+| `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? }]` |
+| `enableExport` | `true` | Register the `/export` command (Markdown/HTML session export, renderer-aware) |
+## Tools & surfaces
+| Surface | Kind | Notes |
+|---|---|---|
+| `/style` | command | List styles, switch, or restore the project default |
+| `/export` | command | Render the current session to Markdown or sanitized HTML |
+| `output_style` | storage domain | Session-scoped style choice, keyed by sessionId |
+| `systemPrompt.section()` | contribution | Injects the current style body at every assembly |
+| `output.render.*` | renderer registry | `ctx.outputRenderers` + the `output.render/before` waterfall |
+| `style` | projection | `{ options, currentValue }` folded from settled commands |
+| Web picker | client entry | `dsh-output-styles/client` decorates `/style` with a popup picker |
-## ⌨️ Command reference
+## Command reference
 | Input | Outcome |
 |---|---|
-| `/style` | List current selection + one line per style (name — description) |
+| `/style` | List the current selection + one line per style (name — description) |
 | `/style concise` | Switch (durable write), `switched to concise` |
 | `/style Diagrams first` | Multi-word names are the whole remainder |
 | `/style off` | Restore the project default (settings default, then `defaultStyle`) |
@@ -169,37 +138,34 @@ Entries accept `keep-coding-instructions` and `force-for-plugin` exactly as Clau
 | `/export html` | Render to sanitized HTML |
 | `/export --renderer=concise` | Render with one renderer forced (rules bypassed) |
-## 🎨 Renderer protocol
+## Style library
-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:
+One Markdown file per style; frontmatter for metadata, body = the model directive. `name` defaults to the file name and may contain spaces (`Diagrams first`).
-```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),
-}))
-```
+| Field | Default | Meaning |
+|---|---|---|
+| `name` | file name | Switch target; letters, digits, spaces, and hyphens (`off` is reserved) |
+| `description` | — (required) | One sentence shown in listings and the picker |
+| `whenToUse` | — | Optional guidance appended to listings |
+| `keep-coding-instructions` | `false` | Keep the harness prompt when `true`; replace it when `false` (Claude Code semantics) |
+| `force-for-plugin` | `false` | Apply unconditionally, overriding any session selection; `force` is an alias, at most one style may set it |
-- **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)).
+With `compatJson: true`, Claude Code `outputStyles` JSON entries (`{ name, description, prompt }`) load beside Markdown styles; unparseable entries are skipped with a warning.
-## 🖱️ Web picker
+## Renderer protocol
-The `dsh.client` entry decorates the host `/style` command's bare invocation with a popup picker: an "off" row plus one row per library style (`description · whenToUse`), the active row marked. Picking submits `/style <name>` through the command Remote, so every switch keeps the host's durable command lifecycle and the `style` projection stays the single displayed fact. The picker follows the Web UI's shipped `zh`/`en` locale pair.
+The `output.render.*` protocol turns presentation 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.
-## 🔍 Conflict check
+- **Waterfall first**: every render request passes through `output.render/before` (`{ text, context }`); listeners must call `next()`.
+- **Rules**: `rules: [{ match: { tool: 'bash' }, style: 'concise' }]` names the renderer for matching requests; ties break by `priority`, then rule order.
+- **Built-ins**: `concise` (whitespace compaction + budget truncation) and `step-by-step` (consistent step numbering).
+- **Auditability**: every render result carries `{ original, rendered, rendererId, changed }`; the rendered text is what surfaces, the original stays reconstructable from the session log.
-Screened against the DSH ecosystem before development (2026-08 snapshot): no `style`/`output-style` repository under [topic:dsh-plugin](https://github.com/topics/dsh-plugin), no output-style category in the four major [awesome lists](https://github.com/awesome-dsh-plugin/awesome-dsh-plugin), and no entry in the [dsh-hub catalog](https://github.com/omdsh-dev/dsh-hub-workshop). The closest neighbors — [dsh-soul-md](https://github.com/Scorp1o117/dsh-soul-md) (persona) and [dsh-claude-marketplace](https://github.com/ben7am1n/dsh-claude-marketplace) (output styles explicitly deferred to v0.2+) — are adjacent, not conflicting.
+## Web picker
+The `dsh.client` entry decorates the host `/style` command's bare invocation with a popup picker: an "off" row plus one row per library style (`description · whenToUse`), the active row marked. Picking submits `/style <name>` through the command Remote, so every switch keeps the host's durable command lifecycle. The picker follows the Web UI's shipped `zh`/`en` locale pair.
-## 🆚 Differences from Claude Code
+## Differences from Claude Code
 | | Claude Code | dsh-output-styles |
 |---|---|---|
@@ -210,7 +176,29 @@ Screened against the DSH ecosystem before development (2026-08 snapshot): no `st
 | Subagents | Styles do not apply | Same — subagent sessions keep their own prompts |
 | Switching | `/config` menu or `outputStyle` setting (the `/output-style` command was removed in v2.1.91) | `/style` command + Web picker + settings `output-style.style` |
-## 🧪 Development
+## Conflict check
+Screened against the DSH ecosystem before development (2026-08 snapshot): no `style`/`output-style` repository under [topic:dsh-plugin](https://github.com/topics/dsh-plugin), no output-style category in the four major [awesome lists](https://github.com/awesome-dsh-plugin/awesome-dsh-plugin), and no entry in the [dsh-hub catalog](https://github.com/omdsh-dev/dsh-hub-workshop). The closest neighbors — [dsh-soul-md](https://github.com/Scorp1o117/dsh-soul-md) (persona) and [dsh-claude-marketplace](https://github.com/ben7am1n/dsh-claude-marketplace) (output styles explicitly deferred to v0.2+) — are adjacent, not conflicting.
+## Permissions & data
+- **Permissions**: declares `fs:read`, `fs:watch`, `storage:read`, `storage:write`, and `settings:read` in its workshop manifest.
+- **Data**: the style choice lives in the `output_style` storage domain (keyed by sessionId); no other state is persisted, no network requests.
+- **Session log**: the style name comes from `command/run`, the exact injected text from `request/header`; the provenance marker `{ kind: 'plugin', plugin: 'dsh-output-styles' }` rides in the domain record.
+## Security boundaries
+- **Public services only.** Contributes `systemPrompt`, commands, storage, and settings; no engine / agent-loop / apiproxy / official-UI changes.
+- **Model-visible ⟺ logged.** Everything the model sees is reconstructable from the session log — no new session event type, no agent-loop changes.
+- **Original always kept.** Every render (and `/export`) keeps the original text beside the rendered one; sanitized HTML is used for HTML export.
+## Known limitations
+- **Main conversation only.** Styles apply to the main conversation; subagent sessions keep their own prompts (matching Claude Code).
+- **Truncation.** Style bodies longer than `maxStyleChars` are truncated with a marker.
+- **Skipped style files.** A bad style file is skipped with a warning and never breaks the profile.
+## Development
 ```sh
 pnpm install
@@ -221,18 +209,16 @@ pnpm run build       # lib/ artifacts (host + client bundles)
 pnpm pack            # tarball for dsh plugin add
 ```
-Releases: pushing a `v*` tag whose suffix matches the `package.json` version triggers the Publish workflow — full verification, then an npm publish with provenance. Any `npm publish` also passes the `verify` gate through `prepublishOnly`.
+Releases: pushing a `v*` tag whose suffix matches the `package.json` version triggers the Publish workflow — full verification, then an npm publish with provenance.
-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).
+## Topics
-## 👥 Contributors
+`deepseek-harness`, `dsh`, `dsh-plugin`, `output-style`, `output-styles`, `claude-code`
-Thanks to everyone who helped build this project:
+## Contributors
 - [@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:
@@ -255,10 +241,6 @@ This project is one of the [15 DeepSeek Harness plugins](https://github.com/Perr
 | [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
----
+## License
-<sub>Topics: `dsh` · `dsh-plugin` · `deepseek-harness` · `output-styles` · `claude-code`</sub>
+[Apache License 2.0](LICENSE) © 2026 dsh-output-styles contributors

package/README.pt.md ADDED Viewed

@@ -0,0 +1,246 @@
+<div align="center">
+# 🎨 dsh-output-styles
+**O `outputStyles` do Claude Code para o DeepSeek Harness**: alterne o estilo de saída do modelo em tempo de execução, por sessão, de forma durável.
+*`/style concise` — e a partir de agora toda resposta é concisa. `/style off` — de volta ao padrão do projeto.*
+[![License](https://img.shields.io/badge/license-Apache%202.0-blue.svg)](LICENSE)
+[![DSH plugin](https://img.shields.io/badge/dsh-plugin-✅-green)](https://github.com/topics/dsh-plugin)
+[![Node](https://img.shields.io/badge/node-%5E22.19%20%7C%7C%20%3E%3D24-brightgreen.svg)](#)
+[![CI](https://img.shields.io/github/actions/workflow/status/PerryLink/dsh-output-styles/ci.yml?branch=main&label=CI)](https://github.com/PerryLink/dsh-output-styles/actions)
+[![Version](https://img.shields.io/github/v/tag/PerryLink/dsh-output-styles?label=version)](https://github.com/PerryLink/dsh-output-styles/releases)
+[![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)
+[English](README.md) · [简体中文](README.zh.md) · [Español](README.es.md) · [Português](README.pt.md) · [हिन्दी](README.hi.md)
+</div>
+---
+## Compatibility
+| Surface | Status |
+|---|---|
+| Harness | DeepSeek Harness `0.1.0-rc.8` |
+| Node | `^22.19.0 || >=24.0.0` |
+| Platforms | Todas (host + cliente web) |
+| Model | Qualquer (injeção no prompt do sistema) |
+## What you get
+O `dsh-output-styles` é o equivalente do `outputStyles` do Claude Code para o DeepSeek Harness: um comando `/style` que alterna o estilo de saída do modelo em tempo de execução, persistido por sessão e injetado a cada montagem do prompt.
+- **Biblioteca de estilos** — um arquivo Markdown por estilo (`styles/*.md`); frontmatter para metadados, corpo = a diretiva do modelo. Seis estilos integrados (`concise`, `explanatory`, `formal`, `learning`, `proactive`, `step-by-step`), incluindo `proactive` e `learning` com paridade Claude Code.
+- **Comando `/style`** — sem argumento lista os estilos (com descrições) e a seleção atual; `/style <name>` alterna; `/style off` restaura o padrão do projeto.
+- **Persistência por sessão** — a escolha vive no domínio de armazenamento `output_style`, indexada por sessionId, e sobrevive a reinícios.
+- **Injeção no prompt do sistema** — uma contribuição `systemPrompt.section()` (ordem `sectionOrder`) injeta o corpo do estilo atual a cada montagem, truncado em um orçamento configurável.
+- **Paridade Claude Code** — `keep-coding-instructions`, `force-for-plugin` (alias `force`), compatibilidade JSON `outputStyles`, diretórios `stylesDir` em camadas, recarga a quente e fallback do projeto sobre a costura de settings do DSH.
+- **Registro de renderers (`output.render.*`)** — `ctx.outputRenderers` permite a qualquer plugin registrar um presenter puro, aplicado pela cascata `output.render/before`; renderers integrados `concise` e `step-by-step`.
+- **Regras por sessão/por ferramenta** — `rules: [{ match: { tool: 'bash' }, style: 'concise' }]` nomeiam o renderer para solicitações coincidentes; editáveis pela seção de settings `output-style-rules`.
+- **`/export`** — renderiza a sessão atual para Markdown ou HTML saneado pela pipeline de render; cada render mantém o texto original ao lado do renderizado.
+## Quick start
+```sh
+# 1. install the bundle into your profile
+dsh plugin --profile web add "github:PerryLink/dsh-output-styles#main"
+# or from npm (published releases)
+dsh plugin --profile web add dsh-output-styles
+# 2. restart and verify the row
+dsh --profile web --dump-config | grep -A3 'id: output-styles'
+```
+## Demo
+```
+You > /style
+      output style off
+      concise — Terse, direct answers — minimal prose, no preamble. (Daily coding work, tool-heavy sessions, or when prompt length matters.)
+      explanatory — Educational answers with short "Insights" that teach as you work. (Learning a codebase, onboarding, …)
+      formal — Formal, precise prose with complete sentences and defined terms. (Reports, documentation, release notes, …)
+      learning — Collaborative learn-by-doing mode with short "Insights" and small hands-on steps for the user. (Pairing, onboarding, …)
+      proactive — Execute immediately, assume reasonable defaults, and prefer action over planning. (Routine multi-step work, …)
+      step-by-step — Numbered reasoning steps with explicit intermediate results. (Debugging, design decisions, …)
+You > /style concise
+      switched to concise
+You > 请只用一句话介绍你自己。
+AI  > 我是运行在 DeepSeek Harness 插件化平台上、基于 deepseek-v4-pro 模型的 AI 编码代理。
+```
+## How it works
+```mermaid
+flowchart LR
+    U[You type /style concise] --> C[command registry]
+    C -->|command/run logged| L[(session log)]
+    C -->|put {style, source}| D[(output_style domain)]
+    D --> R[OutputStyleRuntime]
+    R -->|body at every assembly| S[systemPrompt section order 90]
+    S --> M[Model request]
+    M -->|full system prompt| H[request/header logged]
+```
+Tudo o que o modelo vê é reconstruível a partir do log de sessão — sem novo tipo de evento de sessão, sem alterações no agent-loop. O nome do estilo vem de `command/run`, o texto exato injetado de `request/header`, e o marcador de procedência `{ kind: 'plugin', plugin: 'dsh-output-styles' }` viaja no registro do domínio. Os estilos se aplicam apenas à conversa principal; sessões de subagente mantêm seus próprios prompts (como no Claude Code).
+## Install & uninstall
+- **canal git** (último `main`): `dsh plugin --profile web add "github:PerryLink/dsh-output-styles#main"` — o script `prepare` compila apenas com dependências de produção.
+- **canal npm** (versões publicadas): `dsh plugin --profile web add dsh-output-styles`.
+- **canal tarball**: `pnpm pack` neste repo, depois `dsh plugin --profile web add ./dsh-output-styles-<version>.tgz`.
+- **desinstalar**: `dsh plugin --profile web remove dsh-output-styles`.
+## Configuration
+Todos os parâmetros são campos Schemastery `Config` (alteráveis pelo cordis.yml). Valores inválidos falham a carga.
+| Key | Default | Meaning |
+|---|---|---|
+| `stylesDir` | `[]` | Diretórios da biblioteca, resolvidos contra o cwd; entradas posteriores sobrescrevem as anteriores. `[]` = somente os `styles/` integrados |
+| `maxStyleChars` | `4000` | Orçamento do corpo do estilo (≥ 1); corpos mais longos são truncados com um marcador |
+| `defaultStyle` | `''` | Estilo para sessões que nunca escolheram um (e sem padrão em settings); `''` = sem estilo |
+| `compatJson` | `true` | Carregar entradas JSON `outputStyles` do Claude Code (objetos avulsos ou arrays) |
+| `sectionOrder` | `90` | Ordem da seção injetada (0 = persona, 100–199 = guia de ferramentas) |
+| `truncationMarker` | `"\n\n[style truncated]"` | Marcador anexado no ponto de truncamento |
+| `includeBuiltins` | `true` | Incluir os `styles/` do pacote como camada de menor prioridade |
+| `watchStyles` | `true` | Recarregar a biblioteca quando um arquivo de estilo muda em disco |
+| `rules` | `[]` | Regras de render por sessão/ferramenta: `[{ match: { tool?, contentType?, session? }, style, priority? }]` |
+| `enableExport` | `true` | Registrar o comando `/export` (exportação de sessão Markdown/HTML, ciente do renderer) |
+## Tools & surfaces
+| Surface | Kind | Notes |
+|---|---|---|
+| `/style` | command | Lista estilos, alterna ou restaura o padrão do projeto |
+| `/export` | command | Renderiza a sessão atual para Markdown ou HTML saneado |
+| `output_style` | storage domain | Escolha de estilo por sessão, indexada por sessionId |
+| `systemPrompt.section()` | contribution | Injeta o corpo do estilo atual a cada montagem |
+| `output.render.*` | renderer registry | `ctx.outputRenderers` + a cascata `output.render/before` |
+| `style` | projection | `{ options, currentValue }` dobrado a partir de comandos assentados |
+| Web picker | client entry | `dsh-output-styles/client` decora `/style` com um seletor pop-up |
+## Command reference
+| Input | Outcome |
+|---|---|
+| `/style` | Lista a seleção atual + uma linha por estilo (nome — descrição) |
+| `/style concise` | Alterna (escrita durável), `switched to concise` |
+| `/style Diagrams first` | Nomes com várias palavras são o restante inteiro |
+| `/style off` | Restaura o padrão do projeto (default de settings, depois `defaultStyle`) |
+| `/style nope` | `error: unknown output style "nope" (available: …)` |
+| `/export` | Renderiza a sessão atual para Markdown pela pipeline de render |
+| `/export html` | Renderiza para HTML saneado |
+| `/export --renderer=concise` | Renderiza forçando um renderer (regras ignoradas) |
+## Style library
+Um arquivo Markdown por estilo; frontmatter para metadados, corpo = a diretiva do modelo. `name` toma por padrão o nome do arquivo e pode conter espaços (`Diagrams first`).
+| Field | Default | Meaning |
+|---|---|---|
+| `name` | nome do arquivo | Alvo da alternância; letras, dígitos, espaços e hífens (`off` é reservado) |
+| `description` | — (obrigatório) | Uma frase exibida nas listagens e no seletor |
+| `whenToUse` | — | Orientação opcional anexada às listagens |
+| `keep-coding-instructions` | `false` | Manter o prompt do harness quando `true`; substituí-lo quando `false` (semântica Claude Code) |
+| `force-for-plugin` | `false` | Aplicar incondicionalmente, sobrescrevendo qualquer seleção de sessão; `force` é um alias, no máximo um estilo pode defini-lo |
+Com `compatJson: true`, entradas JSON `outputStyles` do Claude Code (`{ name, description, prompt }`) carregam ao lado dos estilos Markdown; entradas não analisáveis são omitidas com um aviso.
+## Renderer protocol
+O protocolo `output.render.*` transforma a apresentação em um ponto de extensão. Um renderer é um **presenter puro** — `presenter(text, context)` mapeia argumentos para dados de exibição, nunca toca o DOM — emparelhado por nome de ferramenta e tipo de conteúdo, ordenado por prioridade.
+- **Waterfall primeiro**: toda solicitação de render passa por `output.render/before` (`{ text, context }`); os listeners devem chamar `next()`.
+- **Rules**: `rules: [{ match: { tool: 'bash' }, style: 'concise' }]` nomeia o renderer para solicitações coincidentes; empates se resolvem por `priority` e depois pela ordem da regra.
+- **Built-ins**: `concise` (compactação de espaços + truncamento por orçamento) e `step-by-step` (numeração de passos consistente).
+- **Auditabilidade**: cada resultado de render carrega `{ original, rendered, rendererId, changed }`; o texto renderizado é o que aparece, o original permanece reconstruível a partir do log de sessão.
+## Web picker
+A entrada `dsh.client` decora a invocação nua do comando `/style` com um seletor pop-up: uma linha "off" mais uma linha por estilo da biblioteca (`description · whenToUse`), com a linha ativa marcada. Escolher envia `/style <name>` pelo Remote de comandos, de modo que cada alternância mantém o ciclo de vida durável do comando host. O seletor segue o par de idiomas `zh`/`en` da Web UI.
+## Differences from Claude Code
+| | Claude Code | dsh-output-styles |
+|---|---|---|
+| Arquivos de estilo | `.claude/output-styles` em níveis usuário/projeto/gerenciado | diretórios `stylesDir` + `styles/` integrados, vence o diretório posterior |
+| Estilos personalizados | Markdown, frontmatter `name`/`description`/`keep-coding-instructions`/`force-for-plugin` | Mesmos campos (`force-for-plugin` aceito textualmente, `force` como alias) + `whenToUse` |
+| JSON legado | array `outputStyles` em `settings.json` | Carregado textualmente (`compatJson: true`) |
+| Quando entra em vigor | Após `/clear` ou uma sessão nova | Imediatamente — o prompt do sistema se remonta por solicitação |
+| Subagentes | Estilos não se aplicam | Igual — sessões de subagente mantêm seus próprios prompts |
+| Alternância | menu `/config` ou ajuste `outputStyle` (o comando `/output-style` foi removido na v2.1.91) | comando `/style` + Web picker + settings `output-style.style` |
+## Conflict check
+Filtrado contra o ecossistema DSH antes do desenvolvimento (instantânea 2026-08): nenhum repositório `style`/`output-style` sob [topic:dsh-plugin](https://github.com/topics/dsh-plugin), nenhuma categoria de output-style nas quatro principais [awesome lists](https://github.com/awesome-dsh-plugin/awesome-dsh-plugin), e nenhuma entrada no [catálogo dsh-hub](https://github.com/omdsh-dev/dsh-hub-workshop). Os vizinhos mais próximos — [dsh-soul-md](https://github.com/Scorp1o117/dsh-soul-md) (persona) e [dsh-claude-marketplace](https://github.com/ben7am1n/dsh-claude-marketplace) (estilos de saída diferidos explicitamente para v0.2+) — são adjacentes, não conflitantes.
+## Permissions & data
+- **Permissions**: o manifesto de workshop declara `fs:read`, `fs:watch`, `storage:read`, `storage:write` e `settings:read`.
+- **Data**: a escolha de estilo vive no domínio de armazenamento `output_style` (indexada por sessionId); nenhum outro estado é persistido, sem solicitações de rede.
+- **Session log**: o nome do estilo vem de `command/run`, o texto exato injetado de `request/header`; o marcador de procedência `{ kind: 'plugin', plugin: 'dsh-output-styles' }` viaja no registro do domínio.
+## Security boundaries
+- **Somente serviços públicos.** Contribui `systemPrompt`, comandos, armazenamento e settings; sem alterações em engine / agent-loop / apiproxy / UI oficial.
+- **Visível para o modelo ⟺ registrado.** Tudo o que o modelo vê é reconstruível a partir do log de sessão — sem novo tipo de evento de sessão, sem alterações no agent-loop.
+- **Original sempre conservado.** Cada render (e `/export`) mantém o texto original ao lado do renderizado; a exportação HTML usa HTML saneado.
+## Known limitations
+- **Somente conversa principal.** Os estilos se aplicam à conversa principal; sessões de subagente mantêm seus próprios prompts (como no Claude Code).
+- **Truncamento.** Corpos de estilo mais longos que `maxStyleChars` são truncados com um marcador.
+- **Arquivos omitidos.** Um arquivo de estilo defeituoso é omitido com um aviso e nunca quebra o profile.
+## Development
+```sh
+pnpm install
+pnpm run typecheck   # ambos os projetos tsc
+pnpm test            # vitest — 107 tests
+pnpm run verify      # typecheck + tests + self-contained (a porta de prepublishOnly)
+pnpm run build       # artefatos lib/ (bundles host + client)
+pnpm pack            # tarball para dsh plugin add
+```
+Lançamentos: empurrar uma etiqueta `v*` cujo sufixo coincide com a versão de `package.json` dispara o workflow Publish — verificação completa e depois publicação no npm com procedência.
+## Topics
+`deepseek-harness`, `dsh`, `dsh-plugin`, `output-style`, `output-styles`, `claude-code`
+## Contributors
+- [@PerryLink](https://github.com/PerryLink) — autor e mantenedor: arquitetura do plugin, biblioteca de estilos, instalação de bundle, Web picker, documentação em cinco idiomas e ferramentas de CI/lançamento.
+## PerryLink DSH Plugin Family
+Este projeto é um dos [15 plugins do DeepSeek Harness](https://github.com/PerryLink) mantidos por [PerryLink](https://github.com/PerryLink). Se este te ajuda, os demais provavelmente também:
+| 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 License 2.0](LICENSE) © 2026 dsh-output-styles contributors