@sidequest-007/dsh-atlas 1.0.9 → 1.0.11

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/CHANGELOG.md CHANGED
@@ -1,7 +1,218 @@
1
1
  # Changelog
2
2
 
3
+ ## [1.0.11] - 2026-10-28
4
+
5
+ ### Fixed
6
+
7
+ - **A line-range reference was priced as if it were the whole file.** The dock
8
+ computed a reference's token cost from the file's byte size, which is the only
9
+ fact the Host has without opening it — so `@src/db.ts:88-140` was quoted at the
10
+ full weight of `db.ts` and became, by a wide margin, the most expensive-looking
11
+ row in a draft that asked the agent for 53 lines. A range is now priced by its
12
+ line count, and never above the file's own figure. The estimate stays an
13
+ estimate: the Host still opens nothing, which is what keeps the reference a
14
+ marker rather than a copy of the file.
15
+
16
+ ### Changed
17
+
18
+ - `description` now names the line ranges and the per-reference cost, which is
19
+ what the plugin actually adds over the built-in `@`.
20
+ - `dsh.plugin.json` carried `1.0.9-port.9` as its version while `package.json`
21
+ said `1.0.10`. Both agree again.
22
+
23
+ ## [1.0.10] - 2026-10-28
24
+
25
+ ### Changed
26
+
27
+ - **This is `1.0.9-port.9`, promoted to `latest`.** The four `port` builds fixed
28
+ real defects: a history palette that had no surface of its own (it asked for a
29
+ token this shell never defines, so the fallback `transparent` applied and the
30
+ transcript read straight through the dialog), eight more tokens with the same
31
+ problem — every border, rule and frame that used them had been invisible — and
32
+ a `lib/` that had fallen behind the sources, so one published tarball carried an
33
+ older client than the code it claimed to be.
34
+
35
+ All of that was reachable only through the `port` dist-tag. A plain
36
+ `dsh plugin add @sidequest-007/dsh-atlas`, and every market install, kept
37
+ handing out the 2026-09-27 build. `latest` now points here, so both paths agree.
38
+
39
+ ### Unchanged
40
+
41
+ - No runtime changes since `1.0.9-port.9` — the same `lib/`, the same tests
42
+ (1040 passed, 1 skipped; 94.87% statement, 90.13% branch). This release moves
43
+ the version number and the dist-tag to which it publishes, nothing else.
44
+
45
+ ## [1.0.9-port.9] - 2026-10-27
46
+
47
+ ### Fixed
48
+
49
+ - **The history palette had no surface of its own.** It asked for
50
+ `--dsw-alias-bg-elevated`, a token this shell does not define, so the declared fallback
51
+ (`transparent`) applied and the transcript read straight through the dialog — the rows and the
52
+ conversation behind them interfered, which is what the user reported. It now uses the same
53
+ surface as the roaming bar (`--dsw-specific-tip`, falling back to `--dsw-alias-bg-layer-1`), so
54
+ the two history surfaces match and the list sits on something solid.
55
+ - The same audit found eight more tokens this shell never defines, each of which had been
56
+ silently resolving to `transparent`: `bg-subtle`, `bg-muted`, `bg-primary`, `border-subtle`,
57
+ `border-accent`, `border-focus`, `border-secondary` and `label-error`. They now map to the
58
+ tokens that exist (`bg-layer-2`, `bg-base`, `border-l1`, `brand-primary`, `border-l2`,
59
+ `state-error-primary`). Visible consequences: the roaming frame band and its left rule, the
60
+ palette's borders and the picker's footer rule were all invisible before.
61
+
62
+ ## [1.0.9-port.8] - 2026-10-27
63
+
64
+ ### 文档
65
+
66
+ - **两种语言都把「历史跳转」写进 README**:漫游(<kbd>Esc</kbd>)与检索面板(<kbd>Ctrl/Cmd+Shift+H</kbd>)的按键表、
67
+ 一格一轮与导轨同一把尺(A-33)、回答与系统轮次也是落点、会抢键时的让位规则、取回方式与智能跟随的口径。
68
+ 设置表补上四项(启用历史跳转 / 历史粒度 / 取回方式 / 智能跟随),默认值按 port.5 起**真实生效**的口径写
69
+ (历史粒度默认「每轮对话」)。
70
+ - **`docs/history-jump.md` §7.1 的默认值不再是 `'message'`**:与 `src/client/settings.ts`、`src/settings.ts` 对齐为 `'turn'`。
71
+ - **新增 `assets/screenshots/history-roam.png`**(1280×820 @2x,取自真实实例):按 <kbd>Esc</kbd> 后输入框上方的读数
72
+ `历史 第 0 / 1 轮 · 当前草稿`。
73
+ - 包描述与关键词补上历史跳转(`history` / `keyboard` / `navigation` / `session-history` / `esc`)。
74
+
75
+ ### 测试
76
+
77
+ - `tests/mention-navigator.spec.tsx` 新增两组:一次提交只触发一次 `onSend`(`submitting` 跨多次渲染只发一次,
78
+ 回到 idle 后再提交才再发);菜单高度预算把输入框卡片顶边写成 `--dsh-atlas-menu-max`,跟随 resize,
79
+ 底部 160px 夹取,卡片消失时移除该变量。
80
+ - 语句覆盖 94.87%、分支 90.13%,单测 **1040 通过 / 1 跳过**。
81
+
82
+ ## [1.0.9-port.7] - 2026-10-27
83
+
84
+ ### 修复
85
+
86
+ - **发布产物里的 `lib/` 落后于源码**:`lib/index.js` 停在 `9ca2757`(port.6 的功能提交),
87
+ 之后那次「分类缓存改为实例级」的修复(`397f9da`)只进了 `src/`,没重建进 `lib/`。
88
+ npm 上的 tarball 装的就是 `lib/`,所以 **port.6 发布出去的包带着模块级缓存的旧缺陷**:
89
+ 同一进程里插件卸载再挂载,30 秒 TTL 内会拿到上一个实例的技能/会话/插件列表。
90
+ 本版重建 `lib/`,产物与源码重新对齐(`cmp` 证明 port.6 的 lib 与重建结果不同)。
91
+
92
+ ### 变更
93
+
94
+ - 无功能变化:本版只为让发布产物等于已审阅的源码。
95
+
96
+ ### 证据
97
+
98
+ - 单测 **1030 通过 / 1 跳过**、`tsc --noEmit` 0 错误、`verify:publish` 66 文件、
99
+ 语句覆盖 94.64%(5193/5487)、分支 89.83%(3489/3884)。
100
+
101
+ ## [1.0.9-port.6] - 2026-10-27
102
+
103
+ ### 修复
104
+
105
+ - **默认粒度在客户端没有真正生效**(用户回报:设置里默认仍不是「每轮对话」)。根因是三个地方的口径不一致:
106
+ 契约默认 `'turn'`,设置面板兜底 `'turn'`,但 `FrameCursor` / `HistoryPalette` 用的是
107
+ `settings.historyJumpFrames === 'turn' ? 'turn' : 'message'` —— **缺值就落到 `'message'`**。
108
+ 宿主交给客户端的可能是**存储层**(`at-file` 里没有这个键)而不是 schema 解析后的对象,
109
+ 于是面板显示「每轮对话」而阶梯仍按「条」走,两者当场自相矛盾。
110
+ 现在两处都改成 `=== 'message' ? 'message' : 'turn'`:**只有显式选择「每条消息」才细走**。
111
+ - 单测 **983 通过 / 1 跳过**,`tsc` 0 错误。
112
+
113
+ ## [1.0.9-port.5] - 2026-10-27
114
+
115
+ ### 变更
116
+
117
+ - **Esc 的历史阶梯改成「轮」,与页面右侧的轮次导轨同一把尺**(用户选定的方案 A)。
118
+ 一格 = 一个 `turn`,身份就是 turn 号,所以同一轮在结构上不可能出现两格:
119
+ 上一版把「提问」和「回答」各算一格,11 轮的会话在面板里读作 22 格,而右侧只画 11 格。
120
+ - **系统发起的轮次自带一格**:这种轮次没有提问节点,它的最后一个有正文的助手节点就是这一轮唯一的停点(标签 系统),
121
+ 与宿主 `turnNavigationItem` 的 `user ?? loaded[0]` 锚点规则、`findLast` 取回答的规则一致。
122
+ - **默认粒度改为 `'turn'`**(原 `'message'`)。`'message'` 仍可在设置里选,它保留「每条提问 + 每条回答都停」的细粒度。
123
+ - **读数条单位随粒度**:`'turn'` 显示「第 3 / 11 轮」,`'message'` 仍显示「第 3 / 22 条」。
124
+
125
+ ### 测试
126
+
127
+ - `tests/runtime.spec.ts` 的默认设置形状断言更新为 `historyJumpFrames: 'turn'`。
128
+ - 全套 40 文件 **983 通过 / 1 跳过**。
129
+
130
+ ## [1.0.9-port.4] - 2026-10-27
131
+
132
+ ### 修复
133
+
134
+ - **系统发起的轮次走不到**:上一版只在「该 turn 的 prompt 也在格上」时才建回复格,而系统轮次没有 `user`
135
+ 节点(没有人提问),于是那几轮在 Up/Down 里根本不存在。现在无 prompt 的 turn 用它的回答成格,
136
+ 并标注**系统**(来源优先于类别:有提问的回复格标 回复,系统轮次的格标 系统)。
137
+ - **流式消息的第一条被当成独立的历史消息**:一轮回答可能流出多个助手节点,第一条常是上文的重放,
138
+ 上一版给每个节点都建了一格,面板里于是多出一条既不是用户、也不是系统发起的行。
139
+ 现在**一个 turn 只留一格**,取最后一个有正文的 `assistant-step`;该 turn 一旦成格即认领,
140
+ outline 不会为同一 turn 再合成一格。
141
+
142
+ ### 测试
143
+
144
+ - `tests/history-frames.spec.ts` 新增 4 条:回复格归属(用户提问 / 系统发起)、一轮多节点只留一格、
145
+ `'turn'` 粒度不含回复格。
146
+ - 重新基线 `tests/history-cursor.spec.tsx` 三处系统轮次断言(窗口里只有回答的 turn 现在是最新停点)。
147
+ 全套 40 文件 **983 通过 / 1 跳过**。
148
+
149
+ ## [1.0.9-port.3] - 2026-10-27
150
+
151
+ ### 新增
152
+
153
+ - **把助手的回复也当作消息的一格,Up/Down 会跳到它上面**(用户口径:*"系统的轮次不会如用户的输入轮次一样随
154
+ up 和 down 移动到对应的位置,也就是应该把系统轮次视作消息的一个类别,也要跳转"*)。
155
+ `src/client/history-frames.ts` 的 `HistoryFrame.kind` 增加 `'reply'`:`'message'` 粒度下,一个有正文的
156
+ `assistant-step` 节点成格,读数条标 `history.replyTag`(回复 / Reply)。有三条边界写进了代码注释与
157
+ `docs/history-jump.md` §5.1.1:
158
+ 1. **只在提问也在格上时才成格**(`seenTurns.has(turn)`)——回复排在提问之后,窗口里没有 prompt 的 turn
159
+ (只有 outline 的那部分)保留 outline 合成的格,读数条总数仍按 outline 口径,不会凭空多出回复格;
160
+ 2. **`'turn'` 粒度不变**,一回合仍只一格(开头 prompt);
161
+ 3. **不复用**:回复的 `authoredByUser === false`,于是 `Ctrl+↑` 的"复用我写过的话"仍只走用户消息,
162
+ 而漫游停在回复上按 Enter 会把这段正文写回输入框(引用/续写)。
163
+ - `src/client/locales.ts` 增 `history.replyTag`(zh 回复 / en Reply),`FrameCursor` 的读数条与
164
+ `HistoryPalette` 的行标记按 kind 而非只按 `systemInitiated` 取标签。
165
+
166
+ ### 变更
167
+
168
+ - 受影响的既有断言按新契约重排:`tests/history-cursor.spec.tsx`(漫游首停由最新用户消息变为最新回复、
169
+ 四次 Up 才到最旧格、行高亮/滚动/`CSS.escape` 的目标 key 由 `u2` 变 `a2`)、
170
+ `tests/history-palette.spec.tsx`(列表由 2 行变 4 行、`data-atlas-frame-count` 由 2 变 4)。
171
+ 全套 40 文件 979 通过 / 1 跳过(新增 4 条针对回复格边界的断言)。
172
+
3
173
  本项目遵循 [Keep a Changelog](https://keepachangelog.com/zh-CN/1.1.0/) 的组织方式,版本号遵循 [语义化版本](https://semver.org/lang/zh-CN/)。
4
174
 
175
+ ## [1.0.9-port.2] - 2026-10-26
176
+
177
+ ### 修复
178
+
179
+ - **历史面板快捷键的文档/实现互相矛盾**:`src/client/history-keys.ts:157 isCommandOnly` 要求
180
+ 「命令键且不带 Shift」,于是实现只认 `Ctrl/Cmd+H`,而 `src/client/index.ts:1442` 与
181
+ `docs/history-jump.md` §2 选型表写的是 `Ctrl/Cmd+Shift+H`(选它的理由正是绕开浏览器历史记录与 macOS
182
+ 「隐藏应用」)。现在两种拼写打开同一面板(新增 `isPaletteChord`,`HistoryPalette` 复用它),`Alt` 仍被
183
+ 排除(Windows 上 `AltGr` 即 `Ctrl+Alt`)。首轮无头实测证据:`Ctrl+Shift+H` 命中 0、`Ctrl+H` 命中 1;
184
+ 改后两者都命中。
185
+
186
+ ## [1.0.9-port.1] - 2026-10-26
187
+
188
+ ### 移植
189
+
190
+ - **基座取自 npm/GitHub 最新发行版 `1.0.9`(tag `v1.0.9`),上游源码包里的新功能以补丁形式叠加上去**:
191
+ 源码压缩包自带的那份 `dsh-atlas` 已经无法启动(不带 `lib/`,且写的是宿主的旧设置 API),
192
+ 所以移植只搬 `src/`、`tests/`、`docs/` 的行为与代码,构建、依赖装配、发布清单全部沿用 `1.0.9`。
193
+ - **宿主 API 对齐 `@deepseek-ai/*@0.2.0-rc.2`**:注入工厂拿到的会话 id 是裸 `string`,进入领域函数前
194
+ 用一处 `sid()` 收口成 `SessionId`(品牌类型);会话跳转改为先问 `uiWorkspace.openSession`,退回旧
195
+ `sessions.open`,两者都没有就如实报"这一版客户端没有会话导航"。
196
+ `useSession` / `useSessions` 这两个标准快照钩子按消费端约定补进 `SessionStandardProps` /
197
+ `GlobalStandardProps` 的模块声明,运行时由 ui-session 提供,不再假装它们不存在。
198
+ - **设置命名空间带降级**:`ctx.settings.register` 在新宿主上由 dsh-purge 的兼容层提供;没有这一层时
199
+ 不再抛 `TypeError: ctx.settings.register is not a function` 把整个插件拽死,而是警告一句、
200
+ 用 schema 默认值继续跑。
201
+
202
+ ### 新增
203
+
204
+ - **会话历史跳转(History Jump)**:`Esc` 进入选择态后 `↑` / `↓` 在历史消息间走,`Enter` 把那条话
205
+ 原样放回输入框;另有 `Ctrl + ↑ / ↓` 不进入选择态直接快速复用;`F1` 打开会话历史面板(可筛选、
206
+ 可只显示每轮首条、系统发起的一轮单独标注)。
207
+ 配套四个设置项:`historyJump`、`historyJumpFrames`(每条消息 / 每轮)、`historyJumpReuseMode`
208
+ (覆盖 / 追加草稿)、`historyJumpSmartFollow`(是否跟随手动滚动改变"当前位置",默认关)。
209
+ - **设置面板**:新增 `settings.section` 一节,把上面四项按"两个功能共用 / Esc 漫游 / Ctrl+↑↓ 快速复用"
210
+ 分组呈现。
211
+ - **文件夹选择器重做**:边输入边浏览(`atFile/browse`),不存在或越界的路径用"最长有效前缀 + 剩余部分
212
+ 当筛选"回答;`hasChildren` 探测决定能不能展开;Windows 列盘符;工作区外的常用文件夹按
213
+ `sibling` / `parent` / `child` / `recent` / `family` 分组(`atFile/recentFolders`)。
214
+ - **条目上限不再吃掉你要的那一行**:名字被 `maxFiles` 截断时,目标那行以 `pinned` 顶到第一行。
215
+
5
216
  ## [1.0.6] - 2026-09-27
6
217
 
7
218
  ### 文档
package/LICENSE-ORIGINAL CHANGED
@@ -1,21 +1,21 @@
1
- MIT License
2
-
3
- Copyright (c) 2026 dsh-at-file contributors
4
-
5
- Permission is hereby granted, free of charge, to any person obtaining a copy
6
- of this software and associated documentation files (the "Software"), to deal
7
- in the Software without restriction, including without limitation the rights
8
- to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
9
- copies of the Software, and to permit persons to whom the Software is
10
- furnished to do so, subject to the following conditions:
11
-
12
- The above copyright notice and this permission notice shall be included in all
13
- copies or substantial portions of the Software.
14
-
15
- THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
16
- IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
17
- FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
18
- AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
19
- LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
20
- OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
21
- SOFTWARE.
1
+ MIT License
2
+
3
+ Copyright (c) 2026 dsh-at-file contributors
4
+
5
+ Permission is hereby granted, free of charge, to any person obtaining a copy
6
+ of this software and associated documentation files (the "Software"), to deal
7
+ in the Software without restriction, including without limitation the rights
8
+ to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
9
+ copies of the Software, and to permit persons to whom the Software is
10
+ furnished to do so, subject to the following conditions:
11
+
12
+ The above copyright notice and this permission notice shall be included in all
13
+ copies or substantial portions of the Software.
14
+
15
+ THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
16
+ IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
17
+ FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
18
+ AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
19
+ LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
20
+ OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
21
+ SOFTWARE.
package/README.md CHANGED
@@ -24,7 +24,7 @@ Unified `@` mentions for the DeepSeek Harness web GUI: type `@` in the composer
24
24
 
25
25
  It extends [`dsh-at-file`](https://github.com/FSMargoo/dsh-at-file) (MIT), keeping its workspace path index, file filters, and paste protection, and adding four more categories, a category menu with shortcuts, mixed results, collapsible groups, and three model-facing query tools.
26
26
 
27
- > `dsh-atlas` and `dsh-at-file` both claim the composer's `@` trigger. Install **one of them**, not both.
27
+ > **Coming from `dsh-at-file`?** Its last commit was 2026-09-01, and on current Harness it no longer starts: `ctx.settings.register` is not a function, so the plugin throws during load and its entries are dropped silently ([upstream #45](https://github.com/FSMargoo/dsh-at-file/issues/45), open since 2026-09-25; the fix has been sitting as [#47](https://github.com/FSMargoo/dsh-at-file/pull/47) since 2026-10-19). `dsh-atlas` is that same file index carried onto the current API — the workspace path index, the filters and the paste protection are all still here, with the categories above on top. Same trigger, so install one of the two.
28
28
 
29
29
  ## Install
30
30
 
@@ -38,7 +38,7 @@ dsh plugin --profile web add github:jameswatt139240-crypto/dsh-ATLAS
38
38
  git clone https://github.com/jameswatt139240-crypto/dsh-ATLAS
39
39
  dsh plugin --profile web add link:/path/to/dsh-ATLAS
40
40
 
41
- # npm (once published; the scope is the studio's, the plugin id stays `dsh-atlas`)
41
+ # npm (published; `latest` is the current release)
42
42
  dsh plugin --profile web add @sidequest-007/dsh-atlas
43
43
  ```
44
44
 
@@ -86,6 +86,22 @@ The menu keeps the category rows — five built in, plus the bundled `@git` —
86
86
 
87
87
  *The reference dock above the composer: one row per mention in the draft, each with its own glyph, its approximate token cost (`≈26k tokens` in red is past the 8 000 highlight) and its remove button — and every token in the draft painted as a link.*
88
88
 
89
+ ## History jump (<kbd>Esc</kbd>)
90
+
91
+ Two ways to reach back into the session without touching the scrollbar.
92
+
93
+ - **Roam in place.** With an empty composer, <kbd>Esc</kbd> puts the draft aside and shows a readout above it — `历史 第 3 / 19 轮`, or `… 条` when the granularity is per message. <kbd>↑</kbd>/<kbd>↓</kbd> walk one stop at a time, <kbd>PageUp</kbd>/<kbd>PageDown</kbd> five, <kbd>Home</kbd>/<kbd>End</kbd> jump to the oldest stop or back to your own draft. Typing any printable character, or <kbd>Backspace</kbd>, <kbd>Tab</kbd>, leaves the roam and lets the key do its ordinary job. <kbd>Enter</kbd> on a stop you wrote reuses that text; on any other stop it only leaves the roam.
94
+ - **The palette.** <kbd>Ctrl</kbd>/<kbd>Cmd</kbd>+<kbd>Shift</kbd>+<kbd>H</kbd> (the same chord without <kbd>Shift</kbd> also opens it) lists the stops with their turn number and a preview; type to filter, <kbd>↑</kbd>/<kbd>↓</kbd> to move, <kbd>Enter</kbd> to jump, <kbd>Esc</kbd> to close.
95
+ - **One stop per turn by default** — the same ruler as the turn rail down the right edge of the conversation, so `第 N / M 轮` in the readout and tick N of the rail name the same turn. Switch **History granularity** to *per message* to stop on the prompt and on each answer separately.
96
+ - **A turn's answer is a stop too**, not part of its prompt: landing on a turn lands on what was answered, so a session whose turns were all started for you is still walkable. System-initiated turns are stops as well, which is why a fresh session with one system turn shows `第 1 / 1 轮` rather than nothing.
97
+ - **Keys that would surprise you yield.** While the `@` menu is open, a modal is up, or a turn is generating, <kbd>Esc</kbd> keeps its ordinary meaning — the roam never swallows the first <kbd>Esc</kbd> of a running turn.
98
+ - **Reuse** writes the stop's text back into the composer: replace (default) or append, per **Reuse mode**. <kbd>Ctrl</kbd>/<kbd>Cmd</kbd>+<kbd>↑</kbd>/<kbd>↓</kbd> reuses directly without entering the roam; it clamps at both ends instead of wrapping, and its position resets to your draft after you send, so the first <kbd>Ctrl</kbd>+<kbd>↑</kbd> always starts from where you are. The roam keeps its own cursor and does wrap at both ends.
99
+ - **Smart follow off by default**: scrolling the conversation or clicking the rail does not move either cursor. Turn it on in settings if you want the roam to start wherever you last looked.
100
+
101
+ ![History roam](assets/screenshots/history-roam.png)
102
+
103
+ *The roam readout above the composer after <kbd>Esc</kbd>: `历史 第 0 / 1 轮 · 当前草稿` — standing on your own draft, of one turn in this session, at turn granularity. <kbd>↑</kbd> takes you to that turn.*
104
+
89
105
  ## Injected references
90
106
 
91
107
  Before each agent step, the plugin validates every reference in the draft and appends one message carrying **only the reference** — never file content. The agent reads referenced content on demand with the tools available to the session.
@@ -208,6 +224,10 @@ Managed in **Settings → Workspace file mentions**:
208
224
  | Candidate limit | 50 | Maximum candidates returned per request (1–200) |
209
225
  | Ignore @ mentions in pasted text | on | `@tokens` pasted from other applications stay plain text |
210
226
  | File filters | — | Global and per-workspace rules; each rule is Exact or Regex, with its own case setting |
227
+ | Enable history jump | on | Master switch for <kbd>Esc</kbd> and the palette; off hands every key back to the composer |
228
+ | History granularity | per turn | One stop per turn (the rail's own ruler), or one per message — a prompt and each answer separately |
229
+ | Reuse mode | replace | Whether a reused stop replaces the draft or is appended to it |
230
+ | Smart follow | off | Let the roam cursor start where the conversation was last scrolled to or the rail last clicked |
211
231
 
212
232
  ![File mention settings](assets/screenshots/file-mention-settings.png)
213
233
 
@@ -291,6 +311,12 @@ pnpm run verify:publish # publish-surface gate on its own
291
311
  run `npm publish --registry https://registry.npmjs.org` (a mirror such as
292
312
  `registry.npmmirror.com` cannot accept a publish).
293
313
 
314
+ ## If this replaced something you were using
315
+
316
+ `dsh-at-file` stopped loading on Harness 0.2.x, and this carried its file index onto the current API. If that is why you are here, one thing helps more than a bug report: **a star**. The plugin markets sort by it, and a project sitting at zero reads as abandoned whether or not it is — a poor first impression for a plugin whose entire job is to be dependable about paths.
317
+
318
+ → [Star the repo](https://github.com/jameswatt139240-crypto/dsh-ATLAS) · [Report a bug](https://github.com/jameswatt139240-crypto/dsh-ATLAS/issues)
319
+
294
320
  ## Compatibility
295
321
 
296
322
  The plugin satisfies both generations of the Harness Typert codec validation (the installed build checks `codec.schema.parse`; the source checkout checks `codec.create()`), and opens referenced paths through `ctx.remote.session.openWorkspacePath`.
package/README.zh.md CHANGED
@@ -24,7 +24,7 @@ DeepSeek Harness Web 界面的**统一 `@` 提及**插件:在输入框输入 `
24
24
 
25
25
  它基于 [`dsh-at-file`](https://github.com/FSMargoo/dsh-at-file)(MIT)扩展而来:保留原有的工作区路径索引、文件过滤规则与粘贴保护,并新增四个类别、类别菜单与快捷键、混合结果、分组折叠,以及三个模型侧查询工具。
26
26
 
27
- > `dsh-atlas` 与 `dsh-at-file` 都占用输入框的 `@` 触发位。请**二选一**,不要同时安装。
27
+ > **从 `dsh-at-file` 过来?** 它最后一次提交是 2026-09-01,在当前的 Harness 上已经起不来:`ctx.settings.register` 不再是函数,插件加载时即抛错、条目被静默丢弃([上游 #45](https://github.com/FSMargoo/dsh-at-file/issues/45),2026-09-25 至今未关;修复 PR [#47](https://github.com/FSMargoo/dsh-at-file/pull/47) 从 2026-10-19 躺到现在)。`dsh-atlas` 就是同一套文件索引搬到当前 API 上——工作区路径索引、过滤规则、粘贴保护都还在,再加上前面那些类别。二者占用同一个触发位,装一个。
28
28
 
29
29
  ## 安装
30
30
 
@@ -38,7 +38,7 @@ dsh plugin --profile web add github:jameswatt139240-crypto/dsh-ATLAS
38
38
  git clone https://github.com/jameswatt139240-crypto/dsh-ATLAS
39
39
  dsh plugin --profile web add link:/path/to/dsh-ATLAS
40
40
 
41
- # npm 包(发布后;scope 是工作室的,插件 id 仍是 `dsh-atlas`)
41
+ # npm 包(已发布;`latest` 即当前版本)
42
42
  dsh plugin --profile web add @sidequest-007/dsh-atlas
43
43
  ```
44
44
 
@@ -87,6 +87,22 @@ dsh plugin --profile web add @sidequest-007/dsh-atlas
87
87
 
88
88
  *输入框上方的引用栏:草稿里每个引用一行,各带自己的图标、≈token 成本(红色的 `≈26k tokens` 是超过 8 000 的高亮)与移除按钮——草稿里的每个 token 同时都被画成链接。*
89
89
 
90
+ ## 历史跳转(<kbd>Esc</kbd>)
91
+
92
+ 两条回看会话的通道,都不必碰滚动条。
93
+
94
+ - **就地漫游**:输入框为空时按 <kbd>Esc</kbd>,把草稿先放下,输入框上方出现读数 —— `历史 第 3 / 19 轮`(粒度是「条」时写 `条`)。<kbd>↑</kbd>/<kbd>↓</kbd> 逐格走,<kbd>PageUp</kbd>/<kbd>PageDown</kbd> 走五格,<kbd>Home</kbd>/<kbd>End</kbd> 跳最旧一格或回到你自己的草稿。任何可打印字符、<kbd>Backspace</kbd>、<kbd>Tab</kbd> 都退出漫游并让该键按原义落进输入框;在你写的那一格上按 <kbd>Enter</kbd> 才把那段文字取回,落在别的格上按 <kbd>Enter</kbd> 只是退出。
95
+ - **检索面板**:<kbd>Ctrl</kbd>/<kbd>Cmd</kbd>+<kbd>Shift</kbd>+<kbd>H</kbd>(不带 <kbd>Shift</kbd> 同样能开)列出所有落点,带轮号与预览;输入即过滤,<kbd>↑</kbd>/<kbd>↓</kbd> 移动,<kbd>Enter</kbd> 跳转,<kbd>Esc</kbd> 关闭。
96
+ - **默认一轮一格** —— 与页面右侧那把轮次导轨同一把尺:读数里的 `第 N / M 轮` 与导轨第 N 个刻度指的是同一轮。把**历史粒度**改成「每条消息」,才会在提问与每条回答上分别停。
97
+ - **一轮的回答本身也是落点**,不是提问的附属:落到某一轮就落在它被回答的位置,所以「整段会话都是别人发起」也能走。系统发起的轮次同样是格,这就是刚开的会话虽然只有 1 个系统轮、读数也写 `第 1 / 1 轮` 而不是空白的原因。
98
+ - **会抢键的场合一律让位**:`@` 菜单开着、有模态、或当前轮还在生成时,<kbd>Esc</kbd> 保持原义 —— 漫游绝不吞掉生成中那第一下 <kbd>Esc</kbd>。
99
+ - **取回**把该格的文字写回输入框:按**取回方式**覆盖(默认)或追加。<kbd>Ctrl</kbd>/<kbd>Cmd</kbd>+<kbd>↑</kbd>/<kbd>↓</kbd> 不进漫游、直接取回;它在两端**夹取停住**而不环绕,且你发出一条消息后位置重置回草稿位,所以第一次 <kbd>Ctrl</kbd>+<kbd>↑</kbd> 总是从你当下的位置起算。漫游则保留自己的游标,并在两端环绕。
100
+ - **智能跟随默认关**:滚动会话或点导轨都不会移动任何一个游标。想让漫游从你最后看的位置起算,在设置里打开它。
101
+
102
+ ![历史漫游](assets/screenshots/history-roam.png)
103
+
104
+ *按 <kbd>Esc</kbd> 后输入框上方的读数:`历史 第 0 / 1 轮 · 当前草稿` —— 停在你自己的草稿位,本会话共 1 轮,粒度为「轮」;按 <kbd>↑</kbd> 才走到那一轮。*
105
+
90
106
  ## 注入语义
91
107
 
92
108
  每次 agent 开始处理前,插件会校验草稿中的每个引用,并追加一条**只含引用信息、不含文件内容**的消息。文件内容始终由 agent 使用当前会话的工具按需读取。
@@ -209,6 +225,10 @@ const provider: AtlasProvider = {
209
225
  | 候选数量上限 | 50 | 每次请求返回的候选条目上限(1–200) |
210
226
  | 忽略粘贴文本中的 @ | 开 | 从其他应用粘贴的 `@内容` 保持普通文本,不触发引用 |
211
227
  | 文件过滤 | — | 全局与工作区两套规则;每条可选 Exact / Regex 与是否区分大小写 |
228
+ | 启用历史跳转 | 开 | <kbd>Esc</kbd> 与检索面板的总开关;关闭后所有键交回输入框 |
229
+ | 历史粒度 | 每轮对话 | 一轮一格(与右侧导轨同尺),或每条消息一格 —— 提问与每条回答分开停 |
230
+ | 取回方式 | 覆盖 | 取回某一格时覆盖草稿,还是追加到草稿末尾 |
231
+ | 智能跟随 | 关 | 让漫游游标从会话最后滚动到的位置(或最后点的导轨刻度)起算 |
212
232
 
213
233
  ![文件提及设置](assets/screenshots/file-mention-settings.png)
214
234
 
@@ -283,6 +303,12 @@ pnpm run verify:publish # 单独运行发布面门禁
283
303
  DSH 源码检出,CI 里没有)。若要手动发布:`npm publish --registry https://registry.npmjs.org`
284
304
  (镜像如 `registry.npmmirror.com` 不能接收发布)。
285
305
 
306
+ ## 如果它替代了你原本在用的东西
307
+
308
+ `dsh-at-file` 在 Harness 0.2.x 上已经加载不起来了,这个插件把它的文件索引接到了当前 API 上。如果你是因为这个来的,有一件事比提 issue 更有用:**一个 star**。插件市场的排序看它,而一个 0 star 的项目在别人眼里就是「没人维护」——不管它实际上有没有,这对一个主打「路径靠谱」的插件来说是很糟的第一印象。
309
+
310
+ → [给个 star](https://github.com/jameswatt139240-crypto/dsh-ATLAS) · [报个 bug](https://github.com/jameswatt139240-crypto/dsh-ATLAS/issues)
311
+
286
312
  ## 兼容性
287
313
 
288
314
  插件同时兼容两代 Harness 的 Typert codec 校验(安装版校验 `codec.schema.parse`,源码检出校验 `codec.create()`),并在运行时通过 `ctx.remote.session.openWorkspacePath` 打开引用路径。
package/dsh.plugin.json CHANGED
@@ -1,7 +1,7 @@
1
1
  {
2
2
  "name": "@sidequest-007/dsh-atlas",
3
- "description": "AT Last, All Sources. One @ . Jump anywhere.",
4
- "version": "1.0.9",
3
+ "description": "AT Last, All Sources. One @ to jump anywhere — line ranges like @src/a.ts:12-40, the token cost of each reference before you send, and Esc to walk the session back.",
4
+ "version": "1.0.11",
5
5
  "entry": {
6
6
  "name": "@sidequest-007/dsh-atlas",
7
7
  "inject": []