在 DSH 系统中,插件、技能、预设和规范是分散的实体。管理它们通常需要频繁切换上下文。dsh-asset-manager 插件提供了一个集中视图,将所有这些资产收集到一个面板中。它统一了 DSHComponent 数据模型,扫描真实数据,并提供了一套管理生命周期(启用/停用/删除)的功能,同时内置了安全机制。
安装¶
使用命令行安装插件:
dsh plugin --profile web add github:butingxz/dsh-asset-manager
入口¶
插件提供两个访问入口:
- 会话视图页签「系统总览」:左侧树形导航 + 右侧卡片表格。
- 会话头部右侧按钮:直达主面板。
核心功能¶
- 资产概览:提供 4 张统计卡,分别显示总数、启用中、已停用和可更新数量。
- 资产浏览:支持分类树导航、状态筛选以及名称/描述的模糊搜索。
- 组件操作:使用滑动开关启用或停用组件;支持本地路径缩略图和一键复制。
- 详细信息:点击行展开详情,包括直白介绍、用法示例、来源链以及位置与时间信息。
- 删除保护:删除操作需通过 Modal 输入组件全名进行二次确认;删除前自动备份到
workspace/.dsh-asset-backups;内置保护机制防止删除官方@deepseek-ai/*组件或系统规范。 - 版本更新:真实查询 npmmirror 最新版本(带超时和缓存),可更新项显示升级选项。
- UI/UX:包含骨架屏加载、操作 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 scripts/build.sh # 构建 host + client
dev_inject_plugin <本目录> # 首次注入 / 大改后重注入
dev_reload_package dsh-asset-manager # 小改热重载(若报 duplicate route:先 dev_clear_routes /@dsh-external/dsh-asset-manager)
注意:Client 改动需刷新浏览器页面生效(未开 dev:web 监听时)。
依赖¶
插件依赖以下包:
@deepseek-ai/dsh-client-ui-slots@deepseek-ai/dsh-llm@deepseek-ai/dsh-toolscordisschemastery
结尾¶
该插件为 DSH 开发者提供了一个管理资产和监控状态的集中中心。查看 GitHub 仓库 了解更多或贡献。