# @0xdeafcafe/tslsp-cli 中文文档

规范地址：https://npmcn.com/package/%400xdeafcafe/tslsp-cli/

版本：0\.6\.0
npm 元数据更新时间：2026-06-08T17:56:28.008Z
中文译文更新时间：2026-11-06T00:30:31.380Z
软件包许可：MIT

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

原始 npm 页面：https://www.npmjs.com/package/%400xdeafcafe/tslsp-cli
原文对照：https://npmcn.com/package/%400xdeafcafe/tslsp-cli/?lang=original
项目主页：https://github.com/0xdeafcafe/tslsp-cli#readme
源码仓库：https://github.com/0xdeafcafe/tslsp-cli

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

- 包体积（解压后）：296 kB，37 个文件
- 模块格式：ES Module
- TypeScript 类型：未声明
- Node.js 要求：\>=22
- 运行依赖：1 个
- 首次发布：2026-05-28T12:19:35.591Z
- 最新版本发布：2026-06-08T17:56:27.673Z
- 近 30 天下载量：8174（2026-10-04 至 2026-11-02，npm 官方下载统计）
- 已发布版本数：5（近 12 个月 5 个）

## 中文简介

Type-aware TypeScript代码智能CLI——重命名,引用,定义,徘徊,符号,诊断,调用层次,代码动作. 后被诸斯果.

## 安装

```sh
npm install @0xdeafcafe/tslsp-cli
```

也可以使用：`pnpm add @0xdeafcafe/tslsp-cli`、`yarn add @0xdeafcafe/tslsp-cli`、`bun add @0xdeafcafe/tslsp-cli`

## README

# 页:1

[![npm](https://img.shields.io/npm/v/@0xdeafcafe/tslsp-cli.svg?logo=npm&label=npm)](https://www.npmjs.com/package/@0xdeafcafe/tslsp-cli) [![CI](https://github.com/0xdeafcafe/tslsp-cli/actions/workflows/ci.yml/badge.svg)](https://github.com/0xdeafcafe/tslsp-cli/actions/workflows/ci.yml) [![node](https://img.shields.io/node/v/@0xdeafcafe/tslsp-cli.svg?logo=node.js)](https://github.com/0xdeafcafe/tslsp-cli/blob/main/package.json)

机型有意识的TypeScript/JavaScript代码智能作为CLI. 环绕 [兹戈](https://github.com/microsoft/typescript-go) (Microsoft的原产地去tserver港)并暴露其LSP能力—— `references`, (中文(简体) ), `definition`, (中文(简体) ), `rename`, (中文(简体) ), `rename-file`, (中文(简体) ), `hover`, (中文(简体) ), `outline`, (中文(简体) ), `diagnostics`, (中文(简体) ), `call-hierarchy`, (中文(简体) ), `code-action` ——作为一套小型的方便特工的命令.

重点是给编码剂一个替代grep/find-and-取而代之/`mv` 关于标识级别的工作. `rename` 更新每个引用. `rename-file` 重写每次导入 . `outline` 返回 LSP 的结构视图,而不是200行来源.

每秒一个 `tsconfig.json`懒惰发作 可选 `--daemon` 保持tsgo温暖 通过呼叫.

## 安装

两个客户端是一等:克洛德代码(通过捆绑的插件市场)和克洛德克思(通过CLI+) `AGENTS.md`) (中文(简体) ).

### 克劳德代码

```
/plugin marketplace add 0xdeafcafe/tslsp-cli
/plugin install tslsp@0xdeafcafe-tslsp
```

插件捆绑了指示克洛德使用的路由技巧 `tslsp-cli` 而非 grep / 字符串编辑 / `mv` 用于任何TS/JS标识工作——无 `CLAUDE.md` 需要编辑。 技术驱动CLI,所以安装这个:

```bash
npm i -g @0xdeafcafe/tslsp-cli
```

该技能指示克洛德 验证CLI `PATH` 在每次会话开始时; 缺失的安装表面立即而非中值。 更新技能为 `/plugin marketplace update 0xdeafcafe-tslsp`。 。 。 .

### 代码

代码读取 `AGENTS.md` 克劳德也是这样写的 `CLAUDE.md`。安装 CLI 并让它写入路由块:

```bash
npm i -g @0xdeafcafe/tslsp-cli

tslsp-cli install --skills --project --with-agents-md   # writes ./AGENTS.md
tslsp-cli install --skills --with-agents-md             # writes ~/.codex/AGENTS.md (user-wide)
```

同上文——由标注评论来守护,所以再运行是无操作. `--with-claude-md` 是非市场Claude代码安装的等同旗帜;两种旗帜可以一起相传.

### 其他代理人

Cursor, Cline, Aider, 其它任何运行 shell并读取指令文件: 安装 CLI(`npm i -g @0xdeafcafe/tslsp-cli`然后粘贴身体 [`skills/tslsp/SKILL.md`](https://npmcn.com/package/%400xdeafcafe/tslsp-cli/skills/tslsp/SKILL.md) 输入主机的等同文件.

### 从源

```bash
git clone https://github.com/0xdeafcafe/tslsp-cli.git
cd tslsp-cli && pnpm install && pnpm run build
./dist/cli.js --help
```

## 命令

| 命令 | 目的 |
| --- | --- |
| `find-symbol` | 工作空间符号搜索. 多克或多克位置 `--queries a,b,c`。 。 。 . `--kind`, (中文(简体) ), `--container`。 。 。 . |
| `references` | 每参参. 定位器或 `--symbols` 批号. `--summary` 页:1 `path (N): lines`。 。 。 . |
| `definition` | 跳到定义符号的地方. `--symbols` 批号. |
| `type-definition` | 跳转到值的 _类型_ 声明(vs.值). `--symbols` 批号. |
| `implementation` | 具体实施接口/抽象成员. `--symbols` 批号. |
| `rename` | 每个文件都重命名类型 . `--dry-run` 预览. |
| `rename-file` | 移动文件或文件夹; 更新每次导入 。 文件夹递归行走. |
| `hover` | 类型签名+JSDoc. `--symbols` 批号. |
| `outline` | 缩入声明大纲. 文件, 缩写( G) (`'src/**/*.ts'`),目录. `--depth`, (中文(简体) ), `--kind`。 。 。 . |
| `diagnostics` | 类型错误。 档案 词汇 目录 每一个打开的文件都无参数 = 汇总 . |
| `call-hierarchy` | 召相与所请. `--direction incoming` 编号 : `outgoing` 编号 : `both`。 。 。 . |
| `code-action` | 列出快取/重构/组织-进口; `--apply N` 应用. |

`tslsp-cli --help` 财务报告和审定财务报表 `tslsp-cli <command> --help` 具有权威性.

## 定位器

需要位置的指令接受三种表格,按优先顺序排列:

```
--file F --line L --character C   explicit LSP position
--file F --line L --symbol NAME   scan line L of F for NAME
--symbol NAME                     workspace search; exit 2 with candidates if ambiguous
```

特工通常知道符号名称和行,而不是栏. 模式2和3弥补了差距.

## 批次

每个只读命令接受一个列表. 一个CLI呼叫 – 没有平行的LSP查询 – 一个标签的回:

```bash
tslsp-cli find-symbol  add double sum                # multi-positional
tslsp-cli hover        --symbols User,Account,Session
tslsp-cli references   --symbols add,sum,double
tslsp-cli outline      'src/**/*.ts'                 # quote the glob
tslsp-cli diagnostics  src/api/                      # directory walk
```

块被标记 `=== name ===`。 。 。 . `find-symbol` 内部序列化( tsgo) `workspace/symbol` 比赛在冷起步时进行;其他一切球迷都出道.

通过源扩展集过滤Glob和目录输入(`.ts/.tsx/.mts/.cts/.js/.jsx/.mjs/.cjs`和一个被忽略的集合(`node_modules`, (中文(简体) ), `.git`, (中文(简体) ), `dist`, (中文(简体) ), `build`, (中文(简体) ), `out`, (中文(简体) ), `.next`, (中文(简体) ), `coverage`。在图案本身(例如:. `node_modules/**/*.ts`包括这些点击.

断接输出被挤压: 干净的物品丢弃 `=== file ===` 信头,所有干净的批次倒入一行,和 `references --summary` 交换片断 `path (N): l1, l2, l3` ——~15KB ——在被大量引用的符号上有几百字节.

## 守护进程

```
tslsp-cli <cmd>             fresh tsgo per invocation; disposed after the call
tslsp-cli --daemon <cmd>    RPC into a per-workspace daemon
```

Fresh-process model 对一次性通话来说是好的. 对于一个循环 与许多电话, `--daemon` 在第一次使用时自动喷出每个工作空间守护进程,然后重复使用。 套接字路径 : `$CACHE/tslsp/daemon/<sha1(tsconfig-dir)>/<session>.sock` (主要内容) `~/Library/Caches`时, Linux `$XDG_CACHE_HOME`窗口 `%LOCALAPPDATA%`; 覆盖到 `TSLSP_DAEMON_DIR`) (中文(简体) ).

```bash
tslsp-cli --daemon references --symbol User
tslsp-cli daemon list           # running daemons
tslsp-cli daemon restart        # after upgrading tslsp-cli
tslsp-cli daemon stop           # graceful stop for this workspace
tslsp-cli daemon kill-all       # SIGKILL every daemon
```

守护进程在闲置了30分钟后自行退出( M)`TSLSP_DAEMON_IDLE_MS`); 10分钟后在内部的个人tsgos收获(`TSLSP_TSGO_IDLE_MS`。 版本扭曲守护进程拒绝新调用 – 运行 `daemon restart` 升级后.

## 来了

-   `@typescript/native-preview` 被固定在一个特定的dev建筑。 tsgo动作快;故意撞倒.
-   `rename` 财务报告和审定财务报表 `rename-file` 写入磁盘. `--dry-run` 先预览.
-   总是引用光彩图案. 一个未引用 `src/**/*.ts` 匹配您 shell 中的任何内容 成为字面参数和 LSP 错误, 而不是扩展器查找零文件 .
-   每秒一个 `tsconfig.json` 树根。 Monorepos支付项目荷载的成本是每个项目第一次被击中(~50ms小,更多在大.
-   `--daemon` 保持文件对调。 两次守护进程调用之间的外部编辑可能短暂地滞后到下次文件打开或 `didChangeWatchedFiles` 活动.
-   守护进程住在那里 `$CACHE/tslsp/daemon/<hash>/<session>.err` -第一个看产卵失败的地方.
-   `TSLSP_VERBOSE=1` 将 tsgo 的 stderr 转发到前景进程 .
-   安装了土生土长机 `tsgo` 打开 `PATH` 被忽略; `tslsp-cli` 总是使用 npm 钉住的.

## 常见问题

### @0xdeafcafe/tslsp-cli 是什么？

Type-aware TypeScript代码智能CLI——重命名,引用,定义,徘徊,符号,诊断,调用层次,代码动作\. 后被诸斯果\.

### 如何安装 @0xdeafcafe/tslsp-cli？

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

### @0xdeafcafe/tslsp-cli 支持 TypeScript 吗？

该包的 package\.json 没有声明类型入口。需要类型提示时，可以在 npm 上查找社区维护的 @types/0xdeafcafe\_\_tslsp-cli 是否存在。

### @0xdeafcafe/tslsp-cli 支持 ESM 还是 CommonJS？

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

### @0xdeafcafe/tslsp-cli 需要什么版本的 Node\.js？

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

### @0xdeafcafe/tslsp-cli 可以商用吗？

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

### @0xdeafcafe/tslsp-cli 的下载量有多少？

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

### @0xdeafcafe/tslsp-cli 还在维护吗？

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