# @decibelsystems/tools 中文文档

规范地址：https://npmcn.com/package/%40decibelsystems/tools/

版本：3\.3\.4
npm 元数据更新时间：2026-11-06T21:37:02.185Z
中文译文更新时间：2026-11-14T14:39:05.278Z
软件包许可：MIT

本文由上游 README 翻译，可能存在偏差，请结合原文核对 API、命令与配置。版权与许可归原作者所有。

原始 npm 页面：https://www.npmjs.com/package/%40decibelsystems/tools
原文对照：https://npmcn.com/package/%40decibelsystems/tools/?lang=original

## 关键信息（来自 npm 元数据）

- 包体积（解压后）：5 MB，813 个文件
- 模块格式：ES Module
- TypeScript 类型：包内自带
- Node.js 要求：\>=18\.0\.0
- 运行依赖：6 个
- 首次发布：2026-02-16T18:03:26.975Z
- 最新版本发布：2026-11-06T21:37:01.866Z
- 近 30 天下载量：2012（2026-10-12 至 2026-11-10，npm 官方下载统计）
- 已发布版本数：19（近 12 个月 19 个）

## 中文简介

MCP服务器用于项目智能. 26个外观工具(170+内部处理器),涵盖20个领域:工作跟踪,架构,实验,设计,git法证,代理协调等.

## 安装

```sh
npm install @decibelsystems/tools
```

也可以使用：`pnpm add @decibelsystems/tools`、`yarn add @decibelsystems/tools`、`bun add @decibelsystems/tools`

## README

# @ decibelsystems/ tables (帮助) @ info: whatsthis

**AI编码会话的项目情报.** 一个单一的MCP服务器,为Claude(或任何MCP客户端)提供您工程的持久内存——问题,决定,摩擦,行进图等——存储在您repo中作为平面文件,因此当聊天窗口不时上下文会活下来.

> 29个外观工具(170+内部处理器)跨越工作跟踪,架构,实验,设计,git法证,代理协调,以及安全. 与克洛德桌面,克洛德代码,克洛德克洛德Cursor一起测试. [学习更多](https://decibel.systems/tools)

[![Add to Cursor](https://cursor.com/deeplink/mcp-install-dark.svg)](https://github.com/decibelsystems/decibel-tools-mcp#cursor)

* * *

## 这是什么?

当你和一个AI助手合作时,它"知道你的项目的一切"都活在聊天中——当会话结束时消失. 接下来的会话开始冷:它重新发现同一种bug,重新做出相同的决定,忘记你三周前为什么选择了Postgres而不是SQLite.

Decibel解决了这个问题 是MCP服务器让你的AI **将工程知识写入磁盘** 结构化和 **读回来** 在任何未来会议上。 在一次谈话中追踪一个问题;一周后,一次新鲜的会议问到“我应该做些什么?”并得到了答案。 记录一次建筑决定;它永远存在。 没有数据库可以运行,也没有账户可以创建——只是YAML和Markdown在一个 `.decibel/` 文件夹在您的 repo 中.

## 目标

Decibel是围绕几个目标构建的:

-   **坚持不忘召回.** 项目状态应活过一次聊天——因此知识积累而不是蒸发.
-   **当地第一和私人.** 一切都是简单的文件 __ 复发. 没有遥测,没有云依赖,没有锁定。 你可以读,diff, 并把它像任何其他来源.
-   **一个工具,许多域.** 几个"花相"工具(每个工具都有 `action`包括跟踪、决定、设计、安全和协调——而不是170个分散模型背景的单独工具.
-   **AI-内生,人可读取.** 设计为助理驾驶,但每个文物都是一个人能打开和理解的东西.
-   **在MCP的任何地方工作.** 同样的工具设定在Claude Code, Claude Desktop, Cursor,以及HTTP上的自定义代理.

## 目录

-   [所需资源](https://npmcn.com/package/%40decibelsystems/tools/#readme-requirements)
-   [快速启动](https://npmcn.com/package/%40decibelsystems/tools/#readme-quick-start)
-   [连接您的 AI 客户端](https://npmcn.com/package/%40decibelsystems/tools/#readme-connect-your-ai-client) —— 说 [克劳德代码](https://npmcn.com/package/%40decibelsystems/tools/#readme-claude-code) • 妇女 [克劳德桌面](https://npmcn.com/package/%40decibelsystems/tools/#readme-claude-desktop) • 妇女 [光标](https://npmcn.com/package/%40decibelsystems/tools/#readme-cursor)
-   [你的头五分钟](https://npmcn.com/package/%40decibelsystems/tools/#readme-your-first-5-minutes)
-   [工具](https://npmcn.com/package/%40decibelsystems/tools/#readme-the-tools)
-   [守护进程模式](https://npmcn.com/package/%40decibelsystems/tools/#readme-daemon-mode)
-   [配置 & Pro 许可证](https://npmcn.com/package/%40decibelsystems/tools/#readme-configuration--pro-license)
-   [数据存储](https://npmcn.com/package/%40decibelsystems/tools/#readme-data-storage)
-   [环境变量](https://npmcn.com/package/%40decibelsystems/tools/#readme-environment-variables)
-   [解决问题](https://npmcn.com/package/%40decibelsystems/tools/#readme-troubleshooting)
-   [隐私](https://npmcn.com/package/%40decibelsystems/tools/#readme-privacy)

* * *

## 所需资源

-   **节点.js 18** (单位:千美元)`node --version` 检查). 在macOS上,最简单的路径是 [土生土长](https://brew.sh/)数字 : `brew install node`。 。 。 .
-   MCP有能力的客户端:克洛德代码克洛德桌面克洛德克洛德克洛德克洛德克洛德克洛德克洛德克洛德克洛德克洛德克洛德克洛德克洛德克洛德克洛德克洛德克洛德克洛德克洛德克洛克克克克洛德克洛德克克洛德克洛德克洛克克克克克克克克克克克克克克克克克克克克克克克. Cursor, or your own.

## 快速启动

```bash
# Install globally…
npm install -g @decibelsystems/tools

# …or run on demand with npx (no install)
npx @decibelsystems/tools
```

然后把它传到你的AI客户端下面 [初始化您的第一个工程](https://npmcn.com/package/%40decibelsystems/tools/#readme-your-first-5-minutes)。 。 。 .

* * *

## 连接您的 AI 客户端

工具集在每一个客户端都是相同的——只有配置文件位置不同.

### 克劳德代码

添加为 `.mcp.json` 在项目根中(或 `~/.claude.json` 使它成为全球性的—— _没有_ `~/.claude/settings.json`,它持有模型/hoks/插件并被 MCP 服务器忽略:

```json
{
  "mcpServers": {
    "decibel-tools": {
      "command": "npx",
      "args": ["-y", "@decibelsystems/tools"]
    }
  }
}
```

### 克劳德桌面

编辑 `~/Library/Application Support/Claude/claude_desktop_config.json` (macOS) (英语). 如果文件还不存在, 请创建它 .

> **重要的——使用登录壳包.** Claude 桌面发射被剥去 `PATH` 并且经常找不到空的 `npx`,所以服务器没有启动。 将命令包入 `zsh -lc` 让它装入您的外壳配置文件并找到节点, 无论它在哪里安装 :

```json
{
  "mcpServers": {
    "decibel-tools": {
      "command": "/bin/zsh",
      "args": ["-lc", "npx -y @decibelsystems/tools"]
    }
  }
}
```

存完钱, **完全退出 Claude Desktop(QQ而不只是窗口)并重新打开.** 服务器出现在 **桌面** 组 _设置 – 连接器_。第一次发射缓慢,同时 `npx` 下载软件包——给出30–60s.

_喜欢背景服务吗?_ 运行 [守护进程](https://npmcn.com/package/%40decibelsystems/tools/#readme-daemon-mode) 并加成一个 **自定义连接器** (乌拉圭) `http://127.0.0.1:4888/mcp`相反,没有每个程序,由客户共享.

### 光标

添加为 `~/.cursor/mcp.json`数字 :

```json
{
  "mcpServers": {
    "decibel-tools": {
      "command": "npx",
      "args": ["-y", "@decibelsystems/tools"]
    }
  }
}
```

* * *

## 你的头五分钟

**1\. 登记一个项目.** 工具被设定到一个项目,所以这是第一个。 问问你的助手:

> 运行 `project_init` 这个文件夹。"

这创造了一个 `.decibel/` 记录和登记项目。 (优先文件吗? ) 复制 `projects.example.json` 改为 `projects.json` 并增加你们的道路

**2\. 开始使用.** 一切都是简单的语言——助理将您的请求映射到正确的工具:

| 你说.. | 发生什么事 |
| --- | --- |
| 追踪错误: 守护进程在睡眠后不会重新连接 | `sentinel` 日志一个问题 |
| "记录为什么我们选择Postgres 而不是SQLite" | `architect` 写入一个 ADR |
| "这个建造步骤不断打破——登录" | `friction` 抓住疼痛点 |
| "接下来我该做什么?" | `oracle` 返回优先行动 |
| "这个项目有多健康?" | `workflow status` 编号 : `oracle` 报告 |

**3\. 以后再来.** 在全新的会议,问 _"什么是开放的,我应该做什么?"_ - 和助手读回所有从 `.decibel/`这就是重点所在.

> 💡 **提示 :** 向您添加一个简短的注释 `CLAUDE.md` (Claude Code)或项目指令 (Claude Desktop) 告诉助手更喜欢Decibel工具来跟踪工作——因此它自动到达它们.

* * *

## 工具

每个工具都是 **外观**: 每个域有一个工具, 带有 `action` 参数选择操作(例如). `sentinel` + 动作 `create_issue`) (中文(简体) ).

### 核心——始终可用

| 外观 | 域名 | 主要行动 |
| --- | --- | --- |
| **发送器** | 工作跟踪 | `create_issue`, (中文(简体) ), `close_issue`, (中文(简体) ), `log_epic`, (中文(简体) ), `list_epics`, (中文(简体) ), `scan` |
| **建筑师** | 决定(发展成果评估) | `create_adr`, (中文(简体) ), `create_policy`, (中文(简体) ), `list_policies`, (中文(简体) ), `compile_oversight` |
| **道场** | 孵化 | `add_wish`, (中文(简体) ), `create_proposal`, (中文(简体) ), `scaffold_experiment`, (中文(简体) ), `run_experiment` |
| **设计者** | 设计决定 | `record_design_decision`, (中文(简体) ), `crit`, (中文(简体) ), `sync_tokens`, (中文(简体) ), `review_figma` |
| **预告** | 建议 | `next_actions`, (中文(简体) ), `portfolio_summary`, (中文(简体) ), `roadmap` |
| **路线图** | 战略 | `get`, (中文(简体) ), `list`, (中文(简体) ), `get_health`, (中文(简体) ), `link_epic`, (中文(简体) ), `init` |
| **gi** | Git 法医 | `history`, (中文(简体) ), `changes`, (中文(简体) ), `link_issue` |
| **工作流程** | 复合材料 | `status`, (中文(简体) ), `preflight`, (中文(简体) ), `ship`, (中文(简体) ), `investigate` |
| **向量** | 代理运行跟踪 | `track`, (中文(简体) ), `drift`, (中文(简体) ), `score` |
| **上下文** | AI 内存 | `pin`, (中文(简体) ), `unpin`, (中文(简体) ), `list`, (中文(简体) ), `event_append`, (中文(简体) ), `event_search` |
| **审计员** | 代码质量 | `health`, (中文(简体) ), `refactor_score` |
| **预测** | 估计 | `estimate`, (中文(简体) ), `decompose`, (中文(简体) ), `capacity` |
| **速度** | 计量 | `trends`, (中文(简体) ), `contributors` |
| **协调员** | 多剂锁 | `lock`, (中文(简体) ), `unlock`, (中文(简体) ), `heartbeat`, (中文(简体) ), `log`, (中文(简体) ), `message` |
| **群聚起来** | 代理会议 | `start_session`, (中文(简体) ), `join_session`, (中文(简体) ), `emit_signal`, (中文(简体) ), `claim_signal` |
| **同行** | 同行发现 | 代理代理代理存在和消息 |
| **概念** | 概念图 | 关联和查询项目概念 |
| **摩擦** | 疼痛点 | `log`, (中文(简体) ), `list`, (中文(简体) ), `resolve`, (中文(简体) ), `bump` |
| **登记** | 项目 | `add`, (中文(简体) ), `remove`, (中文(简体) ), `list`, (中文(简体) ), `alias`, (中文(简体) ), `init`, (中文(简体) ), `status` |
| **反馈** | 工具反馈 | `submit`, (中文(简体) ), `list` |
| **学习** | 知识库 | `append`, (中文(简体) ), `list` |
| **来源** | 审计线索 | `list` |
| **长椅** | 基准 | `run`, (中文(简体) ), `compare` |
| **守护者** | 安全扫描 | `scan_deps`, (中文(简体) ), `scan_secrets`, (中文(简体) ), `scan_http`, (中文(简体) ), `scan_config`, (中文(简体) ), `report` |

### Pro- 需要许可证密钥

| 外观 | 域名 | 主要行动 |
| --- | --- | --- |
| **语音** | 语音收件箱 | `sync`, (中文(简体) ), `list`, (中文(简体) ), `process` |
| **工作室** | 创意资产 | `generate_image`, (中文(简体) ), `generate_video` |
| **实体** | 代码模式 | `search`, (中文(简体) ), `index` |
| **剂** | 配置汇编 | `compile_pack`, (中文(简体) ), `render`, (中文(简体) ), `lint`, (中文(简体) ), `golden_eval` |

> 将许可证密钥添加到 `~/.decibel/config.yaml` 下级 `license.key` 打开 Pro [配置](https://npmcn.com/package/%40decibelsystems/tools/#readme-configuration--pro-license)。 。 。 .

* * *

## 守护进程模式

以 HTTP 传输方式运行 Decibel 作为持续的背景服务—— 当几个客户端( Desktop、 Cursor、 自定义代理) 共享一个服务器和一组用户时有用 `.decibel` 数据.

```bash
# Start the daemon (default 127.0.0.1:4888)
npx @decibelsystems/tools --daemon

# Both transports (stdio + HTTP) from one process
npx @decibelsystems/tools --daemon --stdio

# Manage it as a macOS launchd service (auto-start on login)
npx @decibelsystems/tools --daemon install
npx @decibelsystems/tools --daemon uninstall
npx @decibelsystems/tools --daemon status
```

守护进程包括日志旋转、坠机防护(60年代5起坠机)、请求排水的优雅关闭和a `/health` 终点 MCP 客户端连接于 **`http://127.0.0.1:4888/mcp`**;检查它是否还活着 `curl http://127.0.0.1:4888/health`。 。 。 .

* * *

## 配置 & Pro 许可证

创建 `~/.decibel/config.yaml`数字 :

```yaml
daemon:
  port: 4888
  host: 127.0.0.1
  auth_token: your-secret-token   # optional; required for non-localhost
  log_max_size_mb: 10
  log_max_files: 3
  rate_limit_rpm: 60
license:
  key: your-license-key           # unlocks Pro facades
```

CLI 旗帜覆盖了配置文件值 。 发送 `SIGHUP` 重新装入配置而不重新启动.

* * *

## 数据存储

所有东西都生活在本地项目中 `.decibel/` 文件夹 — 可读、 可分割、 可承诺 :

```
{project}/
└── .decibel/
    ├── sentinel/
    │   ├── issues/      # ISS-{nnnn}.yml
    │   └── epics/       # EPIC-{nnnn}.yml
    ├── architect/
    │   ├── adrs/        # ADR-{nnnn}.yml
    │   └── policies/    # POL-{nnnn}.yaml
    ├── dojo/
    │   ├── proposals/   # DOJO-PROP-{nnnn}.yml
    │   ├── experiments/ # DOJO-EXP-{nnnn}/
    │   └── wishes/      # WISH-{nnnn}.yml
    ├── designer/        # Design decisions, principles, crits
    ├── friction/        # Pain point logs
    ├── learnings/       # Knowledge documents
    ├── context/         # Pinned facts, events
    ├── guardian/        # Security scan results, allowlists
    └── voice/inbox/     # Voice messages (Pro)
```

## 环境变量

### 核心

| 变量 | 默认 | 说明 |
| --- | --- | --- |
| `DECIBEL_ENV` | `dev` | 环境`dev`, (中文(简体) ), `staging`, (中文(简体) ), `prod`(中文(简体) ) |
| `DECIBEL_ORG` | `default` | 组织名称 |
| `DECIBEL_MCP_ROOT` | `~/.decibel` | 全球数据存储根 |
| `DECIBEL_PROJECT_ROOT` | —— 说 | 当前工程根路径 |
| `DECIBEL_REGISTRY_PATH` | —— 说 | 自定义注册文件位置 |
| `DECIBEL_PRO` | —— 说 | 设定为 `1` 在 Dev 中启用 Pro 外观 |

### 可选融合

| 变量 | 用于 |
| --- | --- |
| `SUPABASE_URL` 编号 : `SUPABASE_SERVICE_KEY` | 语音信箱, 群集会话 |
| `FIGMA_ACCESS_TOKEN` | 设计者 : `sync_tokens`, (中文(简体) ), `review_figma` |
| `OPENAI_API_KEY` | 工作室:图像生成 |
| `TOGETHER_API_KEY` | 工作室:替代图像生成 |

* * *

## 解决问题

**工具不会出现在克洛德桌面.**

1.  你差点就打中了 `PATH` 问题——使用 [`zsh -lc` 包装](https://npmcn.com/package/%40decibelsystems/tools/#readme-claude-desktop),没有赤裸的 `npx`。 。 。 .
2.  **完全放弃** 关闭的窗口不是重启.
3.  首发下载包;等30–60s.
4.  检查日志 : `~/Library/Logs/Claude/mcp-server-decibel-tools.log`。 。 。 .

**`PROJECT_NOT_FOUND` 错误.** 还没有注册 - 运行 `project_init` (或 `registry add`在调用其他工具之前,您的项目.

**本地服务器对主机连接器 .** 解剖工具是一个 _当地_ MCP服务器 — 它被配置在 JSON 文件里, 并且只在您添加到那里时才会出现 。 它不会出现在连接器中 _搜索_ (仅列出Anthropic主机目录). 主机连接器(GitHub,Gmail)是分开的,账号范围,并启用了每个应用程序和每个对话.

**Pro外观缺失.** 他们需要一个 `license.key` 内 `~/.decibel/config.yaml` (或 `DECIBEL_PRO=1` . . . .

* * *

## 隐私

-   **仅限本地存储.** 所有项目数据都留在 `.decibel/` 文件夹在您的文件夹中 。 无一是默认发送到任何地方.
-   **可选云集成** 仅在您配置 API 密钥( Figma, Supabase, OpenAI) 时激活 —— 标记 `openWorldHint: true` 在他们的工具说明.
-   **没有遥测.** 没有用法分析,没有追踪.

## 许可证

麻省理工学院 - [Decibel 系统](https://decibel.systems/)

## 常见问题

### @decibelsystems/tools 是什么？

MCP服务器用于项目智能\. 26个外观工具\(170\+内部处理器\),涵盖20个领域:工作跟踪,架构,实验,设计,git法证,代理协调等\.

### 如何安装 @decibelsystems/tools？

在项目目录运行 npm install @decibelsystems/tools，或使用 pnpm add / yarn add / bun add。它还提供命令行工具 decibel-tools，可以用 npx decibel-tools 直接运行。

### @decibelsystems/tools 支持 TypeScript 吗？

支持。包内自带 TypeScript 类型声明（package\.json 声明了 types 入口），安装后即可获得类型提示，无需再安装 @types 包。

### @decibelsystems/tools 支持 ESM 还是 CommonJS？

以 ES Module 形式发布，推荐使用 import 引入。在 CommonJS 项目中，Node\.js 20\.19\+ / 22\.12\+ 可以直接 require\(\) 不含顶层 await 的 ES Module，更早的版本需要改用动态 import\(\)。

### @decibelsystems/tools 需要什么版本的 Node\.js？

package\.json 的 engines 字段要求 Node\.js \>=18\.0\.0。版本不符时 npm 默认只给出警告，开启 engine-strict 后会拒绝安装。

### @decibelsystems/tools 可以商用吗？

@decibelsystems/tools 使用 MIT 许可。宽松许可：允许商业使用、修改和再分发，通常只需在分发时保留原版权与许可声明。以上为概括，不构成法律意见，请以许可原文为准。

### @decibelsystems/tools 的下载量有多少？

根据 npm 官方下载统计，@decibelsystems/tools 在 2026/10/12 – 2026/11/10 这 30 天内被下载 2,012 次，日均约 67 次。下载量会把 CI 构建、镜像同步和作为其他包依赖的安装一并计入，适合横向比较热度，不能直接等同于使用人数。

### @decibelsystems/tools 还在维护吗？

最新版本 3\.3\.4 发布于 2026/11/07（7 天前）；至今共发布 19 个版本，其中过去 12 个月发布了 19 个；首次发布于 2026/02/17。发布频率只是参考信号：功能稳定的工具可能很少需要更新，建议结合源码仓库的 issue 和提交记录判断。