Un-Default

Un-Default

为每种构建方式提供一次深思熟虑的语言检查。

原名为 Anti-Default。工具不变——新名称表达的是撤销默认设置， 而不是反对任何人。旧 URL darkai.ca/anti-default 会重定向到此处。 npx anti-default 仍可作为 npx -y anti-default 的别名使用。

Un-Default 会检查文案、文档、UI 字符串和实时页面，查找种族主义默认设置、 性别歧视假设、健全主义隐喻和有记录的暗语。 它会说明发现的问题，并提供更清晰的替代表述。

无需账户。匹配无需 AI。开放规则，可自行调整。

Claude 写完 UI 文案之后 · 试用 Web 应用 · 添加 Chrome 扩展程序 · 在 GitHub 上点 Star

---

Claude / Cursor 写完 UI 文案之后

一条命令——技能 + MCP + PR 检查。这是能坚持下来的习惯：

npx -y anti-default init

这还会写入 examples/un-default-demo.md，并打印示例扫描结果，让你立即看到一项发现。浏览器演示（可分享）：/?demo=1。

或者从此仓库的市场安装 Claude Code 插件：

claude plugin marketplace add NomadBuilder/un-default
claude plugin install un-default@un-default

可直接粘贴的 MCP JSON 和 Claude Project 指令：

https://darkai.ca/un-default/for-agents/

目录检查清单：docs/PUBLISH-DIRECTORIES.md

粘贴 MCP 配置（Cursor · Claude Desktop · Claude Code）

{
  "mcpServers": {
    "un-default": {
      "command": "npx",
      "args": ["-y", "anti-default", "mcp"]
    }
  }
}

主机	配置位置
Cursor	.cursor/mcp.json（由 init 写入）或 Settings → MCP
Claude Desktop	Settings → Developer → Edit Config → claude_desktop_config.json（合并配置、退出并重新启动）
Claude Code	插件市场（上文），或通过 init 创建 .mcp.json，或运行 claude mcp add

工具：un_default_scan · un_default_fix · un_default_feedback

---

不到一分钟即可添加

npx -y anti-default .

本地设置就这些。它会打印发现结果，并在发现明确问题时以非零状态退出。模糊匹配或引用内容中的匹配仅作提示。

要在团队项目中固定使用它：

npm install --save-dev anti-default

想要完整的项目设置？

npx -y anti-default init

init 会添加忽略文件、用于检查已更改文件的 GitHub 工作流、Cursor + Claude 技能、.cursor/mcp.json + .mcp.json、Claude/Cursor 编辑后钩子、 CLAUDE.md 指令，以及 inclusive-check / inclusive-fix 脚本。 不会覆盖现有文件。钩子会在 Edit/Write 后将严重问题反馈给 Agent， 让 Claude 持续检查，即使没人记得要检查也是如此。

AI 文案习惯（完成定义）

npx -y anti-default fix .          # safe 1:1 autofixes only
npx -y anti-default .              # remaining findings

在严重问题得到解决或在上下文中明确标记为可接受之前，Agent 不应将 UI/文档工作标记为完成。轻微或编码类命中仅作提示。

# Preview autofixes without writing
npx -y anti-default fix . --dry-run

# Intentional language — suppress locally + share structured feedback
npx -y anti-default feedback --kind fine_in_context \
  --rule guys-generic --match "guys" --context "…snippet…" \
  --note "Quoted lyric" --open-issue

MCP 服务

npx -y anti-default mcp

针对特定主机的粘贴步骤，请参阅 for-agents。

按照你的工作方式扫描

# Paths
npx -y anti-default ./src ./docs README.md

# CI formats
npx -y anti-default . --format json  -o report.json
npx -y anti-default . --format sarif -o results.sarif

# Batch URLs — no Review UI
npx -y anti-default --urls https://example.com https://example.com/about
npx -y anti-default --urls-file urls.txt --format json

# Only files changed in this branch
npx -y anti-default . --changed-from origin/main

# Keep existing findings quiet; report only new ones
npx -y anti-default baseline .

忽略无关内容

提交 .undefaultignore，避免第二天的噪声淹没团队（示例）：

node_modules/
vendor/
*.min.js
rule:guys          # turn off one rule for this repo

---

GitHub Action

不要让种族主义、性别歧视和健全主义默认设置进入 PR 流程。此工具只扫描已更改的文件，发现明确的新问题时会失败，并留下检查清单评论：

# .github/workflows/un-default.yml
name: Un-Default
on: [pull_request]
permissions:
  contents: read
  pull-requests: write
  security-events: write

jobs:
  scan:
    runs-on: ubuntu-latest
    steps:
      - uses: actions/checkout@v4
        with:
          fetch-depth: 0
      - uses: NomadBuilder/un-default@v1
        with:
          changed-from: ${{ github.event.pull_request.base.sha }}
          format: json
          comment-on-pr: "true"
          # telemetry: false   # opt out of anonymous action_run pings

更倾向于使用 Code Scanning 的 SARIF 格式？设置 format: sarif 和 output-file: un-default.sarif。完整输入参数：action.yml。

匿名 Action 请求（不含仓库名称或发现结果）会计入公开统计数据，见 darkai.ca/un-default/usage。徽章：

![Un-Default CI runs](https://darkai.ca/un-default/api/badge/action_run.svg)

---

Agent 技能

npx -y anti-default init 会安装 .cursor/skills/un-default/SKILL.md——AI 生成文案的完成标准工作流：修正 → 扫描 → 提问或反馈 → 重新扫描。

来源：skills/un-default/SKILL.md · 反馈模型：feedback/README.md

---

将其用作库

这个 npm 包没有运行时依赖，并提供与 CLI 和 Web 应用相同的分析器：

import { analyzeText, LANGUAGE_RULES } from "anti-default";

const result = analyzeText("Welcome, you guys.");
console.log(result.findings);

---

Chrome 扩展

规则与应用相同——可直接在你正在浏览的页面上使用。

添加到 Chrome →

从捆绑的规则列表离线运行。无跟踪。无 AI 调用。
开发 / 解包：npm run extension:pack → 加载未打包的扩展程序 → extension/ · 详情见 extension/README.md

Web 应用——试用、学习、调整

darkai.ca/un-default

• 审阅——粘贴、上传或扫描 URL；导出 Markdown、CSV 或检查清单
• 替换——将一个短语改写成更清晰的替代说法
• 隐晦暗示——了解短语可能传达的含义，以及上下文何时会产生影响
• 规则——根据你的项目调整开放规则目录

npm install && npm run dev   # localhost:3000

---

团队为何选择它

• 发布前——发现营销文案、文档和产品文案中的默认表达
• 在 PR 中——通过 Action + SARIF/JSON，同时向机器和人发出提示
• 在上线页面上——为从不打开终端的写作者提供扩展
• 无需说教——建议只是供参考，具体情境始终优先

每条建议都会注明背后的风格指南和参考资料 → /sources

---

自定义和自托管

• 在界面中调整：/rules · 编辑代码：src/lib/rules.ts
• 实践语料库：npm run corpus
• 静态导出：npm run build → out/
  子路径（DarkAI）：STATIC_EXPORT=true BASE_PATH=/un-default npm run build

生产环境部署在 darkai.ca/un-default，也作为供应代码集成在 DarkAI 中。

许可证

MIT