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

32 Commits

Author SHA1 Message Date
JOJO
4e1d08f106 fix(frontend): 修复多个前端交互问题 
- 修复运行时 intent Unicode 转义显示异常（后端 extract_intent_from_partial 解码）
- 修复 ask_user 弹窗问题/说明不换行
- 修复刷新页面后等待回答提示不恢复（添加 fetchPendingUserQuestions 并在初始化路径调用）
- 修复回答问题弹窗长问题撑满窗口（header/context 限高滚动）
- 修复角色编辑器模型选择菜单定位与滚动
- 在 AGENTS.md 中再次强调前端调试日志必须统一筛选词

测试：/Library/Developer/CommandLineTools/Library/Frameworks/Python3.framework/Versions/3.9/bin/python3.9 -m unittest test.test_server_refactor_smoke; npm run build
 2026-07-15 00:31:13 +08:00
JOJO
351cd311c2 fix(multi-agent): 修复压缩404、prompt冻结串扰、子智能体状态串扰及/multiagent/new跳转问题 2026-07-14 23:22:06 +08:00
JOJO
ce92697181 feat(multi_agent): add formatters and structured rendering for multi-agent tools 2026-07-14 22:14:55 +08:00
JOJO
58ec936a8c docs(agents): 补充多智能体模式章节 §11 
包含角色/实例、执行机制、消息池与派发链路（含情况1/2/3
和 4 条硬约束）、通知池独立、渲染判断、调试日志、已知坑
与对话切换状态保留等所有 Agent 改代码必须知道的约束。
 2026-07-13 20:13:38 +08:00
JOJO
e3c897947f refactor(paths): 统一迁移运行态数据路径到 Astrion 命名空间 
- 工作区内部路径 .agents/ -> .astrion/
- 默认运行态数据根 ~/.agents/agents/ -> ~/.astrion/astrion/
- 环境变量 AGENTS_DATA_ROOT -> ASTRION_DATA_ROOT（无兼容）
- 同步更新代码、测试、文档与脚本中的路径引用
- 新增 .gitignore 忽略 .astrion/ 与 .agents/ 运行态目录
 2026-07-10 00:35:15 +08:00
JOJO
15106e7d00 feat(branding): 将产品名统一为 Astrion 
- 前端页面标题、登录/注册页、左侧栏、聊天头部、教程欢迎语全部改为 Astrion
- CLI 欢迎面板与状态栏改为 Astrion CLI
- 后端启动日志与 setup 向导改为 Astrion
- package.json 与 README 标题同步更新
- 主 system prompt 增加 Astrion 自我介绍，视觉模型 prompt 文件名从 qwenvl 改为 vl
- 项目记忆与 AGENTS.md/CLAUDE.md 新增产品名说明
 2026-07-07 18:17:48 +08:00
JOJO
ed9bbeecb7 feat(frontend): 子智能体结果添加统计信息并规范 meta/content 分区 
- create_sub_agent 增强显示增加工作时间、调用次数、工具次数
- 将统计信息与最终回复放入 tool-result-content（结果区）
- 工具参数保留在 tool-result-meta（参数区）
- 在 AGENTS.md 新增 §5.6 工具结果显示规范
 2026-06-25 12:38:58 +08:00
JOJO
b4080f3880 docs: update runtime data paths and project status to 2026-06 2026-06-21 22:46:25 +08:00
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
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
a224537618 docs: add precise reading guideline 2026-05-31 17:28:51 +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
672110c213 docs: adjust agent reporting rules 2026-05-29 14:10:34 +08:00
JOJO
bed194386a fix(mobile): align conversation overlay in app 2026-05-28 20:50:44 +08:00
JOJO
f61a8df6fa feat: add blocking user question tool 2026-05-28 16:30:55 +08:00
JOJO
92ca6e460e docs(agents): allow direct main development 2026-05-28 14:30:44 +08:00
JOJO
cc9df7959a feat(cli): 新增 React/Ink CLI 端，修复全屏布局与光标定位 
## 新增：基于 React/Ink 的 CLI 终端（cli/）

使用 Ink 框架构建完整的终端 UI，取代原有的纯 print 交互方式：

- App.tsx：主应用组件，管理对话状态、任务轮询、键盘输入、slash 命令
- components.tsx：Timeline、Composer、StatusLine、Picker、SlashMenu 等全部 UI 组件
- eventMapper.ts：将后端 SSE 事件流映射为 Timeline 条目，支持 thinking/tool/assistant/sub_agent 等类型
- api.ts：封装所有后端 REST 接口（任务、对话、模型、权限、工作区等）
- commands.ts：slash 命令定义（/new /resume /model /permission /execution /workspace /compact /tools 等）
- workspaces.ts：本地工作区目录的持久化管理
- types.ts：所有共享类型定义
- format.ts：context 格式化、路径缩写等工具函数

## 重大修复：去除固定高度全屏模式，恢复滚轮滚动

**问题根因**：根 Box 设置了 `height={stdout.rows}` 使 Ink 进入原地重绘模式
（类似 vim/htop），所有内容在同一块屏幕区域反复擦写，永远不会真正
"滚出"屏幕顶部，导致 terminal 的 scrollback buffer 始终为空，鼠标
滚轮无任何响应。

**修复方案**：
- 移除根 Box 的 `height` 约束和 `overflow="hidden"`
- 移除内层 Box 的 `flexGrow`/`justifyContent="flex-end"` 全屏布局
- Timeline 不再做行数截断，直接渲染全部条目
- 内容自然流入 terminal scrollback buffer，鼠标滚轮恢复正常

**同步清理**：删除 `getTimelineMaxRows`、`estimateTimelineRows`、
`scrollOffset` 状态及方向键滚动逻辑（这些都是全屏模式下的补丁，
去除固定高度后不再需要）

## 修复：Composer 光标位置偏移一行

`setCursorPosition` 中 y 轴使用 `lines.length` 导致单行时偏移 +1。
改为 `lines.length - 1`，与实际最后一行渲染位置对齐。

## 其他

- AGENTS.md / README.md：补充 CLI 启动方式与架构说明
- server/chat.py：补充任务轮询接口所需字段
- package.json：新增 cli 相关脚本入口
- docs/cli_slash_commands_spec.md、docs/cli_ui_display_spec.md：CLI 设计文档

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
 2026-05-16 01:06:51 +08:00
JOJO
8d665ad6de feat(permission): add auto-approval mode with approval agent, UI flow, and docs sync 
Implemented a new permission mode  between  and , including backend policy, runtime behavior, frontend display, and documentation updates.

Backend & policy changes:

- Added  to permission mode validation and persistence paths.

- Updated tool permission evaluation: workspace-local  direct pass, out-of-workspace requires approval.

- Kept  readonly-first flow and added auto-approval decision path when permission denial occurs.

- Added approval reason/decider support in tool approval manager.

- Improved rejection tool-content format to natural language: '工具调用被拒绝\n原因：...'

- Fixed permission-mode sync edge cases on conversation create/load and restart-first-switch behavior.

Approval agent subsystem:

- Added  and .

- Added lightweight auto-approval config at  (name/url/key/model/extra_params + timeouts).

- Added optional transcript debug switch in code and transcript output under logs/approval_agent.

- Aligned transcript saving toward cumulative messages format and captured reasoning/content/tool_calls/tool sequence.

Frontend changes:

- Added  option to personalization and permission menus.

- Reworked approval panel auto-review display into a dedicated block with simplified lines: start, command, final approve/reject + reason.

- Added delayed sidebar auto-close (10s) after approval resolved.

- Added stricter permission-switch verification and rollback on mismatch/error.

Docs updated:

- Synced AGENTS.md, README.md, and docs/host_sandbox_and_permission_model.md with new permission mode, approval-agent behavior, config, and current constraints (including docker caveat).
 2026-05-11 17:55:27 +08:00
JOJO
a93f17010c feat(security): unify host sandbox controls across command/python/terminal/sub-agent and add path authorization UI 
This commit lands a broad host-security architecture update focused on enforceable sandbox execution, clearer permission semantics, and operator usability.

Core execution/security changes
- Introduce and wire a unified host sandbox runner for multi-OS execution:
  - macOS: sandbox-exec
  - Linux: bubblewrap + seccomp
  - Windows: WSL2 path
- Remove silent fallback behavior in failure paths; sandbox-unavailable cases now fail closed instead of dropping to unsafe host execution.
- Ensure host execution mode (sandbox/direct) is propagated consistently into runtime components, including sub-agent startup.

Permission mode model upgrade
- Rework readonly/approval behavior for run_command from brittle command-text gating to execution-layer enforcement:
  - readonly: run_command executes in read-only sandbox profile.
  - approval: run_command first executes read-only; when permission-denied is detected, request approval and retry once with writable sandbox for that single call.
- Tool loop now returns final post-approval execution result, not intermediate permission-denied payloads.
- Update permission-mode system messaging to describe user-visible behavior without exposing internal implementation details.

Path authorization system
- Add dynamic host policy module and persisted policy file.
- Support dual path classes:
  - writable_paths (read+write)
  - readable_extra_paths (read-only)
- Enforce file access in file_manager by access type (read vs write) under host mode.
- Add host-only frontend 路径授权 management dialog (settings三级菜单入口), including mode switch between 可读可写 and 仅可读 with separate drafts and save flow.

Sub-agent and terminal alignment
- Sub-agent process launch now respects host execution mode and sandbox controls in host mode.
- Keep terminal session model compatible with sandbox-first behavior and execution-mode propagation.

Tool surface updates
- Remove legacy file-management tools from active tool definitions (create_file/create_folder/rename_file/delete_file) while preserving historical conversation compatibility.

Docs updates
- Add dedicated architecture doc: docs/host_sandbox_and_permission_model.md
- Refresh README and AGENTS sections to reflect updated permission/execution model and path-authorization semantics.

Validation performed
- python unittest smoke suite passes: test.test_server_refactor_smoke
- frontend build passes: npm run build
- syntax checks for touched Python modules completed
 2026-05-11 13:41:30 +08:00
JOJO
cfffc8e4ef docs(agents): simplify git workflow — remove PR and review 2026-04-27 23:58:59 +08:00
JOJO
54e8c8c0fb docs(agents): add CLI troubleshooting and fix cleanup commands (#2) 2026-04-27 23:48:50 +08:00
JOJO
2799608051 docs(agents): add comprehensive git workflow and review spec 2026-04-27 23:31:14 +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
7f7a7e9f94 docs: refresh README and guidelines 2025-12-16 18:35:15 +08:00
JOJO
fea932425a chore: initial import 2025-11-14 16:44:12 +08:00