cotutor 0.3.0 → 0.4.0

package/dist/app/workspace.d.ts

@@ -1,6 +1,6 @@
 import { ConfigError, UsageError } from '../shared/errors.ts';
 import { redactDeep, redactHome } from '../shared/home.ts';
-import { type RootSource, type Workspace } from '../schema/workspace.ts';
+import { type RootSource, type SandboxMark, type Workspace } from '../schema/workspace.ts';
 import { type CotutorConfig } from '../schema/index.ts';
 export { ConfigError, UsageError, redactDeep, redactHome };
 export type { RootSource, Workspace };
@@ -29,6 +29,8 @@ export declare function resolveRoot(override?: string, opts?: ResolveOptions): R
 /** 校验 cotutor.json 的形状;失败 → ConfigError,信息是逐条修复指南 */
 export declare function parseConfig(raw: unknown, file: string): CotutorConfig;
 export declare function resolvePaths(root: string, paths: Record<string, string>): Workspace['paths'];
+/** 根下的 sandbox 标记(.cotutor/sandbox.json):没有 → null;坏了响亮报错(不当成真 workspace 静默往下跑) */
+export declare function readSandboxMark(root: string): SandboxMark | null;
 export declare function assembleWorkspace(root: string, source: RootSource, config: CotutorConfig): Workspace;
 /** 定根 + 读配置 + 校验 + 展开角色。cotutor.json 缺失也是错(它是必需的)。 */
 export declare function loadWorkspace(override?: string, opts?: ResolveOptions): Workspace;
@@ -51,8 +53,11 @@ export declare function deepMerge(base: unknown, patch: unknown): unknown;
 export declare function patchConfig(ws: Workspace, patch: Record<string, unknown>, opts?: {
     also?: readonly string[];
 }): Promise<CotutorConfig>;
-/** 文件改了(页面写的、或家长在编辑器改的)就重读;坏了抛 ConfigError,调用方决定是留旧的还是响 */
-export declare function reloadIfChanged(ws: Workspace, lastMtime: number): Promise<{
+/**
+ * 文件内容变了(页面写的、或家长在编辑器改的)就重读;坏了抛 ConfigError,调用方决定是留旧的还是响。
+ * 比原文不比修改时间:Windows 上写 .tmp 再 rename 连写两次,修改时间常常一模一样(10-31 实测 200 次里 105 次);文件只有几 K,每次读一遍不贵。
+ */
+export declare function reloadIfChanged(ws: Workspace, lastText: string | null): Promise<{
     ws: Workspace;
-    mtime: number;
+    text: string;
 }>;

package/dist/app/workspace.js

@@ -7,10 +7,10 @@
  * 配置"在但解析不了"响亮报错,不静默走缺省(沿 drawtell 的教训)。
  */
 import { readFileSync, readdirSync, statSync } from 'node:fs';
-import { writeFile, rename, stat } from 'node:fs/promises';
+import { readFile, writeFile, rename } from 'node:fs/promises';
 import { ConfigError, UsageError } from "../shared/errors.js";
 import { redactDeep, redactHome } from "../shared/home.js";
-import { SKILLS_DIR } from "../schema/workspace.js";
+import { SANDBOX_MARK, SKILLS_DIR, SandboxMarkSchema } from "../schema/workspace.js";
 import { homedir } from 'node:os';
 import { dirname, isAbsolute, join, resolve } from 'node:path';
 import { CotutorConfigSchema, PATH_ROLES, ROLE_DEFAULTS, WORKSPACE_ROLES, explainIssues, } from "../schema/index.js";
@@ -136,11 +136,24 @@ export function resolvePaths(root, paths) {
             out[role] = expandPath(value, vault);
     return out;
 }
+/** 根下的 sandbox 标记(.cotutor/sandbox.json):没有 → null;坏了响亮报错(不当成真 workspace 静默往下跑) */
+export function readSandboxMark(root) {
+    const file = join(root, SANDBOX_MARK);
+    const raw = readJson(file);
+    if (raw === null)
+        return null;
+    const r = SandboxMarkSchema.safeParse(raw);
+    if (!r.success)
+        throw new ConfigError(file, explainIssues(r.error.issues).map((l) => `  - ${l}`).join('\n'));
+    return r.data;
+}
 export function assembleWorkspace(root, source, config) {
+    const sandbox = readSandboxMark(root);
     return {
         root,
         source,
         config,
+        ...(sandbox ? { sandbox } : {}),
         paths: resolvePaths(root, config.paths),
         dirs: {
             agents: join(root, 'agents'),
@@ -178,6 +191,7 @@ export function workspaceReport(ws) {
         vault: ws.paths.vault,
         tutors: Object.keys(ws.config.tutors),
         runtime: ws.config.runtimes.default,
+        ...(ws.sandbox ? { sandbox: { from: ws.sandbox.from, forkedAt: ws.sandbox.forkedAt } } : {}),
     });
 }
 // ---- cotutor.json 的补丁写回与热重载(从 runtime/journal/store.ts 搬来,2026-10-29) ----
@@ -233,13 +247,22 @@ export async function patchConfig(ws, patch, opts = {}) {
     await rename(tmp, ws.files.config);
     return r.data;
 }
-/** 文件改了(页面写的、或家长在编辑器改的)就重读;坏了抛 ConfigError,调用方决定是留旧的还是响 */
-export async function reloadIfChanged(ws, lastMtime) {
-    const st = await stat(ws.files.config);
-    if (st.mtimeMs === lastMtime)
-        return { ws, mtime: lastMtime };
-    const raw = readJson(ws.files.config);
-    if (raw === null)
+/**
+ * 文件内容变了(页面写的、或家长在编辑器改的)就重读;坏了抛 ConfigError,调用方决定是留旧的还是响。
+ * 比原文不比修改时间:Windows 上写 .tmp 再 rename 连写两次,修改时间常常一模一样(10-31 实测 200 次里 105 次);文件只有几 K,每次读一遍不贵。
+ */
+export async function reloadIfChanged(ws, lastText) {
+    const text = await readFile(ws.files.config, 'utf8').catch(() => null);
+    if (text === null)
         throw new ConfigError(ws.files.config, '不存在了');
-    return { ws: assembleWorkspace(ws.root, ws.source, parseConfig(raw, ws.files.config)), mtime: st.mtimeMs };
+    if (text === lastText)
+        return { ws, text };
+    let raw;
+    try {
+        raw = JSON.parse(text);
+    }
+    catch (err) {
+        throw new ConfigError(ws.files.config, `不是合法 JSON:${err instanceof Error ? err.message : String(err)}`);
+    }
+    return { ws: assembleWorkspace(ws.root, ws.source, parseConfig(raw, ws.files.config)), text };
 }

package/dist/app/ws/route.d.ts

@@ -18,8 +18,14 @@ export interface LiveRouteDeps {
     echoWaitMs?: number;
     ringMs?: number;
     stallMs?: number;
+    idleCutMs?: number;
+    maxTakeMs?: number;
     onFinished?(tutor: string, why: string): void;
 }
-export declare function makeLiveUpgrade(deps?: LiveRouteDeps): (req: IncomingMessage, socket: Duplex, head: Buffer, ctx: LiveApp) => Promise<boolean>;
+/** 接升级的函数;openCalls = 现在开着几通(serve 看它定这台电脑能不能睡) */
+export type LiveUpgrade = ((req: IncomingMessage, socket: Duplex, head: Buffer, ctx: LiveApp) => Promise<boolean>) & {
+    openCalls(): number;
+};
+export declare function makeLiveUpgrade(deps?: LiveRouteDeps): LiveUpgrade;
 /** 探针:COTUTOR_LIVE_ENDPOINT 指到假百炼 */
-export declare const liveUpgrade: (req: IncomingMessage, socket: Duplex, head: Buffer, ctx: LiveApp) => Promise<boolean>;
+export declare const liveUpgrade: LiveUpgrade;

package/dist/app/ws/route.js

@@ -3,7 +3,8 @@ import { acceptWebSocket, isUpgrade } from "./ws.js";
 import { cookieOf } from "../http/access.js";
 import { DEVICE_COOKIE } from "../../schema/kid-device.js";
 export function makeLiveUpgrade(deps = {}) {
-    return async function liveUpgrade(req, socket, head, ctx) {
+    const open = new Set();
+    const liveUpgrade = async function liveUpgrade(req, socket, head, ctx) {
         const m = /^\/api\/live\/([a-z0-9][a-z0-9-]*)\/ws(?:\?.*)?$/.exec(req.url ?? '');
         if (!m || !isUpgrade(req))
             return false;
@@ -20,10 +21,13 @@ export function makeLiveUpgrade(deps = {}) {
             onClose: () => call?.onSocketClose(),
         });
         const listen = new URL(req.url ?? '', 'http://x').searchParams.get('listen') === 'open' ? 'open' : 'hold';
-        call = new LiveCall(sock, { ctx, tutor, deviceId: cookieOf(req.headers.cookie, DEVICE_COOKIE), listen, endpoint: deps.endpoint, env: deps.env, heartbeatMs: deps.heartbeatMs, keepAliveMs: deps.keepAliveMs, swapTokens: deps.swapTokens, idleSwapMs: deps.idleSwapMs, echoWaitMs: deps.echoWaitMs, ringMs: deps.ringMs, stallMs: deps.stallMs, onFinished: (why) => deps.onFinished?.(tutor, why) });
+        call = new LiveCall(sock, { ctx, tutor, deviceId: cookieOf(req.headers.cookie, DEVICE_COOKIE), listen, endpoint: deps.endpoint, env: deps.env, heartbeatMs: deps.heartbeatMs, keepAliveMs: deps.keepAliveMs, swapTokens: deps.swapTokens, idleSwapMs: deps.idleSwapMs, echoWaitMs: deps.echoWaitMs, ringMs: deps.ringMs, stallMs: deps.stallMs, idleCutMs: deps.idleCutMs, maxTakeMs: deps.maxTakeMs, onFinished: (why) => { if (call)
+                open.delete(call); deps.onFinished?.(tutor, why); } });
+        open.add(call);
         void call.start();
         return true;
     };
+    return Object.assign(liveUpgrade, { openCalls: () => open.size });
 }
 /** 探针:COTUTOR_LIVE_ENDPOINT 指到假百炼 */
-export const liveUpgrade = makeLiveUpgrade(process.env.COTUTOR_LIVE_ENDPOINT ? { endpoint: process.env.COTUTOR_LIVE_ENDPOINT, env: { ...process.env, DASHSCOPE_API_KEY: process.env.DASHSCOPE_API_KEY ?? 'sk-probe' } } : {});
+export const liveUpgrade = makeLiveUpgrade(process.env.COTUTOR_LIVE_ENDPOINT ? { endpoint: process.env.COTUTOR_LIVE_ENDPOINT } : {});

package/dist/board/parse.d.ts

@@ -78,8 +78,6 @@ export declare function playsLecture(line: {
     cues?: readonly BoardCue[];
 }, cards: readonly BoardCard[]): boolean;
 export declare function parseBoard(text: string, opts?: ParseBoardOptions): ParsedBoard;
-/** 回复停在写成正文的工具调用上(后面只剩空行):老师在等工具的结果,这一轮其实没写完(runner 据此 resume 一次) */
-export declare function endsWithToolCall(text: string): boolean;
 /** 原文一行的角色:解析器把它当什么了 */
 export type SourceRole = 
 /** 讲稿一句(念出来) */

package/dist/board/parse.js

@@ -247,12 +247,6 @@ export function parseBoard(text, opts = {}) {
         },
     };
 }
-/** 回复停在写成正文的工具调用上(后面只剩空行):老师在等工具的结果,这一轮其实没写完(runner 据此 resume 一次) */
-export function endsWithToolCall(text) {
-    const { spans } = parseBoard(text);
-    const last = spans.toolCalls[spans.toolCalls.length - 1];
-    return Boolean(last) && text.split('\n').slice(last[1] + 1).every((l) => !l.trim());
-}
 const SECTION_HEAD = /^##\s+(.+?)\s*$/;
 /**
  * 家长端「看原文」用:把老师原文的每一行标上解析器怎么读的。

package/dist/board/presentation.d.ts

@@ -152,7 +152,7 @@ export interface BoardMessage {
     reply: string | null;
     pending: boolean;
     section?: BoardSection | null;
-    /** 孩子这条带的作业照片(相对 workspace 根;R5):节头上回显缩略图 */
+    /** 孩子这条带的作业照片(相对 workspace 根):答拍给我看卡的进那张卡;别的由老师用 image 卡放上板 */
     photos?: string[];
     /** 看完小课堂后的第一条:这一节前面是小课堂卡 */
     lecture?: KidLecture;
@@ -163,14 +163,14 @@ export interface BoardMessage {
     /** 按住说话的(索引里带 voice):板上去口头禅、一行截断 */
     /** 首页按钮发的:按钮上的字,不是孩子说的 */
     fromHome?: boolean;
-    /** 实时的一轮(讲稿嘴照念,不配音) */
+    /** 实时的一轮(讲稿嘴照念):板上不看它,一律照实时的画(2026-11-04);只给字幕重放、录像用 */
     live?: boolean;
 }
 /** 板上孩子的一句话:text 是显示的(语音去了口头禅),full 是原话 */
 export interface KidSaid {
     text: string;
     full: string;
-    /** 答拍给我看卡时拍来的照片:进那张卡的答案栏,节头不再回显 */
+    /** 答拍给我看卡时拍来的照片:放大放在那张卡里(2026-11-04 之前缩在卡下沿) */
     photos?: string[];
 }
 export interface BoardEntry extends BoardSection {
@@ -178,27 +178,23 @@ export interface BoardEntry extends BoardSection {
     at?: string;
     /** 老师还在说:卡只增不改;前 ready 拍就绪了就能播(2026-09-13 之前是整轮跑完才播);整轮跑完换成正式的一节 */
     partial?: boolean;
-    /** 孩子问这节时拍的照片(节头上回显) */
-    photos?: string[];
     /** 这一节答的是看完小课堂后的第一问:节前画小课堂卡 */
     lecture?: KidLecture;
     /** 这一节答的是孩子从纸上交的画:节前一张孩子的画卡 */
     drawing?: KidDrawing;
-    /** 孩子引出这一节的那句话;saidOn = 它答的是哪一节的哪张问题卡(写进那张卡的答案栏),没有 = 在这一节开头单独一行。实时的节头不是它(看 head),它只给左栏用 */
+    /** 孩子引出这一节的那句话;saidOn = 它答的是哪一节的哪张问题卡。节头不是它(看 head):它给左栏用,答拍给我看卡的还进那张卡 */
     said?: KidSaid;
     saidOn?: {
         job: string;
         card: number;
     };
-    /** 实时的一轮:卡闭合了就铺(不按拍);不出卡的板上留讲稿的字 */
-    live?: true;
-    /** 实时:这一轮开头是脑写的节头(只有一行 # 标题的文字卡),从这里起新的一件事,head 是它的标题(liveHead) */
+    /** 这一轮开头是脑写的节头(只有一行 # 标题的文字卡),从这里起新的一件事,head 是它的标题(liveHead) */
     head?: string;
-    /** 实时:这一轮开头没写节头,接着上一节画 */
+    /** 这一轮开头没写节头,接着上一节画 */
     cont?: true;
 }
 /**
- * 实时的一节怎么接:新一节的开头由脑定,不再机械是孩子那句。
+ * 一节怎么接(板上只有实时一种画法,2026-11-04;以前的话题也这样画):新一节的开头由脑定,不再机械是孩子那句。
  * 这一轮第一张卡是节头 → head;没写(只有讲稿、开头是别的卡、还没写出卡)→ cont,接着上一节。一轮中间的节头卡,是从那张卡起新一节
  */
 export declare function liveHead(s: Pick<BoardSection, 'cards'>): {
@@ -225,7 +221,7 @@ export declare function kidSaid(messages: readonly BoardMessage[]): Map<string,
 }>;
 /**
  * 孩子端条目 → 板书节(没有 section 的条目不出节);
- * 孩子的话挂在它引出的那一节上(said / saidOn,kidSaid);还在跑的只有带 partial 板书(流式,已有卡或已有配好的句;实时的有句就算)才出节且标 partial,其余不出。
+ * 孩子的话挂在它引出的那一节上(said / saidOn,kidSaid);还在跑的只有带 partial 板书(流式,已有卡或已有句)才出节且标 partial,其余不出。
  */
 export declare function sectionsFromMessages(messages: readonly BoardMessage[]): BoardEntry[];
 /** 一节在目录里的名字:小节标题 > 有名字的文字卡 > 第一张有字的卡 > 第一句讲稿;截到 14 个字 */
@@ -269,13 +265,11 @@ export type PlayerEvent = {
     type: 'fresh';
     sections: number[];
 };
-/** stop 只停声音(卡的点读、单词);paint = 把某节的标注画齐;showNow = 选中态照现在的位置;scrollLast = 滚到最后一节 */
+/** stop 只停声音(卡的点读、单词);paint = 把某节的标注画齐;scrollLast = 滚到最后一节。板上不描「念到哪张」(卡和讲稿不同步,2026-11-04 起以前的话题也这样) */
 export type PlayerEffect = {
     kind: 'stop';
 } | {
     kind: 'render';
-} | {
-    kind: 'showNow';
 } | {
     kind: 'paint';
     section: number;

package/dist/board/presentation.js

@@ -433,7 +433,7 @@ export function isQuestion(text) {
     return t.endsWith('?') || t.endsWith('？');
 }
 /**
- * 实时的一节怎么接:新一节的开头由脑定,不再机械是孩子那句。
+ * 一节怎么接(板上只有实时一种画法,2026-11-04;以前的话题也这样画):新一节的开头由脑定,不再机械是孩子那句。
  * 这一轮第一张卡是节头 → head;没写(只有讲稿、开头是别的卡、还没写出卡)→ cont,接着上一节。一轮中间的节头卡,是从那张卡起新一节
  */
 export function liveHead(s) {
@@ -488,16 +488,16 @@ export function kidSaid(messages) {
 }
 /**
  * 孩子端条目 → 板书节(没有 section 的条目不出节);
- * 孩子的话挂在它引出的那一节上(said / saidOn,kidSaid);还在跑的只有带 partial 板书(流式,已有卡或已有配好的句;实时的有句就算)才出节且标 partial,其余不出。
+ * 孩子的话挂在它引出的那一节上(said / saidOn,kidSaid);还在跑的只有带 partial 板书(流式,已有卡或已有句)才出节且标 partial,其余不出。
  */
 export function sectionsFromMessages(messages) {
     const out = [];
     const says = kidSaid(messages);
     for (const m of messages) {
         const k = says.get(m.job);
-        const at = { ...(m.at ? { at: m.at } : {}), ...(m.photos?.length && !k?.said.photos ? { photos: m.photos } : {}), ...(m.lecture ? { lecture: m.lecture } : {}), ...(m.drawing ? { drawing: m.drawing } : {}), ...(k ? { said: k.said, ...(k.on ? { saidOn: k.on } : {}) } : {}), ...(m.live ? { live: true, ...liveHead(m.section ?? { cards: [] }) } : {}) };
+        const at = { ...(m.at ? { at: m.at } : {}), ...(m.lecture ? { lecture: m.lecture } : {}), ...(m.drawing ? { drawing: m.drawing } : {}), ...(k ? { said: k.said, ...(k.on ? { saidOn: k.on } : {}) } : {}), ...liveHead(m.section ?? { cards: [] }) };
         if (m.pending) {
-            if (m.section && m.section.partial && (m.section.cards.length || (m.live && m.section.lines.length)))
+            if (m.section && m.section.partial && (m.section.cards.length || m.section.lines.length))
                 out.push({ job: m.job, ...at, cards: m.section.cards, lines: m.section.lines, partial: true, ready: m.section.ready ?? 0, ...(m.section.layout ? { layout: m.section.layout } : {}) });
             continue;
         }
@@ -558,7 +558,7 @@ export function step(model, ev, ctx) {
         case 'liveStart':
             fx.push({ kind: 'paint', section: ev.section });
             m = { state: { section: ev.section, line: -1, status: 'thinking' } };
-            fx.push({ kind: 'render' }, { kind: 'showNow' });
+            fx.push({ kind: 'render' });
             break;
         case 'liveBeat':
             if (m.state.section !== ev.section || m.state.status !== 'thinking')
@@ -569,12 +569,10 @@ export function step(model, ev, ctx) {
             fx.push({ kind: 'paint', section: ev.section });
             if (m.state.section !== ev.section)
                 break;
-            if (m.state.status !== 'thinking') {
-                fx.push({ kind: 'showNow' });
+            if (m.state.status !== 'thinking')
                 break;
-            }
             m = { state: playerAtEnd(secs) };
-            fx.push({ kind: 'render' }, { kind: 'showNow' });
+            fx.push({ kind: 'render' });
             break;
         case 'liveDropped':
             fx.push({ kind: 'stop' });
@@ -587,7 +585,7 @@ export function step(model, ev, ctx) {
             for (const i of ev.sections)
                 fx.push({ kind: 'paint', section: i });
             m = { state: playerAtEnd(secs) };
-            fx.push({ kind: 'render' }, { kind: 'showNow' }, { kind: 'scrollLast' });
+            fx.push({ kind: 'render' }, { kind: 'scrollLast' });
             break;
     }
     return { model: m, effects: fx };

package/dist/brain/api-tools.js

@@ -137,8 +137,9 @@ export function readOnlyTools(roots, opts = {}) {
     const relOf = async (p) => {
         for (const root of await realRoots()) {
             const rel = relative(root, p);
+            // 模型给的通配按 / 写(如 随便/*期中*.md),Windows 上 relative 给的是反斜杠
             if (!outside(rel))
-                return rel;
+                return rel.split(sep).join('/');
         }
         return p;
     };

package/dist/brain/api.d.ts

@@ -1,57 +1,52 @@
 import { type ModelMessage } from 'ai';
-import type { CliEvent } from './cli/types.ts';
-import { type RunPlan } from './cli/run-plan.ts';
+import { type RunPlan } from './runtime.ts';
 import { type ApiRuntime, type CotutorConfig, type Policy } from '../schema/index.ts';
-import type { BrainHooks, BrainRequest, BrainRun, WarmKey } from './index.ts';
+import type { BrainHooks, BrainRequest, BrainRun } from './index.ts';
 /** 计划里记的 cli 名:API 的轮次按它分流 */
 export declare const API_CLI = "api";
 /**
  * 出厂的 API 运行时(2026-10-31 起新装缺省 api,Qwen Code 那两条留作备用):模型同那两条——api 对 qwen(qwen3.8-max),api-flash 对 qwen-flash(qwen3.8-flash)
  */
 export declare const FACTORY_API_RUNTIMES: Record<string, ApiRuntime>;
-/** .log 的一行 → 统一事件(API 轮次的日志就是一行一条统一事件);不是这种行回 [] */
-export declare function parseEventLine(line: string): CliEvent[];
 /** 政策 effort → 思考开关与思考量(同 qwen:low 不想,孩子在等;带工具的轮次至少想一点,不然照片题连资料都不查) */
 export declare function thinkingOf(effort: Policy['effort'] | undefined, tools: BrainRequest['tools']): {
     enableThinking: boolean;
     thinkingBudget?: number;
 };
 /**
- * 有思考档的模型照 qwen 运行时发 reasoning_effort(src/brain/cli/qwen.ts 的 EFFORT):想一点 = low、不限 = xhigh;不想或没有档 → null,照 thinkingOf 发。
+ * 有思考档的模型发 reasoning_effort(照当时 Qwen Code 的档):想一点 = low、不限 = xhigh;不想或没有档 → null,照 thinkingOf 发。
  * low 是它自己看着想:闲聊想一两百 token,认照片题想得多;thinking_budget 是死卡,1024 时有照片的话题每轮都想满(2026-10-31)
  */
 export declare function effortOf(model: string, effort: Policy['effort'] | undefined, tools: BrainRequest['tools']): 'low' | 'xhigh' | null;
 /** AI SDK 的 alibaba 只认 thinking_budget:在 fetch 这一层把请求体里的换成 reasoning_effort(SDK 给的中间件口子) */
 export declare function effortFetch(effort: 'low' | 'xhigh', base?: typeof fetch): typeof fetch;
-/**
- * 百炼 Chat Completions 的端点:知道业务空间 id 就走它的域名(原型验过,同 realtime);只有按量 key 就走公网域名(qwen 那边按量的线也走它,2026-10-29 真跑通)
- */
-export declare function bailianBase(workspaceId: string | null): string;
 /**
  * 已经结束的一轮,拼回历史时的老师那条:正文照原样,思考不带,工具往返换成一句「(用了 …,回了 N 字;结果这里不再带,要看再查)」。
  * 只剩一条纯文字的回复,历史里永远没有配不上对的工具消息
  */
 export declare function slimTurn(messages: readonly ModelMessage[]): string;
+/** 这个模型发到哪、带哪把 key(src/shared/qianwen.ts 的 compatibleLine);null = 没配 */
+export type BrainLine = (model: string) => {
+    baseURL: string;
+    key: string;
+    plan: boolean;
+} | null;
 export declare class ApiBrain {
     private readonly workspace;
-    private readonly auth;
-    /** 测试与探针:…/compatible-mode/v1(假百炼);不给按业务空间 id 拼 */
+    private readonly line;
+    /** 测试与探针:…/compatible-mode/v1(假百炼);不给按模型选线 */
     private readonly endpoint;
     constructor(opts: {
         workspace: () => {
             config: CotutorConfig;
             root: string;
         };
-        auth: () => {
-            key: string;
-            workspaceId: string | null;
-        } | null;
+        line: BrainLine;
         endpoint?: string;
     });
     plan(req: BrainRequest): RunPlan;
     start(req: BrainRequest, plan: RunPlan, ctx: {
         tutor: string;
-        key: WarmKey;
         files: {
             log: string;
             err: string;

package/dist/brain/api.js

@@ -1,5 +1,6 @@
 /**
  * 脑执行的 API 实现(2026-10-29):不起 CLI,应用在服务进程里直连百炼的 Chat Completions(AI SDK + @ai-sdk/alibaba,cotutor-api-prototype 验过这条路)。
+ * - 发到哪按模型选(src/shared/qianwen.ts 的 compatibleLine):Token Plan 有这个模型、本机有 token-plan.json 就走 Token Plan(2026-11-02 起),否则百炼按量
  * - 系统提示 = runner 给的 systemBody(老师正文或 activity + 板书写法);消息 = 上下文包 + 孩子的话,本轮的照片直接附成图,不靠老师自己去读
  * - 同一话题的模型历史应用自己存:<日期>.<话题>.brain.jsonl,一行一轮(会话 id、模型、这轮的用户消息、模型回的全部消息、成没成);
  *   接着话题时把同一会话的那几行拼回去。照片只记相对 workspace 根的路径,发的时候再编码。没回完的一轮只留写出来的正文,下一条消息前头注明
@@ -20,11 +21,11 @@ import { isStepCount, streamText } from 'ai';
 import { randomUUID } from 'node:crypto';
 import { createWriteStream } from 'node:fs';
 import { appendFile, mkdir, readFile, stat, writeFile } from 'node:fs/promises';
-import { dirname, extname, isAbsolute, join, relative } from 'node:path';
-import { getRuntime } from "./cli/run-plan.js";
+import { dirname, extname, isAbsolute, join, relative, sep } from 'node:path';
+import { getRuntime } from "./runtime.js";
+import { parseEventLine } from "./log.js";
 import { createPartialReader } from "./stream.js";
 import { parseTranscript, toolCalls, toolSummary } from "./transcript.js";
-import { compatibleBase, DASHSCOPE_HOST } from "../shared/qianwen.js";
 import { isApiRuntime } from "../schema/index.js";
 import { readOnlyTools } from "./api-tools.js";
 /** 计划里记的 cli 名:API 的轮次按它分流 */
@@ -39,7 +40,7 @@ export const FACTORY_API_RUNTIMES = {
 const DEFAULT_STEPS = 6;
 /** 想一点:没有思考档的模型思考最多多少 token(有档的发 reasoning_effort,见 effortOf) */
 const THINK_LITTLE = 1024;
-/** 有思考档的模型:同 Qwen Code 里的 qwen3.8 系列(src/brain/cli/qwen.ts 的 tiers),百炼兼容接口认 reasoning_effort */
+/** 有思考档的模型:qwen3.8 系列(2026-10-31 照当时 Qwen Code 的档对过),百炼兼容接口认 reasoning_effort */
 const TIERED = /^qwen3\.8-/;
 /** 一张照片最大多少字节(百炼按 base64 收,太大的不附,记一条提醒) */
 const IMAGE_MAX = 10 * 1024 * 1024;
@@ -48,18 +49,6 @@ const MIME = { '.png': 'image/png', '.jpg': 'image/jpeg', '.jpeg': 'image/jpeg',
 const CODEC = 'ai-sdk@7';
 /** 上一轮没回完:接在下一条消息前头 */
 const UNFINISHED = '(应用注:上一轮你没有回完,上面是写出来的那部分;孩子可能听到了一些,也可能没有,别当它已经说完。)';
-/** .log 的一行 → 统一事件(API 轮次的日志就是一行一条统一事件);不是这种行回 [] */
-export function parseEventLine(line) {
-    if (!line.startsWith('{"kind":'))
-        return [];
-    try {
-        const e = JSON.parse(line);
-        return typeof e.kind === 'string' ? [e] : [];
-    }
-    catch {
-        return [];
-    }
-}
 /** 政策 effort → 思考开关与思考量(同 qwen:low 不想,孩子在等;带工具的轮次至少想一点,不然照片题连资料都不查) */
 export function thinkingOf(effort, tools) {
     if (effort === 'high')
@@ -69,7 +58,7 @@ export function thinkingOf(effort, tools) {
     return { enableThinking: false };
 }
 /**
- * 有思考档的模型照 qwen 运行时发 reasoning_effort(src/brain/cli/qwen.ts 的 EFFORT):想一点 = low、不限 = xhigh;不想或没有档 → null,照 thinkingOf 发。
+ * 有思考档的模型发 reasoning_effort(照当时 Qwen Code 的档):想一点 = low、不限 = xhigh;不想或没有档 → null,照 thinkingOf 发。
  * low 是它自己看着想:闲聊想一两百 token,认照片题想得多;thinking_budget 是死卡,1024 时有照片的话题每轮都想满(2026-10-31)
  */
 export function effortOf(model, effort, tools) {
@@ -87,12 +76,6 @@ export function effortFetch(effort, base = fetch) {
         return base(input, { ...init, body: JSON.stringify({ ...body, reasoning_effort: effort }) });
     };
 }
-/**
- * 百炼 Chat Completions 的端点:知道业务空间 id 就走它的域名(原型验过,同 realtime);只有按量 key 就走公网域名(qwen 那边按量的线也走它,2026-10-29 真跑通)
- */
-export function bailianBase(workspaceId) {
-    return workspaceId ? `https://${workspaceId}.cn-beijing.maas.aliyuncs.com/compatible-mode/v1` : compatibleBase(DASHSCOPE_HOST);
-}
 /** 报错只说状态码:SDK 的异常里带着整个请求 */
 function failure(err) {
     const status = err && typeof err === 'object' && 'statusCode' in err ? err.statusCode : undefined;
@@ -213,12 +196,12 @@ async function pastOf(file, session, root, current) {
 }
 export class ApiBrain {
     workspace;
-    auth;
-    /** 测试与探针:…/compatible-mode/v1(假百炼);不给按业务空间 id 拼 */
+    line;
+    /** 测试与探针:…/compatible-mode/v1(假百炼);不给按模型选线 */
     endpoint;
     constructor(opts) {
         this.workspace = opts.workspace;
-        this.auth = opts.auth;
+        this.line = opts.line;
         this.endpoint = opts.endpoint;
     }
     plan(req) {
@@ -247,11 +230,11 @@ export class ApiBrain {
             const session = plan.session ?? `api-${randomUUID()}`;
             event({ kind: 'session', id: session });
             const images = req.images ?? [];
-            const stored = images.map((p) => { const rel = relative(root, p); return rel.startsWith('..') || isAbsolute(rel) ? p : rel; });
+            const stored = images.map((p) => { const rel = relative(root, p); return rel.startsWith('..') || isAbsolute(rel) ? p : rel.split(sep).join('/'); });
             const record = { v: 1, session, at: new Date().toISOString(), model: runtime.model, codec: CODEC, user: { text: req.prompt, images: stored }, messages: [], ok: false };
             let final;
-            const auth = this.auth();
-            if (!auth && !this.endpoint) {
+            const line = this.line(runtime.model);
+            if (!line && !this.endpoint) {
                 final = { ok: false, text: null, reason: 'auth:没有百炼按量 key' };
                 warnings.push('百炼还没配好(按量 key):家长端「首页」里填,这位老师的运行时是 API 的,没有它说不了话');
             }
@@ -267,7 +250,7 @@ export class ApiBrain {
                 }
                 const user = await userMessage(text, attach, root, warnings);
                 const tier = effortOf(runtime.model, req.effort, req.tools);
-                const alibaba = createAlibaba({ apiKey: auth?.key ?? 'sk-endpoint', baseURL: this.endpoint ?? bailianBase(auth.workspaceId), includeUsage: true, ...(tier ? { fetch: effortFetch(tier) } : {}) });
+                const alibaba = createAlibaba({ apiKey: line?.key ?? 'sk-endpoint', baseURL: this.endpoint ?? line.baseURL, includeUsage: true, ...(tier ? { fetch: effortFetch(tier) } : {}) });
                 // 断流看门狗:stall.ms 没有一块流到就停(工具在本进程里跑,几毫秒的事,不另算)
                 const abort = new AbortController();
                 let stalled = false;
@@ -296,7 +279,7 @@ export class ApiBrain {
                 try {
                     const result = streamText({
                         model: alibaba(runtime.model),
-                        ...(req.systemBody ?? req.agentBody ? { system: req.systemBody ?? req.agentBody } : {}),
+                        ...(req.systemBody ? { system: req.systemBody } : {}),
                         messages: [...past, user],
                         ...(req.tools !== 'off' ? { tools: readOnlyTools(req.readDirs, { images }) } : {}),
                         stopWhen: isStepCount(runtime.maxSteps ?? DEFAULT_STEPS),
@@ -399,13 +382,13 @@ export class ApiBrain {
             hooks.onExit(Date.now());
             await new Promise((r) => out.end(r));
             // 没配凭证的那轮连请求都没发:不进历史
-            if (auth || this.endpoint)
+            if (line || this.endpoint)
                 await appendFile(files.history, `${JSON.stringify(record)}\n`).catch(() => { });
             const logText = await readFile(files.log, 'utf8').catch(() => '');
             const transcript = parseTranscript(logText, parseEventLine);
             const tools = toolCalls(logText, parseEventLine).slice(0, 200);
             return { transcript: { ...transcript, final: transcript.final ?? final }, tools, warnings };
         };
-        return { warm: false, text: () => reader.text(), done: go() };
+        return { text: () => reader.text(), done: go() };
     }
 }