acp-service
v0.6.0
开发与运行时
可执行外部程序以 shell 执行命令写入文件
面向 Codex、Grok Build、Claude Code 以及其他 Agent 的 ACP Agent 运行时服务,这些 Agent 由其内嵌的 1ACP 运行时提供支持。0.2 版本使用 **基于 WebSocket 的 ACP v1 JSON-RPC 2.0**。每个连接选择一个 Agent;每个会话在重新连接时都会保留该 Agent 及其工作区。
作者原文(英文)
ACP runtime, CLI, HTTP/WebSocket service and DeepSeek Harness ACP/A2A plugins in one package.
中文简介由 DeepSeek 模型翻译,仅供参考。
dreammateacpagent-runtimeclaude-codegrokcodexa2a
检测报告
关注度高。命中了不少能力模式,其中可能有需要留意的。逐条看下面的清单。
2高关注5需留意5一般12未命中
高关注需留意一般
能力清单
- 可执行外部程序
spawns-processes高关注5 处命中dist/bin/acp-service.js:2import { execFileSync, spawn } from 'node:child_process';…/dist/agent-registry-CMg8LHKY.js:4import { execFile } from "node:child_process";…r/runtime/dist/flows-CiJSCy4D.js:6import { spawn } from "node:child_process";…/queue-owner-runtime-DSFdsS_y.js:6import { spawn } from "node:child_process";- 看它调用哪些程序。调用本机已有的工具是常见做法。
- 以 shell 执行命令
shell-exec高关注2 处命中dist/bin/acp-service.js:47baseHelp = execFileSync(process.execPath, [cliPath, '--help'], { encoding: 'utf-8' });…/dist/agent-registry-CMg8LHKY.js:322shell: true- 看命令字符串是拼出来的还是写死的。拼接用户输入才是真正的风险。
- 写入文件
writes-files需留意63 处命中dist/src/acp-state.js:24mkdirSync(this.directory, { recursive: true });dist/src/acp-state.js:27writeFileSync(temporary, JSON.stringify(binding) + '\n', { mode: 0o600, flag: 'wx' });dist/src/acp-state.js:28renameSync(temporary, file);dist/src/acp-state.js:31mkdirSync(this.directory, { recursive: true });- 看写入位置。写自己的配置目录是正常的,写系统目录不是。
- 可终止进程
kills-processes需留意14 处命中dist/bin/acp-service.js:78process.kill(process.pid, signal);…r/runtime/dist/flows-CiJSCy4D.js:422process.kill(pid, signal);…r/runtime/dist/flows-CiJSCy4D.js:429process.kill(-root, signal);…r/runtime/dist/flows-CiJSCy4D.js:516process.kill(-child.pid, 0);- 看它终止的是自己启动的进程,还是按名字匹配到的任意进程。
- 发起网络请求
network需留意8 处命中dist/bin/a2a.js:41const response = await fetch(url, { method: 'POST', redirect: 'error', signal: AbortSignal.timeout(15_000),vendor/dsh/client.js:268const response = await fetch(`/api/1agents-acp/session?id=${encodeURIComponent(sessionId)}`, {vendor/dsh/discovery.js:4const response = await fetch(new URL('/agents', serviceUrl), { signal: AbortSignal.timeout(10_000) });dist/src/a2a/gateway.js:132return await fetch(input, { ...init, signal, redirect: 'error' });- 看请求发往哪些域名。发往作者自己的后端是常见做法。
- 启动伪终端
spawns-pty需留意2 处命中…/queue-owner-runtime-DSFdsS_y.js:2715return await runTimedExecFile("powershell.exe", […/queue-owner-runtime-DSFdsS_y.js:6458return (await runTimedExecFile("powershell.exe", [- 伪终端等于给了一个完整 shell。确认这是插件的核心功能。
- 含混淆或编码代码
obfuscated-code需留意2 处命中vendor/dsh/client.js:261zh: { toolGroup: "\u5DF2\u8C03\u7528 {count} \u4E2A\u5DE5\u5177", model: "\u6A21\u578B", choose: "\u9009\u62E9\u6A21\u57…- 混淆本身不是恶意,但公开源码里出现大段混淆值得问一句为什么。
- 接触凭据或密钥
credentials一般194 处命中dist/bin/a2a.js:17invoke reads a JSON parameters object from stdin. Credentials stay in thedist/bin/a2a.js:29throw new Error('Gateway config contains credentials; set chmod 600');dist/src/bridge.js:1182const transientCredentials = launch?.transientCredentials &&dist/src/bridge.js:1183typeof launch.transientCredentials === "object" &&- 看它读取哪些凭据、发往哪里。用于登录自己的服务是正常的。
- 读取文件
reads-files一般68 处命中dist/bin/a2a.js:27const stat = fs.statSync(file);dist/bin/a2a.js:30const config = JSON.parse(fs.readFileSync(file, 'utf8'));dist/bin/a2a.js:40const params = JSON.parse(fs.readFileSync(0, 'utf8'));dist/bin/acp-service.js:20const content = fs.readFileSync(url, 'utf-8');- 读文件是绝大多数插件的正常工作方式,本身不构成顾虑。
- 读取环境变量
reads-env一般41 处命中vendor/dsh/a2a.js:8const token = options.token ?? process.env[options.tokenEnv ?? 'DSH_A2A_TOKEN'];dist/bin/acp-service.js:74env: process.env,dist/src/acp-state.js:8constructor(directory = join(process.env.ACP_STATE_DIR || join(homedir(), '.1agents', 'acpx-state'), 'acp')) {…/dist/agent-registry-CMg8LHKY.js:249function resolveWindowsCommand(command, env = process.env, cwd) {- 环境变量里常混有密钥。看它是否把整个 env 都读走。
- 动态加载模块
dynamic-import一般22 处命中dist/bin/acp-service.js:108const { serveAcpService } = await import('../src/server.js');dist/bin/acp-service.js:109const { attachProcessSignalHandlers } = await import('../src/bridge.js');dist/bin/acp-service.js:121const { maybeHandleSkillflag } = await import('skillflag');dist/bin/acp-service.js:130const { runA2ACli } = await import('./a2a.js');- 动态导入本身无害,但会让依赖关系难以静态审阅。
- 文中出现远程脚本地址
remote-url-reference一般5 处命中dist/src/catalog-descriptors.js:31"install_command": "curl -fsSL https://x.ai/cli/install.sh | bash"dist/src/catalog-descriptors.js:61"install_command": "curl -fsSL https://cli.devin.ai/install.sh | bash"dist/src/catalog-descriptors.js:121"install_command": "curl -fsSL https://antigravity.google/cli/install.sh | bash"dist/src/catalog-descriptors.js:161"install_command": "curl -fsSL https://hermes-agent.nousresearch.com/install.sh | bash"- 只是文本里出现了远程脚本地址,没有看到加载它的调用。多半是文档或注释;若确实可疑,搜一下这个地址在包里的其他出现位置。
逐条扫描明细
| 能力 | 标识 | 关注度 | 命中次数 |
|---|---|---|---|
| 可执行外部程序 | spawns-processes | 高关注 | 5 |
| 以 shell 执行命令 | shell-exec | 高关注 | 2 |
| 写入文件 | writes-files | 需留意 | 63 |
| 可终止进程 | kills-processes | 需留意 | 14 |
| 发起网络请求 | network | 需留意 | 8 |
| 启动伪终端 | spawns-pty | 需留意 | 2 |
| 含混淆或编码代码 | obfuscated-code | 需留意 | 2 |
| 接触凭据或密钥 | credentials | 一般 | 194 |
| 读取文件 | reads-files | 一般 | 68 |
| 读取环境变量 | reads-env | 一般 | 41 |
| 动态加载模块 | dynamic-import | 一般 | 22 |
| 文中出现远程脚本地址 | remote-url-reference | 一般 | 5 |
这份报告的口径
扫描读的是包里的源码,全程不执行第三方代码。 本次读了 94 个文件,扫描于 2026-10-14。 命中次数只说明源码里出现过这类调用,不说明行为好坏——一个插件读写文件 500 次和 1 次 都会被记为「读取文件」。这是能力清单,不是信任评分,也不是安全结论: 没扫出来的能力可能只是写法没被规则覆盖。
依赖安全公告
这个插件声明的依赖中,有 3 条已公开的安全公告 (最高等级:中):
| 等级 | 依赖包 | 编号 | 摘要 |
|---|---|---|---|
| 中 | ws | CVE-2026-45736 | ws: Uninitialized memory disclosure 修复版本:8.20.1 详情 → |
| 中 | ws | CVE-2026-48779 | ws: Memory exhaustion DoS from tiny fragments and data chunks 修复版本:5.2.5, 6.2.4, 7.5.11 详情 → |
| 低 | zod | CVE-2023-4316 | Zod denial of service vulnerability 修复版本:3.22.3 详情 → |
查询的是依赖声明范围的下界(如 ^4.2.0 查 4.2.0),
不是实际安装到的版本。真正装的时候如果解析到了修复版本,就不受影响——
所以这是「可能受影响」,不是「这个插件有漏洞」。数据来自
OSV.dev。