@astron-team/skillhub-dsh

配置技能来源

进入 DSH Plugins/插件 → @astron-team/skillhub-dsh → SkillHub 设置。

1. 在“技能来源”填写 Registry 地址，使用实例的 HTTP(S) 基础地址，可包含部署子路径；不要填写 API 路由、凭证、查询参数或片段。
2. 点击“测试连接”，使用当前草稿地址测试，不保存配置。结果显示公开目录可读或仅支持基础搜索及耗时；最长等待 10 秒，失败或超时可重试。修改地址后清除旧测试结果，连接成功不代表技能下载或所有可选接口可用。
3. 在“详情标签”设置版本、安全审核及评论的显示方式。
4. 点击“保存配置”，看到“配置已保存”后进入侧栏“技能中心”搜索公开测试技能。

“已配置”只表示 Host 已保存非空来源，不代表连通测试成功。空地址表示断开来源；“重置修改”恢复当前 Host 配置快照，不发起网络重载或保存。只读连接不可编辑。若保存发生 revision 冲突，先重置修改，再基于当前值编辑。

字段	行为
registryUrl	Registry 基础地址；缺省为 https://skill.xfyun.cn；显式空串或仅空白断开，不回退；自定义值保留
detailTabs.versions	版本历史显示策略
detailTabs.securityAudit	安全审核显示策略
detailTabs.reviews	只读评论显示策略

三项策略均支持 auto（自动检测）、show（显示）、hide（隐藏）。自动检测按实际匿名读取能力决定展示；显示不会放开服务端权限；隐藏不请求对应模块。当前审核接口不允许匿名读取，不能把不可访问显示为审核通过。未上线评论的 SaaS 可先隐藏评论。

使用流程

• 浏览技能：搜索、服务端排序、真实标签筛选、点击加载更多。新目录接口每批 12 项；旧来源首批 404/405 可回退受限搜索，明确提示不支持分页和排序。选中标签失败不会退回未过滤结果。
• 技能详情：查看文档、版本和可选模块；可“查看此版本”后确认安装指定的可下载版本。已有其他版本时保留覆盖保护，不执行降级。
• 已安装：按来源、范围和关键词查看本地记录。详情右侧“版本与更新”提供重新读取及检查更新；升级确认完整目标集合，卸载只影响一个明确位置。目录缺失时可单独确认清理失效记录。
• 对话搜索：astron_skillhub_search 只搜索，不安装或执行技能。结果提供明确详情动作；详情抽屉可确认安装。
• 对话安装：用户明确要求安装唯一搜索结果时，不必先打开详情。astron_skillhub_install 核验搜索时的精确版本和快照；接受 selectionRef 或完整坐标，二者互斥，范围为 user/project。过期或歧义引用拒绝执行，不改装当前 latest。

本地操作需要活动会话，Host 据此解析可信用户目录和工作区。远程 Host 的文件安装在 Host 所在机器，不在浏览器机器。插件不提供登录、评论提交或权限管理。

安装受理、文件完成、DSH 发现及模型实际使用是不同状态。安装卡主区展示结果，展开“安装记录”可查看核验、当前库存和原操作信息。历史完成不代表当前仍安装该版本，也不代表模型已执行。Host 重启后的历史搜索需要主动“重新查看详情”重新核验，不能恢复旧引用的写权限。