Skip to content

feat(agent): Skill Hub + 沙箱只读 / 可写开关(只读时拦截写类工具) - #230

Merged
avabbbb merged 1 commit into
mainfrom
feat/agent-skill-hub
Nov 19, 2026
Merged

avabbbb merged 1 commit into
mainfrom
feat/agent-skill-hub

Conversation

@avabbbb

@avabbbb avabbbb commented Nov 19, 2026

Copy link
Copy Markdown
Owner

What and why / 改了什么、为什么

让用户看得到 Agent 会按什么方法做事(Skill Hub),并能把它关进「只读」沙箱:只查、只给建议,不改任何数据。基于 #222 的技能注册表(packages/core/src/agent/skills.ts),不改技能内容和自动加载逻辑。

  • Skill Hub:GET /api/agent/skills 返回注册表目录(skillCatalog():id、标题、什么时候用、触发词(由 triggers 正则拆成可读关键词)、完整方法、示例说法 example)+ 沙箱说明。前端 AgentSkillHub 对话框(/skills 打开):搜索、触发词紫色小胶囊、展开看方法、「试一下」把示例填进输入框(命中触发词 → 自动加载该技能)。
  • 沙箱开关:新增 packages/core/src/agent/sandbox.ts。Run 请求带 sandbox: "read_only" | "workspace_write"(默认可写;非法值 400)。只读时 applySandbox 包一层:白名单放行读类工具(overview / search / list / get / changes / read_file / find_files / web_search / fetch_page / reconcile_memory / export_data / tool_manual / skill_read / request_user_input,email_sync 仅 action=status),其余(含将来新加的工具)一律不执行,回 {ok:false, error:{code:"read_only", message, retryable:false, suggestedAction}},描述前加「只读模式下不可用」。模式记进 run.llm_runtime.sandbox,续跑 / 回答 Ask 时沿用。ToolErrorCode 加 read_only。
  • host.ts 只动了三处:RunOptions.sandbox、tools 外包 applySandbox、llm_runtime 记 sandbox;没碰上下文窗口 / MAX_STEPS。
  • 前端开关三处同一设置:输入框「模式」菜单(写入确认 + 沙箱两组)、Skill Hub 底部分段开关、/readonly /write;只读时模式胶囊显示锁 +「只读」。
  • docs/design/components.md、docs/route-coverage.md 同步。无表结构变更。

怎么测的 / Testing

  • backend-ts: 新增 Skill Hub 目录契约、只读 Run(save 被拦成 read_only 结构化错误、overview 照常、记忆没写入、写类工具描述标注、llm_runtime 记模式、非法 sandbox 400)、可写 Run 照常写入;agent-sandbox.test.ts(模式解析、白名单 / 未知工具算写 / email_sync 读写、包装行为);vitest ✅ 224、typecheck ✅。
  • frontend: 新增 AgentSkillHub.test.tsx(筛选、列表 / 触发词 / 展开方法 / 试一下、沙箱切换、加载失败)、AgentComposerControls 模式菜单用例;typecheck ✅、vitest ✅ 287、design:audit ✅ 0 new、build ✅。

风险 / Risk

  • 低
  • 中:工具执行路径多一层包装(只在只读时生效;可写时原样返回同一组工具)
  • 高

怎么撤回 / How to revert

revert 这个 PR;无数据变更(沙箱选择存在浏览器 localStorage 的 composer 设置里)。

Checklist

  • Tests or checks run / 已运行测试或检查
  • AI-assisted / AI 辅助:yes

@avabbbb
avabbbb merged commit bd61e0c into main Nov 19, 2026
13 checks passed
@avabbbb
avabbbb deleted the feat/agent-skill-hub branch November 19, 2026 07:50
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant