dsh-learn-mode 0.1.2 → 0.2.0

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 (37) hide show
  1. package/client/client.js +452 -0
  2. package/cordis.patch.yml +20 -16
  3. package/index.js +19 -0
  4. package/package.json +42 -13
  5. package/skills/dsh-learn-mode/SKILL.md +7 -5
  6. package/skills/learn-synthesizer/SKILL.md +278 -0
  7. package/skills/learn-synthesizer/analysis/workspace-file-convention.md +402 -0
  8. package/skills/learn-synthesizer/evals/evals.json +72 -0
  9. package/skills/learn-synthesizer/references/axis-types.md +20 -0
  10. package/skills/learn-synthesizer/references/example-structures.md +291 -0
  11. package/skills/learn-synthesizer/references/feedback-types.md +296 -0
  12. package/skills/learn-synthesizer/references/gotchas.md +322 -0
  13. package/skills/learn-synthesizer/references/sub-agent-prompt.md +222 -0
  14. package/skills/learn-synthesizer/rules/core-principles.md +173 -0
  15. package/skills/learn-synthesizer/rules/output-format.md +355 -0
  16. package/skills/learn-synthesizer/rules/quality-gates.md +209 -0
  17. package/skills/learn-synthesizer/scripts/pdf_to_md.py +124 -0
  18. package/skills/learn-synthesizer/templates/MISSION.md +38 -0
  19. package/skills/learn-synthesizer/templates/deep-dive.md +73 -0
  20. package/skills/learn-synthesizer/templates/map-evolution.md +38 -0
  21. package/skills/learn-synthesizer/templates/understanding-map.md +42 -0
  22. package/skills/learn-synthesizer/workflows/stage0.5-mission.md +141 -0
  23. package/skills/learn-synthesizer/workflows/stage1-collect.md +214 -0
  24. package/skills/learn-synthesizer/workflows/stage2-extract.md +254 -0
  25. package/skills/learn-synthesizer/workflows/stage2.5-importance.md +197 -0
  26. package/skills/learn-synthesizer/workflows/stage3-merge.md +492 -0
  27. package/skills/learn-synthesizer/workflows/stage3.5-gap.md +317 -0
  28. package/skills/learn-synthesizer/workflows/stage4-chapter-agent.md +342 -0
  29. package/skills/learn-synthesizer/workflows/stage4-ref-extract.md +111 -0
  30. package/skills/learn-synthesizer/workflows/stage4-write.md +355 -0
  31. package/skills/learn-synthesizer/workflows/stage4.5-verify.md +327 -0
  32. package/skills/learn-synthesizer/workflows/stage5-review.md +196 -0
  33. package/skills/learn-synthesizer/workflows/stage5.5-iterate.md +297 -0
  34. package/skills/learn-synthesizer/workflows/stage6-finalize.md +310 -0
  35. package/skills/learn-synthesizer/workflows/stage6-progressive.md +173 -0
  36. package/skills-provider.mjs +99 -0
  37. package/workbench-host.mjs +425 -0
@@ -0,0 +1,452 @@
1
+ /**
2
+ * 学习阅读器(右栏页签)客户端 bundle。
3
+ *
4
+ * 手写 ModuleLoader 格式:宿主只提供已构建 bundle,本文件不经 TS 构建。
5
+ * 通过 ctx.sidebarRightTabs 注册 kind=study.reader,正文在
6
+ * sidebar.right.pane.tab 席位渲染;文件内容由 Host 的 /study-workbench/* 提供。
7
+ * 只使用 React 公开 API 与 fetch,不依赖任何 Harness Client 包。
8
+ */
9
+ window.__ModuleLoader__.load({
10
+ id: 'dsh-learn-mode',
11
+ factory: function (require) {
12
+ var module = { exports: {} }
13
+ var exports = module.exports
14
+ const React = require('react')
15
+ const { useCallback, useEffect, useRef, useState } = React
16
+
17
+ const KIND = 'study.reader'
18
+ const TAB_ID = 'study.reader'
19
+ const lsKey = (sid) => 'dsh.study.reader.' + sid
20
+
21
+ function loadState(sid) {
22
+ try { return JSON.parse(localStorage.getItem(lsKey(sid)) || '{}') } catch { return {} }
23
+ }
24
+ function saveState(sid, next) {
25
+ try { localStorage.setItem(lsKey(sid), JSON.stringify(next)) } catch { /* 忽略配额错误 */ }
26
+ }
27
+
28
+ function escapeHtml(s) {
29
+ return String(s)
30
+ .replace(/&/g, '&')
31
+ .replace(/</g, '&lt;')
32
+ .replace(/>/g, '&gt;')
33
+ .replace(/"/g, '&quot;')
34
+ .replace(/'/g, '&#39;')
35
+ }
36
+
37
+ function inline(s) {
38
+ let t = escapeHtml(s)
39
+ t = t.replace(/`([^`]+)`/g, '<code>$1</code>')
40
+ t = t.replace(/\*\*([^*]+)\*\*/g, '<strong>$1</strong>')
41
+ t = t.replace(/\[([^\]]+)\]\(([^)]+)\)/g, function (all, label, href) {
42
+ if (/^\/\//.test(href) || !/^(https?:\/\/|\/|#|\.)/i.test(href)) return all
43
+ return '<a href="' + href + '" target="_blank" rel="noreferrer noopener">' + label + '</a>'
44
+ })
45
+ return t
46
+ }
47
+
48
+ function mdToHtml(src) {
49
+ const lines = String(src).replace(/\r\n/g, '\n').split('\n')
50
+ const out = []
51
+ let inCode = false
52
+ let code = []
53
+ for (const line of lines) {
54
+ if (/^```/.test(line)) {
55
+ if (inCode) { out.push('<pre><code>' + escapeHtml(code.join('\n')) + '</code></pre>'); code = []; inCode = false }
56
+ else inCode = true
57
+ continue
58
+ }
59
+ if (inCode) { code.push(line); continue }
60
+ if (/^\s*$/.test(line)) { out.push(''); continue }
61
+ let m
62
+ if ((m = /^(#{1,6})\s+(.*)$/.exec(line))) {
63
+ const n = m[1].length
64
+ out.push('<h' + n + '>' + inline(m[2]) + '</h' + n + '>')
65
+ continue
66
+ }
67
+ if ((m = /^\s*[-*+]\s+(.*)$/.exec(line))) { out.push('<li>' + inline(m[1]) + '</li>'); continue }
68
+ if ((m = /^\s*\d+[.)]\s+(.*)$/.exec(line))) { out.push('<li>' + inline(m[1]) + '</li>'); continue }
69
+ out.push('<p>' + inline(line) + '</p>')
70
+ }
71
+ if (inCode) out.push('<pre><code>' + escapeHtml(code.join('\n')) + '</code></pre>')
72
+ return out.join('\n').replace(/(?:<li>[\s\S]*?<\/li>\n?)+/g, function (block) {
73
+ return '<ul>' + block.trim() + '</ul>'
74
+ })
75
+ }
76
+
77
+ const CITATION_HEADER = '[学习引用]'
78
+ const CITATION_FOOTER = '[/学习引用]'
79
+ const CITATION_LIMIT = 500
80
+
81
+ // 在源文中定位选中文本,返回 1 基行号范围;找不到时返回 null(载荷不带行号)
82
+ function lineRangeOf(source, text) {
83
+ const src = String(source || '')
84
+ const needle = String(text || '')
85
+ if (!needle) return null
86
+ const idx = src.indexOf(needle)
87
+ if (idx < 0) return null
88
+ const start = src.slice(0, idx).split('\n').length
89
+ const end = start + (needle.match(/\n/g) || []).length
90
+ return { start: start, end: end }
91
+ }
92
+
93
+ // [学习引用] 纯文本载荷:总长不超过 500 字,超长截断并加省略号
94
+ function buildCitation(input) {
95
+ const path = String((input && input.path) || '').trim()
96
+ const raw = String((input && input.text) || '').replace(/\r\n/g, '\n').trim()
97
+ .replace(/\[\/学习引用\]/g, '[/学习引用]')
98
+ .replace(/\[学习引用\]/g, '[学习引用]')
99
+ const hasRange = !!(input && input.startLine)
100
+ const range = hasRange ? { start: input.startLine, end: input.endLine || input.startLine } : null
101
+ const head = CITATION_HEADER + '\n'
102
+ + '文件: ' + path + '\n'
103
+ + (range ? '位置: 第 ' + range.start + (range.end !== range.start ? '-' + range.end : '') + ' 行\n' : '')
104
+ + '内容:\n'
105
+ const tail = '\n问题: \n' + CITATION_FOOTER
106
+ const room = Math.max(0, CITATION_LIMIT - head.length - tail.length)
107
+ const body = raw.length > room
108
+ ? raw.slice(0, Math.max(0, room - 1)) + '…'
109
+ : raw
110
+ return head + body + tail
111
+ }
112
+
113
+ // 多段引用:同一文件只写一次“文件:”行,每段保留自己的位置与内容;总长仍 ≤500
114
+ function buildCitationMulti(inputs) {
115
+ const list = Array.isArray(inputs) ? inputs : []
116
+ if (list.length === 0) return ''
117
+ const tail = '\n问题: \n' + CITATION_FOOTER
118
+ let out = CITATION_HEADER + '\n'
119
+ let lastPath = null
120
+ for (let i = 0; i < list.length; i += 1) {
121
+ const input = list[i] || {}
122
+ const path = String(input.path || '').trim()
123
+ const raw = String(input.text || '').replace(/\r\n/g, '\n').trim()
124
+ .replace(/\[\/学习引用\]/g, '[/学习引用]')
125
+ .replace(/\[学习引用\]/g, '[学习引用]')
126
+ if (!raw) continue
127
+ let piece = ''
128
+ if (path !== lastPath) { piece += '文件: ' + path + '\n'; lastPath = path }
129
+ if (input.startLine) {
130
+ const end = input.endLine || input.startLine
131
+ piece += '位置: 第 ' + input.startLine + (end !== input.startLine ? '-' + end : '') + ' 行\n'
132
+ }
133
+ piece += '内容:\n'
134
+ const room = Math.max(0, CITATION_LIMIT - out.length - piece.length - tail.length - 2)
135
+ if (raw.length > room) {
136
+ out += piece + raw.slice(0, Math.max(0, room - 1)) + '…' + tail
137
+ return out
138
+ }
139
+ out += piece + raw + (i === list.length - 1 ? '' : '\n---\n')
140
+ }
141
+ return out + tail
142
+ }
143
+
144
+ // HTML 双档安全策略:静态档完全禁脚本;交互档只加 allow-scripts,永不给 allow-same-origin
145
+ function htmlCsp(mode) {
146
+ const base = "default-src 'none'; img-src data: blob:; style-src 'unsafe-inline'; form-action 'none'; base-uri 'none'"
147
+ return mode === 'interactive' ? base + "; script-src 'unsafe-inline'" : base
148
+ }
149
+
150
+ function stripSelfNavigation(html) {
151
+ return String(html || '')
152
+ .replace(/<meta[^>]*http-equiv\s*=\s*("|')?refresh\1?[^>]*>/gi, '')
153
+ .replace(/<base\b[^>]*>/gi, '')
154
+ }
155
+
156
+ function withCsp(html, mode) {
157
+ const text = stripSelfNavigation(html)
158
+ // 始终注入我方 CSP:多条策略取交集,只会更严,不能因页面自带 CSP 就放行
159
+ const meta = '<meta http-equiv="Content-Security-Policy" content="' + htmlCsp(mode) + '">'
160
+ if (/<head[^>]*>/i.test(text)) return text.replace(/<head[^>]*>/i, function (m) { return m + meta })
161
+ return meta + text
162
+ }
163
+
164
+ function htmlFrameProps(mode, html) {
165
+ const safeMode = mode === 'interactive' ? 'interactive' : 'static'
166
+ return {
167
+ 'data-study-html': safeMode,
168
+ sandbox: safeMode === 'interactive' ? 'allow-scripts' : '',
169
+ srcDoc: withCsp(html, safeMode),
170
+ }
171
+ }
172
+
173
+ function stripSelfNavigationExport(html) { return stripSelfNavigation(html) }
174
+
175
+ async function getJson(url) {
176
+ const res = await fetch(url, { headers: { accept: 'application/json' } })
177
+ if (!res.ok) throw new Error('HTTP ' + res.status)
178
+ return res.json()
179
+ }
180
+
181
+ let pluginCtx = null
182
+ let presentTimer = null
183
+
184
+ function ReaderBody(props) {
185
+ const sessionId = props.sessionId
186
+ if (typeof window !== 'undefined') window.__studyReaderSession = sessionId
187
+ const [manifest, setManifest] = useState(null)
188
+ const [error, setError] = useState('')
189
+ const [notice, setNotice] = useState('')
190
+ const [active, setActive] = useState(null)
191
+ const [content, setContent] = useState(null)
192
+ const [cite, setCite] = useState(null)
193
+ const [pending, setPending] = useState([])
194
+ const [fallback, setFallback] = useState('')
195
+ const inputActions = props.inputActions
196
+ if (typeof window !== 'undefined') window.__studyReaderActions = inputActions
197
+ const paneRef = useRef(null)
198
+ const stateRef = useRef(loadState(sessionId))
199
+
200
+ const loadManifest = useCallback(async (subject, node) => {
201
+ const qs = new URLSearchParams({ session: sessionId })
202
+ if (subject) qs.set('subject', subject)
203
+ if (node) qs.set('node', node)
204
+ return getJson('/study-workbench/manifest?' + qs.toString())
205
+ }, [sessionId])
206
+
207
+ const openItem = useCallback(async (m, item) => {
208
+ if (!item) return
209
+ if (!item.exists) {
210
+ setActive(item)
211
+ setContent({ text: '(内容文件不存在:' + item.path + ')', mime: 'text/plain', url: '' })
212
+ return
213
+ }
214
+ const rel = item.full || item.path
215
+ const qs = new URLSearchParams({ session: sessionId, path: rel })
216
+ if (m.subjectDir) qs.set('subject', m.subjectDir)
217
+ const url = '/study-workbench/file?' + qs.toString()
218
+ const res = await fetch(url)
219
+ if (!res.ok) { setError('读取失败 HTTP ' + res.status); return }
220
+ const mime = res.headers.get('content-type') || ''
221
+ const hash = res.headers.get('x-study-hash') || ''
222
+ const htmlMode = res.headers.get('x-study-html-mode') || 'static'
223
+ const text = mime.indexOf('image/') === 0 ? '' : await res.text()
224
+ const prev = (stateRef.current.hashes || {})[rel]
225
+ setNotice(prev && hash && prev !== hash ? '内容已更新:' + rel : '')
226
+ stateRef.current.hashes = Object.assign({}, stateRef.current.hashes, { [rel]: hash })
227
+ stateRef.current.path = rel
228
+ stateRef.current.subject = m.subjectDir || null
229
+ saveState(sessionId, stateRef.current)
230
+ setError('')
231
+ setActive(item)
232
+ setContent({ text: text, mime: mime, url: url, htmlMode: htmlMode })
233
+ requestAnimationFrame(function () {
234
+ const el = paneRef.current
235
+ if (el) el.scrollTop = (stateRef.current.scroll || {})[item.path] || 0
236
+ })
237
+ }, [sessionId])
238
+
239
+ const openNode = useCallback(async (nodeId) => {
240
+ try {
241
+ const m = await loadManifest(stateRef.current.subject || undefined, nodeId)
242
+ setManifest(m)
243
+ const want = (stateRef.current.path && m.items.find(function (it) { return (it.full || it.path) === stateRef.current.path })) || m.items[0]
244
+ if (want) await openItem(m, want)
245
+ } catch (e) { setError(String(e && e.message ? e.message : e)) }
246
+ }, [loadManifest, openItem])
247
+
248
+ // present 轮询:章节就绪信号到达后自动打开阅读器页签
249
+ useEffect(function () {
250
+ let stop = false
251
+ async function tick() {
252
+ try {
253
+ let p = await getJson('/study-workbench/present?session=' + encodeURIComponent(sessionId))
254
+ if (!p || !p.at) p = await getJson('/study-workbench/present/latest')
255
+ if (stop || !p || !p.at || p.at === stateRef.current.presentAt) return
256
+ stateRef.current.presentAt = p.at
257
+ saveState(sessionId, stateRef.current)
258
+ if (p.subject) stateRef.current.subject = p.subject
259
+ const m = await loadManifest(p.subject || undefined, p.node || undefined)
260
+ if (stop) return
261
+ setManifest(m)
262
+ const sidebar = pluginCtx && pluginCtx.sidebarRight
263
+ if (sidebar && typeof sidebar.openTab === 'function') {
264
+ try { sidebar.openTab(KIND, { revealIfOpened: true }) } catch { /* 无会话面时忽略 */ }
265
+ }
266
+ const want = (stateRef.current.path && m.items.find(function (it) { return (it.full || it.path) === stateRef.current.path })) || m.items[0]
267
+ if (want) await openItem(m, want)
268
+ } catch { /* 轮询失败静默,下轮再试 */ }
269
+ }
270
+ tick()
271
+ const timer = setInterval(tick, 1500)
272
+ return function () { stop = true; clearInterval(timer) }
273
+ }, [sessionId, loadManifest, openItem])
274
+
275
+ // 首次挂载:若无 present,也尝试按上次学科恢复
276
+ useEffect(function () {
277
+ if (manifest !== null) return
278
+ const subject = stateRef.current.subject
279
+ if (!subject) return
280
+ loadManifest(subject).then(function (m) {
281
+ setManifest(m)
282
+ }).catch(function () { /* 无信号时不打扰 */ })
283
+ }, [manifest, loadManifest])
284
+
285
+ const onScroll = function (e) {
286
+ if (!active) return
287
+ stateRef.current.scroll = Object.assign({}, stateRef.current.scroll, { [active.path]: e.target.scrollTop })
288
+ saveState(sessionId, stateRef.current)
289
+ }
290
+
291
+ // 在正文中划选后弹出“提问”浮层;仅对 Markdown 文本生效
292
+ const onSelect = function () {
293
+ if (!active || !content) return
294
+ if (content.mime.indexOf('image/') === 0 || content.mime.indexOf('text/html') === 0) { setCite(null); return }
295
+ const sel = typeof window !== 'undefined' && window.getSelection ? window.getSelection() : null
296
+ if (!sel || sel.isCollapsed || !sel.rangeCount) { setCite(null); return }
297
+ const pane = paneRef.current
298
+ const anchor = sel.anchorNode
299
+ const anchorEl = anchor && anchor.nodeType === 3 ? anchor.parentNode : anchor
300
+ if (!pane || !anchorEl || !pane.contains(anchorEl)) { setCite(null); return }
301
+ const text = String(sel.toString() || '').trim()
302
+ if (!text) { setCite(null); return }
303
+ const rect = sel.getRangeAt(0).getBoundingClientRect()
304
+ const range = lineRangeOf(content.text, text)
305
+ setCite({
306
+ top: Math.max(8, rect.bottom + 6),
307
+ left: Math.max(8, rect.left),
308
+ text: text,
309
+ startLine: range ? range.start : null,
310
+ endLine: range ? range.end : null,
311
+ })
312
+ }
313
+
314
+ const addPending = function () {
315
+ if (!cite) return
316
+ const rel = (active && (active.full || active.path)) || ''
317
+ setPending(function (prev) {
318
+ return prev.concat([{ path: rel, text: cite.text, startLine: cite.startLine, endLine: cite.endLine }])
319
+ })
320
+ setCite(null)
321
+ }
322
+
323
+ const insertCitation = function () {
324
+ const rel = (active && (active.full || active.path)) || ''
325
+ const current = cite ? [{ path: rel, text: cite.text, startLine: cite.startLine, endLine: cite.endLine }] : []
326
+ const all = pending.concat(current)
327
+ if (all.length === 0) return
328
+ const payload = all.length === 1 ? buildCitation(all[0]) : buildCitationMulti(all)
329
+ let ok = false
330
+ try {
331
+ if (inputActions && typeof inputActions.captureInsertion === 'function' && typeof inputActions.insertText === 'function') {
332
+ const span = inputActions.captureInsertion()
333
+ ok = inputActions.insertText(payload, span) === true
334
+ }
335
+ } catch { ok = false }
336
+ setFallback(ok ? '' : payload)
337
+ setCite(null)
338
+ if (ok) setPending([])
339
+ }
340
+
341
+ const copyFallback = function () {
342
+ try { if (navigator.clipboard) navigator.clipboard.writeText(fallback) } catch { /* 忽略 */ }
343
+ }
344
+
345
+ if (manifest === null) {
346
+ return React.createElement('div', { style: { padding: '12px', fontSize: '13px', color: '#666' } },
347
+ error ? '学习阅读器:' + error : '学习阅读器待命(收到章节呈现信号后自动打开)')
348
+ }
349
+
350
+ const nodes = manifest.nodes || []
351
+ const items = manifest.items || []
352
+
353
+ return React.createElement('div', { 'data-study-reader': 'root', style: { display: 'flex', flexDirection: 'column', height: '100%', minHeight: 0, fontSize: '13px' } },
354
+ React.createElement('div', { style: { padding: '8px 12px', borderBottom: '1px solid rgba(127,127,127,.25)', display: 'flex', gap: '8px', alignItems: 'baseline' } },
355
+ React.createElement('strong', null, manifest.subject || '学习'),
356
+ manifest.node ? React.createElement('span', { style: { color: '#666' } }, manifest.node.title || manifest.node.id) : null,
357
+ React.createElement('span', { style: { marginLeft: 'auto', color: '#999' } }, items.length + ' 个内容文件')),
358
+ notice ? React.createElement('div', { 'data-study-notice': 'updated', style: { padding: '4px 12px', color: '#a60' } }, notice) : null,
359
+ React.createElement('div', { style: { display: 'flex', flex: '1', minHeight: 0 } },
360
+ React.createElement('nav', { 'data-study-toc': 'nav', style: { width: '180px', overflow: 'auto', borderRight: '1px solid rgba(127,127,127,.2)', padding: '6px' } },
361
+ nodes.map(function (n) {
362
+ return React.createElement('button', {
363
+ key: n.id,
364
+ type: 'button',
365
+ 'data-node-id': n.id,
366
+ onClick: function () { openNode(n.id) },
367
+ style: { display: 'block', width: '100%', textAlign: 'left', padding: '4px 6px', margin: '1px 0', background: manifest.node && manifest.node.id === n.id ? 'rgba(64,128,255,.12)' : 'transparent', border: 0, borderRadius: '4px', cursor: 'pointer', color: n.hasContent ? 'inherit' : '#999' },
368
+ }, n.id + ' ' + (n.title || ''))
369
+ })),
370
+ React.createElement('main', { style: { flex: '1', minWidth: 0, display: 'flex', flexDirection: 'column' } },
371
+ items.length > 1 ? React.createElement('div', { style: { display: 'flex', gap: '6px', padding: '6px 10px', flexWrap: 'wrap' } },
372
+ items.map(function (it) {
373
+ return React.createElement('button', {
374
+ key: it.path, type: 'button', 'data-item-path': it.path,
375
+ onClick: function () { openItem(manifest, it) },
376
+ style: { padding: '2px 8px', borderRadius: '10px', border: '1px solid rgba(127,127,127,.3)', background: active && active.path === it.path ? 'rgba(64,128,255,.15)' : 'transparent', cursor: 'pointer', fontSize: '12px' },
377
+ }, it.path.split('/').pop())
378
+ })) : null,
379
+ pending.length ? React.createElement('div', { 'data-study-pending': String(pending.length), style: { padding: '4px 10px', fontSize: '12px', color: '#1f4fd8', display: 'flex', gap: '8px', alignItems: 'center' } },
380
+ React.createElement('span', null, '已暂存 ' + pending.length + ' 段引用'),
381
+ React.createElement('button', { type: 'button', onClick: insertCitation, style: { padding: '1px 8px', cursor: 'pointer' } }, '插入全部'),
382
+ React.createElement('button', { type: 'button', onClick: function () { setPending([]) }, style: { padding: '1px 8px', cursor: 'pointer' } }, '清空')) : null,
383
+ React.createElement('div', { ref: paneRef, onScroll: onScroll, onMouseUp: onSelect, onKeyUp: onSelect, 'data-study-content': 'pane', style: { flex: '1', overflow: 'auto', padding: '10px 14px', minHeight: 0 } },
384
+ content === null ? React.createElement('p', { style: { color: '#888' } }, '选择左侧节点开始阅读')
385
+ : content.mime.indexOf('image/') === 0 ? React.createElement('img', { src: content.url, alt: active ? active.path : '', style: { maxWidth: '100%' } })
386
+ : content.mime.indexOf('text/html') === 0 ? React.createElement('iframe', Object.assign({
387
+ style: { width: '100%', height: '100%', border: 0, background: '#fff' },
388
+ }, htmlFrameProps(content.htmlMode, content.text)))
389
+ : React.createElement('div', { dangerouslySetInnerHTML: { __html: mdToHtml(content.text) } })))),
390
+ cite ? React.createElement('div', {
391
+ style: { position: 'fixed', top: cite.top + 'px', left: cite.left + 'px', zIndex: 9999, display: 'flex', gap: '4px' },
392
+ },
393
+ React.createElement('button', {
394
+ type: 'button', 'data-study-ask': 'citation', onClick: insertCitation,
395
+ style: { padding: '3px 10px', borderRadius: '12px', border: '1px solid rgba(64,128,255,.6)', background: '#fff', color: '#1f4fd8', cursor: 'pointer', boxShadow: '0 2px 8px rgba(0,0,0,.15)' },
396
+ }, '提问'),
397
+ React.createElement('button', {
398
+ type: 'button', 'data-study-append': 'citation', onClick: addPending,
399
+ style: { padding: '3px 10px', borderRadius: '12px', border: '1px solid rgba(127,127,127,.5)', background: '#fff', color: '#444', cursor: 'pointer', boxShadow: '0 2px 8px rgba(0,0,0,.15)' },
400
+ }, '加入多段')) : null,
401
+ fallback ? React.createElement('div', {
402
+ 'data-study-citation-fallback': '1',
403
+ style: { position: 'fixed', right: '16px', bottom: '16px', width: '360px', maxHeight: '45vh', overflow: 'auto', zIndex: 9999, background: '#fff', border: '1px solid rgba(160,80,0,.5)', borderRadius: '6px', padding: '8px', boxShadow: '0 4px 16px rgba(0,0,0,.2)' },
404
+ },
405
+ React.createElement('div', { style: { fontSize: '12px', color: '#a60', marginBottom: '4px' } }, '没能插入输入框,请手动复制下面内容:'),
406
+ React.createElement('textarea', { readOnly: true, value: fallback, 'data-study-citation-text': '1', style: { width: '100%', height: '140px', fontSize: '12px', fontFamily: 'monospace' } }),
407
+ React.createElement('div', { style: { display: 'flex', gap: '8px', marginTop: '4px' } },
408
+ React.createElement('button', { type: 'button', onClick: copyFallback, style: { padding: '2px 10px', cursor: 'pointer' } }, '复制'),
409
+ React.createElement('button', { type: 'button', onClick: function () { setFallback('') }, style: { padding: '2px 10px', cursor: 'pointer' } }, '关闭'))) : null,
410
+ error ? React.createElement('div', { style: { padding: '4px 12px', color: '#b00' } }, error) : null)
411
+ }
412
+
413
+ function apply(ctx) {
414
+ pluginCtx = ctx
415
+ window.__studyReader = {
416
+ kind: KIND, registered: true, stage: 'm4',
417
+ open: function () {
418
+ try {
419
+ if (typeof ctx.sidebarRight.isExpanded === 'function' && !ctx.sidebarRight.isExpanded()) ctx.sidebarRight.toggleExpanded()
420
+ ctx.sidebarRight.openTab(KIND, { revealIfOpened: true })
421
+ } catch (e) { return String(e && e.message || e) }
422
+ return true
423
+ }
424
+ }
425
+ const def = { id: TAB_ID, kind: KIND, title: function () { return '学习阅读器' }, keepMounted: true, priority: 50 }
426
+ ctx.sidebarRightTabs.register(def)
427
+ ctx.slots.register({ name: 'sidebar.right.pane.tab', key: def.id }, ReaderBody)
428
+ // present 到达且页签未开时自动展开(无会话面时静默重试)
429
+ let lastAt = null
430
+ if (presentTimer !== null) clearInterval(presentTimer)
431
+ presentTimer = setInterval(async function () {
432
+ try {
433
+ const p = await getJson('/study-workbench/present/latest')
434
+ if (!p || !p.at || p.at === lastAt) return
435
+ lastAt = p.at
436
+ window.__studyReaderLastAt = p.at
437
+ if (pluginCtx && pluginCtx.sidebarRight) {
438
+ if (typeof pluginCtx.sidebarRight.isExpanded === 'function' && !pluginCtx.sidebarRight.isExpanded()) {
439
+ pluginCtx.sidebarRight.toggleExpanded()
440
+ }
441
+ pluginCtx.sidebarRight.openTab(KIND, { revealIfOpened: true })
442
+ }
443
+ } catch { /* 静默 */ }
444
+ }, 1500)
445
+ }
446
+
447
+ exports.apply = apply
448
+ exports.inject = ['slots', 'sidebarRightTabs', 'sidebarRight']
449
+ exports.__test = { mdToHtml: mdToHtml, escapeHtml: escapeHtml, buildCitation: buildCitation, buildCitationMulti: buildCitationMulti, lineRangeOf: lineRangeOf, CITATION_LIMIT: CITATION_LIMIT, htmlCsp: htmlCsp, htmlFrameProps: htmlFrameProps, stripSelfNavigation: stripSelfNavigationExport }
450
+ return module.exports
451
+ },
452
+ })
package/cordis.patch.yml CHANGED
@@ -1,3 +1,10 @@
1
+ # 学习模式 bundle:顶层运行时(技能提供器 + 工作台 Host 路由 + 客户端阅读器)。
2
+ # 必须在顶层挂载,不能只写在 preset 的 plugins 里:客户端插件由宿主扫描顶层 Loader 条目组合,
3
+ # 只存在于 preset 内时启动阶段不会加载,右栏页签永远不会出现。
4
+ - insert:
5
+ - id: learn-mode-runtime
6
+ name: 'dsh-learn-mode'
7
+
1
8
  # Agent preset dsh-learn-mode:学习模式档位。
2
9
  # 结构照出货实例 dsh-web-app/presets/standard.patch.yml,按学习场景裁剪:
3
10
  # 去掉 plan 模式与 goal 工具,保留文件、shell、web、skill、支线委派、compaction。
@@ -10,6 +17,7 @@
10
17
  description: 学习模式:系统学习任意领域。追问走支线子会话,知识推进以 roadmap.json 为唯一真源,不打断课程主线。
11
18
  order: 10
12
19
  plugins:
20
+ # 技能提供器已由顶层 learn-mode-runtime 注册,此处不再重复挂载(重复会注册两次 provider)
13
21
  - id: persona
14
22
  name: '@deepseek-ai/dsh-persona'
15
23
  config:
@@ -17,13 +25,11 @@
17
25
  你是学习助手,帮助用户系统学习任意领域。
18
26
  本会话应当开在学习根目录。开工前先加载 skill「dsh-learn-mode」并照其执行:开场仪式、逐点教学、支线答疑(用户提问一律开支线子会话,不在主线展开)、卡顿分级通知、共享记忆与订正留痕。
19
27
  方法论(资料采集、精读、分级、质量门)由 skill「learn-synthesizer」规定,按 dsh-learn-mode 的接管点使用。
20
- suffix: 学习根目录是 {{cwd}}。
21
- # 主线默认模型:为新建会话钉死路由(会话内用户改模型仍优先)。
22
- - id: agent-default-model
23
- name: '@deepseek-ai/dsh-agent-default-model'
24
- config:
25
- provider: deepseek-official
26
- model: deepseek-flash
28
+ suffix: 学习根目录就是本会话的工作目录。
29
+ # 主线默认模型不在此挂载:agentDefaultModel 是进程级单例服务,由 Host 配置提供,
30
+ # 且其消费者是 Host 侧的 session-controller。preset 内重复挂载会触发
31
+ # “service agentDefaultModel has been registered”并使整个 preset 新绑定失败。
32
+ # 学习会话的主线模型沿用 Host 默认与会话级选择;支线模型仍由下方 agentOptions 钉死。
27
33
  - id: tool-bash
28
34
  name: '@deepseek-ai/dsh-tool-bash'
29
35
  disabled: !!js process.platform === 'win32'
@@ -67,25 +73,23 @@
67
73
  config:
68
74
  - id: tool-subagent-control
69
75
  name: '@deepseek-ai/dsh-tool-subagent-control'
70
- - id: tool-subagent-list-agents
71
- name: '@deepseek-ai/dsh-tool-subagent-control/list-agents'
76
+ # 主入口已注册 list_agents;旧版独立子路径 .../list-agents 在当前宿主已不再导出,
77
+ # 保留该行会让整个 preset 激活失败并从档位选择器消失。不要加回来。
72
78
  - id: tool-subagent
73
79
  name: '@deepseek-ai/dsh-tool-subagent'
74
80
  config:
75
81
  provider: spawn
76
82
  toolName: subagent
77
- modelSelectionSettings: true
78
- backgroundMode: continuable
79
- # spawn 子 agent 显式钉死路由;想给支线换别的模型改这一处。
80
- agentOptions:
81
- provider: deepseek-official
82
- model: deepseek-flash
83
+ # 当前版本字段名是 modelSelection;旧名 modelSelectionSettings 已移除。
84
+ modelSelection: true
85
+ # 不钉死子级路由:agentOptions 若指向本机不可用的 provider(如 deepseek-official
86
+ # 凭证无效),会让所有支线答疑 401/传输失败。继承主线路由,与主线一致。
83
87
  - id: tool-subagent-fork
84
88
  name: '@deepseek-ai/dsh-tool-subagent'
85
89
  config:
86
90
  provider: fork
87
91
  toolName: subagent_fork
88
- backgroundMode: continuable
92
+ # backgroundMode 在当前版本已移除;本地 spawn/fork 子级默认支持后续消息。
89
93
  # fork 默认继承主线路由(答疑保真需要);如需与主线不同,在此加 agentOptions 覆盖。
90
94
  - id: workflow-ptc
91
95
  name: '@deepseek-ai/dsh-workflow-ptc'
package/index.js ADDED
@@ -0,0 +1,19 @@
1
+ /**
2
+ * 组合插件入口:随包技能提供器 + 学习工作台 Host 路由。
3
+ *
4
+ * 顶层只 inject skills,保证技能提供器先可用;工作台依赖的
5
+ * webServer/workspaceFiles/sessions 在嵌套 ctx.inject 中就绪后再注册,
6
+ * 任一服务缺失时只降级工作台,不影响技能。
7
+ */
8
+ import { registerSkills } from './skills-provider.mjs'
9
+ import { registerWorkbench } from './workbench-host.mjs'
10
+
11
+ export const name = 'dsh-learn-mode-bundled-skills'
12
+ export const inject = ['skills']
13
+
14
+ export function apply(ctx, config) {
15
+ registerSkills(ctx)
16
+ ctx.inject(['webServer', 'workspaceFiles', 'sessions'], (scope) => {
17
+ registerWorkbench(scope, config ?? {})
18
+ })
19
+ }
package/package.json CHANGED
@@ -1,13 +1,42 @@
1
- {
2
- "name": "dsh-learn-mode",
3
- "version": "0.1.2",
4
- "description": "DSH 学习模式 agent 预设:逐点教学 + 支线答疑 + roadmap.json 进度真源,追问再深也不打断课程主线。",
5
- "type": "module",
6
- "keywords": ["deepseek-harness", "dsh", "agent", "preset", "learning", "cordis", "plugin"],
7
- "license": "MIT",
8
- "files": [
9
- "cordis.patch.yml",
10
- "skills/"
11
- ],
12
- "dsh": { "bundle": { "patch": "./cordis.patch.yml" } }
13
- }
1
+ {
2
+ "name": "dsh-learn-mode",
3
+ "version": "0.2.0",
4
+ "description": "DSH 学习模式 agent 预设:逐点教学 + 支线答疑 + roadmap.json 进度真源,追问再深也不打断课程主线。",
5
+ "type": "module",
6
+ "main": "./index.js",
7
+ "exports": {
8
+ ".": "./index.js",
9
+ "./client": "./client/client.js"
10
+ },
11
+ "keywords": [
12
+ "deepseek-harness",
13
+ "dsh",
14
+ "agent",
15
+ "preset",
16
+ "learning",
17
+ "cordis",
18
+ "plugin"
19
+ ],
20
+ "license": "MIT",
21
+ "files": [
22
+ "index.js",
23
+ "skills-provider.mjs",
24
+ "workbench-host.mjs",
25
+ "cordis.patch.yml",
26
+ "skills/",
27
+ "client/"
28
+ ],
29
+ "dsh": {
30
+ "bundle": {
31
+ "patch": "./cordis.patch.yml"
32
+ },
33
+ "client": {
34
+ "platform": "web",
35
+ "inject": [
36
+ "slots",
37
+ "sidebarRightTabs",
38
+ "sidebarRight"
39
+ ]
40
+ }
41
+ }
42
+ }
@@ -66,7 +66,7 @@ description: DSH 学习模式的交互协议层。在学习模式会话中承载
66
66
 
67
67
  ## 支线答疑
68
68
 
69
- **触发**:用户在学习途中显式提问(「我有疑问」「这里不懂」「?X」),或主线撞上卡顿信号。
69
+ **触发**:用户在学习途中显式提问(「我有疑问」「这里不懂」「?X」),或主线撞上卡顿信号。用户从右侧学习阅读器划选原文、经 `[学习引用]` 块带入输入框的提问,同样视为显式提问,且原文锚点优先于口头描述。
70
70
 
71
71
  **开法选择**:
72
72
 
@@ -77,12 +77,12 @@ description: DSH 学习模式的交互协议层。在学习模式会话中承载
77
77
  | 需要给子会话换模型 | workflow 工具的 agent 调用 |
78
78
  | 需要子会话看到「当前这一步」 | 两种都不行,写进派发 prompt |
79
79
 
80
- **派发时必须做**:在 prompt 里显式说明当前这一步在做什么。fork 排除进行中的轮次,子会话看不到创建它的那次工具调用。label 统一形如「答疑-NN-主题」,方便用户在页头后代目录里辨认。prompt 里写明:**用中文回答**(术语保留英文原词)——子会话继承主线模型,不指定语言时可能默认出英文。
80
+ **派发时必须做**:在 prompt 里显式说明当前这一步在做什么。fork 排除进行中的轮次,子会话看不到创建它的那次工具调用。label 统一形如「答疑-NN-主题」,方便用户在页头后代目录里辨认。prompt 里写明:**用中文回答**(术语保留英文原词)——子会话继承主线模型,不指定语言时可能默认出英文。用户提问带 `[学习引用]` 块时,把其中的文件路径、位置与原文原样放进派发 prompt,不要改写成概括。
81
81
 
82
82
  **产出契约**(缺一项视为未完成):
83
83
 
84
84
  1. 给用户的直接答案。
85
- 2. 答疑卡落盘到学科目录的 _internal/qa/ 子目录,六字段:问题、结论、证据、对主线的影响、待验证、回流建议。
85
+ 2. 答疑卡落盘到学科目录的 _internal/qa/ 子目录,八字段:问题、原文引用(文件与位置,无引用则写「无」)、阅读上下文(学科与节点)、结论、证据、对主线的影响、待验证、回流建议。
86
86
  3. 台账 index.md 写一行。
87
87
  4. 完成后主动向主线 send_message 回推 ≤200 字摘要:问题、结论、对主线的影响、是否建议回流。
88
88
 
@@ -96,7 +96,7 @@ description: DSH 学习模式的交互协议层。在学习模式会话中承载
96
96
 
97
97
  **权限分工**:子会话只负责读与推理。需要审批的动作(跑命令、写工作区外文件)在子会话内会直接失败,子会话应报回主线执行,不得换方式重试。
98
98
 
99
- **使用姿势**:提示用户把子会话固定在右侧栏,与主线并存。
99
+ **使用姿势**:答疑子会话固定在右侧栏,与主线并存;学习阅读器也占右栏页签,两者可切换,切回阅读器时保留阅读位置。提问前先在阅读器里划选原文,再补一句疑问即可。
100
100
 
101
101
  **平台约束**:子会话深度上限默认 1(答疑子会话不能再开子会话);并发驻留上限默认 8,答疑结束即释放;导航入口在会话页头的后代数量触发器。
102
102
 
@@ -172,11 +172,13 @@ description: DSH 学习模式的交互协议层。在学习模式会话中承载
172
172
 
173
173
  - 建科必须一次创建齐六件:roadmap.json、00-学习路线图.md、MISSION.md、understanding-map.md、session-state.md、_internal/qa/index.md(台账,即使还没有答疑也要先建)。缺件视为建科未完成,不要留到以后补。
174
174
  - 学科必须建在 subjects/ 下,答疑台账必须在学科的 _internal/qa/ 下。学习根下除上述结构外不放学科内容。
175
- - roadmap.json 字段契约:{"subject": "<学科>", "nodes": [{"id", "title", "type", "deps", "status"}]}。status 只能是:未开始/进行中/已完成/待复习(中文,渲染器按此着色与统计);type 只能是:概念/实操/实验。可自由加 importance、covers、note 等扩展字段。
175
+ - roadmap.json 字段契约:{"subject": "<学科>", "nodes": [{"id", "title", "type", "deps", "status"}]}。status 只能是:未开始/进行中/已完成/待复习(中文,渲染器按此着色与统计);type 只能是:概念/实操/实验。可自由加 importance、covers、note 等扩展字段。准备让某节点可被阅读器打开时,给该节点加可选 `content` 字段:相对学科目录的文件路径数组(如 ["chapters/n01.md"]),不要填绝对路径或 `..`;没有课件就不要加,阅读器不会猜文件。
176
+ - 开始学习某节点、且该节点有 `content` 时,把 `{"subject": "<学科>", "node": "<节点 id>", "at": "<ISO 时间>"}` 写入 `<学习根>/_internal/workbench/present.json`(目录不存在则创建),右侧阅读器会自动展开;同一节点重复写不抢占其它页签。
176
177
  - 00-学习路线图.md 必须含 <!-- GENERATED:roadmap BEGIN --> 与 <!-- GENERATED:roadmap END --> 两个标记,标记之间完全留给渲染器,叙述手写在标记外。
177
178
  - MISSION.md 四节:为什么学、成功标准、不学什么、约束。
178
179
  - session-state.md 恢复要点:当前节点、进行中的事、待回流答疑数。
179
180
  - 台账 index.md 行格式:编号 | 提问 | 开法 | 子会话 id | 答疑卡文件 | 是否回流 | 状态(待回流/已回流/已归档)。
181
+ - 写任何日期、时间或“阶段状态”前,先用系统时间校准(例如运行 `Get-Date`/`date`),不得凭记忆或沿用旧值;会话收尾时把 session-state.md 的阶段行更新为实际状态,避免残留“进行中”的旧描述。
180
182
  - 每次改完 roadmap.json、台账或课件后,在学习根运行 node _internal/render.mjs 刷新页面。
181
183
 
182
184
  ## 禁止事项汇总