# codex-plugins

**Repository Path**: waset/codex-plugins

## Basic Information

- **Project Name**: codex-plugins
- **Description**: No description available
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: main
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-07-20
- **Last Updated**: 2026-08-11

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# 潮美科技插件集

This repository contains the `codex-plugins` Codex marketplace:

- `apifox`: inspect and use Apifox API projects through MCP.
- `wecom`: operate WeCom internal applications through the official server API.
- `jin-dou-yun`: use generated 金斗云 database schema, enum references, API route lists, auth cache, and API helpers.

## Layout

```text
.agents/plugins/marketplace.json
plugins/apifox/
plugins/jin-dou-yun/
plugins/wecom/
```

## Install

Add this Git repository as a Codex marketplace:

```bash
codex plugin marketplace add hnyjzj/codex-plugins
```

Each plugin keeps its own `.env.local` inside that plugin directory. Configure once after installing
or updating the plugin; later calls load it automatically:

```bash
# Run each command from that plugin's installed directory.
python3 scripts/wecom_api.py configure --corp-id 'ww...' --agent-id '1000002' --ask-corp-secret
python3 scripts/jdy.py configure \
  --db-host 127.0.0.1 --db-port 3306 --db-name jdy --db-user root --ask-db-password
```

- `apifox`: the user only provides `APIFOX_ACCESS_TOKEN=<token>` when asked. The plugin automatically
  saves it to its own directory, validates it, and continues the original request; users do not run
  configuration commands or restart the task.
- `wecom`: saves `WECOM_CORP_ID`, `WECOM_CORP_SECRET`, and `WECOM_AGENT_ID`.
- `jin-dou-yun`: saves optional API/database settings for direct calls and queries.

All `.env.local` and `.auth-cache*.json` files are ignored by Git. macOS/Linux use mode `0600`;
Windows uses an NTFS ACL that grants access only to the current Windows user. They are deliberately
version-local: updating a plugin requires configuring and authorizing the new plugin copy again.
Process environment variables may temporarily override saved values, but are not required for normal
use.

When configuration is missing, expired, rejected, or a service cannot be reached, every plugin must
identify the failed target and show the user a copyable `KEY=<中文说明>` template for the required
parameters or key. Apifox accepts its token as the user's only input and passes it internally through
non-echoing configuration; all plugins must avoid echoing secret values.

## Development

- Git commits must strictly follow Conventional Commits.
- Prefer Chinese commit messages when possible, for example `docs(apifox): 明确 MCP 为默认数据源`.