# @dotdotgod/claude-code 中文文档

规范地址：https://npmcn.com/package/%40dotdotgod/claude-code/

版本：0\.8\.1
npm 元数据更新时间：2026-11-11T04:05:53.464Z
中文译文更新时间：2026-11-13T02:27:19.099Z
软件包许可：Elastic-2\.0

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

原始 npm 页面：https://www.npmjs.com/package/%40dotdotgod/claude-code
原文对照：https://npmcn.com/package/%40dotdotgod/claude-code/?lang=original
项目主页：https://github.com/dotdotgod/dotdotgod-kit/tree/main/packages/claude-code#readme
源码仓库：https://github.com/dotdotgod/dotdotgod-kit

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

- 包体积（解压后）：23.7 MB，58 个文件
- 模块格式：ES Module
- TypeScript 类型：未声明
- Node.js 要求：\>=22\.5\.0
- 运行依赖：0 个
- 首次发布：2026-05-14T23:03:32.348Z
- 最新版本发布：2026-11-11T04:05:53.294Z
- 近 30 天下载量：2431（2026-10-13 至 2026-11-11，npm 官方下载统计）
- 已发布版本数：99（近 12 个月 99 个）

## 中文简介

Dotdotgod项目内存工作流程的克洛德代码适配器.

## 安装

```sh
npm install @dotdotgod/claude-code
```

也可以使用：`pnpm add @dotdotgod/claude-code`、`yarn add @dotdotgod/claude-code`、`bun add @dotdotgod/claude-code`

## README

# @ dotdotgod/ claude- code (英语)

`document-clarify` 单独通过 [@ dotdotgod/ 技能( )](https://npmcn.com/package/%40dotdotgod/skills/README.md)在从捆绑的副本升级之前,请遵循其 [移徙指南](https://npmcn.com/package/%40dotdotgod/skills/MIGRATION.md)。 。 。 .

[![npm version](https://img.shields.io/npm/v/@dotdotgod/claude-code.svg)](https://www.npmjs.com/package/@dotdotgod/claude-code) [![GitHub](https://img.shields.io/badge/GitHub-dotdotgod%2Fdotdotgod--kit-181717?logo=github)](https://github.com/dotdotgod/dotdotgod-kit/tree/main/packages/claude-code) [![License: Elastic 2.0](https://img.shields.io/badge/License-Elastic%202.0-blue.svg)](https://github.com/dotdotgod/dotdotgod-kit/blob/main/LICENSE)

Claude代码适配器为多克多特戈德的Docs-第一项目-记忆工作流程.

当您希望克劳德代码从共享项目大脑中工作时使用此软件包: 维持代理规则和文件, 持久计划, 突出上下文加载, 以及交接前更改文件证据 .

## 什么样的变化

-   **克劳德从共享项目知识开始.** `AGENTS.md` 并且文档地图在代理器之间仍然可以重复使用,而克洛德特定的指令则提供了一个本地的切入点.
-   **计划成为耐用的项目文物.** `/dd:plan` 记录任务意图 `docs/plan/` 所以它能活下来 紧凑,交接,和新的会话.
-   **项目证据在需要时到达.** `/dd:load` 和本地 MCP 运行时间提供有边框的文档,命令输出,文件,并获取文本.
-   **已更改的文件保留其审查上下文 .** 包接的钩子跟踪成功的编辑,需要匹配的图表影响后再进行广泛的验证或交接命令.
-   **工作流程仍可检查.** 一个被拒绝的操作名称需要的MCP动作,克洛德在检查成功后重试了原始操作.

## 从这里开始

这个包是一个克劳德代码插件 包含一个清单, `/dd:*` 指令,技能,MCP集成,和钩. Claude Code通过插件注册或本地插件目录来加载软件包时会注册这些资源.

在 Claude 代码内注册 dotdotgod 插件市场,然后安装插件:

```text
/plugin marketplace add dotdotgod/dotdotgod-kit
/plugin install dotdotgod@dotdotgod
```

然后用捆绑的 `/dd:*` 命令:

```text
/dd:init
/dd:load
/dd:plan Update the API migration plan.
/dd:impact
```

更新后,重新启动克洛德代码并确认活动插件指向新安装的缓存条目. 源更改不重写已存在的 `~/.claude/plugins/cache/.../<hash>/`;如果克劳德继续使用更古老的缓存散列,则通过所支持的流重新安装插件.

对于本地开发, 请直接装入插件目录而不是安装 :

```bash
claude --plugin-dir /path/to/dotdotgod/packages/claude-code
```

## 它添加到克洛德代码

| 指挥或技能 | 用它来 | 结果 |
| --- | --- | --- |
| `/dd:init` | 以 dotdotgod 常规创建仓库 . | 创建或规范共享代理文件、 docs 索引、 本地- memory 区域, 以及完整的默认工程配置 . |
| `/dd:load` | 在不更改维护的项目文件的情况下装入项目内存 . | 渲染共享的马克下行树并使用 `dotdotgod query` 当提供焦点文本时; 无法选择的语义路由返回到带有有边界证据的地图上. |
| `/dd:plan` | 实施前的计划. | 写入或更新持久任务意图 `docs/plan/<task-slug>/README.md`。 。 。 . |
| `/dd:impact` | 在验证或移交前审查已更改的文件 . | 用途 `dotdotgod graph impact` 以识别可能相关的文件、测试、命令和源文件. |
| `dotdotgod-context` MCP工具 | 运行命令,处理文件,获取/索引文本,并在本地搜索大输出. | 在模型上下文外保留了大块生字节并返回有边框的输出或FTS5节录. |

## 共享项目-记忆合同

-   `AGENTS.md` 仍然坚忍不拔.
-   `CLAUDE.md` 进口或指向 `AGENTS.md`。 。 。 .
-   斯佩克斯描述了行为和要求.
-   结构文件解释了理由、界限和公约.
-   测试文件解释核查战略、回归范围、固定装置和命令.
-   积极的计划使用 `docs/plan/<task-slug>/README.md`。 。 。 .
-   已完成计划 `docs/archive/plan/<task-slug>/`。 。 。 .
-   临时报告移至 `docs/archive/report/<report-slug>/`。 。 。 .
-   `docs/archive/README.md` 是归档地图; 归档机构只应在目标时读取.

## 记忆区和可追踪性

默认, `docs/spec/**` 有两个不同的角色:

-   它是产品行为和要求的稳定共享项目内存.
-   这是行为特征的可追溯性强制路径.

项目可以自定义内存角色 `memory.areas`,选择可追溯性强制标记 `traceability.required` 财务报告和审定财务报表 `traceability.exclude`,并定义命令的完整可追溯性字符串数组清单 `traceability.keys`。每个键拥有其标签、路径或命令目标、图表关系和PPR重量.

## 捆绑式磁共振 还有虎克

插件启动本地 stdio MCP 服务器. 它会暴露 `execute` 财务报告和审定财务报表 `execute_file`; 上下文索引、 搜索、 获取、 会话恢复、 持久摄入- 工作生命周期、 明确愈合、 统计、 医生和清洗工具; + `project_load`, (中文(简体) ), `project_impact`, (中文(简体) ), `impact_status`, (中文(简体) ), `project_initialize`, (中文(简体) ), `embedding_status`,并获得确认 `embedding_install`。个人姓名没有 `dotdotgod_` 前缀; 发现主机合格名称。 升级后重新装入已存在的会话; 遗留名称不是别名 .

Dotdotgod 执行工具共享每个指令的10 MiB stdout/stderr 捕获上限. 跨越上限终止儿童过程和报告 `captureLimitExceeded`;直取出取出取出取出取出取出取出取出取出取出取出取出取出取出取出取出取出取出取出取出取出取出取出取出取出取出取出取出取出取出取出取出取出取出取出取出取出取出取出取出取出取出取出取出取出取出取出取出取出取出取出取出取出取出取出取出取出取出取取出取出取出取出取出取出取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取 他们的孩子环境在过滤出运行时注入变量后保留了面向相容性的继承;此报告过滤了没有值的名字,但并不孤立普通被继承的证书. 在被忽略的本地项目中检索前, 大输出会被索引 `.dotdotgod/context/context.sqlite` FTS5商店, 并搜索返回的有界限的节选。 该店使用WAL,这是一条有界限的繁忙超时,以及交易源替换,过期和清洗. 结构Markdown/JSON块、有界限的能耐打字的三克选取物、对等分级的聚变以及标题/路径/近似信号改进了检索,同时改进出处和 `instructionAuthority: "none"` 将检索到的文本识别为非授权数据.

多边方案 `index` 工具接受文件或明确请求的有边框的目录,包括外部路径,其中包含决定性的 traversal,可配置的资源限制,明确的扩展/路径排除,以及默认跳过的同义链接。 这些捕捉和取回规则在克洛德调用dotdotgod MCP工具时适用;克洛德代码所内置的巴什工具保持了它的本土行为. URL索引执行应用程序级别HTTP(S),DNS/地址,连接-peer,重定向,和字节限制验证. 接受 HTML 的规范化为没有浏览器渲染、 JavaScript 、 子资源加载、 或默认后链接的无信任文本 。 服务器捆绑没有浏览器渲染器,因此浏览器选择入门失败,除非一个主机注入了这种能力. 这些控制不是网络沙盒或完整的即时注射预防. 见 [`@dotdotgod/context` npm 软件包](https://www.npmjs.com/package/@dotdotgod/context)页:1 [GitHub 读取器](https://github.com/dotdotgod/dotdotgod-kit/tree/main/packages/context),则 [维持执行合同](https://github.com/dotdotgod/dotdotgod-kit/blob/main/docs/spec/CONTEXT_EXECUTION.md) 对于整个运行时间的行为.

按会话启动时需要被捆绑的钩子标记项目负载,记录成功的源/配置编辑,并拒绝广泛的校验或交接命令,直到匹配的图撞击成功. 拒绝要求克洛德调用所需的MCP工具并重试;钩子不会默默地将一个工具类型更改为另一个. 见 [`hooks/README.md`](https://github.com/dotdotgod/dotdotgod-kit/blob/main/packages/claude-code/hooks/README.md) 用于生命周期和信任边界.

## 本地计划目录

选入后运行 `dotdotgod init . --claude-plans --dry-run`,然后重复 无 `--dry-run` 添加项目 `.claude/settings.json` `plansDirectory`。 。 。 . 使用 `node <plugin>/mcp/cli.mjs init . --claude-plans` 如果没有CLI. 保存现有值和其他设置;全局设置和权限 无人知晓。 土著文件名仍为Claude Code所有,同时共享任务计划 使用情况 `docs/plan/<task-slug>/README.md` 当模式允许时。 无需使用 Mods . Claude Code 2.1.308上用离线固定装置核实了当地实际储存.

## 地方发展

```bash
pnpm --filter @dotdotgod/claude-code run verify
pnpm --filter @dotdotgod/claude-code run pack:dry-run
```

## 学习更多

见 [根读取](https://github.com/dotdotgod/dotdotgod-kit#readme), (中文(简体) ), [背景说明](https://github.com/dotdotgod/dotdotgod-kit/blob/main/docs/concept/CONTEXT_CURATION.md), (中文(简体) ), [背景力学](https://github.com/dotdotgod/dotdotgod-kit/blob/main/docs/concept/CONTEXT_MECHANICS.md), (中文(简体) ), [内存区域配置](https://github.com/dotdotgod/dotdotgod-kit/blob/main/docs/spec/MEMORY_AREA_CONFIG.md),以及 [可追踪配置](https://github.com/dotdotgod/dotdotgod-kit/blob/main/docs/spec/TRACEABILITY_CONFIG.md)。 。 。 .

## 工作流程模型

适配器将克洛德代码的指令,技能,MCP工具,和钩子等连接到其他代理机所使用的相同的被维护的项目内存. README指数路径集中阅读,持久计划保留意图,并提供了图表影响方面的证据供审查.

## 常见问题

### @dotdotgod/claude-code 是什么？

Dotdotgod项目内存工作流程的克洛德代码适配器\.

### 如何安装 @dotdotgod/claude-code？

在项目目录运行 npm install @dotdotgod/claude-code，或使用 pnpm add / yarn add / bun add。

### @dotdotgod/claude-code 支持 TypeScript 吗？

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

### @dotdotgod/claude-code 支持 ESM 还是 CommonJS？

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

### @dotdotgod/claude-code 需要什么版本的 Node\.js？

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

### @dotdotgod/claude-code 可以商用吗？

@dotdotgod/claude-code 使用 Elastic-2\.0 许可。声明的许可为 Elastic-2\.0，请阅读许可原文确认使用条件。以上为概括，不构成法律意见，请以许可原文为准。

### @dotdotgod/claude-code 的下载量有多少？

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

### @dotdotgod/claude-code 还在维护吗？

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