opencode-session-analyzer

v0.1.1

Published

8 days ago

An OpenCode plugin for analyzing historical sessions and writing stable JSON artifacts.

0High
0Medium
0Low

aahljhlj

opencode plugin session analyzer llm

OpenCode Session Analyzer

English README

这是一个 OpenCode 插件，用于分析历史 session，为用户提供建议，旨在优化项目内或全局的AGENTS.md记忆文件。

本项目并非由 OpenCode 团队开发，不是 OpenCode 官方项目，也与 OpenCode 团队不存在隶属或关联关系。

本功能由用户显式触发分析，不进行隐藏的后台分析，也不单独维护自己的 API key。LLM 分析直接复用用户当前 OpenCode 环境中已经配置好的 provider 和 model。

快速开始

npm包名：opencode-session-analyzer

建议在 OpenCode 全局配置中添加：

{
  "$schema": "https://opencode.ai/config.json",
  "plugin": ["opencode-session-analyzer"],
  "command": {
    "session-analyzer": {
      "description": "默认按当前项目从最早开始分析 5 个待分析 session；可继续执行，或用 --project 分析当前项目全部待分析 session",
      "template": "Use the `session_analyzer` tool to analyze sessions for this workspace.\n\nArguments: `$ARGUMENTS`\n\nParse the arguments into this shape and call the tool exactly once unless the call fails and needs retry:\n\n```json\n{\n  \"arguments\": \"$ARGUMENTS\"\n}\n```\n\nAfter the tool returns, summarize in Chinese and keep it concise. Report analyzed progress, newly analyzed sessions, remaining eligible sessions, output directory, and any failures. Mention `/session-analyzer --project` when more eligible sessions remain.\n\nIf the tool call fails before analysis starts because `session_analyzer` is unavailable, the plugin package failed to install, or the error looks like a permission/write/install problem: explain that OpenCode installs the npm plugin implicitly from the `plugin` config entry and users do not need to preinstall it manually; clearly state this is usually a first-run permission problem while OpenCode is trying to write the plugin package; tell the user to close OpenCode and reopen it once with administrator privileges, then retry `/session-analyzer`; say that opening OpenCode as administrator once is usually enough for it to write the package successfully; do not present the run as analyzer success in this case."
    }
  }
}

首次使用时，OpenCode 会自动安装 opencode-session-analyzer。如果提示找不到工具，可能是安装过程中出现写入权限不足的报错，尝试关闭 OpenCode 后，用管理员权限打开一次 OpenCode，或用管理员权限打开命令行后运行 opencode，再重试 /session-analyzer 即可。通常只需要这一次管理员启动，OpenCode 就能把这个包自动写进去。

功能

按需分析历史 OpenCode session
生成 session、project、global 级别的机器可读 JSON 产物
跟踪哪些 session 已分析、哪些已经 stale
保留带 evidence 引用的结构化分析结果
生成可复用的工作流建议，但不自动改写项目规则

用法

在 OpenCode 中执行：

/session-analyzer

常见变体：

/session-analyzer
/session-analyzer --project
/session-analyzer --recent 10
/session-analyzer --session <id-or-path>
/session-analyzer --force
/session-analyzer --only-stale

输出文件

运行后会写入：

.opencode/session-analyzer/

包含：

analysis-index.json
run-progress.json
run-events.jsonl
project-summary.json
global-summary.json
sessions/<session-id>.json

这些都是本地生成产物，不应该提交到仓库，也不应该发布到 npm。

支持参数

--recent <n>
--project current
--project <path>
--session <id-or-path>
--force
--only-stale

默认批处理行为：

/session-analyzer 会分析当前项目中下一批 5 个 eligible session
/session-analyzer --project 会分析当前项目中全部 eligible session
/session-analyzer --recent <n> 会先选出范围内最近更新的 n 个 session，再按这些 session 中从早到晚的顺序执行分析

LLM 行为

当前 MVP 固定走 LLM 分析路径
如果某个 session 的 structured LLM output 缺失或无效，该 session 会被标记为失败
当 structured LLM analysis 失败时，不会退回 deterministic-only summary

验证

TypeScript 检查命令：

node_modules\.bin\tsc -p tsconfig.json --noEmit

发布前本地验包：

npm pack --dry-run
npm pack

隐私

生成的分析产物可能包含历史 session 内容
生成产物也可能包含本机路径和诊断信息
应保持 .opencode/session-analyzer/ 被 git 忽略，并且不要发布到 npm

当前限制

当前仓库仍主要按源码工作区和本地插件方式组织
最终 npm 分发形态仍建议在真实 OpenCode 安装环境中验证一次
/session-analyzer 当前通过 OpenCode custom tool 路由，而不是内建 plugin command API
project/global 聚合逻辑仍然比较轻量，还没有实现完整的时间冲突解析

License

MIT

Published

Vulnerabilities

Links

Maintainers

Keywords

Readme