Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
17 changes: 9 additions & 8 deletions references/agent_development.md
Original file line number Diff line number Diff line change
Expand Up @@ -8,11 +8,12 @@ Model facts and protocol rules are linked from [models.md](models.md) and
[api_reference.md](api_reference.md). The design advice and prompt examples
below are **`application-policy`**: starting points to evaluate on your tasks.

**Contract update checked 2026-10-02:** the 2026-09-18 model change made
`ecnu-max` text-only again; use `ecnu-plus` for vision. Plus now supports
`low` / `medium` / `xhigh` effort when thinking is enabled. The older model
choices below describe the September 12 checks, not current execution advice;
follow [current model selection](models.md) and [thinking](examples.md#thinking-and-tool-history).
**Contract update checked 2026-10-19:** the 2026-10-01 model update moved
`ecnu-max` to a multimodal backend, and both primary models now document image
understanding. Plus supports `low` / `medium` / `xhigh` effort when thinking is
enabled. The older model choices below describe the September 12 checks, not
current execution advice; follow [current model selection](models.md) and
[thinking](examples.md#thinking-and-tool-history).

## Choose a model and reasoning budget

Expand All @@ -33,9 +34,9 @@ Two upstream differences matter when adapting examples:
ECNU still documents `low` / `high` / `max` for direct Chat requests. Use the
ECNU protocol mappings; do not invent numeric equivalents.
- **Qwen3.8:** upstream thinking defaults and template options differ from
ECNU. On ECNU, thinking defaults off, and `ecnu-plus` ignores effort tiers.
Use `thinking.type`; do not copy `enable_thinking`, `preserve_thinking`, or
`chat_template_kwargs` into ECNU requests.
ECNU. On ECNU, thinking defaults off, and `ecnu-plus` uses `low` / `medium` /
`xhigh` effort tiers. Use `thinking.type`; do not copy `enable_thinking`,
`preserve_thinking`, or `chat_template_kwargs` into ECNU requests.

Use the API's thinking control instead of trying to activate it with a
"think step by step" phrase. Ask for a concise answer with evidence and checks;
Expand Down
1 change: 1 addition & 0 deletions references/api_reference.md
Original file line number Diff line number Diff line change
Expand Up @@ -32,6 +32,7 @@ in environment variables; ticket URLs are also credentials.
| Anthropic-compatible client | [Anthropic API](https://developer.ecnu.edu.cn/vitepress/llm/api/anthropic.html) | [SDK setup](examples.md#anthropic-sdk); investigate suffix errors only when they occur |
| Embed an iframe | [Embed integration](https://developer.ecnu.edu.cn/vitepress/llm/api/embediframe.html) | Do not log or reuse one-time tickets |
| Browser link that submits a question | [URL chat](https://developer.ecnu.edu.cn/vitepress/llm/api/urlchat.html) | Opening a submit link sends data; do not auto-open it as a documentation check |
| Error status or response shape | [Error codes](https://developer.ecnu.edu.cn/vitepress/llm/error.html) | [Targeted diagnosis](workflows.md#start-from-the-symptom); keep the actual status and body type |

## Account and changing values

Expand Down
19 changes: 11 additions & 8 deletions references/known_deviations.md
Original file line number Diff line number Diff line change
Expand Up @@ -204,10 +204,11 @@ and credentials were not retained.

## Direct `ecnu-max` image input

Current-contract note (documentation checked 2026-10-02, not a retest): the
[2026-09-18 model change](https://developer.ecnu.edu.cn/vitepress/llm/model.html)
made `ecnu-max` text-only again. Use `ecnu-plus` for image understanding.
The resolved status below describes only the September 12 fixture.
Current-contract note (documentation checked 2026-10-19, not a retest): the
[2026-10-01 model update](https://developer.ecnu.edu.cn/vitepress/llm/model.html)
moved `ecnu-max` to DeepSeek-V4.1-Flash-1017 with native image understanding.
The 2026-09-18 text-only interval is historical, and the resolved status below
still describes only the September 12 fixture.

- **Tested at:** 2026-09-12; previous failure on 2026-08-23
- **Environment:** live-2026-09-12-a, direct HTTP; historical live-2026-08-23-a
Expand Down Expand Up @@ -405,10 +406,12 @@ max default. Its original test date and status are retained.

## Verified coverage on 2026-09-12 through 2026-09-14

**Current-contract note (2026-10-02):** This is historical coverage, not a
current capability test. The model page now specifies max as text-only with
512K context; use plus for image understanding and the current per-model
thinking tiers. No live revalidation was performed for this note.
**Current-contract note (2026-10-19):** This is historical coverage, not a
current capability test. The model page now documents image understanding on
both primary models; the max-vision result below predates the 2026-09-18
text-only interval and the 2026-10-01 multimodal backend update. Use the
current per-model thinking tiers. No live revalidation was performed for this
note.

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
Expand Down
27 changes: 19 additions & 8 deletions references/models.md
Original file line number Diff line number Diff line change
Expand Up @@ -20,8 +20,12 @@ a measured quality or latency ranking.
## Select the capability, not just a new model name

The [2026-09-30 release](https://developer.ecnu.edu.cn/vitepress/llm/release.html)
added multimodal retrieval and image editing. Contract checked 2026-10-02;
these are documented capabilities, not new live-test results.
added multimodal retrieval and image editing. The
[model page](https://developer.ecnu.edu.cn/vitepress/llm/model.html) also
records the 2026-10-01 backend update: `ecnu-max` is now
DeepSeek-V4.1-Flash-1017 and `ecnu-plus` is Qwen3.8-Flash-Next. Contract
checked 2026-10-19; these are documented capabilities, not new live-test
results.

| Model | Backend in the current model page | Integration choice |
|---|---|---|
Expand All @@ -31,19 +35,26 @@ these are documented capabilities, not new live-test results.
| `ecnu-rerank-vl` | Qwen3-VL-Reranker-8B | Text/image query and candidates; rerank an already retrieved candidate set |
| `ecnu-image` | qwen-image-2.1 | Generate from text or edit one existing image; different request formats and prompt handling |

The same page currently lists `ecnu-max` with 512K context, up to 256K output,
and `low` / `high` / `max` effort, and `ecnu-plus` with 256K context, up to
128K output, and `low` / `medium` / `xhigh` effort. Per-user concurrency caps
are 3 for `ecnu-max` and 5 for `ecnu-plus`, counted independently. Recheck
those values before displaying or depending on them. `ecnu-tts` is
Fun-CosyVoice3-0.5B with 16 voices and a 4096-character input limit.

Use the [retrieval and image recipes](examples.md) for the differences that
affect requests. Equal vector dimensions do not imply compatible embedding
spaces: changing embedding models requires re-embedding the indexed items and
using that same model and dimensions for queries. A reranker can change without
replacing stored vectors; its relevance scores are not scientific or educational
quality judgments and should not be compared across models.

For image understanding, the current model page specifies `ecnu-plus`.
`ecnu-max` currently uses DeepSeek-V4-Flash-0731 and is text-only; older
DeepSeek-V4.1 and successful vision observations are historical, not current
capability guarantees. Keep stable ECNU aliases in requests and recheck backend
labels before displaying them. Do not relabel old generated assets as output
from a newly announced backend.
The current model page documents image understanding on both `ecnu-max` and
`ecnu-plus`. The 2026-10-01 backend update moved `ecnu-max` to
DeepSeek-V4.1-Flash-1017, ending the 2026-09-18 interval when it was text-only.
Keep stable ECNU aliases in requests and recheck backend labels before
displaying them. Do not relabel old generated assets as output from a newly
announced backend.

## ECNU-specific boundaries

Expand Down
11 changes: 7 additions & 4 deletions references/workbuddy_setup.md
Original file line number Diff line number Diff line change
Expand Up @@ -4,7 +4,7 @@ Connect ECNU to WorkBuddy desktop as a custom OpenAI-compatible model source.
The desktop implementation and startup behavior below were inspected on
2026-09-12; they have not been revalidated on current WorkBuddy builds.
The configuration follows the [ECNU model contract](https://developer.ecnu.edu.cn/vitepress/llm/model.html)
checked on 2026-10-02, but this revised configuration has not been live-tested.
checked on 2026-10-19, but this revised configuration has not been live-tested.

## Configuration file

Expand Down Expand Up @@ -36,9 +36,12 @@ Edit the JSON file directly.
## Configuration example

Use `ecnu-reasoner` for thinking and `ecnu-max` for ordinary text requests.
Both are currently text-only. The input/output limits below are conservative
client budgets: together they stay below the documented 512K context, without
assuming whether K means 1000 or 1024. They are not backend maximums.
The entries below keep this client text-only; since 2026-10-01 the ECNU model
page documents image understanding on both `ecnu-max` and `ecnu-plus`, so
`supportsImages: false` is a client configuration choice, not a model limit.
The input/output limits below are conservative client budgets: together they
stay below the documented 512K context, without assuming whether K means 1000
or 1024. They are not backend maximums.

```json
[
Expand Down
4 changes: 2 additions & 2 deletions references/workflows.md
Original file line number Diff line number Diff line change
Expand Up @@ -26,9 +26,9 @@ These links are dated observations, not claims that the issue still reproduces.
| An effort tier fails | Use the chosen model's [documented tiers](examples.md#thinking-and-tool-history); the [September max observation](known_deviations.md#unavailable-reasoning-effort-tiers) does not apply to plus |
| TTS error parsing crashes | Tolerate non-JSON errors: [invalid voice](known_deviations.md#invalid-tts-voice-error-shape) |
| PCM bytes arrive without format metadata | Configure the format explicitly: [missing headers](known_deviations.md#successful-tts-response-headers) |
| Old max-vision success conflicts with current docs | Current max is text-only; the [September 12 fixture](known_deviations.md#direct-ecnu-max-image-input) predates the September 18 contract change |
| Old max-vision notes conflict with current docs | Current docs list image understanding on both models; the [September 12 fixture](known_deviations.md#direct-ecnu-max-image-input) predates the 2026-09-18 text-only interval and the 2026-10-01 backend update |
| `422` | Inspect `detail` and the relevant [request contract](api_reference.md); do not retry the unchanged request |
| `429` | Check [current credits/quota](models.md); stop parallel retries |
| `429` | Check [current credits/quota](models.md) and the independent per-user concurrency caps (`ecnu-max`: 3; `ecnu-plus`: 5); stop parallel retries |
| Timeout or dropped connection after POST | Completion and debit may be unknown; do not automatically resubmit |

A later release announcement does not by itself resolve a deviation. Do not
Expand Down
Loading