🏦 BankAI · 银行公文写作助手

一句话需求 → 59 种"银行味"公文底稿。 严格遵循《党政机关公文格式》GB/T 9704-2012，内置反编造护栏，复制即可改、审核后可用。

BankAI 把你的口语化需求，按 59 种银行公文文种之一，调用 DeepSeek 生成一份纯文本、格式合规、零编造的底稿。它不替你拍板，只帮你把"从空白到初稿"这一步从半小时压到一分钟。

✨ 核心能力

59 种银行公文全覆盖——监管回复、分析研判、规章制度、行政公文、汇报总结、自定义，六大类。
"银行味"国标格式——强制中文全角标点、禁用 Markdown、套用 GB/T 9704-2012 公文结构，交上去不像 AI 写的。
反编造护栏（硬铁律）——输入未给的任何数字、金额、人名、文号、日期，一律写成 XX 占位，文末附"需人工核实"清单。绝不发生"看起来很真其实是编的"数据。
双入口——命令行（CI / 批处理友好）或直接对话触发。
数据不出域——你自备 DeepSeek Key，调用在你本地或你指定的端点完成。

🔑 使用前提

⚠️ 你必须自备 DeepSeek API Key。 BankAI 不在云端代付，不收集你的任何数据，也不替你承担任何 API 费用——你用你自己的 Key 直连 DeepSeek。

没有 Key 时，可用 --mock 参数预览输出结构（不真实调用模型）。

⚙️ 环境变量配置

只需一步，把 Key 交给运行环境：

# Linux / macOS
export DEEPSEEK_API_KEY="sk-your-real-key-here"

# Windows (PowerShell)
$env:DEEPSEEK_API_KEY="sk-your-real-key-here"

备用方案：运行时用 --key-env 指定其他环境变量名（默认即 DEEPSEEK_API_KEY）。

私有化部署（数据不出行）： 用 --base-url 指向你内网 / 自建的 OpenAI 兼容端点，或改 config.json 的 baseUrl：

node scripts/bankai_write.mjs --type 通知 --input @req.json --base-url https://your-intranet-endpoint/v1/chat/completions

🖥️ 方式一：命令行（CLI）

# 列出全部 59 种文种（含 id / 分类 / 名称）
node scripts/bankai_write.mjs --list

# 生成一篇公文：--type 接文种 id 或中文名称，--input 接 JSON 或 @文件
node scripts/bankai_write.mjs --type 贷后检查报告 --input '{"借款人":"XX科技有限公司","授信额度":"XX万元","检查周期":"2026年Q2"}'

# 结果写入文件（不写则打印到终端）
node scripts/bankai_write.mjs --type 请示 --input @req.json --output 请示_草稿.txt

# 预览结构（不真实调用，免 Key）
node scripts/bankai_write.mjs --type 通知 --input '{}' --mock

常用参数：

参数	说明	必填
`--type`	文种 id 或中文名称（如 `贷后检查报告`）	✅
`--input`	JSON 字符串，或 `@文件路径`（字段键值对）	✅
`--output`	输出文件路径（缺省打印到终端）	❌
`--base-url`	自建 / 私有化端点（合规内网部署）	❌
`--model`	模型名（默认 `deepseek-chat`）	❌
`--key-env`	API Key 所在环境变量名（默认 `DEEPSEEK_API_KEY`）	❌
`--mock`	用假数据预览输出结构，不调模型	❌
`--list`	列出全部 59 种文种	—

💬 方式二：对话触发

在装载了 BankAI 的助手（如 WorkBuddy / OpenClaw）里，直接用自然语言说：

"帮我写一份关于XX支行二季度不良率上升的情况说明" "出个请示，关于申请增加柜面人员的" "写一份贷后检查报告，借款人XX科技"

Skill 会：① 识别文种 → ② 追问缺失的必填字段 → ③ 生成纯文本底稿并附"需人工核实"清单。

📋 使用示例

示例 1 · 监管报送（CLI）

node scripts/bankai_write.mjs \
  --type 情况说明 \
  --input '{"事项":"XX支行二季度不良率上升至XX%","原因概述":"XX","已采取措施":"XX","后续安排":"XX"}'

→ 输出一份结构完整的监管情况说明底稿，缺失的量化指标以 XX 占位，文末列出需人工补实的数据。

示例 2 · 内部请示（CLI + 文件） 把需求写进 req.json：

{"事项":"申请增配2名柜面人员","理由":"网点日均客流XX、峰值排队XX分钟","编制现状":"现有XX人"}

node scripts/bankai_write.mjs --type 请示 --input @req.json --output 请示_草稿.txt

示例 3 · 对话生成

你说："写个通知，全行周五下午3点开季度风控会" BankAI：识别为「通知」文种，追问会议地点、主持人等必填项，补全后生成合规通知正文。

🗂️ 59 种公文类型（六大类）

完整字段定义与提示词见 references/scenarios.mjs（从线上源码提取，请勿手改）。运行 --list 可看全部 id。

监管回复（7）：情况说明、调查报告、监管指标专项说明报告、监管检查整改回复、陈述申辩函、重大事项即时上报、银行询证函回复
分析研判（11）：贷款贷后检查报告、风险分析报告、贷前调查报告、授信审批意见书、风险预警通知书、不良资产处置报告、合规审查意见书、财务分析报告、贷款五级分类认定、逾期催收通知书、产品说明书
规章制度（5）：管理办法、实施方案、突发事件应急预案、岗位说明书、合作框架协议
行政公文（20）：通知、函件、请示、通报、会议纪要、批复、意见、决定、公告、通告、工作计划、跨部门工作联系单、督办通知、合规承诺书、在职/收入证明、现金调拨申请、人事通知、客户投诉回复函、账户冻结告知函、贷款到期提醒函
汇报总结（15）：工作总结、工作报告、述职报告、竞聘报告、工作简报、倡议书、备忘录、营销活动方案、柜面账务差错说明、预算编制/执行分析、年末财务决算报告、资金头寸报告、税务测算及申报说明、绩效考核通报、培训计划/总结
自定义（1）：自定义公文

❓ 常见问题（FAQ）

Q1：DeepSeek API Key 在哪获取？ 到 DeepSeek 开放平台注册 → 充值 → 在「API Keys」页创建 Key（形如 sk-...）。Key 仅存于你本地环境变量，BankAI 不会上传。

Q2：提示"未找到公文类型"？ --type 必须填精确的文种 id 或中文名称（如 贷后检查报告），不支持模糊匹配（银行场景选错文种代价大，宁可报错）。先用 --list 查准确名称。

Q3：调用超时 / 一直转圈？ 默认 120 秒超时并自动重试 3 次（429 / 5xx）。若仍失败：检查 Key 是否有效、网络是否可达 api.deepseek.com、账户余额是否充足。

Q4：生成的数字靠谱吗？会不会编？ 不会编。反编造护栏强制：输入没给的具体数值一律 XX 占位，文末附"需人工核实"清单。所有 AI 生成内容都必须经人工审核后使用，禁止直接提交。

Q5：能部署到银行内网吗？ 能。用 --base-url 指向你内网自建的 OpenAI 兼容推理端点（如 Ollama / vLLM），数据全程不出域。详见 references/usage.md。

Q6：多少钱？ 模型费用由 DeepSeek 按量计收（你自己的账户），BankAI 本身免费。大致成本见 references/usage.md。

📮 联系与商业合作

🌐 官网：https://www.deepwater84.cn/bankai/
📧 邮箱：458468698@qq.com
💼 服务：企业私有化部署 / 专属文种定制 / 培训咨询

面向银行、消金、农商行的内网私有化部署与专属文种定制欢迎洽谈。

📄 许可证

MIT-0 —— 免费使用、修改、分发，无需署名，无担保。

Bankai Skill

安装到 Tokeny（自动）

SKILL.md