dsh-output-styles 0.2.0

package/README.ko.md

@@ -0,0 +1,197 @@
+<div align="center">
+
+# 🎨 dsh-output-styles
+
+**DeepSeek Harness를 위한 Claude Code `outputStyles`** —— 런타임에, 세션별로, 영구적으로 모델의 출력 스타일을 전환합니다.
+
+[![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)
+[![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)
+
+</div>
+
+---
+
+`/style concise` —— 이제부터 모든 답변이 간결해집니다. `/style step-by-step` —— 모델이 번호 매긴 단계로 설명합니다. `/style off` —— 프로젝트 기본값으로 복귀합니다. 세션당 명령 하나, 재시작에도 유지되며 agent loop 변경은 전혀 없습니다.
+
+## ✨ 기능
+
+| | |
+|---|---|
+| 🗂️ **스타일 라이브러리** | 스타일당 Markdown 파일 하나(`styles/*.md`). frontmatter에 메타데이터를, 본문은 모델 지시문입니다. `name`은 기본값이 파일명이며 공백을 포함할 수 있습니다(`Diagrams first`). |
+| ⌨️ **`/style` 명령** | 인자 없이 실행하면 스타일 목록(설명 포함) + 현재 선택을 표시합니다. `/style <name>`으로 전환하고 `/style off`로 프로젝트 기본값을 복원합니다. `/style` 뒤의 나머지 전체가 스타일 이름입니다. |
+| 💾 **세션 범위 영속화** | 선택은 `output_style` 저장소 도메인에 sessionId를 키로 저장되어, 두 세션이 서로 간섭하지 않고 선택은 재시작 후에도 유지됩니다. |
+| 🧩 **시스템 프롬프트 주입** | `systemPrompt.section()` 기여(order 90)가 매 조립마다 현재 세션의 스타일 본문을 주입합니다. 본문은 설정 가능한 예산으로 잘립니다. |
+| 🎭 **Claude Code `keep-coding-instructions`** | `keep-coding-instructions: false`(Claude Code와 같은 기본값)인 스타일은 시스템 프롬프트 전체를 교체합니다 —— 소프트웨어 엔지니어링에서 벗어나는 스타일용입니다. |
+| 📌 **강제 스타일** | `force: true`는 세션 선택을 무시하고 무조건 스타일을 적용합니다. 강제 스타일이 둘이면 로드가 실패합니다. |
+| 🔁 **Claude Code 호환성** | `outputStyles` JSON 컬렉션(`{ name, description, prompt }`)을 로드하며, 단일 항목 또는 `settings.json` 스타일 배열을 지원합니다. 해석 불가 항목은 경고와 함께 건너뜁니다. |
+| 📚 **계층화된 디렉터리** | `stylesDir`은 목록이며 뒤쪽 디렉터리가 앞쪽을 재정의합니다(내장 `styles/`가 최하위 계층, `includeBuiltins: false`로 비활성화). |
+| 🔄 **핫 리로드** | 스타일 파일 변경이 재시작 없이 반영됩니다(`watchStyles: false`로 해제). |
+| ⚙️ **설정과 프로젝트 기본값** | 한 번도 선택하지 않은 세션은 DSH 설정의 `output-style.style`, 그다음 `defaultStyle`로 폴백합니다. |
+| 🖱️ **웹 피커** | `dsh.client` 항목(`dsh-output-styles/client`)이 호스트의 `/style` 명령을 프로젝션 기반 팝업 피커로 꾸밉니다. |
+| 📊 **세션 프로젝션** | Web UI용 `style` 프로젝션(`{ options, currentValue }`)으로, 세션 로그에서 확정된 명령으로부터 폴딩됩니다. |
+| 🧯 **명확한 실패, 깔끔한 건너뜀** | 잘못된 설정은 로드 시 예외를 던집니다. 잘못된 스타일 파일은 경고와 함께 건너뛰며 프로필을 깨뜨리지 않습니다. |
+| 🌐 **5개 언어 문서** | EN · 中文 · 日本語 · 한국어 · Español. |
+
+## 🚀 빠른 시작
+
+```sh
+# 1. 설치 — 이 패키지는 번들 레이어이므로 한 명령으로
+#    storage + storage-json + storage-domain + 플러그인 행이 구성됩니다:
+dsh plugin --profile <name> add dsh-output-styles
+
+# 2. 부팅하고 전환
+dsh --profile <name>
+/style               # → output style off, 그다음 스타일별 한 줄
+/style concise       # → switched to concise
+/style Diagrams first  # → 공백 포함 이름도 동작
+/style off           # → 프로젝트 기본값으로 복귀
+```
+
+이 레이어는 웹 프로필에 대해 멱등적입니다(id 기준 삽입이 동일 id 행을 대체). 웹 프로필은 `storage`를 기본으로 포함합니다. 웹 피커를 사용하려면 프로필에 클라이언트 행을 추가하세요:
+
+```yaml
+- id: output-styles-client
+  name: 'dsh-output-styles/client'
+```
+
+## 🎬 데모
+
+```
+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, …)
+      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 코딩 에이전트입니다.
+```
+
+## 🧠 동작 방식
+
+```mermaid
+flowchart LR
+    U[/style concise 입력] --> C[명령 레지스트리]
+    C -->|command/run 기록| L[(세션 로그)]
+    C -->|put {style, source}| D[(output_style 도메인)]
+    D --> R[OutputStyleRuntime]
+    R -->|매 조립마다 본문 주입| S[systemPrompt 섹션 order 90]
+    S --> M[모델 요청]
+    M -->|전체 시스템 프롬프트| H[request/header 기록]
+```
+
+모델이 보는 모든 것은 세션 로그에서 재구성할 수 있습니다 —— 새로운 세션 이벤트 타입도, agent-loop 변경도 없습니다. 스타일 이름은 `command/run`에서, 주입된 정확한 텍스트는 `request/header`에서 나오며, 출처 마커 `{ kind: 'plugin', plugin: 'dsh-output-styles' }`는 도메인 레코드에 남습니다. 스타일은 메인 대화에만 적용되며, 하위 에이전트 세션은 자체 프롬프트를 유지합니다(Claude Code와 일치).
+
+## ⚙️ 설정
+
+모든 조정 값은 검증된 Schemastery `Config` 필드입니다(잘못된 값은 로드 실패):
+
+| 필드 | 기본값 | 의미 |
+|---|---|---|
+| `stylesDir` | `[]` | 스타일 라이브러리 디렉터리. cwd 기준으로 해석되며 뒤쪽 항목이 앞쪽을 재정의합니다. `[]` = 내장 `styles/`만. 단순 문자열은 단일 디렉터리 목록입니다. |
+| `maxStyleChars` | `4000` | 스타일 본문 예산(코드 포인트, ≥ 1). 더 긴 본문은 마커와 함께 잘립니다. |
+| `defaultStyle` | `''` | 한 번도 선택하지 않은 세션(설정 기본값도 없음)에 적용할 스타일. `''` = 스타일 없음. |
+| `compatJson` | `true` | Claude Code `outputStyles` JSON 항목(단일 객체 또는 배열)을 로드합니다. |
+| `sectionOrder` | `90` | 주입 섹션의 순서(0 = persona, 100–199 = 도구 지침). |
+| `truncationMarker` | `"\n\n[style truncated]"` | 잘린 지점에 추가되는 마커. |
+| `includeBuiltins` | `true` | 패키지 내장 `styles/`를 최저 우선순위 계층으로 포함합니다. |
+| `watchStyles` | `true` | 디스크에서 스타일 파일이 변경되면 라이브러리를 다시 로드합니다. |
+
+## 📚 스타일 라이브러리
+
+<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>
+
+frontmatter 필드:
+
+| 필드 | 기본값 | 의미 |
+|---|---|---|
+| `name` | 파일명 | 전환 대상. 문자, 숫자, 공백, 하이픈(선행/후행 공백 없음. `off`는 예약됨). |
+| `description` | —(필수) | 목록과 피커에 표시되는 한 문장. |
+| `whenToUse` | — | 목록에 덧붙이는 선택적 안내. |
+| `keep-coding-instructions` | `false` | `true`면 하네스 프롬프트(정체성, persona, 도구 지침)를 유지하고, `false`면 완전히 교체합니다(Claude Code 의미론). |
+| `force` | `false` | 세션 선택을 무시하고 무조건 적용합니다. 최대 한 스타일만 설정할 수 있습니다. |
+
+<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." }
+```
+
+레거시 `settings.json` 배열(`[{ … }, { … }]`)은 그대로 로드되고, 잘못된 항목은 경고와 함께 건너뜁니다.
+
+</details>
+
+## ⌨️ 명령 레퍼런스
+
+| 입력 | 결과 |
+|---|---|
+| `/style` | 현재 선택 + 스타일별 한 줄(name — description) 나열 |
+| `/style concise` | 전환(영구 기록), `switched to concise` |
+| `/style Diagrams first` | 여러 단어 이름은 나머지 전체 |
+| `/style off` | 프로젝트 기본값 복원(설정 기본값, 그다음 `defaultStyle`) |
+| `/style nope` | `error: unknown output style "nope" (available: …)` |
+
+## 🖱️ 웹 피커
+
+`dsh.client` 항목은 호스트 `/style` 명령의 인자 없는 호출을 팝업 피커로 꾸밉니다: 「off」 행 + 라이브러리 스타일별 한 행(`description · whenToUse`), 활성 행이 표시됩니다. 선택하면 명령 Remote를 통해 `/style <name>`을 제출하므로, 모든 전환이 호스트의 영구적인 명령 수명 주기를 유지하고 `style` 프로젝션이 유일하게 표시되는 사실로 남습니다.
+
+## 🔍 충돌 검사
+
+개발 전 DSH 생태계를 조사했습니다(2026-08 스냅샷): [topic:dsh-plugin](https://github.com/topics/dsh-plugin) 아래 `style`/`output-style` 저장소 없음, 4대 [awesome 목록](https://github.com/awesome-dsh-plugin/awesome-dsh-plugin)에 output-style 카테고리 없음, [dsh-hub 카탈로그](https://github.com/omdsh-dev/dsh-hub-workshop)에도 항목 없음. 가장 가까운 이웃인 [dsh-soul-md](https://github.com/Scorp1o117/dsh-soul-md)(persona)와 [dsh-claude-marketplace](https://github.com/ben7am1n/dsh-claude-marketplace)(출력 스타일을 명시적으로 v0.2+로 연기)은 인접하지만 충돌하지 않습니다.
+
+## 🆚 Claude Code와의 차이
+
+| | Claude Code | dsh-output-styles |
+|---|---|---|
+| 스타일 파일 | 사용자/프로젝트/관리 계층의 `.claude/output-styles` | `stylesDir` 디렉터리 + 내장 `styles/`, 뒤쪽 디렉터리가 우선 |
+| 사용자 정의 스타일 | Markdown, frontmatter `name`/`description`/`keep-coding-instructions`/`force-for-plugin` | 동일 필드(`force` = `force-for-plugin`) + `whenToUse` |
+| 레거시 JSON | `settings.json`의 `outputStyles` 배열 | 그대로 로드(`compatJson: true`) |
+| 적용 시점 | `/clear` 후 또는 새 세션 | 즉시 — 시스템 프롬프트가 요청마다 재조립 |
+| 하위 에이전트 | 스타일 미적용 | 동일 — 하위 에이전트 세션은 자체 프롬프트 유지 |
+| 전환 | `/config` 메뉴 또는 `outputStyle` 설정(`/output-style` 명령은 v2.1.91에서 제거) | `/style` 명령 + 웹 피커 + 설정 `output-style.style` |
+
+## 🧪 개발
+
+```sh
+pnpm install
+pnpm run typecheck   # 두 tsc 프로젝트
+pnpm test            # vitest — 87 테스트
+pnpm run build       # lib/ 산출물(호스트 + 클라이언트 번들)
+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/`(내장 스타일).
+
+## 📄 라이선스
+
+[Apache-2.0](LICENSE) © 2026 dsh-output-styles contributors
+
+---
+
+<sub>Topics: `dsh` · `dsh-plugin` · `deepseek-harness` · `output-styles` · `claude-code`</sub>

package/README.md

@@ -0,0 +1,197 @@
+<div align="center">
+
+# 🎨 dsh-output-styles
+
+**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)
+[![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)
+
+</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.
+
+## ✨ Features
+
+| | |
+|---|---|
+| 🗂️ **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`). |
+| ⌨️ **`/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** | `force: true` 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. |
+| 🧯 **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
+
+```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
+```
+
+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:
+
+```yaml
+- id: output-styles-client
+  name: 'dsh-output-styles/client'
+```
+
+## 🎬 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, …)
+      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]
+```
+
+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
+
+Every tunable is a validated Schemastery `Config` field (invalid values fail the load):
+
+| 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. |
+
+## 📚 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>
+
+Frontmatter fields:
+
+| Field | 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` | `false` | Apply unconditionally, overriding any session selection; 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." }
+```
+
+Legacy `settings.json` arrays (`[{ … }, { … }]`) load as-is; bad entries are skipped with a warning.
+
+</details>
+
+## ⌨️ Command reference
+
+| Input | Outcome |
+|---|---|
+| `/style` | List 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`) |
+| `/style nope` | `error: unknown output style "nope" (available: …)` |
+
+## 🖱️ 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 and the `style` projection stays the single displayed fact.
+
+## 🔍 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.
+
+## 🆚 Differences from Claude Code
+
+| | Claude Code | dsh-output-styles |
+|---|---|---|
+| Style files | `.claude/output-styles` at user/project/managed levels | `stylesDir` directories + bundled `styles/`, later directory wins |
+| Custom styles | Markdown, frontmatter `name`/`description`/`keep-coding-instructions`/`force-for-plugin` | Same fields (`force` = `force-for-plugin`) + `whenToUse` |
+| Legacy JSON | `outputStyles` array in `settings.json` | Loaded verbatim (`compatJson: true`) |
+| Taking effect | After `/clear` or a new session | Immediately — the system prompt re-assembles per request |
+| 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
+
+```sh
+pnpm install
+pnpm run typecheck   # both tsc projects
+pnpm test            # vitest — 87 tests
+pnpm run build       # lib/ artifacts (host + client bundles)
+pnpm pack            # tarball for dsh plugin add
+```
+
+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).
+
+## 📄 License
+
+[Apache-2.0](LICENSE) © 2026 dsh-output-styles contributors
+
+---
+
+<sub>Topics: `dsh` · `dsh-plugin` · `deepseek-harness` · `output-styles` · `claude-code`</sub>

package/README.zh.md

@@ -0,0 +1,197 @@
+<div align="center">
+
+# 🎨 dsh-output-styles
+
+**DeepSeek Harness 版的 Claude Code `outputStyles`** —— 在运行时、按会话、持久地切换模型输出风格。
+
+[![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)
+[![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)
+
+</div>
+
+---
+
+`/style concise` —— 从此之后每条回复都简洁。`/style step-by-step` —— 模型按编号步骤叙述推理。`/style off` —— 回到项目默认。每会话一条命令、重启后依然生效、零 agent-loop 改动。
+
+## ✨ 特性
+
+| | |
+|---|---|
+| 🗂️ **风格库** | 每个风格一个 Markdown 文件（`styles/*.md`）；frontmatter 存元数据，正文即模型指令。`name` 缺省继承文件名，且可含空格（如 `Diagrams first`）。 |
+| ⌨️ **`/style` 命令** | 无参列出全部风格（含描述）与当前选择；`/style <name>` 切换；`/style off` 恢复项目默认。`/style` 之后的整段文本即风格名。 |
+| 💾 **会话级持久化** | 选择保存在 `output_style` 存储域，按 sessionId 隔离——会话互不干扰，重启后保留。 |
+| 🧩 **系统提示注入** | `systemPrompt.section()` 贡献（order 90）在每次组装时注入当前会话的风格正文；正文按可配置预算截断。 |
+| 🎭 **Claude Code `keep-coding-instructions`** | `keep-coding-instructions: false`（缺省，与 Claude Code 一致）的风格**替换整个系统提示**——适合彻底离开软件工程的风格。 |
+| 📌 **强制风格** | `force: true` 无条件生效，覆盖任何会话选择；两个强制风格会在加载期报错。 |
+| 🔁 **Claude Code 兼容** | 加载 `outputStyles` JSON 集合（`{ name, description, prompt }`），支持单对象与 `settings.json` 式数组；坏条目逐个跳过并警告。 |
+| 📚 **目录分层** | `stylesDir` 是目录列表，后者覆盖前者（内置 `styles/` 是最低层，`includeBuiltins: false` 可排除）。 |
+| 🔄 **热加载** | 风格文件改动即时生效，无需重启（`watchStyles: false` 可关闭）。 |
+| ⚙️ **settings 项目默认** | 从未选择过的会话依次回落到 settings 的 `output-style.style`、再回落 `defaultStyle`。 |
+| 🖱️ **Web 选择器** | `dsh.client` 入口（`dsh-output-styles/client`）把宿主 `/style` 命令装饰成投影驱动的弹窗选择器。 |
+| 📊 **会话投影** | `style` 投影（`{ options, currentValue }`）供 Web UI 使用，按会话日志中**已成功落定**的命令折叠。 |
+| 🧯 **失效即响、坏件干净跳过** | 配置错误加载期抛错；坏风格文件跳过并警告，绝不拖垮 profile。 |
+| 🌐 **五语文档** | EN · 中文 · 日本語 · 한국어 · Español。 |
+
+## 🚀 快速开始
+
+```sh
+# 1. 安装——本包是 bundle 补丁层，一条命令即组合好
+#    storage + storage-json + storage-domain + 插件行：
+dsh plugin --profile <name> add dsh-output-styles
+
+# 2. 启动并切换
+dsh --profile <name>
+/style               # → 当前状态 + 每风格一行
+/style concise       # → switched to concise
+/style Diagrams first  # → 含空格的名字同样可用
+/style off           # → 回到项目默认
+```
+
+该补丁层对 web profile 幂等（按 id 插入会替换同 id 行），web profile 本就内建 storage 三行。使用 Web 选择器时，向 profile 添加客户端行：
+
+```yaml
+- id: output-styles-client
+  name: 'dsh-output-styles/client'
+```
+
+## 🎬 演示
+
+```
+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, …)
+      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 编码代理。
+```
+
+## 🧠 工作原理
+
+```mermaid
+flowchart LR
+    U[输入 /style concise] --> C[命令注册表]
+    C -->|记录 command/run| L[(会话日志)]
+    C -->|写入 {style, source}| D[(output_style 域)]
+    D --> R[OutputStyleRuntime]
+    R -->|每次组装注入正文| S[systemPrompt 节 order 90]
+    S --> M[模型请求]
+    M -->|完整系统提示| H[记录 request/header]
+```
+
+模型所见的一切都能从会话日志重建——无需新增会话事件类型、不改 agent-loop。风格名来自 `command/run`，注入的确切文本来自 `request/header`，来源标记 `{ kind: 'plugin', plugin: 'dsh-output-styles' }` 随域记录存储。风格只作用于主会话；子代理会话保持各自的提示（与 Claude Code 一致）。
+
+## ⚙️ 配置
+
+所有可调项都是带校验的 Schemastery `Config` 字段（非法值加载即失败）：
+
+| 字段 | 默认 | 含义 |
+|---|---|---|
+| `stylesDir` | `[]` | 风格库目录列表，相对 cwd 解析；后者覆盖前者。`[]` = 仅内置 `styles/`。裸字符串视为单目录列表。 |
+| `maxStyleChars` | `4000` | 风格正文预算（码点，≥ 1）；超长正文截断并加标记。 |
+| `defaultStyle` | `''` | 从未选择过的会话（且无 settings 默认）使用的风格；`''` = 不注入。 |
+| `compatJson` | `true` | 加载 Claude Code `outputStyles` JSON 条目（单对象或数组）。 |
+| `sectionOrder` | `90` | 注入节顺序（0 = persona，100–199 = 工具指引）。 |
+| `truncationMarker` | `"\n\n[style truncated]"` | 截断点追加的标记。 |
+| `includeBuiltins` | `true` | 将包内置 `styles/` 作为最低优先级层纳入。 |
+| `watchStyles` | `true` | 风格文件在磁盘上变化时重载风格库。 |
+
+## 📚 风格库
+
+<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>
+
+frontmatter 字段：
+
+| 字段 | 默认 | 含义 |
+|---|---|---|
+| `name` | 文件名 | 切换目标；字母、数字、空格、连字符（首尾无空白；`off` 为保留字）。 |
+| `description` | ——（必填） | 列表与选择器里展示的一句话。 |
+| `whenToUse` | —— | 可选适用场景说明，追加到列表。 |
+| `keep-coding-instructions` | `false` | `true` 保留宿主提示（身份、persona、工具指引）；`false` 整体替换（Claude Code 语义）。 |
+| `force` | `false` | 无条件生效，覆盖会话选择；最多一个风格可设置。 |
+
+<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." }
+```
+
+旧版 `settings.json` 的数组形式（`[{ … }, { … }]`）原样加载；坏条目逐个跳过并警告。
+
+</details>
+
+## ⌨️ 命令参考
+
+| 输入 | 结果 |
+|---|---|
+| `/style` | 列出当前选择 + 每风格一行（名称 — 描述） |
+| `/style concise` | 切换（持久写入），`switched to concise` |
+| `/style Diagrams first` | 含空格的风格名 = `/style` 后的整段文本 |
+| `/style off` | 恢复项目默认（先 settings 默认，后 `defaultStyle`） |
+| `/style nope` | `error: unknown output style "nope" (available: …)` |
+
+## 🖱️ Web 选择器
+
+`dsh.client` 入口把宿主 `/style` 命令的裸调用装饰成弹窗选择器：「off」行 + 每风格一行（`描述 · 适用场景`），当前行高亮。选中即通过命令 Remote 提交 `/style <name>`，因此每次切换都保留宿主的持久命令生命周期，`style` 投影始终是唯一展示事实。
+
+## 🔍 生态冲突检查
+
+开发前对 DSH 生态做了筛查（2026-08 快照）：[topic:dsh-plugin](https://github.com/topics/dsh-plugin) 下没有 `style`/`output-style` 仓库，四大 [awesome 列表](https://github.com/awesome-dsh-plugin/awesome-dsh-plugin) 没有 output-style 分类，[dsh-hub 目录](https://github.com/omdsh-dev/dsh-hub-workshop) 亦无条目。最接近的邻居——[dsh-soul-md](https://github.com/Scorp1o117/dsh-soul-md)（persona）与 [dsh-claude-marketplace](https://github.com/ben7am1n/dsh-claude-marketplace)（明确将输出风格推迟到 v0.2+）——相邻而不冲突。
+
+## 🆚 与 Claude Code 的差异
+
+| | Claude Code | dsh-output-styles |
+|---|---|---|
+| 风格文件 | 用户/项目/托管层级的 `.claude/output-styles` | `stylesDir` 目录 + 内置 `styles/`，后目录胜出 |
+| 自定义风格 | Markdown，frontmatter `name`/`description`/`keep-coding-instructions`/`force-for-plugin` | 同字段（`force` 对应 `force-for-plugin`）+ `whenToUse` |
+| 旧版 JSON | `settings.json` 里的 `outputStyles` 数组 | 原样加载（`compatJson: true`） |
+| 生效时机 | `/clear` 或新会话后 | 立即生效——系统提示每次请求重组 |
+| 子代理 | 风格不适用 | 一致——子代理会话保持各自提示 |
+| 切换方式 | `/config` 菜单或 `outputStyle` 设置（`/output-style` 命令已在 v2.1.91 移除） | `/style` 命令 + Web 选择器 + settings `output-style.style` |
+
+## 🧪 开发
+
+```sh
+pnpm install
+pnpm run typecheck   # 两个 tsc 工程
+pnpm test            # vitest —— 87 个测试
+pnpm run build       # lib/ 产物（宿主 + 客户端两个 bundle）
+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/`（内置风格）。
+
+## 📄 License
+
+[Apache-2.0](LICENSE) © 2026 dsh-output-styles contributors
+
+---
+
+<sub>Topics: `dsh` · `dsh-plugin` · `deepseek-harness` · `output-styles` · `claude-code`</sub>

package/cordis.patch.yml

@@ -0,0 +1,40 @@
+# Patch layer for `dsh-output-styles`, declared by the package's
+# `dsh.bundle.patch` manifest and also usable by hand with `--patch`.
+#
+# Inserting rows by id replaces any same-id row already in the profile, so
+# the layer is safe on top of a web profile (which composes storage in box)
+# and completes a bare headless profile.
+#
+# The plugin injects `storageDomain`; a headless profile has none of the
+# storage rows, so the layer brings the routed kv backend along.
+- insert:
+    - id: storage
+      name: '@deepseek-ai/dsh-storage'
+    - id: storage-json
+      name: '@deepseek-ai/dsh-storage-json'
+    - id: storage-domain
+      name: '@deepseek-ai/dsh-storage-domain'
+    - id: output-styles
+      name: 'dsh-output-styles'
+      # config:                     # schema defaults shown for reference
+      #   stylesDir: []             # [] = bundled styles/ only (lowest priority)
+      #   maxStyleChars: 4000
+      #   defaultStyle: ''          # '' = new sessions get no style
+      #   compatJson: true
+      #   sectionOrder: 90
+      #   truncationMarker: "\n\n[style truncated]"
+      #   includeBuiltins: true
+      #   watchStyles: true
+
+    # Optional invariant companion (envelope-level checks). Only for profiles
+    # that DISABLE the main row above: the main plugin already registers
+    # library-aware checks when an `invariants` service is composed, and the
+    # host registry accepts one registrant per package name.
+    # - id: output-styles-invariant
+    #   name: 'dsh-output-styles/invariant'
+
+    # Optional Web picker (browser half). Only for web profiles whose client
+    # bundle composes the client runtime services; headless profiles must not
+    # enable this row.
+    # - id: output-styles-client
+    #   name: 'dsh-output-styles/client'