JOJO/agent-Specialization
1
0
Fork 0
Code Issues Pull Requests 1 Actions Packages Projects Releases Wiki Activity
581 Commits 5 Branches 0 Tags 500 MiB
8e1a339102
Commit Graph

15 Commits

Author SHA1 Message Date
JOJO
8e1a339102 refactor: split api_client, tool_result_formatter, tools_definition into sub-packages 
- utils/api_client.py -> utils/api_client/ (mixin-based)
- utils/tool_result_formatter.py -> utils/tool_result_formatter/ (by tool category)
- core/main_terminal_parts/tools_definition.py -> core/main_terminal_parts/tools_definition/ (by tool group)
- Update AGENTS.md, CLAUDE.md, and split memory index
- Keep original files as compatibility re-exports
- Includes TerminalPanel display adjustment and ToolAction.vue diff line fix
 2026-06-20 21:51:45 +08:00
JOJO
f661dc6456 refactor(server,modules,utils,frontend): split oversized modules into packages and fix regressions 
- Split server/chat.py, server/status.py, server/tasks.py into sub-packages
- Split utils/context_manager.py, utils/conversation_manager.py into mixin packages
- Split modules/file_manager.py, persistent_terminal.py, terminal_ops.py, mcp_client_manager.py into packages
- Split core/main_terminal_parts/context.py into base + mixins
- Split static/src/app/methods/{ui,message,upload,taskPolling,conversation} into sub-modules
- Fix flattened method exports, dynamic import paths, missing cross-module imports
- Add missing permission/network/execution mode constants and _PERMISSION_MODE_LABEL
- Update AGENTS.md, CLAUDE.md and project memories to reflect new structure
 2026-06-20 15:54:48 +08:00
JOJO
9ed956518c refactor(sub_agent): 子智能体从 Node.js 子进程改为主进程内 Python 协程 
- 重写子智能体执行核心，不再启动 easyagent Node.js 子进程
- 新增 modules/sub_agent/ 包集中管理子智能体逻辑
- 工具调用复用主进程 WebTerminal.handle_tool_call，自然经过沙箱/容器链路
- 子智能体模型独立读取 ~/.agents/<mode>/config/sub_agent_models.json
- 支持 8 个工具：read_file/write_file/edit_file(replacements+replace_all)/run_command/web_search/extract_webpage/search_workspace/read_mediafile
- 修复子智能体进度弹窗：标题颜色、write_file 显示、过滤非 progress 条目、统一滚动条样式
- 更新 AGENTS.md / CLAUDE.md 子智能体描述
- 新增 test/test_sub_agent_regression.py 回归测试
 2026-06-20 00:26:45 +08:00
JOJO
f31f8d6fd7 feat(host): host 模式同时加载 host/ 和 web/ 用户数据 
- paths.py: 新增 IS_HOST_MODE / WEB_DATA_DIR / WEB_USER_SPACE_DIR
- user_manager.py: host 模式合并两处用户列表与工作区
- 已有 web 工作区直接复用，新数据写入 host/
- 更新 AGENTS.md / CLAUDE.md 文档
 2026-06-16 22:39:32 +08:00
JOJO
b4030c386e refactor(frontend): 颜色 token 系统两层重构 + 三主题填色 + 去半透明 
将前端配色从散落的硬编码/双命名体系（--claude-* / --theme-*）重构为
两层 token 结构（原始层 + 中性语义层），并按"经典抄 Claude、浅色抄
ChatGPT、深色自研"的定位完成三主题填色，同时建立 stylelint 防回退栏杆。
代码大量由 AI 生成的历史遗留配色问题（同语义多值、跨主题塌缩、强调色
撞文字色、fallback 第二真相源等）在此一并收口。

== 一、Token 结构重构（_tokens.scss）==
- 重写为两层：原始层 + 语义层；组件只引用中性语义名
  （--surface-* / --text-* / --border-* / --accent* / --state-* 等）。
- --claude-* / --theme-* 降级为兼容别名（41 个转发），迁移完成后删除。
- 三主题（classic / light / dark）+ 首屏回退（:root:not([data-theme])，
  与经典同值）全部补齐，结构对齐、不再缺项。

== 二、三主题填色 ==
- 经典 = Claude 官网亮色盘：暖奶油表面阶梯
  canvas #faf9f5 < soft #f5f0e8 < card #efe9de < cream-strong #e8e0d2
  < 纯白浮起；文字 #141413；hairline #e6dfd8；暖橙 primary #cc785c。
- 浅色 = ChatGPT 亮色盘：冷白 #ffffff / 侧栏 #f9f9f9 / 嵌套 #f3f3f3，
  中性灰文字，近黑 primary #181818。
- 深色 = 自研中性灰阶，本轮完全不动（原样保留）。
- 修复塌缩 bug：强调色在 light/dark 原被误填成灰（CTA 失去品牌色），
  现统一回品牌 primary；light 表面原全塌成 #ffffff（过于平面），
  现按灰阶拉开层次。
- 强调色克制（CTA-only voltage）：primary 仅用于发送按钮/logo 等极少
  数处；hover / 选中 / 运行态一律走中性灰（运行态指示器从 amber 改灰）。
- 对话区背景从纯白改为暖奶油 canvas；个人空间下拉菜单、git 状态条、
  二级菜单等收口到统一语义色。

== 三、全面去半透明 ==
- 所有实体面板/二级菜单背景改为不透明（surface token 由半透明白改实色，
  --mobile-menu 三亮色主题改实色）。
- 移除已不透明面板上失效的 backdrop-filter 磨砂（移动端菜单、右键菜单、
  模型模式下拉等）。
- 遮罩 scrim（--overlay-scrim）与刻意玻璃质感装饰保留半透明。

== 四、块展开底色统一 ==
- 思考/工具块展开区底色统一为对话背景色：.collapsible-block 及其 header
  背景由 --surface-soft 改 transparent，与堆叠块（stacked-block）一致，
  消除"单块奶油底 vs 多块透明"的不一致。

== 五、布局修复 ==
- 工作区隐藏后残留空白：.workspace-panel--collapsed 补 flex-basis:0 +
  width/min-width:0，修正 flex-basis:auto 被子元素内容宽度撑开导致内联
  width:0 失效、collapsed 后仍占 ~300px 的问题。

== 六、防回退栏杆（新增）==
- 新增 .stylelintrc.cjs：三条规则拦截裸 hex / rgb()|hsl() 字面色 /
  var(--x, fallback) 兜底 / prefers-color-scheme；存量未清理文件用
  BASELINE_EXEMPT 临时豁免（现仅剩 5 个 admin 页面，本轮按用户要求不处理），
  清理一个移除一个、不再回退。
- package.json：build 脚本接入 stylelint（tsc → stylelint → vite），
  新增 lint:css 脚本及 stylelint/postcss-scss/postcss-html 依赖。
- 修复 25 处 \!important 笔误（zsh 历史扩展污染导致的无效 CSS）。

== 七、辅助脚本（新增 scripts/）==
- lint_check.py：Node 环境不可用时的 stylelint 替身（复刻三规则 + 括号
  校验，支持多行声明检测）。
- color_map.py：硬编码色 → token 反查，判定可映射/野色。
- strip_fallback.py：安全剥离已定义 token 的冗余 fallback。

== 八、文档 ==
- CLAUDE.md / AGENTS.md 前端设计规范更新：颜色规则扩写为三主题定位 +
  两层 token + 表面层次 + 强调色克制 + color-mix 派生 + stylelint 栏杆；
  新增"实体面板禁止半透明"规则；"禁止边缘光晕"补充"仅在用户明确允许
  或要求时才可使用"。

注：前端构建验证（npm run build / lint:css）由用户本机完成；AI 工具
上下文 Node v24 段错误无法运行 node/npm/vite/stylelint。

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
 2026-06-06 16:20:58 +08:00
JOJO
582f292114 feat(release): 新增开箱启动脚本 setup.sh / start.sh（P4 第一步） 
为 release 开箱即用提供入口，把首启向导串进启动流程。Python/Node 均
依赖系统已装运行时（不内置解释器），便携包只带源码 + venv 创建逻辑。

- _bootstrap.sh: 共享引导逻辑（被 source）
  - ensure_python_env: 系统 python 建/复用 .venv，装 requirements.lock.txt
  - ensure_node_env: 系统 node 装 easyagent 依赖 + 前端构建（缺失才装）
  - has_env_file: 首启判断
- setup.sh: 初始化入口 → 备好环境 → 跑 python -m scripts.setup 向导
- start.sh: 启动入口 → 备好环境 → 无 .env 自动跑向导 → python -m server.app
  （透传参数给 server.app，如 --thinking-mode）
- CLAUDE.md: Build & Run 增加开箱方式（./setup.sh / ./start.sh）与
  requirements.lock 说明

验证：bash -n 语法通过；_bootstrap 函数逻辑（ROOT 定位 / 选系统 python /
has_env_file / node_modules 已存在时跳过）实测正确；setup 向导在系统
Python 3.9 下端到端跑通（含写文件），确认 from __future__ annotations
使新式类型注解在 3.9 兼容。

注：实际「建 venv + 联网装依赖 + 解压验证」需在本机网络环境执行；
沙箱内仅做了不联网的逻辑校验。

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
 2026-06-01 17:19:45 +08:00
JOJO
b8a51c1c63 refactor(config): 移除硬编码模型残留，部署级配置外置到 ~/.agents 
## 模型逻辑清理
早期把模型 API 端点/密钥/模型 ID 硬编码的残留（AGENT_API_* / THINKING_* /
TITLE_* 三件套）已彻底移除。模型配置统一由 config/custom_models.json
（经 model_profiles 解析为档案）描述，运行时通过 apply_profile 注入；
没有任何可用模型时按既定行为报错。

- config/api.py: 删 9 个三件套符号，仅保留 DEFAULT_RESPONSE_MAX_TOKENS
- utils/api_client.py: client 改为空配置起步，移除三件套 import
- server/chat_flow_helpers.py: 删死 import（TITLE_* 符号）

## 部署级配置外置（按"决策权归谁"分类）
config/*.json 不再一概锚定源码树：
- 程序能力（docker_risk_markers / skill_hints）留源码树，随版本演进
- 部署者自定义（custom_models / host_workspaces / auto_approval /
  goal_review / forbidden_commands / host_sandbox_policy）外置到
  ~/.agents/<mode>/config/

新增统一解析机制（config/paths.py）：
- DEPLOY_CONFIG_DIR（默认 ~/.agents/<mode>/config，可用环境变量覆盖）
- resolve_deploy_config()：只读，回退链 部署目录→源码树.json→源码树.example
  （开发环境不必先跑 setup 也能用源码树种子）
- deploy_config_path()：写回用，稳定指向部署目录

6 个加载点改用上述解析；顺带修复 approval_agent / goal_review_agent 的
DEBUG_TRANSCRIPT_DIR 仍指旧源码树 logs/ 的漏迁问题。

## 安全与运维
- 含密钥/机器特定的 5 个文件停止 git 追踪（git rm --cached，本地保留）
  并加入 .gitignore，仓库仅留 .example 种子；forbidden_commands 保留
  追踪作默认黑名单
- scripts/setup.py: 模型配置写到部署目录（用与 paths 一致的独立推导，
  不 import config 以免过早锁定路径）
- scripts/migrate_runtime_data.py: 新增 config/*.json → 部署目录迁移
  （备份 + 不覆盖已存在）

## 关联：P1 配置收敛 + P2 首启向导
- config/server.py: Web 端口/监听地址/debug/NODE_BIN/PYTHON_BIN 单一事实源
- 消灭 8091 多处重复定义（state.py 死代码、app_legacy、main.py 各读各的）
- 修复 sub_agent_manager 命令数组硬编码 "node" → NODE_BIN（便携包内置
  Node 的前提）
- scripts/setup.py: 终端首启向导（模式/端口/管理员/密钥/模型）

## 测试
test_config_paths_resolution 更新以反映新行为（host_workspaces 锚定部署
目录、新增 DEPLOY_CONFIG_DIR 用例）；全部离线用例通过。

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
 2026-06-01 16:59:34 +08:00
JOJO
eaa5e3bee9 refactor(runtime): 运行态数据迁出源码树到 ~/.agents，日志默认关并加轮转，清理实验残留 
将运行态数据（对话/用户工作区/日志等）默认迁出源码树到 ~/.agents/<mode>，
对齐 ~/.claude、~/.codex 惯例；同时为日志加上开关与轮转，并归档/清理仓库内
长期堆积的实验残留与误产生文件。

## 路径变量重写（核心）
- 重写 config/paths.py：运行态根按模式分流，host -> ~/.agents/host，
  其它（默认 docker/web）-> ~/.agents/web。
- 三级解析优先级（高→低）：
  1) 具体目录变量 DATA_DIR / LOGS_DIR / USER_SPACE_DIR / API_USER_SPACE_DIR
  2) 模式根变量 AGENTS_HOST_HOME / AGENTS_WEB_HOME
  3) 兜底 ~/.agents/<mode>
- 导出变量名保持不变，20+ 处消费方零改动；统一 config/sub_agent.py 重复的
  路径解析逻辑，将 sub_agent 任务目录/状态文件收编进 DATA_DIR；
  SUB_AGENT_PROJECT_RESULTS_DIR 仍随工作区（有意保留）。
- config/*.json、prompts/、agentskills/ 属配置/资源，仍锚定源码树。

## 日志止血
- 新增 utils/log_rotation.py：按大小轮转（默认 20MB×3 份）+ 按份清理
  （dump 默认保留最近 30 个），阈值可由 AGENT_LOG_ROTATE_MAX_BYTES /
  AGENT_LOG_ROTATE_BACKUPS / AGENT_DUMP_KEEP 覆盖。
- utils/api_client.py：API 请求体 dump 默认关闭（AGENT_API_DUMP_ENABLED 开启），
  收编两处写死的 logs/ 硬编码路径改用 LOGS_DIR；dump 关闭时 request_dump 安全置空。
- utils/host_workspace_debug.py、server/utils_common.py（chunk/conn_diag 等）、
  utils/logger.py（TaskLogger/ErrorLogger）统一接入轮转。

## 迁移与运维脚本
- scripts/migrate_runtime_data.py：源码树 -> 运行态根，复制+备份+校验+可回滚+幂等，
  logs 丢弃不迁；import config 复用程序同一套路径解析（模式由 .env 决定），
  覆盖 data/users/api 及 sub_agent/tasks（-> data/sub_agent_tasks）。
- scripts/cleanup_misplaced_web.sh：清理误迁到 ~/.agents/web 的副本（带 chflags 兜底）。

## 测试
- 重写 test/test_config_paths_resolution.py：覆盖默认分流、模式切换、模式根变量覆盖、
  具体目录变量最高优先级、相对路径锚定 repo root、源码树配置项不随迁移等 6 个用例。

## 仓库清理
- 删除旧版子智能体目录 sub_agent/（逻辑已统一在 easyagent/）。
- 删除误产生/垃圾文件：误敲命令生成的 "ystemctl status ..."、空文件 .zhouyanbo /
  testfile_from_ai、运行态日志/pid、test_playwright.png、test_system_message.py 等。
- 实验残留与历史文档（BUG_FIX/POLLING 变更日志、SUB_AGENT 文档、翻译资料、
  model_tests、compact_result、奇奇怪怪的bug、截图、goal_research）归档到
  本地 _experiments/，并从版本控制移除（已加入 .gitignore）。
- .gitignore：新增 api/、_experiments/，清理已失效的 sub_agent/* 条目与冗余项。

## 文档
- CLAUDE.md / AGENTS.md：补充数据目录与路径变量、日志策略、迁移流程，
  更新目录结构（移除 sub_agent、新增 _experiments/scripts），调试日志路径改为 ~/.agents/<mode>/logs/。
 2026-06-01 13:17:32 +08:00
JOJO
0815625cfd docs: 前端改动不强制本地构建（沙箱无法跑 build） 
Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
 2026-05-31 17:55:03 +08:00
JOJO
fc70179b02 feat(web): 统一前端设计风格并重写回顾/版本管理弹窗 
- 将 8 条前端设计风格原则写入 CLAUDE.md 与 AGENTS.md
- 重写对话回顾弹窗：扁平化去圆角套娃、移除彩色光晕、固定高度、
  自定义关闭按钮、滚动条隐藏、颜色全走三模式变量
- 回顾弹窗改用独立列表 state，加载更多改为追加不刷新、不复位滚动，
  按钮样式对齐侧边栏（全宽/文字靠左/固定高度）
- 后端 get_conversation_list 新增 non_empty 参数，回顾弹窗仅显示
  有内容的对话且分页数量一致（侧边栏不受影响）
- 重写版本管理弹窗：原生 select/checkbox 换自定义下拉与开关、
  拆圆角套娃、固定高度、颜色走变量（diff 红绿语义色保留）
- 版本管理开关旁文字随状态显示开启/关闭
- icons 注册 refreshCw 键

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
 2026-05-31 11:30:08 +08:00
JOJO
3fd2214da0 feat(compression): 深压缩改为 in-place 标记前缀，不再切换新对话 
深压缩从"建新对话+切过去"重构为标记当前对话历史前缀(deep_compacted)：
原文保留并照常显示，仅在 build_messages 构建请求时排除。conversation_id
不变，避免任务状态/目标模式/前端对话切换的大量适配带来的 bug。

- deep_compression.py: _mark_history_compacted 打标 + 重置 current_context_tokens
  防自动续接死循环；总结请求传入正常 tools 以 100% 命中前缀缓存
- context.py build_messages: 跳过 deep_compacted 消息
- conversation.py /compress: 去掉切对话，按 compress_behavior 决定续接/等待
- 新增个性化设置 deep_compress_form(file/inject) 与
  deep_compress_behavior(continue/wait，仅手动压缩生效)
- 前端去掉强制切换对话，改为重载当前对话刷新展示
- AGENTS.md/CLAUDE.md: 补充默认中文交流约定等说明

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
 2026-05-30 20:56:15 +08:00
JOJO
1bda147a6f fix: 完善工具约束与项目文档说明 2026-04-10 14:33:41 +08:00
JOJO
7e03e3cd5f feat: stabilize context compression and deep-compact flow 2026-04-06 15:12:25 +08:00
JOJO
12c7a4bdd9 fix: remove legacy file edit tags 2026-03-17 22:43:51 +08:00
JOJO
09654b7d4b fix: stabilize conversation loading 2025-11-29 23:13:11 +08:00