# 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 的长期知识条目。