把 AAsource 的 A 股事实查询能力封装成 ChatGPT / Codex 插件。
可查证券主数据、实时行情、K 线、成交、市场截面、板块、可复算特征和参考数据，也可以一次取回无判断的个股或市场证据包。所有结果保留来源、时效、警告、覆盖缺口与降级状态。
不提供交易建议，不具备下单能力。 证据包逻辑在本仓库内独立实现，不依赖 vibe-market 或 ashare-data-hub。
需要 Python 3.11 或 3.12。首次查询时插件会在本机准备隔离运行环境并安装依赖。
codex plugin marketplace add The-R0/AAsource-gpt --ref main
codex plugin add aasource@aasource-gpt安装后新建一个任务，让 aasource-market-data 技能进入会话。也可以使用完整 Git URL：
codex plugin marketplace add https://github.com/The-R0/AAsource-gpt.git --ref main
codex plugin add aasource@aasource-gptChatGPT 网页端读不到本地文件，也跑不了本机命令。把这台电脑当成 MCP 服务器后，由 OpenAI Secure MCP Tunnel 把请求转发到 http://127.0.0.1:8787/mcp。电脑要保持开机联网；不需要域名、公网 IP 或端口映射。
1. 只启动本机 MCP（自检用）
powershell -ExecutionPolicy Bypass -File plugins\aasource\scripts\start-mcp.ps1本机地址 http://127.0.0.1:8787/mcp，健康检查 http://127.0.0.1:8787/healthz。
2. 日常启动（本机 MCP + ChatGPT 隧道）
powershell -ExecutionPolicy Bypass -File plugins\aasource\scripts\start-chatgpt.ps1第一次运行会生成 .runtime\tunnel.env 并打开 OpenAI Tunnels 页面，需要填两个值：
| 字段 | 在哪里拿 |
|---|---|
CONTROL_PLANE_TUNNEL_ID |
Tunnels 创建，格式 tunnel_ + 32 位小写十六进制 |
CONTROL_PLANE_API_KEY |
API keys 创建的 runtime key |
保存后再跑一次 start-chatgpt.ps1，保持窗口开着。
3. 开机自启（可选）
# 登录后自动启动
powershell -ExecutionPolicy Bypass -File plugins\aasource\scripts\install-autostart.ps1
# 取消自启
powershell -ExecutionPolicy Bypass -File plugins\aasource\scripts\uninstall-autostart.ps1休眠或关机后 ChatGPT 网页端连不上。
4. ChatGPT 侧配置
- Settings → Security and login → 打开 Developer mode
- ChatGPT Plugins → 新建插件 → Connection 选 Tunnel，粘贴同一个
tunnel_id - 新开对话，从插件列表启用 AAsource
隧道客户端状态页在 http://127.0.0.1:8080/ui。ChatGPT 每次调用工具时，本机的 MCP 和 tunnel-client 都必须在线。
每天 15:05 之后写一次 close 快照（MCP 只读缓存，不会在对话里默默全扫）：
python plugins\aasource\scripts\scanner\run.py --slot close状态写在 .runtime\scanner\。详见 plugins/aasource/scripts/scanner/README.md。
- 给我贵州茅台的个股证据包，先说覆盖缺口再概括事实。
- 先读市场雷达：今天发生了什么、钱去了哪些题材、哪些题材在迁移、有哪些角色候选。
- 比较招商银行和平安银行的关键价格与近期涨跌。
- 列出当前行业板块涨幅排名。
- 行情与数据源请求固定直连，不读取
HTTP_PROXY/HTTPS_PROXY，本机代理软件不影响数据接口。 - tunnel-client 访问
api.openai.com时会走HTTPS_PROXY（如需要）；到127.0.0.1的回环连接自动绕过代理。 - 如果
git push被本机代理的 fake-IP 拦下，可在~/.ssh/config把github.com指到ssh.github.com:443。
.agents/plugins/marketplace.json
plugins/
└── aasource/
├── .codex-plugin/plugin.json
├── .mcp.json
├── skills/aasource-market-data/
├── scripts/run_aasource.py
├── scripts/run_mcp.py
├── scripts/mcp_server.py
├── scripts/packs/
├── scripts/scanner/
├── scripts/start-mcp.ps1
├── scripts/start-chatgpt.ps1
├── scripts/install-autostart.ps1
├── scripts/uninstall-autostart.ps1
├── assets/
└── runtime/
项目原创代码使用 MIT License。第三方数据源、接口、商标和内容不受 MIT License 覆盖；运行前请阅读插件内的 THIRD_PARTY_NOTICES.md。
插件构建格式遵循 OpenAI 官方插件文档。