# 纷析云AI技能

**Repository Path**: flyemu/fxy-ai-skill

## Basic Information

- **Project Name**: 纷析云AI技能
- **Description**: No description available
- **Primary Language**: Unknown
- **License**: MIT
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 1
- **Created**: 2026-06-17
- **Last Updated**: 2026-08-20

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# 纷析云 AI 记账助手

用**说话的方式**打理账务：记凭证、看报表、查凭证、录发票、记出纳、结账结转，都可以交给 AI 助手完成。

本技能包教 AI 如何连接你的纷析云账套，**不会自动乱记账**——每次保存前都会先给你预览，你输入「y」才会真正写入。

## 你能做什么

| 你说的话（举例）            | AI 会帮你              |
|---------------------|---------------------|
| 收到客户货款 5890 元存入银行   | 生成凭证预览，确认后保存        |
| 应收账款挂「华为技术」（账套里还没有） | 先快速创建客户辅助核算，再记账     |
| 看一下 10 月的凭证         | 列出凭证清单              |
| 出一份 11 月利润表         | 查询并整理成表格            |
| 录入这张进项发票            | 填写发票信息（可附 PDF）      |
| 记一笔银行存款支出           | 创建出纳资金记录            |
| 结转 10 月损益 / 结 10 月账 | 期末检查 → 结转 → 结账（需确认） |
| 反结账到 9 月            | 从最近已结账月往前反结（需确认）    |
| 把账号下所有账套建成工作空间     | 每个账套一个子文件夹，预填好配置和期间目录   |
| 做一次税务风险体检           | 只读拉取发票与账簿数据，按金税四期口径输出风险清单（scripts/tax-risk-check.py） |

## 三步开始

### 第 1 步：在纷析云拿到「API 密钥」

1. 登录 [纷析云](https://f3.fenxi365.com/)
2. 打开 **个人设置 → API 密钥**
3. 生成密钥，复制以 `AK-` 开头的一串字符（只显示一次，请妥善保存）

### 第 2 步：把技能装到你的 AI 工具里

根据你用的软件，选一种方式（**详细图文见 [INSTALL.md](INSTALL.md)**）：

| 你用的工具            | 最简单做法                                |
|------------------|--------------------------------------|
| **OpenCode**     | 运行安装脚本，选 `opencode`                  |
| **WorkBuddy**    | 技能面板「上传技能」或放到 `~/.workbuddy/skills/` |
| **Codex**        | 运行安装脚本，选 `codex`，或在对话里说「安装纷析云记账技能」   |
| **DeepSeek CLI** | 把技能文件夹放到 `~/.agents/skills/`         |
| **Mimo**         | 在设置里添加自定义技能，或放入 `~/.agents/skills/`  |
| **SkillHub**     | 打开 [skillhub.cn/skills/fxy-voucher-natural-language](https://skillhub.cn/skills/fxy-voucher-natural-language) 一键添加 |

**一键安装（Mac / Linux 终端）：**

```bash
# 方式 1：下载后安装（推荐，安全性最高：本地留有完整源码可审计）
git clone https://gitee.com/flyemu/fxy-ai-skill.git
cd fxy-ai-skill
bash install.sh --tool all

# 方式 2：一条命令安装（curl 管道执行，请先校验脚本完整性）
curl -fsSL -o /tmp/fxy-install.sh https://gitee.com/flyemu/fxy-ai-skill/raw/master/install.sh
shasum -a 256 /tmp/fxy-install.sh   # 与 Gitee 对应版本 Release 说明中公布的 SHA256 比对
bash /tmp/fxy-install.sh --tool all
```

> 🔒 **安全提示：** 技能通过 `config.txt` 中的 `baseUrl` 连接纷析云。官方地址固定为
> `https://f3.fenxi365.com/api`，请勿改为任何第三方地址（私有化部署除外，脚本会要求显式确认）。
> 你的 API 密钥只会发送到该地址。

技能包地址：

- Gitee 仓库：[https://gitee.com/flyemu/fxy-ai-skill](https://gitee.com/flyemu/fxy-ai-skill)
- SkillHub 在线安装：[https://skillhub.cn/skills/fxy-voucher-natural-language](https://skillhub.cn/skills/fxy-voucher-natural-language)

不确定用哪种？执行 `--tool all` 会装到常见工具的默认目录，装好后在你要用的那个软件里对话即可。

### 第 3 步：填写连接信息

在**你平时放工作文件的文件夹**里，新建一个名叫 `config.txt` 的文本文件，写入：

```ini
baseUrl=https://f3.fenxi365.com/api
AK=AK-这里粘贴你的密钥
accountSetId=
```

- `accountSetId` 可以先留空，第一次使用时 AI 会让你选账套
- **不要把 config.txt 发给别人**，里面是你的密钥

## 开始对话

打开你的 AI 工具，用**大白话**说需求即可，例如：

- 「帮我记一笔：收到货款 5890 元」
- 「查一下这个月的利润表」
- 「列出 10 月的记字凭证」
- 「结转本月损益」
- 「这个月可以结账吗」

如果 AI 助手支持选择技能，请选中 **纷析云记账** / **fxy-voucher-natural-language**。

保存凭证、删凭证、录发票、创建辅助核算、结账、反结账等操作前，AI 会先展示预览或说明，你回复 **y** 才会执行。

## 常见问题

**连不上 / 提示 IP 不在白名单**  
在纷析云「API 密钥」里关闭 IP 白名单，或把你电脑的公网 IP 加进去。

**提示没有权限**  
你在该账套里的角色可能没有记账权限，请联系账套管理员。

**凭证保存失败：期间已结账**  
把凭证日期改到当前未结账的月份。

更多问题见 [INSTALL.md](INSTALL.md#常见问题)。

## 文件说明（给需要的人）

| 文件                       | 作用                  |
|--------------------------|---------------------|
| [INSTALL.md](INSTALL.md) | **安装与使用完整教程**（推荐先看） |
| SKILL.md                 | AI 读的操作说明（一般不用你改）   |
| config.txt.example       | 配置文件模板              |

开发者发布说明见 [DEVELOPERS.md](DEVELOPERS.md)。

## 许可

[MIT](LICENSE)