dsh-sidebar-suite 0.2.8 → 0.3.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/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "dsh-sidebar-suite",
3
- "version": "0.2.8",
3
+ "version": "0.3.0",
4
4
  "license": "MIT",
5
5
  "author": "Yonan",
6
6
  "repository": {
@@ -27,7 +27,7 @@
27
27
  ],
28
28
  "type": "module",
29
29
  "scripts": {
30
- "test": "node tests/test_020.mjs && node tests/test_022.mjs && node tests/test_023.mjs && node tests/test_024.mjs && node tests/test_025.mjs && node tests/test_028.mjs",
30
+ "test": "node tests/test_020.mjs && node tests/test_022.mjs && node tests/test_023.mjs && node tests/test_024.mjs && node tests/test_025.mjs && node tests/test_028.mjs && node tests/test_029.mjs && node tests/test_030.mjs && node tests/test_031.mjs",
31
31
  "check": "node --check lib/index.js && node --check lib/client.js && node --check lib/temp-session-host.mjs && npm pack --dry-run"
32
32
  },
33
33
  "main": "lib/index.js",
@@ -63,15 +63,19 @@
63
63
 
64
64
  ### 3.2 临时切一下(只影响这次)
65
65
 
66
- 侧栏顶部有一排很小的文字按钮:
66
+ 侧栏顶部是一条**分段控件**:三个布局装在同一枚灰色胶囊里,选中的那个是白底高亮;胶囊右边隔一道竖线,是当前布局专用的动作按钮。0.2.9 起全部是矢量图标。
67
67
 
68
68
  ```
69
- 折叠 · 标签页 · 浮层 │ 显示工作区 / 展开扩展 · 换布局
69
+ ┌─────────────────┐
70
+ │ ▤ ▥ ▢ │ │ ⇄ 显示扩展
71
+ └─────────────────┘
72
+ 折叠 标签页 浮层 动作按钮
70
73
  ```
71
74
 
72
- - 点 `折叠 / 标签页 / 浮层` = 切换布局。**只对本次会话有效**,下次启动回到默认值。
73
- - 中间那条竖线后面的按钮 = 在当前布局下切换「看哪一组」。
74
- - `换布局` = 按顺序轮换三种。**侧栏宽度小于 300px 时会自动隐藏**(放不下)。
75
+ - 点胶囊里的三个图标 = 切换布局(`▤` 折叠 / `▥` 标签页 / `▢` 浮层)。**只对本次会话有效**,下次启动回到默认值。
76
+ - 每个按钮鼠标悬停都会显示文字说明,不用记图标。
77
+ - 竖线右边的按钮 = 在当前布局下切换「看哪一组」;侧栏拖宽超过 300px 后,这些按钮会把文字显示出来。
78
+ - 侧栏很窄(< 300px)时只显示图标;再窄(< 100px,折成图标条)时连图标都会精简。
75
79
 
76
80
  > 故意不做记忆:临时切换不写盘、不写 localStorage,避免你在窄屏随手一点把默认布局改坏了。
77
81
 
@@ -113,6 +117,29 @@
113
117
 
114
118
  ---
115
119
 
120
+ ### 3.4 第三方插件加的页签(0.3.0)
121
+
122
+ 这一版给**别的插件**开了一个口:它们可以往你侧栏里加自己的一页。
123
+
124
+ 你不需要做任何设置。什么时候会看到:
125
+
126
+ - 装了某个使用这个接口的插件之后,**控制栏下面会多出一排页签**,比如 `扩展 │ 工作区 │ 那个插件的名字`。
127
+ - 点哪个,侧栏中间那块就换成哪一页。
128
+ - **再点一次当前页签**,就退回原来的会话列表 / 扩展列表。
129
+ - 你在哪一页会被记住,下次打开还在那一页。
130
+
131
+ 三种布局下的差别:
132
+
133
+ | 你选的布局 | 页签条长什么样 |
134
+ |---|---|
135
+ | 标签页(默认) | `扩展 / 工作区 / 插件页` 三种并排 |
136
+ | 折叠 | 只有插件页进条;扩展和工作区还是用原来那两个折叠按钮 |
137
+ | 浮层 | 只有插件页进条;扩展还是用「浮出面板」按钮 |
138
+
139
+ **一个都没装的话,这排页签根本不会出现** —— 界面和 0.2.x 一模一样,不会平白多一行东西。
140
+
141
+ > 想自己写一个?接口是 `ctx.sidebarSuite.registerTab({ id, title, icon, mount })`,`mount` 拿到一个空容器,你爱画什么画什么。完整示例在 README 和 DETAIL 里。
142
+
116
143
  ## 四、临时会话(重点)
117
144
 
118
145
  ### 4.1 它到底是什么