JOJO/agent-Specialization
1
0
Fork 0
Code Issues Pull Requests 1 Actions Packages Projects Releases Wiki Activity
103 Commits 6 Branches 0 Tags 503 MiB
2198e40c49
Commit Graph

37 Commits

Author SHA1 Message Date
JOJO
2198e40c49 feat(review): 对话回顾新增纯净对话模式（默认），修复 /new 页面无法生成 
- build_review_lines 新增 content_mode：dialogue（默认推荐，仅保留有实际内容的 user/assistant）/ full（原完整行为，含工具调用与结果）
- conversation_review 工具与 review_preview/review 两个手动 API 均支持 content_mode，落盘 md 文件首行加模式标注
- 回顾弹窗新增「完整记录」切换按钮，预览实时跟随模式刷新
- 修复 /new 页面无法生成回顾：移除活跃对话硬拦截，发送给模型时改走正常发送入口自动创建对话

Co-authored-by: Astrion powered by Kimi-K3 <astrion-agent@users.noreply.github.com>
 2026-09-14 13:39:17 +08:00
JOJO
5459d82637 feat(cli): 面板与状态栏接真实数据，/new 对齐草稿语义；host 设置面双通道化 
CLI（bun 跑源码即生效）：
- boot：loadBootData 一次性加载模型清单（含 context_window）/个性化默认
  （含压缩设置）/path 授权/会话列表；新会话 unshift 标 current
- /session：Enter 真实加载（timeline.reset + getSessionHistory 渲染历史文本）
- /new：对齐 web /new 页面语义——空对话草稿不立即建会话，首条消息
  createTask 不带 cid 由服务端惰性创建，响应回 id 后插入列表标 current
- /context + 状态栏：token_update 事件（运行期事件流）+ 打开面板时查询
  新端点 GET /api/runtime/sessions/<cid>/token-stats；百分比算法对齐 web
  InputComposer（自动压缩阈值优先于模型窗口）
- /model：Enter = 本地生效 + createTask 带 model_key/run_mode/thinking_mode
  覆盖（会话级即时）+ savePersonalization patch 存默认（effort default 存 null）
- /path：增删后 savePathAuths 全量提交两组（服务端 deny 校验保留）
- /agents /tasks /workflow /rewind：打开时拉真实列表（sub_agents/
  background_commands/workflows/versioning-checkpoints）
- 发送链路统一 sendWithSettings 携带 /model 生效值（含排队队列）

后端：
- 8 端点装饰器 api_login_required → api_login_or_host_token_required
  （personalization×2 / path-authorization×2 / sub_agents / background_commands
  / workflows / versioning-checkpoints），web session 行为不变
- headless_app 用 add_url_rule 共享上述视图函数（URL 与 full 一致）；
  sub_agents/background_commands 支持 query 显式传 conversation_id
  （Bearer 装配的 terminal 无当前对话概念）
- RuntimeService 新增 get_session_token_stats；gateway_api 挂 token-stats 路由
- headless 404 兜底：非 /api/ 的 GET 路径回落告知页（对齐 SPA fallback）

验证：tsc ✅ py_compile ✅ 冒烟 6/6 ✅ headless 装配 54 路由 ✅
localconfig 无头实测读到真实配置 ✅；真实服务端到端待用户重启 8091 实机验收

Co-authored-by: Astrion powered by Kimi-K3 <astrion-agent@users.noreply.github.com>
 2026-09-11 21:20:58 +08:00
JOJO
66fa90d6cc feat(server): headless 启动入口（Gateway 专用路由面）+ approval 拆独立蓝图 
- 新增 server/headless_app.py：仅挂 gateway/tasks/status/approval/usage 五件蓝图，
  无 web 站点路由面（/login、会话管理、静态页全砍），根路径返回 HTML 告知页；
  供 CLI 探测无服务时 spawn（同 RuntimeService 单例/数据目录/端口 8091，
  与 full 形态互斥不并存）
- server/chat/approval.py 拆出 approval_bp（tool/plan/question 6 条路由 URL 不变），
  解除对 chat_bp 的 import 循环，full/headless 双形态共用
- cli/src/gateway.ts：spawn 切 server.headless_app；python 解释器改 pickPython
  依赖探测（import yaml/flask 逐个试 .venv → homebrew 3.12/3.11 → python3），
  修本机 .venv 缺 pyyaml 导致的自启动即崩
- 修复 socket 移除残留雷：make_terminal_callback 定义随 broadcast.py 被删，
  workflow_runtime_api 模块级 import 即炸；resources.py 补兼容空操作（恒返 None）
- AGENTS.md §2 补 headless 启动命令、§12.5 补兼容空操作与 headless 形态说明

验证：tsc ✅ py_compile ✅ 冒烟 6/6 ✅ headless 装配 47 路由 ✅
8093 真实冒烟（health/Bearer/404 面/告知页）✅

Co-authored-by: Astrion powered by Kimi-K3 <astrion-agent@users.noreply.github.com>
 2026-09-11 19:00:22 +08:00
JOJO
e5808ea5be refactor(server,web): remove Socket.IO entirely, unify on REST polling 
- task event stream (_append_event) is now the sole realtime channel for web and CLI
- status snapshots: idle 5s polling of /api/status (was status_update push); operation initiator gets state from REST responses
- terminal panel: REST polling (list 5s, output 1.5s, prefix-matched incremental xterm writes)
- multi-tab passive sync deliberately degrades to polling-based perception
- delete socket_handlers/broadcast/useLegacySocket (2103-line dead file); extensions.py keeps only run_background
- remove socket token chain (/api/socket-token, prune/consume_socket_token, pending_socket_tokens)
- app.run(threaded=True) replaces socketio.run; reapers switched to plain threading
- drop flask-socketio/socket.io-client/websockets dependencies
- docs: AGENTS.md section 12.5 (replacement map + hard constraints), plus CLI rewrite companion doc updates

Co-authored-by: Astrion powered by Kimi-K3 <astrion-agent@users.noreply.github.com>
 2026-09-11 17:28:47 +08:00
JOJO
d97c1423b1 feat(cli): rewrite CLI on opentui with Gateway host Bearer channel 
- replace Ink implementation with opentui + React 19 (old version kept at cli/legacy-ink-src/ for field reference)
- all traffic goes through Gateway host Bearer token; workspace bound via X-Astrion-Workspace-Id header
- auto-spawn server only when no instance is alive (never kill/restart running ones); stale server without token is detected
- astrion launcher (bin/astrion, symlink-aware, --version/--help fast-exit)
- slash menu panels (session/model/mode/permission/path/context/approvals...) with shared selector component
- backend: host workspace list/create dual-channel endpoints, host token generated at startup
- i18n reads OS locale at startup (zh/en)

Co-authored-by: Astrion powered by Kimi-K3 <astrion-agent@users.noreply.github.com>
 2026-09-11 17:27:53 +08:00
JOJO
70e16fccfb feat(tools): 工具动态加载——低频工具按需注入，对话文件快照为准 
- 新增 core/tool_loading.py：可延迟注册表（8 类目 18 工具：工作流/子智能体/
  对话回顾/记忆写入/个性化/技能/MCP/彩蛋）、快照与状态迁移、目录渲染、守门判定
- 常驻 load_tools 工具：按名在 tool result 返回完整 JSON 定义后直接调用；
  执行守门拦截未加载的延迟工具并引导先加载；只读/计划模式放行
- 对话创建时快照 metadata.tool_loading（enabled/deferred_set/initial_exposed/
  loaded/pending），创建即钉死，个人空间设置只影响新建对话；老对话无字段
  不生效（全量工具，零迁移）；多智能体对话 v1 不启用
- prompt 目录走现有冻结机制（frozen_tool_loading_prompt，skills 段之后），
  创建即冻结终身不变，不破坏前缀缓存；tools 数组恒为「构建集−deferred_set」
- 压缩三钩子（深度/浅度/手动）重置 loaded→空、pending→deferred_set，
  frozen_tool_loading_prompt 纳入 REBUILD_FROZEN_KEYS
- 个人空间新增「按需加载的工具」设置区（总开关默认开+类目分组勾选，
  双语 i18n），GET /api/personalization 下发注册表
- load_tools 上下文 formatter 保留完整 JSON 定义（定义靠 tool result 存续）；
  前端渲染名称+状态徽章；新增 19 个单元测试
- AGENTS.md 新增 §13（硬约束与新增可延迟工具 checklist）
 2026-09-10 17:07:15 +08:00
JOJO
aa50a72d86 fix(chat): /new页面切换工作模式被运行中对话误拦 
- 运行中判定改基于请求显式携带的 conversation_id，不再用工作区级
  terminal 的残留焦点（_ensure_conversation 自动加载最近对话）；
  /new 页面无 cid 直接放行（新对话默认模式与运行中对话无关）
- /new 路径切换改 persist=False，避免误写残留焦点对话的 metadata
  （plan 联动权限曾一并污染），与 _sync_workspace_terminal_mode 同策略

Co-authored-by: Astrion powered by Kimi-K3 <astrion-agent@users.noreply.github.com>
 2026-09-09 02:19:30 +08:00
JOJO
944cef0587 fix(runtime): 审批/提问等待的停止检查改为两级判定——修复弹窗被运行期常驻 entry 误触发 
stop_flags[task_id] 在任务运行期常驻 {'stop': False, ...} entry（chat_flow 启动时写入），
entry 存在 ≠ 停止请求。新增 _make_interaction_stop_check（entry 存在且 stop 字段为真才判定），
替换 tool 审批/ask_user/submit_plan 共 5 处调用点；修复前三个 _wait_* 一律秒触 stopped 分支，
三类弹窗（提问/计划批准/工具审批）不弹直接返回。

Co-authored-by: Astrion powered by Kimi-K3 <astrion-agent@users.noreply.github.com>
 2026-09-08 11:38:14 +08:00
JOJO
aa9bf377a3 feat(runtime): Gateway 收尾——session 传输暴露、host Bearer 通道、flask 依赖拆解、审批链路收口 
- session.* 传输暴露：新增 gateway_api 蓝图（list/create/history），RuntimeService 补 create_session
- host Bearer 通道：gateway_auth 双通道认证（host 模式+回环限定，token 存 DATA_DIR/host_api_token），tasks/approval 路由接入
- api_v1 会话路由转调公共入口消双轨，会话索引/列表补齐 run_mode/model_key/custom_prompt_name/personalization_name
- flask 包依赖拆解：_flask_bridge 延迟桥接 + context 子包 PEP 562 懒加载，import server.tasks/runtime 不再拉起 flask
- 审批链路：mark_expired 终态回写（超时/软停止/取消三路径）+ 终态 TTL 惰性清理（3600s）
- 测试 patch 点随迁；全量 75 测试失败恰为 4 项存量，独立启动验收 4/4 全绿

Co-authored-by: Astrion powered by Kimi-K3 <astrion-agent@users.noreply.github.com>
 2026-09-08 11:37:51 +08:00
JOJO
f43b03484d refactor(runtime): 拆除 session_data 兼容桥，任务上下文三层结构化直传 
- TaskRecord 去 session_data dict，直存 principal/task_params/directives
  + 可变 goal_progress 字段（__slots__）
- create_chat_task 签名改为收 RuntimeContext 必填，TaskRecord.__init__
  同步精简（身份/消息/模式等全部从 ctx 派生）
- _run_chat_task 身份还原/门闸认领/事件注入/terminal 属性设置
  全部改为三层属性访问；goal_progress 回写改独立可变字段
- RuntimeService.create_task 原样透传 ctx；to_session_data() 删除
- task_public_payload / api.py 单任务载荷改三层读取
- 契约/注释/i18n 文案同步去 session_data 化；测试重写为三层断言

验证：75 测试全量回归，失败恰为 4 项存量（host_workspace_manager /
skills_manager / token_usage_extractor / conversation_workspace_storage）
 2026-09-08 02:08:33 +08:00
JOJO
f77f1d67a8 refactor(runtime): 审核 F1-F4 收口——发现入口、范围校验、入口统一转调、验收加固 
- F1: RuntimeService.list_runs 公共 Run 发现（工作区/会话/状态筛选）；
  task_public_payload 序列化收敛至 models.py 核心层单一实现（Web/公共入口同构，
  helpers.py 旧实现删除，无新旧双轨）
- F2: tasks/api.py 7 处、api_v1.py 3 处、chat/approval.py 6 处全部转调
  runtime_service；HTTP 轮询透传 window_start 缺口水位；死导入清零
- F3: _resources_for_query 补 principal workspace_id 一致性校验
  （跨工作区查询必须重新认证）
- F4: config 新增 ASTRION_IGNORE_DOTENV 逃生门（.env 对 ASTRION_DATA_ROOT 的
  优先覆盖是刻意设计，保留）；验收测试自包含（假模型 127.0.0.1:9 快失败）+
  隔离生效断言；lifecycle 改 api_request_start 装配证据断言；
  新增审批等待链验收（approval 档真实工具循环：等待→公共入口批准→继续）；
  chain 首段改双客户端场景（B 经 list_runs 发现 A 的 Run 并观察/取消）
- execution_plane/base.py 注释修正：命令校验/路径授权仍在旧链路（审核 §4）
- 全量 75 测试：失败恰为 4 项存量，与改造无关
 2026-09-08 01:29:43 +08:00
JOJO
d7cb854f0c feat(runtime): 审批/提问纳入公共入口，①②③链路收口 
- RuntimeService 新增 list_pending_approvals（三类分桶）与 resolve_approval
  （kind 路由 tool/plan/question，透传 manager 单次裁决/越权/参数校验语义）
- 协议能力 run.*/approval.*/session.* 全部有 RuntimeService 公共方法
- 现状文档记录本轮收口决策：①②③贯通为终点，③↔④全量贯通后置（§7.5-补四件事）
- 全量回归：失败恰为 4 项存量，与改造无关
 2026-09-07 23:34:42 +08:00
JOJO
4378eb6a46 feat(runtime): 会话查询公共入口与就绪度收口（改造第 5 步收窄） 
- RuntimeService 新增 list_sessions / get_session_history（会话列表/磁盘权威历史），
  CLI 等非 Web 调用方不再依赖 Web 路由；principal 与目标用户一致性校验防身份伪造
- chain 验收补会话查询断言（列表含会话/历史含消息/越权抛 PermissionError）
- gateway_current_state.md：§6.1/§7 实施状态速览（第 0-5 步完成度与遗留清单）
- 全量 74 测试失败恰为 4 项存量，与改造无关
 2026-09-07 23:07:32 +08:00
JOJO
d9bd599c1c feat(runtime): Gateway 独立启动与公共协议落地（改造第 0-3 步） 
- 闭环修复：审批 task_id 显式化（N2）、通知回退路径门闸 finally 释放（N1）、
  personalization 原子写（S10，公共 atomic_write_json）
- server.tasks 拆解：__init__ 轻量化、Blueprint/路由移至 blueprint.py/web.py，
  app_legacy 装配点惰性挂载；models.py 循环依赖死导入移除
- 执行链 Web 解耦：emit_event/run_background 安全包装（socketio 未绑定静默），
  清除 4 处裸 socketio.emit（含 task_stopped 先写事件流再推送的顺序修复）
- RuntimeService 补建对话下沉：chat 任务无 conversation_id 时服务层装配，
  客户端无需复制 Web 两步流程
- 事件协议：get_task_events 返回 meta.window_start 缺口检测水位
- 验收：test_runtime_standalone_lifecycle 子进程隔离（config import 固化问题），
  独立启动 + 协议全链路 + 审批语义全绿；全量 74 测试失败恰为 4 项存量
 2026-09-07 23:00:15 +08:00
JOJO
c80bc4fbb4 feat(api): 支持 x-opencode-session 会话头与 Astrion User-Agent 
- OpenCode Go/Zen 自 2026-09-05 起要求每个对话携带稳定的 x-opencode-session 头，用于会话亲和路由与 prompt 缓存优化
- 个人空间「模型与思考」新增「外部会话标识」开关（默认关闭，opt-in）
- 开启后按对话惰性生成随机 ID（uuid4 hex）并持久化到对话 metadata，深压缩后重置
- 覆盖主对话/传统与多智能体子智能体/三个审核智能体（一次性 ID）/标题生成（复用主对话 ID）
- 仅对 opencode.ai 域名下发，不向其他 provider 泄露对话标识
- 所有对外模型请求统一携带 User-Agent: Astrion/1.0（新增 config/version.py）
 2026-09-07 18:50:29 +08:00
JOJO
9a17b38153 fix(context): 补拆包遗漏的 get_current_user_role 导入，修复 host 策略静默失效 
拆包时 resources.py 独立 import 头漏了 get_current_user_role：host 模式 + 非显式身份 + 存在 host 用户记录时触发 NameError，被 except 吞掉后工具分类限制与禁用模型等管理员策略静默不应用（默认无 host 记录不触发）。

- resources.py/usage.py 顺带补 TYPE_CHECKING 导入净化字符串类型注解，server/context/ 与 server/runtime/ pyflakes F821 清零
- 新增回归测试：host 模式 + HTTP 请求上下文 + host 记录存在，断言策略真正应用到 terminal；红绿验证通过（回退导入测试即红）

测试：25/25 全绿（24 + 新增 1）
 2026-09-07 17:40:49 +08:00
JOJO
652c160640 feat(runtime): 抽出 RuntimeService 公共任务入口，任务线程拆除 Flask 隐式上下文 
Gateway 化阶段一/二实施（公共任务入口），计划与验收记录见 cache_research/gateway/phase12_implementation_plan.md；契约文档 docs/runtime_contract.md 为本地文档按仓库惯例不入库

- 新增 server/runtime/：RuntimeContext 三层模型（TrustedPrincipal/TaskParams/InternalDirectives）+ RuntimeService（create_task/cancel/guidance/queue/get_task_events）
- create_chat_task 强制显式 session_data（缺失 ValueError，i18n key tasks.missing_session_data）；6 处调用点迁移至 runtime_service.create_task()（tasks/api、api_v1、workflow_runtime_api x2、chat_flow_task_main x2），门闸 token 移交与 notice 互斥豁免语义保留
- _run_chat_task 拆除 test_request_context 桥，任务线程全程 RuntimeIdentity 驱动
- 审批超时经 terminal._approval_timeout_seconds 透传至工具循环 4 个 _wait_* 调用点（默认 3600s 语义不变）
- 附带：config/_load_dotenv 容忍沙箱禁读 .env；AGENTS.md 同步结构

测试：改造相关 24/24 全绿（冒烟 6 + runtime_service 10 + model_persistence 4 + identity 路由 4）；真实环境验证已由用户人工完成

Co-authored-by: Astrion powered by Kimi-K3 <astrion-agent@users.noreply.github.com>
Co-authored-by: Codex powered by ChatGPT-6-Astra <codex@example.com>
 2026-09-07 16:16:12 +08:00
JOJO
7d290d1790 refactor(context): server/context.py 拆分为子包，get_user_resources 参数化 
- 989 行单文件拆为 server/context/ 9 模块（identity/broadcast/personalization/usage/upload/conversation/resources/decorators/reaper）+ __init__.py 兼容 re-export，外部 import 路径不变
- 新增 RuntimeIdentity 显式身份快照（identity.py），get_user_resources 支持参数化身份驱动，为任务线程拆除 Flask 隐式上下文做准备
- 测试 patch 目标随迁至 server.context.personalization；新增 test_runtime_identity_resources 覆盖 web/host/api 身份路由矩阵

Co-authored-by: Astrion powered by Kimi-K3 <astrion-agent@users.noreply.github.com>
Co-authored-by: Codex powered by ChatGPT-6-Astra <codex@example.com>
 2026-09-07 16:14:53 +08:00
JOJO
08f7adb0fd fix(containers): 配额只统计 docker 句柄，修复 host 模式工作区列表 503 
- ensure_container 的全局/每用户配额闸门仅在创建 docker 句柄时执行，
  host 句柄（会话标识，不占容器池）不再计入任何配额，修复 host 模式
  下第 4 个工作区起 GET /api/conversations 返回 503 的问题
- _has_capacity / has_capacity 全局上限计数同步只统计 docker 句柄
- MAX_ACTIVE_CONTAINERS_PER_USER 默认值 3 -> 8
- admin 面板 available_slots 展示对齐为 docker 句柄计数
 2026-09-02 23:39:42 +08:00
JOJO
0522414a6c fix(security): 第二轮全量 API 审计修复（角色穿越/宿主 GUI/限流收口） 
背景：对全部 206 个 HTTP 路由 + SocketIO 事件逐个排查（主审 + 2 个子
智能体初筛后复核），另按用户要求专项审计前端渲染面（无新发现）。
完整报告见 _experiments/security_audit_2026-09-02/REPORT.md 第八章。

新漏洞修复：
- 多智能体角色 role_id 路径穿越（高）：save_custom_role 直接拼接
  "{role_id}.md"，POST body 的 role_id 无任何校验，可 ../ 穿越覆盖
  其他用户角色文件（跨用户提示词注入），本地已复现写入成功。
  修复：新增 validate_role_id 白名单（^[a-z0-9][a-z0-9_-]{0,63}$），
  role_store 存储层 + multi_agent API 层（POST/PUT/DELETE）双保险
- open-in-file-manager 漏 _is_host_mode_request 检查（同文件其余三个
  端点都有）：docker 模式下任意登录用户可触发宿主 GUI 弹窗+探测路径。
  修复：补 host 检查，docker 下 403
- /api/admin/secondary/verify 无限流且 CSRF 豁免：admin 会话前提下
  可在线爆破二级密码（纵深防御缺失）。修复：5 次/300s 用户维度限流
- WS client_chunk_log / client_stream_debug_log 无连接认证检查且
  无限流（日志写盘放大面）。修复：必须已认证连接 + 30 次/60s 滑窗
  + 桶表万级上限回收
- _get_conversation_file_path 直接拼 "{id}.json"（conv_ 前缀恰好阻碍
  直接穿越，属防御深度缺失）。修复：^conv_[A-Za-z0-9_-]+$ 白名单，
  已核验全部 5 个调用点与 temp_ 前缀排除路径不受影响
- /api/conversations/media/<id> 采信 entry mime_type 并 inline 返回。
  修复：text/html、image/svg+xml、xhtml 强制 octet-stream + attachment
  （与 file/content 的 SVG 策略对齐，防存储型 XSS 一致性收口）
- /api/status 每次心跳返回宿主绝对 project_path（泄露系统用户名与
  目录布局）。修复：docker 模式脱敏为容器视角 /workspace，host 不变

LLM 成本攻击止血（第一轮发现 5 的端点级落地）：
- POST /api/tasks（GUI 发消息主入口）：30 次/60s/user
- POST /api/conversations/<id>/compress（调 api_client.chat 做摘要）：
  5 次/300s/user
- 注：对话回顾 review 端点实为纯本地 Markdown 生成（不调 LLM），
  其「发送给模型」模式走 /api/tasks，已被上述限流覆盖；
  按 token 计费的完整配额方案仍遗留待产品决策

验证：全部 py_compile 通过；冒烟测试 6/6；validate_role_id 8 个恶意
样本全拒 + 3 个合法样本放行 + 穿越写入拦截回归通过；conv_id 白名单
4 组样本符合预期。端点级行为待服务重启后实测。

Co-authored-by: Astrion powered by Kimi-K3 <astrion-agent@users.noreply.github.com>
 2026-09-02 19:37:34 +08:00
JOJO
1a4e5baa23 fix(security): Docker 多用户模式全面安全加固（安全审计修复） 
威胁模型：拥有普通账号的已登录用户攻击服务器。完整审计报告见
_experiments/security_audit_2026-09-02/（不入库），含实测复现记录。

严重/高危修复：
- 彻底移除文件夹打包下载（/api/download/folder 端点删除，gui/api_v1
  目录下载分支改 410）：文件型符号链接会被宿主进程解析，实测可读宿主
  任意文件（含 settings.json 全部 LLM 密钥），删除比补校验更彻底
- XFF 伪造防护：get_client_ip 仅信任 ASTRION_TRUSTED_PROXIES
  （默认空=不信 XFF）；登录新增账号维度锁定（5 次失败锁 300s）；
  注册邀请码加爆破锁定；限流桶/失败表加 2 万键上限+GC 回收
- auth_debug.log 接入大小轮转；/api/client_debug_log 加限流+长度截断
- /host-login 增加 LINUX_SAFETY 检查且仅回环地址可用

容器加固：
- 默认 cpus=1 / memory=1g，新增 pids-limit=512、memory-swap、
  no-new-privileges
- 新增每用户容器配额 MAX_ACTIVE_CONTAINERS_PER_USER（默认 3），
  防止单用户占满全局容器池

api_v1：
- prompts/personalizations 的 name 加白名单校验（^[A-Za-z0-9_-]{1,64}$），
  修复路径穿越写入；对话元数据中的引用名同步加白名单
- workspaces/conversations/messages/upload 四端点加用户维度限流
- 消息体加 MAX_MESSAGE_CHARS 上限（默认 200000，/api/tasks 同步）
- _path_within 加分隔符边界（修复 startswith 前缀碰撞）

其他：
- SVG 预览强制 application/octet-stream（修存储型 XSS 漏网）
- monitor_snapshot 缓存键加 username 维度（修跨用户快照读取）
- ensure/delete_workspace 加 workspace_id 白名单+父目录二次核验
- delete_folder 拒绝删除工作区根（crud_mixin 与容器代理同步修）
- GuiFileManager 死代码加名称校验防复活
- admin_dashboard 静态壳非 admin 访问一律 404
- /api/app/apk/latest 加登录校验+限流（原未认证可拉 133MB）

有意未修（见报告 7.3 遗留清单）：容器 egress 过滤（部署层）、
--cap-drop ALL（怕破坏容器内工作流，已先上 no-new-privileges）、
API 用户/子智能体 LLM 按 token 计费（待产品决策）、str(exc) 收口、
WebSocket 限流、network_permission=restricted 容器语义。

验证：全部文件 py_compile 通过；冒烟测试 6/6 通过；关键新逻辑
（名称校验/路径边界/容器代理删除防护/限流回收）已单测级验证；
端点级行为待服务重启后实测复核（清单见报告 7.5）。

Co-authored-by: Astrion powered by Kimi-K3 <astrion-agent@users.noreply.github.com>
 2026-09-02 18:31:00 +08:00
JOJO
92e4931408 fix(server): 修正宿主机免登录模式文件服务路由的工作区解析 
/user_upload/ 与 /workspace/ 路由此前误用 user_manager 的
users/<user>/projects/<id> 结构，宿主机免登录模式下解析到空工作区，
导致已上传文件 404（show_image 引用上传目录图片加载失败）。
改为与 get_user_resources 同源的 host_workspaces.json 解析。

Co-authored-by: Astrion powered by Kimi-K3 <astrion-agent@users.noreply.github.com>
 2026-09-02 01:08:31 +08:00
JOJO
e6d8f194d2 feat(chat): 行内引用胶囊（inline citations） 
- 模型输出 【cite:src_xxx】/【file:相对路径】 标记，渲染为可交互来源胶囊（悬停延迟开/点击固定/滚动收起）
- 后端：modules/citations.py 注册表与落库校验（剥离幻觉 id 与不存在的文件）；web_search/extract_webpage 注册来源并在工具结果带 citation 信息；assistant 消息落库时 finalize 并挂载 message.metadata.citations
- 前端：marker 输出瞬间即渲染（工具结果查表 + 文件 token 自解析），task_complete 后权威裁决与富化；弹层支持网页摘要/文件内容片段/图片预览，文件头部点击打开右侧预览面板，宿主机模式可在文件管理器中打开
- prompt：三份系统提示加入引用格式与规则（提到文件名不等于引用；图片等二进制文件同样可引用）
 2026-09-01 22:31:37 +08:00
JOJO
deaa1560a5 feat(personalization): 个人空间支持配置对话标题生成模型 
新增 title_model 配置，复用子智能体模型库条目生成对话标题：
- 个人空间「常规」页签新增「标题生成模型」下拉菜单（复用子智能体
  模型列表，general 页签挂载时加载）
- 标题生成改为使用所选子智能体模型 profile；未配置时回落模型库
  default_model，移除 AGENT_TITLE_* 环境变量覆盖与主智能体默认
  模型回退（个人空间为唯一配置来源）
- personalization 白名单注册 title_model 键（默认值 + sanitize）
 2026-09-01 09:46:05 +08:00
JOJO
55b3ee44b7 feat(sandbox): Windows 沙箱环境检测弹窗与一键安装向导 2026-09-01 01:01:09 +08:00
JOJO
6c0a32330c feat(stream): 流式断流「清除重来」自动重试机制 
后端↔API 流式连接在输出中途断开时，旧行为直接终止任务。现改为：
- 网络类断流（status_code 为空）有接收也重试，与零接收共用 5 次
  额度、间隔 10s；4xx 业务错误保持原逻辑
- 重试前发 stream_reset 事件，前端清除本轮已渲染的半截内容
  （思考块含已闭合的/文本/preparing 工具条目），显示「连接中断，
  正在重试（第 n/5 次）…」占位，socket 与 REST 轮询双通道生效
- 修复断流作废轮 usage 重复计数
- 子智能体同构改造：网络断流重试耗尽转 idle 汇报 Team Leader，
  重试前将已推送的「正在调用」工具条目标记 cancelled
 2026-08-31 19:58:43 +08:00
JOJO
8257e4d34d feat(security): 沙箱只读真强制与权限模式边界收敛 
- docker：只读/审批档 run_command、后台命令与持久终端改用非特权 uid(10001) 执行角色，内核 DAC 强制只读，取代文本特征识别；Dockerfile 加固（agent 用户 / git safe.directory / 去 setuid）
- macOS：只读与可写沙箱 profile 统一为白名单读模型（deny default + 系统目录/工作区/路径授权），修复 deny 顺序导致的工作区 .env 实际可读漏洞；可写 profile 白名单化后审批不再放大读取，越界读取唯一途径为路径授权
- 权限模式：受限档（readonly/approval/auto_approval）与 direct 执行环境硬互斥——进入受限档压回沙箱并记录，切回 unrestricted 恢复，存量受限+direct 对话加载自愈矫正
- 配置：路径授权来源收敛为 host_sandbox_policy.json + 环境变量两个通道（移除 settings.json 映射）
- 修复：新建对话权限模式被个性化默认值覆盖、/new 切只读后回落无限制的继承 bug
- 原生文件工具读边界与沙箱白名单同源对齐
 2026-08-30 22:07:14 +08:00
JOJO
a30b03fb93 fix(i18n): 未登录 401 返回双语文案「登录状态已过期，请重新登录」 
- auth_helpers.py / app_legacy.py 的 api_login_required 401 响应改用 tr('auth.session_expired')
- 新增 i18n key：zh 登录状态已过期，请重新登录 / en Your login session has expired. Please log in again.
 2026-08-30 00:33:43 +08:00
JOJO
2a870c5a35 fix(multi-agent): 多智能体对话创建继承 work_mode，/new 切换后新建对话不再回落默认 
Co-authored-by: Astrion powered by DeepSeek-V4-Flash <astrion-agent@users.noreply.github.com>
 2026-08-29 15:26:39 +08:00
JOJO
0b3d98d91b feat(stats): token 统计新增缓存命中追踪与命中率展示 
- utils/token_usage.py：usage 归一化补全缓存命中字段提取，覆盖
  prompt_tokens_details/input_tokens_details.cached_tokens（OpenAI 系）、
  顶层 prompt_cache_hit_tokens（DeepSeek）、顶层 cached_tokens（Kimi/Step）、
  cache_read_input_tokens（Anthropic 系）、cachedContentTokenCount（Gemini）；
  Anthropic 语义下把缓存读/写加回总输入以统一口径，normalize 保持幂等
- 对话级统计新增 total_cached_input_tokens 与 cache_exempt_input_tokens
  （首轮/深度压缩后首轮未命中缓存的输入视为冷启动成本，豁免出命中率分母；
  压缩通过 cache_cold_start_pending 标记在下一次真实调用时判定）
- token_update 广播与 token-statistics 接口同步携带新字段
- TokenDrawer 面板新增「累积缓存输入」「缓存命中率」（前端按 缓存/（总输入-豁免) 换算）
- 深色模式下「当前上下文」数字由灰色 --accent 改为 --text-primary（白）
- 附 cache_research/ 各厂商缓存字段调研文档（代码注释引用）
 2026-08-29 12:43:14 +08:00
JOJO
a2cf547400 feat(i18n): 后端用户可见消息国际化（zh/en 双语 + ui_locale 偏好持久化） 
- 新增 modules/i18n.py：tr() + 进程级语言缓存 + modules/i18n_messages/ 域文案包自动聚合
- 新增 29 个域文案包，共 1153 条双语 key；90+ 源文件 1146 处用户可见消息 tr 化
- ui_locale 存入 personalization.json（用户级共享），前后端双向同步
- 前端匹配点双语兼容（history/shared/ChatArea/taskPolling/upload 等正则）
- 修复语言判等陷阱：审批等待加稳定 code 字段；conversation.py 不存在判等改双语 helper
- 边界：日志/prompt 注入/子智能体工具回填/容器内嵌脚本不迁移
 2026-08-29 07:58:29 +08:00
JOJO
f9f9032ce5 fix(tasks): 用户取消的主任务统一以 stopped 收尾，根治死任务事件重放导致的显示回退 
- 收尾不再按 has_bg 分流保持 cancel_requested 等待已废弃的「第二下点击」，
  cancel_requested 退化为 cancel_task 到收尾之间的秒级瞬态
- 此前有后台任务时按下停止，任务永久卡在活跃集合，被 bootstrap/running-status
  当作最新活跃主任务，前端对账每 2.5s 从事件 0 全量重放死任务事件流，
  表现为回复完成瞬间显示回退到旧回复、刷新空白卡死且无效
- cleanup_old_tasks 清理集修正："canceled" 是从未被赋值的拼写（实际终态为
  stopped），改为 {succeeded,failed,stopped,canceled,cancel_requested} 兜底
 2026-08-28 20:12:20 +08:00
JOJO
4cf9c38137 feat(avatar): 状态头像新增「等待 API 响应」并修复异常中断状态卡住 
- 后端每次发起 API 请求前（含每次重试）发 api_request_start 事件
- 前端新增 apiRequestPending 状态，轮询/socket 双链路维护，
  响应开始（thinking_start/text_start/tool_preparing）或任务终结时清除
- InputComposer 头像旁显示固定文案「等待 API 响应…」（work+apiWaiting 标记）
- chat store 新增 clearStreamingResidualState 统一清理流式残留字段，
  接入全部终结路径（handleTaskError/Stopped/Complete、运行状态对账、
  resetAllStates、socket error），修复断网/停止后形象卡「思考中」
- handleTaskError 补 clearPendingTools 与空占位消息清理
- avatarStatus isThinking 增加运行态防御，双保险防状态卡死
 2026-08-26 15:11:18 +08:00
JOJO
d5a7c94c8e fix(server): /new 页面切换模型被工作区 terminal 残留 has_images 误拦 
重启后工作区级 terminal 自动加载最近对话恢复焦点时，会从其 metadata
无条件恢复 has_images/has_videos（attach_history=False 不挂历史但标志仍残留）。
/new 页面切换模型不带 conversation_id，前端守卫已放行，但后端 set_model
守卫读到残留标志误抛「当前对话包含图片」。

/api/model 端点识别 /new 语义（无 conversation_id 且 terminal 未绑定对话）时，
切换前清除残留标志——与 create_new_conversation「新对话视为干净会话」语义一致；
显式打开对话时 load_conversation_by_id 会从 metadata 重新恢复，清除安全。
 2026-08-26 10:23:01 +08:00
JOJO
2d9b4eb5a6 fix(conversation): 修复版本回溯被旧内存merge覆盖，统一presend用户输入口径 
- 回溯后同步对话级 terminal 内存为磁盘快照，避免 merge-on-save 把被裁消息当"内存独有"救回（此前只能回溯后立刻重启进程）
- 工作区级服务实例不再挂载对话历史（focus-only 仅恢复焦点+模式），settings/通知判定/工作流游标等保存路径改读磁盘回传，消除旧内存写回污染源
- 左侧输入导航与深度压缩的用户输入口径补 presend（提前输入排队转正），guidance 维持不计入；统一字段缺失老消息视为 user
 2026-08-25 22:43:58 +08:00
JOJO
9d3784bd90 refactor(compression): 压缩注入引导语与存档不再重复附带用户最近一次输入 
最近一次输入本身会作为正常消息出现在上下文中，注入消息里再附一份属于重复
 2026-08-23 17:13:02 +08:00
JOJO
10654c407d release: sync from main @0f9fd1b2 (2026-08-22) 2026-08-22 12:27:19 +08:00