@xcanwin/manyoyo 8.6.9 → 8.6.11

package/bin/manyoyo.js

@@ -26,6 +26,7 @@ const { listServeInstances, formatServeTable } = require('../lib/serve-instances
 const { pruneDanglingImages: pruneDanglingImagesSafely } = require('../lib/image-prune');
 const { runUninstall, readPid, defaultIsManyoyoServe, defaultKill } = require('../lib/uninstall');
 const appUpdate = require('../lib/app-update');
+const codeUpdate = require('../lib/code-update');
 const { getGithubFetch } = require('../lib/net-proxy');
 const { createUpdateChecker } = require('../lib/update-check');
 const { getLoginTokenDir, issueLoginToken } = require('../lib/login-token');
@@ -348,7 +349,7 @@ function installServeProcessDiagnostics(logger) {
  * @property {string[]} [volumes] - 挂载卷数组
  * @property {Object.<string, Object>} [plugins] - 可选插件配置映射（如 plugins.playwright）
  * @property {{title?:string}} [serve] - serve 命令专属配置（如自定义网页标题，留空字符串则显示为空）
- * @property {string} [agentInstructions] - 网页里执行 Agent 时追加给它的说明（接在内置环境说明后面；runs.<name> 可覆盖）
+ * @property {string} [agentInstructions] - 补充系统提示词（接在默认系统提示词后面，作为网页新建容器的初始内容；runs.<name> 可覆盖）
  * @property {Object.<string, Object>} [runs] - 运行配置映射（-r <name>）
  * @property {string} [yolo] - YOLO 模式
  * @property {string} [containerMode] - 容器模式
@@ -862,7 +863,36 @@ async function updateOfflineInstall(mode, options, globalConfig) {
     const installed = appUpdate.currentVersion(appRoot) || mode.version;
     console.log(`${CYAN}🔄 当前版本: ${installed}${NC}`);
     let result;
-    if (options.file) {
+    if (options.code) {
+        const github = getGithubFetch();
+        if (github.notice) console.log(`${CYAN}🌐 ${github.notice}${NC}`);
+        console.log(`${CYAN}🔄 正在查询分支 ${options.code} 的代码版...${NC}`);
+        try {
+            // MANYOYO_TEST_CODE_BASE 只给测试用（指向本地下载站替身）
+            const outcome = await codeUpdate.installCodeUpdate({
+                appRoot, branch: options.code, installed, fetchImpl: github.fetch, targetOs: appUpdate.platformOs(),
+                downloadBase: process.env.MANYOYO_TEST_CODE_BASE || undefined, log: line => console.log(`   ${line}`),
+                // 校验通过后、下载或切换之前先说清楚装的是哪个提交
+                onInfo: info => console.log(`${CYAN}   ${options.code}@${info.commit.slice(0, 7)} ${info.subject}（构建于 ${codeUpdate.formatBuiltAt(info.builtAt)}）${NC}`)
+            });
+            const label = `${options.code}@${outcome.info.commit.slice(0, 7)}`;
+            if (outcome.status === 'same') {
+                console.log(`${GREEN}✅ 已是 ${label}，无需更新${NC}`);
+                return;
+            }
+            if (outcome.status === 'same-release') {
+                console.log(`${GREEN}✅ ${label} 就是当前正式版 ${installed} 的代码，无需更新${NC}`);
+                return;
+            }
+            if (outcome.status === 'reused') console.log(`${CYAN}   使用本地已有的 ${outcome.version}，无需下载${NC}`);
+            result = outcome;
+        } catch (error) {
+            if (error instanceof appUpdate.UpdateError && error.code === 'NETWORK') {
+                error.message += `\n   ${github.proxy && github.proxy.proxyEnv ? `当前代理: ${github.proxy.display}，请确认代理可用` : '有代理的话先在终端设置: export https_proxy=http://127.0.0.1:7890'}`;
+            }
+            throw error;
+        }
+    } else if (options.file) {
         const info = appUpdate.parseAppFileName(options.file);
         if (info && appUpdate.compareVersions(info.version, installed) <= 0) {
             console.log(`${GREEN}✅ 已是最新版本 ${installed}${NC}`);
@@ -878,7 +908,7 @@ async function updateOfflineInstall(mode, options, globalConfig) {
             console.log(`${CYAN}🔄 正在查询最新版本...${NC}`);
             release = await appUpdate.fetchLatestRelease({ fetchImpl: github.fetch });
             if (appUpdate.compareVersions(release.version, installed) <= 0) {
-                console.log(`${GREEN}✅ 已是最新版本 ${installed}${NC}`);
+                console.log(`${GREEN}✅ ${codeUpdate.latestReleaseNotice(installed, release.version)}${NC}`);
                 return;
             }
             console.log(`${CYAN}⬇️  发现新版本 ${release.version}，只下载 manyoyo 本体（数十 MB）${NC}`);
@@ -938,6 +968,14 @@ async function updateOfflineInstall(mode, options, globalConfig) {
 }
 
 async function updateManyoyo(options = {}, globalConfig = {}) {
+    if (options.code && (options.file || options.rollback)) {
+        console.error(`${RED}❌ --code 不能同时使用 --file 或 --rollback。${NC}`);
+        process.exit(1);
+    }
+    if (options.code && !codeUpdate.isValidBranch(options.code)) {
+        console.error(`${RED}❌ 分支名不合法: ${String(options.code).slice(0, 60)}（只能用字母、数字、. _ - /，不能以符号开头，不能含 -- / .. / //）${NC}`);
+        process.exit(1);
+    }
     const mode = appUpdate.detectInstallMode({ scriptPath: __filename });
     if (mode.mode === 'offline') {
         try {
@@ -955,6 +993,10 @@ async function updateManyoyo(options = {}, globalConfig = {}) {
         console.error(`${RED}❌ --rollback 只适用于离线包安装；npm 安装的版本请用 npm install -g @xcanwin/manyoyo@<版本> 回退。${NC}`);
         process.exit(1);
     }
+    if (options.code) {
+        console.error(`${RED}❌ --code 只适用于离线包安装；npm 安装请用 npm install -g @xcanwin/manyoyo 升级。${NC}`);
+        process.exit(1);
+    }
     if (options.file) {
         console.error(`${RED}❌ --file 只适用于离线包安装；npm 安装请用 npm install -g @xcanwin/manyoyo 升级。${NC}`);
         process.exit(1);
@@ -1225,7 +1267,8 @@ https://github.com/xcanwin/manyoyo
         .description('升级到最新版本')
         .option('--rollback', '回到上一版本')
         .option('--file <path>', '安装手动下载的升级包（manyoyo-<版本>-<系统>-<架构>-app.tar.gz，同目录需有 SHA256SUMS）')
-        .action(options => selectAction('update', { update: true, rollback: Boolean(options.rollback), file: options.file || '' }));
+        .option('--code [branch]', '安装某个分支的最新代码版（未发布，默认 main）')
+        .action(options => selectAction('update', { update: true, rollback: Boolean(options.rollback), file: options.file || '', code: options.code === undefined ? '' : (options.code === true ? 'main' : options.code) }));
 
     program.command('uninstall')
         .helpGroup('日常:')

package/lib/agent-instructions.js

@@ -1,14 +1,16 @@
 'use strict';
 
-// Web 端执行 Agent 时追加给它的环境说明（唯一数据源）。
+// Web 端执行 Agent 时追加给它的系统提示词（唯一数据源）。
 // 只写环境事实、用条件句：不鼓励它主动生成或展示图片，也不重复模型本来就知道的事。
 const BUILTIN_AGENT_INSTRUCTIONS = [
-    '你的回复会显示在 MANYOYO 网页里（用户可能在手机上看），Markdown 会被渲染。',
+    '你的回复会显示在网页里（用户可能在手机上看），Markdown 会被渲染。',
     '- 需要让用户看某张图片时（如截图、生成的图表），用 Markdown 图片语法写容器内的绝对路径：![说明](/路径/图.png)，支持 png/jpg/jpeg/gif/webp/bmp/ico。没有必要时不要专门生成或展示图片。',
     '- 提到文件时写容器内的绝对路径，用户可以点开查看。'
 ].join('\n');
 
 const USER_INSTRUCTIONS_MAX_CHARS = 4000;
+// 容器的系统提示词 = 默认 + 补充，上限放宽
+const SYSTEM_PROMPT_MAX_CHARS = 8000;
 
 function pickUserInstructions(config, runName) {
     const source = config && typeof config === 'object' ? config : {};
@@ -22,18 +24,37 @@ function pickUserInstructions(config, runName) {
 
 // 去掉控制字符（保留换行、制表符）：codex 的 TOML 字符串不接受它们，也没有正当用途；
 // {prompt} 会被命令模板当成占位符替换，拆开写
-function sanitizeUserInstructions(text) {
+function sanitizeUserInstructions(text, max = USER_INSTRUCTIONS_MAX_CHARS) {
     return String(text || '')
         .replace(/\r\n?/g, '\n')
         .replace(/[\u0000-\u0008\u000b-\u001f\u007f]/g, '')
         .replace(/\{prompt\}/g, '{ prompt }')
         .trim()
-        .slice(0, USER_INSTRUCTIONS_MAX_CHARS);
+        .slice(0, max);
 }
 
-function buildAgentInstructions(config, runName) {
-    const extra = sanitizeUserInstructions(pickUserInstructions(config, runName));
-    return extra ? `${BUILTIN_AGENT_INSTRUCTIONS}\n\n${extra}` : BUILTIN_AGENT_INSTRUCTIONS;
+// 系统设置里两段各有开关（默认开）：默认系统提示词（内置）与补充系统提示词（agentInstructions）
+function pickEnabled(config, key) {
+    return !(config && typeof config === 'object' && config[key] === false);
+}
+
+// 默认系统提示词 + 补充系统提示词（按开关取用），新建容器时作为初始内容
+function composeSystemPrompt(config, runName) {
+    const parts = [];
+    if (pickEnabled(config, 'agentInstructionsBuiltinEnabled')) parts.push(BUILTIN_AGENT_INSTRUCTIONS);
+    const extra = pickEnabled(config, 'agentInstructionsCustomEnabled')
+        ? sanitizeUserInstructions(pickUserInstructions(config, runName))
+        : '';
+    if (extra) parts.push(extra);
+    return parts.length ? `${parts.join('\n\n')}\n` : '';
+}
+
+// 某个容器实际使用的系统提示词：容器自己存过就以它为准（enabled=false 即不注入），没存过（旧容器）用当前全局设置
+function buildAgentInstructions(config, runName, containerPrompt) {
+    if (containerPrompt && typeof containerPrompt === 'object') {
+        return containerPrompt.enabled === false ? '' : sanitizeUserInstructions(containerPrompt.text, SYSTEM_PROMPT_MAX_CHARS);
+    }
+    return sanitizeUserInstructions(composeSystemPrompt(config, runName), SYSTEM_PROMPT_MAX_CHARS);
 }
 
 // TOML 基本字符串：JSON 的转义（\" \\ \n \t \uXXXX）在 TOML 里含义相同；
@@ -45,6 +66,8 @@ function toTomlBasicString(text) {
 module.exports = {
     BUILTIN_AGENT_INSTRUCTIONS,
     buildAgentInstructions,
+    composeSystemPrompt,
     sanitizeUserInstructions,
+    SYSTEM_PROMPT_MAX_CHARS,
     toTomlBasicString
 };

package/lib/app-update.js

@@ -15,6 +15,12 @@ const WEB_BASE = 'https://github.com';
 // 不依赖 PATH 查找 tar（macOS 与常见 Linux 都在 /usr/bin）
 const TAR_COMMAND = fs.existsSync('/usr/bin/tar') ? '/usr/bin/tar' : 'tar';
 const VERSION_PATTERN = /^\d+\.\d+\.\d+$/;
+// app/ 下的目录名：正式版 x.y.z，或代码版 x.y.z+<提交前 7 位>（见 lib/code-update.js）
+const APP_VERSION_PATTERN = /^\d+\.\d+\.\d+(\+[0-9a-f]{7})?$/;
+
+function isAppVersion(value) {
+    return typeof value === 'string' && APP_VERSION_PATTERN.test(value);
+}
 const FETCH_TIMEOUT_MS = 15000;
 
 class UpdateError extends Error {
@@ -71,7 +77,7 @@ function detectInstallMode({ scriptPath, homeDir = os.homedir() }) {
     const relative = path.relative(appRoot, real);
     if (!relative.startsWith('..') && !path.isAbsolute(relative)) {
         const version = relative.split(path.sep)[0];
-        if (VERSION_PATTERN.test(version)) {
+        if (isAppVersion(version)) {
             return { mode: 'offline', appRoot, version };
         }
     }
@@ -190,14 +196,29 @@ function readUpdateRecord(appRoot) {
     }
 }
 
-// 只保留当前与上一版本，其它版本目录与残留的临时目录一起清掉
+// 只保留当前、上一版本和最新的正式版（连装几次代码版后仍能回到正式版），其它版本目录与残留的临时目录一起清掉
 function pruneApps(appRoot, keep) {
-    for (const name of fs.readdirSync(appRoot)) {
-        if (keep.includes(name) || name === 'current' || name === '.update.json') continue;
-        if (VERSION_PATTERN.test(name) || name.startsWith('.tmp-')) fs.rmSync(path.join(appRoot, name), { recursive: true, force: true });
+    const names = fs.readdirSync(appRoot);
+    const latestRelease = names.filter(name => VERSION_PATTERN.test(name)).sort((a, b) => compareVersions(b, a))[0];
+    for (const name of names) {
+        if (keep.includes(name) || name === latestRelease || name === 'current' || name === '.update.json') continue;
+        if (isAppVersion(name) || name.startsWith('.tmp-')) fs.rmSync(path.join(appRoot, name), { recursive: true, force: true });
     }
 }
 
+/**
+ * 切换 current 到 app/<version>/（目录必须已就位）、写 .update.json（记下上一版本）、清理旧版本。
+ * installFromArchive 与代码版的“本地已有就直接切换”共用；manifest 原样放进返回值，供调用方做收尾。
+ */
+function switchInstalled({ appRoot, version, manifest }) {
+    const previous = currentVersion(appRoot);
+    switchCurrent(appRoot, version);
+    writeUpdateRecord(appRoot, { previous: previous && previous !== version ? previous : readUpdateRecord(appRoot).previous || '', current: version, updatedAt: new Date().toISOString() });
+    const record = readUpdateRecord(appRoot);
+    pruneApps(appRoot, [version, record.previous].filter(Boolean));
+    return { version, previous: record.previous || '', manifest };
+}
+
 /**
  * 解开已校验过的 -app.tar.gz 并切换 current（网络下载与 --file 共用）。包不完整/内容不符都在切换前中止。
  */
@@ -226,11 +247,7 @@ async function installFromArchive({ appRoot, archive, version, targetArch, targe
         const target = path.join(appRoot, version);
         if (version !== previous) fs.rmSync(target, { recursive: true, force: true });
         if (version !== previous) fs.renameSync(staging, target);
-        switchCurrent(appRoot, version);
-        writeUpdateRecord(appRoot, { previous: previous && previous !== version ? previous : readUpdateRecord(appRoot).previous || '', current: version, updatedAt: new Date().toISOString() });
-        const record = readUpdateRecord(appRoot);
-        pruneApps(appRoot, [version, record.previous].filter(Boolean));
-        return { version, previous: record.previous || '', manifest };
+        return switchInstalled({ appRoot, version, manifest });
     } finally {
         fs.rmSync(staging, { recursive: true, force: true });
     }
@@ -306,9 +323,10 @@ function rollbackApp({ appRoot }) {
     const current = currentVersion(appRoot);
     const record = readUpdateRecord(appRoot);
     let previous = record.previous;
-    if (!previous || !VERSION_PATTERN.test(previous) || !fs.existsSync(path.join(appRoot, previous))) {
-        const candidates = fs.existsSync(appRoot) ? fs.readdirSync(appRoot).filter(name => VERSION_PATTERN.test(name) && name !== current && fs.existsSync(path.join(appRoot, name, 'manyoyo', 'bin', 'manyoyo.js'))) : [];
-        candidates.sort((a, b) => compareVersions(b, a));
+    if (!previous || !isAppVersion(previous) || !fs.existsSync(path.join(appRoot, previous))) {
+        const candidates = fs.existsSync(appRoot) ? fs.readdirSync(appRoot).filter(name => isAppVersion(name) && name !== current && fs.existsSync(path.join(appRoot, name, 'manyoyo', 'bin', 'manyoyo.js'))) : [];
+        // 版本相同（正式版与代码版）时正式版排前面
+        candidates.sort((a, b) => compareVersions(b, a) || (VERSION_PATTERN.test(b) ? 1 : 0) - (VERSION_PATTERN.test(a) ? 1 : 0));
         previous = candidates[0];
     }
     if (!previous) throw new UpdateError('NO_PREVIOUS', '没有可回滚的上一版本。');
@@ -386,6 +404,9 @@ module.exports = {
     UpdateError,
     parseVersion,
     compareVersions,
+    isAppVersion,
+    installFromArchive,
+    switchInstalled,
     detectInstallMode,
     fetchLatestRelease,
     parseSha256Sums,
@@ -394,6 +415,7 @@ module.exports = {
     installAppFile,
     parseAppFileName,
     networkError,
+    request,
     rollbackApp,
     currentVersion,
     describeRuntimeChange,

package/lib/code-update.js

@@ -0,0 +1,212 @@
+'use strict';
+
+// 代码版升级：`manyoyo update --code [分支]`。
+// 目标机器没有 git / npm，所以构建在 CI 里做（.github/workflows/code-packages.yml、scripts/offline/build-code.js），
+// 这里只下载 CODE.json → 校验 → 下载本机平台的 -app.tar.gz → SHA256 校验 → 复用 installFromArchive 切换 current。
+// 网络与副作用都从参数注入。CODE.json 来自网络，每个字段都严格校验：资产名要“等于”按提交与平台拼出的名字，不是匹配某个正则。
+
+const fs = require('fs');
+const os = require('os');
+const path = require('path');
+const appUpdate = require('./app-update');
+const { downloadVerified, sha256File } = require('./download-verified');
+
+const { UpdateError, compareVersions, networkError, request, installFromArchive, switchInstalled } = appUpdate;
+
+const DOWNLOAD_BASE = 'https://github.com/xcanwin/manyoyo/releases/download/';
+const BRANCH_PATTERN = /^[A-Za-z0-9][A-Za-z0-9._/-]{0,100}$/;
+const IMAGE_VERSION_PATTERN = /^\d+\.\d+\.\d+-[A-Za-z0-9][A-Za-z0-9_.-]*$/;
+const PLATFORMS = ['linux-x64', 'linux-arm64', 'macos-x64', 'macos-arm64'];
+const MAX_CODE_JSON_CHARS = 64 * 1024;
+const SUBJECT_MAX_CHARS = 200;
+
+function isValidBranch(branch) {
+    return typeof branch === 'string' && BRANCH_PATTERN.test(branch) && !branch.includes('--') && !branch.includes('..') && !branch.includes('//') && !branch.endsWith('/');
+}
+
+/** 分支 → 滚动预发布的 tag：code-<分支>，/ 换成 --（分支名不允许含 --，所以映射不会冲突）。CI 脚本与客户端共用。 */
+function codeTagForBranch(branch) {
+    if (!isValidBranch(branch)) {
+        throw new UpdateError('BAD_BRANCH', `分支名不合法: ${String(branch).slice(0, 60)}（只能用字母、数字、. _ - /，不能以符号开头，不能含 -- / .. / //）`);
+    }
+    return `code-${branch.replace(/\//g, '--')}`;
+}
+
+function codeAssetName(commit, targetOs, targetArch) {
+    return `manyoyo-code-${String(commit).slice(0, 7)}-${targetOs}-${targetArch}-app.tar.gz`;
+}
+
+function bad(message) {
+    return new UpdateError('BAD_CODE_INFO', `代码版信息（CODE.json）不合法：${message}，已中止。`);
+}
+
+/** 校验 CODE.json；返回规范化后的副本（subject 已清洗）。 */
+function validateCodeInfo(info, { branch }) {
+    if (!info || typeof info !== 'object' || Array.isArray(info)) throw bad('不是对象');
+    if (info.schemaVersion !== 1) throw bad('schemaVersion 不支持');
+    if (info.branch !== branch) throw bad(`分支不符（期望 ${branch}）`);
+    if (typeof info.commit !== 'string' || !/^[0-9a-f]{40}$/.test(info.commit)) throw bad('commit 格式不对');
+    if (typeof info.version !== 'string' || !/^\d+\.\d+\.\d+\+[0-9a-f]{7}$/.test(info.version) || !info.version.endsWith(`+${info.commit.slice(0, 7)}`)) throw bad('version 与 commit 不符');
+    if (typeof info.imageVersion !== 'string' || !IMAGE_VERSION_PATTERN.test(info.imageVersion)) throw bad('imageVersion 格式不对');
+    if (typeof info.imageReady !== 'boolean') throw bad('imageReady 必须是布尔值');
+    if (!info.assets || typeof info.assets !== 'object' || Array.isArray(info.assets)) throw bad('缺少 assets');
+    const assets = {};
+    for (const [key, asset] of Object.entries(info.assets)) {
+        if (!PLATFORMS.includes(key)) throw bad(`未知平台 ${key.slice(0, 40)}`);
+        const [targetOs, targetArch] = key.split('-');
+        if (!asset || typeof asset !== 'object') throw bad(`${key} 条目不是对象`);
+        if (asset.name !== codeAssetName(info.commit, targetOs, targetArch)) throw bad(`${key} 的文件名不符合命名规则`);
+        if (typeof asset.sha256 !== 'string' || !/^[0-9a-f]{64}$/.test(asset.sha256)) throw bad(`${key} 的 sha256 格式不对`);
+        if (!Number.isInteger(asset.size) || asset.size <= 0) throw bad(`${key} 的 size 不对`);
+        assets[key] = { name: asset.name, sha256: asset.sha256, size: asset.size };
+    }
+    // 只用于打印：去掉控制字符并截断
+    const subject = String(info.subject || '').replace(/[\u0000-\u001f\u007f-\u009f]/g, ' ').replace(/\s+/g, ' ').trim().slice(0, SUBJECT_MAX_CHARS);
+    return {
+        schemaVersion: 1, branch, commit: info.commit, subject, version: info.version,
+        imageVersion: info.imageVersion, imageReady: info.imageReady, builtAt: typeof info.builtAt === 'string' ? info.builtAt.slice(0, 40) : '', assets
+    };
+}
+
+function tagBase(downloadBase, branch) {
+    return `${downloadBase}${encodeURIComponent(codeTagForBranch(branch))}/`;
+}
+
+// notFoundRetryMs：CI 替换 CODE.json 时（gh 的 --clobber 是先删后传）有一小段时间它不存在，404 先等一下再确认一次
+async function fetchCodeInfo({ branch, fetchImpl = fetch, downloadBase = DOWNLOAD_BASE, notFoundRetryMs = 2000 }) {
+    const url = `${tagBase(downloadBase, branch)}CODE.json`;
+    let response = await request(fetchImpl, url, { headers: { Accept: 'application/json' } });
+    if (response.status === 404) {
+        await new Promise(resolve => setTimeout(resolve, notFoundRetryMs));
+        response = await request(fetchImpl, url, { headers: { Accept: 'application/json' } });
+    }
+    if (response.status === 404) {
+        throw new UpdateError('NO_CODE_BUILD', `分支 ${branch} 还没有代码版（也可能正在更新）。main 分支在推送后会自动构建（需要几分钟，稍后再试）；其他分支需要维护者手动触发构建。`);
+    }
+    if (!response.ok) throw new UpdateError('HTTP', `查询代码版信息失败（HTTP ${response.status}）。\n   地址: ${url}`, { url });
+    // 声明的长度就超限的，不读内容
+    if (Number(response.headers.get('content-length')) > MAX_CODE_JSON_CHARS) throw bad('内容过大');
+    let text;
+    try {
+        text = await response.text();
+    } catch (error) {
+        throw networkError(url, error, '读取中断，连不上');
+    }
+    if (text.length > MAX_CODE_JSON_CHARS) throw bad('内容过大');
+    let parsed;
+    try {
+        parsed = JSON.parse(text);
+    } catch (error) {
+        throw bad('不是合法的 JSON');
+    }
+    return validateCodeInfo(parsed, { branch });
+}
+
+// 当前版本的 manyoyo/package.json 里的 gitHead（正式包与代码版包构建时写入）；读不到或格式不对当作没有
+function readCurrentGitHead(appRoot) {
+    try {
+        const head = JSON.parse(fs.readFileSync(path.join(appRoot, 'current', 'manyoyo', 'package.json'), 'utf-8')).gitHead;
+        return typeof head === 'string' && /^[0-9a-f]{40}$/.test(head) ? head : '';
+    } catch (error) {
+        return '';
+    }
+}
+
+/**
+ * 本地 app/<版本>/ 已经是这个代码版时返回它的 manifest，否则 null（调用方照常下载，不报错）。
+ * --rollback 直接切到本地目录，所以这里的检查不能比它宽松：目录结构完整，并额外核对 manifest 与 .installed、提交号。
+ */
+async function findLocalCopy({ appRoot, info, targetArch, targetOs }) {
+    const dir = path.join(appRoot, info.version);
+    try {
+        for (const required of ['node/bin/node', 'manyoyo/bin/manyoyo.js', 'manifest.json', '.installed']) {
+            if (!fs.existsSync(path.join(dir, required))) return null;
+        }
+        const manifest = JSON.parse(fs.readFileSync(path.join(dir, 'manifest.json'), 'utf-8'));
+        if (!manifest || manifest.version !== info.version || manifest.kind !== 'app' || manifest.arch !== targetArch || manifest.os !== targetOs) return null;
+        if (!manifest.source || manifest.source.commit !== info.commit) return null;
+        // installFromArchive 安装时把 manifest.json 的哈希写进 .installed：对得上才说明目录没被动过
+        if (fs.readFileSync(path.join(dir, '.installed'), 'utf-8').trim() !== await sha256File(path.join(dir, 'manifest.json'))) return null;
+        return manifest;
+    } catch (error) {
+        return null;
+    }
+}
+
+// 构建时间按本机时区显示成 YYYY-MM-DD HH:mm；timeZone 可注入（测试不依赖运行机器的时区）
+function formatBuiltAt(builtAt, timeZone) {
+    const date = new Date(builtAt);
+    if (typeof builtAt !== 'string' || !builtAt || Number.isNaN(date.getTime())) return '未知时间';
+    const parts = Object.fromEntries(new Intl.DateTimeFormat('en-CA', { timeZone, year: 'numeric', month: '2-digit', day: '2-digit', hour: '2-digit', minute: '2-digit', hourCycle: 'h23' })
+        .formatToParts(date).map(part => [part.type, part.value]));
+    return `${parts.year}-${parts.month}-${parts.day} ${parts.hour}:${parts.minute}`;
+}
+
+/**
+ * 安装某个分支的代码版。installed 是当前版本号。
+ * 返回：{ status: 'same', info }（已是这个版本）、{ status: 'same-release', info }（与当前正式版同一个提交）、
+ * { status: 'reused' | 'installed', info, version, previous, manifest }（本地已有就直接切换 / 下载安装）。
+ * 校验失败 / 镜像未发布 / 版本更旧都在下载与切换之前中止，current 不变。
+ * onInfo(info)：全部校验通过后、下载或切换之前调用，让调用方先告诉用户装的是哪个提交。
+ */
+async function installCodeUpdate({ appRoot, branch, installed, fetchImpl = fetch, downloadBase = DOWNLOAD_BASE, notFoundRetryMs, onInfo, targetArch = appUpdate.arch(), targetOs = appUpdate.platformOs(), run, log = () => {}, tmpRoot = os.tmpdir() }) {
+    const info = await fetchCodeInfo({ branch, fetchImpl, downloadBase, notFoundRetryMs });
+    if (info.version === installed) return { status: 'same', info };
+    if (readCurrentGitHead(appRoot) === info.commit) return { status: 'same-release', info };
+    if (compareVersions(info.version, installed) < 0) {
+        throw new UpdateError('OLDER', `分支 ${branch} 的代码版是 ${info.version}，比当前的 ${installed} 旧。${branch} 的最新提交可能还在构建，稍后再试；要换回正式版请用 manyoyo update --rollback 或重新运行安装命令。`);
+    }
+    if (!info.imageReady) {
+        throw new UpdateError('IMAGE_NOT_READY', `这个代码版需要镜像 ${info.imageVersion}，但它还没有发布，现在升级会让容器拉不到镜像。请等镜像发布后再试，或换一个分支。`);
+    }
+    // 降级与镜像检查都排在本地复用之前，否则本地留着旧目录时会绕过它们
+    const local = await findLocalCopy({ appRoot, info, targetArch, targetOs });
+    const asset = info.assets[`${targetOs}-${targetArch}`];
+    if (!local && !asset) throw new UpdateError('NO_ASSET', `代码版 ${info.version} 里没有适合这台机器（${targetOs}-${targetArch}）的升级包。`);
+    if (typeof onInfo === 'function') onInfo(info);
+    if (local) return { status: 'reused', info, ...switchInstalled({ appRoot, version: info.version, manifest: local }) };
+    const url = `${tagBase(downloadBase, branch)}${asset.name}`;
+    // 包是按 CODE.json 里的固定命名拼出来的：先确认确实存在（404 就是没有）
+    const probe = await request(fetchImpl, url, { method: 'HEAD' });
+    if (probe.status === 404) throw new UpdateError('NO_ASSET', `代码版 ${info.version} 的升级包 ${asset.name} 还没有上传完整，请稍后再试。`);
+
+    const workDir = fs.mkdtempSync(path.join(tmpRoot, 'manyoyo-code-update-'));
+    try {
+        const archive = path.join(workDir, asset.name);
+        try {
+            // 服务端声明的大小与 CODE.json 不符就直接中止，不把磁盘写满再校验哈希
+            const guarded = async (target, options) => {
+                const response = await request(fetchImpl, target, { ...options, noTimeout: true });
+                const declared = response.headers.get('content-length');
+                if (response.ok && declared !== null && Number(declared) !== asset.size) {
+                    // status 让 downloadVerified 当作明确的拒绝，不做重试
+                    throw new UpdateError('CHECKSUM', `代码版升级包大小与 CODE.json 不符（${declared} ≠ ${asset.size}），已中止升级，当前版本不受影响。`, { status: response.status });
+                }
+                return response;
+            };
+            await downloadVerified({ url, sha256: asset.sha256, dest: archive, fetchImpl: guarded, log });
+        } catch (error) {
+            if (/SHA256 校验失败/.test(error.message)) throw new UpdateError('CHECKSUM', '代码版升级包 SHA256 校验失败，已中止升级，当前版本不受影响。');
+            if (error instanceof UpdateError) throw error;
+            throw networkError(url, error, '下载中断，连不上');
+        }
+        const result = await installFromArchive({ appRoot, archive, version: info.version, targetArch, targetOs, run });
+        return { status: 'installed', info, ...result };
+    } finally {
+        fs.rmSync(workDir, { recursive: true, force: true });
+    }
+}
+
+function isCodeVersion(version) {
+    return typeof version === 'string' && /^\d+\.\d+\.\d+\+[0-9a-f]{7}$/.test(version);
+}
+
+/** 普通 `update` 发现最新正式版不比当前新时说的话：代码版要特别说明怎么换回正式版。 */
+function latestReleaseNotice(installed, latest) {
+    if (isCodeVersion(installed)) {
+        return `当前是代码版 ${installed}，最新正式版 ${latest} 不比它新。要换回正式版，请重新运行安装命令（或 manyoyo update --rollback 回到上一个版本）。`;
+    }
+    return `已是最新版本 ${installed}`;
+}
+
+module.exports = { formatBuiltAt, isCodeVersion, latestReleaseNotice, DOWNLOAD_BASE, isValidBranch, codeTagForBranch, codeAssetName, validateCodeInfo, fetchCodeInfo, installCodeUpdate };

package/lib/container-state.js

@@ -48,7 +48,8 @@ function paths(homeDir, id) {
         envFiles: path.join(dir, 'env-files.json'),
         network: path.join(dir, 'network.json'),
         netStatus: path.join(dir, 'net-status.json'),
-        meta: path.join(dir, 'meta.json')
+        meta: path.join(dir, 'meta.json'),
+        systemPrompt: path.join(dir, 'system-prompt.json')
     };
 }
 
@@ -153,6 +154,7 @@ function writeFileAtomic(filePath, data, mode = 0o600) {
  * @param {string} [options.id]
  * @param {string[]} [options.envLines] KEY=VALUE（已校验）
  * @param {string} [options.autostart] 自启动脚本
+ * @param {{enabled: boolean, text: string}} [options.systemPrompt] 系统提示词
  * @param {object} [options.meta]
  * @param {boolean} [options.netRequired]
  * @param {object} [options.network] 已校验的网络策略（见 lib/network-policy.js）
@@ -178,6 +180,7 @@ function createState(options) {
     if (!fs.existsSync(p.managedEnv)) writeFileAtomic(p.managedEnv, '');
     setNetRequired(homeDir, id, Boolean(options.netRequired));
     if (options.network) writeNetworkRaw(homeDir, id, options.network);
+    if (options.systemPrompt) writeFileAtomic(p.systemPrompt, `${JSON.stringify({ enabled: options.systemPrompt.enabled !== false, text: String(options.systemPrompt.text || '') })}\n`);
     writeMeta(homeDir, id, { id, createdAt: new Date().toISOString(), ...(options.meta || {}) });
     return { id, ...p };
 }
@@ -398,6 +401,21 @@ function writeNetStatus(homeDir, id, status) {
     writeFileAtomic(paths(homeDir, id).netStatus, `${JSON.stringify(status)}\n`);
 }
 
+// 容器自己的系统提示词 {enabled, text}：创建时定下，之后只能在容器设置里改；没有文件（旧容器）返回 null
+function readSystemPrompt(homeDir, id) {
+    try {
+        const data = JSON.parse(fs.readFileSync(paths(homeDir, id).systemPrompt, 'utf-8'));
+        return { enabled: data.enabled !== false, text: typeof data.text === 'string' ? data.text : '' };
+    } catch (e) {
+        return null;
+    }
+}
+
+function writeSystemPrompt(homeDir, id, prompt) {
+    assertStateExists(homeDir, id);
+    writeFileAtomic(paths(homeDir, id).systemPrompt, `${JSON.stringify({ enabled: prompt.enabled !== false, text: String(prompt.text || '') })}\n`);
+}
+
 function removeState(homeDir, id) {
     if (!isValidId(id)) return false;
     fs.rmSync(stateDir(homeDir, id), { recursive: true, force: true });
@@ -456,6 +474,8 @@ module.exports = {
     readAutostartLogTail,
     writeManagedEnv,
     readMeta,
+    readSystemPrompt,
+    writeSystemPrompt,
     writeMeta,
     readNetworkRaw,
     writeNetworkRaw,

package/lib/setup-config.js

@@ -34,4 +34,8 @@ function buildAgentInstructionsConfigRaw(baseRaw, text) {
     return upsertValueByPath(baseRaw, ['agentInstructions'], JSON.stringify(String(text || '')));
 }
 
-module.exports = { EMPTY_CONFIG_RAW, baseRawOf, buildAgentConfigRaw, buildPasswordConfigRaw, shouldWriteMirrors, buildMirrorsConfigRaw, buildAgentInstructionsConfigRaw };
+function buildBooleanConfigRaw(baseRaw, key, value) {
+    return upsertValueByPath(baseRaw, [key], value ? 'true' : 'false');
+}
+
+module.exports = { buildBooleanConfigRaw, EMPTY_CONFIG_RAW, baseRawOf, buildAgentConfigRaw, buildPasswordConfigRaw, shouldWriteMirrors, buildMirrorsConfigRaw, buildAgentInstructionsConfigRaw };

package/lib/web/AGENTS.md

@@ -30,7 +30,7 @@
 - **终端 WebSocket**：`/api/sessions/:name/terminal/ws`，在 `server.on('upgrade')` 里做 Origin 校验 + 认证 + 容器名校验，再交给 `bindTerminalWebSocket()`。上行 `input` / `resize` / `ping` / `close`，下行 `output` / `status`（`ready` / `closed`）/ `error` / `pong`；实现是 `docker exec` 里用 `script` 或 python `pty` 引导出的伪 TTY。**动态 resize**：bootstrap 的 rc 把 `tty` 输出写进容器里 `/tmp/manyoyo-term-<随机id>.tty`；收到 `resize` 后（整数、10～500 列、4～200 行，否则整条忽略；下限比建连初值 40×12 低，因为手机竖屏不到 40 列；节流，同一时刻只有一个 exec）用固定脚本 `TERMINAL_RESIZE_SCRIPT` 在容器里读该文件，内容必须整行匹配 `/dev/pts/<数字>` 才执行 `stty -F`。**这个 tty 文件容器里的进程可写，只能当不可信输入**（脚本只认普通文件、不跟符号链接、最多读 64 字节），用例见 `test/web-terminal-resize.test.js`。降级成非 TTY 时 resize 自然无效。并发上限 `WEB_TERMINAL_MAX_SESSIONS = 20`，每条连接对应一个 `ptyProcess`，`ws` 关闭即 `SIGTERM`——所以前端任何「卸载终端组件」的改动都等于杀掉用户正在跑的 shell。
 - 空闲保活是 `/agent/stream` 那条心跳规则的同类问题，**两个入口都要守**：终端侧服务端每 `WEB_TERMINAL_PING_INTERVAL_MS`（30s）发 WebSocket ping 帧，连续 `WEB_TERMINAL_MAX_MISSED_PONGS`（3 次，约 90s）无 pong 才判死；前端另发应用层 `ping`（浏览器 JS 发不出 ping 帧，上行需要自己造流量）。判死阈值不要收紧到一个周期：手机切后台会让连接短暂挂起，误杀等于用户的 shell 没了。升级后的 socket 还要 `setTimeout(0)` + `setKeepAlive`，解除 HTTP 侧空闲超时。
 - 新增接口/页面必须走全局认证网关，禁止在业务路由里零散补认证；匿名白名单见根 `AGENTS.md` 的安全约束。
-- **环境说明**（`lib/agent-instructions.js` 唯一数据源，`buildWebAgentExecCommand` 的 `options.instructions`）：每次执行时现读配置（`runs.<快照里的 run 名>.agentInstructions` > 全局），claude 用 `--append-system-prompt`、codex 用 `-c developer_instructions=<TOML 字符串>`、opencode 把说明写进容器 `/tmp/manyoyo-agent-instructions.md` 再经 `OPENCODE_CONFIG_CONTENT` 合并（1.19.3 实测与用户的 instructions 拼接）；gemini 只有 `GEMINI_SYSTEM_MD` 这种整体替换，不注入。用户模板里已有同名参数 / 变量就不注入；用户追加的文本去控制字符、把 `{prompt}` 拆开（否则会被模板替换成提示词）。CLI 的 `manyoyo run` 是交互终端，不注入。
+- **系统提示词**（`lib/agent-instructions.js` 唯一数据源，`buildWebAgentExecCommand` 的 `options.instructions`）：全局配置（`agentInstructions` + 两个 `agentInstructions{Builtin,Custom}Enabled` 开关，`composeSystemPrompt`）只决定**新建容器时的初始内容**；创建时（请求 `systemPrompt:{enabled,text}`，没给就现算）存进容器状态目录 `system-prompt.json`，之后只能经 `/api/containers/:name/system-prompt` 改，改系统设置不影响已有容器。每次执行时读该容器的文件（`readContainerSystemPrompt`），旧容器没有文件就退回按当前全局配置现算；claude 用 `--append-system-prompt`、codex 用 `-c developer_instructions=<TOML 字符串>`、opencode 把说明写进容器 `/tmp/manyoyo-agent-instructions.md` 再经 `OPENCODE_CONFIG_CONTENT` 合并（1.19.3 实测与用户的 instructions 拼接）；gemini 只有 `GEMINI_SYSTEM_MD` 这种整体替换，不注入。用户模板里已有同名参数 / 变量就不注入；用户追加的文本去控制字符、把 `{prompt}` 拆开（否则会被模板替换成提示词）。CLI 的 `manyoyo run` 是交互终端，不注入。
 - **会话标题**：claude 交互模式写 `ai-title`、`/rename` 写 `custom-title`（优先），**`-p` 下实测不生成 `ai-title`**（2.1.290，3 轮）。每轮结束后 `refreshWebAgentTitle` 在后台只读会话 jsonl 尾部 256KB（session id 按 UUID 校验），失败静默不写日志；`firstPrompt` 在第一次追加 Agent 用户消息时记下（历史会被裁剪，不能现算）。这些字段与 `pinned`、`slashCommands` 都要同时加进 `createEmptyWebAgentSession` 和 `normalizeWebAgentSessionRecord`，否则落盘丢失。
 - **斜杠命令候选**（`GET .../slash-commands`）：来自 claude 每次运行 init 事件的 `slash_commands` / `skills` / `terminal_slash_commands`，只列 skill 和 `HEADLESS_BUILTIN_COMMANDS`（`-p` 下逐个实测过；`compact` 在 `-p` 下不压缩，别加回去）。
 - **改动视图**（`lib/web/git-changes.js`，`GET .../git/changes`、`.../git/diff?path=`）：按需执行、不轮询；仓库和 git 配置由容器控制，命令里关掉外部 diff / textconv / fsmonitor、`GIT_OPTIONAL_LOCKS=0`、输出有上限；diff 的 path 必须出现在服务端重新取的改动列表里，`-` 开头和换行 / NUL 一律拒绝。

package/lib/web/container-manage.js

@@ -10,6 +10,7 @@ const { envUrlDomains } = require('../network-endpoints');
 const { egressPaths } = require('../egress-sidecar');
 const deniedLib = require('../egress-denied');
 const { isBrowserBackground } = require('../browser-background');
+const { composeSystemPrompt, SYSTEM_PROMPT_MAX_CHARS } = require('../agent-instructions');
 
 // 容器管理接口：环境变量、自启动、网络（含端口暴露）、孤儿状态目录。
 // 全部挂在全局认证网关之后；非只读请求由 handleWebApi 统一校验 X-Requested-With。
@@ -124,6 +125,13 @@ function createContainerManageRoutes({ ctx, state, req, res, deps }) {
         }
     }
 
+    function currentSystemPrompt(id) {
+        const saved = state_.readSystemPrompt(homeDir, id);
+        if (saved) return saved;
+        const snapshot = deps.readConfig ? deps.readConfig() : {};
+        return { enabled: true, text: composeSystemPrompt(snapshot, '') };
+    }
+
     function readPolicy(id) {
         return normalizePolicy(state_.readNetworkRaw(homeDir, id) || undefined);
     }
@@ -453,6 +461,31 @@ function createContainerManageRoutes({ ctx, state, req, res, deps }) {
                 });
             }
         },
+        {
+            // 容器自己的系统提示词：创建时定下，之后只在这里改；旧容器没存过时显示按系统设置现算的内容
+            method: 'GET',
+            match: p => p.match(/^\/api\/containers\/([^/]+)\/system-prompt$/),
+            handler: async match => {
+                const target = resolveTarget(match[1]);
+                if (!target) return;
+                sendJson(res, 200, { legacy: false, id: target.id, ...currentSystemPrompt(target.id) });
+            }
+        },
+        {
+            method: 'PUT',
+            match: p => p.match(/^\/api\/containers\/([^/]+)\/system-prompt$/),
+            handler: async match => {
+                const target = resolveTarget(match[1], { write: true });
+                if (!target) return;
+                const body = await readJsonBody(req);
+                if (typeof body.text !== 'string' || typeof body.enabled !== 'boolean') {
+                    sendJson(res, 400, { error: '需要 enabled（布尔）和 text（字符串）' });
+                    return;
+                }
+                state_.writeSystemPrompt(homeDir, target.id, { enabled: body.enabled, text: body.text.slice(0, SYSTEM_PROMPT_MAX_CHARS) });
+                sendJson(res, 200, { legacy: false, id: target.id, ...currentSystemPrompt(target.id) });
+            }
+        },
         {
             method: 'POST',
             match: p => p.match(/^\/api\/containers\/([^/]+)\/autostart\/run$/),