dsh-output-styles 0.4.0 โ 0.4.1
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.
- package/CHANGELOG.md +6 -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/index.js +3 -2
- 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 +14 -6
- package/src/runtime.ts +5 -2
- package/README.ja.md +0 -217
- package/README.ko.md +0 -217
package/README.ja.md
DELETED
|
@@ -1,217 +0,0 @@
|
|
|
1
|
-
<div align="center">
|
|
2
|
-
|
|
3
|
-
# ๐จ dsh-output-styles
|
|
4
|
-
|
|
5
|
-
**DeepSeek Harness ๅใ Claude Code `outputStyles`** โโ ใขใใซใฎๅบๅในใฟใคใซใๅฎ่กๆใซใใปใใทใงใณๅไฝใงใๆฐธ็ถ็ใซๅใๆฟใใพใใ
|
|
6
|
-
|
|
7
|
-
[](LICENSE)
|
|
8
|
-
[](https://github.com/PerryLink/dsh-output-styles/actions/workflows/ci.yml)
|
|
9
|
-
[](https://www.npmjs.com/package/dsh-output-styles)
|
|
10
|
-
[](https://www.npmjs.com/package/dsh-output-styles)
|
|
11
|
-
[](#)
|
|
12
|
-
[](#)
|
|
13
|
-
[](#)
|
|
14
|
-
|
|
15
|
-
๐ [English](README.md) ยท [ไธญๆ](README.zh.md) ยท [ๆฅๆฌ่ช](README.ja.md) ยท [ํ๊ตญ์ด](README.ko.md) ยท [Espaรฑol](README.es.md)
|
|
16
|
-
|
|
17
|
-
</div>
|
|
18
|
-
|
|
19
|
-
---
|
|
20
|
-
|
|
21
|
-
`/style concise` โโ ใใไปฅ้ใฎ่ฟไฟกใฏใในใฆ็ฐกๆฝใซใชใใพใใ`/style step-by-step` โโ ใขใใซใ็ชๅทไปใใฎๆ้ ใง่ชฌๆใใพใใ`/style off` โโ ใใญใธใงใฏใใฎใใใฉใซใใซๆปใใพใใใปใใทใงใณใใจใซ 1 ใณใใณใใๅ่ตทๅใใพใใใงไฟๆใใใagent loop ใซใฏไธๅๅคๆดใๅ ใใพใใใ
|
|
22
|
-
|
|
23
|
-
## โจ ๆฉ่ฝ
|
|
24
|
-
|
|
25
|
-
| | |
|
|
26
|
-
|---|---|
|
|
27
|
-
| ๐๏ธ **ในใฟใคใซใฉใคใใฉใช** | ในใฟใคใซใใจใซ 1 ใคใฎ Markdown ใใกใคใซ๏ผ`styles/*.md`๏ผใfrontmatter ใซใกใฟใใผใฟใๆฌๆใใขใใซใธใฎๆ็คบใงใใ`name` ใฏๆขๅฎใงใใกใคใซๅใซใชใใ็ฉบ็ฝใๅซใใพใ๏ผ`Diagrams first`๏ผใๅๆขฑใฎ็ตใฟ่พผใฟในใฟใคใซใฏ 6 ็จฎใงใClaude Code ใจๅ็ญใฎ `proactive` ใจ `learning` ใๅซใฟใพใใ |
|
|
28
|
-
| โจ๏ธ **`/style` ใณใใณใ** | ๅผๆฐใชใใงในใฟใคใซไธ่ฆง๏ผ่ชฌๆไปใ๏ผใจ็พๅจใฎ้ธๆใ่กจ็คบใ`/style <name>` ใงๅใๆฟใใ`/style off` ใงใใญใธใงใฏใใฎใใใฉใซใใๅพฉๅ
ใใพใใ`/style` ใใๅพใฎๆฎใๅ
จไฝใในใฟใคใซๅใงใใ |
|
|
29
|
-
| ๐พ **ใปใใทใงใณๅไฝใฎๆฐธ็ถๅ** | ้ธๆใฏ `output_style` ในใใฌใผใธใใกใคใณใซ sessionId ใใญใผใจใใฆไฟๆใใใ2 ใคใฎใปใใทใงใณใๅนฒๆธใใใใจใฏใชใใ้ธๆใฏๅ่ตทๅๅพใๆฎใใพใใ |
|
|
30
|
-
| ๐งฉ **ใทในใใ ใใญใณใใๆณจๅ
ฅ** | `systemPrompt.section()` ใฎ่ฒข็ฎ๏ผorder 90๏ผใใๆฏๅใฎ็ตใฟ็ซใฆใง็พๅจใฎใปใใทใงใณใฎในใฟใคใซๆฌๆใๆณจๅ
ฅใใพใใๆฌๆใฏ่จญๅฎๅฏ่ฝใชใใธใงใใใงๅใ่ฉฐใใใใพใใ |
|
|
31
|
-
| ๐ญ **Claude Code `keep-coding-instructions`** | `keep-coding-instructions: false`๏ผClaude Code ใจๅใๆขๅฎ๏ผใฎในใฟใคใซใฏใทในใใ ใใญใณใใๅ
จไฝใ็ฝฎใๆใใพใโโใฝใใใฆใงใขใจใณใธใใขใชใณใฐใใ้ขใใในใฟใคใซๅใใงใใ |
|
|
32
|
-
| ๐ **ๅผทๅถในใฟใคใซ** | Claude Code ใฎ `force-for-plugin`๏ผใจใคใชใขใน `force`๏ผใฏใปใใทใงใณใฎ้ธๆใ็ก่ฆใใฆ็กๆกไปถใซในใฟใคใซใ้ฉ็จใใพใใๅผทๅถในใฟใคใซใ 2 ใคใใใจ่ชญใฟ่พผใฟใซๅคฑๆใใพใใ |
|
|
33
|
-
| ๐ **Claude Code ไบๆๆง** | `outputStyles` JSON ใณใฌใฏใทใงใณ๏ผ`{ name, description, prompt }`๏ผใ่ชญใฟ่พผใฟใพใใๅไธใจใณใใชใพใใฏ `settings.json` ๅฝขๅผใฎ้
ๅใซๅฏพๅฟใใ่งฃๆไธ่ฝใชใจใณใใชใฏ่ญฆๅไปใใงในใญใใใใพใใ |
|
|
34
|
-
| ๐ **ใใฃใฌใฏใใชใฎ้ๅฑคๅ** | `stylesDir` ใฏใชในใใงใๅพๆนใฎใใฃใฌใฏใใชใๅๆนใฎใใฎใไธๆธใใใพใ๏ผๅๆขฑใฎ `styles/` ใๆไธๅฑคใงใ`includeBuiltins: false` ใง็กๅนๅ๏ผใ |
|
|
35
|
-
| ๐ **ใใใใชใญใผใ** | ในใฟใคใซใใกใคใซใฎๅคๆดใฏๅ่ตทๅใชใใงๅๆ ใใใพใ๏ผ`watchStyles: false` ใง็กๅนๅ๏ผใ |
|
|
36
|
-
| โ๏ธ **settings ใจใใญใธใงใฏใใใใฉใซใ** | ไธๅบฆใ้ธๆใใฆใใชใใปใใทใงใณใฏใDSH settings ใฎ `output-style.style`ใๆฌกใใง `defaultStyle` ใซใใฉใผใซใใใฏใใพใใ |
|
|
37
|
-
| ๐ฑ๏ธ **Web ใใใซใผ** | `dsh.client` ใจใณใใช๏ผ`dsh-output-styles/client`๏ผใใใในใใฎ `/style` ใณใใณใใๆๅฝฑใใผในใฎใใใใขใใใใใซใผใง่ฃ
้ฃพใใพใใ |
|
|
38
|
-
| ๐ **ใปใใทใงใณๆๅฝฑ** | Web UI ๅใใฎ `style` ๆๅฝฑ๏ผ`{ options, currentValue }`๏ผใใปใใทใงใณใญใฐๅ
ใง็ขบๅฎใใใณใใณใใใๆใใใใพใใพใใ |
|
|
39
|
-
| ๐งฏ **ๅคฑๆใฏๆ็คบใในใญใใใฏใฏใชใผใณใซ** | ่จญๅฎใในใฏ่ชญใฟ่พผใฟๆใซไพๅคใๆใใพใใไธๆญฃใชในใฟใคใซใใกใคใซใฏ่ญฆๅไปใใงในใญใใใใใใใญใใกใคใซใๅฃใใใจใฏใใใพใใใ |
|
|
40
|
-
| ๐ **5 ่จ่ชใฎใใญใฅใกใณใ** | EN ยท ไธญๆ ยท ๆฅๆฌ่ช ยท ํ๊ตญ์ด ยท Espaรฑolใ |
|
|
41
|
-
|
|
42
|
-
## ๐ ใฏใคใใฏในใฟใผใ
|
|
43
|
-
|
|
44
|
-
```sh
|
|
45
|
-
# 1. ใคใณในใใผใซโโใใฎใใใฑใผใธใฏ bundle ใฌใคใคใผใชใฎใงใ1 ใณใใณใใง
|
|
46
|
-
# storage + storage-json + storage-domain + ใใฉใฐใคใณ่กใๆงๆใใใพใ๏ผ
|
|
47
|
-
dsh plugin --profile <name> add dsh-output-styles
|
|
48
|
-
|
|
49
|
-
# 2. ่ตทๅใใฆๅใๆฟใ
|
|
50
|
-
dsh --profile <name>
|
|
51
|
-
/style # โ output style offใใใฎๅพใซในใฟใคใซใใจใซ 1 ่ก
|
|
52
|
-
/style concise # โ switched to concise
|
|
53
|
-
/style Diagrams first # โ ็ฉบ็ฝใๅซใๅๅใไฝฟใใพใ
|
|
54
|
-
/style off # โ ใใญใธใงใฏใใฎใใใฉใซใใซๆปใ
|
|
55
|
-
```
|
|
56
|
-
|
|
57
|
-
ใใฎใฌใคใคใผใฏ web ใใญใใกใคใซใซๅฏพใใฆๅช็ญใงใ๏ผid ๅไฝใฎๆฟๅ
ฅใๅ id ใฎ่กใ็ฝฎใๆใใพใ๏ผใweb ใใญใใกใคใซใซใฏ `storage` ใใใใใใๅซใพใใฆใใพใใWeb ใใใซใผใไฝฟใใซใฏใใใญใใกใคใซใซใฏใฉใคใขใณใ่กใ่ฟฝๅ ใใพใ๏ผ
|
|
58
|
-
|
|
59
|
-
```yaml
|
|
60
|
-
- id: output-styles-client
|
|
61
|
-
name: 'dsh-output-styles/client'
|
|
62
|
-
```
|
|
63
|
-
|
|
64
|
-
## ๐ฌ ใใข
|
|
65
|
-
|
|
66
|
-
```
|
|
67
|
-
You > /style
|
|
68
|
-
output style off
|
|
69
|
-
concise โ Terse, direct answers โ minimal prose, no preamble. (Daily coding work, tool-heavy sessions, or when prompt length matters.)
|
|
70
|
-
explanatory โ Educational answers with short "Insights" that teach as you work. (Learning a codebase, onboarding, โฆ)
|
|
71
|
-
formal โ Formal, precise prose with complete sentences and defined terms. (Reports, documentation, release notes, โฆ)
|
|
72
|
-
learning โ Collaborative learn-by-doing mode with short "Insights" and small hands-on steps for the user. (Pairing, onboarding, โฆ)
|
|
73
|
-
proactive โ Execute immediately, assume reasonable defaults, and prefer action over planning. (Routine multi-step work, โฆ)
|
|
74
|
-
step-by-step โ Numbered reasoning steps with explicit intermediate results. (Debugging, design decisions, โฆ)
|
|
75
|
-
|
|
76
|
-
You > /style concise
|
|
77
|
-
switched to concise
|
|
78
|
-
|
|
79
|
-
You > ไธๆใ ใใง่ชๅทฑ็ดนไปใใฆใใ ใใใ
|
|
80
|
-
AI > ็งใฏ DeepSeek Harness ใใฉใฐใคใณใใฉใใใใฉใผใ ไธใงๅไฝใใใdeepseek-v4-pro ใขใใซใใผในใฎ AI ใณใผใใฃใณใฐใจใผใธใงใณใใงใใ
|
|
81
|
-
```
|
|
82
|
-
|
|
83
|
-
## ๐ง ไป็ตใฟ
|
|
84
|
-
|
|
85
|
-
```mermaid
|
|
86
|
-
flowchart LR
|
|
87
|
-
U[/style concise ใจๅ
ฅๅ] --> C[ใณใใณใใฌใธในใใช]
|
|
88
|
-
C -->|command/run ใ่จ้ฒ| L[(ใปใใทใงใณใญใฐ)]
|
|
89
|
-
C -->|put {style, source}| D[(output_style ใใกใคใณ)]
|
|
90
|
-
D --> R[OutputStyleRuntime]
|
|
91
|
-
R -->|ๆฏๅใฎ็ตใฟ็ซใฆใงๆฌๆใๆณจๅ
ฅ| S[systemPrompt ใปใฏใทใงใณ order 90]
|
|
92
|
-
S --> M[ใขใใซใชใฏใจในใ]
|
|
93
|
-
M -->|ๅฎๅ
จใชใทในใใ ใใญใณใใ| H[request/header ใ่จ้ฒ]
|
|
94
|
-
```
|
|
95
|
-
|
|
96
|
-
ใขใใซใ่ฆใใใฎใฏใในใฆใปใใทใงใณใญใฐใใๅๆง็ฏใงใใพใโโๆฐใใใปใใทใงใณใคใใณใๅใ agent-loop ใฎๅคๆดใไธ่ฆใงใใในใฟใคใซๅใฏ `command/run` ใใใๆณจๅ
ฅใใใๆญฃ็ขบใชใใญในใใฏ `request/header` ใใๅพใใใๅบๆใใผใซใผ `{ kind: 'plugin', plugin: 'dsh-output-styles' }` ใฏใใกใคใณใฌใณใผใใซๆฎใใพใใในใฟใคใซใฏใกใคใณไผ่ฉฑใฎใฟใซ้ฉ็จใใใใตใใจใผใธใงใณใใฎใปใใทใงใณใฏ็ฌ่ชใฎใใญใณใใใไฟๆใใพใ๏ผClaude Code ใจไธ่ด๏ผใ
|
|
97
|
-
|
|
98
|
-
## โ๏ธ ่จญๅฎ
|
|
99
|
-
|
|
100
|
-
ใในใฆใฎ่ชฟๆด้
็ฎใฏๆค่จผไปใใฎ Schemastery `Config` ใใฃใผใซใใงใ๏ผไธๆญฃใชๅคใฏ่ชญใฟ่พผใฟใซๅคฑๆใใพใ๏ผ๏ผ
|
|
101
|
-
|
|
102
|
-
| ใใฃใผใซใ | ๆขๅฎ | ๆๅณ |
|
|
103
|
-
|---|---|---|
|
|
104
|
-
| `stylesDir` | `[]` | ในใฟใคใซใฉใคใใฉใชใฎใใฃใฌใฏใใชใcwd ใๅบๆบใซ่งฃๆฑบใใใๅพๆนใฎใจใณใใชใๅๆนใฎใใฎใไธๆธใใใพใใ`[]` = ๅๆขฑใฎ `styles/` ใฎใฟใ่ฃธใฎๆๅญๅใฏๅไธใใฃใฌใฏใใชใฎใชในใใจใฟใชใใใพใใ |
|
|
105
|
-
| `maxStyleChars` | `4000` | ในใฟใคใซๆฌๆใฎใใธใงใใ๏ผใณใผใใใคใณใใโฅ 1๏ผใ้ทใๆฌๆใฏใใผใซใผไปใใงๅใ่ฉฐใใใใพใใ |
|
|
106
|
-
| `defaultStyle` | `''` | ไธๅบฆใ้ธๆใใฆใใชใใปใใทใงใณ๏ผใใค settings ใฎๆขๅฎใใชใ๏ผๅใใฎในใฟใคใซใ`''` = ในใฟใคใซใชใใ |
|
|
107
|
-
| `compatJson` | `true` | Claude Code `outputStyles` ใฎ JSON ใจใณใใช๏ผๅไธใชใใธใงใฏใใพใใฏ้
ๅ๏ผใ่ชญใฟ่พผใฟใพใใ |
|
|
108
|
-
| `sectionOrder` | `90` | ๆณจๅ
ฅใปใฏใทใงใณใฎ้ ๅบ๏ผ0 = personaใ100โ199 = ใใผใซใฌใคใใณใน๏ผใ |
|
|
109
|
-
| `truncationMarker` | `"\n\n[style truncated]"` | ๅใ่ฉฐใไฝ็ฝฎใซไปๅ ใใใใใผใซใผใ |
|
|
110
|
-
| `includeBuiltins` | `true` | ใใใฑใผใธๅๆขฑใฎ `styles/` ใๆๅชๅ
ๅบฆใฎไฝใใฌใคใคใผใจใใฆๅซใใพใใ |
|
|
111
|
-
| `watchStyles` | `true` | ในใฟใคใซใใกใคใซใใใฃในใฏไธใงๅคๆดใใใใจใใซใฉใคใใฉใชใๅ่ชญใฟ่พผใฟใใพใใ |
|
|
112
|
-
| `rules` | `[]` | ใปใใทใงใณ/ใใผใซๅฅใฎๆ็ปใซใผใซ๏ผ`[{ match: { tool?, contentType?, session? }, style, priority? }]`โโ`style` ใฏใฌใณใใฉใผ id๏ผใใซใใคใณใฏในใฟใคใซๅใจๅๅ๏ผใ |
|
|
113
|
-
| `enableExport` | `true` | `/export` ใณใใณใใ็ป้ฒ๏ผMarkdown/HTML ใปใใทใงใณๆธใๅบใใใฌใณใใฉใผๅฏพๅฟ๏ผใ |
|
|
114
|
-
|
|
115
|
-
## ๐จ ใฌใณใใฉใผใใญใใณใซ
|
|
116
|
-
|
|
117
|
-
`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ใ
|
|
118
|
-
## ๐ ในใฟใคใซใฉใคใใฉใช
|
|
119
|
-
|
|
120
|
-
<details>
|
|
121
|
-
<summary><code>styles/concise.md</code></summary>
|
|
122
|
-
|
|
123
|
-
```markdown
|
|
124
|
-
---
|
|
125
|
-
name: concise
|
|
126
|
-
description: Terse, direct answers โ minimal prose, no preamble.
|
|
127
|
-
whenToUse: Daily coding work, tool-heavy sessions, or when prompt length matters.
|
|
128
|
-
keep-coding-instructions: true
|
|
129
|
-
---
|
|
130
|
-
|
|
131
|
-
You are in the concise output style for this conversation.
|
|
132
|
-
- Lead with the direct answer; skip preamble, restatements, and filler.
|
|
133
|
-
- ๅ็ญ่ฏญ่จ่ท้็จๆท่ฏญ่จ๏ผไธญๆๆ้ฎ็จไธญๆๅ็ญ๏ผ่ฑๆๆ้ฎ็จ่ฑๆๅ็ญใ
|
|
134
|
-
```
|
|
135
|
-
|
|
136
|
-
</details>
|
|
137
|
-
|
|
138
|
-
frontmatter ใใฃใผใซใ๏ผ
|
|
139
|
-
|
|
140
|
-
| ใใฃใผใซใ | ๆขๅฎ | ๆๅณ |
|
|
141
|
-
|---|---|---|
|
|
142
|
-
| `name` | ใใกใคใซๅ | ๅใๆฟใๅฏพ่ฑกใ่ฑๅญใๆฐๅญใ็ฉบ็ฝใใใคใใณ๏ผๅ
้ ญใปๆซๅฐพใฎ็ฉบ็ฝใฏไธๅฏใ`off` ใฏไบ็ดๆธใฟ๏ผใ |
|
|
143
|
-
| `description` | โ๏ผๅฟ
้ ๏ผ | ไธ่ฆงใจใใใซใผใซ่กจ็คบใใใ 1 ๆใ |
|
|
144
|
-
| `whenToUse` | โ | ไธ่ฆงใซ่ฟฝ่จใใใไปปๆใฎๅฉ็จใฌใคใใณในใ |
|
|
145
|
-
| `keep-coding-instructions` | `false` | `true` ใฎใจใใใผใในใฎใใญใณใใ๏ผใขใคใใณใใฃใใฃใpersonaใใใผใซใฌใคใใณใน๏ผใไฟๆใใ`false` ใฎใจใๅฎๅ
จใซ็ฝฎใๆใใพใ๏ผClaude Code ใฎใปใใณใใฃใฏใน๏ผใ |
|
|
146
|
-
| `force-for-plugin` | `false` | Claude Code ๅ
ฌๅผใใฃใผใซใ๏ผใปใใทใงใณใฎ้ธๆใ็ก่ฆใใฆ็กๆกไปถใซ้ฉ็จใใพใใ`force` ใฏใจใคใชใขในใงใ่จญๅฎใงใใใฎใฏๆๅคง 1 ใคใฎในใฟใคใซใงใใ |
|
|
147
|
-
|
|
148
|
-
<details>
|
|
149
|
-
<summary>Claude Code <code>outputStyles</code> JSON๏ผ<code>compatJson: true</code>๏ผ</summary>
|
|
150
|
-
|
|
151
|
-
```json
|
|
152
|
-
{ "name": "explain", "description": "Explain like a teacher.", "prompt": "Teach in small steps." }
|
|
153
|
-
```
|
|
154
|
-
|
|
155
|
-
ใจใณใใชใฏ Claude Code ใๆธใ่พผใใจใใใซ `keep-coding-instructions` ใจ `force-for-plugin` ใๅใไปใใพใใใฌใฌใทใผใฎ `settings.json` ้
ๅ๏ผ`[{ โฆ }, { โฆ }]`๏ผใฏใใฎใพใพ่ชญใฟ่พผใพใใไธๆญฃใชใจใณใใชใฏ่ญฆๅไปใใงในใญใใใใใพใใ
|
|
156
|
-
|
|
157
|
-
</details>
|
|
158
|
-
|
|
159
|
-
## โจ๏ธ ใณใใณใใชใใกใฌใณใน
|
|
160
|
-
|
|
161
|
-
| ๅ
ฅๅ | ็ตๆ |
|
|
162
|
-
|---|---|
|
|
163
|
-
| `/style` | ็พๅจใฎ้ธๆ + ในใฟใคใซใใจใซ 1 ่ก๏ผname โ description๏ผใไธ่ฆง่กจ็คบ |
|
|
164
|
-
| `/style concise` | ๅใๆฟใ๏ผๆฐธ็ถๆธใ่พผใฟ๏ผใ`switched to concise` |
|
|
165
|
-
| `/style Diagrams first` | ่คๆฐ่ชใฎๅๅใฏๆฎใๅ
จไฝใๅฏพ่ฑก |
|
|
166
|
-
| `/style off` | ใใญใธใงใฏใใฎใใใฉใซใใๅพฉๅ
๏ผsettings ใฎๆขๅฎใๆฌกใใง `defaultStyle`๏ผ |
|
|
167
|
-
| `/style nope` | `error: unknown output style "nope" (available: โฆ)` |
|
|
168
|
-
|
|
169
|
-
## ๐ฑ๏ธ Web ใใใซใผ
|
|
170
|
-
|
|
171
|
-
`dsh.client` ใจใณใใชใฏใใในใใฎ `/style` ใณใใณใใฎๅผๆฐใชใๅผใณๅบใใใใใใขใใใใใซใผใง่ฃ
้ฃพใใพใ๏ผใoffใ่ก + ใฉใคใใฉใชใฎในใฟใคใซใใจใซ 1 ่ก๏ผ`description ยท whenToUse`๏ผใงใใขใฏใใฃใใช่กใใใผใฏใใใพใใ้ธๆใใใจใณใใณใ Remote ใ้ใใฆ `/style <name>` ใ้ไฟกใใใใใใใฉใฎๅใๆฟใใใในใใฎๆฐธ็ถ็ใชใณใใณใใฉใคใใตใคใฏใซใ็ต็ฑใใ`style` ๆๅฝฑใๅฏไธใฎ่กจ็คบไบๅฎใงใใ็ถใใพใใใใใซใผใฎๆ่จใฏ Web UI ใๅๆขฑใใ `zh`/`en` ใฎ่จ่ชใใขใซๅพใใพใใ
|
|
172
|
-
|
|
173
|
-
## ๐ ็ซถๅใใงใใฏ
|
|
174
|
-
|
|
175
|
-
้็บๅใซ 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+ ใธๅ
้ใ๏ผโโใฏ้ฃๆฅใใฆใใฆใ็ซถๅใฏใใพใใใ
|
|
176
|
-
|
|
177
|
-
## ๐ Claude Code ใจใฎ้ใ
|
|
178
|
-
|
|
179
|
-
| | Claude Code | dsh-output-styles |
|
|
180
|
-
|---|---|---|
|
|
181
|
-
| ในใฟใคใซใใกใคใซ | ใฆใผใถใผ/ใใญใธใงใฏใ/ใใใผใธใ้ๅฑคใฎ `.claude/output-styles` | `stylesDir` ใใฃใฌใฏใใช + ๅๆขฑใฎ `styles/`ใๅพๆนใฎใใฃใฌใฏใใชใๅชๅ
|
|
|
182
|
-
| ใซในใฟใ ในใฟใคใซ | Markdownใfrontmatter `name`/`description`/`keep-coding-instructions`/`force-for-plugin` | ๅใใใฃใผใซใ๏ผ`force-for-plugin` ใใใฎใพใพๅใไปใใ`force` ใฏใจใคใชใขใน๏ผ+ `whenToUse` |
|
|
183
|
-
| ใฌใฌใทใผ JSON | `settings.json` ๅ
ใฎ `outputStyles` ้
ๅ | ใใฎใพใพ่ชญใฟ่พผใฟ๏ผ`compatJson: true`๏ผ |
|
|
184
|
-
| ๅๆ ใฟใคใใณใฐ | `/clear` ๅพใพใใฏๆฐใใใปใใทใงใณ | ๅณๆโโใทในใใ ใใญใณใใใฏใชใฏใจในใใใจใซๅๆง็ฏ |
|
|
185
|
-
| ใตใใจใผใธใงใณใ | ในใฟใคใซใฏ้ฉ็จใใใชใ | ๅใโโใตใใจใผใธใงใณใใฎใปใใทใงใณใฏ็ฌ่ชใฎใใญใณใใใไฟๆ |
|
|
186
|
-
| ๅใๆฟใ | `/config` ใกใใฅใผใพใใฏ `outputStyle` ่จญๅฎ๏ผ`/output-style` ใณใใณใใฏ v2.1.91 ใงๅ้ค๏ผ | `/style` ใณใใณใ + Web ใใใซใผ + settings `output-style.style` |
|
|
187
|
-
|
|
188
|
-
## ๐งช ้็บ
|
|
189
|
-
|
|
190
|
-
```sh
|
|
191
|
-
pnpm install
|
|
192
|
-
pnpm run typecheck # ไธกๆนใฎ tsc ใใญใธใงใฏใ
|
|
193
|
-
pnpm test # vitest โ 93 ใในใ
|
|
194
|
-
pnpm run verify # typecheck + ใในใ + ่ชๅทฑๅฎ็ตใใงใใฏ๏ผprepublishOnly ใฒใผใ๏ผ
|
|
195
|
-
pnpm run build # lib/ ๆๆ็ฉ๏ผใในใ + ใฏใฉใคใขใณใ bundle๏ผ
|
|
196
|
-
pnpm pack # dsh plugin add ็จใฎ tarball
|
|
197
|
-
```
|
|
198
|
-
|
|
199
|
-
ใชใชใผใน๏ผ`package.json` ใฎใใผใธใงใณใจไธ่ดใใๆฅๅฐพ่พใๆใค `v*` ใฟใฐใ push ใใใจ Publish ใฏใผใฏใใญใผใ่ตทๅใใพใโโๅฎๅ
จๆค่จผใฎๅพใซ npm ใธๅ
ฌ้๏ผprovenance ไปใ๏ผใใใใใ `npm publish` ใ `prepublishOnly` ็ต็ฑใง `verify` ใฒใผใใ้้ใใพใใ
|
|
200
|
-
|
|
201
|
-
ๆงๆใฏ [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/`๏ผ็ตใฟ่พผใฟในใฟใคใซ๏ผใ
|
|
202
|
-
|
|
203
|
-
## ๐ฅ ใณใณใใชใใฅใผใฟใผ
|
|
204
|
-
|
|
205
|
-
ๆฌใใญใธใงใฏใใซ่ฒข็ฎใใฆใใ ใใฃใใในใฆใฎๆนใซๆ่ฌใใพใ๏ผ
|
|
206
|
-
|
|
207
|
-
- [@PerryLink](https://github.com/PerryLink) โ ไฝ่
ๅ
ผใกใณใใใผ๏ผใใฉใฐใคใณใขใผใญใใฏใใฃใในใฟใคใซใฉใคใใฉใชใbundle ใคใณในใใผใซใWeb ใใใซใผใ5 ่จ่ชใใญใฅใกใณใใCI/ใชใชใผในใใผใซใ
|
|
208
|
-
|
|
209
|
-
ใใฐใใขใคใใขใใใใฐ [issue](https://github.com/PerryLink/dsh-output-styles/issues) ใ [pull request](https://github.com/PerryLink/dsh-output-styles/pulls) ใใฉใใใใฉใฎ่จ่ชใงใฎ่ฒข็ฎใๆญ่ฟใใพใใ
|
|
210
|
-
|
|
211
|
-
## ๐ ใฉใคใปใณใน
|
|
212
|
-
|
|
213
|
-
[Apache-2.0](LICENSE) ยฉ 2026 dsh-output-styles contributors
|
|
214
|
-
|
|
215
|
-
---
|
|
216
|
-
|
|
217
|
-
<sub>Topics: `dsh` ยท `dsh-plugin` ยท `deepseek-harness` ยท `output-styles` ยท `claude-code`</sub>
|
package/README.ko.md
DELETED
|
@@ -1,217 +0,0 @@
|
|
|
1
|
-
<div align="center">
|
|
2
|
-
|
|
3
|
-
# ๐จ dsh-output-styles
|
|
4
|
-
|
|
5
|
-
**DeepSeek Harness๋ฅผ ์ํ Claude Code `outputStyles`** โโ ๋ฐํ์์, ์ธ์
๋ณ๋ก, ์๊ตฌ์ ์ผ๋ก ๋ชจ๋ธ์ ์ถ๋ ฅ ์คํ์ผ์ ์ ํํฉ๋๋ค.
|
|
6
|
-
|
|
7
|
-
[](LICENSE)
|
|
8
|
-
[](https://github.com/PerryLink/dsh-output-styles/actions/workflows/ci.yml)
|
|
9
|
-
[](https://www.npmjs.com/package/dsh-output-styles)
|
|
10
|
-
[](https://www.npmjs.com/package/dsh-output-styles)
|
|
11
|
-
[](#)
|
|
12
|
-
[](#)
|
|
13
|
-
[](#)
|
|
14
|
-
|
|
15
|
-
๐ [English](README.md) ยท [ไธญๆ](README.zh.md) ยท [ๆฅๆฌ่ช](README.ja.md) ยท [ํ๊ตญ์ด](README.ko.md) ยท [Espaรฑol](README.es.md)
|
|
16
|
-
|
|
17
|
-
</div>
|
|
18
|
-
|
|
19
|
-
---
|
|
20
|
-
|
|
21
|
-
`/style concise` โโ ์ด์ ๋ถํฐ ๋ชจ๋ ๋ต๋ณ์ด ๊ฐ๊ฒฐํด์ง๋๋ค. `/style step-by-step` โโ ๋ชจ๋ธ์ด ๋ฒํธ ๋งค๊ธด ๋จ๊ณ๋ก ์ค๋ช
ํฉ๋๋ค. `/style off` โโ ํ๋ก์ ํธ ๊ธฐ๋ณธ๊ฐ์ผ๋ก ๋ณต๊ทํฉ๋๋ค. ์ธ์
๋น ๋ช
๋ น ํ๋, ์ฌ์์์๋ ์ ์ง๋๋ฉฐ agent loop ๋ณ๊ฒฝ์ ์ ํ ์์ต๋๋ค.
|
|
22
|
-
|
|
23
|
-
## โจ ๊ธฐ๋ฅ
|
|
24
|
-
|
|
25
|
-
| | |
|
|
26
|
-
|---|---|
|
|
27
|
-
| ๐๏ธ **์คํ์ผ ๋ผ์ด๋ธ๋ฌ๋ฆฌ** | ์คํ์ผ๋น Markdown ํ์ผ ํ๋(`styles/*.md`). frontmatter์ ๋ฉํ๋ฐ์ดํฐ๋ฅผ, ๋ณธ๋ฌธ์ ๋ชจ๋ธ ์ง์๋ฌธ์
๋๋ค. `name`์ ๊ธฐ๋ณธ๊ฐ์ด ํ์ผ๋ช
์ด๋ฉฐ ๊ณต๋ฐฑ์ ํฌํจํ ์ ์์ต๋๋ค(`Diagrams first`). ๋ด์ฅ ์คํ์ผ 6์ข
์ด ํจ๊ป ์ ๊ณต๋๋ฉฐ, Claude Code์ ๋๋ฑํ `proactive`์ `learning`์ ํฌํจํฉ๋๋ค. |
|
|
28
|
-
| โจ๏ธ **`/style` ๋ช
๋ น** | ์ธ์ ์์ด ์คํํ๋ฉด ์คํ์ผ ๋ชฉ๋ก(์ค๋ช
ํฌํจ) + ํ์ฌ ์ ํ์ ํ์ํฉ๋๋ค. `/style <name>`์ผ๋ก ์ ํํ๊ณ `/style off`๋ก ํ๋ก์ ํธ ๊ธฐ๋ณธ๊ฐ์ ๋ณต์ํฉ๋๋ค. `/style` ๋ค์ ๋๋จธ์ง ์ ์ฒด๊ฐ ์คํ์ผ ์ด๋ฆ์
๋๋ค. |
|
|
29
|
-
| ๐พ **์ธ์
๋ฒ์ ์์ํ** | ์ ํ์ `output_style` ์ ์ฅ์ ๋๋ฉ์ธ์ sessionId๋ฅผ ํค๋ก ์ ์ฅ๋์ด, ๋ ์ธ์
์ด ์๋ก ๊ฐ์ญํ์ง ์๊ณ ์ ํ์ ์ฌ์์ ํ์๋ ์ ์ง๋ฉ๋๋ค. |
|
|
30
|
-
| ๐งฉ **์์คํ
ํ๋กฌํํธ ์ฃผ์
** | `systemPrompt.section()` ๊ธฐ์ฌ(order 90)๊ฐ ๋งค ์กฐ๋ฆฝ๋ง๋ค ํ์ฌ ์ธ์
์ ์คํ์ผ ๋ณธ๋ฌธ์ ์ฃผ์
ํฉ๋๋ค. ๋ณธ๋ฌธ์ ์ค์ ๊ฐ๋ฅํ ์์ฐ์ผ๋ก ์๋ฆฝ๋๋ค. |
|
|
31
|
-
| ๐ญ **Claude Code `keep-coding-instructions`** | `keep-coding-instructions: false`(Claude Code์ ๊ฐ์ ๊ธฐ๋ณธ๊ฐ)์ธ ์คํ์ผ์ ์์คํ
ํ๋กฌํํธ ์ ์ฒด๋ฅผ ๊ต์ฒดํฉ๋๋ค โโ ์ํํธ์จ์ด ์์ง๋์ด๋ง์์ ๋ฒ์ด๋๋ ์คํ์ผ์ฉ์
๋๋ค. |
|
|
32
|
-
| ๐ **๊ฐ์ ์คํ์ผ** | Claude Code์ `force-for-plugin`(๋ณ์นญ `force`)์ด ์ธ์
์ ํ์ ๋ฌด์ํ๊ณ ๋ฌด์กฐ๊ฑด ์คํ์ผ์ ์ ์ฉํฉ๋๋ค. ๊ฐ์ ์คํ์ผ์ด ๋์ด๋ฉด ๋ก๋๊ฐ ์คํจํฉ๋๋ค. |
|
|
33
|
-
| ๐ **Claude Code ํธํ์ฑ** | `outputStyles` JSON ์ปฌ๋ ์
(`{ name, description, prompt }`)์ ๋ก๋ํ๋ฉฐ, ๋จ์ผ ํญ๋ชฉ ๋๋ `settings.json` ์คํ์ผ ๋ฐฐ์ด์ ์ง์ํฉ๋๋ค. ํด์ ๋ถ๊ฐ ํญ๋ชฉ์ ๊ฒฝ๊ณ ์ ํจ๊ป ๊ฑด๋๋๋๋ค. |
|
|
34
|
-
| ๐ **๊ณ์ธตํ๋ ๋๋ ํฐ๋ฆฌ** | `stylesDir`์ ๋ชฉ๋ก์ด๋ฉฐ ๋ค์ชฝ ๋๋ ํฐ๋ฆฌ๊ฐ ์์ชฝ์ ์ฌ์ ์ํฉ๋๋ค(๋ด์ฅ `styles/`๊ฐ ์ตํ์ ๊ณ์ธต, `includeBuiltins: false`๋ก ๋นํ์ฑํ). |
|
|
35
|
-
| ๐ **ํซ ๋ฆฌ๋ก๋** | ์คํ์ผ ํ์ผ ๋ณ๊ฒฝ์ด ์ฌ์์ ์์ด ๋ฐ์๋ฉ๋๋ค(`watchStyles: false`๋ก ํด์ ). |
|
|
36
|
-
| โ๏ธ **์ค์ ๊ณผ ํ๋ก์ ํธ ๊ธฐ๋ณธ๊ฐ** | ํ ๋ฒ๋ ์ ํํ์ง ์์ ์ธ์
์ DSH ์ค์ ์ `output-style.style`, ๊ทธ๋ค์ `defaultStyle`๋ก ํด๋ฐฑํฉ๋๋ค. |
|
|
37
|
-
| ๐ฑ๏ธ **์น ํผ์ปค** | `dsh.client` ํญ๋ชฉ(`dsh-output-styles/client`)์ด ํธ์คํธ์ `/style` ๋ช
๋ น์ ํ๋ก์ ์
๊ธฐ๋ฐ ํ์
ํผ์ปค๋ก ๊พธ๋ฐ๋๋ค. |
|
|
38
|
-
| ๐ **์ธ์
ํ๋ก์ ์
** | Web UI์ฉ `style` ํ๋ก์ ์
(`{ options, currentValue }`)์ผ๋ก, ์ธ์
๋ก๊ทธ์์ ํ์ ๋ ๋ช
๋ น์ผ๋ก๋ถํฐ ํด๋ฉ๋ฉ๋๋ค. |
|
|
39
|
-
| ๐งฏ **๋ช
ํํ ์คํจ, ๊น๋ํ ๊ฑด๋๋** | ์๋ชป๋ ์ค์ ์ ๋ก๋ ์ ์์ธ๋ฅผ ๋์ง๋๋ค. ์๋ชป๋ ์คํ์ผ ํ์ผ์ ๊ฒฝ๊ณ ์ ํจ๊ป ๊ฑด๋๋ฐ๋ฉฐ ํ๋กํ์ ๊นจ๋จ๋ฆฌ์ง ์์ต๋๋ค. |
|
|
40
|
-
| ๐ **5๊ฐ ์ธ์ด ๋ฌธ์** | EN ยท ไธญๆ ยท ๆฅๆฌ่ช ยท ํ๊ตญ์ด ยท Espaรฑol. |
|
|
41
|
-
|
|
42
|
-
## ๐ ๋น ๋ฅธ ์์
|
|
43
|
-
|
|
44
|
-
```sh
|
|
45
|
-
# 1. ์ค์น โ ์ด ํจํค์ง๋ ๋ฒ๋ค ๋ ์ด์ด์ด๋ฏ๋ก ํ ๋ช
๋ น์ผ๋ก
|
|
46
|
-
# storage + storage-json + storage-domain + ํ๋ฌ๊ทธ์ธ ํ์ด ๊ตฌ์ฑ๋ฉ๋๋ค:
|
|
47
|
-
dsh plugin --profile <name> add dsh-output-styles
|
|
48
|
-
|
|
49
|
-
# 2. ๋ถํ
ํ๊ณ ์ ํ
|
|
50
|
-
dsh --profile <name>
|
|
51
|
-
/style # โ output style off, ๊ทธ๋ค์ ์คํ์ผ๋ณ ํ ์ค
|
|
52
|
-
/style concise # โ switched to concise
|
|
53
|
-
/style Diagrams first # โ ๊ณต๋ฐฑ ํฌํจ ์ด๋ฆ๋ ๋์
|
|
54
|
-
/style off # โ ํ๋ก์ ํธ ๊ธฐ๋ณธ๊ฐ์ผ๋ก ๋ณต๊ท
|
|
55
|
-
```
|
|
56
|
-
|
|
57
|
-
์ด ๋ ์ด์ด๋ ์น ํ๋กํ์ ๋ํด ๋ฉฑ๋ฑ์ ์
๋๋ค(id ๊ธฐ์ค ์ฝ์
์ด ๋์ผ id ํ์ ๋์ฒด). ์น ํ๋กํ์ `storage`๋ฅผ ๊ธฐ๋ณธ์ผ๋ก ํฌํจํฉ๋๋ค. ์น ํผ์ปค๋ฅผ ์ฌ์ฉํ๋ ค๋ฉด ํ๋กํ์ ํด๋ผ์ด์ธํธ ํ์ ์ถ๊ฐํ์ธ์:
|
|
58
|
-
|
|
59
|
-
```yaml
|
|
60
|
-
- id: output-styles-client
|
|
61
|
-
name: 'dsh-output-styles/client'
|
|
62
|
-
```
|
|
63
|
-
|
|
64
|
-
## ๐ฌ ๋ฐ๋ชจ
|
|
65
|
-
|
|
66
|
-
```
|
|
67
|
-
You > /style
|
|
68
|
-
output style off
|
|
69
|
-
concise โ Terse, direct answers โ minimal prose, no preamble. (Daily coding work, tool-heavy sessions, or when prompt length matters.)
|
|
70
|
-
explanatory โ Educational answers with short "Insights" that teach as you work. (Learning a codebase, onboarding, โฆ)
|
|
71
|
-
formal โ Formal, precise prose with complete sentences and defined terms. (Reports, documentation, release notes, โฆ)
|
|
72
|
-
learning โ Collaborative learn-by-doing mode with short "Insights" and small hands-on steps for the user. (Pairing, onboarding, โฆ)
|
|
73
|
-
proactive โ Execute immediately, assume reasonable defaults, and prefer action over planning. (Routine multi-step work, โฆ)
|
|
74
|
-
step-by-step โ Numbered reasoning steps with explicit intermediate results. (Debugging, design decisions, โฆ)
|
|
75
|
-
|
|
76
|
-
You > /style concise
|
|
77
|
-
switched to concise
|
|
78
|
-
|
|
79
|
-
You > ํ ๋ฌธ์ฅ์ผ๋ก๋ง ์๊ธฐ์๊ฐํด ์ฃผ์ธ์.
|
|
80
|
-
AI > ์ ๋ DeepSeek Harness ํ๋ฌ๊ทธ์ธ ํ๋ซํผ์์ ์คํ๋๊ณ deepseek-v4-pro ๋ชจ๋ธ์ ๊ธฐ๋ฐ์ผ๋ก ํ๋ AI ์ฝ๋ฉ ์์ด์ ํธ์
๋๋ค.
|
|
81
|
-
```
|
|
82
|
-
|
|
83
|
-
## ๐ง ๋์ ๋ฐฉ์
|
|
84
|
-
|
|
85
|
-
```mermaid
|
|
86
|
-
flowchart LR
|
|
87
|
-
U[/style concise ์
๋ ฅ] --> C[๋ช
๋ น ๋ ์ง์คํธ๋ฆฌ]
|
|
88
|
-
C -->|command/run ๊ธฐ๋ก| L[(์ธ์
๋ก๊ทธ)]
|
|
89
|
-
C -->|put {style, source}| D[(output_style ๋๋ฉ์ธ)]
|
|
90
|
-
D --> R[OutputStyleRuntime]
|
|
91
|
-
R -->|๋งค ์กฐ๋ฆฝ๋ง๋ค ๋ณธ๋ฌธ ์ฃผ์
| S[systemPrompt ์น์
order 90]
|
|
92
|
-
S --> M[๋ชจ๋ธ ์์ฒญ]
|
|
93
|
-
M -->|์ ์ฒด ์์คํ
ํ๋กฌํํธ| H[request/header ๊ธฐ๋ก]
|
|
94
|
-
```
|
|
95
|
-
|
|
96
|
-
๋ชจ๋ธ์ด ๋ณด๋ ๋ชจ๋ ๊ฒ์ ์ธ์
๋ก๊ทธ์์ ์ฌ๊ตฌ์ฑํ ์ ์์ต๋๋ค โโ ์๋ก์ด ์ธ์
์ด๋ฒคํธ ํ์
๋, agent-loop ๋ณ๊ฒฝ๋ ์์ต๋๋ค. ์คํ์ผ ์ด๋ฆ์ `command/run`์์, ์ฃผ์
๋ ์ ํํ ํ
์คํธ๋ `request/header`์์ ๋์ค๋ฉฐ, ์ถ์ฒ ๋ง์ปค `{ kind: 'plugin', plugin: 'dsh-output-styles' }`๋ ๋๋ฉ์ธ ๋ ์ฝ๋์ ๋จ์ต๋๋ค. ์คํ์ผ์ ๋ฉ์ธ ๋ํ์๋ง ์ ์ฉ๋๋ฉฐ, ํ์ ์์ด์ ํธ ์ธ์
์ ์์ฒด ํ๋กฌํํธ๋ฅผ ์ ์งํฉ๋๋ค(Claude Code์ ์ผ์น).
|
|
97
|
-
|
|
98
|
-
## โ๏ธ ์ค์
|
|
99
|
-
|
|
100
|
-
๋ชจ๋ ์กฐ์ ๊ฐ์ ๊ฒ์ฆ๋ Schemastery `Config` ํ๋์
๋๋ค(์๋ชป๋ ๊ฐ์ ๋ก๋ ์คํจ):
|
|
101
|
-
|
|
102
|
-
| ํ๋ | ๊ธฐ๋ณธ๊ฐ | ์๋ฏธ |
|
|
103
|
-
|---|---|---|
|
|
104
|
-
| `stylesDir` | `[]` | ์คํ์ผ ๋ผ์ด๋ธ๋ฌ๋ฆฌ ๋๋ ํฐ๋ฆฌ. cwd ๊ธฐ์ค์ผ๋ก ํด์๋๋ฉฐ ๋ค์ชฝ ํญ๋ชฉ์ด ์์ชฝ์ ์ฌ์ ์ํฉ๋๋ค. `[]` = ๋ด์ฅ `styles/`๋ง. ๋จ์ ๋ฌธ์์ด์ ๋จ์ผ ๋๋ ํฐ๋ฆฌ ๋ชฉ๋ก์
๋๋ค. |
|
|
105
|
-
| `maxStyleChars` | `4000` | ์คํ์ผ ๋ณธ๋ฌธ ์์ฐ(์ฝ๋ ํฌ์ธํธ, โฅ 1). ๋ ๊ธด ๋ณธ๋ฌธ์ ๋ง์ปค์ ํจ๊ป ์๋ฆฝ๋๋ค. |
|
|
106
|
-
| `defaultStyle` | `''` | ํ ๋ฒ๋ ์ ํํ์ง ์์ ์ธ์
(์ค์ ๊ธฐ๋ณธ๊ฐ๋ ์์)์ ์ ์ฉํ ์คํ์ผ. `''` = ์คํ์ผ ์์. |
|
|
107
|
-
| `compatJson` | `true` | Claude Code `outputStyles` JSON ํญ๋ชฉ(๋จ์ผ ๊ฐ์ฒด ๋๋ ๋ฐฐ์ด)์ ๋ก๋ํฉ๋๋ค. |
|
|
108
|
-
| `sectionOrder` | `90` | ์ฃผ์
์น์
์ ์์(0 = persona, 100โ199 = ๋๊ตฌ ์ง์นจ). |
|
|
109
|
-
| `truncationMarker` | `"\n\n[style truncated]"` | ์๋ฆฐ ์ง์ ์ ์ถ๊ฐ๋๋ ๋ง์ปค. |
|
|
110
|
-
| `includeBuiltins` | `true` | ํจํค์ง ๋ด์ฅ `styles/`๋ฅผ ์ต์ ์ฐ์ ์์ ๊ณ์ธต์ผ๋ก ํฌํจํฉ๋๋ค. |
|
|
111
|
-
| `watchStyles` | `true` | ๋์คํฌ์์ ์คํ์ผ ํ์ผ์ด ๋ณ๊ฒฝ๋๋ฉด ๋ผ์ด๋ธ๋ฌ๋ฆฌ๋ฅผ ๋ค์ ๋ก๋ํฉ๋๋ค. |
|
|
112
|
-
| `rules` | `[]` | ์ธ์
/๋๊ตฌ๋ณ ๋ ๋ ๊ท์น๏ผ`[{ match: { tool?, contentType?, session? }, style, priority? }]`โโ`style` ์ ๋ ๋๋ฌ id๏ผ๋ด์ฅ์ ์คํ์ผ๊ณผ ๋๋ช
๏ผใ |
|
|
113
|
-
| `enableExport` | `true` | `/export` ๋ช
๋ น ๋ฑ๋ก๏ผMarkdown/HTML ์ธ์
๋ด๋ณด๋ด๊ธฐใ๋ ๋๋ฌ ์ธ์๏ผใ |
|
|
114
|
-
|
|
115
|
-
## ๐จ ๋ ๋๋ฌ ํ๋กํ ์ฝ
|
|
116
|
-
|
|
117
|
-
`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ใ
|
|
118
|
-
## ๐ ์คํ์ผ ๋ผ์ด๋ธ๋ฌ๋ฆฌ
|
|
119
|
-
|
|
120
|
-
<details>
|
|
121
|
-
<summary><code>styles/concise.md</code></summary>
|
|
122
|
-
|
|
123
|
-
```markdown
|
|
124
|
-
---
|
|
125
|
-
name: concise
|
|
126
|
-
description: Terse, direct answers โ minimal prose, no preamble.
|
|
127
|
-
whenToUse: Daily coding work, tool-heavy sessions, or when prompt length matters.
|
|
128
|
-
keep-coding-instructions: true
|
|
129
|
-
---
|
|
130
|
-
|
|
131
|
-
You are in the concise output style for this conversation.
|
|
132
|
-
- Lead with the direct answer; skip preamble, restatements, and filler.
|
|
133
|
-
- ๅ็ญ่ฏญ่จ่ท้็จๆท่ฏญ่จ๏ผไธญๆๆ้ฎ็จไธญๆๅ็ญ๏ผ่ฑๆๆ้ฎ็จ่ฑๆๅ็ญใ
|
|
134
|
-
```
|
|
135
|
-
|
|
136
|
-
</details>
|
|
137
|
-
|
|
138
|
-
frontmatter ํ๋:
|
|
139
|
-
|
|
140
|
-
| ํ๋ | ๊ธฐ๋ณธ๊ฐ | ์๋ฏธ |
|
|
141
|
-
|---|---|---|
|
|
142
|
-
| `name` | ํ์ผ๋ช
| ์ ํ ๋์. ๋ฌธ์, ์ซ์, ๊ณต๋ฐฑ, ํ์ดํ(์ ํ/ํํ ๊ณต๋ฐฑ ์์. `off`๋ ์์ฝ๋จ). |
|
|
143
|
-
| `description` | โ(ํ์) | ๋ชฉ๋ก๊ณผ ํผ์ปค์ ํ์๋๋ ํ ๋ฌธ์ฅ. |
|
|
144
|
-
| `whenToUse` | โ | ๋ชฉ๋ก์ ๋ง๋ถ์ด๋ ์ ํ์ ์๋ด. |
|
|
145
|
-
| `keep-coding-instructions` | `false` | `true`๋ฉด ํ๋ค์ค ํ๋กฌํํธ(์ ์ฒด์ฑ, persona, ๋๊ตฌ ์ง์นจ)๋ฅผ ์ ์งํ๊ณ , `false`๋ฉด ์์ ํ ๊ต์ฒดํฉ๋๋ค(Claude Code ์๋ฏธ๋ก ). |
|
|
146
|
-
| `force-for-plugin` | `false` | Claude Code ๊ณต์ ํ๋: ์ธ์
์ ํ์ ๋ฌด์ํ๊ณ ๋ฌด์กฐ๊ฑด ์ ์ฉํฉ๋๋ค. `force`๋ ๋ณ์นญ์ด๋ฉฐ ์ต๋ ํ ์คํ์ผ๋ง ์ค์ ํ ์ ์์ต๋๋ค. |
|
|
147
|
-
|
|
148
|
-
<details>
|
|
149
|
-
<summary>Claude Code <code>outputStyles</code> JSON(<code>compatJson: true</code>)</summary>
|
|
150
|
-
|
|
151
|
-
```json
|
|
152
|
-
{ "name": "explain", "description": "Explain like a teacher.", "prompt": "Teach in small steps." }
|
|
153
|
-
```
|
|
154
|
-
|
|
155
|
-
ํญ๋ชฉ์ Claude Code๊ฐ ์ฐ๋ ๊ทธ๋๋ก `keep-coding-instructions`์ `force-for-plugin` ํ๋๋ฅผ ๋ฐ์ต๋๋ค. ๋ ๊ฑฐ์ `settings.json` ๋ฐฐ์ด(`[{ โฆ }, { โฆ }]`)์ ๊ทธ๋๋ก ๋ก๋๋๊ณ , ์๋ชป๋ ํญ๋ชฉ์ ๊ฒฝ๊ณ ์ ํจ๊ป ๊ฑด๋๋๋๋ค.
|
|
156
|
-
|
|
157
|
-
</details>
|
|
158
|
-
|
|
159
|
-
## โจ๏ธ ๋ช
๋ น ๋ ํผ๋ฐ์ค
|
|
160
|
-
|
|
161
|
-
| ์
๋ ฅ | ๊ฒฐ๊ณผ |
|
|
162
|
-
|---|---|
|
|
163
|
-
| `/style` | ํ์ฌ ์ ํ + ์คํ์ผ๋ณ ํ ์ค(name โ description) ๋์ด |
|
|
164
|
-
| `/style concise` | ์ ํ(์๊ตฌ ๊ธฐ๋ก), `switched to concise` |
|
|
165
|
-
| `/style Diagrams first` | ์ฌ๋ฌ ๋จ์ด ์ด๋ฆ์ ๋๋จธ์ง ์ ์ฒด |
|
|
166
|
-
| `/style off` | ํ๋ก์ ํธ ๊ธฐ๋ณธ๊ฐ ๋ณต์(์ค์ ๊ธฐ๋ณธ๊ฐ, ๊ทธ๋ค์ `defaultStyle`) |
|
|
167
|
-
| `/style nope` | `error: unknown output style "nope" (available: โฆ)` |
|
|
168
|
-
|
|
169
|
-
## ๐ฑ๏ธ ์น ํผ์ปค
|
|
170
|
-
|
|
171
|
-
`dsh.client` ํญ๋ชฉ์ ํธ์คํธ `/style` ๋ช
๋ น์ ์ธ์ ์๋ ํธ์ถ์ ํ์
ํผ์ปค๋ก ๊พธ๋ฐ๋๋ค: ใoffใ ํ + ๋ผ์ด๋ธ๋ฌ๋ฆฌ ์คํ์ผ๋ณ ํ ํ(`description ยท whenToUse`), ํ์ฑ ํ์ด ํ์๋ฉ๋๋ค. ์ ํํ๋ฉด ๋ช
๋ น Remote๋ฅผ ํตํด `/style <name>`์ ์ ์ถํ๋ฏ๋ก, ๋ชจ๋ ์ ํ์ด ํธ์คํธ์ ์๊ตฌ์ ์ธ ๋ช
๋ น ์๋ช
์ฃผ๊ธฐ๋ฅผ ์ ์งํ๊ณ `style` ํ๋ก์ ์
์ด ์ ์ผํ๊ฒ ํ์๋๋ ์ฌ์ค๋ก ๋จ์ต๋๋ค. ํผ์ปค ๋ฌธ๊ตฌ๋ Web UI์ ๋ด์ฅ๋ `zh`/`en` ์ธ์ด ์์ ๋ฐ๋ฆ
๋๋ค.
|
|
172
|
-
|
|
173
|
-
## ๐ ์ถฉ๋ ๊ฒ์ฌ
|
|
174
|
-
|
|
175
|
-
๊ฐ๋ฐ ์ 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+๋ก ์ฐ๊ธฐ)์ ์ธ์ ํ์ง๋ง ์ถฉ๋ํ์ง ์์ต๋๋ค.
|
|
176
|
-
|
|
177
|
-
## ๐ Claude Code์์ ์ฐจ์ด
|
|
178
|
-
|
|
179
|
-
| | Claude Code | dsh-output-styles |
|
|
180
|
-
|---|---|---|
|
|
181
|
-
| ์คํ์ผ ํ์ผ | ์ฌ์ฉ์/ํ๋ก์ ํธ/๊ด๋ฆฌ ๊ณ์ธต์ `.claude/output-styles` | `stylesDir` ๋๋ ํฐ๋ฆฌ + ๋ด์ฅ `styles/`, ๋ค์ชฝ ๋๋ ํฐ๋ฆฌ๊ฐ ์ฐ์ |
|
|
182
|
-
| ์ฌ์ฉ์ ์ ์ ์คํ์ผ | Markdown, frontmatter `name`/`description`/`keep-coding-instructions`/`force-for-plugin` | ๋์ผ ํ๋(`force-for-plugin` ๊ทธ๋๋ก ์์ฉ, `force`๋ ๋ณ์นญ) + `whenToUse` |
|
|
183
|
-
| ๋ ๊ฑฐ์ JSON | `settings.json`์ `outputStyles` ๋ฐฐ์ด | ๊ทธ๋๋ก ๋ก๋(`compatJson: true`) |
|
|
184
|
-
| ์ ์ฉ ์์ | `/clear` ํ ๋๋ ์ ์ธ์
| ์ฆ์ โ ์์คํ
ํ๋กฌํํธ๊ฐ ์์ฒญ๋ง๋ค ์ฌ์กฐ๋ฆฝ |
|
|
185
|
-
| ํ์ ์์ด์ ํธ | ์คํ์ผ ๋ฏธ์ ์ฉ | ๋์ผ โ ํ์ ์์ด์ ํธ ์ธ์
์ ์์ฒด ํ๋กฌํํธ ์ ์ง |
|
|
186
|
-
| ์ ํ | `/config` ๋ฉ๋ด ๋๋ `outputStyle` ์ค์ (`/output-style` ๋ช
๋ น์ v2.1.91์์ ์ ๊ฑฐ) | `/style` ๋ช
๋ น + ์น ํผ์ปค + ์ค์ `output-style.style` |
|
|
187
|
-
|
|
188
|
-
## ๐งช ๊ฐ๋ฐ
|
|
189
|
-
|
|
190
|
-
```sh
|
|
191
|
-
pnpm install
|
|
192
|
-
pnpm run typecheck # ๋ tsc ํ๋ก์ ํธ
|
|
193
|
-
pnpm test # vitest โ 93 ํ
์คํธ
|
|
194
|
-
pnpm run verify # typecheck + ํ
์คํธ + ์์ฒด ํฌํจ ๊ฒ์ฌ(prepublishOnly ๊ฒ์ดํธ)
|
|
195
|
-
pnpm run build # lib/ ์ฐ์ถ๋ฌผ(ํธ์คํธ + ํด๋ผ์ด์ธํธ ๋ฒ๋ค)
|
|
196
|
-
pnpm pack # dsh plugin add์ฉ tarball
|
|
197
|
-
```
|
|
198
|
-
|
|
199
|
-
๋ฆด๋ฆฌ์ค: `package.json` ๋ฒ์ ๊ณผ ์ผ์นํ๋ ์ ๋ฏธ์ฌ๋ฅผ ๊ฐ์ง `v*` ํ๊ทธ๋ฅผ pushํ๋ฉด Publish ์ํฌํ๋ก๊ฐ ์คํ๋ฉ๋๋ค โ ์ ์ฒด ๊ฒ์ฆ ํ npm ๊ฒ์(provenance ํฌํจ). ๋ชจ๋ `npm publish`๋ `prepublishOnly`๋ฅผ ํตํด `verify` ๊ฒ์ดํธ๋ฅผ ํต๊ณผํฉ๋๋ค.
|
|
200
|
-
|
|
201
|
-
๊ตฌ์กฐ๋ [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/`(๋ด์ฅ ์คํ์ผ).
|
|
202
|
-
|
|
203
|
-
## ๐ฅ ๊ธฐ์ฌ์
|
|
204
|
-
|
|
205
|
-
์ด ํ๋ก์ ํธ์ ๊ธฐ์ฌํด ์ฃผ์ ๋ชจ๋ ๋ถ๊ป ๊ฐ์ฌ๋๋ฆฝ๋๋ค:
|
|
206
|
-
|
|
207
|
-
- [@PerryLink](https://github.com/PerryLink) โ ์์ฑ์์ด์ ๋ฉ์ธํ
์ด๋: ํ๋ฌ๊ทธ์ธ ์ํคํ
์ฒ, ์คํ์ผ ๋ผ์ด๋ธ๋ฌ๋ฆฌ, ๋ฒ๋ค ์ค์น, ์น ํผ์ปค, 5๊ฐ ์ธ์ด ๋ฌธ์, CI/๋ฆด๋ฆฌ์ค ๋๊ตฌ.
|
|
208
|
-
|
|
209
|
-
๋ฒ๊ทธ๋ ์์ด๋์ด๊ฐ ์์ผ์ ๊ฐ์? [issue](https://github.com/PerryLink/dsh-output-styles/issues) ๋๋ [pull request](https://github.com/PerryLink/dsh-output-styles/pulls)๋ฅผ ๋ณด๋ด ์ฃผ์ธ์. ์ด๋ค ์ธ์ด์ ๊ธฐ์ฌ๋ ํ์ํฉ๋๋ค.
|
|
210
|
-
|
|
211
|
-
## ๐ ๋ผ์ด์ ์ค
|
|
212
|
-
|
|
213
|
-
[Apache-2.0](LICENSE) ยฉ 2026 dsh-output-styles contributors
|
|
214
|
-
|
|
215
|
-
---
|
|
216
|
-
|
|
217
|
-
<sub>Topics: `dsh` ยท `dsh-plugin` ยท `deepseek-harness` ยท `output-styles` ยท `claude-code`</sub>
|