agent-steward 0.0.3 → 0.0.4
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/CHANGELOG.md +20 -0
- package/README.md +3 -3
- package/ROADMAP-STRATEGY.md +9 -9
- package/ROADMAP.md +50 -34
- package/dist/core/dlq-api.d.ts +44 -0
- package/dist/core/dlq-api.d.ts.map +1 -0
- package/dist/core/dlq-api.js +68 -0
- package/dist/core/dry-run.d.ts.map +1 -1
- package/dist/core/dry-run.js +18 -1
- package/dist/core/lock.d.ts +20 -4
- package/dist/core/lock.d.ts.map +1 -1
- package/dist/core/lock.js +97 -22
- package/dist/core/one-shot.d.ts +5 -1
- package/dist/core/one-shot.d.ts.map +1 -1
- package/dist/core/one-shot.js +33 -8
- package/dist/core/opencode-cli.d.ts +28 -0
- package/dist/core/opencode-cli.d.ts.map +1 -0
- package/dist/core/opencode-cli.js +74 -0
- package/dist/core/opencode-models.d.ts +62 -0
- package/dist/core/opencode-models.d.ts.map +1 -0
- package/dist/core/opencode-models.js +277 -0
- package/dist/core/ps-wrapper.d.ts +1 -1
- package/dist/core/ps-wrapper.d.ts.map +1 -1
- package/dist/core/ps-wrapper.js +11 -1
- package/dist/core/record-history.d.ts +15 -0
- package/dist/core/record-history.d.ts.map +1 -1
- package/dist/core/record-history.js +56 -32
- package/dist/core/router/dispatch.d.ts +36 -0
- package/dist/core/router/dispatch.d.ts.map +1 -0
- package/dist/core/router/dispatch.js +59 -0
- package/dist/core/router/escalation.d.ts +47 -0
- package/dist/core/router/escalation.d.ts.map +1 -0
- package/dist/core/router/escalation.js +87 -0
- package/dist/core/router/planner.d.ts +53 -0
- package/dist/core/router/planner.d.ts.map +1 -0
- package/dist/core/router/planner.js +113 -0
- package/dist/core/router/rules.d.ts +46 -0
- package/dist/core/router/rules.d.ts.map +1 -0
- package/dist/core/router/rules.js +85 -0
- package/dist/core/run-panel-api.d.ts +94 -0
- package/dist/core/run-panel-api.d.ts.map +1 -0
- package/dist/core/run-panel-api.js +169 -0
- package/dist/core/schedule-gate.js +5 -1
- package/dist/core/schedule-v2.d.ts +34 -0
- package/dist/core/schedule-v2.d.ts.map +1 -1
- package/dist/core/schedule-v2.js +91 -5
- package/dist/core/scheduler/at-fallback.d.ts +55 -2
- package/dist/core/scheduler/at-fallback.d.ts.map +1 -1
- package/dist/core/scheduler/at-fallback.js +135 -5
- package/dist/core/scheduler/linux.d.ts +10 -1
- package/dist/core/scheduler/linux.d.ts.map +1 -1
- package/dist/core/scheduler/linux.js +29 -11
- package/dist/core/scheduler/posix.d.ts.map +1 -1
- package/dist/core/scheduler/posix.js +25 -1
- package/dist/core/scheduler/registry.d.ts +11 -0
- package/dist/core/scheduler/registry.d.ts.map +1 -1
- package/dist/core/scheduler/registry.js +83 -21
- package/dist/core/scheduler/run-now.d.ts +16 -0
- package/dist/core/scheduler/run-now.d.ts.map +1 -0
- package/dist/core/scheduler/run-now.js +28 -0
- package/dist/core/secrets.d.ts.map +1 -1
- package/dist/core/secrets.js +125 -28
- package/dist/core/session.d.ts.map +1 -1
- package/dist/core/session.js +18 -11
- package/dist/core/task-name.d.ts +24 -0
- package/dist/core/task-name.d.ts.map +1 -0
- package/dist/core/task-name.js +40 -0
- package/dist/core/wrappers/bash.d.ts.map +1 -1
- package/dist/core/wrappers/bash.js +49 -4
- package/dist/db/capability-repo.d.ts +83 -0
- package/dist/db/capability-repo.d.ts.map +1 -0
- package/dist/db/capability-repo.js +182 -0
- package/dist/db/history-repo.d.ts +8 -0
- package/dist/db/history-repo.d.ts.map +1 -1
- package/dist/db/history-repo.js +19 -0
- package/dist/db/index.d.ts +4 -0
- package/dist/db/index.d.ts.map +1 -1
- package/dist/db/index.js +39 -1
- package/dist/db/migrate.d.ts.map +1 -1
- package/dist/db/migrate.js +3 -1
- package/dist/db/run-context.d.ts +103 -0
- package/dist/db/run-context.d.ts.map +1 -0
- package/dist/db/run-context.js +224 -0
- package/dist/db/run-dlq.d.ts +100 -0
- package/dist/db/run-dlq.d.ts.map +1 -0
- package/dist/db/run-dlq.js +191 -0
- package/dist/db/run-resume.d.ts +5 -2
- package/dist/db/run-resume.d.ts.map +1 -1
- package/dist/db/run-resume.js +30 -11
- package/dist/db/runs-repo.d.ts +13 -5
- package/dist/db/runs-repo.d.ts.map +1 -1
- package/dist/db/runs-repo.js +28 -5
- package/dist/db/schema.d.ts +2 -2
- package/dist/db/schema.d.ts.map +1 -1
- package/dist/db/schema.js +154 -2
- package/dist/db/settings-repo.d.ts +11 -0
- package/dist/db/settings-repo.d.ts.map +1 -1
- package/dist/db/settings-repo.js +25 -0
- package/dist/db/step-idempotency.d.ts +51 -0
- package/dist/db/step-idempotency.d.ts.map +1 -0
- package/dist/db/step-idempotency.js +136 -0
- package/dist/index.d.ts +4 -4
- package/dist/index.d.ts.map +1 -1
- package/dist/index.js +102 -4
- package/dist/rpc.d.ts +678 -0
- package/dist/rpc.d.ts.map +1 -1
- package/dist/rpc.js +235 -0
- package/dist/server.d.ts +31 -0
- package/dist/server.d.ts.map +1 -1
- package/dist/server.js +95 -35
- package/dist/types.d.ts.map +1 -1
- package/dist/types.js +7 -0
- package/dist/workspaces.d.ts +25 -3
- package/dist/workspaces.d.ts.map +1 -1
- package/dist/workspaces.js +43 -8
- package/docs/ARCHITECTURE.md +229 -5
- package/docs/CONCEPT.md +171 -91
- package/docs/EXECUTION-LOOP.md +196 -0
- package/docs/README.ru.md +2 -2
- package/docs/README.zh.md +3 -3
- package/docs/SAFETY.md +122 -0
- package/docs/SAVINGS.md +29 -0
- package/docs/SAVINGS.ru.md +29 -0
- package/docs/SAVINGS.zh.md +18 -0
- package/gui-experimental.cjs +8 -8
- package/locales/en.json +67 -0
- package/locales/ru.json +67 -0
- package/locales/zh.json +67 -0
- package/package.json +28 -3
- package/scripts/audit-bundle.mjs +215 -0
- package/src/core/dlq-api.ts +98 -0
- package/src/core/dry-run.ts +25 -1
- package/src/core/lock.ts +95 -22
- package/src/core/one-shot.ts +36 -8
- package/src/core/opencode-cli.ts +103 -0
- package/src/core/opencode-models.ts +315 -0
- package/src/core/ps-wrapper.ts +11 -1
- package/src/core/record-history.ts +75 -37
- package/src/core/router/dispatch.ts +94 -0
- package/src/core/router/escalation.ts +129 -0
- package/src/core/router/planner.ts +166 -0
- package/src/core/router/rules.ts +109 -0
- package/src/core/run-panel-api.ts +262 -0
- package/src/core/schedule-gate.ts +6 -2
- package/src/core/schedule-v2.ts +114 -5
- package/src/core/scheduler/at-fallback.ts +190 -5
- package/src/core/scheduler/linux.ts +32 -10
- package/src/core/scheduler/posix.ts +20 -1
- package/src/core/scheduler/registry.ts +107 -26
- package/src/core/scheduler/run-now.ts +32 -0
- package/src/core/secrets.ts +127 -27
- package/src/core/session.ts +23 -10
- package/src/core/task-name.ts +67 -0
- package/src/core/wrappers/bash.ts +49 -4
- package/src/db/capability-repo.ts +285 -0
- package/src/db/history-repo.ts +22 -0
- package/src/db/index.ts +37 -1
- package/src/db/migrate.ts +3 -1
- package/src/db/run-context.ts +370 -0
- package/src/db/run-dlq.ts +310 -0
- package/src/db/run-resume.ts +48 -12
- package/src/db/runs-repo.ts +30 -7
- package/src/db/schema.ts +154 -2
- package/src/db/settings-repo.ts +31 -0
- package/src/db/step-idempotency.ts +185 -0
- package/src/gui.tsx +515 -0
- package/src/index.ts +124 -4
- package/src/rpc.ts +251 -0
- package/src/server.ts +112 -36
- package/src/types.ts +9 -0
- package/src/workspaces.ts +58 -9
package/docs/README.ru.md
CHANGED
|
@@ -18,7 +18,7 @@ Translations: [English](../README.md) · [中文](README.zh.md).
|
|
|
18
18
|
|
|
19
19
|
> Поставь задачу «утренний-отчёт»: каждый день в 09:00 с промптом «Просуммаризируй вчерашние git-коммиты и запиши отчёт в ~/reports/».
|
|
20
20
|
|
|
21
|
-
3. Откройте дашборд: агент печатает ссылку при создании задачи (по умолчанию `http://localhost:
|
|
21
|
+
3. Откройте дашборд: агент печатает ссылку при создании задачи (по умолчанию `http://localhost:3782`), позже её можно получить инструментом `get_dashboard_info`. Посмотреть демо без установки: `node scripts/demo-dashboard.mjs` — дашборд с демо-данными на `http://localhost:3782`.
|
|
22
22
|
|
|
23
23
|

|
|
24
24
|
|
|
@@ -224,7 +224,7 @@ src/
|
|
|
224
224
|
npm install
|
|
225
225
|
npm run build # tsc
|
|
226
226
|
npm run build:gui # vite
|
|
227
|
-
npm test #
|
|
227
|
+
npm test # 83 сюит, 600+ проверок
|
|
228
228
|
npm run test:en # те же сюиты с английской локалью
|
|
229
229
|
```
|
|
230
230
|
|
package/docs/README.zh.md
CHANGED
|
@@ -19,7 +19,7 @@ Translations: [English](../README.md) · [Русский](README.ru.md).
|
|
|
19
19
|
|
|
20
20
|
> 创建一个名为 "morning-report" 的任务,每天 09:00 运行,提示词为:"Summarize yesterday's git commits and write the report to ~/reports/"。
|
|
21
21
|
|
|
22
|
-
3. 打开仪表盘观察运行情况:创建任务时 agent 会打印 URL(默认 `http://localhost:
|
|
22
|
+
3. 打开仪表盘观察运行情况:创建任务时 agent 会打印 URL(默认 `http://localhost:3782`),之后也可以随时用 `get_dashboard_info` 工具获取。想不安装任何东西先看看效果?`node scripts/demo-dashboard.mjs` 会在 `http://localhost:3782` 启动一个演示仪表盘。
|
|
23
23
|
|
|
24
24
|
## 为什么需要它
|
|
25
25
|
|
|
@@ -35,7 +35,7 @@ Translations: [English](../README.md) · [Русский](README.ru.md).
|
|
|
35
35
|
|
|
36
36
|

|
|
37
37
|
|
|
38
|
-
不想安装 OpenCode 也想看看效果?`node scripts/demo-dashboard.mjs` 会用演示数据在 http://localhost:
|
|
38
|
+
不想安装 OpenCode 也想看看效果?`node scripts/demo-dashboard.mjs` 会用演示数据在 http://localhost:3782 启动仪表盘。
|
|
39
39
|
|
|
40
40
|
## 功能
|
|
41
41
|
|
|
@@ -231,7 +231,7 @@ src/
|
|
|
231
231
|
npm install
|
|
232
232
|
npm run build # tsc
|
|
233
233
|
npm run build:gui # vite
|
|
234
|
-
npm test #
|
|
234
|
+
npm test # 83 test suites, 600+ checks
|
|
235
235
|
npm run test:en # same suites with the English locale
|
|
236
236
|
```
|
|
237
237
|
|
package/docs/SAFETY.md
ADDED
|
@@ -0,0 +1,122 @@
|
|
|
1
|
+
# SAFETY — контракт безопасности миссии
|
|
2
|
+
|
|
3
|
+
> Шаг 1 цикла v2.1. Принцип: **продукт для людей** — не сломать репо, не слить
|
|
4
|
+
> данные, не разорить. Порядок столпов: надёжно > приватно > дёшево > фичи.
|
|
5
|
+
> Контракт одинаков для **ad-hoc**, внутренних и registered запусков.
|
|
6
|
+
|
|
7
|
+
## 1. Классы риска
|
|
8
|
+
|
|
9
|
+
| Класс | Что делает | Примеры | Default |
|
|
10
|
+
|-------|-----------|---------|---------|
|
|
11
|
+
| **R0** read-only | Читает, ничего не меняет | анализ, отчёт, обзор | разрешён |
|
|
12
|
+
| **R1** local-write | Меняет файлы в изолированном worktree | правка кода, бойлерплейт | разрешён в worktree |
|
|
13
|
+
| **R2** external-effect | Меняет внешнее состояние | git push, PR, API-запись, деплой | **approval + отложенные эффекты** |
|
|
14
|
+
| **R3** destructive / egress | Удаляет, льёт данные наружу | reset --hard, удаление, отправка наружу | **approval + явный opt-in** |
|
|
15
|
+
|
|
16
|
+
Класс определяется по **инструментам и командам**, а не по описанию миссии.
|
|
17
|
+
|
|
18
|
+
## 2. Компиляция политики (принуждение, не декларация)
|
|
19
|
+
|
|
20
|
+
```
|
|
21
|
+
risk R2 → allowedTools: [read, edit, glob, grep]
|
|
22
|
+
deniedTools: [shell]
|
|
23
|
+
egress: [] (кроме явного allowlist)
|
|
24
|
+
requiredGates: [tests, lint, approval]
|
|
25
|
+
effects: deferred (intents)
|
|
26
|
+
budget: из контракта
|
|
27
|
+
```
|
|
28
|
+
|
|
29
|
+
- Enforcement — существующие `permissions` / `OPENCODE_CONFIG_CONTENT` +
|
|
30
|
+
egress-контроль на уровне исполнения.
|
|
31
|
+
- `policy_hash` пишется в ledger; изменение политики посреди миссии → `fail` +
|
|
32
|
+
аудит-инцидент.
|
|
33
|
+
- Внешние policy-движки (OPA/Cedar) на этом этапе не используем: локальная одна
|
|
34
|
+
машина, мало зависимостей.
|
|
35
|
+
|
|
36
|
+
## 3. Capability issuance на шаг
|
|
37
|
+
|
|
38
|
+
- Агент получает **scoped-конфиг ровно на шаг**, не на миссию.
|
|
39
|
+
- Секреты — короткоживущая инъекция только используемых (`collectSecretNames`),
|
|
40
|
+
очистка после шага.
|
|
41
|
+
- Никаких долгоживущих токенов в окружении задачи.
|
|
42
|
+
|
|
43
|
+
## 4. Уровни изоляции
|
|
44
|
+
|
|
45
|
+
| Уровень | Механизм | Когда |
|
|
46
|
+
|---------|----------|-------|
|
|
47
|
+
| 1 (default) | git worktree | R0/R1 |
|
|
48
|
+
| 2 | OS-jail: ограничение ФС/процессов | R1 с недоверенным контентом |
|
|
49
|
+
| 3 | Docker runner (opt-in, спринт 46) | R2/R3, недоверенные зависимости |
|
|
50
|
+
|
|
51
|
+
**Worktree не защищает от сети/API/БД** — поэтому обязателен следующий раздел.
|
|
52
|
+
|
|
53
|
+
## 5. Отложенные внешние эффекты
|
|
54
|
+
|
|
55
|
+
1. До гейта агент **не выполняет** irreversible-действие, а пишет `effect_intents`.
|
|
56
|
+
2. Гейт проверяет артефакт и валидность intents (политика, egress, blast-radius).
|
|
57
|
+
3. `pass` → применение, отметка `effects_applied_at`.
|
|
58
|
+
4. `fail` → discard; частично применённые — компенсация (saga).
|
|
59
|
+
|
|
60
|
+
Так «локальность» действительно ограничивает ущерб, а не только конфликты файлов.
|
|
61
|
+
|
|
62
|
+
## 6. Blast-radius
|
|
63
|
+
|
|
64
|
+
- Работа в worktree; основное дерево не трогается до принятия.
|
|
65
|
+
- Запрет push в защищённые ветки; лимит числа файлов и объёма diff.
|
|
66
|
+
- Egress только по явному allowlist; всё в аудит.
|
|
67
|
+
- Destructive-команды запрещены без явного разрешения в контракте.
|
|
68
|
+
|
|
69
|
+
## 7. Бюджет миссии (живой)
|
|
70
|
+
|
|
71
|
+
```yaml
|
|
72
|
+
budget:
|
|
73
|
+
maxUsd: 0.50
|
|
74
|
+
maxTokens: 200000
|
|
75
|
+
maxMinutes: 30
|
|
76
|
+
maxEscalations: 2
|
|
77
|
+
```
|
|
78
|
+
|
|
79
|
+
Счётчик ведётся в durable-run и учитывает **верификацию и эскалации**. При
|
|
80
|
+
подходе к границе роутинг предлагает более дешёвую модель или `review`;
|
|
81
|
+
превышение → circuit-breaker, статус `review`, уведомление.
|
|
82
|
+
|
|
83
|
+
## 8. Approval-матрица
|
|
84
|
+
|
|
85
|
+
| Условие | Требуется |
|
|
86
|
+
|---------|-----------|
|
|
87
|
+
| R0 / R1 в worktree | нет |
|
|
88
|
+
| R2 (внешний эффект) | approval + отложенные эффекты |
|
|
89
|
+
| R3 (destructive / egress) | approval + явный opt-in |
|
|
90
|
+
| Превышен бюджет | остановка + review |
|
|
91
|
+
| Capability-карта даёт `review` | очередь человеку с evidence |
|
|
92
|
+
|
|
93
|
+
`approval` — **тип гейта**. Исполнение — на существующей паузе с инъекциями:
|
|
94
|
+
paused-миссия **не потребляет compute**, комментарий человека доставляется шагу
|
|
95
|
+
при resume.
|
|
96
|
+
|
|
97
|
+
## 9. Least privilege и недоверенный контент
|
|
98
|
+
|
|
99
|
+
- Политика прав задачи (`hybrid` по умолчанию) — пол, не потолок.
|
|
100
|
+
- Gate-файлы и gate-команда вне write-scope агента.
|
|
101
|
+
- Внешний контент (web, issues, PR) — недоверенный по умолчанию: prompt-injection
|
|
102
|
+
учитывается как угроза.
|
|
103
|
+
- Секреты маскируются в логах, истории и аудите.
|
|
104
|
+
|
|
105
|
+
## 10. Kill switch
|
|
106
|
+
|
|
107
|
+
- Остановка миссии в любой момент; откат worktree чистый, intents отбрасываются.
|
|
108
|
+
- Глобальная пауза планировщика останавливает новые **registered** запуски;
|
|
109
|
+
ad-hoc миссии можно запускать и на паузе планировщика (это разные подсистемы).
|
|
110
|
+
|
|
111
|
+
## 11. Инварианты (проверяются тестами)
|
|
112
|
+
|
|
113
|
+
1. Миссия без gate-спеки не принимается.
|
|
114
|
+
2. Миссия без safety-контракта получает safe-default (R1, worktree, бюджет).
|
|
115
|
+
3. R2/R3 без approval не стартует.
|
|
116
|
+
4. Агент не получает инструмент, запрещённый скомпилированной политикой.
|
|
117
|
+
5. Агент не может изменить gate-файлы (`gate_hash` сверяется).
|
|
118
|
+
6. Irreversible-действие невозможно до `pass`.
|
|
119
|
+
7. Превышение бюджета останавливает миссию.
|
|
120
|
+
8. Каждый вердикт, эскалация и применение эффектов попадают в аудит.
|
|
121
|
+
9. **Ad-hoc миссия проходит ту же политику, бюджет и gate, что и registered.**
|
|
122
|
+
10. **Ad-hoc миссия не создаёт записей в планировщике ОС.**
|
package/docs/SAVINGS.md
CHANGED
|
@@ -42,6 +42,35 @@ there is nothing to compare.
|
|
|
42
42
|
So the counter answers "how much would this cost in the cloud at the reference
|
|
43
43
|
price", not "how much money came back to the account".
|
|
44
44
|
|
|
45
|
+
## What-If models and prices
|
|
46
|
+
|
|
47
|
+
The dashboard block "what if every run used model X" does not rely on a fixed
|
|
48
|
+
model list any more. Both the list and the prices come from OpenCode itself:
|
|
49
|
+
|
|
50
|
+
1. **Available models** — `opencode models`, i.e. exactly the models configured
|
|
51
|
+
on this machine (providers, keys, local Ollama models). Models that already
|
|
52
|
+
appear in the run history go first; after them there is one model per
|
|
53
|
+
distinct price level (cheapest, middle, most expensive), at most five
|
|
54
|
+
entries in total.
|
|
55
|
+
2. **Prices** — the models.dev catalogue that OpenCode caches in
|
|
56
|
+
`<cache>/opencode/models.json` (`cost.input` / `cost.output`, USD per 1M
|
|
57
|
+
tokens). History does not split tokens into input and output, so the
|
|
58
|
+
estimate uses the average of the two prices.
|
|
59
|
+
|
|
60
|
+
Price lookup order: `OPENCODE_SCHEDULER_MODEL_PRICES` (JSON) → OpenCode
|
|
61
|
+
catalogue → built-in table → $3 per 1M tokens. Local providers (Ollama,
|
|
62
|
+
LM Studio) and `*-free` models cost zero.
|
|
63
|
+
|
|
64
|
+
| Variable | Meaning |
|
|
65
|
+
| --- | --- |
|
|
66
|
+
| `OPENCODE_SCHEDULER_WHAT_IF_MODELS` | explicit JSON list, replaces the selection |
|
|
67
|
+
| `OPENCODE_SCHEDULER_MODEL_PRICES` | explicit prices, for example `{"openai/gpt-4o": 2.5}` |
|
|
68
|
+
| `OPENCODE_SCHEDULER_MODELS_CACHE` | path to another `models.json` |
|
|
69
|
+
| `OPENCODE_SCHEDULER_MODEL_SOURCE=static` | never call OpenCode, use built-in values only |
|
|
70
|
+
|
|
71
|
+
If OpenCode is not reachable, the block falls back to the built-in list and
|
|
72
|
+
prices, so the dashboard keeps working.
|
|
73
|
+
|
|
45
74
|
## API
|
|
46
75
|
|
|
47
76
|
`get_analytics` returns `report.savings`:
|
package/docs/SAVINGS.ru.md
CHANGED
|
@@ -41,6 +41,35 @@ Translations: [English](SAVINGS.md) · [中文](SAVINGS.zh.md)
|
|
|
41
41
|
Поэтому счётчик отвечает на вопрос «сколько бы это стоило в облаке по
|
|
42
42
|
эталонной цене», а не «сколько денег вернулось на счёт».
|
|
43
43
|
|
|
44
|
+
## What-If: модели и цены
|
|
45
|
+
|
|
46
|
+
Блок дашборда «если бы все запуски шли через модель X» больше не опирается на
|
|
47
|
+
захардкоженный список. И список, и цены берутся из самого OpenCode:
|
|
48
|
+
|
|
49
|
+
1. **Доступные модели** — `opencode models`, то есть ровно то, что настроено
|
|
50
|
+
на этой машине (провайдеры, ключи, локальные модели Ollama). Первыми идут
|
|
51
|
+
модели, которые уже встречались в истории запусков, дальше — по одной
|
|
52
|
+
модели на каждую цену (самая дешёвая, средняя, самая дорогая). Всего не
|
|
53
|
+
больше пяти строк.
|
|
54
|
+
2. **Цены** — каталог models.dev, который OpenCode держит в
|
|
55
|
+
`<cache>/opencode/models.json` (`cost.input` / `cost.output`, USD за 1M
|
|
56
|
+
токенов). История не делит токены на входные и выходные, поэтому берётся
|
|
57
|
+
среднее из двух цен.
|
|
58
|
+
|
|
59
|
+
Порядок выбора цены: `OPENCODE_SCHEDULER_MODEL_PRICES` (JSON) → каталог
|
|
60
|
+
OpenCode → встроенная таблица → 3 $ за 1M токенов. Локальные провайдеры
|
|
61
|
+
(Ollama, LM Studio) и модели `*-free` считаются бесплатными.
|
|
62
|
+
|
|
63
|
+
| Переменная | Значение |
|
|
64
|
+
| --- | --- |
|
|
65
|
+
| `OPENCODE_SCHEDULER_WHAT_IF_MODELS` | явный JSON-список, заменяет подбор |
|
|
66
|
+
| `OPENCODE_SCHEDULER_MODEL_PRICES` | явные цены, например `{"openai/gpt-4o": 2.5}` |
|
|
67
|
+
| `OPENCODE_SCHEDULER_MODELS_CACHE` | путь к другому `models.json` |
|
|
68
|
+
| `OPENCODE_SCHEDULER_MODEL_SOURCE=static` | не обращаться к OpenCode, только встроенные значения |
|
|
69
|
+
|
|
70
|
+
Если OpenCode недоступен, блок откатывается на встроенный список и цены —
|
|
71
|
+
дашборд продолжает работать.
|
|
72
|
+
|
|
44
73
|
## API
|
|
45
74
|
|
|
46
75
|
`get_analytics` возвращает `report.savings`:
|
package/docs/SAVINGS.zh.md
CHANGED
|
@@ -33,6 +33,24 @@ Translations: [English](SAVINGS.md) · [Русский](SAVINGS.ru.md)
|
|
|
33
33
|
|
|
34
34
|
因此该计数器回答的是「按参考价格在云端要花多少钱」,而不是「实际退回了多少钱」。
|
|
35
35
|
|
|
36
|
+
## What-If:模型与价格
|
|
37
|
+
|
|
38
|
+
仪表盘的「如果所有运行都使用模型 X」区块不再依赖硬编码列表。列表和价格都来自 OpenCode 本身:
|
|
39
|
+
|
|
40
|
+
1. **可用模型** —— `opencode models`,即本机实际配置的模型(提供商、密钥、本地 Ollama 模型)。先列出运行历史中出现过的模型,之后每种价格只列一个(最便宜、中间、最贵),总共不超过五行。
|
|
41
|
+
2. **价格** —— OpenCode 缓存在 `<cache>/opencode/models.json` 的 models.dev 目录(`cost.input` / `cost.output`,USD / 1M token)。历史记录不区分输入与输出 token,因此取两者价格的平均值。
|
|
42
|
+
|
|
43
|
+
价格顺序:`OPENCODE_SCHEDULER_MODEL_PRICES`(JSON)→ OpenCode 目录 → 内置表 → 每 1M token 3 美元。本地提供商(Ollama、LM Studio)和 `*-free` 模型按零计算。
|
|
44
|
+
|
|
45
|
+
| 变量 | 含义 |
|
|
46
|
+
| --- | --- |
|
|
47
|
+
| `OPENCODE_SCHEDULER_WHAT_IF_MODELS` | 显式 JSON 列表,替换自动选择 |
|
|
48
|
+
| `OPENCODE_SCHEDULER_MODEL_PRICES` | 显式价格,例如 `{"openai/gpt-4o": 2.5}` |
|
|
49
|
+
| `OPENCODE_SCHEDULER_MODELS_CACHE` | 指向另一个 `models.json` |
|
|
50
|
+
| `OPENCODE_SCHEDULER_MODEL_SOURCE=static` | 不访问 OpenCode,只用内置值 |
|
|
51
|
+
|
|
52
|
+
如果 OpenCode 不可用,该区块会回退到内置列表和价格,仪表盘继续正常工作。
|
|
53
|
+
|
|
36
54
|
## API
|
|
37
55
|
|
|
38
56
|
`get_analytics` 返回 `report.savings`:
|