# @dashup/connector 中文文档

规范地址：https://npmcn.com/package/%40dashup/connector/

版本：0\.1\.39
npm 元数据更新时间：2026-11-06T23:42:52.699Z
中文译文更新时间：2026-11-11T12:44:54.023Z
软件包许可：MIT

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

原始 npm 页面：https://www.npmjs.com/package/%40dashup/connector
原文对照：https://npmcn.com/package/%40dashup/connector/?lang=original
项目主页：https://dashup.com/
源码仓库：https://github.com/EdenCoder/dashup-connector

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

- 包体积（解压后）：1 MB，11 个文件
- 模块格式：ES Module
- TypeScript 类型：未声明
- Node.js 要求：\>=24\.0\.0
- 运行依赖：9 个
- 首次发布：2026-10-27T05:25:54.788Z
- 最新版本发布：2026-11-06T23:42:52.535Z
- 近 30 天下载量：5719（2026-10-12 至 2026-11-10，npm 官方下载统计）
- 已发布版本数：29（近 12 个月 29 个）

## 中文简介

在每台计算机的编辑器旁运行,包括Zed窗口连接在SSH上的开发机的PC. Dashup 保留了保存了 SSH 关系; 它不会启动替换 SSH 会话 .

## 安装

```sh
npm install @dashup/connector
```

也可以使用：`pnpm add @dashup/connector`、`yarn add @dashup/connector`、`bun add @dashup/connector`

## README

# 桌面连接器

在每台计算机的编辑器旁运行,包括Zed窗口连接在SSH上的开发机的PC. Dashup 保留了保存了 SSH 关系; 它不会启动替换 SSH 会话 .

与节点24:

```sh
npx @dashup/connector pair
```

留着 `dashup` 作为命令,用 `npm install -g @dashup/connector`。软件包将工作空间代码捆绑起来.

`dashup pair` 在终端中走过对接:它显示一个在5分钟后过期的QR代码,等待电话在Pair一台计算机下扫描,并提议让Dashup在后台运行. 第一部手机将计算机添加到其账户中,所以在确认之前,行走名称进行账户和共享. 之后的代码对同一账户上更多的手机进行对接,无需询问,包括通过已经运行的连接器. 扫描已过期密码的电话 就会被电脑吊销 因为它从未保存过钥匙 在没有提示的情况下,如果代理商可以将账户命名为 `--account you@example.com`;拒绝向任何其他账户注册的电话。 没有终端,代码就用这个计算机上的浏览器来打开而不是打印,因为它搭载了配对的加密密钥,一个代理输出离开计算机. 然后对齐出口 `dashup install` 保持Dashup运行。 在没有浏览器可以打开的地方,对接需要一个终端. 用这个 `https://api.dashup.com`; 对于本地 API , 添加 `--api http://localhost:3000`。物理电话需要可达到的 HTTPS API。 在前景中运行一对连接器, 使用 `dashup watch`。 。 。 .

## 现有项目和警报

```sh
dashup doctor
dashup projects
dashup alert --project PROJECT_ID --title "Dashup is connected"
```

连接器会自动读取已存在的克洛德代码,Codex,Kimi,和与Zed工作空间和VS代码聊天历史并列的OpenCode对话. 它尊重了本带现有的数据目录,认证,和本土会话ID. 原生商店只开放只读;发现从未发射代理,创建或恢复对话,或更改编辑器设置. 只有会话,电话才会运行代理(见下文)。 通过 Zed 打开同样的被支持的绑带会话, 并且它的原生历史在实际会话身份匹配时使用一个 Dashup 线程 。 仅匹配目录名称就永远不会合并本地和SSH项目. Zed SSH计划中的一位特工 在那台机器上运行 其连接器列出了它的谈话.

一个线条的标题是代理商自己的(重名,Codex所存储的标题,克洛德的标题),否则是个人打出的第一个消息: Codex注入了AGENTS.md,环境信息以及克洛德代码的斜线命令被跳过,一个Codex子代理商因其任务被命名. 在对话中,Codex注入了消息,克洛德代码自己的元行不参与,一个克洛德代码斜线命令读取为打字,然后是它的输出. 一个线程的时间是它自己历史上最后的谈话信息;编辑Zed's sidebar respamps等簿记从不移动. 子代理会(OpenCode children,Codex产物代理)会携带他们的母线. 工具调用与结果结合到一个步骤中,有状态,持续时间,对于文件编辑,一个统一的diff. 被保存的历史有未知的活状态,除非一个确切的本地的 Codex 作家仍然拥有它:它持续地转动开始,完成和中止事件,然后提供工作状态或闲状态. 单凭文件时间戳绝不意味着活动. 电话可以通过恢复它来回答一个未拥有的保存会话(参见从电话开始会话). 文件更改发布项目元数据;只有批准,提问,出错或完成转会发出警告. 工作空间一旦有对话就成为一个项目。 连接器每个对接的电话保留一款加密的电流仪表板:有界项目卡,活动/最近会话摘要和使用. 手机可以显示计算机重联时缓存的仪表板. 项目会话列表和对话细节直接取自搭配的计算机在活加密会话套接字上. 开启聊天只读出原生对话,并返回最多30个完整消息,16个文本的KiB和40个JSON的KiB. 已签名的光标获取更旧的完整信件 。 大消息有一个开放预览,内容完整,可按要求提供. Live 更改以替换最近限制的窗口; 读取旧信件时, 保留到个人返回最新消息 . 达苏普数据库中没有聊天记录,命令日记或历史生成. 土著直播界面提供实际地位和待定选择。 工具集成还可以排入明确的加密提醒 `alert`。 。 。 .

概览还载有这台计算机的代理登录器,每个都带有它的电子邮件,它的计划以及它的窗口花费了多少,还有一个工作线条名称是它最后迈出的一步. 最多每5分钟,当会话变化时,连接器会询问Anthropic的用量表关于克洛德代码的登录,作为克洛德的 `/usage` 已经 它读到登录从 `.credentials.json` 在克洛德的配置目录中,或者从macOS keychain中,并且只向Anthropic发送符号. 它永远不会刷新符号,因为刷新会旋转登录克洛德码所持有的,所以一个过期的会等待克洛德码续作. 无法读取的登录仍会命名其电子邮件,来自 `.claude.json`和它的计划,从登录本身。 Codex 使用是代码代码的速率限制 , 最后写入会话的展开,其电子邮件和计划来自 Codex 中的身份符 `auth.json`。 。 。 .

项目路径,SSH细节,线程内容,批准和提醒,每个对接电话都单独加密. 服务器存储一个可替换的仪表盘密码和不透明的实时会话包。 对等和设备更改使用账户范围状态事件;连接器不订阅数据库模型查询. 撤销一对键会丢弃其密钥,等待提醒和本地请求收据,并关闭其终端.

命令只通过连接的活会话执行 。 只读请求不写连接器收据. 原生突变在交接前会保存少量请求收据,因此重复请求不能两次发出代理提示;未经证实的交接请求人检查原生会话. 原生 Codex 队列接收仍然跟踪队列,交付和未知结果. 对话消息和活包从未被添加到可耐用的收发箱中.

## 通知偏好

电话上的设置会分别配置每个对齐的计算机. 决定只是默认:批准、问题和问题。 完成通知可立即发出,或分为15-、30-或60分钟摘要。 工程可以哑音或打呼一到八个小时. 静时使用手机所选择的时区,包括防日变化. 连接器接收到这些首选项加密,并在API发送通则推前应用. 静态事件不会产生推力;会话状态在仪表板上仍然可用.

裁决要简短地等待,这样自动解决的批准不会打断当事人。 在提醒之前,再次检查了静静时间的要求。 等待提醒在对接键下重新启动加密连接器 。 完成意味着现场谈话变得无所事事,没有已知的儿童仍在工作或等待关注;它不能证明任务是否成功。 一份摘要开启了最近的对话。 没有可靠活状态的适配器仍然可以发出明确的输入提示,但不能建立完成. 目前适配器无法提供桌面焦点,因此使用计算机不会压制电话警报.

用法重置提醒默认启用,可以在设置中禁用每个计算机 → 注意偏好 → 用法重置. 它们遵循当地供应商的仪表(目前为Codex和Claude代码)已经报告的重设时间戳,用于非零用量的窗口。 一个供应商/账户的同步窗口发出一个提醒。 静时会推迟一个仍然相关的重置;过期的提醒、签出和替换重置时间被丢弃。 待发催复通知时保持本地加密,小的散列收讫会防止重启后重复提醒. 同一登录的不可用计量表保留了它先前公布的截止日期;陈旧的历史从未发明过另一个反复出现的重置. 电脑必须运行 发送警报。 Push 文本只表示使用量允许重置; 窃听打开了计算机的使用部分.

批准推手持不透明的开除身份证 计算机在其加密的提醒中保留已交付的请求,直到当地国家确认其得到解决,包括编辑器或代理人作出的决定。 未知或断开状态不能忽略它 。 API只向发布支持广告的电话发出无声取消;Android和iOS删除了准确的通知并记得一组被封禁的ID来压制被延迟的重复. iOS的背景投递受制于OS的调度. 这需要更新API,连接器和原生应用程序;更古老的应用程序保持正常的提醒.

## 现有现场会议

Dashup发现了现有的本地OpenCode收听器,Codex控制套接字,和VS代码代理主机端点. 这些连接仍然是局部的;其信使从未被送到Parcae或电话. 本地端点被检查为本地所有或回回回访问,并拒绝重定向和远程端点URL.

-   **打开代码 :** 现有的 TUI/ server 提供对话,活事件,提示,本地工具权限,以及问题,电话回答或跳过. 答复针对的是最初的会话ID,并保留其最新的本地代理、模型和变体。 对于现有的会话, Dashup 不运行 `opencode serve` 或者创造另一个。 OpenCode 2的背景服务从它保存的记录中找到(`~/.local/state/opencode/service.json`,每个请求需要的密码),并通过其 `/api`,其对话从 OpenCode 的数据库中读取(`session_v2` 财务报告和审定财务报表 `session_message`) (中文(简体) ). 在最新历史网页之外积极活动的人由他们的本地身份证获取。 当多个 OpenCode 服务器列出相同的已保存的对话时, 报告当前工作或待选选择的服务器会提供其状态和控制; 闲置的历史视图无法隐藏它 .
-   **代码 :** 已装入的线程 。 状态和控制是独立于对话历史,包括被标注的历史阅读的。 答复需要识别的本地服务器和一个仍然被装入并接受直接输入的线程,然后立即发送. Codex 0.165和较新的可以在运行转折时接收回覆;更早支持的服务器需要闲置的线程. 对于已有的线程, Dashup从不呼叫 `thread/start`, (中文(简体) ), `thread/resume`,或 `session/load`. 批准控制只显示为路由到此连接的本地请求;另一个客户拥有的批准可能仅保留在原始的UI中.
-   **VS 代码 :** 微软的官方AHP客户端订阅了现有的主机会话和聊天. 原生选择被保留,交付得到主办方的认可. 没有可用的代理主机的旧扩展主机聊天仍然保存了历史. AHP聊天ID被命名空间而不是猜测到平等的CLI线程ID. 非文件远程 AHP 工作空间 URI 不显示为本地执行环境 .
-   **克劳德代码 :** 现有的笔录可以读取而不开始克劳德. `dashup install` 将 Dashup 的插件添加到 Claude 代码(`dashup@dashup`,从此包中读取 `claude/` 文件夹)和 `dashup uninstall` 将取去. 以插件开始的会话会保留一条对流 `~/.dashup/claude.sock` 结束 `curl`,然后将每个回复作为个人的单词;从 `/` 运行命令。 插件还将每个权限请求,会话等待到电话上:一个允许一次或根据规则克洛德码建议,提问,或者计划的工具. 计算机上的对话框,或主持会话的编辑器,保持开放,第一个答案获胜. Claude Code只允许那里的人或其主机批准一个计划,因此电话只能将运行的会话计划带回更改的内容. Claude Code的收件箱套接字没有被使用,因为Claude将发布在那里的任何东西作为另一个会话的信息,没有人物的授权. 插件安装前打开的会话,以及Windows上的会话,保留只读.

原生的收听器发现支持主机可用的进程/socket接口. 文件与套接字格式是版本执行边界;不可用或不熟悉的界面留下历史可读性,控制被禁用. 当 Dashup 连接器断开时,现有的编辑器和代理程序会独立地继续. PC所保存的SSH关系被保留;读取它不会允许远程机器的CLI商店访问.

现有Zed/Codex会话的证明记录了原生队列的复制交付,并且观察者和连接器都针对一个不变的原始进程重启. 单独的产品 **队列回复** 适配器支持本地Linux Codex 0.153.4,0.160.1,0.164.0和0.165.0,包括桌面捆绑,npm包和私人-stdio所有者. 该版本出自准确运行的二进制,而非其软件包布局. 它需要精确的本地线程的自有作家锁定,推出文件,队列数据库,进程启动时间和可执行版本. 匹配的目录或复制的笔录不准许队列访问 。 在已安装的0.153.4、0.164.0和0.165.0二进制上进行孤立的本土检查核实了队列接受和客户端信息身份;连接器回归测试涵盖所有权和接收处理。 这些版本的端到端电话发送仍未核实.

只有明确的队列回复启动一个临时的官方应用程序服务器帮助初始化和呼叫 `thread/queue/add` 在同一个本地家庭。 它不启动、恢复或加载代理线程。 一个持久的本地意向在发送前记录呼叫者提供的本地客户端消息ID. 中断的确认使请求得不到确认,并防止自动重新提交,包括在连接器重新启动之后。 如果项目离开队列,则保留已知的接受;失踪不是交付.

交付需要在原始线程的本土历史数据库中输入准确的客户端-消息ID. 回复收据需要同一回转的后期本地助理物品;这并不意味着代理完成. 接收通过加密的活会话套接字。 打开一条线程读取一个被绑定的最新页面; 选中的本地更改在没有投票数据库历史的情况下更新该窗口 。 Writer 所有权也允许在未知版本上不准许队列访问的情况下进行生命周期状态,并阻止连接器恢复另一个进程所持有的对话. 私人-stdio进程拥有的土著批准仍然得不到支持,需要其原始的UI. 队列文本绝不取代本土批准.

每个线索都显示它自己的记录 说它最后一次运行。 Claude Code会话显示了它最新回复的模型,如果模型使用它们,则显示快速模式和超编码;选择和名称是会议本身的Claude Code 二进制在初始化回复中提供主机的模型,或者 `claude`'是系统不给二进制命名的地方. 一个 Codex 线程显示其最新转弯的模型和推理努力,如果模型具有优先级,则快速模式,由 Codex 自己命名 `models_cache.json`。一个 OpenCode 会话显示模型和代理 OpenCode 保存在会话上(`/api/session`),作为人物最喜爱的和最近的模型之一,作为OpenCode的TUI保存了这些模型(OpenCode's TUI)`model.json`),以其目录命名,并列出文件夹的主要代理. Kimi只记录一个会话的计划模式,所以电话运行的会话显示这个模式,并思考它从这个模式开始,在Kimi的模型中 `config.toml` 名称。 只有在代理记录发生变化时,例如超密码或Codex的分级记录才会被搜索,无论它是否在很长的一段时间内被检测到。 保存的线程携带着这些,没有选择,只保存在自己的已公布状态下,从不保存在仪表板上.

手机会更改运行的会话设置: 通过克劳德插件与克劳德代码自己的 `/model`, (中文(简体) ), `/fast` 财务报告和审定财务报表 `/effort ultracode` 命令; 在克劳德会话中, 电话启动, 在每个回合开始时有控制请求; 在编码线条中, 连接器持有, 下一个 `turn/start` 它发送;在OpenCode会话中,在会话本身上,所以电话的信息会随它运行;在Kimi会话中,随着它的下个回合的开始,电话会随时间而运行,即刻以计划模式运行. 一个代理记录下个回合开始时的变化,所以它从下个回复中显示出来. 更改需要实时连接, 并且从不为离线计算机排队 .

停止中断运行通过每个活界面: OpenCode 会话中止, Codex `turn/interrupt`,AHP客户端取消,ACP `session/cancel`,则克洛德代码插件的转动中止。 它在无所事事的情况下拒绝,并且只能通过连接的活会话发送.

现场发现以每个端点最近的100个会话为限;OpenCode 2还包含该页外最多100个活跃会话. OpenCode 提供最新的200个消息; VS 代码主机提供当前聊天快照. 页面历史倾向于在可用时使用本地保存的商店,否则会使用已存在的活的快照. 其实际命令或文件内容无法被预览的审批会在计算机上获得批准;当本地协议支持时,否决仍然可用.

线程上下文测量仪显示代理商最近报告的符数和上下文容量. Codex通过现场使用活动或节省的推出提供这些;非加太会议可以提供 `usage_update`。当一个实时报告无法提供时,包括在 Codex 收缩时,电量表就清除了,当计算机断开时则隐藏。 没有可靠统计和能力的其他整合没有显示计量表。 上下文只计算在所选线程加密活态中的旅行,与账户使用限制分开.

当本地代理报告时, 自动模式出现在模型旁边 。 主办克洛德会话使用本地权限-模式控制;Codex在下个回合应用其批准审查器而无需更改沙盒. Claude 插件本身无法更改权限模式, 因此控制仍然只读在那里 。 包装的非加太会议揭示了代理商的本土模式和模式选择,只有在代理商接受这些选择后才承认变化.

## 克林、皮、克洛码和朱尼

这些集成使用本地界面. 对话与命令进入已存在的配对-device加密路径;其本地令牌从不去接力.

| 探员 | 连接到 | 电话控制 |
| --- | --- | --- |
| 线 | 现有的经认证的本地SDK/CLI中枢 | 答复、队列/队列、中断和本地允许/拒绝决定 |
| Pi | 现有互动 Pi 进程内的 Dashup 包 | 答复、后续排队、引导和中断;扩展问题留在计算机上 |
| Kilo 代码 | 它现有的本地守护进程 | 读取、答复、队列/队列、中断、权限和问题;明确启动会话 |
| 朱妮 | 非加太会议由Dashup开始;保存了本地历史 | 在电话启动的会话中回复、中断和本地权限; 读取导入的历史 |

**线条 :** 启动 Cline 时通常使用一个暴露其本地中枢的版本. Dashup读了克莱恩的私人发现记录 `~/.cline/data/locks/hub/owners` (或克莱恩的) `CLINE_DATA_DIR` 编号 : `CLINE_HUB_DISCOVERY_PATH`) (中文(简体) ). 发现从不创建或恢复克林会话. 此选项不附加到旧的 Cline 编辑器扩展名中, 没有中枢 .

**皮:** `dashup install` 使用 `pi install <connector-install>/pi`运行 `/reload` 在已经开放的 Pi会话中。 为了退房, `pi install /absolute/path/to/apps/connector/pi` 做同样的. `dashup uninstall` 通过 Pi 的 CLI 删除已安装的软件包 。 该软件包运行在已存在的TUI内部并发布一个经过认证的私有回路桥;其注册中包含连接证书,而不是对话文本. Dashup不发射Pi或将扩展问题变成普通的快取.

**Kilo 代码 :** 运行 `kilo daemon start` 并使用守护进程。 Dashup读它的私人 `daemon.json`包括Kilo的保留 `data/kilo/state` 倒置,然后使用本地认证的 API 。 此守护进程以外的独立 TUI/服务器不为此集成所附加 。 Dashup 在发现会话时不会启动守护进程 。 编辑权限而不在计算机上保留完整的diff;显示的持续权限包括其保存的规则范围. Kilo已经拥有自己的移动应用程序;Dashup添加了共享代理收件箱和配对设备传输.

**朱妮:** 安装朱尼,并在从电话开始朱尼会话之前正常认证. Dashup 阅读本地会话索引并致力于用户/最后回答活动 `~/.junie/sessions`; 内部状态blobs 不是对话信息 。 它运行 `junie --acp true` 以明确电话启动。 被导入的历史只保留读取,因为朱尼的索引和终端进程注册无法证明另一个非加太进程释放了会话. 它不附加在运行中的 EIDO 或终端会话中 。 编辑拥有的ACP会话可以使用下面的可选包装. 朱尼自己的许可选项和证书错误被保留.

运输检查使用已公布的克线核心0.2.0中枢,Pi 0.80.10,Kilo 7.8.18和Junie 3110.7.0. Pi的交互式证明使用本地模拟模型,其原始过程和会话相同. Cline的证明使用具有常住测试运行时间的生产中枢;Kilo的原生证明在不引用模型或工具的情况下承认输入和回答权限. 朱尼的本地模拟模型证明开始一个会话,并读取其本土被拯救的历史. 其明确的本土载荷测试在关闭了原始过程后验证同一ID还原;这不能确定进口产品历史的所有权。 这些检查并不建立每一个编辑器集成或提供者配置.

## 从电话开始会话

电话在本地项目中启动会话, 或在已持有此计算机项目的文件夹之一的新文件夹中启动会话, Klaude Code、 Codex、 Kimi 或 OpenCode: 任意 `claude`, (中文(简体) ), `codex`, (中文(简体) ), `kimi` 财务报告和审定财务报表 `opencode` 并安装了Kimi Zed的代理注册 `kimi` 不是在路径上。 代理根据自己的设置和许可规则工作,在他们不允许的事情发生之前询问电话. 克劳德代码运行无头( Claude Code)`claude -p`)每个转弯并恢复下个会话; Codex 线程开始于 Codex 自己的应用服务器守护进程(`codex app-server daemon start`),并超过连接器; OpenCode 会话运行在 OpenCode 2 的背景服务中, 否则运行于 a `opencode serve` 该文件夹的连接器开始; Kimi 运行其线条模式(`kimi --wire`) 连接器选择的会话代号下每转一个会话,电话会回答它的赞同和问题. Claude Code的许可请求随命令而来,或者diff一个编辑或写作会做出,以及会阻止它再次询问的规则;电话作为Claude Code的主机回答了它的问题和计划.

新的克洛德和Codex会话在第一个消息之前提供了计算机的本土模型目录. 所选择的模型是加密起动命令的一部分,并适用于第一个转弯. 其他代理在没有起始时间目录的情况下保留其本地默认值.

电话启动的会话保留了本地的ID和历史,但Zed不会自动添加到它的侧边栏. 在连接执行主机的 Zed 窗口中,打开侧边栏的时钟按钮, 选择 **导入线索**,选择代理和导入。 导入的条目开始存档于 Thread History; 打开一个以恢复到侧边栏 。 SSH项目必须使用其远程代理历史,而不是复制的本地语录.

当一个被保存的对话的代理商在这里运行时,其项目是局部的,没有其他东西打开:克洛德代码恢复它(Claude Code)`claude -p --resume`),Codex在它的守护进程中加载它(`thread/resume`Kimi), Kimi 恢复原样(`kimi --wire --session`),并且 OpenCode 为它的文件夹服务。 一个本地的 Codex 进程会接收排队的消息 。 启动需要连接的计算机.

Kilo Code 在其本地守护进程可用时提供; Junie 在其命令安装时提供. 两人均保留本地会话身份证. Cline和Pi通过他们现有的活络出现,没有作为代理Dashup可以发射而提供.

对于已有承诺的 Git 项目, New session 提供当前检出, 新的工作树, 或在该仓库注册的现有工作树 。 一个新的工作树从选定的分支创建选定的分支, 或在兄弟会中承诺 `<project>.worktrees` 目录。 它留下了原始的离职 和它的未承诺的变化。 现有工作树选择只接受该寄存器的路径 Git 列表 。 一个寄存器子目录内的一个项目从选定工作树的同个子目录开始;一个没有该文件夹的分支被拒绝. Dashup不会自动执行,移动更改,去掉工作树,或者通过替换分支来重试失败的代理发射. 在一种剂未能发射之前创建的工作树仍然可供再利用.

从一个线的菜单, **继续使用另一个代理** 在同一项目中打开一个新会话草稿。 审查所选信件文本,删除信件,选择代理和取出,并添加下一个请求. 交接处保留了对已装入信件的限定选择,以配合其角色;预览被贴上标签,并注意省略的内容. 附件、待答复和本地代理状态不复制。 原始线条及其草稿仍然完好无损. 新的要求是分开提出的,从不缩短,以适应情况。 开始使用与其它任何新对话相同的加密直播命令和本地会话所有权.

## 终端对话

新终端在所选的本地项目中开始一个新鲜的外壳并打开它与代理商相同的对话列表和作曲. 它的对话显示一个活的终端屏幕,包括了终端应用程序使用的颜色,光标位置和备用屏幕. 作曲和键盘控制器会写给真实的PTY;作曲者可以提交一行或发送文本而无需Enter. 停止发送 Ctrl- C 到前景进程 。 关闭终端结束外壳. 外壳保留其工作目录和环境,随连接器的操作系统权限而运行,并留在配对计算机上. 对于一个SSH项目,先将执行主机自己配对后再开始其终端.

一个终端属于创建它的电话. 其他配对电话无法看到其实例或发送输入. 输入和原始终端输出使用活加密的WebSocket管,与其他活会话流量共享. 服务器在不存储终端输入或输出的情况下运行密码文本. 只有该电话流目前连接的终端输出;离开它或断开连接会停止该流. 输入只在连接时发送,并且从不为以后的执行排队. 终端附件不被接受为命令 .

最多可有8个炮弹可以同时运行. 私人文件 `terminals/` 旁边 `connector.json` 仅保留实例元数据,包括所有权、项目和退出状态。 没有终端聊天信息或已保存的笔录. 内膜终端仿真器在手机重联时会恢复当前屏幕. 关闭应用让外壳运行;关闭外壳,取消外壳的配对,或停止连接器将外壳结束. 连接器重新启动后, 保存的事件会关闭, 新终端会启动一个新的 shell .

打开的代理谈话附加在同一加密会话传输中. 它最新的有界消息页面在详细线索状态之前到达,没有等待仪表板写入或扫描其他项目. 背景源发现仍然独立于所选的对话. 关闭对话解开其流;本地代理持续运行.

## 审查项目变化

对照总部或选定的分支或承诺,审查更改。 它包括了被分级,未分级和未跟踪的文件,并带有有边框的文本diff和二进制文件标记. 屏幕将这些标签作为当前工程的更改,因为多个代理和编辑可以共享一次出票. 它没有推断哪一届会议作了修改。 点击 diff 线以添加评论; 打开与实时回复连接的对话的回评让电话将评论发回该会话 。 删除行注释保留其旧侧行号.

运行检查会执行该人进入项目寄存器根中的命令,并有连接器的操作系统权限. 它记录实际指挥,退出状态,输出和时间. 检查在2分钟后停止,其输出被限制,并停止连接器停止其活性检查. 每一次只检查一次 最近的三次检查结果一直保存在连接器内存中,直到重新启动为止. 内容指纹,包括未承诺和未跟踪的文件,在检查前与状态不同时,标记结果停滞。 经纪人的测试通过的声明不是记录的支票. Git检查和检查结果对请求配对的电话进行加密.

## 从电话发送的文件

手机在上传之前对所选图像和文件加密. 组合连接器的下载并解密到它的私密 `uploads` 目录旁边 `connector.json`;中继和对象存储接收密码文本. 文件名称无法在该目录外选择一个目的地, 并且拒绝现有的同名链接或冲突文件 。 当地拷贝留在那里直到移除.

信件包括本地文件路径, 这样现有的代理可以凭其通常的权限读取它们. Codex现场回复和电话启动或恢复的Codex会话也收到支持的图像作为本地本地图像输入. Claude Code会话通过 Dashup 的无头主机开始或恢复,接收支持的图像作为原生的 Base64 图像块. 其他集成,包括克洛德插件和本地队列回复,都收到文件-路径上下文;这并不意味着每个代理或模型都有本地图像输入支持. 被支持的本土图像MIME类型有PNG,JPEG,GIF和WebP等. 模型和代理仍然决定着他们可以解释哪些文件.

连接器测试包括真实的临时 Git 工作树,编辑后的 stale checks, 处理超时和关闭, 认证附件解密, 路径封禁, 以及图像输入对模拟 Claude 和 Codex 传输。 这些检查并不确立每个主机的真电话行为或提供者支持的图像解释.

## 可选非加太包装

默认历史和本地主机路径不需要包装或编辑器配置 。 对于一个明确配置的外部ACP代理,使用连接器作为编辑器的stdio包装;它使用官方的ACP SDK协议合同:

```sh
dashup acp -- /absolute/path/to/original-agent ORIGINAL_ARGUMENTS
```

安装 `dashup` 在全球范围设置编辑器现有的代理命令,并附上参数. 先启动连接器并通过编辑器配置启动代理. 代理开始原指令一次并转发编辑器自己的ACP流. 电话留言和批准选择都采用同样的程序和会议。 只有本地批准的选择,包括代理提供时的本地文件范围. 打开电话线程时, 代理不会创建另一个会话 .

包装和连接器必须运行在同一执行主机上. 对于SSH项目,在配置其命令之前,确认该特定外部代理运行的地点; [Zed将外部代理运行时间和认证视为代理拥有](https://zed.dev/docs/ai/external-agents#remote-projects)。如果开发机器拥有包装程序,则该机器单独对等。 读取 PC 保存的 SSH 项目不会附加到远程代理进程上.

包装器无法追溯到已经运行的 stdio 流 。 保存的历史不是一个活的会话控件 。 Zed的内置代理和提供商没有支持的本地附加接口,仍然只在Dashup中被读取. 如果连接器重启,原始包裹的代理继续,但这个可选的包件目前需要重启以恢复其观察者连接.

## 开始于登录

回答“是”的背景问题或运行 `dashup install` 在对齐的计算机上,注册一个 macOS LaunchAgent, Windows Startup 条目,或 Linux 用户系统化服务并启动,从已经运行的状态文件连接器中接管。 服务运行 `watch` 与它配对的状态文件( w)`DASHUP_CONFIG`) (中文(简体) ). Linux 需要用户系统化会话; 没有桌面会话, 如在 SSH 上, 安装也会打开悬存的会话, 因此在您登录完后服务会继续运行 。 在 npx 或 pnpm dlx 下, 服务运行一个存储的安装副本 `app/` 状态文件旁边; 检查或全局安装运行到位 。 节点可执行文件必须留在已安装的位置。 未包含已签名的桌面安装器 .

`dashup uninstall` 停止 Dashup 并删除启动条目及其 `app/` 复制; 电脑保持对接 . `dashup stop` 停止服务直到下一个登录;崩溃重新启动它.

## 地方政府和检查

`~/.dashup/connector.json` 持有这台计算机的秘密,配对密钥,加密待发提醒,通知首选,仪表盘序列计数器和小型本土交接收据. 它在解剖学上带有私有的Unix权限;目前不受OS证书金库的保护. 不要共享或复制到另一个连接器. `DASHUP_CONFIG` 选择单独的状态文件. `DASHUP_ZED_DATA` 财务报告和审定财务报表 `DASHUP_VSCODE_DATA` 选择自定义编辑器数据目录。 土著历史发现荣誉 `CLAUDE_CONFIG_DIR`, (中文(简体) ), `CODEX_HOME`, (中文(简体) ), `DASHUP_KIMI_HOME` (次数) `~/.kimi`XDG 路径。 代理历史按要求本地解析; 终端文件仅包含有边框的实例元数据 .

从一次离职,运行 `pnpm install` 财务报告和审定财务报表 `pnpm --filter @dashup/connector... build` ,然后使用 `pnpm --filter @dashup/connector dashup` 替换 `dashup`对于孤立的开发装置, `DASHUP_LIVE_DISCOVERY=0` 禁用自动进程发现。 明确 `DASHUP_OPENCODE_ENDPOINT`, (中文(简体) ), `DASHUP_CODEX_SOCKET`,以及 `DASHUP_AHP_DATA` 覆盖允许本地测试端点而不修改编辑器配置 。 普通的发现不需要它们.

`DASHUP_PI_DIRECTORY` 选择私有 Pi 注册目录. `DASHUP_KILO_DAEMON` 选择本地 Kilo 守护进程记录, `DASHUP_JUNIE_COMMAND` 选择一个绝对的 Junie 可执行文件,并且 `DASHUP_JUNIE_HOME` 选择朱尼的故乡。 这些超接仍然执行本地认证,不允许远程HTTP端点. 原生烟雾测试采用 `DASHUP_PI_CLI`, (中文(简体) ), `DASHUP_KILO_CLI` 财务报告和审定财务报表 `DASHUP_JUNIE_CLI`,指其已安装的二进制或CLI出入口;它们使用孤立的临时数据和本地固定装置.

```sh
pnpm --filter @dashup/connector test
pnpm --filter @dashup/connector check-types
pnpm --filter @dashup/connector build
TEST_API_URL=http://127.0.0.1:3049 pnpm --filter @dashup/connector test:workflow
```

工作流程测试需要运行一个孤立的Dashup API和数据库. 它创建可支配账户并验证对等,加密仪表板替换,直接限定本地聊天页面,命令分解,离线行为和在真实会话套接字上被撤销. 单位定着会执行真实的本土文件格式,HTTP/SSE,Unix WebSockets,以及官方的AHP客户端. 实际编辑器UI兼容性,macOS/Windows启动,和生产推力证书需要各自的主机和证书.

## 让代理商询问电话输入

运行 `dashup phone-tools` 作为同一计算机上的 MCP stdio 服务器 `DASHUP_CONFIG` 作为运行的连接器。 对于接受JSON配置的MCP客户端:

```json
{
  "mcpServers": {
    "dashup-phone": { "command": "dashup", "args": ["phone-tools"] }
  }
}
```

`phone_list` 列出带有 Dashup 打开的配对电话. `phone_request` 使用一个 `kind` (单位:千美元)`photo`, (中文(简体) ), `screenshot`, (中文(简体) ), `file`, (中文(简体) ), `sketch`, (中文(简体) ), `choice`,或 `text`)和a 数据 `prompt` 解释经纪人需要什么 选择请求还需要两个到十二个不同的 `choices`如果几通电话打开,请通过 `pairing` 从 `phone_list`可选 `projectId` 财务报告和审定财务报表 `threadId` 确定最初的工作; `timeoutMs` 10-300秒,默认为120秒.

该人明确拍照,选择截图/文件,对图像进行注释,绘制草图,或回答请求. 无所取被默取. 他们审查后选择 **发送到代理**。照片和截图在发送前打开绘图表面。 连接器返回答案和私有本地文件路径;代理在其计算机上读取这些文件. 附件字节在上传前被加密,仅在对齐的计算机上打开. Android相机使用一个临时的私人缓存文件,在抓取完成后被删除;被接受的图像使用被捆绑的本土内存手柄.

最多四个请求可以同时等待. 离开应用程序则会取消请求, 过期、 MCP 取消、 断开、 不铺张、 连接器关闭丢弃器等待请求 。 重新连接不会重放它们 。 没有数据库行、 离线队列或永久请求日记 .

## 现有的 T3 代码和 Orca 聊天

Dashup附属于已经运行的,同用本地工人。 发现者读取他们的当前会话目录;它从不启动工作台,创建线程,导入对话,或启动提供者. T3代码使用它 [v0.1.5 协议-2 HTTP 和 WebSocket 接口](https://github.com/pingdotgg/t3code/blob/v0.1.5/packages/contracts/src/environmentHttp.ts). Orca 使用其 [v1.4.244 当地CLI IPC](https://github.com/stablyai/orca/blob/v1.4.244/src/cli/runtime/transport.ts)现有土著会议证仍然是发送、停止和支持批准选择的所有人.

T3代码发现读取 `~/.t3/userdata/server-runtime.json`,荣誉 `T3CODE_HOME` 或者说 `DASHUP_T3_BASE_DIR`。安装 `t3` CLI必须在连接器的路径上; `DASHUP_T3_CLI` 选择另一个可执行文件。 只打个破电话 `t3 auth session issue`,与 `orchestration:read` 财务报告和审定财务报表 `orchestration:operate` 瞄准镜和十分钟的寿命 官方认证命令打开现有的本地认证存储, 并且从不启动它的服务器或代理 。 无记名者留在连接器内存中,从不记录或发送过程参数,在T3中过期. 现有的私人 JSON 证书文件可以选择 `DASHUP_T3_AUTH_FILE`;必须包含 `origin`, (中文(简体) ), `token`标准化 `expiresAt`,属于准确的地方环境。 仅接受不可信回回回回回回回回回回回回回回回回回回回回回回回回回回回回回回回回回回回回回回回回回回回回回回回回回回回回回回回回回回回回回回回回回回回回回回回回回回回回回回回回回回回回回回回回回回回回回回回回回回回回回回回回回回回回回回回回回回回回回回回回回回回回回回回回回回回回回回回回回回回回回回回回回回回回回回回回回回回回回回回回回回回回回回回回回回回回回回回回回回回回回回回回回回回回回回回回回回回回回回回回回回回回回回回回回回回回回回回回回回回回回回回回回回回回回回回回回回回回回回回回回回回回回回回回回回回.

奥尔卡发现读其私人 `orca-runtime.json` 在本地应用程序数据目录中,尊重 `ORCA_USER_DATA_PATH`· ; `DASHUP_ORCA_DISCOVERY_PATH` 选择一个明确的记录。 连接器接受从该记录中取出一个当前用户Unix socket或本地Windows命名的管,计算机上保留了原生证书. 它暴露出现有的本地结构聊天标签. 远程主机工作空间和终端专用标签仍留在Orca. Orca发送/停止操作使用其运行时间栅栏和有效载荷指纹,批准答案将准确的项目修改命名在屏幕上.

只有选中的对话加载信件内容 。 两个集成在每页最多返回了30个本土消息行,然后加密的电话传输应用了自己的字节/文本限制和全信息页. Orca读取了30个条目的日记尾;T3的原生字节所绑定的历史窗口留在了计算机上,同时从中选择了更小的页面. 离开谈话 释放窗口和等待批准查看。 选中的最新页面在可见时刷新; 旧的页面不会投票 。 Dashup没有保存的文字记录。 文本,工具预览,发送,停止,以及简单的本土审批选择都得到了支持;复杂的本土问题表,本土配置菜单,附件细节留在了工作区. Orca接受电话图像作为本地图像参考;T3附件在T3本身中被添加.

## 常见问题

### @dashup/connector 是什么？

在每台计算机的编辑器旁运行,包括Zed窗口连接在SSH上的开发机的PC\. Dashup 保留了保存了 SSH 关系; 它不会启动替换 SSH 会话 \.

### 如何安装 @dashup/connector？

在项目目录运行 npm install @dashup/connector，或使用 pnpm add / yarn add / bun add。它还提供命令行工具 dashup，可以用 npx dashup 直接运行。

### @dashup/connector 支持 TypeScript 吗？

该包的 package\.json 没有声明类型入口。需要类型提示时，可以在 npm 上查找社区维护的 @types/dashup\_\_connector 是否存在。

### @dashup/connector 支持 ESM 还是 CommonJS？

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

### @dashup/connector 需要什么版本的 Node\.js？

package\.json 的 engines 字段要求 Node\.js \>=24\.0\.0。版本不符时 npm 默认只给出警告，开启 engine-strict 后会拒绝安装。

### @dashup/connector 可以商用吗？

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

### @dashup/connector 的下载量有多少？

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

### @dashup/connector 还在维护吗？

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

