安装前先看这几项
- 配置资料
- 配置资料完整
- 配置难度
- 较高
- 适合新手
- 建议具备相关经验
- 兼容状态
- 声明兼容,尚未实测
- 验证状态
- 源码已审阅,未标记运行实测
本页目录(9)
按照固定来源完成安装、配置与验证
教程包含独立 Profile、精确安装目标、配置证据、最小验证任务、回退和数据清理。
这个插件能做什么
AIO Agent 0.0.1 将 Cursor、Claude Code、Codex、OpenCode、CodeBuddy 和 Kimi Code 接入 DSH 模式与模型菜单,每轮由本机外部 CLI 执行并把对话、工具结果和用量写回 DSH 会话。
需要多 Agent、工作流、编排能力的用户。
该插件涉及较高配置难度或敏感权限,不建议在生产工作区直接试装。
安装前准备
- DSH 版本组合(必需):Node.js >=22;未声明 engines.dsh,4 项 DSH peer 均声明为 *,按宿主含预发行版本的规则接受 0.2.1-rc.5。通配范围不是作者跨版本实测承诺;本页固定 DSH 0.2.1-rc.5,静态核对所用 Session/Agent/LLM 入口,未安装或运行验证。外部 CLI 自身的版本、登录与平台兼容性另行核对。
- 独立测试环境与停机备份(必需):本页命令用独立 DSH_HOME 下的 web Profile;先停止 DSH,备份 profiles/web 的 package.json、pnpm-lock.yaml 和 cordis.patch.yml。不要挂生产目录或已有敏感会话。
- 首次加载前禁用六个组件(必需):bundle 默认启用六个组件并自动查询模型,permission 默认 allow。安装时保持停机,在任何加载或 --dump-config 前写入本页 disabled:true/permission:deny 的六行覆盖。
- 一个已独立安装并登录的 CLI(必需):实际任务验证另需站长批准。本页示例只在批准后启用 Claude Code;先由用户按厂商官方流程独立准备测试登录,不执行 README 中的全局安装器或让 DSH 帮我配置按钮。
如何安装 dsh-aio-agent
本页命令固定使用 DSH 0.2.1-rc.5,与 npm 默认版本分别维护。切换 DSH 前核对本插件的兼容记录;新版 Session API 与格式变化见0.1.3-alpha.1 升级说明。源码审阅不等于运行验证。
下面的命令使用本站核验的 DSH 基线,并锁定插件版本或 Git commit,避免默认分支变化导致安装内容漂移。本站已核对安装目标,但尚未在你的系统和 Profile 中实际执行。
- 安装到
webProfile- DSH 基线
0.2.1-rc.5- 安装来源
- GitHub 源码(锁定提交)
- 固定目标
github:cocofhu/dsh-aio-agent#a546722a62c8fa64c794769af19932da788dea71
Node.js >=22;未声明 engines.dsh,4 项 DSH peer 均声明为 *,按宿主含预发行版本的规则接受 0.2.1-rc.5。通配范围不是作者跨版本实测承诺;本页固定 DSH 0.2.1-rc.5,静态核对所用 Session/Agent/LLM 入口,未安装或运行验证。外部 CLI 自身的版本、登录与平台兼容性另行核对。
- DSH 版本组合来源 1(外部链接,在新标签页打开)
- DSH 版本组合来源 2(外部链接,在新标签页打开)
- DSH 版本组合来源 3(外部链接,在新标签页打开)
- DSH 版本组合来源 4(外部链接,在新标签页打开)
固定 Git 树已经包含全部宿主入口及客户端 JS,无 prepare/安装构建脚本,不运行作者测试或 build:logos。安装时保持 DSH 停止,首次加载或 --dump-config 前先按下方待机配置禁用 6 个 CLI 组件并设 permission:deny,再进行配置检查。不要直接启动默认 allow 配置。
- 01检查 Node.js 与 pnpm
DSH 当前基线需要 Node.js 22.19 或 Node.js 24 及以上,并且
pnpm必须已在 PATH 中。先运行:环境检查node --version && pnpm --version - 02安装到 Web Profile
这条命令会把插件加入
webProfile,并在插件声明 DSH Bundle 时自动加入配置层。GitHub 源码(锁定提交)npx --yes @deepseek-ai/[email protected] plugin --profile web add github:cocofhu/dsh-aio-agent#a546722a62c8fa64c794769af19932da788dea71 - 03确认 Bundle 已进入配置
先完成上方安装说明要求的准备或配置,再导出组合配置,不启动 Agent。输出中应能找到包名 @cocofhu/dsh-aio-agent或对应 Bundle 层。
检查配置npx --yes @deepseek-ai/[email protected] --profile web --dump-config - 04启动并完成最小验证
启动 Web Profile 后,只测试一个与插件功能直接相关的最小任务,并检查日志、文件、网络和凭据访问是否符合预期。
启动 DSH Webnpx --yes @deepseek-ai/[email protected] web
测试不通过时先停止 DSH,再从同一 Profile 移除插件。移除后重新运行配置检查,确认对应 Bundle 层已经消失;插件自己创建的数据和外部账号配置可能需要另行清理。
npx --yes @deepseek-ai/[email protected] plugin --profile web remove @cocofhu/dsh-aio-agent插件专属配置
$DSH_HOME/profiles/web/cordis.patch.yml- 覆盖已有 aio-cursor、aio-claude-code、aio-codex、aio-opencode、aio-codebuddy、aio-kimi-code 的 disabled/config;不要重复 insert,也不要把 permission 写到根 aio-agent。
插件 → AIO Agent → 对应 CLI → 配置- 启用后可编辑 command、model、permission;保存从下一轮读取,保存后重新检测也可能触发 CLI 查询,不是静态表单。
DSH 进程 PATH、环境与外部 CLI 登录/会话目录- 命令由宿主进程查找,工作目录不是权限围栏。CLI 继承大部分环境;Codex 运行会剔除 OPENAI_API_KEY、CODEX_API_KEY、ACP_CODEX_API_KEY 以使用自己的登录。
安装后、首次加载前:禁用全部 CLI 并拒绝权限请求 · yaml。示例中的账号、路径和凭据占位符必须替换,不要提交真实密钥。
- id: aio-cursor
disabled: true
config:
permission: deny
- id: aio-claude-code
disabled: true
config:
permission: deny
- id: aio-codex
disabled: true
config:
permission: deny
- id: aio-opencode
disabled: true
config:
permission: deny
- id: aio-codebuddy
disabled: true
config:
permission: deny
- id: aio-kimi-code
disabled: true
config:
permission: deny后续获准运行验证时:只启用 Claude Code,并保留 deny · yaml。示例中的账号、路径和凭据占位符必须替换,不要提交真实密钥。
- id: aio-claude-code
disabled: false
config:
permission: deny
command: ""
model: ""- 停机执行固定 Git 安装后,先手工合并六组件待机覆盖,再运行 --dump-config;预期 root aio-agent 仍在,六个 CLI 组件均 disabled,尚不启动外部任务。
- 批准运行验证并确认外部 CLI 测试登录后,只将 aio-claude-code 改为 disabled:false,其余继续禁用;保持 permission:deny。启用后模型发现会调用本机 CLI。
- 进入插件专属配置页,确认自动批准权限请求关闭;创建无敏感内容的测试会话,选择 Claude Code 模式与匹配的模型,不在普通 DSH 模式中混选 AIO 模型。
配置检查与成功结果
- 01合并六组件待机覆盖后检查组合配置复制验证命令
npx --yes @deepseek-ai/[email protected] --profile web --dump-config期望结果:aio-agent 及六个组件身份无重复,六个 CLI 组件保持 disabled:true/permission:deny。配置导出不是 CLI 登录、任务运行或沙箱验证。
- 02站长另行批准后,启用一个 CLI 并检查模型菜单
期望结果:对应模式与模型出现,其他五个模式不启用。模型列表只能说明目录查询有结果,不能证明登录、执行权限或会话续接全部正常。
- 03另行批准后,在可丢弃目录执行一个只读最小任务
期望结果:请求仅报告测试目录中的一个文件名,不修改文件、不运行安装器。对照 CLI 与 DSH 的文本、工具记录和 token 用量;原目录 diff 无意外修改。本次没有执行该验证。
第一次使用建议这样验证
- 后续获准运行验证时,在新的 Claude Code 模式测试会话中请求:只读取当前可丢弃目录,报告一个文件名,不修改内容,不安装依赖。确认该 CLI 自身的审批/隔离设置有效后再继续。
它可能接触哪些数据和能力
启用组件即尝试启动 CLI 查询模型,Kimi 的发现还可创建临时目录中的 ACP 会话;运行任务时继承宿主环境与已有 CLI 登录态,以会话 cwd 或进程 cwd 启动子进程,可读写工作区、联网和运行命令。默认 permission:allow 会加入绕过审批/沙箱的参数;DSH 输入框访问模式不约束外部 CLI。会话日志含原消息、工具输入输出及 CLI 绑定。
数据存储:DSH 保存用户/助手消息、工具输入输出与 plugin:dsh-aio-agent/binding、stream、acp、permission 记录;外部 CLI 另有自己的登录、会话和缓存。非 JSON 图片写入系统临时目录的 dsh-aio-<随机 ID> 文件并尝试清理;不要把字段名脱敏当成完整的正文脱敏。
请注意:“源码已审阅”说明本站检查到的证据范围,不等于安全认证。重要工作区应锁定版本、备份数据并在最小权限下测试。
故障排查与数据清理
- npm 404、构建提示或模型列表为空
- 使用本页固定 Git 目标;固定树已有 JS,不运行未知 prepare/build。核对 DSH 进程 PATH、被禁用组件、CLI 版本与用户自行完成的登录;列表为空不能区分未装/未登录,列表非空也不保证可执行。
- DSH 只读模式下仍发生外部写入
- 输入框访问模式不约束外部 CLI。permission:deny 只改变插件的请求应答/强制参数,不是只读沙箱;检查 CLI 自身权限、命令附加参数和可访问目录,先停用组件。不要改成 allow 排障。
- 续接失败、模式与模型不匹配或停止后仍有进程
- 绑定保存在 DSH 日志及 CLI 本地会话中,切后端、变启动命令或缺少 CLI 历史可能导致新会话。确认模式与模型同属一个后端;核对自己启动的进程与目录差异,不能把停止按钮当回滚。
- 日志中出现敏感文本或临时图片残留
- 字段名脱敏不覆盖普通文本、工具输入输出和全部错误。Codex/OpenCode 提示还可出现在进程参数中;不要输入密钥。按 DSH/CLI 各自流程限制访问并清理测试记录,异常退出后检查临时图片。
- 先停止当前测试任务,将六个组件全部恢复 disabled:true/permission:deny,再停止 DSH;检查自己启动的 CLI 进程,停止不保证后代进程都已退出,也不回滚外部写入。
- 在同一测试 Profile 移除准确包名:`npx --yes @deepseek-ai/[email protected] plugin --profile web remove @cocofhu/dsh-aio-agent`;需要回退时整体恢复安装前 Profile 依赖、锁文件和补丁。
- 卸载只移除 DSH 集成,不卸载外部 CLI、不注销其账号、不删除 CLI 或 DSH 会话历史。按各自官方流程撤销测试登录、清理测试会话和临时图片,保留仍需审计的原记录。
深入审计:兼容性、数据流与来源
兼容性与审阅记录
兼容性说明
Node.js >=22;未声明 engines.dsh,4 项 DSH peer 均声明为 *,按宿主含预发行版本的规则接受 0.2.1-rc.5。通配范围不是作者跨版本实测承诺;本页固定 DSH 0.2.1-rc.5,静态核对所用 Session/Agent/LLM 入口,未安装或运行验证。外部 CLI 自身的版本、登录与平台兼容性另行核对。
数据流
DSH 用户文本和图片 → 本机外部 CLI(JSON 流或 ACP)→ 该 CLI 配置的模型服务;CLI 回复、思考、工具调用、用量和绑定 → DSH Session/浏览器。Codex/OpenCode 的文本提示作为进程参数,其余按后端经 stdin/ACP;部分图片写入系统临时目录后 finally 清理,异常终止仍需检查残留。插件不向固定遥测端点发请求,但外部 CLI 的网络、凭据和存储规则仍生效。
源码审阅结论
2026-11-01 再查 @cocofhu/dsh-aio-agent/0.0.1 仍为 npm 404,只提供完整 40 位 Git 安装目标。固定树 80 个文件经 Git blob 校验,含完整 MIT、图标第三方许可、预构建 lib/client.js 和所有宿主 JS,无 prepare/安装构建脚本,未执行作者测试或 CLI。默认注册 6 个组件且 permission 默认 allow:Cursor 可加 --yolo/--approve-mcps,Codex 可加 --dangerously-bypass-approvals-and-sandbox,OpenCode 可加 --dangerously-skip-permissions,Claude/CodeBuddy 使用 bypassPermissions。教程要求首次加载前停机将 6 项设 disabled:true 与 permission:deny,后续仅启用一个已独立安装登录的 CLI。deny 不是只读沙箱,也不撤销自定义命令或 CLI 自身预授权。spawn/execFile 默认 argv 分离、不启 shell,但自定义 command 仍可直接启动任意程序。日志 redaction 只按字段名递归处理字符串,不保证清除普通文本/工具结果中的密钥;停止只针对直接子进程或 ACP cancel,不保证杀掉所有后代或回滚写入。
来源与维护信息
本页根据固定提交的仓库、包清单和本站审阅资料生成。版本变化后,请重新核对作者说明。
- 来源快照
a546722a62c8- 固定提交
a546722a62c8- 许可证
- MIT
- 主要语言
- JavaScript
- 中文资料
- 有完整中文配置资料