dingdawg-compliance

dingdawg-compliance

Colorado SB 205 AI 法案合规扫描器。60 秒内即可运行，获取评分，并在 2026 年 6 月 30 日之前了解自身差距。

pip install dingdawg-compliance
python3 -m dingdawg_compliance scan

---

功能

Colorado SB 205 要求任何使用 AI 做出重大决策（就业、住房、信贷、保险、医疗保健、教育）的公司：

• 在部署前进行影响评估
• 在决策时向消费者披露 AI 的使用情况
• 提供申诉和人工审核机制
• 指定一名负责任 AI 官员
• 测试是否存在歧视性偏见
• 保留 3 年的审计记录

此工具会根据全部 25 项 SB 205 控制措施为你的准备情况评分。免费，无需注册，可在本地运行。

---

安装

pip install dingdawg-compliance

需要 Python 3.9+。无外部依赖——仅使用标准库。

---

用法

交互式扫描（推荐）

python3 -m dingdawg_compliance scan

逐项检查全部 25 项控制措施。针对每项回答 y/n/skip。最后获取评分。

输出示例：

──────────────────────────────────────────────────────
  Overall Score: 44/100  [████████░░░░░░░░░░░░]  NEEDS WORK
──────────────────────────────────────────────────────

  Category Scores:
    ~ scope                  100%
    ✗ impact_assessment        0%
    ✗ transparency            33%
    ✗ appeal                   0%
    ~ governance              50%
    ✗ bias_testing             0%
    ✗ data_governance          0%
    ✗ incident_response       50%
    ✓ audit                  100%

  ⚠ Critical gaps (2) — mandatory under SB 205:
    • CO-3   Pre-Deployment Impact Assessment
    • CO-6   Consumer Disclosure at Point of Decision

  Need the full remediation report?
  → dingdawg.com/compliance  (CO SB 205 gap report — $199)

根据 JSON 文件评分

python3 -m dingdawg_compliance score responses.json

responses.json 的格式：

{
  "CO-1": true,
  "CO-2": true,
  "CO-3": false,
  "CO-4": null
}

true = 已实施，false = 未实施，null = 未知（按未实施计分）。

列出全部 25 项控制措施

python3 -m dingdawg_compliance controls

---

作为库使用

from dingdawg_compliance import calculate_co_sb205_score, CO_SB_205_CONTROLS

# Score a self-assessment
responses = {
    "CO-1": True,   # scope: identified consequential decisions
    "CO-3": False,  # impact_assessment: no pre-deployment assessment yet
    "CO-6": True,   # transparency: consumer disclosure implemented
    # ... rest of controls
}

result = calculate_co_sb205_score(responses)
print(result["score"])           # 0-100
print(result["gaps"])            # list of unimplemented controls
print(result["critical_gaps"])   # CO-3, CO-6, CO-10, CO-14 if missing

在 SQLite 中跟踪评估

from dingdawg_compliance import ComplianceStore, ComplianceScorer, ComplianceFramework

store = ComplianceStore()  # stored at ~/.dingdawg/compliance/compliance.db

# Register and assess a control
store.assess_control("CO-3", status="COMPLIANT", assessor="legal-team", notes="Completed Q1 2026")

# Score
scorer = ComplianceScorer(store)
print(scorer.overall_posture_score())   # e.g. 72.0
print(scorer.per_framework_score())     # per-framework breakdown
print(scorer.gap_analysis())            # prioritized gap list

自动检查（只读）

from dingdawg_compliance import AutoAssessor
from pathlib import Path

assessor = AutoAssessor(
    base_dir=Path("./src"),
    db_paths=[Path("./data/app.db")]
)

results = assessor.run_all_checks()
print(results["checks"]["access_controls"]["summary"])
print(results["checks"]["audit_logging"]["summary"])

---

25 项 Colorado SB 205 控制措施

ID	类别	控制措施	关键
CO-1	scope	重大决策识别
CO-2	scope	高风险 AI 系统分类
CO-3	impact_assessment	部署前影响评估	★
CO-4	impact_assessment	年度影响评估审查
CO-5	impact_assessment	影响评估文档
CO-6	transparency	决策时向消费者披露	★
CO-7	transparency	披露时间
CO-8	transparency	披露内容——AI 的作用
CO-9	transparency	披露内容——使用的数据
CO-10	appeal	申诉机制	★
CO-11	appeal	人工审核选项
CO-12	appeal	退出机制
CO-13	appeal	申诉响应时限
CO-14	governance	指定负责任 AI 官员	★
CO-15	governance	AI 清单
CO-16	governance	供应商尽职调查
CO-17	governance	政策文档
CO-18	bias_testing	部署前偏见测试
CO-19	bias_testing	持续偏见监控
CO-20	bias_testing	受保护群体分析
CO-21	data_governance	训练数据文档
CO-22	data_governance	数据最小化
CO-23	incident_response	AI 事件响应计划
CO-24	incident_response	错误通知
CO-25	audit	第三方审计记录

★ 关键——必须在 2026 年 6 月 30 日之前完成整改。

---

本工具不包含的内容

此扫描器会展示要检查的内容以及你存在哪些差距。它不会生成整改计划、法规引文、证据模板或可供审计的文档。

如需包含整改指南的完整差距报告 → dingdawg.com/compliance

---

许可证

Apache 2.0——可免费使用、派生和贡献。

参与贡献

欢迎提交有关新增指标、更多框架或 CLI 改进的 PR。涉及结构调整的内容请先提交 issue。