jnMetaCode/shellward

**AI 应用合规网关** — 为中国监管而生的 AI Agent 安全合规工具（网安法 2026 / PIPL / 等保2.0 / 数据出境 / AI标识）。先一行命令体检项目合规风险，再在运行时拦截提示注入、数据外泄与危险命令。中文威胁检测 + 中文 PII + 零依赖——英文工具不做的事。
**🌐 官网: https://jnmetacode.github.io/shellward/**
中文 | English
30 秒合规体检
零安装、只读、不上传任何数据。一行命令，扫出你的 AI 项目踩了哪些合规红线：
输出一张映射到 **网安法 / PIPL / 等保2.0 / 数据出境 / AI标识** 的红黄绿评分卡，并精确到 文件:行：
🆕 让你的 agent 做一次完整合规审计（Skill）
scan 是确定性扫描：它能告诉你「项目里有境外模型端点」，但判断不了**个人信息有没有真的流过去**；14 个法规控制项里也有 11 个它只能标「需人工确认」。这一段交给你的编码 agent 来做——Claude Code、Cursor、Codex 等支持 Agent Skills 的工具都能用。
把这句话粘贴给你的 agent：
或者用命令装：npx skills add jnMetaCode/shellward --skill china-ai-compliance-audit
它会先跑 shellward scan 拿确定性基线，再顺着数据流逐项取证，最后产出 .compliance/COMPLIANCE-REPORT.md。和「让 AI 随便看看合不合规」的区别在三道闸：
| | |
|---|---|
| **取证闸** | 每条发现必须带 文件:行 + 原文引用；校验脚本逐条打开文件核对，**引用对不上就不算数**（防幻觉） |
| **复核闸** | 每条「缺口」和「已满足」都要被一个没看过推理过程的独立 agent 尝试推翻一次；推翻的留档不删 |
| **诚实闸** | 仓库里找不到的事实（备案、PIA、日志实际保留天数）不许替你下结论，只许提出**一个人能直接回答的具体问题** |
另外：14 个控制项必须全部有结论，不许悄悄跳过；报告里不许出现完整密钥、手机号、身份证号——合规报告自己不能泄漏数据。
**示例**（演示项目 · 完整记录）：一个客服机器人，shellward scan 给 **75 分 [B]**、只报出「有 OpenAI 端点」；审计顺着调用链查到客户手机号和身份证号被拼进 system prompt 发往境外——**2 条严重、3 条高**，外加 6 个只有人能回答的问题（比如「审核是不是在网关侧做了」——仓库里看不到的事，它不替你下结论）。
> 这是技术自查材料，不是法律意见。备案、定级、PIA 等主体责任不能由工具代替。
**团队要对多个 AI 项目做合规自查、或想把它接进内部流程？** 邮件 jnMetaCode@qq.com，说一下团队规模和场景。
想在浏览器里看？npx shellward scan --open（扫完直接打开报告）或 --serve（本地 http://localhost 提供报告）——**数据全程不出本机**。
**Web 扫描器 / 客户端（双模式）**：
- shellward web — 公开仓库 web 扫描器：网页贴「公开仓库 URL」或用 /scan?repo=URL 链接体检（可部署，见 Dockerfile）。
- shellward web --local — 本地 web GUI（客户端体验）：填本地路径扫描，**私有代码不上传、不出本机**，无需命令行。
--json 供 CI · --ci 发现 critical 时让构建失败 · --html report.html 导出可打印成 PDF 的报告（备案/审计存档）· 也可作 GitHub Action 接入 PR 门禁。
> 检测重点：**境外大模型端点与 SDK 依赖（数据出境——中国独有、英文工具没有的概念）**、硬编码密钥、文件中的中文 PII、.env 暴露。扫到境外模型（如 openai 依赖）时，**直接给出境内合规替代**（通义千问 / DeepSeek / Kimi / 智谱）及其 OpenAI 兼容 base_url——多数迁移只需改一个 base_url。
境内合规替代表 （ src/rules/domestic-alternatives.ts ，报告里默认推荐前 4 个；欢迎 PR 补充，见 #3 ）
| 境内模型 | 厂商 | OpenAI 兼容 base_url |
|---|---|---|
| 通义千问 Qwen | 阿里云百炼/DashScope | https://dashscope.aliyuncs.com/compatible-mode/v1 |
| DeepSeek | 深度求索 | https://api.deepseek.com |
| Kimi | 月之暗面 | https://api.moonshot.cn/v1 |
| 智谱 GLM | 智谱 AI | https://open.bigmodel.cn/api/paas/v4 |
| 豆包 Doubao | 字节火山方舟 | https://ark.cn-beijing.volces.com/api/v3 |
| 文心一言 ERNIE | 百度千帆 | https://qianfan.baidubce.com/v2 |
| 腾讯混元 Hunyuan | 腾讯云 | https://api.hunyuan.cloud.tencent.com/v1 |
| MiniMax | 稀宇科技 | https://api.minimaxi.com/v1 |
| 讯飞星火 Spark | 科大讯飞 | https://spark-api-open.xf-yun.com/v1 |
| 阶跃星辰 Step | 阶跃星辰 | https://api.stepfun.com/v1 |
| 百川 Baichuan | 百川智能 | https://api.baichuan-ai.com/v1 |
| 零一万物 Yi | 零一万物 | https://api.lingyiwanwu.com/v1 |
base_url 为各厂商公开的 OpenAI 兼容端点，可能随官方调整，迁移前以官方文档为准。境外识别覆盖 OpenAI / Anthropic / Gemini / Azure / Bedrock / Cohere / Mistral / Groq / Together / Perplexity / OpenRouter / HuggingFace / xAI / Replicate / AI21 / Fireworks / DeepInfra / Cerebras / Voyage / NVIDIA NIM 的端点，以及 npm / pip / Go 的 SDK 依赖（含 LangChain、LlamaIndex、Vercel AI SDK 适配包），见 src/rules/overseas-llm.ts（#4）。
**想在浏览器里看报告？** 在项目目录跑 npx shellward scan --open —— 自动扫描并在浏览器打开报告，**无需上传、无弹框、数据不出本机**（最干净）。也可 npx shellward web --local 起本地图形界面（粘贴/点选路径，服务端直读）。
更多命令、运行时防护（MCP / 插件）、与英文文档见下方 English 章节。
---
English
**AI Agent Security & Compliance Gateway** — the AI agent security middleware built for **China's regulatory regime** (CSL / PIPL / MLPS 2.0 / cross-border data / AI labeling). Scan your project for compliance risks, then block prompt injection, data exfiltration, and dangerous commands at runtime. Chinese-language threat detection + Chinese PII + zero dependencies — things English tools don't do.
Quick start: npx shellward scan — zero install, read-only, nothing uploaded. Outputs a red/yellow/green scorecard mapped to Chinese regulations plus concrete file:line findings, and prescribes domestic compliant model alternatives for any overseas LLM it finds.
Agent skill: a full compliance audit, with receipts
scan is deterministic: it can tell you "this project calls an overseas LLM endpoint", but not **whether personal data actually flows to it** — and 11 of the 14 regulatory controls can only be marked "needs manual review". The china-ai-compliance-audit skill hands that part to your coding agent (Claude Code, Cursor, Codex, or anything that supports Agent Skills).
Paste this into your agent:
or npx skills add jnMetaCode/shellward --skill china-ai-compliance-audit.