前言¶
DeepSeek Harness（DSH）里 Agent 常用内置浏览器工具操作页面：导航、读 DOM、截图、多标签等。默认侧栏由 @deepseek-ai/dsh-client-ui-sidebar-browser 渲染，工具栏高度与视觉与 Kimi Code 桌面版的工作台并不一致；对话流里浏览器步骤的展示方式也偏「工具日志」，不如工作台那种卡片化、可展开输入输出、一键在侧栏查看的体验。
若你已经在 DSH Desktop 上跑浏览器自动化，又希望侧栏 chrome、接管状态和人机交还流程对齐 Kimi Code 桌面版（3.2.21）的设计语言，社区插件 dsh-kimi-control（维护者 lswang9，目录分类为客户端）做的是交互层与桌面输入事件桥，而不是替换浏览器运行时本身。
这是什么¶
dsh-kimi-control 为 DeepSeek Harness 增加 Kimi Code 桌面版风格的浏览器接管 UI：右侧栏使用 Kimi 工作台的浏览器 chrome（52px 标签条、浏览器工具栏、居中域名地址栏、更多菜单），并把 Agent / 用户接管状态收进工具栏状态芯片；对话内提供 Kimi 工具卡片。
运行时仍基于 MIT 许可的 dsh-builtin-browser，保留其 32 个 dsh_browser_* 工具以及 DOM / 无障碍树、截图、登录态、下载和多标签页能力。本仓库不是 Kimi 或 DeepSeek 的官方插件。
核心功能¶
Kimi 工作台浏览器 chrome¶
侧栏浏览器面板顶部为 52px 工作台标签条 + 52px 工具栏。工具栏从左到右为返回、前进、刷新（加载中变为停止）、居中域名地址栏（聚焦后显示完整 URL，回车导航）、更多菜单（刷新 / 复制链接 / 关闭标签页）。
实现上，插件隐藏 DSH 内置侧栏浏览器原有的 38px 原生工具栏，按现有 DOM 结构注入 Kimi chrome，并复用同一 <webview> 与导航能力。DSH 升级后若内部 DOM 结构变化，chrome 可能需要重新适配。
接管状态与真实页面¶
工具栏右侧的状态芯片区分：
- Agent 控制：「正在操作浏览器」，蓝色呼吸点；
- 用户接管：「你已接管」及「交还给 Agent」；
- 短暂完成反馈：「已完成」。
桌面端使用 DSH 原生 <webview>；点击页面内任意位置或按键即视为接管，交还后 Agent 继续。状态芯片只负责展示，不暂停 Agent，也不构成权限边界；浏览器动作权限仍由上游设置与 DSH 审批机制控制。
对话流中的 Kimi 工具卡片¶
浏览器工具在对话里以 Kimi 工具卡片呈现：动作、目标、运行状态、可展开的输入 / 输出，以及「在侧栏中查看」。
设计规格与可及性¶
交互层按 Kimi Code 桌面版浏览器工作台的设计语言重做（规格来自对已安装应用的静态逆向），例如强调色亮色 #1783ff、深色 #1a88ff，动效 120–180ms、cubic-bezier(.2, 0, 0, 1)，并跟随系统「减少动态效果」设置。
环境要求¶
- DSH：
>=0.2.0-rc.2且<0.3.0（package.json 中engines.dsh与此一致）。 - Node.js：
>=22.19。 - 完整侧栏接管体验需要 DSH Desktop；
dsh web仍有对话卡片和浏览器工具，但浏览器由独立窗口承载。 - 上游运行时首次使用自托管浏览器时，若提示缺少 Electron 二进制，按提示运行
npx install-electron。
安装与启用¶
插件以当前 DSH 进程权限运行；安装前建议阅读仓库源码与 MIT 许可证，并理解桌面桥对应用入口的修改方式（见下文安全说明）。
DSH Desktop¶
先添加插件，再运行桌面桥安装器：
dsh plugin --profile desktop add git+https://github.com/lswang9/dsh-kimi-control.git
node ~/.dsh/profiles/desktop/node_modules/dsh-kimi-control/desktop-bridge/install.mjs
安装器会自动探测标准 macOS / Windows 应用目录，也可显式传入 DSH Desktop 应用路径，例如：
node ~/.dsh/profiles/desktop/node_modules/dsh-kimi-control/desktop-bridge/install.mjs "/Applications/DeepSeek Harness.app/Contents"
完全退出并重新打开 DSH Desktop。桌面应用升级会替换应用文件，需要重新执行安装器。
桌面桥必须在 Electron 主进程中运行，因此安装器会备份并修改 DSH Desktop 的应用入口；提供 --revert 回滚。不安装桥时，浏览器工具退化为独立窗口，原生侧栏交互不可用。
DSH Web¶
dsh plugin --profile web add git+https://github.com/lswang9/dsh-kimi-control.git
重启 dsh web 并新建会话。
典型用法¶
直接对 Agent 用自然语言描述浏览器任务即可，例如：
打开 example.com，读取主要内容，然后点击登录按钮。
对话卡片出现「执行中」时，侧栏会同步显示接管状态。你可以用侧栏工具栏导航，或在页面里登录、完成人机验证、修正输入，然后点「交还给 Agent」。
卸载¶
Desktop 需先回滚桌面桥，再移除插件；Web profile 单独移除：
node ~/.dsh/profiles/desktop/node_modules/dsh-kimi-control/desktop-bridge/install.mjs --revert
dsh plugin --profile desktop remove dsh-kimi-control
dsh plugin --profile web remove dsh-kimi-control
适用场景与注意¶
适合谁： 在 DSH Desktop 上频繁使用浏览器工具、希望侧栏视觉与 Kimi 工作台一致，并需要「Agent 操作 ↔ 用户点页面接管 ↔ 交还」清晰反馈的开发者或智能体使用者。
隐私与安全（README 原文要点）：
- 桌面输入桥只上报操作类型（
mouseDown或keyDown）及所属会话，不上传按键、文本、密码或页面内容。 - 浏览器可能持有真实登录态；不要允许不受信任的页面或指令诱导 Agent 发布内容、付款或修改账号设置。
DSH 生态理念是「一切皆插件」；SkillHub 目录页 为社区站点，与 DeepSeek / 幻方无官方从属关系。
