@sidequest-007/dsh-atlas 1.0.10 → 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 +20 -0
- package/README.md +9 -5
- package/README.zh.md +9 -5
- package/dsh.plugin.json +2 -2
- package/lib/client.js +12 -4
- package/package.json +2 -2
package/CHANGELOG.md
CHANGED
|
@@ -1,5 +1,25 @@
|
|
|
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
|
+
|
|
3
23
|
## [1.0.10] - 2026-10-28
|
|
4
24
|
|
|
5
25
|
### Changed
|
package/README.md
CHANGED
|
@@ -2,8 +2,6 @@
|
|
|
2
2
|
|
|
3
3
|
**English** · [简体中文](README.zh.md)
|
|
4
4
|
|
|
5
|
-
Beyond the **built-in `@`**: line ranges like `@src/a.ts:12-40`, skills, plugins and any git repo as source groups — with the approximate token cost of each reference shown before you send.
|
|
6
|
-
|
|
7
5
|
A **Side Quest** project (工作室:支线任务, **Side Quest Labs**) — npm scope `@sidequest-007/*`, repository [`jameswatt139240-crypto/dsh-ATLAS`](https://github.com/jameswatt139240-crypto/dsh-ATLAS); the DSH plugin id keeps the ecosystem's unscoped `dsh-*` form.
|
|
8
6
|
|
|
9
7
|
<img src="assets/diagrams/atlas-overview.svg" alt="dsh-ATLAS: one @ trigger, five built-in categories plus the bundled git category, and a category any plugin can register" width="880">
|
|
@@ -26,7 +24,7 @@ Unified `@` mentions for the DeepSeek Harness web GUI: type `@` in the composer
|
|
|
26
24
|
|
|
27
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.
|
|
28
26
|
|
|
29
|
-
> `dsh-
|
|
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.
|
|
30
28
|
|
|
31
29
|
## Install
|
|
32
30
|
|
|
@@ -40,8 +38,8 @@ dsh plugin --profile web add github:jameswatt139240-crypto/dsh-ATLAS
|
|
|
40
38
|
git clone https://github.com/jameswatt139240-crypto/dsh-ATLAS
|
|
41
39
|
dsh plugin --profile web add link:/path/to/dsh-ATLAS
|
|
42
40
|
|
|
43
|
-
# npm (published; `
|
|
44
|
-
dsh plugin --profile web add @sidequest-007/dsh-atlas
|
|
41
|
+
# npm (published; `latest` is the current release)
|
|
42
|
+
dsh plugin --profile web add @sidequest-007/dsh-atlas
|
|
45
43
|
```
|
|
46
44
|
|
|
47
45
|
Restart `dsh web` after installing or updating so the Host and the browser client load the same version. Then type `@` in the composer.
|
|
@@ -313,6 +311,12 @@ pnpm run verify:publish # publish-surface gate on its own
|
|
|
313
311
|
run `npm publish --registry https://registry.npmjs.org` (a mirror such as
|
|
314
312
|
`registry.npmmirror.com` cannot accept a publish).
|
|
315
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
|
+
|
|
316
320
|
## Compatibility
|
|
317
321
|
|
|
318
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
|
@@ -2,8 +2,6 @@
|
|
|
2
2
|
|
|
3
3
|
[English](README.md) · **简体中文**
|
|
4
4
|
|
|
5
|
-
在**内置 `@`** 之上:行区间如 `@src/a.ts:12-40`、Skill、插件与任意 git 仓库作为可选来源,并在发送前显示每条引用要花多少 token。
|
|
6
|
-
|
|
7
5
|
本项目属于 **Side Quest(支线任务)** 工作室(**Side Quest Labs**)—— npm 范围 `@sidequest-007/*`,仓库 [`jameswatt139240-crypto/dsh-ATLAS`](https://github.com/jameswatt139240-crypto/dsh-ATLAS);**DSH 插件 id 沿用生态惯例的无 scope 形式 `dsh-*`**。
|
|
8
6
|
|
|
9
7
|
<img src="assets/diagrams/atlas-overview.svg" alt="dsh-ATLAS:一个 @ 触发位、五个内置类别加内置的 git 类别,以及任何插件都能注册的自己的类别" width="880">
|
|
@@ -26,7 +24,7 @@ DeepSeek Harness Web 界面的**统一 `@` 提及**插件:在输入框输入 `
|
|
|
26
24
|
|
|
27
25
|
它基于 [`dsh-at-file`](https://github.com/FSMargoo/dsh-at-file)(MIT)扩展而来:保留原有的工作区路径索引、文件过滤规则与粘贴保护,并新增四个类别、类别菜单与快捷键、混合结果、分组折叠,以及三个模型侧查询工具。
|
|
28
26
|
|
|
29
|
-
> `dsh-
|
|
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 上——工作区路径索引、过滤规则、粘贴保护都还在,再加上前面那些类别。二者占用同一个触发位,装一个。
|
|
30
28
|
|
|
31
29
|
## 安装
|
|
32
30
|
|
|
@@ -40,8 +38,8 @@ dsh plugin --profile web add github:jameswatt139240-crypto/dsh-ATLAS
|
|
|
40
38
|
git clone https://github.com/jameswatt139240-crypto/dsh-ATLAS
|
|
41
39
|
dsh plugin --profile web add link:/path/to/dsh-ATLAS
|
|
42
40
|
|
|
43
|
-
# npm 包(已发布;`
|
|
44
|
-
dsh plugin --profile web add @sidequest-007/dsh-atlas
|
|
41
|
+
# npm 包(已发布;`latest` 即当前版本)
|
|
42
|
+
dsh plugin --profile web add @sidequest-007/dsh-atlas
|
|
45
43
|
```
|
|
46
44
|
|
|
47
45
|
安装或更新后**重启 `dsh web`**,确保 Host 与浏览器客户端都加载同一版本。然后在输入框打 `@`。
|
|
@@ -305,6 +303,12 @@ pnpm run verify:publish # 单独运行发布面门禁
|
|
|
305
303
|
DSH 源码检出,CI 里没有)。若要手动发布:`npm publish --registry https://registry.npmjs.org`
|
|
306
304
|
(镜像如 `registry.npmmirror.com` 不能接收发布)。
|
|
307
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
|
+
|
|
308
312
|
## 兼容性
|
|
309
313
|
|
|
310
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 @ to jump anywhere
|
|
4
|
-
"version": "1.0.
|
|
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": []
|
package/lib/client.js
CHANGED
|
@@ -22408,10 +22408,18 @@ function lineRangeLabel(lines) {
|
|
|
22408
22408
|
// src/client/FilesDock.tsx
|
|
22409
22409
|
var import_jsx_runtime2 = require("react/jsx-runtime");
|
|
22410
22410
|
var BYTES_PER_TOKEN = 4;
|
|
22411
|
+
var TOKENS_PER_LINE = 12;
|
|
22411
22412
|
var COST_WARN_TOKENS = 8e3;
|
|
22412
|
-
function referenceCost(info) {
|
|
22413
|
-
if (info === void 0 || !info.exists || info.kind !== "file"
|
|
22414
|
-
const
|
|
22413
|
+
function referenceCost(info, lines) {
|
|
22414
|
+
if (info === void 0 || !info.exists || info.kind !== "file") return void 0;
|
|
22415
|
+
const whole = info.size === void 0 ? void 0 : Math.ceil(info.size / BYTES_PER_TOKEN);
|
|
22416
|
+
if (lines === void 0) {
|
|
22417
|
+
if (whole === void 0) return void 0;
|
|
22418
|
+
return { tokens: whole, warn: whole > COST_WARN_TOKENS };
|
|
22419
|
+
}
|
|
22420
|
+
const count = lines.end - lines.start + 1;
|
|
22421
|
+
const estimate = count * TOKENS_PER_LINE;
|
|
22422
|
+
const tokens = whole === void 0 ? estimate : Math.min(whole, estimate);
|
|
22415
22423
|
return { tokens, warn: tokens > COST_WARN_TOKENS };
|
|
22416
22424
|
}
|
|
22417
22425
|
function formatTokenCount(tokens) {
|
|
@@ -22510,7 +22518,7 @@ function FilesDock({ input: input2, inputActions, onOpen, requestInspect, useSco
|
|
|
22510
22518
|
if (mentions.length === 0) return null;
|
|
22511
22519
|
return /* @__PURE__ */ (0, import_jsx_runtime2.jsx)("div", { className: "dsh_atFile_rail", role: "group", "aria-label": t("dock.aria"), "data-atlas-dock": true, children: mentions.map((mention) => {
|
|
22512
22520
|
const info = infoByRelative.get(referenceKey(mention.relative ?? ""));
|
|
22513
|
-
const cost = referenceCost(info);
|
|
22521
|
+
const cost = referenceCost(info, mention.lines);
|
|
22514
22522
|
const missing = info !== void 0 && !info.exists;
|
|
22515
22523
|
const directory = mention.kind === "dir" || info?.kind === "dir";
|
|
22516
22524
|
const link = mention.link !== void 0 && directory && mention.link.kind === "file" ? { kind: "folder", path: mention.link.path } : mention.link;
|
package/package.json
CHANGED
|
@@ -1,7 +1,7 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "@sidequest-007/dsh-atlas",
|
|
3
|
-
"description": "AT Last, All Sources. One @ to jump anywhere
|
|
4
|
-
"version": "1.0.
|
|
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
|
"license": "MIT",
|
|
6
6
|
"author": "Side Quest Labs",
|
|
7
7
|
"publishConfig": {
|