# @guuey/agent-layout 中文文档

规范地址：https://npmcn.com/package/%40guuey/agent-layout/

版本：0\.36\.0
npm 元数据更新时间：2026-11-14T17:05:01.022Z
中文译文更新时间：2026-11-17T14:29:40.818Z
软件包许可：MIT

本文由上游 README 翻译，可能存在偏差，请结合原文核对 API、命令与配置。版权与许可归原作者所有。

原始 npm 页面：https://www.npmjs.com/package/%40guuey/agent-layout
原文对照：https://npmcn.com/package/%40guuey/agent-layout/?lang=original
源码仓库：https://github.com/withguuey/guuey-sdks

## 关键信息（来自 npm 元数据）

- 包体积（解压后）：93.8 kB，24 个文件
- 模块格式：ES Module
- TypeScript 类型：包内自带
- 运行依赖：0 个
- peer 依赖：react \>=18
- 首次发布：2026-08-25T01:02:03.239Z
- 最新版本发布：2026-11-14T17:05:00.026Z
- 近 30 天下载量：4885（2026-10-17 至 2026-11-15，npm 官方下载统计）
- 已发布版本数：49（近 12 个月 49 个）

## 中文简介

Agent-mode布局:一个app及其代理共享一地平面的双通外壳-相窗接踵而来,运输拥有溪流.

## 安装

```sh
npm install @guuey/agent-layout
```

也可以使用：`pnpm add @guuey/agent-layout`、`yarn add @guuey/agent-layout`、`bun add @guuey/agent-layout`

## README

# @ guuey/ agent- layout (英语)

**代理模式布局** – 应用程序及其表面的布局类别 代理共享一屏:上边栏的应用程序菜单,下面的代理栏杆, 和内容的平面,其地基 **跟踪用户的注意力** 之间 两个 给代理地址, 窗帘取代理语气; 导航和它 返回应用程序。 一项法律: _排版跟随注意; 运输拥有 流线_ - 调子在提交上翻转, 从来没有在溪流事件, 并打断 是运输的生意.

```tsx
import {
  AgentModeProvider,
  AgentModeShell,
  AgentModeSidebar,
  SidebarPanel,
  ActivePane,
  bindGuueyChat,
  useAgentMode,
} from "@guuey/agent-layout/react";
import "@guuey/agent-layout/styles.css";

function Shell() {
  const { dispatch } = useAgentMode();
  return (
    <AgentModeShell>
      <AgentModeSidebar>
        <SidebarPanel section="app">{/* your menus — zero wiring */}</SidebarPanel>
        <SidebarPanel section="agent">
          <GuueyChat {...bindGuueyChat(dispatch)} />
        </SidebarPanel>
      </AgentModeSidebar>
      <ActivePane>{/* your routes / canvas */}</ActivePane>
    </AgentModeShell>
  );
}

<AgentModeProvider mode={mode} navigationKey={pathname} identity={<Logo />}>
  <Shell />
</AgentModeProvider>;
```

-   **两吨,校正**: 默认对是已运出 温暖相纸/中性相色阶,光和暗. 覆盖被验证 与可视性底线(QQL \* 6或Hue-temperature step)相对 同样的两分钱 都无法解释.
-   **路径导出**:通过您的路由器位置键为 `navigationKey`;每个导航将窗帘返回应用语气 零每条接线。 同页菜单点击被应用面板所捕获 捕捉相听器.
-   **没有 stale- Content 坚持**:而经纪人有房间,什么都没有 呈现时,窗格显示工作状态(您 `identity` +脉冲, 从未在代理语气下出现过上一页.
-   **一个高高的导航卷 特工留下**: 应用程序面板是侧边栏 滚动器(一个最下端的淡出显示,而项目则隐藏在其下方),以及 代理面板从不收缩 在它的地板下, 所以作曲总是 可达. 地板是 `--guuey-layout-agent-panel-min` (默认) `112px`数字 : `@guuey/chat`标题行加上它的一行作曲,所以没有什么 默认剪接). 使作曲家单独作曲的主机可能会降低; 等你的特工表面需要更多时再加注 给代理主机 面板为固定高 (`--guuey-layout-agent-panel-flex: 0 0 auto`(组数) `--guuey-layout-app-panel-flex: 1 1 auto` (默认) `0 1 auto`所以应用程序 面板取出自由空间,而铁路留在底部.
-   **电话宽度抽屉**: 在 1024px 下, 侧边栏变为覆盖 抽屉后面一个""切换"。 在抽屉的宽度,给外壳取景 (单位:千美元)`100dvh`:抽屉和抽屉固定在取景口 切换在它的左上角, 相对于任何主机放置在布局之上. 逃脱关闭了打开的抽屉,焦点返回到切换.
-   **模式意识**: 通过同样的 `mode` 你给自己的聊天表层——自由 骑着现有的轻/暗机械 并且没有增加任何它自己的.
-   **不是聊天依赖**数字 : `bindGuueyChat` 配对 `@guuey/chat` 结构; 任何代理表面都可以直接通过 `useAgentMode()`。 。 。 .

只反应 DOM, 零运行时间依赖 . `react >= 18` 是可选的对等点 : 页:1 `./react` 子路径需要它和根(注意机器和基调) 帮助者)不会,所以npm不会为您安装它——添加 `react` 给自己的 导入时的依赖性 `@guuey/agent-layout/react`。 。 。 .

## 支助

问题和帮助:Discord上的贵人社区—— [https://guuey.com/discord (英语)](https://guuey.com/discord)。 。 。 . 错误和特性请求 : [https://github.com/wisguuey/guey-sdks/ 问题](https://github.com/withguuey/guuey-sdks/issues)。 。 。 .

## 常见问题

### @guuey/agent-layout 是什么？

Agent-mode布局:一个app及其代理共享一地平面的双通外壳-相窗接踵而来,运输拥有溪流\.

### 如何安装 @guuey/agent-layout？

在项目目录运行 npm install @guuey/agent-layout，或使用 pnpm add / yarn add / bun add。

### @guuey/agent-layout 支持 TypeScript 吗？

支持。包内自带 TypeScript 类型声明（package\.json 声明了 types 入口），安装后即可获得类型提示，无需再安装 @types 包。

### @guuey/agent-layout 支持 ESM 还是 CommonJS？

以 ES Module 形式发布，推荐使用 import 引入。在 CommonJS 项目中，Node\.js 20\.19\+ / 22\.12\+ 可以直接 require\(\) 不含顶层 await 的 ES Module，更早的版本需要改用动态 import\(\)。

### @guuey/agent-layout 可以商用吗？

@guuey/agent-layout 使用 MIT 许可。宽松许可：允许商业使用、修改和再分发，通常只需在分发时保留原版权与许可声明。以上为概括，不构成法律意见，请以许可原文为准。

### @guuey/agent-layout 的下载量有多少？

根据 npm 官方下载统计，@guuey/agent-layout 在 2026/10/17 – 2026/11/15 这 30 天内被下载 4,885 次，日均约 163 次。下载量会把 CI 构建、镜像同步和作为其他包依赖的安装一并计入，适合横向比较热度，不能直接等同于使用人数。

### @guuey/agent-layout 还在维护吗？

最新版本 0\.36\.0 发布于 2026/11/15（2 天前）；至今共发布 49 个版本，其中过去 12 个月发布了 49 个；首次发布于 2026/08/25。发布频率只是参考信号：功能稳定的工具可能很少需要更新，建议结合源码仓库的 issue 和提交记录判断。

