# @gajae-code/coding-agent 中文文档

规范地址：https://npmcn.com/package/%40gajae-code/coding-agent/

版本：0\.21\.0
npm 元数据更新时间：2026-11-16T05:22:14.754Z
中文译文更新时间：2026-11-16T05:27:19.954Z
软件包许可：MIT

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

原始 npm 页面：https://www.npmjs.com/package/%40gajae-code/coding-agent
原文对照：https://npmcn.com/package/%40gajae-code/coding-agent/?lang=original
项目主页：https://gajae-code.com/
源码仓库：https://github.com/Yeachan-Heo/gajae-code

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

- 包体积（解压后）：40.8 MB，3492 个文件
- 模块格式：ES Module
- TypeScript 类型：包内自带
- 运行依赖：31 个
- 首次发布：2026-05-27T18:46:46.118Z
- 最新版本发布：2026-11-16T05:22:14.429Z
- 近 30 天下载量：7479（2026-10-16 至 2026-11-14，npm 官方下载统计）
- 已发布版本数：157（近 12 个月 157 个）

## 中文简介

Gajae 代码 CLI 有读取、击打、编辑、写作工具和会话管理

## 安装

```sh
npm install @gajae-code/coding-agent
```

也可以使用：`pnpm add @gajae-code/coding-agent`、`yarn add @gajae-code/coding-agent`、`bun add @gajae-code/coding-agent`

## README

# @gajae-code/编码代理

执行《公约》的核心一揽子措施 `gjc` 编码代理 `gajae-code` 单相机.

关于安装,设置,提供者配置,模型角色,斜线命令,以及完整的CLI参考,参见:

-   [Monorepo 读取(当地)](https://npmcn.com/package/README.md)
-   [莫诺雷波读取( GitHub)](https://github.com/Yeachan-Heo/gajae-code#readme)

特定软件包参考文献:

-   [变化](https://npmcn.com/package/%40gajae-code/coding-agent/CHANGELOG.md)
-   [发展](https://npmcn.com/package/%40gajae-code/coding-agent/DEVELOPMENT.md)
-   [气象指南](https://npmcn.com/package/docs/render-mermaid.md)

## 外部生命周期通知

GJC已经通过扩展/hook事件合同曝光了公共生命周期事件. Discord, Hermes, 爪子或类似频道的外部通知集成, 应当选择并订阅这些事件, 而不是刮取记录或日志 :

-   `turn_end` 模型/工具转接完成。 公共载荷是 `{ type: "turn_end", turnIndex, message, toolResults }`。 。 。 .
-   `agent_end` ——提交快报的代理回路已到达终端边界. 公共载荷是 `{ type: "agent_end", messages }`。 。 。 .

对于不需要完整扩展的简单局部副作用,设置用户级别 `completion.notifyCommand`GJC运行在完成的代理转盘上 `GJC_NOTIFICATION_*` 环境变量(`GJC_NOTIFICATION_TITLE`, (中文(简体) ), `GJC_NOTIFICATION_BODY`, (中文(简体) ), `GJC_NOTIFICATION_JSON`等);项目设置无法激活此命令钩.

```sh
gjc config set completion.notifyCommand 'cmux notify --title "$GJC_NOTIFICATION_TITLE" --body "$GJC_NOTIFICATION_BODY"'
```

在macOS上,GJC发布终端BEL完成,批准,并默认在何时通知 `notifications.terminalBell` 未配置 。 准备吧 `false` 使macOS终端保持安静.

当GJC运行在 cmux 终端内部时(`CMUX_WORKSPACE_ID` 设置中),GJC最优工作区重命名为当前GJC会话名称(带有 `GJC:` 前缀)——但只有在工作空间仍然拥有其默认标题时,所以你所绑定的名称(或由同行会话设定的共享工作空间)永远不会被覆盖. 选择退出 `GJC_NO_CMUX_RENAME=1`。 。 。 .

Windows 终端可能保存 BEL(`[Console]::Write([char]7)`) 沉默,这取决于配置和系统声音设置,即使在 `notifications.terminalBell` 已启用。 对于一个可调取的 Windows 完成 哔声, 请配置一个用户级的 PowerShell 命令钩:

```powershell
gjc config set completion.notifyCommand 'powershell.exe -NoProfile -Command "[Console]::Beep(880, 300)"'
```

`cmux notify` 返回成功意味着GJC将完成事件交给了cmux. cmux在app/window被聚焦,放出工作空间活动,或通知面板打开时,仍可能压制本地桌面横幅. 在这种情况下,检查cmux的通知面板或未读的工作空间状态,而不是将缺失的横幅作为GJC送出失败处理. 建议的外部映射 :

| 通知 | 公共活动 | 现状指南 |
| --- | --- | --- |
| 旋转完成 | `turn_end` | 使用处理器自身的消毒状态, 如 `"finished"`。 。 。 . |
| 停止/完成代理 | `agent_end` | 将您视为提示的终端 . |
| 等待/封锁/失效 | `agent_end` 外加呼叫器的安全摘要 | 目前的生命周期事件没有暴露出单独的结构化等待/封锁的理由;只检查公共安全、一体化的国家. |

仅转发一个最小的, 呼叫器-安全有效载荷。 不包括原始提示、 助理记录、 隐藏提示、 工具输出、 原始日志、 主机路径、 私密配置、 Webhook URL、 频道 ID、 符号或秘密 。 安全通知有效载荷应通过扩展/安装本身建造,例如:

```ts
import type { ExtensionAPI } from "@gajae-code/coding-agent";

type PublicLifecycleNotification = {
    type: "turn_end" | "agent_end";
    status: "finished" | "stopped" | "failed" | "blocked" | "waiting";
    turnIndex?: number;
    timestamp: string;
    summary: string;
};

export default function lifecycleNotifier(pi: ExtensionAPI) {
    const enabled = process.env.GJC_LIFECYCLE_NOTIFY === "1";
    if (!enabled) return;

    const send = async (payload: PublicLifecycleNotification) => {
        // POST to Discord/Hermes/clawhip here. Keep target URLs and channel IDs in
        // private config or environment variables; never include them in payloads.
    };

    pi.on("turn_end", event =>
        send({
            type: "turn_end",
            status: "finished",
            turnIndex: event.turnIndex,
            timestamp: new Date().toISOString(),
            summary: "GJC turn finished",
        }),
    );

    pi.on("agent_end", () =>
        send({
            type: "agent_end",
            status: "stopped",
            timestamp: new Date().toISOString(),
            summary: "GJC prompt reached a terminal lifecycle boundary",
        }),
    );
}
```

这是支持的再生生命周期通知路径. 这不是 Claude 代码钩钩兼容性, 除非用户配置扩展/ hook 处理器和私人发送目标, 否则它仍然被禁用 .

## Windows psmux 权威边界

在本地 Windows 上, GJC 管理的 psmux 会话持续为每个所有者 `ProviderAuthority`: 准确解析的可执行身份和一个孤立的 tmux 兼容 `-L` 名称空间. `GJC_TMUX_COMMAND` 仅是一个可执行路径/ 名称, 绝不 `psmux -L …`。通过GJC恢复管理会话,以便重新使用和重新证明这一权限;不要回到环境 `tmux`编号 :`psmux` 或手动重建命名空间。 无法使用、改变或含糊不清的权威未能关闭.

## 内存后端

该代理支持三个相互排斥的内存后端,通过 `memory.backend` 设置( 设置 内存标签, 或 `~/.gjc/agent/config.yml`:

-   `off` (默认)——没有内存子系统运行.
-   `local` - 现有的推出-总结管道 `memory_summary.md` 和综合文物 代理目录.
-   `hindsight` - 与一个 [后视](https://hindsight.vectorize.io/) 服务器。 Hindsight使用私人后端生命周期钩来保留记录和召回上下文;对于遗留后端的调用,仅兼容的内部仍然保留,但GJC不暴露公共编码-harness内存工具等 `retain`, (中文(简体) ), `recall`,或 `reflect`。 。 。 .

### 突然开始

1.  运行 Hindsight 服务器( 云或) `docker run -p 8888:8888 ghcr.io/vectorize-io/hindsight:latest`) (中文(简体) ).
2.  设定 `memory.backend = "hindsight"` 财务报告和审定财务报表 `hindsight.apiUrl = "http://localhost:8888"` (或你的云URL).
3.  可选环境覆盖( env 胜过设置) :
    -   `HINDSIGHT_API_URL`, (中文(简体) ), `HINDSIGHT_API_TOKEN` - 连接
    -   `HINDSIGHT_BANK_ID`, (中文(简体) ), `HINDSIGHT_DYNAMIC_BANK_ID`, (中文(简体) ), `HINDSIGHT_AGENT_NAME` 银行地址
    -   `HINDSIGHT_AUTO_RECALL`, (中文(简体) ), `HINDSIGHT_AUTO_RETAIN`, (中文(简体) ), `HINDSIGHT_RETAIN_MODE` - 生命周期
    -   `HINDSIGHT_RECALL_BUDGET`, (中文(简体) ), `HINDSIGHT_RECALL_MAX_TOKENS` ——回顾尺寸
    -   `HINDSIGHT_BANK_MISSION`, (中文(简体) ), `HINDSIGHT_DEBUG`

在下一次系统即时重建及下一次重建中, 将切换后端 `/memory` 斜线命令。 现有用户 `memories.enabled = true|false` 迁移到 `memory.backend = "local"|"off"` 刚刚发射一次.

## 紅爪 TUI主题

交互式 TUI 默认为捆绑 `red-claw` 暗终端和捆绑的甲壳类主题 `blue-crab` 主题为光出现终端,并配对欢迎/icon资产。 增加三个捆绑的移徙主题—— `claude-code`, (中文(简体) ), `codex`,以及 `opencode` - 反映这些工具的外观,便于眼动,可从设置中选择 `/theme`。明确的用户主题设置仍然赢得;设置 `theme.dark: red-claw` 财务报告和审定财务报表 `theme.light: blue-crab` 内 `~/.gjc/agent/config.yml` 把他们钉上.

### 欢迎 Windows 终端上的横幅字体

启动标志默认为圆形 Unicode 框绘图 。 Windows终端可以在所选配置字体具有需要的框画格时正确渲染;推荐的选择是 `Cascadia Mono` 或者说 `Cascadia Mono Nerd Font`。在 Windows 终端设置中,将配置字体面值设置为其中之一,或添加到配置 JSON 中:

```json
"font": {
  "face": "Cascadia Mono"
}
```

对于断开圆角的终端或字体,设置 `startup.welcomeBannerMode` 内 `~/.gjc/agent/config.yml` 对其中之一 `unicode`, (中文(简体) ), `square`,或 `ascii`。 。 。 . `square` 保留使用平角的Unicode外观标志(`┌ ┐ └ ┘`时 `ascii` 仅使用 `+`, (中文(简体) ), `-`,以及 `|`。 。 。 .

## 常见问题

### @gajae-code/coding-agent 是什么？

Gajae 代码 CLI 有读取、击打、编辑、写作工具和会话管理

### 如何安装 @gajae-code/coding-agent？

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

### @gajae-code/coding-agent 支持 TypeScript 吗？

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

### @gajae-code/coding-agent 支持 ESM 还是 CommonJS？

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

### @gajae-code/coding-agent 可以商用吗？

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

### @gajae-code/coding-agent 的下载量有多少？

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

### @gajae-code/coding-agent 还在维护吗？

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

