#命令

A3S Code 主要是 SDK 驱动。CLI 和 UI 通常把命令映射到 session API，而不是依赖 一个庞大的公开命令协议。

本页说明会话命令注册表。9.0.0 终端客户端自行处理的命令见 A3S Code TUI。

这些 surface 刻意不同：

SDK command 会在 LLM 看到输入之前执行。handler 接收原始参数字符串和 session 元数据，并返回展示文本。命令适合薄薄的控制面动作；workflow、工具、验证和持久化 应直接使用普通 SDK 方法。

#推荐映射

#构建斜杠命令

如果产品提供 slash command，请让它们薄薄地映射到这些 API。注册 handler、列出 可用命令，并通过 session.send() 触发：

session.registerCommand(
  'docs_status',
  'Return docs command status',
  (args, ctx) => {
    return `status args=${args}; session=${ctx.sessionId}; workspace=${ctx.workspace}`;
  },
);

console.log(session.listCommands());

const result = await session.send('/docs_status check');
console.log(result.text);

command handler 不应隐藏长时间运行的工作。如果一个命令需要运行工具、验证输出、 fan out 到 subagent 或调度周期性自动化，让 handler 返回简短确认，再由明确的宿主 代码执行这些工作。这样取消、审计和权限边界仍然可见。