dsh-loadout 0.11.0 → 0.11.2

package/CHANGELOG.md

@@ -2,6 +2,17 @@
 
 「装备栏」是一个 DeepSeek Harness 插件：给每个对话选一套工具（套装），只把用得上的工具投给模型。
 
+## 0.11.2
+
+- README 的「预置套装」一节改写为**历史记录**的口径：明确它从 0.10.2 起就不在界面里，用户看到的是「全部 / 仅内置 / 我的套装」，而三套数据仍在 `cordis.patch.yml` 里、`/kit 写作|调研|编程` 仍可用；标题也改成「界面不展示，命令仍可用」。中英文同步。
+- 无代码改动：宿主、客户端、`cordis.patch.yml` 与 0.11.1 完全一致。
+
+## 0.11.1
+
+- README 与界面同步：功能表不再把**预置套装**当卖点（0.10.2 起界面已隐藏它），改成介绍**我的套装**——新建、设为默认、复制切换命令、编辑（覆盖保存 / 另存为新套装）、备注、删除；并补上 token 账本一行。
+- 安装段改成三种来源并列：npm（`dsh plugin add dsh-loadout`）、GitHub（`add github:JungleYXu/dsh-loadout`）、本地目录链接安装。中英文 README 同步。
+- 无行为变化，只是文档与 npm 首页对齐（npm 页面读的是发布包里的 README）。
+
 ## 0.11.0
 
 首个公开发布版本（npm + awesome-dsh-plugin）。

package/README.en.md

@@ -13,30 +13,32 @@ DeepSeek Harness exposes every tool to every conversation: the more plugins you
 | Capability | Behaviour |
 | --- | --- |
 | Three bases | `All` (no masking, default) / `Built-in only` / one of your kits |
+| Your kits | Tick built-in tools and plugins under "New kit" and save them as a named loadout. Each card can be set as default, copied as a switch command, edited (overwrite in place, or save as a new kit), annotated, and deleted |
 | Add-ons | Attach a plugin on top of the base for a one-off combination, without saving a kit |
-| Shipped presets | Writing / Research / Coding — read-only; editing saves a copy as your own kit |
 | Notes | Up to 20 characters per kit, shown as `Test 1（for video work）` in the menu |
+| Token ledger | The menu status line says `saves ~1.9k tokens`; Settings shows the full account (tools kept, tokens kept, tokens saved) |
 | Refresh | `⟳` in the menu re-reads the tool catalogue and re-applies the current selection |
 | Per conversation | A switch affects only the current conversation, starting with the next message; new conversations start from the default kit in Settings → Loadout |
 
 ## Install
 
-Let Harness install it, which creates a **link** instead of a copy:
+Three sources, same package:
 
-```text
-plugin_manager action=install_bundle target=<absolute path to this directory>
-```
+```bash
+# 1) npm (published)
+dsh plugin --profile desktop add dsh-loadout
 
-Or from the CLI:
+# 2) GitHub (same package, when the registry is unreachable)
+dsh plugin --profile desktop add github:JungleYXu/dsh-loadout
 
-```bash
+# 3) a local directory (development; installs a link, not a copy)
 dsh plugin --profile desktop add link:<absolute path to this directory>
 ```
 
-Or, once published to npm:
+Letting Harness install it is the same as the third form:
 
-```bash
-dsh plugin --profile desktop add dsh-loadout
+```text
+plugin_manager action=install_bundle target=<absolute path to this directory>
 ```
 
 Restart the app afterwards: host plugins have no hot reload, and the UI needs at least a refresh.
@@ -61,11 +63,11 @@ node scripts/client-smoke.mjs # browser bundle: menu and settings panel render
 
 Settings has no conversation of its own, so it only decides *where new conversations start* — use the header button to change the current one. In the default list, `All` / `Built-in only` and kits are the same kind of card: each can copy its switch command or be set as default. **My kits** starts collapsed and shows only the current default; open it to see the rest. A saved kit can be **edited** on its card: the form opens under that card, and you either overwrite it (conversations already using it switch immediately) or save as a new kit.
 
-### What the shipped presets contain
+### Shipped presets (not shown in the UI, still selectable by command)
 
-> Since 0.10.2 the UI does **not** show the presets (neither the header menu nor Settings). The three entries still live in `cordis.patch.yml` and `/kit writing` keeps working; they are kept for our own testing until they are clear enough to ship to users. The table documents them for review.
+> This section is a **historical record**, not a user-facing feature. Since 0.10.2 neither the header menu nor Settings shows the presets; what users see is `All` / `Built-in only` / `My kits`. The three entries still live in `cordis.patch.yml` and `/kit writing`, `/kit research`, `/kit coding` keep working — they are kept for our own testing until they are clear enough to put back in the UI. The table below is for review and troubleshooting.
 
-All three are read-only; an edit becomes a copy of your own. They list **built-in tools only** — plugin tools come in through add-ons or by saving your own kit.
+The presets are read-only; an edit can only become a copy of your own. They list **built-in tools only** — plugin tools come in through add-ons or by saving your own kit.
 
 | Preset | Built-in tools |
 | --- | --- |

package/README.md

@@ -13,26 +13,34 @@ DeepSeek Harness 的工具是全局可见的：插件装得越多，每个对话
 | 能力 | 说明 |
 | --- | --- |
 | 三档底座 | `全部`（不裁剪，默认）/ `仅内置`（只留 DSH 自带工具）/ `我的套装` |
+| 我的套装 | 「新建套装」里勾选内置工具与插件，存成一套带名字的装备。卡片上可以**设为默认**、**复制切换命令**、**编辑**（改完覆盖保存，或另存成新的一套）、**备注**、**删除** |
 | 加挂 | 在底座之上临时加挂插件，不必为一次性组合新建套装 |
-| 预置套装 | 写作 / 调研 / 编程，只读；改动会另存为你的套装 |
 | 备注 | 每个套装可加 20 字备注，菜单里显示成 `测试1（用于视频制作）` |
+| token 账本 | 菜单状态行 `省 ~1.9k tokens`，设置页给出「保留 N 个工具 · 约 X tokens · 省多少」的完整账目 |
 | 刷新 | 菜单右上 `⟳` 重拉工具目录并重套用当前选择 |
 | 每对话独立 | 切换只影响当前对话，下一条消息即按新清单组装；新对话用「设置 → 装备栏」的默认套装 |
 
 ## 安装
 
-推荐让 Harness 自己装（会创建**链接**，而不是拷贝）：
+三种来源，装的是一个东西：
 
-```text
-plugin_manager action=install_bundle target=<本目录绝对路径>
-```
+```bash
+# 1) npm（已发布，最短）
+dsh plugin --profile desktop add dsh-loadout
 
-或走 CLI：
+# 2) GitHub（npm 不可达时用同一个包）
+dsh plugin --profile desktop add github:JungleYXu/dsh-loadout
 
-```bash
+# 3) 本地目录（开发用，链接安装，不拷贝）
 dsh plugin --profile desktop add link:<本目录绝对路径>
 ```
 
+让 Harness 自己装也可以（等价于第 3 种）：
+
+```text
+plugin_manager action=install_bundle target=<本目录绝对路径>
+```
+
 装完重启应用：宿主插件没有热重载，界面至少刷新一次。
 
 ### 为什么不能复制文件
@@ -55,11 +63,11 @@ node scripts/client-smoke.mjs # 浏览器 bundle：菜单与设置页渲染
 
 设置页没有自己的对话，所以它只管「新对话从哪套开始」，不切换当前对话——当前对话请在标题栏里切。默认列表里「全部 / 仅内置」和套装是同一种卡片：都能「复制切换命令」或「设为默认」；「我的套装」默认折叠，只显示当前默认的那一个，点开才列出全部。已经保存的套装可以在卡片上「编辑」：改动就在那张卡片下面展开，「覆盖保存」（正在用它的对话立刻按新工具集走）或「另存为新套装」。
 
-### 预置套装里有什么
+### 预置套装（界面不展示，命令仍可用）
 
-> 0.10.2 起，**界面暂时不展示预置套装**（标题栏菜单和设置页都不出现）。三套数据仍在 `cordis.patch.yml` 里、`/kit 写作` 这类命令也照常可用，保留给自己测试；等它们对用户足够直观再放出来。下面表格记录它们的内容，方便核对。
+> 这一节是**历史记录**，不是面向用户的功能。从 0.10.2 起，标题栏菜单和设置页都不再出现预置套装，用户看到的就是「全部 / 仅内置 / 我的套装」。三套数据仍留在 `cordis.patch.yml` 里，`/kit 写作`、`/kit 调研`、`/kit 编程` 照常可用，保留给我们自己测试；等它们足够直观再放回界面。下面的内容用于核对和排障。
 
-三套都是只读的，改动会另存为你的套装。它们只列**内置工具**，插件工具要靠「加挂」或另存时勾选。
+预置套装是只读的，改动只能另存为你的套装。它们只列**内置工具**，插件工具要靠「加挂」或在另存时勾选。
 
 | 套装 | 内置工具 |
 | --- | --- |

package/icon.svg

@@ -1,4 +1,4 @@
-<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 64 64" role="img" aria-label="Tool Kits">
+<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 64 64" role="img" aria-label="Loadout">
   <rect x="7" y="9" width="50" height="13" rx="4" fill="none" stroke="currentColor" stroke-width="3.5"/>
   <rect x="7" y="26" width="50" height="13" rx="4" fill="none" stroke="currentColor" stroke-width="3.5" opacity="0.7"/>
   <rect x="7" y="43" width="32" height="12" rx="4" fill="currentColor" opacity="0.92"/>

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "dsh-loadout",
-  "version": "0.11.0",
+  "version": "0.11.2",
   "description": "Loadout for DeepSeek Harness: group tools into kits, keep only the current kit's tools visible in each conversation, and manage everything from a settings panel.",
   "type": "module",
   "main": "./index.js",

package/scripts/agent-lookup-probe.mjs

@@ -0,0 +1,24 @@
+/**
+ * Is there a host service that maps a session id to its live agent?
+ */
+import { readFileSync, readdirSync } from 'node:fs'
+
+const BASE = 'C:/Users/JungleYXu/AppData/Local/Programs/DeepSeek Harness/resources/app.asar/dsh/node_modules/@deepseek-ai'
+const packages = readdirSync(BASE)
+const pattern = /agentFor|bySession|sessionAgent|agentOf|resolveAgent/g
+
+for (const name of packages) {
+  if (!name.startsWith('dsh-')) continue
+  let text
+  try {
+    text = readFileSync(`${BASE}/${name}/lib/index.js`, 'utf8')
+  } catch {
+    continue
+  }
+  const hits = [...new Set([...text.matchAll(pattern)].map((m) => m[0]))]
+  if (hits.length === 0) continue
+  const index = text.search(pattern)
+  console.log(`\n### ${name} :: ${hits.join(', ')}`)
+  console.log(text.slice(Math.max(0, index - 200), index + 260).replace(/\s+/g, ' '))
+}
+

package/scripts/agent-probe.mjs

@@ -0,0 +1,25 @@
+/**
+ * How does host code get a session id from an agent object?
+ */
+import { readFileSync } from 'node:fs'
+
+const BASE = 'C:/Users/JungleYXu/AppData/Local/Programs/DeepSeek Harness/resources/app.asar/dsh/node_modules/@deepseek-ai'
+const files = [
+  'dsh-tools/lib/index.js',
+  'dsh-agent/lib/index.js',
+  'dsh-session/lib/index.js',
+  'dsh-subagent/lib/index.js',
+]
+
+for (const rel of files) {
+  let text
+  try {
+    text = readFileSync(`${BASE}/${rel}`, 'utf8')
+  } catch (error) {
+    console.log(`skip ${rel}: ${error.code}`)
+    continue
+  }
+  const hits = [...text.matchAll(/agent\.session[A-Za-z]*/g)].map((m) => m[0])
+  const unique = [...new Set(hits)]
+  console.log(`${rel} -> ${unique.join(', ') || '(none)'}`)
+}

package/scripts/attribution-probe.mjs

@@ -0,0 +1,91 @@
+/**
+ * Offline probe: does the package-name heuristic actually recover the plugins
+ * that own the host-registered tools? Prints the derived index and the mapping
+ * for a list of real tool names, so the heuristic can be checked before the app
+ * is restarted.
+ *
+ *   ELECTRON_RUN_AS_NODE=1 "DeepSeek Harness.exe" scripts/attribution-probe.mjs
+ */
+import { existsSync, readFileSync, readdirSync } from 'node:fs'
+import { homedir } from 'node:os'
+import { join } from 'node:path'
+
+const BUILTIN_PREFIXES = new Set([
+  'todo', 'web', 'kit', 'agent', 'work', 'read', 'write', 'edit', 'glob', 'grep',
+  'ask', 'present', 'skill', 'workflow', 'subagent', 'send', 'list', 'interrupt',
+  'job', 'schedule', 'create', 'get', 'update', 'exit', 'compress', 'decompress',
+  'search', 'load', 'working',
+])
+
+const NAME_NOISE = new Set([
+  'core', 'tools', 'tool', 'client', 'server', 'shared', 'common', 'plugin', 'plugins',
+  'dsh', 'ui', 'web', 'harness', 'extension', 'preset', 'settings', 'sidebar', 'runtime',
+])
+
+const SELF = 'dsh-loadout'
+
+const REAL_GLOBAL_TOOLS = [
+  'kit_list', 'kit_apply', 'kit_create', 'kit_set_tools', 'kit_set_default', 'kit_delete',
+  'modlens_read_image',
+  'weknora_list_knowledge_bases', 'weknora_search', 'weknora_read_document', 'weknora_ask',
+  'hindsight_sync_status', 'hindsight_diagnose', 'hindsight_search_knowledge_pages',
+  'hindsight_list_knowledge_pages', 'hindsight_read_knowledge_page', 'hindsight_reflect',
+  'hindsight_capture_initiative', 'hindsight_ingest_document',
+  'working_directory',
+  'vision_describe', 'vision_bootstrap', 'vision_materialize', 'vision_ground', 'vision_detect',
+  'vision_crop', 'vision_present', 'vision_pixel_diff', 'vision_colors', 'vision_ocr',
+  'vision_long_screenshot_ocr', 'vision_trace', 'vision_extract_foreground', 'vision_html_screenshot',
+  'list_mcp_resources', 'list_mcp_resource_templates', 'read_mcp_resource',
+  'compress', 'decompress', 'search_context',
+  'acp_status', 'acp_cache', 'acp_read_original_image',
+  'load_workspace_dependencies',
+]
+
+function profilePackages() {
+  const root = join(homedir(), '.dsh', 'profiles')
+  const names = new Set()
+  for (const entry of readdirSync(root)) {
+    const file = join(root, entry, 'package.json')
+    if (!existsSync(file)) continue
+    const parsed = JSON.parse(readFileSync(file, 'utf8'))
+    for (const name of Object.keys(parsed.dependencies ?? {})) names.add(name)
+    for (const bundle of parsed?.dsh?.profile?.bundles ?? []) if (typeof bundle === 'string') names.add(bundle)
+  }
+  return [...names]
+}
+
+function buildIndex(packages) {
+  const index = new Map()
+  for (const packageName of packages) {
+    const base = packageName.replace(/^@[^/]+\//, '')
+    if (base === SELF) continue
+    const stripped = base.replace(/^dsh-/, '').replace(/^plugin-/, '')
+    const tokens = [stripped, ...stripped.split('-')]
+      .map((token) => token.toLowerCase())
+      .filter((token) => token.length >= 3 && !NAME_NOISE.has(token) && !BUILTIN_PREFIXES.has(token))
+    for (const token of tokens) if (!index.has(token)) index.set(token, { id: token, title: stripped, packageName: base })
+  }
+  return index
+}
+
+const packages = profilePackages()
+const index = buildIndex(packages)
+console.log(`profile packages: ${packages.length}`)
+console.log(`tokens: ${[...index.keys()].sort().join(', ')}`)
+console.log('')
+const grouped = new Map()
+const orphan = []
+for (const toolName of REAL_GLOBAL_TOOLS) {
+  const cut = toolName.indexOf('_')
+  const prefix = cut > 0 ? toolName.slice(0, cut).toLowerCase() : ''
+  const owner = prefix === '' || BUILTIN_PREFIXES.has(prefix) ? undefined : index.get(prefix)
+  if (owner === undefined) { orphan.push(toolName); continue }
+  if (!grouped.has(owner.title)) grouped.set(owner.title, [])
+  grouped.get(owner.title).push(toolName)
+}
+for (const [title, tools] of [...grouped.entries()].sort()) {
+  console.log(`${title}  (${tools.length})`)
+  console.log(`   ${tools.join(', ')}`)
+}
+console.log('')
+console.log(`built-in / unattributed (${orphan.length}): ${orphan.join(', ')}`)

package/scripts/cmd-probe.mjs

@@ -0,0 +1,30 @@
+/**
+ * What can a client plugin do with the command system, and how is a session id
+ * exposed to a session-scoped slot?
+ */
+import { readFileSync } from 'node:fs'
+
+const BASE = 'C:/Users/JungleYXu/AppData/Local/Programs/DeepSeek Harness/resources/app.asar/dsh/node_modules/@deepseek-ai'
+
+function show(rel, pattern, width = 260, limit = 6) {
+  let text
+  try {
+    text = readFileSync(`${BASE}/${rel}`, 'utf8')
+  } catch (error) {
+    console.log(`skip ${rel}: ${error.code}`)
+    return
+  }
+  console.log(`\n##### ${rel}`)
+  let index = text.search(pattern)
+  let shown = 0
+  while (index !== -1 && shown < limit) {
+    console.log('...' + text.slice(Math.max(0, index - 80), index + width).replace(/\s+/g, ' '))
+    index = text.slice(index + 1).search(pattern)
+    if (index !== -1) index += 1
+    shown += 1
+  }
+}
+
+show('dsh-client-ui-commands/lib/client.js', /submitCommand|runCommand|executeCommand/)
+show('dsh-client-commands/lib/index.js', /^\s*(run|execute|dispatch|submit)\(|exports\.(run|execute|dispatch|submit)/, 200, 8)
+show('dsh-client-ui-conversation/lib/client.js', /inject: \(sessionId\) =>/, 700, 2)

package/scripts/dock-probe.mjs

@@ -0,0 +1,53 @@
+/**
+ * Look at how the shipped bundles use the composer-area slots, so the kit bar
+ * can plug into a real surface with real props.
+ */
+import { readFileSync, readdirSync } from 'node:fs'
+
+const BASE = 'C:/Users/JungleYXu/AppData/Local/Programs/DeepSeek Harness/resources/app.asar/dsh/node_modules/@deepseek-ai'
+
+function files(pkg) {
+  const out = []
+  const walk = (dir, depth) => {
+    if (depth > 3) return
+    let names = []
+    try {
+      names = readdirSync(dir)
+    } catch {
+      return
+    }
+    for (const name of names) {
+      if (name === 'node_modules') continue
+      const full = `${dir}/${name}`
+      if (name.endsWith('.js') || name.endsWith('.d.ts')) out.push(full)
+      else if (!name.includes('.')) walk(full, depth + 1)
+    }
+  }
+  walk(`${BASE}/${pkg}`, 0)
+  return out
+}
+
+const targets = ['composer.dock', 'conversation.composer', 'session.header.utilities', 'shell.overlay']
+const pkgs = readdirSync(BASE).filter((n) => n.startsWith('dsh-client-ui'))
+
+for (const pkg of pkgs) {
+  for (const file of files(pkg)) {
+    let text
+    try {
+      text = readFileSync(file, 'utf8')
+    } catch {
+      continue
+    }
+    for (const target of targets) {
+      let index = text.indexOf(target)
+      let shown = 0
+      while (index !== -1 && shown < 2) {
+        const start = Math.max(0, index - 320)
+        console.log(`\n=== ${pkg}/${file.split('/').slice(-2).join('/')} :: ${target}`)
+        console.log(text.slice(start, index + 320).replace(/\s+/g, ' '))
+        index = text.indexOf(target, index + 1)
+        shown += 1
+      }
+    }
+  }
+}

package/scripts/slots-probe.mjs

@@ -0,0 +1,59 @@
+/**
+ * Find real slot names in the shipped client bundles.
+ * Electron's fs is asar-aware, so archive-internal paths start with '/'.
+ */
+import { readFileSync, readdirSync, statSync } from 'node:fs'
+
+const ROOT = '/dsh/node_modules/@deepseek-ai'
+const found = new Map()
+
+function safeReaddir(dir) {
+  try {
+    return readdirSync(dir, { withFileTypes: false })
+  } catch {
+    try {
+      return readdirSync(dir)
+    } catch {
+      return []
+    }
+  }
+}
+
+const packages = safeReaddir(ROOT).filter((name) => name.startsWith('dsh-client-ui') || name.startsWith('dsh-client-'))
+console.log(`packages: ${packages.length}`)
+
+const pattern = /["']((?:shell|conversation|settings|sidebar|composer|workspace|agent|home|chat|message|session)\.[a-zA-Z.]+)["']/g
+
+function scan(dir, depth) {
+  if (depth > 3) return
+  for (const entry of safeReaddir(dir)) {
+    const full = `${dir}/${entry}`
+    let isDir = false
+    try {
+      isDir = statSync(full).isDirectory()
+    } catch {
+      continue
+    }
+    if (isDir) {
+      if (entry === 'node_modules') continue
+      scan(full, depth + 1)
+      continue
+    }
+    if (!entry.endsWith('.js')) continue
+    let text
+    try {
+      text = readFileSync(full, 'utf8')
+    } catch {
+      continue
+    }
+    for (const match of text.matchAll(pattern)) {
+      const slot = match[1]
+      if (slot.split('.').length < 2) continue
+      found.set(slot, (found.get(slot) ?? 0) + 1)
+    }
+  }
+}
+
+for (const name of packages) scan(`${ROOT}/${name}`, 0)
+
+for (const [slot, count] of [...found.entries()].sort()) console.log(`${slot}\t${count}`)