内容
<div align="center">
> **2026-09-09 源码同步 · 2.6.0（公开仓库）**：新增 [AI 精确复刻指南](docs/REPRODUCE.md)、[总提示词](docs/reproduce/MASTER_PROMPT.md)、[25 套完整工作流](docs/reproduce/WORKFLOWS.md) 和 [离线一键复制页面](docs/reproduce/index.html)（下载后双击打开）。复刻包包含源码上下文与 SHA-256 清单；保留原界面源码和锁文件，避免仅凭文字重新设计。
# AI智能体财务工作台
**把收入、往来、报销、资金、核算、税务、报表和经营分析，整理成可执行、可复核、可留痕的标准流程。界面采用现代雾光背景、清晰信息层级和克制卡片体系，提供 4 套专业主题；正文、表单和按钮按长时间办公重新放大，适合财务人员持续录入与复核，兼顾使用财务自动化的新手。**
[](https://github.com/feng-liu-1994/workbuddy-finance-workbench/actions/workflows/ci.yml)
[](https://github.com/feng-liu-1994/workbuddy-finance-workbench/releases/latest)
[](https://www.codebuddy.cn/docs/cli/mcp-apps)
[](LICENSE)
[一键安装](#30-秒安装) · [25 份提示词](#25-份可直接复制的提示词) · [功能说明](#不是一张看板而是一套财务闭环) · [使用边界](#数据与专业边界) · [开发文档](#开发与验证)
<img src="docs/images/readme-hero.png" width="1080" alt="WorkBuddy 财务工作台桌面总览">
</div>
这是一个面向财务人员和财务 FDE 场景的开源工作台。它不是只有提示词的 Skill：在 **WorkBuddy 中可直接打开完整交互界面**，在 **DeepSeek Harness 中可作为原生侧栏应用运行**，也保留通用 Agent Skill 供 Codex、Claude Code 等工具读取。
界面采用克制的雾光层次与高可读字号，不使用夸张高光、塑料质感或密集小字。内置 20 个工作模块、25 个统一编号的 AI 工作流、25 份可查看与复制的完整提示词、异常责任闭环、月结证据控制、经营快照、资料索引和本机备份。
## 先选对安装方式
| 使用环境 | 得到什么 | 推荐入口 |
|---|---|---|
| **WorkBuddy** | 完整图形工作台 + 25 个工作流 + Skill | [一键安装完整应用](docs/INSTALL_WORKBUDDY.md) |
| **DeepSeek Harness** | 左侧导航中的原生完整工作台 | [安装 DSH 插件](docs/INSTALL_DSH.md) |
| **Codex / Claude Code / 其他 Agent** | 财务规则、工作流与验收清单；不含图形界面 | [安装通用 Skill](docs/INSTALL_AGENT.md) |
> 三种方式共用同一套财务口径和工作流。图形界面的承载方式不同：WorkBuddy 使用 MCP App Widget，DeepSeek Harness 使用原生 UI 插件，其他 Agent 使用 Markdown/JSON Skill。
## 30 秒安装
### macOS：WorkBuddy 完整版
1. 下载 [WorkBuddy macOS 安装包](https://github.com/feng-liu-1994/workbuddy-finance-workbench/releases/latest/download/workbuddy-finance-workbench-macos.zip)。
2. 解压，双击 **`安装 WorkBuddy 财务工作台.command`**。
3. 保存 WorkBuddy 中正在编辑的内容，完全退出后重新打开。
4. 在 WorkBuddy 输入：**`打开财务工作台`**。
安装器会先备份已有 Skill 与 `.mcp.json`，只新增 `finance-workbench` 配置项；不会读取财务文件、API Key，也不会强制重启 WorkBuddy。首次安装前需要 [Node.js 20+](https://nodejs.org/zh-cn/download)。
### Windows：WorkBuddy 完整版
下载 [WorkBuddy Windows 安装包](https://github.com/feng-liu-1994/workbuddy-finance-workbench/releases/latest/download/workbuddy-finance-workbench-windows.zip)，解压后在目录中打开 PowerShell：
```powershell
powershell -ExecutionPolicy Bypass -File .\scripts\install-workbuddy-app.ps1
```
### 从源码安装
```bash
git clone https://github.com/feng-liu-1994/workbuddy-finance-workbench.git
cd workbuddy-finance-workbench
./scripts/install-workbuddy-app.sh
```
完整安装、更新、卸载和排障步骤见 [WorkBuddy 新手安装指南](docs/INSTALL_WORKBUDDY.md)。
## 25 份可直接复制的提示词
25 个工作流已统一编号为 01–25，每个都有独立提示词，不需要先学习“提示词工程”：
- 在 WorkBuddy / DeepSeek Harness 工作台中：打开“工作流”，选择场景，可查看或复制完整提示词。
- 在 Codex、Claude Code 或其他 AI 工具中：打开 [25 份提示词目录](agents/finance-workbench/references/prompts/README.md)，复制对应文件的全部内容。
- 不清楚主体、期间或口径时可留空；AI 会先识别现有文件，再一次列出真正必需的缺项。
每份提示词都包含：新手填写区、所需资料、字段与口径预览、小样本试跑、异常边界、固定输出、金额/行数校验、人工复核和完成回报。
## 不是一张看板，而是一套财务闭环
| 工作层级 | 模块 | 解决的问题 |
|---|---|---|
| 经营与往来 | 收入、应收、应付、报销、资金、预算 | 业务确认、账龄、付款排期、13 周资金预测与预算偏差 |
| 核算与合规 | 资产、税务、发票、工资、对账、成本 | 台账勾稽、期间截止、重复识别、证据链与分摊复核 |
| 报告与决策 | 报表、分析、投资 | 报表勾稽、差异归因、管理摘要、情景测算与投后跟踪 |
| 治理与系统 | 异常、审计、备份、设置 | 责任到人、期限跟踪、处置证据、本机留痕与口径治理 |
每个业务模块都给出责任岗位、建议频率、第一步、关键控制、固定交付物和推荐工作流。每个 AI 工作流都包含输入、字段口径、处理规则、7 步执行路径、交付成果、验收清单和人工复核点。
<table>
<tr>
<td width="50%"><img src="docs/images/exception-control.png" alt="异常控制台"><br><sub><b>异常控制台</b>：风险、金额、责任人、期限、来源与处置证据</sub></td>
<td width="50%"><img src="docs/images/theme-night.png" alt="深色主题"><br><sub><b>4 套专业主题</b>：雾光靛蓝、松石墨绿、暖砂棕金、夜航深色</sub></td>
</tr>
</table>
### 财务控制不是“发现异常”就结束
异常控制台会按风险等级、金额影响和逾期状态排序。没有处置证据的事项不能关闭；任何异常都可以转成待办或导出 CSV。经营快照、待办、月结、异常、收藏、字段字典和审计日志可以整体导出为 JSON 备份。
### 新手第一次使用
1. 在“系统设置”选择主题，填写主体、期间和重要性阈值。
2. 在“财务总览”录入本期汇总数，先看经营快照与今日节奏。
3. 用仓库中的[虚构演示数据](examples/demo/README.md)打开一个工作流试跑。
4. 先确认字段映射、口径、异常规则和预期输出，再处理 20–50 行样本。
5. 人工复核后再处理全量；取得底稿、凭证号或业务确认后关闭异常。
## WorkBuddy 完整版如何工作
安装包同时部署两部分：
- `MCP App`：在 WorkBuddy 对话中打开全屏交互工作台；工作流按钮会把结构化任务填入输入框，发送前由你核对附件。
- `finance-workbench Skill`：为 WorkBuddy 提供财务规则、执行边界和 25 个标准场景。
Widget 资源完全本地打包，不依赖 CDN。MCP App 采用 WorkBuddy 官方的 `text/html;profile=mcp-app` 资源协议；终端型客户端会自然降级为文字结果。
## 数据与专业边界
- 仓库只包含虚构演示数据，不包含真实发票、流水、身份信息、密码、Cookie、Token 或 API Key。
- 经营快照、待办、异常、字段字典和设置默认保存在当前应用的浏览器本机存储中。
- Widget 中选择文件只建立当前会话索引；执行工作流前仍需在 WorkBuddy 输入框确认并添加原始附件。
- JSON 备份不包含原始财务文件；更新与卸载脚本保留带时间戳的配置副本。
- AI/OCR 结果不能直接替代入账、付款、纳税申报、薪资发放或重大专业判断的人工复核。
详见 [安全政策](SECURITY.md)。
## 项目结构
```text
workbuddy/ 已构建的 WorkBuddy MCP App
agents/finance-workbench/ 通用财务 Agent Skill
src/ WorkBuddy / DSH 共用界面与业务源码
scripts/ 安装、卸载、构建、脱敏与发布验证
docs/ 图文安装、排障与版本说明
examples/demo/ 完全虚构的练习数据
test/ 单元、协议与发布完整性测试
```
## 开发与验证
要求 Node.js 20+：
```bash
npm ci
npm run verify:release
```
发布校验覆盖：20 个导航模块、25 个工作流、异常关闭门槛、目录穿越防护、备份格式、WorkBuddy MCP 协议、256 KB Widget 上限、隔离目录安装/卸载、公开文件脱敏扫描、生产构建和 npm 发布清单。
## 文档
- [WorkBuddy 完整应用安装](docs/INSTALL_WORKBUDDY.md)
- [DeepSeek Harness 完整界面安装](docs/INSTALL_DSH.md)
- [Codex / Claude / 通用 Agent Skill](docs/INSTALL_AGENT.md)
- [常见问题与排障](docs/TROUBLESHOOTING.md)
- [更新记录](CHANGELOG.md)
- [参与贡献](CONTRIBUTING.md)
## 开源许可
代码采用 [MIT License](LICENSE)。欢迎提交 Issue 和 Pull Request；财务处理结果请由具备权限和专业判断能力的人员复核。
## 联系方式
欢迎扫码添加微信：weihuiaccounting，注明来意进一步交流学习
<img src="docs/images/筱亭微信.jpg" width="540" alt="欢迎交流，共同进步">
MCP 市场