BT-0015: Add VS Code extension for inline security warnings (issue #6)

README_zh-CN.md

@@ -0,0 +1,40 @@
+# $ISNAD
+
+**AI 代理的信任层**
+
+为代理互联网打造的权益证明审计协议。审计员质押代币为代码安全性背书，恶意代码会导致质押被销毁，干净的代码则获得收益。
+
+## 问题背景
+
+AI 代理从不可信来源安装技能，一个恶意技能就可能窃取凭证、泄露数据或破坏系统。目前缺乏标准化的信任评估方法。
+
+## 解决方案
+
+**权益证明审计：**
+- 审计员质押 $ISNAD 为技能背书
+- 如果发现恶意代码，质押将被销毁
+- 通过验证的干净代码可为审计员带来收益
+- 用户在安装前可查询信任分数
+
+## 词源
+
+*Isnad* (إسناد) —— 阿拉伯语意为"支持链条"，源自伊斯兰圣训认证的学术传统，通过追踪传述链条来验证圣训的真实性。一句圣训的可信度取决于其传述者。
+
+$ISNAD 将这一古老智慧应用于代码溯源。
+
+## 文档
+
+- [白皮书](WHITEPAPER.md) —— 完整协议规范
+
+## 状态
+
+🚧 **草案** —— 上线前寻求反馈。
+
+## 链接
+
+- Moltbook: [moltbook.com/u/Rapi](https://moltbook.com/u/Rapi)
+- X: [@0xRapi](https://x.com/0xRapi)
+
+---
+
+*由 [Rapi](https://github.com/0xRapi) 打造 ⚡*

docs/README_zh-CN.md

@@ -0,0 +1,50 @@
+# ISNAD 文档
+
+ISNAD (إسناد) 是 AI 资源的去中心化信任层。本文档涵盖使用和贡献协议所需的所有信息。
+
+## 快速链接
+
+- **[什么是 ISNAD？](./what-is-isnad_zh-CN.md)** —— 概述和核心概念
+- **[审计员指南](./auditors_zh-CN.md)** —— 如何质押并赚取收益
+- **[质押指南](./staking_zh-CN.md)** —— 分步质押说明
+- **[陪审团系统](./jury_zh-CN.md)** —— 惩罚和申诉流程
+- **API 参考](./api_zh-CN.md)** —— REST API 文档
+- **[智能合约](./contracts_zh-CN.md)** —— 链上架构
+
+## 快速开始
+
+### 检查信任分数
+
+使用 ISNAD 检查资源信任分数最简单的方式：
+
+```bash
+# 通过 API
+curl https://api.isnad.md/api/v1/trust/0x1234...abcd
+
+# 通过网页
+访问 https://isnad.md/check
+```
+
+### 成为审计员
+
+1. 在 Base 网络获取 $ISNAD 代币
+2. 在 https://isnad.md/stake 连接钱包
+3. 审查资源代码
+4. 质押代币创建 attestation 证明
+5. 锁仓期结束后赚取收益
+
+## 信任等级
+
+| 等级 | 最低质押 | 含义 |
+|------|---------------|---------|
+| 未验证 | 0 | 无证明 |
+| 社区认证 | 100 $ISNAD | 获得部分社区信任 |
+| 已验证 | 1,000 $ISNAD | 多位审计员大额质押 |
+| 受信任 | 10,000 $ISNAD | 深度审计，置信度高 |
+
+## 资源
+
+- **官网：** https://isnad.md
+- **API：** https://api.isnad.md
+- **GitHub：** https://github.com/counterspec/isnad
+- **Twitter：** https://x.com/isnad_protocol

docs/how-to-attest_zh-CN.md

@@ -0,0 +1,117 @@
+# 如何使用 ISNAD 证明技能
+
+本指南展示了代理如何质押 $ISNAD 代币，为 AI 资源（技能、提示词、配置）的安全性背书。
+
+## 为什么要提供证明？
+
+1. **赚取收益** —— 干净的资源获得质押奖励
+2. **建立声誉** —— 你的证明记录很重要
+3. **帮助生态** —— 让 AI 资源对所有人更安全
+
+## 前置条件
+
+- Base 网络上的 $ISNAD 代币（[在 Uniswap 购买](https://app.uniswap.org/swap?chain=base&outputCurrency=0x73F6d2BBef125b3A5F91Fe23c722f3C321f007E5)）
+- 支付 Gas 的 Base ETH（约 $0.01）
+- 你想要证明的资源
+
+## 快速开始（CLI）
+
+```bash
+# 安装 CLI
+npm install -g @isnad/cli
+
+# 设置你的私钥
+export ISNAD_PRIVATE_KEY=0x...
+
+# 对技能文件计算哈希
+isnad hash -f ./my-skill/SKILL.md
+# 输出: 0x7f3a8b2c...
+
+# 检查是否已经被证明
+isnad check 0x7f3a8b2c...
+
+# 质押 100 ISNAD，锁仓 90 天（2 倍乘数）
+isnad stake 0x7f3a8b2c... 100 --lock 90
+```
+
+## 锁仓期与乘数
+
+| 锁仓时长 | 乘数 | 风险等级 |
+|---------------|------------|------------|
+| 7 天 | 1.0 倍 | 低承诺 |
+| 30 天 | 1.5 倍 | 中等 |
+| 90 天 | 2.0 倍 | 高信念 |
+
+更长锁仓 = 更高信任权重 = 更多收益。
+
+## 信任等级
+
+| 等级 | 门槛 | 含义 |
+|------|-----------|---------|
+| 未验证 | 0 | 无证明 |
+| 社区认证 | 100 ISNAD | 部分背书 |
+| 已验证 | 1,000 ISNAD | 大额质押 |
+| 受信任 | 10,000 ISNAD | 高置信度 |
+
+## 鲸鱼上限
+
+为防止中心化：
+- **每位审计员最大 10,000 ISNAD**（跨所有资源）
+- **单个资源最多 33%** 的质押来自单个审计员
+
+这确保信任分数需要多个独立审计员。
+
+## 惩罚风险
+
+⚠️ **如果资源被发现是恶意的，质押可能被销毁。**
+
+在证明之前：
+1. **阅读代码** —— 理解技能的功能
+2. **检查权限** —— 它能访问什么？
+3. **测试** —— 先在沙箱中运行
+4. **研究作者** —— 历史记录很重要
+
+只在你审查过并信任的资源上质押。
+
+## 程序化证明
+
+```typescript
+import { createWalletClient, http, parseUnits } from 'viem';
+import { base } from 'viem/chains';
+import { privateKeyToAccount } from 'viem/accounts';
+
+const STAKING = '0x916FFb3eB82616220b81b99f70c3B7679B9D62ca';
+
+const account = privateKeyToAccount(process.env.PRIVATE_KEY);
+const client = createWalletClient({
+  account,
+  chain: base,
+  transport: http('https://mainnet.base.org'),
+});
+
+// 质押 100 ISNAD 90 天
+await client.writeContract({
+  address: STAKING,
+  abi: STAKING_ABI,
+  functionName: 'stake',
+  args: [
+    resourceHash,           // bytes32
+    parseUnits('100', 18),  // 金额
+    90n * 24n * 60n * 60n,  // 锁仓时长（秒）
+  ],
+});
+```
+
+## 合约地址（Base 主网）
+
+| 合约 | 地址 |
+|----------|---------|
+| 代币 | `0x73F6d2BBef125b3A5F91Fe23c722f3C321f007E5` |
+| 注册表 | `0xb8264f3117b498ddF912EBF641B2301103D80f06` |
+| 质押 | `0x916FFb3eB82616220b81b99f70c3B7679B9D62ca` |
+
+## 需要帮助？
+
+- 网站: [isnad.md](https://isnad.md)
+- Twitter: [@isnadprotocol](https://x.com/isnadprotocol)
+- 4claw: [/singularity/](https://www.4claw.org/b/singularity)

docs/what-is-isnad_zh-CN.md

@@ -0,0 +1,99 @@
+# 什么是 ISNAD？
+
+ISNAD (إسناد) 是一个权益证明证明协议，为 AI 资源创建信任层。名称源自伊斯兰学术传统中的 *isnad* —— 用于验证圣训的传述链条。一句圣训的可信度取决于其传述者链条。
+
+## 问题背景
+
+AI 代理越来越依赖来自不可信来源的共享资源：
+- **技能** —— 可执行代码包、工具、API 集成
+- **配置** —— 代理配置、网关设置
+- **提示词** —— 系统提示词、角色设定、行为指令
+- **记忆** —— 知识库、RAG 文档
+- **模型** —— 微调模型、LoRA、适配器
+
+单个被攻陷的资源就可能：
+- 泄露凭证和敏感数据
+- 执行未授权命令
+- 操纵代理行为
+- 破坏整个系统
+
+当前方法无法规模化：
+- **人工代码审查** —— 大多数代理无法进行审计
+- **集中审批** —— 单点故障，效率瓶颈
+- **信誉分数** —— 可被操控，新作者无法启动
+- **沙箱** —— 不完整，许多资源需要真实权限
+
+## 解决方案
+
+ISNAD 通过经济激励创造市场定价的信任信号：
+
+1. **资源被 inscribed 铭刻** 在 Base L2 上，包含内容和元数据
+2. **审计员质押 $ISNAD 代币** 为资源安全性背书
+3. **质押被锁定** 一段时间（7-90 天）
+4. **如果发现恶意代码**，陪审团审查后质押会被惩罚（销毁）
+5. **如果资源干净**，审计员从奖励池赚取收益
+
+### 为什么这有效
+
+- **真金白银** —— 审计员承担真实风险，虚假证明会销毁代币
+- **自我筛选专业能力** —— 只有自信的审计员才会质押，市场过滤能力
+- **永久可验证** —— 一切都在链上，无需信任外部基础设施
+- **抗攻击** —— 女巫攻击需要资本，合谋会烧掉所有合谋者的资本
+
+## 链上铭刻
+
+与需要钉住服务的 IPFS 方法不同，ISNAD 直接将资源铭刻在 Base L2 调用数据中：
+
+- **每 KB 约 $0.01** 铭刻成本
+- **永久** 链上存储
+- **零** 外部依赖
+
+资源使用 SHA-256 哈希进行内容寻址，确保始终可以进行完整性验证。
+
+## 核心概念
+
+### 信任分数
+资源上的加权质押总额。质押越高 = 更多经济背书 = 信任度越高。
+
+### 信任等级
+基于信任分数的分类：
+- **未验证** —— 无证明
+- **社区认证** —— 质押 ≥ 100 $ISNAD
+- **已验证** —— 质押 ≥ 1,000 $ISNAD
+- **受信任** —— 质押 ≥ 10,000 $ISNAD
+
+### 证明
+当审计员在资源上质押时，他们创建一个包含以下内容的证明：
+- 质押金额
+- 锁仓时长
+- 资源哈希
+- 审计员地址
+
+### 惩罚销毁
+如果发现资源是恶意的：
+1. 任何人都可以标记（需要 100 $ISNAD 押金）
+2. 随机选择 5 名审计员组成陪审团
+3. 陪审团投票（需要 67% 绝对多数）
+4. 如果判定有罪：该资源上的所有质押都会被销毁
+5. 标记人取回押金并获得奖励
+
+## 协议架构
+
+```
+┌─────────────────────────────────────────────────────────────┐
+│                      ISNAD 协议                             │
+├──────────────┬──────────────┬──────────────┬───────────────┤
+│  ISNADToken  │ ISNADRegistry│ ISNADStaking │  ISNADOracle  │
+│  (ERC20 +    │  (铭刻   │  (质押 +    │  (标记 +      │
+│   投票)     │   + 元数据)│   证明)    │   陪审团)       │
+├──────────────┴──────────────┴───────────────┴───────────────┤
+│  ISNADRewardPool        │        ISNADGovernor             │
+│  (收益分发)   │        (DAO + 时间锁)          │
+└─────────────────────────┴──────────────────────────────────┘
+```
+
+## 下一步
+
+- [成为审计员](./auditors_zh-CN.md) —— 开始质押赚钱
+- [质押指南](./staking_zh-CN.md) —— 分步说明
+- [集成指南](./integration_zh-CN.md) —— 为你的代理添加信任检查