家族卡片渲染 121212165/dsh-plugin-family-cards

dsh-plugin-family-cards

给家族 11 个工具的 web UI 工具卡片渲染器 —— 官方内置 Web Client 不消费 presentCall/presentResult（adding-a-tool cookbook 原话），本插件按工具名在 tool.call.toolview slot 注册渲染器补上这一层

60 秒上手：dsh plugin --profile web add github:121212165/dsh-plugin-family-cards → 重启 dsh → 在 web 里让模型调用任一家族工具，看到统一格式的卡片

🧩 dsh 插件家族（22 件）：总目录 dsh-plugin-family ｜ 明星插件：ide-hub 跨 IDE 统一管理 · task-forge 跨窗口无损交接 · quota 实时用量仪表

它做什么

dsh 的工具卡片有官方 presentation hooks（presentCall/presentResult），但内置 Web Client 不消费它们——Client 插件要在 tool.call.toolview slot 按工具名注册渲染器。本插件就是这个渲染器：

- 覆盖 11 个家族工具：quota_meter / pin_add / fact_search / fact_find / ledger_query / cache_status / quota_check / session_search / deep_scan / eco_scan / forge_write；
- 每张卡：标题 + 状态（running / ok / error）+ 参数预览 + 可滚动结果文本；
- 样式只用 --dsw-alias-* tokens，不 require 任何 client 包。

结构

- client.js：ModuleLoader，ctx.slots.inject("tool.call.toolview", ...) 按工具名 keyed 注册；
- host 侧 apply() 为空（纯 Client 插件），manifest 声明 dsh.client {platform: web, immediately: true}。

借鉴来源与差异（不盲目抄）

| 来源 | 借鉴 | 我们的差异 |
| dsh-client-ui-cordis（官方 client 内置渲染器，lib/client.js 1441-1490 行） | tool.call.toolview keyed slot 注册模式与组件收到的 block 片段契约 | 官方渲染器只覆盖自家工具；我们把同机制变成家族工具的统一卡片层 |

验证状态

挂载进 web profile 后工具卡片渲染待人工目验（需要真实 web 会话触发工具调用）。host 侧零逻辑，风险面在 client 渲染层。

License

MIT