# 动态插件版

把同一个文件浏览器做成**单会话的 Cordis 动态插件**：不需要包、不需要 composition 行、
不改 profile。适合在安装 profile 插件之前先试一下面板，也可以当作 UI 接线的参考。

动态插件是**进程内**的——DSH 进程重启后面板就没了。日常使用请安装
[profile 插件](../README.md#作为-profile-插件安装)。

[English](README.en.md) | 中文

| | 本版本 | [profile 插件](../README.md) |
|---|---|---|
| 文件 | `host.body.js`、`client.body.js` | `lib/index.js`、`lib/client.js` |
| 数据通道 | Package 私有的 `harness.handle` / `host.call` RPC | HTTP 路由 `/dsh-file-explorer/tree` |
| 样式 | `styles.insert` 内置能力 | `apply` 里插入 `<style>` |
| 文案 | 内联中文 | `ctx.locale` 字典（英文 + 中文） |
| 类名前缀 | `dshfx-` | `dshfe-` |
| 生命周期 | 当前进程 | 跨重启存活 |
| 安装 | 让你的 agent 加载 | `dsh plugin --profile web add …` |

其余完全一致：同一套懒加载目录树、同一个「零尺寸锚点 + 绝对定位停靠层」结构（为什么必须是
这个形状见 [实现原理](../README.md#实现原理)）、同一套测量宽度、同一个可拖拽高度，以及同一个
**设置 → 通用**开关。

## 如何加载

这两个 `.body.js` **不是模块**。每个文件的全部内容就是 Cordis 工具接受的
`code.host` / `code.client` 纯 JavaScript 函数体，所以它们以 `return` 开头。
不要 `import` 它们，也不要直接运行。

在 GUI 里开一个会话、把工作目录设成你想浏览的项目，然后给你的 DSH agent 这段提示词：

> 读取本仓库的 `dynamic-plugin/host.body.js` 与 `dynamic-plugin/client.body.js`。
> 定义一个新的 Cordis 插件，`code.host` 用 `host.body.js` 的全部内容，
> `code.client` 用 `client.body.js` 的全部内容，然后运行它。名字叫 "file explorer"。

agent 会调用 `cordis_define`（只定义并预览代码），然后调用 `cordis_run`（会让你批准浏览器半）。
批准之后，面板就出现在侧边栏 `设置` 那一行上方，并在 **设置 → 通用** 里多出一个开关。

把两个文件的内容直接粘进 `cordis_define` 的 `code.host` / `code.client` 也是同样的效果——
文件里没有别的东西。

## 前置要求

与 profile 插件相同：需要 Web GUI、宿主侧的 `fs` 服务，以及浏览器侧的 `slots` 服务。
动态沙箱另外提供了 `styles` 与 `host`，本版本依赖这两者。

## 移除

打开侧边栏 `设置` 上方的 Cordis 面板，停止或移除该插件。停止会保留定义以便之后再运行；
移除则彻底删除。