@lyra-ai/toolkit

组织级研发工具集。面向研发团队的效能分析、评估与持续改进。

适用场景：组织内部已部署配套的分析平台和技能中心。不适用于个人开发者独立使用。

纯 JS（.mjs，Node 18+，无编译、无运行时依赖）。

功能

个人编码效能看板

安装后，你的 AI 编码数据自动进入组织分析平台，生成专属的多维度效能看板。

toolkit install --registry http://your-platform:38000

• 会话结束后自动同步，无需手动操作
• 支持多项目，按项目自动分组
• 只处理新会话，不重复

管理命令

toolkit status                 # 安装状态 + 已同步/待同步会话数
toolkit flush                  # 手动触发一次同步
toolkit config                 # 查看全部配置
toolkit config set registry <url>      # 修改平台地址
toolkit config set project-filter <关键词>  # 按项目名关键词过滤(逗号分隔),留空=全部
toolkit config unset project-filter         # 清除过滤,恢复全部
toolkit uninstall              # 卸载
toolkit uninstall --purge      # 卸载并清除本地数据

--registry

组织平台根地址，自动派生子系统路径：

http://your-host:38000
  /ai-metrics    效能分析平台
  /skillhub      技能中心（预留）

日志查询（log-query）

Elasticsearch 日志查询工具，支持链路追踪、时间窗口、关键词搜索、自动根因解析。首次使用运行向导配置。

目前支持 PlumeLog 索引格式（字段：dateTime / dtTime / traceId / appName / className / content / logLevel）。

log-query init                                # 向导式配置（ES 地址 + 索引 + 应用名）
log-query search --trace <traceId>            # 按链路追踪（全链路，时间正序）
log-query search --at "2026-07-11 08:32:40"   # 以某时刻为中心（默认 ±5 分钟）
log-query search --kw "NullPointerException"   # 关键词搜索
log-query search --hours 2 --json             # 回看 2 小时，JSON 输出
log-query search --since "..." --until "..."   # 绝对时间区间
log-query config                              # 查看当前 ES 配置

可选参数：--app <名> --level <级> --index <模式> --size <n> --window <分> --full

禅道 CLI（zentao）

禅道 REST v1 的命令行工具，支持 bug 查询/创建/解决、项目管理、配置管理。

zentao ping                              # 连通性测试
zentao init                              # 交互式配置
zentao project list                      # 项目列表
zentao product list                      # 产品列表
zentao bug list [过滤选项]                # bug 检索（本地缓存）
zentao bug sync [--product ID] [--mine]  # 同步 bug 到本地
zentao bug get <id>                      # bug 详情
zentao bug create --title T              # 创建 bug
zentao bug resolve <id> --resolution fixed  # 解决 bug
zentao config set <key> <value>          # 配置管理

默认输出 JSON（stdout），错误走 stderr。退出码：0 成功 / 2 参数 / 3 认证 / 4 网络 / 5 API。

安装

npm install -g @lyra-ai/toolkit   # 发布后
# 或本地开发：
cd <本目录> && npm link

JSON 示例

{"total":1,"count":1,"bugs":[{"id":"9","title":"t","severity":"1","priority":"2","status":"active","assignedTo":"a"}]}

skillhub 命令速查

AI 技能包管理器：搜索、安装、发布、管理 AI coding agent 技能包。

• skillhub help [topic] → 帮助信息（topic 为命令名）
• skillhub login --token <token> [--registry <url>] → 登录 registry
• skillhub logout → 清除本地凭证
• skillhub whoami → 显示当前登录用户
• skillhub search [query] [--limit N] [--json] → 搜索技能包
• skillhub install <slug> [--namespace <ns>] [--agent <profile>] [--scope user|project] [--max-file-size <size>] [--json] → 安装技能包
• skillhub list [--scope user|project] [--json] → 列出已安装技能包
• skillhub remove <slug> [--scope user|project] [--agent <profile>] [--json] → 移除技能包
• skillhub publish <path> [--json] → 发布技能包到 registry

Agent profiles（--agent）

支持 15 种 AI coding agent 配置文件：claude-code、codex、cursor、cody、continue、augment、copilot、tabnine、qoder、windsurf、aider、cline、roo、trae、generic。可重复使用 --agent 指定多个。

数据存储

• 凭证：~/.skillhub/credentials.json
• 配置：~/.skillhub/config.json
• 用户级技能包：~/.skillhub/skills/
• 项目级技能包：<cwd>/.skillhub/skills/

默认输出 JSON（stdout），错误走 stderr。退出码：0 成功 / 1 通用错误 / 2 参数配置 / 3 认证失败 / 4 网络错误。

skillhub JSON 示例

{"ok":true,"version":"0.1.0"}
{"ok":true,"skills":[{"slug":"code-review","version":"1.2.0","scope":"user"}]}