@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/README.md CHANGED
@@ -1,9 +1,9 @@
1
- # 顺带私教 (`@oxmumu3/dsh-incidental-learn`)
1
+ # 顺带私教 (@oxmumu3/dsh-incidental-learn)
2
2
 
3
3
  > 作者:`牛村木木山 <157776623+oxmumu3@users.noreply.github.com>`
4
- > 适用宿主:`DeepSeek Harness >=0.2.2-rc.2 || 0.2.2-rc.3`
4
+ > 适用宿主:`DeepSeek Harness 0.2.2-rc.2 || 0.2.2-rc.3`
5
5
 
6
- 把日常跟 Agent 协作干活中遇到的真实工程、架构与前端设计取舍顺手攒下来,沉淀为个人技能库:平时干活零打扰,仅在值得留心的回合末尾附上一条低调柔和灰的可折起「顺带学习卡」(带「附 · 顺带补充(非本轮主回复)」分隔与默认折起 1 行摘要条,不抢主回答的风头);忙时完全不用点按钮,系统在后台自动存档;有空时点击「在右侧边聊边学」在右侧顺带学习栏不扰动主对话草稿完成一题点拨,或点「开始 3 分钟展开学」深入闯关并沉淀跨 Agent 共享技能库。
6
+ 平时照常跟 Agent 协作干活,顺带私教会在涉及真实工程、前端体验、AI 协作或产品策略取舍的回合末尾,附上一条默认折起的小学习卡;忙着赶进度时完全不用点任何按钮,系统会在后台静默存档;闲下来随时回到工作台,按 **前端与界面体验**、**架构与工程实践**、**AI 与 Agent 协作**、**产品与增长策略** 4 类通用技能库复习、闯关,沉淀属于自己的跨 Agent 个人技能库。
7
7
 
8
8
  ## 在 DeepSeek Harness 中安装
9
9
 
@@ -20,21 +20,59 @@
20
20
 
21
21
  进入「插件 -> 添加插件」,填入 `@oxmumu3/dsh-incidental-learn@latest`,安装后点击「立即启用」,再打开左侧「顺带私教」。
22
22
 
23
- ## 架构概览
24
-
25
- 1. **五格客户端槽位 (`client.js`)**:
26
- - `sidebar.panellist` + `main` (`key: 'incidental-learn'`):840px 单栏个人技能库、三步图文使用说明(0/0 空态直出、积累后可通过顶栏「使用说明」收放)、默认折叠的「效果预览」(`details` + `toolbar`) 与「后台自动存档」清单、15 分钟集中学、原生 `<dialog closedby="any">` 过关详情窗与零 Token 示例预览入口。
27
- - `conversation.chat.markdown.fence` (`shield` / `learn-quiz` / `learn-pass`):独立于 `foldCompletedTurns`,流式阶段平稳占位,定稿后就地交互;其中 `shield` 以「附 · 顺带补充」引导线 + 默认折叠柔和灰折起条呈现,未展开也同样静默写入后台存档。选项作答内置草稿保护(非空不覆盖)与空闲直发(`useInput` + `inputActions`)。
28
- - `sidebarRightTabs` + `sidebar.right.pane.tab` (`id: '@oxmumu3/dsh-incidental-learn/coach'`, `kind: 'incidental-learn-coach'`):右侧「顺带学习栏」边聊边学,独立升级掌握度至 `3/4 能复述`。
29
- - `conversation.input.right`:顶部输入栏轻提醒胶囊(`顺带学习 · 已存 N 张`)。
30
- - `tool.call.toolview`:`learn_save`、`learn_checkpoint`、`learn_triage` 紧凑单行执行回执。
31
- 2. **宿主侧能力 (`index.js` + `lib/`)**:
32
- - 原子多进程共享账本 (`$DSH_HOME/incidental-learn/ledger.json`):支持 `mtimeMs` 外部变更合并、临时文件 + `renameSync` 原子落盘及 15 步撤销栈。
33
- - 静态字节预算 `systemPrompt.section`(<= 1150 UTF-8 字节),仅在 `learn_board` 工具可见时注入。
34
- - 4 个同源工具:`learn_board`、`learn_save`、`learn_checkpoint`、`learn_triage`。
35
- - `/api/incidental_learn/view` 与 `/api/incidental_learn/action` 同源路由(带 CSRF/Origin、Content-Type 与包体上限校验)。
36
- 3. **跨 Agent CLI 桥 (`bin/incidental-learn-cli.mjs`)**:
37
- - 供 Antigravity、Codex、Claude Code 或 Super Agent 验收脚本向同一份 `ledger.json` 追加候选卡片或导出笔记:
23
+ ## 界面与日常用法一览
24
+
25
+ ### 1. 刚装好就能看懂的三步上手引导(零 Token 开箱)
26
+
27
+ 首次打开默认显示三步图解,不加载虚假历史数据,也不消耗模型额度;想先看完整成效时,可一键加载不耗 Token 的示例效果随时还原。
28
+
29
+ ![刚装好一眼看懂的三步图解引导](https://raw.githubusercontent.com/oxmumu3/dsh-incidental-learn/main/docs/images/01-welcome.png)
30
+
31
+ ### 2. 对话末尾默认折起的「顺带补充」,绝不抢主回复风头
32
+
33
+ 仅在出现值得留心的取舍时附上一条带「附 · 顺带补充(非本轮主回复)」分隔的柔和灰单行折起条;底部输入栏轻量显示 `顺带学习 · 已存 N 张`,普通闲聊或简单改字保持完全静默。
34
+
35
+ ![对话末尾默认折起的柔和灰顺带学习卡与输入栏轻提醒](https://raw.githubusercontent.com/oxmumu3/dsh-incidental-learn/main/docs/images/02-chat-strip.png)
36
+
37
+ ### 3. 点开就在右侧「顺带学习栏」边聊边学,主输入框草稿原样保留
38
+
39
+ 有空想弄懂时,点「在右侧边聊边学」在右侧顺带学习栏完成一题点拨,左侧正在写到一半的业务草稿原封不动;点「加入重点学」可显式挂入待学清单。
40
+
41
+ ![右侧顺带学习栏独立边聊边学且主草稿零扰动](https://raw.githubusercontent.com/oxmumu3/dsh-incidental-learn/main/docs/images/03-side-coach.png)
42
+
43
+ ### 4. 四类通用个人技能库,集中回看、三分钟闯关与四档掌握度
44
+
45
+ 按 **前端与界面体验**、**架构与工程实践**、**AI 与 Agent 协作**、**产品与增长策略** 四个通用维度自动归类,优先置顶最值得学的一张,并独立记录 `1/4` 至 `4/4 能接住追问` 的过关证据。
46
+
47
+ ![四类通用个人技能库工作台与后台自动存档收件箱](https://raw.githubusercontent.com/oxmumu3/dsh-incidental-learn/main/docs/images/04-skill-library.png)
48
+
49
+ ## 为什么不会打断干活
50
+
51
+ - **默认折起、静默优先**:对话卡片以「附 · 顺带补充」单行柔和灰收起,不遮挡也不过度提示;无实质取舍的普通问答零卡片。
52
+ - **忙时不点也在后台自动存档**:只要当轮出现取舍,卡片默认折叠也会静默写入本机「后台自动存档」清单;待看超过 5 张时出现一键清理过期低价值卡片,误删可立即撤销。
53
+ - **右侧栏与草稿双保险**:点选项自测若主输入框已有未发送草稿,绝不直接覆盖,先弹出确认条;右侧学习栏与主对话完全隔离。
54
+
55
+ <details>
56
+ <summary>开发者与进阶说明(跨 Agent CLI / 技术架构 / 本地验证)</summary>
57
+
58
+ ### 1. 五格客户端槽位 (`client.js`)
59
+
60
+ - `sidebar.panellist` + `main` (`key: 'incidental-learn'`):840px 单栏个人技能库、三步图文使用说明(0/0 空态直出、积累后可通过顶栏「使用说明」收放)、默认折叠的「效果预览」(`details` + `toolbar`) 与「后台自动存档」清单、15 分钟集中学、原生 `<dialog closedby="any">` 过关详情窗与零 Token 示例预览入口;打开旧版本账本时自动无损升级为四类通用技能维度,不丢失任何已有条目与自定义分类。
61
+ - `conversation.chat.markdown.fence` (`shield` / `learn-quiz` / `learn-pass`):独立于 `foldCompletedTurns`,流式阶段平稳占位,定稿后就地交互;其中 `shield` 以「附 · 顺带补充」引导线 + 默认折叠柔和灰折起条呈现,未展开也同样静默写入后台存档。选项作答内置草稿保护(非空不覆盖)与空闲直发(`useInput` + `inputActions`)。
62
+ - `sidebarRightTabs` + `sidebar.right.pane.tab` (`id: '@oxmumu3/dsh-incidental-learn/coach'`, `kind: 'incidental-learn-coach'`):右侧「顺带学习栏」边聊边学,独立升级掌握度至 `3/4 能复述`。
63
+ - `conversation.input.right`:顶部输入栏轻提醒胶囊(`顺带学习 · 已存 N 张`)。
64
+ - `tool.call.toolview`:`learn_save`、`learn_checkpoint`、`learn_triage` 紧凑单行执行回执。
65
+
66
+ ### 2. 宿主侧能力 (`index.js` + `lib/`)
67
+
68
+ - 原子多进程共享账本 (`$DSH_HOME/incidental-learn/ledger.json`):支持 `mtimeMs` 外部变更合并、临时文件 + `renameSync` 原子落盘及 15 步撤销栈。
69
+ - 静态字节预算 `systemPrompt.section`(<= 1150 UTF-8 字节),仅在 `learn_board` 工具可见时注入。
70
+ - 4 个同源工具:`learn_board`、`learn_save`、`learn_checkpoint`、`learn_triage`。
71
+ - `/api/incidental_learn/view` 与 `/api/incidental_learn/action` 同源路由(带 CSRF/Origin、Content-Type 与包体上限校验)。
72
+
73
+ ### 3. 跨 Agent CLI 桥 (`bin/incidental-learn-cli.mjs`)
74
+
75
+ 供 Antigravity、Codex、Claude Code 或 Super Agent 验收脚本向同一份 `ledger.json` 追加候选卡片或导出笔记:
38
76
 
39
77
  ```bash
40
78
  dsh-incidental-learn add \
@@ -49,7 +87,7 @@ dsh-incidental-learn status
49
87
  dsh-incidental-learn export --out ./study-notes.md
50
88
  ```
51
89
 
52
- ## 本地开发与四层门禁验证
90
+ ### 4. 本地开发与四层门禁验证
53
91
 
54
92
  ```bash
55
93
  npm run build # 将 shared/schema.js 与 src-client/* 编译为单文件 client.js
@@ -58,10 +96,12 @@ npm test # 原子账本并发、CLI、HTTP 安全校验、工具 Sch
58
96
  npm run pack:release # 生成可重现 .tgz 与 .sha256
59
97
  ```
60
98
 
61
- ## 安装到 DeepSeek Harness Desktop
99
+ ### 5. 安装本地离线包到 DeepSeek Harness Desktop
62
100
 
63
101
  建议在退出当前运行的桌面端后通过官方 `dsh plugin` 安装离线包:
64
102
 
65
103
  ```bash
66
- dsh plugin --profile desktop add ./oxmumu3-dsh-incidental-learn-<version>.tgz
104
+ dsh plugin --profile desktop add ./oxmumu3-dsh-incidental-learn-0.1.6.tgz
67
105
  ```
106
+
107
+ </details>
@@ -34,7 +34,7 @@ function usage() {
34
34
  ' add Append a candidate card (or explicit item with --explicit)',
35
35
  ' --title <text> --why <text> [--rejected <text>] [--probe <text>]',
36
36
  ' [--source antigravity|codex|dsh-chat|superagent-review|manual]',
37
- ' [--track track-frontend|track-harness|track-growth] [--explicit]',
37
+ ' [--track track-frontend|track-engineering|track-ai|track-product] [--explicit]',
38
38
  ' status Print ledger summary [--json]',
39
39
  ' export Export study notes [--track <id>] [--out <path>]',
40
40
  '',
@@ -64,7 +64,7 @@ async function main() {
64
64
  rejected: flags.rejected ? String(flags.rejected) : '',
65
65
  probe: flags.probe ? String(flags.probe) : '',
66
66
  source: flags.source ? String(flags.source) : 'manual',
67
- trackId: flags.track ? String(flags.track) : 'track-harness',
67
+ trackId: flags.track ? String(flags.track) : 'track-engineering',
68
68
  epistemic: flags.explicit ? 'explicit' : 'inferred',
69
69
  }
70
70
  const res = flags.explicit