会话与记忆 · v0.2.2
dsh-acp
一个用于持久化外部 ACP Agent 会话的 out-of-tree DeepSeek Harness 插件。
作者原文(英文)
An out-of-tree DeepSeek Harness plugin for persistent external ACP Agent sessions.
简介取自插件 README 开头,由 DeepSeek 模型翻译,仅供参考。
安装命令
dsh plugin --profile web add @1agents/dsh-acp@0.2.2
试装需批准构建脚本
安装过程会执行依赖的构建脚本,pnpm 默认拒绝执行这类脚本,需要人工批准后才能继续。本站不在无人值守的检查里替你批准。
检测报告
能力清单
- 可执行外部程序
spawns-processes高关注1 处命中dist/service-process.js:2import { fork } from 'node:child_process';- 看它调用哪些程序。调用本机已有的工具是常见做法。
- 发起网络请求
network需留意4 处命中dist/client.js:39const response = await fetch(`/api/1agents-acp/session?id=${encodeURIComponent(sessionId)}`, {dist/discovery.js:4const response = await fetch(new URL('/agents', serviceUrl), { signal: AbortSignal.timeout(10_000) });dist/service-process.js:38response = await fetch(new URL('/health', url), { signal: AbortSignal.timeout(timeout), redirect: 'error' });dist/transport.js:42const ws = new WebSocket(endpoint, { handshakeTimeout: 10_000 });- 看请求发往哪些域名。发往作者自己的后端是常见做法。
- 写入文件
writes-files需留意3 处命中dist/state.js:22mkdirSync(this.directory, { recursive: true, mode: 0o700 });dist/state.js:24writeFileSync(temp, JSON.stringify(binding) + '\n', { flag: 'wx', mode: 0o600 });dist/state.js:25renameSync(temp, path);- 看写入位置。写自己的配置目录是正常的,写系统目录不是。
- 含混淆或编码代码
obfuscated-code需留意1 处命中dist/client.js:32zh: { model: "\u6A21\u578B", choose: "\u9009\u62E9\u6A21\u578B", loading: "\u6B63\u5728\u8FDE\u63A5 Agent\u2026", retry:…- 混淆本身不是恶意,但公开源码里出现大段混淆值得问一句为什么。
- 读取环境变量
reads-env一般2 处命中dist/index.js:12const home = homePath ? homePath() : process.env.DSH_HOME || join(homedir(), '.dsh');dist/service-process.js:58env: { ...process.env, ELECTRON_RUN_AS_NODE: '1' },- 环境变量里常混有密钥。看它是否把整个 env 都读走。
- 动态加载模块
dynamic-import一般2 处命中dist/service-worker.js:30startup = import('@1agents/acp-service').then(service => service.serveAcpService({ host, port, report: false }));dist/transport.d.ts:14rpc: import("@agentclientprotocol/sdk").ClientContext;- 动态导入本身无害,但会让依赖关系难以静态审阅。
- 读取文件
reads-files一般1 处命中dist/state.js:13return decodeBinding(JSON.parse(readFileSync(this.path(id), 'utf8')));- 读文件是绝大多数插件的正常工作方式,本身不构成顾虑。
- 接触凭据或密钥
credentials一般1 处命中dist/service-process.js:111&& url.pathname === '/' && !url.search && !url.hash && !url.username && !url.password;- 看它读取哪些凭据、发往哪里。用于登录自己的服务是正常的。
逐条扫描明细
| 能力 | 标识 | 关注度 | 命中次数 |
|---|---|---|---|
| 可执行外部程序 | spawns-processes | 高关注 | 1 |
| 发起网络请求 | network | 需留意 | 4 |
| 写入文件 | writes-files | 需留意 | 3 |
| 含混淆或编码代码 | obfuscated-code | 需留意 | 1 |
| 读取环境变量 | reads-env | 一般 | 2 |
| 动态加载模块 | dynamic-import | 一般 | 2 |
| 读取文件 | reads-files | 一般 | 1 |
| 接触凭据或密钥 | credentials | 一般 | 1 |
这份报告的口径
扫描读的是包里的源码,全程不执行第三方代码。 本次读了 22 个文件,扫描于 2026-10-15。 命中次数只说明源码里出现过这类调用,不说明行为好坏——一个插件读写文件 500 次和 1 次 都会被记为「读取文件」。这是能力清单,不是信任评分,也不是安全结论: 没扫出来的能力可能只是写法没被规则覆盖。
可信度
- -5需要批准构建脚本才能装(本站不代跑第三方代码)warn
- -5cordis entry id「oneagents-acp」被 2 个包共用,同时安装会互相替换warn:@1agents/acp-service
认证等级 L0
- L0静态结构与契约✓sha512-0M08KVv490U4lete… 与本地 tarball 复算一致,补丁与入口齐备
- L1配置组合与依赖图—entry id oneagents-acp 被 2 个包共用
- L2隔离沙箱冒烟—需要批准构建脚本——本站不代跑第三方代码
- L3运行时健康监控—未抽样(本层是抽样检测:没有会话不等于干净)
评分口径与作者信息
从 100 分开始按规则扣减:fail −20 / major −10 / warn −5 / minor −2;star 数、下载量、LLM 输出都不参与评分
- 维护者
- scottzx
- 仓库
- https://github.com/scottzx/1acp
- 许可
- MIT
- 最后发布
- 2026-10-01
- 周下载
- 25
- star
- 0
扫描状态:已扫描。能力是事实,不是缺陷; 周下载与 star 只作参考,不参与评分。
认证等级只回答四件事:包本身是否完整可解析(L0)、能不能与别的插件组合(L1)、隔离环境里装不装得上并起得来(L2)、抽样运行时有没有异常(L3)。依赖漏洞、仓库存活、下载量都不参与评级,只作为独立信号标注。可信 ≠ 无漏洞,上架 ≠ 推荐。
| Node 要求 | >=22.13.0 |
|---|---|
| 第三方依赖 | 3 个 |
| bundle patch | ./cordis.patch.yml |
| 依赖安全公告 | 2 条,见下方 |
这个插件声明的依赖中,有 2 条已公开的安全公告 (最高等级:中):
| 等级 | 依赖包 | 编号 | 摘要 |
|---|---|---|---|
| 中 | 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 详情 |
查询的是依赖声明范围的下界(如 ^4.2.0 查 4.2.0),
不是实际安装到的版本。真正装的时候如果解析到了修复版本,就不受影响——
所以这是「可能受影响」,不是「这个插件有漏洞」。数据来自
OSV.dev。
元数据
| 主页 | https://github.com/scottzx/1acp#readme |
|---|---|
| 仓库最近提交 | 2026-10-11 |
| 仓库创建 | 2026-06-09 |
DSH