deep-agent-cli 0.1.2__tar.gz → 0.1.3__tar.gz
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- {deep_agent_cli-0.1.2 → deep_agent_cli-0.1.3}/PKG-INFO +105 -7
- {deep_agent_cli-0.1.2 → deep_agent_cli-0.1.3}/README.md +104 -6
- {deep_agent_cli-0.1.2 → deep_agent_cli-0.1.3}/agent/cancel.py +6 -1
- {deep_agent_cli-0.1.2 → deep_agent_cli-0.1.3}/agent/cli/app.py +221 -46
- {deep_agent_cli-0.1.2 → deep_agent_cli-0.1.3}/agent/cli/commands.py +5 -0
- {deep_agent_cli-0.1.2 → deep_agent_cli-0.1.3}/agent/cli/interactions.py +2 -0
- {deep_agent_cli-0.1.2 → deep_agent_cli-0.1.3}/agent/cli/rendering.py +76 -13
- {deep_agent_cli-0.1.2 → deep_agent_cli-0.1.3}/agent/cli/session_controller.py +9 -7
- deep_agent_cli-0.1.3/agent/cli/skills.py +71 -0
- {deep_agent_cli-0.1.2 → deep_agent_cli-0.1.3}/agent/config.example.yaml +25 -5
- {deep_agent_cli-0.1.2 → deep_agent_cli-0.1.3}/agent/config.py +5 -1
- {deep_agent_cli-0.1.2 → deep_agent_cli-0.1.3}/agent/factory.py +15 -2
- {deep_agent_cli-0.1.2 → deep_agent_cli-0.1.3}/agent/network.py +3 -3
- {deep_agent_cli-0.1.2 → deep_agent_cli-0.1.3}/agent/permission.py +14 -12
- {deep_agent_cli-0.1.2 → deep_agent_cli-0.1.3}/agent/runner.py +20 -1
- {deep_agent_cli-0.1.2 → deep_agent_cli-0.1.3}/agent/sandbox.py +316 -137
- deep_agent_cli-0.1.3/agent/sandbox_pool.py +369 -0
- deep_agent_cli-0.1.3/agent/sandbox_worker.py +173 -0
- {deep_agent_cli-0.1.2 → deep_agent_cli-0.1.3}/agent/tools/execute.py +19 -9
- {deep_agent_cli-0.1.2 → deep_agent_cli-0.1.3}/pyproject.toml +1 -1
- {deep_agent_cli-0.1.2 → deep_agent_cli-0.1.3}/.gitignore +0 -0
- {deep_agent_cli-0.1.2 → deep_agent_cli-0.1.3}/LICENSE +0 -0
- {deep_agent_cli-0.1.2 → deep_agent_cli-0.1.3}/agent/__init__.py +0 -0
- {deep_agent_cli-0.1.2 → deep_agent_cli-0.1.3}/agent/attachments.py +0 -0
- {deep_agent_cli-0.1.2 → deep_agent_cli-0.1.3}/agent/bootstrap.py +0 -0
- {deep_agent_cli-0.1.2 → deep_agent_cli-0.1.3}/agent/cli/__init__.py +0 -0
- {deep_agent_cli-0.1.2 → deep_agent_cli-0.1.3}/agent/cli/clipboard.py +0 -0
- {deep_agent_cli-0.1.2 → deep_agent_cli-0.1.3}/agent/cli/gitinfo.py +0 -0
- {deep_agent_cli-0.1.2 → deep_agent_cli-0.1.3}/agent/cli/input.py +0 -0
- {deep_agent_cli-0.1.2 → deep_agent_cli-0.1.3}/agent/cli/main.py +0 -0
- {deep_agent_cli-0.1.2 → deep_agent_cli-0.1.3}/agent/cli/pasted_content.py +0 -0
- {deep_agent_cli-0.1.2 → deep_agent_cli-0.1.3}/agent/cli/previews.py +0 -0
- {deep_agent_cli-0.1.2 → deep_agent_cli-0.1.3}/agent/cli/state.py +0 -0
- {deep_agent_cli-0.1.2 → deep_agent_cli-0.1.3}/agent/cli/working_messages.py +0 -0
- {deep_agent_cli-0.1.2 → deep_agent_cli-0.1.3}/agent/cli/working_messages.yaml +0 -0
- {deep_agent_cli-0.1.2 → deep_agent_cli-0.1.3}/agent/control.py +0 -0
- {deep_agent_cli-0.1.2 → deep_agent_cli-0.1.3}/agent/file_mutation.py +0 -0
- {deep_agent_cli-0.1.2 → deep_agent_cli-0.1.3}/agent/llm.py +0 -0
- {deep_agent_cli-0.1.2 → deep_agent_cli-0.1.3}/agent/middleware/__init__.py +0 -0
- {deep_agent_cli-0.1.2 → deep_agent_cli-0.1.3}/agent/middleware/attachments.py +0 -0
- {deep_agent_cli-0.1.2 → deep_agent_cli-0.1.3}/agent/middleware/cancel_tools.py +0 -0
- {deep_agent_cli-0.1.2 → deep_agent_cli-0.1.3}/agent/middleware/pause.py +0 -0
- {deep_agent_cli-0.1.2 → deep_agent_cli-0.1.3}/agent/middleware/recovery.py +0 -0
- {deep_agent_cli-0.1.2 → deep_agent_cli-0.1.3}/agent/middleware/runtime_config.py +0 -0
- {deep_agent_cli-0.1.2 → deep_agent_cli-0.1.3}/agent/middleware/steering.py +0 -0
- {deep_agent_cli-0.1.2 → deep_agent_cli-0.1.3}/agent/middleware/tool_arg_hints.py +0 -0
- {deep_agent_cli-0.1.2 → deep_agent_cli-0.1.3}/agent/middleware/workspace_filesystem.py +0 -0
- {deep_agent_cli-0.1.2 → deep_agent_cli-0.1.3}/agent/middleware/write_operation.py +0 -0
- {deep_agent_cli-0.1.2 → deep_agent_cli-0.1.3}/agent/session.py +0 -0
- {deep_agent_cli-0.1.2 → deep_agent_cli-0.1.3}/agent/session_lock.py +0 -0
- {deep_agent_cli-0.1.2 → deep_agent_cli-0.1.3}/agent/session_runtime.py +0 -0
- {deep_agent_cli-0.1.2 → deep_agent_cli-0.1.3}/agent/stream.py +0 -0
- {deep_agent_cli-0.1.2 → deep_agent_cli-0.1.3}/agent/tools/__init__.py +0 -0
- {deep_agent_cli-0.1.2 → deep_agent_cli-0.1.3}/agent/tools/examples.py +0 -0
- {deep_agent_cli-0.1.2 → deep_agent_cli-0.1.3}/agent/tools/human_input.py +0 -0
- {deep_agent_cli-0.1.2 → deep_agent_cli-0.1.3}/agent/tools/human_interaction.py +0 -0
- {deep_agent_cli-0.1.2 → deep_agent_cli-0.1.3}/agent/tools/web_search.py +0 -0
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
Metadata-Version: 2.4
|
|
2
2
|
Name: deep-agent-cli
|
|
3
|
-
Version: 0.1.
|
|
3
|
+
Version: 0.1.3
|
|
4
4
|
Summary: A sandboxed coding agent CLI for Linux and WSL2
|
|
5
5
|
License-Expression: MIT
|
|
6
6
|
License-File: LICENSE
|
|
@@ -30,21 +30,22 @@ Description-Content-Type: text/markdown
|
|
|
30
30
|
|
|
31
31
|
`deep-agent` 是一个在终端中运行的 Coding Agent,支持 Linux 和 WSL2。它把启动时所在的目录作为工作区,调用你配置的 OpenAI 兼容模型服务,并在 [Bubblewrap](https://github.com/containers/bubblewrap) 沙箱中执行命令。Agent 运行时基于 [Deep Agents](https://github.com/langchain-ai/deepagents) 和 LangGraph 构建。
|
|
32
32
|
|
|
33
|
-
当前版本 0.1.
|
|
33
|
+
当前版本 0.1.3,处于早期开发阶段。第一个稳定版之前,配置格式、会话存储格式和 Python API 都可能出现不兼容变更。
|
|
34
34
|
|
|
35
35
|
## 功能
|
|
36
36
|
|
|
37
37
|
- **文件操作**:在工作区中列目录、读、写、编辑、搜索、删除文件。
|
|
38
38
|
- **命令执行**:在 Bubblewrap 沙箱中运行 shell 命令,默认没有网络;输出实时显示。
|
|
39
|
-
-
|
|
39
|
+
- **审批**:默认 `ask` 模式下,每次运行命令、Web 搜索、写入、编辑、删除文件前都会请求你确认。
|
|
40
40
|
- **会话**:按工作区保存在本地 SQLite 中,可以随时恢复。
|
|
41
41
|
- **多模型**:在配置文件中定义多个模型,运行中切换模型和推理强度。支持 Chat Completions 和 Responses 两种接口。
|
|
42
|
-
-
|
|
42
|
+
- **流式输出**:思考内容和回答都流式显示;思考区默认保留按终端宽度折行后的末尾 5 行正文,`Ctrl+T` 展开。
|
|
43
43
|
- **运行中干预**:任务执行时可以追加指令、排队后续任务或取消。
|
|
44
44
|
- **图片输入**:向声明支持图片的模型发送图片。
|
|
45
45
|
- **结构化提问**:Agent 需要你做决定时,会弹出单选、多选、是/否或文本输入。
|
|
46
46
|
- **上下文压缩**:接近模型上下文窗口时自动摘要旧对话,也可以手动压缩。
|
|
47
|
-
-
|
|
47
|
+
- **技能**:从 `~/.deep-agent/skills/` 加载 Skills,通过 `/skill` 选择技能并附带任务说明,支持读取技能目录中的参考文件。
|
|
48
|
+
- **可选扩展**:配置 Tavily API key 后可以搜索公开网页;读取工作区根目录的 `AGENTS.md` 作为项目说明。
|
|
48
49
|
|
|
49
50
|
## 运行要求
|
|
50
51
|
|
|
@@ -95,14 +96,24 @@ llm:
|
|
|
95
96
|
api_key: ${MY_API_KEY} # 也可以直接写密钥
|
|
96
97
|
provider: openai-compatible # 端点支持 Responses API 时可改为 qwen-responses
|
|
97
98
|
stream_usage: true
|
|
99
|
+
reasoning_efforts: [none, low, medium, high] # 来源级列表,见下文
|
|
98
100
|
models:
|
|
99
101
|
main: # 模型键,自定义
|
|
100
102
|
model: your-model-name # 发给服务端的模型名
|
|
101
103
|
context_window: 128k
|
|
102
104
|
input: [text] # 支持图片时写 [text, image]
|
|
105
|
+
fast: {} # 省略的字段全部继承来源
|
|
106
|
+
other:
|
|
107
|
+
reasoning_efforts: [low, high] # 写了就完整替换来源列表
|
|
103
108
|
```
|
|
104
109
|
|
|
105
|
-
`
|
|
110
|
+
模型按「来源」分组。来源下可以写的字段,模型项中也都可以写:模型项省略则继承来源,写了就覆盖。列表字段(`input`、`reasoning_efforts`)是整表替换,不是合并;`reasoning_efforts` 写成 `null` 或 `[]` 会清除继承。
|
|
111
|
+
|
|
112
|
+
`provider` 未填写时默认为 `qwen-responses`(Responses API),只提供 Chat Completions 的服务需要显式写 `openai-compatible`。
|
|
113
|
+
|
|
114
|
+
`reasoning_efforts` 需要按服务商文档填写,程序不会自动探测。常见取值包括 `none`、`low`、`medium`、`high`、`xhigh`、`max`,同一模型在不同端点上可能不同。列表非空时,`/model` 只显示这些值,默认选中第一项;空列表或未配置时只显示 `default`,请求不携带强度参数。`default` 是 CLI 选项,不能写进列表。`none` 仅在端点明确支持关闭思考时才写;`low` 仍然会思考。Chat Completions 发送 `reasoning_effort`,Responses API 发送 `reasoning.effort`。
|
|
115
|
+
|
|
116
|
+
其他字段和服务商示例见 [配置参考](https://github.com/ADaozz/deep_agent_cli/blob/main/docs/configuration.md)。
|
|
106
117
|
|
|
107
118
|
**3. 在项目目录中启动**
|
|
108
119
|
|
|
@@ -129,12 +140,15 @@ deep-agent resume 01a08aae # 按 id 或前缀恢复
|
|
|
129
140
|
| `/help` | 列出命令和快捷键 |
|
|
130
141
|
| `/status` | 当前模型、权限模式、沙箱状态 |
|
|
131
142
|
| `/model` | 选择模型和推理强度 |
|
|
143
|
+
| `/skill` | 选择技能,在输入框插入技能名称块 |
|
|
132
144
|
| `/permission ask\|allow` | 切换审批模式 |
|
|
133
145
|
| `/resume`、`/new` | 切换到已有会话、新建会话 |
|
|
134
146
|
| `/compact` | 手动压缩上下文 |
|
|
135
147
|
| `/image <路径>` | 为下一条消息附加图片 |
|
|
136
148
|
| `/quit` | 退出 |
|
|
137
149
|
|
|
150
|
+
输入 `/` 显示命令候选,按连续子串匹配,例如 `/elp` 匹配 `/help`,`/hlp` 不匹配。完整匹配和前缀匹配优先;方向键选择,`Tab` 或 `Enter` 填入,退格后重新计算候选。`/model ` 和 `/permission ` 的参数也支持补全。
|
|
151
|
+
|
|
138
152
|
| 按键 | 作用 |
|
|
139
153
|
|---|---|
|
|
140
154
|
| `Enter` | 提交;任务运行中提交为追加指令 |
|
|
@@ -149,14 +163,98 @@ deep-agent resume 01a08aae # 按 id 或前缀恢复
|
|
|
149
163
|
|
|
150
164
|
完整的命令、按键和界面行为见 [终端界面](https://github.com/ADaozz/deep_agent_cli/blob/main/docs/tui.md)。
|
|
151
165
|
|
|
166
|
+
## 使用 Skills
|
|
167
|
+
|
|
168
|
+
每个技能放在 `~/.deep-agent/skills/` 下的独立目录中,入口文件为 `SKILL.md`。其 YAML 头部必须包含 `name` 和 `description`;技能列表显示 `name`,缺少有效元数据的目录会被跳过。
|
|
169
|
+
|
|
170
|
+
### 安装示例:Playwright CLI
|
|
171
|
+
|
|
172
|
+
准备好 Node.js 和 npm 后,在终端执行以下命令。先使用[微软官方 Playwright CLI](https://github.com/microsoft/playwright-cli#installing-skills) 的安装命令生成 Skill,再复制到本项目使用的目录:
|
|
173
|
+
|
|
174
|
+
```bash
|
|
175
|
+
mkdir -p ~/.deep-agent/skills
|
|
176
|
+
cd ~/.deep-agent/skills
|
|
177
|
+
|
|
178
|
+
# 如果还没安装 CLI
|
|
179
|
+
npm install -g @playwright/cli@latest
|
|
180
|
+
|
|
181
|
+
# 安装官方 Skill 到临时目录
|
|
182
|
+
skill_tmp_dir="$(mktemp -d)"
|
|
183
|
+
(cd "$skill_tmp_dir" && playwright-cli install --skills=agents)
|
|
184
|
+
|
|
185
|
+
# 复制到 DeepAgent 的技能目录
|
|
186
|
+
cp -a "$skill_tmp_dir/.agents/skills/playwright-cli" ~/.deep-agent/skills/
|
|
187
|
+
|
|
188
|
+
# 清理临时目录
|
|
189
|
+
rm -rf "$skill_tmp_dir"
|
|
190
|
+
```
|
|
191
|
+
|
|
192
|
+
验证安装:
|
|
193
|
+
|
|
194
|
+
```bash
|
|
195
|
+
ls -R ~/.deep-agent/skills/playwright-cli
|
|
196
|
+
```
|
|
197
|
+
|
|
198
|
+
安装后目录结构如下,`references/` 中的参考文档也能读取:
|
|
199
|
+
|
|
200
|
+
```text
|
|
201
|
+
~/.deep-agent/
|
|
202
|
+
└── skills/
|
|
203
|
+
└── playwright-cli/
|
|
204
|
+
├── SKILL.md
|
|
205
|
+
└── references/
|
|
206
|
+
├── playwright-tests.md
|
|
207
|
+
├── request-mocking.md
|
|
208
|
+
├── running-code.md
|
|
209
|
+
├── session-management.md
|
|
210
|
+
├── storage-state.md
|
|
211
|
+
├── test-generation.md
|
|
212
|
+
├── tracing.md
|
|
213
|
+
├── video-recording.md
|
|
214
|
+
├── element-attributes.md
|
|
215
|
+
└── pr-attachments.md
|
|
216
|
+
```
|
|
217
|
+
|
|
218
|
+
### 在输入框中调用技能
|
|
219
|
+
|
|
220
|
+
在 CLI 中输入 `/skill` 后回车,用上下键选择技能,再回车将 `[Skill: playwright-cli]` 插入输入框。此时可以直接回车调用,也可以追加说明后提交:
|
|
221
|
+
|
|
222
|
+
```text
|
|
223
|
+
[Skill: playwright-cli] 检查当前项目页面的登录流程,并记录截图。
|
|
224
|
+
```
|
|
225
|
+
|
|
226
|
+
选择时按 `Esc` 取消;完整删除输入框中的技能块即可取消本次技能调用。技能列表在每次打开时重新读取目录。发送后的聊天记录仍显示技能名称块和附带说明,恢复会话时也保持这一显示方式。
|
|
227
|
+
|
|
228
|
+
技能目录以只读方式映射到 `/skills/`。DeepAgent 原生 SkillsMiddleware 加载技能名称和描述;提交时携带所选技能的名称及路径,由模型按需读取 `/skills/playwright-cli/SKILL.md` 和相关参考文件,技能正文不会整段展开到输入框中。
|
|
229
|
+
|
|
230
|
+
加载技能只提供操作说明。工具链要在宿主机装好,再通过沙箱挂载暴露给命令。沙箱不能 `sudo` 或 `apt-get`,所以不要在里面执行 `npx playwright install chrome`。
|
|
231
|
+
|
|
232
|
+
### 沙箱里的工具链
|
|
233
|
+
|
|
234
|
+
首次启动时,[`agent/config.example.yaml`](agent/config.example.yaml) 会复制成 `~/.deep-agent/config.yaml`。其中的 `sandbox` 段已经是默认工具链配置:`PATH` 包含 Node.js 和 Cargo,并挂载下面这些目录。`optional: true` 的源目录在宿主机上不存在时会被跳过,不会阻止启动。
|
|
235
|
+
|
|
236
|
+
| 宿主机路径 | 沙箱路径 | 权限 | 用途 |
|
|
237
|
+
|---|---|---|---|
|
|
238
|
+
| `~/.nvm/versions/node/v22.23.2` | `/opt/node` | 只读 | `node`、`npm`、`playwright-cli` |
|
|
239
|
+
| `~/.cargo` | `/opt/cargo` | 只读 | Rust 工具链 |
|
|
240
|
+
| `/opt/google` | `/opt/google` | 只读 | 系统 Chrome。`playwright-cli open` 使用 `/opt/google/chrome/chrome` |
|
|
241
|
+
| `~/.cache/ms-playwright` | `/opt/ms-playwright` | 可写 | Chrome for Testing。环境变量 `PLAYWRIGHT_BROWSERS_PATH` 指向这里 |
|
|
242
|
+
|
|
243
|
+
Node.js 版本以本机 `~/.nvm/versions/node/` 下的目录名为准,和模板不一致时改 `source`。其他装在 `~/.local`、`/opt` 或家目录里的程序同样处理:用 `readlink -f "$(command -v 工具名)"` 找到落在 `/usr`、`/bin`、`/lib` 之外的目录,按同样格式追加挂载,并把可执行文件所在目录加到 `PATH` 前面。`PATH` 会替换沙箱默认值,末尾保留 `/usr/local/bin:/usr/bin:/bin`。
|
|
244
|
+
|
|
245
|
+
`playwright-cli open` 走系统 Chrome,不读浏览器缓存。没有系统 Chrome 时,在宿主机执行 `npx playwright install chromium`(先保证 `~/.cache/ms-playwright` 存在),沙箱里再用 `playwright-cli open --browser=chromium`。缓存目录可写,沙箱中的安装和删除会改宿主机上的同一目录;只使用已安装浏览器时,把该项改到 `extra_read_only_mounts`。下载浏览器的命令需要网络。
|
|
246
|
+
|
|
247
|
+
已经存在的 `~/.deep-agent/config.yaml` 不会被模板覆盖。把模板里的 `sandbox.env_set` 和两个挂载列表合并进现有文件,保存后退出并重新启动 `deep-agent`。挂载规则见 [沙箱与权限](https://github.com/ADaozz/deep_agent_cli/blob/main/docs/sandbox.md)。
|
|
248
|
+
|
|
152
249
|
## 安全模型
|
|
153
250
|
|
|
154
251
|
| | 行为 |
|
|
155
252
|
|---|---|
|
|
156
253
|
| 命令能访问的文件 | 工作区(读写,在沙箱中为 `/workspace`)、`~/.deep-agent/skills/`(只读)、系统的 `/usr`、`/bin`、`/lib`(只读)。家目录的其余部分不可见 |
|
|
157
254
|
| 网络 | 命令默认无网络。模型可以为单条命令申请网络,此时它能访问互联网、`localhost` 和局域网 |
|
|
255
|
+
| 沙箱复用 | 每个会话最多一个无网沙箱和一个有网沙箱,按需启动、跨命令复用(`/tmp` 和后台进程保留),会话结束时销毁。切换模型或权限模式不重建沙箱;`ask` / `allow` 只决定之后的命令要不要审批 |
|
|
158
256
|
| 环境变量 | 只传入 `LANG`、`TERM` 等少量变量,其余需在配置中显式列出 |
|
|
159
|
-
| `ask` 模式(默认) |
|
|
257
|
+
| `ask` 模式(默认) | 每次运行命令、Web 搜索、写入、编辑、删除文件前需要确认 |
|
|
160
258
|
| `allow` 模式 | 所有工具自动批准,所有命令都开放网络。仅在沙箱可用时可开启,开启时需输入 `ALLOW` |
|
|
161
259
|
| 沙箱不可用 | 拒绝启动。只有在配置中设置 `sandbox.allow_unsandboxed: true`,或在启动提示中输入 `UNSANDBOXED`,命令才会以当前用户身份直接在宿主机上运行,此时只能使用 `ask` 模式 |
|
|
162
260
|
|
|
@@ -2,21 +2,22 @@
|
|
|
2
2
|
|
|
3
3
|
`deep-agent` 是一个在终端中运行的 Coding Agent,支持 Linux 和 WSL2。它把启动时所在的目录作为工作区,调用你配置的 OpenAI 兼容模型服务,并在 [Bubblewrap](https://github.com/containers/bubblewrap) 沙箱中执行命令。Agent 运行时基于 [Deep Agents](https://github.com/langchain-ai/deepagents) 和 LangGraph 构建。
|
|
4
4
|
|
|
5
|
-
当前版本 0.1.
|
|
5
|
+
当前版本 0.1.3,处于早期开发阶段。第一个稳定版之前,配置格式、会话存储格式和 Python API 都可能出现不兼容变更。
|
|
6
6
|
|
|
7
7
|
## 功能
|
|
8
8
|
|
|
9
9
|
- **文件操作**:在工作区中列目录、读、写、编辑、搜索、删除文件。
|
|
10
10
|
- **命令执行**:在 Bubblewrap 沙箱中运行 shell 命令,默认没有网络;输出实时显示。
|
|
11
|
-
-
|
|
11
|
+
- **审批**:默认 `ask` 模式下,每次运行命令、Web 搜索、写入、编辑、删除文件前都会请求你确认。
|
|
12
12
|
- **会话**:按工作区保存在本地 SQLite 中,可以随时恢复。
|
|
13
13
|
- **多模型**:在配置文件中定义多个模型,运行中切换模型和推理强度。支持 Chat Completions 和 Responses 两种接口。
|
|
14
|
-
-
|
|
14
|
+
- **流式输出**:思考内容和回答都流式显示;思考区默认保留按终端宽度折行后的末尾 5 行正文,`Ctrl+T` 展开。
|
|
15
15
|
- **运行中干预**:任务执行时可以追加指令、排队后续任务或取消。
|
|
16
16
|
- **图片输入**:向声明支持图片的模型发送图片。
|
|
17
17
|
- **结构化提问**:Agent 需要你做决定时,会弹出单选、多选、是/否或文本输入。
|
|
18
18
|
- **上下文压缩**:接近模型上下文窗口时自动摘要旧对话,也可以手动压缩。
|
|
19
|
-
-
|
|
19
|
+
- **技能**:从 `~/.deep-agent/skills/` 加载 Skills,通过 `/skill` 选择技能并附带任务说明,支持读取技能目录中的参考文件。
|
|
20
|
+
- **可选扩展**:配置 Tavily API key 后可以搜索公开网页;读取工作区根目录的 `AGENTS.md` 作为项目说明。
|
|
20
21
|
|
|
21
22
|
## 运行要求
|
|
22
23
|
|
|
@@ -67,14 +68,24 @@ llm:
|
|
|
67
68
|
api_key: ${MY_API_KEY} # 也可以直接写密钥
|
|
68
69
|
provider: openai-compatible # 端点支持 Responses API 时可改为 qwen-responses
|
|
69
70
|
stream_usage: true
|
|
71
|
+
reasoning_efforts: [none, low, medium, high] # 来源级列表,见下文
|
|
70
72
|
models:
|
|
71
73
|
main: # 模型键,自定义
|
|
72
74
|
model: your-model-name # 发给服务端的模型名
|
|
73
75
|
context_window: 128k
|
|
74
76
|
input: [text] # 支持图片时写 [text, image]
|
|
77
|
+
fast: {} # 省略的字段全部继承来源
|
|
78
|
+
other:
|
|
79
|
+
reasoning_efforts: [low, high] # 写了就完整替换来源列表
|
|
75
80
|
```
|
|
76
81
|
|
|
77
|
-
`
|
|
82
|
+
模型按「来源」分组。来源下可以写的字段,模型项中也都可以写:模型项省略则继承来源,写了就覆盖。列表字段(`input`、`reasoning_efforts`)是整表替换,不是合并;`reasoning_efforts` 写成 `null` 或 `[]` 会清除继承。
|
|
83
|
+
|
|
84
|
+
`provider` 未填写时默认为 `qwen-responses`(Responses API),只提供 Chat Completions 的服务需要显式写 `openai-compatible`。
|
|
85
|
+
|
|
86
|
+
`reasoning_efforts` 需要按服务商文档填写,程序不会自动探测。常见取值包括 `none`、`low`、`medium`、`high`、`xhigh`、`max`,同一模型在不同端点上可能不同。列表非空时,`/model` 只显示这些值,默认选中第一项;空列表或未配置时只显示 `default`,请求不携带强度参数。`default` 是 CLI 选项,不能写进列表。`none` 仅在端点明确支持关闭思考时才写;`low` 仍然会思考。Chat Completions 发送 `reasoning_effort`,Responses API 发送 `reasoning.effort`。
|
|
87
|
+
|
|
88
|
+
其他字段和服务商示例见 [配置参考](https://github.com/ADaozz/deep_agent_cli/blob/main/docs/configuration.md)。
|
|
78
89
|
|
|
79
90
|
**3. 在项目目录中启动**
|
|
80
91
|
|
|
@@ -101,12 +112,15 @@ deep-agent resume 01a08aae # 按 id 或前缀恢复
|
|
|
101
112
|
| `/help` | 列出命令和快捷键 |
|
|
102
113
|
| `/status` | 当前模型、权限模式、沙箱状态 |
|
|
103
114
|
| `/model` | 选择模型和推理强度 |
|
|
115
|
+
| `/skill` | 选择技能,在输入框插入技能名称块 |
|
|
104
116
|
| `/permission ask\|allow` | 切换审批模式 |
|
|
105
117
|
| `/resume`、`/new` | 切换到已有会话、新建会话 |
|
|
106
118
|
| `/compact` | 手动压缩上下文 |
|
|
107
119
|
| `/image <路径>` | 为下一条消息附加图片 |
|
|
108
120
|
| `/quit` | 退出 |
|
|
109
121
|
|
|
122
|
+
输入 `/` 显示命令候选,按连续子串匹配,例如 `/elp` 匹配 `/help`,`/hlp` 不匹配。完整匹配和前缀匹配优先;方向键选择,`Tab` 或 `Enter` 填入,退格后重新计算候选。`/model ` 和 `/permission ` 的参数也支持补全。
|
|
123
|
+
|
|
110
124
|
| 按键 | 作用 |
|
|
111
125
|
|---|---|
|
|
112
126
|
| `Enter` | 提交;任务运行中提交为追加指令 |
|
|
@@ -121,14 +135,98 @@ deep-agent resume 01a08aae # 按 id 或前缀恢复
|
|
|
121
135
|
|
|
122
136
|
完整的命令、按键和界面行为见 [终端界面](https://github.com/ADaozz/deep_agent_cli/blob/main/docs/tui.md)。
|
|
123
137
|
|
|
138
|
+
## 使用 Skills
|
|
139
|
+
|
|
140
|
+
每个技能放在 `~/.deep-agent/skills/` 下的独立目录中,入口文件为 `SKILL.md`。其 YAML 头部必须包含 `name` 和 `description`;技能列表显示 `name`,缺少有效元数据的目录会被跳过。
|
|
141
|
+
|
|
142
|
+
### 安装示例:Playwright CLI
|
|
143
|
+
|
|
144
|
+
准备好 Node.js 和 npm 后,在终端执行以下命令。先使用[微软官方 Playwright CLI](https://github.com/microsoft/playwright-cli#installing-skills) 的安装命令生成 Skill,再复制到本项目使用的目录:
|
|
145
|
+
|
|
146
|
+
```bash
|
|
147
|
+
mkdir -p ~/.deep-agent/skills
|
|
148
|
+
cd ~/.deep-agent/skills
|
|
149
|
+
|
|
150
|
+
# 如果还没安装 CLI
|
|
151
|
+
npm install -g @playwright/cli@latest
|
|
152
|
+
|
|
153
|
+
# 安装官方 Skill 到临时目录
|
|
154
|
+
skill_tmp_dir="$(mktemp -d)"
|
|
155
|
+
(cd "$skill_tmp_dir" && playwright-cli install --skills=agents)
|
|
156
|
+
|
|
157
|
+
# 复制到 DeepAgent 的技能目录
|
|
158
|
+
cp -a "$skill_tmp_dir/.agents/skills/playwright-cli" ~/.deep-agent/skills/
|
|
159
|
+
|
|
160
|
+
# 清理临时目录
|
|
161
|
+
rm -rf "$skill_tmp_dir"
|
|
162
|
+
```
|
|
163
|
+
|
|
164
|
+
验证安装:
|
|
165
|
+
|
|
166
|
+
```bash
|
|
167
|
+
ls -R ~/.deep-agent/skills/playwright-cli
|
|
168
|
+
```
|
|
169
|
+
|
|
170
|
+
安装后目录结构如下,`references/` 中的参考文档也能读取:
|
|
171
|
+
|
|
172
|
+
```text
|
|
173
|
+
~/.deep-agent/
|
|
174
|
+
└── skills/
|
|
175
|
+
└── playwright-cli/
|
|
176
|
+
├── SKILL.md
|
|
177
|
+
└── references/
|
|
178
|
+
├── playwright-tests.md
|
|
179
|
+
├── request-mocking.md
|
|
180
|
+
├── running-code.md
|
|
181
|
+
├── session-management.md
|
|
182
|
+
├── storage-state.md
|
|
183
|
+
├── test-generation.md
|
|
184
|
+
├── tracing.md
|
|
185
|
+
├── video-recording.md
|
|
186
|
+
├── element-attributes.md
|
|
187
|
+
└── pr-attachments.md
|
|
188
|
+
```
|
|
189
|
+
|
|
190
|
+
### 在输入框中调用技能
|
|
191
|
+
|
|
192
|
+
在 CLI 中输入 `/skill` 后回车,用上下键选择技能,再回车将 `[Skill: playwright-cli]` 插入输入框。此时可以直接回车调用,也可以追加说明后提交:
|
|
193
|
+
|
|
194
|
+
```text
|
|
195
|
+
[Skill: playwright-cli] 检查当前项目页面的登录流程,并记录截图。
|
|
196
|
+
```
|
|
197
|
+
|
|
198
|
+
选择时按 `Esc` 取消;完整删除输入框中的技能块即可取消本次技能调用。技能列表在每次打开时重新读取目录。发送后的聊天记录仍显示技能名称块和附带说明,恢复会话时也保持这一显示方式。
|
|
199
|
+
|
|
200
|
+
技能目录以只读方式映射到 `/skills/`。DeepAgent 原生 SkillsMiddleware 加载技能名称和描述;提交时携带所选技能的名称及路径,由模型按需读取 `/skills/playwright-cli/SKILL.md` 和相关参考文件,技能正文不会整段展开到输入框中。
|
|
201
|
+
|
|
202
|
+
加载技能只提供操作说明。工具链要在宿主机装好,再通过沙箱挂载暴露给命令。沙箱不能 `sudo` 或 `apt-get`,所以不要在里面执行 `npx playwright install chrome`。
|
|
203
|
+
|
|
204
|
+
### 沙箱里的工具链
|
|
205
|
+
|
|
206
|
+
首次启动时,[`agent/config.example.yaml`](agent/config.example.yaml) 会复制成 `~/.deep-agent/config.yaml`。其中的 `sandbox` 段已经是默认工具链配置:`PATH` 包含 Node.js 和 Cargo,并挂载下面这些目录。`optional: true` 的源目录在宿主机上不存在时会被跳过,不会阻止启动。
|
|
207
|
+
|
|
208
|
+
| 宿主机路径 | 沙箱路径 | 权限 | 用途 |
|
|
209
|
+
|---|---|---|---|
|
|
210
|
+
| `~/.nvm/versions/node/v22.23.2` | `/opt/node` | 只读 | `node`、`npm`、`playwright-cli` |
|
|
211
|
+
| `~/.cargo` | `/opt/cargo` | 只读 | Rust 工具链 |
|
|
212
|
+
| `/opt/google` | `/opt/google` | 只读 | 系统 Chrome。`playwright-cli open` 使用 `/opt/google/chrome/chrome` |
|
|
213
|
+
| `~/.cache/ms-playwright` | `/opt/ms-playwright` | 可写 | Chrome for Testing。环境变量 `PLAYWRIGHT_BROWSERS_PATH` 指向这里 |
|
|
214
|
+
|
|
215
|
+
Node.js 版本以本机 `~/.nvm/versions/node/` 下的目录名为准,和模板不一致时改 `source`。其他装在 `~/.local`、`/opt` 或家目录里的程序同样处理:用 `readlink -f "$(command -v 工具名)"` 找到落在 `/usr`、`/bin`、`/lib` 之外的目录,按同样格式追加挂载,并把可执行文件所在目录加到 `PATH` 前面。`PATH` 会替换沙箱默认值,末尾保留 `/usr/local/bin:/usr/bin:/bin`。
|
|
216
|
+
|
|
217
|
+
`playwright-cli open` 走系统 Chrome,不读浏览器缓存。没有系统 Chrome 时,在宿主机执行 `npx playwright install chromium`(先保证 `~/.cache/ms-playwright` 存在),沙箱里再用 `playwright-cli open --browser=chromium`。缓存目录可写,沙箱中的安装和删除会改宿主机上的同一目录;只使用已安装浏览器时,把该项改到 `extra_read_only_mounts`。下载浏览器的命令需要网络。
|
|
218
|
+
|
|
219
|
+
已经存在的 `~/.deep-agent/config.yaml` 不会被模板覆盖。把模板里的 `sandbox.env_set` 和两个挂载列表合并进现有文件,保存后退出并重新启动 `deep-agent`。挂载规则见 [沙箱与权限](https://github.com/ADaozz/deep_agent_cli/blob/main/docs/sandbox.md)。
|
|
220
|
+
|
|
124
221
|
## 安全模型
|
|
125
222
|
|
|
126
223
|
| | 行为 |
|
|
127
224
|
|---|---|
|
|
128
225
|
| 命令能访问的文件 | 工作区(读写,在沙箱中为 `/workspace`)、`~/.deep-agent/skills/`(只读)、系统的 `/usr`、`/bin`、`/lib`(只读)。家目录的其余部分不可见 |
|
|
129
226
|
| 网络 | 命令默认无网络。模型可以为单条命令申请网络,此时它能访问互联网、`localhost` 和局域网 |
|
|
227
|
+
| 沙箱复用 | 每个会话最多一个无网沙箱和一个有网沙箱,按需启动、跨命令复用(`/tmp` 和后台进程保留),会话结束时销毁。切换模型或权限模式不重建沙箱;`ask` / `allow` 只决定之后的命令要不要审批 |
|
|
130
228
|
| 环境变量 | 只传入 `LANG`、`TERM` 等少量变量,其余需在配置中显式列出 |
|
|
131
|
-
| `ask` 模式(默认) |
|
|
229
|
+
| `ask` 模式(默认) | 每次运行命令、Web 搜索、写入、编辑、删除文件前需要确认 |
|
|
132
230
|
| `allow` 模式 | 所有工具自动批准,所有命令都开放网络。仅在沙箱可用时可开启,开启时需输入 `ALLOW` |
|
|
133
231
|
| 沙箱不可用 | 拒绝启动。只有在配置中设置 `sandbox.allow_unsandboxed: true`,或在启动提示中输入 `UNSANDBOXED`,命令才会以当前用户身份直接在宿主机上运行,此时只能使用 `ask` 模式 |
|
|
134
232
|
|
|
@@ -1,4 +1,4 @@
|
|
|
1
|
-
"""
|
|
1
|
+
"""同步工具与 execute 的可选取消协议。"""
|
|
2
2
|
from __future__ import annotations
|
|
3
3
|
|
|
4
4
|
from contextvars import ContextVar, Token
|
|
@@ -95,6 +95,11 @@ def _kill_process_group(process: Any) -> None:
|
|
|
95
95
|
import os
|
|
96
96
|
import signal
|
|
97
97
|
|
|
98
|
+
# 持久沙箱内的命令没有可信号的宿主 PID;句柄只杀掉该命令,沙箱继续运行。
|
|
99
|
+
cancel_execution = getattr(process, "cancel_execution", None)
|
|
100
|
+
if callable(cancel_execution):
|
|
101
|
+
cancel_execution()
|
|
102
|
+
return
|
|
98
103
|
pid = getattr(process, "pid", None)
|
|
99
104
|
if not pid:
|
|
100
105
|
return
|