| 文件 | 最后提交记录 | 最后更新时间 |
|---|---|---|
feat(cannbot-insight): v1.51→v1.67——root 编排对账重构、Skill 加载校验、Audit 阶段诊断增强 Co-authored-by: duanbingzhe<duanbingzhe@huawei.com> # message auto-generated for no-merge-commit merge: !808 merge feature/update-cannbot-insight into master feat(cannbot-insight): v1.51→v1.67——root 编排对账重构、Skill 加载校验、Audit 阶段诊断增强 Created-by: duanbingzhe Commit-by: duanbingzhe Merged-by: cann-robot Description: ## 描述 版本 v1.51 → v1.67。合并多轮功能迭代，71 个文件变更（57 修改 + 14 新增，+4903 / -624）。核心聚焦三类审计/校验能力，其余为配套增强。 ## root 对账编排声明提取重构 - 新增 recoverWorkflowDeclaration 及辅助 resolveWorkflowSkillName / recoverSkillResourceFile - 优先级：skill resources 文件（task-prompts.md）> SKILL.md body > turn0 注入(≥500字) > null - 不再用 STATE.md / todowrite（属"任务完成度"，非"编排规程遵循度"） - 新增设计文档 docs/workflow-plan-extraction-design.md ## Skill 加载校验（新功能） - 新增 SkillContentAudit 组件 + use-skill-content-audit hook + skill-content-audit API - 校验每个 skill 是否在会话内读取完整 SKILL.md：Skill 工具注入即全文；Read 需无 offset/limit 且无截断标记才判全文，否则部分读取 - chip 三态（全文 / 部分 / 未读），点击 chip 在表格展开该 skill 行 ## Audit 增强 - v4 agent 树默认隐藏全部通过的子 agent（勾选开关才显示） - 跨 agent 问题与优化优先级每项给证据（agent:<name> #turn，可点击跳转）；审计头部展示本次消耗 token 数 - 新增 StageBreakdownTable + StageBreakdownRow 类型：6 阶段（extract/refine/headline/rebuild/judge/postprocess）墙钟+token 诊断，区分 LLM vs 程序阶段 - finding / aggregate 增加 source_excerpt（bullet 原文）、headline（人话标题）、turn_refs（证据 turn 序号，可点击跳转） ## Skills tab 增强 - 恢复展示 dispatch 的 subagent 行（此前被误删） - 新增 agent-content API：从磁盘扫 agent .md（AGENTS_SCAN_ROOT），多插件按 session dispatch 覆盖率消歧 ## smart-agent 增强 - trajectory_analyzer 新增 AdaptiveLimiter（自适应并发：激进出高限、撞限流乘性回退、窗口清了爬回）与 _is_rate_or_timeout 判别 - 重构 _audit_one_agent / _aggregate_session；subagent 桥接写入复刻 Claude Code subagent 存储结构 - jsonl_logger 支持 append 模式；server.py analyze_logger 改 append=False ## 零依赖导出 Session DB - 新增 export-db.mjs：从 opencode.db 或 Claude Code JSONL 提取单个 session（含子会话）为独立文件 - 零依赖：仅需 Node.js >= 22（内置 node:sqlite），无需 npm install / Prisma / 后端 - 自动识别框架，支持 --list / -s / -o / --json；README 新增"方式三" ## CLI upload 增强 - 支持 --session-id（非交互指定）、--list、--yes / --json、--description - README 重写上传文档（opencode / Claude Code 分开示例 + 参数表）；路径修正 sessions.db → opencode.db ## Turns 与概念追踪交互 - Turn 快速跳转：输入 turn 编号（如 #459）回车直达；subagent turn 自动展开祖先 dispatch lane - 概念追踪高亮跳转：搜索结果点击 View Turn 跳转 Turns tab，自动展开并高亮关键词至匹配位置 - 新增纯函数 src/lib/shared/highlight.tsx（highlightKeyword，大小写不敏感，<mark> 包裹） ## 测试与文档 - 新增 cannbot-insight adapter、opencode-db adapter、delete-session API、skill-content-audit API、trace-turn-highlight、turn-timeline-jump 等集成测试；skill-eval-audit 测试 +615 行 - README / README-zh 功能列表与 tab 描述同步；AGENTS.md 补充相关说明 See merge request: cann/cannbot-skills!808 | 8 天前 | |
feat(cannbot-insight): 同步 v1.51（v1.03 → v1.51） Co-authored-by: duanbingzhe<duanbingzhe@huawei.com> # message auto-generated for no-merge-commit merge: !731 merge fix/CleanCode into master feat(cannbot-insight): 同步 v1.51（v1.03 → v1.51） Created-by: duanbingzhe Commit-by: duanbingzhe Merged-by: cann-robot Description: ## 描述 cannbot-insight 功能更新，版本 v1.03 → v1.48。本次新增七大功能，新增 114 个文件、修改 48 个、移除 4 个（旧 Workflow/AI Workflow tab）。主线为 性能可观测（Performance 全景）、文件循迹重建、会话对齐，Audit 工作流审计作为 preview 先行合入承接后续迭代。 一、Performance 性能全景 全新的独立 Performance tab，一站式 session 级性能与成本可观测。所有数据直读 DB、零 LLM 依赖——确定性、可重复、即开即用，不受审计结果波动影响。 PerfPanorama 性能全景三大面板： 1. perf top — 子代理耗时排行（Linux top 风格） - 可排序表格（TURNS / TIME / TOKENS / AVG·T），活跃列箭头指示，列宽稳定不偏移 - 占比条形图：当前值占总量比例，条色随排序键切换（TIME 红 / TOKENS 蓝 / TURNS 灰），一眼锁定最耗资源的子代理 - 点击下钻：展开该子代理 turn 列表（§N + 耗时 + tokens + tools + model），默认 Top 10、一键展开全部 2. Token 成本分析 — 精准定位优化空间 - Cache 节省量卡片：命中缓存（绿）vs 未命中冷输入（红）的量与占比，直指 compaction 后重复输入的浪费 - 每轮 Cache 命中率趋势线（SVG 折线 + 面积渐变），compaction 事件自动标注（命中率骤降点），低命中轮次（<50%）标红 - 与 perf top 联动：下钻 turn 行增加 cache 命中率列，低命中高亮，形成「定位问题 turn → 跳转排查」闭环 3. Top 工具调用 — 耗时瓶颈定位 - 全 session 工具按 durationMs 降序 Top 10，水平条形图，标签 toolName §turnIndex - 点击直接跳转 turns tab 对应 turn 净耗时归因（关键能力）：主 Agent 耗时自动扣除并行子代理等待时间（max(bridge.subagentLatencyMs)），还原主 Agent 真实工作时间，避免被子代理壁钟时间虚高——这是判断「主 Agent 是真慢还是在等子代理」的核心依据。 7 张总览卡片：主 Agent 耗时(净) / 子代理耗时 / 总 Tokens / Cache 命中率 / 主 Agent turns / 子代理 sessions / 工具调用，响应式 grid（2/3/6 列）。 交互与性能：可折叠全景、懒挂载（切 tab 不卸载不 re-fetch）、onJumpToTurn 回调定位。设计文档 docs/performance-tab-design.md。 v1.48 同时完成 perf2→perf 整合，并移除旧 Workflow tab 与 AI Workflow tab（删除 WorkflowAIView.tsx/WorkflowTreeView.tsx/prompts/workflow-analyse.md），其能力由 Performance + Audit 承接。 二、文件循迹重建 - File Content Restore（循迹复卷）：每文件行一键按时间戳拼合本会话内 read/write 片段重建全文（后写入者覆盖先前），未被读取行标注 --line N not found --；兼容 claude（N\t）与 opencode（<content> 信封 + N: ）两种 Read 格式，支持下载/收起。API GET /api/observe/session/file-restore + 纯函数库 src/lib/file-restore.ts。 - Gather & Rebuild Directory（重编汇册）：一键按路径树重建本会话工作目录下全部被读/写文件并打包下载 zip，服务端构建二进制响应（不在页面展开全部内容）。纯函数库 src/lib/zip-store.ts（buildZip/crc32/normalizeZipPath，STORE 无压缩 + UTF-8 文件名标志位兼容 Windows 中文路径）。API GET /api/observe/session/dir-restore。 - Skill Content（SKILL.md 全文）：每个 skill 可点击展示/下载全文，优先取原生 Skill 工具注入的 resultJson（剥前导），回退 Read of */SKILL.md（剥行号），多次加载取最长版本。API GET /api/observe/session/skill-content。 三、Session Compare — turn 对齐 - banded-DP turn 对齐算法：两个 session 逐 turn 对齐，Web Worker 后台计算不阻塞 UI，ComparePanorama 全景对比 token/费用/耗时/工具调用/subagent。含正确性与性能基准（tests/compare-perf/：banded-dp-correctness、turn-align.bench、api-n+1-elimination、render-smoke）。新增 src/lib/compare/turn-align.ts/turn-align.worker.ts。 四、增量刷新 Auto-refresh 探测源 DB 变化后增量导入（auto-refresh-probe.ts），支持 SSE 流式进度推送，适配 Claude Code JSONL 与 opencode DB。新增 API /api/observe/auto-refresh、/api/observe/auto-refresh-stream，e2e fixture 覆盖 append-turn/idle-assistant/streaming 场景。 五、CLI 与配置 - CLI export-md：导出 session 为 Markdown（与 Web UI 导出/audit step 1 同源输出），供轨迹分析器消费。src/cli/commands/export-md.ts。 - AI Provider 配置：settings 页面 + AIProviderConfigPanel，为审计配置 OpenAI 兼容 provider（baseUrl/apiKey/model）。 - agent-md-scan / agent-version：扫描本地 agent .md、提取版本号。 六、Audit 审计（持续完善中） - Audit tab 拆两个子 tab：Workflow audit（v1-v4，preview）+ Skill audit（接入 skill-eval 对账「真实执行 vs SKILL.md」：五态 verdict、可过滤 findings、by-instruction 表、实时进度条流式百分比）。 - Session Trajectory Analyzer：自建轻量 agent，正则预处理 + 有界 LLM 循环（≤3 轮）分析 10 万+ 行轨迹 MD，无需 Claude Code；Python 版 smart-agent/ + TS 版双端对齐，HTTP 服务 + Next.js 代理路由，Audit tab 可切 v1(TS)/v2(Python)。 - Audit 结果 JSON 导入/导出（audit-export.ts）。 七、性能优化 - 导入流水线 create → createMany + $transaction，单 session 35-100x 加速（23.5s→1.6s），batch 分批（500 条/批）防 SQLite 变量溢出 - opencode-db 适配器 N+1 消除：listSessions ~200+ → 5-6 次批量查询；readSession N×3 → 3 次 - 大 session 事务超时 5s → 60s，解决 "Transaction already closed" 八、移除项 移除 替代 Workflow tab（WorkflowAIView.tsx/WorkflowTreeView.tsx） Performance tab + Audit tab prompts/workflow-analyse.md session-trajectory-analyse.md + trajectory-compress.md tests/start-script.test.ts tests/start-sh-validation.test.ts 九、测试覆盖 新增 45 个测试文件，覆盖上述能力：zip-store(11)、skill-content(20)、file-restore(26)、dir-restore-api、skill-eval-audit、audit-job/audit-export、turn-align/-hard/-stress/-manual、compare-perf/*、claude-autorefresh*、agent-md-scan、trajectory-analyzer、cannbay-archive、upload-session-api、start-sh-validation 等。 同步内容为 skills-dev main 已提交状态，未带入开发仓未提交改动；package-lock.json 按 .gitignore 约定不入库；版本号 VERSION = "1.48"。 关联的Issue <!-- 本次为版本同步发布，暂无对应 Issue。cannbot-insight 大版本跳跃建议在本 PR 评审期间于 Discussions 同步说明。 --> 测试 - cannbot-insight 单元/集成测试：cd plugins-community/cannbot-insight && npm install && npm test（vitest，新增 45 个测试文件） - 仓库级 CI 闸门：./tests/gate_check.sh、./tests/run-tests.sh --fast - 4 个抽样文件 hash 已校验与 skills-dev main blob 一致，确保未带入未提交改动 文档更新 - README.md：Features 列表新增 Performance / 循迹复卷 / 重编汇册 / SKILL.md 全文 / Skill audit 描述 - CHANGELOG.md：补齐 v1.37-v1.40 条目 - 新增设计文档：docs/architecture.md、docs/performance-tab-design.md、docs/audit-skill-subtab-design.md、docs/session-trajectory-analyzer-design.md - 新增 smart-agent/README.md See merge request: cann/cannbot-skills!731 | 17 天前 | |
feat(cannbot-insight): 同步 v1.51（v1.03 → v1.51） Co-authored-by: duanbingzhe<duanbingzhe@huawei.com> # message auto-generated for no-merge-commit merge: !731 merge fix/CleanCode into master feat(cannbot-insight): 同步 v1.51（v1.03 → v1.51） Created-by: duanbingzhe Commit-by: duanbingzhe Merged-by: cann-robot Description: ## 描述 cannbot-insight 功能更新，版本 v1.03 → v1.48。本次新增七大功能，新增 114 个文件、修改 48 个、移除 4 个（旧 Workflow/AI Workflow tab）。主线为 性能可观测（Performance 全景）、文件循迹重建、会话对齐，Audit 工作流审计作为 preview 先行合入承接后续迭代。 一、Performance 性能全景 全新的独立 Performance tab，一站式 session 级性能与成本可观测。所有数据直读 DB、零 LLM 依赖——确定性、可重复、即开即用，不受审计结果波动影响。 PerfPanorama 性能全景三大面板： 1. perf top — 子代理耗时排行（Linux top 风格） - 可排序表格（TURNS / TIME / TOKENS / AVG·T），活跃列箭头指示，列宽稳定不偏移 - 占比条形图：当前值占总量比例，条色随排序键切换（TIME 红 / TOKENS 蓝 / TURNS 灰），一眼锁定最耗资源的子代理 - 点击下钻：展开该子代理 turn 列表（§N + 耗时 + tokens + tools + model），默认 Top 10、一键展开全部 2. Token 成本分析 — 精准定位优化空间 - Cache 节省量卡片：命中缓存（绿）vs 未命中冷输入（红）的量与占比，直指 compaction 后重复输入的浪费 - 每轮 Cache 命中率趋势线（SVG 折线 + 面积渐变），compaction 事件自动标注（命中率骤降点），低命中轮次（<50%）标红 - 与 perf top 联动：下钻 turn 行增加 cache 命中率列，低命中高亮，形成「定位问题 turn → 跳转排查」闭环 3. Top 工具调用 — 耗时瓶颈定位 - 全 session 工具按 durationMs 降序 Top 10，水平条形图，标签 toolName §turnIndex - 点击直接跳转 turns tab 对应 turn 净耗时归因（关键能力）：主 Agent 耗时自动扣除并行子代理等待时间（max(bridge.subagentLatencyMs)），还原主 Agent 真实工作时间，避免被子代理壁钟时间虚高——这是判断「主 Agent 是真慢还是在等子代理」的核心依据。 7 张总览卡片：主 Agent 耗时(净) / 子代理耗时 / 总 Tokens / Cache 命中率 / 主 Agent turns / 子代理 sessions / 工具调用，响应式 grid（2/3/6 列）。 交互与性能：可折叠全景、懒挂载（切 tab 不卸载不 re-fetch）、onJumpToTurn 回调定位。设计文档 docs/performance-tab-design.md。 v1.48 同时完成 perf2→perf 整合，并移除旧 Workflow tab 与 AI Workflow tab（删除 WorkflowAIView.tsx/WorkflowTreeView.tsx/prompts/workflow-analyse.md），其能力由 Performance + Audit 承接。 二、文件循迹重建 - File Content Restore（循迹复卷）：每文件行一键按时间戳拼合本会话内 read/write 片段重建全文（后写入者覆盖先前），未被读取行标注 --line N not found --；兼容 claude（N\t）与 opencode（<content> 信封 + N: ）两种 Read 格式，支持下载/收起。API GET /api/observe/session/file-restore + 纯函数库 src/lib/file-restore.ts。 - Gather & Rebuild Directory（重编汇册）：一键按路径树重建本会话工作目录下全部被读/写文件并打包下载 zip，服务端构建二进制响应（不在页面展开全部内容）。纯函数库 src/lib/zip-store.ts（buildZip/crc32/normalizeZipPath，STORE 无压缩 + UTF-8 文件名标志位兼容 Windows 中文路径）。API GET /api/observe/session/dir-restore。 - Skill Content（SKILL.md 全文）：每个 skill 可点击展示/下载全文，优先取原生 Skill 工具注入的 resultJson（剥前导），回退 Read of */SKILL.md（剥行号），多次加载取最长版本。API GET /api/observe/session/skill-content。 三、Session Compare — turn 对齐 - banded-DP turn 对齐算法：两个 session 逐 turn 对齐，Web Worker 后台计算不阻塞 UI，ComparePanorama 全景对比 token/费用/耗时/工具调用/subagent。含正确性与性能基准（tests/compare-perf/：banded-dp-correctness、turn-align.bench、api-n+1-elimination、render-smoke）。新增 src/lib/compare/turn-align.ts/turn-align.worker.ts。 四、增量刷新 Auto-refresh 探测源 DB 变化后增量导入（auto-refresh-probe.ts），支持 SSE 流式进度推送，适配 Claude Code JSONL 与 opencode DB。新增 API /api/observe/auto-refresh、/api/observe/auto-refresh-stream，e2e fixture 覆盖 append-turn/idle-assistant/streaming 场景。 五、CLI 与配置 - CLI export-md：导出 session 为 Markdown（与 Web UI 导出/audit step 1 同源输出），供轨迹分析器消费。src/cli/commands/export-md.ts。 - AI Provider 配置：settings 页面 + AIProviderConfigPanel，为审计配置 OpenAI 兼容 provider（baseUrl/apiKey/model）。 - agent-md-scan / agent-version：扫描本地 agent .md、提取版本号。 六、Audit 审计（持续完善中） - Audit tab 拆两个子 tab：Workflow audit（v1-v4，preview）+ Skill audit（接入 skill-eval 对账「真实执行 vs SKILL.md」：五态 verdict、可过滤 findings、by-instruction 表、实时进度条流式百分比）。 - Session Trajectory Analyzer：自建轻量 agent，正则预处理 + 有界 LLM 循环（≤3 轮）分析 10 万+ 行轨迹 MD，无需 Claude Code；Python 版 smart-agent/ + TS 版双端对齐，HTTP 服务 + Next.js 代理路由，Audit tab 可切 v1(TS)/v2(Python)。 - Audit 结果 JSON 导入/导出（audit-export.ts）。 七、性能优化 - 导入流水线 create → createMany + $transaction，单 session 35-100x 加速（23.5s→1.6s），batch 分批（500 条/批）防 SQLite 变量溢出 - opencode-db 适配器 N+1 消除：listSessions ~200+ → 5-6 次批量查询；readSession N×3 → 3 次 - 大 session 事务超时 5s → 60s，解决 "Transaction already closed" 八、移除项 移除 替代 Workflow tab（WorkflowAIView.tsx/WorkflowTreeView.tsx） Performance tab + Audit tab prompts/workflow-analyse.md session-trajectory-analyse.md + trajectory-compress.md tests/start-script.test.ts tests/start-sh-validation.test.ts 九、测试覆盖 新增 45 个测试文件，覆盖上述能力：zip-store(11)、skill-content(20)、file-restore(26)、dir-restore-api、skill-eval-audit、audit-job/audit-export、turn-align/-hard/-stress/-manual、compare-perf/*、claude-autorefresh*、agent-md-scan、trajectory-analyzer、cannbay-archive、upload-session-api、start-sh-validation 等。 同步内容为 skills-dev main 已提交状态，未带入开发仓未提交改动；package-lock.json 按 .gitignore 约定不入库；版本号 VERSION = "1.48"。 关联的Issue <!-- 本次为版本同步发布，暂无对应 Issue。cannbot-insight 大版本跳跃建议在本 PR 评审期间于 Discussions 同步说明。 --> 测试 - cannbot-insight 单元/集成测试：cd plugins-community/cannbot-insight && npm install && npm test（vitest，新增 45 个测试文件） - 仓库级 CI 闸门：./tests/gate_check.sh、./tests/run-tests.sh --fast - 4 个抽样文件 hash 已校验与 skills-dev main blob 一致，确保未带入未提交改动 文档更新 - README.md：Features 列表新增 Performance / 循迹复卷 / 重编汇册 / SKILL.md 全文 / Skill audit 描述 - CHANGELOG.md：补齐 v1.37-v1.40 条目 - 新增设计文档：docs/architecture.md、docs/performance-tab-design.md、docs/audit-skill-subtab-design.md、docs/session-trajectory-analyzer-design.md - 新增 smart-agent/README.md See merge request: cann/cannbot-skills!731 | 17 天前 | |
feat(cannbot-insight): v1.51→v1.67——root 编排对账重构、Skill 加载校验、Audit 阶段诊断增强 Co-authored-by: duanbingzhe<duanbingzhe@huawei.com> # message auto-generated for no-merge-commit merge: !808 merge feature/update-cannbot-insight into master feat(cannbot-insight): v1.51→v1.67——root 编排对账重构、Skill 加载校验、Audit 阶段诊断增强 Created-by: duanbingzhe Commit-by: duanbingzhe Merged-by: cann-robot Description: ## 描述 版本 v1.51 → v1.67。合并多轮功能迭代，71 个文件变更（57 修改 + 14 新增，+4903 / -624）。核心聚焦三类审计/校验能力，其余为配套增强。 ## root 对账编排声明提取重构 - 新增 recoverWorkflowDeclaration 及辅助 resolveWorkflowSkillName / recoverSkillResourceFile - 优先级：skill resources 文件（task-prompts.md）> SKILL.md body > turn0 注入(≥500字) > null - 不再用 STATE.md / todowrite（属"任务完成度"，非"编排规程遵循度"） - 新增设计文档 docs/workflow-plan-extraction-design.md ## Skill 加载校验（新功能） - 新增 SkillContentAudit 组件 + use-skill-content-audit hook + skill-content-audit API - 校验每个 skill 是否在会话内读取完整 SKILL.md：Skill 工具注入即全文；Read 需无 offset/limit 且无截断标记才判全文，否则部分读取 - chip 三态（全文 / 部分 / 未读），点击 chip 在表格展开该 skill 行 ## Audit 增强 - v4 agent 树默认隐藏全部通过的子 agent（勾选开关才显示） - 跨 agent 问题与优化优先级每项给证据（agent:<name> #turn，可点击跳转）；审计头部展示本次消耗 token 数 - 新增 StageBreakdownTable + StageBreakdownRow 类型：6 阶段（extract/refine/headline/rebuild/judge/postprocess）墙钟+token 诊断，区分 LLM vs 程序阶段 - finding / aggregate 增加 source_excerpt（bullet 原文）、headline（人话标题）、turn_refs（证据 turn 序号，可点击跳转） ## Skills tab 增强 - 恢复展示 dispatch 的 subagent 行（此前被误删） - 新增 agent-content API：从磁盘扫 agent .md（AGENTS_SCAN_ROOT），多插件按 session dispatch 覆盖率消歧 ## smart-agent 增强 - trajectory_analyzer 新增 AdaptiveLimiter（自适应并发：激进出高限、撞限流乘性回退、窗口清了爬回）与 _is_rate_or_timeout 判别 - 重构 _audit_one_agent / _aggregate_session；subagent 桥接写入复刻 Claude Code subagent 存储结构 - jsonl_logger 支持 append 模式；server.py analyze_logger 改 append=False ## 零依赖导出 Session DB - 新增 export-db.mjs：从 opencode.db 或 Claude Code JSONL 提取单个 session（含子会话）为独立文件 - 零依赖：仅需 Node.js >= 22（内置 node:sqlite），无需 npm install / Prisma / 后端 - 自动识别框架，支持 --list / -s / -o / --json；README 新增"方式三" ## CLI upload 增强 - 支持 --session-id（非交互指定）、--list、--yes / --json、--description - README 重写上传文档（opencode / Claude Code 分开示例 + 参数表）；路径修正 sessions.db → opencode.db ## Turns 与概念追踪交互 - Turn 快速跳转：输入 turn 编号（如 #459）回车直达；subagent turn 自动展开祖先 dispatch lane - 概念追踪高亮跳转：搜索结果点击 View Turn 跳转 Turns tab，自动展开并高亮关键词至匹配位置 - 新增纯函数 src/lib/shared/highlight.tsx（highlightKeyword，大小写不敏感，<mark> 包裹） ## 测试与文档 - 新增 cannbot-insight adapter、opencode-db adapter、delete-session API、skill-content-audit API、trace-turn-highlight、turn-timeline-jump 等集成测试；skill-eval-audit 测试 +615 行 - README / README-zh 功能列表与 tab 描述同步；AGENTS.md 补充相关说明 See merge request: cann/cannbot-skills!808 | 8 天前 | |
[feat]cannbot-insight tool Co-authored-by: guanxinghua<guanxinghua@huawei.com> # message auto-generated for no-merge-commit merge: !521 merge merge-cannbot-insight into master [feat]cannbot-insight tool Created-by: guanxinghua Commit-by: guanxinghua Merged-by: cann-robot Description: 需求@功能描述： https://gitcode.com/cann/cannbot-skills/issues/377 See merge request: cann/cannbot-skills!521 | 1 个月前 | |
feat(cannbot-insight): v1.51→v1.67——root 编排对账重构、Skill 加载校验、Audit 阶段诊断增强 Co-authored-by: duanbingzhe<duanbingzhe@huawei.com> # message auto-generated for no-merge-commit merge: !808 merge feature/update-cannbot-insight into master feat(cannbot-insight): v1.51→v1.67——root 编排对账重构、Skill 加载校验、Audit 阶段诊断增强 Created-by: duanbingzhe Commit-by: duanbingzhe Merged-by: cann-robot Description: ## 描述 版本 v1.51 → v1.67。合并多轮功能迭代，71 个文件变更（57 修改 + 14 新增，+4903 / -624）。核心聚焦三类审计/校验能力，其余为配套增强。 ## root 对账编排声明提取重构 - 新增 recoverWorkflowDeclaration 及辅助 resolveWorkflowSkillName / recoverSkillResourceFile - 优先级：skill resources 文件（task-prompts.md）> SKILL.md body > turn0 注入(≥500字) > null - 不再用 STATE.md / todowrite（属"任务完成度"，非"编排规程遵循度"） - 新增设计文档 docs/workflow-plan-extraction-design.md ## Skill 加载校验（新功能） - 新增 SkillContentAudit 组件 + use-skill-content-audit hook + skill-content-audit API - 校验每个 skill 是否在会话内读取完整 SKILL.md：Skill 工具注入即全文；Read 需无 offset/limit 且无截断标记才判全文，否则部分读取 - chip 三态（全文 / 部分 / 未读），点击 chip 在表格展开该 skill 行 ## Audit 增强 - v4 agent 树默认隐藏全部通过的子 agent（勾选开关才显示） - 跨 agent 问题与优化优先级每项给证据（agent:<name> #turn，可点击跳转）；审计头部展示本次消耗 token 数 - 新增 StageBreakdownTable + StageBreakdownRow 类型：6 阶段（extract/refine/headline/rebuild/judge/postprocess）墙钟+token 诊断，区分 LLM vs 程序阶段 - finding / aggregate 增加 source_excerpt（bullet 原文）、headline（人话标题）、turn_refs（证据 turn 序号，可点击跳转） ## Skills tab 增强 - 恢复展示 dispatch 的 subagent 行（此前被误删） - 新增 agent-content API：从磁盘扫 agent .md（AGENTS_SCAN_ROOT），多插件按 session dispatch 覆盖率消歧 ## smart-agent 增强 - trajectory_analyzer 新增 AdaptiveLimiter（自适应并发：激进出高限、撞限流乘性回退、窗口清了爬回）与 _is_rate_or_timeout 判别 - 重构 _audit_one_agent / _aggregate_session；subagent 桥接写入复刻 Claude Code subagent 存储结构 - jsonl_logger 支持 append 模式；server.py analyze_logger 改 append=False ## 零依赖导出 Session DB - 新增 export-db.mjs：从 opencode.db 或 Claude Code JSONL 提取单个 session（含子会话）为独立文件 - 零依赖：仅需 Node.js >= 22（内置 node:sqlite），无需 npm install / Prisma / 后端 - 自动识别框架，支持 --list / -s / -o / --json；README 新增"方式三" ## CLI upload 增强 - 支持 --session-id（非交互指定）、--list、--yes / --json、--description - README 重写上传文档（opencode / Claude Code 分开示例 + 参数表）；路径修正 sessions.db → opencode.db ## Turns 与概念追踪交互 - Turn 快速跳转：输入 turn 编号（如 #459）回车直达；subagent turn 自动展开祖先 dispatch lane - 概念追踪高亮跳转：搜索结果点击 View Turn 跳转 Turns tab，自动展开并高亮关键词至匹配位置 - 新增纯函数 src/lib/shared/highlight.tsx（highlightKeyword，大小写不敏感，<mark> 包裹） ## 测试与文档 - 新增 cannbot-insight adapter、opencode-db adapter、delete-session API、skill-content-audit API、trace-turn-highlight、turn-timeline-jump 等集成测试；skill-eval-audit 测试 +615 行 - README / README-zh 功能列表与 tab 描述同步；AGENTS.md 补充相关说明 See merge request: cann/cannbot-skills!808 | 8 天前 | |
feat(cannbot-insight): 同步 v1.51（v1.03 → v1.51） Co-authored-by: duanbingzhe<duanbingzhe@huawei.com> # message auto-generated for no-merge-commit merge: !731 merge fix/CleanCode into master feat(cannbot-insight): 同步 v1.51（v1.03 → v1.51） Created-by: duanbingzhe Commit-by: duanbingzhe Merged-by: cann-robot Description: ## 描述 cannbot-insight 功能更新，版本 v1.03 → v1.48。本次新增七大功能，新增 114 个文件、修改 48 个、移除 4 个（旧 Workflow/AI Workflow tab）。主线为 性能可观测（Performance 全景）、文件循迹重建、会话对齐，Audit 工作流审计作为 preview 先行合入承接后续迭代。 一、Performance 性能全景 全新的独立 Performance tab，一站式 session 级性能与成本可观测。所有数据直读 DB、零 LLM 依赖——确定性、可重复、即开即用，不受审计结果波动影响。 PerfPanorama 性能全景三大面板： 1. perf top — 子代理耗时排行（Linux top 风格） - 可排序表格（TURNS / TIME / TOKENS / AVG·T），活跃列箭头指示，列宽稳定不偏移 - 占比条形图：当前值占总量比例，条色随排序键切换（TIME 红 / TOKENS 蓝 / TURNS 灰），一眼锁定最耗资源的子代理 - 点击下钻：展开该子代理 turn 列表（§N + 耗时 + tokens + tools + model），默认 Top 10、一键展开全部 2. Token 成本分析 — 精准定位优化空间 - Cache 节省量卡片：命中缓存（绿）vs 未命中冷输入（红）的量与占比，直指 compaction 后重复输入的浪费 - 每轮 Cache 命中率趋势线（SVG 折线 + 面积渐变），compaction 事件自动标注（命中率骤降点），低命中轮次（<50%）标红 - 与 perf top 联动：下钻 turn 行增加 cache 命中率列，低命中高亮，形成「定位问题 turn → 跳转排查」闭环 3. Top 工具调用 — 耗时瓶颈定位 - 全 session 工具按 durationMs 降序 Top 10，水平条形图，标签 toolName §turnIndex - 点击直接跳转 turns tab 对应 turn 净耗时归因（关键能力）：主 Agent 耗时自动扣除并行子代理等待时间（max(bridge.subagentLatencyMs)），还原主 Agent 真实工作时间，避免被子代理壁钟时间虚高——这是判断「主 Agent 是真慢还是在等子代理」的核心依据。 7 张总览卡片：主 Agent 耗时(净) / 子代理耗时 / 总 Tokens / Cache 命中率 / 主 Agent turns / 子代理 sessions / 工具调用，响应式 grid（2/3/6 列）。 交互与性能：可折叠全景、懒挂载（切 tab 不卸载不 re-fetch）、onJumpToTurn 回调定位。设计文档 docs/performance-tab-design.md。 v1.48 同时完成 perf2→perf 整合，并移除旧 Workflow tab 与 AI Workflow tab（删除 WorkflowAIView.tsx/WorkflowTreeView.tsx/prompts/workflow-analyse.md），其能力由 Performance + Audit 承接。 二、文件循迹重建 - File Content Restore（循迹复卷）：每文件行一键按时间戳拼合本会话内 read/write 片段重建全文（后写入者覆盖先前），未被读取行标注 --line N not found --；兼容 claude（N\t）与 opencode（<content> 信封 + N: ）两种 Read 格式，支持下载/收起。API GET /api/observe/session/file-restore + 纯函数库 src/lib/file-restore.ts。 - Gather & Rebuild Directory（重编汇册）：一键按路径树重建本会话工作目录下全部被读/写文件并打包下载 zip，服务端构建二进制响应（不在页面展开全部内容）。纯函数库 src/lib/zip-store.ts（buildZip/crc32/normalizeZipPath，STORE 无压缩 + UTF-8 文件名标志位兼容 Windows 中文路径）。API GET /api/observe/session/dir-restore。 - Skill Content（SKILL.md 全文）：每个 skill 可点击展示/下载全文，优先取原生 Skill 工具注入的 resultJson（剥前导），回退 Read of */SKILL.md（剥行号），多次加载取最长版本。API GET /api/observe/session/skill-content。 三、Session Compare — turn 对齐 - banded-DP turn 对齐算法：两个 session 逐 turn 对齐，Web Worker 后台计算不阻塞 UI，ComparePanorama 全景对比 token/费用/耗时/工具调用/subagent。含正确性与性能基准（tests/compare-perf/：banded-dp-correctness、turn-align.bench、api-n+1-elimination、render-smoke）。新增 src/lib/compare/turn-align.ts/turn-align.worker.ts。 四、增量刷新 Auto-refresh 探测源 DB 变化后增量导入（auto-refresh-probe.ts），支持 SSE 流式进度推送，适配 Claude Code JSONL 与 opencode DB。新增 API /api/observe/auto-refresh、/api/observe/auto-refresh-stream，e2e fixture 覆盖 append-turn/idle-assistant/streaming 场景。 五、CLI 与配置 - CLI export-md：导出 session 为 Markdown（与 Web UI 导出/audit step 1 同源输出），供轨迹分析器消费。src/cli/commands/export-md.ts。 - AI Provider 配置：settings 页面 + AIProviderConfigPanel，为审计配置 OpenAI 兼容 provider（baseUrl/apiKey/model）。 - agent-md-scan / agent-version：扫描本地 agent .md、提取版本号。 六、Audit 审计（持续完善中） - Audit tab 拆两个子 tab：Workflow audit（v1-v4，preview）+ Skill audit（接入 skill-eval 对账「真实执行 vs SKILL.md」：五态 verdict、可过滤 findings、by-instruction 表、实时进度条流式百分比）。 - Session Trajectory Analyzer：自建轻量 agent，正则预处理 + 有界 LLM 循环（≤3 轮）分析 10 万+ 行轨迹 MD，无需 Claude Code；Python 版 smart-agent/ + TS 版双端对齐，HTTP 服务 + Next.js 代理路由，Audit tab 可切 v1(TS)/v2(Python)。 - Audit 结果 JSON 导入/导出（audit-export.ts）。 七、性能优化 - 导入流水线 create → createMany + $transaction，单 session 35-100x 加速（23.5s→1.6s），batch 分批（500 条/批）防 SQLite 变量溢出 - opencode-db 适配器 N+1 消除：listSessions ~200+ → 5-6 次批量查询；readSession N×3 → 3 次 - 大 session 事务超时 5s → 60s，解决 "Transaction already closed" 八、移除项 移除 替代 Workflow tab（WorkflowAIView.tsx/WorkflowTreeView.tsx） Performance tab + Audit tab prompts/workflow-analyse.md session-trajectory-analyse.md + trajectory-compress.md tests/start-script.test.ts tests/start-sh-validation.test.ts 九、测试覆盖 新增 45 个测试文件，覆盖上述能力：zip-store(11)、skill-content(20)、file-restore(26)、dir-restore-api、skill-eval-audit、audit-job/audit-export、turn-align/-hard/-stress/-manual、compare-perf/*、claude-autorefresh*、agent-md-scan、trajectory-analyzer、cannbay-archive、upload-session-api、start-sh-validation 等。 同步内容为 skills-dev main 已提交状态，未带入开发仓未提交改动；package-lock.json 按 .gitignore 约定不入库；版本号 VERSION = "1.48"。 关联的Issue <!-- 本次为版本同步发布，暂无对应 Issue。cannbot-insight 大版本跳跃建议在本 PR 评审期间于 Discussions 同步说明。 --> 测试 - cannbot-insight 单元/集成测试：cd plugins-community/cannbot-insight && npm install && npm test（vitest，新增 45 个测试文件） - 仓库级 CI 闸门：./tests/gate_check.sh、./tests/run-tests.sh --fast - 4 个抽样文件 hash 已校验与 skills-dev main blob 一致，确保未带入未提交改动 文档更新 - README.md：Features 列表新增 Performance / 循迹复卷 / 重编汇册 / SKILL.md 全文 / Skill audit 描述 - CHANGELOG.md：补齐 v1.37-v1.40 条目 - 新增设计文档：docs/architecture.md、docs/performance-tab-design.md、docs/audit-skill-subtab-design.md、docs/session-trajectory-analyzer-design.md - 新增 smart-agent/README.md See merge request: cann/cannbot-skills!731 | 17 天前 | |
feat(cannbot-insight): 同步 v1.51（v1.03 → v1.51） Co-authored-by: duanbingzhe<duanbingzhe@huawei.com> # message auto-generated for no-merge-commit merge: !731 merge fix/CleanCode into master feat(cannbot-insight): 同步 v1.51（v1.03 → v1.51） Created-by: duanbingzhe Commit-by: duanbingzhe Merged-by: cann-robot Description: ## 描述 cannbot-insight 功能更新，版本 v1.03 → v1.48。本次新增七大功能，新增 114 个文件、修改 48 个、移除 4 个（旧 Workflow/AI Workflow tab）。主线为 性能可观测（Performance 全景）、文件循迹重建、会话对齐，Audit 工作流审计作为 preview 先行合入承接后续迭代。 一、Performance 性能全景 全新的独立 Performance tab，一站式 session 级性能与成本可观测。所有数据直读 DB、零 LLM 依赖——确定性、可重复、即开即用，不受审计结果波动影响。 PerfPanorama 性能全景三大面板： 1. perf top — 子代理耗时排行（Linux top 风格） - 可排序表格（TURNS / TIME / TOKENS / AVG·T），活跃列箭头指示，列宽稳定不偏移 - 占比条形图：当前值占总量比例，条色随排序键切换（TIME 红 / TOKENS 蓝 / TURNS 灰），一眼锁定最耗资源的子代理 - 点击下钻：展开该子代理 turn 列表（§N + 耗时 + tokens + tools + model），默认 Top 10、一键展开全部 2. Token 成本分析 — 精准定位优化空间 - Cache 节省量卡片：命中缓存（绿）vs 未命中冷输入（红）的量与占比，直指 compaction 后重复输入的浪费 - 每轮 Cache 命中率趋势线（SVG 折线 + 面积渐变），compaction 事件自动标注（命中率骤降点），低命中轮次（<50%）标红 - 与 perf top 联动：下钻 turn 行增加 cache 命中率列，低命中高亮，形成「定位问题 turn → 跳转排查」闭环 3. Top 工具调用 — 耗时瓶颈定位 - 全 session 工具按 durationMs 降序 Top 10，水平条形图，标签 toolName §turnIndex - 点击直接跳转 turns tab 对应 turn 净耗时归因（关键能力）：主 Agent 耗时自动扣除并行子代理等待时间（max(bridge.subagentLatencyMs)），还原主 Agent 真实工作时间，避免被子代理壁钟时间虚高——这是判断「主 Agent 是真慢还是在等子代理」的核心依据。 7 张总览卡片：主 Agent 耗时(净) / 子代理耗时 / 总 Tokens / Cache 命中率 / 主 Agent turns / 子代理 sessions / 工具调用，响应式 grid（2/3/6 列）。 交互与性能：可折叠全景、懒挂载（切 tab 不卸载不 re-fetch）、onJumpToTurn 回调定位。设计文档 docs/performance-tab-design.md。 v1.48 同时完成 perf2→perf 整合，并移除旧 Workflow tab 与 AI Workflow tab（删除 WorkflowAIView.tsx/WorkflowTreeView.tsx/prompts/workflow-analyse.md），其能力由 Performance + Audit 承接。 二、文件循迹重建 - File Content Restore（循迹复卷）：每文件行一键按时间戳拼合本会话内 read/write 片段重建全文（后写入者覆盖先前），未被读取行标注 --line N not found --；兼容 claude（N\t）与 opencode（<content> 信封 + N: ）两种 Read 格式，支持下载/收起。API GET /api/observe/session/file-restore + 纯函数库 src/lib/file-restore.ts。 - Gather & Rebuild Directory（重编汇册）：一键按路径树重建本会话工作目录下全部被读/写文件并打包下载 zip，服务端构建二进制响应（不在页面展开全部内容）。纯函数库 src/lib/zip-store.ts（buildZip/crc32/normalizeZipPath，STORE 无压缩 + UTF-8 文件名标志位兼容 Windows 中文路径）。API GET /api/observe/session/dir-restore。 - Skill Content（SKILL.md 全文）：每个 skill 可点击展示/下载全文，优先取原生 Skill 工具注入的 resultJson（剥前导），回退 Read of */SKILL.md（剥行号），多次加载取最长版本。API GET /api/observe/session/skill-content。 三、Session Compare — turn 对齐 - banded-DP turn 对齐算法：两个 session 逐 turn 对齐，Web Worker 后台计算不阻塞 UI，ComparePanorama 全景对比 token/费用/耗时/工具调用/subagent。含正确性与性能基准（tests/compare-perf/：banded-dp-correctness、turn-align.bench、api-n+1-elimination、render-smoke）。新增 src/lib/compare/turn-align.ts/turn-align.worker.ts。 四、增量刷新 Auto-refresh 探测源 DB 变化后增量导入（auto-refresh-probe.ts），支持 SSE 流式进度推送，适配 Claude Code JSONL 与 opencode DB。新增 API /api/observe/auto-refresh、/api/observe/auto-refresh-stream，e2e fixture 覆盖 append-turn/idle-assistant/streaming 场景。 五、CLI 与配置 - CLI export-md：导出 session 为 Markdown（与 Web UI 导出/audit step 1 同源输出），供轨迹分析器消费。src/cli/commands/export-md.ts。 - AI Provider 配置：settings 页面 + AIProviderConfigPanel，为审计配置 OpenAI 兼容 provider（baseUrl/apiKey/model）。 - agent-md-scan / agent-version：扫描本地 agent .md、提取版本号。 六、Audit 审计（持续完善中） - Audit tab 拆两个子 tab：Workflow audit（v1-v4，preview）+ Skill audit（接入 skill-eval 对账「真实执行 vs SKILL.md」：五态 verdict、可过滤 findings、by-instruction 表、实时进度条流式百分比）。 - Session Trajectory Analyzer：自建轻量 agent，正则预处理 + 有界 LLM 循环（≤3 轮）分析 10 万+ 行轨迹 MD，无需 Claude Code；Python 版 smart-agent/ + TS 版双端对齐，HTTP 服务 + Next.js 代理路由，Audit tab 可切 v1(TS)/v2(Python)。 - Audit 结果 JSON 导入/导出（audit-export.ts）。 七、性能优化 - 导入流水线 create → createMany + $transaction，单 session 35-100x 加速（23.5s→1.6s），batch 分批（500 条/批）防 SQLite 变量溢出 - opencode-db 适配器 N+1 消除：listSessions ~200+ → 5-6 次批量查询；readSession N×3 → 3 次 - 大 session 事务超时 5s → 60s，解决 "Transaction already closed" 八、移除项 移除 替代 Workflow tab（WorkflowAIView.tsx/WorkflowTreeView.tsx） Performance tab + Audit tab prompts/workflow-analyse.md session-trajectory-analyse.md + trajectory-compress.md tests/start-script.test.ts tests/start-sh-validation.test.ts 九、测试覆盖 新增 45 个测试文件，覆盖上述能力：zip-store(11)、skill-content(20)、file-restore(26)、dir-restore-api、skill-eval-audit、audit-job/audit-export、turn-align/-hard/-stress/-manual、compare-perf/*、claude-autorefresh*、agent-md-scan、trajectory-analyzer、cannbay-archive、upload-session-api、start-sh-validation 等。 同步内容为 skills-dev main 已提交状态，未带入开发仓未提交改动；package-lock.json 按 .gitignore 约定不入库；版本号 VERSION = "1.48"。 关联的Issue <!-- 本次为版本同步发布，暂无对应 Issue。cannbot-insight 大版本跳跃建议在本 PR 评审期间于 Discussions 同步说明。 --> 测试 - cannbot-insight 单元/集成测试：cd plugins-community/cannbot-insight && npm install && npm test（vitest，新增 45 个测试文件） - 仓库级 CI 闸门：./tests/gate_check.sh、./tests/run-tests.sh --fast - 4 个抽样文件 hash 已校验与 skills-dev main blob 一致，确保未带入未提交改动 文档更新 - README.md：Features 列表新增 Performance / 循迹复卷 / 重编汇册 / SKILL.md 全文 / Skill audit 描述 - CHANGELOG.md：补齐 v1.37-v1.40 条目 - 新增设计文档：docs/architecture.md、docs/performance-tab-design.md、docs/audit-skill-subtab-design.md、docs/session-trajectory-analyzer-design.md - 新增 smart-agent/README.md See merge request: cann/cannbot-skills!731 | 17 天前 | |
feat(cannbot-insight): 同步 v1.51（v1.03 → v1.51） Co-authored-by: duanbingzhe<duanbingzhe@huawei.com> # message auto-generated for no-merge-commit merge: !731 merge fix/CleanCode into master feat(cannbot-insight): 同步 v1.51（v1.03 → v1.51） Created-by: duanbingzhe Commit-by: duanbingzhe Merged-by: cann-robot Description: ## 描述 cannbot-insight 功能更新，版本 v1.03 → v1.48。本次新增七大功能，新增 114 个文件、修改 48 个、移除 4 个（旧 Workflow/AI Workflow tab）。主线为 性能可观测（Performance 全景）、文件循迹重建、会话对齐，Audit 工作流审计作为 preview 先行合入承接后续迭代。 一、Performance 性能全景 全新的独立 Performance tab，一站式 session 级性能与成本可观测。所有数据直读 DB、零 LLM 依赖——确定性、可重复、即开即用，不受审计结果波动影响。 PerfPanorama 性能全景三大面板： 1. perf top — 子代理耗时排行（Linux top 风格） - 可排序表格（TURNS / TIME / TOKENS / AVG·T），活跃列箭头指示，列宽稳定不偏移 - 占比条形图：当前值占总量比例，条色随排序键切换（TIME 红 / TOKENS 蓝 / TURNS 灰），一眼锁定最耗资源的子代理 - 点击下钻：展开该子代理 turn 列表（§N + 耗时 + tokens + tools + model），默认 Top 10、一键展开全部 2. Token 成本分析 — 精准定位优化空间 - Cache 节省量卡片：命中缓存（绿）vs 未命中冷输入（红）的量与占比，直指 compaction 后重复输入的浪费 - 每轮 Cache 命中率趋势线（SVG 折线 + 面积渐变），compaction 事件自动标注（命中率骤降点），低命中轮次（<50%）标红 - 与 perf top 联动：下钻 turn 行增加 cache 命中率列，低命中高亮，形成「定位问题 turn → 跳转排查」闭环 3. Top 工具调用 — 耗时瓶颈定位 - 全 session 工具按 durationMs 降序 Top 10，水平条形图，标签 toolName §turnIndex - 点击直接跳转 turns tab 对应 turn 净耗时归因（关键能力）：主 Agent 耗时自动扣除并行子代理等待时间（max(bridge.subagentLatencyMs)），还原主 Agent 真实工作时间，避免被子代理壁钟时间虚高——这是判断「主 Agent 是真慢还是在等子代理」的核心依据。 7 张总览卡片：主 Agent 耗时(净) / 子代理耗时 / 总 Tokens / Cache 命中率 / 主 Agent turns / 子代理 sessions / 工具调用，响应式 grid（2/3/6 列）。 交互与性能：可折叠全景、懒挂载（切 tab 不卸载不 re-fetch）、onJumpToTurn 回调定位。设计文档 docs/performance-tab-design.md。 v1.48 同时完成 perf2→perf 整合，并移除旧 Workflow tab 与 AI Workflow tab（删除 WorkflowAIView.tsx/WorkflowTreeView.tsx/prompts/workflow-analyse.md），其能力由 Performance + Audit 承接。 二、文件循迹重建 - File Content Restore（循迹复卷）：每文件行一键按时间戳拼合本会话内 read/write 片段重建全文（后写入者覆盖先前），未被读取行标注 --line N not found --；兼容 claude（N\t）与 opencode（<content> 信封 + N: ）两种 Read 格式，支持下载/收起。API GET /api/observe/session/file-restore + 纯函数库 src/lib/file-restore.ts。 - Gather & Rebuild Directory（重编汇册）：一键按路径树重建本会话工作目录下全部被读/写文件并打包下载 zip，服务端构建二进制响应（不在页面展开全部内容）。纯函数库 src/lib/zip-store.ts（buildZip/crc32/normalizeZipPath，STORE 无压缩 + UTF-8 文件名标志位兼容 Windows 中文路径）。API GET /api/observe/session/dir-restore。 - Skill Content（SKILL.md 全文）：每个 skill 可点击展示/下载全文，优先取原生 Skill 工具注入的 resultJson（剥前导），回退 Read of */SKILL.md（剥行号），多次加载取最长版本。API GET /api/observe/session/skill-content。 三、Session Compare — turn 对齐 - banded-DP turn 对齐算法：两个 session 逐 turn 对齐，Web Worker 后台计算不阻塞 UI，ComparePanorama 全景对比 token/费用/耗时/工具调用/subagent。含正确性与性能基准（tests/compare-perf/：banded-dp-correctness、turn-align.bench、api-n+1-elimination、render-smoke）。新增 src/lib/compare/turn-align.ts/turn-align.worker.ts。 四、增量刷新 Auto-refresh 探测源 DB 变化后增量导入（auto-refresh-probe.ts），支持 SSE 流式进度推送，适配 Claude Code JSONL 与 opencode DB。新增 API /api/observe/auto-refresh、/api/observe/auto-refresh-stream，e2e fixture 覆盖 append-turn/idle-assistant/streaming 场景。 五、CLI 与配置 - CLI export-md：导出 session 为 Markdown（与 Web UI 导出/audit step 1 同源输出），供轨迹分析器消费。src/cli/commands/export-md.ts。 - AI Provider 配置：settings 页面 + AIProviderConfigPanel，为审计配置 OpenAI 兼容 provider（baseUrl/apiKey/model）。 - agent-md-scan / agent-version：扫描本地 agent .md、提取版本号。 六、Audit 审计（持续完善中） - Audit tab 拆两个子 tab：Workflow audit（v1-v4，preview）+ Skill audit（接入 skill-eval 对账「真实执行 vs SKILL.md」：五态 verdict、可过滤 findings、by-instruction 表、实时进度条流式百分比）。 - Session Trajectory Analyzer：自建轻量 agent，正则预处理 + 有界 LLM 循环（≤3 轮）分析 10 万+ 行轨迹 MD，无需 Claude Code；Python 版 smart-agent/ + TS 版双端对齐，HTTP 服务 + Next.js 代理路由，Audit tab 可切 v1(TS)/v2(Python)。 - Audit 结果 JSON 导入/导出（audit-export.ts）。 七、性能优化 - 导入流水线 create → createMany + $transaction，单 session 35-100x 加速（23.5s→1.6s），batch 分批（500 条/批）防 SQLite 变量溢出 - opencode-db 适配器 N+1 消除：listSessions ~200+ → 5-6 次批量查询；readSession N×3 → 3 次 - 大 session 事务超时 5s → 60s，解决 "Transaction already closed" 八、移除项 移除 替代 Workflow tab（WorkflowAIView.tsx/WorkflowTreeView.tsx） Performance tab + Audit tab prompts/workflow-analyse.md session-trajectory-analyse.md + trajectory-compress.md tests/start-script.test.ts tests/start-sh-validation.test.ts 九、测试覆盖 新增 45 个测试文件，覆盖上述能力：zip-store(11)、skill-content(20)、file-restore(26)、dir-restore-api、skill-eval-audit、audit-job/audit-export、turn-align/-hard/-stress/-manual、compare-perf/*、claude-autorefresh*、agent-md-scan、trajectory-analyzer、cannbay-archive、upload-session-api、start-sh-validation 等。 同步内容为 skills-dev main 已提交状态，未带入开发仓未提交改动；package-lock.json 按 .gitignore 约定不入库；版本号 VERSION = "1.48"。 关联的Issue <!-- 本次为版本同步发布，暂无对应 Issue。cannbot-insight 大版本跳跃建议在本 PR 评审期间于 Discussions 同步说明。 --> 测试 - cannbot-insight 单元/集成测试：cd plugins-community/cannbot-insight && npm install && npm test（vitest，新增 45 个测试文件） - 仓库级 CI 闸门：./tests/gate_check.sh、./tests/run-tests.sh --fast - 4 个抽样文件 hash 已校验与 skills-dev main blob 一致，确保未带入未提交改动 文档更新 - README.md：Features 列表新增 Performance / 循迹复卷 / 重编汇册 / SKILL.md 全文 / Skill audit 描述 - CHANGELOG.md：补齐 v1.37-v1.40 条目 - 新增设计文档：docs/architecture.md、docs/performance-tab-design.md、docs/audit-skill-subtab-design.md、docs/session-trajectory-analyzer-design.md - 新增 smart-agent/README.md See merge request: cann/cannbot-skills!731 | 17 天前 | |
feat(cannbot-insight): 同步 v1.51（v1.03 → v1.51） Co-authored-by: duanbingzhe<duanbingzhe@huawei.com> # message auto-generated for no-merge-commit merge: !731 merge fix/CleanCode into master feat(cannbot-insight): 同步 v1.51（v1.03 → v1.51） Created-by: duanbingzhe Commit-by: duanbingzhe Merged-by: cann-robot Description: ## 描述 cannbot-insight 功能更新，版本 v1.03 → v1.48。本次新增七大功能，新增 114 个文件、修改 48 个、移除 4 个（旧 Workflow/AI Workflow tab）。主线为 性能可观测（Performance 全景）、文件循迹重建、会话对齐，Audit 工作流审计作为 preview 先行合入承接后续迭代。 一、Performance 性能全景 全新的独立 Performance tab，一站式 session 级性能与成本可观测。所有数据直读 DB、零 LLM 依赖——确定性、可重复、即开即用，不受审计结果波动影响。 PerfPanorama 性能全景三大面板： 1. perf top — 子代理耗时排行（Linux top 风格） - 可排序表格（TURNS / TIME / TOKENS / AVG·T），活跃列箭头指示，列宽稳定不偏移 - 占比条形图：当前值占总量比例，条色随排序键切换（TIME 红 / TOKENS 蓝 / TURNS 灰），一眼锁定最耗资源的子代理 - 点击下钻：展开该子代理 turn 列表（§N + 耗时 + tokens + tools + model），默认 Top 10、一键展开全部 2. Token 成本分析 — 精准定位优化空间 - Cache 节省量卡片：命中缓存（绿）vs 未命中冷输入（红）的量与占比，直指 compaction 后重复输入的浪费 - 每轮 Cache 命中率趋势线（SVG 折线 + 面积渐变），compaction 事件自动标注（命中率骤降点），低命中轮次（<50%）标红 - 与 perf top 联动：下钻 turn 行增加 cache 命中率列，低命中高亮，形成「定位问题 turn → 跳转排查」闭环 3. Top 工具调用 — 耗时瓶颈定位 - 全 session 工具按 durationMs 降序 Top 10，水平条形图，标签 toolName §turnIndex - 点击直接跳转 turns tab 对应 turn 净耗时归因（关键能力）：主 Agent 耗时自动扣除并行子代理等待时间（max(bridge.subagentLatencyMs)），还原主 Agent 真实工作时间，避免被子代理壁钟时间虚高——这是判断「主 Agent 是真慢还是在等子代理」的核心依据。 7 张总览卡片：主 Agent 耗时(净) / 子代理耗时 / 总 Tokens / Cache 命中率 / 主 Agent turns / 子代理 sessions / 工具调用，响应式 grid（2/3/6 列）。 交互与性能：可折叠全景、懒挂载（切 tab 不卸载不 re-fetch）、onJumpToTurn 回调定位。设计文档 docs/performance-tab-design.md。 v1.48 同时完成 perf2→perf 整合，并移除旧 Workflow tab 与 AI Workflow tab（删除 WorkflowAIView.tsx/WorkflowTreeView.tsx/prompts/workflow-analyse.md），其能力由 Performance + Audit 承接。 二、文件循迹重建 - File Content Restore（循迹复卷）：每文件行一键按时间戳拼合本会话内 read/write 片段重建全文（后写入者覆盖先前），未被读取行标注 --line N not found --；兼容 claude（N\t）与 opencode（<content> 信封 + N: ）两种 Read 格式，支持下载/收起。API GET /api/observe/session/file-restore + 纯函数库 src/lib/file-restore.ts。 - Gather & Rebuild Directory（重编汇册）：一键按路径树重建本会话工作目录下全部被读/写文件并打包下载 zip，服务端构建二进制响应（不在页面展开全部内容）。纯函数库 src/lib/zip-store.ts（buildZip/crc32/normalizeZipPath，STORE 无压缩 + UTF-8 文件名标志位兼容 Windows 中文路径）。API GET /api/observe/session/dir-restore。 - Skill Content（SKILL.md 全文）：每个 skill 可点击展示/下载全文，优先取原生 Skill 工具注入的 resultJson（剥前导），回退 Read of */SKILL.md（剥行号），多次加载取最长版本。API GET /api/observe/session/skill-content。 三、Session Compare — turn 对齐 - banded-DP turn 对齐算法：两个 session 逐 turn 对齐，Web Worker 后台计算不阻塞 UI，ComparePanorama 全景对比 token/费用/耗时/工具调用/subagent。含正确性与性能基准（tests/compare-perf/：banded-dp-correctness、turn-align.bench、api-n+1-elimination、render-smoke）。新增 src/lib/compare/turn-align.ts/turn-align.worker.ts。 四、增量刷新 Auto-refresh 探测源 DB 变化后增量导入（auto-refresh-probe.ts），支持 SSE 流式进度推送，适配 Claude Code JSONL 与 opencode DB。新增 API /api/observe/auto-refresh、/api/observe/auto-refresh-stream，e2e fixture 覆盖 append-turn/idle-assistant/streaming 场景。 五、CLI 与配置 - CLI export-md：导出 session 为 Markdown（与 Web UI 导出/audit step 1 同源输出），供轨迹分析器消费。src/cli/commands/export-md.ts。 - AI Provider 配置：settings 页面 + AIProviderConfigPanel，为审计配置 OpenAI 兼容 provider（baseUrl/apiKey/model）。 - agent-md-scan / agent-version：扫描本地 agent .md、提取版本号。 六、Audit 审计（持续完善中） - Audit tab 拆两个子 tab：Workflow audit（v1-v4，preview）+ Skill audit（接入 skill-eval 对账「真实执行 vs SKILL.md」：五态 verdict、可过滤 findings、by-instruction 表、实时进度条流式百分比）。 - Session Trajectory Analyzer：自建轻量 agent，正则预处理 + 有界 LLM 循环（≤3 轮）分析 10 万+ 行轨迹 MD，无需 Claude Code；Python 版 smart-agent/ + TS 版双端对齐，HTTP 服务 + Next.js 代理路由，Audit tab 可切 v1(TS)/v2(Python)。 - Audit 结果 JSON 导入/导出（audit-export.ts）。 七、性能优化 - 导入流水线 create → createMany + $transaction，单 session 35-100x 加速（23.5s→1.6s），batch 分批（500 条/批）防 SQLite 变量溢出 - opencode-db 适配器 N+1 消除：listSessions ~200+ → 5-6 次批量查询；readSession N×3 → 3 次 - 大 session 事务超时 5s → 60s，解决 "Transaction already closed" 八、移除项 移除 替代 Workflow tab（WorkflowAIView.tsx/WorkflowTreeView.tsx） Performance tab + Audit tab prompts/workflow-analyse.md session-trajectory-analyse.md + trajectory-compress.md tests/start-script.test.ts tests/start-sh-validation.test.ts 九、测试覆盖 新增 45 个测试文件，覆盖上述能力：zip-store(11)、skill-content(20)、file-restore(26)、dir-restore-api、skill-eval-audit、audit-job/audit-export、turn-align/-hard/-stress/-manual、compare-perf/*、claude-autorefresh*、agent-md-scan、trajectory-analyzer、cannbay-archive、upload-session-api、start-sh-validation 等。 同步内容为 skills-dev main 已提交状态，未带入开发仓未提交改动；package-lock.json 按 .gitignore 约定不入库；版本号 VERSION = "1.48"。 关联的Issue <!-- 本次为版本同步发布，暂无对应 Issue。cannbot-insight 大版本跳跃建议在本 PR 评审期间于 Discussions 同步说明。 --> 测试 - cannbot-insight 单元/集成测试：cd plugins-community/cannbot-insight && npm install && npm test（vitest，新增 45 个测试文件） - 仓库级 CI 闸门：./tests/gate_check.sh、./tests/run-tests.sh --fast - 4 个抽样文件 hash 已校验与 skills-dev main blob 一致，确保未带入未提交改动 文档更新 - README.md：Features 列表新增 Performance / 循迹复卷 / 重编汇册 / SKILL.md 全文 / Skill audit 描述 - CHANGELOG.md：补齐 v1.37-v1.40 条目 - 新增设计文档：docs/architecture.md、docs/performance-tab-design.md、docs/audit-skill-subtab-design.md、docs/session-trajectory-analyzer-design.md - 新增 smart-agent/README.md See merge request: cann/cannbot-skills!731 | 17 天前 | |
feat(cannbot-insight): v1.51→v1.67——root 编排对账重构、Skill 加载校验、Audit 阶段诊断增强 Co-authored-by: duanbingzhe<duanbingzhe@huawei.com> # message auto-generated for no-merge-commit merge: !808 merge feature/update-cannbot-insight into master feat(cannbot-insight): v1.51→v1.67——root 编排对账重构、Skill 加载校验、Audit 阶段诊断增强 Created-by: duanbingzhe Commit-by: duanbingzhe Merged-by: cann-robot Description: ## 描述 版本 v1.51 → v1.67。合并多轮功能迭代，71 个文件变更（57 修改 + 14 新增，+4903 / -624）。核心聚焦三类审计/校验能力，其余为配套增强。 ## root 对账编排声明提取重构 - 新增 recoverWorkflowDeclaration 及辅助 resolveWorkflowSkillName / recoverSkillResourceFile - 优先级：skill resources 文件（task-prompts.md）> SKILL.md body > turn0 注入(≥500字) > null - 不再用 STATE.md / todowrite（属"任务完成度"，非"编排规程遵循度"） - 新增设计文档 docs/workflow-plan-extraction-design.md ## Skill 加载校验（新功能） - 新增 SkillContentAudit 组件 + use-skill-content-audit hook + skill-content-audit API - 校验每个 skill 是否在会话内读取完整 SKILL.md：Skill 工具注入即全文；Read 需无 offset/limit 且无截断标记才判全文，否则部分读取 - chip 三态（全文 / 部分 / 未读），点击 chip 在表格展开该 skill 行 ## Audit 增强 - v4 agent 树默认隐藏全部通过的子 agent（勾选开关才显示） - 跨 agent 问题与优化优先级每项给证据（agent:<name> #turn，可点击跳转）；审计头部展示本次消耗 token 数 - 新增 StageBreakdownTable + StageBreakdownRow 类型：6 阶段（extract/refine/headline/rebuild/judge/postprocess）墙钟+token 诊断，区分 LLM vs 程序阶段 - finding / aggregate 增加 source_excerpt（bullet 原文）、headline（人话标题）、turn_refs（证据 turn 序号，可点击跳转） ## Skills tab 增强 - 恢复展示 dispatch 的 subagent 行（此前被误删） - 新增 agent-content API：从磁盘扫 agent .md（AGENTS_SCAN_ROOT），多插件按 session dispatch 覆盖率消歧 ## smart-agent 增强 - trajectory_analyzer 新增 AdaptiveLimiter（自适应并发：激进出高限、撞限流乘性回退、窗口清了爬回）与 _is_rate_or_timeout 判别 - 重构 _audit_one_agent / _aggregate_session；subagent 桥接写入复刻 Claude Code subagent 存储结构 - jsonl_logger 支持 append 模式；server.py analyze_logger 改 append=False ## 零依赖导出 Session DB - 新增 export-db.mjs：从 opencode.db 或 Claude Code JSONL 提取单个 session（含子会话）为独立文件 - 零依赖：仅需 Node.js >= 22（内置 node:sqlite），无需 npm install / Prisma / 后端 - 自动识别框架，支持 --list / -s / -o / --json；README 新增"方式三" ## CLI upload 增强 - 支持 --session-id（非交互指定）、--list、--yes / --json、--description - README 重写上传文档（opencode / Claude Code 分开示例 + 参数表）；路径修正 sessions.db → opencode.db ## Turns 与概念追踪交互 - Turn 快速跳转：输入 turn 编号（如 #459）回车直达；subagent turn 自动展开祖先 dispatch lane - 概念追踪高亮跳转：搜索结果点击 View Turn 跳转 Turns tab，自动展开并高亮关键词至匹配位置 - 新增纯函数 src/lib/shared/highlight.tsx（highlightKeyword，大小写不敏感，<mark> 包裹） ## 测试与文档 - 新增 cannbot-insight adapter、opencode-db adapter、delete-session API、skill-content-audit API、trace-turn-highlight、turn-timeline-jump 等集成测试；skill-eval-audit 测试 +615 行 - README / README-zh 功能列表与 tab 描述同步；AGENTS.md 补充相关说明 See merge request: cann/cannbot-skills!808 | 8 天前 | |
feat(cannbot-insight): 同步 v1.51（v1.03 → v1.51） Co-authored-by: duanbingzhe<duanbingzhe@huawei.com> # message auto-generated for no-merge-commit merge: !731 merge fix/CleanCode into master feat(cannbot-insight): 同步 v1.51（v1.03 → v1.51） Created-by: duanbingzhe Commit-by: duanbingzhe Merged-by: cann-robot Description: ## 描述 cannbot-insight 功能更新，版本 v1.03 → v1.48。本次新增七大功能，新增 114 个文件、修改 48 个、移除 4 个（旧 Workflow/AI Workflow tab）。主线为 性能可观测（Performance 全景）、文件循迹重建、会话对齐，Audit 工作流审计作为 preview 先行合入承接后续迭代。 一、Performance 性能全景 全新的独立 Performance tab，一站式 session 级性能与成本可观测。所有数据直读 DB、零 LLM 依赖——确定性、可重复、即开即用，不受审计结果波动影响。 PerfPanorama 性能全景三大面板： 1. perf top — 子代理耗时排行（Linux top 风格） - 可排序表格（TURNS / TIME / TOKENS / AVG·T），活跃列箭头指示，列宽稳定不偏移 - 占比条形图：当前值占总量比例，条色随排序键切换（TIME 红 / TOKENS 蓝 / TURNS 灰），一眼锁定最耗资源的子代理 - 点击下钻：展开该子代理 turn 列表（§N + 耗时 + tokens + tools + model），默认 Top 10、一键展开全部 2. Token 成本分析 — 精准定位优化空间 - Cache 节省量卡片：命中缓存（绿）vs 未命中冷输入（红）的量与占比，直指 compaction 后重复输入的浪费 - 每轮 Cache 命中率趋势线（SVG 折线 + 面积渐变），compaction 事件自动标注（命中率骤降点），低命中轮次（<50%）标红 - 与 perf top 联动：下钻 turn 行增加 cache 命中率列，低命中高亮，形成「定位问题 turn → 跳转排查」闭环 3. Top 工具调用 — 耗时瓶颈定位 - 全 session 工具按 durationMs 降序 Top 10，水平条形图，标签 toolName §turnIndex - 点击直接跳转 turns tab 对应 turn 净耗时归因（关键能力）：主 Agent 耗时自动扣除并行子代理等待时间（max(bridge.subagentLatencyMs)），还原主 Agent 真实工作时间，避免被子代理壁钟时间虚高——这是判断「主 Agent 是真慢还是在等子代理」的核心依据。 7 张总览卡片：主 Agent 耗时(净) / 子代理耗时 / 总 Tokens / Cache 命中率 / 主 Agent turns / 子代理 sessions / 工具调用，响应式 grid（2/3/6 列）。 交互与性能：可折叠全景、懒挂载（切 tab 不卸载不 re-fetch）、onJumpToTurn 回调定位。设计文档 docs/performance-tab-design.md。 v1.48 同时完成 perf2→perf 整合，并移除旧 Workflow tab 与 AI Workflow tab（删除 WorkflowAIView.tsx/WorkflowTreeView.tsx/prompts/workflow-analyse.md），其能力由 Performance + Audit 承接。 二、文件循迹重建 - File Content Restore（循迹复卷）：每文件行一键按时间戳拼合本会话内 read/write 片段重建全文（后写入者覆盖先前），未被读取行标注 --line N not found --；兼容 claude（N\t）与 opencode（<content> 信封 + N: ）两种 Read 格式，支持下载/收起。API GET /api/observe/session/file-restore + 纯函数库 src/lib/file-restore.ts。 - Gather & Rebuild Directory（重编汇册）：一键按路径树重建本会话工作目录下全部被读/写文件并打包下载 zip，服务端构建二进制响应（不在页面展开全部内容）。纯函数库 src/lib/zip-store.ts（buildZip/crc32/normalizeZipPath，STORE 无压缩 + UTF-8 文件名标志位兼容 Windows 中文路径）。API GET /api/observe/session/dir-restore。 - Skill Content（SKILL.md 全文）：每个 skill 可点击展示/下载全文，优先取原生 Skill 工具注入的 resultJson（剥前导），回退 Read of */SKILL.md（剥行号），多次加载取最长版本。API GET /api/observe/session/skill-content。 三、Session Compare — turn 对齐 - banded-DP turn 对齐算法：两个 session 逐 turn 对齐，Web Worker 后台计算不阻塞 UI，ComparePanorama 全景对比 token/费用/耗时/工具调用/subagent。含正确性与性能基准（tests/compare-perf/：banded-dp-correctness、turn-align.bench、api-n+1-elimination、render-smoke）。新增 src/lib/compare/turn-align.ts/turn-align.worker.ts。 四、增量刷新 Auto-refresh 探测源 DB 变化后增量导入（auto-refresh-probe.ts），支持 SSE 流式进度推送，适配 Claude Code JSONL 与 opencode DB。新增 API /api/observe/auto-refresh、/api/observe/auto-refresh-stream，e2e fixture 覆盖 append-turn/idle-assistant/streaming 场景。 五、CLI 与配置 - CLI export-md：导出 session 为 Markdown（与 Web UI 导出/audit step 1 同源输出），供轨迹分析器消费。src/cli/commands/export-md.ts。 - AI Provider 配置：settings 页面 + AIProviderConfigPanel，为审计配置 OpenAI 兼容 provider（baseUrl/apiKey/model）。 - agent-md-scan / agent-version：扫描本地 agent .md、提取版本号。 六、Audit 审计（持续完善中） - Audit tab 拆两个子 tab：Workflow audit（v1-v4，preview）+ Skill audit（接入 skill-eval 对账「真实执行 vs SKILL.md」：五态 verdict、可过滤 findings、by-instruction 表、实时进度条流式百分比）。 - Session Trajectory Analyzer：自建轻量 agent，正则预处理 + 有界 LLM 循环（≤3 轮）分析 10 万+ 行轨迹 MD，无需 Claude Code；Python 版 smart-agent/ + TS 版双端对齐，HTTP 服务 + Next.js 代理路由，Audit tab 可切 v1(TS)/v2(Python)。 - Audit 结果 JSON 导入/导出（audit-export.ts）。 七、性能优化 - 导入流水线 create → createMany + $transaction，单 session 35-100x 加速（23.5s→1.6s），batch 分批（500 条/批）防 SQLite 变量溢出 - opencode-db 适配器 N+1 消除：listSessions ~200+ → 5-6 次批量查询；readSession N×3 → 3 次 - 大 session 事务超时 5s → 60s，解决 "Transaction already closed" 八、移除项 移除 替代 Workflow tab（WorkflowAIView.tsx/WorkflowTreeView.tsx） Performance tab + Audit tab prompts/workflow-analyse.md session-trajectory-analyse.md + trajectory-compress.md tests/start-script.test.ts tests/start-sh-validation.test.ts 九、测试覆盖 新增 45 个测试文件，覆盖上述能力：zip-store(11)、skill-content(20)、file-restore(26)、dir-restore-api、skill-eval-audit、audit-job/audit-export、turn-align/-hard/-stress/-manual、compare-perf/*、claude-autorefresh*、agent-md-scan、trajectory-analyzer、cannbay-archive、upload-session-api、start-sh-validation 等。 同步内容为 skills-dev main 已提交状态，未带入开发仓未提交改动；package-lock.json 按 .gitignore 约定不入库；版本号 VERSION = "1.48"。 关联的Issue <!-- 本次为版本同步发布，暂无对应 Issue。cannbot-insight 大版本跳跃建议在本 PR 评审期间于 Discussions 同步说明。 --> 测试 - cannbot-insight 单元/集成测试：cd plugins-community/cannbot-insight && npm install && npm test（vitest，新增 45 个测试文件） - 仓库级 CI 闸门：./tests/gate_check.sh、./tests/run-tests.sh --fast - 4 个抽样文件 hash 已校验与 skills-dev main blob 一致，确保未带入未提交改动 文档更新 - README.md：Features 列表新增 Performance / 循迹复卷 / 重编汇册 / SKILL.md 全文 / Skill audit 描述 - CHANGELOG.md：补齐 v1.37-v1.40 条目 - 新增设计文档：docs/architecture.md、docs/performance-tab-design.md、docs/audit-skill-subtab-design.md、docs/session-trajectory-analyzer-design.md - 新增 smart-agent/README.md See merge request: cann/cannbot-skills!731 | 17 天前 | |
feat(cannbot-insight): 同步 v1.51（v1.03 → v1.51） Co-authored-by: duanbingzhe<duanbingzhe@huawei.com> # message auto-generated for no-merge-commit merge: !731 merge fix/CleanCode into master feat(cannbot-insight): 同步 v1.51（v1.03 → v1.51） Created-by: duanbingzhe Commit-by: duanbingzhe Merged-by: cann-robot Description: ## 描述 cannbot-insight 功能更新，版本 v1.03 → v1.48。本次新增七大功能，新增 114 个文件、修改 48 个、移除 4 个（旧 Workflow/AI Workflow tab）。主线为 性能可观测（Performance 全景）、文件循迹重建、会话对齐，Audit 工作流审计作为 preview 先行合入承接后续迭代。 一、Performance 性能全景 全新的独立 Performance tab，一站式 session 级性能与成本可观测。所有数据直读 DB、零 LLM 依赖——确定性、可重复、即开即用，不受审计结果波动影响。 PerfPanorama 性能全景三大面板： 1. perf top — 子代理耗时排行（Linux top 风格） - 可排序表格（TURNS / TIME / TOKENS / AVG·T），活跃列箭头指示，列宽稳定不偏移 - 占比条形图：当前值占总量比例，条色随排序键切换（TIME 红 / TOKENS 蓝 / TURNS 灰），一眼锁定最耗资源的子代理 - 点击下钻：展开该子代理 turn 列表（§N + 耗时 + tokens + tools + model），默认 Top 10、一键展开全部 2. Token 成本分析 — 精准定位优化空间 - Cache 节省量卡片：命中缓存（绿）vs 未命中冷输入（红）的量与占比，直指 compaction 后重复输入的浪费 - 每轮 Cache 命中率趋势线（SVG 折线 + 面积渐变），compaction 事件自动标注（命中率骤降点），低命中轮次（<50%）标红 - 与 perf top 联动：下钻 turn 行增加 cache 命中率列，低命中高亮，形成「定位问题 turn → 跳转排查」闭环 3. Top 工具调用 — 耗时瓶颈定位 - 全 session 工具按 durationMs 降序 Top 10，水平条形图，标签 toolName §turnIndex - 点击直接跳转 turns tab 对应 turn 净耗时归因（关键能力）：主 Agent 耗时自动扣除并行子代理等待时间（max(bridge.subagentLatencyMs)），还原主 Agent 真实工作时间，避免被子代理壁钟时间虚高——这是判断「主 Agent 是真慢还是在等子代理」的核心依据。 7 张总览卡片：主 Agent 耗时(净) / 子代理耗时 / 总 Tokens / Cache 命中率 / 主 Agent turns / 子代理 sessions / 工具调用，响应式 grid（2/3/6 列）。 交互与性能：可折叠全景、懒挂载（切 tab 不卸载不 re-fetch）、onJumpToTurn 回调定位。设计文档 docs/performance-tab-design.md。 v1.48 同时完成 perf2→perf 整合，并移除旧 Workflow tab 与 AI Workflow tab（删除 WorkflowAIView.tsx/WorkflowTreeView.tsx/prompts/workflow-analyse.md），其能力由 Performance + Audit 承接。 二、文件循迹重建 - File Content Restore（循迹复卷）：每文件行一键按时间戳拼合本会话内 read/write 片段重建全文（后写入者覆盖先前），未被读取行标注 --line N not found --；兼容 claude（N\t）与 opencode（<content> 信封 + N: ）两种 Read 格式，支持下载/收起。API GET /api/observe/session/file-restore + 纯函数库 src/lib/file-restore.ts。 - Gather & Rebuild Directory（重编汇册）：一键按路径树重建本会话工作目录下全部被读/写文件并打包下载 zip，服务端构建二进制响应（不在页面展开全部内容）。纯函数库 src/lib/zip-store.ts（buildZip/crc32/normalizeZipPath，STORE 无压缩 + UTF-8 文件名标志位兼容 Windows 中文路径）。API GET /api/observe/session/dir-restore。 - Skill Content（SKILL.md 全文）：每个 skill 可点击展示/下载全文，优先取原生 Skill 工具注入的 resultJson（剥前导），回退 Read of */SKILL.md（剥行号），多次加载取最长版本。API GET /api/observe/session/skill-content。 三、Session Compare — turn 对齐 - banded-DP turn 对齐算法：两个 session 逐 turn 对齐，Web Worker 后台计算不阻塞 UI，ComparePanorama 全景对比 token/费用/耗时/工具调用/subagent。含正确性与性能基准（tests/compare-perf/：banded-dp-correctness、turn-align.bench、api-n+1-elimination、render-smoke）。新增 src/lib/compare/turn-align.ts/turn-align.worker.ts。 四、增量刷新 Auto-refresh 探测源 DB 变化后增量导入（auto-refresh-probe.ts），支持 SSE 流式进度推送，适配 Claude Code JSONL 与 opencode DB。新增 API /api/observe/auto-refresh、/api/observe/auto-refresh-stream，e2e fixture 覆盖 append-turn/idle-assistant/streaming 场景。 五、CLI 与配置 - CLI export-md：导出 session 为 Markdown（与 Web UI 导出/audit step 1 同源输出），供轨迹分析器消费。src/cli/commands/export-md.ts。 - AI Provider 配置：settings 页面 + AIProviderConfigPanel，为审计配置 OpenAI 兼容 provider（baseUrl/apiKey/model）。 - agent-md-scan / agent-version：扫描本地 agent .md、提取版本号。 六、Audit 审计（持续完善中） - Audit tab 拆两个子 tab：Workflow audit（v1-v4，preview）+ Skill audit（接入 skill-eval 对账「真实执行 vs SKILL.md」：五态 verdict、可过滤 findings、by-instruction 表、实时进度条流式百分比）。 - Session Trajectory Analyzer：自建轻量 agent，正则预处理 + 有界 LLM 循环（≤3 轮）分析 10 万+ 行轨迹 MD，无需 Claude Code；Python 版 smart-agent/ + TS 版双端对齐，HTTP 服务 + Next.js 代理路由，Audit tab 可切 v1(TS)/v2(Python)。 - Audit 结果 JSON 导入/导出（audit-export.ts）。 七、性能优化 - 导入流水线 create → createMany + $transaction，单 session 35-100x 加速（23.5s→1.6s），batch 分批（500 条/批）防 SQLite 变量溢出 - opencode-db 适配器 N+1 消除：listSessions ~200+ → 5-6 次批量查询；readSession N×3 → 3 次 - 大 session 事务超时 5s → 60s，解决 "Transaction already closed" 八、移除项 移除 替代 Workflow tab（WorkflowAIView.tsx/WorkflowTreeView.tsx） Performance tab + Audit tab prompts/workflow-analyse.md session-trajectory-analyse.md + trajectory-compress.md tests/start-script.test.ts tests/start-sh-validation.test.ts 九、测试覆盖 新增 45 个测试文件，覆盖上述能力：zip-store(11)、skill-content(20)、file-restore(26)、dir-restore-api、skill-eval-audit、audit-job/audit-export、turn-align/-hard/-stress/-manual、compare-perf/*、claude-autorefresh*、agent-md-scan、trajectory-analyzer、cannbay-archive、upload-session-api、start-sh-validation 等。 同步内容为 skills-dev main 已提交状态，未带入开发仓未提交改动；package-lock.json 按 .gitignore 约定不入库；版本号 VERSION = "1.48"。 关联的Issue <!-- 本次为版本同步发布，暂无对应 Issue。cannbot-insight 大版本跳跃建议在本 PR 评审期间于 Discussions 同步说明。 --> 测试 - cannbot-insight 单元/集成测试：cd plugins-community/cannbot-insight && npm install && npm test（vitest，新增 45 个测试文件） - 仓库级 CI 闸门：./tests/gate_check.sh、./tests/run-tests.sh --fast - 4 个抽样文件 hash 已校验与 skills-dev main blob 一致，确保未带入未提交改动 文档更新 - README.md：Features 列表新增 Performance / 循迹复卷 / 重编汇册 / SKILL.md 全文 / Skill audit 描述 - CHANGELOG.md：补齐 v1.37-v1.40 条目 - 新增设计文档：docs/architecture.md、docs/performance-tab-design.md、docs/audit-skill-subtab-design.md、docs/session-trajectory-analyzer-design.md - 新增 smart-agent/README.md See merge request: cann/cannbot-skills!731 | 17 天前 | |
feat(cannbot-insight): 同步 v1.51（v1.03 → v1.51） Co-authored-by: duanbingzhe<duanbingzhe@huawei.com> # message auto-generated for no-merge-commit merge: !731 merge fix/CleanCode into master feat(cannbot-insight): 同步 v1.51（v1.03 → v1.51） Created-by: duanbingzhe Commit-by: duanbingzhe Merged-by: cann-robot Description: ## 描述 cannbot-insight 功能更新，版本 v1.03 → v1.48。本次新增七大功能，新增 114 个文件、修改 48 个、移除 4 个（旧 Workflow/AI Workflow tab）。主线为 性能可观测（Performance 全景）、文件循迹重建、会话对齐，Audit 工作流审计作为 preview 先行合入承接后续迭代。 一、Performance 性能全景 全新的独立 Performance tab，一站式 session 级性能与成本可观测。所有数据直读 DB、零 LLM 依赖——确定性、可重复、即开即用，不受审计结果波动影响。 PerfPanorama 性能全景三大面板： 1. perf top — 子代理耗时排行（Linux top 风格） - 可排序表格（TURNS / TIME / TOKENS / AVG·T），活跃列箭头指示，列宽稳定不偏移 - 占比条形图：当前值占总量比例，条色随排序键切换（TIME 红 / TOKENS 蓝 / TURNS 灰），一眼锁定最耗资源的子代理 - 点击下钻：展开该子代理 turn 列表（§N + 耗时 + tokens + tools + model），默认 Top 10、一键展开全部 2. Token 成本分析 — 精准定位优化空间 - Cache 节省量卡片：命中缓存（绿）vs 未命中冷输入（红）的量与占比，直指 compaction 后重复输入的浪费 - 每轮 Cache 命中率趋势线（SVG 折线 + 面积渐变），compaction 事件自动标注（命中率骤降点），低命中轮次（<50%）标红 - 与 perf top 联动：下钻 turn 行增加 cache 命中率列，低命中高亮，形成「定位问题 turn → 跳转排查」闭环 3. Top 工具调用 — 耗时瓶颈定位 - 全 session 工具按 durationMs 降序 Top 10，水平条形图，标签 toolName §turnIndex - 点击直接跳转 turns tab 对应 turn 净耗时归因（关键能力）：主 Agent 耗时自动扣除并行子代理等待时间（max(bridge.subagentLatencyMs)），还原主 Agent 真实工作时间，避免被子代理壁钟时间虚高——这是判断「主 Agent 是真慢还是在等子代理」的核心依据。 7 张总览卡片：主 Agent 耗时(净) / 子代理耗时 / 总 Tokens / Cache 命中率 / 主 Agent turns / 子代理 sessions / 工具调用，响应式 grid（2/3/6 列）。 交互与性能：可折叠全景、懒挂载（切 tab 不卸载不 re-fetch）、onJumpToTurn 回调定位。设计文档 docs/performance-tab-design.md。 v1.48 同时完成 perf2→perf 整合，并移除旧 Workflow tab 与 AI Workflow tab（删除 WorkflowAIView.tsx/WorkflowTreeView.tsx/prompts/workflow-analyse.md），其能力由 Performance + Audit 承接。 二、文件循迹重建 - File Content Restore（循迹复卷）：每文件行一键按时间戳拼合本会话内 read/write 片段重建全文（后写入者覆盖先前），未被读取行标注 --line N not found --；兼容 claude（N\t）与 opencode（<content> 信封 + N: ）两种 Read 格式，支持下载/收起。API GET /api/observe/session/file-restore + 纯函数库 src/lib/file-restore.ts。 - Gather & Rebuild Directory（重编汇册）：一键按路径树重建本会话工作目录下全部被读/写文件并打包下载 zip，服务端构建二进制响应（不在页面展开全部内容）。纯函数库 src/lib/zip-store.ts（buildZip/crc32/normalizeZipPath，STORE 无压缩 + UTF-8 文件名标志位兼容 Windows 中文路径）。API GET /api/observe/session/dir-restore。 - Skill Content（SKILL.md 全文）：每个 skill 可点击展示/下载全文，优先取原生 Skill 工具注入的 resultJson（剥前导），回退 Read of */SKILL.md（剥行号），多次加载取最长版本。API GET /api/observe/session/skill-content。 三、Session Compare — turn 对齐 - banded-DP turn 对齐算法：两个 session 逐 turn 对齐，Web Worker 后台计算不阻塞 UI，ComparePanorama 全景对比 token/费用/耗时/工具调用/subagent。含正确性与性能基准（tests/compare-perf/：banded-dp-correctness、turn-align.bench、api-n+1-elimination、render-smoke）。新增 src/lib/compare/turn-align.ts/turn-align.worker.ts。 四、增量刷新 Auto-refresh 探测源 DB 变化后增量导入（auto-refresh-probe.ts），支持 SSE 流式进度推送，适配 Claude Code JSONL 与 opencode DB。新增 API /api/observe/auto-refresh、/api/observe/auto-refresh-stream，e2e fixture 覆盖 append-turn/idle-assistant/streaming 场景。 五、CLI 与配置 - CLI export-md：导出 session 为 Markdown（与 Web UI 导出/audit step 1 同源输出），供轨迹分析器消费。src/cli/commands/export-md.ts。 - AI Provider 配置：settings 页面 + AIProviderConfigPanel，为审计配置 OpenAI 兼容 provider（baseUrl/apiKey/model）。 - agent-md-scan / agent-version：扫描本地 agent .md、提取版本号。 六、Audit 审计（持续完善中） - Audit tab 拆两个子 tab：Workflow audit（v1-v4，preview）+ Skill audit（接入 skill-eval 对账「真实执行 vs SKILL.md」：五态 verdict、可过滤 findings、by-instruction 表、实时进度条流式百分比）。 - Session Trajectory Analyzer：自建轻量 agent，正则预处理 + 有界 LLM 循环（≤3 轮）分析 10 万+ 行轨迹 MD，无需 Claude Code；Python 版 smart-agent/ + TS 版双端对齐，HTTP 服务 + Next.js 代理路由，Audit tab 可切 v1(TS)/v2(Python)。 - Audit 结果 JSON 导入/导出（audit-export.ts）。 七、性能优化 - 导入流水线 create → createMany + $transaction，单 session 35-100x 加速（23.5s→1.6s），batch 分批（500 条/批）防 SQLite 变量溢出 - opencode-db 适配器 N+1 消除：listSessions ~200+ → 5-6 次批量查询；readSession N×3 → 3 次 - 大 session 事务超时 5s → 60s，解决 "Transaction already closed" 八、移除项 移除 替代 Workflow tab（WorkflowAIView.tsx/WorkflowTreeView.tsx） Performance tab + Audit tab prompts/workflow-analyse.md session-trajectory-analyse.md + trajectory-compress.md tests/start-script.test.ts tests/start-sh-validation.test.ts 九、测试覆盖 新增 45 个测试文件，覆盖上述能力：zip-store(11)、skill-content(20)、file-restore(26)、dir-restore-api、skill-eval-audit、audit-job/audit-export、turn-align/-hard/-stress/-manual、compare-perf/*、claude-autorefresh*、agent-md-scan、trajectory-analyzer、cannbay-archive、upload-session-api、start-sh-validation 等。 同步内容为 skills-dev main 已提交状态，未带入开发仓未提交改动；package-lock.json 按 .gitignore 约定不入库；版本号 VERSION = "1.48"。 关联的Issue <!-- 本次为版本同步发布，暂无对应 Issue。cannbot-insight 大版本跳跃建议在本 PR 评审期间于 Discussions 同步说明。 --> 测试 - cannbot-insight 单元/集成测试：cd plugins-community/cannbot-insight && npm install && npm test（vitest，新增 45 个测试文件） - 仓库级 CI 闸门：./tests/gate_check.sh、./tests/run-tests.sh --fast - 4 个抽样文件 hash 已校验与 skills-dev main blob 一致，确保未带入未提交改动 文档更新 - README.md：Features 列表新增 Performance / 循迹复卷 / 重编汇册 / SKILL.md 全文 / Skill audit 描述 - CHANGELOG.md：补齐 v1.37-v1.40 条目 - 新增设计文档：docs/architecture.md、docs/performance-tab-design.md、docs/audit-skill-subtab-design.md、docs/session-trajectory-analyzer-design.md - 新增 smart-agent/README.md See merge request: cann/cannbot-skills!731 | 17 天前 | |
feat(cannbot-insight): 同步 v1.51（v1.03 → v1.51） Co-authored-by: duanbingzhe<duanbingzhe@huawei.com> # message auto-generated for no-merge-commit merge: !731 merge fix/CleanCode into master feat(cannbot-insight): 同步 v1.51（v1.03 → v1.51） Created-by: duanbingzhe Commit-by: duanbingzhe Merged-by: cann-robot Description: ## 描述 cannbot-insight 功能更新，版本 v1.03 → v1.48。本次新增七大功能，新增 114 个文件、修改 48 个、移除 4 个（旧 Workflow/AI Workflow tab）。主线为 性能可观测（Performance 全景）、文件循迹重建、会话对齐，Audit 工作流审计作为 preview 先行合入承接后续迭代。 一、Performance 性能全景 全新的独立 Performance tab，一站式 session 级性能与成本可观测。所有数据直读 DB、零 LLM 依赖——确定性、可重复、即开即用，不受审计结果波动影响。 PerfPanorama 性能全景三大面板： 1. perf top — 子代理耗时排行（Linux top 风格） - 可排序表格（TURNS / TIME / TOKENS / AVG·T），活跃列箭头指示，列宽稳定不偏移 - 占比条形图：当前值占总量比例，条色随排序键切换（TIME 红 / TOKENS 蓝 / TURNS 灰），一眼锁定最耗资源的子代理 - 点击下钻：展开该子代理 turn 列表（§N + 耗时 + tokens + tools + model），默认 Top 10、一键展开全部 2. Token 成本分析 — 精准定位优化空间 - Cache 节省量卡片：命中缓存（绿）vs 未命中冷输入（红）的量与占比，直指 compaction 后重复输入的浪费 - 每轮 Cache 命中率趋势线（SVG 折线 + 面积渐变），compaction 事件自动标注（命中率骤降点），低命中轮次（<50%）标红 - 与 perf top 联动：下钻 turn 行增加 cache 命中率列，低命中高亮，形成「定位问题 turn → 跳转排查」闭环 3. Top 工具调用 — 耗时瓶颈定位 - 全 session 工具按 durationMs 降序 Top 10，水平条形图，标签 toolName §turnIndex - 点击直接跳转 turns tab 对应 turn 净耗时归因（关键能力）：主 Agent 耗时自动扣除并行子代理等待时间（max(bridge.subagentLatencyMs)），还原主 Agent 真实工作时间，避免被子代理壁钟时间虚高——这是判断「主 Agent 是真慢还是在等子代理」的核心依据。 7 张总览卡片：主 Agent 耗时(净) / 子代理耗时 / 总 Tokens / Cache 命中率 / 主 Agent turns / 子代理 sessions / 工具调用，响应式 grid（2/3/6 列）。 交互与性能：可折叠全景、懒挂载（切 tab 不卸载不 re-fetch）、onJumpToTurn 回调定位。设计文档 docs/performance-tab-design.md。 v1.48 同时完成 perf2→perf 整合，并移除旧 Workflow tab 与 AI Workflow tab（删除 WorkflowAIView.tsx/WorkflowTreeView.tsx/prompts/workflow-analyse.md），其能力由 Performance + Audit 承接。 二、文件循迹重建 - File Content Restore（循迹复卷）：每文件行一键按时间戳拼合本会话内 read/write 片段重建全文（后写入者覆盖先前），未被读取行标注 --line N not found --；兼容 claude（N\t）与 opencode（<content> 信封 + N: ）两种 Read 格式，支持下载/收起。API GET /api/observe/session/file-restore + 纯函数库 src/lib/file-restore.ts。 - Gather & Rebuild Directory（重编汇册）：一键按路径树重建本会话工作目录下全部被读/写文件并打包下载 zip，服务端构建二进制响应（不在页面展开全部内容）。纯函数库 src/lib/zip-store.ts（buildZip/crc32/normalizeZipPath，STORE 无压缩 + UTF-8 文件名标志位兼容 Windows 中文路径）。API GET /api/observe/session/dir-restore。 - Skill Content（SKILL.md 全文）：每个 skill 可点击展示/下载全文，优先取原生 Skill 工具注入的 resultJson（剥前导），回退 Read of */SKILL.md（剥行号），多次加载取最长版本。API GET /api/observe/session/skill-content。 三、Session Compare — turn 对齐 - banded-DP turn 对齐算法：两个 session 逐 turn 对齐，Web Worker 后台计算不阻塞 UI，ComparePanorama 全景对比 token/费用/耗时/工具调用/subagent。含正确性与性能基准（tests/compare-perf/：banded-dp-correctness、turn-align.bench、api-n+1-elimination、render-smoke）。新增 src/lib/compare/turn-align.ts/turn-align.worker.ts。 四、增量刷新 Auto-refresh 探测源 DB 变化后增量导入（auto-refresh-probe.ts），支持 SSE 流式进度推送，适配 Claude Code JSONL 与 opencode DB。新增 API /api/observe/auto-refresh、/api/observe/auto-refresh-stream，e2e fixture 覆盖 append-turn/idle-assistant/streaming 场景。 五、CLI 与配置 - CLI export-md：导出 session 为 Markdown（与 Web UI 导出/audit step 1 同源输出），供轨迹分析器消费。src/cli/commands/export-md.ts。 - AI Provider 配置：settings 页面 + AIProviderConfigPanel，为审计配置 OpenAI 兼容 provider（baseUrl/apiKey/model）。 - agent-md-scan / agent-version：扫描本地 agent .md、提取版本号。 六、Audit 审计（持续完善中） - Audit tab 拆两个子 tab：Workflow audit（v1-v4，preview）+ Skill audit（接入 skill-eval 对账「真实执行 vs SKILL.md」：五态 verdict、可过滤 findings、by-instruction 表、实时进度条流式百分比）。 - Session Trajectory Analyzer：自建轻量 agent，正则预处理 + 有界 LLM 循环（≤3 轮）分析 10 万+ 行轨迹 MD，无需 Claude Code；Python 版 smart-agent/ + TS 版双端对齐，HTTP 服务 + Next.js 代理路由，Audit tab 可切 v1(TS)/v2(Python)。 - Audit 结果 JSON 导入/导出（audit-export.ts）。 七、性能优化 - 导入流水线 create → createMany + $transaction，单 session 35-100x 加速（23.5s→1.6s），batch 分批（500 条/批）防 SQLite 变量溢出 - opencode-db 适配器 N+1 消除：listSessions ~200+ → 5-6 次批量查询；readSession N×3 → 3 次 - 大 session 事务超时 5s → 60s，解决 "Transaction already closed" 八、移除项 移除 替代 Workflow tab（WorkflowAIView.tsx/WorkflowTreeView.tsx） Performance tab + Audit tab prompts/workflow-analyse.md session-trajectory-analyse.md + trajectory-compress.md tests/start-script.test.ts tests/start-sh-validation.test.ts 九、测试覆盖 新增 45 个测试文件，覆盖上述能力：zip-store(11)、skill-content(20)、file-restore(26)、dir-restore-api、skill-eval-audit、audit-job/audit-export、turn-align/-hard/-stress/-manual、compare-perf/*、claude-autorefresh*、agent-md-scan、trajectory-analyzer、cannbay-archive、upload-session-api、start-sh-validation 等。 同步内容为 skills-dev main 已提交状态，未带入开发仓未提交改动；package-lock.json 按 .gitignore 约定不入库；版本号 VERSION = "1.48"。 关联的Issue <!-- 本次为版本同步发布，暂无对应 Issue。cannbot-insight 大版本跳跃建议在本 PR 评审期间于 Discussions 同步说明。 --> 测试 - cannbot-insight 单元/集成测试：cd plugins-community/cannbot-insight && npm install && npm test（vitest，新增 45 个测试文件） - 仓库级 CI 闸门：./tests/gate_check.sh、./tests/run-tests.sh --fast - 4 个抽样文件 hash 已校验与 skills-dev main blob 一致，确保未带入未提交改动 文档更新 - README.md：Features 列表新增 Performance / 循迹复卷 / 重编汇册 / SKILL.md 全文 / Skill audit 描述 - CHANGELOG.md：补齐 v1.37-v1.40 条目 - 新增设计文档：docs/architecture.md、docs/performance-tab-design.md、docs/audit-skill-subtab-design.md、docs/session-trajectory-analyzer-design.md - 新增 smart-agent/README.md See merge request: cann/cannbot-skills!731 | 17 天前 | |
[feat]cannbot-insight tool Co-authored-by: guanxinghua<guanxinghua@huawei.com> # message auto-generated for no-merge-commit merge: !521 merge merge-cannbot-insight into master [feat]cannbot-insight tool Created-by: guanxinghua Commit-by: guanxinghua Merged-by: cann-robot Description: 需求@功能描述： https://gitcode.com/cann/cannbot-skills/issues/377 See merge request: cann/cannbot-skills!521 | 1 个月前 | |
[feat]cannbot-insight tool Co-authored-by: guanxinghua<guanxinghua@huawei.com> # message auto-generated for no-merge-commit merge: !521 merge merge-cannbot-insight into master [feat]cannbot-insight tool Created-by: guanxinghua Commit-by: guanxinghua Merged-by: cann-robot Description: 需求@功能描述： https://gitcode.com/cann/cannbot-skills/issues/377 See merge request: cann/cannbot-skills!521 | 1 个月前 | |
feat(cannbot-insight): v1.51→v1.67——root 编排对账重构、Skill 加载校验、Audit 阶段诊断增强 Co-authored-by: duanbingzhe<duanbingzhe@huawei.com> # message auto-generated for no-merge-commit merge: !808 merge feature/update-cannbot-insight into master feat(cannbot-insight): v1.51→v1.67——root 编排对账重构、Skill 加载校验、Audit 阶段诊断增强 Created-by: duanbingzhe Commit-by: duanbingzhe Merged-by: cann-robot Description: ## 描述 版本 v1.51 → v1.67。合并多轮功能迭代，71 个文件变更（57 修改 + 14 新增，+4903 / -624）。核心聚焦三类审计/校验能力，其余为配套增强。 ## root 对账编排声明提取重构 - 新增 recoverWorkflowDeclaration 及辅助 resolveWorkflowSkillName / recoverSkillResourceFile - 优先级：skill resources 文件（task-prompts.md）> SKILL.md body > turn0 注入(≥500字) > null - 不再用 STATE.md / todowrite（属"任务完成度"，非"编排规程遵循度"） - 新增设计文档 docs/workflow-plan-extraction-design.md ## Skill 加载校验（新功能） - 新增 SkillContentAudit 组件 + use-skill-content-audit hook + skill-content-audit API - 校验每个 skill 是否在会话内读取完整 SKILL.md：Skill 工具注入即全文；Read 需无 offset/limit 且无截断标记才判全文，否则部分读取 - chip 三态（全文 / 部分 / 未读），点击 chip 在表格展开该 skill 行 ## Audit 增强 - v4 agent 树默认隐藏全部通过的子 agent（勾选开关才显示） - 跨 agent 问题与优化优先级每项给证据（agent:<name> #turn，可点击跳转）；审计头部展示本次消耗 token 数 - 新增 StageBreakdownTable + StageBreakdownRow 类型：6 阶段（extract/refine/headline/rebuild/judge/postprocess）墙钟+token 诊断，区分 LLM vs 程序阶段 - finding / aggregate 增加 source_excerpt（bullet 原文）、headline（人话标题）、turn_refs（证据 turn 序号，可点击跳转） ## Skills tab 增强 - 恢复展示 dispatch 的 subagent 行（此前被误删） - 新增 agent-content API：从磁盘扫 agent .md（AGENTS_SCAN_ROOT），多插件按 session dispatch 覆盖率消歧 ## smart-agent 增强 - trajectory_analyzer 新增 AdaptiveLimiter（自适应并发：激进出高限、撞限流乘性回退、窗口清了爬回）与 _is_rate_or_timeout 判别 - 重构 _audit_one_agent / _aggregate_session；subagent 桥接写入复刻 Claude Code subagent 存储结构 - jsonl_logger 支持 append 模式；server.py analyze_logger 改 append=False ## 零依赖导出 Session DB - 新增 export-db.mjs：从 opencode.db 或 Claude Code JSONL 提取单个 session（含子会话）为独立文件 - 零依赖：仅需 Node.js >= 22（内置 node:sqlite），无需 npm install / Prisma / 后端 - 自动识别框架，支持 --list / -s / -o / --json；README 新增"方式三" ## CLI upload 增强 - 支持 --session-id（非交互指定）、--list、--yes / --json、--description - README 重写上传文档（opencode / Claude Code 分开示例 + 参数表）；路径修正 sessions.db → opencode.db ## Turns 与概念追踪交互 - Turn 快速跳转：输入 turn 编号（如 #459）回车直达；subagent turn 自动展开祖先 dispatch lane - 概念追踪高亮跳转：搜索结果点击 View Turn 跳转 Turns tab，自动展开并高亮关键词至匹配位置 - 新增纯函数 src/lib/shared/highlight.tsx（highlightKeyword，大小写不敏感，<mark> 包裹） ## 测试与文档 - 新增 cannbot-insight adapter、opencode-db adapter、delete-session API、skill-content-audit API、trace-turn-highlight、turn-timeline-jump 等集成测试；skill-eval-audit 测试 +615 行 - README / README-zh 功能列表与 tab 描述同步；AGENTS.md 补充相关说明 See merge request: cann/cannbot-skills!808 | 8 天前 | |
feat(cannbot-insight): 同步 v1.51（v1.03 → v1.51） Co-authored-by: duanbingzhe<duanbingzhe@huawei.com> # message auto-generated for no-merge-commit merge: !731 merge fix/CleanCode into master feat(cannbot-insight): 同步 v1.51（v1.03 → v1.51） Created-by: duanbingzhe Commit-by: duanbingzhe Merged-by: cann-robot Description: ## 描述 cannbot-insight 功能更新，版本 v1.03 → v1.48。本次新增七大功能，新增 114 个文件、修改 48 个、移除 4 个（旧 Workflow/AI Workflow tab）。主线为 性能可观测（Performance 全景）、文件循迹重建、会话对齐，Audit 工作流审计作为 preview 先行合入承接后续迭代。 一、Performance 性能全景 全新的独立 Performance tab，一站式 session 级性能与成本可观测。所有数据直读 DB、零 LLM 依赖——确定性、可重复、即开即用，不受审计结果波动影响。 PerfPanorama 性能全景三大面板： 1. perf top — 子代理耗时排行（Linux top 风格） - 可排序表格（TURNS / TIME / TOKENS / AVG·T），活跃列箭头指示，列宽稳定不偏移 - 占比条形图：当前值占总量比例，条色随排序键切换（TIME 红 / TOKENS 蓝 / TURNS 灰），一眼锁定最耗资源的子代理 - 点击下钻：展开该子代理 turn 列表（§N + 耗时 + tokens + tools + model），默认 Top 10、一键展开全部 2. Token 成本分析 — 精准定位优化空间 - Cache 节省量卡片：命中缓存（绿）vs 未命中冷输入（红）的量与占比，直指 compaction 后重复输入的浪费 - 每轮 Cache 命中率趋势线（SVG 折线 + 面积渐变），compaction 事件自动标注（命中率骤降点），低命中轮次（<50%）标红 - 与 perf top 联动：下钻 turn 行增加 cache 命中率列，低命中高亮，形成「定位问题 turn → 跳转排查」闭环 3. Top 工具调用 — 耗时瓶颈定位 - 全 session 工具按 durationMs 降序 Top 10，水平条形图，标签 toolName §turnIndex - 点击直接跳转 turns tab 对应 turn 净耗时归因（关键能力）：主 Agent 耗时自动扣除并行子代理等待时间（max(bridge.subagentLatencyMs)），还原主 Agent 真实工作时间，避免被子代理壁钟时间虚高——这是判断「主 Agent 是真慢还是在等子代理」的核心依据。 7 张总览卡片：主 Agent 耗时(净) / 子代理耗时 / 总 Tokens / Cache 命中率 / 主 Agent turns / 子代理 sessions / 工具调用，响应式 grid（2/3/6 列）。 交互与性能：可折叠全景、懒挂载（切 tab 不卸载不 re-fetch）、onJumpToTurn 回调定位。设计文档 docs/performance-tab-design.md。 v1.48 同时完成 perf2→perf 整合，并移除旧 Workflow tab 与 AI Workflow tab（删除 WorkflowAIView.tsx/WorkflowTreeView.tsx/prompts/workflow-analyse.md），其能力由 Performance + Audit 承接。 二、文件循迹重建 - File Content Restore（循迹复卷）：每文件行一键按时间戳拼合本会话内 read/write 片段重建全文（后写入者覆盖先前），未被读取行标注 --line N not found --；兼容 claude（N\t）与 opencode（<content> 信封 + N: ）两种 Read 格式，支持下载/收起。API GET /api/observe/session/file-restore + 纯函数库 src/lib/file-restore.ts。 - Gather & Rebuild Directory（重编汇册）：一键按路径树重建本会话工作目录下全部被读/写文件并打包下载 zip，服务端构建二进制响应（不在页面展开全部内容）。纯函数库 src/lib/zip-store.ts（buildZip/crc32/normalizeZipPath，STORE 无压缩 + UTF-8 文件名标志位兼容 Windows 中文路径）。API GET /api/observe/session/dir-restore。 - Skill Content（SKILL.md 全文）：每个 skill 可点击展示/下载全文，优先取原生 Skill 工具注入的 resultJson（剥前导），回退 Read of */SKILL.md（剥行号），多次加载取最长版本。API GET /api/observe/session/skill-content。 三、Session Compare — turn 对齐 - banded-DP turn 对齐算法：两个 session 逐 turn 对齐，Web Worker 后台计算不阻塞 UI，ComparePanorama 全景对比 token/费用/耗时/工具调用/subagent。含正确性与性能基准（tests/compare-perf/：banded-dp-correctness、turn-align.bench、api-n+1-elimination、render-smoke）。新增 src/lib/compare/turn-align.ts/turn-align.worker.ts。 四、增量刷新 Auto-refresh 探测源 DB 变化后增量导入（auto-refresh-probe.ts），支持 SSE 流式进度推送，适配 Claude Code JSONL 与 opencode DB。新增 API /api/observe/auto-refresh、/api/observe/auto-refresh-stream，e2e fixture 覆盖 append-turn/idle-assistant/streaming 场景。 五、CLI 与配置 - CLI export-md：导出 session 为 Markdown（与 Web UI 导出/audit step 1 同源输出），供轨迹分析器消费。src/cli/commands/export-md.ts。 - AI Provider 配置：settings 页面 + AIProviderConfigPanel，为审计配置 OpenAI 兼容 provider（baseUrl/apiKey/model）。 - agent-md-scan / agent-version：扫描本地 agent .md、提取版本号。 六、Audit 审计（持续完善中） - Audit tab 拆两个子 tab：Workflow audit（v1-v4，preview）+ Skill audit（接入 skill-eval 对账「真实执行 vs SKILL.md」：五态 verdict、可过滤 findings、by-instruction 表、实时进度条流式百分比）。 - Session Trajectory Analyzer：自建轻量 agent，正则预处理 + 有界 LLM 循环（≤3 轮）分析 10 万+ 行轨迹 MD，无需 Claude Code；Python 版 smart-agent/ + TS 版双端对齐，HTTP 服务 + Next.js 代理路由，Audit tab 可切 v1(TS)/v2(Python)。 - Audit 结果 JSON 导入/导出（audit-export.ts）。 七、性能优化 - 导入流水线 create → createMany + $transaction，单 session 35-100x 加速（23.5s→1.6s），batch 分批（500 条/批）防 SQLite 变量溢出 - opencode-db 适配器 N+1 消除：listSessions ~200+ → 5-6 次批量查询；readSession N×3 → 3 次 - 大 session 事务超时 5s → 60s，解决 "Transaction already closed" 八、移除项 移除 替代 Workflow tab（WorkflowAIView.tsx/WorkflowTreeView.tsx） Performance tab + Audit tab prompts/workflow-analyse.md session-trajectory-analyse.md + trajectory-compress.md tests/start-script.test.ts tests/start-sh-validation.test.ts 九、测试覆盖 新增 45 个测试文件，覆盖上述能力：zip-store(11)、skill-content(20)、file-restore(26)、dir-restore-api、skill-eval-audit、audit-job/audit-export、turn-align/-hard/-stress/-manual、compare-perf/*、claude-autorefresh*、agent-md-scan、trajectory-analyzer、cannbay-archive、upload-session-api、start-sh-validation 等。 同步内容为 skills-dev main 已提交状态，未带入开发仓未提交改动；package-lock.json 按 .gitignore 约定不入库；版本号 VERSION = "1.48"。 关联的Issue <!-- 本次为版本同步发布，暂无对应 Issue。cannbot-insight 大版本跳跃建议在本 PR 评审期间于 Discussions 同步说明。 --> 测试 - cannbot-insight 单元/集成测试：cd plugins-community/cannbot-insight && npm install && npm test（vitest，新增 45 个测试文件） - 仓库级 CI 闸门：./tests/gate_check.sh、./tests/run-tests.sh --fast - 4 个抽样文件 hash 已校验与 skills-dev main blob 一致，确保未带入未提交改动 文档更新 - README.md：Features 列表新增 Performance / 循迹复卷 / 重编汇册 / SKILL.md 全文 / Skill audit 描述 - CHANGELOG.md：补齐 v1.37-v1.40 条目 - 新增设计文档：docs/architecture.md、docs/performance-tab-design.md、docs/audit-skill-subtab-design.md、docs/session-trajectory-analyzer-design.md - 新增 smart-agent/README.md See merge request: cann/cannbot-skills!731 | 17 天前 | |
[feat]cannbot-insight tool Co-authored-by: guanxinghua<guanxinghua@huawei.com> # message auto-generated for no-merge-commit merge: !521 merge merge-cannbot-insight into master [feat]cannbot-insight tool Created-by: guanxinghua Commit-by: guanxinghua Merged-by: cann-robot Description: 需求@功能描述： https://gitcode.com/cann/cannbot-skills/issues/377 See merge request: cann/cannbot-skills!521 | 1 个月前 | |
[feat]cannbot-insight tool Co-authored-by: guanxinghua<guanxinghua@huawei.com> # message auto-generated for no-merge-commit merge: !521 merge merge-cannbot-insight into master [feat]cannbot-insight tool Created-by: guanxinghua Commit-by: guanxinghua Merged-by: cann-robot Description: 需求@功能描述： https://gitcode.com/cann/cannbot-skills/issues/377 See merge request: cann/cannbot-skills!521 | 1 个月前 | |
feat(cannbot-insight): 同步 v1.51（v1.03 → v1.51） Co-authored-by: duanbingzhe<duanbingzhe@huawei.com> # message auto-generated for no-merge-commit merge: !731 merge fix/CleanCode into master feat(cannbot-insight): 同步 v1.51（v1.03 → v1.51） Created-by: duanbingzhe Commit-by: duanbingzhe Merged-by: cann-robot Description: ## 描述 cannbot-insight 功能更新，版本 v1.03 → v1.48。本次新增七大功能，新增 114 个文件、修改 48 个、移除 4 个（旧 Workflow/AI Workflow tab）。主线为 性能可观测（Performance 全景）、文件循迹重建、会话对齐，Audit 工作流审计作为 preview 先行合入承接后续迭代。 一、Performance 性能全景 全新的独立 Performance tab，一站式 session 级性能与成本可观测。所有数据直读 DB、零 LLM 依赖——确定性、可重复、即开即用，不受审计结果波动影响。 PerfPanorama 性能全景三大面板： 1. perf top — 子代理耗时排行（Linux top 风格） - 可排序表格（TURNS / TIME / TOKENS / AVG·T），活跃列箭头指示，列宽稳定不偏移 - 占比条形图：当前值占总量比例，条色随排序键切换（TIME 红 / TOKENS 蓝 / TURNS 灰），一眼锁定最耗资源的子代理 - 点击下钻：展开该子代理 turn 列表（§N + 耗时 + tokens + tools + model），默认 Top 10、一键展开全部 2. Token 成本分析 — 精准定位优化空间 - Cache 节省量卡片：命中缓存（绿）vs 未命中冷输入（红）的量与占比，直指 compaction 后重复输入的浪费 - 每轮 Cache 命中率趋势线（SVG 折线 + 面积渐变），compaction 事件自动标注（命中率骤降点），低命中轮次（<50%）标红 - 与 perf top 联动：下钻 turn 行增加 cache 命中率列，低命中高亮，形成「定位问题 turn → 跳转排查」闭环 3. Top 工具调用 — 耗时瓶颈定位 - 全 session 工具按 durationMs 降序 Top 10，水平条形图，标签 toolName §turnIndex - 点击直接跳转 turns tab 对应 turn 净耗时归因（关键能力）：主 Agent 耗时自动扣除并行子代理等待时间（max(bridge.subagentLatencyMs)），还原主 Agent 真实工作时间，避免被子代理壁钟时间虚高——这是判断「主 Agent 是真慢还是在等子代理」的核心依据。 7 张总览卡片：主 Agent 耗时(净) / 子代理耗时 / 总 Tokens / Cache 命中率 / 主 Agent turns / 子代理 sessions / 工具调用，响应式 grid（2/3/6 列）。 交互与性能：可折叠全景、懒挂载（切 tab 不卸载不 re-fetch）、onJumpToTurn 回调定位。设计文档 docs/performance-tab-design.md。 v1.48 同时完成 perf2→perf 整合，并移除旧 Workflow tab 与 AI Workflow tab（删除 WorkflowAIView.tsx/WorkflowTreeView.tsx/prompts/workflow-analyse.md），其能力由 Performance + Audit 承接。 二、文件循迹重建 - File Content Restore（循迹复卷）：每文件行一键按时间戳拼合本会话内 read/write 片段重建全文（后写入者覆盖先前），未被读取行标注 --line N not found --；兼容 claude（N\t）与 opencode（<content> 信封 + N: ）两种 Read 格式，支持下载/收起。API GET /api/observe/session/file-restore + 纯函数库 src/lib/file-restore.ts。 - Gather & Rebuild Directory（重编汇册）：一键按路径树重建本会话工作目录下全部被读/写文件并打包下载 zip，服务端构建二进制响应（不在页面展开全部内容）。纯函数库 src/lib/zip-store.ts（buildZip/crc32/normalizeZipPath，STORE 无压缩 + UTF-8 文件名标志位兼容 Windows 中文路径）。API GET /api/observe/session/dir-restore。 - Skill Content（SKILL.md 全文）：每个 skill 可点击展示/下载全文，优先取原生 Skill 工具注入的 resultJson（剥前导），回退 Read of */SKILL.md（剥行号），多次加载取最长版本。API GET /api/observe/session/skill-content。 三、Session Compare — turn 对齐 - banded-DP turn 对齐算法：两个 session 逐 turn 对齐，Web Worker 后台计算不阻塞 UI，ComparePanorama 全景对比 token/费用/耗时/工具调用/subagent。含正确性与性能基准（tests/compare-perf/：banded-dp-correctness、turn-align.bench、api-n+1-elimination、render-smoke）。新增 src/lib/compare/turn-align.ts/turn-align.worker.ts。 四、增量刷新 Auto-refresh 探测源 DB 变化后增量导入（auto-refresh-probe.ts），支持 SSE 流式进度推送，适配 Claude Code JSONL 与 opencode DB。新增 API /api/observe/auto-refresh、/api/observe/auto-refresh-stream，e2e fixture 覆盖 append-turn/idle-assistant/streaming 场景。 五、CLI 与配置 - CLI export-md：导出 session 为 Markdown（与 Web UI 导出/audit step 1 同源输出），供轨迹分析器消费。src/cli/commands/export-md.ts。 - AI Provider 配置：settings 页面 + AIProviderConfigPanel，为审计配置 OpenAI 兼容 provider（baseUrl/apiKey/model）。 - agent-md-scan / agent-version：扫描本地 agent .md、提取版本号。 六、Audit 审计（持续完善中） - Audit tab 拆两个子 tab：Workflow audit（v1-v4，preview）+ Skill audit（接入 skill-eval 对账「真实执行 vs SKILL.md」：五态 verdict、可过滤 findings、by-instruction 表、实时进度条流式百分比）。 - Session Trajectory Analyzer：自建轻量 agent，正则预处理 + 有界 LLM 循环（≤3 轮）分析 10 万+ 行轨迹 MD，无需 Claude Code；Python 版 smart-agent/ + TS 版双端对齐，HTTP 服务 + Next.js 代理路由，Audit tab 可切 v1(TS)/v2(Python)。 - Audit 结果 JSON 导入/导出（audit-export.ts）。 七、性能优化 - 导入流水线 create → createMany + $transaction，单 session 35-100x 加速（23.5s→1.6s），batch 分批（500 条/批）防 SQLite 变量溢出 - opencode-db 适配器 N+1 消除：listSessions ~200+ → 5-6 次批量查询；readSession N×3 → 3 次 - 大 session 事务超时 5s → 60s，解决 "Transaction already closed" 八、移除项 移除 替代 Workflow tab（WorkflowAIView.tsx/WorkflowTreeView.tsx） Performance tab + Audit tab prompts/workflow-analyse.md session-trajectory-analyse.md + trajectory-compress.md tests/start-script.test.ts tests/start-sh-validation.test.ts 九、测试覆盖 新增 45 个测试文件，覆盖上述能力：zip-store(11)、skill-content(20)、file-restore(26)、dir-restore-api、skill-eval-audit、audit-job/audit-export、turn-align/-hard/-stress/-manual、compare-perf/*、claude-autorefresh*、agent-md-scan、trajectory-analyzer、cannbay-archive、upload-session-api、start-sh-validation 等。 同步内容为 skills-dev main 已提交状态，未带入开发仓未提交改动；package-lock.json 按 .gitignore 约定不入库；版本号 VERSION = "1.48"。 关联的Issue <!-- 本次为版本同步发布，暂无对应 Issue。cannbot-insight 大版本跳跃建议在本 PR 评审期间于 Discussions 同步说明。 --> 测试 - cannbot-insight 单元/集成测试：cd plugins-community/cannbot-insight && npm install && npm test（vitest，新增 45 个测试文件） - 仓库级 CI 闸门：./tests/gate_check.sh、./tests/run-tests.sh --fast - 4 个抽样文件 hash 已校验与 skills-dev main blob 一致，确保未带入未提交改动 文档更新 - README.md：Features 列表新增 Performance / 循迹复卷 / 重编汇册 / SKILL.md 全文 / Skill audit 描述 - CHANGELOG.md：补齐 v1.37-v1.40 条目 - 新增设计文档：docs/architecture.md、docs/performance-tab-design.md、docs/audit-skill-subtab-design.md、docs/session-trajectory-analyzer-design.md - 新增 smart-agent/README.md See merge request: cann/cannbot-skills!731 | 17 天前 | |
[feat]cannbot-insight tool Co-authored-by: guanxinghua<guanxinghua@huawei.com> # message auto-generated for no-merge-commit merge: !521 merge merge-cannbot-insight into master [feat]cannbot-insight tool Created-by: guanxinghua Commit-by: guanxinghua Merged-by: cann-robot Description: 需求@功能描述： https://gitcode.com/cann/cannbot-skills/issues/377 See merge request: cann/cannbot-skills!521 | 1 个月前 | |
[feat]cannbot-insight tool Co-authored-by: guanxinghua<guanxinghua@huawei.com> # message auto-generated for no-merge-commit merge: !521 merge merge-cannbot-insight into master [feat]cannbot-insight tool Created-by: guanxinghua Commit-by: guanxinghua Merged-by: cann-robot Description: 需求@功能描述： https://gitcode.com/cann/cannbot-skills/issues/377 See merge request: cann/cannbot-skills!521 | 1 个月前 | |
feat(cannbot-insight): 同步 v1.51（v1.03 → v1.51） Co-authored-by: duanbingzhe<duanbingzhe@huawei.com> # message auto-generated for no-merge-commit merge: !731 merge fix/CleanCode into master feat(cannbot-insight): 同步 v1.51（v1.03 → v1.51） Created-by: duanbingzhe Commit-by: duanbingzhe Merged-by: cann-robot Description: ## 描述 cannbot-insight 功能更新，版本 v1.03 → v1.48。本次新增七大功能，新增 114 个文件、修改 48 个、移除 4 个（旧 Workflow/AI Workflow tab）。主线为 性能可观测（Performance 全景）、文件循迹重建、会话对齐，Audit 工作流审计作为 preview 先行合入承接后续迭代。 一、Performance 性能全景 全新的独立 Performance tab，一站式 session 级性能与成本可观测。所有数据直读 DB、零 LLM 依赖——确定性、可重复、即开即用，不受审计结果波动影响。 PerfPanorama 性能全景三大面板： 1. perf top — 子代理耗时排行（Linux top 风格） - 可排序表格（TURNS / TIME / TOKENS / AVG·T），活跃列箭头指示，列宽稳定不偏移 - 占比条形图：当前值占总量比例，条色随排序键切换（TIME 红 / TOKENS 蓝 / TURNS 灰），一眼锁定最耗资源的子代理 - 点击下钻：展开该子代理 turn 列表（§N + 耗时 + tokens + tools + model），默认 Top 10、一键展开全部 2. Token 成本分析 — 精准定位优化空间 - Cache 节省量卡片：命中缓存（绿）vs 未命中冷输入（红）的量与占比，直指 compaction 后重复输入的浪费 - 每轮 Cache 命中率趋势线（SVG 折线 + 面积渐变），compaction 事件自动标注（命中率骤降点），低命中轮次（<50%）标红 - 与 perf top 联动：下钻 turn 行增加 cache 命中率列，低命中高亮，形成「定位问题 turn → 跳转排查」闭环 3. Top 工具调用 — 耗时瓶颈定位 - 全 session 工具按 durationMs 降序 Top 10，水平条形图，标签 toolName §turnIndex - 点击直接跳转 turns tab 对应 turn 净耗时归因（关键能力）：主 Agent 耗时自动扣除并行子代理等待时间（max(bridge.subagentLatencyMs)），还原主 Agent 真实工作时间，避免被子代理壁钟时间虚高——这是判断「主 Agent 是真慢还是在等子代理」的核心依据。 7 张总览卡片：主 Agent 耗时(净) / 子代理耗时 / 总 Tokens / Cache 命中率 / 主 Agent turns / 子代理 sessions / 工具调用，响应式 grid（2/3/6 列）。 交互与性能：可折叠全景、懒挂载（切 tab 不卸载不 re-fetch）、onJumpToTurn 回调定位。设计文档 docs/performance-tab-design.md。 v1.48 同时完成 perf2→perf 整合，并移除旧 Workflow tab 与 AI Workflow tab（删除 WorkflowAIView.tsx/WorkflowTreeView.tsx/prompts/workflow-analyse.md），其能力由 Performance + Audit 承接。 二、文件循迹重建 - File Content Restore（循迹复卷）：每文件行一键按时间戳拼合本会话内 read/write 片段重建全文（后写入者覆盖先前），未被读取行标注 --line N not found --；兼容 claude（N\t）与 opencode（<content> 信封 + N: ）两种 Read 格式，支持下载/收起。API GET /api/observe/session/file-restore + 纯函数库 src/lib/file-restore.ts。 - Gather & Rebuild Directory（重编汇册）：一键按路径树重建本会话工作目录下全部被读/写文件并打包下载 zip，服务端构建二进制响应（不在页面展开全部内容）。纯函数库 src/lib/zip-store.ts（buildZip/crc32/normalizeZipPath，STORE 无压缩 + UTF-8 文件名标志位兼容 Windows 中文路径）。API GET /api/observe/session/dir-restore。 - Skill Content（SKILL.md 全文）：每个 skill 可点击展示/下载全文，优先取原生 Skill 工具注入的 resultJson（剥前导），回退 Read of */SKILL.md（剥行号），多次加载取最长版本。API GET /api/observe/session/skill-content。 三、Session Compare — turn 对齐 - banded-DP turn 对齐算法：两个 session 逐 turn 对齐，Web Worker 后台计算不阻塞 UI，ComparePanorama 全景对比 token/费用/耗时/工具调用/subagent。含正确性与性能基准（tests/compare-perf/：banded-dp-correctness、turn-align.bench、api-n+1-elimination、render-smoke）。新增 src/lib/compare/turn-align.ts/turn-align.worker.ts。 四、增量刷新 Auto-refresh 探测源 DB 变化后增量导入（auto-refresh-probe.ts），支持 SSE 流式进度推送，适配 Claude Code JSONL 与 opencode DB。新增 API /api/observe/auto-refresh、/api/observe/auto-refresh-stream，e2e fixture 覆盖 append-turn/idle-assistant/streaming 场景。 五、CLI 与配置 - CLI export-md：导出 session 为 Markdown（与 Web UI 导出/audit step 1 同源输出），供轨迹分析器消费。src/cli/commands/export-md.ts。 - AI Provider 配置：settings 页面 + AIProviderConfigPanel，为审计配置 OpenAI 兼容 provider（baseUrl/apiKey/model）。 - agent-md-scan / agent-version：扫描本地 agent .md、提取版本号。 六、Audit 审计（持续完善中） - Audit tab 拆两个子 tab：Workflow audit（v1-v4，preview）+ Skill audit（接入 skill-eval 对账「真实执行 vs SKILL.md」：五态 verdict、可过滤 findings、by-instruction 表、实时进度条流式百分比）。 - Session Trajectory Analyzer：自建轻量 agent，正则预处理 + 有界 LLM 循环（≤3 轮）分析 10 万+ 行轨迹 MD，无需 Claude Code；Python 版 smart-agent/ + TS 版双端对齐，HTTP 服务 + Next.js 代理路由，Audit tab 可切 v1(TS)/v2(Python)。 - Audit 结果 JSON 导入/导出（audit-export.ts）。 七、性能优化 - 导入流水线 create → createMany + $transaction，单 session 35-100x 加速（23.5s→1.6s），batch 分批（500 条/批）防 SQLite 变量溢出 - opencode-db 适配器 N+1 消除：listSessions ~200+ → 5-6 次批量查询；readSession N×3 → 3 次 - 大 session 事务超时 5s → 60s，解决 "Transaction already closed" 八、移除项 移除 替代 Workflow tab（WorkflowAIView.tsx/WorkflowTreeView.tsx） Performance tab + Audit tab prompts/workflow-analyse.md session-trajectory-analyse.md + trajectory-compress.md tests/start-script.test.ts tests/start-sh-validation.test.ts 九、测试覆盖 新增 45 个测试文件，覆盖上述能力：zip-store(11)、skill-content(20)、file-restore(26)、dir-restore-api、skill-eval-audit、audit-job/audit-export、turn-align/-hard/-stress/-manual、compare-perf/*、claude-autorefresh*、agent-md-scan、trajectory-analyzer、cannbay-archive、upload-session-api、start-sh-validation 等。 同步内容为 skills-dev main 已提交状态，未带入开发仓未提交改动；package-lock.json 按 .gitignore 约定不入库；版本号 VERSION = "1.48"。 关联的Issue <!-- 本次为版本同步发布，暂无对应 Issue。cannbot-insight 大版本跳跃建议在本 PR 评审期间于 Discussions 同步说明。 --> 测试 - cannbot-insight 单元/集成测试：cd plugins-community/cannbot-insight && npm install && npm test（vitest，新增 45 个测试文件） - 仓库级 CI 闸门：./tests/gate_check.sh、./tests/run-tests.sh --fast - 4 个抽样文件 hash 已校验与 skills-dev main blob 一致，确保未带入未提交改动 文档更新 - README.md：Features 列表新增 Performance / 循迹复卷 / 重编汇册 / SKILL.md 全文 / Skill audit 描述 - CHANGELOG.md：补齐 v1.37-v1.40 条目 - 新增设计文档：docs/architecture.md、docs/performance-tab-design.md、docs/audit-skill-subtab-design.md、docs/session-trajectory-analyzer-design.md - 新增 smart-agent/README.md See merge request: cann/cannbot-skills!731 | 17 天前 | |
feat(cannbot-insight): 同步 v1.51（v1.03 → v1.51） Co-authored-by: duanbingzhe<duanbingzhe@huawei.com> # message auto-generated for no-merge-commit merge: !731 merge fix/CleanCode into master feat(cannbot-insight): 同步 v1.51（v1.03 → v1.51） Created-by: duanbingzhe Commit-by: duanbingzhe Merged-by: cann-robot Description: ## 描述 cannbot-insight 功能更新，版本 v1.03 → v1.48。本次新增七大功能，新增 114 个文件、修改 48 个、移除 4 个（旧 Workflow/AI Workflow tab）。主线为 性能可观测（Performance 全景）、文件循迹重建、会话对齐，Audit 工作流审计作为 preview 先行合入承接后续迭代。 一、Performance 性能全景 全新的独立 Performance tab，一站式 session 级性能与成本可观测。所有数据直读 DB、零 LLM 依赖——确定性、可重复、即开即用，不受审计结果波动影响。 PerfPanorama 性能全景三大面板： 1. perf top — 子代理耗时排行（Linux top 风格） - 可排序表格（TURNS / TIME / TOKENS / AVG·T），活跃列箭头指示，列宽稳定不偏移 - 占比条形图：当前值占总量比例，条色随排序键切换（TIME 红 / TOKENS 蓝 / TURNS 灰），一眼锁定最耗资源的子代理 - 点击下钻：展开该子代理 turn 列表（§N + 耗时 + tokens + tools + model），默认 Top 10、一键展开全部 2. Token 成本分析 — 精准定位优化空间 - Cache 节省量卡片：命中缓存（绿）vs 未命中冷输入（红）的量与占比，直指 compaction 后重复输入的浪费 - 每轮 Cache 命中率趋势线（SVG 折线 + 面积渐变），compaction 事件自动标注（命中率骤降点），低命中轮次（<50%）标红 - 与 perf top 联动：下钻 turn 行增加 cache 命中率列，低命中高亮，形成「定位问题 turn → 跳转排查」闭环 3. Top 工具调用 — 耗时瓶颈定位 - 全 session 工具按 durationMs 降序 Top 10，水平条形图，标签 toolName §turnIndex - 点击直接跳转 turns tab 对应 turn 净耗时归因（关键能力）：主 Agent 耗时自动扣除并行子代理等待时间（max(bridge.subagentLatencyMs)），还原主 Agent 真实工作时间，避免被子代理壁钟时间虚高——这是判断「主 Agent 是真慢还是在等子代理」的核心依据。 7 张总览卡片：主 Agent 耗时(净) / 子代理耗时 / 总 Tokens / Cache 命中率 / 主 Agent turns / 子代理 sessions / 工具调用，响应式 grid（2/3/6 列）。 交互与性能：可折叠全景、懒挂载（切 tab 不卸载不 re-fetch）、onJumpToTurn 回调定位。设计文档 docs/performance-tab-design.md。 v1.48 同时完成 perf2→perf 整合，并移除旧 Workflow tab 与 AI Workflow tab（删除 WorkflowAIView.tsx/WorkflowTreeView.tsx/prompts/workflow-analyse.md），其能力由 Performance + Audit 承接。 二、文件循迹重建 - File Content Restore（循迹复卷）：每文件行一键按时间戳拼合本会话内 read/write 片段重建全文（后写入者覆盖先前），未被读取行标注 --line N not found --；兼容 claude（N\t）与 opencode（<content> 信封 + N: ）两种 Read 格式，支持下载/收起。API GET /api/observe/session/file-restore + 纯函数库 src/lib/file-restore.ts。 - Gather & Rebuild Directory（重编汇册）：一键按路径树重建本会话工作目录下全部被读/写文件并打包下载 zip，服务端构建二进制响应（不在页面展开全部内容）。纯函数库 src/lib/zip-store.ts（buildZip/crc32/normalizeZipPath，STORE 无压缩 + UTF-8 文件名标志位兼容 Windows 中文路径）。API GET /api/observe/session/dir-restore。 - Skill Content（SKILL.md 全文）：每个 skill 可点击展示/下载全文，优先取原生 Skill 工具注入的 resultJson（剥前导），回退 Read of */SKILL.md（剥行号），多次加载取最长版本。API GET /api/observe/session/skill-content。 三、Session Compare — turn 对齐 - banded-DP turn 对齐算法：两个 session 逐 turn 对齐，Web Worker 后台计算不阻塞 UI，ComparePanorama 全景对比 token/费用/耗时/工具调用/subagent。含正确性与性能基准（tests/compare-perf/：banded-dp-correctness、turn-align.bench、api-n+1-elimination、render-smoke）。新增 src/lib/compare/turn-align.ts/turn-align.worker.ts。 四、增量刷新 Auto-refresh 探测源 DB 变化后增量导入（auto-refresh-probe.ts），支持 SSE 流式进度推送，适配 Claude Code JSONL 与 opencode DB。新增 API /api/observe/auto-refresh、/api/observe/auto-refresh-stream，e2e fixture 覆盖 append-turn/idle-assistant/streaming 场景。 五、CLI 与配置 - CLI export-md：导出 session 为 Markdown（与 Web UI 导出/audit step 1 同源输出），供轨迹分析器消费。src/cli/commands/export-md.ts。 - AI Provider 配置：settings 页面 + AIProviderConfigPanel，为审计配置 OpenAI 兼容 provider（baseUrl/apiKey/model）。 - agent-md-scan / agent-version：扫描本地 agent .md、提取版本号。 六、Audit 审计（持续完善中） - Audit tab 拆两个子 tab：Workflow audit（v1-v4，preview）+ Skill audit（接入 skill-eval 对账「真实执行 vs SKILL.md」：五态 verdict、可过滤 findings、by-instruction 表、实时进度条流式百分比）。 - Session Trajectory Analyzer：自建轻量 agent，正则预处理 + 有界 LLM 循环（≤3 轮）分析 10 万+ 行轨迹 MD，无需 Claude Code；Python 版 smart-agent/ + TS 版双端对齐，HTTP 服务 + Next.js 代理路由，Audit tab 可切 v1(TS)/v2(Python)。 - Audit 结果 JSON 导入/导出（audit-export.ts）。 七、性能优化 - 导入流水线 create → createMany + $transaction，单 session 35-100x 加速（23.5s→1.6s），batch 分批（500 条/批）防 SQLite 变量溢出 - opencode-db 适配器 N+1 消除：listSessions ~200+ → 5-6 次批量查询；readSession N×3 → 3 次 - 大 session 事务超时 5s → 60s，解决 "Transaction already closed" 八、移除项 移除 替代 Workflow tab（WorkflowAIView.tsx/WorkflowTreeView.tsx） Performance tab + Audit tab prompts/workflow-analyse.md session-trajectory-analyse.md + trajectory-compress.md tests/start-script.test.ts tests/start-sh-validation.test.ts 九、测试覆盖 新增 45 个测试文件，覆盖上述能力：zip-store(11)、skill-content(20)、file-restore(26)、dir-restore-api、skill-eval-audit、audit-job/audit-export、turn-align/-hard/-stress/-manual、compare-perf/*、claude-autorefresh*、agent-md-scan、trajectory-analyzer、cannbay-archive、upload-session-api、start-sh-validation 等。 同步内容为 skills-dev main 已提交状态，未带入开发仓未提交改动；package-lock.json 按 .gitignore 约定不入库；版本号 VERSION = "1.48"。 关联的Issue <!-- 本次为版本同步发布，暂无对应 Issue。cannbot-insight 大版本跳跃建议在本 PR 评审期间于 Discussions 同步说明。 --> 测试 - cannbot-insight 单元/集成测试：cd plugins-community/cannbot-insight && npm install && npm test（vitest，新增 45 个测试文件） - 仓库级 CI 闸门：./tests/gate_check.sh、./tests/run-tests.sh --fast - 4 个抽样文件 hash 已校验与 skills-dev main blob 一致，确保未带入未提交改动 文档更新 - README.md：Features 列表新增 Performance / 循迹复卷 / 重编汇册 / SKILL.md 全文 / Skill audit 描述 - CHANGELOG.md：补齐 v1.37-v1.40 条目 - 新增设计文档：docs/architecture.md、docs/performance-tab-design.md、docs/audit-skill-subtab-design.md、docs/session-trajectory-analyzer-design.md - 新增 smart-agent/README.md See merge request: cann/cannbot-skills!731 | 17 天前 | |
[feat]cannbot-insight tool Co-authored-by: guanxinghua<guanxinghua@huawei.com> # message auto-generated for no-merge-commit merge: !521 merge merge-cannbot-insight into master [feat]cannbot-insight tool Created-by: guanxinghua Commit-by: guanxinghua Merged-by: cann-robot Description: 需求@功能描述： https://gitcode.com/cann/cannbot-skills/issues/377 See merge request: cann/cannbot-skills!521 | 1 个月前 | |
feat(cannbot-insight): 同步 v1.51（v1.03 → v1.51） Co-authored-by: duanbingzhe<duanbingzhe@huawei.com> # message auto-generated for no-merge-commit merge: !731 merge fix/CleanCode into master feat(cannbot-insight): 同步 v1.51（v1.03 → v1.51） Created-by: duanbingzhe Commit-by: duanbingzhe Merged-by: cann-robot Description: ## 描述 cannbot-insight 功能更新，版本 v1.03 → v1.48。本次新增七大功能，新增 114 个文件、修改 48 个、移除 4 个（旧 Workflow/AI Workflow tab）。主线为 性能可观测（Performance 全景）、文件循迹重建、会话对齐，Audit 工作流审计作为 preview 先行合入承接后续迭代。 一、Performance 性能全景 全新的独立 Performance tab，一站式 session 级性能与成本可观测。所有数据直读 DB、零 LLM 依赖——确定性、可重复、即开即用，不受审计结果波动影响。 PerfPanorama 性能全景三大面板： 1. perf top — 子代理耗时排行（Linux top 风格） - 可排序表格（TURNS / TIME / TOKENS / AVG·T），活跃列箭头指示，列宽稳定不偏移 - 占比条形图：当前值占总量比例，条色随排序键切换（TIME 红 / TOKENS 蓝 / TURNS 灰），一眼锁定最耗资源的子代理 - 点击下钻：展开该子代理 turn 列表（§N + 耗时 + tokens + tools + model），默认 Top 10、一键展开全部 2. Token 成本分析 — 精准定位优化空间 - Cache 节省量卡片：命中缓存（绿）vs 未命中冷输入（红）的量与占比，直指 compaction 后重复输入的浪费 - 每轮 Cache 命中率趋势线（SVG 折线 + 面积渐变），compaction 事件自动标注（命中率骤降点），低命中轮次（<50%）标红 - 与 perf top 联动：下钻 turn 行增加 cache 命中率列，低命中高亮，形成「定位问题 turn → 跳转排查」闭环 3. Top 工具调用 — 耗时瓶颈定位 - 全 session 工具按 durationMs 降序 Top 10，水平条形图，标签 toolName §turnIndex - 点击直接跳转 turns tab 对应 turn 净耗时归因（关键能力）：主 Agent 耗时自动扣除并行子代理等待时间（max(bridge.subagentLatencyMs)），还原主 Agent 真实工作时间，避免被子代理壁钟时间虚高——这是判断「主 Agent 是真慢还是在等子代理」的核心依据。 7 张总览卡片：主 Agent 耗时(净) / 子代理耗时 / 总 Tokens / Cache 命中率 / 主 Agent turns / 子代理 sessions / 工具调用，响应式 grid（2/3/6 列）。 交互与性能：可折叠全景、懒挂载（切 tab 不卸载不 re-fetch）、onJumpToTurn 回调定位。设计文档 docs/performance-tab-design.md。 v1.48 同时完成 perf2→perf 整合，并移除旧 Workflow tab 与 AI Workflow tab（删除 WorkflowAIView.tsx/WorkflowTreeView.tsx/prompts/workflow-analyse.md），其能力由 Performance + Audit 承接。 二、文件循迹重建 - File Content Restore（循迹复卷）：每文件行一键按时间戳拼合本会话内 read/write 片段重建全文（后写入者覆盖先前），未被读取行标注 --line N not found --；兼容 claude（N\t）与 opencode（<content> 信封 + N: ）两种 Read 格式，支持下载/收起。API GET /api/observe/session/file-restore + 纯函数库 src/lib/file-restore.ts。 - Gather & Rebuild Directory（重编汇册）：一键按路径树重建本会话工作目录下全部被读/写文件并打包下载 zip，服务端构建二进制响应（不在页面展开全部内容）。纯函数库 src/lib/zip-store.ts（buildZip/crc32/normalizeZipPath，STORE 无压缩 + UTF-8 文件名标志位兼容 Windows 中文路径）。API GET /api/observe/session/dir-restore。 - Skill Content（SKILL.md 全文）：每个 skill 可点击展示/下载全文，优先取原生 Skill 工具注入的 resultJson（剥前导），回退 Read of */SKILL.md（剥行号），多次加载取最长版本。API GET /api/observe/session/skill-content。 三、Session Compare — turn 对齐 - banded-DP turn 对齐算法：两个 session 逐 turn 对齐，Web Worker 后台计算不阻塞 UI，ComparePanorama 全景对比 token/费用/耗时/工具调用/subagent。含正确性与性能基准（tests/compare-perf/：banded-dp-correctness、turn-align.bench、api-n+1-elimination、render-smoke）。新增 src/lib/compare/turn-align.ts/turn-align.worker.ts。 四、增量刷新 Auto-refresh 探测源 DB 变化后增量导入（auto-refresh-probe.ts），支持 SSE 流式进度推送，适配 Claude Code JSONL 与 opencode DB。新增 API /api/observe/auto-refresh、/api/observe/auto-refresh-stream，e2e fixture 覆盖 append-turn/idle-assistant/streaming 场景。 五、CLI 与配置 - CLI export-md：导出 session 为 Markdown（与 Web UI 导出/audit step 1 同源输出），供轨迹分析器消费。src/cli/commands/export-md.ts。 - AI Provider 配置：settings 页面 + AIProviderConfigPanel，为审计配置 OpenAI 兼容 provider（baseUrl/apiKey/model）。 - agent-md-scan / agent-version：扫描本地 agent .md、提取版本号。 六、Audit 审计（持续完善中） - Audit tab 拆两个子 tab：Workflow audit（v1-v4，preview）+ Skill audit（接入 skill-eval 对账「真实执行 vs SKILL.md」：五态 verdict、可过滤 findings、by-instruction 表、实时进度条流式百分比）。 - Session Trajectory Analyzer：自建轻量 agent，正则预处理 + 有界 LLM 循环（≤3 轮）分析 10 万+ 行轨迹 MD，无需 Claude Code；Python 版 smart-agent/ + TS 版双端对齐，HTTP 服务 + Next.js 代理路由，Audit tab 可切 v1(TS)/v2(Python)。 - Audit 结果 JSON 导入/导出（audit-export.ts）。 七、性能优化 - 导入流水线 create → createMany + $transaction，单 session 35-100x 加速（23.5s→1.6s），batch 分批（500 条/批）防 SQLite 变量溢出 - opencode-db 适配器 N+1 消除：listSessions ~200+ → 5-6 次批量查询；readSession N×3 → 3 次 - 大 session 事务超时 5s → 60s，解决 "Transaction already closed" 八、移除项 移除 替代 Workflow tab（WorkflowAIView.tsx/WorkflowTreeView.tsx） Performance tab + Audit tab prompts/workflow-analyse.md session-trajectory-analyse.md + trajectory-compress.md tests/start-script.test.ts tests/start-sh-validation.test.ts 九、测试覆盖 新增 45 个测试文件，覆盖上述能力：zip-store(11)、skill-content(20)、file-restore(26)、dir-restore-api、skill-eval-audit、audit-job/audit-export、turn-align/-hard/-stress/-manual、compare-perf/*、claude-autorefresh*、agent-md-scan、trajectory-analyzer、cannbay-archive、upload-session-api、start-sh-validation 等。 同步内容为 skills-dev main 已提交状态，未带入开发仓未提交改动；package-lock.json 按 .gitignore 约定不入库；版本号 VERSION = "1.48"。 关联的Issue <!-- 本次为版本同步发布，暂无对应 Issue。cannbot-insight 大版本跳跃建议在本 PR 评审期间于 Discussions 同步说明。 --> 测试 - cannbot-insight 单元/集成测试：cd plugins-community/cannbot-insight && npm install && npm test（vitest，新增 45 个测试文件） - 仓库级 CI 闸门：./tests/gate_check.sh、./tests/run-tests.sh --fast - 4 个抽样文件 hash 已校验与 skills-dev main blob 一致，确保未带入未提交改动 文档更新 - README.md：Features 列表新增 Performance / 循迹复卷 / 重编汇册 / SKILL.md 全文 / Skill audit 描述 - CHANGELOG.md：补齐 v1.37-v1.40 条目 - 新增设计文档：docs/architecture.md、docs/performance-tab-design.md、docs/audit-skill-subtab-design.md、docs/session-trajectory-analyzer-design.md - 新增 smart-agent/README.md See merge request: cann/cannbot-skills!731 | 17 天前 | |
[feat]cannbot-insight tool Co-authored-by: guanxinghua<guanxinghua@huawei.com> # message auto-generated for no-merge-commit merge: !521 merge merge-cannbot-insight into master [feat]cannbot-insight tool Created-by: guanxinghua Commit-by: guanxinghua Merged-by: cann-robot Description: 需求@功能描述： https://gitcode.com/cann/cannbot-skills/issues/377 See merge request: cann/cannbot-skills!521 | 1 个月前 | |
feat(cannbot-insight): 同步 v1.51（v1.03 → v1.51） Co-authored-by: duanbingzhe<duanbingzhe@huawei.com> # message auto-generated for no-merge-commit merge: !731 merge fix/CleanCode into master feat(cannbot-insight): 同步 v1.51（v1.03 → v1.51） Created-by: duanbingzhe Commit-by: duanbingzhe Merged-by: cann-robot Description: ## 描述 cannbot-insight 功能更新，版本 v1.03 → v1.48。本次新增七大功能，新增 114 个文件、修改 48 个、移除 4 个（旧 Workflow/AI Workflow tab）。主线为 性能可观测（Performance 全景）、文件循迹重建、会话对齐，Audit 工作流审计作为 preview 先行合入承接后续迭代。 一、Performance 性能全景 全新的独立 Performance tab，一站式 session 级性能与成本可观测。所有数据直读 DB、零 LLM 依赖——确定性、可重复、即开即用，不受审计结果波动影响。 PerfPanorama 性能全景三大面板： 1. perf top — 子代理耗时排行（Linux top 风格） - 可排序表格（TURNS / TIME / TOKENS / AVG·T），活跃列箭头指示，列宽稳定不偏移 - 占比条形图：当前值占总量比例，条色随排序键切换（TIME 红 / TOKENS 蓝 / TURNS 灰），一眼锁定最耗资源的子代理 - 点击下钻：展开该子代理 turn 列表（§N + 耗时 + tokens + tools + model），默认 Top 10、一键展开全部 2. Token 成本分析 — 精准定位优化空间 - Cache 节省量卡片：命中缓存（绿）vs 未命中冷输入（红）的量与占比，直指 compaction 后重复输入的浪费 - 每轮 Cache 命中率趋势线（SVG 折线 + 面积渐变），compaction 事件自动标注（命中率骤降点），低命中轮次（<50%）标红 - 与 perf top 联动：下钻 turn 行增加 cache 命中率列，低命中高亮，形成「定位问题 turn → 跳转排查」闭环 3. Top 工具调用 — 耗时瓶颈定位 - 全 session 工具按 durationMs 降序 Top 10，水平条形图，标签 toolName §turnIndex - 点击直接跳转 turns tab 对应 turn 净耗时归因（关键能力）：主 Agent 耗时自动扣除并行子代理等待时间（max(bridge.subagentLatencyMs)），还原主 Agent 真实工作时间，避免被子代理壁钟时间虚高——这是判断「主 Agent 是真慢还是在等子代理」的核心依据。 7 张总览卡片：主 Agent 耗时(净) / 子代理耗时 / 总 Tokens / Cache 命中率 / 主 Agent turns / 子代理 sessions / 工具调用，响应式 grid（2/3/6 列）。 交互与性能：可折叠全景、懒挂载（切 tab 不卸载不 re-fetch）、onJumpToTurn 回调定位。设计文档 docs/performance-tab-design.md。 v1.48 同时完成 perf2→perf 整合，并移除旧 Workflow tab 与 AI Workflow tab（删除 WorkflowAIView.tsx/WorkflowTreeView.tsx/prompts/workflow-analyse.md），其能力由 Performance + Audit 承接。 二、文件循迹重建 - File Content Restore（循迹复卷）：每文件行一键按时间戳拼合本会话内 read/write 片段重建全文（后写入者覆盖先前），未被读取行标注 --line N not found --；兼容 claude（N\t）与 opencode（<content> 信封 + N: ）两种 Read 格式，支持下载/收起。API GET /api/observe/session/file-restore + 纯函数库 src/lib/file-restore.ts。 - Gather & Rebuild Directory（重编汇册）：一键按路径树重建本会话工作目录下全部被读/写文件并打包下载 zip，服务端构建二进制响应（不在页面展开全部内容）。纯函数库 src/lib/zip-store.ts（buildZip/crc32/normalizeZipPath，STORE 无压缩 + UTF-8 文件名标志位兼容 Windows 中文路径）。API GET /api/observe/session/dir-restore。 - Skill Content（SKILL.md 全文）：每个 skill 可点击展示/下载全文，优先取原生 Skill 工具注入的 resultJson（剥前导），回退 Read of */SKILL.md（剥行号），多次加载取最长版本。API GET /api/observe/session/skill-content。 三、Session Compare — turn 对齐 - banded-DP turn 对齐算法：两个 session 逐 turn 对齐，Web Worker 后台计算不阻塞 UI，ComparePanorama 全景对比 token/费用/耗时/工具调用/subagent。含正确性与性能基准（tests/compare-perf/：banded-dp-correctness、turn-align.bench、api-n+1-elimination、render-smoke）。新增 src/lib/compare/turn-align.ts/turn-align.worker.ts。 四、增量刷新 Auto-refresh 探测源 DB 变化后增量导入（auto-refresh-probe.ts），支持 SSE 流式进度推送，适配 Claude Code JSONL 与 opencode DB。新增 API /api/observe/auto-refresh、/api/observe/auto-refresh-stream，e2e fixture 覆盖 append-turn/idle-assistant/streaming 场景。 五、CLI 与配置 - CLI export-md：导出 session 为 Markdown（与 Web UI 导出/audit step 1 同源输出），供轨迹分析器消费。src/cli/commands/export-md.ts。 - AI Provider 配置：settings 页面 + AIProviderConfigPanel，为审计配置 OpenAI 兼容 provider（baseUrl/apiKey/model）。 - agent-md-scan / agent-version：扫描本地 agent .md、提取版本号。 六、Audit 审计（持续完善中） - Audit tab 拆两个子 tab：Workflow audit（v1-v4，preview）+ Skill audit（接入 skill-eval 对账「真实执行 vs SKILL.md」：五态 verdict、可过滤 findings、by-instruction 表、实时进度条流式百分比）。 - Session Trajectory Analyzer：自建轻量 agent，正则预处理 + 有界 LLM 循环（≤3 轮）分析 10 万+ 行轨迹 MD，无需 Claude Code；Python 版 smart-agent/ + TS 版双端对齐，HTTP 服务 + Next.js 代理路由，Audit tab 可切 v1(TS)/v2(Python)。 - Audit 结果 JSON 导入/导出（audit-export.ts）。 七、性能优化 - 导入流水线 create → createMany + $transaction，单 session 35-100x 加速（23.5s→1.6s），batch 分批（500 条/批）防 SQLite 变量溢出 - opencode-db 适配器 N+1 消除：listSessions ~200+ → 5-6 次批量查询；readSession N×3 → 3 次 - 大 session 事务超时 5s → 60s，解决 "Transaction already closed" 八、移除项 移除 替代 Workflow tab（WorkflowAIView.tsx/WorkflowTreeView.tsx） Performance tab + Audit tab prompts/workflow-analyse.md session-trajectory-analyse.md + trajectory-compress.md tests/start-script.test.ts tests/start-sh-validation.test.ts 九、测试覆盖 新增 45 个测试文件，覆盖上述能力：zip-store(11)、skill-content(20)、file-restore(26)、dir-restore-api、skill-eval-audit、audit-job/audit-export、turn-align/-hard/-stress/-manual、compare-perf/*、claude-autorefresh*、agent-md-scan、trajectory-analyzer、cannbay-archive、upload-session-api、start-sh-validation 等。 同步内容为 skills-dev main 已提交状态，未带入开发仓未提交改动；package-lock.json 按 .gitignore 约定不入库；版本号 VERSION = "1.48"。 关联的Issue <!-- 本次为版本同步发布，暂无对应 Issue。cannbot-insight 大版本跳跃建议在本 PR 评审期间于 Discussions 同步说明。 --> 测试 - cannbot-insight 单元/集成测试：cd plugins-community/cannbot-insight && npm install && npm test（vitest，新增 45 个测试文件） - 仓库级 CI 闸门：./tests/gate_check.sh、./tests/run-tests.sh --fast - 4 个抽样文件 hash 已校验与 skills-dev main blob 一致，确保未带入未提交改动 文档更新 - README.md：Features 列表新增 Performance / 循迹复卷 / 重编汇册 / SKILL.md 全文 / Skill audit 描述 - CHANGELOG.md：补齐 v1.37-v1.40 条目 - 新增设计文档：docs/architecture.md、docs/performance-tab-design.md、docs/audit-skill-subtab-design.md、docs/session-trajectory-analyzer-design.md - 新增 smart-agent/README.md See merge request: cann/cannbot-skills!731 | 17 天前 | |
feat(cannbot-insight): 同步 v1.51（v1.03 → v1.51） Co-authored-by: duanbingzhe<duanbingzhe@huawei.com> # message auto-generated for no-merge-commit merge: !731 merge fix/CleanCode into master feat(cannbot-insight): 同步 v1.51（v1.03 → v1.51） Created-by: duanbingzhe Commit-by: duanbingzhe Merged-by: cann-robot Description: ## 描述 cannbot-insight 功能更新，版本 v1.03 → v1.48。本次新增七大功能，新增 114 个文件、修改 48 个、移除 4 个（旧 Workflow/AI Workflow tab）。主线为 性能可观测（Performance 全景）、文件循迹重建、会话对齐，Audit 工作流审计作为 preview 先行合入承接后续迭代。 一、Performance 性能全景 全新的独立 Performance tab，一站式 session 级性能与成本可观测。所有数据直读 DB、零 LLM 依赖——确定性、可重复、即开即用，不受审计结果波动影响。 PerfPanorama 性能全景三大面板： 1. perf top — 子代理耗时排行（Linux top 风格） - 可排序表格（TURNS / TIME / TOKENS / AVG·T），活跃列箭头指示，列宽稳定不偏移 - 占比条形图：当前值占总量比例，条色随排序键切换（TIME 红 / TOKENS 蓝 / TURNS 灰），一眼锁定最耗资源的子代理 - 点击下钻：展开该子代理 turn 列表（§N + 耗时 + tokens + tools + model），默认 Top 10、一键展开全部 2. Token 成本分析 — 精准定位优化空间 - Cache 节省量卡片：命中缓存（绿）vs 未命中冷输入（红）的量与占比，直指 compaction 后重复输入的浪费 - 每轮 Cache 命中率趋势线（SVG 折线 + 面积渐变），compaction 事件自动标注（命中率骤降点），低命中轮次（<50%）标红 - 与 perf top 联动：下钻 turn 行增加 cache 命中率列，低命中高亮，形成「定位问题 turn → 跳转排查」闭环 3. Top 工具调用 — 耗时瓶颈定位 - 全 session 工具按 durationMs 降序 Top 10，水平条形图，标签 toolName §turnIndex - 点击直接跳转 turns tab 对应 turn 净耗时归因（关键能力）：主 Agent 耗时自动扣除并行子代理等待时间（max(bridge.subagentLatencyMs)），还原主 Agent 真实工作时间，避免被子代理壁钟时间虚高——这是判断「主 Agent 是真慢还是在等子代理」的核心依据。 7 张总览卡片：主 Agent 耗时(净) / 子代理耗时 / 总 Tokens / Cache 命中率 / 主 Agent turns / 子代理 sessions / 工具调用，响应式 grid（2/3/6 列）。 交互与性能：可折叠全景、懒挂载（切 tab 不卸载不 re-fetch）、onJumpToTurn 回调定位。设计文档 docs/performance-tab-design.md。 v1.48 同时完成 perf2→perf 整合，并移除旧 Workflow tab 与 AI Workflow tab（删除 WorkflowAIView.tsx/WorkflowTreeView.tsx/prompts/workflow-analyse.md），其能力由 Performance + Audit 承接。 二、文件循迹重建 - File Content Restore（循迹复卷）：每文件行一键按时间戳拼合本会话内 read/write 片段重建全文（后写入者覆盖先前），未被读取行标注 --line N not found --；兼容 claude（N\t）与 opencode（<content> 信封 + N: ）两种 Read 格式，支持下载/收起。API GET /api/observe/session/file-restore + 纯函数库 src/lib/file-restore.ts。 - Gather & Rebuild Directory（重编汇册）：一键按路径树重建本会话工作目录下全部被读/写文件并打包下载 zip，服务端构建二进制响应（不在页面展开全部内容）。纯函数库 src/lib/zip-store.ts（buildZip/crc32/normalizeZipPath，STORE 无压缩 + UTF-8 文件名标志位兼容 Windows 中文路径）。API GET /api/observe/session/dir-restore。 - Skill Content（SKILL.md 全文）：每个 skill 可点击展示/下载全文，优先取原生 Skill 工具注入的 resultJson（剥前导），回退 Read of */SKILL.md（剥行号），多次加载取最长版本。API GET /api/observe/session/skill-content。 三、Session Compare — turn 对齐 - banded-DP turn 对齐算法：两个 session 逐 turn 对齐，Web Worker 后台计算不阻塞 UI，ComparePanorama 全景对比 token/费用/耗时/工具调用/subagent。含正确性与性能基准（tests/compare-perf/：banded-dp-correctness、turn-align.bench、api-n+1-elimination、render-smoke）。新增 src/lib/compare/turn-align.ts/turn-align.worker.ts。 四、增量刷新 Auto-refresh 探测源 DB 变化后增量导入（auto-refresh-probe.ts），支持 SSE 流式进度推送，适配 Claude Code JSONL 与 opencode DB。新增 API /api/observe/auto-refresh、/api/observe/auto-refresh-stream，e2e fixture 覆盖 append-turn/idle-assistant/streaming 场景。 五、CLI 与配置 - CLI export-md：导出 session 为 Markdown（与 Web UI 导出/audit step 1 同源输出），供轨迹分析器消费。src/cli/commands/export-md.ts。 - AI Provider 配置：settings 页面 + AIProviderConfigPanel，为审计配置 OpenAI 兼容 provider（baseUrl/apiKey/model）。 - agent-md-scan / agent-version：扫描本地 agent .md、提取版本号。 六、Audit 审计（持续完善中） - Audit tab 拆两个子 tab：Workflow audit（v1-v4，preview）+ Skill audit（接入 skill-eval 对账「真实执行 vs SKILL.md」：五态 verdict、可过滤 findings、by-instruction 表、实时进度条流式百分比）。 - Session Trajectory Analyzer：自建轻量 agent，正则预处理 + 有界 LLM 循环（≤3 轮）分析 10 万+ 行轨迹 MD，无需 Claude Code；Python 版 smart-agent/ + TS 版双端对齐，HTTP 服务 + Next.js 代理路由，Audit tab 可切 v1(TS)/v2(Python)。 - Audit 结果 JSON 导入/导出（audit-export.ts）。 七、性能优化 - 导入流水线 create → createMany + $transaction，单 session 35-100x 加速（23.5s→1.6s），batch 分批（500 条/批）防 SQLite 变量溢出 - opencode-db 适配器 N+1 消除：listSessions ~200+ → 5-6 次批量查询；readSession N×3 → 3 次 - 大 session 事务超时 5s → 60s，解决 "Transaction already closed" 八、移除项 移除 替代 Workflow tab（WorkflowAIView.tsx/WorkflowTreeView.tsx） Performance tab + Audit tab prompts/workflow-analyse.md session-trajectory-analyse.md + trajectory-compress.md tests/start-script.test.ts tests/start-sh-validation.test.ts 九、测试覆盖 新增 45 个测试文件，覆盖上述能力：zip-store(11)、skill-content(20)、file-restore(26)、dir-restore-api、skill-eval-audit、audit-job/audit-export、turn-align/-hard/-stress/-manual、compare-perf/*、claude-autorefresh*、agent-md-scan、trajectory-analyzer、cannbay-archive、upload-session-api、start-sh-validation 等。 同步内容为 skills-dev main 已提交状态，未带入开发仓未提交改动；package-lock.json 按 .gitignore 约定不入库；版本号 VERSION = "1.48"。 关联的Issue <!-- 本次为版本同步发布，暂无对应 Issue。cannbot-insight 大版本跳跃建议在本 PR 评审期间于 Discussions 同步说明。 --> 测试 - cannbot-insight 单元/集成测试：cd plugins-community/cannbot-insight && npm install && npm test（vitest，新增 45 个测试文件） - 仓库级 CI 闸门：./tests/gate_check.sh、./tests/run-tests.sh --fast - 4 个抽样文件 hash 已校验与 skills-dev main blob 一致，确保未带入未提交改动 文档更新 - README.md：Features 列表新增 Performance / 循迹复卷 / 重编汇册 / SKILL.md 全文 / Skill audit 描述 - CHANGELOG.md：补齐 v1.37-v1.40 条目 - 新增设计文档：docs/architecture.md、docs/performance-tab-design.md、docs/audit-skill-subtab-design.md、docs/session-trajectory-analyzer-design.md - 新增 smart-agent/README.md See merge request: cann/cannbot-skills!731 | 17 天前 | |
[feat]cannbot-insight tool Co-authored-by: guanxinghua<guanxinghua@huawei.com> # message auto-generated for no-merge-commit merge: !521 merge merge-cannbot-insight into master [feat]cannbot-insight tool Created-by: guanxinghua Commit-by: guanxinghua Merged-by: cann-robot Description: 需求@功能描述： https://gitcode.com/cann/cannbot-skills/issues/377 See merge request: cann/cannbot-skills!521 | 1 个月前 | |
[feat]cannbot-insight tool Co-authored-by: guanxinghua<guanxinghua@huawei.com> # message auto-generated for no-merge-commit merge: !521 merge merge-cannbot-insight into master [feat]cannbot-insight tool Created-by: guanxinghua Commit-by: guanxinghua Merged-by: cann-robot Description: 需求@功能描述： https://gitcode.com/cann/cannbot-skills/issues/377 See merge request: cann/cannbot-skills!521 | 1 个月前 | |
[feat]cannbot-insight tool Co-authored-by: guanxinghua<guanxinghua@huawei.com> # message auto-generated for no-merge-commit merge: !521 merge merge-cannbot-insight into master [feat]cannbot-insight tool Created-by: guanxinghua Commit-by: guanxinghua Merged-by: cann-robot Description: 需求@功能描述： https://gitcode.com/cann/cannbot-skills/issues/377 See merge request: cann/cannbot-skills!521 | 1 个月前 | |
feat(cannbot-insight): v1.51→v1.67——root 编排对账重构、Skill 加载校验、Audit 阶段诊断增强 Co-authored-by: duanbingzhe<duanbingzhe@huawei.com> # message auto-generated for no-merge-commit merge: !808 merge feature/update-cannbot-insight into master feat(cannbot-insight): v1.51→v1.67——root 编排对账重构、Skill 加载校验、Audit 阶段诊断增强 Created-by: duanbingzhe Commit-by: duanbingzhe Merged-by: cann-robot Description: ## 描述 版本 v1.51 → v1.67。合并多轮功能迭代，71 个文件变更（57 修改 + 14 新增，+4903 / -624）。核心聚焦三类审计/校验能力，其余为配套增强。 ## root 对账编排声明提取重构 - 新增 recoverWorkflowDeclaration 及辅助 resolveWorkflowSkillName / recoverSkillResourceFile - 优先级：skill resources 文件（task-prompts.md）> SKILL.md body > turn0 注入(≥500字) > null - 不再用 STATE.md / todowrite（属"任务完成度"，非"编排规程遵循度"） - 新增设计文档 docs/workflow-plan-extraction-design.md ## Skill 加载校验（新功能） - 新增 SkillContentAudit 组件 + use-skill-content-audit hook + skill-content-audit API - 校验每个 skill 是否在会话内读取完整 SKILL.md：Skill 工具注入即全文；Read 需无 offset/limit 且无截断标记才判全文，否则部分读取 - chip 三态（全文 / 部分 / 未读），点击 chip 在表格展开该 skill 行 ## Audit 增强 - v4 agent 树默认隐藏全部通过的子 agent（勾选开关才显示） - 跨 agent 问题与优化优先级每项给证据（agent:<name> #turn，可点击跳转）；审计头部展示本次消耗 token 数 - 新增 StageBreakdownTable + StageBreakdownRow 类型：6 阶段（extract/refine/headline/rebuild/judge/postprocess）墙钟+token 诊断，区分 LLM vs 程序阶段 - finding / aggregate 增加 source_excerpt（bullet 原文）、headline（人话标题）、turn_refs（证据 turn 序号，可点击跳转） ## Skills tab 增强 - 恢复展示 dispatch 的 subagent 行（此前被误删） - 新增 agent-content API：从磁盘扫 agent .md（AGENTS_SCAN_ROOT），多插件按 session dispatch 覆盖率消歧 ## smart-agent 增强 - trajectory_analyzer 新增 AdaptiveLimiter（自适应并发：激进出高限、撞限流乘性回退、窗口清了爬回）与 _is_rate_or_timeout 判别 - 重构 _audit_one_agent / _aggregate_session；subagent 桥接写入复刻 Claude Code subagent 存储结构 - jsonl_logger 支持 append 模式；server.py analyze_logger 改 append=False ## 零依赖导出 Session DB - 新增 export-db.mjs：从 opencode.db 或 Claude Code JSONL 提取单个 session（含子会话）为独立文件 - 零依赖：仅需 Node.js >= 22（内置 node:sqlite），无需 npm install / Prisma / 后端 - 自动识别框架，支持 --list / -s / -o / --json；README 新增"方式三" ## CLI upload 增强 - 支持 --session-id（非交互指定）、--list、--yes / --json、--description - README 重写上传文档（opencode / Claude Code 分开示例 + 参数表）；路径修正 sessions.db → opencode.db ## Turns 与概念追踪交互 - Turn 快速跳转：输入 turn 编号（如 #459）回车直达；subagent turn 自动展开祖先 dispatch lane - 概念追踪高亮跳转：搜索结果点击 View Turn 跳转 Turns tab，自动展开并高亮关键词至匹配位置 - 新增纯函数 src/lib/shared/highlight.tsx（highlightKeyword，大小写不敏感，<mark> 包裹） ## 测试与文档 - 新增 cannbot-insight adapter、opencode-db adapter、delete-session API、skill-content-audit API、trace-turn-highlight、turn-timeline-jump 等集成测试；skill-eval-audit 测试 +615 行 - README / README-zh 功能列表与 tab 描述同步；AGENTS.md 补充相关说明 See merge request: cann/cannbot-skills!808 | 8 天前 | |
feat(cannbot-insight): v1.51→v1.67——root 编排对账重构、Skill 加载校验、Audit 阶段诊断增强 Co-authored-by: duanbingzhe<duanbingzhe@huawei.com> # message auto-generated for no-merge-commit merge: !808 merge feature/update-cannbot-insight into master feat(cannbot-insight): v1.51→v1.67——root 编排对账重构、Skill 加载校验、Audit 阶段诊断增强 Created-by: duanbingzhe Commit-by: duanbingzhe Merged-by: cann-robot Description: ## 描述 版本 v1.51 → v1.67。合并多轮功能迭代，71 个文件变更（57 修改 + 14 新增，+4903 / -624）。核心聚焦三类审计/校验能力，其余为配套增强。 ## root 对账编排声明提取重构 - 新增 recoverWorkflowDeclaration 及辅助 resolveWorkflowSkillName / recoverSkillResourceFile - 优先级：skill resources 文件（task-prompts.md）> SKILL.md body > turn0 注入(≥500字) > null - 不再用 STATE.md / todowrite（属"任务完成度"，非"编排规程遵循度"） - 新增设计文档 docs/workflow-plan-extraction-design.md ## Skill 加载校验（新功能） - 新增 SkillContentAudit 组件 + use-skill-content-audit hook + skill-content-audit API - 校验每个 skill 是否在会话内读取完整 SKILL.md：Skill 工具注入即全文；Read 需无 offset/limit 且无截断标记才判全文，否则部分读取 - chip 三态（全文 / 部分 / 未读），点击 chip 在表格展开该 skill 行 ## Audit 增强 - v4 agent 树默认隐藏全部通过的子 agent（勾选开关才显示） - 跨 agent 问题与优化优先级每项给证据（agent:<name> #turn，可点击跳转）；审计头部展示本次消耗 token 数 - 新增 StageBreakdownTable + StageBreakdownRow 类型：6 阶段（extract/refine/headline/rebuild/judge/postprocess）墙钟+token 诊断，区分 LLM vs 程序阶段 - finding / aggregate 增加 source_excerpt（bullet 原文）、headline（人话标题）、turn_refs（证据 turn 序号，可点击跳转） ## Skills tab 增强 - 恢复展示 dispatch 的 subagent 行（此前被误删） - 新增 agent-content API：从磁盘扫 agent .md（AGENTS_SCAN_ROOT），多插件按 session dispatch 覆盖率消歧 ## smart-agent 增强 - trajectory_analyzer 新增 AdaptiveLimiter（自适应并发：激进出高限、撞限流乘性回退、窗口清了爬回）与 _is_rate_or_timeout 判别 - 重构 _audit_one_agent / _aggregate_session；subagent 桥接写入复刻 Claude Code subagent 存储结构 - jsonl_logger 支持 append 模式；server.py analyze_logger 改 append=False ## 零依赖导出 Session DB - 新增 export-db.mjs：从 opencode.db 或 Claude Code JSONL 提取单个 session（含子会话）为独立文件 - 零依赖：仅需 Node.js >= 22（内置 node:sqlite），无需 npm install / Prisma / 后端 - 自动识别框架，支持 --list / -s / -o / --json；README 新增"方式三" ## CLI upload 增强 - 支持 --session-id（非交互指定）、--list、--yes / --json、--description - README 重写上传文档（opencode / Claude Code 分开示例 + 参数表）；路径修正 sessions.db → opencode.db ## Turns 与概念追踪交互 - Turn 快速跳转：输入 turn 编号（如 #459）回车直达；subagent turn 自动展开祖先 dispatch lane - 概念追踪高亮跳转：搜索结果点击 View Turn 跳转 Turns tab，自动展开并高亮关键词至匹配位置 - 新增纯函数 src/lib/shared/highlight.tsx（highlightKeyword，大小写不敏感，<mark> 包裹） ## 测试与文档 - 新增 cannbot-insight adapter、opencode-db adapter、delete-session API、skill-content-audit API、trace-turn-highlight、turn-timeline-jump 等集成测试；skill-eval-audit 测试 +615 行 - README / README-zh 功能列表与 tab 描述同步；AGENTS.md 补充相关说明 See merge request: cann/cannbot-skills!808 | 8 天前 | |
feat(cannbot-insight): 同步 v1.51（v1.03 → v1.51） Co-authored-by: duanbingzhe<duanbingzhe@huawei.com> # message auto-generated for no-merge-commit merge: !731 merge fix/CleanCode into master feat(cannbot-insight): 同步 v1.51（v1.03 → v1.51） Created-by: duanbingzhe Commit-by: duanbingzhe Merged-by: cann-robot Description: ## 描述 cannbot-insight 功能更新，版本 v1.03 → v1.48。本次新增七大功能，新增 114 个文件、修改 48 个、移除 4 个（旧 Workflow/AI Workflow tab）。主线为 性能可观测（Performance 全景）、文件循迹重建、会话对齐，Audit 工作流审计作为 preview 先行合入承接后续迭代。 一、Performance 性能全景 全新的独立 Performance tab，一站式 session 级性能与成本可观测。所有数据直读 DB、零 LLM 依赖——确定性、可重复、即开即用，不受审计结果波动影响。 PerfPanorama 性能全景三大面板： 1. perf top — 子代理耗时排行（Linux top 风格） - 可排序表格（TURNS / TIME / TOKENS / AVG·T），活跃列箭头指示，列宽稳定不偏移 - 占比条形图：当前值占总量比例，条色随排序键切换（TIME 红 / TOKENS 蓝 / TURNS 灰），一眼锁定最耗资源的子代理 - 点击下钻：展开该子代理 turn 列表（§N + 耗时 + tokens + tools + model），默认 Top 10、一键展开全部 2. Token 成本分析 — 精准定位优化空间 - Cache 节省量卡片：命中缓存（绿）vs 未命中冷输入（红）的量与占比，直指 compaction 后重复输入的浪费 - 每轮 Cache 命中率趋势线（SVG 折线 + 面积渐变），compaction 事件自动标注（命中率骤降点），低命中轮次（<50%）标红 - 与 perf top 联动：下钻 turn 行增加 cache 命中率列，低命中高亮，形成「定位问题 turn → 跳转排查」闭环 3. Top 工具调用 — 耗时瓶颈定位 - 全 session 工具按 durationMs 降序 Top 10，水平条形图，标签 toolName §turnIndex - 点击直接跳转 turns tab 对应 turn 净耗时归因（关键能力）：主 Agent 耗时自动扣除并行子代理等待时间（max(bridge.subagentLatencyMs)），还原主 Agent 真实工作时间，避免被子代理壁钟时间虚高——这是判断「主 Agent 是真慢还是在等子代理」的核心依据。 7 张总览卡片：主 Agent 耗时(净) / 子代理耗时 / 总 Tokens / Cache 命中率 / 主 Agent turns / 子代理 sessions / 工具调用，响应式 grid（2/3/6 列）。 交互与性能：可折叠全景、懒挂载（切 tab 不卸载不 re-fetch）、onJumpToTurn 回调定位。设计文档 docs/performance-tab-design.md。 v1.48 同时完成 perf2→perf 整合，并移除旧 Workflow tab 与 AI Workflow tab（删除 WorkflowAIView.tsx/WorkflowTreeView.tsx/prompts/workflow-analyse.md），其能力由 Performance + Audit 承接。 二、文件循迹重建 - File Content Restore（循迹复卷）：每文件行一键按时间戳拼合本会话内 read/write 片段重建全文（后写入者覆盖先前），未被读取行标注 --line N not found --；兼容 claude（N\t）与 opencode（<content> 信封 + N: ）两种 Read 格式，支持下载/收起。API GET /api/observe/session/file-restore + 纯函数库 src/lib/file-restore.ts。 - Gather & Rebuild Directory（重编汇册）：一键按路径树重建本会话工作目录下全部被读/写文件并打包下载 zip，服务端构建二进制响应（不在页面展开全部内容）。纯函数库 src/lib/zip-store.ts（buildZip/crc32/normalizeZipPath，STORE 无压缩 + UTF-8 文件名标志位兼容 Windows 中文路径）。API GET /api/observe/session/dir-restore。 - Skill Content（SKILL.md 全文）：每个 skill 可点击展示/下载全文，优先取原生 Skill 工具注入的 resultJson（剥前导），回退 Read of */SKILL.md（剥行号），多次加载取最长版本。API GET /api/observe/session/skill-content。 三、Session Compare — turn 对齐 - banded-DP turn 对齐算法：两个 session 逐 turn 对齐，Web Worker 后台计算不阻塞 UI，ComparePanorama 全景对比 token/费用/耗时/工具调用/subagent。含正确性与性能基准（tests/compare-perf/：banded-dp-correctness、turn-align.bench、api-n+1-elimination、render-smoke）。新增 src/lib/compare/turn-align.ts/turn-align.worker.ts。 四、增量刷新 Auto-refresh 探测源 DB 变化后增量导入（auto-refresh-probe.ts），支持 SSE 流式进度推送，适配 Claude Code JSONL 与 opencode DB。新增 API /api/observe/auto-refresh、/api/observe/auto-refresh-stream，e2e fixture 覆盖 append-turn/idle-assistant/streaming 场景。 五、CLI 与配置 - CLI export-md：导出 session 为 Markdown（与 Web UI 导出/audit step 1 同源输出），供轨迹分析器消费。src/cli/commands/export-md.ts。 - AI Provider 配置：settings 页面 + AIProviderConfigPanel，为审计配置 OpenAI 兼容 provider（baseUrl/apiKey/model）。 - agent-md-scan / agent-version：扫描本地 agent .md、提取版本号。 六、Audit 审计（持续完善中） - Audit tab 拆两个子 tab：Workflow audit（v1-v4，preview）+ Skill audit（接入 skill-eval 对账「真实执行 vs SKILL.md」：五态 verdict、可过滤 findings、by-instruction 表、实时进度条流式百分比）。 - Session Trajectory Analyzer：自建轻量 agent，正则预处理 + 有界 LLM 循环（≤3 轮）分析 10 万+ 行轨迹 MD，无需 Claude Code；Python 版 smart-agent/ + TS 版双端对齐，HTTP 服务 + Next.js 代理路由，Audit tab 可切 v1(TS)/v2(Python)。 - Audit 结果 JSON 导入/导出（audit-export.ts）。 七、性能优化 - 导入流水线 create → createMany + $transaction，单 session 35-100x 加速（23.5s→1.6s），batch 分批（500 条/批）防 SQLite 变量溢出 - opencode-db 适配器 N+1 消除：listSessions ~200+ → 5-6 次批量查询；readSession N×3 → 3 次 - 大 session 事务超时 5s → 60s，解决 "Transaction already closed" 八、移除项 移除 替代 Workflow tab（WorkflowAIView.tsx/WorkflowTreeView.tsx） Performance tab + Audit tab prompts/workflow-analyse.md session-trajectory-analyse.md + trajectory-compress.md tests/start-script.test.ts tests/start-sh-validation.test.ts 九、测试覆盖 新增 45 个测试文件，覆盖上述能力：zip-store(11)、skill-content(20)、file-restore(26)、dir-restore-api、skill-eval-audit、audit-job/audit-export、turn-align/-hard/-stress/-manual、compare-perf/*、claude-autorefresh*、agent-md-scan、trajectory-analyzer、cannbay-archive、upload-session-api、start-sh-validation 等。 同步内容为 skills-dev main 已提交状态，未带入开发仓未提交改动；package-lock.json 按 .gitignore 约定不入库；版本号 VERSION = "1.48"。 关联的Issue <!-- 本次为版本同步发布，暂无对应 Issue。cannbot-insight 大版本跳跃建议在本 PR 评审期间于 Discussions 同步说明。 --> 测试 - cannbot-insight 单元/集成测试：cd plugins-community/cannbot-insight && npm install && npm test（vitest，新增 45 个测试文件） - 仓库级 CI 闸门：./tests/gate_check.sh、./tests/run-tests.sh --fast - 4 个抽样文件 hash 已校验与 skills-dev main blob 一致，确保未带入未提交改动 文档更新 - README.md：Features 列表新增 Performance / 循迹复卷 / 重编汇册 / SKILL.md 全文 / Skill audit 描述 - CHANGELOG.md：补齐 v1.37-v1.40 条目 - 新增设计文档：docs/architecture.md、docs/performance-tab-design.md、docs/audit-skill-subtab-design.md、docs/session-trajectory-analyzer-design.md - 新增 smart-agent/README.md See merge request: cann/cannbot-skills!731 | 17 天前 | |
feat(cannbot-insight): v1.51→v1.67——root 编排对账重构、Skill 加载校验、Audit 阶段诊断增强 Co-authored-by: duanbingzhe<duanbingzhe@huawei.com> # message auto-generated for no-merge-commit merge: !808 merge feature/update-cannbot-insight into master feat(cannbot-insight): v1.51→v1.67——root 编排对账重构、Skill 加载校验、Audit 阶段诊断增强 Created-by: duanbingzhe Commit-by: duanbingzhe Merged-by: cann-robot Description: ## 描述 版本 v1.51 → v1.67。合并多轮功能迭代，71 个文件变更（57 修改 + 14 新增，+4903 / -624）。核心聚焦三类审计/校验能力，其余为配套增强。 ## root 对账编排声明提取重构 - 新增 recoverWorkflowDeclaration 及辅助 resolveWorkflowSkillName / recoverSkillResourceFile - 优先级：skill resources 文件（task-prompts.md）> SKILL.md body > turn0 注入(≥500字) > null - 不再用 STATE.md / todowrite（属"任务完成度"，非"编排规程遵循度"） - 新增设计文档 docs/workflow-plan-extraction-design.md ## Skill 加载校验（新功能） - 新增 SkillContentAudit 组件 + use-skill-content-audit hook + skill-content-audit API - 校验每个 skill 是否在会话内读取完整 SKILL.md：Skill 工具注入即全文；Read 需无 offset/limit 且无截断标记才判全文，否则部分读取 - chip 三态（全文 / 部分 / 未读），点击 chip 在表格展开该 skill 行 ## Audit 增强 - v4 agent 树默认隐藏全部通过的子 agent（勾选开关才显示） - 跨 agent 问题与优化优先级每项给证据（agent:<name> #turn，可点击跳转）；审计头部展示本次消耗 token 数 - 新增 StageBreakdownTable + StageBreakdownRow 类型：6 阶段（extract/refine/headline/rebuild/judge/postprocess）墙钟+token 诊断，区分 LLM vs 程序阶段 - finding / aggregate 增加 source_excerpt（bullet 原文）、headline（人话标题）、turn_refs（证据 turn 序号，可点击跳转） ## Skills tab 增强 - 恢复展示 dispatch 的 subagent 行（此前被误删） - 新增 agent-content API：从磁盘扫 agent .md（AGENTS_SCAN_ROOT），多插件按 session dispatch 覆盖率消歧 ## smart-agent 增强 - trajectory_analyzer 新增 AdaptiveLimiter（自适应并发：激进出高限、撞限流乘性回退、窗口清了爬回）与 _is_rate_or_timeout 判别 - 重构 _audit_one_agent / _aggregate_session；subagent 桥接写入复刻 Claude Code subagent 存储结构 - jsonl_logger 支持 append 模式；server.py analyze_logger 改 append=False ## 零依赖导出 Session DB - 新增 export-db.mjs：从 opencode.db 或 Claude Code JSONL 提取单个 session（含子会话）为独立文件 - 零依赖：仅需 Node.js >= 22（内置 node:sqlite），无需 npm install / Prisma / 后端 - 自动识别框架，支持 --list / -s / -o / --json；README 新增"方式三" ## CLI upload 增强 - 支持 --session-id（非交互指定）、--list、--yes / --json、--description - README 重写上传文档（opencode / Claude Code 分开示例 + 参数表）；路径修正 sessions.db → opencode.db ## Turns 与概念追踪交互 - Turn 快速跳转：输入 turn 编号（如 #459）回车直达；subagent turn 自动展开祖先 dispatch lane - 概念追踪高亮跳转：搜索结果点击 View Turn 跳转 Turns tab，自动展开并高亮关键词至匹配位置 - 新增纯函数 src/lib/shared/highlight.tsx（highlightKeyword，大小写不敏感，<mark> 包裹） ## 测试与文档 - 新增 cannbot-insight adapter、opencode-db adapter、delete-session API、skill-content-audit API、trace-turn-highlight、turn-timeline-jump 等集成测试；skill-eval-audit 测试 +615 行 - README / README-zh 功能列表与 tab 描述同步；AGENTS.md 补充相关说明 See merge request: cann/cannbot-skills!808 | 8 天前 | |
feat(cannbot-insight): v1.51→v1.67——root 编排对账重构、Skill 加载校验、Audit 阶段诊断增强 Co-authored-by: duanbingzhe<duanbingzhe@huawei.com> # message auto-generated for no-merge-commit merge: !808 merge feature/update-cannbot-insight into master feat(cannbot-insight): v1.51→v1.67——root 编排对账重构、Skill 加载校验、Audit 阶段诊断增强 Created-by: duanbingzhe Commit-by: duanbingzhe Merged-by: cann-robot Description: ## 描述 版本 v1.51 → v1.67。合并多轮功能迭代，71 个文件变更（57 修改 + 14 新增，+4903 / -624）。核心聚焦三类审计/校验能力，其余为配套增强。 ## root 对账编排声明提取重构 - 新增 recoverWorkflowDeclaration 及辅助 resolveWorkflowSkillName / recoverSkillResourceFile - 优先级：skill resources 文件（task-prompts.md）> SKILL.md body > turn0 注入(≥500字) > null - 不再用 STATE.md / todowrite（属"任务完成度"，非"编排规程遵循度"） - 新增设计文档 docs/workflow-plan-extraction-design.md ## Skill 加载校验（新功能） - 新增 SkillContentAudit 组件 + use-skill-content-audit hook + skill-content-audit API - 校验每个 skill 是否在会话内读取完整 SKILL.md：Skill 工具注入即全文；Read 需无 offset/limit 且无截断标记才判全文，否则部分读取 - chip 三态（全文 / 部分 / 未读），点击 chip 在表格展开该 skill 行 ## Audit 增强 - v4 agent 树默认隐藏全部通过的子 agent（勾选开关才显示） - 跨 agent 问题与优化优先级每项给证据（agent:<name> #turn，可点击跳转）；审计头部展示本次消耗 token 数 - 新增 StageBreakdownTable + StageBreakdownRow 类型：6 阶段（extract/refine/headline/rebuild/judge/postprocess）墙钟+token 诊断，区分 LLM vs 程序阶段 - finding / aggregate 增加 source_excerpt（bullet 原文）、headline（人话标题）、turn_refs（证据 turn 序号，可点击跳转） ## Skills tab 增强 - 恢复展示 dispatch 的 subagent 行（此前被误删） - 新增 agent-content API：从磁盘扫 agent .md（AGENTS_SCAN_ROOT），多插件按 session dispatch 覆盖率消歧 ## smart-agent 增强 - trajectory_analyzer 新增 AdaptiveLimiter（自适应并发：激进出高限、撞限流乘性回退、窗口清了爬回）与 _is_rate_or_timeout 判别 - 重构 _audit_one_agent / _aggregate_session；subagent 桥接写入复刻 Claude Code subagent 存储结构 - jsonl_logger 支持 append 模式；server.py analyze_logger 改 append=False ## 零依赖导出 Session DB - 新增 export-db.mjs：从 opencode.db 或 Claude Code JSONL 提取单个 session（含子会话）为独立文件 - 零依赖：仅需 Node.js >= 22（内置 node:sqlite），无需 npm install / Prisma / 后端 - 自动识别框架，支持 --list / -s / -o / --json；README 新增"方式三" ## CLI upload 增强 - 支持 --session-id（非交互指定）、--list、--yes / --json、--description - README 重写上传文档（opencode / Claude Code 分开示例 + 参数表）；路径修正 sessions.db → opencode.db ## Turns 与概念追踪交互 - Turn 快速跳转：输入 turn 编号（如 #459）回车直达；subagent turn 自动展开祖先 dispatch lane - 概念追踪高亮跳转：搜索结果点击 View Turn 跳转 Turns tab，自动展开并高亮关键词至匹配位置 - 新增纯函数 src/lib/shared/highlight.tsx（highlightKeyword，大小写不敏感，<mark> 包裹） ## 测试与文档 - 新增 cannbot-insight adapter、opencode-db adapter、delete-session API、skill-content-audit API、trace-turn-highlight、turn-timeline-jump 等集成测试；skill-eval-audit 测试 +615 行 - README / README-zh 功能列表与 tab 描述同步；AGENTS.md 补充相关说明 See merge request: cann/cannbot-skills!808 | 8 天前 | |
[feat]cannbot-insight tool Co-authored-by: guanxinghua<guanxinghua@huawei.com> # message auto-generated for no-merge-commit merge: !521 merge merge-cannbot-insight into master [feat]cannbot-insight tool Created-by: guanxinghua Commit-by: guanxinghua Merged-by: cann-robot Description: 需求@功能描述： https://gitcode.com/cann/cannbot-skills/issues/377 See merge request: cann/cannbot-skills!521 | 1 个月前 | |
[feat]cannbot-insight tool Co-authored-by: guanxinghua<guanxinghua@huawei.com> # message auto-generated for no-merge-commit merge: !521 merge merge-cannbot-insight into master [feat]cannbot-insight tool Created-by: guanxinghua Commit-by: guanxinghua Merged-by: cann-robot Description: 需求@功能描述： https://gitcode.com/cann/cannbot-skills/issues/377 See merge request: cann/cannbot-skills!521 | 1 个月前 | |
feat(cannbot-insight): v1.51→v1.67——root 编排对账重构、Skill 加载校验、Audit 阶段诊断增强 Co-authored-by: duanbingzhe<duanbingzhe@huawei.com> # message auto-generated for no-merge-commit merge: !808 merge feature/update-cannbot-insight into master feat(cannbot-insight): v1.51→v1.67——root 编排对账重构、Skill 加载校验、Audit 阶段诊断增强 Created-by: duanbingzhe Commit-by: duanbingzhe Merged-by: cann-robot Description: ## 描述 版本 v1.51 → v1.67。合并多轮功能迭代，71 个文件变更（57 修改 + 14 新增，+4903 / -624）。核心聚焦三类审计/校验能力，其余为配套增强。 ## root 对账编排声明提取重构 - 新增 recoverWorkflowDeclaration 及辅助 resolveWorkflowSkillName / recoverSkillResourceFile - 优先级：skill resources 文件（task-prompts.md）> SKILL.md body > turn0 注入(≥500字) > null - 不再用 STATE.md / todowrite（属"任务完成度"，非"编排规程遵循度"） - 新增设计文档 docs/workflow-plan-extraction-design.md ## Skill 加载校验（新功能） - 新增 SkillContentAudit 组件 + use-skill-content-audit hook + skill-content-audit API - 校验每个 skill 是否在会话内读取完整 SKILL.md：Skill 工具注入即全文；Read 需无 offset/limit 且无截断标记才判全文，否则部分读取 - chip 三态（全文 / 部分 / 未读），点击 chip 在表格展开该 skill 行 ## Audit 增强 - v4 agent 树默认隐藏全部通过的子 agent（勾选开关才显示） - 跨 agent 问题与优化优先级每项给证据（agent:<name> #turn，可点击跳转）；审计头部展示本次消耗 token 数 - 新增 StageBreakdownTable + StageBreakdownRow 类型：6 阶段（extract/refine/headline/rebuild/judge/postprocess）墙钟+token 诊断，区分 LLM vs 程序阶段 - finding / aggregate 增加 source_excerpt（bullet 原文）、headline（人话标题）、turn_refs（证据 turn 序号，可点击跳转） ## Skills tab 增强 - 恢复展示 dispatch 的 subagent 行（此前被误删） - 新增 agent-content API：从磁盘扫 agent .md（AGENTS_SCAN_ROOT），多插件按 session dispatch 覆盖率消歧 ## smart-agent 增强 - trajectory_analyzer 新增 AdaptiveLimiter（自适应并发：激进出高限、撞限流乘性回退、窗口清了爬回）与 _is_rate_or_timeout 判别 - 重构 _audit_one_agent / _aggregate_session；subagent 桥接写入复刻 Claude Code subagent 存储结构 - jsonl_logger 支持 append 模式；server.py analyze_logger 改 append=False ## 零依赖导出 Session DB - 新增 export-db.mjs：从 opencode.db 或 Claude Code JSONL 提取单个 session（含子会话）为独立文件 - 零依赖：仅需 Node.js >= 22（内置 node:sqlite），无需 npm install / Prisma / 后端 - 自动识别框架，支持 --list / -s / -o / --json；README 新增"方式三" ## CLI upload 增强 - 支持 --session-id（非交互指定）、--list、--yes / --json、--description - README 重写上传文档（opencode / Claude Code 分开示例 + 参数表）；路径修正 sessions.db → opencode.db ## Turns 与概念追踪交互 - Turn 快速跳转：输入 turn 编号（如 #459）回车直达；subagent turn 自动展开祖先 dispatch lane - 概念追踪高亮跳转：搜索结果点击 View Turn 跳转 Turns tab，自动展开并高亮关键词至匹配位置 - 新增纯函数 src/lib/shared/highlight.tsx（highlightKeyword，大小写不敏感，<mark> 包裹） ## 测试与文档 - 新增 cannbot-insight adapter、opencode-db adapter、delete-session API、skill-content-audit API、trace-turn-highlight、turn-timeline-jump 等集成测试；skill-eval-audit 测试 +615 行 - README / README-zh 功能列表与 tab 描述同步；AGENTS.md 补充相关说明 See merge request: cann/cannbot-skills!808 | 8 天前 | |
feat(cannbot-insight): 同步 v1.51（v1.03 → v1.51） Co-authored-by: duanbingzhe<duanbingzhe@huawei.com> # message auto-generated for no-merge-commit merge: !731 merge fix/CleanCode into master feat(cannbot-insight): 同步 v1.51（v1.03 → v1.51） Created-by: duanbingzhe Commit-by: duanbingzhe Merged-by: cann-robot Description: ## 描述 cannbot-insight 功能更新，版本 v1.03 → v1.48。本次新增七大功能，新增 114 个文件、修改 48 个、移除 4 个（旧 Workflow/AI Workflow tab）。主线为 性能可观测（Performance 全景）、文件循迹重建、会话对齐，Audit 工作流审计作为 preview 先行合入承接后续迭代。 一、Performance 性能全景 全新的独立 Performance tab，一站式 session 级性能与成本可观测。所有数据直读 DB、零 LLM 依赖——确定性、可重复、即开即用，不受审计结果波动影响。 PerfPanorama 性能全景三大面板： 1. perf top — 子代理耗时排行（Linux top 风格） - 可排序表格（TURNS / TIME / TOKENS / AVG·T），活跃列箭头指示，列宽稳定不偏移 - 占比条形图：当前值占总量比例，条色随排序键切换（TIME 红 / TOKENS 蓝 / TURNS 灰），一眼锁定最耗资源的子代理 - 点击下钻：展开该子代理 turn 列表（§N + 耗时 + tokens + tools + model），默认 Top 10、一键展开全部 2. Token 成本分析 — 精准定位优化空间 - Cache 节省量卡片：命中缓存（绿）vs 未命中冷输入（红）的量与占比，直指 compaction 后重复输入的浪费 - 每轮 Cache 命中率趋势线（SVG 折线 + 面积渐变），compaction 事件自动标注（命中率骤降点），低命中轮次（<50%）标红 - 与 perf top 联动：下钻 turn 行增加 cache 命中率列，低命中高亮，形成「定位问题 turn → 跳转排查」闭环 3. Top 工具调用 — 耗时瓶颈定位 - 全 session 工具按 durationMs 降序 Top 10，水平条形图，标签 toolName §turnIndex - 点击直接跳转 turns tab 对应 turn 净耗时归因（关键能力）：主 Agent 耗时自动扣除并行子代理等待时间（max(bridge.subagentLatencyMs)），还原主 Agent 真实工作时间，避免被子代理壁钟时间虚高——这是判断「主 Agent 是真慢还是在等子代理」的核心依据。 7 张总览卡片：主 Agent 耗时(净) / 子代理耗时 / 总 Tokens / Cache 命中率 / 主 Agent turns / 子代理 sessions / 工具调用，响应式 grid（2/3/6 列）。 交互与性能：可折叠全景、懒挂载（切 tab 不卸载不 re-fetch）、onJumpToTurn 回调定位。设计文档 docs/performance-tab-design.md。 v1.48 同时完成 perf2→perf 整合，并移除旧 Workflow tab 与 AI Workflow tab（删除 WorkflowAIView.tsx/WorkflowTreeView.tsx/prompts/workflow-analyse.md），其能力由 Performance + Audit 承接。 二、文件循迹重建 - File Content Restore（循迹复卷）：每文件行一键按时间戳拼合本会话内 read/write 片段重建全文（后写入者覆盖先前），未被读取行标注 --line N not found --；兼容 claude（N\t）与 opencode（<content> 信封 + N: ）两种 Read 格式，支持下载/收起。API GET /api/observe/session/file-restore + 纯函数库 src/lib/file-restore.ts。 - Gather & Rebuild Directory（重编汇册）：一键按路径树重建本会话工作目录下全部被读/写文件并打包下载 zip，服务端构建二进制响应（不在页面展开全部内容）。纯函数库 src/lib/zip-store.ts（buildZip/crc32/normalizeZipPath，STORE 无压缩 + UTF-8 文件名标志位兼容 Windows 中文路径）。API GET /api/observe/session/dir-restore。 - Skill Content（SKILL.md 全文）：每个 skill 可点击展示/下载全文，优先取原生 Skill 工具注入的 resultJson（剥前导），回退 Read of */SKILL.md（剥行号），多次加载取最长版本。API GET /api/observe/session/skill-content。 三、Session Compare — turn 对齐 - banded-DP turn 对齐算法：两个 session 逐 turn 对齐，Web Worker 后台计算不阻塞 UI，ComparePanorama 全景对比 token/费用/耗时/工具调用/subagent。含正确性与性能基准（tests/compare-perf/：banded-dp-correctness、turn-align.bench、api-n+1-elimination、render-smoke）。新增 src/lib/compare/turn-align.ts/turn-align.worker.ts。 四、增量刷新 Auto-refresh 探测源 DB 变化后增量导入（auto-refresh-probe.ts），支持 SSE 流式进度推送，适配 Claude Code JSONL 与 opencode DB。新增 API /api/observe/auto-refresh、/api/observe/auto-refresh-stream，e2e fixture 覆盖 append-turn/idle-assistant/streaming 场景。 五、CLI 与配置 - CLI export-md：导出 session 为 Markdown（与 Web UI 导出/audit step 1 同源输出），供轨迹分析器消费。src/cli/commands/export-md.ts。 - AI Provider 配置：settings 页面 + AIProviderConfigPanel，为审计配置 OpenAI 兼容 provider（baseUrl/apiKey/model）。 - agent-md-scan / agent-version：扫描本地 agent .md、提取版本号。 六、Audit 审计（持续完善中） - Audit tab 拆两个子 tab：Workflow audit（v1-v4，preview）+ Skill audit（接入 skill-eval 对账「真实执行 vs SKILL.md」：五态 verdict、可过滤 findings、by-instruction 表、实时进度条流式百分比）。 - Session Trajectory Analyzer：自建轻量 agent，正则预处理 + 有界 LLM 循环（≤3 轮）分析 10 万+ 行轨迹 MD，无需 Claude Code；Python 版 smart-agent/ + TS 版双端对齐，HTTP 服务 + Next.js 代理路由，Audit tab 可切 v1(TS)/v2(Python)。 - Audit 结果 JSON 导入/导出（audit-export.ts）。 七、性能优化 - 导入流水线 create → createMany + $transaction，单 session 35-100x 加速（23.5s→1.6s），batch 分批（500 条/批）防 SQLite 变量溢出 - opencode-db 适配器 N+1 消除：listSessions ~200+ → 5-6 次批量查询；readSession N×3 → 3 次 - 大 session 事务超时 5s → 60s，解决 "Transaction already closed" 八、移除项 移除 替代 Workflow tab（WorkflowAIView.tsx/WorkflowTreeView.tsx） Performance tab + Audit tab prompts/workflow-analyse.md session-trajectory-analyse.md + trajectory-compress.md tests/start-script.test.ts tests/start-sh-validation.test.ts 九、测试覆盖 新增 45 个测试文件，覆盖上述能力：zip-store(11)、skill-content(20)、file-restore(26)、dir-restore-api、skill-eval-audit、audit-job/audit-export、turn-align/-hard/-stress/-manual、compare-perf/*、claude-autorefresh*、agent-md-scan、trajectory-analyzer、cannbay-archive、upload-session-api、start-sh-validation 等。 同步内容为 skills-dev main 已提交状态，未带入开发仓未提交改动；package-lock.json 按 .gitignore 约定不入库；版本号 VERSION = "1.48"。 关联的Issue <!-- 本次为版本同步发布，暂无对应 Issue。cannbot-insight 大版本跳跃建议在本 PR 评审期间于 Discussions 同步说明。 --> 测试 - cannbot-insight 单元/集成测试：cd plugins-community/cannbot-insight && npm install && npm test（vitest，新增 45 个测试文件） - 仓库级 CI 闸门：./tests/gate_check.sh、./tests/run-tests.sh --fast - 4 个抽样文件 hash 已校验与 skills-dev main blob 一致，确保未带入未提交改动 文档更新 - README.md：Features 列表新增 Performance / 循迹复卷 / 重编汇册 / SKILL.md 全文 / Skill audit 描述 - CHANGELOG.md：补齐 v1.37-v1.40 条目 - 新增设计文档：docs/architecture.md、docs/performance-tab-design.md、docs/audit-skill-subtab-design.md、docs/session-trajectory-analyzer-design.md - 新增 smart-agent/README.md See merge request: cann/cannbot-skills!731 | 17 天前 | |
feat(cannbot-insight): 同步 v1.51（v1.03 → v1.51） Co-authored-by: duanbingzhe<duanbingzhe@huawei.com> # message auto-generated for no-merge-commit merge: !731 merge fix/CleanCode into master feat(cannbot-insight): 同步 v1.51（v1.03 → v1.51） Created-by: duanbingzhe Commit-by: duanbingzhe Merged-by: cann-robot Description: ## 描述 cannbot-insight 功能更新，版本 v1.03 → v1.48。本次新增七大功能，新增 114 个文件、修改 48 个、移除 4 个（旧 Workflow/AI Workflow tab）。主线为 性能可观测（Performance 全景）、文件循迹重建、会话对齐，Audit 工作流审计作为 preview 先行合入承接后续迭代。 一、Performance 性能全景 全新的独立 Performance tab，一站式 session 级性能与成本可观测。所有数据直读 DB、零 LLM 依赖——确定性、可重复、即开即用，不受审计结果波动影响。 PerfPanorama 性能全景三大面板： 1. perf top — 子代理耗时排行（Linux top 风格） - 可排序表格（TURNS / TIME / TOKENS / AVG·T），活跃列箭头指示，列宽稳定不偏移 - 占比条形图：当前值占总量比例，条色随排序键切换（TIME 红 / TOKENS 蓝 / TURNS 灰），一眼锁定最耗资源的子代理 - 点击下钻：展开该子代理 turn 列表（§N + 耗时 + tokens + tools + model），默认 Top 10、一键展开全部 2. Token 成本分析 — 精准定位优化空间 - Cache 节省量卡片：命中缓存（绿）vs 未命中冷输入（红）的量与占比，直指 compaction 后重复输入的浪费 - 每轮 Cache 命中率趋势线（SVG 折线 + 面积渐变），compaction 事件自动标注（命中率骤降点），低命中轮次（<50%）标红 - 与 perf top 联动：下钻 turn 行增加 cache 命中率列，低命中高亮，形成「定位问题 turn → 跳转排查」闭环 3. Top 工具调用 — 耗时瓶颈定位 - 全 session 工具按 durationMs 降序 Top 10，水平条形图，标签 toolName §turnIndex - 点击直接跳转 turns tab 对应 turn 净耗时归因（关键能力）：主 Agent 耗时自动扣除并行子代理等待时间（max(bridge.subagentLatencyMs)），还原主 Agent 真实工作时间，避免被子代理壁钟时间虚高——这是判断「主 Agent 是真慢还是在等子代理」的核心依据。 7 张总览卡片：主 Agent 耗时(净) / 子代理耗时 / 总 Tokens / Cache 命中率 / 主 Agent turns / 子代理 sessions / 工具调用，响应式 grid（2/3/6 列）。 交互与性能：可折叠全景、懒挂载（切 tab 不卸载不 re-fetch）、onJumpToTurn 回调定位。设计文档 docs/performance-tab-design.md。 v1.48 同时完成 perf2→perf 整合，并移除旧 Workflow tab 与 AI Workflow tab（删除 WorkflowAIView.tsx/WorkflowTreeView.tsx/prompts/workflow-analyse.md），其能力由 Performance + Audit 承接。 二、文件循迹重建 - File Content Restore（循迹复卷）：每文件行一键按时间戳拼合本会话内 read/write 片段重建全文（后写入者覆盖先前），未被读取行标注 --line N not found --；兼容 claude（N\t）与 opencode（<content> 信封 + N: ）两种 Read 格式，支持下载/收起。API GET /api/observe/session/file-restore + 纯函数库 src/lib/file-restore.ts。 - Gather & Rebuild Directory（重编汇册）：一键按路径树重建本会话工作目录下全部被读/写文件并打包下载 zip，服务端构建二进制响应（不在页面展开全部内容）。纯函数库 src/lib/zip-store.ts（buildZip/crc32/normalizeZipPath，STORE 无压缩 + UTF-8 文件名标志位兼容 Windows 中文路径）。API GET /api/observe/session/dir-restore。 - Skill Content（SKILL.md 全文）：每个 skill 可点击展示/下载全文，优先取原生 Skill 工具注入的 resultJson（剥前导），回退 Read of */SKILL.md（剥行号），多次加载取最长版本。API GET /api/observe/session/skill-content。 三、Session Compare — turn 对齐 - banded-DP turn 对齐算法：两个 session 逐 turn 对齐，Web Worker 后台计算不阻塞 UI，ComparePanorama 全景对比 token/费用/耗时/工具调用/subagent。含正确性与性能基准（tests/compare-perf/：banded-dp-correctness、turn-align.bench、api-n+1-elimination、render-smoke）。新增 src/lib/compare/turn-align.ts/turn-align.worker.ts。 四、增量刷新 Auto-refresh 探测源 DB 变化后增量导入（auto-refresh-probe.ts），支持 SSE 流式进度推送，适配 Claude Code JSONL 与 opencode DB。新增 API /api/observe/auto-refresh、/api/observe/auto-refresh-stream，e2e fixture 覆盖 append-turn/idle-assistant/streaming 场景。 五、CLI 与配置 - CLI export-md：导出 session 为 Markdown（与 Web UI 导出/audit step 1 同源输出），供轨迹分析器消费。src/cli/commands/export-md.ts。 - AI Provider 配置：settings 页面 + AIProviderConfigPanel，为审计配置 OpenAI 兼容 provider（baseUrl/apiKey/model）。 - agent-md-scan / agent-version：扫描本地 agent .md、提取版本号。 六、Audit 审计（持续完善中） - Audit tab 拆两个子 tab：Workflow audit（v1-v4，preview）+ Skill audit（接入 skill-eval 对账「真实执行 vs SKILL.md」：五态 verdict、可过滤 findings、by-instruction 表、实时进度条流式百分比）。 - Session Trajectory Analyzer：自建轻量 agent，正则预处理 + 有界 LLM 循环（≤3 轮）分析 10 万+ 行轨迹 MD，无需 Claude Code；Python 版 smart-agent/ + TS 版双端对齐，HTTP 服务 + Next.js 代理路由，Audit tab 可切 v1(TS)/v2(Python)。 - Audit 结果 JSON 导入/导出（audit-export.ts）。 七、性能优化 - 导入流水线 create → createMany + $transaction，单 session 35-100x 加速（23.5s→1.6s），batch 分批（500 条/批）防 SQLite 变量溢出 - opencode-db 适配器 N+1 消除：listSessions ~200+ → 5-6 次批量查询；readSession N×3 → 3 次 - 大 session 事务超时 5s → 60s，解决 "Transaction already closed" 八、移除项 移除 替代 Workflow tab（WorkflowAIView.tsx/WorkflowTreeView.tsx） Performance tab + Audit tab prompts/workflow-analyse.md session-trajectory-analyse.md + trajectory-compress.md tests/start-script.test.ts tests/start-sh-validation.test.ts 九、测试覆盖 新增 45 个测试文件，覆盖上述能力：zip-store(11)、skill-content(20)、file-restore(26)、dir-restore-api、skill-eval-audit、audit-job/audit-export、turn-align/-hard/-stress/-manual、compare-perf/*、claude-autorefresh*、agent-md-scan、trajectory-analyzer、cannbay-archive、upload-session-api、start-sh-validation 等。 同步内容为 skills-dev main 已提交状态，未带入开发仓未提交改动；package-lock.json 按 .gitignore 约定不入库；版本号 VERSION = "1.48"。 关联的Issue <!-- 本次为版本同步发布，暂无对应 Issue。cannbot-insight 大版本跳跃建议在本 PR 评审期间于 Discussions 同步说明。 --> 测试 - cannbot-insight 单元/集成测试：cd plugins-community/cannbot-insight && npm install && npm test（vitest，新增 45 个测试文件） - 仓库级 CI 闸门：./tests/gate_check.sh、./tests/run-tests.sh --fast - 4 个抽样文件 hash 已校验与 skills-dev main blob 一致，确保未带入未提交改动 文档更新 - README.md：Features 列表新增 Performance / 循迹复卷 / 重编汇册 / SKILL.md 全文 / Skill audit 描述 - CHANGELOG.md：补齐 v1.37-v1.40 条目 - 新增设计文档：docs/architecture.md、docs/performance-tab-design.md、docs/audit-skill-subtab-design.md、docs/session-trajectory-analyzer-design.md - 新增 smart-agent/README.md See merge request: cann/cannbot-skills!731 | 17 天前 | |
feat(cannbot-insight): 同步 v1.51（v1.03 → v1.51） Co-authored-by: duanbingzhe<duanbingzhe@huawei.com> # message auto-generated for no-merge-commit merge: !731 merge fix/CleanCode into master feat(cannbot-insight): 同步 v1.51（v1.03 → v1.51） Created-by: duanbingzhe Commit-by: duanbingzhe Merged-by: cann-robot Description: ## 描述 cannbot-insight 功能更新，版本 v1.03 → v1.48。本次新增七大功能，新增 114 个文件、修改 48 个、移除 4 个（旧 Workflow/AI Workflow tab）。主线为 性能可观测（Performance 全景）、文件循迹重建、会话对齐，Audit 工作流审计作为 preview 先行合入承接后续迭代。 一、Performance 性能全景 全新的独立 Performance tab，一站式 session 级性能与成本可观测。所有数据直读 DB、零 LLM 依赖——确定性、可重复、即开即用，不受审计结果波动影响。 PerfPanorama 性能全景三大面板： 1. perf top — 子代理耗时排行（Linux top 风格） - 可排序表格（TURNS / TIME / TOKENS / AVG·T），活跃列箭头指示，列宽稳定不偏移 - 占比条形图：当前值占总量比例，条色随排序键切换（TIME 红 / TOKENS 蓝 / TURNS 灰），一眼锁定最耗资源的子代理 - 点击下钻：展开该子代理 turn 列表（§N + 耗时 + tokens + tools + model），默认 Top 10、一键展开全部 2. Token 成本分析 — 精准定位优化空间 - Cache 节省量卡片：命中缓存（绿）vs 未命中冷输入（红）的量与占比，直指 compaction 后重复输入的浪费 - 每轮 Cache 命中率趋势线（SVG 折线 + 面积渐变），compaction 事件自动标注（命中率骤降点），低命中轮次（<50%）标红 - 与 perf top 联动：下钻 turn 行增加 cache 命中率列，低命中高亮，形成「定位问题 turn → 跳转排查」闭环 3. Top 工具调用 — 耗时瓶颈定位 - 全 session 工具按 durationMs 降序 Top 10，水平条形图，标签 toolName §turnIndex - 点击直接跳转 turns tab 对应 turn 净耗时归因（关键能力）：主 Agent 耗时自动扣除并行子代理等待时间（max(bridge.subagentLatencyMs)），还原主 Agent 真实工作时间，避免被子代理壁钟时间虚高——这是判断「主 Agent 是真慢还是在等子代理」的核心依据。 7 张总览卡片：主 Agent 耗时(净) / 子代理耗时 / 总 Tokens / Cache 命中率 / 主 Agent turns / 子代理 sessions / 工具调用，响应式 grid（2/3/6 列）。 交互与性能：可折叠全景、懒挂载（切 tab 不卸载不 re-fetch）、onJumpToTurn 回调定位。设计文档 docs/performance-tab-design.md。 v1.48 同时完成 perf2→perf 整合，并移除旧 Workflow tab 与 AI Workflow tab（删除 WorkflowAIView.tsx/WorkflowTreeView.tsx/prompts/workflow-analyse.md），其能力由 Performance + Audit 承接。 二、文件循迹重建 - File Content Restore（循迹复卷）：每文件行一键按时间戳拼合本会话内 read/write 片段重建全文（后写入者覆盖先前），未被读取行标注 --line N not found --；兼容 claude（N\t）与 opencode（<content> 信封 + N: ）两种 Read 格式，支持下载/收起。API GET /api/observe/session/file-restore + 纯函数库 src/lib/file-restore.ts。 - Gather & Rebuild Directory（重编汇册）：一键按路径树重建本会话工作目录下全部被读/写文件并打包下载 zip，服务端构建二进制响应（不在页面展开全部内容）。纯函数库 src/lib/zip-store.ts（buildZip/crc32/normalizeZipPath，STORE 无压缩 + UTF-8 文件名标志位兼容 Windows 中文路径）。API GET /api/observe/session/dir-restore。 - Skill Content（SKILL.md 全文）：每个 skill 可点击展示/下载全文，优先取原生 Skill 工具注入的 resultJson（剥前导），回退 Read of */SKILL.md（剥行号），多次加载取最长版本。API GET /api/observe/session/skill-content。 三、Session Compare — turn 对齐 - banded-DP turn 对齐算法：两个 session 逐 turn 对齐，Web Worker 后台计算不阻塞 UI，ComparePanorama 全景对比 token/费用/耗时/工具调用/subagent。含正确性与性能基准（tests/compare-perf/：banded-dp-correctness、turn-align.bench、api-n+1-elimination、render-smoke）。新增 src/lib/compare/turn-align.ts/turn-align.worker.ts。 四、增量刷新 Auto-refresh 探测源 DB 变化后增量导入（auto-refresh-probe.ts），支持 SSE 流式进度推送，适配 Claude Code JSONL 与 opencode DB。新增 API /api/observe/auto-refresh、/api/observe/auto-refresh-stream，e2e fixture 覆盖 append-turn/idle-assistant/streaming 场景。 五、CLI 与配置 - CLI export-md：导出 session 为 Markdown（与 Web UI 导出/audit step 1 同源输出），供轨迹分析器消费。src/cli/commands/export-md.ts。 - AI Provider 配置：settings 页面 + AIProviderConfigPanel，为审计配置 OpenAI 兼容 provider（baseUrl/apiKey/model）。 - agent-md-scan / agent-version：扫描本地 agent .md、提取版本号。 六、Audit 审计（持续完善中） - Audit tab 拆两个子 tab：Workflow audit（v1-v4，preview）+ Skill audit（接入 skill-eval 对账「真实执行 vs SKILL.md」：五态 verdict、可过滤 findings、by-instruction 表、实时进度条流式百分比）。 - Session Trajectory Analyzer：自建轻量 agent，正则预处理 + 有界 LLM 循环（≤3 轮）分析 10 万+ 行轨迹 MD，无需 Claude Code；Python 版 smart-agent/ + TS 版双端对齐，HTTP 服务 + Next.js 代理路由，Audit tab 可切 v1(TS)/v2(Python)。 - Audit 结果 JSON 导入/导出（audit-export.ts）。 七、性能优化 - 导入流水线 create → createMany + $transaction，单 session 35-100x 加速（23.5s→1.6s），batch 分批（500 条/批）防 SQLite 变量溢出 - opencode-db 适配器 N+1 消除：listSessions ~200+ → 5-6 次批量查询；readSession N×3 → 3 次 - 大 session 事务超时 5s → 60s，解决 "Transaction already closed" 八、移除项 移除 替代 Workflow tab（WorkflowAIView.tsx/WorkflowTreeView.tsx） Performance tab + Audit tab prompts/workflow-analyse.md session-trajectory-analyse.md + trajectory-compress.md tests/start-script.test.ts tests/start-sh-validation.test.ts 九、测试覆盖 新增 45 个测试文件，覆盖上述能力：zip-store(11)、skill-content(20)、file-restore(26)、dir-restore-api、skill-eval-audit、audit-job/audit-export、turn-align/-hard/-stress/-manual、compare-perf/*、claude-autorefresh*、agent-md-scan、trajectory-analyzer、cannbay-archive、upload-session-api、start-sh-validation 等。 同步内容为 skills-dev main 已提交状态，未带入开发仓未提交改动；package-lock.json 按 .gitignore 约定不入库；版本号 VERSION = "1.48"。 关联的Issue <!-- 本次为版本同步发布，暂无对应 Issue。cannbot-insight 大版本跳跃建议在本 PR 评审期间于 Discussions 同步说明。 --> 测试 - cannbot-insight 单元/集成测试：cd plugins-community/cannbot-insight && npm install && npm test（vitest，新增 45 个测试文件） - 仓库级 CI 闸门：./tests/gate_check.sh、./tests/run-tests.sh --fast - 4 个抽样文件 hash 已校验与 skills-dev main blob 一致，确保未带入未提交改动 文档更新 - README.md：Features 列表新增 Performance / 循迹复卷 / 重编汇册 / SKILL.md 全文 / Skill audit 描述 - CHANGELOG.md：补齐 v1.37-v1.40 条目 - 新增设计文档：docs/architecture.md、docs/performance-tab-design.md、docs/audit-skill-subtab-design.md、docs/session-trajectory-analyzer-design.md - 新增 smart-agent/README.md See merge request: cann/cannbot-skills!731 | 17 天前 | |
[feat]cannbot-insight tool Co-authored-by: guanxinghua<guanxinghua@huawei.com> # message auto-generated for no-merge-commit merge: !521 merge merge-cannbot-insight into master [feat]cannbot-insight tool Created-by: guanxinghua Commit-by: guanxinghua Merged-by: cann-robot Description: 需求@功能描述： https://gitcode.com/cann/cannbot-skills/issues/377 See merge request: cann/cannbot-skills!521 | 1 个月前 | |
feat(cannbot-insight): v1.51→v1.67——root 编排对账重构、Skill 加载校验、Audit 阶段诊断增强 Co-authored-by: duanbingzhe<duanbingzhe@huawei.com> # message auto-generated for no-merge-commit merge: !808 merge feature/update-cannbot-insight into master feat(cannbot-insight): v1.51→v1.67——root 编排对账重构、Skill 加载校验、Audit 阶段诊断增强 Created-by: duanbingzhe Commit-by: duanbingzhe Merged-by: cann-robot Description: ## 描述 版本 v1.51 → v1.67。合并多轮功能迭代，71 个文件变更（57 修改 + 14 新增，+4903 / -624）。核心聚焦三类审计/校验能力，其余为配套增强。 ## root 对账编排声明提取重构 - 新增 recoverWorkflowDeclaration 及辅助 resolveWorkflowSkillName / recoverSkillResourceFile - 优先级：skill resources 文件（task-prompts.md）> SKILL.md body > turn0 注入(≥500字) > null - 不再用 STATE.md / todowrite（属"任务完成度"，非"编排规程遵循度"） - 新增设计文档 docs/workflow-plan-extraction-design.md ## Skill 加载校验（新功能） - 新增 SkillContentAudit 组件 + use-skill-content-audit hook + skill-content-audit API - 校验每个 skill 是否在会话内读取完整 SKILL.md：Skill 工具注入即全文；Read 需无 offset/limit 且无截断标记才判全文，否则部分读取 - chip 三态（全文 / 部分 / 未读），点击 chip 在表格展开该 skill 行 ## Audit 增强 - v4 agent 树默认隐藏全部通过的子 agent（勾选开关才显示） - 跨 agent 问题与优化优先级每项给证据（agent:<name> #turn，可点击跳转）；审计头部展示本次消耗 token 数 - 新增 StageBreakdownTable + StageBreakdownRow 类型：6 阶段（extract/refine/headline/rebuild/judge/postprocess）墙钟+token 诊断，区分 LLM vs 程序阶段 - finding / aggregate 增加 source_excerpt（bullet 原文）、headline（人话标题）、turn_refs（证据 turn 序号，可点击跳转） ## Skills tab 增强 - 恢复展示 dispatch 的 subagent 行（此前被误删） - 新增 agent-content API：从磁盘扫 agent .md（AGENTS_SCAN_ROOT），多插件按 session dispatch 覆盖率消歧 ## smart-agent 增强 - trajectory_analyzer 新增 AdaptiveLimiter（自适应并发：激进出高限、撞限流乘性回退、窗口清了爬回）与 _is_rate_or_timeout 判别 - 重构 _audit_one_agent / _aggregate_session；subagent 桥接写入复刻 Claude Code subagent 存储结构 - jsonl_logger 支持 append 模式；server.py analyze_logger 改 append=False ## 零依赖导出 Session DB - 新增 export-db.mjs：从 opencode.db 或 Claude Code JSONL 提取单个 session（含子会话）为独立文件 - 零依赖：仅需 Node.js >= 22（内置 node:sqlite），无需 npm install / Prisma / 后端 - 自动识别框架，支持 --list / -s / -o / --json；README 新增"方式三" ## CLI upload 增强 - 支持 --session-id（非交互指定）、--list、--yes / --json、--description - README 重写上传文档（opencode / Claude Code 分开示例 + 参数表）；路径修正 sessions.db → opencode.db ## Turns 与概念追踪交互 - Turn 快速跳转：输入 turn 编号（如 #459）回车直达；subagent turn 自动展开祖先 dispatch lane - 概念追踪高亮跳转：搜索结果点击 View Turn 跳转 Turns tab，自动展开并高亮关键词至匹配位置 - 新增纯函数 src/lib/shared/highlight.tsx（highlightKeyword，大小写不敏感，<mark> 包裹） ## 测试与文档 - 新增 cannbot-insight adapter、opencode-db adapter、delete-session API、skill-content-audit API、trace-turn-highlight、turn-timeline-jump 等集成测试；skill-eval-audit 测试 +615 行 - README / README-zh 功能列表与 tab 描述同步；AGENTS.md 补充相关说明 See merge request: cann/cannbot-skills!808 | 8 天前 | |
feat(cannbot-insight): 同步 v1.51（v1.03 → v1.51） Co-authored-by: duanbingzhe<duanbingzhe@huawei.com> # message auto-generated for no-merge-commit merge: !731 merge fix/CleanCode into master feat(cannbot-insight): 同步 v1.51（v1.03 → v1.51） Created-by: duanbingzhe Commit-by: duanbingzhe Merged-by: cann-robot Description: ## 描述 cannbot-insight 功能更新，版本 v1.03 → v1.48。本次新增七大功能，新增 114 个文件、修改 48 个、移除 4 个（旧 Workflow/AI Workflow tab）。主线为 性能可观测（Performance 全景）、文件循迹重建、会话对齐，Audit 工作流审计作为 preview 先行合入承接后续迭代。 一、Performance 性能全景 全新的独立 Performance tab，一站式 session 级性能与成本可观测。所有数据直读 DB、零 LLM 依赖——确定性、可重复、即开即用，不受审计结果波动影响。 PerfPanorama 性能全景三大面板： 1. perf top — 子代理耗时排行（Linux top 风格） - 可排序表格（TURNS / TIME / TOKENS / AVG·T），活跃列箭头指示，列宽稳定不偏移 - 占比条形图：当前值占总量比例，条色随排序键切换（TIME 红 / TOKENS 蓝 / TURNS 灰），一眼锁定最耗资源的子代理 - 点击下钻：展开该子代理 turn 列表（§N + 耗时 + tokens + tools + model），默认 Top 10、一键展开全部 2. Token 成本分析 — 精准定位优化空间 - Cache 节省量卡片：命中缓存（绿）vs 未命中冷输入（红）的量与占比，直指 compaction 后重复输入的浪费 - 每轮 Cache 命中率趋势线（SVG 折线 + 面积渐变），compaction 事件自动标注（命中率骤降点），低命中轮次（<50%）标红 - 与 perf top 联动：下钻 turn 行增加 cache 命中率列，低命中高亮，形成「定位问题 turn → 跳转排查」闭环 3. Top 工具调用 — 耗时瓶颈定位 - 全 session 工具按 durationMs 降序 Top 10，水平条形图，标签 toolName §turnIndex - 点击直接跳转 turns tab 对应 turn 净耗时归因（关键能力）：主 Agent 耗时自动扣除并行子代理等待时间（max(bridge.subagentLatencyMs)），还原主 Agent 真实工作时间，避免被子代理壁钟时间虚高——这是判断「主 Agent 是真慢还是在等子代理」的核心依据。 7 张总览卡片：主 Agent 耗时(净) / 子代理耗时 / 总 Tokens / Cache 命中率 / 主 Agent turns / 子代理 sessions / 工具调用，响应式 grid（2/3/6 列）。 交互与性能：可折叠全景、懒挂载（切 tab 不卸载不 re-fetch）、onJumpToTurn 回调定位。设计文档 docs/performance-tab-design.md。 v1.48 同时完成 perf2→perf 整合，并移除旧 Workflow tab 与 AI Workflow tab（删除 WorkflowAIView.tsx/WorkflowTreeView.tsx/prompts/workflow-analyse.md），其能力由 Performance + Audit 承接。 二、文件循迹重建 - File Content Restore（循迹复卷）：每文件行一键按时间戳拼合本会话内 read/write 片段重建全文（后写入者覆盖先前），未被读取行标注 --line N not found --；兼容 claude（N\t）与 opencode（<content> 信封 + N: ）两种 Read 格式，支持下载/收起。API GET /api/observe/session/file-restore + 纯函数库 src/lib/file-restore.ts。 - Gather & Rebuild Directory（重编汇册）：一键按路径树重建本会话工作目录下全部被读/写文件并打包下载 zip，服务端构建二进制响应（不在页面展开全部内容）。纯函数库 src/lib/zip-store.ts（buildZip/crc32/normalizeZipPath，STORE 无压缩 + UTF-8 文件名标志位兼容 Windows 中文路径）。API GET /api/observe/session/dir-restore。 - Skill Content（SKILL.md 全文）：每个 skill 可点击展示/下载全文，优先取原生 Skill 工具注入的 resultJson（剥前导），回退 Read of */SKILL.md（剥行号），多次加载取最长版本。API GET /api/observe/session/skill-content。 三、Session Compare — turn 对齐 - banded-DP turn 对齐算法：两个 session 逐 turn 对齐，Web Worker 后台计算不阻塞 UI，ComparePanorama 全景对比 token/费用/耗时/工具调用/subagent。含正确性与性能基准（tests/compare-perf/：banded-dp-correctness、turn-align.bench、api-n+1-elimination、render-smoke）。新增 src/lib/compare/turn-align.ts/turn-align.worker.ts。 四、增量刷新 Auto-refresh 探测源 DB 变化后增量导入（auto-refresh-probe.ts），支持 SSE 流式进度推送，适配 Claude Code JSONL 与 opencode DB。新增 API /api/observe/auto-refresh、/api/observe/auto-refresh-stream，e2e fixture 覆盖 append-turn/idle-assistant/streaming 场景。 五、CLI 与配置 - CLI export-md：导出 session 为 Markdown（与 Web UI 导出/audit step 1 同源输出），供轨迹分析器消费。src/cli/commands/export-md.ts。 - AI Provider 配置：settings 页面 + AIProviderConfigPanel，为审计配置 OpenAI 兼容 provider（baseUrl/apiKey/model）。 - agent-md-scan / agent-version：扫描本地 agent .md、提取版本号。 六、Audit 审计（持续完善中） - Audit tab 拆两个子 tab：Workflow audit（v1-v4，preview）+ Skill audit（接入 skill-eval 对账「真实执行 vs SKILL.md」：五态 verdict、可过滤 findings、by-instruction 表、实时进度条流式百分比）。 - Session Trajectory Analyzer：自建轻量 agent，正则预处理 + 有界 LLM 循环（≤3 轮）分析 10 万+ 行轨迹 MD，无需 Claude Code；Python 版 smart-agent/ + TS 版双端对齐，HTTP 服务 + Next.js 代理路由，Audit tab 可切 v1(TS)/v2(Python)。 - Audit 结果 JSON 导入/导出（audit-export.ts）。 七、性能优化 - 导入流水线 create → createMany + $transaction，单 session 35-100x 加速（23.5s→1.6s），batch 分批（500 条/批）防 SQLite 变量溢出 - opencode-db 适配器 N+1 消除：listSessions ~200+ → 5-6 次批量查询；readSession N×3 → 3 次 - 大 session 事务超时 5s → 60s，解决 "Transaction already closed" 八、移除项 移除 替代 Workflow tab（WorkflowAIView.tsx/WorkflowTreeView.tsx） Performance tab + Audit tab prompts/workflow-analyse.md session-trajectory-analyse.md + trajectory-compress.md tests/start-script.test.ts tests/start-sh-validation.test.ts 九、测试覆盖 新增 45 个测试文件，覆盖上述能力：zip-store(11)、skill-content(20)、file-restore(26)、dir-restore-api、skill-eval-audit、audit-job/audit-export、turn-align/-hard/-stress/-manual、compare-perf/*、claude-autorefresh*、agent-md-scan、trajectory-analyzer、cannbay-archive、upload-session-api、start-sh-validation 等。 同步内容为 skills-dev main 已提交状态，未带入开发仓未提交改动；package-lock.json 按 .gitignore 约定不入库；版本号 VERSION = "1.48"。 关联的Issue <!-- 本次为版本同步发布，暂无对应 Issue。cannbot-insight 大版本跳跃建议在本 PR 评审期间于 Discussions 同步说明。 --> 测试 - cannbot-insight 单元/集成测试：cd plugins-community/cannbot-insight && npm install && npm test（vitest，新增 45 个测试文件） - 仓库级 CI 闸门：./tests/gate_check.sh、./tests/run-tests.sh --fast - 4 个抽样文件 hash 已校验与 skills-dev main blob 一致，确保未带入未提交改动 文档更新 - README.md：Features 列表新增 Performance / 循迹复卷 / 重编汇册 / SKILL.md 全文 / Skill audit 描述 - CHANGELOG.md：补齐 v1.37-v1.40 条目 - 新增设计文档：docs/architecture.md、docs/performance-tab-design.md、docs/audit-skill-subtab-design.md、docs/session-trajectory-analyzer-design.md - 新增 smart-agent/README.md See merge request: cann/cannbot-skills!731 | 17 天前 | |
feat(cannbot-insight): 同步 v1.51（v1.03 → v1.51） Co-authored-by: duanbingzhe<duanbingzhe@huawei.com> # message auto-generated for no-merge-commit merge: !731 merge fix/CleanCode into master feat(cannbot-insight): 同步 v1.51（v1.03 → v1.51） Created-by: duanbingzhe Commit-by: duanbingzhe Merged-by: cann-robot Description: ## 描述 cannbot-insight 功能更新，版本 v1.03 → v1.48。本次新增七大功能，新增 114 个文件、修改 48 个、移除 4 个（旧 Workflow/AI Workflow tab）。主线为 性能可观测（Performance 全景）、文件循迹重建、会话对齐，Audit 工作流审计作为 preview 先行合入承接后续迭代。 一、Performance 性能全景 全新的独立 Performance tab，一站式 session 级性能与成本可观测。所有数据直读 DB、零 LLM 依赖——确定性、可重复、即开即用，不受审计结果波动影响。 PerfPanorama 性能全景三大面板： 1. perf top — 子代理耗时排行（Linux top 风格） - 可排序表格（TURNS / TIME / TOKENS / AVG·T），活跃列箭头指示，列宽稳定不偏移 - 占比条形图：当前值占总量比例，条色随排序键切换（TIME 红 / TOKENS 蓝 / TURNS 灰），一眼锁定最耗资源的子代理 - 点击下钻：展开该子代理 turn 列表（§N + 耗时 + tokens + tools + model），默认 Top 10、一键展开全部 2. Token 成本分析 — 精准定位优化空间 - Cache 节省量卡片：命中缓存（绿）vs 未命中冷输入（红）的量与占比，直指 compaction 后重复输入的浪费 - 每轮 Cache 命中率趋势线（SVG 折线 + 面积渐变），compaction 事件自动标注（命中率骤降点），低命中轮次（<50%）标红 - 与 perf top 联动：下钻 turn 行增加 cache 命中率列，低命中高亮，形成「定位问题 turn → 跳转排查」闭环 3. Top 工具调用 — 耗时瓶颈定位 - 全 session 工具按 durationMs 降序 Top 10，水平条形图，标签 toolName §turnIndex - 点击直接跳转 turns tab 对应 turn 净耗时归因（关键能力）：主 Agent 耗时自动扣除并行子代理等待时间（max(bridge.subagentLatencyMs)），还原主 Agent 真实工作时间，避免被子代理壁钟时间虚高——这是判断「主 Agent 是真慢还是在等子代理」的核心依据。 7 张总览卡片：主 Agent 耗时(净) / 子代理耗时 / 总 Tokens / Cache 命中率 / 主 Agent turns / 子代理 sessions / 工具调用，响应式 grid（2/3/6 列）。 交互与性能：可折叠全景、懒挂载（切 tab 不卸载不 re-fetch）、onJumpToTurn 回调定位。设计文档 docs/performance-tab-design.md。 v1.48 同时完成 perf2→perf 整合，并移除旧 Workflow tab 与 AI Workflow tab（删除 WorkflowAIView.tsx/WorkflowTreeView.tsx/prompts/workflow-analyse.md），其能力由 Performance + Audit 承接。 二、文件循迹重建 - File Content Restore（循迹复卷）：每文件行一键按时间戳拼合本会话内 read/write 片段重建全文（后写入者覆盖先前），未被读取行标注 --line N not found --；兼容 claude（N\t）与 opencode（<content> 信封 + N: ）两种 Read 格式，支持下载/收起。API GET /api/observe/session/file-restore + 纯函数库 src/lib/file-restore.ts。 - Gather & Rebuild Directory（重编汇册）：一键按路径树重建本会话工作目录下全部被读/写文件并打包下载 zip，服务端构建二进制响应（不在页面展开全部内容）。纯函数库 src/lib/zip-store.ts（buildZip/crc32/normalizeZipPath，STORE 无压缩 + UTF-8 文件名标志位兼容 Windows 中文路径）。API GET /api/observe/session/dir-restore。 - Skill Content（SKILL.md 全文）：每个 skill 可点击展示/下载全文，优先取原生 Skill 工具注入的 resultJson（剥前导），回退 Read of */SKILL.md（剥行号），多次加载取最长版本。API GET /api/observe/session/skill-content。 三、Session Compare — turn 对齐 - banded-DP turn 对齐算法：两个 session 逐 turn 对齐，Web Worker 后台计算不阻塞 UI，ComparePanorama 全景对比 token/费用/耗时/工具调用/subagent。含正确性与性能基准（tests/compare-perf/：banded-dp-correctness、turn-align.bench、api-n+1-elimination、render-smoke）。新增 src/lib/compare/turn-align.ts/turn-align.worker.ts。 四、增量刷新 Auto-refresh 探测源 DB 变化后增量导入（auto-refresh-probe.ts），支持 SSE 流式进度推送，适配 Claude Code JSONL 与 opencode DB。新增 API /api/observe/auto-refresh、/api/observe/auto-refresh-stream，e2e fixture 覆盖 append-turn/idle-assistant/streaming 场景。 五、CLI 与配置 - CLI export-md：导出 session 为 Markdown（与 Web UI 导出/audit step 1 同源输出），供轨迹分析器消费。src/cli/commands/export-md.ts。 - AI Provider 配置：settings 页面 + AIProviderConfigPanel，为审计配置 OpenAI 兼容 provider（baseUrl/apiKey/model）。 - agent-md-scan / agent-version：扫描本地 agent .md、提取版本号。 六、Audit 审计（持续完善中） - Audit tab 拆两个子 tab：Workflow audit（v1-v4，preview）+ Skill audit（接入 skill-eval 对账「真实执行 vs SKILL.md」：五态 verdict、可过滤 findings、by-instruction 表、实时进度条流式百分比）。 - Session Trajectory Analyzer：自建轻量 agent，正则预处理 + 有界 LLM 循环（≤3 轮）分析 10 万+ 行轨迹 MD，无需 Claude Code；Python 版 smart-agent/ + TS 版双端对齐，HTTP 服务 + Next.js 代理路由，Audit tab 可切 v1(TS)/v2(Python)。 - Audit 结果 JSON 导入/导出（audit-export.ts）。 七、性能优化 - 导入流水线 create → createMany + $transaction，单 session 35-100x 加速（23.5s→1.6s），batch 分批（500 条/批）防 SQLite 变量溢出 - opencode-db 适配器 N+1 消除：listSessions ~200+ → 5-6 次批量查询；readSession N×3 → 3 次 - 大 session 事务超时 5s → 60s，解决 "Transaction already closed" 八、移除项 移除 替代 Workflow tab（WorkflowAIView.tsx/WorkflowTreeView.tsx） Performance tab + Audit tab prompts/workflow-analyse.md session-trajectory-analyse.md + trajectory-compress.md tests/start-script.test.ts tests/start-sh-validation.test.ts 九、测试覆盖 新增 45 个测试文件，覆盖上述能力：zip-store(11)、skill-content(20)、file-restore(26)、dir-restore-api、skill-eval-audit、audit-job/audit-export、turn-align/-hard/-stress/-manual、compare-perf/*、claude-autorefresh*、agent-md-scan、trajectory-analyzer、cannbay-archive、upload-session-api、start-sh-validation 等。 同步内容为 skills-dev main 已提交状态，未带入开发仓未提交改动；package-lock.json 按 .gitignore 约定不入库；版本号 VERSION = "1.48"。 关联的Issue <!-- 本次为版本同步发布，暂无对应 Issue。cannbot-insight 大版本跳跃建议在本 PR 评审期间于 Discussions 同步说明。 --> 测试 - cannbot-insight 单元/集成测试：cd plugins-community/cannbot-insight && npm install && npm test（vitest，新增 45 个测试文件） - 仓库级 CI 闸门：./tests/gate_check.sh、./tests/run-tests.sh --fast - 4 个抽样文件 hash 已校验与 skills-dev main blob 一致，确保未带入未提交改动 文档更新 - README.md：Features 列表新增 Performance / 循迹复卷 / 重编汇册 / SKILL.md 全文 / Skill audit 描述 - CHANGELOG.md：补齐 v1.37-v1.40 条目 - 新增设计文档：docs/architecture.md、docs/performance-tab-design.md、docs/audit-skill-subtab-design.md、docs/session-trajectory-analyzer-design.md - 新增 smart-agent/README.md See merge request: cann/cannbot-skills!731 | 17 天前 | |
feat(cannbot-insight): 同步 v1.51（v1.03 → v1.51） Co-authored-by: duanbingzhe<duanbingzhe@huawei.com> # message auto-generated for no-merge-commit merge: !731 merge fix/CleanCode into master feat(cannbot-insight): 同步 v1.51（v1.03 → v1.51） Created-by: duanbingzhe Commit-by: duanbingzhe Merged-by: cann-robot Description: ## 描述 cannbot-insight 功能更新，版本 v1.03 → v1.48。本次新增七大功能，新增 114 个文件、修改 48 个、移除 4 个（旧 Workflow/AI Workflow tab）。主线为 性能可观测（Performance 全景）、文件循迹重建、会话对齐，Audit 工作流审计作为 preview 先行合入承接后续迭代。 一、Performance 性能全景 全新的独立 Performance tab，一站式 session 级性能与成本可观测。所有数据直读 DB、零 LLM 依赖——确定性、可重复、即开即用，不受审计结果波动影响。 PerfPanorama 性能全景三大面板： 1. perf top — 子代理耗时排行（Linux top 风格） - 可排序表格（TURNS / TIME / TOKENS / AVG·T），活跃列箭头指示，列宽稳定不偏移 - 占比条形图：当前值占总量比例，条色随排序键切换（TIME 红 / TOKENS 蓝 / TURNS 灰），一眼锁定最耗资源的子代理 - 点击下钻：展开该子代理 turn 列表（§N + 耗时 + tokens + tools + model），默认 Top 10、一键展开全部 2. Token 成本分析 — 精准定位优化空间 - Cache 节省量卡片：命中缓存（绿）vs 未命中冷输入（红）的量与占比，直指 compaction 后重复输入的浪费 - 每轮 Cache 命中率趋势线（SVG 折线 + 面积渐变），compaction 事件自动标注（命中率骤降点），低命中轮次（<50%）标红 - 与 perf top 联动：下钻 turn 行增加 cache 命中率列，低命中高亮，形成「定位问题 turn → 跳转排查」闭环 3. Top 工具调用 — 耗时瓶颈定位 - 全 session 工具按 durationMs 降序 Top 10，水平条形图，标签 toolName §turnIndex - 点击直接跳转 turns tab 对应 turn 净耗时归因（关键能力）：主 Agent 耗时自动扣除并行子代理等待时间（max(bridge.subagentLatencyMs)），还原主 Agent 真实工作时间，避免被子代理壁钟时间虚高——这是判断「主 Agent 是真慢还是在等子代理」的核心依据。 7 张总览卡片：主 Agent 耗时(净) / 子代理耗时 / 总 Tokens / Cache 命中率 / 主 Agent turns / 子代理 sessions / 工具调用，响应式 grid（2/3/6 列）。 交互与性能：可折叠全景、懒挂载（切 tab 不卸载不 re-fetch）、onJumpToTurn 回调定位。设计文档 docs/performance-tab-design.md。 v1.48 同时完成 perf2→perf 整合，并移除旧 Workflow tab 与 AI Workflow tab（删除 WorkflowAIView.tsx/WorkflowTreeView.tsx/prompts/workflow-analyse.md），其能力由 Performance + Audit 承接。 二、文件循迹重建 - File Content Restore（循迹复卷）：每文件行一键按时间戳拼合本会话内 read/write 片段重建全文（后写入者覆盖先前），未被读取行标注 --line N not found --；兼容 claude（N\t）与 opencode（<content> 信封 + N: ）两种 Read 格式，支持下载/收起。API GET /api/observe/session/file-restore + 纯函数库 src/lib/file-restore.ts。 - Gather & Rebuild Directory（重编汇册）：一键按路径树重建本会话工作目录下全部被读/写文件并打包下载 zip，服务端构建二进制响应（不在页面展开全部内容）。纯函数库 src/lib/zip-store.ts（buildZip/crc32/normalizeZipPath，STORE 无压缩 + UTF-8 文件名标志位兼容 Windows 中文路径）。API GET /api/observe/session/dir-restore。 - Skill Content（SKILL.md 全文）：每个 skill 可点击展示/下载全文，优先取原生 Skill 工具注入的 resultJson（剥前导），回退 Read of */SKILL.md（剥行号），多次加载取最长版本。API GET /api/observe/session/skill-content。 三、Session Compare — turn 对齐 - banded-DP turn 对齐算法：两个 session 逐 turn 对齐，Web Worker 后台计算不阻塞 UI，ComparePanorama 全景对比 token/费用/耗时/工具调用/subagent。含正确性与性能基准（tests/compare-perf/：banded-dp-correctness、turn-align.bench、api-n+1-elimination、render-smoke）。新增 src/lib/compare/turn-align.ts/turn-align.worker.ts。 四、增量刷新 Auto-refresh 探测源 DB 变化后增量导入（auto-refresh-probe.ts），支持 SSE 流式进度推送，适配 Claude Code JSONL 与 opencode DB。新增 API /api/observe/auto-refresh、/api/observe/auto-refresh-stream，e2e fixture 覆盖 append-turn/idle-assistant/streaming 场景。 五、CLI 与配置 - CLI export-md：导出 session 为 Markdown（与 Web UI 导出/audit step 1 同源输出），供轨迹分析器消费。src/cli/commands/export-md.ts。 - AI Provider 配置：settings 页面 + AIProviderConfigPanel，为审计配置 OpenAI 兼容 provider（baseUrl/apiKey/model）。 - agent-md-scan / agent-version：扫描本地 agent .md、提取版本号。 六、Audit 审计（持续完善中） - Audit tab 拆两个子 tab：Workflow audit（v1-v4，preview）+ Skill audit（接入 skill-eval 对账「真实执行 vs SKILL.md」：五态 verdict、可过滤 findings、by-instruction 表、实时进度条流式百分比）。 - Session Trajectory Analyzer：自建轻量 agent，正则预处理 + 有界 LLM 循环（≤3 轮）分析 10 万+ 行轨迹 MD，无需 Claude Code；Python 版 smart-agent/ + TS 版双端对齐，HTTP 服务 + Next.js 代理路由，Audit tab 可切 v1(TS)/v2(Python)。 - Audit 结果 JSON 导入/导出（audit-export.ts）。 七、性能优化 - 导入流水线 create → createMany + $transaction，单 session 35-100x 加速（23.5s→1.6s），batch 分批（500 条/批）防 SQLite 变量溢出 - opencode-db 适配器 N+1 消除：listSessions ~200+ → 5-6 次批量查询；readSession N×3 → 3 次 - 大 session 事务超时 5s → 60s，解决 "Transaction already closed" 八、移除项 移除 替代 Workflow tab（WorkflowAIView.tsx/WorkflowTreeView.tsx） Performance tab + Audit tab prompts/workflow-analyse.md session-trajectory-analyse.md + trajectory-compress.md tests/start-script.test.ts tests/start-sh-validation.test.ts 九、测试覆盖 新增 45 个测试文件，覆盖上述能力：zip-store(11)、skill-content(20)、file-restore(26)、dir-restore-api、skill-eval-audit、audit-job/audit-export、turn-align/-hard/-stress/-manual、compare-perf/*、claude-autorefresh*、agent-md-scan、trajectory-analyzer、cannbay-archive、upload-session-api、start-sh-validation 等。 同步内容为 skills-dev main 已提交状态，未带入开发仓未提交改动；package-lock.json 按 .gitignore 约定不入库；版本号 VERSION = "1.48"。 关联的Issue <!-- 本次为版本同步发布，暂无对应 Issue。cannbot-insight 大版本跳跃建议在本 PR 评审期间于 Discussions 同步说明。 --> 测试 - cannbot-insight 单元/集成测试：cd plugins-community/cannbot-insight && npm install && npm test（vitest，新增 45 个测试文件） - 仓库级 CI 闸门：./tests/gate_check.sh、./tests/run-tests.sh --fast - 4 个抽样文件 hash 已校验与 skills-dev main blob 一致，确保未带入未提交改动 文档更新 - README.md：Features 列表新增 Performance / 循迹复卷 / 重编汇册 / SKILL.md 全文 / Skill audit 描述 - CHANGELOG.md：补齐 v1.37-v1.40 条目 - 新增设计文档：docs/architecture.md、docs/performance-tab-design.md、docs/audit-skill-subtab-design.md、docs/session-trajectory-analyzer-design.md - 新增 smart-agent/README.md See merge request: cann/cannbot-skills!731 | 17 天前 | |
feat(cannbot-insight): 同步 v1.51（v1.03 → v1.51） Co-authored-by: duanbingzhe<duanbingzhe@huawei.com> # message auto-generated for no-merge-commit merge: !731 merge fix/CleanCode into master feat(cannbot-insight): 同步 v1.51（v1.03 → v1.51） Created-by: duanbingzhe Commit-by: duanbingzhe Merged-by: cann-robot Description: ## 描述 cannbot-insight 功能更新，版本 v1.03 → v1.48。本次新增七大功能，新增 114 个文件、修改 48 个、移除 4 个（旧 Workflow/AI Workflow tab）。主线为 性能可观测（Performance 全景）、文件循迹重建、会话对齐，Audit 工作流审计作为 preview 先行合入承接后续迭代。 一、Performance 性能全景 全新的独立 Performance tab，一站式 session 级性能与成本可观测。所有数据直读 DB、零 LLM 依赖——确定性、可重复、即开即用，不受审计结果波动影响。 PerfPanorama 性能全景三大面板： 1. perf top — 子代理耗时排行（Linux top 风格） - 可排序表格（TURNS / TIME / TOKENS / AVG·T），活跃列箭头指示，列宽稳定不偏移 - 占比条形图：当前值占总量比例，条色随排序键切换（TIME 红 / TOKENS 蓝 / TURNS 灰），一眼锁定最耗资源的子代理 - 点击下钻：展开该子代理 turn 列表（§N + 耗时 + tokens + tools + model），默认 Top 10、一键展开全部 2. Token 成本分析 — 精准定位优化空间 - Cache 节省量卡片：命中缓存（绿）vs 未命中冷输入（红）的量与占比，直指 compaction 后重复输入的浪费 - 每轮 Cache 命中率趋势线（SVG 折线 + 面积渐变），compaction 事件自动标注（命中率骤降点），低命中轮次（<50%）标红 - 与 perf top 联动：下钻 turn 行增加 cache 命中率列，低命中高亮，形成「定位问题 turn → 跳转排查」闭环 3. Top 工具调用 — 耗时瓶颈定位 - 全 session 工具按 durationMs 降序 Top 10，水平条形图，标签 toolName §turnIndex - 点击直接跳转 turns tab 对应 turn 净耗时归因（关键能力）：主 Agent 耗时自动扣除并行子代理等待时间（max(bridge.subagentLatencyMs)），还原主 Agent 真实工作时间，避免被子代理壁钟时间虚高——这是判断「主 Agent 是真慢还是在等子代理」的核心依据。 7 张总览卡片：主 Agent 耗时(净) / 子代理耗时 / 总 Tokens / Cache 命中率 / 主 Agent turns / 子代理 sessions / 工具调用，响应式 grid（2/3/6 列）。 交互与性能：可折叠全景、懒挂载（切 tab 不卸载不 re-fetch）、onJumpToTurn 回调定位。设计文档 docs/performance-tab-design.md。 v1.48 同时完成 perf2→perf 整合，并移除旧 Workflow tab 与 AI Workflow tab（删除 WorkflowAIView.tsx/WorkflowTreeView.tsx/prompts/workflow-analyse.md），其能力由 Performance + Audit 承接。 二、文件循迹重建 - File Content Restore（循迹复卷）：每文件行一键按时间戳拼合本会话内 read/write 片段重建全文（后写入者覆盖先前），未被读取行标注 --line N not found --；兼容 claude（N\t）与 opencode（<content> 信封 + N: ）两种 Read 格式，支持下载/收起。API GET /api/observe/session/file-restore + 纯函数库 src/lib/file-restore.ts。 - Gather & Rebuild Directory（重编汇册）：一键按路径树重建本会话工作目录下全部被读/写文件并打包下载 zip，服务端构建二进制响应（不在页面展开全部内容）。纯函数库 src/lib/zip-store.ts（buildZip/crc32/normalizeZipPath，STORE 无压缩 + UTF-8 文件名标志位兼容 Windows 中文路径）。API GET /api/observe/session/dir-restore。 - Skill Content（SKILL.md 全文）：每个 skill 可点击展示/下载全文，优先取原生 Skill 工具注入的 resultJson（剥前导），回退 Read of */SKILL.md（剥行号），多次加载取最长版本。API GET /api/observe/session/skill-content。 三、Session Compare — turn 对齐 - banded-DP turn 对齐算法：两个 session 逐 turn 对齐，Web Worker 后台计算不阻塞 UI，ComparePanorama 全景对比 token/费用/耗时/工具调用/subagent。含正确性与性能基准（tests/compare-perf/：banded-dp-correctness、turn-align.bench、api-n+1-elimination、render-smoke）。新增 src/lib/compare/turn-align.ts/turn-align.worker.ts。 四、增量刷新 Auto-refresh 探测源 DB 变化后增量导入（auto-refresh-probe.ts），支持 SSE 流式进度推送，适配 Claude Code JSONL 与 opencode DB。新增 API /api/observe/auto-refresh、/api/observe/auto-refresh-stream，e2e fixture 覆盖 append-turn/idle-assistant/streaming 场景。 五、CLI 与配置 - CLI export-md：导出 session 为 Markdown（与 Web UI 导出/audit step 1 同源输出），供轨迹分析器消费。src/cli/commands/export-md.ts。 - AI Provider 配置：settings 页面 + AIProviderConfigPanel，为审计配置 OpenAI 兼容 provider（baseUrl/apiKey/model）。 - agent-md-scan / agent-version：扫描本地 agent .md、提取版本号。 六、Audit 审计（持续完善中） - Audit tab 拆两个子 tab：Workflow audit（v1-v4，preview）+ Skill audit（接入 skill-eval 对账「真实执行 vs SKILL.md」：五态 verdict、可过滤 findings、by-instruction 表、实时进度条流式百分比）。 - Session Trajectory Analyzer：自建轻量 agent，正则预处理 + 有界 LLM 循环（≤3 轮）分析 10 万+ 行轨迹 MD，无需 Claude Code；Python 版 smart-agent/ + TS 版双端对齐，HTTP 服务 + Next.js 代理路由，Audit tab 可切 v1(TS)/v2(Python)。 - Audit 结果 JSON 导入/导出（audit-export.ts）。 七、性能优化 - 导入流水线 create → createMany + $transaction，单 session 35-100x 加速（23.5s→1.6s），batch 分批（500 条/批）防 SQLite 变量溢出 - opencode-db 适配器 N+1 消除：listSessions ~200+ → 5-6 次批量查询；readSession N×3 → 3 次 - 大 session 事务超时 5s → 60s，解决 "Transaction already closed" 八、移除项 移除 替代 Workflow tab（WorkflowAIView.tsx/WorkflowTreeView.tsx） Performance tab + Audit tab prompts/workflow-analyse.md session-trajectory-analyse.md + trajectory-compress.md tests/start-script.test.ts tests/start-sh-validation.test.ts 九、测试覆盖 新增 45 个测试文件，覆盖上述能力：zip-store(11)、skill-content(20)、file-restore(26)、dir-restore-api、skill-eval-audit、audit-job/audit-export、turn-align/-hard/-stress/-manual、compare-perf/*、claude-autorefresh*、agent-md-scan、trajectory-analyzer、cannbay-archive、upload-session-api、start-sh-validation 等。 同步内容为 skills-dev main 已提交状态，未带入开发仓未提交改动；package-lock.json 按 .gitignore 约定不入库；版本号 VERSION = "1.48"。 关联的Issue <!-- 本次为版本同步发布，暂无对应 Issue。cannbot-insight 大版本跳跃建议在本 PR 评审期间于 Discussions 同步说明。 --> 测试 - cannbot-insight 单元/集成测试：cd plugins-community/cannbot-insight && npm install && npm test（vitest，新增 45 个测试文件） - 仓库级 CI 闸门：./tests/gate_check.sh、./tests/run-tests.sh --fast - 4 个抽样文件 hash 已校验与 skills-dev main blob 一致，确保未带入未提交改动 文档更新 - README.md：Features 列表新增 Performance / 循迹复卷 / 重编汇册 / SKILL.md 全文 / Skill audit 描述 - CHANGELOG.md：补齐 v1.37-v1.40 条目 - 新增设计文档：docs/architecture.md、docs/performance-tab-design.md、docs/audit-skill-subtab-design.md、docs/session-trajectory-analyzer-design.md - 新增 smart-agent/README.md See merge request: cann/cannbot-skills!731 | 17 天前 | |
feat(cannbot-insight): 同步 v1.51（v1.03 → v1.51） Co-authored-by: duanbingzhe<duanbingzhe@huawei.com> # message auto-generated for no-merge-commit merge: !731 merge fix/CleanCode into master feat(cannbot-insight): 同步 v1.51（v1.03 → v1.51） Created-by: duanbingzhe Commit-by: duanbingzhe Merged-by: cann-robot Description: ## 描述 cannbot-insight 功能更新，版本 v1.03 → v1.48。本次新增七大功能，新增 114 个文件、修改 48 个、移除 4 个（旧 Workflow/AI Workflow tab）。主线为 性能可观测（Performance 全景）、文件循迹重建、会话对齐，Audit 工作流审计作为 preview 先行合入承接后续迭代。 一、Performance 性能全景 全新的独立 Performance tab，一站式 session 级性能与成本可观测。所有数据直读 DB、零 LLM 依赖——确定性、可重复、即开即用，不受审计结果波动影响。 PerfPanorama 性能全景三大面板： 1. perf top — 子代理耗时排行（Linux top 风格） - 可排序表格（TURNS / TIME / TOKENS / AVG·T），活跃列箭头指示，列宽稳定不偏移 - 占比条形图：当前值占总量比例，条色随排序键切换（TIME 红 / TOKENS 蓝 / TURNS 灰），一眼锁定最耗资源的子代理 - 点击下钻：展开该子代理 turn 列表（§N + 耗时 + tokens + tools + model），默认 Top 10、一键展开全部 2. Token 成本分析 — 精准定位优化空间 - Cache 节省量卡片：命中缓存（绿）vs 未命中冷输入（红）的量与占比，直指 compaction 后重复输入的浪费 - 每轮 Cache 命中率趋势线（SVG 折线 + 面积渐变），compaction 事件自动标注（命中率骤降点），低命中轮次（<50%）标红 - 与 perf top 联动：下钻 turn 行增加 cache 命中率列，低命中高亮，形成「定位问题 turn → 跳转排查」闭环 3. Top 工具调用 — 耗时瓶颈定位 - 全 session 工具按 durationMs 降序 Top 10，水平条形图，标签 toolName §turnIndex - 点击直接跳转 turns tab 对应 turn 净耗时归因（关键能力）：主 Agent 耗时自动扣除并行子代理等待时间（max(bridge.subagentLatencyMs)），还原主 Agent 真实工作时间，避免被子代理壁钟时间虚高——这是判断「主 Agent 是真慢还是在等子代理」的核心依据。 7 张总览卡片：主 Agent 耗时(净) / 子代理耗时 / 总 Tokens / Cache 命中率 / 主 Agent turns / 子代理 sessions / 工具调用，响应式 grid（2/3/6 列）。 交互与性能：可折叠全景、懒挂载（切 tab 不卸载不 re-fetch）、onJumpToTurn 回调定位。设计文档 docs/performance-tab-design.md。 v1.48 同时完成 perf2→perf 整合，并移除旧 Workflow tab 与 AI Workflow tab（删除 WorkflowAIView.tsx/WorkflowTreeView.tsx/prompts/workflow-analyse.md），其能力由 Performance + Audit 承接。 二、文件循迹重建 - File Content Restore（循迹复卷）：每文件行一键按时间戳拼合本会话内 read/write 片段重建全文（后写入者覆盖先前），未被读取行标注 --line N not found --；兼容 claude（N\t）与 opencode（<content> 信封 + N: ）两种 Read 格式，支持下载/收起。API GET /api/observe/session/file-restore + 纯函数库 src/lib/file-restore.ts。 - Gather & Rebuild Directory（重编汇册）：一键按路径树重建本会话工作目录下全部被读/写文件并打包下载 zip，服务端构建二进制响应（不在页面展开全部内容）。纯函数库 src/lib/zip-store.ts（buildZip/crc32/normalizeZipPath，STORE 无压缩 + UTF-8 文件名标志位兼容 Windows 中文路径）。API GET /api/observe/session/dir-restore。 - Skill Content（SKILL.md 全文）：每个 skill 可点击展示/下载全文，优先取原生 Skill 工具注入的 resultJson（剥前导），回退 Read of */SKILL.md（剥行号），多次加载取最长版本。API GET /api/observe/session/skill-content。 三、Session Compare — turn 对齐 - banded-DP turn 对齐算法：两个 session 逐 turn 对齐，Web Worker 后台计算不阻塞 UI，ComparePanorama 全景对比 token/费用/耗时/工具调用/subagent。含正确性与性能基准（tests/compare-perf/：banded-dp-correctness、turn-align.bench、api-n+1-elimination、render-smoke）。新增 src/lib/compare/turn-align.ts/turn-align.worker.ts。 四、增量刷新 Auto-refresh 探测源 DB 变化后增量导入（auto-refresh-probe.ts），支持 SSE 流式进度推送，适配 Claude Code JSONL 与 opencode DB。新增 API /api/observe/auto-refresh、/api/observe/auto-refresh-stream，e2e fixture 覆盖 append-turn/idle-assistant/streaming 场景。 五、CLI 与配置 - CLI export-md：导出 session 为 Markdown（与 Web UI 导出/audit step 1 同源输出），供轨迹分析器消费。src/cli/commands/export-md.ts。 - AI Provider 配置：settings 页面 + AIProviderConfigPanel，为审计配置 OpenAI 兼容 provider（baseUrl/apiKey/model）。 - agent-md-scan / agent-version：扫描本地 agent .md、提取版本号。 六、Audit 审计（持续完善中） - Audit tab 拆两个子 tab：Workflow audit（v1-v4，preview）+ Skill audit（接入 skill-eval 对账「真实执行 vs SKILL.md」：五态 verdict、可过滤 findings、by-instruction 表、实时进度条流式百分比）。 - Session Trajectory Analyzer：自建轻量 agent，正则预处理 + 有界 LLM 循环（≤3 轮）分析 10 万+ 行轨迹 MD，无需 Claude Code；Python 版 smart-agent/ + TS 版双端对齐，HTTP 服务 + Next.js 代理路由，Audit tab 可切 v1(TS)/v2(Python)。 - Audit 结果 JSON 导入/导出（audit-export.ts）。 七、性能优化 - 导入流水线 create → createMany + $transaction，单 session 35-100x 加速（23.5s→1.6s），batch 分批（500 条/批）防 SQLite 变量溢出 - opencode-db 适配器 N+1 消除：listSessions ~200+ → 5-6 次批量查询；readSession N×3 → 3 次 - 大 session 事务超时 5s → 60s，解决 "Transaction already closed" 八、移除项 移除 替代 Workflow tab（WorkflowAIView.tsx/WorkflowTreeView.tsx） Performance tab + Audit tab prompts/workflow-analyse.md session-trajectory-analyse.md + trajectory-compress.md tests/start-script.test.ts tests/start-sh-validation.test.ts 九、测试覆盖 新增 45 个测试文件，覆盖上述能力：zip-store(11)、skill-content(20)、file-restore(26)、dir-restore-api、skill-eval-audit、audit-job/audit-export、turn-align/-hard/-stress/-manual、compare-perf/*、claude-autorefresh*、agent-md-scan、trajectory-analyzer、cannbay-archive、upload-session-api、start-sh-validation 等。 同步内容为 skills-dev main 已提交状态，未带入开发仓未提交改动；package-lock.json 按 .gitignore 约定不入库；版本号 VERSION = "1.48"。 关联的Issue <!-- 本次为版本同步发布，暂无对应 Issue。cannbot-insight 大版本跳跃建议在本 PR 评审期间于 Discussions 同步说明。 --> 测试 - cannbot-insight 单元/集成测试：cd plugins-community/cannbot-insight && npm install && npm test（vitest，新增 45 个测试文件） - 仓库级 CI 闸门：./tests/gate_check.sh、./tests/run-tests.sh --fast - 4 个抽样文件 hash 已校验与 skills-dev main blob 一致，确保未带入未提交改动 文档更新 - README.md：Features 列表新增 Performance / 循迹复卷 / 重编汇册 / SKILL.md 全文 / Skill audit 描述 - CHANGELOG.md：补齐 v1.37-v1.40 条目 - 新增设计文档：docs/architecture.md、docs/performance-tab-design.md、docs/audit-skill-subtab-design.md、docs/session-trajectory-analyzer-design.md - 新增 smart-agent/README.md See merge request: cann/cannbot-skills!731 | 17 天前 | |
feat(cannbot-insight): 同步 v1.51（v1.03 → v1.51） Co-authored-by: duanbingzhe<duanbingzhe@huawei.com> # message auto-generated for no-merge-commit merge: !731 merge fix/CleanCode into master feat(cannbot-insight): 同步 v1.51（v1.03 → v1.51） Created-by: duanbingzhe Commit-by: duanbingzhe Merged-by: cann-robot Description: ## 描述 cannbot-insight 功能更新，版本 v1.03 → v1.48。本次新增七大功能，新增 114 个文件、修改 48 个、移除 4 个（旧 Workflow/AI Workflow tab）。主线为 性能可观测（Performance 全景）、文件循迹重建、会话对齐，Audit 工作流审计作为 preview 先行合入承接后续迭代。 一、Performance 性能全景 全新的独立 Performance tab，一站式 session 级性能与成本可观测。所有数据直读 DB、零 LLM 依赖——确定性、可重复、即开即用，不受审计结果波动影响。 PerfPanorama 性能全景三大面板： 1. perf top — 子代理耗时排行（Linux top 风格） - 可排序表格（TURNS / TIME / TOKENS / AVG·T），活跃列箭头指示，列宽稳定不偏移 - 占比条形图：当前值占总量比例，条色随排序键切换（TIME 红 / TOKENS 蓝 / TURNS 灰），一眼锁定最耗资源的子代理 - 点击下钻：展开该子代理 turn 列表（§N + 耗时 + tokens + tools + model），默认 Top 10、一键展开全部 2. Token 成本分析 — 精准定位优化空间 - Cache 节省量卡片：命中缓存（绿）vs 未命中冷输入（红）的量与占比，直指 compaction 后重复输入的浪费 - 每轮 Cache 命中率趋势线（SVG 折线 + 面积渐变），compaction 事件自动标注（命中率骤降点），低命中轮次（<50%）标红 - 与 perf top 联动：下钻 turn 行增加 cache 命中率列，低命中高亮，形成「定位问题 turn → 跳转排查」闭环 3. Top 工具调用 — 耗时瓶颈定位 - 全 session 工具按 durationMs 降序 Top 10，水平条形图，标签 toolName §turnIndex - 点击直接跳转 turns tab 对应 turn 净耗时归因（关键能力）：主 Agent 耗时自动扣除并行子代理等待时间（max(bridge.subagentLatencyMs)），还原主 Agent 真实工作时间，避免被子代理壁钟时间虚高——这是判断「主 Agent 是真慢还是在等子代理」的核心依据。 7 张总览卡片：主 Agent 耗时(净) / 子代理耗时 / 总 Tokens / Cache 命中率 / 主 Agent turns / 子代理 sessions / 工具调用，响应式 grid（2/3/6 列）。 交互与性能：可折叠全景、懒挂载（切 tab 不卸载不 re-fetch）、onJumpToTurn 回调定位。设计文档 docs/performance-tab-design.md。 v1.48 同时完成 perf2→perf 整合，并移除旧 Workflow tab 与 AI Workflow tab（删除 WorkflowAIView.tsx/WorkflowTreeView.tsx/prompts/workflow-analyse.md），其能力由 Performance + Audit 承接。 二、文件循迹重建 - File Content Restore（循迹复卷）：每文件行一键按时间戳拼合本会话内 read/write 片段重建全文（后写入者覆盖先前），未被读取行标注 --line N not found --；兼容 claude（N\t）与 opencode（<content> 信封 + N: ）两种 Read 格式，支持下载/收起。API GET /api/observe/session/file-restore + 纯函数库 src/lib/file-restore.ts。 - Gather & Rebuild Directory（重编汇册）：一键按路径树重建本会话工作目录下全部被读/写文件并打包下载 zip，服务端构建二进制响应（不在页面展开全部内容）。纯函数库 src/lib/zip-store.ts（buildZip/crc32/normalizeZipPath，STORE 无压缩 + UTF-8 文件名标志位兼容 Windows 中文路径）。API GET /api/observe/session/dir-restore。 - Skill Content（SKILL.md 全文）：每个 skill 可点击展示/下载全文，优先取原生 Skill 工具注入的 resultJson（剥前导），回退 Read of */SKILL.md（剥行号），多次加载取最长版本。API GET /api/observe/session/skill-content。 三、Session Compare — turn 对齐 - banded-DP turn 对齐算法：两个 session 逐 turn 对齐，Web Worker 后台计算不阻塞 UI，ComparePanorama 全景对比 token/费用/耗时/工具调用/subagent。含正确性与性能基准（tests/compare-perf/：banded-dp-correctness、turn-align.bench、api-n+1-elimination、render-smoke）。新增 src/lib/compare/turn-align.ts/turn-align.worker.ts。 四、增量刷新 Auto-refresh 探测源 DB 变化后增量导入（auto-refresh-probe.ts），支持 SSE 流式进度推送，适配 Claude Code JSONL 与 opencode DB。新增 API /api/observe/auto-refresh、/api/observe/auto-refresh-stream，e2e fixture 覆盖 append-turn/idle-assistant/streaming 场景。 五、CLI 与配置 - CLI export-md：导出 session 为 Markdown（与 Web UI 导出/audit step 1 同源输出），供轨迹分析器消费。src/cli/commands/export-md.ts。 - AI Provider 配置：settings 页面 + AIProviderConfigPanel，为审计配置 OpenAI 兼容 provider（baseUrl/apiKey/model）。 - agent-md-scan / agent-version：扫描本地 agent .md、提取版本号。 六、Audit 审计（持续完善中） - Audit tab 拆两个子 tab：Workflow audit（v1-v4，preview）+ Skill audit（接入 skill-eval 对账「真实执行 vs SKILL.md」：五态 verdict、可过滤 findings、by-instruction 表、实时进度条流式百分比）。 - Session Trajectory Analyzer：自建轻量 agent，正则预处理 + 有界 LLM 循环（≤3 轮）分析 10 万+ 行轨迹 MD，无需 Claude Code；Python 版 smart-agent/ + TS 版双端对齐，HTTP 服务 + Next.js 代理路由，Audit tab 可切 v1(TS)/v2(Python)。 - Audit 结果 JSON 导入/导出（audit-export.ts）。 七、性能优化 - 导入流水线 create → createMany + $transaction，单 session 35-100x 加速（23.5s→1.6s），batch 分批（500 条/批）防 SQLite 变量溢出 - opencode-db 适配器 N+1 消除：listSessions ~200+ → 5-6 次批量查询；readSession N×3 → 3 次 - 大 session 事务超时 5s → 60s，解决 "Transaction already closed" 八、移除项 移除 替代 Workflow tab（WorkflowAIView.tsx/WorkflowTreeView.tsx） Performance tab + Audit tab prompts/workflow-analyse.md session-trajectory-analyse.md + trajectory-compress.md tests/start-script.test.ts tests/start-sh-validation.test.ts 九、测试覆盖 新增 45 个测试文件，覆盖上述能力：zip-store(11)、skill-content(20)、file-restore(26)、dir-restore-api、skill-eval-audit、audit-job/audit-export、turn-align/-hard/-stress/-manual、compare-perf/*、claude-autorefresh*、agent-md-scan、trajectory-analyzer、cannbay-archive、upload-session-api、start-sh-validation 等。 同步内容为 skills-dev main 已提交状态，未带入开发仓未提交改动；package-lock.json 按 .gitignore 约定不入库；版本号 VERSION = "1.48"。 关联的Issue <!-- 本次为版本同步发布，暂无对应 Issue。cannbot-insight 大版本跳跃建议在本 PR 评审期间于 Discussions 同步说明。 --> 测试 - cannbot-insight 单元/集成测试：cd plugins-community/cannbot-insight && npm install && npm test（vitest，新增 45 个测试文件） - 仓库级 CI 闸门：./tests/gate_check.sh、./tests/run-tests.sh --fast - 4 个抽样文件 hash 已校验与 skills-dev main blob 一致，确保未带入未提交改动 文档更新 - README.md：Features 列表新增 Performance / 循迹复卷 / 重编汇册 / SKILL.md 全文 / Skill audit 描述 - CHANGELOG.md：补齐 v1.37-v1.40 条目 - 新增设计文档：docs/architecture.md、docs/performance-tab-design.md、docs/audit-skill-subtab-design.md、docs/session-trajectory-analyzer-design.md - 新增 smart-agent/README.md See merge request: cann/cannbot-skills!731 | 17 天前 | |
feat(cannbot-insight): v1.51→v1.67——root 编排对账重构、Skill 加载校验、Audit 阶段诊断增强 Co-authored-by: duanbingzhe<duanbingzhe@huawei.com> # message auto-generated for no-merge-commit merge: !808 merge feature/update-cannbot-insight into master feat(cannbot-insight): v1.51→v1.67——root 编排对账重构、Skill 加载校验、Audit 阶段诊断增强 Created-by: duanbingzhe Commit-by: duanbingzhe Merged-by: cann-robot Description: ## 描述 版本 v1.51 → v1.67。合并多轮功能迭代，71 个文件变更（57 修改 + 14 新增，+4903 / -624）。核心聚焦三类审计/校验能力，其余为配套增强。 ## root 对账编排声明提取重构 - 新增 recoverWorkflowDeclaration 及辅助 resolveWorkflowSkillName / recoverSkillResourceFile - 优先级：skill resources 文件（task-prompts.md）> SKILL.md body > turn0 注入(≥500字) > null - 不再用 STATE.md / todowrite（属"任务完成度"，非"编排规程遵循度"） - 新增设计文档 docs/workflow-plan-extraction-design.md ## Skill 加载校验（新功能） - 新增 SkillContentAudit 组件 + use-skill-content-audit hook + skill-content-audit API - 校验每个 skill 是否在会话内读取完整 SKILL.md：Skill 工具注入即全文；Read 需无 offset/limit 且无截断标记才判全文，否则部分读取 - chip 三态（全文 / 部分 / 未读），点击 chip 在表格展开该 skill 行 ## Audit 增强 - v4 agent 树默认隐藏全部通过的子 agent（勾选开关才显示） - 跨 agent 问题与优化优先级每项给证据（agent:<name> #turn，可点击跳转）；审计头部展示本次消耗 token 数 - 新增 StageBreakdownTable + StageBreakdownRow 类型：6 阶段（extract/refine/headline/rebuild/judge/postprocess）墙钟+token 诊断，区分 LLM vs 程序阶段 - finding / aggregate 增加 source_excerpt（bullet 原文）、headline（人话标题）、turn_refs（证据 turn 序号，可点击跳转） ## Skills tab 增强 - 恢复展示 dispatch 的 subagent 行（此前被误删） - 新增 agent-content API：从磁盘扫 agent .md（AGENTS_SCAN_ROOT），多插件按 session dispatch 覆盖率消歧 ## smart-agent 增强 - trajectory_analyzer 新增 AdaptiveLimiter（自适应并发：激进出高限、撞限流乘性回退、窗口清了爬回）与 _is_rate_or_timeout 判别 - 重构 _audit_one_agent / _aggregate_session；subagent 桥接写入复刻 Claude Code subagent 存储结构 - jsonl_logger 支持 append 模式；server.py analyze_logger 改 append=False ## 零依赖导出 Session DB - 新增 export-db.mjs：从 opencode.db 或 Claude Code JSONL 提取单个 session（含子会话）为独立文件 - 零依赖：仅需 Node.js >= 22（内置 node:sqlite），无需 npm install / Prisma / 后端 - 自动识别框架，支持 --list / -s / -o / --json；README 新增"方式三" ## CLI upload 增强 - 支持 --session-id（非交互指定）、--list、--yes / --json、--description - README 重写上传文档（opencode / Claude Code 分开示例 + 参数表）；路径修正 sessions.db → opencode.db ## Turns 与概念追踪交互 - Turn 快速跳转：输入 turn 编号（如 #459）回车直达；subagent turn 自动展开祖先 dispatch lane - 概念追踪高亮跳转：搜索结果点击 View Turn 跳转 Turns tab，自动展开并高亮关键词至匹配位置 - 新增纯函数 src/lib/shared/highlight.tsx（highlightKeyword，大小写不敏感，<mark> 包裹） ## 测试与文档 - 新增 cannbot-insight adapter、opencode-db adapter、delete-session API、skill-content-audit API、trace-turn-highlight、turn-timeline-jump 等集成测试；skill-eval-audit 测试 +615 行 - README / README-zh 功能列表与 tab 描述同步；AGENTS.md 补充相关说明 See merge request: cann/cannbot-skills!808 | 8 天前 | |
feat(cannbot-insight): 同步 v1.51（v1.03 → v1.51） Co-authored-by: duanbingzhe<duanbingzhe@huawei.com> # message auto-generated for no-merge-commit merge: !731 merge fix/CleanCode into master feat(cannbot-insight): 同步 v1.51（v1.03 → v1.51） Created-by: duanbingzhe Commit-by: duanbingzhe Merged-by: cann-robot Description: ## 描述 cannbot-insight 功能更新，版本 v1.03 → v1.48。本次新增七大功能，新增 114 个文件、修改 48 个、移除 4 个（旧 Workflow/AI Workflow tab）。主线为 性能可观测（Performance 全景）、文件循迹重建、会话对齐，Audit 工作流审计作为 preview 先行合入承接后续迭代。 一、Performance 性能全景 全新的独立 Performance tab，一站式 session 级性能与成本可观测。所有数据直读 DB、零 LLM 依赖——确定性、可重复、即开即用，不受审计结果波动影响。 PerfPanorama 性能全景三大面板： 1. perf top — 子代理耗时排行（Linux top 风格） - 可排序表格（TURNS / TIME / TOKENS / AVG·T），活跃列箭头指示，列宽稳定不偏移 - 占比条形图：当前值占总量比例，条色随排序键切换（TIME 红 / TOKENS 蓝 / TURNS 灰），一眼锁定最耗资源的子代理 - 点击下钻：展开该子代理 turn 列表（§N + 耗时 + tokens + tools + model），默认 Top 10、一键展开全部 2. Token 成本分析 — 精准定位优化空间 - Cache 节省量卡片：命中缓存（绿）vs 未命中冷输入（红）的量与占比，直指 compaction 后重复输入的浪费 - 每轮 Cache 命中率趋势线（SVG 折线 + 面积渐变），compaction 事件自动标注（命中率骤降点），低命中轮次（<50%）标红 - 与 perf top 联动：下钻 turn 行增加 cache 命中率列，低命中高亮，形成「定位问题 turn → 跳转排查」闭环 3. Top 工具调用 — 耗时瓶颈定位 - 全 session 工具按 durationMs 降序 Top 10，水平条形图，标签 toolName §turnIndex - 点击直接跳转 turns tab 对应 turn 净耗时归因（关键能力）：主 Agent 耗时自动扣除并行子代理等待时间（max(bridge.subagentLatencyMs)），还原主 Agent 真实工作时间，避免被子代理壁钟时间虚高——这是判断「主 Agent 是真慢还是在等子代理」的核心依据。 7 张总览卡片：主 Agent 耗时(净) / 子代理耗时 / 总 Tokens / Cache 命中率 / 主 Agent turns / 子代理 sessions / 工具调用，响应式 grid（2/3/6 列）。 交互与性能：可折叠全景、懒挂载（切 tab 不卸载不 re-fetch）、onJumpToTurn 回调定位。设计文档 docs/performance-tab-design.md。 v1.48 同时完成 perf2→perf 整合，并移除旧 Workflow tab 与 AI Workflow tab（删除 WorkflowAIView.tsx/WorkflowTreeView.tsx/prompts/workflow-analyse.md），其能力由 Performance + Audit 承接。 二、文件循迹重建 - File Content Restore（循迹复卷）：每文件行一键按时间戳拼合本会话内 read/write 片段重建全文（后写入者覆盖先前），未被读取行标注 --line N not found --；兼容 claude（N\t）与 opencode（<content> 信封 + N: ）两种 Read 格式，支持下载/收起。API GET /api/observe/session/file-restore + 纯函数库 src/lib/file-restore.ts。 - Gather & Rebuild Directory（重编汇册）：一键按路径树重建本会话工作目录下全部被读/写文件并打包下载 zip，服务端构建二进制响应（不在页面展开全部内容）。纯函数库 src/lib/zip-store.ts（buildZip/crc32/normalizeZipPath，STORE 无压缩 + UTF-8 文件名标志位兼容 Windows 中文路径）。API GET /api/observe/session/dir-restore。 - Skill Content（SKILL.md 全文）：每个 skill 可点击展示/下载全文，优先取原生 Skill 工具注入的 resultJson（剥前导），回退 Read of */SKILL.md（剥行号），多次加载取最长版本。API GET /api/observe/session/skill-content。 三、Session Compare — turn 对齐 - banded-DP turn 对齐算法：两个 session 逐 turn 对齐，Web Worker 后台计算不阻塞 UI，ComparePanorama 全景对比 token/费用/耗时/工具调用/subagent。含正确性与性能基准（tests/compare-perf/：banded-dp-correctness、turn-align.bench、api-n+1-elimination、render-smoke）。新增 src/lib/compare/turn-align.ts/turn-align.worker.ts。 四、增量刷新 Auto-refresh 探测源 DB 变化后增量导入（auto-refresh-probe.ts），支持 SSE 流式进度推送，适配 Claude Code JSONL 与 opencode DB。新增 API /api/observe/auto-refresh、/api/observe/auto-refresh-stream，e2e fixture 覆盖 append-turn/idle-assistant/streaming 场景。 五、CLI 与配置 - CLI export-md：导出 session 为 Markdown（与 Web UI 导出/audit step 1 同源输出），供轨迹分析器消费。src/cli/commands/export-md.ts。 - AI Provider 配置：settings 页面 + AIProviderConfigPanel，为审计配置 OpenAI 兼容 provider（baseUrl/apiKey/model）。 - agent-md-scan / agent-version：扫描本地 agent .md、提取版本号。 六、Audit 审计（持续完善中） - Audit tab 拆两个子 tab：Workflow audit（v1-v4，preview）+ Skill audit（接入 skill-eval 对账「真实执行 vs SKILL.md」：五态 verdict、可过滤 findings、by-instruction 表、实时进度条流式百分比）。 - Session Trajectory Analyzer：自建轻量 agent，正则预处理 + 有界 LLM 循环（≤3 轮）分析 10 万+ 行轨迹 MD，无需 Claude Code；Python 版 smart-agent/ + TS 版双端对齐，HTTP 服务 + Next.js 代理路由，Audit tab 可切 v1(TS)/v2(Python)。 - Audit 结果 JSON 导入/导出（audit-export.ts）。 七、性能优化 - 导入流水线 create → createMany + $transaction，单 session 35-100x 加速（23.5s→1.6s），batch 分批（500 条/批）防 SQLite 变量溢出 - opencode-db 适配器 N+1 消除：listSessions ~200+ → 5-6 次批量查询；readSession N×3 → 3 次 - 大 session 事务超时 5s → 60s，解决 "Transaction already closed" 八、移除项 移除 替代 Workflow tab（WorkflowAIView.tsx/WorkflowTreeView.tsx） Performance tab + Audit tab prompts/workflow-analyse.md session-trajectory-analyse.md + trajectory-compress.md tests/start-script.test.ts tests/start-sh-validation.test.ts 九、测试覆盖 新增 45 个测试文件，覆盖上述能力：zip-store(11)、skill-content(20)、file-restore(26)、dir-restore-api、skill-eval-audit、audit-job/audit-export、turn-align/-hard/-stress/-manual、compare-perf/*、claude-autorefresh*、agent-md-scan、trajectory-analyzer、cannbay-archive、upload-session-api、start-sh-validation 等。 同步内容为 skills-dev main 已提交状态，未带入开发仓未提交改动；package-lock.json 按 .gitignore 约定不入库；版本号 VERSION = "1.48"。 关联的Issue <!-- 本次为版本同步发布，暂无对应 Issue。cannbot-insight 大版本跳跃建议在本 PR 评审期间于 Discussions 同步说明。 --> 测试 - cannbot-insight 单元/集成测试：cd plugins-community/cannbot-insight && npm install && npm test（vitest，新增 45 个测试文件） - 仓库级 CI 闸门：./tests/gate_check.sh、./tests/run-tests.sh --fast - 4 个抽样文件 hash 已校验与 skills-dev main blob 一致，确保未带入未提交改动 文档更新 - README.md：Features 列表新增 Performance / 循迹复卷 / 重编汇册 / SKILL.md 全文 / Skill audit 描述 - CHANGELOG.md：补齐 v1.37-v1.40 条目 - 新增设计文档：docs/architecture.md、docs/performance-tab-design.md、docs/audit-skill-subtab-design.md、docs/session-trajectory-analyzer-design.md - 新增 smart-agent/README.md See merge request: cann/cannbot-skills!731 | 17 天前 | |
feat(cannbot-insight): 同步 v1.51（v1.03 → v1.51） Co-authored-by: duanbingzhe<duanbingzhe@huawei.com> # message auto-generated for no-merge-commit merge: !731 merge fix/CleanCode into master feat(cannbot-insight): 同步 v1.51（v1.03 → v1.51） Created-by: duanbingzhe Commit-by: duanbingzhe Merged-by: cann-robot Description: ## 描述 cannbot-insight 功能更新，版本 v1.03 → v1.48。本次新增七大功能，新增 114 个文件、修改 48 个、移除 4 个（旧 Workflow/AI Workflow tab）。主线为 性能可观测（Performance 全景）、文件循迹重建、会话对齐，Audit 工作流审计作为 preview 先行合入承接后续迭代。 一、Performance 性能全景 全新的独立 Performance tab，一站式 session 级性能与成本可观测。所有数据直读 DB、零 LLM 依赖——确定性、可重复、即开即用，不受审计结果波动影响。 PerfPanorama 性能全景三大面板： 1. perf top — 子代理耗时排行（Linux top 风格） - 可排序表格（TURNS / TIME / TOKENS / AVG·T），活跃列箭头指示，列宽稳定不偏移 - 占比条形图：当前值占总量比例，条色随排序键切换（TIME 红 / TOKENS 蓝 / TURNS 灰），一眼锁定最耗资源的子代理 - 点击下钻：展开该子代理 turn 列表（§N + 耗时 + tokens + tools + model），默认 Top 10、一键展开全部 2. Token 成本分析 — 精准定位优化空间 - Cache 节省量卡片：命中缓存（绿）vs 未命中冷输入（红）的量与占比，直指 compaction 后重复输入的浪费 - 每轮 Cache 命中率趋势线（SVG 折线 + 面积渐变），compaction 事件自动标注（命中率骤降点），低命中轮次（<50%）标红 - 与 perf top 联动：下钻 turn 行增加 cache 命中率列，低命中高亮，形成「定位问题 turn → 跳转排查」闭环 3. Top 工具调用 — 耗时瓶颈定位 - 全 session 工具按 durationMs 降序 Top 10，水平条形图，标签 toolName §turnIndex - 点击直接跳转 turns tab 对应 turn 净耗时归因（关键能力）：主 Agent 耗时自动扣除并行子代理等待时间（max(bridge.subagentLatencyMs)），还原主 Agent 真实工作时间，避免被子代理壁钟时间虚高——这是判断「主 Agent 是真慢还是在等子代理」的核心依据。 7 张总览卡片：主 Agent 耗时(净) / 子代理耗时 / 总 Tokens / Cache 命中率 / 主 Agent turns / 子代理 sessions / 工具调用，响应式 grid（2/3/6 列）。 交互与性能：可折叠全景、懒挂载（切 tab 不卸载不 re-fetch）、onJumpToTurn 回调定位。设计文档 docs/performance-tab-design.md。 v1.48 同时完成 perf2→perf 整合，并移除旧 Workflow tab 与 AI Workflow tab（删除 WorkflowAIView.tsx/WorkflowTreeView.tsx/prompts/workflow-analyse.md），其能力由 Performance + Audit 承接。 二、文件循迹重建 - File Content Restore（循迹复卷）：每文件行一键按时间戳拼合本会话内 read/write 片段重建全文（后写入者覆盖先前），未被读取行标注 --line N not found --；兼容 claude（N\t）与 opencode（<content> 信封 + N: ）两种 Read 格式，支持下载/收起。API GET /api/observe/session/file-restore + 纯函数库 src/lib/file-restore.ts。 - Gather & Rebuild Directory（重编汇册）：一键按路径树重建本会话工作目录下全部被读/写文件并打包下载 zip，服务端构建二进制响应（不在页面展开全部内容）。纯函数库 src/lib/zip-store.ts（buildZip/crc32/normalizeZipPath，STORE 无压缩 + UTF-8 文件名标志位兼容 Windows 中文路径）。API GET /api/observe/session/dir-restore。 - Skill Content（SKILL.md 全文）：每个 skill 可点击展示/下载全文，优先取原生 Skill 工具注入的 resultJson（剥前导），回退 Read of */SKILL.md（剥行号），多次加载取最长版本。API GET /api/observe/session/skill-content。 三、Session Compare — turn 对齐 - banded-DP turn 对齐算法：两个 session 逐 turn 对齐，Web Worker 后台计算不阻塞 UI，ComparePanorama 全景对比 token/费用/耗时/工具调用/subagent。含正确性与性能基准（tests/compare-perf/：banded-dp-correctness、turn-align.bench、api-n+1-elimination、render-smoke）。新增 src/lib/compare/turn-align.ts/turn-align.worker.ts。 四、增量刷新 Auto-refresh 探测源 DB 变化后增量导入（auto-refresh-probe.ts），支持 SSE 流式进度推送，适配 Claude Code JSONL 与 opencode DB。新增 API /api/observe/auto-refresh、/api/observe/auto-refresh-stream，e2e fixture 覆盖 append-turn/idle-assistant/streaming 场景。 五、CLI 与配置 - CLI export-md：导出 session 为 Markdown（与 Web UI 导出/audit step 1 同源输出），供轨迹分析器消费。src/cli/commands/export-md.ts。 - AI Provider 配置：settings 页面 + AIProviderConfigPanel，为审计配置 OpenAI 兼容 provider（baseUrl/apiKey/model）。 - agent-md-scan / agent-version：扫描本地 agent .md、提取版本号。 六、Audit 审计（持续完善中） - Audit tab 拆两个子 tab：Workflow audit（v1-v4，preview）+ Skill audit（接入 skill-eval 对账「真实执行 vs SKILL.md」：五态 verdict、可过滤 findings、by-instruction 表、实时进度条流式百分比）。 - Session Trajectory Analyzer：自建轻量 agent，正则预处理 + 有界 LLM 循环（≤3 轮）分析 10 万+ 行轨迹 MD，无需 Claude Code；Python 版 smart-agent/ + TS 版双端对齐，HTTP 服务 + Next.js 代理路由，Audit tab 可切 v1(TS)/v2(Python)。 - Audit 结果 JSON 导入/导出（audit-export.ts）。 七、性能优化 - 导入流水线 create → createMany + $transaction，单 session 35-100x 加速（23.5s→1.6s），batch 分批（500 条/批）防 SQLite 变量溢出 - opencode-db 适配器 N+1 消除：listSessions ~200+ → 5-6 次批量查询；readSession N×3 → 3 次 - 大 session 事务超时 5s → 60s，解决 "Transaction already closed" 八、移除项 移除 替代 Workflow tab（WorkflowAIView.tsx/WorkflowTreeView.tsx） Performance tab + Audit tab prompts/workflow-analyse.md session-trajectory-analyse.md + trajectory-compress.md tests/start-script.test.ts tests/start-sh-validation.test.ts 九、测试覆盖 新增 45 个测试文件，覆盖上述能力：zip-store(11)、skill-content(20)、file-restore(26)、dir-restore-api、skill-eval-audit、audit-job/audit-export、turn-align/-hard/-stress/-manual、compare-perf/*、claude-autorefresh*、agent-md-scan、trajectory-analyzer、cannbay-archive、upload-session-api、start-sh-validation 等。 同步内容为 skills-dev main 已提交状态，未带入开发仓未提交改动；package-lock.json 按 .gitignore 约定不入库；版本号 VERSION = "1.48"。 关联的Issue <!-- 本次为版本同步发布，暂无对应 Issue。cannbot-insight 大版本跳跃建议在本 PR 评审期间于 Discussions 同步说明。 --> 测试 - cannbot-insight 单元/集成测试：cd plugins-community/cannbot-insight && npm install && npm test（vitest，新增 45 个测试文件） - 仓库级 CI 闸门：./tests/gate_check.sh、./tests/run-tests.sh --fast - 4 个抽样文件 hash 已校验与 skills-dev main blob 一致，确保未带入未提交改动 文档更新 - README.md：Features 列表新增 Performance / 循迹复卷 / 重编汇册 / SKILL.md 全文 / Skill audit 描述 - CHANGELOG.md：补齐 v1.37-v1.40 条目 - 新增设计文档：docs/architecture.md、docs/performance-tab-design.md、docs/audit-skill-subtab-design.md、docs/session-trajectory-analyzer-design.md - 新增 smart-agent/README.md See merge request: cann/cannbot-skills!731 | 17 天前 | |
feat(cannbot-insight): 同步 v1.51（v1.03 → v1.51） Co-authored-by: duanbingzhe<duanbingzhe@huawei.com> # message auto-generated for no-merge-commit merge: !731 merge fix/CleanCode into master feat(cannbot-insight): 同步 v1.51（v1.03 → v1.51） Created-by: duanbingzhe Commit-by: duanbingzhe Merged-by: cann-robot Description: ## 描述 cannbot-insight 功能更新，版本 v1.03 → v1.48。本次新增七大功能，新增 114 个文件、修改 48 个、移除 4 个（旧 Workflow/AI Workflow tab）。主线为 性能可观测（Performance 全景）、文件循迹重建、会话对齐，Audit 工作流审计作为 preview 先行合入承接后续迭代。 一、Performance 性能全景 全新的独立 Performance tab，一站式 session 级性能与成本可观测。所有数据直读 DB、零 LLM 依赖——确定性、可重复、即开即用，不受审计结果波动影响。 PerfPanorama 性能全景三大面板： 1. perf top — 子代理耗时排行（Linux top 风格） - 可排序表格（TURNS / TIME / TOKENS / AVG·T），活跃列箭头指示，列宽稳定不偏移 - 占比条形图：当前值占总量比例，条色随排序键切换（TIME 红 / TOKENS 蓝 / TURNS 灰），一眼锁定最耗资源的子代理 - 点击下钻：展开该子代理 turn 列表（§N + 耗时 + tokens + tools + model），默认 Top 10、一键展开全部 2. Token 成本分析 — 精准定位优化空间 - Cache 节省量卡片：命中缓存（绿）vs 未命中冷输入（红）的量与占比，直指 compaction 后重复输入的浪费 - 每轮 Cache 命中率趋势线（SVG 折线 + 面积渐变），compaction 事件自动标注（命中率骤降点），低命中轮次（<50%）标红 - 与 perf top 联动：下钻 turn 行增加 cache 命中率列，低命中高亮，形成「定位问题 turn → 跳转排查」闭环 3. Top 工具调用 — 耗时瓶颈定位 - 全 session 工具按 durationMs 降序 Top 10，水平条形图，标签 toolName §turnIndex - 点击直接跳转 turns tab 对应 turn 净耗时归因（关键能力）：主 Agent 耗时自动扣除并行子代理等待时间（max(bridge.subagentLatencyMs)），还原主 Agent 真实工作时间，避免被子代理壁钟时间虚高——这是判断「主 Agent 是真慢还是在等子代理」的核心依据。 7 张总览卡片：主 Agent 耗时(净) / 子代理耗时 / 总 Tokens / Cache 命中率 / 主 Agent turns / 子代理 sessions / 工具调用，响应式 grid（2/3/6 列）。 交互与性能：可折叠全景、懒挂载（切 tab 不卸载不 re-fetch）、onJumpToTurn 回调定位。设计文档 docs/performance-tab-design.md。 v1.48 同时完成 perf2→perf 整合，并移除旧 Workflow tab 与 AI Workflow tab（删除 WorkflowAIView.tsx/WorkflowTreeView.tsx/prompts/workflow-analyse.md），其能力由 Performance + Audit 承接。 二、文件循迹重建 - File Content Restore（循迹复卷）：每文件行一键按时间戳拼合本会话内 read/write 片段重建全文（后写入者覆盖先前），未被读取行标注 --line N not found --；兼容 claude（N\t）与 opencode（<content> 信封 + N: ）两种 Read 格式，支持下载/收起。API GET /api/observe/session/file-restore + 纯函数库 src/lib/file-restore.ts。 - Gather & Rebuild Directory（重编汇册）：一键按路径树重建本会话工作目录下全部被读/写文件并打包下载 zip，服务端构建二进制响应（不在页面展开全部内容）。纯函数库 src/lib/zip-store.ts（buildZip/crc32/normalizeZipPath，STORE 无压缩 + UTF-8 文件名标志位兼容 Windows 中文路径）。API GET /api/observe/session/dir-restore。 - Skill Content（SKILL.md 全文）：每个 skill 可点击展示/下载全文，优先取原生 Skill 工具注入的 resultJson（剥前导），回退 Read of */SKILL.md（剥行号），多次加载取最长版本。API GET /api/observe/session/skill-content。 三、Session Compare — turn 对齐 - banded-DP turn 对齐算法：两个 session 逐 turn 对齐，Web Worker 后台计算不阻塞 UI，ComparePanorama 全景对比 token/费用/耗时/工具调用/subagent。含正确性与性能基准（tests/compare-perf/：banded-dp-correctness、turn-align.bench、api-n+1-elimination、render-smoke）。新增 src/lib/compare/turn-align.ts/turn-align.worker.ts。 四、增量刷新 Auto-refresh 探测源 DB 变化后增量导入（auto-refresh-probe.ts），支持 SSE 流式进度推送，适配 Claude Code JSONL 与 opencode DB。新增 API /api/observe/auto-refresh、/api/observe/auto-refresh-stream，e2e fixture 覆盖 append-turn/idle-assistant/streaming 场景。 五、CLI 与配置 - CLI export-md：导出 session 为 Markdown（与 Web UI 导出/audit step 1 同源输出），供轨迹分析器消费。src/cli/commands/export-md.ts。 - AI Provider 配置：settings 页面 + AIProviderConfigPanel，为审计配置 OpenAI 兼容 provider（baseUrl/apiKey/model）。 - agent-md-scan / agent-version：扫描本地 agent .md、提取版本号。 六、Audit 审计（持续完善中） - Audit tab 拆两个子 tab：Workflow audit（v1-v4，preview）+ Skill audit（接入 skill-eval 对账「真实执行 vs SKILL.md」：五态 verdict、可过滤 findings、by-instruction 表、实时进度条流式百分比）。 - Session Trajectory Analyzer：自建轻量 agent，正则预处理 + 有界 LLM 循环（≤3 轮）分析 10 万+ 行轨迹 MD，无需 Claude Code；Python 版 smart-agent/ + TS 版双端对齐，HTTP 服务 + Next.js 代理路由，Audit tab 可切 v1(TS)/v2(Python)。 - Audit 结果 JSON 导入/导出（audit-export.ts）。 七、性能优化 - 导入流水线 create → createMany + $transaction，单 session 35-100x 加速（23.5s→1.6s），batch 分批（500 条/批）防 SQLite 变量溢出 - opencode-db 适配器 N+1 消除：listSessions ~200+ → 5-6 次批量查询；readSession N×3 → 3 次 - 大 session 事务超时 5s → 60s，解决 "Transaction already closed" 八、移除项 移除 替代 Workflow tab（WorkflowAIView.tsx/WorkflowTreeView.tsx） Performance tab + Audit tab prompts/workflow-analyse.md session-trajectory-analyse.md + trajectory-compress.md tests/start-script.test.ts tests/start-sh-validation.test.ts 九、测试覆盖 新增 45 个测试文件，覆盖上述能力：zip-store(11)、skill-content(20)、file-restore(26)、dir-restore-api、skill-eval-audit、audit-job/audit-export、turn-align/-hard/-stress/-manual、compare-perf/*、claude-autorefresh*、agent-md-scan、trajectory-analyzer、cannbay-archive、upload-session-api、start-sh-validation 等。 同步内容为 skills-dev main 已提交状态，未带入开发仓未提交改动；package-lock.json 按 .gitignore 约定不入库；版本号 VERSION = "1.48"。 关联的Issue <!-- 本次为版本同步发布，暂无对应 Issue。cannbot-insight 大版本跳跃建议在本 PR 评审期间于 Discussions 同步说明。 --> 测试 - cannbot-insight 单元/集成测试：cd plugins-community/cannbot-insight && npm install && npm test（vitest，新增 45 个测试文件） - 仓库级 CI 闸门：./tests/gate_check.sh、./tests/run-tests.sh --fast - 4 个抽样文件 hash 已校验与 skills-dev main blob 一致，确保未带入未提交改动 文档更新 - README.md：Features 列表新增 Performance / 循迹复卷 / 重编汇册 / SKILL.md 全文 / Skill audit 描述 - CHANGELOG.md：补齐 v1.37-v1.40 条目 - 新增设计文档：docs/architecture.md、docs/performance-tab-design.md、docs/audit-skill-subtab-design.md、docs/session-trajectory-analyzer-design.md - 新增 smart-agent/README.md See merge request: cann/cannbot-skills!731 | 17 天前 |
| 文件 | 最后提交记录 | 最后更新时间 |
|---|---|---|
| 8 天前 | ||
| 17 天前 | ||
| 17 天前 | ||
| 8 天前 | ||
| 1 个月前 | ||
| 8 天前 | ||
| 17 天前 | ||
| 17 天前 | ||
| 17 天前 | ||
| 17 天前 | ||
| 8 天前 | ||
| 17 天前 | ||
| 17 天前 | ||
| 17 天前 | ||
| 17 天前 | ||
| 1 个月前 | ||
| 1 个月前 | ||
| 8 天前 | ||
| 17 天前 | ||
| 1 个月前 | ||
| 1 个月前 | ||
| 17 天前 | ||
| 1 个月前 | ||
| 1 个月前 | ||
| 17 天前 | ||
| 17 天前 | ||
| 1 个月前 | ||
| 17 天前 | ||
| 1 个月前 | ||
| 17 天前 | ||
| 17 天前 | ||
| 1 个月前 | ||
| 1 个月前 | ||
| 1 个月前 | ||
| 8 天前 | ||
| 8 天前 | ||
| 17 天前 | ||
| 8 天前 | ||
| 8 天前 | ||
| 1 个月前 | ||
| 1 个月前 | ||
| 8 天前 | ||
| 17 天前 | ||
| 17 天前 | ||
| 17 天前 | ||
| 1 个月前 | ||
| 8 天前 | ||
| 17 天前 | ||
| 17 天前 | ||
| 17 天前 | ||
| 17 天前 | ||
| 17 天前 | ||
| 17 天前 | ||
| 8 天前 | ||
| 17 天前 | ||
| 17 天前 | ||
| 17 天前 |