@dezignerdrugz/ade

中文文档
0.1.12发布于 2026/11/12MITES Module近 30 天下载 2200

ADE:一个在您机器上驱动编码代理CLIS(Codex,OpenCode,Pi,Claude Code)的本地网络UI.

中文使用文档
文档目录10 节
  1. 本地运行
  2. 快开始
  3. 用你的手机或者其他电脑
  4. 从源头运行
  5. 代理和认证
  6. 代理浏览器
  7. 安全和目前的限制
  8. 建筑
  9. 许可证
  10. 检查

ADE 本地代理工作空间

ADE是本地编码代理CLI的开源工作空间. 它不需要ADE账户、托管后端或中继器。 最初的可爱屏幕是模拟;目前的应用用读取本地文件系统并启动已安装的CLI进程的一个节点服务取代了它的种子项目,生成代理运行,假入和被伪造的diffs.

本地运行

要求: Node.js 22+和 Git. 安装您计划使用的编码代理CLI。 终端和浏览器是可选的.

快开始

运行 ADE 不克隆寄存器或安装其开发依赖:

npx @dezignerdrugz/ade

打开打印地址( 默认情况下) http://127.0.0.1:3100) (中文(简体) ). 要选择端口或自动打开端口:

npx @dezignerdrugz/ade --port 3200 --open

用你的手机或者其他电脑

npx @dezignerdrugz/ade --remote

ADE 在通常地址旁边打印一个登录链接 :

ADE is running.
  This computer:  http://127.0.0.1:3100
  Your devices:   http://192.168.1.135:3100/?token=…  (same Wi-Fi)
Open a link once on each phone or laptop; it stays signed in. Ctrl+C stops ADE.
Wi-Fi links are plain HTTP: fine at home, not on public Wi-Fi.

在连接同一无线的电话或笔记本电脑上打开链接. 它标志浏览器进入并打开ADE;从此在平面地址上(http://192.168.1.135:3100在那里工作过。 没有账户、密码或配置 :

  • 链接保持不变. ADE 一次做访问标志 并保存在 ~/.ade/remote-token。删除此文件以签名每个设备退出;下一个 ade --remote 创建新的链接.
  • 仅限主网. Wi-Fi链接为平版HTTP,因此同一网络上的任何人都可以在中途读取. 在家里使用,不公开或共享Wi-Fi.
  • 分级是可选的. 若为 分级 已连接, ADE 添加了从您的 Tailscale 设备中运行的第二个链接: HTTPS 通过 tailscale serve 当 ADE 运行(当您的尾网有 HTTPS 证书打开时) 时, 否则是纯尾网地址 。 当 ADE 停止时, 您的分级设置中没有留下任何东西 .
  • 一些工具留在这台电脑上. 内置终端,文件编辑器,以及安装或更新代理CLIS只在运行ADE的计算机上工作.
  • 另一个端口 : ade --remote --port 3200Ctrl+C 停止 ADE, 链接停止工作直到运行 ade --remote 再来一次.

如果链接不打开其他设备,请检查是否两者在同一网络上(客人和办公室网络经常将设备分开),此计算机的防火墙允许ADE端口接入连接,而且自ADE启动以来,此计算机的地址没有改变.

检查这个机器的设置 npx @dezignerdrugz/ade doctor。内置终端是可选的;当其平台二进制不可用时,ADE的其余部分仍然有效. ade browser-setup 解释或安装Chrome在所支持的Linux系统中所需的主机包.

从源头运行

为了开发,复制存储器并安装其开发依赖:

npm install
npm run dev

打开 http://127.0.0.1:3100 (dev服务器被固定在那里,与安装的端口相同) ade ,因此一次运行一次; 覆盖到 npm run dev -- --port <n>) (中文(简体) ). 开发服务器和 API 绑定到 127.0.0.1 默认的,不是局域网; ADE_HOST编号 :ADE_TOKEN (下文)适用于 npm run dev {\fn黑体\fs22\bord1\shad0\3ahbe\4ah00\fscx67\fscy66\2chffffff\3ch808080}还有一个没有落地的 ADE_HOST 无 ADE_TOKEN 使 dev 服务器拒绝启动 。 要运行已建的, 自托管的节点服务器 :

npm run build
npm start

那个服务器在听 127.0.0.1:3100 (与 PORT=... npm start) (中文(简体) ). 要轻松地与您的其他设备共享源检出, 请运行 node bin/ade.mjs --remote 之后 npm run build (见 用你的手机或者其他电脑 以上);本段其余部分描述了它使用的手动设置. 它只保留回放,除非您明确选择 : set ADE_HOST (或通过) ade --host)到局域网/Tailscale接口地址(或 0.0.0.0(中文(简体) ) 财务报告和审定财务报表 ADE_TOKEN 至一个不空的秘密openssl rand -hex 16);没有符号 scripts/start-local.mjs 拒绝在非浏览地址上听 退出 1。 在曝光模式下 /api 非浏览客户端的请求必须证明该符号——如 Authorization: Bearer <ADE_TOKEN> 用于脚本,或通过 HttpOnly ade_auth {\fn黑体\fs22\bord1\shad0\3aHBE\4aH00\fscx67\fscy66\2cHFFFFFF\3cH808080}UI的标志门 {\fn黑体\fs22\bord1\shad0\3aHBE\4aH00\fscx67\fscy66\2cHFFFFFF\3cH808080}通过Posting the sording to /api/auth 一次(错误的符号得到401). 具体 ADE_HOST 还将请求的主机头与该地址相提并论,作为DNS重装围栏; ADE_HOST=0.0.0.0 (或 ::) 横跨每个接口并接受任何主机名,而符号仍为门. 环背客户端——这台机器上的代理CLIs和ADE——无论哪种方式都免去符号. Plain HTTP 将符号装入清晰的符号中, 因此更喜欢一个 Tailscale 地址, 或保留默认的回回绑并用它前置 tailscale serve --bg https / http://127.0.0.1:3100:然后请求从本地代理到达,远程浏览器得到HTTPS. 无 ADE_TOKEN 代理是唯一的门;与之相通,代理浏览器也必须证明该指使(一个尾网可以包括其他人). 打开任何 ADE 页面 ?token=<ADE_TOKEN> 显示浏览器的相同方式,然后重新装入没有符号的页面,使其不停留在地址栏中.

从中添加一个工程 + 键 按钮,以三种方式之一: 已有文件夹 (本地取取器, ADE 自己的文件夹浏览器, 否则, 或输入其本地路径); 从 GitHub 复制 输入您选择的文件夹( e)owner/repo, GitHub URL,或 SSH 地址——运行 git clone 已禁用提示, 因此需要私有寄存器 gh auth login,在 ssh-agent; 拒绝带密码的地址和非远程路径;或 制作 新文件夹,可选择初始化为Git寄存器. 文件夹浏览器有一个 新文件夹 按钮用于创建目的地。 一个失败的克隆会移除它部分写的东西, 一个已有的文件夹永远不会被覆盖 。 要从工作区丢弃一个工程, 请使用 删除 在项目标题中:它只删除ADE在明确确认后对该项目的元数据(会话记录,处理条目),而绝不触及文件夹或其文件.

ADE 存储项目/会议元数据 ~/.ade/workspace.json 和 JSONL 文件的 CLI 日志 ~/.ade/session-logs/ (私人文件权限); Pi 会话文件处于 ~/.ade/sessions/。项目文件不会被复制到 ADE 中,供应商证书不会被写入 ADE 或项目文件.

代理和认证

ADE 检测已安装可执行文件, 并要求 CLI 报告其当前认证状态 。 它引用带有参数阵列(无外壳插值)的代理:

  • OpenAI 编码器 : codex exec --json --cd <project> --sandbox workspace-write …;恢复使用 Codex 的会话ID . codex login --device-auth 是一个实际支持的设备签名流,可以从 ADE 启动。 Codex自己的CLI管理其证书.
  • 打开代码 : opencode run --format json …;项目来自工作目录ADE 孕育了CLI in(opencode run 后续会议继续开会。 提供者证书由OpenCode管理(opencode auth login)在其用户级数据目录中。 OAuth 可用性取决于提供者;ADE并不要求每个提供者支持浏览器流.
  • 取型器 : 每个任务都可以选择在特定模型上运行. ADE 读取已安装的 CLI 本身的无配额,缓存备份的列表(codex debug models后退为 --bundled 离线; opencode models· ; pi --offline --list-models) ——它从未刷新过网络上的目录,也从未运送过一个静态的站立列表,所以你看到的是CLI目前为它所配置的供应商所暴露的. 所选模式作为 -m编号 :--model (单位:千美元)codex exec, (中文(简体) ), codex exec resume, (中文(简体) ), opencode run, (中文(简体) ), pi --model provider/id; 保留它未设置会完全省略国旗,所以代理使用自己配置的默认值. 该模型记录在会话上下文显示并显示在会话标题中. 一个模型 id 仅仅是字符验证(第一个字符为字母,所以它永远不能读取为 CLI 旗;然后字母,数字, . _ / : [ ] - +, 最大 256) ,并在 argv 阵列中逐字传递 —— ADE 不运行外壳, 模式 ids 被分割在第一个 / 只能由接收它们的CLI进行. 明确身份证明总是胜出:ADE从不为被选中的型号提供反对上市的门,也从未发明超出此范围的应享权利检查;CLI是权威,其真正的拒绝被浮出水面(见下文). 您可以从会话标题中更改会话模式; 更改适用于下一个 CLI 回合( 已运行的回合保留其当前模式), 采取者的"其他模式 id..."/ free- text 条目覆盖无法列出目录的账户 .
  • 模式列表被缓存 记忆和私人 ~/.ade 文件 (0600) 由代理按键 和 CLI 版本 (一个被替换/升级的CLI不能服务一个 stale 列表),有一个300秒的新鲜度窗口;列表是空的不是一个错误,它意味着没有在那个CLI中配置提供者,拾取者会因此回到手动输入.
  • 代理切换 : 一个会话可以通过 POST /api/sessions/:id/switch-agent。切换只保存选定的代理及其模型选项;它不会启动代理转动。 下一个用户消息开始与被选中的代理开始新的对话. 寄存器状态,任务,和当前 diff 结转,但先前的对话没有,会话记录了该披露. 模型标识和模型范围选项对所选代理人进行验证. 在运行 CLI 转弯和完成会话时拒绝切换.
  • 背景显示 : 每个代理都记录一份清单(项目/部门、任务、接受标准、限制、候选人档案) git ls-files,代理工具集,和脏-树状态)在会话中,表面显示为UI中可折叠的细节,并将已渲染的版本传递给CLI快取.
  • 皮探员: pi -p --mode json …; 转弯使用工程外的会话文件。 Pi 支持 /login ,但不会为这个浏览器 UI 显示一个支持的设备登录 API。 使用 pi 接下来 /login 在终端; ADE 不假冒登录。 Pi的认证报告被明确通过.
  • 克劳德代码 : ADE 检测自己的 claude 打开 PATH 不过你安装了它(Anthropic的安装器,npm,Homebrew,mise...),检查它的登录 claude auth status --json运行相同 claude; 您签入 claude auth login 在终端。 只有当 claude 缺少代理拾取器是否提供安装, 它运行 npm install -g @anthropic-ai/claude-code。翻过 代理客户协议 通过克洛德代码的ACP桥, claude-agent-acp: 已经打开的复制件 PATH 使用,否则ADE将安装它测试过的版本(@agentclientprotocol/[email protected](一经下 ~/.ade/acp,第一次需要它(打开克洛德的模型列表或它的第一个任务;大约70 MB,几秒钟,一个任务说是这样). 那份副本漏掉了桥上的Claude代码二进制 因为ADE指向了你的桥 CLAUDE_CODE_EXECUTABLE每一个转弯都产出桥并驾车在JSON-RPC上站出(Stdin/stdout)src/local/acp.mjs: initialize,则 session/resume (或 session/load) 后续行动,其他 session/new,然后是模式,模式,以及提示。 ADE没有宣传文件系统或终端能力,因此克洛德保留了自己的工具;它从未提供克洛德的绕行许可模式. 构建 选择克劳德的 接受编辑 模式和模式 计划 联合国 计划 模式。 ACP没有列表命令,因此对于模型拾取器ADE打开一个从未被激发的克洛德会话,并保存了一无所有(SpersistSession: false,自动记忆关闭),读取它提供的模型,并按克洛德代码版本保留该列表(翻转刷新);取出者只提供那些ID,被记住的模型克洛德不提供回其默认;通过克洛德自己的模型选项应用一个被选择的模型,并且一个ID不提供与它所做的ID的转折.

对照已安装的CLI及其现有文件检查了CLI版本和认证方法: 代码认证, (中文(简体) ), 打开代码 CLI 财务报告和审定财务报表 供应商, (中文(简体) ), Pi 编码代理, (中文(简体) ), 非加太集团v1 财务报告和审定财务报表 @agentclientprotocol/claude-agent-acp 0.99.0 与克洛德代码2.1.307(设计: docs/superpowers/specs/2026-10-28-acp-adapter-design.mdADE从不要求你贴上一个符号 一些CLIS将证书存储在自己的用户级文件中,而不是OS密钥链;ADE将选择权留给被支持的CLI流量.

代理浏览器

每个项目的正确面板有一个 浏览器 选项卡: 机器上的无头色调 代理本身驱动器 ——页面快照,截图,鼠标,键盘 ——运行和手动测试您的项目,光标云代理或Grok计算机的使用方式,但完全本地化. 你看着它生活在ADE中,可以控制 掌权 切换。 它的工作像 T3 代码的服务器浏览器( 见 THIRD_PARTY_NOTICES.md);没有云服务,没有容器,没有东西离开你的机器.

设置 : 无。 一个项目的浏览器首次启动时,ADE下载了Chrome用于测试的无头壳(一个被绑定的放出,大约100–120 MB)进入 ~/.ade/tools/chrome-headless-shell/ 并对照被绑住的大小和SHA-256进行核对,然后拆出;浏览器标签显示下载进度,每个项目重复复制。 打开标签启动浏览器( 大约一秒) 。 如果Chrome无法启动,窗格和代理工具会说原因: 缺少共享库,一个AppArmor政策来阻挡Chrome的沙盒(Ubuntu 23.10+),或作为根运行. npm run browser:setup 将前两个修正在适合的 Linux 上( 它解释它会做什么并要求 sudo 当需要时); 在其它地方,它为您的软件包管理器命名缺失的库。 Chrome for Testing没有针对每个平台的无头壳(例如32位Linux);有窗格报告浏览器为不可用.

隔离 : Chrome 带着自己的沙盒无头运行( 只有 ADE_BROWSER_SANDBOX=0 关上它). Playwright在管子上发射,因此没有打开DevTools端口,并用ADE退出. 每个项目都有自己的概况 ~/.ade/browser/profiles/,与您的浏览器分开 : 保持登录 (默认)将项目的饼干和存储保存在运行之间 无法辨认 每次开始清理; 清除 删除存储的配置文件,以及删除工程。 ADE 只导航到 http(s) URL, 页面可以看到普通的 Chrome 而非 HeadlessChrome,所以签入的页面和bot检查把它们当作普通浏览器. 与旧多克电脑不同,浏览器运行在您的网络上,就像代理CLI已经运行的那样.

密码和本地浏览器对话框 : 默认的无头壳无法显示操作系统密码对话框 。 要使用本地完整的 Chrome 或 Chromium 构建, 退出 ADE 并启动它 ADE_BROWSER_HEADED=1 财务报告和审定财务报表 ADE_BROWSER_EXECUTABLE 设置到绝对可执行路径。 例如,在Linux上:

ADE_BROWSER_HEADED=1 ADE_BROWSER_EXECUTABLE=/usr/bin/chromium npm run start

在macOS上,可执行文件可能是 /Applications/Google Chrome.app/Contents/MacOS/Google Chrome; 设置变量时引用路径。 在 Windows PowerShell 上设定 $env:ADE_BROWSER_HEADED = "1" 财务报告和审定财务报表 $env:ADE_BROWSER_EXECUTABLE 通向完整路径的 chrome.exe 在ADE开始之前。 使用浏览器构建,支持您的系统上的密码提供者或安全密钥. ADE 运行时必须提供图形桌面 。 完整浏览器为自己的对话框打开单独的本地窗口;在提示时继续在该窗口工作. 其页面还被流入ADE,具有相同的代理工具以及项目和标签隔离. 关闭 ADE 并重新启动, 无需这些变量即可返回无头模式 .

这两个模式将其配置和登录保留在单独的目录中(~/.ade/browser/profiles/ 财务报告和审定财务报表 ~/.ade/browser/profiles-headed/) (中文(简体) ). 这使得更新型的系统浏览器无法升级被绑的无头浏览器的数据. 已存在的登录不会自动传输;在需要时使用 ADE 的浏览器导入. 清除配置文件会删除其两种模式的数据。 私人浏览在两种模式中都是暂时的。 操作系统和浏览器支持有所不同:特别是,可用的密码,硬件密钥,和生物鉴别提示取决于所选浏览器,其签名和平台集成,以及本地系统.

代理工具 : 每个特工都得到同样的工具 browser_* 在网页的无障碍快照上发挥作用的工具browser_status, (中文(简体) ), browser_navigate, (中文(简体) ), browser_snapshot, (中文(简体) ), browser_click, (中文(简体) ), browser_type, (中文(简体) ), browser_select, (中文(简体) ), browser_upload, (中文(简体) ), browser_dialog, (中文(简体) ), browser_screenshot 和其余的, computer_* 使用在1280x800页坐标上工作的工具computer_screenshot, (中文(简体) ), computer_open_url, (中文(简体) ), computer_click, (中文(简体) ), computer_double_click, (中文(简体) ), computer_move, (中文(简体) ), computer_drag, (中文(简体) ), computer_type, (中文(简体) ), computer_key, (中文(简体) ), computer_scroll, (中文(简体) ), computer_wait;每个返回新的截图),以及 dev_server_status 编号 : dev_server_start 编号 : dev_server_stop 用于项目的dev服务器. 第一个呼叫启动浏览器;在一次性下载过程中,有一个带有进度的呼叫答案,以便代理可以重试. 按 CLI 进行线化: Codex 作为 MCP 服务器接收工具(由 Codex 本身启动,所以尽管它 workspace-write sandbox); OpenCode 通过其配置接收它们; Pi (没有 MCP 客户端) 加载一个注册相同工具的小扩展; Claude Code 接收 ACP 中相同的 MCP 服务器 session/new,预留与单一规则 mcp__ade_computer 因此浏览器动作从不提高权限提示. 所有工具都称ADE的回回API.

现场视图 : 浏览器 Tab 流,该页面正在直播(通过回路WebSocket屏幕播放)。 它停靠在右面板上或被弹出到可拖动的浮动窗口中,并带有后向,前向,再加载,URL和开放外向控制. 点击 掌权 亲自驾驶; 把手拿回来 返回给代理人。 当你控制它的时候 特工 browser_* 财务报告和审定财务报表 computer_* 调用失败 human_control 留言直到你还手。 打入到页面,包括粘贴和IME组成;在电话或平板电脑上,点击可编辑字段会提高屏幕上键盘并拖动页面滚动. 代理回复中的链接和终端在此打开, 而不是您的系统浏览器, 像工作空间一样 .html 财务报告和审定财务报表 .pdf 文档。 空状态列出已在此机上运行的网络服务器 。 设备工具栏提供预设、自由尺寸、自转和 填充窗帘,该页面的大小与窗格的大小那么符合您看到的布局;菜单可以将页面弹出到自己的操作系统窗口。 您在页面中复制的文本会降落在您自己的剪贴板上 。 当页面打开文件拾取器时, 由谁驱动就回答: 在窗格中从计算机中选择文件, 代理使用 browser_upload. JavaScript 对话框(提醒,确认,即时)以同样的方式出现在窗格中并呈现给代理. 当代理打开一页而浏览器标签不在屏幕上时,它会漂浮在对话上;停靠或关闭以阻止它出行.

工作空间文件 : GET /api/projects/:id/browser/files/<path> 服务项目内部的一页(HTML,PDF,以及该页自己的CSS,脚本,图像和字体),这样浏览器就可以显示它. 工程以外的路径,点文件,和未列出的文件类型被拒绝.

Dev 服务器留在主机上 (内部) node_modules,快速文件监视),浏览器也是如此,所以 localhost:<port> URL直接到达. 旧的预览分页(iframe + a-port form)和Processes列表已消失;代理通过工具启动并停止dev服务器本身,您在浏览器中查看结果.

从 Docker 计算机升级: ADE不再使用多克语. 早期版本所遗留的容器可以拆卸 docker rm -f $(docker ps -aq --filter label=ade.computer=1)和他们的图像 docker image ls ade-computer 编号 : docker image rm。 。 。 .

在窗口上时间 .cmd shims需要用外壳包装器安全地产出;ADE在它的工艺层中处理这个(src/local/spawn.mjs) 从未将参数插入外壳中,并杀死停站上的整个进程树,因此 dev-server 端口实际上是被放出.

安全和目前的限制

  • 未承诺的工作是受到保护的,而不是阻碍的. 您可以在肮脏的工作树上启动任务( 使用一击承认) 。 ADE 记录作为会话基线的已存在的更改,将文件列表传递给代理商,并明确指示永远不返回,隐藏,承诺,或覆盖,并在 diff 视图中标记出这些文件"你的",以便从代理商的编辑中得知. 基线在每个转弯起步时会刷新,因此可以在转弯之间保持编辑. ADE 从未自动安装、重装、检查或恢复文件。 它允许每个项目有一个运行的任务.
  • 代码x 与其 workspace-write 沙盒; ADE 从未通过 Codex 的危险沙盒-旁通旗. OpenCode 不启动 --auto. ADE本身不执行部署或外部/共享系统更改.
  • Claude Code的认可已经取消. 当克洛德在动作前询问(在Build: shell 命令,网络取取,项目外的文件),回合暂停,会话显示 需要你帮忙,一张卡片列出克劳德自己的选项(例如: 对, (中文(简体) ), 是的,别再问了.., (中文(简体) ), 没有),ADE没有添加自有内容. Claude Code自己拯救了“永远”的选择,它可能把这些选择写到项目上 .claude/settings.local.json。停止会话会留下一个悬而未决的问题。 单位 计划,ADE拒绝编辑、删除、移动、运行命令或离开计划模式而无需询问的每一个请求,并显示克劳德所准备的计划作为其答复;切换会话以构建并后续应用.
  • 对于 Codex, OpenCode, 和 Pi, 指定代理交互批准/问题协议是 尚未连接到此 UI。代理人可能停止、失败或在其答复中报告问题;ADE 显示实际输出,并让您跟进。 当一个CLI转弯仍在运行时,后续可以等那个转弯退出或停止转弯并立即发送. ADE 不向运行中的 CLI 进程注入文本 。 不得将目前的UI作为每个工具的审批门.
  • 提供方配额/限速失败是从CLI自己的措辞中检测出,并报告为单独,可回收状态(在给出提示时,提供方会重试提示)——从未成功,也从未被模拟输出所取而代之. 模型和提供者级的故障从相同的真实措辞中获取自己的可回收状态:一个被否决的模型 id(model_not_found,包括CLI自己的"你的意思"建议),一个无法使用的提供商(英语:provider_unavailable),拒绝登录(auth_expired,通过CLI自身的登录流量恢复),并超越上下文(context_overflow) (中文(简体) ). 所列模式不是权利保障 ——上市范围为账号范围,一些型号为计划;只有运行时间的CLI决定,其出错在项目中没有任何变化的情况下被诚实地浮出水面.
  • 改变模式的中间对话从下个回合开始适用。 CLI 在不同的模式下是否正确保存了对话上下文 未核实 每CLI(OpenCode和Codex在续作上接受国旗;语义可能有所不同);会话视图指出这一点而不是假装互换是惰性.
  • 故意被推迟:每个项目的默认模式,一个全目录(不仅仅是证书过滤)的模型浏览器,以及推理-努力/变相选择——OpenCode无声地倒放无比 --variant 值,而 ADE 将不会默默地放弃用户的推理选择,所以功能等待诚实的端到端支持.
  • 项目检查脚本执行项目代码,可以产生副作用. ADE不自动运行;“运行项目检查”首先要求确认,并报告实际命令、退出状态和产出。 缺少的脚本不作为通行证代表.
  • Dev-server控制由一等和代理驱动. POST /api/projects/:projectId/dev/start 重新扫描 package.json 内线(同一弯道上早些时候安装的项目脚手架立即被检测出),将发射旗帜映射到被检测到的框架,以及报告 running 只在端口真正接受连接后; dev/stop 工作期间 starting 并且具有同能性(有PID-再用后卫,所以回收的PID永远不会被杀死); GET .../dev 返回已绑定状态( e){found, status, port, command},仅输出尾端). 拒绝的框架 --host (下一个)只获得 -H 127.0.0.1; 未知脚本获得 PORT 加号 HOST=127.0.0.1 在环境中——探测器无法验证这些物质的广泛结合,所以它们总是被固定在回转上。 没有dev脚本的项目仍然可以启动:代理程序提出一个程序及其参数(dev_server_start({ command, cwd })),会话显示 需要你帮忙 带有 运行这个 dev 命令? 卡片,一旦允许它 ADE 运行该命令本身(没有 shell,项目内部的文件夹, PORT编号 :HOST 和一个项目 .venv 打开 PATH)在以后每次启动时;Agent浏览器的“细节”用 忘记 (单位:千美元)ADR 0005 数据) (中文(简体) ). 没有dev脚本或经批准的指令,开始得到404号指示代理商提出一个——永远不要倒回脱去的过程;双发开始得到409个与当前记录. 代理驱动相同的端点 通过他们的 dev_server_status, (中文(简体) ), dev_server_start,以及 dev_server_stop 工具(见 代理浏览器),它从CLI沙盒外调用ADE的回回回API——一个沙盒外壳卷曲可能被屏蔽的可靠路径.
  • 双子星国际也讲非加太语(gemini --acp),但还没有被提供:其许可请求没有结构化工具名,因此ADE无法在那里预先启用自己的浏览器工具. 没有ADE云服务或遥测。 原类型方向用本地捆绑的OFL许可证字体保存(许可证在 public/licenses/; UI 不提出第三方字体请求.

建筑

现有的"TanStack Start"/"React"app和"温暖的工作本"视觉取向被保留. 一个小节点本地服务模块被挂入了Vite dev/preview和自托管的节点服务器: src/local/ade-local.mjs 每个地区的API路线都位于 src/local/routes/,大型服务有自己的模块(dev-server.mjs, (中文(简体) ), agent-status.mjs, (中文(简体) ), remote.mjs 页:1 代理适配器被隔离在 src/local/adapters/ 因此可以不改变UI状态而添加额外的CLI. 该服务拥有项目注册、Git检查/diffs、任务持续、儿童流程生命周期、CLI流、检查和发展服务器。 浏览器在Server-Sent Eventions上接收了被范围化的无效数据,并按需要加载会话细节和日志;浏览器存储不再是真理的来源.

许可证

ADE 于 MIT 许可证第三方组件和捆绑字体保留自己的许可证;见 THIRD_PARTY_NOTICES.md 财务报告和审定财务报表 public/licenses/。 。 。 .

检查

npm run typecheck
npm run lint
npm run build

版本与发布记录

@dezignerdrugz/ade 共发布 14 个版本,首次发布于 2026/11/02;过去 12 个月发布了 14 个版本。

版本发布日期距今
0.1.12latest2026/11/121 天前
0.1.112026/11/121 天前
0.1.102026/11/094 天前
0.1.92026/11/085 天前
0.1.82026/11/067 天前
0.1.72026/11/049 天前

关于 @dezignerdrugz/ade 的常见问题

@dezignerdrugz/ade 是什么?

ADE:一个在您机器上驱动编码代理CLIS(Codex,OpenCode,Pi,Claude Code)的本地网络UI.

如何安装 @dezignerdrugz/ade?

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

@dezignerdrugz/ade 支持 TypeScript 吗?

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

@dezignerdrugz/ade 支持 ESM 还是 CommonJS?

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

@dezignerdrugz/ade 需要什么版本的 Node.js?

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

@dezignerdrugz/ade 可以商用吗?

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

@dezignerdrugz/ade 的下载量有多少?

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

@dezignerdrugz/ade 还在维护吗?

最新版本 0.1.12 发布于 2026/11/12(1 天前);至今共发布 14 个版本,其中过去 12 个月发布了 14 个;首次发布于 2026/11/02。发布频率只是参考信号:功能稳定的工具可能很少需要更新,建议结合源码仓库的 issue 和提交记录判断。