77c24601a8
## Summary
- OpenCode **2.2.3** becomes both the **technical minimum** and the
**recommended** runtime. The minimum moves because upstream
[#60258](https://github.com/anomalyco/opencode/pull/60258) (shipped in
2.2.2) changed the image tool contract that CodeNomad's Images gallery,
Design agent and Images settings consume: one name,
`experimental_image_generate`, for the tool, its permission action, its
job type and its completion notices' `metadata.source`, and the tool on
by default (only `experimental.image_generate: false` disables it). On
2.2.2+, the gallery lost every generation entry and the Design companion
fixture timed out; 2.2.1 passed.
- Images are implemented for the 2.2.3 contract only, with no fallback
to the old name: `IMAGE_TOOL` drives the gallery and its proof;
`imageGenerationSelection` reads unset as on; the Design agent and
skills name the new tool; the activation fixture exercises the image
tool instead of falling back to webfetch; the gallery fixture represents
the 2.2.3 transcript format.
- Older daemons (2.1.x, 2.2.1, 2.2.2) go through the existing
below-minimum path (`native_contract`). The 2.1.0 client/plugin/schema
pins stay.
- Help (all ten locales), READMEs, `CONTRIBUTING.md`, `dev-docs`
(compatibility, pruning, panel extensions, settings) and the
architecture skill describe the new minimum, its reason and default-on
image generation. The setup minimum-reason UI string is updated in all
locales.
## Contract review (v2.2.1 → v2.2.2 → v2.2.3; 40 + 101 commits)
Reviewed from the exact tags `v2.2.1` (`3ebcf9a32c`), `v2.2.2`
(`098aa7fd6e`) and `v2.2.3` (`082ac6281f`), the published npm packages,
and an authenticated OpenAPI dump from each official CLI running in its
own sandbox. The [changelog](https://opencode.ai/changelog) has entries
for both 2.2.2 (29 October, highlights only) and 2.2.3 (30 October, full
notes); everything below was also checked against the commit log and
source.
**Headline:** the HTTP contract CodeNomad consumes didn't change, but
2.2.2 **renamed the image tool** from `image_generate` to
`experimental_image_generate` and **turned it on by default**
([#60258](https://github.com/anomalyco/opencode/pull/60258)).
CodeNomad's Images/Design features match the old name and the old
default, so they break on 2.2.2 and later (see [Design companion
finding](#design-companion-finding)). Nothing else found affects
CodeNomad.
- **Authenticated OpenAPI:** **134 paths and 162 operations** on all
three, the same operation set. Schemas 355 → 350 → 351.
- **Added/removed operations:** none in either release.
- **Changed operations (2.2.2):** `GET /api/model`, `GET /api/event`,
`PUT /api/pty/{ptyID}`, `POST /api/shell`, `GET /api/shell/{id}/output`,
`POST /api/debug/heap-dump` and `GET /api/experimental/migration/v1`.
All of these are **representation-only**: the Effect 4.0.6 JSON Schema
output flattens nested `anyOf`, bounds integers with `maximum:
9007199254740991` (and `minimum` for signed integers), and rewrites the
numeric-string query pattern. The event-type and model-type enums are
unchanged.
- **Changed operations (2.2.3):** only the description of `POST
/api/credential`, which can now be refused by an `integration.connect`
policy.
- **Consumed schemas:** the same family selector as the 2.2.1 review
(`V2EventEncoded`, `Session.*`, `SessionStats.*`, `Form.*`,
`Permission.*`, `Prompt*`, `Event.*`, `Location.*`, PTY/Shell).
Re-derived from that description it selects 104 schemas at 2.2.1 (the
2.2.1 file says 103), all byte-identical from 2.1.4 to 2.2.1.
- In 2.2.2 the seven alias copies `Form.Fields_1..3` and
`Session.Message.Native_1..4` collapse into their base schemas, which
are byte-identical to the copies, leaving **97**. Of these, 71 are
byte-identical and 24 differ only in generator representation.
- Two changes are additive and optional: `Session.Info.time.busy`, the
start of the latest execution
([#59910](https://github.com/anomalyco/opencode/pull/59910)), and the
input field `PromptInput.FileAttachment.source` (`Prompt.FileSource`,
inline or uri; CodeNomad doesn't send it).
- `V2EventEncoded`, `Session.Message.*` content, `Session.Inbox.*`,
`Form.*` semantics, `Permission.*` and `Event.SeqEncoded` are unchanged.
- From 2.2.2 to 2.2.3 the family is byte-identical.
- **`Config.InfoEncoded`:** no semantic change in 2.2.2 (representation
only). 2.2.3 extends the managed-policy `action` enum (top-level and
`experimental.policies`) with `integration.connect`, `mcp.use`,
`skill.use` and `plugin.use`
([#60315](https://github.com/anomalyco/opencode/pull/60315)); CodeNomad
writes no policies. The *meaning* of `experimental.image_generate`
changed: unset now means on, and only `false` turns it off. The schema
shape stayed the same and the OpenAPI carries no description, so no
contract signal reveals it.
- **Schedules (not consumed on dev):** `when` becomes optional;
`if`/`until` conditions (shell in 2.2.2, Code Mode in 2.2.3) are added;
outcomes gain `checked`/`expired`.
- **Admission:** every predicate in `compatibility/negotiate.ts`
(unchanged since the 2.2.1 review) holds on 2.2.1, 2.2.2 and 2.2.3.
- **Instance proxy:** no new routes and an unchanged allowlist. Proxied
routes whose representation changed: `GET /api/model`, `PUT
/api/pty/{id}`, `POST /api/shell` and `GET /api/shell/{id}/output`.
Integer bounds and an equivalent numeric pattern accept everything
CodeNomad sends.
- **Published declarations** (2.2.1 → 2.2.3):
- **Client:** 185 methods on all three; the method tree is identical.
2.2.2 adds the generated types `ScheduleCondition*`; `FormFields2` is
renamed to `FormFields1`, which is generated-type churn. 2.2.3 adds the
Promise media helpers `withMediaRefs`, `mediaHashFromUri` and
`MediaRequestOptions`
([#60116](https://github.com/anomalyco/opencode/pull/60116)) and
persistent-PTY frame helpers in `solid/pty`. CodeNomad imports none of
these.
- **Schema:** 2.2.2 adds schedule conditions (`ShellCondition`,
`CheckMode`, …) and exports `SessionLegacy.part`. 2.2.3 adds
`CodeCondition*` and `policy.Action`.
- **Plugin:** 2.2.2 adds the GUI
`ComposerQuoteAnchor`/`ComposerFocusOptions`. 2.2.3 has no export
changes, but the optional peers `@opentui/*` become `>=0.8.0`
([#60385](https://github.com/anomalyco/opencode/pull/60385)). The
published `dependencies.effect` moves from **4.0.1 to 4.0.6** (2.2.2).
- **Typecheck:** the server and UI typecheck with **0 errors** against
the 2.2.2 and 2.2.3 client/schema/plugin/effect declarations through
scratch `paths` overrides. The pinned 2.1.0 control is also clean. The
harness now also remaps `effect` itself; the 2.2.1 harness skipped it
because effect's `exports` are plain `.js` strings.
- **Host modules:** the three daemon-loaded bundles still import
`@opencode/plugin` (`Plugin`), `/effect` (`Plugin`, `Rpc`, `Location`),
`/promise/adapter` (`fromPromise`), `/rpc` (`Rpc`), `effect` and
`effect/encoding` (`Base64Url`) from the host. A probe plugin in an
isolated **2.2.3** daemon resolves every module and binding, as on
2.2.1. `runtime-modules.ts` is unchanged between the tags.
- **Host Effect: 4.0.1 → 4.0.6** (2.2.2,
[#59630](https://github.com/anomalyco/opencode/pull/59630)). The 2.1.0
`@opencode/schema`/`@opencode/client` code bundled into the Missions and
pruning plugins now runs on host Effect 4.0.6. The plugin-runtime,
pruning, Missions-contract, permission-receipts and image-settings
native suites pass on 2.2.3.
- **Private native services:** the keys (`LocationServiceMap`, `Form`,
`Permission`, `Location`, `Job`, `Database`, `Session`, `Bus`) and the
members CodeNomad calls are unchanged. The changes are additive:
`Permission.Unattended` (a reference that denies unanswerable asks for
schedule checks), a `CorrectedError.message` getter, and `Session`
deciding fork media from the parent's location.
- **Storage** (three migrations): `session_part` (new table),
`session_v2.time_busy` and four `schedule` check columns.
- **`session_part`**
([#58915](https://github.com/anomalyco/opencode/pull/58915)): history
reads now *prefer* `session_part` rows over
`session_message.data.content` for assistant messages. The projector
writes parts there only for messages that already have part rows, so new
messages stay inline. Every 2.2.3 fixture DB inspected has **0**
`session_part` rows, and upstream `dev` (`1e28374e48`, 30 October) has
no writer either.
- The tables CodeNomad reads directly keep their shape.
- **Forward risk:** when a release starts writing parts, CodeNomad's
direct `session_message.data.content` readers and the pruning `UPDATE …
json_set(data,'$.content',…)` (`session-pruning/transaction.ts`) would
silently miss or be shadowed by part rows. See Recommendations.
- **Behavior changes checked:**
- **Image generation** (2.2.2): renamed and on by default. See the
[dedicated section](#design-companion-finding).
- **Code Mode:** inner tool progress no longer replaces the `execute`
call rows ([#60480](https://github.com/anomalyco/opencode/pull/60480)),
and progress is throttled to at most one update per 100 ms
([#60120](https://github.com/anomalyco/opencode/pull/60120)). Programs
see the same failure text as direct calls
([#60109](https://github.com/anomalyco/opencode/pull/60109)), `fetch` in
Code Mode is now subject to `webfetch` permissions
([#59954](https://github.com/anomalyco/opencode/pull/59954)), `for…in`
visits inherited keys
([#59933](https://github.com/anomalyco/opencode/pull/59933)) and `null`
survives text encoding
([#57639](https://github.com/anomalyco/opencode/pull/57639)). The
run-to-completion regression behind the 2.1.2 minimum passes on 2.2.3:
`{ total: 2000, beforeAwait: 1000, count: 1000 }`.
- **Permissions and MCP:** permission reasons and feedback are kept in
MCP tool failures
([#60102](https://github.com/anomalyco/opencode/pull/60102)). Shell
permission checks moved fully off tree-sitter and now check redirects,
PowerShell method calls and dynamic directory changes
([#60332](https://github.com/anomalyco/opencode/pull/60332),
[#60376](https://github.com/anomalyco/opencode/pull/60376)), so some
shell commands may now ask where they didn't. The managed-policy split
(`integration.use` vs `mcp.use`/`skill.use`/`plugin.use`) is a changelog
"breaking change" for managed deployments only.
- **Sessions:** deleting a session removes its persistent terminals
([#60322](https://github.com/anomalyco/opencode/pull/60322)), and a
persistent terminal with a missing cwd is rejected
([#60300](https://github.com/anomalyco/opencode/pull/60300)). Forked and
imported sessions store media as blobs when `media_blob` is on
([#60118](https://github.com/anomalyco/opencode/pull/60118)). The native
fork suite passes on 2.2.3.
- **Providers:** a built-in **Claude Agent** provider uses the user's
Claude Code login
([#58782](https://github.com/anomalyco/opencode/pull/58782)).
Plugin-supplied model variants are preserved
([#60097](https://github.com/anomalyco/opencode/pull/60097)), and the
dynamic provider npm fallback runs after external SDK hooks
([#60380](https://github.com/anomalyco/opencode/pull/60380)). These are
source-reviewed and touch no consumed contract.
- **Persistent PTY binary** (the process daemon): 2.2.2 switches from
`@opencode-ai/pty` 0.3.1 to `@opencode/pty` **0.3.3**
([#60276](https://github.com/anomalyco/opencode/pull/60276)).
`process-daemon-v0.3.3` contains only the release commit after 0.3.2 (a
version bump of the `@opencode/pty-*` binaries). **v0.4.0** (terminal
renaming, [#60324](https://github.com/anomalyco/opencode/pull/60324)) is
**not** shipped in CLI 2.2.3, which pins 0.3.3. CodeNomad only lists
persistent PTYs (worktree deletion guard), whose schema is unchanged
apart from representation.
- **Client fix not inherited:** the 2.2.3 client evicts missing sessions
on 404 ([#60459](https://github.com/anomalyco/opencode/pull/60459)).
CodeNomad stays on the 2.1.0 client.
- **`@opencode/ai` breaking changes** (media moved to `/experimental`,
one `tool()`): CodeNomad doesn't import `@opencode/ai`.
- Desktop/TUI-only changes (timeline performance, side-panel tabs,
spellcheck, question sounds, OpenTUI 0.8) don't affect CodeNomad.
**Verdict:**
- The **2.1.0 client/plugin pins stay**. Bumping them would bring
nothing CodeNomad consumes.
- No consumed HTTP/plugin contract broke; the breaking change is the
image tool contract of #60258, consumed by the Images gallery, the
Design agent and the Images settings.
- **Decision applied in this PR:** 2.2.3 becomes both the minimum and
the recommendation, and Images are implemented for the 2.2.3 contract
only (see Summary). This replaces the review's initial suggestion to
keep the 2.1.2 minimum and accept both tool names.
**Not verified here:**
- the full native suite matrix on 2.2.2/2.2.3; only the runs in Appendix
I were performed;
- the forward-compatibility of the `session_part` readers against a
runtime that writes parts (no such runtime exists yet);
- the Claude Agent provider and shell-permission changes at runtime
(source only);
- macOS/Linux.
---
## Design companion finding
**Symptom:** `scripts/test-design-companion-native.mjs <cli>` passes on
2.2.1 and fails on 2.2.2 and 2.2.3 with `Error: Timed out: series 1
generated and read`. Reproduced independently in a scratch checkout of
`origin/dev` (`f39642bc4`), with `CODENOMAD_NATIVE_FIXTURE_PARENT`
outside the home:
```
test-design-companion-native 2.2.1 exit=0 PASS AC-16, AC-52
test-design-companion-native 2.2.2 exit=1 Timed out: series 1 generated and read
test-design-companion-native 2.2.3 exit=1 Timed out: series 1 generated and read
```
**What the step waits for**
(`test-design-companion-native.mjs:238-241`): the fixture's loopback
chat provider answers a `RUN [...]` turn with two tool calls `{ tool:
"image_generate", args: { prompt, path: ".codenomad/design/icon/<name>"
} }`. The step then waits until the transcript holds two synthetic
notices with `metadata.source === "image_generate"` (line 209) and two
`read` parts of the generated files. No HTTP generate route, file watch
or media blob is involved; it is the agent tool path.
**Cause: an intentional upstream contract change, not an upstream bug.**
In 2.2.2, [#60258](https://github.com/anomalyco/opencode/pull/60258)
(`d4e48f54da`, "turn experimental_image_generate on by default") changed
`packages/core/src/tool/plugin/image-generate.ts`:
- `export const name = "image_generate"` →
`"experimental_image_generate"`. That one constant is the tool name, the
permission action (`assertions: ["experimental_image_generate", "edit",
"read"]`), the Job `type`, and the completion notice's
`metadata.source`. `session/execution/restart.ts` also tags
restart-recovery notices `source: "experimental_image_generate"`.
- The opt-in became default-on: `if (!enabled || imageGenerate(entries)
=== false) return`. An unset `experimental.image_generate` now offers
the tool; only `false` removes it ("still honored for configs from when
the tool was opt-in; permissions are the supported way to turn it off").
- The 2.2.2 changelog states it: "agents can now use
`experimental_image_generate` without additional configuration".
2.2.2 also wraps the notice text as `<image id="…"
state="…">\n…\n</image>` and adds `id` to the tool output
([#60098](https://github.com/anomalyco/opencode/pull/60098)).
CodeNomad's `Saved image: (.+) \(` parse still matches; `jobID`, `state`
and `path` metadata are unchanged.
**Evidence** (fixture DBs copied read-only to `evidence/`):
```
2.2.3, original fixture (calls "image_generate"):
seq 5 tool image_generate error "No tool named \"image_generate\" is currently available. Please use a tool from the available tool list." (x2)
-> no image job, no notice, no read: the wait times out.
2.2.3, fixture with the tool name changed (scratch copy; CodeNomad server code unmodified):
seq 5 tool experimental_image_generate completed {path:…/icon-minimal-a, model:"fiximg/image", jobID:"image_18cfb59…"}
seq 18 synthetic {"source":"experimental_image_generate","jobID":"image_18cfb59…","state":"completed",…}
<image id="image_18cfb59…" state="completed"> | Image request finished. Saved image: …
seq 20 tool read completed (x2) … seq 40/48/49 refinement
-> files, image calls and reads all correct, then
AssertionError: generations.length 0 !== 3 (test line 260: gallery "generation" entries)
```
So the product bug is real and independent of the fixture: on 2.2.2+
CodeNomad's Images gallery finds **no generation entries**. Images still
appear through their `read` parts, but without prompt, model, lineage or
"proven" origin, and `galleryImageReference` refuses them as `changed`.
**CodeNomad code that assumes the 2.2.1 name or default** (origin/dev):
| Where | Assumption | Effect on 2.2.2+ |
| --- | --- | --- |
| `session-pruning/assets-gallery.ts:56,139` | `part.name ===
"image_generate"` | no generation entries; references refused `changed`
|
| `session-pruning/assets-gallery-proof.ts:104,130` | tool name and
notice `source === "image_generate"` | no calls or notices, so no
provenance proof |
| `opencode/image-settings.ts` `imageGenerationSelection(undefined) →
false` (doc: "Reads … as OpenCode does") | unset means off | Settings →
Images shows **Off** and `images.status()` returns `"disabled"` while
the tool is offered; help step "Turn on image generation"
(`docs/help/en/extensions.md:73`) is no longer needed |
| `opencode/design/opencode/agents/design.md`, `skills/design-core`,
`design-logo`, `design-ui-mockup` | the agent is told to call
`image_generate` | the model sees only `experimental_image_generate`;
the first call can fail with "No tool named …" |
| `scripts/test-design-companion-native.mjs:125,209,238,301` | fixture
calls/filters `image_generate` | red on 2.2.2+ |
| `scripts/test-design-activation-native.mjs:76,307` | ask rule on
action `image_generate`; tool detection by that name | **passes but
loses coverage**: `askTool` falls back to `webfetch` on 2.2.2/2.2.3
(logged) |
| `dev-docs/SESSION_PRUNING_RPC.md`, `PANEL_EXTENSIONS.md`,
`SETTINGS.md` | describe `image_generate` parts and opt-in | out of date
for 2.2.2+ |
User permission rules written for action `image_generate` no longer
match on 2.2.2+; that is an OpenCode-side change for users. CodeNomad's
help never names the permission action; the Design fixtures and agent
use `experimental_image_generate`.
**Fix in this PR** (2.2.3 contract only, no fallback):
1. One `IMAGE_TOOL = "experimental_image_generate"` constant drives the
gallery and its proof; the gallery reads the 2.2.3 notice format.
2. The native fixtures use the new tool; the activation fixture
exercises it (default on) instead of falling back to webfetch.
3. The Design agent and skills name `experimental_image_generate`.
4. `imageGenerationSelection` reads an unset
`experimental.image_generate` as on; only `false` disables it. Settings
→ Images and `images.status()` report it that way.
## Follow-up
- Hardening for `session_part` (independent of this upgrade, no 2.2.3
regression): make the direct readers and the pruning transaction fail
safe when `session_part` has rows for the target messages.
## Isolated Windows qualification
Base: dev `f39642bc4`; Node 25.2.1 (local; CI runs the pinned 24.20.0);
exact official CLI **2.2.3**; locked client/plugin **2.1.0**;
`CODENOMAD_NATIVE_FIXTURE_PARENT` outside the user profile for the
Design fixtures.
- **Before the image fix (recommendation-only change):** every native
suite passed on 2.2.3 except the Design companion end to end, which
passes on 2.2.1 and times out on 2.2.2/2.2.3 at "series 1 generated and
read" (`No tool named "image_generate" is currently available`).
- **After this change, on 2.2.3:** Design companion (3 files, 2 series,
all proven, lineage), Design activation (image tool offered to Design
and Build, default on), Design content, image settings (default on,
Off→On hot reload), session pruning including session images/media, Code
Mode jobs `{ total: 2000, beforeAwait: 1000, count: 1000 }`.
- **Full native set on 2.2.3 (before the image fix, unaffected areas):**
plugin runtime, automation, Location/worktrees/event relay, permission
receipts, Git init/degraded, Missions (contract, family control, native,
trajectory) and all 11 recurring journeys, sessions (environment, fork,
aside, interrupt, lifecycle, blank cleanup, compaction, prompt skills,
providers, service usage, web search, plugin packages, output limit,
Promise-tool failure, subagent depth, temporary workspaces), migrations
from 2.1.2/2.2.1/2.2.2, install/upgrade/legacy replacement.
- **Units and checks after the change:** root and server typecheck
clean; server **2,825 passed, 9 skipped, 1 cancelled** (`index.test.ts`
shutdown test timed out under full-suite load; **4/4** alone); gallery
107/107; Design 23/23; opencode-update 62 passed / 1 skipped; touched UI
units 8/8; browser `opencode-setup` + `websearch-settings` 38/38; native
plugin build 2/2; ten-locale help 31/31.
18 KiB
הרחבות לוח
עיון בהרחבות מותקנות ומקוונות
- פתחו התאמת הלוח הימני בסרגל הלשוניות של הלוח הימני.
- הרחיבו הרחבות מתחת לקו ההפרדה.
- השתמשו ב־חיפוש הרחבות לחיפוש ברשימה המאוחדת של תוספים מותקנים והקטלוג המקוון הרשמי. רחפו מעל רשומה או מקדו אותה להצגת המטא־נתונים שלה.
הסעיף מתחיל מכווץ בכל פתיחה של חלונית ההתאמה. רשומות מותקנות ומקוונות מאוחדות לפי מזהה ההרחבה; אין חלון ניהול נפרד או מצב מותקן/מקוון. עיון במטא־נתוני הקטלוג אינו מוריד או מריץ את קוד הלוח של המחבר. הקטלוג מתוחזק ב־CodeNomad Extensions; הכללה בו ושמות מחברים מוצהרים אינם חתימות או הוכחת אמינות.
אם הקטלוג אינו זמין, ההרחבות המותקנות ו־התקנה מקובץ ZIP… נשארות זמינות. רעננו כדי לנסות שוב לגלות רשומות. כיווץ החלונית או סגירתה זונחים את ממשק הבדיקה/האישור הממתין; הם אינם מתקינים דבר בשקט.
בדיקה והתקנה ללא הפעלה
- בחרו התקנה… ברשומת קטלוג, או התקנה מקובץ ZIP… עבור חבילה שהשגתם בנפרד.
- בדקו את מזהה החבילה, המחבר, המאגר, הגרסה, ה־API/ההרשאות ותקציר SHA-256. הרחיבו פרטים טכניים לפי הצורך.
- אמתו את המפרסם, וכשאפשר השוו את התקציר בערוץ מהימן.
- רק אם אתם נותנים אמון בקוד, סמנו אני סומך על החבילה ועל המחבר שלה, ואז התקנה ללא הפעלה.
הבדיקה מורידה/מאמתת מחדש את החבילה שנבחרה; קוד המחבר אינו מורץ בבדיקה. תקציר מזהה בתים מדויקים, לא את זהות המחבר. חבילות הקטלוג מגיעות מנכס ההפצה המדויק שהוצהר ב־GitHub, לא מכתובת שרירותית. חבילות ידניות הן קובצי ZIP המכילים רק manifest.json ו־panel.html עצמאי; חבילות לא תקינות או לא נתמכות נדחות.
ההתקנה אינה דורשת הפעלה מחדש של OpenCode ולעולם אינה מעניקה הפעלה אוטומטית. כשל באימות, התנגשות או כשל אחסון אינם מתירים ניסיון חוזר עם בתים אחרים. בדקו מחדש את החבילה לפני ניסיון התקנה חדש.
הפעלה והבנת ההיקף
- חזרו לשורת התוסף מעל הסעיף הרחבות ב־התאמת הלוח הימני. תוספים מותקנים ומושבתים נשארים ברשימה.
- סמנו את תיבת הסימון שלו כדי להפעילו. נקו את אותה תיבה כדי להשביתו.
תיבת סימון זו היא פקד ההפעלה היחיד: אין מתג ניהול נוסף או תנאי נראות לכל חלון. ההפעלה חלה על כל הפרויקטים בתצורה, לא על תיקייה בודדת. בחיבור מרוחק היא משפיעה על מאגר ההרחבות המותקנות של השרת, לא רק על המכשיר שבו אתם צופים.
מאגר ההרחבות הוא panel-extensions/ לצד תצורת CodeNomad שנבחרה. פרופילי נתונים נפרדים לשולחן העבודה אינם מבודדים הרחבות כאשר הפרופילים משתמשים באותה תיקיית תצורה. מנגד, פתיחת תצורה אחרת אינה מעניקה רשות להריץ תוסף שהותקן במקום אחר. ראו חלונות ונתונים בשולחן העבודה להבחנה.
לוח שהופעל יכול להיטען כשנבחר; הסתרתו יכולה לסלק את מצב הממשק הזמני שלו. השבתה מבטלת את אישור הפעלתו. איפוס בהתאמה רק משחזר פריסה מובנית ואינו מפעיל, משבית או מסיר הרחבות.
החלפה או הסרה
- השתמשו ב־שינוי גרסה… או בדקו ZIP אחר בעל אותו מזהה כדי להחליף חבילה מותקנת.
- בדקו את התקציר וההרשאות החדשים, אשרו אמון והתקינו ללא הפעלה.
- הפעילו מחדש בתיבת הסימון הרגילה רק לאחר שהחלטתם לתת אמון בתחליף.
- להסרה, השתמשו ב־הסרה… וב־אישור הסרה לאחר בדיקת היעד.
כל החלפה מבטלת הפעלה בכל הפרויקטים, גם אם רשימת ההרשאות לא השתנתה, ומוחקת את ההגדרות השמורות של הלוח עצמו. כשל אימות/התנגשות/אחסון משמר את החבילה המותקנת. אין עדכוני הרחבות שקטים. הסרה מוחקת את החבילה, את הגדרות ההפעלה שלה ואת הגדרות הלוח השמורות שלה, לא סשנים של OpenCode או קובצי פרויקט. להתאוששות מקוד לא רצוי, השביתו אותו תחילה; התקינו מחדש רק חבילה מאומתת ומהימנה.
הקשר, הסכמה לנכסים ומגבלות ארגז החול
| חוזה | מה ההפעלה מתירה |
|---|---|
API 1 / session.context |
מזהה הסשן הנוכחי (או ללא מזהה), שפת הממשק והמראה. ללא טקסט תמליל או גישה למערכת הקבצים. |
API 2 / session.assets.read נוסף על ההקשר |
הרשאה שנבדקה במפורש לרשימה מוגבלת של מטא־נתוני תמונות/קבצים מצורפים מתוצאות כלים בסשן הנוכחי ולקריאת בתים מוטמעים נתמכים. זו אינה גישה כללית לתמליל, לקבצים או לכתובות URL. |
API 3 / repository.workItems.read בתוספת הקשר |
הרשאה שנבדקה במפורש להצגת עמודים מוגבלים של issues ו-pull requests של מאגר הפרויקט ב-GitHub, GitLab או Gitea/Forgejo, ולפתיחת אחד מהם בדפדפן. אין בה גישה לקבצים, לפרטי התחברות או לרשת באופן כללי. |
| API 4 / הקשר בתוספת הרשאה אחת או יותר מההרשאות שלהלן | הבדיקה מציגה משפט אחד לכל הרשאה מוצהרת; ההפעלה מעניקה את כולן יחד, והחלפה מבטלת את כולן. |
session.images.read |
קריאת התמונות שהוחזרו על ידי הכלי read בשיחה המוצגת, עם מצב היצירה והשושלת כאשר ניתן לאמת אותם. |
session.images.prompts (דורשת session.images.read) |
קריאת ההנחיה והמודל של כל תמונה שנוצרה בשיחת התמונות של הפרויקט. |
composer.prefill |
הוספת טקסט לשדה הקלט של השיחה המוצגת. אף פעם אינה שולחת הודעה. |
images.conversation |
פתיחה או התחלה של שיחת התמונות של פרויקט זה. |
opencode.designAgent |
מוסיפה ל-OpenCode את סוכן Design של CodeNomad ואת מיומנויות התמונה שלו כל עוד הרחבה זו מופעלת. |
panel.preferences |
זכירת ההגדרות הייחודיות של לוח זה. |
גישה לנכסים עוקבת אחר המארח/הסשן המוצג כעת, לא אחר סשן שהמחבר בחר. הפניות מקומיות/מרוחקות עשויות להופיע כלא זמינות; API הנכסים אינו מאחזר כתובות מרוחקות שרירותיות או פותח קבצים מקומיים. החלפת סשן, ניתוק או ביטול הסכמה מבטלים גישה ישנה.
ב-API 4, קריאת תמונות עוקבת באותו אופן אחר השיחה המוצגת, ומציגה רק את התמונות שהסוכן קרא בחזרה לתוכה. הרחבה עם session.images.prompts יכולה לקרוא את ההנחיות שאתם או הסוכן כתבתם לתמונות בשיחת תמונות, ועלולה להעביר אותן הלאה למרות ארגז החול, לכן העניקו אותה רק למחברים שאתם סומכים עליהם בנוגע להן. טקסט שנוסף על ידי composer.prefill נשאר בשדה הקלט עד שתערכו אותו או תבחרו שלח הודעה; הוא אף פעם אינו מתחיל בפקודה, אף פעם אינו מסתיים באזכור @ פתוח, ומציין נתיבי תמונות כטקסט רגיל. ביטול עם Ctrl+Z (Cmd+Z ב-macOS) בשדה הקלט אינו מסיר אותו. הגדרות לוח שמורות שייכות לפרופיל CodeNomad זה, לכל היותר 4 KiB לכל הרחבה; השבתת הרחבה שומרת אותן.
הפריטים מגיעים מה-remote upstream של תיקיית הפרויקט, ואם אין כזה מ-origin. CodeNomad קורא אותם באמצעות ה-CLI של GitHub, GitLab או Gitea שאליו כבר התחברתם (gh, glab, tea), או באופן אנונימי למאגרים ציבוריים, ואינו שומר טוקן; ההרחבה רואה רק את שם המאגר ואת הפריטים. קריאה אנונימית זמינה ל-github.com, gitlab.com, codeberg.org ו-gitea.com; פלטפורמה באירוח עצמי נקראת רק דרך ה-CLI המחובר אליה. פתיחת פריט מבקשת מ-CodeNomad לפתוח את דף הפריט באותה פלטפורמה בדפדפן, לכל היותר פעם בשנייה; ההרחבה אינה יכולה לפתוח כתובות אחרות.
קוד המחבר רץ ב־iframe מוגבל, לא בתהליך התצוגה המהימן של היישום. הוא אינו מקבל גשר מקורי/ל־OpenCode, גישה לפרטי התחברות, RPC כללי, טפסים, חלונות קופצים או הורדות; ממשקי רשת ומשאבים חיצוניים מוגבלים. הרחבות הן תוספי ממשק, לא תוספי OpenCode.
ארגז החול אינו בידוד תהליך/מעבד או הבטחה שקוד שאושר אינו מזיק. הרחבה עוינת יכולה לשבש את תהליך התצוגה שלה. התקינו רק ממחברים מהימנים, אל תמסרו סודות והשביתו/הסירו תוסף שמתנהג באופן בלתי צפוי.
יצירת תמונות עם הרחבת Design
ההרחבה Design היא שולחן אור לתמונות שאתם יוצרים עם סוכן Design של CodeNomad בשיחת התמונות של פרויקט. היא מציגה את התמונות, מכינה בקשות בתיבת ההודעה ומשאירה כל יצירה להודעות שאתם שולחים.
- חברו ספק שמציע מודל תמונות. יצירת התמונות פעילה, אלא אם כובתה ב-הגדרות → ספקים → תמונות (יצירת תמונות ושמירתן).
- ב־התאמת הלוח הימני → הרחבות, התקינו את Design מהקטלוג (בדיקה והתקנה ללא הפעלה) לאחר שבדקתם את ההרשאות שלה (הקשר, הסכמה לנכסים ומגבלות ארגז החול), ואז סמנו את תיבת הסימון שלה (הפעלה והבנת ההיקף).
- פתחו את הלוח Design ובחרו פתיחת שיחת התמונות.
כל עוד ההרחבה מופעלת, CodeNomad מוסיפה ל-OpenCode את סוכן Design שלה ואת מיומנויות התמונה שלו. סוכן design משלכם ומיומנויות design-* משלכם תמיד קודמים; כשאתם מספקים סוכן design משלכם, הלוח מציג נעשה שימוש בסוכן Design משלכם. הלוח מציין גם מתי חסרים יצירת תמונות, מודל תמונות או סוכן Design.
שיחת התמונות
לכל תיקיית פרויקט או worktree יש שיחת תמונות משלה, שכותרתה תמונות. פתיחת שיחת התמונות מוצאת אותה, או יוצרת אותה עם סוכן Design ועם המודל ש-CodeNomad בוחרת לשיחה חדשה עם הסוכן הזה, ואז מציגה אותה כשהמיקוד בתיבת ההודעה; הפתיחה אינה שולחת דבר. שיחת תמונות קיימת שומרת על המודל שלה. שיחת תמונות חדשה מתחילה שיחה נוספת עם שולחן אור ריק, והלוח מציע אותה כשבשיחה יש תמונות רבות; לאחר מכן פתיחה מציגה את החדשה ביותר. שיחות תמונות שהועברו לארכיון או נמחקו מדולגות.
תארו את מה שאתם צריכים ושלחו: הסוכן שואל כמה שאלות מיקוד, מודיע כמה תמונות ייצור, יוצר אותן, קורא כל אחת בחזרה ומבקר אותה. התמונות נשמרות ב־.codenomad/design/ שבתיקיית הפרויקט. CodeNomad מוסיפה את התיקייה הזו להחרגות Git המקומיות של המאגר (.git/info/exclude) ואינה נוגעת ב־.gitignore; כשאינה יכולה, הלוח מציג תמונות במיקום זה עשויות להופיע ב-Git. ביטול סבב מסיר את התמונות שלו משולחן האור אך שומר את הקבצים שלהן, ותמונה שהסוכן דרס אי אפשר לשחזר. הסוכן מבקש תמונות של כ-1K פיקסלים, אך ספקים עשויים להחזיר תמונות גדולות יותר, וכמה תמונות גדולות בבת אחת עלולות לצרוך זיכרון רב בשירות OpenCode המשותף.
אם סוכן Design חסר בשיחת תמונות שמשתמשת בו, תיבת ההודעה מציגה הסוכן Design אינו זמין וחוסמת את השליחה: בחרו השתמש בסוכן ברירת המחדל, או הפעילו שוב את הרחבת Design. אם מודל הצ'אט של השיחה אינו מקבל תמונות, הלוח מזהיר שהסוכן אינו יכול לבקר אותן חזותית; התמונות שהוא קורא בחזרה עדיין מופיעות על שולחן האור.
שולחן אור
שולחן אור מציג את התמונות שהסוכן קרא בחזרה בשיחה המוצגת, מהחדשה לישנה, בקבוצות לפי תשובה. בחירת תמונה מציגה אותה בגדול עם תצוגות מקדימות של גדלים קטנים ב-16, 32 ו-64 פיקסלים; השוואה מציבה שתי תמונות זו לצד זו, ו־הצגה בגודל מלא פותחת מציג. בלוח צר, הרחיבו אותו כדי להשוות. השושלת (נוצרה מתוך, שימשה עבור) ובשיחת התמונות גם ההנחיה והמודל מופיעים רק כש-CodeNomad יכולה לאמת איזו יצירה הפיקה את התמונה; אחרת התמונה שומרת על הפיקסלים שלה ומסומנת מקור שאינו ניתן לאימות. יצירות מפרט כל יצירת תמונה עם מצבה; עקבו אחר התקדמותה בשיחה. בשיחה אחרת, הלוח מציג את התמונות שנקראו בחזרה באותה שיחה, בלי הנחיות ובלי בקשות, ומציע לפתוח את שיחת התמונות.
בשיחת התמונות, התחלה מתבנית (מתכון כמו סמל אפליקציה או לוגו), שיפור, וריאציות, החלת כיוון, שמירה בפרויקט…, לבקש מהסוכן להציג אותה ו־ניסיון חוזר רק מוסיפים טקסט שניתן לערוך לתיבת ההודעה: הלוח לעולם אינו שולח הודעה ואינו יוצר תמונה. פעולות על תמונה שבחרתם מצטטות את הנתיב שלה יחסית לפרויקט, ואפשר לצטט רק תמונות של הפרויקט שמקורן ניתן לאימות. ערכו את הבקשה ושלחו אותה בעצמכם. שמירה בפרויקט… מבקשת מהסוכן להעתיק את התמונה ליעד שאתם מקלידים אחרי הבקשה. תמונות לכל סבב (1 עד 4, ברירת מחדל 3) נכלל בבקשות שיוצרות תמונות חדשות ונשמר בהגדרות השמורות של הלוח. בטלפון, הלוח צף ונסגר כשהוא מוסיף בקשה.
שימוש בסוכן Design בלי CodeNomad
סוכן Design והמיומנויות שלו הם קובצי OpenCode רגילים. כדי להשתמש בהם ב-TUI של OpenCode או בלקוח אחר בלי CodeNomad, העתיקו את תוכן תיקיית התוכן של Design לתיקייה .opencode/ של פרויקט או לתיקיית התצורה הגלובלית של OpenCode (~/.config/opencode/), יחד עם NOTICE.md והרישיון. לאחר מכן בחרו בסוכן design; הוא טוען את המיומנויות שלו לפי שמן, וסוכנים אחרים משתמשים בהן רק כשאתם נוקבים בשמן.
סוכן Design והמיומנויות שלו מעבדים חומר מ-Open Design (Apache-2.0) ומ-taste-skill (MIT); NOTICE.md מפרט כל קובץ שעובד. הרחבת Design עושה שימוש חוזר בקוד מהרחבת MCP Assets (MIT).