Hawk Personal Plugins

个人 AI 插件市场，集中维护 Codex、Claude Code 与 MCP 插件。

插件目录

插件	平台	功能	位置	状态
evidence-researcher	Codex / MCP Apps	搜索核验、商品选购、行情分析和可视化结果	plugins/evidence-researcher	可用
weixin-album	Claude Code / MCP	下载微信公众号合集文章与图片，生成 Markdown 索引	plugins/weixin-album	可用
code-atlas	Codex / Claude Code	用源码证据生成五分钟项目导览、改动影响图和学习路线	plugins/code-atlas	可用

每个插件都是独立单元，自己的清单、源码、依赖、脚本和文档均放在对应的 plugins/<plugin-name>/ 目录中。

安装

Codex：evidence-researcher

git clone https://github.com/Hawk-liang/hawk-plugins.git
cd hawk-plugins
codex plugin marketplace add "$PWD"
codex plugin add evidence-researcher@personal

安装或更新后，请开启新的 Codex 任务，以载入最新 Skill、MCP 工具和 UI。

Claude Code：weixin-album

1. 打开 Claude Code 的 Manage Plugins；
2. 在 Marketplaces 中添加 Hawk-liang/hawk-plugins；
3. 确认 Marketplace 显示为 hawk-plugins，在 Plugins 中搜索并安装 weixin-album；
4. 按照 plugins/weixin-album/README.md 完成 Chromium 安装。

Codex / Claude Code：code-atlas

Codex：

codex plugin marketplace add "$PWD"
codex plugin add code-atlas@personal

Claude Code：

1. 在 Manage Plugins → Marketplaces 中添加 Hawk-liang/hawk-plugins；
2. 确认 Marketplace 显示为 hawk-plugins，搜索并安装 code-atlas；
3. 使用 /code-atlas:code-atlas 调用。

也可以通过 Claude Code CLI 安装：

claude plugin marketplace add https://github.com/Hawk-liang/hawk-plugins
claude plugin install code-atlas@hawk-plugins

本机个人开发可把 plugins/code-atlas/skills/code-atlas 分别链接到 ~/.agents/skills/code-atlas 和 ~/.claude/skills/code-atlas，两端共用同一份 Skill 源码。

仓库结构

hawk-plugins/
├── .agents/
│   └── plugins/marketplace.json          # Codex 市场入口
├── .claude-plugin/
│   └── marketplace.json                  # Claude Code 市场入口
├── plugins/
│   ├── evidence-researcher/
│   │   ├── .codex-plugin/plugin.json     # Codex 插件清单
│   │   ├── .mcp.json                     # MCP Apps 服务配置
│   │   ├── skills/                       # 搜索、选购、行情 Skill
│   │   ├── server/                       # MCP 服务
│   │   ├── ui/                           # 可视化结果界面
│   │   ├── scripts/                      # 插件级测试
│   │   └── README.md                     # 插件说明
│   ├── weixin-album/
│       ├── .claude-plugin/plugin.json    # Claude Code 插件清单
│       ├── .mcp.json                     # MCP 服务配置
│       ├── src/                          # TypeScript 源码
│       ├── docs/                         # 设计与实现资料
│       ├── package.json                  # 插件依赖与脚本
│       ├── package-lock.json             # 依赖锁定
│       ├── tsconfig.json                 # TypeScript 配置
│       └── README.md                     # 插件说明
│   └── code-atlas/
│       ├── .codex-plugin/plugin.json     # Codex 插件清单
│       ├── .claude-plugin/plugin.json    # Claude Code 插件清单
│       ├── skills/code-atlas/            # 两端共用 Skill
│       └── README.md                     # 插件说明
├── .gitignore                            # 仓库通用忽略规则
└── README.md                             # 市场首页和插件索引

目录约定

新增插件时遵循以下规则：

1. 目录统一使用 plugins/<plugin-name>/，名称采用小写连字符格式；
2. 插件必须自包含，不从自己的目录外读取运行文件；
3. Codex 插件清单放在 .codex-plugin/plugin.json；
4. Claude Code 插件清单放在 .claude-plugin/plugin.json；
5. MCP 配置放在插件根目录的 .mcp.json；
6. 源码、测试、资源和文档分别放入 src/、tests/ 或 scripts/、assets/、docs/；
7. 每个插件在自己的 README.md 中维护安装、使用与验证说明；
8. 根市场清单只负责登记插件，不存放单个插件的实现文件。

开发与验证

验证 evidence-researcher：

python3 plugins/evidence-researcher/scripts/smoke_test_mcp.py

构建 weixin-album：

cd plugins/weixin-album
npm ci
npm run build

验证 code-atlas：

python3 ~/.codex/skills/.system/plugin-creator/scripts/validate_plugin.py plugins/code-atlas
python3 ~/.codex/skills/.system/skill-creator/scripts/quick_validate.py plugins/code-atlas/skills/code-atlas
node plugins/code-atlas/skills/code-atlas/scripts/scan-project.mjs /path/to/project --mode summary

License

各插件沿用其插件清单中声明的许可证。