forgex-agent 0.5.2 → 0.5.7
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.
- package/README.md +15 -2
- package/main.js +16754 -10385
- package/package.json +1 -1
package/README.md
CHANGED
|
@@ -4,7 +4,7 @@ TUI-first 的 Coding + DevOps Agent。用自然语言让 Agent 读代码、改
|
|
|
4
4
|
|
|
5
5
|
## 环境要求
|
|
6
6
|
|
|
7
|
-
- Node.js **>= 22.13.0
|
|
7
|
+
- Node.js **>= 22.13.0**(依赖原生 fetch 与 AbortSignal.any)
|
|
8
8
|
- Git(使用 `git_status` / `git_diff` 时需要)
|
|
9
9
|
- 可选:ripgrep(`grep_search` 会优先使用;没有则回退到 Node 搜索)
|
|
10
10
|
|
|
@@ -45,8 +45,10 @@ forgex
|
|
|
45
45
|
| 命令 | 作用 |
|
|
46
46
|
| --- | --- |
|
|
47
47
|
| `/models` | 切换模型;也支持 `/models deepseek-v4-pro` |
|
|
48
|
+
| `/mode [模式]` | 查看/切换权限模式(readonly / standard / trusted / yolo),`Shift+Tab` 循环 |
|
|
48
49
|
| `/plan` | 进入/退出计划模式:只读分析,不改文件、不执行命令 |
|
|
49
50
|
| `/connect` | 配置 Provider、API Key、模型,并测试连通性 |
|
|
51
|
+
| `/key <API Key>` | 保存 API Key(持久化到凭据文件,重开会话仍可用) |
|
|
50
52
|
| `/context` | 查看当前上下文 token 估算 |
|
|
51
53
|
| `/session` | 查看当前会话 ID |
|
|
52
54
|
| `/help` | 查看帮助 |
|
|
@@ -63,6 +65,9 @@ forgex connect # 配置模型连接
|
|
|
63
65
|
forgex # 启动 TUI(非 TTY 时自动纯文本模式)
|
|
64
66
|
forgex run "检查端口 8080" # 单次任务
|
|
65
67
|
forgex run --json "..." # JSON 输出
|
|
68
|
+
forgex run "修复空指针" --worktree # 在独立 Git worktree + 分支中执行,产物可审阅
|
|
69
|
+
forgex task list|show|diff|clean # 审阅/清理 worktree 任务产物
|
|
70
|
+
forgex sandbox # 查看沙箱能力(区分工作区隔离 / 资源限制 / OS 级隔离)
|
|
66
71
|
forgex doctor # 环境自检
|
|
67
72
|
forgex tools # 列出内置工具
|
|
68
73
|
forgex sessions # 查看历史会话
|
|
@@ -70,6 +75,11 @@ forgex config # 查看最终生效配置(Key 脱敏)
|
|
|
70
75
|
```
|
|
71
76
|
|
|
72
77
|
`forgex run` 支持 `--session <id>` 继续历史会话,`--yes` 跳过审批(仅建议在隔离环境使用)。
|
|
78
|
+
任务闭环会生成计划、逐步执行并运行项目质量门禁(如 `npm test`),最终状态以 JSON 输出与
|
|
79
|
+
`forgex task list` 为准:`completed` / `unverified` / `failed` 等;`unverified` 表示项目没有可运行的
|
|
80
|
+
门禁命令,不能当作验证通过。
|
|
81
|
+
`--worktree` 只隔离工作区与改动(独立 worktree + 分支,产物用 `forgex task diff` 审阅),
|
|
82
|
+
仓库有未提交改动时会直接拒绝,不会 stash/reset。
|
|
73
83
|
|
|
74
84
|
## 配置
|
|
75
85
|
|
|
@@ -93,7 +103,10 @@ forgex config # 查看最终生效配置(Key 脱敏)
|
|
|
93
103
|
|
|
94
104
|
- 写文件、执行命令默认需要人工审批。
|
|
95
105
|
- 审计日志写入 `~/.forgex/audit.jsonl`,敏感字段会脱敏。
|
|
96
|
-
-
|
|
106
|
+
- 会话、审计、指标与任务状态默认保存在当前工作区的 `.forgex/events.jsonl`。
|
|
107
|
+
- 临时目录 / Git worktree 只隔离文件视图;Rust 执行器只提供超时、输出限额与进程树清理——
|
|
108
|
+
都**不是** OS 沙箱。OS 级隔离(bubblewrap)目前仅 Linux 可用,需通过启动探针验证;
|
|
109
|
+
其它平台或验证失败时,不可信代码执行(`trustLevel: untrusted`)一律拒绝,不降级、不静默裸跑。
|
|
97
110
|
- 命令白名单不是内核级沙箱;不要在不可信目录中随意授予执行权限。
|
|
98
111
|
|
|
99
112
|
## 链接
|