Accio Work Export KB Suite V4

面向 Accio Work 外贸场景的证据优先、租户隔离、可审计知识库套件。它把 00–20 企业知识模块装配成业务转化、运营、管理、采购、财务、单证、人事行政和新媒体 8 个端口的 30 个可治理场景，并提供便携 Skills、stdio MCP、Cloud API、OpenCode Plugin 与 Web Portal。

独立适配声明：本项目由人人易 AI 维护，不代表 Accio、Alibaba.com 或其关联方的官方产品、合作或认证。Accio Work 客户端的实际导入入口、连接器和权限以当前版本为准；仓库只对自身代码、Schema 和测试结果负责。

V4 的首要升级不是增加“神奇功能”，而是删除虚假能力：没有实时提供商就返回 unavailable；没有来源就不当企业事实；没有审批就不对外承诺。

系统组成

Related MCP server: mcp-gatehouse

Accio Work 使用场景

机器可读目录位于 knowledge-base/accio-work-use-cases.json。没有配置所需连接器时，场景必须返回 unavailable 或停留在草稿状态。

安全边界

• 租户 ID 来自 API Key 或 MCP 进程环境，不接受模型在请求中指定。

• 所有冷启动卡默认 public_claim_approved=false。

• 退订、黑名单、营销许可、欠款和严重纠纷优先于评分。

• 海关、CRM、官网采集、运费关税与汇率未配置真实提供商时返回 HTTP 501。

• 邮箱工具只做语法检查，明确不代表 MX、SMTP、邮箱所有权或决策人身份已验证。

• 真实企业资料、客户、订单、报价、凭据和日志放在 data/ 或外部数据库，禁止提交 Git。

• 当前开源版持久层是 ephemeral_memory，用于安全验证和二次开发；生产多实例部署需接 PostgreSQL/RLS、对象存储、OIDC 与密钥管理。

5 分钟启动

需要 Node.js 20–24 或 Docker。

git clone https://github.com/cnproduct/accio-work-export-kb-suite.git
cd accio-work-export-kb-suite
npm ci
npm run verify
cp .env.example .env
# 修改 .env 中的演示密钥
docker compose up --build

打开 http://localhost:8080，输入 .env 中 API Key。健康检查：

curl http://localhost:8080/health/ready

生成企业知识库骨架

npm run bootstrap:kb -- \
  --tenant acme-export \
  --company "Acme Export Ltd" \
  --out data/acme-export

结果包含 21 个模块、30 个 Accio Work 使用场景、AI 岗位分工与审批矩阵、分阶段上线验收表，全部处于待补充/待核验状态，不会把模板冒充企业事实。

Cloud API

API 使用 Bearer Key。格式：

ACCIO_WORK_API_KEYS=long-secret-key:tenant-id:admin|sales,another-key:tenant-b:admin

示例：

curl -X POST http://localhost:8080/api/v1/kb/cold-start \
  -H "Authorization: Bearer $ACCIO_WORK_EXPORT_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"company_name":"Acme Export","website_url":"https://example.com","profile_summary":"User supplied profile"}'

详见 docs/API_SPEC.md 与运行时 /openapi.json。

MCP 配置

先构建，再把租户固定在进程环境：

npm run build:mcp
ACCIO_WORK_TENANT_ID=acme-export npm run start:mcp

仓库自带 opencode.json 作为可运行参考。本地 stdio MCP 不暴露租户切换参数；将其接入 Accio Work 前，应先核对当前客户端是否支持自定义 Skill/MCP 以及具体授权范围，不能把仓库存在视为已完成客户端安装。

Plugin 与 Skills

• OpenCode Plugin：.opencode/plugins/accio-work-export-growth.ts

• V4 总控 Skill：.opencode/skills/accio-work-ai-export-growth-system/SKILL.md

• 专项 Skills：skills/*/SKILL.md

Plugin 需要：

export ACCIO_WORK_EXPORT_API_URL=http://localhost:8080
export ACCIO_WORK_EXPORT_API_KEY='your-private-key'

不要把 Key 写入 opencode.json、Skill 或任何 Git 文件。

GitHub 交付

• main 推送自动执行 build、测试、元数据校验、知识库生成烟测与 Docker build。

• 镜像自动发布到 ghcr.io/cnproduct/accio-work-export-kb-suite:latest。

• Portal 通过 GitHub Pages 工作流发布；Pages 只承载静态界面，不承载 API、数据库或秘密。

验证

npm run verify
node --check portal/app.js
docker build -t accio-work-export-growth:local .

测试重点覆盖：租户隔离、默认公开闸门关闭、营销许可硬停止、负数报价拒绝、未配置连接器诚实失败、邮箱不伪验真、35 例基准不伪造通过率。

路线图

1. PostgreSQL + RLS + pgvector + 对象存储持久层。

2. OIDC/OAuth 2.1 与远程 Streamable HTTP MCP。

3. 按企业授权接入 OKKI/CRM、邮箱、订单和持牌海关/贸易数据。

4. 审批流、事件队列、审计日志、备份恢复与 9 万客户压力测试。

5. 按实际赢单、复购、回款和投诉校准评分，不允许模型自动改规则。

文档

• docs/ARCHITECTURE.md：架构、安全和生产化边界

• docs/API_SPEC.md：API 与错误合同

• knowledge-base/README.md：知识库生成与数据规范

• knowledge-base/accio-work-use-cases.json：8 个端口、30 个 Accio Work 场景目录

• docs/AI_AGENT_OPERATING_MODEL.md：四类人机分工、统一业务闭环与分阶段上线闸门

• DESIGN.md：Portal 设计系统与无障碍标准

• OpenWork 概念参考：start-here/do-work-with-it/skills-plugins-and-mcp.mdx、start-here/connect-your-stack/add-an-mcp-server.mdx

MIT License © 2026 人人易 AI