一、为什么企业一定要走本地部署这条路
先说结论：只要你的公司在处理客户数据、源代码、财务信息，AI 工具的本地部署就不是"可选项"，是"必然选项"。
原因分三层：
① 数据主权。数据、文件、API Key 全在本地，默认只监听127.0.0.1。这是金融、制造、国央企行业过合规的前提。
② 成本可控。云端 AI 按 token 计费是浮动支出，没法做预算；本地部署 + 自有模型是固定投入。
③ 能力沉淀。员工摸索出的工作流是公司资产。留在云端平台账号里，人走了就散了。
对一个技术负责人来说，还有第四个理由：可维护、可审计、可二次开发。黑盒 SaaS 你只能等供应商排期。
二、选型：自研 vs 采购 vs 开源底座
我按这三个选项做过对比，结论很明确。
| 方案 | 前期投入 | 可定制性 | 数据边界 | 风险 |
|---|---|---|---|---|
| 完全自研 | 3–5 人 × 半年 | 100% | 完全自主 | 做出来了没人长期维护，烂尾率高 |
| 商业 SaaS | 低 | 低（黑盒） | 数据在厂商 | 被锁死，涨价没办法 |
| 开源底座二次开发 | 1–2 人 × 数周 | 高（扩展点开放） | 完全自主 | 需搞定授权合规 |
自研最贵的地方不是开发成本，是维护成本。Agent 不是一个"做完就完了"的产品——模型更新要适配、工具报错要兜底、提示词要迭代。你搭起来的不是系统，是一个要长期养的活物。
我的建议：找能满足 80% 需求的底座，自己做剩下 20%。
三、为什么选 OpenWorkBuddy 当底座
3.1 基础件齐全
评估一个 Agent 底座，先看它有没有替你把"不产生业务价值但必须做"的部分做完：
- Agent 主循环（规划 → 工具调用 → 观察 → 继续）
- 工具调用框架
- 文件验收机制（说写了文件，磁盘上必须有）
- 记忆系统
- 权限控制
- 审计日志
- 多模型路由
- 会话持久化 / 断点续跑 / 并发任务
这些它都有，而且是在一个仓库里全摊开的：
text
server.js → agent.js → 模型路由 / 能力层 / 工作区 / Trace想搞懂 Agent 主循环怎么转，从这两个文件进去就行。
3.2 技术栈对二次开发友好
Node.js 18+，零构建。
bash
git clone https://github.com/CatCatUncle/openworkbuddy.git cd openworkbuddy && npm install npm run app # 桌面版 # 或 npm start # → http://localhost:3800没有复杂的编译链、没有构建等待、没有沉重的工程配置。改完存盘就见效——对"抽两个人做二次开发"这种规模的团队，这一条能省掉大量前期成本。
3.3 四个明确的扩展点
这是它最值钱的设计。
| 扩展点 | 位置 | 用途 | 门槛 |
|---|---|---|---|
| Skills | skills/<名字>/skill.md | 加业务能力 | 会写文档即可 |
| MCP | 标准协议 | 接外部工具/数据源 | 懂协议 |
| Plugins | 插件目录 | 改 Agent 行为 | 需写代码 |
| Engines | openworkbuddy engines | 换执行引擎 | 一条命令 |
四、部署全流程
4.1 本机试跑（先评估再上内网）
bash
git clone https://github.com/CatCatUncle/openworkbuddy.git cd openworkbuddy && npm install npm run app # 桌面版 npm start # 或 → http://localhost:3800填一个模型 Key 即可。数据落在~/OpenWorkBuddy，卸载不删。
模型可选（界面「设置 → 模型」点一下切换，BYOK）：
text
OpenAI / Anthropic / OpenRouter / DeepSeek / 通义 / 智谱 / Kimi / 火山方舟 / Ollama（本地模型）如果要做完全离线的内网部署，走 Ollama 这一路。
生图、配音、生视频的模型另有一张配置表。
⚠️ Key 只存在
config.json，已在.gitignore里。别手滑提交。
4.2 服务器部署（团队用）
bash
git clone https://github.com/CatCatUncle/openworkbuddy.git cd openworkbuddy bash deploy.sh --domain buddy.example.com # Docker + 自动 HTTPS关键提醒：起来之后先注册管理员——第一个注册的账号自动成为超管。
配套文档：
docs/部署.md—— 服务器 / Docker / 反代deploy/README.md—— 运维手册docs/多人协作.md—— 多租户、账号、权限、额度
4.3 内网/无公网场景
几个要点：
- 模型走 Ollama，本地加载，不出网
- 默认监听
127.0.0.1，需要局域网访问时改监听地址，但不要直接暴露公网 - URL 白名单：限制 Agent 能访问的域名（无公网场景可以直接全禁）
- 文件黑名单：把密钥目录、财务数据目录加进去
- 权限档：按部门给不同的权限档位
4.4 关键配置：企业管控
部署完之后，这些是企业必须配的：
- 席位：给谁开账号
- 额度：每个员工的用量上限——防止单人烧光部门预算
- 权限回收：离职一键收权限
- 审计：运行记录，每趟调了哪些工具、为什么这么说，都能点开看
五、实测：几个典型场景
5.1 软著材料一键生成
挂上软著技能，把代码仓库作为输入，产出：
- 程序鉴别材料
- 文档鉴别材料（说明书）
- 在线表单所需字段文本
软著代理费市场价几千到上万，而流程本身高度标准化。
5.2 AI 短剧无限画布
剧本、角色、场景、分镜、参考图、视频、配音、时间线摆在同一张图上。
关键设计：连线表示生成关系，改哪个镜头只有那个镜头重跑。
画布交互：
text
空白处拖拽 → 平移 Shift + 拖拽 → 框选 Shift / ⌘ + 点击 → 加减选 底部输入框 @ → 引用任意节点和素材对短剧工作室，这一条直接省掉"改一处、重算一季"的成本。
5.3 音视频分离
给一个视频链接，分离人声与背景音乐。作者实测用DeepSeek模型，耗时约为 Codex 方案的一半。
5.4 定时任务 + IM 推送
每天早上抓行业新闻做晨报，推到飞书 / 企微 / 钉钉。人不在电脑前也照跑，错过了会补跑。
配置入口：「自动化」，运行记录可查每趟的工具调用。
六、命令行（适合做自动化和集成）
CLI 与桌面版共用同一份配置、技能、记忆、连接器和会话：
bash
npm link # 一次性：装成全局命令 openworkbuddy "帮我写一份本周周报" # 单发：跑完就退 openworkbuddy # 交互 cat error.log | openworkbuddy "这是什么问题" # 管道 openworkbuddy -q "生成本周周报" > 周报.md # 静默：只出结果 openworkbuddy engines use claude-code # 换执行引擎 openworkbuddy doctor # 环境自检 openworkbuddy sessions / resume # 会话管理 openworkbuddy pair # 扫码把手机连上来退出码语义（可直接用于 CI / 脚本）：
text
0 成功 1 任务失败 2 参数写错 130 Ctrl+C单发和管道模式不会反问，脚本和 cron 里不会卡住。
七、二次开发上手
7.1 加一个业务技能（最低门槛）
text
skills/ └── 客户提案生成/ └── skill.md存盘后下一条任务就生效——不改代码、不重启、不打包。
这一步不需要会编程。业务专家自己就能沉淀能力：财务写审核规则、销售写跟进话术、法务写合同检查点。
7.2 接内部系统（MCP）
走标准 MCP 协议，把 ERP / CRM / 工单系统接进来，让 Agent 能读内部数据、写内部记录。
7.3 换执行引擎
bash
openworkbuddy engines use claude-code本机装了 Claude Code / Codex 的，可以拿它当发动机，跑在已付费订阅上，不额外烧 API 额度。
八、安全清单（上线前必查）
这个 Agent 手里有 shell，能跑命令、读写文件、上网。上线前逐条核对：
- [ ] 命令审批开了吗？（危险命令要人工确认）
- [ ] 文件黑名单配了吗？（密钥、财务目录）
- [ ] URL 白名单配了吗？
- [ ] 权限档设对了吗？（按部门最小权限）
- [ ] 审计日志能查吗？
- [ ] 装第三方技能前做静态体检了吗？
- [ ] 是否默认只听
127.0.0.1？ - [ ] 放公网的是否读过
docs/安全.md？
官方明确说明：默认配置只为本机调试设计。放公网前务必先读安全文档。
它还提供了姊妹项目toolward——给 Agent 用的技能/MCP 连接器静态安检，37 条规则分六族，零运行时依赖。npm i -g toolward装上，OpenWorkBuddy 自动把它当第二把尺子。
九、授权：商用之前必须确认的事
协议是 PolyForm Noncommercial 1.0.0：
text
个人使用 → 免费 学习使用 → 免费 非营利使用 → 免费 公司内部使用 → 需要商业授权有一个细节值得说清楚：买授权不解锁功能，代码只有这一份。
也就是说，未授权版本和授权版本功能完全一样——差别只在"合不合规"。
这个表态反而说明作者是认真做长期生意的：不靠功能阉割逼单，靠合法性和服务。
需要商业授权、企业私有化部署、二次开发合作、FDE（驻场工程）：
text
contact@aijentra.com作者背景：常驻深圳，前大厂 Agent 工程师，服务过跨境电商、制造业、AI 初创、私募金融机构、消费品巨头、国央企等客户。
业务范围：企业 AI 内训 / 企业私有化部署 / 行业智能体 / AI 数字化全案 / AI 搜索优化 / Agent 项目落地。
写邮件时把行业、规模、要解决的问题、是否二次开发、数据安全要求写清楚，能直接拿到方案。
十、总结
企业本地部署 Agent 系统，OpenWorkBuddy 是我目前评估下来完成度最高的开源选项。
理由收敛成五条：
- 交付物可验收——文件真落盘，说写了没写会被当场拦下
- 企业后台完整——多租户、席位、额度、离职收权限
- 扩展成本极低——加能力就是加一个 Markdown 文件
- 技术栈友好——Node.js，零构建，改完存盘见效
- 维护节奏稳定——2026 年 8 月建仓至今几乎每天提交
本地部署的 Agent 软件 + 本地部署的模型，是注重数据安全的企业绕不开的方向。
以前这个方向要么自己从零搭，要么忍数据风险。现在有一个完成度够高的开源底座了。
基于它做二次开发，同样是目前性价比最高的路径。
项目地址：https://github.com/CatCatUncle/openworkbuddy
商业授权：contact@aijentra.com