kid-process

@kidlab/dsh-kid-process · 工人点名（进程小工人）

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

给小朋友讲「电脑里现在有多少小工人在干活」的插件：一个包 = 一张卡片 + 四个工具，零第三方依赖、无构建步骤，装完即用。 它是 kid-coder / kid-sysmon / kid-network / kid-storage / kid-memory / kid-security 之后的第 7 个，也是最后一个从 0.1 动态创作形态搬过来的。

把进程讲成在**工作台（内存）**上干活的小工人：

• 🐝 卡片：常驻在输入条上方，折叠时一行「N 个工人在册 · M 个在卖力 + 等级」，点开是点名板 / 最卖力榜 / 家族 / 僵尸名单。 全部 免 sudo、只读，每 15 秒点一次名（服务端另有 5 秒缓存，连点不会反复敲 ps）。
• 🔧 四个模型工具：proc_count / proc_busiest / proc_family / proc_badge，模型可以直接喊出来查。 这四个的文本、命令、判定与 0.1 版逐字一致（node verify-legacy-equivalence.mjs 逐条核对），只有注册方式变了。

卡片长这样（折叠 / 展开，数字是本机实测的示意）：

┌──────────────────────────────────────────────────────────────┐
│ 🐝 工人点名     511 个工人在册 · 21 个在卖力   🙂 有几个僵尸 ▾ │
└──────────────────────────────────────────────────────────────┘

┌──────────────────────────────────────────────────────────────┐
│ 🐝 工人点名     511 个工人在册 · 21 个在卖力   🙂 有几个僵尸 ▴ │
│  点名板                                                       │
│     21              487               3                       │
│   在卖力干活      在打盹等活儿      赖着不走的僵尸             │
│  ▓▓▓▓ 21 在卖力 ▓▓▓▓▓▓▓▓▓▓▓▓ 487 在打盹 ▓ 3 僵尸             │
│  最卖力榜                                                     │
│  Google Chrome  ×12  ▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓  51.5%   │
│  node                ▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓            41.9%   │
│  家族                                                         │
│  总管 launchd（工号 1）带了 435 个直接徒弟                     │
│  🧟 赖着不走的小工人（活干完了，工牌还没被收走）3 个            │
│  🐝 进程 = 在这台电脑上干活的小工人 ｜ 每 15 秒点一次名 ｜ 22:31 │
└──────────────────────────────────────────────────────────────┘

等级看的是车间秩序（僵尸越多越该收工牌）：

安装

# 推荐：GUI「插件管理」页的安装框里直接粘贴包目录路径
/Users/baixiao/Code/deepseek-harness-dev/plugin-kid-process

# 或者在 DSH 会话里让模型执行（等价的同一件事）
plugin_manager install_bundle /Users/baixiao/Code/deepseek-harness-dev/plugin-kid-process

• 工具半部（index.js / tools.js / collect.js）：装完返回 applied 就立即生效，不用重启。
• 卡片半部（client.js）：装完先刷新页面看 🐝 在不在——安装一般会顺带把模块表增量重算并推下去，刷新就够； 万一刷新后还是没有，再重启 dsh web（重启后刷新即可，不用重装）。
  • 重启请在普通终端里跑。在 DSH 会话内拉起的进程会继承会话的文件沙箱（setsid / nohup 也甩不掉）， 新起的 dsh web 会以 EPERM: operation not permitted, open '~/.dsh/profiles/web/cordis.yml' 直接退出， 结果旧服务已停、新服务没起来（经过见迁移指南 14.9「新量到 3」）。
  • 只改 client.js 的话不用重启，刷新页面即可；改 index.js 才需要重启。

配置

在用户层（~/.dsh/cordis.patch.yml）按 id 覆盖这一行——不要再写一行 insert（同 id 的 insert 行不能共存）：

- id: kid-process
  config:
    enabled: true      # false = 只关掉四个模型工具，卡片照旧
    timeoutMs: 8000    # 单条命令超时，1000–30000

timeoutMs 不合法（非数字）时回落到默认 8000。

和旧版（0.1 动态创作）的差异

0.1 版只有工具，没有卡片；这一版把卡片补上，并且把装载方式从「workspace 注册 + 根 tsc 编译 + ~/.dsh/profiles/node_modules 软链 + 用户层 patch 的 insert 行」 换成 web profile 里的静态 bundle（一个 install_bundle 就位）：

tools.js 刻意不和 collect.js 共用一个取数层：tools.js 要保持「一个字没动」，而卡片的命令重新挑过（每条多带一个 pid，这样卡片上的名字能对上工具里的工号）。

只想在某个会话显示卡片

client.js 顶部有一行白名单（当前为空 = 每个会话都显示）：

const ONLY_SESSIONS = []

• 想只在某些会话显示 → 把会话 id 填进去；echo $DSH_SESSION_ID 可以拿到当前会话 id。
• 想恢复每个会话都显示 → 留空 const ONLY_SESSIONS = []（空数组 = 不限会话）。

白名单外的会话直接渲染 null：卡片不出现，轮询也不会启动（不白花算力）。

自检

node verify.mjs                      # 端到端自检（112 项）：解析 / 真机采集 / 路由 / 卡片装载 / 渲染 / 四个工具
node verify-legacy-equivalence.mjs   # 与旧版 legacy/src/tools.ts 的文本级等价对照

两个都 EXIT=0 才算好。verify.mjs 不依赖浏览器，也不依赖本机此刻的进程表（点名、榜单、家族、等级都用注入的假文本测）。

⚠️ 一个环境坑：本 checkout 的 bash 沙箱会拦 /bin/ps（Operation not permitted）， 所以 verify.mjs 会先探一次 ps 能不能用，不能用时把真机断言自动降级成「形状 + 降级文案」核对 （插件在 dsh 进程里跑，不受这个沙箱限制）。同理，本 checkout 里 tsc 跑这些插件会 segfault（exit 139，环境问题），所以用 node --check + 上面两个脚本。

发布

private: true 是为了本机 link: 安装。真要发 npm：去掉 private、npm version 提版本、npm publish --access public。 legacy/ 已经在 files 白名单之外，不会被发出去。

目录