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

16 Commits

Author SHA1 Message Date
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
f6a46b5b0a refactor(tools): remove zombie close_sub_agent tool 
该工具自 2025-11-15 引入起即为 terminate_sub_agent 的别名（两提交相隔
19 分钟），main_terminal 拆分为 main_terminal_parts 时执行分支丢失，
仅剩定义残留——模型调用必落 unknown_tool，且与 terminate_sub_agent
命名近似干扰工具选择。本次彻底移除定义、分组集合、tool_config 分类、
formatter 注册、i18n 键与前端三处图标映射，并在原定义位置留注释
防止误恢复。终止子智能体统一使用 terminate_sub_agent。
 2026-09-10 13:41:12 +08:00
JOJO
d574159f82 chore(repo): 根目录杂项归档 _experiments，完善 .gitignore 
- 停止追踪 study.md、3 个沙箱调研 md、2 张无引用散图及 cache_research/（25 个文件），实体全部移入 _experiments/
- .gitignore 补全：cli-redesign-demo/、_packaging/、.pytest_cache/、.runtime/、.upload_quarantine/、opencode_key_fix_output/、cache_research/；去除重复的 sub_agent_results/
- 同步修正 test/utils 注释与本地文档中的调研资料路径引用

Co-authored-by: Astrion powered by Kimi-K3 <astrion-agent@users.noreply.github.com>
 2026-09-09 21:11:58 +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
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
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
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
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
e4fdc82319 fix(i18n): 子智能体统计与工具结果摘要补齐 tr() 双语，根治漏网硬编码中文 
sub_agent/stats.py 的统计摘要（调用/读写/搜索/网页/指令次数、运行时长、交付目录）与 tool_result_formatter/agent_context.py 的子智能体相关格式化函数此前仍是硬编码中文，英文界面显示中文。新增 sub_agent_stats.* 9 个 key、扩展 fmt_agent2.* 30 个 key；补齐后引用完整性 0 缺失、0 占位符漂移，冒烟 6/6，中英双语自检通过。
 2026-08-29 10:09:19 +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
e04b56d967 fix(sub-agent): 深度压缩重建 system 消息包装为 dict，根治压缩后首次模型调用必崩 
- _deep_compress_messages 此前把 _rebuild_system_prompt 返回的裸字符串直接
  作为 messages[0]，压缩后首次模型调用在 _merge_system_messages 的
  msg.get("role") 处崩溃（'str' object has no attribute 'get'），
  任何触发 150k tokens 压缩阈值的子智能体 100% 必崩
- _merge_system_messages 入口增加非 dict 归一防御（包装为 system 消息），
  同时避免下游 sanitizer 静默丢弃导致 system prompt 内容丢失
 2026-08-28 20:12:44 +08:00
JOJO
16aaea6b1e refactor(multi-agent): 子智能体统一显示名寻址并增强可靠性 
- 全局 agent_id 转为内部实现细节：由 next_free_agent_id 自动分配对话级
  最小空闲正整数，不再接受模型指定、不出现在工具参数/结果文案中
- 角色内编号改为 peek + commit 两步：创建成功才消耗编号，失败不跳号
- 所有寻址类工具改用显示名：send_message/stop/terminate 传 display_name，
  get_sub_agent_status 传 display_names，sleep 的 wait_sub_agent_output，
  子侧 ask_other_agent 传 target_display_name，answer_other_agent 去掉
  source_agent_id
- _run_loop 对 _call_model 增加重试：最多 5 次、间隔 10s、仅零接收时重试，
  输出中断直接失败；多智能体模式下 5 次全失败转 idle 并向 Team Leader 报错
- 新增工具「正在调用」进度事件（calling），与 running/completed 共用
  tool_call id，前端支持同 id 原地更新
 2026-08-27 09:21:30 +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
da176ba4c7 chore: 记忆审计修正 —— AGENTS.md APIClient 引用 + 删除保存调试 trace 代码 
- AGENTS.md §11.2: DeepSeekClient → APIClient（2026-07-28 改名的遗留引用）
- crud_mixin.py: 删除已过观察期的 _debug_conversation_save_trace（含 shrink/wipe_suspect 判定、调用栈捕获、conversation_save_debug.log 落盘）及配套 _CONV_SAVE_LOG_DIR / threading 导入
- 保留 ConvSaveGuard 断言与 ConvSaveMerge 矫正打印（机制级长期日志）
- 验证：模块加载成功 + test_server_refactor_smoke 6/6 通过
 2026-08-22 19:12:08 +08:00
JOJO
10654c407d release: sync from main @0f9fd1b2 (2026-08-22) 2026-08-22 12:27:19 +08:00