VDERR/echocat-skill-panel-3.0
# 中文学习卡：echocat-skill-panel-3.0
一、一句话定位
一款为 DSH Desktop Beta 设计的 cordis 插件，能自动统计每轮对话调用了哪些 skill，并让你在应用内直接安装、删除和引用 skill，无需依赖模型自觉。
二、核心技术/架构亮点
1. 不依赖模型报告：从会话事件流推导本轮使用的 skill（包括自动、手动 `/name`、甚至未使用的场景），模型忘记说也能正确上报。
2. 三界面数据共享：输入框上方横栏、左栏图标、中栏面板共用同一份 skill 数据，横栏支持一键引用到草稿。
3. 智能安装引擎：支持仓库链接、文件夹链接、`SKILL.md` 链接、zip 直链、`owner/repo`、SSH 地址等多种格式，自动解析分支与子目录。同名 skill 先备份再替换，删除进入备份目录永不硬删。
4. 中文友好：通过 `meta.yaml` 的 `display-name-zh` 显示中文名，可随时修改；`/名字` 手势仍走 ASCII 代号，互不干扰。
5. 构建产物入库：`lib/client.js` 是必须提交的构建产物，修改 `src/client/` 后需在同一 commit 重建，否则 `verify-install.mjs` 会报错。
三、适用场景与目标用户
- 目标用户：DSH Desktop Beta 用户、skill 开发者/管理者、需要动态管理对话系统中可用 skill 的团队。
- 场景：快速安装第三方 skill 并立即测试；在对话中灵活引用已安装 skill；跟踪每轮对话实际调用了哪些 skill 用于调试或统计。
四、可动手动作
1. Clone 并安装：
```powershell
git clone https://github.com/VDERR/echocat-skill-panel-3.0.git
cd echocat-skill-panel-3.0
& ".\安装-3.0.ps1" # 自动执行备份、镜像、建联接等步骤，支持 -Rollback 回退
```
2. 通过 dsh 安装：`dsh plugin --profile web add echocat-skill-panel-3.0`
3. 使用一键安装功能：在面板内粘贴任意 skill 仓库地址即可自动下载并装载。
4. 开发构建：`node tools/build-client.mjs` 生成 `lib/client.js`，注意每次修改 `src/client/` 后必须重建并提交。
五、学习优先级
P1（排期）
理由：项目已成熟（v3.0.0），功能完整，文档清晰，适合在 DSH 生态中作为 skill 管理基础设施使用。但涉及特定运行时（DSH Desktop Beta）和 peer 依赖，非通用技术，短期动手门槛稍高，建议排期 1-2 天内熟悉安装与使用即可。⌂