# audit-cube-skill

**Repository Path**: wwwwwc/audit-cube-skill

## Basic Information

- **Project Name**: audit-cube-skill
- **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-08-04
- **Last Updated**: 2026-08-04

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# 财审魔方（Audit-Cube）插件技能包

将 AuditCube 桌面审计工具箱的 **45 个原子插件能力**封装为可被任意 AI Agent 直接调用的 CLI 技能。
**插件核心逻辑已编译为二进制（.pyd），不以明文展示**；引导层（SKILL.md / run.py / config.json / manifest）为明文接口。

## 功能概览

| 分类 | 插件 | 说明 |
| --- | --- | --- |
| PDF 处理 (9) | pdf-info / pdf-compress / pdf-encrypt / pdf-decrypt / pdf-merge / pdf-split / pdf-watermark / pdf-to-images / pdf-insert-blank | 页数统计、压缩、加密、解密、合并、拆分、水印、转图片、插空白页 |
| 图片处理 (6) | pic-compress / pic-format-convert / pic-montage / pic-resize / pic-to-pdf / pic-watermark | 压缩、格式转换、拼接、尺寸调整、转 PDF、水印 |
| 表格处理 (5) | spreadsheet-preview / spreadsheet-toolkit / table-column-map / bank-statement-parser / bank-statement-check | 预览、工具箱、列映射、流水识别、流水核对 |
| 文件管理 (7) | file-info / file-ops / folder-info / batch-rename / local-search / archive-info / archive-manager | 元数据、文件操作、目录扫描、批量重命名、本地搜索、压缩包 |
| 文档转换 (3) | office-to-pdf / office-format-upgrade / rag-document-parser | Office→PDF、格式升级、文档→Markdown |
| 公告下载 (3) | hke / neeq / szse-announcements-download | 港交所 / 北交所 / 深交所公告 |
| 文本工具 (4) | smart-sum / web-fetch / web-search / wwcai-sensitive-check | 数字求和、网页抓取、联网搜索、敏感词检测 |
| 通信通知 (2) | webhook / mail | 飞书/钉钉/企业微信通知、邮件收发 |
| 财务数据 (6) | wwcai-audit-stats / wwcai-balance-sheet / wwcai-income-statement / wwcai-cash-flow / wwcai-fx-rates / wwcai-quota | 审计市场统计、三张报表、汇率、配额 |

## 环境要求

- **Windows x64**
- **Python 3.12 x64（必须，其他版本无法运行）**——`.pyd` 按 CPython 3.12 编译，与版本强绑定。若已装其他版本 Python，无需卸载，可另装 3.12 到独立文件夹（优先 `D:\Python312`，仅 C 盘时用 `C:\Python312`）共存

## 安装

```bash
# 1. 安装依赖（国内网络建议先配清华镜像）
pip config set global.index-url https://pypi.tuna.tsinghua.edu.cn/simple
pip install -r requirements.txt

# 2. 验证
python scripts/run.py --list          # 应输出 45 个插件
python scripts/run.py pdf-info '{"pdf_path": "某个.pdf"}'   # 应返回 page_count
```

> 若 PATH 被旧版本 Python 抢占，用完整路径调用：`D:\Python312\python.exe scripts/run.py ...`

## 使用（AI Agent 调用）

```bash
# 列出全部插件及参数
python scripts/run.py --list

# 调用插件：内联 JSON / 文件 / stdin
python scripts/run.py pdf-info '{"pdf_path": "C:/x.pdf"}'
python scripts/run.py pdf-merge params.json
echo '{"query": "年报"}' | python scripts/run.py local-search -
```

**输出协议**（stdout，JSON Lines）：取 `{"type":"result","data":{...}}` 为结果，`{"type":"error","msg":...}` 为失败。

**详细引导见 `SKILL.md`**（触发场景、45 插件清单、审计工作流、列映射）。

## 配置管理

需要 API Key / 凭据的插件（wwcai、web-search、webhook、mail、embedding、rag-document-parser、neeq）配置**集中存放于 `config/settings.json`**（已 gitignore 排除），用 `config.py` 轻量编辑、`run.py` 自动注入：

```bash
python scripts/config.py set wwcai.api_key sk-xxxx   # 设置（敏感值打码显示）
python scripts/config.py list
```

详细见 `references/config-guide.md`。

## 文档

| 文件 | 内容 |
| --- | --- |
| `SKILL.md` | 主引导词：触发场景、用法、插件清单、工作流、环境安装 |
| `references/MAPPING.md` | 表格列映射（宿主 Agent 手动映射）详细引导 |
| `references/momo-audit-guide.md` | MOMO 审计方法论（列映射规则、银行流水工作流、输出要求） |
| `references/config-guide.md` | 配置与凭据管理、插件更新同步 |
| `config/settings.example.json` | 配置模板（密钥留空，可安全分发） |
| `evals/evals.json` | 官方格式测试用例 |

## 更新

本技能包通过 **Gitee 仓库**发布：`https://gitee.com/wwwwwc/audit-cube-skill`。更新方式：

```bash
git pull origin main
```

## 安全说明

- 插件逻辑为 Nuitka 编译产物（.pyd），非明文；防普通用户翻看，但无法阻止有能力者反汇编（所有本地方案的物理上限）
- `config/settings.json` 含密钥，请勿提交/外发；分发时只发空模板 `settings.example.json`
- 联网类插件（web-search / web-fetch / 公告下载 / mail）会访问外部网络，注意数据合规