mcpField
O
openwork-debug

openwork-debug

github.com/different-ai开发24.3k95 次安装今天更新
代码仓库

关于 openwork-debug

用于排查 OpenWork 及其 OpenCode 引擎问题的只读技能，提供 HTTP 检查、工作区和审计记录查看、引擎诊断，以及 SQLite 备用查询。

主要功能

  1. 01检查服务器健康状态与能力
  2. 02查看工作区及配置
  3. 03检查近期审计日志
  4. 04运行 OpenCode 引擎诊断
  5. 05使用 SQLite 备用查询

适用场景

  1. 01诊断 OpenWork 服务器响应
  2. 02检查工作区设置和活动
  3. 03检查 OpenCode 与 MCP 状态
  4. 04引擎 API 不可用时查看近期会话

MCP 相关

包含用于列出和调试已配置 MCP 服务的 OpenCode 命令。

安装

复制下面的命令，在终端中运行。

$npx skills add https://github.com/different-ai/openwork --skill openwork-debug

安装后在 Claude Code 中输入/openwork-debug确认已加载。

详细介绍

凭据检查

运行 HTTP 检查前，请设置以下变量：

  • OPENWORK_SERVER_URL
  • OPENWORK_SERVER_TOKEN
  • OPENWORK_WORKSPACE_ID（可选；使用 /workspaces 进行查找）

快速使用（只读）

curl -s "$OPENWORK_SERVER_URL/health"
curl -s "$OPENWORK_SERVER_URL/capabilities" \
  -H "Authorization: Bearer $OPENWORK_SERVER_TOKEN"

curl -s "$OPENWORK_SERVER_URL/workspaces" \
  -H "Authorization: Bearer $OPENWORK_SERVER_TOKEN"

工作区配置快照

curl -s "$OPENWORK_SERVER_URL/workspace/$OPENWORK_WORKSPACE_ID/config" \
  -H "Authorization: Bearer $OPENWORK_SERVER_TOKEN"

审计日志（最近）

curl -s "$OPENWORK_SERVER_URL/workspace/$OPENWORK_WORKSPACE_ID/audit?limit=25" \
  -H "Authorization: Bearer $OPENWORK_SERVER_TOKEN"

OpenCode 引擎检查

opencode -p "ping" -f json -q
opencode mcp list
opencode mcp debug <name>

数据库回退（只读）

引擎 API 不可用时，可以检查 SQLite 数据库：

sqlite3 ~/.opencode/opencode.db "select id, title, status from sessions order by updated_at desc limit 5;"
sqlite3 ~/.opencode/opencode.db "select role, content from messages order by created_at desc limit 10;"

注意事项

  • 审计日志存储在工作区根目录下的 .opencode/openwork/audit.jsonl。
  • OpenWork 服务只会在获准的工作区根目录内写入。

评论

支持 Markdown