@oxmumu3/dsh-incidental-learn 0.1.8 → 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.
- package/README.md +23 -26
- package/client.js +984 -625
- package/lib/ledger.js +75 -7
- package/lib/prompt.js +4 -4
- package/lib/routes.js +4 -2
- package/locale/en.json +15 -15
- package/locale/zh.json +15 -15
- package/package.json +2 -2
- package/shared/schema.js +18 -0
package/README.md
CHANGED
|
@@ -1,55 +1,54 @@
|
|
|
1
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 || 0.2.2-rc.5`
|
|
5
5
|
|
|
6
|
-
平时照常跟 Agent
|
|
6
|
+
平时照常跟 Agent 协作干活,顺带私教仅在真正遇到反直觉踩坑或跨项目架构、设计取舍的回合末尾,附上一条默认折起的小学习卡;新抓到的经验直接落进唯一 **「一本手账」** 最顶部(平时 1-3 条直接铺开少点一次、第 4 条起自动折叠旧未看并设 8 条封顶防刷屏),点击行内「10 秒快测」做一道盲选题即可原地升级到 `2/4 讲过一轮` 零搬运;随时也能通过顶部输入框一键开启 1 对 1 专心闯关或从工具栏连抽 3 条串学。
|
|
7
7
|
|
|
8
8
|
## 在 DeepSeek Harness 中安装
|
|
9
9
|
|
|
10
|
-
### 方式一:创造模式一句话安装(推荐)
|
|
11
|
-
|
|
12
10
|
1. 在 DeepSeek Harness 新建会话,点顶部「标准模式」下拉,切到「创造模式」。
|
|
13
11
|
2. 复制下面这句话发给 Agent,弹出授权时点「允许」:
|
|
14
12
|
|
|
15
13
|
```text
|
|
16
|
-
请通过插件管理器,从 npm 官方源安装并启用 @oxmumu3/dsh-incidental-learn@latest
|
|
14
|
+
请通过插件管理器,从 npm 官方源安装并启用 @oxmumu3/dsh-incidental-learn@latest。完成后请核对版本和启用状态,再带我打开左侧「顺带私教」。
|
|
17
15
|
```
|
|
18
16
|
|
|
19
|
-
|
|
17
|
+
(也可以在「插件 -> 添加插件」直接填入 `@oxmumu3/dsh-incidental-learn@latest` 安装并启用。)
|
|
20
18
|
|
|
21
|
-
|
|
19
|
+
开源仓库与图文说明(觉得有帮助欢迎点个 Star):
|
|
20
|
+
https://github.com/oxmumu3/dsh-incidental-learn
|
|
22
21
|
|
|
23
22
|
## 界面与日常用法一览
|
|
24
23
|
|
|
25
|
-
### 1.
|
|
24
|
+
### 1. 一体化 1 对 1 入口 + 刚装好就能看懂的三步原理图(零 Token 开箱)
|
|
26
25
|
|
|
27
|
-
|
|
26
|
+
首次打开保留清晰三步工作原理图与交互按钮模拟器(不加载虚假历史数据,不耗模型额度),顶部常驻「直接开启 1 对 1 专心学习」输入框,不被历史未看条卡住;积累记录后随时可通过顶栏「工作原理图」按需重看。
|
|
28
27
|
|
|
29
28
|

|
|
30
29
|
|
|
31
30
|
### 2. 对话末尾默认折起的「顺带补充」,绝不抢主回复风头
|
|
32
31
|
|
|
33
|
-
|
|
32
|
+
系统提示词严选只在反直觉踩坑或跨项目架构/设计取舍时附上一条带「附 · 顺带补充(非本轮主回复)」分隔的柔和灰单行折起条,单会话限频且拒绝低价值常规杂活;底部输入栏轻量显示 `顺带学习 · 已存 N 张`。
|
|
34
33
|
|
|
35
34
|

|
|
36
35
|
|
|
37
|
-
### 3.
|
|
36
|
+
### 3. 点开就在右侧「顺带学习栏」边聊边测,主输入框草稿原样保留
|
|
38
37
|
|
|
39
|
-
|
|
38
|
+
有空想弄懂时,点「在右侧边聊边学」在右侧顺带学习栏完成一题盲选点拨,左侧正在写到一半的业务草稿原封不动,并顺滑留在同一本手账内。
|
|
40
39
|
|
|
41
40
|

|
|
42
41
|
|
|
43
|
-
### 4.
|
|
42
|
+
### 4. 「一本手账」合二为一零搬运 + 三层严选防刷屏
|
|
44
43
|
|
|
45
|
-
|
|
44
|
+
取消独立多标签页跳转:刚抓到的条目以琥珀左边线 `0/4 新抓到 · 未看` 直接铺在手账最顶部(最多直铺 3 条,第 4 条起自动收进单行折叠条、滚动上限 8 条防刷屏,彻底不挤出下方已学技能),原地答对「10 秒快测」立即升到 `2/4 讲过一轮`;「15 分钟连考」收进工具栏动作按钮与原生模态 `<dialog>`,点击「看手卡」可随时翻阅核心取舍、避坑对照与 4 档过关证据。
|
|
46
45
|
|
|
47
|
-

|
|
48
47
|
|
|
49
|
-
##
|
|
48
|
+
## 为什么不会打断、也不会越攒越乱
|
|
50
49
|
|
|
51
|
-
-
|
|
52
|
-
-
|
|
50
|
+
- **三层防刷屏守卫**:第 1 层提示词严选 + 写入质量门禁拒收常规小修;第 2 层自动捕获未看队列按 FIFO 封顶 `8` 条;第 3 层手账首屏最多直铺最新 `3` 条,第 `4` 条起自动折进单行收纳条并支持一键清理较早旧未看(可撤销)。
|
|
51
|
+
- **零跨页搬运**:删掉双收件箱隔离概念,未看条、学习中、已吃透共居同一本手账,支持药丸筛选(`全部` / `新抓到未看` / `学习中` / `已吃透`)与按分类过滤。
|
|
53
52
|
- **右侧栏与草稿双保险**:点选项自测若主输入框已有未发送草稿,绝不直接覆盖,先弹出确认条;右侧学习栏与主对话完全隔离。
|
|
54
53
|
|
|
55
54
|
<details>
|
|
@@ -57,15 +56,15 @@
|
|
|
57
56
|
|
|
58
57
|
### 1. 五格客户端槽位 (`client.js`)
|
|
59
58
|
|
|
60
|
-
- `sidebar.panellist` + `main` (`key: 'incidental-learn'`):
|
|
61
|
-
- `conversation.chat.markdown.fence` (`shield` / `learn-quiz` / `learn-pass`):独立于 `foldCompletedTurns`,流式阶段平稳占位,定稿后就地交互;其中 `shield` 以「附 · 顺带补充」引导线 +
|
|
59
|
+
- `sidebar.panellist` + `main` (`key: 'incidental-learn'`):920px 单栏一本手账、顶部一体化 1 对 1 专心学习入口、三步工作原理图(0/0 空态直出、积累后可通过顶栏「工作原理图」开关)、行内「10 秒快测」原地升级(`0/4 -> 2/4`)、超 3 条未看自动收纳条、药丸状态与分类筛选,以及两枚原生 `<dialog closedby="any">` 模态窗(经验手卡详单与连抽 3 条串学弹窗);打开旧版本账本时自动无损升级为四类通用技能维度。
|
|
60
|
+
- `conversation.chat.markdown.fence` (`shield` / `learn-quiz` / `learn-pass`):独立于 `foldCompletedTurns`,流式阶段平稳占位,定稿后就地交互;其中 `shield` 以「附 · 顺带补充」引导线 + 默认折叠柔和灰折起条呈现,未展开也同样静默写入手账顶部(带前端 `cardKey` Set + 后端质量门禁与 8 条封顶)。
|
|
62
61
|
- `sidebarRightTabs` + `sidebar.right.pane.tab` (`id: '@oxmumu3/dsh-incidental-learn/coach'`, `kind: 'incidental-learn-coach'`):右侧「顺带学习栏」边聊边学,独立升级掌握度至 `3/4 能复述`。
|
|
63
62
|
- `conversation.input.right`:顶部输入栏轻提醒胶囊(`顺带学习 · 已存 N 张`)。
|
|
64
63
|
- `tool.call.toolview`:`learn_save`、`learn_checkpoint`、`learn_triage` 紧凑单行执行回执。
|
|
65
64
|
|
|
66
65
|
### 2. 宿主侧能力 (`index.js` + `lib/`)
|
|
67
66
|
|
|
68
|
-
- 原子多进程共享账本 (`$DSH_HOME/incidental-learn/ledger.json`):支持 `mtimeMs` 外部变更合并、临时文件 + `renameSync`
|
|
67
|
+
- 原子多进程共享账本 (`$DSH_HOME/incidental-learn/ledger.json`):支持 `mtimeMs` 外部变更合并、临时文件 + `renameSync` 原子落盘、自动捕获质量门禁 + 8 条滚动封顶、支持 `clear_older` 与 15 步撤销栈。
|
|
69
68
|
- 静态字节预算 `systemPrompt.section`(<= 1150 UTF-8 字节),仅在 `learn_board` 工具可见时注入。
|
|
70
69
|
- 4 个同源工具:`learn_board`、`learn_save`、`learn_checkpoint`、`learn_triage`。
|
|
71
70
|
- `/api/incidental_learn/view` 与 `/api/incidental_learn/action` 同源路由(带 CSRF/Origin、Content-Type 与包体上限校验)。
|
|
@@ -92,16 +91,14 @@ dsh-incidental-learn export --out ./study-notes.md
|
|
|
92
91
|
```bash
|
|
93
92
|
npm run build # 将 shared/schema.js 与 src-client/* 编译为单文件 client.js
|
|
94
93
|
npm run check:client # 校验包名、零 ESM export、五格槽位挂载与完整卸载
|
|
95
|
-
npm test #
|
|
94
|
+
npm test # 原子账本并发、质量门禁、8条滚动封顶、行内快测原地升级、CLI、HTTP 安全校验、词典与零 Emoji
|
|
96
95
|
npm run pack:release # 生成可重现 .tgz 与 .sha256
|
|
97
96
|
```
|
|
98
97
|
|
|
99
|
-
### 5.
|
|
100
|
-
|
|
101
|
-
建议在退出当前运行的桌面端后通过官方 `dsh plugin` 安装离线包:
|
|
98
|
+
### 5. 离线打包测试(仅限开发者维护脚本)
|
|
102
99
|
|
|
103
100
|
```bash
|
|
104
|
-
dsh plugin --profile desktop add ./oxmumu3-dsh-incidental-learn-0.
|
|
101
|
+
dsh plugin --profile desktop add ./oxmumu3-dsh-incidental-learn-0.2.0.tgz
|
|
105
102
|
```
|
|
106
103
|
|
|
107
104
|
</details>
|