diff --git a/app/AGENTS.md b/app/AGENTS.md index cf82cb6..9a2f619 100644 --- a/app/AGENTS.md +++ b/app/AGENTS.md @@ -223,12 +223,16 @@ IM 用户在实时对话,回合中插话应当“当前这步跑完就插” `disable` 连 `tools/list` 都不发。旧字段 `enable` 已废弃,`mode: silent` 已移除, 出现即报配置错(不静默忽略)。 - `executeTool(baseCtx, name, args)`:先查 `HANDLERS` 表,未命中再交给 MCP 注册表。 - `ctx = {sessionId, taskDir, run, cfg, db, vision}`;工具返回字符串,`read_file` 读图时返回 + `ctx = {sessionId, taskDir, workDir, run, cfg, db, vision}`;工具返回字符串,`read_file` 读图时返回 `{text, image_rel}`(`text` 是结构化 JSON 回执,由 engine 转成 `image_ref` 块)。 + `workDir` = 会话手选的工作目录(本地端新建会话可选),空串时 `taskDir` 就是默认的 + `workspace_root/<会话id>`。 - **路径沙箱**:所有路径经 `resolveInTask` 解析到 `taskDir` 内;`/tmp` 会被映射到 `/.tmp`(与 executor 容器里 `/tmp` 的 bind 对齐)。符号链接越界一律拒绝。 例外:`AGENT_FILE_SCOPE=workspace`(本地端 `local/start.sh` 注入)把业务工具的根放宽到 `workspace_root`,且 `/tmp` 不重写、直接放行(本地 terminal 写的是真 `/tmp`); + 会话若手选了目录(`sessions.work_dir` 非空),业务工具与文件 API 的根都取那个真实目录 + (`fsRoot` 优先返回 `ctx.workDir`),且不再创建 `task-*` 子目录; 路由层(文件 API / 公网短链 / data-page)与 `@会话` 仍按 `taskDir` 校验,不随之外扩。 - **跨会话只读**:`@/` 只允许 `list_directory`、`read_file`、`copy_path` 的 `source_path`,且只限同一用户的会话。写侧显式拒绝——否则会造出字面 `@task-x` 目录。 diff --git a/app/server/db.js b/app/server/db.js index edd89ce..0326c81 100644 --- a/app/server/db.js +++ b/app/server/db.js @@ -231,6 +231,9 @@ function initDb(dbPath) { // 迁移:title_locked 用户手动重命名过标题(renameSession 置 1):显式留痕「名字是用户起的」, // 不得静默冲掉;清空会话时随标题一并复位(旧名字已文不对题)。 if (!cols.some(c => c.name === 'title_locked')) db.exec("ALTER TABLE sessions ADD COLUMN title_locked INTEGER NOT NULL DEFAULT 0"); + // 迁移:会话级工作目录(本地桌面端新建会话时手选一个真实目录)。空串 = 沿用 + // workspace_root/<会话id>;服务器形态永远为空,行为与旧版完全一致(见 engine.taskDirOf)。 + if (!cols.some(c => c.name === 'work_dir')) db.exec("ALTER TABLE sessions ADD COLUMN work_dir TEXT NOT NULL DEFAULT ''"); // 迁移:wechat_bindings 补 deep_think 列——微信端全局深度思考开关(routes/channel.js /think 读写, // 投递时作为既有 deepThink 参数的取值来源);默认 0=关(与 H5 按钮初始态一致,/think on 手动开)。 // 旧库若曾按 DEFAULT 1 补过列(当时默认开,存量行都是默认值回填而非用户显式选择), diff --git a/app/server/engine.js b/app/server/engine.js index f21d989..d6bf4b2 100644 --- a/app/server/engine.js +++ b/app/server/engine.js @@ -53,8 +53,41 @@ function genTaskId() { return id; } +// 会话级工作目录:本地桌面端新建会话时可手选一个真实目录(DB 列 work_dir,见 db.js 迁移)。 +// 空串 = 沿用 workspace_root/<会话id>,服务器形态永远走这条,行为与 v2.5.0 完全一致。 +// 用缓存的 prepared statement:taskDirOf 在文件 API / 工具链里被高频调用,每次现 prepare 没必要。 +let stmtWorkDir = null; +function sessionWorkDir(sessionId) { + try { + if (!stmtWorkDir) stmtWorkDir = db.prepare('SELECT work_dir FROM sessions WHERE id = ?'); + const row = stmtWorkDir.get(sessionId); + return String((row && row.work_dir) || ''); + } catch (_) { return ''; } +} + function taskDirOf(sessionId) { - return path.join(cfg.workspace_root, sessionId); + return sessionWorkDir(sessionId) || path.join(cfg.workspace_root, sessionId); +} + +// 校验并归一化「手选工作目录」:必须已存在的真实目录(不替用户 mkdir),且不能是根目录 / +// 或平台数据目录——后者存着 SQLite(.agent.db)和 prompt dump,让会话目录指过去等于让 AI +// 直接动运行数据库。用户主目录/Linux 根下子目录不拦(本地模式本来就没沙箱,README 已提示 +// 选专用目录),但选到根目录本身无意义。 +function normalizeWorkDir(input) { + const raw = String(input || '').trim(); + if (!raw) return ''; + if (!path.isAbsolute(raw)) throw Object.assign(new Error('工作目录必须是绝对路径:' + raw), { status_code: 400 }); + let real; + try { real = fs.realpathSync(raw); } catch (_) { throw Object.assign(new Error('工作目录不存在:' + raw), { status_code: 400 }); } + let st; + try { st = fs.statSync(real); } catch (_) { throw Object.assign(new Error('工作目录不可访问:' + raw), { status_code: 400 }); } + if (!st.isDirectory()) throw Object.assign(new Error('不是目录:' + raw), { status_code: 400 }); + if (real === path.parse(real).root) throw Object.assign(new Error('不能把根目录作为工作目录'), { status_code: 400 }); + const dataRoot = String(cfg.data_root || ''); + if (dataRoot && (real === dataRoot || real.startsWith(dataRoot + path.sep))) { + throw Object.assign(new Error('不能选择平台数据目录作为工作目录'), { status_code: 400 }); + } + return real; } function getSession(sessionId) { @@ -842,7 +875,7 @@ async function runLoopInner(sessionId, run) { isError = true; } else { try { - output = await executeTool({ sessionId, taskDir: taskDirOf(sessionId), run, cfg, db, vision, + output = await executeTool({ sessionId, taskDir: taskDirOf(sessionId), workDir: sessionWorkDir(sessionId), run, cfg, db, vision, onTaskCreated: () => { run.taskWrap = true; }, onCard: (card) => bus.emit(sessionId, 'ui_card', card), onDeepThink: (info) => { const m = (cfg.models || []).find(x => x.id === session.model_id); @@ -1116,7 +1149,7 @@ function sleep(ms) { return new Promise(r => setTimeout(r, ms)); } // ---------- 对外 API ---------- // 新建即绑模(无排队):指定了优先模型(welcome 预选)就取其平台「最不 active」的 key; // 模型无效或平台无槽位退回全局优先级选。池完全为空直接报错(配置问题),不建吊儿郎当的会话。 -function createSession(title, preferModelId, assistantType, user) { +function createSession(title, preferModelId, assistantType, user, workDir) { // 用户锁定模型(auth.users[].model)优先于前端预选;锁定值无效/被禁用时退回原逻辑(用前端预选或全局自动选择)。 const lock = lockedModelOf(user); const lockValid = !!lock && platformModels(platformOf(lock)).includes(lock); @@ -1137,11 +1170,14 @@ function createSession(title, preferModelId, assistantType, user) { if (!modelId) throw Object.assign(new Error('无可用模型:请检查配置并重启服务'), { status_code: 503 }); } const id = genTaskId(); - const dir = taskDirOf(id); - fs.mkdirSync(dir, { recursive: true }); + // 手选目录:直接当作会话工作目录(不建 task-* 子目录);未选 = 老行为,在 workspace_root 下按 id 建档。 + // 选中的目录必须已存在(normalizeWorkDir 已校验),绝不在用户目录里替它 mkdir。 + const wd = normalizeWorkDir(workDir); + const dir = wd || path.join(cfg.workspace_root, id); + if (!wd) fs.mkdirSync(dir, { recursive: true }); db.prepare( - "INSERT INTO sessions (id, title, status, model_id, model_slot, last_model_id, held_at, assistant_type, user, created_at, updated_at) VALUES (?,?,'held',?,?,?,?,?,?,?,?)" - ).run(id, title || '', modelId, key.id, modelId, now(), assistantType || 'secretary', user || '', now(), now()); + "INSERT INTO sessions (id, title, status, model_id, model_slot, last_model_id, held_at, assistant_type, user, work_dir, created_at, updated_at) VALUES (?,?,'held',?,?,?,?,?,?,?,?,?)" + ).run(id, title || '', modelId, key.id, modelId, now(), assistantType || 'secretary', user || '', wd, now(), now()); db.prepare('UPDATE model_pool SET last_used_at = ? WHERE id = ?').run(now(), key.id); profile.freezeSnapshot(db, id); // 冻结画像快照:仅创建/清空时点注入,会话内恒定(见 user-profile.js) // 新建会话默认走模型配置的 profile(未配 = 全量默认组合 + profile-default.txt),不再有顾问阶段 @@ -1358,6 +1394,9 @@ function renameSession(sessionId, title) { function deleteSession(sessionId, deleteDir) { const session = getSession(sessionId); if (!session) throw Object.assign(new Error('会话不存在'), { status_code: 404 }); + // 删行前先取目录:行没了 taskDirOf 会退回默认路径,且手选目录根本不归平台管。 + const sessionDir = taskDirOf(sessionId); + const ownWorkDir = String(session.work_dir || ''); stop(sessionId); // 尽力清理该会话在 executor 侧的预览槽(officecli 预览已迁 executor/preview.js;未配 executor 静默,失败只记日志不阻断删除) try { rexec.killPreviewSession(cfg, sessionId); } catch (_) {} @@ -1367,8 +1406,10 @@ function deleteSession(sessionId, deleteDir) { const frags = memory.dropFragment(db, sessionId); // 日记随会话一并销毁:删掉的会话不该还活在长期记忆里 if (frags) log.info('task', sessionId + ' 连带删除日记碎片 ' + frags + ' 条'); autoCompressProposed.delete(sessionId); // 提议闸门随会话销毁 - if (deleteDir) { - try { fs.rmSync(taskDirOf(sessionId), { recursive: true, force: true }); } catch (_) {} + if (deleteDir && !ownWorkDir) { + // 只删平台自己建的会话目录(workspace_root/<会话id>)。手选工作目录是用户的资产, + // 多个会话可以共用同一个目录,删会话绝不能连带删用户的项目。 + try { fs.rmSync(sessionDir, { recursive: true, force: true }); } catch (_) {} } bus.closeAll(sessionId); return { ok: true }; diff --git a/app/server/public/css/style.css b/app/server/public/css/style.css index adbb53d..ed35024 100644 --- a/app/server/public/css/style.css +++ b/app/server/public/css/style.css @@ -127,6 +127,61 @@ main { flex: 1; min-height: 0; display: flex; flex-direction: column; } gap: 14px; } +/* 本地端:新建会话手选工作目录(服务器形态由 JS 整块隐藏)。 */ +.welcome-dir { + margin-top: 18px; + max-width: min(90vw, 560px); + display: inline-flex; + align-items: center; + gap: 6px; + padding: 6px 10px; + border: 1px solid var(--border); + border-radius: 999px; + background: var(--surface); + font-size: 13px; + color: var(--ink); +} +.welcome-dir-cap { flex: 0 0 auto; opacity: .6; } +.welcome-dir-pick { + min-width: 0; + display: inline-flex; + align-items: center; + gap: 6px; + margin: 0; + padding: 0; + border: 0; + background: none; + color: inherit; + font: inherit; + cursor: pointer; +} +.welcome-dir-pick:disabled { opacity: .6; cursor: default; } +.welcome-dir-pick .ic { flex: 0 0 auto; color: var(--active); } +.welcome-dir-path { + max-width: 44ch; + overflow: hidden; + text-overflow: ellipsis; + white-space: nowrap; +} +.welcome-dir.is-set .welcome-dir-path { color: var(--active); } +.welcome-dir-clear { + flex: 0 0 auto; + width: 18px; + height: 18px; + padding: 0; + border: 0; + border-radius: 50%; + background: none; + color: var(--ink); + opacity: .5; + cursor: pointer; + display: inline-flex; + align-items: center; + justify-content: center; +} +.welcome-dir-clear:hover { opacity: 1; background: var(--border); } +.welcome-dir-clear .ic { width: 12px; height: 12px; } + /* ---------- 对话状态:对话内容区 ---------- */ /* overflow-x 显式 hidden:overflow-y:auto 会把 visible 的 overflow-x 计算成 auto, 宽代码块/表格自带横向滚动,不该再让消息流整体横向溢出 */ diff --git a/app/server/public/index.html b/app/server/public/index.html index 87a26b4..813677b 100644 --- a/app/server/public/index.html +++ b/app/server/public/index.html @@ -151,6 +151,18 @@
随时开始吧
+ + diff --git a/app/server/public/js/sessions.js b/app/server/public/js/sessions.js index e20e7a6..b2ef413 100644 --- a/app/server/public/js/sessions.js +++ b/app/server/public/js/sessions.js @@ -231,7 +231,7 @@ // welcome 经弹窗预选的模型在这里兑现:model_id 建档透传。 async function ensureSession() { if (state.sessionId) return state.sessionId; - const s = await req('POST', '/api/sessions', { title: '', model_id: state.pendingModel || '', assistant_type: state.mode }); + const s = await req('POST', '/api/sessions', { title: '', model_id: state.pendingModel || '', assistant_type: state.mode, work_dir: pendingWorkDir || undefined }); state.sessionId = s.id; state.sessionTitle = (s && s.title) || ''; state.sessionType = (s && s.assistant_type) || state.mode; @@ -243,6 +243,49 @@ return s.id; } + // ---------- 本地端:新建会话时手选工作目录 ---------- + // 只在 local/ 启动器(AGENT_LOCAL_PICK=1)下可用:探测 /api/local/info,拿不到就把整条 + // chip 隐藏,服务器形态完全看不见这个入口。选择只暂存在前端,真正建档时随 + // POST /api/sessions 提交一次;不选 = work_dir 空串 = 老行为(workspace_root/<会话id>)。 + let pendingWorkDir = ''; + + function renderWelcomeDir() { + const pathEl = $('welcome-dir-path'); + if (!pathEl) return; + const chip = $('welcome-dir'); + pathEl.textContent = pendingWorkDir || '默认(工作区内)'; + pathEl.title = pendingWorkDir || '默认:每个会话在系统工作目录下单独建档'; + chip.classList.toggle('is-set', !!pendingWorkDir); + $('welcome-dir-clear').classList.toggle('hidden', !pendingWorkDir); + } + + async function pickWelcomeDir() { + const btn = $('welcome-dir-pick'); + if (btn.disabled) return; + btn.disabled = true; + try { + // 超时给足 130s:后端对话框上限 120s,这里多留余量,别让前端先断 + const r = await req('POST', '/api/local/pick-dir', {}, false, 130000); + if (r && r.path) { pendingWorkDir = r.path; renderWelcomeDir(); } + } catch (e) { + toast('选择目录失败:' + e.message); + } finally { + btn.disabled = false; + } + } + + (function initWelcomeDir() { + const chip = $('welcome-dir'); + if (!chip) return; + req('GET', '/api/local/info').then(info => { + if (!info || !info.enabled) return; + chip.classList.remove('hidden'); + renderWelcomeDir(); + }).catch(() => { /* 服务器形态:接口 404,整条隐藏 */ }); + $('welcome-dir-pick').addEventListener('click', pickWelcomeDir); + $('welcome-dir-clear').addEventListener('click', () => { pendingWorkDir = ''; renderWelcomeDir(); }); + })(); + function newChat() { closeStream(); removeTyping(); @@ -257,6 +300,8 @@ renderSendQueue(); state.pendingModel = ''; state.attachments = []; + pendingWorkDir = ''; // 新建会话把上次手选的工作目录也归零(回到默认) + renderWelcomeDir(); if (typeof clearEditState === 'function') clearEditState(); state.streamEl = null; state.streamText = ''; diff --git a/app/server/routes/local.js b/app/server/routes/local.js new file mode 100644 index 0000000..1b0b1cc --- /dev/null +++ b/app/server/routes/local.js @@ -0,0 +1,76 @@ +// 本地桌面端(local/ 启动器)专用:唤起系统原生目录选择器。 +// 只在 AGENT_LOCAL_PICK=1 时挂载(见 server.js),服务器形态根本不加载本文件。 +// +// 为什么必须走后端:浏览器拿不到本机目录的绝对路径( 只给相对名), +// 要真实路径只能调系统对话框。必须 execFile 异步——同步执行会阻塞事件循环,所有会话的 SSE +// 都会卡住,直到用户关掉对话框。用户取消不是错误,回 { path: '' }; +// 其它失败(无对话框、权限被拒、超时)要带原因回给前端,别让用户以为是自己取消了。 +const express = require('express'); +const os = require('os'); +const { execFile } = require('child_process'); +const engine = require('../engine'); + +const router = express.Router(); + +function sendErr(res, err) { + const code = (err && err.status_code) || 500; + res.status(code).json({ error: String((err && err.message) || err) }); +} + +// 各平台可用的对话框后端。mac 用 osascript;Linux 依次试 zenity / kdialog。 +// cancelRe / cancelExit 区分「用户取消」和「真失败」: +// osascript 取消时 stderr 是 "User canceled. (-128)",别的报错(如自动化权限被拒)不能当取消; +// zenity/kdialog 取消统一退出码 1。 +const CANDIDATES = process.platform === 'darwin' + ? [{ cmd: 'osascript', args: ['-e', 'POSIX path of (choose folder with prompt "选择这个会话的工作目录")'], cancelRe: /User canceled|-128/ }] + : process.platform === 'linux' + ? [ + { cmd: 'zenity', args: ['--file-selection', '--directory', '--title=选择这个会话的工作目录'], cancelExit: 1 }, + { cmd: 'kdialog', args: ['--getexistingdirectory', os.homedir(), '--title', '选择这个会话的工作目录'], cancelExit: 1 }, + ] + : []; + +// 跑一个对话框,resolve 出选中的路径(用户取消 → '')。 +// 超时兜底:对话框可能被用户晾在那儿,这里到点 kill,避免永远挂着一个 child。 +function runPicker(cand, timeoutMs) { + return new Promise((resolve, reject) => { + execFile(cand.cmd, cand.args, { timeout: timeoutMs, maxBuffer: 1 << 20 }, (err, stdout, stderr) => { + if (!err) return resolve(String(stdout || '').trim()); + if (err.code === 'ENOENT') return reject(Object.assign(new Error('no-cmd'), { no_cmd: true })); + if (err.killed) return reject(Object.assign(new Error('选择目录超时,请重试'), { status_code: 408 })); + const msg = String(stderr || '').trim(); + if (cand.cancelRe && cand.cancelRe.test(msg)) return resolve(''); + if (cand.cancelExit && err.code === cand.cancelExit) return resolve(''); + reject(Object.assign(new Error('目录选择器失败:' + (msg || ('退出码 ' + err.code))), { status_code: 500 })); + }); + }); +} + +async function pickDir() { + if (!CANDIDATES.length) { + throw Object.assign(new Error('当前系统不支持目录选择(仅支持 macOS / Linux)'), { status_code: 501 }); + } + for (const cand of CANDIDATES) { + try { + const out = await runPicker(cand, 120000); + if (!out) return ''; + // osascript 的 POSIX path 带尾斜杠,去掉让展示一致;选到根 '/' 时保底保留。 + return out.replace(/\/+$/, '') || '/'; + } catch (e) { + if (e.no_cmd) continue; // 换下一个后端 + throw e; + } + } + throw Object.assign(new Error('没有可用的目录选择器(Linux 请安装 zenity 或 kdialog)'), { status_code: 501 }); +} + +// 能力探测:前端凭这个决定是否显示「工作目录」入口(拿不到就整条隐藏)。 +router.get('/info', (req, res) => { + res.json({ enabled: true, platform: process.platform, workspace_root: engine.getConfig().workspace_root }); +}); + +router.post('/pick-dir', (req, res) => { + pickDir().then(p => res.json({ path: p })).catch(err => sendErr(res, err)); +}); + +module.exports = router; diff --git a/app/server/routes/sessions.js b/app/server/routes/sessions.js index 585fea5..8065795 100644 --- a/app/server/routes/sessions.js +++ b/app/server/routes/sessions.js @@ -84,7 +84,9 @@ router.post('/', wrap((req, res) => { const assistantType = String((req.body && req.body.assistant_type) || 'secretary').trim().slice(0, 32) || 'secretary'; // 创建者取认证中间件的 req.user(不信客户端传参);未启用认证时为空串 const user = String(req.user || '').trim().slice(0, 64); - const session = engine.createSession(title, modelId, assistantType, user); + // 手选工作目录(仅本地端前端会传,服务器前端从不带;不传/空串 = 老行为,见 engine.createSession) + const workDir = String((req.body && req.body.work_dir) || '').trim(); + const session = engine.createSession(title, modelId, assistantType, user, workDir); log.info('task', (req.user || '-') + ' 新建任务 ' + session.id + '「' + (session.title || '未命名') + '」model=' + (modelId || '自动') + ' type=' + (session.assistant_type || 'secretary')); res.json(session); })); diff --git a/app/server/server.js b/app/server/server.js index 29bc5b1..be3d7ad 100644 --- a/app/server/server.js +++ b/app/server/server.js @@ -67,6 +67,12 @@ require('./routes/preview-proxy').earlyGuard(app); app.use(express.static(path.join(__dirname, 'public'))); +// 本地桌面端(local/ 启动器)专用:原生目录选择器。AGENT_LOCAL_PICK=1 才挂, +// 服务器形态零影响(不加载 routes/local.js,/api/local/* 一律 404)。 +if (String(process.env.AGENT_LOCAL_PICK || '') === '1') { + app.use('/api/local', require('./routes/local')); +} + app.use('/api/sessions', require('./routes/sessions')); app.use('/api/sessions', require('./routes/messages')); app.use('/api/sessions', require('./routes/files')); diff --git a/app/server/tools/executor.js b/app/server/tools/executor.js index 1679382..dd1009e 100644 --- a/app/server/tools/executor.js +++ b/app/server/tools/executor.js @@ -58,6 +58,9 @@ function resolveInTask(taskDir, p, rootDir) { // 工具层允许的根:session 形态 = 会话目录;workspace 形态 = workspace_root。 // 只给「业务工具」用;路由层(文件 API/公网短链/data-page)与 @历史会话仍按会话目录校验。 function fsRoot(ctx) { + // 手选工作目录的会话:AI 的一切文件操作都在这个真实目录里(本地端,不建 task-* 子目录)。 + // 优先于 WIDE_SCOPE 的 workspace_root 兜底。 + if (ctx.workDir) return ctx.workDir; if (!WIDE_SCOPE) return ctx.taskDir; return (ctx.cfg && ctx.cfg.workspace_root) || ctx.taskDir; } @@ -90,13 +93,15 @@ function resolvePastPath(ctx, p) { const sid = m[1]; const rel = m[2] || '.'; if (!/^task-[0-9A-Za-z_\-]+$/.test(sid)) throw new Error('@ 后需会话 id, 形如 task-YYYYMMDD-NNN: ' + sid); - const s = ctx.db.prepare('SELECT id, user, title FROM sessions WHERE id = ?').get(sid); + const s = ctx.db.prepare('SELECT id, user, title, work_dir FROM sessions WHERE id = ?').get(sid); if (!s) throw new Error('会话不存在: ' + sid); const me = ctx.db.prepare('SELECT user FROM sessions WHERE id = ?').get(ctx.sessionId); if (String(s.user || '') !== String((me && me.user) || '')) throw new Error('无权访问该会话: ' + sid); + // 目标会话若手选了工作目录,@<会话> 也必须指向那个真实目录,而不是 workspace_root/。 + const wd = String(s.work_dir || ''); const root = String((ctx.cfg && ctx.cfg.workspace_root) || ''); - if (!root) throw new Error('workspace_root 未配置'); - const dir = path.join(root, sid); + const dir = wd || (root ? path.join(root, sid) : ''); + if (!dir) throw new Error('workspace_root 未配置'); return { sid: sid, title: s.title || sid, dir: dir, abs: resolveInTask(dir, rel) }; } diff --git a/docs/local-mode.md b/docs/local-mode.md index 56232d7..e7eaa42 100644 --- a/docs/local-mode.md +++ b/docs/local-mode.md @@ -329,3 +329,27 @@ rm -rf local/ # 或保留脚本、只是不用 `local/config.local.yml`、`~/AgentWork/`、`app/node_modules/`、`mcp/image_task|video_task/node_modules/`。 全部在 gitignore 内,不影响仓库;想彻底重来就把它们删掉再跑脚本(会话产出在 `data/` 与 工作目录下的 `task-*` 里,不会被清)。 + +## 10. 新建会话手选工作目录(本地端) + +默认每个会话落在 `workspace_root/<会话id>`(形如 `task-YYYYMMDD-NNN`)。本地端希望「给它一个 +目录就放开手脚」,所以新建会话时可以手选一个真实目录,这个会话的 AI 一切操作都在那儿。 + +**后端只动 `taskDirOf` 一处**(`engine.js`): + +```js +taskDirOf(sessionId) = sessions.work_dir || path.join(workspace_root, sessionId) +``` + +全仓库的会话路径(文件 API、上传、`terminal` 的 cwd、`resolveInTask` 基准、data-page、 +`@会话` 只读)都经由它,所以改这一处即全线生效,不必逐个路由改。 + +- 选择只存前端(`pendingWorkDir`),建档时随 `POST /api/sessions` 提交一次;不选 = 空串 = 老行为。 +- **不建 `task-*` 子目录**,直接以所选目录为工作目录(隐藏产物 `.tmp`/`.imgcache`/`.app`/`data.db` 落在这里)。 +- 允许多个会话选同一目录;**删会话绝不删该目录**(`deleteSession` 只在 `work_dir` 为空时才 `rmSync`)。 +- `fsRoot` 优先返回 `ctx.workDir`;`@<会话>` 也按目标会话的 `work_dir` 解析(`resolvePastPath`)。 +- 目录选择器:`routes/local.js` 用 `osascript`(mac)/ `zenity`/`kdialog`(Linux)弹原生窗口, + **仅 `AGENT_LOCAL_PICK=1` 时挂载**(`server.js`),服务器形态 `/api/local/*` 一律 404,前端整条入口隐藏。 + 必须 `execFile` 异步:同步会阻塞事件循环、卡住所有 SSE。 +- 只接受已存在的目录(`normalizeWorkDir` 校验真实路径),并拒绝根目录 `/` 与平台数据目录。 +- 服务器形态:前端从不传 `work_dir`,`work_dir` 列恒为空,行为与旧版完全一致。 diff --git a/local/README.md b/local/README.md index 86eea28..e31d849 100644 --- a/local/README.md +++ b/local/README.md @@ -32,6 +32,10 @@ cd agent 浏览器里首次使用:**左下角「用户区」→ 设置 → 模型池**,添加平台和 API Key,然后点「重启」。 +新建会话时,欢迎页「随时开始吧」下方可以**手选一个工作目录**:选了之后这个会话的 AI 一切操作 +都在那个目录里(不再建 `task-*` 子目录);不选就沿用默认(系统工作目录下的独立会话目录)。 +删会话不会删你选的目录。 + 没有 Node 20+ 时不会让你白选目录:脚本在入口就停下,终端打出安装方式,自检结果(哪项缺、怎么装)写到状态页。 > 「重启」能用是因为启动器在守护。`routes/system.js` 的重启实现是 `process.exit(0)`, diff --git a/local/start.sh b/local/start.sh index 83cb3a3..97db55f 100755 --- a/local/start.sh +++ b/local/start.sh @@ -818,6 +818,7 @@ start_core() { HOST="$HOST_ADDR" \ AGENT_CONFIG="$CONFIG" \ AGENT_FILE_SCOPE=workspace \ + AGENT_LOCAL_PICK=1 \ ASR_URL="$ASR_URL" \ PYTHONPATH="$ROOT/skills/deps" \ node server/server.js >>"$LOG" 2>&1 ) &