dsh-nerd-mode 0.4.3 → 0.4.5
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/NOTICE.md +1 -1
- package/README.md +305 -218
- package/README.zh.md +305 -220
- package/client.js +457 -62
- package/package.json +1 -1
- package/skills/diagram/SKILL.md +0 -2
- package/skills/teach/GLOSSARY-FORMAT.md +0 -35
- package/skills/teach/LEARNING-RECORD-FORMAT.md +0 -46
- package/skills/teach/MISSION-FORMAT.md +0 -31
- package/skills/teach/RESOURCES-FORMAT.md +0 -32
- package/skills/teach/SKILL.md +0 -140
- package/skills/teach/agents/openai.yaml +0 -5
package/README.zh.md
CHANGED
|
@@ -1,220 +1,305 @@
|
|
|
1
|
-
<p align="center">
|
|
2
|
-
<img src="assets/nerd.svg" width="280" alt="手绘的书呆子，粗框眼镜，两颗门牙">
|
|
3
|
-
</p>
|
|
4
|
-
|
|
5
|
-
<h1 align="center">Nerd Mode：dsh 学习开关</h1>
|
|
6
|
-
|
|
7
|
-
<hr>
|
|
8
|
-
|
|
9
|
-
<p align="center"><em
|
|
10
|
-
|
|
11
|
-
<p align="center">
|
|
12
|
-
<a href="
|
|
13
|
-
|
|
14
|
-
|
|
15
|
-
|
|
16
|
-
|
|
17
|
-
|
|
18
|
-
|
|
19
|
-
|
|
20
|
-
|
|
21
|
-
|
|
22
|
-
|
|
23
|
-
|
|
24
|
-
-
|
|
25
|
-
|
|
26
|
-
-
|
|
27
|
-
|
|
28
|
-
##
|
|
29
|
-
|
|
30
|
-
-
|
|
31
|
-
-
|
|
32
|
-
-
|
|
33
|
-
|
|
34
|
-
|
|
35
|
-
|
|
36
|
-
|
|
37
|
-
|
|
38
|
-
|
|
39
|
-
|
|
40
|
-
|
|
41
|
-
|
|
42
|
-
|
|
43
|
-
|
|
44
|
-
|
|
45
|
-
|
|
46
|
-
|
|
47
|
-
|
|
48
|
-
|
|
49
|
-
|
|
50
|
-
|
|
51
|
-
|
|
52
|
-
|
|
53
|
-
|
|
54
|
-
|
|
55
|
-
|
|
56
|
-
|
|
57
|
-
|
|
58
|
-
|
|
59
|
-
|
|
60
|
-
<
|
|
61
|
-
|
|
62
|
-
|
|
63
|
-
|
|
64
|
-
|
|
65
|
-
|
|
66
|
-
|
|
67
|
-
|
|
68
|
-
|
|
69
|
-
|
|
70
|
-
|
|
71
|
-
|
|
72
|
-
-
|
|
73
|
-
|
|
74
|
-
|
|
75
|
-
|
|
76
|
-
|
|
77
|
-
|
|
78
|
-
|
|
79
|
-
|
|
80
|
-
|
|
81
|
-
|
|
82
|
-
|
|
83
|
-
|
|
84
|
-
|
|
85
|
-
|
|
86
|
-
|
|
87
|
-
|
|
88
|
-
|
|
89
|
-
|
|
90
|
-
|
|
91
|
-
|
|
92
|
-
|
|
93
|
-
|
|
94
|
-
|
|
95
|
-
|
|
96
|
-
|
|
97
|
-
|
|
98
|
-
|
|
99
|
-
|
|
100
|
-
|
|
101
|
-
|
|
102
|
-
|
|
103
|
-
|
|
104
|
-
|
|
105
|
-
```text
|
|
106
|
-
/study
|
|
107
|
-
/study
|
|
108
|
-
/study
|
|
109
|
-
|
|
110
|
-
|
|
111
|
-
|
|
112
|
-
|
|
113
|
-
|
|
114
|
-
|
|
115
|
-
|
|
116
|
-
|
|
117
|
-
|
|
118
|
-
|
|
119
|
-
|
|
120
|
-
|
|
121
|
-
|
|
122
|
-
|
|
123
|
-
|
|
124
|
-
|
|
125
|
-
|
|
126
|
-
|
|
127
|
-
|
|
128
|
-
|
|
129
|
-
|
|
130
|
-
|
|
131
|
-
|
|
132
|
-
|
|
133
|
-
|
|
134
|
-
|
|
135
|
-
|
|
136
|
-
|
|
137
|
-
|
|
138
|
-
|
|
139
|
-
|
|
140
|
-
|
|
141
|
-
|
|
142
|
-
|
|
143
|
-
|
|
144
|
-
|
|
145
|
-
|
|
146
|
-
|
|
147
|
-
|
|
148
|
-
|
|
149
|
-
|
|
150
|
-
|
|
151
|
-
|
|
|
152
|
-
|
|
153
|
-
|
|
|
154
|
-
|
|
155
|
-
|
|
156
|
-
|
|
157
|
-
|
|
158
|
-
|
|
159
|
-
|
|
160
|
-
|
|
161
|
-
|
|
162
|
-
|
|
163
|
-
|
|
164
|
-
|
|
165
|
-
|
|
166
|
-
|
|
167
|
-
|
|
168
|
-
|
|
169
|
-
|
|
170
|
-
|
|
171
|
-
|
|
172
|
-
|
|
173
|
-
|
|
174
|
-
|
|
175
|
-
|
|
176
|
-
|
|
177
|
-
|
|
178
|
-
|
|
179
|
-
|
|
180
|
-
|
|
181
|
-
|
|
182
|
-
|
|
183
|
-
|
|
184
|
-
|
|
185
|
-
-
|
|
186
|
-
|
|
187
|
-
|
|
188
|
-
-
|
|
189
|
-
-
|
|
190
|
-
-
|
|
191
|
-
|
|
192
|
-
|
|
193
|
-
|
|
194
|
-
|
|
195
|
-
|
|
196
|
-
-
|
|
197
|
-
-
|
|
198
|
-
|
|
199
|
-
-
|
|
200
|
-
|
|
201
|
-
|
|
202
|
-
|
|
203
|
-
|
|
204
|
-
|
|
205
|
-
|
|
206
|
-
|
|
207
|
-
|
|
208
|
-
|
|
209
|
-
|
|
210
|
-
|
|
211
|
-
|
|
212
|
-
|
|
213
|
-
|
|
214
|
-
|
|
215
|
-
|
|
216
|
-
|
|
217
|
-
|
|
218
|
-
##
|
|
219
|
-
|
|
220
|
-
|
|
1
|
+
<p align="center">
|
|
2
|
+
<img src="assets/nerd.svg" width="280" alt="手绘的书呆子，粗框眼镜，两颗门牙">
|
|
3
|
+
</p>
|
|
4
|
+
|
|
5
|
+
<h1 align="center">Nerd Mode：dsh 学习开关</h1>
|
|
6
|
+
|
|
7
|
+
<hr>
|
|
8
|
+
|
|
9
|
+
<p align="center"><em>教育本该如此，而不只是干巴巴的讲义。</em></p>
|
|
10
|
+
|
|
11
|
+
<p align="center">
|
|
12
|
+
<a href="https://www.npmjs.com/package/dsh-nerd-mode"><img src="https://img.shields.io/npm/v/dsh-nerd-mode" alt="npm 版本"></a>
|
|
13
|
+
<a href="https://github.com/bocchii-the-code/dsh-nerd-mode/actions/workflows/check.yml"><img src="https://github.com/bocchii-the-code/dsh-nerd-mode/actions/workflows/check.yml/badge.svg" alt="构建状态"></a>
|
|
14
|
+
<a href="https://github.com/bocchii-the-code/dsh-nerd-mode/blob/main/LICENSE"><img src="https://img.shields.io/npm/l/dsh-nerd-mode" alt="许可证 MIT"></a>
|
|
15
|
+
<a href="./README.md"><img src="https://img.shields.io/badge/English-switch-d0d7de" alt="English"></a>
|
|
16
|
+
</p>
|
|
17
|
+
|
|
18
|
+
一个 DeepSeek Harness 学习开关：分步教学，并为每个 Course 留下带日期的记录。
|
|
19
|
+
|
|
20
|
+
聊天里的学习通常在答案到达时就结束了。没人检验你有没有弄懂，关掉窗口也什么都不剩。Nerd Mode 让 dsh 一步步地教，在换个选择就会改变结果的地方停下来，遇到值得跟的科目就留下带日期的记录。一个 Course 能撑过几周，而不只是一次对话。
|
|
21
|
+
|
|
22
|
+
| 命令 | 做什么 | 留下什么 |
|
|
23
|
+
|---|---|---|
|
|
24
|
+
| `/nerd-mode on` | 这次对话进入教学状态 | 不留；它只是一个开关 |
|
|
25
|
+
| `/study` | 讲一个概念，或做一件事 | 只有你指定路径时才存文件 |
|
|
26
|
+
| `/study-plus` | 跑一个 Course，每次一个概念 | 概念图、状态、日志、讲义、HTML 书 |
|
|
27
|
+
|
|
28
|
+
## 目录
|
|
29
|
+
|
|
30
|
+
- [主要功能](#主要功能)
|
|
31
|
+
- [安装](#安装)
|
|
32
|
+
- [快速开始](#快速开始)
|
|
33
|
+
- [两条学习路径](#两条学习路径)
|
|
34
|
+
- [设置](#设置)
|
|
35
|
+
- [它怎么接进 dsh](#它怎么接进-dsh)
|
|
36
|
+
- [开关改了什么](#开关改了什么)
|
|
37
|
+
- [内置技能](#内置技能)
|
|
38
|
+
- [开发](#开发)
|
|
39
|
+
- [贡献](#贡献)
|
|
40
|
+
- [卸载](#卸载)
|
|
41
|
+
- [许可](#许可)
|
|
42
|
+
|
|
43
|
+
## 主要功能
|
|
44
|
+
|
|
45
|
+
- **先有图，再上课。** 概念按先修顺序排好，分进 Book、Chapter、Section，等你批准之后才写文件。
|
|
46
|
+
- **开课前只问一轮。** 目标、背景，以及在对话里一次讲完还是建一份跟下去的记录。走记录时再问哪些概念可以跳过。
|
|
47
|
+
- **讲到分叉点就停。** 讲义一步一步地讲，在换个选择就会改变结果的地方停下来问你，不会直接把成品答案端上来。
|
|
48
|
+
- **有评分的检查。** 没见过的题加上要评分的复述，评分标准在出题之前就写好。只有你自己答出来的内容才会改写记录。
|
|
49
|
+
- **记录比对话活得久。** 概念图、状态和带日期的日志能跨重启保留，HTML 书支持全文搜索。
|
|
50
|
+
- **不用翻文件就能看进度。** Study 标签页读当前对话的记录文件，显示进度百分比，上一节、当前节、下一节三格，状态是 shaky 的概念，以及最近三轮概念循环。它只读，不写。
|
|
51
|
+
- **讲义找得回来。** Lectures 标签页按选中的 Course 列出保存过的讲义，并标出已读、未读和已归档的行。
|
|
52
|
+
|
|
53
|
+
## 安装
|
|
54
|
+
|
|
55
|
+
需要装有 profile 的 DeepSeek Harness、Node.js 22.19 或更新，Windows、macOS 或 Linux 均可。在 `@deepseek-ai/dsh` 0.2.1-rc.3 和 Node 22 上测过。
|
|
56
|
+
|
|
57
|
+
从 npm：
|
|
58
|
+
|
|
59
|
+
```powershell
|
|
60
|
+
dsh plugin --profile <profile> add dsh-nerd-mode
|
|
61
|
+
```
|
|
62
|
+
|
|
63
|
+
从 GitHub：
|
|
64
|
+
|
|
65
|
+
```powershell
|
|
66
|
+
dsh plugin --profile <profile> add github:bocchii-the-code/dsh-nerd-mode
|
|
67
|
+
```
|
|
68
|
+
|
|
69
|
+
从本地目录或压缩包：
|
|
70
|
+
|
|
71
|
+
```powershell
|
|
72
|
+
dsh plugin --profile <profile> add C:\path\to\dsh-nerd-mode
|
|
73
|
+
```
|
|
74
|
+
|
|
75
|
+
重启 dsh。每个模式都会多出 `/nerd-mode` 命令，输入框工具栏多一个 `Nerd Mode` 胶囊。模式选择器里看不到新条目，因为插件挂在 profile 层，不是预设。
|
|
76
|
+
|
|
77
|
+
## 快速开始
|
|
78
|
+
|
|
79
|
+
1. 用上面的任一命令装好插件，然后重启 dsh。
|
|
80
|
+
2. 让这次对话进入教学状态：`/nerd-mode on`。
|
|
81
|
+
3. 问一个问题：`/study 为什么 Adam 要除以 1 - β^t`。
|
|
82
|
+
4. 想把科目跟下去：`/study-plus 洗发水与 Adam 优化器`。
|
|
83
|
+
|
|
84
|
+
## 两条学习路径
|
|
85
|
+
|
|
86
|
+
两条都分步骤讲，都会在分叉点停下来问一次。区别在于它们留下什么。
|
|
87
|
+
|
|
88
|
+
显式输入 `/study` 会直接在对话里讲。显式输入 `/study-plus` 会直接进入带记录的会话，即使请求里有多个概念。打开开关、没敲命令直接提问时，学习类请求会先问一轮。它问目标、背景各选一项，以及在对话里一次讲完还是走带记录的 `/study-plus`。
|
|
89
|
+
|
|
90
|
+
<p align="center">
|
|
91
|
+
<img src="assets/two-paths.svg" width="720" alt="左右两栏对照。左边 /study 只处理一个问题和一个答案，讲完就结束。右边 /study-plus 先建概念图，再分 Book、Chapter、Section，每个概念一份讲义，并跨周记录每节课。">
|
|
92
|
+
</p>
|
|
93
|
+
|
|
94
|
+
### 快速课程：`/study`
|
|
95
|
+
|
|
96
|
+
它把一个概念或一个任务从第一步走到最后一步，只在分叉点停一次。概念按层次讲：先直觉，再术语，最后形式细节。任务直接产出成品，每一步旁边写一行理由。全程不打分，也不保存学习者记录。
|
|
97
|
+
|
|
98
|
+
适合现在就想弄懂、之后大概不会再回来的问题。
|
|
99
|
+
|
|
100
|
+
- 读论文卡在一个术语上。
|
|
101
|
+
- 今晚必须交的一道作业。
|
|
102
|
+
- 改代码之前，要先把这段逻辑理顺。
|
|
103
|
+
- 一个不大的选择，想先看清取舍再决定。
|
|
104
|
+
|
|
105
|
+
```text
|
|
106
|
+
/study 为什么 Adam 要除以 1 - β^t
|
|
107
|
+
/study 帮我把这个文件里的预条件子讲清楚 # 带代码
|
|
108
|
+
/study 帮我把第三题做完，每一步都说原因 # 带作业
|
|
109
|
+
```
|
|
110
|
+
|
|
111
|
+
你会拿到：标题、中心思想、编号步骤，每个公式上方一行符号说明。四个以上符号在多个公式里反复出现时，开头再加一张速查表。然后是一个具体例子、常见错误，以及在分叉点停的那一次。
|
|
112
|
+
|
|
113
|
+
它只写你要的东西：你指定路径的讲义或成品，以及需要配图时的一张图。图放在 `diagrams/<name>.svg`；在 Course 里，图放在 `study/<course>/diagrams/<name>.svg`。它不得读写 `graph.md`、`state.md`、`log.md` 或 `plan.md`。
|
|
114
|
+
|
|
115
|
+
### 长课程：`/study-plus`
|
|
116
|
+
|
|
117
|
+
一个 Course 组织成一本 Book，下面分 Chapter，每个 Chapter 下分 Section，每个 Section 只放一个概念。先按先修顺序建概念图，再把概念分进各章。概念图里同时带 Chapter 和 Section 两列，所以一张图里既有阅读顺序，也有先修顺序。
|
|
118
|
+
|
|
119
|
+
这个 Course 的根目录下有三个记录文件。每个概念保存一份 Markdown 讲义，放在 `study/<course>/lectures/`。你批准概念图后，它会为每个概念先写好一份完整讲稿，开讲不用等准备。它用已保存的材料生成一个 HTML 书页。
|
|
120
|
+
|
|
121
|
+
适合下个月你还在学的东西。
|
|
122
|
+
|
|
123
|
+
- 认真读一本教材、一门课或一篇论文。
|
|
124
|
+
- 想让教材的章节目录成为之后复习的骨架。
|
|
125
|
+
- 需要知道下一步该学什么，而不只是现在该问什么。
|
|
126
|
+
- 想要能拿出证据的进度。
|
|
127
|
+
|
|
128
|
+
```text
|
|
129
|
+
/study-plus 洗发水与 Adam 优化器 # 第一次建图
|
|
130
|
+
/study-plus # 之后继续同一个 Course
|
|
131
|
+
/study-plus 第 2 章 # 按书中顺序读这一章
|
|
132
|
+
/study-plus 矩阵平方根 # 直接跳到某个概念
|
|
133
|
+
```
|
|
134
|
+
|
|
135
|
+
一个 Course 就是 `study/` 下的一个文件夹，里面有一份概念图、一个状态文件、一份日志，外加讲义、图和 Book。一次对话在第一次带记录的讲解时定下 Course，之后不再问。工作区里只有一个 Course 时，`/study-plus` 直接用它，在一行里说明，不问。有多个 Course 时，用一个问题列出它们，并给出新建 Course 的选项。问到另一个科目时，只问一次：把这些概念加进当前 Course，还是新建一个 Course。
|
|
136
|
+
|
|
137
|
+
#### 第一次会话
|
|
138
|
+
|
|
139
|
+
```text
|
|
140
|
+
/study-plus <course>
|
|
141
|
+
按先修顺序给出 15 到 30 个概念，分进各章
|
|
142
|
+
章节列表和概念表一起给你看，然后等你确认
|
|
143
|
+
你批准、修改或重建概念图
|
|
144
|
+
你回答一轮开课校准：目标、背景，以及哪些概念可以跳过
|
|
145
|
+
为每个概念写一份完整讲稿，跳过的也写
|
|
146
|
+
逐个概念教：课前回忆（可选）→ 讲义 → 设置数量的没见过的题 → 复述 → 带日期的记录
|
|
147
|
+
```
|
|
148
|
+
|
|
149
|
+
批准概念图后再问剩下的开课问题：你想用这个 Course 做什么，以前读过或用过什么，概念图里哪些可以直接跳过。如果开头的提问已经问过目标和背景，这里只问哪些概念可以跳过。答案决定 `graph.md` 里的 `Teaching level` 一行，`Goal` 和 `Background` 也一并写入，之后每份讲义都按这个深度来写。
|
|
150
|
+
|
|
151
|
+
| 深度 | 什么时候用 | 讲义的样子 |
|
|
152
|
+
|---|---|---|
|
|
153
|
+
| `beginner` | 大部分先修都没学过 | 分 3 到 7 个编号步骤，每个术语都解释，每一步配一个例子 |
|
|
154
|
+
| `standard` | 学过一部分先修 | 先讲直觉，再讲形式细节，需要时给例子 |
|
|
155
|
+
| `advanced` | 大部分先修都已掌握 | 一遍讲完，不编号，从形式陈述开始，每个想法最多一个例子 |
|
|
156
|
+
|
|
157
|
+
<p align="center">
|
|
158
|
+
<img src="assets/calibration.svg" width="720" alt="开课校准流程：你批准概念图，回答一轮校准问题，答案定出教学深度。图里对照 beginner、standard、advanced 三种讲义，之后每份讲义都按选定的深度来写。">
|
|
159
|
+
</p>
|
|
160
|
+
|
|
161
|
+
深度只管讲义，不管题目、复述和记录。中途改的深度只对这次会话有效，说「以后都这样」才会改写那一行。
|
|
162
|
+
|
|
163
|
+
讲稿只是准备，不算学习。每份讲义都按 `/study` 的写作规则写，先保存再显示。概念图删掉一个概念时，它的讲义文件会移到 `lectures/archive/`，不会被删除。
|
|
164
|
+
|
|
165
|
+
之后的会话先读记录文件。你挑一章或一个概念，它用一句说明这个概念和它的先修各是什么状态。顺序不强制。先修没学也不拦你，它只讲清或建议，选哪个仍由你决定。
|
|
166
|
+
|
|
167
|
+
HTML 书页会在每次批量写稿和每节课后刷新，每节一页，还没讲过的内容标成草稿。书页沿用概念图里每个 Section 的编号，即使对应的讲义文件还没保存。上一版存成 `book.html.bak`。书页不是命令。
|
|
168
|
+
|
|
169
|
+
### 两者会留下什么
|
|
170
|
+
|
|
171
|
+
| | `/study` 快速课程 | `/study-plus` 长课程 |
|
|
172
|
+
|---|---|---|
|
|
173
|
+
| 写文件 | 只在你指定路径时保存讲稿或成品，需要图时会画 SVG | `study/<course>/` 下的概念图、状态、日志，每个概念一份文件，`book.html` 自动刷新 |
|
|
174
|
+
| 读文件 | 默认不读，但会读写你指定的成品路径 | 开口前先读那三个 |
|
|
175
|
+
| 下次还记得 | 不记得 | 记得，带日期 |
|
|
176
|
+
| 批改 | 不批 | 按概念批，先写评分标准 |
|
|
177
|
+
| 组织方式 | 一个概念、一个任务，或一次性的书式讲解 | Book、Chapter、Section |
|
|
178
|
+
| 典型长度 | 一次坐完，一个概念 | 15 到 30 个概念，跨几周 |
|
|
179
|
+
|
|
180
|
+
`/study` 自己不会建 `study/` 文件夹。`/study-plus` 不排复习时间表，也不猜你会什么。
|
|
181
|
+
|
|
182
|
+
### 怎么选
|
|
183
|
+
|
|
184
|
+
<p align="center">
|
|
185
|
+
<img src="assets/choose-a-mode.svg" width="720" alt="一个问题，这个主题你还会再回来吗，分成是和否两支。否走 /study，一次坐完，不留记录。是走 /study-plus，连着几周上课，留下带日期的记录。一条标着「还会回来」的弧线箭头从 /study 指向 /study-plus。">
|
|
186
|
+
</p>
|
|
187
|
+
|
|
188
|
+
- 问完就不会再回来的问题，用 `/study`。
|
|
189
|
+
- 要连着几周的东西，用 `/study-plus`。
|
|
190
|
+
- 想让教材的章节目录成为复习骨架，用 `/study-plus`，它会把教材的章映射成 Chapter。
|
|
191
|
+
- 先用 `/study`，发现自己一直在回来，就用 `/study-plus` 建一次概念图，之前聊过的内容照样用得上。
|
|
192
|
+
|
|
193
|
+
### 命令
|
|
194
|
+
|
|
195
|
+
```text
|
|
196
|
+
/nerd-mode on 这次对话进入教学状态
|
|
197
|
+
/nerd-mode off
|
|
198
|
+
/study <概念或任务>
|
|
199
|
+
/study-plus <course> 记录写在三个文件里
|
|
200
|
+
```
|
|
201
|
+
|
|
202
|
+
输入框工具栏里的胶囊发的就是 `/nerd-mode`。它排在 Full Throttle 左边，一直显示，关闭时变暗。
|
|
203
|
+
|
|
204
|
+
## 设置
|
|
205
|
+
|
|
206
|
+
改默认值：设置 → Nerd Mode。
|
|
207
|
+
|
|
208
|
+
| 设置 | 可选 | 默认 |
|
|
209
|
+
|---|---|---|
|
|
210
|
+
| 课前回忆 | 开、关 | 关 |
|
|
211
|
+
| 每节课后的题数 | 0 到 10 | 3 |
|
|
212
|
+
| 题型 | 简答、四选一、混合 | 简答 |
|
|
213
|
+
|
|
214
|
+
四选一以卡片出现，四个选项里只有一个对；简答直接在对话里问。保存从下一节课开始生效，取消只丢草稿，恢复默认回到关闭、3 题、简答。在一次 `/study-plus` 请求里明确说出的偏好，只对那一次会话生效，不会改 profile。
|
|
215
|
+
|
|
216
|
+
底部的「关于」显示已安装版本和 npm 上的最新版本。点按钮会通过 DSH Market 安装更新；宿主允许时还会给出重启按钮。整页文案跟随 DSH 界面语言。
|
|
217
|
+
|
|
218
|
+
## 它怎么接进 dsh
|
|
219
|
+
|
|
220
|
+
Nerd Mode 是一个挂在 profile 层的插件，由 `cordis.patch.yml` 装入。补丁覆盖整个 profile，所以每个模式都有命令和胶囊。
|
|
221
|
+
|
|
222
|
+
```text
|
|
223
|
+
package.json
|
|
224
|
+
├── dsh.bundle.patch → cordis.patch.yml
|
|
225
|
+
│ ├── dsh-nerd-mode → lib/index.js
|
|
226
|
+
│ │ ├── session projection — 开关状态，从会话日志折叠出来
|
|
227
|
+
│ │ ├── prompt section — assets/section.md，顺序 550，只在开着时注入
|
|
228
|
+
│ │ └── /nerd-mode — 开关
|
|
229
|
+
│ ├── study-plus-skills — skills/ 作为文件系统技能来源
|
|
230
|
+
│ └── goal packages — 已禁用
|
|
231
|
+
└── dsh.client → client.js：胶囊、Study 标签页、Lectures 标签页、设置页
|
|
232
|
+
```
|
|
233
|
+
|
|
234
|
+
**状态**存在一个 session projection 里，从会话日志折叠出来，所以压缩上下文、恢复会话、分叉都不丢。只有那个状态是「开着」时，提示段落才有内容。
|
|
235
|
+
|
|
236
|
+
**提示文字**就是 `assets/section.md`，也是插件唯一加进提示的文本，所以 profile 补丁里不会留一份过期的副本。配置里的 `section` 可以替换它。
|
|
237
|
+
|
|
238
|
+
**设置**只在带记录的会话里，以一小段默认值附在那段提示后面。它们从不改变工具目录。
|
|
239
|
+
|
|
240
|
+
**补丁范围**覆盖整个 profile。补丁用 `!!js` 表达式加载 `skills/`，改之前要按宿主进程代码来审。补丁还禁用了三个 goal 包，因为内置的 goal 工具会把一次讲解变成自动续跑的循环。
|
|
241
|
+
|
|
242
|
+
## 开关改了什么
|
|
243
|
+
|
|
244
|
+
- 它改的是文字，不是工具，只作用于这一次会话。工具目录和提示缓存都不变，压缩上下文、恢复会话也不丢状态。
|
|
245
|
+
- 只对学习类请求生效：讲清概念、辅导作业、讲解代码、准备考试。写功能、查资料、改配置、跑命令照常。
|
|
246
|
+
- 命令执行失败时，窗口顶部会弹一条说明原因的提示，胶囊保持原状态。
|
|
247
|
+
- 子代理各自跑自己的会话，所以默认都是关闭的。
|
|
248
|
+
- 它删不掉基础模式的人格文字，只能声明自己的规则优先。
|
|
249
|
+
|
|
250
|
+
## 内置技能
|
|
251
|
+
|
|
252
|
+
### 教学
|
|
253
|
+
|
|
254
|
+
- `study`：不打分的引导式讲解，也是讲义的写作标准。按需存文件，需要图时会画。
|
|
255
|
+
- `study-plus`：带记录的会话。Book、Chapter、Section，每个概念一份讲义，按概念批改。
|
|
256
|
+
- `diagram`：一个概念一张 SVG 图。为本包编写。
|
|
257
|
+
|
|
258
|
+
### 通用工具
|
|
259
|
+
|
|
260
|
+
这四个随包一起装，但不属于教学流程，也不读写 Tracker。
|
|
261
|
+
|
|
262
|
+
- `answer-me-with-html`：一页式 HTML 图解，作者 QingYunA。
|
|
263
|
+
- `writing-beats`：逐拍结构的文章写法，作者 Matt Pocock。
|
|
264
|
+
- `humanizer`：把 AI 味的文字改回人话，作者 Siqi Chen。
|
|
265
|
+
- `convert-documents-to-markdown`：Word、PDF、电子书转换，作者 firecrawl。
|
|
266
|
+
|
|
267
|
+
## 开发
|
|
268
|
+
|
|
269
|
+
```powershell
|
|
270
|
+
git clone https://github.com/bocchii-the-code/dsh-nerd-mode
|
|
271
|
+
cd dsh-nerd-mode
|
|
272
|
+
npm install
|
|
273
|
+
npm run check
|
|
274
|
+
```
|
|
275
|
+
|
|
276
|
+
`npm run check` 跑 ESLint 和 Node 测试。`npm test` 只跑测试，`npm run lint` 只跑 ESLint。
|
|
277
|
+
|
|
278
|
+
| 路径 | 内容 |
|
|
279
|
+
|---|---|
|
|
280
|
+
| `lib/index.js` | 插件入口：投影、提示段落、命令、会话默认值 |
|
|
281
|
+
| `lib/fold.js` | 状态折叠与常量 |
|
|
282
|
+
| `client.js` | 输入框胶囊、Study 与 Lectures 标签页、设置页 |
|
|
283
|
+
| `assets/section.md` | 教学策略提示词 |
|
|
284
|
+
| `skills/` | 随包的技能 |
|
|
285
|
+
| `test/` | 每个界面一个文件，由 `node --test` 运行 |
|
|
286
|
+
|
|
287
|
+
想试本地构建，把这个目录当插件装：`dsh plugin --profile <profile> add .`
|
|
288
|
+
|
|
289
|
+
如果你改了包名，记得同步 `cordis.patch.yml` 里的 `resolve('dsh-nerd-mode/package.json')`。
|
|
290
|
+
|
|
291
|
+
设计记录：[SPEC v3](./docs/specs/2026-10-28-study-plus-v3.md)、[v2，历史版本](./docs/specs/2026-10-27-study-plus-v2.md)、[会话默认值](./docs/specs/2026-10-28-nerd-mode-settings.md)、[GLOSSARY.md](./GLOSSARY.md)、`docs/adr/`。文档结构见 [docs/README.md](./docs/README.md)。版本变更记录：[CHANGELOG.md](https://github.com/bocchii-the-code/dsh-nerd-mode/blob/main/CHANGELOG.md)。
|
|
292
|
+
|
|
293
|
+
## 贡献
|
|
294
|
+
|
|
295
|
+
欢迎在 [GitHub](https://github.com/bocchii-the-code/dsh-nerd-mode/issues) 提 issue 和 pull request。提交前先跑 `npm run check`。如果要改教学提示词，先读 `docs/adr/`，那里记录了提示词行为的原因。
|
|
296
|
+
|
|
297
|
+
## 卸载
|
|
298
|
+
|
|
299
|
+
```powershell
|
|
300
|
+
dsh plugin --profile <profile> remove dsh-nerd-mode
|
|
301
|
+
```
|
|
302
|
+
|
|
303
|
+
## 许可
|
|
304
|
+
|
|
305
|
+
MIT。随包的第三方技能各自保留许可，见 [NOTICE.md](./NOTICE.md)。
|