CLAUDE.md@apps/webA

CLAUDE.md@apps/web from ximing/vital is a CLAUDE.md file: the standing instructions Claude Code reads in that repo.

Install it, pinned

mdr add ximing/vital/apps/web/CLAUDE.md@git:20261021.2674a2a

Pins git:20261021.2674a2a in mdr.lock. Pin the fingerprint instead.

Audit grade: A, 14 of 14 checks passed
Kind: CLAUDE.md file
Repository: ximing/vital
Path: apps/web/CLAUDE.md
Versions recorded: 1
Latest version: git:20261021.2674a2a, committed Oct 21, 2026
Size: 2,992 bytes
Repository stars: 3
License: none declared

Collected from public GitHub. Every version is saved exactly as it was and never changes. Install it at an exact version with the mdr tool, and every file is checked before it reaches your agent. The main file is checked against the SHA-256 fingerprint recorded here, and the others against the fingerprints GitHub keeps for its source commit. The automatic checks below grade the latest version, and the same checks always give the same file the same grade.

What the file says

# `@vital/web` — Web 工作区指令

## 这个目录负责什么

- 承载 Vital 的桌面/浏览器主工作区（Vite + React 19 + Tailwind CSS v4 + `@rabjs/react` + TanStack Query，开发端口 `5180`）。
- 同时作为 `apps/desktop`（Tauri 2 桌面端）直接加载的前端界面。

## 放置约束

- **放什么**：
  - `src/features/<domain>/`：按业务域（`today`、`todos`、`inbox`、`reports`、`days`、`settings`、`agent-chat` 等）组织视图组件、领域模型、TanStack Query hooks（`queries.ts` / `query-keys.ts`）以及局部 `@rabjs/react` 服务（`*-ui.service.ts` / `*-page.service.ts`）。
  - `src/shell/`：应用骨架（`Rail` / `Library` / `Focus Canvas` / `Detail`）、导航路由守卫与全局快捷键管理。
  - `src/ui/`：跨业务域复用的基础 UI 原语（`field.tsx`、`date-field.tsx`、`time-field.tsx`、`overlay.tsx`、`confirm-dialog.tsx` 等）。
  - `src/services/`：全局应用级 `@rabjs/react` 服务（如鉴权、主题、全局查询管理）。
  - `src/copy.ts`：全局中文（`zh-CN`）界面文案集中定义。
- **不放什么**：
  - 不要把仅单个 feature 使用的私有组件或状态放进 `src/ui/` 或 `src/services/`。
  - 不要在组件里硬编码散落的中文文案或直接写死应用版本号。
  - 不要把跨端可复用的 DTO 校验或通用 Markdown / 正文解析逻辑留在 `apps/web` 内（应放到 `packages/*`）。

## 开发偏好与局部范式

1. **状态分层（TanStack Query + `@rabjs/react`）**：
   - 服务端数据拉取、缓存与变更优先走 TanStack Query（`queries.ts`）与增量同步机制。
   - 视图局部交互状态（选区、弹层开关、阅读器字号、草稿预览等）使用继承自 `Service` 的 `@rabjs/react` 服务管理，并提供 `reset()` 以便测试清理。
2. **收件箱正文缓存保护**：
…

Read the whole file at its exact version.

How to install

The exact contents, by fingerprint

mdr add ximing/vital/apps/web/CLAUDE.md@sha256:6caded06c3f498a7

The line at the top of this page pins the label git:20261021.2674a2a, which is what most people want. This one pins the sha256 fingerprint of the contents instead, so it survives a label being moved. Either way the exact version is written to mdr.lock, and mdr install downloads and checks those contents again, so it installs them exactly or stops with an error.

Badge

[![mdr](https://markdownregistry.com/badge/art_lg5q2zxuytfxztoz.svg)](https://markdownregistry.com/a/art_lg5q2zxuytfxztoz)

1 badge image fetches in 30 days. What the badge shows.

Versions

The registry has recorded 1 version of this file, committed on Oct 21, 2026.

version	committed	commit	size	audit
git:20261021.2674a2a latest	2026-10-21	2674a2a	2,992 B	A	view

Audit of the latest version

A 14 of 14 checks passed. Fixed automatic checks with no AI involved, so the same checks give the same answer every run.

pass: Size between 200 bytes and 200 KB (2992 bytes)
pass: No zero-width or bidi control characters
pass: No instruction hidden inside an HTML comment
pass: No link to an exfiltration or paste host
pass: No credential-shaped string
pass: No instruction to send local credentials anywhere
pass: No text hidden with inline styles
pass: No prompt-injection phrasing
pass: No curl or wget piped into a shell
pass: No recursive delete of root, home or parent
pass: No instruction to read or print local credentials
pass: No base64 blob over 200 characters
pass: No link to a raw IP address
pass: No script tag

Source

GitHub

ximing/vital · 3 stars · license none declared · pushed 2026-10-21 · branch main

API

GET https://markdownregistry.com/api/v1/artifacts/art_lg5q2zxuytfxztoz
GET https://markdownregistry.com/api/v1/resolve?ref=ximing/vital/apps/web/CLAUDE.md
GET https://markdownregistry.com/api/v1/blob/6caded06c3f498a772abc58948e5cce7d16bf69b739863f264ccd275feed634a

Your AI assistant does the legwork. You hear about the deals worth your word. Hand yours the standing instructions at modelranch.com and it joins the network that reads files like this one.

Guides: what a CLAUDE.md file is · keeping AGENTS.md and CLAUDE.md in sync · which agent file does what.

More from ximing/vital

ximing-progressive-project SKILL.md skill

ximing/vital · .claude/skills/ximing-progressive-project/SKILL.md · 把现有项目重构为适合 Claude Code 的持久化指令渐进式加载架构。用户提到“拆分根 CLAUDE.md”、“按目录下沉规则”、“给当前项目设计分层指令文件”、“创建不同目录的 CLAUDE.md”、“补…