GPU_GUARD_MONOREPO/docs/code-wiki/raw/transcripts/2026-04-19-git-audit-48b4a5b-head.md

Local Audit Source — git range 48b4a5b..HEAD

本文件是 2026-04-19 对 48b4a5b..HEAD 的本地 git 审计快照，作为本次 code-wiki 增量更新的原始来源层。 来源类型：本地仓库 git log --oneline + git diff --name-only + 关键源码阅读。 约定：此文件为原始来源记录，不在后续 wiki 更新中就地改写。

基线

• Wiki 上次摄入记录：48b4a5b
• 审计日期：2026-04-19
• 审计范围：48b4a5b..HEAD

关键提交（按时间倒序）

• 215b46d 完成 Neta 会话子Agent委派功能与聚合修复
• b932264 chore(repo): commit remaining workspace changes
• c198bb5 feat(netaclaw): add tool governance and agent tool controls
• c187fde fix(agent-chat): refine history view toggle behavior
• 089d507 fix(agent-fe): 修正 contextWindow 单位换算
• f3aec00 fix(netaclaw-be): 补齐缺失的 /session/contextTokens 接口
• b712536 fix(agent-fe): token-stats 静态显示修复 — tokenContext 增加本地估算 fallback
• b2fa690 fix(agent-fe): 压缩事件被 loading 守卫拦截导致前端无响应
• 8fdae94 fix(netaclaw): 修复压缩前端无响应 + 视图切换无效
• 5dd29d9 fix(compaction): phase2 边界检测越界
• c22e265 fix: 代码审查修复 — 并发安全、XSS、队列上限、视图切换
• 40e4d7c fix(agent-fe): ChatMessage 类型支持 compaction 角色并修正 chat.ts 变量名
• d32eeb1 feat(agent-fe): 新增压缩/完整历史视图切换 + token-stats 新 props 接入
• 62a949f feat(agent-fe): 模型渠道管理支持 isAuxiliary 标记
• 852e94b feat(agent-fe): Agent 编辑页新增上下文压缩配置子区域
• dbe0bd4 feat(agent-fe): 新增压缩事件气泡组件
• 45d39bb feat(agent-fe): 新增 parseSlashCommand + /compact 命令拦截
• 9002698 feat(agent-fe): chat store 新增 compactionState + 压缩事件处理
• 9faaef6 feat(agent-fe): 新增前端 Protocol 类型定义同步后端压缩相关事件
• d295ab3 feat(agent-fe): token-stats 重构为进度条
• e1b6204 feat(netaclaw): Gateway 集成自动/手动压缩触发 + token 估算修正
• 7fc1a4e feat(netaclaw): Protocol 新增压缩相关 WS 事件类型
• 0c05cf9 feat(netaclaw): SessionService 增加 view 参数支持压缩/完整历史切换
• c11af60 feat(netaclaw): 新增 CompactionService
• f74abe2 feat(netaclaw): 新增 AuxiliaryLLMClient
• bdcf314 feat(netaclaw): 新增 token_utils.ts
• a6d68f6 feat(netaclaw): 新增 LLMMessageWithId 接口供压缩流程使用
• ae6338b feat(netaclaw): 扩展 Entity 字段支持上下文压缩

与本次 wiki 直接相关的变更文件

后端

• packages/backend/src/modules/netaclaw/entity/tool.ts
• packages/backend/src/modules/netaclaw/entity/subagent_session.ts
• packages/backend/src/modules/netaclaw/entity/agent.ts
• packages/backend/src/modules/netaclaw/entity/message.ts
• packages/backend/src/modules/netaclaw/entity/model_channel.ts
• packages/backend/src/modules/netaclaw/controller/admin/tool.ts
• packages/backend/src/modules/netaclaw/controller/agent.ts
• packages/backend/src/modules/netaclaw/controller/session.ts
• packages/backend/src/modules/netaclaw/gateway/protocol.ts
• packages/backend/src/modules/netaclaw/gateway/server.ts
• packages/backend/src/modules/netaclaw/gateway/session.ts
• packages/backend/src/modules/netaclaw/runtime/compaction.ts
• packages/backend/src/modules/netaclaw/runtime/prompt_builder.ts
• packages/backend/src/modules/netaclaw/runtime/token_utils.ts
• packages/backend/src/modules/netaclaw/service/chat_orchestrator.ts
• packages/backend/src/modules/netaclaw/service/subagent.ts
• packages/backend/src/modules/netaclaw/service/tool_registry.ts
• packages/backend/src/modules/netaclaw/service/tool_resolver.ts
• packages/backend/src/modules/netaclaw/tools/catalog.ts

前端

• packages/frontend/src/modules/agent/views/tools.vue
• packages/frontend/src/modules/agent/views/agent-edit.vue
• packages/frontend/src/modules/agent/views/chat.vue
• packages/frontend/src/modules/agent/views/model-channel.vue
• packages/frontend/src/modules/agent/store/chat.ts
• packages/frontend/src/modules/agent/components/subagent-batch-card.vue
• packages/frontend/src/modules/agent/components/compaction-bubble.vue
• packages/frontend/src/modules/agent/components/token-stats.vue
• packages/frontend/src/modules/agent/types/index.d.ts
• packages/frontend/src/modules/agent/types/protocol.ts
• packages/frontend/src/modules/agent/utils/slash_command.ts
• packages/frontend/src/modules/agent/config.ts

审计结论摘要

本次真实代码变更可归纳为三块：

1. 上下文压缩与历史视图

   • 新增 CompactionService
   • 支持 /compact 手动压缩与阈值自动压缩
   • 会话消息支持 compacted/full 两种历史视图
   • 新增压缩相关 WS 事件和前端气泡展示

2. Tool 全局治理与 Agent 级工具配置

   • 新增 netaclaw_tool 全局治理表
   • Catalog 与 DB 同步
   • 运行时由 tool_resolver 统一决策可用工具、禁用原因和 Prompt Hint
   • 前端新增 /agent/tools 管理页，Agent 编辑页支持逐工具启停和子代理约束

3. 会话级子 Agent 委派

   • 新增 netaclaw_subagent_session 持久化记录
   • chat_orchestrator 负责 assistant 占位消息与批次聚合 metadata
   • 新增 subagent_batch_start / subagent_update / subagent_done 事件
   • 前端以 subagent-batch-card 组件展示批量执行状态

注意

• packages/backend/analyze_cert.py
• packages/backend/marriage_cert.jpg
• packages/backend/marriage_cert_analysis_report.txt
• packages/backend/order_list.yml
• packages/backend/sql/20260418_netaclaw_session_subagent.sql

以上文件已被用户明确判定为应删除或已删除，不纳入本次 wiki 的长期知识条目。