@dobby.ai/dobby 0.1.2 → 0.2.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 +53 -1
- package/package.json +1 -1
package/README.md
CHANGED
|
@@ -214,6 +214,37 @@ dobby cron resume <jobId>
|
|
|
214
214
|
dobby cron remove <jobId>
|
|
215
215
|
```
|
|
216
216
|
|
|
217
|
+
## Release 流程
|
|
218
|
+
|
|
219
|
+
仓库现在内置了两条 GitHub Actions：
|
|
220
|
+
|
|
221
|
+
- `.github/workflows/ci.yml`
|
|
222
|
+
- 在 PR / push 到 `main` 时执行 `npm ci`、`npm run plugins:install`、`npm run check`、`npm run build`、`npm run test:cli`、`npm run plugins:check`、`npm run plugins:build`
|
|
223
|
+
- `.github/workflows/release.yml`
|
|
224
|
+
- 在 push 到 `main` 时运行 Release Please
|
|
225
|
+
- 有 releasable commit 时自动维护 release PR
|
|
226
|
+
- release PR 合并后自动发布对应 npm 包，并为每个包生成独立 GitHub release / tag
|
|
227
|
+
|
|
228
|
+
推荐的日常流程：
|
|
229
|
+
|
|
230
|
+
1. 正常提交功能改动到 PR（建议继续使用 Conventional Commits 风格，例如 `feat(...)` / `fix(...)`）
|
|
231
|
+
2. 合并到 `main`
|
|
232
|
+
3. 等待 Release Please 自动更新或创建 release PR
|
|
233
|
+
4. review 并合并 release PR
|
|
234
|
+
5. 合并后由 `release.yml` 自动执行 npm trusted publishing
|
|
235
|
+
|
|
236
|
+
注意：
|
|
237
|
+
|
|
238
|
+
- 首次启用前，需要在 npm 后台为每个 `@dobby.ai/*` 包配置 GitHub trusted publisher，指向当前仓库和 `.github/workflows/release.yml`
|
|
239
|
+
- 建议在 GitHub 仓库里创建 `npm-publish` environment，后续若需要人工审批可以直接加保护规则
|
|
240
|
+
- 进入自动发版流程后，后续版本号应由 Release Please 维护，不再手动执行 `npm version`
|
|
241
|
+
- 本地手动兜底发布仍然保留，可用：
|
|
242
|
+
|
|
243
|
+
```bash
|
|
244
|
+
node scripts/publish-packages.mjs --package plugins/provider-codex-cli --skip-existing
|
|
245
|
+
node scripts/publish-packages.mjs --package . --tag next
|
|
246
|
+
```
|
|
247
|
+
|
|
217
248
|
## Gateway 配置模型
|
|
218
249
|
|
|
219
250
|
顶层结构：
|
|
@@ -305,9 +336,30 @@ codex login status
|
|
|
305
336
|
|
|
306
337
|
- `command`（默认 `codex`）
|
|
307
338
|
- `commandArgs`（默认 `[]`）
|
|
308
|
-
- `model
|
|
339
|
+
- `model`（可选；未设置时沿用 Codex CLI 当前 profile / `~/.codex/config.toml` 的默认模型）
|
|
340
|
+
- `profile`（可选；等价于 `codex -p <profile>`）
|
|
341
|
+
- `approvalPolicy`（可选；默认 `never`）
|
|
342
|
+
- `sandboxMode`（可选；不填时按 route 的 `tools` 推导：`readonly -> read-only`，`full -> workspace-write`）
|
|
343
|
+
- `configOverrides`（可选；字符串数组，按原样转成重复的 `codex -c key=value`）
|
|
309
344
|
- `skipGitRepoCheck`（默认 `false`）
|
|
310
345
|
|
|
346
|
+
例如希望网关里的 Codex 会话复用本机 profile，并显式打开无人值守执行：
|
|
347
|
+
|
|
348
|
+
```json
|
|
349
|
+
{
|
|
350
|
+
"type": "provider.codex-cli",
|
|
351
|
+
"command": "codex",
|
|
352
|
+
"profile": "background",
|
|
353
|
+
"approvalPolicy": "never",
|
|
354
|
+
"sandboxMode": "danger-full-access",
|
|
355
|
+
"configOverrides": [
|
|
356
|
+
"model_reasoning_effort = \"xhigh\""
|
|
357
|
+
]
|
|
358
|
+
}
|
|
359
|
+
```
|
|
360
|
+
|
|
361
|
+
注意：`provider.codex-cli` 当前是 host-only，`danger-full-access` 会直接作用在宿主机上。
|
|
362
|
+
|
|
311
363
|
`--enable` 的行为：
|
|
312
364
|
|
|
313
365
|
- 把包写入 `extensions.allowList`
|