@dsh-external/dsh-asset-manager

Readme

# @dsh-external/dsh-asset-manager — DSH-Omni 系统总览与组件管理中心

把 DSH 的全部组件装进一个「指挥室」：插件 / 技能 / 预设 / 规范（spec），
真实数据扫描，统一 `DSHComponent` 数据模型，白色主题 + 青色强调。

## 安装

```bash
# 方式一：插件市场（设置 → 插件市场）搜索 dsh-asset-manager 一键安装
# 方式二：命令行（GitHub 源）
dsh plugin --profile web add github:butingxz/dsh-asset-manager
```

## 入口（双入口）

1. **会话视图页签「🧩 系统总览」**（`conversation.view`）：全屏左树导航 + 右侧卡片表格
2. **会话头部右侧 🧩 按钮**（`conversation.session.header.utilities`）：直达大面板

## 功能

- 4 张统计卡：总数 / 启用中 / 已停用 / 可更新
- 分类树 + 状态筛选 + 名称/描述模糊搜索（筛选状态跨页签存活，模块级 store）
- 滑动开关启用/停用；本地路径缩略 + 一键复制（Toast）
- 行内展开详情：直白介绍 / 用法示例（黑箱说明书）/ 来源链（仓库链接）/ 位置与时间
- 删除二次确认：Modal 输入组件全名；删除前自动备份到 `workspace/.dsh-asset-backups`
- 内置组件保护（官方 `@deepseek-ai/*` 与系统规范）：删除按钮置灰 + 警告 + 服务端拒绝
- **版本更新检测**：真实查询 npmmirror 最新版本（带超时 + 10 分钟缓存），
  可更新项显示「⬆ 升级至 x.x.x」；升级执行由 AI 助手走「重建 → 热重载」完成（v1），
  面板内一键升级为 v2 待办
- 骨架屏加载、操作 Loading 防重复点击、Toast 错误兜底

## API

```
GET  /@dsh-external/dsh-asset-manager/api/assets            # 资产列表（含缓存更新信息）
POST /@dsh-external/dsh-asset-manager/api/refresh-updates   # 触发更新检测
POST /@dsh-external/dsh-asset-manager/api/disable | enable | delete
```

对话工具：`_dsh_external_dsh_asset_manager_status`（资产概况速览）。

## 构建与注入

```bash
bash scripts/build.sh              # tsc host + tsdown client
# 注入器环境内：
dev_inject_plugin <本目录>        # 首次注入 / 大改后重注入
dev_reload_package dsh-asset-manager   # 小改热重载（若报 duplicate route：先 dev_clear_routes /@dsh-external/dsh-asset-manager）
```

注意：client 改动需刷新浏览器页面生效（未开 dev:web 监听时）。