@gajae-code/编码代理
执行《公约》的核心一揽子措施 gjc 编码代理 gajae-code 单相机.
关于安装,设置,提供者配置,模型角色,斜线命令,以及完整的CLI参考,参见:
特定软件包参考文献:
外部生命周期通知
GJC已经通过扩展/hook事件合同曝光了公共生命周期事件. Discord, Hermes, 爪子或类似频道的外部通知集成, 应当选择并订阅这些事件, 而不是刮取记录或日志 :
turn_end模型/工具转接完成。 公共载荷是{ type: "turn_end", turnIndex, message, toolResults }。 。 。 .agent_end——提交快报的代理回路已到达终端边界. 公共载荷是{ type: "agent_end", messages }。 。 。 .
对于不需要完整扩展的简单局部副作用,设置用户级别 completion.notifyCommandGJC运行在完成的代理转盘上 GJC_NOTIFICATION_* 环境变量(GJC_NOTIFICATION_TITLE, (中文(简体) ), GJC_NOTIFICATION_BODY, (中文(简体) ), GJC_NOTIFICATION_JSON等);项目设置无法激活此命令钩.
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 命令钩:
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、 符号或秘密 。 安全通知有效载荷应通过扩展/安装本身建造,例如:
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- 与一个 后视 服务器。 Hindsight使用私人后端生命周期钩来保留记录和召回上下文;对于遗留后端的调用,仅兼容的内部仍然保留,但GJC不暴露公共编码-harness内存工具等retain, (中文(简体) ),recall,或reflect。 。 。 .
突然开始
- 运行 Hindsight 服务器( 云或)
docker run -p 8888:8888 ghcr.io/vectorize-io/hindsight:latest) (中文(简体) ). - 设定
memory.backend = "hindsight"财务报告和审定财务报表hindsight.apiUrl = "http://localhost:8888"(或你的云URL). - 可选环境覆盖( 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 中:
"font": {
"face": "Cascadia Mono"
}
对于断开圆角的终端或字体,设置 startup.welcomeBannerMode 内 ~/.gjc/agent/config.yml 对其中之一 unicode, (中文(简体) ), square,或 ascii。 。 。 . square 保留使用平角的Unicode外观标志(┌ ┐ └ ┘时 ascii 仅使用 +, (中文(简体) ), -,以及 |。 。 。 .