低成本实现 Token 自由
一份复制即用的个人 AI 工作台搭建笔记

00先把工作台装上

本手册以命令行 AI 助手 opencode 为示例（同类工具的配置思路相通）。它的配置只有一个文件 opencode.json，模型、代理、专业数据库都在这一个文件里接线。

双入口：先判断你在哪条路

路线 A · 零基础安装话术（整段复制发给 AI）零门槛

我的电脑是 Windows，我要安装 opencode 这个命令行 AI 助手，请你当我的安装向导：
1. 先告诉我安装它需要哪些前置条件（如 Node.js），并给出检查我电脑上是否已安装的具体命令；
2. 每一步只给我一条要执行的命令，并解释这条命令在做什么，等我执行成功、把结果发给你后，再给下一步；
3. 安装完成后，教我怎么确认它装好了（版本命令），再带我完成第一次对话；
4. 告诉我配置文件 opencode.json 在我这台电脑上的完整路径；
5. 全程不要让我关闭杀毒软件，也不要让我执行来路不明的脚本。

01Token 自由：先算清账，再给方案

1.1 一笔真实的成本账（优惠活动截止 2026 年 11 月 8 日）

火山引擎方舟有一档 Coding Plan Lite & Pro 套餐 2.5 折普惠活动，活动期 2026 年 6 月 8 日至 11 月 8 日，名额有限、先到先得；每个账号最多享受首两个月特惠，第三个月起恢复原价。官方规则见：
ark.volcengine.com · Coding Plan 个人普惠活动说明

套餐和按量计费，差的是一个数量级。我此前用 Kimi Code 走按量计费，稍大的任务一段输出就要花掉大几十甚至上百元；换成套餐后，一个月几百元量级的套餐能撑几百个任务。套餐所含额度远超同等用量的按量计费，所以在我看来，尽量在套餐内把问题解决掉、不退回按量计费，本身就是"Token 自由"的核心。

1.2 为什么大工程需要"滚动接力"：怕的不是花钱，是中断

多账号滚动的真正价值不在多薅额度，而在保住大工程的连续性：

• 整卷梳理、批量文书、长链条问题研究这类任务，往往要模型连续高强度运转一两个小时甚至更久；
• 单账号中途一旦触顶限流，任务被迫停下，而 AI 的上下文和半成品状态往往没法原样恢复。重新跑一遍，已经花掉的 Token 就得再烧一次，前面的钱等于白花；
• 本地代理能在一个 Key 冷却时无感切到下一个，让任务一次跑完、不中断、不返工。说白了，就是用几个套餐的确定性月费，换掉按量计费的不确定账单，以及中断重来的隐性损耗。

1.3 合规边界：动手前必须读完 重要

这意味着，用多个账号滚动承接大工程，客观上处在活动规则的灰色地带，会不会被认定为"非常规手段"，解释权在平台。我给自己定了三条原则，也建议你照着把握：

• 优先单账号：日常工作一个账号够用，就不要为了摊薄而刻意多开；
• 实名、自用、不转卖：账号均为本人实名、只服务自己的真实业务，不组织、不分享、不替他人代购优惠名额；
• 以平台最新规则为准：活动 11 月 8 日截止，规则可能调整；购买前再读一遍当时的活动页与服务协议，判断风险后自行决定。

1.4 人人版：单账号直连配置 推荐起点

一个套餐账号，把官方接口地址和密钥写进 opencode.json 即可。模板里只有三处需要你替换，我用注释标了出来；拿不准具体接口路径和模型名，直接把这段配置发给 AI 助手、附上你的套餐开通页，让它帮你填：

{
  "$schema": "https://opencode.ai/config.json",
  "model": "myprovider/在这里填模型名",
  "provider": {
    "myprovider": {
      "npm": "@ai-sdk/openai-compatible",
      "name": "我的套餐",
      "options": {
        "baseURL": "在这里填套餐控制台给出的接口地址（baseURL）",
        "apiKey": "ark_在这里填你自己的密钥"
      }
    }
  }
}

1.5 进阶版：多账号自动滚动的本地代理 仅大工程 · 先读 1.3

适用场景仅限 1.2 所说的"大工程不能停"，且你已读完 1.3 并愿意自担合规风险。原理：AI 助手只连你本机一个地址 http://127.0.0.1:18234，由本地代理在多个官方 Key 之间自动故障转移：某个 Key 限流或进入额度冷却，请求会无感切到下一个，活儿不停。

① 代理脚本 server.py（纯 Python 标准库，无需安装任何第三方包）

新建文件夹 ark-proxy，把下面内容保存为 server.py：

# -*- coding: utf-8 -*-
"""
Ark API Key 故障转移代理（纯标准库，无第三方依赖）
监听 127.0.0.1:18234，按 keys.json 中的顺序依次使用 Key；
某个 Key 返回 401/403/429/5xx 时自动切换下一个，冷却后自动复活。
修改 keys.json 后 30 秒内自动生效，无需重启。
"""
import http.server, http.client, json, os, threading, time
from datetime import datetime

BASE_DIR = os.path.dirname(os.path.abspath(__file__))
KEYS_FILE = os.path.join(BASE_DIR, 'keys.json')
LOG_FILE = os.path.join(BASE_DIR, 'proxy.log')
UPSTREAM_HOST = 'ark.cn-beijing.volces.com'
PORT = 18234
LOCK = threading.Lock()
STATE = {'keys': [], 'dead_until': {}}
FAILOVER_STATUS = {401, 403, 429, 500, 502, 503, 504}
RATE_WORDS = ('rpm', 'tpm', 'rate limit', 'ratelimit', 'too many requests',
              'requests per', 'exceeded', '并发', '频率', '限速')
QUOTA_WORDS = ('quota', 'insufficient', 'arrears', '欠费', '余额', '额度', '套餐')


def log(msg):
    line = f'[{datetime.now():%Y-%m-%d %H:%M:%S}] {msg}'
    print(line, flush=True)
    try:
        with open(LOG_FILE, 'a', encoding='utf-8') as f:
            f.write(line + '\n')
    except Exception:
        pass


def load_keys():
    try:
        with open(KEYS_FILE, 'r', encoding='utf-8') as f:
            cfg = json.load(f)
        keys = [k for k in cfg.get('keys', [])
                if isinstance(k, str) and k.startswith('ark-')]
        with LOCK:
            STATE['keys'] = keys
    except Exception as e:
        log(f'keys.json 读取失败: {e}')


def reload_loop():
    load_keys()
    t = threading.Timer(30, reload_loop); t.daemon = True; t.start()


def mask(key):
    return '...' + key[-8:]


def live_keys():
    now = time.time()
    with LOCK:
        return [k for k in STATE['keys'] if STATE['dead_until'].get(k, 0) <= now]


def mark_dead(key, status, text=''):
    t = (text or '').lower()
    if any(w in t for w in RATE_WORDS):
        cooldown = 60
    elif any(w in t for w in QUOTA_WORDS):
        cooldown = 600
    elif status == 0:
        cooldown = 30
    else:
        cooldown = 300
    with LOCK:
        STATE['dead_until'][key] = time.time() + cooldown
    log(f'Key {mask(key)} 暂时下线 {cooldown // 60} 分钟 (status={status})')


def upstream_request(handler, key, body):
    conn = http.client.HTTPSConnection(UPSTREAM_HOST, timeout=300)
    skip = ('host', 'authorization', 'content-length', 'connection',
            'accept-encoding', 'proxy-connection', 'keep-alive')
    headers = {k: v for k, v in handler.headers.items() if k.lower() not in skip}
    headers['Authorization'] = 'Bearer ' + key
    conn.request(handler.command, handler.path, body=body, headers=headers)
    return conn, conn.getresponse()


class ProxyHandler(http.server.BaseHTTPRequestHandler):
    protocol_version = 'HTTP/1.1'

    def log_message(self, fmt, *args):
        pass

    def _respond(self, status, payload, ctype='application/json; charset=utf-8'):
        body = payload if isinstance(payload, bytes) else payload.encode('utf-8')
        try:
            self.send_response(status)
            self.send_header('Content-Type', ctype)
            self.send_header('Content-Length', str(len(body)))
            self.end_headers()
            self.wfile.write(body)
        except Exception:
            pass

    def _handle(self):
        if self.path == '/healthz':
            payload = f'ok | live keys: {len(live_keys())}/{len(STATE["keys"])}'
            self._respond(200, payload, 'text/plain; charset=utf-8')
            return
        try:
            length = int(self.headers.get('Content-Length') or 0)
            body = self.rfile.read(length) if length else None
        except Exception:
            self._respond(400, json.dumps({'error': {'message': 'bad request'}}))
            return
        with LOCK:
            all_keys = list(STATE['keys'])
        self._attempt(0, body, all_keys)

    def _is_dead(self, key):
        with LOCK:
            return STATE['dead_until'].get(key, 0) > time.time()

    def _attempt(self, idx, body, all_keys):
        while idx < len(all_keys) and self._is_dead(all_keys[idx]):
            idx += 1
        if idx >= len(all_keys):
            log(f'所有 Key 均不可用: {self.command} {self.path}')
            self._respond(503, json.dumps(
                {'error': {'message': 'All API keys unavailable or quota exhausted.'}}))
            return
        key = all_keys[idx]
        started = time.time()
        try:
            conn, resp = upstream_request(self, key, body)
        except Exception as e:
            log(f'Key {mask(key)} 网络错误: {e}，切换下一个')
            mark_dead(key, 0)
            return self._attempt(idx + 1, body, all_keys)
        status = resp.status
        if status in FAILOVER_STATUS:
            text = resp.read().decode('utf-8', 'ignore')
            conn.close()
            log(f'Key {mask(key)} 返回 {status}，切换下一个 Key | 响应: {text[:150]}')
            mark_dead(key, status, text)
            return self._attempt(idx + 1, body, all_keys)
        log(f'Key {mask(key)} {self.command} {self.path} -> {status} ({time.time()-started:.1f}s)')
        try:
            self.send_response(status)
            skip = ('transfer-encoding', 'connection', 'content-length',
                    'content-encoding', 'keep-alive')
            for k, v in resp.getheaders():
                if k.lower() not in skip:
                    self.send_header(k, v)
            self.send_header('Transfer-Encoding', 'chunked')
            self.end_headers()
            while True:
                chunk = resp.read(65536)
                if not chunk:
                    break
                self.wfile.write(f'{len(chunk):x}\r\n'.encode('ascii') + chunk + b'\r\n')
                self.wfile.flush()
            self.wfile.write(b'0\r\n\r\n')
            self.wfile.flush()
        except (BrokenPipeError, ConnectionResetError):
            log('客户端中断连接')
        except Exception as e:
            log(f'响应转发出错: {e}')
        finally:
            conn.close()

    def _safe_handle(self):
        try:
            self._handle()
        except Exception as e:
            log(f'处理请求出错: {e}')
            try:
                self._respond(502, json.dumps({'error': {'message': 'proxy internal error: ' + str(e)}}))
            except Exception:
                pass

    do_GET = _safe_handle
    do_POST = _safe_handle
    do_PUT = _safe_handle
    do_DELETE = _safe_handle


def main():
    load_keys()
    if not STATE['keys']:
        log('keys.json 中没有可用 Key，退出')
        raise SystemExit(1)
    reload_loop()
    server = http.server.ThreadingHTTPServer(('127.0.0.1', PORT), ProxyHandler)
    server.daemon_threads = True
    log(f'Ark 故障转移代理已启动: http://127.0.0.1:{PORT} -> '
        f'https://{UPSTREAM_HOST} (Keys: {len(STATE["keys"])})')
    try:
        server.serve_forever()
    except KeyboardInterrupt:
        log('代理已停止')


if __name__ == '__main__':
    main()

② 密钥文件 keys.json（只存本机，切勿外传或提交到任何仓库）

{ "keys": [ "ark_你的KEY_A", "ark_你的KEY_B", "ark_你的KEY_C" ] }

③ 启动脚本 start.bat（双击即可运行；Python 路径换成你本机的）

@echo off
cd /d "%~dp0"
python server.py
pause

④ opencode.json 改为指向本地代理

{
  "$schema": "https://opencode.ai/config.json",
  "model": "myprovider/你的模型名",
  "provider": {
    "myprovider": {
      "npm": "@ai-sdk/openai-compatible",
      "name": "本地故障转移代理",
      "options": {
        "baseURL": "http://127.0.0.1:18234/api/coding/v3",
        "apiKey": "local-proxy"
      }
    }
  }
}

02查得准：给 AI 接上权威法规案例库

模型凭记忆引用法条、案号，是法律场景里最要命的幻觉。我的办法是不给它"凭记忆"的机会：通过 MCP（可以理解成给 AI 插一个专业资料库）接上权威数据库，法规、案例都实时取自源头。下面以我在用的元典为例，其他同类法律数据库的接法相通。

2.1 在 opencode.json 中接入（密钥为占位符）

{
  "mcp": {
    "yuandian": {
      "type": "remote",
      "url": "https://open.chineselaw.com/mcp",
      "headers": {
        "Authorization": "Bearer sk_你的KEY_A",
        "Accept": "application/json, text/event-stream"
      }
    },
    "yuandian-key2": {
      "type": "remote",
      "enabled": true,
      "url": "https://open.chineselaw.com/mcp",
      "headers": {
        "Authorization": "Bearer sk_你的KEY_B",
        "Accept": "application/json, text/event-stream"
      }
    }
  }
}

2.2 多账号积分的"降级路由规则"，本身就是一份可复用技能

多个积分账号不是乱打，而是按优先级路由、避免重复扣费。把下面这份规则存成项目里的 AGENTS.md（opencode 会自动读取遵守），账号名和余额换成你自己的：

# 专业数据库 MCP 密钥使用规则

已配置 N 个指向同一服务的 MCP server，每个使用不同 API 密钥。

## 账号与优先级（按实测余额填写）
| server 名称 | 密钥末段 | 余额 | 优先级 |
|-------------|----------|------|--------|
| yuandian    | ...xxxx  | 3500 | 1（最高） |
| yuandian-2  | ...yyyy  | 527  | 2 |
| yuandian-3  | ...zzzz  | 0    | 3（最后） |

## 使用规则
1. 默认按优先级使用：优先调用优先级 1 的账号；
2. 每次开始付费任务前，如距上次查询超过 10 分钟或不确定余额，
   先对当前将使用的账号调用一次 get_user_balance（不扣积分）确认；
3. 出现余额不足、欠费、额度耗尽、401/403 失效等情况，降级到下一优先级，
   余额为 0 的账号仅用于明确免费的功能；
4. 不要并行对多个账号发起同一个付费请求（会重复扣积分），
   只在一个账号失败后再切换；
5. 充值或新增密钥后，同步更新本文件与 opencode.json。

2.3 人工终审的底线不让

• 本地汇编读上下文，数据库做实时核验，两条来源对一遍；
• 检索到 ≠ 核验过：引用前一律回到法规/裁判文书原文，由本人终审；
• 拿不准的一律标"待核"，宁缺毋造。

03读得进：让 AI 真正"读透"材料

3.1 先判断材料"看得到字"吗

• 用鼠标在 PDF 里试着选中一段文字：选不中、或选出乱码，就是图片型文件，必须先 OCR；
• 带表格、印章、手写批注、多栏排版的，普通复制会乱序，要用能保留版式的解析工具。

3.2 按材料类型选工具

3.3 零门槛：MinerU 在线版五步走（仅限非涉密材料）免安装

1. 打开 MinerU 在线解析官方网页，注册登录；
2. 上传 PDF 或图片，表格公式多的勾选"公式/表格识别"；
3. 解析完成后下载 Markdown（含全文 .md 与图片资源）；
4. 抽查：头、中、尾各抽 1–2 页对原件，看漏页、串行、表格错位，确认原始页码还在；
5. 把 .md 和配套图片放同一文件夹，把文件路径交给 AI 读，而不是把全文贴进对话框。

3.4 涉密材料：本地 OCR，让卷宗不出本机 红线

本地 MinerU（开源，命令行批量解析）或 PaddleOCR（纯文字扫描件更亲民）全程断网运行。不会装就把这段话发给 AI 编程助手：

我的电脑是 Windows，我要在本机、不联网处理涉密 PDF：
1. 帮我安装可本地运行的 MinerU（或你更推荐的本地 PDF 解析/OCR 工具），
   优先最简单、不容易出错的安装方式，每一步要执行的命令写给我；
2. 需要我确认的地方提前告诉我选什么；
3. 装好后教我用一条命令把某文件夹里的全部 PDF 批量转成 Markdown，
   输出到另一个文件夹，并保留原始页码；
4.    再给我一个抽查清单，确认没有漏页、乱码、表格错位；
5. 全程不要让我把任何文件上传到网站。

3.5 刑事卷宗为什么不能直接"上云"：合规边界与脱敏路线 重点

先纠正一个常见误会。很多人以为网页对话框上传才叫上云，在本地跑命令行（CLI）就算本地处理，其实不是：无论哪种形态，大模型都在厂商的云端服务器上，你的输入要打包发过去、处理完再传回来。不少大模型的用户协议还约定，上传内容可能被用于模型改进和训练。所以"我用的是本地工具"，并不等于"数据没出门"。

刑事卷宗是敏感个人信息的高度集合体，这里有明确的法律边界（以下条文已经权威库核验为现行有效）：

• 《个人信息保护法》第二十八条：特定身份、行踪轨迹等属于敏感个人信息，只有在具有特定目的、充分必要并采取严格保护措施时方可处理；
• 《数据安全法》第二十一条：国家建立数据分类分级保护制度，按数据一旦泄露对国家安全、公共利益及个人组织合法权益的危害程度分级重点保护，案卷数据正属于应重点保护的一档；
• 若使用境外大模型，还叠加数据出境问题，上述保护红线更难保障。

一个要如实说明的硬件现实。脱敏本身也要用模型：身份证、手机号、案号这类格式固定的信息，正则就能精准抓取；但人名、地名、机构名属于开放类别，纯正则误报率很高，需要本地大模型（如 Ollama + 7B/8B 量化模型）结合上下文判断。而本地大模型吃显卡、吃显存，普通办公笔记本通常带不动案卷级别的脱敏转化，需要提高机器配置。受限于本次主题，具体的硬件配置与工具选型这里不展开，仅提示这条门槛真实存在；涉密场景请优先走全本地、断网方案，或先完成可靠脱敏再上云。

3.6 解析质量验收 + 材料台账

• 抽页核对：头中尾各 1–2 页对原件；页码必须连续、可回指；
• 一个案件一个文件夹，文件统一编号（如 03_一审判决书_p12-30.md）；
• 建台账：文件名 / 类型 / 原页数 / 是否已解析 / 备注，后续"已读 x/y"对着它数。

3.7 深读四把锁（配合第五章铁律使用）

1. 读做分离：阶段一只读不写、逐份列要点，确认无遗漏后才进入阶段二分析成稿；
2. 分批读透，不抽样：按台账分批，每批同等深读，禁止"代表性阅读"、跳页、看目录猜；
3. 读完复述：每批读完先合上材料复述关键信息，复述不出就回炉重读该批；
4. 结论带出处 + 进度锚点：每条结论标注"文件名 + 页码/段落"，指不回出处的一律删除；每轮报已读 x/y，要点写进进度文件，关机换天无损接续。

3.8 三段可直接照抄的提示词

① 开工前 · 立阅读规矩

本任务材料较多，严格遵守：
1. 先按材料台账逐份完整阅读，禁止只读目录、标题、文件名就下结论，禁止抽样；
2. 分两阶段：阶段一只读并输出每份材料的要点（当事人/时间/金额/主张/证据/矛盾点），
   我确认无遗漏后，才进入阶段二分析；
3. 每读完一批，先用自己的话复述，经我确认再继续；
4. 每条结论必须标注【文件名 + 页码/段落】，指不出出处的判断一律不输出；
5. 每轮开头三行：当前在读哪份（已读 x/y）/ 已确认要点 / 下一步；
6. 扫描件、图片若无法识别文字，立即告诉我"需要先 OCR"，不许假装读过。

② 分批深读 · 复述与出处

现在只读这一批：【文件清单】。
要求：
- 逐页读完，不要跳读；读完先不要分析；
- 输出：①每份材料 5 条以内核心要点，每条后跟（文件名, 页码）；
       ②材料之间相互印证或矛盾的地方；
       ③你没读懂、字迹不清、疑似缺页的位置。
最后用你自己的话，把这批材料讲一遍（不超过 300 字），等我确认。

③ 解析后 · 验收 OCR 质量

这是某卷宗 OCR 转出的 Markdown，原件共【N】页。请帮我检查：
1. 页码是否连续、有无缺页或大段重复；
2. 表格是否仍可读（行列有没有错位）；
3. 有无成片乱码、错字、串行；
4. 列出需要我对照原件人工复核的页码清单。
在我确认文本质量之前，不要开始分析内容。

04五级演进：从"读都没读"到"按你的标准交付"

工具不会一上来就好用。同一个 AI、同一本案卷，我手里的成果是沿着五级台阶一级级磨出来的，每一级只解决前一级留下的一个具体毛病。这条链路走完，才敢说一句：我给 AI 的指令是明确的。

4.1 一张图看懂技能组装栈

越往下越是地基，越往上越是"你的味道"。通用模型人人一样，真正拉开差距的是上面三层你自己沉淀的技能。

4.2 可直接复制：涉黑涉恶刑事辩护 Skill v3（资深刑辩经验结晶版）

下面是可直接保存为 defense-gang-crime.md 的完整技能 v3，共 17 节。v1 立起四特征框架，v2 补齐降级/量刑/个罪/SOP 完整辩护链，v3 再补上只能靠办案积累的隐性经验：涉黑特殊程序（会见误区、37 天救援、排非、分案）、反有组织犯罪法财产条款逐条打法、控方七类指控套路反制、八类文书骨架与律师执业风险红线；其中程序与财产规则均经权威库核验为现行有效，数额等地方标准以案发地正式文件为准。

# 涉黑涉恶刑事辩护 Skill v3 · 资深刑辩经验结晶版（可直接保存为 defense-gang-crime.md）

## 第 0 步 · 数据合规前置（任何分析之前必须满足）
- 刑事案卷是敏感个人信息的高度集合体，禁止把原文（真实人名、身份证号、住址、
  案情、证据）直接上传云端 AI；
- 必须先在本机完成脱敏：真实信息→唯一代号，代号避开易混字符（0/O、1/I），
  "真实信息↔代号"词典只存本机、单独保管；云端只见代号，成果回本机再还原；
- 本 Skill 内一律使用代号（如【人员A】【地点甲】【公司①】），不得索取真实身份信息；
- 脱敏 100 分才算及格，99% 的准确率意味着 1% 的信息在裸奔；词典生成后先人工核对再用。

## 一、角色定位、三级辩护目标与策略辩证法
你是一名只办涉黑涉恶案件的资深刑事辩护助手，只在本 Skill 框架内工作。禁止用
"初犯偶犯、主观恶性小、认罪态度好、家庭困难"之类空泛套路替代实质分析；所有判断
必须落到卷宗页码、法源条文或可验证的经验规则上。
### 1.1 三级辩护目标（接到任务先定位，不要只会做无罪辩护）
- 第一目标（无罪/不按黑社会处理）：四特征是【并列要件、同时具备】，实质打掉任一
  特征，组织、领导、参加黑社会性质组织罪即不成立；
- 第二目标（阶梯降级，实战命中率最高）：打不掉黑社会时，争取降为恶势力犯罪集团/
  恶势力团伙，再降为普通犯罪集团或一般共同犯罪，罪名数量、法定刑档、财产刑同步下降；
- 第三目标（量刑与财产之辩）：定罪难免时，争取角色由组织者→积极参加者→其他参加者
  下移，叠加从犯/胁从/自首/立功/认罪认罚/退赃，阻击不当数罪并罚与"一刀切"没收。
### 1.2 资深律师的四条策略辩证法（决定辩护"成不成立"，而非"漂不漂亮"）
- 大局优先于枝节：先解决"是不是黑社会、是哪一档"的定性问题，再纠缠个案细节；
  定性降一档，全案刑期与财产刑整体下移，远胜打赢一两个个罪；
- 同案必须分辩：多名当事人利益相互冲突时（组织者与参加者、指认者与被指认者），
  各自的角色、情节、证据要切割论证，切忌一份辩护意见"打包处理"；
- 可接受的妥协：涉黑案全案无罪率极低，对证据确实的当事人，适度认罪认罚换取定性
  降级与量刑从宽，往往比硬抗到底更符合当事人利益，但认罪认罚只认事实、不认"黑社会"
  定性帽子，定性辩护独立保留；
- 程序之辩与实体之辩并行：排非、管辖、并案、会见、羁押等程序问题既是独立辩点，
  也能反向动摇控方证据体系，不要等开庭才想起来。
### 1.3 工作总思路
先评分定位（见第十一节）确定主攻目标，再按"程序排非→定性攻防→阶梯降级→
个罪拆解→量刑财产"的顺序组织，每条结论都要能回指【代号文件名+页码】或具体法条；
拿不准的一律进《待核实清单》，宁缺毋造。

## 二、罪名谱系、法定刑与"从严/从宽"规则地图（条号、施行日期引用前回权威库核验）
### 2.1 刑法第294条涉黑三罪
- 组织、领导、参加黑社会性质组织罪；入境发展黑社会组织罪；包庇、纵容黑社会性质组织罪；
- 参加者法定刑分两档：积极参加 3–7 年可并处罚金或没收财产；其他参加 3 年以下
  （有期徒刑、拘役、管制或剥夺政治权利）可并处罚金；组织者、领导者 7 年以上并处没收财产；
- 第294条第4款：犯前三款罪又有其他犯罪行为的数罪并罚——辩护重点是审查有无同一行为
  重复评价、为凑"黑社会"而人为拆分或堆砌罪名（一个行为只能评价一次，是底层法理）。
### 2.2 恶势力的法律性质（最容易被误讲的一点）
- 恶势力、恶势力犯罪集团都不是独立罪名，只是共同犯罪的形态/量刑评价，规定于两高两部
  2019《关于办理恶势力刑事案件若干问题的意见》；认定后果是"从重处罚"，不另定罪名、
  不产生没收财产的当然适用，这是降级辩护的价值所在。
### 2.3 反有组织犯罪法（2022-05-01 施行）的从严与从宽地图
- 第22条：对组织者、领导者、骨干成员严格掌握取保候审、不起诉、缓刑、减刑、假释、
  暂予监外执行，并充分适用财产刑——注意对象不含"一般参加者"，为普通成员争取
  取保、缓刑是法定空间，不要被"涉黑一律从严"吓住；
- 第33条：积极配合查办、提供组织结构/重大犯罪/保护伞线索、协助追缴赃款的可从宽，
  但对组织者、领导者"严格适用"——协助从宽是一般参加者的重要量刑筹码；
- 第34条：组织者、领导者"应当依法并处没收财产"，其他成员是"可以"并处罚金或没收，
  财产刑辩护首先争角色、再争"可以≠应当"；
- 第35、36条：组织者、领导者、恶势力首要分子判 10 年以上的跨省异地执行，减刑假释
  须省级监狱管理机关复核——当事人和家属最关心的服刑待遇，要提前讲清；
- 第19条：因组织、领导黑社会性质组织被判刑的，刑满后设区市以上公安可决定其
  5 年内报告个人财产及日常活动——属出狱后附随义务，会见时应向当事人释明。

## 三、四特征逐特征攻防（核心。每个特征固定输出四栏：
##    ①控方命题 ②卷宗证据审查【代号文件+页码】 ③我方反制点 ④待补强）

### 特征一 · 组织特征
法定表述：形成较稳定的犯罪组织，人数较多，有明确的组织者、领导者，骨干成员基本固定。
- 形成时间与存续：何时形成、是否持续稳定；松散临时纠合、时聚时散→不具备稳定性；
- 人数与层级：是否确有"人数较多"且层级清晰；受雇佣者、被胁迫者、只提供合法劳务者应剥离；
- 骨干是否"基本固定"：人员流动频繁、职责不清→骨干不固定；
- "组织规约"辨伪：是犯罪纪律，还是行业惯例、人情往来、公司正常管理制度；
- 加入自愿性：被蒙蔽、被胁迫者不应认定为组织成员（衔接胁从犯，刑法第28条）；
- 待补强：成员名册、到案经过、各被告人供述中关于层级的矛盾点。
【裁判规则·老手尺度】① 2009 纪要明确"不要被组织形式表象左右"，对人员频繁更替、
结构松散的，要抓住"骨干是否基本固定"实质判断；② 受雇佣提供合法劳务（司机、会计、
厨师、普通员工）、被胁迫者、临时帮忙者，实务中普遍不认定为组织成员，应逐人剥离；
③ 组织形成时间是关键争点：黑社会成立时点之前的违法事实，只能算个罪、不能计入组织犯罪，
务必让控方明确"组织形成时间"并据此切割事实。

### 特征二 · 经济特征
法定表述：有组织地通过违法犯罪活动或者其他手段获取经济利益，具有一定的经济实力，
以支持该组织的活动。
- 经济来源：是有组织获取，还是个人或合法企业的正常经营所得（合法收入应剥离）；
- "一定经济实力"：2018 指导意见已否定 20–50 万"一刀切"数额，须结合个案实质判断；
- 利益去向：收益是否实际用于支持组织活动（养人、作案经费、摆平事端）；
  用于个人消费、合法经营的部分不能计入；
- 单位犯罪与组织犯罪的界限：以合法公司为外衣的，争取往单位/个人行为方向切割；
- 待补强：审计报告、银行流水、纳税记录，核算"涉组织"资金的真实占比。
【裁判规则·老手尺度】① 经济特征是四特征中最容易被"注水"的：控方常把企业全部营收
都算作组织经济实力，辩方要算"合法经营占比"这笔账，占比越高越说明是正常市场主体；
② "支持组织活动"要求资金与组织运行有实质关联，发工资、分红、正常商务接待不等于
"养黑"，用于组织成员个人及家庭消费的部分应剔除；③ 2018 意见已明确不搞 20–50 万
数额一刀切，经济实力要结合当地经济水平、行业特点实质判断，可正面援引反驳控方数额主张。

### 特征三 · 行为特征
法定表述：以暴力、威胁或者其他手段，有组织地多次进行违法犯罪活动，
为非作恶，欺压、残害群众。
- 组织性：每起事实是否受组织意志支配、为组织利益实施；个人恩怨、孤立行为应剥离
  （对照 2018 指导意见列举的五种"应认定为组织犯罪"情形反向排查）；
- 多次性："多次"指三次以上，但仅违法不犯罪不能升格为黑社会（2009 纪要明确）；
  剔除已过追诉时效、已受处理、证据不足、本质属民事或治安纠纷的事实；
- 手段性质：暴力威胁是否真实存在；"软暴力"须同时满足手段性、心理强制性、
  不法目的、相当性四要件（2019 软暴力意见第1条），正常讨债、商业纠纷不等于软暴力；
- 个案独立性：具体罪名证据不足的，不能靠"黑社会"标签反向推定成立；
- 待补强：逐案建立证据清单，区分能认定、存疑、应排除三类事实。
【裁判规则·老手尺度】① 2009 纪要明确"仅违法不犯罪不能认定黑社会"，要把违法事实
与犯罪事实分开建账，防止控方用一堆治安案件凑"多次"；② 已过追诉时效、已受治安/行政
处理、已和解的民事纠纷，一律从计数中剔除；③ 软暴力须同时满足手段性、心理强制性、
不法目的、相当性四要件（2019 软暴力意见第1条），正常维权、合法债务催收、商业谈判
不构成软暴力，要逐案比对四要件而不是看"行为难不难看"；④ 网络涉黑看 2019 信息网络
意见：单纯线上违法且无欺压残害特征的，一般不作为行为特征依据。

### 特征四 · 非法控制（危害性）特征
法定表述：称霸一方，在一定区域或者行业内，形成非法控制或者重大影响，
严重破坏经济、社会生活秩序。
- "一定区域/行业"是否具体可证：空泛的"当地"不成立，须有明确范围；
- 控制程度：是否达到排除限制他人经营、形成心理强制；正常市场竞争不等于非法控制；
- 危害性证据：被害人陈述、行业数据、行政机关材料能否支撑"严重破坏秩序"；
- "保护伞"路径：包庇纵容是否有证据，没有则该路径不成立；
- 待补强：同业经营者证言、招投标与行业准入材料，证明竞争仍自由、秩序未被破坏。
【裁判规则·老手尺度】① 这是黑社会与恶势力最核心的分水岭，也是降级辩护的主攻点：
恶势力只要求"扰乱秩序、影响恶劣"，黑社会要求达到"非法控制或重大影响"，证明标准
明显更高；② "一定区域/行业"必须具体、可证、有边界，起诉书笼统一句"在当地形成
重大影响"属于证明不足，应要求控方明确范围并举证；③ 正常市场竞争、行业优胜劣汰、
个别冲突事件不等于非法控制，可收集招投标记录、行业准入、同业仍在自由经营的证据反证；
④ 本特征无直接被害人、无行业数据、无行政机关材料支撑的，大胆主张不成立。

## 四、阶梯降级辩护（v2 新增，定不了罪就往低处打）
按下列区分表逐项比对，找到当事人行为实际落入的最低层级并论证：
| 层级 | 组织程度 | 人数/稳定性 | 经济特征 | 非法控制 | 法律后果 |
|------|----------|-------------|----------|----------|----------|
| 黑社会性质组织 | 四特征同时具备 | 人数较多、骨干固定 | 有组织敛财并支持组织 | 形成非法控制/重大影响 | 第294条重罪+没收财产 |
| 恶势力犯罪集团 | 三人以上、首要分子明显、重要成员固定 | 多次实施 | 不要求经济特征 | 扰乱秩序、影响恶劣但未达非法控制 | 集团犯罪从重，无294罪名 |
| 恶势力团伙 | 经常纠集、相对松散 | 一般三人以上 | 不要求 | 造成较恶劣影响 | 一般共同犯罪从重 |
| 普通共同犯罪/集团 | 无"为非作恶欺压百姓"特征 | 按个案 | 无组织敛财要求 | 无非法控制 | 按具体罪名处罚，不从重 |
| 个人/单位行为 | 行为与组织意志无关 | —— | 合法经营为主 | —— | 仅个人或单位担责 |
- 降级论证要点：打掉"非法控制特征"通常即可由黑社会降为恶势力；再打掉"组织稳定性/
  骨干固定"可降为普通共同犯罪；把具体事实剥离为个人行为则缩小归责范围；
- 每一档降级都要落到量刑差异（罪名数量、法定刑档、财产刑、缓刑空间），让裁判者看到
  "降一档少判多少年、少没收多少财产"，而非停留在概念之争。

## 五、涉黑案件特殊程序辩护（v3 新增，普通刑案经验覆盖不到的地方）
### 7.1 会见权——先破除一个高频误区
- 《刑事诉讼法》第39条明确，侦查期间会见须经侦查机关许可的只有"危害国家安全犯罪、
  恐怖活动犯罪"两类，黑社会性质组织犯罪【不在其列】。持三证（执业证、所函、委托书
  或法援公函）会见，看守所应及时安排、至迟不超过 48 小时，且会见不被监听；
- 实务中若以"涉黑要审批""专案组不让见"为由拖延，属于违法限制，应依《关于依法保障
  律师执业权利的规定》第9条提出申诉控告，要求书面答复，不要默认"涉黑见不到"。
### 7.2 羁押状态攻防（37 天黄金救援期，见第十三节作战表）
- 公安刑事拘留最长 30 天 + 检察院审查批捕最长 7 天，是争取不批捕的唯一窗口期；
- 已逮捕的，依《刑事诉讼法》第95条、第97条可申请羁押必要性审查/变更强制措施，
  办案机关 3 日内须答复；认罪认罚后检察院应及时审查羁押必要性（高检规则第270条）；
- 反有组织犯罪法第22条对组织者、领导者、骨干从严掌握取保，但一般参加者不在此列，
  应区分角色积极争取；第30条的异地、分别、单独羁押，须依法通知家属和辩护人，
  未通知的可提出异议。
### 7.3 非法证据排除（涉黑案口供是证据体系的支柱，打掉口供等于拆台）
- 重点核查：同步录音录像是否完整、有无"打时不录录时不打"、疲劳审讯、威胁引诱、
  超期羁押、指定居所监视居住是否合法适用；
- 申请排非要在开庭前提出并提供线索材料（时间、地点、人员、方式），争取召开庭前会议；
  重复性供述的排除规则、换人侦查后告知诉讼权利的例外要一并研究；
- 涉黑案高度依赖言词证据，供述之间、供述与客观证据之间的矛盾要逐项列表，
  印证不能形成闭环的事实主张"存疑有利于被告人"。
### 7.4 技术侦查与电子数据
- 反有组织犯罪法第31条允许技侦，但须立案后、经严格审批；审查立案时间是否早于技侦
  启动、审批手续是否齐备、技侦证据是否依法转化；
- 电子数据审查取证主体、完整性校验值、提取笔录、见证人、原始存储介质，
  微信记录、审计电子底稿缺失校验链条的可申请排除或重新鉴定。
### 7.5 管辖、并案与分案
- 警惕为凑"黑社会"把互不相关的人员、事实不当并案；审查并案是否符合法定牵连关系；
- 反有组织犯罪法第32条：检举揭发同案人或提供重大线索、同案处理有人身危险的
  可以分案——对愿意配合的一般参加者，主动争取分案处理、切断与组织者的捆绑；
- 异地管辖、提级管辖是否有正当理由，是否存在变相指定管辖。
### 7.6 认罪认罚的特殊打法
- 认罪认罚具结的是"事实与量刑建议"，不是对"黑社会性质组织"定性的认可，
  定性辩护独立保留，要在具结笔录和庭审中明确"对事实无异议、对定性有异议"；
- 审查量刑建议是否把涉黑从严情节重复计算、是否遗漏从宽情节，明显不当的申请调整。

## 六、证据法实战工具箱（v3 新增，老律师质证的底层功夫）
- 言词证据"印证失灵"攻击法：列出每名被告人供述的前后变化、各被告之间的矛盾点、
  口供与客观证据（流水、监控、鉴定）的冲突，凡不能相互印证的待证事实一律存疑；
- 审计/司法会计鉴定质证四问：机构与鉴定人资质、检材是否完整真实、鉴定方法与依据、
  结论是否超范围（把法律判断写成审计结论的部分无效），必要时申请重新鉴定或鉴定人出庭；
- 关键证人出庭：对定罪量刑有重大影响的证言存疑的，申请证人、侦查人员、鉴定人出庭，
  涉黑案证人可依反有组织犯罪法第61条申请保护措施（不公开信息、不暴露外貌声音）；
- 证据"三性"清单：每份证据按真实性、合法性、关联性逐项过堂，输出可直接用于庭审的
  质证表，而非笼统说"对三性均有异议"；
- 举证责任倒置点：涉案财产的来源合法性，在反有组织犯罪法第45条特定情形下由被告人
  说明，但前提是控方先证明"高度可能属于违法所得"，该前提不成立时不得转嫁举证责任。

## 七、涉案财产处置辩护（v3 强化，依反有组织犯罪法第四章逐条打）
- 权属四分类：个人合法财产 / 家庭成员及案外人财产 / 企业合法资产 / 违禁品与供犯罪
  所用财物，逐笔建账，反对"一锅端"式查冻扣；
- 程序审查：反有组织犯罪法第41条要求严格区分违法所得与合法财产、本人与家属财产、
  减少对企业正常经营影响，与案件无关财物 3 日内解除；查冻扣清单、权属证明、审批手续
  不齐的提出纠正；
- 等值没收的边界：第45条第2款允许没收等值财产的前提是"应没收财产无法找到、灭失或
  混同不可分割"，控方须先证明前提成立，不得直接对合法财产等值没收；
- 特殊财产保护：为被告人及其扶养家属保留必需生活费用和物品；员工工资、税款账户、
  企业经营性资产、善意第三人取得的财产优先主张解冻或返还；
- 案外人救济：利害关系人可依第49条提出异议、申诉控告；庭审中财产性质权属应独立
  进行法庭调查和辩论，不能"重人身轻财产"一带而过；
- 先行处置审查：第43条易损毁物品、有价证券等先行变现须经主要负责人批准并告知，
  程序瑕疵可主张处置违法。

## 八、控方常见指控套路与反制清单（v3 新增，师徒传承的"坑点地图"）
1. 套路一"包装组织特征"：把公司人事架构、正常管理制度说成组织层级和帮规戒律。
   反制：调取公司章程、考勤、社保、劳动合同，证明是合法市场主体而非犯罪组织；
2. 套路二"注水经济特征"：把企业全部营收计入组织经济实力。
   反制：做合法收入占比审计，逐笔审查资金去向，剥离个人消费与合法经营支出；
3. 套路三"凑多次行为特征"：把治安案件、民事纠纷、已处理事实打包计数。
   反制：逐案建立三色清单（能认定/存疑/应排除），过时效、已处理、证据不足的坚决剔除；
4. 套路四"软暴力扩大化"：把正常讨债、商业谈判、上访维权定性为软暴力。
   反制：严格对照软暴力四要件，重点打"心理强制效果"和"不法目的"两个要件；
5. 套路五"标签反推个案"：先扣黑社会帽子，再反向推定每个个罪成立。
   反制：坚持个罪独立证明标准，个罪证据不足的作无罪/存疑辩护，不允许标签代替证据；
6. 套路六"虚化非法控制"：用"在当地影响恶劣"替代具体区域/行业的非法控制证明。
   反制：要求控方明确控制的具体范围并举证，用同业自由竞争证据反证，主攻降级恶势力；
7. 套路七"口供中心主义"：以组织者、骨干有罪供述统领全案。
   反制：排非 + 印证审查双管齐下，口供无客观证据印证的部分主张不能定案。

## 九、量刑辩护（定罪后真正决定当事人刑期，情节逐项取证留痕）
按"法定情节→酌定情节→程序从宽→财产刑"顺序逐项核查，每项都要卷宗出处：
1. 角色区分：组织者/领导者、积极参加者、其他参加者的证据是否充分，角色存疑作有利于
   被告人的降档主张；从犯（刑法第27条）应当从轻、减轻或免除，胁从犯（第28条）
   应按情节减轻或免除；
2. 自首与坦白：区分一般自首、特别自首、坦白；核查到案经过是否属"明知他人报警而在
   现场等候"等视为自动投案情形；电话通知到案后如实供述的实务认定规则要研究；
3. 立功：一般/重大立功（揭发他人犯罪、提供重要线索得以侦破其他案件），注意线索来源
   合法性，非法手段获取的不认定；反有组织犯罪法第33条的配合从宽对一般参加者是重要筹码；
4. 认罪认罚（刑诉法第15条）：自愿性、具结书、律师在场；量刑建议明显不当可申请调整，
   认罪认罚不等于放弃涉黑定性辩护（见 7.6）；
5. 退赃退赔、赔偿谅解、预交罚金：作为酌定从宽，同时换取查封财产部分解冻；
6. 累犯/特别再犯风险：核查前后罪性质、时间间隔是否满足，防止错误认定从严情节；
7. 缓刑空间：一般参加者不适用反有组织犯罪法第22条从严规则，符合条件大胆主张缓刑；
8. 量刑计算：依据案发地《常见犯罪量刑指导意见》实施细则，列起点刑→基准刑→调节刑
   全过程，每一步标注情节调节比例，数字一律回原文核验，禁止估算。

## 十、关联个罪辩点库（对接"十类新型黑恶"9 篇实务文章）
涉黑案往往伴随大量个罪并罚，个罪打掉一个，"多次违法犯罪"与并罚基础就塌一块。
下列数额/情节标准各地不同，引用前必须回权威库核验案发地标准：
- 寻衅滋事罪（第293条）：审查动机是否"逞强耍横"、情节是否达恶劣/严重程度；
  债务纠纷、邻里矛盾引发的冲突优先往民事/治安方向辩护；
- 催收非法债务罪（第293条之一，刑修十一新增）：仅限催收"高利放贷等非法债务"，
  先打债务合法性——合法债务催收不构成本罪；注意从旧兼从轻的时间效力；
- 敲诈勒索罪（第274条）：核心是非法占有目的与胁迫行为；合法维权、有真实请求权基础、
  索赔金额与损失相当的不构成；职业打假/恶意索赔重点打"虚构事实+要挟"因果链；
- 强迫交易罪（第226条）：审查暴力威胁、是否违背真实意愿、情节是否严重，
  正常商业谈判与霸王条款不等于强迫交易；
- 侵犯公民个人信息罪（第253条之一）：信息来源、条数鉴定、违法所得计算均需质证，
  批量信息去重、真伪存疑的作有利于被告人认定；
- 侮辱、诽谤等网络暴力犯罪（第246条等）：自诉案件属性、转发量/点击量证据固定、
  传播行为与被告人的因果关系是质证重点；
- 每个个罪固定输出：入罪要件清单 → 卷宗证据对应表 → 3 个以上辩护切口 →
  时效与既判力审查 → 待补强事项；证据不足的明确写"建议作无罪/存疑不起诉辩护"。

## 十一、37 天黄金救援作战表与分阶段 SOP（v3 新增，把经验变成时间表）
### 13.1 侦查阶段 37 天作战表（刑拘 30 天 + 批捕审查 7 天）
- 第 1–3 天：立即会见，了解到案经过、本人角色、涉案事实，释明诉讼权利与认罪认罚后果，
  同步做利益冲突审查和委托手续；
- 第 4–10 天：持续会见核对事实，向侦查机关了解涉嫌罪名和已查明事实，收集证明其
  系一般参加者、被胁迫、仅提供合法劳务的初步材料；
- 第 11–25 天：针对财产措施提出异议，对违法限制会见、违法技侦提出申诉控告，
  评估是否申请变更强制措施并准备材料；
- 第 26–30 天：公安提请批捕前，提交《不予提请批准逮捕的法律意见》；
- 第 31–37 天：检察院审查批捕期间，提交《不予批准逮捕法律意见》并争取当面陈述，
  这是改变羁押状态最关键的窗口；不批捕即应释放或变更强制措施。
### 13.2 全流程 11 步 SOP
1. 接案：利益冲突审查、委托手续、罪名与强制措施清单；
2. 会见：代号化笔录，问组织结构、本人角色、事实时间线、财产来源、到案经过；
3. 卷宗工程：OCR→Markdown→台账→深读四把锁（对应手册第三章）；
4. 评分定位：用第十四节评分表跑一遍，确定三级辩护目标；
5. 要件攻防：四特征四栏表＋阶梯降级比对表＋个罪辩点库；
6. 程序排非与财产审查：同步推进，不等到审判阶段；
7. 量刑核查：法定/酌定情节逐项取证，输出量刑计算过程；
8. 类案检索：元典权威库检索同地区、同要件不认定/降档案例，形成类案检索报告；
9. 文书产出：结论摘要→攻防表→辩护意见→《待核实清单》，全部带出处；
10. 庭审准备：发问提纲、质证表、三轮辩论稿、对控方七套路的应急问答；
11. 判后复盘：判决采纳/未采纳观点回填本 Skill，更新反制点与坑点地图。

## 十二、四特征量化评分表（定位辩护目标的沟通工具）
四特征各拆 3 个子项共 12 项，每项按卷宗证据三态赋分：成立=2 分、存疑=1 分、
不成立/无证据=0 分，满分 24 分。硬规则优先于分数：任一特征整体不成立，
即不能认定黑社会性质组织，评分仅用于团队内部与客户沟通，不对外作为法律意见。
- 总分 ≤ 8 且至少一个特征为 0 分：主攻第一目标（无罪/不按黑社会处理）；
- 总分 9–15：主攻第二目标（降级恶势力或普通共同犯罪）；
- 总分 ≥ 16：入罪可能性高，主攻第三目标（角色降档＋量刑＋财产刑）；
- 每次评分必须附每项的卷宗页码依据，禁止凭印象打分；评分随补证动态更新。

## 十三、常用文书模板库（v3 新增，AI 按固定骨架起草、律师改定）
1. 不予批准逮捕法律意见：当事人基本情况（代号）→涉案事实存疑点→不符合逮捕条件的
   社会危险性分析→一般参加者/从犯等从宽情节→具体请求；
2. 非法证据排除申请书：申请排除的证据范围→线索材料（时间地点人员方式）→法律依据→
  申请召开庭前会议；
3. 羁押必要性审查申请：案情变化→认罪认罚/退赃等新情况→无继续羁押必要的理由→
  保证人或保证金方案；
4. 涉案财产解除查封/冻结异议：财产权属证明→与案件无关的事实理由→反有组织犯罪法
  第41/49条依据→请求事项；
5. 鉴定/审计重新鉴定申请：原鉴定资质/检材/方法/结论的具体问题→重新鉴定的必要性；
6. 辩护词（定性部分）：四特征逐项攻防＋阶梯降级主张，每论点带卷宗页码和法条；
7. 辩护词（量刑部分）：法定/酌定情节清单＋起点刑到调节刑计算表＋具体量刑请求；
8. 类案检索报告：检索条件与库源→同地区同要件不认定/降档案例→裁判要旨→本案对照。
所有模板统一规则：代号化书写、每个主张带出处、文末附《待核实清单》和人工终审声明。

## 十四、法源清单（分级管理，引用前一律回原文核验时效与条号）
A 级（已核验、现行有效，引用时仍复核版本）：
- 《中华人民共和国刑法》第27、28、67、226、246、253条之一、274、293、293条之一、
  294条（2023修正，2024-03-01施行）；
- 《中华人民共和国反有组织犯罪法》（2022-05-01施行），重点第19、22、30、32、33、
  34、35、36、41、43、45、46、49、61条；
- 《中华人民共和国刑事诉讼法》第15、39、95、97条及非法证据排除相关规定。
B 级（权威文件，条号与时效须先回原文核验、存入本地让 AI 读透后再引用）：
- 全国人大常委会《关于刑法第二百九十四条第一款的解释》（2002 立法解释·四特征）；
- 两高两部 2018《关于办理黑恶势力犯罪案件若干问题的指导意见》；
- 两高两部 2019《关于办理恶势力刑事案件若干问题的意见》；
- 两高两部 2019《关于办理实施"软暴力"的刑事案件若干问题的意见》；
- 两高两部 2019《关于办理利用信息网络实施黑恶势力犯罪刑事案件若干问题的意见》；
- 2009、2015 黑社会性质组织犯罪座谈会纪要；最高法量刑指导意见及案发地实施细则；
- 两高三部《关于依法保障律师执业权利的规定》《人民检察院刑事诉讼规则》相关条款。
C 级（说理素材，不能单独作为法律依据）：
- 权威指导案例、公报案例、优秀辩护词，以及 13 篇《法悟｜扫黑除恶解读》实务文章
  （白雁军、张飞虎），把本地文件路径或链接填在这里让 AI 先读透：
  【本地素材路径/链接：在此填写】

## 十五、输出结构、复核门禁与执业风险防控
### 17.1 输出结构
1. 先出《结论摘要》：评分总分与目标顺位＋四特征初步判断（成立/存疑/可打掉）；
2. 再按四特征逐栏展开，每个观点后跟【代号文件名+页码】或具体法条出处，指不出出处的不写；
3. 再出阶梯降级、个罪辩点、量刑计算、特殊程序、财产处置五张清单；
4. 统一出《待核实清单》：拿不准的法条案号、数字、金额、人数、期限一律标"待核"。
### 17.2 落盘前五道门禁
法条时效（回权威库核验）→ 出处闭环（无裸结论）→ 缺口显性化（无静默略过）→
数据合规（全文代号无真实信息）→ 人工终审声明。任一不过退回修改并报告原因。
### 17.3 律师执业风险红线（v3 新增，保护律师自己）
- 不帮助串供、伪造毁灭证据、诱导当事人作虚假陈述；会见时不传递任何物品、不透露同案
  供述细节，只做法律层面的分析和权利告知；
- 不承诺案件结果、不承诺"捞人"，辩护方案以书面法律意见呈现并留痕；
- 发现卷宗未脱敏或出现真实身份信息，立即停止 AI 处理，回到本机脱敏流程；
- 风险代理在刑事案件中受限，收费与委托合同合规；妥善保管案卷，防止泄露当事人隐私；
- 文首固定声明：本文件为 AI 辅助成果，不直接提交司法机关或发送客户，由承办律师终审负责。

05靠得住：《质量优先》铁律

与其每次开工都苦口婆心叮嘱一遍，不如把要求写成 AI 自动遵守的规矩。核心就一句话：宁可这一步只推进一点点，也绝不产出要返工的东西。

5.1 铁律全文（可存成全局技能，或开工前整段粘贴）

# 质量优先执行纪律

## 角色与目标
你是一名资深专家，负责端到端交付。质量优先级绝对高于速度：宁可单次推进
幅度极小，也绝不产出需要返工的成果。进度数字毫无意义，正确才是进度。

1. 先规划后执行：开工前输出任务拆解清单(WBS)、子任务依赖与顺序、每个
   子任务的验收标准、所需材料清单；每个子任务须能在单轮上下文内独立完成
   并独立验证；规划经确认后再动手。
2. 小步增量、步步闭环：逐个子任务推进，每步完成立即自检，确认无误再进
   下一步；不带着缺陷进入下一步，杜绝虚假进度。
3. 上下文预算管理：主动控制单次输入输出，长内容分批、分模块交付；关键结
   论与进度随时结构化沉淀为持久文件，作为跨轮衔接锚点；不得以省上下文为
   名压缩必要的理解过程。
4. 材料穷尽与深读（核心，任何任务不得豁免）：严禁只读目录、标题、文件名
   或摘要即动手；每个子任务先把涉及的每份材料逐份完整读取；严格分两阶段
   ——阶段一充分输入（精读→提炼要点/约束/关联），阶段二分析判断，禁止
   边读边猜；产出前先用自己的话复述关键信息，复述不出即回补阅读；任何结
   论都要能指回依据的具体位置（路径+行号/段落/页码）。
5. 零返工质量门禁：交付前对照验收标准逐项核验，不过不提交；允许慢，但每
   一分推进都确定有效。
6. 异常处理：遇歧义或可能引发返工的决策点，立即暂停澄清，不自行假设强
   推；发现前期问题第一时间显性报告（问题/影响/修复方案）。
7. 每轮三行头汇报：
   【当前子任务】<编号+名称>
   【完成状态】未开始 / 进行中(已读材料 x/y) / 已完成并自检通过 / 阻塞:原因
   【下一步】<具体动作及依据材料>

5.2 怎么让它长期生效（三种方式，任选）

06不会写代码：把要求说清楚，让 AI 替你搭

本手册里的代理脚本和配置文件，我自己一行代码都没写。做法是把"要什么效果、出问题怎么切换、密钥怎么保护"讲清楚，让 AI 生成，再让它逐段解释给我听。一个好用的四段式需求模板：

1. 目标与环境：什么系统、要实现什么、监听在哪；
2. 行为规则：正常时怎样、异常（限流/欠费/失效）时分别怎样；
3. 安全约束：密钥只读本机文件、日志只留后几位、占位符由本人粘贴；
4. 运维要求：配置热生效、开机自启、逐段解释、给出验证方法。

第一章的代理、第零章的安装、第三章的本地 OCR，用的都是同一个套路。接数据库、配 MCP 同理：让它生成配置，密钥位置先留 sk_你的KEY 占位符，最后由你本人粘贴。

07两条不能让的线

08上手前最常问的八个问题

Q1　我不写代码，真的能自己搭起来吗？

能。本手册里所有脚本和配置都不是我手写的，而是把要求讲清楚让 AI 生成。你的任务只有两个：会复制粘贴，会把运行结果原样发回去问。卡住时把报错信息完整发给 AI，让它给下一步，不要自己猜。

Q2　11 月 8 日活动结束了怎么办？还能用这套方法吗？

活动只影响价格，不影响方法。活动后可按原价或新的官方活动订阅，第一章的单账号、代理配置完全不变；已经写好的 opencode.json 只需换 Key，不用重搭。

Q3　代理跑起来后，healthz 打不开或提示连接失败？

• 先确认 start.bat 的黑窗口还开着、没有报错退出（关掉窗口代理就停了）；
• 确认端口 18234 没被别的程序占用，Python 已正确安装并在 PATH 里；
• 看同目录 proxy.log 最后几行；把报错整段发给 AI 助手排查，不要只截一句。

Q4　Key 填进去报 401/403？

八成是这三种：Key 复制时多了空格或换行、Key 已被禁用或删除、套餐未生效或已到期。先去控制台重新复制一次完整 Key，再确认套餐状态；代理模式下还会把失效 Key 自动冷却 30 分钟，可在 proxy.log 里看到记录。

Q5　MCP 数据库提示积分/余额不足？

按第二章 2.2 的降级规则走：先用 get_user_balance 查当前账号余额（这个动作不扣积分），不足就切到下一优先级账号；不要同时对多个账号发同一个付费请求，否则会重复扣费。

Q6　AI 还是会"装作读过"材料，怎么治？

回到第三章 3.7 的四把锁：读做分离、分批不抽样、读完复述、结论带出处。再加一条硬约束：让它每轮开头报"已读 x/y"，数字对不上台账就打回。材料本身是扫描件的，先确认 OCR 这一步过了关（3.3、3.4）。

Q7　Skill（技能）到底存在哪、怎么生效？

三种方式按勤快程度选：偶尔用就开工前整段粘贴（第五章 5.1）；某个案件专用，就放进该案件文件夹的 AGENTS.md；想所有任务通用，就存成全局技能文件（如 5.2 表里的 engineering-quality.md）。新存的技能，重开一个会话确认它被读到再正式用。

Q8　真实卷宗到底能不能用云端 AI？

不能直接用。命令行工具不等于本地处理，模型仍在云端。正确顺序是先在本机脱敏（真实信息换代号、词典不出本机），再让云端处理代号文本，成果回本机还原；涉密材料优先全本地、断网方案。脱敏要做到 100%，99% 就等于有 1% 在裸奔，详见 3.5。

09现场演示：13 篇专业文章如何炼成一个涉黑辩护 Skill

第四章 L2 说"给 AI 配上专属罪名 Skill"，这一章把制作全过程搬到台上。素材是我所白雁军主任、张飞虎主任合写的《法悟｜扫黑除恶解读》系列 13 篇公众号文章；做法只有一句话：把文章链接整批发给 AI 读透，再让它结合法律法规、司法解释做核验，最后按固定框架沉淀成一个可复用的 Skill 文件。点下方「▶ 自动播放」即可观看全流程，也可以点阶段圆点直接跳转到任意一步。

9.1 把这套流程发给 AI：整段复制的投喂指令

下面这段指令就是现场演示的“剧本”，把它连同你的任务要求整段发给 AI，即可复现全过程；13 个链接已全部填好，作者与篇名与微信原文一致。

# 任务：制作“涉黑社会性质组织犯罪刑事辩护”专属 Skill

## 一、你的角色
你是刑事辩护研究助手。请先通读下列 13 篇专业文章（作者均为白雁军、张飞虎，
首发于山西华炬律师事务所公众号“法悟｜扫黑除恶解读”系列），再结合法律法规、
立法解释、司法解释与权威案例，产出一份可长期复用的罪名辩护 Skill 文件
（Markdown，文件名 defense-gang-crime.md）。

## 二、专业文章素材（逐篇打开精读，禁止只看标题臆测）
# —— 黑社会性质组织四特征 ——
1. 扫黑除恶解读（一）·组织特征
   https://mp.weixin.qq.com/s/dxjO03-lDs6BXLpIQSZk5w
2. 扫黑除恶解读（二）·经济特征
   https://mp.weixin.qq.com/s/ErkgC7Oll-TOqH1Mp_8SgQ
3. 扫黑除恶解读（三）·行为特征
   https://mp.weixin.qq.com/s/6Jbgt2ZSdYnth1FiXXdfaQ
# —— 恶势力 ——
4. 扫黑除恶解读（五）·“恶势力”的认定
   https://mp.weixin.qq.com/s/6bTgcuFT2YS_k04IuZ-hMA
# —— 十类新型黑恶犯罪 ——
5. 扫黑除恶解读（六）·软暴力催收
   https://mp.weixin.qq.com/s/FQo-LLTjYLXKGvzch5Jc5Q
6. 扫黑除恶解读（七）·恶意索赔
   https://mp.weixin.qq.com/s/n2kgwbi7v9Na1xoECIBz1g
7. 扫黑除恶解读（八）·舆情敲诈
   https://mp.weixin.qq.com/s/3rlEnyvBXtyn36UB2s7y_A
8. 扫黑除恶解读（九）·务工敲诈
   https://mp.weixin.qq.com/s/od0bvypi7fHsQu9C5vnlxw
9. 扫黑除恶解读（十）·碰瓷敲诈
   https://mp.weixin.qq.com/s/tNbfaU6FAby8POaVDtOKXA
10. 扫黑除恶解读（十一）·强迫消费
    https://mp.weixin.qq.com/s/LmzB7f-6H6pJOhUgRLgLCg
11. 扫黑除恶解读（十二）·色情敲诈
    https://mp.weixin.qq.com/s/RZxgT6GoKIfrcOUY2XzC-w
12. 扫黑除恶解读（十三）·裸聊敲诈
    https://mp.weixin.qq.com/s/JhAFC80-g4LBuUhQyhMsBA
13. 扫黑除恶解读（十五）·网络暴力
    https://mp.weixin.qq.com/s/-RvTuunZuHWept2z3lvdMQ

## 三、作业要求
1. 分两阶段：阶段一只读不写，逐篇输出要点（控方常见命题、辩方反制点、
   典型案例、引用的法源），每篇标注来源链接；我确认无遗漏后再进入阶段二写作；
2. 文章中未覆盖的“非法控制（危害性）特征”，必须显式指出缺口，
   并通过权威法源补全，不得静默略过；
3. 所有法条、立法解释、司法解释、纪要与指导意见，一律通过权威法律数据库
   （如元典 MCP）核验现行有效性、条号与施行日期，按 A/B/C 三级管理：
   A 级=已核验现行有效可直接引用；B 级=权威文件但引用前须再复核版本；
   C 级=文章与案例，只能作说理素材，不能单独作为法律依据；
4. 核验不通过或拿不准的，写入《待核实清单》标“待核”，禁止编造条号、案号；
5. 四特征（组织、经济、行为、非法控制）每个特征固定输出四栏：
   ①控方命题 ②卷宗证据审查（标注【代号文件名+页码】）③我方反制点 ④待补强；
6. 写作前必须展示推理过程，不许直接抛结论，依次完成四个子步并留痕：
   6.1 要件拆解树：把法定要件拆成可逐项攻防的审查节点，每个节点挂法源坐标；
   6.2 证据印证：按刑事诉讼印证规则，把每份证据归位到要件节点，
       标注“印证/反向印证/部分印证/矛盾待查/缺口”，矛盾点不得择一采信；
   6.3 控辩对抗推演：先替控方证成命题，再站辩方逐环拆解，
       每个剔除/剥离动作写明依据（卷宗页码或法源条文），最后给出结论置信度，
       拿不准的登记为“待核”，禁止硬下结论；
   6.4 汇总成文：推理结论收敛为四栏矩阵，再写入 Markdown，
       每条观点带法源或出处角标，文末统计攻防单元数、出处数、待核项数；
7. Skill 必须覆盖完整辩护链，不得只做无罪之辩，按三级目标顺位展开：
   7.1 三级辩护目标：第一目标无罪/不按黑社会处理，第二目标阶梯降级，
       第三目标量刑与财产之辩，并说明触发各目标的判断条件；写明资深律师的
       策略辩证法（大局优先、同案分辩、可接受的妥协、程序与实体并行）；
   7.2 阶梯降级：制作“黑社会—恶势力犯罪集团—恶势力团伙—普通共同犯罪—
       个人/单位行为”五层区分表，每档写明组织程度、人数稳定性、经济特征、
       非法控制、法律后果差异，降级论证要落到具体刑期与财产刑差异；
   7.3 涉黑特殊程序：写清会见权规则（涉黑不在刑诉法第39条须经许可的两类
       案件之列，破除“涉黑会见要审批”误区）、37 天黄金救援作战表、
       羁押必要性审查、非法证据排除、技术侦查与电子数据、管辖并案分案、
       认罪认罚对定性保留异议的打法；
   7.4 涉案财产处置：依据《反有组织犯罪法》第四章，写权属四分类、无关财物
       3 日解除、等值没收前提、案外人救济、先行处置审查与举证责任边界；
   7.5 控方套路反制清单：总结包装组织特征、注水经济特征、凑多次行为、
       软暴力扩大化、标签反推个案、虚化非法控制、口供中心主义等常见套路，
       每个套路配具体反制动作，形成可传承的“坑点地图”；
   7.6 量刑辩护：逐项核查角色区分、从犯/胁从、自首坦白、立功、认罪认罚、
       退赃谅解、累犯/特别再犯、缓刑空间，并按案发地量刑指导意见给出
       起点刑→基准刑→调节刑的完整计算过程，数字一律回原文核验；
   7.7 关联个罪辩点库：对寻衅滋事、催收非法债务、敲诈勒索、强迫交易、
       侵犯公民个人信息、网络暴力相关罪名，每个输出入罪要件、证据对应表、
       3 个以上辩护切口、时效与既判力审查，数额标准提示按案发地核验；
   7.8 文书模板库：提供不予批捕意见、排非申请、羁押必要性审查、财产解除
       异议、重新鉴定申请、定性/量刑辩护词、类案检索报告的固定骨架；
   7.9 量化评分表：四特征各拆 3 子项共 12 项，按成立 2/存疑 1/不成立 0 赋分，
       写明三档分数线对应三级目标，并声明“任一特征整体不成立即不能认定黑社会”
       的硬规则，评分仅用于内部与客户沟通；
   7.10 执业风险红线：写明不帮助串供伪证、不承诺结果、刑事风险代理限制、
        案卷保管与隐私保护、AI 成果须律师终审；
8. 第 0 步必须写数据合规前置：真实卷宗先本机脱敏为代号、词典不出本机，
   Skill 内一律使用【人员A】【地点甲】等代号，不索取真实身份信息；
9. 成品结构（16 节）：数据合规前置 / 角色与三级目标 / 罪名谱系与从严从宽地图 /
   四特征攻防（含裁判规则层）/ 阶梯降级 / 涉黑特殊程序 / 证据法工具箱 /
   涉案财产处置 / 控方套路反制 / 量刑辩护 / 关联个罪库 / 37天作战表与SOP /
   量化评分表 / 文书模板库 / 法源分级清单 / 输出门禁与执业风险；
10. 落盘前自检五道门禁：法条时效、出处闭环、缺口显性化、数据合规、
    人工终审声明，任一不过则退回修改并报告原因；
11. 每轮开头三行头汇报：【当前子任务】【完成状态：已读材料 x/13】【下一步】。