# https://github.com/maxkle1nz/m1nd 项目说明书
生成时间：2026-07-30 09:33:25 UTC
## 目录
- [项目概览](#page-overview)
- [Lib 模块](#page-m1nd-ui-src-lib)
- [Lib 模块](#page-npm-lib)
- [Lib 模块](#page-m1nd-demo-src-lib)
## 项目概览
### 相关页面
相关主题：[Lib 模块](#page-m1nd-ui-src-lib)
相关源码文件
以下源码文件用于生成本页说明：
- 资料来源： [README.md](https://github.com/maxkle1nz/m1nd/blob/main/README.md)
- 资料来源： [m1nd-demo/package.json](https://github.com/maxkle1nz/m1nd/blob/main/m1nd-demo/package.json)
- 资料来源： [m1nd-ui/package.json](https://github.com/maxkle1nz/m1nd/blob/main/m1nd-ui/package.json)
- 资料来源： [package.json](https://github.com/maxkle1nz/m1nd/blob/main/package.json)
- 资料来源： [skills/README.md](https://github.com/maxkle1nz/m1nd/blob/main/skills/README.md)
summary>
以下源码文件用于生成本页说明：
- [README.md](https://github.com/maxkle1nz/m1nd/blob/main/README.md)
- [package.json](https://github.com/maxkle1nz/m1nd/blob/main/package.json)
- [m1nd-demo/package.json](https://github.com/maxkle1nz/m1nd/blob/main/m1nd-demo/package.json)
- [m1nd-ui/package.json](https://github.com/maxkle1nz/m1nd/blob/main/m1nd-ui/package.json)
- [skills/README.md](https://github.com/maxkle1nz/m1nd/blob/main/skills/README.md)
# 项目概览
m1nd 是一个面向编码代理（coding agents）的**操作性智能层（operational intelligence）**，通过 MCP（Model Context Protocol）协议为代理提供代码库的结构化情报、目标导向的关注点（attention）路由以及对未校准结论的诚实拒答能力。项目核心理念是"诚实的『不知道』优于自信的猜测"，所有结论都附带可信度评分，避免给代理传递幻觉信息。资料来源：[README.md:1-40]()
## 核心定位与设计原则
m1nd 不是一个检索增强生成（RAG）框架，而是一个**预定向（pre-orient）→ 校准执行（act on calibrated verdicts）→ 经验沉淀（capture what you learned）**的闭环系统。在 v1.2.0 进入 OMEGA 时代后，这一取代了纯"检索然后祈祷"的旧模式。资料来源：[README.md:42-60]()
设计原则体现在三个层面：
- **信任层**：响应附带 `confidence` 分数，低于阈值时直接返回 `unknown` 而不是伪造答案
- **关注层**：通过 `focus` 接口实现目标条件化的注意力运行时，仅返回代理当前任务所需的最小代码子集
- **人类层**：在 v1.4.0 引入"trees manager"（项目管理区），将单棵代码树拓展为多项目工作区
## 仓库结构与组件
m1nd 采用 monorepo 结构，顶层 `package.json` 用于统一管理工作区的 npm 子包与脚本。资料来源：[package.json:1-30]()
主要子项目包括：
| 子包 | 角色 | 运行时 |
|------|------|--------|
| `m1nd-core` | Rust 核心库，处理图谱（Graph）、解析、最终化（finalize）等底层逻辑 | Rust crate |
| `m1nd-ingest` | 仓库扫描与索引构建，对应 v0.9.0-beta.8 修复的 `Graph::finalize()` 边丢失问题 | Rust crate |
| `m1nd-mcp` | MCP 协议服务端，暴露 `impact` / `seek` / `focus` / `why` / `north` 等工具 | Rust crate → npm |
| `m1nd-ui` | 浏览器端可视化界面，依赖 lodash 4.18.1（v1.0.0 升级自 4.17.23） | TypeScript / Vite |
| `m1nd-demo` | 演示用站点，dev 依赖使用 Vite 7.3.2 | TypeScript / Vite |
资料来源：[m1nd-ui/package.json:1-25](); [m1nd-demo/package.json:1-25]()
## 核心能力接口
m1nd 通过 MCP 暴露给代理的接口可归纳为四类，每一类都对应不同的代理意图：
- **结构查询**：`impact`（影响面分析）、`why`（调用原因链）；
- **探索查询**：`seek`（按目标查找节点），v0.9.0-beta.8 修复后能正确看到物化边；
- **注意力**：`focus` —— v1.1.0 引入的目标条件化注意力运行时，返回预算受限的最小代码子集；
- **方向导航**：`north` —— v1.2.1 开启"复合（compounding）"循环后的方向锚点。
所有响应都遵循"诚实优于猜测"的原则：当调用方超出绑定仓库范围时，v1.4.0 引入的 **degraded mode**（降级模式）会返回降级答复而非保持沉默。资料来源：[README.md:60-90]()
## 发布与社区反馈通道
m1nd 在 crates.io 与 npm 上同步发布，版本同步从 v1.2.0 起的 `m1nd-core` / `m1nd-ingest` / `m1nd-mcp` 三包同号。社区反馈通过本地邮箱 `~/.m1nd/field-reports.jsonl` 收集，**不进行远程上报**（"m1nd never phones home"），v1.2.1 的"field-triage patch"即基于该邮箱的四条告警逐一转成红盒测试用例再修复。资料来源：[README.md:90-110](); [skills/README.md:1-30]()
最新版本 v1.5.0 主要补全了人类视图的诚实 medulla 卡片、按类别着色的色块以及供编码代理使用的厂商中立工作指南 `AGENTS.md`。
```mermaid
flowchart LR
Agent[编码代理] -->|MCP 调用| m1ndMCP[m1nd-mcp]
m1ndMCP --> m1ndCore[m1nd-core / m1nd-ingest]
m1ndCore --> Graph[(结构图谱)]
m1ndMCP -->|confidence 校准| Agent
m1ndUI[m1nd-ui 可视化] --> m1ndCore
m1ndDemo[m1nd-demo 演示] --> m1ndCore
---
## Lib 模块
### 相关页面
相关主题：[项目概览](#page-overview), [Lib 模块](#page-npm-lib)
相关源码文件
以下源码文件用于生成本页说明：
- [m1nd-ui/src/lib/alerts.test.ts](https://github.com/maxkle1nz/m1nd/blob/main/m1nd-ui/src/lib/alerts.test.ts)
- [m1nd-ui/src/lib/alerts.ts](https://github.com/maxkle1nz/m1nd/blob/main/m1nd-ui/src/lib/alerts.ts)
- [m1nd-ui/src/lib/api.ts](https://github.com/maxkle1nz/m1nd/blob/main/m1nd-ui/src/lib/api.ts)
- [m1nd-ui/src/lib/buildMap.test.ts](https://github.com/maxkle1nz/m1nd/blob/main/m1nd-ui/src/lib/buildMap.test.ts)
- [m1nd-ui/src/lib/buildMap.ts](https://github.com/maxkle1nz/m1nd/blob/main/m1nd-ui/src/lib/buildMap.ts)
- [m1nd-ui/src/lib/buildReplayFrames.ts](https://github.com/maxkle1nz/m1nd/blob/main/m1nd-ui/src/lib/buildReplayFrames.ts)
# Lib 模块
## 概述与定位
`m1nd-ui/src/lib/` 是 m1nd 前端可视化子系统（m1nd-ui）的**纯逻辑层**。它不渲染 UI，而是把后端 MCP / core 接口的原始数据加工成视图所需的数据形状（如代码结构图、回放帧、告警集合），并集中处理跨组件复用的领域规则（"诚实沉默"、越界降级、可信评分）。该模块是 m1nd v1.4.0 引入 degraded mode、v1.5.0 人类视图（medulla card）等特性的逻辑承载层。资料来源：[m1nd-ui/src/lib/api.ts](https://github.com/maxkle1nz/m1nd/blob/main/m1nd-ui/src/lib/api.ts)。
## 核心子模块
### API 客户端 (`api.ts`)
`api.ts` 封装了与 `m1nd-mcp`、`m1nd-core` 之间的请求边界。它处理身份、路径归一化（Windows 盘符已在 v0.9.0-beta.8 修复）、错误归一化，并向上层返回**带可信度标记**的结果，而不是裸 JSON——这与项目"诚实无可信数据时沉默"的原则一致。v1.4.0 的 degraded mode（§9.5）通过此层把"调用者位于绑定仓库之外"这一事实转化为可被 UI 解释的返回结构，而非静默失败。资料来源：[m1nd-ui/src/lib/api.ts](https://github.com/maxkle1nz/m1nd/blob/main/m1nd-ui/src/lib/api.ts)。
### 告警计算 (`alerts.ts` + `alerts.test.ts`)
`alerts.ts` 负责从结构图与回放数据中**派生**告警集合，而不是直接消费后端推送。它的纯函数风格使得 `alerts.test.ts` 能以"红电池"方式覆盖边界（如零边图、回放帧缺失、跨语言调用节点的解析降级）。v1.2.1 的 field-triage 闭环即在此层沉淀：用户本地报错 → 规则更新 → 测试固化。资料来源：[m1nd-ui/src/lib/alerts.ts](https://github.com/maxkle1nz/m1nd/blob/main/m1nd-ui/src/lib/alerts.ts)、[m1nd-ui/src/lib/alerts.test.ts](https://github.com/maxkle1nz/m1nd/blob/main/m1nd-ui/src/lib/alerts.test.ts)。
### 代码地图构建 (`buildMap.ts` + `buildMap.test.ts`)
`buildMap.ts` 将 ingest 输出转化为可视化的节点/边集合。它实现 `Graph::finalize()` 之后的**投影层**——v0.9.0-beta.8 修复的"重 finalize 丢弃边"问题在这一层也有镜像处理，避免 UI 在已有素材的情况下仍显示空图。它还负责 v1.5.0 pastel 字母盒（per-class letter boxes）的字母与配色分配。资料来源：[m1nd-ui/src/lib/buildMap.ts](https://github.com/maxkle1nz/m1nd/blob/main/m1nd-ui/src/lib/buildMap.ts)、[m1nd-ui/src/lib/buildMap.test.ts](https://github.com/maxkle1nz/m1nd/blob/main/m1nd-ui/src/lib/buildMap.test.ts)。
### 回放帧构建 (`buildReplayFrames.ts`)
`buildReplayFrames.ts` 把会话事件流按时间维度切片为"帧"，供时间轴组件消费。这一文件与 `focus` attention runtime（v1.1.0）配合，决定每一帧上重点呈现的节点与边。资料来源：[m1nd-ui/src/lib/buildReplayFrames.ts](https://github.com/maxkle1nz/m1nd/blob/main/m1nd-ui/src/lib/buildReplayFrames.ts)。
## 数据流与架构
下表刻画了 `lib/` 在 m1nd-ui 数据管道中的位置：
| 阶段 | 输入 | 模块 | 输出 |
|------|------|------|------|
| 拉取 | HTTP/SSE | `api.ts` | 归一化 + 可信度标记 |
| 派生 | 原始结构数据 | `buildMap.ts` | 节点/边集 + 字母配色 |
| 派生 | 事件流 | `buildReplayFrames.ts` | 时序帧 |
| 派生 | 图 + 帧 | `alerts.ts` | 告警集合 |
组件层只依赖 `lib/` 暴露的函数与类型，不直接接触后端协议——这也是 m1nd-ui 能在 m1nd-viz 与 m1nd-demo 之间复用的根本原因。资料来源：[m1nd-ui/src/lib/api.ts](https://github.com/maxkle1nz/m1nd/blob/main/m1nd-ui/src/lib/api.ts)。
## 测试与可信赖性
`lib/` 下每个非平凡文件都配有 `*.test.ts`（`alerts.test.ts`、`buildMap.test.ts`），与 m1nd "测量优于断言" 的方法论一致：先有红色用例，再有实现，再有 release note（如 v1.2.1 的四连闭环）。资料来源：[m1nd-ui/src/lib/alerts.test.ts](https://github.com/maxkle1nz/m1nd/blob/main/m1nd-ui/src/lib/alerts.test.ts)。
## 关联与边界
- 与 `m1nd-mcp` 的通信契约集中在 `api.ts`；当 MCP 后端 schema 演进时，`lib/` 是首选适配点。
- v1.4.0 的 degraded mode 与 v1.5.0 的 honest medulla card 都是先在 `lib/` 中实现**判断逻辑**，再被视图层消费。
- `lib/` 不持有长期状态；会话状态由专用的 storage 模块管理，避免与派生逻辑混淆。
---
## Lib 模块
### 相关页面
相关主题：[Lib 模块](#page-m1nd-ui-src-lib), [Lib 模块](#page-m1nd-demo-src-lib)
相关源码文件
以下源码文件用于生成本页说明：
- [npm/lib/agent-cli.js](https://github.com/maxkle1nz/m1nd/blob/main/npm/lib/agent-cli.js)
- [npm/lib/agent-schemas.js](https://github.com/maxkle1nz/m1nd/blob/main/npm/lib/agent-schemas.js)
- [npm/lib/cli.js](https://github.com/maxkle1nz/m1nd/blob/main/npm/lib/cli.js)
- [npm/lib/mcp-runtime-client.js](https://github.com/maxkle1nz/m1nd/blob/main/npm/lib/mcp-runtime-client.js)
- [npm/bin/m1nd.js](https://github.com/maxkle1nz/m1nd/blob/main/npm/bin/m1nd.js)
- [npm/package.json](https://github.com/maxkle1nz/m1nd/blob/main/npm/package.json)
# Lib 模块
## 概述与定位
`npm/lib/` 是 m1nd 在 npm 分发渠道中的 JavaScript 运行时层，承担"薄壳 + 适配器"的职责：把 Rust 编写的核心能力（`m1nd-core` / `m1nd-ingest` / `m1nd-mcp`，见 v1.2.0 发布说明）以可执行命令和结构化 JSON 的形式暴露给终端用户与编码代理（coding agent）。这一层不重新实现代码智能逻辑，而是负责进程拉起、参数解析、协议适配与冷启动协调——例如 v1.3.2 中"npm 冷启动漏斗"的修复就是在这里把 `--version` 标志与运行时获取路径对齐的。
资料来源：[npm/package.json:1-40]()
## 核心组件
### CLI 入口与子命令分发
`npm/bin/m1nd.js` 是 `package.json` 中 `bin` 字段指向的入口，它加载 `npm/lib/cli.js` 完成真正的命令路由。`cli.js` 负责把 `process.argv` 解析为 m1nd 子命令（如 `north`、`impact`、`why`、`focus`、`seek`），并在用户调用任何需要 Rust 二进制的子命令时拉起对应进程。
资料来源：[npm/bin/m1nd.js:1-30]() [npm/lib/cli.js:1-60]()
### Agent CLI — 面向编码代理的薄壳
`agent-cli.js` 是给编码代理（如 Claude Code、Cursor 等）调用的专用入口。它在标准 CLI 的基础上做了三件事：
1. 强制输出机器可读的 JSON（而不是给人看的彩色文本），便于代理直接解析；
2. 注入 `--repo ` 之类的隐式上下文，省去代理记忆路径的负担；
3. 在 v1.4.0 引入的"双层 §9.5 降级模式"中，当调用方位于绑定仓库之外时返回诚实的"未知"响应，而非伪造结果。
资料来源：[npm/lib/agent-cli.js:1-80]()
### Agent Schemas — 结构化契约
`agent-schemas.js` 用 JSON Schema 描述所有面向代理的输出形状（节点、边、impact 报告、verdict 等）。这一层是"信任层"的载体：代理消费的不是自由文本，而是带类型校验的结构化数据，因此一个不诚实的 *no* 才能压过一个自信的猜测（brand gate G1，v1.3.0 移除"未测量的节省量包络"那次提交即围绕此原则）。
资料来源：[npm/lib/agent-schemas.js:1-120]()
### MCP Runtime Client
`mcp-runtime-client.js` 实现 Model Context Protocol 客户端：它通过 stdio 或 socket 与本地 `m1nd-mcp` 守护进程对话，把代理的 `tools/call` 翻译成 m1nd 的内部请求，并把响应按 `agent-schemas.js` 定义的形状回传。v0.9.0-beta.8 修复的"`Graph::finalize()` 重复终结时丢弃物化边"问题，正是这条链路上能被观察到的——MCP 运行时曾因此返回近空的结构图。
资料来源：[npm/lib/mcp-runtime-client.js:1-100]()
## 模块协作流程
下面用一个最小调用追踪说明 `lib/` 内部各文件的协作方式：
```mermaid
sequenceDiagram
participant Agent as Coding Agent
participant Bin as bin/m1nd.js
participant CLI as lib/cli.js
participant ACli as lib/agent-cli.js
participant Schemas as lib/agent-schemas.js
participant MCP as lib/mcp-runtime-client.js
Agent->>Bin: 启动 `m1nd focus "目标"`
Bin->>CLI: 加载并分发子命令
CLI->>ACli: 走代理分支
ACli->>MCP: tools/call(focus, ...)
MCP->>Schemas: 按 schema 校验响应
Schemas-->>Agent: 结构化 JSON verdict
```
冷启动场景下，`cli.js` 会先按 v1.3.2 的修复路径自检本地 Rust 运行时版本（`--version` 探测），缺失时主动拉取与本 npm 包版本对齐的二进制，而不是沿用环境中残留的旧版（曾导致 fresh install 拿到 `0.9.0-beta.6`）。
资料来源：[npm/lib/cli.js:60-140]() [npm/lib/mcp-runtime-client.js:100-180]()
## 设计要点与边界
- **不做代码分析**：`lib/` 中没有任何 AST、调用图或解析器；分析职责完全委托给 `m1nd-core` / `m1nd-ingest`。
- **进程边界即信任边界**：所有越过 JS↔Rust 边界的数据都经过 `agent-schemas.js` 校验，使得 v1.2.1 提出的"现场分诊—红盒用例—修复"闭环能在代理侧复现。
- **人类视图与代理视图分离**：`agent-cli.js` 与 `cli.js` 各自负责不同消费者，v1.5.0 的"诚实髓质卡 + 按类别柔和着色字母盒"的人类视图改造只在人类分支生效，不污染代理契约。
- **本地优先**：`lib/` 内的所有 I/O 都指向 `~/.m1nd/`（如 `field-reports.jsonl`），m1nd 不会回拨远端——这是 v1.2.1 发布说明中明示的隐私承诺。
资料来源：[npm/lib/agent-cli.js:80-160]() [npm/lib/agent-schemas.js:120-200]() [npm/lib/cli.js:140-220]()
---
## Lib 模块
### 相关页面
相关主题：[Lib 模块](#page-npm-lib)
相关源码文件
以下源码文件用于生成本页说明：
- [m1nd-core/src/lib.rs](https://github.com/maxkle1nz/m1nd/blob/main/m1nd-core/src/lib.rs)
- [m1nd-ingest/src/lib.rs](https://github.com/maxkle1nz/m1nd/blob/main/m1nd-ingest/src/lib.rs)
- [m1nd-mcp/src/lib.rs](https://github.com/maxkle1nz/m1nd/blob/main/m1nd-mcp/src/lib.rs)
- [m1nd-demo/src/lib/utils.ts](https://github.com/maxkle1nz/m1nd/blob/main/m1nd-demo/src/lib/utils.ts)
- [m1nd-ui/src/lib/index.ts](https://github.com/maxkle1nz/m1nd/blob/main/m1nd-ui/src/lib/index.ts)
- [m1nd-viz/src/lib/render.ts](https://github.com/maxkle1nz/m1nd/blob/main/m1nd-viz/src/lib/render.ts)
- [m1nd-core/Cargo.toml](https://github.com/maxkle1nz/m1nd/blob/main/m1nd-core/Cargo.toml)
# Lib 模块
`m1nd` 是一个面向编码代理（coding agents）的"运营智能"系统，整体由多个 crate（Rust 库）与前端组件构成。其中 "Lib 模块" 是一个泛称，覆盖项目内所有作为可复用库被引用的代码单元：包括后端的 Rust 核心 crate，以及前端 `src/lib/` 目录下的 TypeScript 工具集。这些 Lib 模块共同支撑 `m1nd-core` / `m1nd-ingest` / `m1nd-mcp` 三大 Rust crate 以及 `m1nd-ui` / `m1nd-viz` / `m1nd-demo` 三个前端组件的运行。
## 模块定位与职责分层
Lib 模块按运行时被划分为两层：Rust 层负责代码结构图、注意力运行时与 MCP 协议适配；TypeScript 层负责演示与可视化中的格式化、状态管理与渲染辅助。这种分层使得核心算法（trust layer、attention、graph）可以独立演进，而前端 UI 只消费其暴露的接口。
- **Rust Lib 层**：发布到 crates.io 的三个 crate 各自封装一组领域能力。
- **TS Lib 层**：每个前端 workspace 都维护一个 `src/lib/`，统一放置与 UI 框架无关的纯函数或渲染逻辑。
资料来源：[m1nd-core/Cargo.toml:1-30]()
## 核心 Rust 库
Rust 一侧的三个 crate 在 v1.2.0 之后均同步升至 `1.2.0`，并在 v1.5.0 之前保持兼容演进。它们通过 Cargo 工作区共享依赖，并以 `lib.rs` 作为模块聚合入口：
- **`m1nd-core`**：实现代码结构图（`Graph`）、函数级调用图以及 `impact` / `why` / `focus` 等查询原语。在 v1.1.0 中引入目标条件化的注意力运行时，并以 `Graph::finalize()` 为入口完成边的物化——v0.9.0-beta.8 曾修复该方法在重复 finalize 时丢失已物化边的回归。
- **`m1nd-ingest`**：负责仓库解析、跨文件符号解析与依赖图构建。它把原始源码转换为 `m1nd-core` 可消费的图节点/边。
- **`m1nd-mcp`**：基于 Model Context Protocol 暴露运行时，使外部编码代理能通过标准化接口调用 `north` / `focus` / `impact` 等查询。v1.4.0 起增加"降级模式"（two-tier §9.5），对绑定仓库外的调用方返回诚实响应而非静默。
资料来源：[m1nd-core/src/lib.rs:1-40]()、[m1nd-ingest/src/lib.rs:1-40]()、[m1nd-mcp/src/lib.rs:1-40]()
## 前端 TypeScript Lib
前端每个 workspace 在 `src/lib/` 下维护无副作用、可独立测试的工具模块，便于在演示、可视化与未来扩展之间复用：
- **`m1nd-demo/src/lib/utils.ts`**：演示页的辅助函数集合，例如路径归一化、Windows 盘符路径解析（修复自 v0.9.0-beta.8）以及快照捕获时的路径脱敏（v1.5.0 测试修复）。
- **`m1nd-ui/src/lib/index.ts`**：UI 组件库的入口聚合，统一导出字母盒（letter boxes）、"诚实髓质卡"（honest medulla card，v1.5.0）等可复用视图原语。
- **`m1nd-viz/src/lib/render.ts`**：图形/树视图的渲染辅助，提供类级别配色与边/节点绘制逻辑，被 v1.5.0 的"pastel-per-class letter boxes"所依赖。
资料来源：[m1nd-demo/src/lib/utils.ts:1-40]()、[m1nd-ui/src/lib/index.ts:1-30]()、[m1nd-viz/src/lib/render.ts:1-30]()
## 模块协作与数据流
下表概括三类 Lib 模块在 `m1nd` 主流工作流（"pre-orient → act on calibrated verdicts → capture"）中的角色分工：
| 模块 | 输入 | 核心能力 | 输出 |
|---|---|---|---|
| `m1nd-ingest` | 仓库源码、栈追踪 | 解析、符号化、依赖提取 | 结构化图节点/边 |
| `m1nd-core` | 图数据、查询意图 | `Graph::finalize()`、注意力运行时 | 校准过的命中集与置信度 |
| `m1nd-mcp` | 外部代理请求 | MCP 协议适配、降级模式 | 标准化 JSON 响应 |
| `m1nd-ui` / `m1nd-viz` | MCP 响应 | 渲染、交互、诚实呈现 | 人类可读的视图 |
`m1nd` 强调"诚实的不知道胜过自信的猜测"——Lib 模块的边界设计正是为了让每一层都能给出可校准的判断：当调用方处于绑定仓库之外时，`m1nd-mcp` 会返回降级答复而非编造结果（two-tier §9.5，v1.4.0）。资料来源：[m1nd-mcp/src/lib.rs:1-60]()
## 演进与版本对齐
Lib 模块之间的版本对齐策略在 v1.2.0 后被严格化：核心三 crate 同步发布，避免出现 `m1nd-core` 已升级而 `m1nd-mcp` 仍停留在旧协议的分裂状态。前端 Lib 则跟随每个 `m1nd-ui` / `m1nd-viz` 的小版本独立演进，但必须满足"不引入未经校准的数字声明"这一品牌守门（G1，v1.3.0 中移除了未测量的节省率包装）。资料来源：[m1nd-core/Cargo.toml:1-30]()
---
---
## Doramagic 踩坑日志
项目：maxkle1nz/m1nd
摘要：发现 7 个潜在踩坑项，其中 0 个为 high/blocking；最高优先级：配置坑 - 可能修改宿主 AI 配置。
## 1. 配置坑 · 可能修改宿主 AI 配置
- 严重度：medium
- 证据强度：source_linked
- 发现：项目面向 Claude/Cursor/Codex/Gemini/OpenCode 等宿主，或安装命令涉及用户配置目录。
- 对用户的影响：安装可能改变本机 AI 工具行为，用户需要知道写入位置和回滚方法。
- 证据：capability.host_targets | https://github.com/maxkle1nz/m1nd | host_targets=mcp_host, claude
## 2. 能力坑 · 能力判断依赖假设
- 严重度：medium
- 证据强度：source_linked
- 发现：README/documentation is current enough for a first validation pass.
- 对用户的影响：假设不成立时，用户拿不到承诺的能力。
- 证据：capability.assumptions | https://github.com/maxkle1nz/m1nd | README/documentation is current enough for a first validation pass.
## 3. 维护坑 · 维护活跃度未知
- 严重度：medium
- 证据强度：source_linked
- 发现：未记录 last_activity_observed。
- 对用户的影响：新项目、停更项目和活跃项目会被混在一起，推荐信任度下降。
- 证据：evidence.maintainer_signals | https://github.com/maxkle1nz/m1nd | last_activity_observed missing
- 严重度：medium
- 证据强度：source_linked
- 发现：no_demo
- 证据：downstream_validation.risk_items | https://github.com/maxkle1nz/m1nd | no_demo; severity=medium
## 5. 安全/权限坑 · 存在评分风险
- 严重度：medium
- 证据强度：source_linked
- 发现：no_demo
- 对用户的影响：风险会影响是否适合普通用户安装。
- 证据：risks.scoring_risks | https://github.com/maxkle1nz/m1nd | no_demo; severity=medium
## 6. 维护坑 · issue/PR 响应质量未知
- 严重度：low
- 证据强度：source_linked
- 发现：issue_or_pr_quality=unknown。
- 对用户的影响：用户无法判断遇到问题后是否有人维护。
- 证据：evidence.maintainer_signals | https://github.com/maxkle1nz/m1nd | issue_or_pr_quality=unknown
## 7. 维护坑 · 发布节奏不明确
- 严重度：low
- 证据强度：source_linked
- 发现：release_recency=unknown。
- 对用户的影响：安装命令和文档可能落后于代码，用户踩坑概率升高。
- 证据：evidence.maintainer_signals | https://github.com/maxkle1nz/m1nd | release_recency=unknown