screenshot-feedback-hook-mcp: Instructions file for Claude Code

CLAUDE.md

screenshot-feedback-hook-mcp CLAUDE.md is an instructions file for Claude Code from lkh081231/screenshot-feedback-hook-mcp. It costs 2,933 tokens per session, scanned A, original, MIT.

Project instructions for a screenshot-feedback tool that lets a coding agent inspect screenshots of its output. It supports an MCP server, automatic screenshot hooks and a DeepSeek Harness plugin.

In plain words
What is it for?
Guiding work on screenshot capture for full screens or displays, MCP image retrieval, Claude Code hooks and DeepSeek Harness integration.
Why use it?
An agent working on visual interfaces or engineering drawings needs to see the rendered result, not only the source code. The instructions document how screenshots reach the agent in each supported environment.

Instructions file for Claude Code

Written for Claude Code: PostToolUse hook event. Also seen: mentions CLAUDE.md; names the TodoWrite tool; mentions Claude Code.

This is lkh081231/screenshot-feedback-hook-mcp's own configuration. It tells Claude Code how to work on screenshot-feedback-hook-mcp itself, so it is not a mod to install elsewhere. Copy it as a starting point and replace the rules that are about this project. Everything screenshot-feedback-hook-mcp configures →

Needs its repository: it reads a path above its own folder, which exists only inside the repository. The line is DSH_SCREENSHOT_CLI=../.venv/Scripts/screenshot-feedback-hook-mcp.exe npx vitest run # 真实截图集成测试(默认跳过).

Reuse

Borrowing it

Nothing to install: this file belongs to lkh081231/screenshot-feedback-hook-mcp. Take a copy, put it at the same path in your own repository, and replace the rules that are about this project with yours.

Copy the file
curl -O https://raw.githubusercontent.com/lkh081231/screenshot-feedback-hook-mcp/main/CLAUDE.md
Clone the repo
git clone --depth 1 https://github.com/lkh081231/screenshot-feedback-hook-mcp

Made for: Claude Code.

Wrote this? Show the measurements

A badge with what this costs and how it scanned, read live from this page, so it follows the numbers instead of freezing them. Markdown for a README, HTML for a documentation site or a project page.

agentmods badge for screenshot-feedback-hook-mcp CLAUDE.md

README.md
[![agentmods](https://agentmods.dev/badge/instructions/lkh081231/screenshot-feedback-hook-mcp/claude-md/github.svg)](https://agentmods.dev/instructions/lkh081231/screenshot-feedback-hook-mcp/claude-md)
Your own site
<a href="https://agentmods.dev/instructions/lkh081231/screenshot-feedback-hook-mcp/claude-md"><img src="https://agentmods.dev/badge/instructions/lkh081231/screenshot-feedback-hook-mcp/claude-md/github.svg" alt="Measured on agentmods" height="20"></a>

Or the 80×15 button, for a site that already has a row of RSS and ATOM ones. Only the verdict fits; the numbers stay here.

agentmods 80×15 button for screenshot-feedback-hook-mcp CLAUDE.md

Your own site · 80×15
<a href="https://agentmods.dev/instructions/lkh081231/screenshot-feedback-hook-mcp/claude-md"><img src="https://agentmods.dev/badge/instructions/lkh081231/screenshot-feedback-hook-mcp/claude-md.svg" alt="Reviewed on agentmods" width="80" height="20"></a>
Per session 2,933 This file is loaded in full into every session.
When invoked 2,933 The same file — it is already loaded in full.
Security scan A 0 findings. A grade says what 26 rules found in the file — not that it is safe.
Origin original No closer match found in the catalogue.
Token cost

What it costs to keep this loaded

Counted locally with the o200k_base tokenizer, which is exact for GPT models; Claude uses its own tokenizer and its counts differ. Treat this as one consistent yardstick across the catalogue rather than a bill. Prices are per million input tokens.

ModelPer sessionOnce invoked
Fable 5.1 $0.02933 $0.02933
Opus 5 $0.01466 $0.01466
Sonnet 5 $0.00587 $0.00587
Haiku 4.5 $0.00293 $0.00293

Measured 10d ago against content hash e5aa041592a4, method: parsed. Prices are Anthropic first-party input rates as of 2026-09-10, from the pricing page.

Security

Grade A, and why

screenshot-feedback-hook-mcp CLAUDE.md scanned grade A with 0 findings against 26 rules in 11 categories — prompt injection, anti-refusal, data exfiltration, privilege escalation, supply chain, agent snooping, system-prompt leakage, SSRF and excessive agency — measured 10d ago.

A static scan of the body, not an audit. Every finding is printed with the line that produced it so you can judge whether it matters here. A mod is markdown that instructs an agent; that is exactly why what it instructs is worth reading.

Nothing flagged

None of the 26 patterns this scan looks for appear in this file: no shell pipes, no recursive deletes, no credential paths, no hidden text, no instruction-override or anti-refusal phrasing, no agent-config snooping. That is not a guarantee, it is the absence of the things that are checkable.

CLAUDE.md · 107 lines

How it starts

The opening of the file, as written. The whole thing — 107 lines — stays where its author put it; the contents beside it link to each section on GitHub.

CLAUDE.md

本文件给在此仓库工作的 Claude Code 提供项目上下文与约定。

项目是什么

screenshot-feedback-hook-mcp —— 一个开源、跨平台(Windows / Linux / macOS)、低部署门槛的「截图反馈」工具,让 coding agent 在做前端设计、画工程图(EasyEDA/CAD)等任务时能看到自己产出的真实画面并据此自我纠正。 (曾用名 agent-eye,因 PyPI 相似度规则弃用;现在包名/命令名/分发名/仓库名统一为 screenshot-feedback-hook-mcp。)

核心技术现实(设计前提,勿推翻):

  • Claude Code 的 hook 只能回传文本,无法直接把图片塞进上下文(feature request anthropics/claude-code#16592 未实现)。
  • MCP 工具能回传原生图片块(FastMCP 的 Image(data=..., format=...))。
  • DeepSeek Harness 没有这条限制:它有持久图片附件服务 ctx.attachments,原生插件可以在拦截点上把截图直接变成图片块推进上下文,agent 无需主动做任何事。
  • 故采用三层架构:MCP 负责「agent 主动调用、直接拿图」;Claude Code hook 负责「操作后自动截图、回传路径让 agent 用 Read 读」;dsh 原生插件负责「手动 + 两个自动时机,直接推图片块」。

已锁定的设计决策

  • 回传机制 = MCP server + Claude Code hook + DeepSeek Harness 原生插件 三层
  • 技术栈 = Python ≥ 3.10 + uv/uvx
  • 截图库 = mss(纯 ctypes 调原生 API,Linux 无需 imagemagick),压缩用 Pillow,MCP 用 mcp(FastMCP)
  • MVP 截图范围 = 全屏 / 指定显示器;区域(坐标)、按窗口标题、URL/无头浏览器 = roadmap
  • dsh 插件 = TypeScript(Cordis 插件),npm 名 dsh-screenshot-feedback-hook-mcp,钉死 dsh v0.1.0-rc.8;截图与压缩仍全部委托 Python CLI(capture --json),TS 侧只做 dsh 接线

目录结构(目标)

screenshot_feedback_hook_mcp/
├── core/capture.py      # 截图核心:mss 抓帧 → Pillow bytes
├── core/optimize.py     # 字节预算导向:降采样(~1568px)+迭代降 JPEG 质量至 ≤~80KB
├── core/platform_check.py  # macOS 权限/Wayland 检测提示
├── server.py            # MCP server(FastMCP,take_screenshot/list_monitors)
├── cli.py               # CLI + 统一入口 entry():无参数=MCP server,带子命令=CLI
└── __init__.py
examples/                # hook 配置样例、MCP 配置样例
tests/                   # optimize 单测 + hook schema 单测 + capture 冒烟测试
pyproject.toml           # uv 管理,[project.scripts] 只暴露 screenshot-feedback-hook-mcp
dsh-plugin/              # DeepSeek Harness 原生插件(独立 npm 包,双面:Host + 浏览器)
├── src/config.ts        # Schemastery Config,同时充当 settings 命名空间的 schema
├── src/capture.ts       # spawn Python CLI(--json) → ctx.attachments.saveImage
├── src/route.ts         # 图片能力闸门 + 换 provider 提示文案
├── src/content.ts       # 规范值 ↔ 图片块/插件来源消息 的共享投影
├── src/tools.ts         # take_screenshot / list_monitors
├── src/auto.ts          # tools/post-execute 与 agent/turn-stopping
├── src/index.ts         # Host 半侧:installSettingsSection + 注册工具/自动时机
├── src/client/          # 浏览器半侧:设置页那张卡片(React)
│   ├── card-form.ts     #   自己的暂存表单 + revision 设栅(不能 import dsh 那份)
│   ├── controller.ts    #   settings scope ↔ 表单,CARD_FIELDS 决定卡片长什么样
│   └── ScreenshotCard.tsx
├── tsdown.config.ts     # 复刻 dsh 未发布的 clientBundle 产物格式
└── cordis.patch.yml     # 组合包 patch 层(package.json 的 dsh.bundle 指向它)

Read the full file on GitHub · 107 lines

Changes

What this file has done since we first saw it

Hashed on every crawl. A supply-chain change to an agent config is a question of when, not whether, so the history is kept rather than the latest state alone.

  1. 10d ago First seen · 107 lines · 2,933 tokens per session scan A e5aa041592a4

Subscribe to this mod's changes

screenshot-feedback-hook-mcp CLAUDE.md is an instructions file published in the GitHub repository lkh081231/screenshot-feedback-hook-mcp (3 stars, last pushed 10d ago), licensed MIT. It adds 2,933 tokens to every session, about $0.0147 per session on Opus 5. A static security scan graded it A with 0 findings. No closer match exists in the catalogue, so it is treated as the original; first seen 2026-08-31.

Related

Other instructions, from other repositories

next.js AGENTS.md

AGENTS.md instructions for vercel/next.js, covering next.js development guide, codebase structure, monorepo overview, core package: packages/next and other important packages.

vercel/next.js · 7,296 tokens

codex AGENTS.md

AGENTS.md instructions for openai/codex, covering rust/codex-rs, the codex-core crate, code review rules, crate api surface and model visible context.

openai/codex · 5,153 tokens

vscode buildNext.instructions.md

Working notes and architecture documentation for the new esbuild-based build system in build/next. Use when making changes to the new build pipeline (transpile/bundle commands, NLS plugin, source-map handling, resource copying, or self-hosting watch tasks).

microsoft/vscode · 6,785 tokens

spec-kit AGENTS.md

AGENTS.md instructions for github/spec-kit, covering agents.md, about spec kit and specify, quickstart — add a new integration in 5 steps, integration architecture and integrationmanifest — file tracking.

github/spec-kit · 7,104 tokens

vscode oss-third-party-notices.instructions.md

Instructions for microsoft/vscode, covering vs code oss third-party-notices pipeline, architecture, pipeline flow in ci, applying the notice (cutover) and fallback chain (never fail the build).

microsoft/vscode · 5,001 tokens

langchain AGENTS.md

AGENTS.md instructions for langchain-ai/langchain, covering global development guidelines for the langchain monorepo, corridor security analysis, project architecture and context, monorepo structure and development tools & commands.

langchain-ai/langchain · 4,469 tokens