NeoXider/neoxider-agent-deck

NeoXider Agent Deck

你的智能体，活跃于桌面之上——为 DeepSeek Harness 会话、上下文与聊天打造的发光伙伴。

Agent Deck 让你无需一直打开完整的 Web 界面，就能随时使用 DeepSeek Harness。它可显示实时会话与子智能体，提供真正的迷你聊天，跟踪上下文压力，切换模型与推理强度，运行原生 Harness 命令，切换工作区，接受文件拖放，渲染安全的 Markdown，并保持工具调用紧凑。

NeoXider 头像会随智能体状态做出反应：空闲时呼吸，工作时打字，等待时漂浮，出错时抖动，完成时庆祝。聊天带有自己的活动指示灯，包括在等待 API 期间以及 Focus 模式下隐藏标题栏时。其颜色与头像、Orb 和 Edge 相匹配；即使其他会话正在工作，空闲的已选聊天也保持平静。动画色彩场位于面板后方，背景不透明度与窗口不透明度和活动光晕分别保存。Harness 离线时具有柔和的断开连接状态和 Start 操作。所有动态效果，从缓慢的极光到日志周围的条带，都遵循减少动态效果偏好以及 Settings → Motion effects。

预览

模式一览

Full
Focus Mini
Orb
Edge
Minimum 360 px

功能展示

实时智能体概览
完整的 Harness 迷你聊天

精确工作区 / 未分组智能体面板
在文件夹内或未分组状态下开始

可搜索的提供商/模型选择器
Markdown + 折叠的工具调用

稳定的 PNG 和视频附件预览

紧凑的原生命令面板
实时 Harness TODO 计划

可读的结构化命令结果
每个工具的状态，即使在混合组中也是如此

目标永远不会滚出视野
紧凑的工具组，按需展开

复制任意消息，复用你自己的
流式输出时即完成格式化

加载中，而非空白
一行反馈，随即消失

一键专注聊天
感知会话的紧凑通知

立即编辑、删除或发送排队消息
流式答案原地增长

阅读位置始终由用户掌控
窗口层级、背景不透明度与发光

已验证更新，一键重启
首个会话前即完整呈现 UI

默认紧凑
增长到三分之一，然后滚动

    

    

亮点

- 聊天优先导航 — 真正的迷你聊天是默认的第一页；agent deck 只需轻点一下即可到达。
- 状态感知的 agent deck — 每张会话卡片都会根据工作、空闲或错误状态改变其头像、光晕和标签。活动状态会从权威的回合事件中清除，因此已完成或失败的会话不会错误地保持为工作中标记。
- 真实的 Harness 会话 — 会话标题、运行状态、子代理和错误均来自实时 HTTP RPC API。
- 完整的长对话 — 历史记录会跟随 Harness 的向后分页一直到第一个事件。日志本身是一个连续的 Telegram 风格窗口：向上滚动会在阅读位置上方实体化更早的消息，而远离视口的行会卸载回占位符，因此即使是 10,000 条消息的聊天也能保持响应，没有页面按钮，也没有冻结的页面。
- 上下文压力 — 一个紧凑的圆环显示相对于模型上下文窗口的预计 token 数，并且在第一个会话存在之前保持为平静的 0% 圆环。
- 模型路由 — 使用可搜索的深色选择器来选择 Harness 暴露的每个提供商/模型；活动/本地路由（包括 LM Studio）始终排在最前。
- 推理控制 — 努力程度选项会针对所选模型动态更新。
- 原生命令和技能 — 垂直的 / 面板在输入框上方打开，并合并 Harness 的两个来源：用于 /goal、/plan、/compact、/permission 和插件命令的 commands/list，以及用于工作区中安装的每个技能的 skill.list。技能会带有相应标记，并作为普通提示发送，因为技能是由模型调用的，而不是由宿主执行的。
- Harness 会话组 — Agents 和 Chat 使用精确的 Harness Workspaces 成员关系加上 Ungrouped，让每个文件夹都能以一行折叠，并提供一个紧凑操作，用于在该组内或所有工作区之外启动会话。
- 安全、多彩的 Markdown — 标题、强调、链接、引用、表格、行内代码和围栏代码使用克制的深色调色板，并为支持的语言提供 Highlight.js 语法颜色；可执行 HTML 和不安全的链接协议会被阻止。
- 折叠的工具运行 — 连续的原生 tool/call、tool/result 和嵌套 Code Mode 调度会合并为一个可展开组；每个子项仍然会显示输入、结果、耗时和错误状态。
- 实时回答气泡——流式传输的助手文本在到达时会在真实聊天气泡内增长，并在流式传输过程中通过与历史记录相同的清理器进行 Markdown 格式化，因此最终消息绝不会重新排版；活动卡片仍保留用于推理和工具状态，而不会将回答错误标记为思考。
- 永不重建的日志——转录记录按 key 进行协调：一次轮询、一个工具结果或一条新消息只修补发生变化的部分，流式传输回答的气泡会变成它最终成为的消息，文本选择在回合之间得以保留。
- 没有突兀弹出——活动卡片、计划、队列、附件、命令面板、错误和目标条都会缓入缓出，工具卡片像抽屉一样打开，而原本跟随对话的日志在移动的每一帧都持续跟随，包括窗口调整大小期间。
- 复制与复用——悬停或聚焦任意消息时，其旁边会出现一个 Copy 图标，而你自己的消息上还会有一个 Reuse 图标，可将文本放回输入框；一行提示会确认此操作，目标暂停或队列消息立即发送时也是如此。
- 会记忆的输入框——未发送的文本会随其会话在切换器中保留，而在空输入框中，方向键会像 shell 一样回溯已发送的内容。
- 加载中，而非空——新选择的会话会显示占位气泡，直到其历史记录到达，而不是在一瞬间声称它是空的。
- 可选的实时活动——思考、工具和工作状态共享一个紧凑的覆盖层，它浮在对话上方、位于自己独立的不透明层上，绝不会移动阅读视口，并且可以通过 Show live activity 持久隐藏。结果——回合完成或失败——仍会被播报。
- 权威的 Harness 队列——运行中的回合期间发送的消息会以来自 Harness 本身的紧凑单行队列项形式出现，并带有 Edit、Delete 和 Send now 操作。附件也会排队：仅含图片的消息显示为 1 attachment，并拒绝就地文本编辑；文件则按名称预览，同时其完整路径会保留以供编辑。
- 尊重用户的滚动——阅读较早消息时绝不会被强制自动滚动打断；一个紧凑的跳转到最新消息胶囊会统计窗口下方到达的消息数量，按一次即可返回。你自己的消息在整个历史记录中都会在滚动轨上保持标记。
- 紧凑的 2×2 输入框——上下文/展开和命令/附件操作保持为两对垂直排列，/ 位于回形针上方，Send 按钮紧密贴合，使输入区域保持宽阔。
- 文件、粘贴和拖放——Ctrl+V 会添加复制的文件或剪贴板图片以供审阅，而不会自动发送。PNG、JPEG、WebP 和 GIF 文件使用官方图片内容块；已发送的消息会保留微小的图片预览或紧凑的文件/视频标签，而其他文件则成为显式的本地 @path 引用。
- 即时截图 — 从标题栏或全局快捷键捕获选定区域或当前显示器，在输入框上方查看 PNG 预览，然后决定是否发送。
- 可重新绑定的全局快捷键 — 显示/折叠面板、创建会话、捕获区域或显示器、聚焦聊天以及打开 Harness；每个绑定都可以禁用、更改、重置，并且在重启后仍然保留。
- 实时聊天光环 — 所选会话的灯光可区分 API 等待、思考、写作、工具、完成和错误，在专注模式下也是如此。排队另一条消息会保留当前阶段；停止会清除它。后台代理无法点亮空闲的所选聊天，延迟的轮询也无法重新启动同一动画。
- 你的背景 — 漂移的色场和面板透明度有一个独立的 背景不透明度 滑块。其保存的值不会改变原生窗口不透明度或活动光晕强度；动态效果可以完全冻结色场。
- 会话绑定附件 — 切换会话会清除输入框中已查看的附件引用，并取消任何未完成的剪贴板准备，同时显示一条简短提示。原始文件保持不变，文本草稿仍遵循各自的会话。
- 连接状态 — 断开连接的 Harness 会在聊天和紧凑模式下呈现为静音的离线状态，保持对话可见，并提供“启动”。一个受令牌门控但已锁定且正在运行的 Harness 则会有自己的状态：使用 连接 粘贴一次 dsh web: 启动 URL（或将其 重启 为自有实例），并且该组件会在每次重启后重新生成其会话 cookie。它与失败的模型回合是分开的。
- 带开关的动态效果 — 一道缓慢的极光在组件后方漂移，并在代理工作时变亮，活动标签滑动，飞机随消息从发送按钮飞出，上下文环在临界时跳动，工作会话卡片带有一道光扫过，新消息滑入。设置 → 动态效果 可一次性关闭所有这些效果。
- 专注聊天 — 一个紧凑的输入框按钮会隐藏所有界面元素和设置界面，只留下消息、可选的附件预览、输入框、上下文和操作；再次点击即可恢复一切。
- 三种窗口状态 — 完整面板、通知头像或虹彩边缘手柄。
- 可拖动的紧凑模式 — 通过圆形拖动头像，或通过线条拖动边缘手柄，并具有原生光标跟踪；释放后会将其磁吸到最近的屏幕边缘，这取决于可见元素被放置的位置，而不是其周围透明窗口的位置。两者都可以紧贴屏幕顶部或底部停放。
- 按模式持久保存位置 — 完整、头像和边缘模式会在重启后记住各自的显示器、侧边和垂直位置；缺失的显示器会通过将窗口安全地限制到当前工作区来处理。
- 点击穿透紧凑模式——在受支持的原生桌面上，两种紧凑窗口都会让鼠标穿过其透明区域：只有 68 px 的头像圆圈及其两个控件，或可见的 8 px 边缘线（各自外加一小段舒适边距）接受悬停、还原和拖拽输入；悬停时向内弹入并绽放，空闲时闪烁青绿色，活跃工作时以绿黄色加速。Linux X11 会暴露一个如实标注的更宽交互边缘，而 Wayland 则禁用边缘模式。
- 平滑宠物状态光晕——折叠后的头像现在会在空闲、思考、写作、工具、等待、错误和完成调色板之间平滑过渡，而不是突然切换其圆环。
- 经典 NeoXider 史莱姆——空闲、工作、等待、错误和完成现在使用来自 NeoXider Video Studio 的原始软底吉祥物形状，而不是圆形变体。
- 点击或拖拽品牌区——点击全尺寸头像可折叠，点击 NeoXider 标题可打开仓库，或在品牌区任意位置拖拽可移动整个小组件。品牌文字不可选中，因此拖拽不会变成文本选择。
- 默认折叠——头像模式保持为一个圆圈，其展开按钮上显示正在工作的代理数量；会话面板仅在需要时打开。设置中的活动时展开头像可恢复旧的始终打开行为。
- 后台任务计数——会话卡片显示其下当前正在运行的后台任务（Harness 子代理）数量，没有时则不显示；统计已完成子项的名单大小已移除。
- 回合已用时间——每张会话卡片和会话选择器都会显示代理在当前回合上已花费的时间（实时跳动），以及上一个已完成回合所花费的时间。时钟从回合自身的事件中读取，因此即使小组件重启也能保留。
- 精确会话宠物回复——折叠宠物模式保留一个有用的回复按钮，而不是创建/命令/附件的杂乱按钮；它会打开产生该回复的代理和会话。
- 会话感知通知——完成的回复会滑出约 2.7 秒，并显示其会话名称和答案预览；点击它会还原到该确切会话。工作完成时边缘手柄仍会弹跳。
- 三种窗口层级——可选择 Desktop（每个普通窗口都会覆盖小组件）、默认的 Above 层级，或 Always on top+，即增强的窗口之上模式（原为 Game）。它会更积极地提升桌面窗口，但不保证在独占全屏之上可见。不受支持的 Linux 桌面会禁用该选项。
- 无关闭按钮——窗口关闭手势会将小组件停靠到屏幕边缘。仍可从托盘菜单退出。
- 单实例启动——重复点击快捷方式会聚焦现有小组件，而不是堆叠半透明窗口。
- 个人控制 — 独立的窗口/背景不透明度、紧凑/标准/大尺寸、聊天光晕强度、窗口层级，以及在平台支持时的登录时启动。
- 锁定渲染器 — 严格的内容安全策略（default-src 'none'、无 unsafe-inline、无 unsafe-eval）、禁止创建窗口、阻止导航以及经过协议检查的外部链接，意味着模型输出可以渲染但永远不会执行或导航。
- 渲染器崩溃后仍能存活 — 一个无边框透明窗口在失去渲染器后会自动重新加载，而不是残留为一个只有任务管理器才能移除的死形状。
- 键盘和屏幕阅读器支持 — 每个可访问的控件都会绘制可见的焦点环，变暗的标签保持 WCAG AA 对比度，并且对话以 ARIA 日志区域的形式暴露。
- 可靠的便携式自启动 — Windows 上的登录时启动指向稳定的便携式启动器，而不是 Electron 临时解压的子进程；现有的过时启动项会自动迁移。启动回读能够处理包含空格的 executable 路径，因此有效的已启用条目仍会显示为已启用。
- 静默后台更新 — 受支持的构建会检查并下载稳定版本，而不会中断聊天。只有在文件完全验证后，版本旁边才会出现一个紧凑的 Update 操作；安装和重启仍需点击一次。
- Xbox Game Bar 桥接 — Windows 包包含一个有界的原生 sidecar，用于单独的 Game Bar 配套应用。该协议会验证确切的 AppContainer 包，仅暴露快照、确认、精确会话打开和快速回复，并且永远不会注入到游戏进程中。

安装

便携版发布

1. 从 Releases 下载最新的 NeoXider-Agent-Deck-*-windows-x64-portable.exe。
2. 在 http://127.0.0.1:3080 上启动 DeepSeek Harness Web，或按离线横幅中的 Start。该 widget 优先使用已安装的官方运行时，并在上一次启动仍在进行时避免生成重复实例。如果 Harness 是在 widget 之外启动的，并且其浏览器索引要求身份验证，横幅会提供 Connect：从 Harness 终端粘贴一次 dsh web: URL，它就会被记住。
3. 运行便携式可执行文件。

要将最新版本安装到 %LOCALAPPDATA% 下，请创建桌面快捷方式并启动它：

一次性升级说明： 0.5.0 是第一个支持应用内更新的版本。0.4.3 及更早版本无法自行更新，因此请手动安装一次 0.5.0；之后受支持的版本可以使用 Settings → Updates。

git clone https://github.com/NeoXider/neoxider-agent-deck.git
cd neoxider-agent-deck
powershell -ExecutionPolicy Bypass -File .\scripts\install-desktop.ps1

从源代码

要求：Node.js 22+ 以及正在运行的 DeepSeek Harness Web 配置文件。

git clone https://github.com/NeoXider/neoxider-agent-deck.git
cd neoxider-agent-deck
npm ci
npm test
npm run test:ui
npm start

设置 DSH_WIDGET_URL 以使用不同的 Harness 端点。

控件

| 控件 | 操作 |
|---|---|
| 发光的标题标签 | 在会话列表和迷你聊天之间切换 |
| 输入框中的聚焦图标 | 隐藏除聊天、附件预览、输入、上下文和操作之外的所有界面；再次点击可恢复 |
| 全尺寸头像 | 点击可折叠为动画头像和快捷操作；拖动可移动窗口 |
| NeoXider / Agent Deck 标题 | 点击可打开此仓库；拖动可移动窗口 |
| 会话旁的 DeepSeek 鲸鱼 | 在 Harness Web 中直接打开所选会话 |
| 边缘箭头 | 停靠到虹彩边缘手柄 |
| 终端按钮 | 打开实时 Harness 命令面板 |
| 模型标签 | 搜索提供商和模型 |
| 灯泡标签 | 选择推理强度 |
| 文件夹标签 | 选择或添加工作区 |
| Agent / Plan 开关 | 更改 Harness 交互模式 |
| 回形针 | 附加文件或打开附件选择器 |
| 折叠宠物旁的聊天图标 | 展开头像面板；其徽章统计当前正在工作的代理数量 |
| 跳转到最新按钮 | 阅读较早的聊天内容后返回最新消息 |
| 发送旁的停止 | 仅取消当前正在运行的回合 |
| 最左侧的上下文环 | 显示预计的上下文使用量 |
| 最右侧的发送 | 提交当前消息或附件 |

点击折叠的头像或边缘手柄可恢复完整面板。使用托盘菜单可完全退出。
通过其圆形拖动头像，或通过其线条拖动边缘手柄，然后将其释放到任意位置：它会吸附到最近的左屏或右屏边缘，并记住该侧。这些窗口中的其他所有内容都是透明的，属于其背后的任何内容。

聊天如何工作

该小部件不会嵌入或抓取 Harness 网页。它直接使用已安装的 Harness RPC 契约：

- session.list、session.history、session.create、session.prompt、session.cancel
- session.updateQueue 用于权威的编辑、删除和立即发送队列操作
- session.models、session.selectModel
- workspace.list、workspace.create
- commands/list、commands/execute

这使 UI 保持小巧，并避免将其与 Harness HTML 布局更改耦合。提供商凭据保留在 Harness 内部；该小部件从不读取 API 密钥。

从该小部件创建或提示的每个会话都会在提示运行之前显式切换到 Harness danger-full-access。这与该小部件预期的受信任桌面工作流相匹配，但这也意味着所选代理可以读取、写入、执行并使用已配置的工具，而无需额外的权限提示。请仅在你信任的模型、工作区、MCP 服务器和技能中使用该小部件。

构建和验证

npm test
npm run test:platforms
npm run test:input
npm run test:ui
npm audit --audit-level=high
npm run smoke
npm run feature-smoke
npm run chat-smoke
npm run tool-smoke
npm run build
便携式可执行文件写入到 release/NeoXider-Agent-Deck-0.9.2-windows-x64-portable.exe。

测试套件验证官方 Harness 事件形态、临时推理、安全 Markdown、工具分组/关联、单实例行为钩子、紧凑窗口几何结构以及 UI 契约。test:ui 在确定性的桌面和最小尺寸场景下启动 Electron，并拒绝被裁剪或溢出的布局。feature-smoke 验证工作区感知的会话创建、实时命令发现/执行以及支持推理的模型发现。chat-smoke 创建一个真实的 Harness 会话，并期望从配置的 LM Studio 路由收到 OK 回复。tool-smoke 还要求该模型执行一个真实的 Harness 工具，并检查小组件中关联的工具卡片。

0.6.4 验收包括一次精确的本地 lmstudio/qwen3.8-27b-unleashed Dynamic MCP 运行，依次经过 search → inspect → enable → tools → call → skill.load → status → disable → status，且零工具错误，并确认 Playwright 子进程已停止。在最终重复期间，该 27B 路由在 LM Studio 模型启动时如实失败（Engine protocol startup was aborted），因此同样的全新只读三工具对等回合在可用的 lmstudio/ling-3.0-tiny 路由上重复：Harness 发出了三个关联的 glob、grep 和 read 调用/结果；小组件生成了单独的已完成卡片，在 turn/end 时清除了实时活动，并保留了最终的俄语回答。持久化凭据：v0.6.4 Dynamic MCP on Qwen 27B、final Tiny multi-tool parity、final Qwen 27B load failure，以及更深入的 widget streaming parity。自动化验收套件还覆盖精确的工作区分组与顺序、完整的 160 到 161 条消息历史分页、紧凑宽度下的分组布局、持久的跳转到最新项功能、不位移的可选 Think 覆盖层、2×2 输入区几何结构、原生紧凑拖拽以及每个 Edge 状态。

安全

渲染器已沙箱化，启用了 contextIsolation 并禁用了 Node.js 集成。本地文件准备和 Harness 请求保留在主进程中，位于狭窄的 IPC 桥接之后。发布下载在替换前有大小限制并进行摘要校验。当前的 Windows 和 macOS 产物未进行代码签名，因此在配置签名证书之前，SmartScreen/Gatekeeper 可能会发出警告。参见 SECURITY.md。

配套项目

使用一个惰性工具减少 MCP schema 开销：NeoXider MCP Hub。

路线图
屏幕捕获、可配置的全局热键以及三会话宠物切换器已在 0.5.0 中发布；剪贴板文件/图像粘贴已在 0.6.4 中发布。剩余的覆盖层诊断、按游戏配置的配置文件以及静默通知工作记录在 TODO.md 中。

更新日志

每个版本都记录在 CHANGELOG.md 中。源代码版本 0.9.2 发布了 0.9.1 的工作，其发布构建因过时的检查而被停止，并让紧凑模式和转录保持稳定：Edge 线保持在指针下方，头像保留其点击和位置，折叠动画不再闪烁，长聊天不再让你滞留在空白区域。它还修复了使用粘贴的启动 URL 连接受门控的 Harness 的问题，该问题由 0.9.0 引入。

平台支持

Windows 10 和 11 是主要支持的目标。CI 还会打包 Intel/Apple Silicon
macOS 构建和 Linux AppImage/deb 构建，但这些仍为实验性。Linux 使用
freedesktop 自启动条目；它会禁用原生不透明度和增强的窗口置顶控制；
Wayland 还会禁用窗口拖动和 Edge 模式，而 X11 会标记其更宽的交互式
Edge 区域。当未找到已安装的 Harness 运行时，Start Harness 依赖启动器环境中存在 npx，而对于从 Finder
或桌面启动器启动的应用来说，这并不能得到保证。Always on top+ 针对普通窗口和无边框窗口；
真正的独占全屏可能优先于桌面窗口，因此本仓库明确保留原生
Xbox Game Bar 伴随路径，而不是声称操作系统并不提供的保证。

贡献

欢迎聚焦的 issue 和 pull request。对于视觉更改，请附上截图；对于行为更改，请附上测试或实机冒烟验证凭据。

MIT © NeoXider