Dear User

Dear User

你的 AI Agent 为你工作，但你们的协作效果如何？

Dear User 是一款开源工具，可审查你的 Claude Code 配置，并明确指出需要修复的内容。它会评估你们的协作情况，查找泄露的机密和配置冲突，并检查系统健康状况——所有操作都在本地进行，除非你主动分享 Wrapped 卡片，否则不会上传任何内容。

claude mcp add --scope user dearuser -- npx -y @poisedhq/dearuser-mcp@latest

然后询问 Claude：“分析我与 Claude 的协作情况”

官网： dearuser.ai · 反馈： 在 Claude 中使用 feedback 工具，或提交 issue

---

功能介绍

Dear User 是一个 MCP 服务（Model Context Protocol，也就是 Claude Code 和 Claude Desktop 使用的插件系统）。安装后，它会作为一组工具显示出来，供你的 Agent 调用。没有图形界面，无需注册，也不需要云账户。

三份本地报告、一张可分享的 Wrapped 卡片、一个反馈渠道：

工具	功能	提示词示例
collab	完整的协作报告——个性特征、0-100 分、摩擦模式和具体建议	“我的 Claude 配置有多好？”
security	查找泄露的机密、提示词注入入口，以及 Agent 约定（CLAUDE.md 或 AGENTS.md）中的规则冲突	“检查我的配置是否泄露了 API 密钥”
health	检查结构完整性——孤立的定时任务、重叠的技能、失效的钩子	“我的配置里有什么东西坏了吗？”
wrapped	Spotify 风格的可分享统计卡片——分数、计数和个性特征。可选择通过 share_report 生成公开 URL。	“生成我的 Dear User Wrapped”
feedback	向 Dear User 收件箱发送留言	“发送反馈：健康报告可以再简短一些”

另有辅助工具：onboard（7 步引导式设置）、history（不重新扫描即可查看趋势）、help（菜单）、implement_recommendation、dismiss_recommendation、share_report（仅上传 Wrapped）。

发布亮点

• 可分享的 Wrapped——运行 wrapped，然后运行 share_report，即可获取 dearuser.ai/r/<token> URL，用于分享你的统计卡片。上传前会进行匿名化处理（路径折叠为基本名称、移除电子邮件、对机密进行脱敏）。协作、安全和健康报告会保留在本地，因为其中的发现可能包含不适合自动分享的业务背景信息。
• 12 类机密扫描器——OpenAI、Anthropic、GitHub、AWS、Stripe、Slack、Google、Supabase、Vercel、私钥、通用环境变量机密、Bearer 令牌。扫描 CLAUDE.md / AGENTS.md、记忆文件、技能和钩子。
• 原生支持 AGENTS.md——与 CLAUDE.md 同级的一等输入。开箱即用，支持 Cursor、Codex、Aider、Cline、Zed，以及所有遵循 Linux Foundation 跨工具标准 的工具。同一目录下同时存在两个文件？我们会将它们合并。
• 语义冲突检测（新增）——即使规则之间没有共同关键词，也能找出相互矛盾的规则。“经常提交”与“提交前先询问”会被标记出来。
• 根据实际情况校准分数——两项研究：988 个提交了 substrate 的公开 Claude Code 配置（中位数为 32/100，最高为 63），以及 2,895 个独立的 CLAUDE.md 文件（中位数为 18，最高为 60）。对于实时评分，substrate 语料库是同类对比的基准。两项研究详见 research/calibration/。

安装

每个客户端只需一条命令。完整指南：docs/install.md。

Claude Code（CLI）

claude mcp add --scope user dearuser -- npx -y @poisedhq/dearuser-mcp@latest

之后请重启 Claude Code，让工具显示出来。

Claude Desktop——添加到 ~/Library/Application Support/Claude/claude_desktop_config.json（macOS）或 %APPDATA%\Claude\claude_desktop_config.json（Windows）：

{
  "mcpServers": {
    "dearuser": {
      "command": "npx",
      "args": ["@poisedhq/dearuser-mcp"]
    }
  }
}

Cursor、Windsurf、Cline、Zed——请参阅 docs/install.md。

可选：安装斜杠命令（完整列表请参阅命令），这样你就可以输入 /dearuser-collab，而不必用自然语言提问：

npx -p @poisedhq/dearuser-mcp dearuser-install-skills

前 5 分钟

安装后，重启客户端并依次尝试以下操作：

1. 基线扫描：

   Run Dear User collab on this project
   

   你将获得一个角色画像（Vibe Coder / Senior Developer / Indie Hacker / Venture Studio / Team Lead）、7 个类别的 0-100 分，以及 3-10 条具体建议。

2. 安全检查：

   Run Dear User security
   

   检查你的 Agent 契约（CLAUDE.md 或 AGENTS.md）、记忆、技能和钩子，查找泄露的令牌、注入入口和规则冲突。

3. 分享结果（可选）：

   Share my collab report
   

   返回一个 dearuser.ai/r/<token> 链接。上传前会进行匿名化。是否将它粘贴到任何地方由你决定。

collab 的输出示例：

Persona: Indie Hacker (87% confidence)
Score:   73 / 100

Top friction:
  • Quality Standards — no test-before-commit rule in CLAUDE.md
  • Memory Health    — 2 memory files haven't been touched in 90+ days
  • Communication    — no language preference stated (English vs Danish mixing)

Recommendations (3 shown, 5 total):
  1. Add a "Session start protocol" block to CLAUDE.md  (apply with: implement_recommendation)
  2. Rotate the OpenAI key leaked in ~/.claude/memory/api-notes.md
  3. Merge overlapping skills: deploy-check and ship-check share 80% of their rules

命令

Dear User 附带八个斜杠命令。你可以按名称向 Agent 提问；如果使用 dearuser-install-skills 安装了这些命令，也可以直接输入斜杠命令。

命令	功能
/dearuser-collab	协作分析——角色画像、7 个类别的 0-100 分，以及按优先级排序的建议。
/dearuser-health	系统健康状况——孤立任务、重叠项、过期计划、缺失的 MCP 注册信息、协调缺口。
/dearuser-security	扫描 Agent 契约中的机密、提示词注入入口和规则冲突。
/dearuser-wrapped	以 Spotify-Wrapped 风格卡片呈现可分享的协作统计数据。
/dearuser-onboard	面向首次使用者的对话式 7 步设置。
/dearuser-history	显示最近的报告、随时间变化的分数趋势，或上次运行以来的变化——无需重新扫描。
/dearuser-feedback	向 Dear User 创始团队发送简短留言（错误、请求、反馈）。
/dearuser-help	显示 Dear User 的功能，并列出所有工具。

Agent 可为你调用的三项聊天内操作：share_report（将 Wrapped 卡片上传到 dearuser.ai/r/<token>）、implement_recommendation（应用一项待处理的建议）、dismiss_recommendation（将一项建议标记为不相关）。

隐私

Dear User 以本地优先。你的扫描数据会保留在自己的计算机上：

• 系统会读取你的 Agent 契约（CLAUDE.md 或 AGENTS.md）、记忆、技能、钩子和会话元数据，但绝不会上传
• 结果存储在 ~/.dearuser/dearuser.db 中（SQLite，WAL 模式）
• 可选的本地主机仪表板从该数据库读取数据——不会传输任何内容
• Dear User 只读取会话元数据（数量、长度），绝不会读取实际对话内容
• 无需 API 密钥，无需注册，不收集遥测数据

仅在你明确触发以下操作时例外：

• share_report（仅限 Wrapped）——你的 Wrapped 卡片会先经过匿名化处理（折叠路径、移除电子邮件地址，并遮盖所有匹配我们机密模式的内容），然后上传到 dearuser.ai，以便你分享链接。不会修改你的本地数据库。你可以设置 expires_at，让链接自动过期。协作、安全和健康报告不可分享——报告中的发现可能包含业务上下文（项目名称、客户端名称、架构说明），我们认为这些内容不应出现在公开链接中。
• feedback——调用反馈工具时，你的留言会发送到我们的 Supabase 收件箱。这正是该工具的用途。我们不会附上你的扫描结果或文件，只会发送你写下的文字。

其他工具都不会传输任何内容。如果 share_report 未配置 DEARUSER_SUPABASE_URL 和 DEARUSER_SUPABASE_SERVICE_KEY，它会正常报错，Dear User 的其余功能仍可继续使用。

完整隐私详情：docs/privacy.md。

工作原理

Your files (CLAUDE.md or AGENTS.md, memory, hooks, skills, sessions)
        │
    Scanner ──► Parser ──► Engines (scoring, secrets, conflicts, health)
        │
 Persona detection → Scoring → Gap analysis → Recommendations
        │
    Feedback loop (tracks which recommendations you implemented)
        │
    ~/.dearuser/dearuser.db  ←  dashboard reads from here

• 根据你的设置识别 5 种角色画像——每种画像都有量身定制的建议
• 7 个评分类别：角色清晰度、沟通、自治平衡、质量标准、记忆健康度、系统成熟度、覆盖范围
• 反馈循环：Dear User 会记住之前给出的建议。下次运行时，它会检查你已落实哪些建议，并显示分数变化。

适用对象

• “氛围编程者” — 你向 Claude 提示需求并交付产品，但始终不太确定自己的配置是否真正正常运行。Dear User 会告诉你。
• 资深开发者 — 你想快速检查泄露的密钥、配置漂移和规则冲突，而不必搭建自定义 lint 流水线。
• 独立黑客 / 独立创始人 — 你在各个项目中积累了钩子、技能和记忆。Dear User 会指出哪些内容无人使用或相互矛盾。
• 团队负责人 — 你想在本地审计团队共享的 Agent 配置。协作、安全和健康报告会留在你的设备上；只有你的个人 Wrapped 卡片可以公开分享。

仓库布局

• mcp/ — @poisedhq/dearuser-mcp npm 包（MCP 服务）。开发说明请参阅 mcp/README.md。
• web/ — dearuser.ai 落地页和分享报告页面（Astro）。
• docs/ — 安装指南、隐私文档、各平台配置指南（适用于可选的 security 平台顾问：Supabase/GitHub/Vercel）。
• research/ — 我们愿意分享的校准数据和架构说明。

贡献

请参阅 CONTRIBUTING.md。欢迎通过 GitHub 问题和 PR 提交 Bug 报告和小型修复。

社区与支持

• GitHub Discussions — 提问、分享想法、“如何……”，以及展示成果
• GitHub Issues — 可复现的 Bug 和功能请求
• 反馈收件箱 — 私人留言；也可以在 Claude 中使用 feedback MCP 工具

链接

• dearuser.ai — 落地页
• 安装指南 · 隐私 · 平台顾问配置指南

许可证

Dear User 使用 MIT 许可证。请参阅 LICENSE。

开源核心承诺： 本仓库中的所有内容均采用 MIT 许可证，并将始终如此。如果我们今后开发团队或托管功能（代理机构仪表盘、跨项目趋势线、垂直领域专属基准），它们将位于单独的仓库中，并采用各自的许可证——绝不会从本仓库中抽取内容。