@epoch-agent/cli 4.1.1 → 6.0.0
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 +11 -18
- package/dist/index.js +386 -539
- package/dist/tui-entry.js +141 -291
- package/package.json +7 -7
package/README.md
CHANGED
|
@@ -2,7 +2,7 @@
|
|
|
2
2
|
|
|
3
3
|
CLI 入口。装了它才有 `epoch` 这个可执行文件。
|
|
4
4
|
|
|
5
|
-
- ✅ **做**:commander 参数解析、TUI
|
|
5
|
+
- ✅ **做**:commander 参数解析、TUI 启动、审批的终端交互、输出格式化、
|
|
6
6
|
退出码、更新检查、shell 补全
|
|
7
7
|
- ❌ **不做**:装配(在 [runtime](../runtime))、领域逻辑(在 [core](../core))、
|
|
8
8
|
渲染细节(在 [tui](../tui))
|
|
@@ -38,7 +38,6 @@ epoch doctor # 装不上 / 跑不起来时第一个跑这个
|
|
|
38
38
|
| `commands/web-open.ts` | 跨平台打开浏览器(`start` / `open` / `xdg-open`) |
|
|
39
39
|
| `tui-entry.ts` | TUI 启动:建 runtime、接 `AgentSession`、`renderApp()` |
|
|
40
40
|
| `approval.ts` | 非 TUI 场景的终端审批交互 |
|
|
41
|
-
| `trust-prompt.ts` | 工作区信任的首次询问 |
|
|
42
41
|
| `import-prompt.ts` | 指令文件引用项目**之外**的文件时的逐个询问(方案 33) |
|
|
43
42
|
| `files/` | `config.yaml` / `.env` 的读写(保留注释与格式);以及 `epoch config schema` 写出的 `.epoch/schemas/*.json` |
|
|
44
43
|
| `errors.ts` / `exit-codes.ts` | 错误 → 人话 + 稳定退出码(CI 靠它判断)。别的包抛的「预期内失败」按 `err.name` 查一张表,不打 stack |
|
|
@@ -105,8 +104,8 @@ stdio 让父进程自然活着):worktree 的收尾得等 TUI 真的退出,
|
|
|
105
104
|
打字的时候问他「要不要删这个 worktree」。
|
|
106
105
|
|
|
107
106
|
`-c` / `-r` 还多一条:**选哪一段在父进程里就定完**(含 `-r` 不带 id 时的选择器)。
|
|
108
|
-
ink 一接管 stdin,inquirer 就抢不回来 ——
|
|
109
|
-
|
|
107
|
+
ink 一接管 stdin,inquirer 就抢不回来 —— 和项目外 `@import` 的询问必须排在
|
|
108
|
+
`renderApp` 之前是同一个约束。
|
|
110
109
|
|
|
111
110
|
三处的「坏输入」都**报错退出**,不静默当没给:
|
|
112
111
|
|
|
@@ -202,22 +201,16 @@ ink 一接管 stdin,inquirer 就抢不回来 —— 和信任闸门必须排
|
|
|
202
201
|
所以本包的 `build` 就是一句 `tsup`,`epoch web` 也不再自己去探产物目录——
|
|
203
202
|
不传 `webRoot`,由 `createWebServer()` 定位自带的那份。
|
|
204
203
|
|
|
205
|
-
## `epoch web`
|
|
204
|
+
## `epoch web` 是一个**宿主**,但插件页不再需要它点头
|
|
206
205
|
|
|
207
|
-
`buildRuntime()` 上那几个 `host*` 选项(`hostCapabilities` / `
|
|
208
|
-
|
|
209
|
-
|
|
206
|
+
`buildRuntime()` 上那几个 `host*` 选项(`hostCapabilities` / `hostPreset`)是给
|
|
207
|
+
「把引擎嵌进自己程序里」的人用的。2026-11-06 之前这里还有第三个:
|
|
208
|
+
`hostMarketplaces` + `--plugins`,让 `epoch web` 显式决定开不开插件页。
|
|
209
|
+
市场 / 上传那一整套宿主定制删掉之后,**本地安装不依赖任何宿主开关**,
|
|
210
|
+
`runtime.plugins` 永远装配 —— 那个旗子没有可切的东西了,于是删了。
|
|
210
211
|
|
|
211
|
-
|
|
212
|
-
|
|
213
|
-
[`commands/web.ts`](src/commands/web.ts) 的文件头,一句话版本:装一个插件会往
|
|
214
|
-
`~/.epoch/plugins/` 里落 `hooks.json` / `mcp.json`,下一程启动时照着跑,
|
|
215
|
-
所以那是一个要人点头的新口子。
|
|
216
|
-
|
|
217
|
-
⚠️ `sources` 是**空的**,这是对的不是没写完:我们没有「宿主 ship 的市场目录」
|
|
218
|
-
那种东西,清单该来自用户自己 `epoch plugin marketplace add` 加的那些,
|
|
219
|
-
而那张表 runtime 本来就在读。命令行上的用法在
|
|
220
|
-
[docs/CLI.md](../../docs/CLI.md) 的「Web UI」一节,别在这儿再抄一份 flag 表。
|
|
212
|
+
⚠️ 写口那些 POST 的回环闸不受影响:`--host 0.0.0.0` 下读得到、装不了。
|
|
213
|
+
命令行上的用法在 [docs/CLI.md](../../docs/CLI.md) 的「Web UI」一节。
|
|
221
214
|
|
|
222
215
|
## 开发
|
|
223
216
|
|