前言¶
在 DeepSeek Harness（DSH）里接远程机器、查应用状态，常见做法是每次对话里重复说明 SSH 路径、服务位置，或自己写固定脚本。对话结束，上下文往往不会变成可复用的目录和界面。
社区插件 dsh-machine-apps 在 SkillHub 上归类为 admin-security；其发布包已更名为 DSH A2UI Studio，npm 包名与安装 ID 仍为 dsh-control-studio（与旧名兼容，无需为品牌改名单独迁移安装 ID）。维护者为 zhaochengggg。插件把「机器档案、SSH 健康检查、由模型编写应用 UI 卡片」交给 DSH 里的智能体：你描述目标和任务，智能体可登记机器、探查应用、保存要点，并生成可反复打开的操作面板。项目为独立社区作品，非 DeepSeek 官方插件；GitHub 仓库 README 指向 zhaochengggg/dsh-a2ui-studio，目录页为 SkillHub：zhaochengggg/dsh-machine-apps。
这是什么¶
一句话：DeepSeek Harness 插件，用于把机器与应用管理委托给智能体，并把应用知识沉淀为 A2UI 风格的可渲染卡片。
README 中的定位是：描述管理对象与工作内容；智能体检查已有记录，用 machine_manage 创建或更新机器档案；需要时在已批准的访问方式下提供连接信息，手动登记仅为可选后备。UI 采用 A2UI-inspired 思路——智能体描述结构化界面，宿主渲染；文档明确说明这不等于完整 A2UI 协议兼容。自定义扩展需单独审查（带代码能力）。
核心功能¶
以下能力均来自 README 中的能力表与说明。
| 能力 | 作用 |
|---|---|
| Machine directory | 持久化记录、多条 SSH 路径、默认连接、健康检查、对话中 @ 引用 |
| Application cards | 模型编写的布局、数据绑定、条件控件、数值色阶 |
| Persistent operations | 卡片修订、发布前审查、执行权限、操作回执 |
| Extensible UI | 组件目录；标准组件不够时可做自定义卡片扩展 |
| Agent skills | 内置机器管理、卡片编写、扩展开发等技能指引 |
插件只保留智能体显式保存的知识，不会自动记住每次对话。打开卡片不会自动应用其设置；本地执行默认未授权；安装过程不改变网络暴露、代理、认证或 GPU 服务。
安装与启用¶
环境要求（README / package.json）： 预发布阶段；支持 Linux 与 Windows 桌面；DSH 0.2.1-alpha.1 或 0.2.1-rc.2；Node >=22.13.0。当前发布包版本 v0.3.2。Windows 限制见仓库 docs/windows.md。
若你已在用 dsh-machine-apps，安装前须按 rename migration guide 迁移，不要与新旧两个包同时启用。
下面先下载并校验预构建包，再以 DSH 用户身份安装（将 web 换成你的 profile 名）：
curl -fL -o dsh-control-studio-0.3.2.tgz \
https://github.com/zhaochengggg/dsh-a2ui-studio/releases/download/v0.3.2/dsh-control-studio-0.3.2.tgz
curl -fL -o SHA256SUMS \
https://github.com/zhaochengggg/dsh-a2ui-studio/releases/download/v0.3.2/SHA256SUMS
sha256sum -c SHA256SUMS
校验输出为 OK 后安装：
dsh plugin --profile web add ./dsh-control-studio-0.3.2.tgz --allow-build=esbuild
dsh --profile web --dump-config
重启 DSH 并刷新浏览器。文档要求使用 release tarball，不要用 git 安装。--allow-build=esbuild 用于批准扩展构建器的依赖脚本；启用执行前请阅读 setup and permissions。
典型用法¶
1. 告诉智能体要管理什么¶
示例意图（README 原文风格）：
Register this machine as Queue server. Find the queue application and remember where it lives.
智能体核对现有记录并维护机器档案；连接细节通过你已批准的访问配置提供即可。
2. 把应用知识变成可用面板¶
示例：
Show running, waiting, completed and failed jobs, with concurrency. Start read-only.
智能体阅读应用、记录位置与用途，并提议定制卡片。发布前你可审查执行定义；插件保留笔记、卡片版本与操作回执。建议先只读：请智能体用 machine-management 登记目标与连接，再用 app-cards-authoring 探查应用并提议只读面板；目录里已有机器时用 @ 引用。确认每个动作实际执行什么之后，再增加控件。
3. 直接使用或继续委托¶
在界面中打开机器及其已保存面板；需要调查或变更时点击 @ 把机器挂到对话，智能体可读取已有上下文而非从零开始。仓库还提供双 GPU 监控与电源控制等 walkthrough（docs/gpu-walkthrough.md），流程相同、界面可以完全不同。
更深文档：docs/setup.md、docs/story.md，以及 skills/machine-management/SKILL.md、apps/skills/app-cards-authoring/SKILL.md 等。
适用场景与注意¶
适合： 需要在 DSH 内长期维护多台机器档案、做 SSH 健康检查、并由智能体为特定应用生成可复用只读/可控面板的开发者或运维（admin-security 类场景）。
务必注意：
- 插件在当前 DSH 进程权限下运行；安装与启用执行能力前，应自行检查源码与许可证（仓库含 LICENSE / NOTICE）。
- 预发布软件；DSH 与插件版本需匹配 README 声明的 engines。
- SkillHub 为独立社区目录站点，与 DeepSeek / 幻方无官方从属关系；星标等目录元数据以站点为准（当前线索为 0 star）。
- 勿在 issue 中提交凭证或私有机器地址；反馈时说明 DSH 版本、预期面板，并提供脱敏日志或截图。
结尾¶
dsh-machine-apps / DSH A2UI Studio 把机器目录、SSH 探活和模型编写的应用卡片收进同一套 DSH 插件工作流：智能体管登记与探查，你审查发布与执行权限，面板与档案可反复使用。
- 目录页：https://www.skillhub.cn/plugins/zhaochengggg/dsh-machine-apps
- GitHub（README 与发布）：https://github.com/zhaochengggg/dsh-machine-apps（发布与迁移文档亦见 https://github.com/zhaochengggg/dsh-a2ui-studio）
