Add WorkBuddy desktop setup recipe and 2026-09-12 thinking deviations

AGENTS.md

@@ -12,6 +12,7 @@ These instructions apply to maintaining this repository, not consuming apps.
 - `references/api_reference.md`: official endpoint links, not copied field tables.
 - `references/models.md`: selection defaults and current account-source pointers.
 - `references/examples.md`: ECNU-specific integration recipes.
+- `references/workbuddy_setup.md`: WorkBuddy desktop custom-model configuration recipe.
 - `references/workflows.md`: symptom-driven, opt-in diagnostics.
 - `references/known_deviations.md`: dated live evidence; preserve dates and scope.
 - `references/agent_development.md`: historical guidance cited by old observations.

README.md

@@ -38,6 +38,7 @@ credentials should not prevent the Agent from writing or reviewing code.
 | Start a normal integration | [SKILL.md](SKILL.md) |
 | Find the relevant official endpoint contract | [Endpoint map](references/api_reference.md) |
 | LangChain embeddings, thinking/tool history, Anthropic SDK | [Integration recipes](references/examples.md) |
+| WorkBuddy desktop custom-model setup | [WorkBuddy recipe](references/workbuddy_setup.md) |
 | Model choice or current account facts | [Model/account pointers](references/models.md) |
 | Diagnose a failure or select a live probe | [Targeted diagnosis](references/workflows.md) |
 | Inspect dated evidence | [Known deviations](references/known_deviations.md) |

SKILL.md

@@ -57,6 +57,7 @@ Its full messages URL ends in `/open/api/anthropic/v1/messages`.
 | LangChain embeddings | [Embedding recipe](references/examples.md#langchain-embeddings) |
 | Anthropic SDK setup | [Anthropic recipe](references/examples.md#anthropic-sdk) |
 | Thinking and tool continuation | [Tool-history recipe](references/examples.md#thinking-and-tool-history) plus the linked ECNU contract |
+| WorkBuddy desktop custom-model setup | [WorkBuddy recipe](references/workbuddy_setup.md) |
 | Model choice, prices, quotas, or deployment questions | [Model and account pointers](references/models.md) |
 | An error, unexpected result, or requested live check | [Targeted diagnosis](references/workflows.md); consult only the matching dated deviation |
 

references/examples.md

@@ -57,6 +57,21 @@ thinking through `thinking.type`; direct `reasoning_effort` uses `low`, `high`,
 or `max` on `ecnu-max` and is ignored by `ecnu-plus`. Pass ECNU extensions through
 `extra_body` with the OpenAI SDK. Do not substitute upstream template switches.
 
+Two observed behaviors refine this contract:
+
+- The alias `ecnu-reasoner` activates thinking server-side; a bare request with
+  no `thinking` parameter still returns non-zero reasoning tokens. Use it when
+  you want always-on thinking without managing the parameter. See
+  [alias default thinking](known_deviations.md#ecnu-reasoner-alias-default-thinking).
+- On `ecnu-max`, sending `reasoning_effort` alone (without `thinking`) is
+  sufficient to activate thinking, contrary to the documented gating. The
+  `thinking` parameter remains optional. See
+  [effort as trigger](known_deviations.md#ecnu-max-reasoning-effort-as-thinking-trigger).
+
+Restrict `reasoning_effort` to `low`, `high`, `xhigh`, and `max`. The values
+`minimal` and `medium` return intermittent HTTP 500; `xhigh` is undocumented
+but stable. See [unavailable tiers](known_deviations.md#unavailable-reasoning-effort-tiers).
+
 For a tool exchange, append the complete actual assistant message before the
 matching tool results. ECNU documents preserving `reasoning_content` for
 thinking-mode tool calls through subsequent user turns. Keep it only in process

references/known_deviations.md

@@ -23,6 +23,17 @@ langchain-openai 0.3.35, and httpx 0.28.1. Requests used synthetic text,
 60-second timeouts, no retries, and the same cumulative 50-credit ceiling.
 Only response structure, field-preservation checks, and usage were retained.
 
+Test environment `live-2026-09-12-c` used the account owner's personal tokens
+(two distinct keys), Windows x64, Node.js 24.14.1 `fetch` direct HTTP, and
+Asia/Shanghai local dates 2026-09-12 through 2026-09-14, during an
+owner-authorized interactive integration session rather than the smoke runner.
+Reliability runs were serial with roughly four-second spacing; unspaced bursts
+are called out per entry. Repeated attempts in those runs were deliberate
+characterization samples, not uncertainty retries, and credit consumption was
+not metered against the runner's ceiling. Only synthetic arithmetic and
+vision-fixture inputs were used. Prompts, generated content, reasoning text,
+and credentials were not retained.
+
 ## Invalid bearer on model discovery
 
 - **Tested at:** 2026-08-23; reproduced 2026-09-12
@@ -328,6 +339,85 @@ estimated cumulative consumption was 3.92822 credits. Neither is verified
 account debit. This targeted run does not revalidate other historical cases,
 other SDK versions, streaming, or arbitrary framework adapters.
 
+## ecnu-reasoner alias default thinking
+
+- **Tested at:** 2026-09-12
+- **Environment:** live-2026-09-12-c, Node.js `fetch` direct HTTP
+- **Protocol and endpoint:** OpenAI-compatible `POST /chat/completions`
+- **Documented expectation:** The alias `ecnu-reasoner` equals `ecnu-max` with `thinking: {"type": "enabled"}`; a client must send the `thinking` parameter to activate thinking on `ecnu-max` itself.
+- **Observed behavior:** A bare `ecnu-reasoner` request with no `thinking` field returned `200` and a non-zero `usage.completion_tokens_details.reasoning_tokens` count (range 18-198 across samples). A matching bare `ecnu-max` control returned `reasoning_tokens: 0`. The alias activates thinking server-side without any client-side `thinking` parameter.
+- **Reproduction conditions:** Send two otherwise identical minimal requests, one with `model: "ecnu-reasoner"` and one with `model: "ecnu-max"`, both omitting `thinking`; compare `usage.completion_tokens_details.reasoning_tokens`.
+- **Impact:** A client that relies on sending `thinking` to detect whether reasoning is active will misclassify `ecnu-reasoner` responses. The absence of `message.reasoning_content` is not a reliable thinking indicator either (see the prior "Max thinking response fields" entry).
+- **Recommended fallback:** Detect active thinking via `usage.completion_tokens_details.reasoning_tokens`, not via `message.reasoning_content` or the presence of a client-side `thinking` parameter. Treat `ecnu-reasoner` as always-thinking for routing decisions.
+- **Status:** active
+
+## ecnu-max reasoning_effort as thinking trigger
+
+- **Tested at:** 2026-09-12
+- **Environment:** live-2026-09-12-c, Node.js `fetch` direct HTTP
+- **Protocol and endpoint:** OpenAI-compatible `POST /chat/completions`
+- **Documented expectation:** The thinking page states that `reasoning_effort` only takes effect when thinking mode is enabled via `thinking: {"type": "enabled"}`; without it, `reasoning_effort` is ignored.
+- **Observed behavior:** `ecnu-max` requests with `reasoning_effort` set but no `thinking` field returned `200` with non-zero `usage.completion_tokens_details.reasoning_tokens`. Dose-response was clean across `low` (median ~117), `high` (~155), and `max` (~343). Adding `thinking: {"type": "enabled"}` alongside `reasoning_effort` did not increase the token count beyond the same-effort baseline.
+- **Reproduction conditions:** Send `ecnu-max` requests with `reasoning_effort` set to `low`, `high`, and `max` but omit `thinking`; record `usage.completion_tokens_details.reasoning_tokens` for each.
+- **Impact:** Clients following the documented precondition may unnecessarily send a `thinking` parameter, or may wrongly conclude thinking is off when only `reasoning_effort` is sent. The documented gating does not match the current deployment.
+- **Recommended fallback:** For `ecnu-max`, sending `reasoning_effort` alone is sufficient to activate thinking; the `thinking` parameter is optional. Do not treat the documented gating as authoritative until rechecked. Keep the `thinking` parameter if an upstream SDK requires it, but do not require it for function.
+- **Status:** active
+
+## Unavailable reasoning effort tiers
+
+- **Tested at:** 2026-09-12
+- **Environment:** live-2026-09-12-c, Node.js `fetch` direct HTTP
+- **Protocol and endpoint:** OpenAI-compatible `POST /chat/completions`
+- **Documented expectation:** The thinking page lists `low`, `high`, and `max` as the three supported `reasoning_effort` values for `ecnu-max`.
+- **Observed behavior:** `minimal` returned HTTP 500 on 5 of 7 attempts; `medium` returned HTTP 500 on 7 of 9 attempts. Both occasionally succeeded but cannot be relied on. `xhigh`, although absent from the documentation, returned `200` on all attempts with a reasoning-token median (~178) between `high` and `max`. `low`, `high`, and `max` were stable across all samples.
+- **Reproduction conditions:** Send `ecnu-max` requests with each of `minimal`, `medium`, `xhigh`, `low`, `high`, and `max` as `reasoning_effort`; use serial requests with roughly four-second spacing to avoid the rate-limit deviation below.
+- **Impact:** A client that sends `minimal` or `medium` (for example, via an SDK default or a UI selector that does not filter values) will hit intermittent 500 errors. `xhigh` is a usable but undocumented tier.
+- **Recommended fallback:** Restrict `reasoning_effort` to `low`, `high`, `xhigh`, and `max` in client-side selectors and validators. Do not send `minimal` or `medium`. If an SDK or framework injects those values, intercept and remap them before the request. Treat `xhigh` as usable but recheck before relying on it for a production default.
+- **Status:** active
+
+## Rapid-request 401 metadata failure
+
+- **Tested at:** 2026-09-12
+- **Environment:** live-2026-09-12-c, Node.js `fetch` direct HTTP
+- **Protocol and endpoint:** OpenAI-compatible `POST /chat/completions` and `GET /models`
+- **Documented expectation:** `401` indicates an authentication failure; the official guidance only advises avoiding parallel calls.
+- **Observed behavior:** Rapid sequential requests (under roughly one second apart) to either endpoint returned `401` with `{"detail": "获取第三方元数据失败"}` even though the same bearer passed spaced requests. Spacing requests by roughly four seconds eliminated the failures. The error shape is identical to the unsupported-model case above, making them indistinguishable without a working control.
+- **Reproduction conditions:** Send the same valid bearer to the same documented model in a tight loop (sub-second spacing); then repeat with four-second spacing.
+- **Impact:** A client may mistake rate-limiting for a credential failure and trigger key rotation or an auth stop. A retry loop without backoff can sustain the 401 and exhaust credits on failed attempts.
+- **Recommended fallback:** On a `401` with this detail string, first retry once after a four-second delay before treating it as an authentication failure. Always serialize requests to ECNU; do not use parallel call patterns. Do not rotate keys based solely on this error shape without a spaced-control request.
+- **Status:** active
+
+## Verified coverage on 2026-09-12 through 2026-09-14
+
+Environment `live-2026-09-12-c` made characterization requests across two
+personal tokens on Windows x64, Node.js 24.14.1, over Asia/Shanghai dates
+2026-09-12 through 2026-09-14. Requests were serial with roughly four-second
+spacing except where unspaced bursts are noted. No credit metering was applied;
+this was an owner-authorized interactive session, not a smoke-runner batch.
+
+Successful coverage included:
+
+- Both `ecnu-max` and `ecnu-reasoner` returned `200` for `reasoning_effort`
+  values `low`, `high`, `xhigh`, and `max`, with a clean dose-response curve
+  (median reasoning tokens: low ~117, high ~155, xhigh ~178, max ~343).
+- `ecnu-reasoner` bare requests returned non-zero reasoning tokens; `ecnu-max`
+  bare requests returned zero. The alias activates thinking server-side.
+- `ecnu-max` with `reasoning_effort` but no `thinking` parameter activated
+  thinking, contradicting the documented gating.
+- `minimal` and `medium` efforts returned intermittent HTTP 500 and are
+  unreliable; `xhigh` is undocumented but stable.
+- Both models correctly recognized a synthetic 96x96 red-circle PNG and
+  returned the expected "circle red" description, with and without thinking.
+- Function calling with thinking coexisted normally on both models; a
+  two-turn tool exchange without preserved `reasoning_content` returned `200`.
+- Rapid sub-second request bursts returned `401`
+  `{"detail": "获取第三方元数据失败"}`; four-second spacing eliminated it.
+
+No SDK, streaming, long-context, embedding, rerank, TTS, or image-generation
+revalidation was performed in this run. The dose-response medians are
+characterization samples, not quality benchmarks. Older observations retain
+their original dates and statuses.
+
 ## Update rules
 
 1. Record the date, non-secret environment, protocol, endpoint, expectation,

references/models.md

@@ -27,6 +27,16 @@ Upstream model cards can explain model design, but do not establish ECNU's
 request fields, thinking defaults, context units, output limits, performance,
 or deployment path. Do not copy upstream serving flags into requests.
 
+For thinking mode, the alias `ecnu-reasoner` activates thinking server-side
+without a client-side `thinking` parameter
+([observed](known_deviations.md#ecnu-reasoner-alias-default-thinking)).
+On `ecnu-max`, `reasoning_effort` alone triggers thinking, contrary to the
+documented gating
+([observed](known_deviations.md#ecnu-max-reasoning-effort-as-thinking-trigger)).
+Restrict `reasoning_effort` to `low`, `high`, `xhigh`, and `max`; `minimal`
+and `medium` are unreliable
+([observed](known_deviations.md#unavailable-reasoning-effort-tiers)).
+
 For a cost calculation, fetch current prices and show the input/output and
 cache assumptions. Do not assume a cache-hit ratio or treat estimated usage as
 verified account debit. A code-only task does not require a cost calculation.