@oxmumu3/dsh-incidental-learn 0.1.5 → 0.1.7

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/lib/ledger.js CHANGED
@@ -58,26 +58,43 @@ function cloneJson(value) {
58
58
  return JSON.parse(JSON.stringify(value))
59
59
  }
60
60
 
61
+ const LEGACY_DEFAULT_TRACK_IDS = new Set(['track-frontend', 'track-harness', 'track-growth'])
62
+
63
+ function isLegacyDefaultTracks(rawTracks) {
64
+ if (!Array.isArray(rawTracks) || !rawTracks.length) return false
65
+ const valid = rawTracks.filter(t => t && t.id && t.title)
66
+ if (!valid.length) return false
67
+ const onlyLegacyIds = valid.every(t => LEGACY_DEFAULT_TRACK_IDS.has(t.id))
68
+ const hasLegacyMarker = valid.some(t => t.id === 'track-harness' || String(t.title).includes('六格主线'))
69
+ return onlyLegacyIds && hasLegacyMarker
70
+ }
71
+
61
72
  function normalizeTrackId(trackId, tracks) {
62
73
  const list = Array.isArray(tracks) && tracks.length ? tracks : DEFAULT_TRACKS
63
74
  if (trackId && list.some(t => t.id === trackId)) return trackId
64
75
  const lowered = String(trackId || '').toLowerCase()
65
- if (lowered.includes('front') || lowered.includes('css') || lowered.includes('dialog')) return 'track-frontend'
66
- if (lowered.includes('growth') || lowered.includes('wechat') || lowered.includes('article')) return 'track-growth'
67
- return list[0].id
76
+ const has = id => list.some(t => t.id === id)
77
+ if ((lowered === 'track-harness' || /ai|agent|prompt|llm|fence|tool/.test(lowered)) && has('track-ai')) return 'track-ai'
78
+ if ((lowered === 'track-growth' || /product|growth|copy|onboarding|wechat|article/.test(lowered)) && has('track-product')) return 'track-product'
79
+ if (/front|css|dialog|ui|dom|layout|theme/.test(lowered) && has('track-frontend')) return 'track-frontend'
80
+ if (/eng|arch|backend|api|db|sql|ledger|mtime|perf/.test(lowered) && has('track-engineering')) return 'track-engineering'
81
+ const fallback = list.find(t => t.id === 'track-engineering') || list[0]
82
+ return fallback.id
68
83
  }
69
84
 
70
85
  function sanitizeLedger(raw) {
71
86
  const base = emptyLedgerState()
72
87
  if (!raw || typeof raw !== 'object') return base
73
- const tracks = Array.isArray(raw.tracks) && raw.tracks.length
74
- ? raw.tracks.filter(t => t && t.id && t.title).map((t, i) => ({
75
- id: cleanText(t.id, 60),
76
- title: cleanText(t.title, 90),
77
- subtitle: cleanText(t.subtitle, 180),
78
- order: Number.isFinite(t.order) ? t.order : i + 1,
79
- }))
80
- : base.tracks
88
+ const tracks = isLegacyDefaultTracks(raw.tracks)
89
+ ? DEFAULT_TRACKS.map(t => ({ ...t }))
90
+ : Array.isArray(raw.tracks) && raw.tracks.length
91
+ ? raw.tracks.filter(t => t && t.id && t.title).map((t, i) => ({
92
+ id: cleanText(t.id, 60),
93
+ title: cleanText(t.title, 90),
94
+ subtitle: cleanText(t.subtitle, 180),
95
+ order: Number.isFinite(t.order) ? t.order : i + 1,
96
+ }))
97
+ : base.tracks
81
98
 
82
99
  const normalizeItem = (row, fallbackIdx = 0) => {
83
100
  if (!row || typeof row !== 'object') return null
@@ -479,9 +496,12 @@ export function createLedgerStore(options = {}) {
479
496
  const idx = draft.triage.findIndex(c => c.id === id)
480
497
  if (idx < 0) return { found: false }
481
498
  const cand = draft.triage[idx]
482
- pushUndo(draft, decision === 'accept' ? `收入「${cand.title.slice(0, 12)}」` : `略过「${cand.title.slice(0, 12)}」`)
499
+ pushUndo(draft, decision === 'accept' ? `收入「${cand.title.slice(0, 12)}」` : `删掉「${cand.title.slice(0, 12)}」`)
483
500
  draft.triage.splice(idx, 1)
484
501
  let created = null
502
+ if (decision === 'skip' && cand.cardKey && !draft.dismissedCardKeys.includes(cand.cardKey)) {
503
+ draft.dismissedCardKeys = [...draft.dismissedCardKeys, cand.cardKey].slice(-400)
504
+ }
485
505
  if (decision === 'accept') {
486
506
  const targetTrack = normalizeTrackId(trackId || cand.trackId, draft.tracks)
487
507
  const existing = findItemByTitleOrId(draft, { title: cand.title })
@@ -516,11 +536,21 @@ export function createLedgerStore(options = {}) {
516
536
  },
517
537
 
518
538
  async triageBatch({ mode } = {}) {
519
- if (mode !== 'accept_all' && mode !== 'sweep_low_value') {
520
- throw new Error('triageBatch requires mode accept_all|sweep_low_value')
539
+ if (mode !== 'accept_all' && mode !== 'sweep_low_value' && mode !== 'clear_all') {
540
+ throw new Error('triageBatch requires mode accept_all|sweep_low_value|clear_all')
521
541
  }
522
542
  const { state, extra } = await mutate(draft => {
523
- if (draft.triage.length === 0) return { affected: 0 }
543
+ if (draft.triage.length === 0) return { affected: 0, mode }
544
+ if (mode === 'clear_all') {
545
+ const clearedCount = draft.triage.length
546
+ pushUndo(draft, `清空 ${clearedCount} 张自动存档`)
547
+ const extraKeys = draft.triage.map(c => c.cardKey).filter(Boolean)
548
+ if (extraKeys.length > 0) {
549
+ draft.dismissedCardKeys = [...new Set([...draft.dismissedCardKeys, ...extraKeys])].slice(-400)
550
+ }
551
+ draft.triage = []
552
+ return { affected: clearedCount, mode }
553
+ }
524
554
  if (mode === 'sweep_low_value') {
525
555
  const lowCount = draft.triage.filter(c => c.lowValue).length
526
556
  const targets = lowCount > 0 ? draft.triage.filter(c => c.lowValue) : draft.triage.filter(c => c.epistemic === 'inferred').slice(2)
package/lib/prompt.js CHANGED
@@ -10,7 +10,7 @@ export const LEARN_PROMPT_MAX_BYTES = 1150
10
10
  export const LEARN_SYSTEM_PROMPT = [
11
11
  '[顺带私教 | SHIELD]',
12
12
  '1. 日常答疑/改字/常规脚本 0 额外输出;仅当本轮做出实质工程、架构或前端设计取舍时,在回答最末尾附 1 块 ```shield JSON:',
13
- '{"title":"短标题","why":"为什么这么做","rejected":"被排除差方案","probe":"一句话摸底","trackId":"track-frontend|track-harness|track-growth","quiz":{"question":"题干","options":[{"key":"A","label":"选项A","correct":false,"feedback":"纠偏"},{"key":"B","label":"选项B","correct":true,"feedback":"解释"}]}}',
13
+ '{"title":"短标题","why":"为什么这么做","rejected":"被排除差方案","probe":"一句话摸底","trackId":"track-frontend|track-engineering|track-ai|track-product","quiz":{"question":"题干","options":[{"key":"A","label":"选项A","correct":false,"feedback":"纠偏"},{"key":"B","label":"选项B","correct":true,"feedback":"解释"}]}}',
14
14
  '2. 仅用户明说保存/记录盲区时才调 learn_save;不要静默写盘。',
15
15
  '3. 若用户消息以 [顺带私教·专心闯关] 开头,走先探后讲+换景追问:第1轮先发 ```learn-quiz JSON(step:1,totalSteps:2,title,scenario,question,before,after,options,analogy)停下等答;第2轮诊断并出换项目迁移 learn-quiz;通过后调 learn_checkpoint(传人话 evidenceSummary 与 toTier:4)并输出 ```learn-pass JSON(itemId,title,fromTier,toTier,evidenceSummary,trackTitle)。',
16
16
  ].join('\n')
package/lib/tools.js CHANGED
@@ -34,7 +34,7 @@ export function createLearnTools({ store }) {
34
34
  type: 'object',
35
35
  additionalProperties: false,
36
36
  properties: {
37
- trackId: str('可选,过滤单条路线:track-frontend | track-harness | track-growth'),
37
+ trackId: str('可选,过滤单条路线:track-frontend | track-engineering | track-ai | track-product'),
38
38
  },
39
39
  },
40
40
  output: { schema: { type: 'string' }, render: (_a, v) => textOut(v) },
@@ -78,7 +78,7 @@ export function createLearnTools({ store }) {
78
78
  why: str('为什么这么做的核心原因'),
79
79
  rejected: str('可选,被排除的差方案'),
80
80
  probe: str('可选,一句话摸底追问'),
81
- trackId: str('可选,目标路线:track-frontend | track-harness | track-growth'),
81
+ trackId: str('可选,目标路线:track-frontend | track-engineering | track-ai | track-product'),
82
82
  epistemic: str('可选,verified | explicit | inferred'),
83
83
  },
84
84
  },
@@ -89,7 +89,7 @@ export function createLearnTools({ store }) {
89
89
  why: args.why,
90
90
  rejected: args.rejected || '',
91
91
  probe: args.probe || '',
92
- trackId: args.trackId || 'track-harness',
92
+ trackId: args.trackId || 'track-engineering',
93
93
  source: 'dsh-chat',
94
94
  epistemic: args.epistemic || 'explicit',
95
95
  })
package/locale/zh.json CHANGED
@@ -8,9 +8,9 @@
8
8
  "spotlightPrimary": "开始 3 分钟展开学",
9
9
  "spotlightSecondary": "看卡片解析",
10
10
  "triageHeading": "后台自动存档",
11
- "triageAccept": "加入重点学",
11
+ "triageAccept": "存进技能库",
12
12
  "triageSkip": "跳过",
13
- "triageAcceptAll": "全部加入重点学",
13
+ "triageAcceptAll": "全部存进技能库",
14
14
  "triageSweepLow": "清理细碎卡片",
15
15
  "tracksHeading": "沉淀下来的技能分类",
16
16
  "course15mBtn": "15 分钟集中学",
@@ -50,7 +50,7 @@
50
50
  "shieldRejected": "避开的坑",
51
51
  "shieldProbe": "顺手想一下",
52
52
  "shieldBtnCoach": "在右侧边聊边学",
53
- "shieldBtnCapture": "加入重点学",
53
+ "shieldBtnCapture": "存进技能库",
54
54
  "shieldBtnDismiss": "已掌握,收起",
55
55
  "shieldCollapsed": "已掌握并收起 · 重新展开",
56
56
  "quizTag": "先探后讲",
package/package.json CHANGED
@@ -1,11 +1,11 @@
1
1
  {
2
2
  "name": "@oxmumu3/dsh-incidental-learn",
3
- "version": "0.1.5",
3
+ "version": "0.1.7",
4
4
  "private": false,
5
5
  "license": "MIT",
6
6
  "type": "module",
7
7
  "main": "index.js",
8
- "description": "顺带私教 for DeepSeek Harness — SHIELD Token-Lite decision cards, non-interruptive 90s right-sidebar drills, cross-Agent blind-spot ledger, and native Socratic mastery checkpoints.",
8
+ "description": "在日常与 Agent 协作中顺手攒经验、沉淀个人技能库的 DeepSeek Harness 插件(对话末尾低调学习卡 + 后台自动存档 + 右侧边聊边学)",
9
9
  "author": "牛村木木山 <157776623+oxmumu3@users.noreply.github.com>",
10
10
  "repository": {
11
11
  "type": "git",
package/shared/schema.js CHANGED
@@ -34,22 +34,28 @@ export const MASTERY_LABELS = {
34
34
  export const DEFAULT_TRACKS = [
35
35
  {
36
36
  id: 'track-frontend',
37
- title: '前端与交互品味',
38
- subtitle: '现代 CSS 容器查询、原生顶层交互与主题令牌',
37
+ title: '前端与界面体验',
38
+ subtitle: '自适应布局、原生组件、明暗主题与交互细节',
39
39
  order: 1,
40
40
  },
41
41
  {
42
- id: 'track-harness',
43
- title: 'Agent 架构与 DSH Harness 六格主线',
44
- subtitle: '槽位契约、会话隔离、幂等写盘与双端边界',
42
+ id: 'track-engineering',
43
+ title: '架构与工程实践',
44
+ subtitle: '接口边界、读写安全、并发控制与性能取舍',
45
45
  order: 2,
46
46
  },
47
47
  {
48
- id: 'track-growth',
49
- title: '增长分发与内容渠道适配',
50
- subtitle: '微信搜一搜首屏利益点、阅读转化与渠道结构差异',
48
+ id: 'track-ai',
49
+ title: 'AI 与 Agent 协作',
50
+ subtitle: '提示词结构、上下文省流、工具设计与多端配合',
51
51
  order: 3,
52
52
  },
53
+ {
54
+ id: 'track-product',
55
+ title: '产品与增长策略',
56
+ subtitle: '首次上手路径、信息层级、表达结构与分发转化',
57
+ order: 4,
58
+ },
53
59
  ]
54
60
 
55
61
  export const STARTER_SAMPLE_PACK = {
@@ -65,7 +71,7 @@ export const STARTER_SAMPLE_PACK = {
65
71
  why: '@container 本身不增加选择器权重;写在基础 repeat(2, 1fr) 规则之后,才能在 390px 分屏下真正覆写成单列。',
66
72
  rejected: '用全局 @media(max-width:768px) 猜测面板宽度(宿主分屏时窗口虽宽,插件面板容器其实已变窄)。',
67
73
  probe: '如果把 @container (max-width: 580px) { grid-template-columns: 1fr } 写在双列网格之前,390px 下还会变成单列吗?',
68
- evidenceSummary: '已看过 learn-v2 原型中 390px 分屏溢出 45px 的真坑定位,待独立完成一次跨场景追问。',
74
+ evidenceSummary: '在分屏窄栏场景中独立核对 @container 与基础规则先后顺序,待完成一次跨项目追问。',
69
75
  priority: 100,
70
76
  quiz: {
71
77
  question: 'DSH 右侧栏只占 420px,而桌面端窗口宽度有 1440px。为什么这里不能靠 @media (max-width: 600px) 切换单列?',
@@ -106,87 +112,87 @@ export const STARTER_SAMPLE_PACK = {
106
112
  },
107
113
  {
108
114
  id: 'item-fence-vs-foldturns',
109
- trackId: 'track-harness',
110
- title: '用 markdown.fence 替代 tool.call.toolview 绕开回合自动折叠',
115
+ trackId: 'track-ai',
116
+ title: '把长期要回看的学习卡放进正文自定义围栏,而不是塞进工具折叠区',
111
117
  source: 'dsh-chat',
112
118
  epistemic: 'verified',
113
119
  masteryTier: 3,
114
- why: 'DSH 0.2.2-rc.3 对已结束回合一律设置 foldCompletedTurns: true;正文里的自定义围栏(shield / learn-quiz / learn-pass)在过程头之外保持常驻展示,停用插件后仍可阅读。',
115
- rejected: '把每次回合结束的决策卡做成一次 tool call(每回合多消耗 1 次工具往返 Token,且回合一结束立刻被收折)。',
116
- probe: '为什么 learn_checkpoint 归档可以走工具调用,但过关毕业卡却要多出一块 learn-pass 围栏?',
117
- evidenceSummary: '在 RC3 app.asar 契约核查中复述出 presentation-policy 折叠范围与 markdown.fence 会话作用域差异。',
120
+ why: '助手在回合结束后通常会把 tool call 过程头折叠收起;放在正文自定义围栏里既不抢主正文风头,还能脱离单次调用常驻留存。',
121
+ rejected: '把每次回合结束的顺带学习卡做成一次 tool call(每轮多花一次工具往返,还容易随着过程记录一起折起来)。',
122
+ probe: '什么适合做成正文里的持久学习卡,什么更适合留作后台动作的工具回执?',
123
+ evidenceSummary: '对比过过程区自动折叠和正文自定义围栏的展示差异,能说清两者的边界。',
118
124
  priority: 85,
119
125
  },
120
126
  {
121
127
  id: 'item-atomic-mtime-ledger',
122
- trackId: 'track-harness',
123
- title: '跨 Agent 共享 ledger.json 的 mtimeMs 合并与原子落盘',
128
+ trackId: 'track-engineering',
129
+ title: '多端共享 JSON 账本前先比对 mtimeMs 再原子 rename 落盘',
124
130
  source: 'codex',
125
131
  epistemic: 'verified',
126
132
  masteryTier: 2,
127
- why: 'DSH 插件宿主与外部 CLI(Antigravity / Codex)会并发读写同一份 ledger.json;写入前比对文件 mtimeMs 并重新合并,再经临时文件 renameSync 原子替换,才能避免半截 JSON 与覆盖丢卡。',
128
- rejected: '启动时把账本全读进内存直接 writeFileSync 覆盖,或引入 SQLite 重型二进制依赖增加跨平台安装风险。',
129
- probe: '如果 Antigravity 刚通过 CLI 塞入一条新盲区,正在运行的 DSH 宿主若不做 mtimeMs 检查直接点「略过」会发生什么?',
130
- evidenceSummary: '已在设计评审阶段对照 state-file-two-hosts 规矩推演双写覆盖场景,待完成一次跨进程盲测确认。',
133
+ why: '桌面插件与外部命令行可能同时读写同一份 ledger.json;写入前比对文件修改时间重新合并,再通过临时文件 rename 原子替换,才能防并发覆盖。',
134
+ rejected: '启动时把文件整份缓存在内存里直接 writeFileSync 覆盖,或为此引入重型数据库依赖。',
135
+ probe: '如果外部命令行刚塞入一条新卡片,桌面端不做 mtimeMs 校验就直接写盘会发生什么?',
136
+ evidenceSummary: '已演练过双进程并发写盘的竞态保护,待在真实多端联动里验证一次。',
131
137
  priority: 92,
132
138
  },
133
139
  {
134
140
  id: 'item-wechat-search-firstscreen',
135
- trackId: 'track-growth',
136
- title: '微信搜一搜短图文与公众号纯文本分发结构差异',
141
+ trackId: 'track-product',
142
+ title: '冷启动图文卡片与熟人长文的首屏信息结构差异',
137
143
  source: 'manual',
138
144
  epistemic: 'explicit',
139
145
  masteryTier: 3,
140
- why: '纯文本只触达既有读者,首句靠共鸣切入;微信搜一搜短图文依赖 3:4 封面卡在信息流抢占第一眼,必须在前 2 秒用结构化利益点代替铺垫背景。',
141
- rejected: '直接把公众号长文拆成白底黑字长截图套用(首屏信息密度失焦,搜一搜点击率折损明显)。',
142
- probe: '面向老读者群发的纯文本与面向冷启动搜一搜的 3:4 短图文,第一眼最核心的改动分别是什么?',
143
- evidenceSummary: '复盘了 500+ 阅读纯文本反馈与 6 张 3:4 短图文封面结构取舍,能独立拆出首屏利益点公式。',
146
+ why: '熟人订阅长文靠共鸣铺垫;公开信息流或搜索卡片依赖首屏前两秒用结构化利益点抓人,不能把长段落裁图硬塞。',
147
+ rejected: '把长文直接截成白底密字长图发进信息流(首屏看不出价值,划走率高)。',
148
+ probe: '面向老读者发长文和面向新用户发卡片,首屏第一眼各自最该放什么?',
149
+ evidenceSummary: '对比大段说明文与三步图文流程卡后,能独立把首屏核心价值收在两秒可读范围内。',
144
150
  priority: 65,
145
151
  },
146
152
  ],
147
153
  triage: [
148
154
  {
149
155
  id: 'cand-draft-guard-lexical',
150
- trackId: 'track-harness',
151
- title: '围栏选项按钮触发 inputActions.submit() 前必须读取 useInput().draft',
156
+ trackId: 'track-frontend',
157
+ title: '点卡片快捷选项自动发送前,必须先检查输入框是否已有未发送草稿',
152
158
  source: 'dsh-chat',
153
159
  epistemic: 'inferred',
154
- why: '用户可能正在输入框编写长回复,直接调 setDraft() 会静默擦除未发送心血。',
155
- rejected: '点击选择题卡片后不检查输入框状态直接覆写发送。',
156
- probe: '当用户在底部输入框留有未发送草稿时,点击 learn-quiz 选项应采取哪两步保护?',
160
+ why: '用户可能正在输入框写长段话,直接替用户提交会覆盖未发送的心血。',
161
+ rejected: '点击选择题卡片后不检查草稿状态直接覆写并提交。',
162
+ probe: '输入框已有草稿时,点击卡片按钮应该触发哪两步保护?',
157
163
  lowValue: false,
158
164
  },
159
165
  {
160
166
  id: 'cand-sidebar-right-id-kind',
161
- trackId: 'track-harness',
162
- title: 'sidebarRightTabs 注册用 id 而 openTab() 传 kind',
167
+ trackId: 'track-engineering',
168
+ title: '插件插槽注册 ID 与按 kind 打开抽屉必须一一对应',
163
169
  source: 'superagent-review',
164
170
  epistemic: 'verified',
165
- why: 'DSH 右侧栏 SlotRegistry 按 definition.id 分发渲染组件,但侧栏服务的 openTab(kind) 按 definition.kind 反查。两者混写同一字符串会在开抽屉时静音失效。',
166
- rejected: '凭直觉把槽位 key 与 openTab 参数都传成同一个 ID。',
167
- probe: '在 dsh-client-ui-sidebar-right 中,Slots 注册 key 与 openTab() 入参分别读哪个字段?',
171
+ why: '插槽定义表和侧栏激活接口往往分别按 id 和 kind 索引,混写会在打开侧栏时静音失败。',
172
+ rejected: '凭直觉把槽位 key 与打开参数硬传成同一字符串。',
173
+ probe: '当点击按钮开侧栏没报错却没反应时,最该先查哪两个注册字段?',
168
174
  lowValue: false,
169
175
  },
170
176
  {
171
177
  id: 'cand-optional-schema-no-false',
172
- trackId: 'track-harness',
173
- title: '工具可选参数必须省略 required 而不是写 required: false',
178
+ trackId: 'track-ai',
179
+ title: '工具可选参数应省略在 required 数组外,避免写 required: false',
174
180
  source: 'codex',
175
181
  epistemic: 'verified',
176
- why: 'JSON Schema 2020-12 校验器要求 required 必须是父级字符串数组,给单个字段写 required: false 会导致底层模型注册报错。',
177
- rejected: '沿用部分旧表单习惯在字段描述对象内写 { type: "string", required: false }。',
178
- probe: '向 DeepSeek Tool Schema 暴露一个可选字符串字段时,正确的 Schema 写法是什么?',
182
+ why: 'JSON Schema 2020-12 要求 required 是父对象的字符串数组,字段内写 required: false 会让模型工具注册校验失败。',
183
+ rejected: '按旧表单习惯在字段定义对象里写 { type: "string", required: false }。',
184
+ probe: '给大模型暴露一个可选字符串入参时,正确的 Schema 结构怎么写?',
179
185
  lowValue: false,
180
186
  },
181
187
  {
182
188
  id: 'cand-prompt-kv-cache',
183
- trackId: 'track-harness',
184
- title: '常驻 systemPrompt.section 必须保持文本固定且 <= 1150 字节',
189
+ trackId: 'track-ai',
190
+ title: '常驻系统提示词必须保持前缀静止与严格字节预算,动态内容按需走工具读取',
185
191
  source: 'antigravity',
186
192
  epistemic: 'verified',
187
- why: '把动态变化的账本条目直接拼进系统提示词前缀,每轮都会击穿模型 KV Cache 导致首字延迟翻倍且账单飙升;静态规则 + 工具按需读取才是省流正道。',
188
- rejected: '每次生成新系统消息把所有历史盲区全部塞进 system prompt。',
189
- probe: '为什么个人盲区数量增加后,系统提示词前缀仍然必须逐字保持静止?',
193
+ why: '把不断变化的个人账本直接塞进系统提示词前缀,每轮都会击穿模型 KV Cache;保持前缀不变、查账本走工具才省钱又低延迟。',
194
+ rejected: '每次对话把用户所有历史盲区拼进 system prompt。',
195
+ probe: '为什么个人积累的卡片越多,系统提示词前缀越不能跟着变长?',
190
196
  lowValue: false,
191
197
  },
192
198
  {
@@ -202,7 +208,7 @@ export const STARTER_SAMPLE_PACK = {
202
208
  },
203
209
  {
204
210
  id: 'cand-rename-readme-heading',
205
- trackId: 'track-growth',
211
+ trackId: 'track-product',
206
212
  title: '文档格式微调:统一 README 二级标题序号格式',
207
213
  source: 'manual',
208
214
  epistemic: 'inferred',
@@ -324,7 +330,7 @@ export function parseShieldFence(code) {
324
330
  why: why || '已基于当前项目边界做出取舍。',
325
331
  rejected: rejected || '已排除高维护成本或脆弱实现方案。',
326
332
  probe: probe || `关于「${finalTitle}」,换到另一处模块时会不会遇到同样的边界?`,
327
- trackId: cleanText(json.trackId, 60) || 'track-harness',
333
+ trackId: cleanText(json.trackId, 60) || 'track-engineering',
328
334
  source: normalizeSource(json.source || 'dsh-chat'),
329
335
  epistemic: normalizeEpistemic(json.epistemic || 'inferred'),
330
336
  quiz: sanitizeQuizBlock(json.quiz, finalTitle, why, rejected, probe),
@@ -359,7 +365,7 @@ export function parseShieldFence(code) {
359
365
  why: cleanText(why, 420) || '已基于当前项目边界做出取舍。',
360
366
  rejected: cleanText(rejected, 420) || '已排除脆弱或高成本备选方案。',
361
367
  probe: cleanText(probe, 320) || `换到另一个新模块时,如何避免重复踩中「${finalTitle}」的坑?`,
362
- trackId: 'track-harness',
368
+ trackId: 'track-engineering',
363
369
  source: 'dsh-chat',
364
370
  epistemic: 'inferred',
365
371
  quiz: buildDefaultQuiz(finalTitle, why, rejected, probe),
@@ -434,15 +440,32 @@ export function parseLearnPassFence(code) {
434
440
  }
435
441
  }
436
442
 
443
+ export function inferTrackIdFromTopic(text) {
444
+ const s = String(text || '')
445
+ if (/css|flex|grid|container|dialog|布局|样式|动画|前端|界面|颜色|主题|弹窗|悬浮|分屏|按钮|组件/i.test(s)) {
446
+ return 'track-frontend'
447
+ }
448
+ if (/prompt|agent|token|mcp|tool|llm|模型|提示词|上下文|多智能体|围栏/i.test(s)) {
449
+ return 'track-ai'
450
+ }
451
+ if (/增长|转化|标题|留存|分发|引导|文案|小红书|公众号|首屏|定位|用户|产品/i.test(s)) {
452
+ return 'track-product'
453
+ }
454
+ return 'track-engineering'
455
+ }
456
+
437
457
  export function buildDeepLearnStarterPrompt(item) {
438
458
  const safe = item && typeof item === 'object' ? item : {}
439
459
  const tierLabel = MASTERY_LABELS[clampTier(safe.masteryTier || 1)]
460
+ const isAdHoc = !safe.rejected && !safe.probe
440
461
  return [
441
462
  '[顺带私教·专心闯关]',
442
463
  `知识点:${cleanText(safe.title, 140) || '当前盲区'}(itemId: ${cleanText(safe.id, 80) || 'ad-hoc'},当前掌握度:${tierLabel})`,
443
464
  safe.why ? `背景取舍:${cleanText(safe.why, 220)}` : '',
444
465
  safe.rejected ? `曾经对比过的坑:${cleanText(safe.rejected, 180)}` : '',
445
466
  safe.probe ? `摸底种子:${cleanText(safe.probe, 180)}` : '',
446
- '请严格按「先探后讲 + 换景追问」节奏带我过关:第 1 轮直接输出一个 ```learn-quiz JSON 代码块让我先盲选判断并停下等我回复,暂不要剧透完整解释。',
467
+ isAdHoc
468
+ ? '这是我主动发起的专心学习主题(若涉及当前工作区代码,可先快速只读扫一眼关键实现)。请严格按「先探后讲 + 换景追问」节奏带我一对一闯关:第 1 轮直接输出一个 ```learn-quiz JSON 代码块让我先盲选判断并停下等我回复,暂不要剧透完整解释。'
469
+ : '请严格按「先探后讲 + 换景追问」节奏带我过关:第 1 轮直接输出一个 ```learn-quiz JSON 代码块让我先盲选判断并停下等我回复,暂不要剧透完整解释。',
447
470
  ].filter(Boolean).join('\n')
448
471
  }