GerdsenAI/GerdsenAI-Agentic-Devtools
GitHub: GerdsenAI/GerdsenAI-Agentic-Devtools
一套跨平台 agentic 开发工具箱，通过 MCP 和斜杠命令为多种 AI 编程助手提供文档构建、深度调研、向量数据库、对抗审查和项目脚手架等统一能力。
Stars: 0 | Forks: 0
# GerdsenAI Agentic Devtools
它通过 `/gerdsenai:` 斜杠命令在 Claude Code 中原生运行，并由 [GerdsenAI Document Builder](https://github.com/GerdsenAI/GerdsenAI_Document_Builder) 提供支持。
## 目录
- [快速开始](#quick-start)
- [命令](#commands)
- [从任意 AI 工具中使用](#use-from-any-ai-tool)
- [本地推理](#local-inference)
- [配置](#configuration)
- [设计驱动规划](#design-driven-planning)
- [文档](#documentation)
- [关于 Gerdsen.AI](#about-gerdsenai)
- [许可证](#license)
- [免责声明](#disclaimer)
## 快速开始
**前置条件：** [uv](https://docs.astral.sh/uv/)。该插件原生支持 uv —— uv 会自行创建虚拟环境并配置合适的 Python (3.9+)，因此无需单独安装 Python。在 Windows 上，还需安装 Git for Windows（提供 Git Bash）。
```
# 安装 uv (macOS/Linux)
curl -LsSf https://astral.sh/uv/install.sh | sh
```
**安装插件** —— 既可以让 Claude Code 指向本地检出目录：
```
claude --plugin-dir .
```
…或者在 Claude Code 中添加 marketplace：运行 `/plugin`，打开 **Marketplaces**，添加 `GerdsenAI/GerdsenAI-Agentic-Devtools`，然后从 **Discover** 中安装 **gerdsenai** 并运行 `/reload-plugins`。
…或者从终端安装：
```
claude plugin marketplace add GerdsenAI/GerdsenAI-Agentic-Devtools
claude plugin install gerdsenai@gerdsenai-agentic-devtools-marketplace --scope user
# 之后，若要更新：claude plugin marketplace update gerdsenai-agentic-devtools-marketplace && claude plugin update gerdsenai@gerdsenai-agentic-devtools-marketplace
```
**配置并构建：**
```
/gerdsenai:setup # guided install + preferences (output, logos, page size, vector DB)
/gerdsenai:build my-doc.md # build a professional PDF
```
完整的安装方法、故障排除和详细配置请参阅 [docs/USAGE.md](docs/USAGE.md)。
## 命令
| 命令 | 描述 |
|---------|-------------|
| `/gerdsenai:help [command]` | 快速只读导览 —— 每个命令的作用、当前配置状态以及从哪里开始 |
| `/gerdsenai:setup` | 安装、配置或更新 Document Builder |
| `/gerdsenai:config [show\|get\|set]` | 从单一 schema 查看和设置任何插件配置 —— 分组、验证、就地编辑（展示所有键，包括以前只能手动编辑的键） |
| `/gerdsenai:build ` | 构建 PDF —— 单个文件或递归目录（自动检测） |
| `/gerdsenai:research-report [topic\|file]` | 深度多来源研究和情报报告；当提供报告文件时支持来源新鲜度监控 |
| `/gerdsenai:red-team ` | 跨 11 个领域的对抗性分析（代码、安全、依赖、架构、测试、DevOps、数据库、AI/ML、可访问性、文档、战略） |
| `/gerdsenai:vector-db [operation]` | Vector DB 管理：报告、存储、查询、同步、配置 —— 支持 ChromaDB、Pinecone 或 Qdrant（本地 FastEmbed 或 server/Cloud）。支持检测并重用的引导流程、项目感知的模型推荐、local-LLM embeddings、双后端自动镜像以及本地↔云同步 |
| `/gerdsenai:sprint-execute [plan\|description\|resume]` | 自主 sprint 执行器：苏格拉底式规划、自动编码、自动提交 |
| `/gerdsenai:llm [detect\|configure\|test\|run]` | 配置或使用本地/远程 OpenAI 兼容 LLM 后端 |
| `/gerdsenai:init [target-dir]` | 搭建新的跨平台、agent 就绪项目（AGENTS.md、MCP、CLAUDE.md、local-inference 配置、git init） |
| `/gerdsenai:agentic-ui [--style observability\|chatgpt\|manus]` | 搭建独立的 agent UI：`observability`（实时终端 → 伪桌面 → computer-use，`--phase 1\|2\|3`），`chatgpt`（ChatGPT 风格的聊天 UI），或 `manus`（Manus 风格的 agent 工作区：聊天 + 实时 Plan / Artifacts / Activity）。公共安全，localhost+token，BYO-model |
| `/gerdsenai:discover [goal]` | 发现符合您目标的 Claude Code 插件、技能、功能和模式 —— 包含精确安装命令的排名建议。绝不自动安装 |
| `/gerdsenai:design-plan` | 打印针对 `/ultraplan`（云规划、浏览器审查）的精选启动提示，以便由 Anthropic 的 `frontend-design` 技能驱动插件客户界面的设计刷新 |
| `/gerdsenai:dashboard` | 启动可选的本地 dashboard —— 一个只读 Web UI，用于监视此插件自身的 agent 工作情况（实时活动流 + sprint/to-do 看板）。Localhost + token，选择性开启 |
| `/gerdsenai:session [status\|sync\|use\|serve\|build …]` | GerdsenAI Session：发现/同步您的 AI 提供商（Ollama/Claude/OpenAI/Gemini/vLLM/LM Studio/OpenRouter）及 vector 存储（Qdrant/Chroma/Pinecone），并通过本地 `127.0.0.1:4318` bridge 向 Session 工作区提供**脱敏**配置。`build` 用于搭建只读工作区 —— 一个 **AI 提供商/vector 标签页**，加上一个**多会话侧边栏 + 聊天/计划/工具调用时间线**，用于观察正在运行的 agent（带有针对每个会话的模型标签）。Local-first，loopback+token，密钥安全保存在您的 keychain 中 |
`/gerdsenai:agentic-ui` 会生成一个独立的 Node + Docker Compose 应用（不是用于此插件的 UI），分为三个累积阶段：浏览器内实时**终端**（xterm.js + node-pty）、Docker 化的**伪桌面**（Xvfb + x11vnc + noVNC）以及 **computer-use** 循环（截图 → VLM → 点击/输入）。它是公共安全且 BYO-model 的 —— 不提供任何凭据或硬编码 endpoint，绑定在生成的 auth token 后的 `127.0.0.1` 上，并默认为只读；您需要提供自己的视觉模型。
当您编写旨在用于 PDF 的 Markdown 时，`pdf-document-authoring` 技能会自动激活，指导 front matter、标题层级、代码块和 Mermaid 图表。完整的命令选项、agent 工作流程和报告类型记录在 [docs/USAGE.md](docs/USAGE.md) 中。
**跳过提问。** 任何提出澄清性问题的命令都接受 **`--yes`**（别名 `-y`）以采用文档默认值并继续执行（`--force` 在其本身已表示覆盖的地方暗含此意）；当您的意图很明确时，也会自动跳过提问。出于安全考虑，单独的 `--yes` 绝不会自动确认安装或覆盖现有文件。请参阅 [docs/USAGE.md](docs/USAGE.md#command-reference)。
### 观察插件工作（可选 dashboard）
`/gerdsenai:dashboard` 构建并可选地启动一个范围限定于此插件的可选本地只读 Web UI —— 这与 AgenticUI 脚手架（可为任何 AI agent 生成独立应用）不同。前端是一个 **Next.js 16 + shadcn** 应用（这里的 shadcn 基于 Base-UI，而不是 Radix），以源码形式提供，并在通过 `npm install && npm run build` 一次性构建为静态导出后，由 **zero-dependency pure-Node** 的 `server.js`（`node server.js`）提供服务。这是一个 **agentic-observability** UI —— 它将原始的工具事件转化为平实的语言叙述（*“red-team 正在运行 shell 命令”*），推断实时状态（跳动的计时器、呼吸感状态点），并对每一次推断保持**诚实**（推断出的元素会被明确标记）。包含两个视图：
- **Mission Control** —— 多项目 **Fleet**：跨您的**已注册项目**的只读 git status（分支、“截至上次 fetch 时”的 ahead/behind 情况、脏文件计数、上次提交、每个仓库的 60 秒活动迷你图），以及一个实时的全局叙述流。使用 `/gerdsenai:dashboard add|remove|list ` 管理要监视的仓库（写入 `~/.gerdsenai/projects.json`）。
- **Project Cockpit** —— 单个项目的近距离视图：计划主轴、实时的“正在播放”通道（带有 **Workflow fan-out** 可视化效果）、可擦洗的 **Replay** 时间线、工具调用检查器、注意力中心，以及 sprint/to-do 看板（来自 CLAUDE.md + todo 文件）。
支持叙述的**活动流**是选择性开启的（`dashboard_activity_log: on`；默认关闭）。它绑定 `127.0.0.1`，需要生成的 auth token（嵌入在 URL 中），并且是**只读**的 —— 每个 git 调用都已列入白名单（仅限 `rev-parse`/`status`/`rev-list`/`log`，通过 `execFile` 执行，无 shell，无网络），已注册的路径会进行 realpath 限制，且仅通过 CLI 在带外修改注册表。Ahead/behind 反映了您上次本地 `git fetch` 的结果。运行它需要 Node.js。配置和安全详细信息请参阅 [docs/USAGE.md](docs/USAGE.md)。
## 从任意 AI 工具中使用
该工具包不仅限于 Claude。它附带了一个 **MCP server** 和一个 **`AGENTS.md`**，使得 Codex、GitHub Copilot、VS Code、Cursor、Gemini CLI、OpenCode 及其他 agent 也能使用相同的功能。您的宿主 agent 负责推理；代码仓库提供了封装 PDF 渲染器、vector memory、来源跟踪和 local-inference 层的便携脚本。
- **MCP server** 暴露了七个工具：`build_pdf`、`vector_db_query`、`vector_db_store`、`vector_db_report`、`vector_db_sync`、`track_sources` 和 `llm_complete`。
- **`AGENTS.md`** 可被 Codex、Cursor、Gemini CLI 和 OpenCode 原生读取；还有一个 Copilot instructions 文件用于覆盖 GitHub Copilot。
完整的客户端对照表和注册步骤请参阅 [docs/CROSS-PLATFORM.md](docs/CROSS-PLATFORM.md)。
## 本地推理
AI 功能可以路由到任何兼容 OpenAI 的 `/v1` endpoint，因此本地提供的模型无需托管 API 即可工作。后端（Ollama、vLLM、LM Studio）会被自动检测。
```
/gerdsenai:llm detect # probe running backends
```
后端、配置和环境变量请参阅 [docs/LOCAL-INFERENCE.md](docs/LOCAL-INFERENCE.md)。
## 配置
执行 `/gerdsenai:setup` 后，配置将**按仓库**存储在 `.claude/gerdsenai.local.md`，或者**全局**存储在 `~/.claude/gerdsenai.global.md`（由您选择范围；按仓库的文件具有优先权）。关键字段涵盖 Document Builder 路径、Vector DB 模式、输出位置、徽标、页面大小和引文样式。
使用 **`/gerdsenai:config`** 查看或更改任何设置（`show` 用于获取分组且带描述的所有键列表；`set ` 用于进行经 schema 验证的就地编辑），或运行 `/gerdsenai:setup` 向导。权威的 schema 位于 `scripts/lib/settings-schema.json`，并且 `templates/gerdsenai.settings.example.md` 中提供了一个可复制的模板。完整的参考文档和 Document Builder `config.yaml` 的样式选项请见 [docs/USAGE.md](docs/USAGE.md)。
**密钥**（API keys：`PINECONE_API_KEY`、`QDRANT_API_KEY`、`OPENAI_API_KEY`、`GERDSEN_LLM_API_KEY`、`GERDSEN_EMBED_API_KEY`，以及由 `gerdsen` provider-sync CLI 读取的 Session AI 标签页提供商密钥 `ANTHROPIC_API_KEY`、`GEMINI_API_KEY`、`OPENROUTER_API_KEY`）**绝不**存储在设置文件中。请将它们设置为环境变量，或者通过插件配置（`/plugin` → 此插件）一次性配置 —— 它们在 `userConfig` 中声明，输入时会被掩码处理并存储在您的 **OS keychain** 中，然后自动暴露给插件的脚本使用。
## 设计驱动规划
对于主要涉及*插件的外观和体验*的版本发布（模板、脚手架文案、README、marketplace 列表），请使用 `/gerdsenai:design-plan` 打印精选的启动提示，并将其粘贴到 Claude Code 的 [`/ultraplan`](https://code.claude.com/docs/en/ultraplan) 中（研究预览版；v2.1.91+）—— 规划任务会转移到一个云端的 Claude Code 会话中，您可以在浏览器中进行（行内评论、emoji 批准、结构化大纲）。此代码仓库的 `.claude/settings.json` 按仓库启用了 Anthropic 的 [`frontend-design`](https://github.com/anthropics/claude-plugins-public/tree/main/plugins/frontend-design) 插件，以便云端会话能继承其大胆的美学观点（排版、颜色、动态、构图 —— 明确反对“AI slop”）。在您的机器上使用 `claude plugin install frontend-design` 安装一次。在浏览器中批准计划，然后在本地 `feat/*` 分支上执行设计刷新。完整工作流程：[skills/agentic-ui/references/design-ultraplan.md](skills/agentic-ui/references/design-ultraplan.md)。
## 文档
- [docs/USAGE.md](docs/USAGE.md) —— 安装方法、命令选项、agent 工作流程、配置参考、故障排除
- [docs/CROSS-PLATFORM.md](docs/CROSS-PLATFORM.md) —— 从任意 AI 工具中使用该工具包（MCP + AGENTS.md）
- [docs/LOCAL-INFERENCE.md](docs/LOCAL-INFERENCE.md) —— Ollama / vLLM / LM Studio 配置
- [docs/OPTIMIZATION.md](docs/OPTIMIZATION.md) —— 性能与资源调优
- [CHANGELOG.md](CHANGELOG.md) —— 发布历史
## 关于 Gerdsen.AI
GerdsenAI Agentic Devtools 由 [Gerdsen.AI](https://gerdsen.ai) 构建和维护，该公司设计实用的、跨平台的工具，帮助团队将 AI agent 投入工作 —— 从文档生成到研究、代码审查和自主工程。了解更多信息，请访问 [gerdsen.ai](https://gerdsen.ai)。
## 许可证
MIT 许可证 —— 详见 [LICENSE](LICENSE)。
## 免责声明
本软件按 **“原样”** 提供，不附带任何形式的保证。AI 生成的输出（文档、研究、代码、评论）可能不准确或不完整 —— **在依赖它之前务必进行验证**。本工具包产生的任何内容均不构成法律、财务或其他专业建议，您需对您生成的内容及使用方式负责。完整条款请见 [DISCLAIMER.md](DISCLAIMER.md)。
标签：AI智能体, AI风险缓解, MCP协议, MITM代理, SOC Prime, 开发工具, 文档转换, 本地推理, 研发效能, 请求拦截, 逆向工具