GPU_GUARD_MONOREPO/docs/code-wiki/log.md

# Wiki Log

> 所有 wiki 操作的时间线记录。仅追加。
> 格式：`## [YYYY-MM-DD] 操作 | 主题`
> 操作类型：ingest, update, query, lint, create, archive, delete
> 当此文件超过 500 条记录时，重命名为 `log-YYYY.md` 并重新开始。

## [2026-05-15] update | MySQL 数据源与问数系统写入 code-wiki
- 来源：当前未提交的 MySQL 数据源管理、只读问数工具、SQL guard、schema/sample/query 服务、查询审计、菜单同步和前端数据源管理页代码。
- 新增 entities/mysql-data-source.md：记录“系统管理 -> 数据源管理”、`netaclaw_data_source`、`netaclaw_data_source_query_audit`、密钥加密、连接池、`mysql_*` 工具、SQL guard、schema/sample 修复和 `data-analyst-mysql` prompt skill。
- 更新 entities/netaclaw-module.md：补入 MySQL 数据源子系统、19 张 NetaClaw 表和相关页面互链。
- 更新 entities/tool-system.md、entities/tool-catalog.md、entities/tool-governance.md：登记 `mysql` toolset、`builtin/mysql.ts`、main-process-proxy 路由和服务端安全边界。
- 更新 entities/base-module.md、concepts/frontend-architecture.md：补入“数据源管理”动态菜单同步、页面职责、端口输入与测试连接行为。
- 更新 entities/skill-system.md、comparisons/database-entity-overview.md：补入 `data-analyst-mysql` 与数据源/审计表字段。
- 更新 index.md：总页面数更新为 39，并登记 `[[mysql-data-source]]`。

## [2026-05-14] ingest | 5e18dbf2..HEAD 微信本地群聊代理与 Desktop Op 写入 code-wiki
- 来源：git log `5e18dbf2..HEAD`，重点核对 2026-05-08 微信群聊渠道设计与修复、2026-05-14 weixin-db 本地代理、v4 双 Agent 自动回复、`weixin_send_text` 和 `desktop_op` 通用桌面 GUI Agent 模块。
- 新增 entities/desktop-op-module.md：记录 `packages/backend/src/modules/desktop_op/` 的运行时拓扑、WeixinAdapter、per-key 队列、全局键鼠互斥、AbortSignal 取消和 `desktop_op_config` / `desktop_op_action_log`。
- 更新 entities/agent-channel.md：从旧 ClawBot 口径扩展为 `weixin` 私聊 + `weixin-db` 群聊代理，补入 WAL watcher、增量解密、群白名单、每群 Agent 覆盖、Clarify/risk 降级和 v4 双 Agent 自动回复。
- 更新 entities/netaclaw-module.md：登记 `netaclaw_agent_channel_group`，把 NetaClaw 表数更新为 17，并把 Desktop Op 加入核心关系。
- 更新 entities/tool-system.md：登记 `weixin_send_text` 工具、`weixin_desktop` toolset、bizContext/currentAgent 运行时上下文、Desktop Op 主进程代理和 60 秒同步等待。
- 更新 concepts/frontend-architecture.md：补入频道管理页的 weixin-db、wxid 唯一性校验、群聊管理和微信自动回复配置区块。
- 更新 comparisons/database-entity-overview.md：登记 `netaclaw_agent_channel_group`、`desktop_op_config` 和 `desktop_op_action_log` 字段速查。
- 更新 entities/project-overview.md 与 index.md：同步后端模块数、总页面数 37、推荐入口和 2026-05-14 增量摘要。

## [2026-05-07] ingest | b4d244c6..HEAD 图像生成、过程事件、Geo 与 Netabrowser 写入 code-wiki
- 来源：git log `b4d244c6..HEAD`，重点核对 2026-05-03 图像生成工具、2026-05-07 Skill process events / vehicle-damage-inspection、Geo S1 infrastructure、Netabrowser CLI 与 backend browser-daemon。
- 新增 entities/image-generation-tools.md：记录 `text_to_image`、`image_to_image`、Ark/MiniMax provider、ImageStorageService、Tool Catalog/Governance/Resolver/前端 renderer 链路。
- 新增 concepts/runtime-process-events.md：记录 `RuntimeProcessEvent`、`ProcessEventBuffer`、payload 脱敏、JSONL 落盘、execute_skill 桥接和前端过程时间线。
- 新增 entities/vehicle-damage-skill.md：记录 `vehicle-damage-inspection` compute-entry Skill 的抽帧、检测、grounding、复核、证据帧和 workspace 产物。
- 新增 entities/geo-module.md：记录 `geo_account`、`geo_proxy_ip`、账号/IP 1:1 绑定、sessionName、fingerprintSeed、cookie 抓取和 Geo 前端页面。
- 新增 entities/netabrowser-runtime.md：记录 `packages/netabrowser-cli`、后端 `browser-daemon`、patchright/neta-chromium、拟人化交互、SOCKS5 HTTP bridge、profile/state 生命周期和相关 Skills。
- 更新 entities/project-overview.md、entities/netaclaw-module.md、entities/tool-system.md、entities/skill-system.md、entities/websocket-gateway.md、concepts/skill-runtime.md、concepts/frontend-architecture.md、comparisons/database-entity-overview.md：同步新增模块、工具、Skill、过程事件、数据库和前端入口。
- 更新 index.md：总页面数更新为 37，并登记新增页面摘要。

## [2026-05-02] ingest | 56eed8c..HEAD Skill Runtime、Tool Operations 与文档 Skills 写入 code-wiki
- 来源：git log `56eed8c..HEAD`，重点核对 2026-04-27 Skill 系统演进设计、2026-05-01 Tool Pluggable Operations 设计与落地提交、2026-04-27~2026-05-02 后端/前端/skills 代码变更。
- 新增 concepts/tool-operations.md：记录 `ToolOperations`、`FileOperations`、`ProcessOperations`、`SearchOperations`、LocalOperations、resolver 注入、ANSI 剥离和后续远程/沙箱替换点。
- 新增 concepts/skill-runtime.md：记录 prompt / compute-entry / compute-toolkit 分类、`skill.config.yaml`、`execute_skill`、`SkillExecutorService`、skill scoped secrets、诊断码和前端配置入口。
- 新增 entities/document-skills.md：登记 `minimax-pdf`、`minimax-docx`、`minimax-xlsx` 三组文档处理 Skills 及其脚本、references、OpenXML/XLSX/PDF 处理边界。
- 更新 entities/skill-system.md：从旧 prompt-only 口径改为分类、配置、密钥、诊断、ToolResolver 注入和 `execute_skill` 口径。
- 更新 entities/tool-system.md、entities/tool-governance.md、concepts/tool-runtime-policy.md：补入 Operations 执行后端层、高风险 bash 工具确认、`execute_skill` 路由和治理/Policy/Operations 三者边界。
- 更新 concepts/frontend-architecture.md：补入 ChatComposer 工具确认 UI、Skill 管理页分类/诊断/secrets 配置和安装 setup 确认。
- 更新 entities/netaclaw-module.md、entities/project-overview.md、comparisons/database-entity-overview.md：同步 Skill Runtime、Tool Operations、文档 Skills、`netaclaw_skill.secrets/envSchema` 和推荐阅读顺序。
- 更新 index.md：总页面数更新为 32，并登记新增页面与相关摘要。

## [2026-04-13] create | Wiki 初始化
- 领域：Neta AI 电商平台代码知识库。
- 创建目录结构：SCHEMA.md, index.md, log.md, raw/, entities/, concepts/, comparisons/, queries/。
- 基于项目源码和初始架构分析创建第一批 wiki 页面。

## [2026-04-13] ingest | 初始全项目代码分析
- 来源：Neta-monorepo 项目源码和 CLAUDE.md。
- 创建核心实体页：project-overview、netaclaw-module、agent-runtime、websocket-gateway、tool-system、memory-system、skill-system、llm-providers、base-module、project-module、cool-admin-framework。
- 创建核心概念页：react-loop、frontend-architecture、development-conventions。
- 创建对比页：database-entity-overview。

## [2026-04-14] ingest | 近期代码变更增量分析
- 来源：git log 07ae148..HEAD。
- 新增 crew-orchestration、agent-channel、todo-system、thinking-system 等页面。
- 更新 skill-system、tool-system、netaclaw-module、llm-providers、websocket-gateway、agent-runtime、project-module、project-overview、database-entity-overview。

## [2026-04-16] ingest | 62b12fc..48b4a5b 新功能摄入
- 来源：git log 62b12fc..HEAD。
- 新增 clarify-tool、patch-tool、tool-catalog、prompt-builder。
- 更新 tool-system、agent-runtime、websocket-gateway、agent-channel、netaclaw-module。

## [2026-04-19] ingest | 48b4a5b..HEAD 真实代码变更回填
- 来源：raw/transcripts/2026-04-19-git-audit-48b4a5b-head.md。
- 新增 tool-governance、subagent-session、context-compaction。
- 更新 agent-runtime、tool-system、tool-catalog、websocket-gateway、netaclaw-module、prompt-builder、database-entity-overview、project-overview。
- index.md 登记到 26 个页面。

## [2026-04-21] update | Agent runtime kernel 架构变更写入 code-wiki
- 来源：近期 Agent runtime kernel、Session Tree、Subagent Worker、Tool Manifest/Runtime Policy、前端 Agent 页面重构代码。
- 新增 concepts/session-tree-runtime.md：记录 Session Tree provider、entry 类型、snapshot、active path、前端恢复和持久化边界。
- 新增 concepts/tool-runtime-policy.md：记录工具 manifest、worker policy 自动推导、worker-local/main-process-proxy/disabled 路由和 blocked reason。
- 更新 entities/agent-runtime.md：从线性 ReAct 说明改为 Session Tree + ChatOrchestrator + ToolResolver + Subagent Worker 架构口径。
- 更新 entities/subagent-session.md：补全独立 worker 进程、JSONL 协议、proxy tool call、subagent_batch/subagent_result 节点。
- 更新 entities/tool-governance.md：补全 runtimeDiagnostic、effectiveRuntimeProfile、effectiveSubagentAllowed、工具管理页和 Agent 编辑页 projection 一致性。
- 更新 entities/tool-system.md：补全内置工具分组、主 Agent 执行、子 Agent 工具路由、前端 renderer registry。
- 更新 concepts/frontend-architecture.md：补全 Agent Chat Store 的 session tree snapshot 状态、对话页滚动/恢复、工具治理页和 Agent 编辑页职责。
- 更新 concepts/context-compaction.md：从线性消息压缩改为 Session Tree compaction 节点和 active path 口径。
- 更新 index.md：用干净中文重写目录，登记 28 个页面。

## [2026-04-23] update | 子 Agent 回放投影与会话树继续发送写入 code-wiki
- 来源：git log 403702f..HEAD，以及 backend/frontend 中 session-tree、subagent、chat store、chat.vue 的真实实现。
- 更新 entities/agent-runtime.md：补充 `gateway/session.ts` 的 `projectSubagentSnapshot()` / `projectSubagentEntry()` 边界，说明后端 canonical subagent projection 已成为运行时契约。
- 更新 entities/subagent-session.md：补充 evidence summary 构建、`finalOutput/rawFinalContent/toolResults/processEvents` 结果载荷，以及 `subagent_batch` 与 `subagent_result` 的职责分层。
- 更新 concepts/session-tree-runtime.md：补充 continue-from-entry 交互、leaf 切换/分叉规则，以及 `metadata.subagentProjection` 的 snapshot 契约。
- 更新 concepts/frontend-architecture.md：补充 chat store 的 `selectedEntryId` / `pendingLeafConfirmation` 等状态、对话页继续发送目标提示和子 Agent 回放诊断面板。
- 更新 index.md：同步更新目录摘要，去除已经过时的“仅 worker/session tree 节点”级别描述。

## [2026-04-23] update | code-wiki 全面体检与入口页校准
- 来源：继续核对 403702f..HEAD 期间 gateway/server.ts、gateway/protocol.ts、gateway/session.ts、tool_resolver.ts、tools.vue、agent-edit.vue 以及相关实体定义。
- 更新 entities/tool-system.md：补充结构化 `rawResult`、resolver 最终输出、子 Agent `toolRuntimeRoutes` 和对话页运行中工具事件。
- 更新 entities/tool-governance.md：补充 `runtimeDiagnostic`、`toolRuntimeRoutes`、renderer capability，以及工具管理页 / Agent 编辑页 / 对话页的职责分层。
- 更新 entities/websocket-gateway.md：修正旧事件名，改写为 `subagent_run_started`、`subagent_event`、`subagent_run_completed`、`session_entry_*`、`session_leaf_changed`、`assistant_stream_*` 等当前协议。
- 更新 entities/netaclaw-module.md：补充 `session-tree/`、`subagent/` 目录，修正为 15 张实体表，并区分 legacy session/message 与 session-tree 主路径。
- 更新 concepts/tool-runtime-policy.md：补充静态画像与动态路由的区别。
- 更新 entities/tool-catalog.md：补充 catalog 到 registry/resolver/manifest 的角色边界。
- 更新 concepts/context-compaction.md：补充 legacy `compactedAt` 兼容路径与 Session Tree 主路径的区别。
- 更新 entities/project-overview.md：补充当前 AI 快速熟悉项目的推荐阅读顺序，并把 Agent 模块入口调整到 Session Tree 时代口径。

## [2026-04-26] ingest | f493b15..HEAD 记忆管理、Windows runtime 与会话删除修复写入 code-wiki
- 来源：git log f493b15..HEAD，重点核对 2026-04-25 Windows installer/tray/dataDir 变更、2026-04-26 memory management 变更、Agent chat 展示修复，以及当前未提交的 MySQL session-tree 删除修复。
- 新增 concepts/windows-runtime.md：记录 backend.exe 打包、Inno Setup 安装器、.NET 托盘、runtime info、dataDir、`/app/base/runtime/status|stop` 本机控制接口和托盘密钥边界。
- 更新 entities/memory-system.md：从旧的静默 prefetch 模型改写为 MemoryProviderRegistry + 显式 `memory_recall` + `memory_save/list_types/stats` 工具体系；补充 `netaclaw_memory_type`、管理 API、`/agent/memory` 页面和 MySQL/SQLite 双后端分页统计。
- 更新 entities/project-overview.md：登记 `packages/windows-tray/`、`/agent/memory` 入口和 Windows 本地部署子系统。
- 更新 concepts/frontend-architecture.md：补充记忆管理页职责、会话删除时使用会话自身 `agentId`、bash/tool 参数持久展示。
- 更新 concepts/session-tree-runtime.md：补充 session-tree 删除语义，说明后端从 `netaclaw_agent_session` 反查真实 `agentId` 以选择正确 provider。
- 更新 entities/netaclaw-module.md 与 comparisons/database-entity-overview.md：把 NetaClaw 表数更新到 16，并登记 `netaclaw_memory_type`。
- 更新 index.md：总页数更新为 29，并同步 Memory、Windows runtime、Session Tree、前端架构等摘要。