kid-storage

@kidlab/dsh-kid-storage · 仓库大管家

📦 npm：@kidlab/dsh-kid-storage　·　安装：dsh plugin --profile web add @kidlab/dsh-kid-storage（或 npm i @kidlab/dsh-kid-storage）

给小朋友的存储启蒙插件（DeepSeek Harness / Cordis bundle）。一个包 = 一张卡片 + 三个工具， 零第三方依赖、无构建步骤，装完即用。

• 🐿️ 卡片：常驻输入条上方，把硬盘讲成「大仓库 / 大行李箱」；真磁盘分区、还挂着的安装包映像、 主目录各文件夹谁最占地方，都会画成横条。点击标题折叠/展开。
• 🔧 模型工具：storage_boxes（分区全景）、storage_home（主目录谁最占地方）、 storage_heavy（最重的几件大行李）。免 sudo、只扫用户目录、单命令超时容错。

┌──────────────────────────────────────────────┐
│ 🐿️ 仓库大管家   系统盘 Data 总 121G 剩 8.4G ▾ │
│  系统盘 Data  ████████████████████████ 92%   │
│  ~/Downloads  ██████ 759 MB                  │
└──────────────────────────────────────────────┘

安装

# 在本机 profile 里安装（发布后也可以用 npm 包名）
plugin_manager install_bundle /绝对路径/plugin-kid-storage

装完后：host half 需要重启 dsh web 生效；client half 只需刷新页面。 cordis.patch.yml 会往 profile 里插一行 kid-storage。

配置

要改默认值，在用户层补丁（~/.dsh/cordis.patch.yml）里按 id 覆盖，别改包里的补丁：

- id: kid-storage
  config: { timeoutMs: 12000 }

和旧版两个包的差异

合并前是两个包、同时挂着：@kidlab/dsh-kid-storage（TypeScript 源码 + defineTool，只给三个工具） 和 @kidlab/dsh-kid-storage-card（只给路由 + 🐿️ 卡片）。现在合成这一个包，模型侧与卡片侧的行为都对齐， 只有三处刻意的差别：

路由（/kid-storage/collect）原先由卡片包注册，现在归 index.js，两个包不会再抢同一个路由和同一个 dock 槽位 id（kid-storage，order 8）。

只想在某个会话显示卡片

卡片模块是进程级装载的（每个会话的页面都会装入），所以「只在某个会话显示」由组件里的 会话判断实现，不靠装载层面。改 client.js 顶部的白名单：

// 留空 [] = 每个会话都显示（当前就是这个）；填会话 id = 只在那些会话显示
const ONLY_SESSIONS = []

当前会话 id：终端执行 echo $DSH_SESSION_ID。

自检

node verify.mjs                      # 真机采集 + 路由 + 客户端渲染 + 三个工具，全绿才退出 0
node verify-legacy-equivalence.mjs   # 逐字对照旧版 TS 源码，确认只是换了注册方式

从两个包换成一个包（本机已做过的切换顺序）

1. 用户层补丁里删掉老的那一行 insert: [{ id: kid-storage, name: '@kidlab/dsh-kid-storage' }] （否则和包补丁里的同名 insert 撞车）；
2. plugin_manager remove_bundle @kidlab/dsh-kid-storage-card（先撤掉卡片包，避免两个客户端模块抢同一个 dock id）；
3. plugin_manager install_bundle /绝对路径/plugin-kid-storage；
4. 重启 dsh web（host half 变了），再刷新页面（client half 变了）。

中间那几步 GUI 会短暂缺卡片，重启+刷新后恢复；切换期间别刷新页面。

发布

1. 删掉 package.json 里的 "private": true；
2. 改 version；
3. npm publish --access public（scoped 包要带 --access public）。

包名、目录名、files 白名单都已就绪（node_modules/、legacy/ 不会被发布）。

目录