CoStrict 是什么

CoStrict 是一款免费开源的 AI 辅助编程工具，专为企业级开发场景设计。支持私有化部署，是组织级安全、标准化 AI 开发工作流的最佳选择。

快速开始

安装版

bun i -g @costrict/xxx
csc

源码版

环境要求：Bun >= 1.2.0

git clone https://github.com/y574444354/csc.git
cd csc
bun install
bun run dev       # 版本号显示 888 即成功
bun run build     # 生产构建 → dist/cli.js + chunk 文件

首次登录

启动后输入 /login，CoStrict 提供两种认证入口：

1. CoStrict 企业登录（推荐）

浏览器自动打开 CoStrict OAuth 页面，完成 SSO 登录后自动写入凭证：

/login → 选择 CoStrict → 浏览器 SSO 登录 → 自动完成

• 认证服务：https://zgsm.sangfor.com/oidc-auth
• 凭证存储：~/.claude/csc-auth.json（0600 权限）
• 自动刷新：三层 Token 验证 + 预防性刷新 + 401 反应性恢复

2. 第三方 API 直连

选择 Anthropic Compatible / OpenAI / Gemini 填写 Base URL 和 API Key：

也可直接编辑 ~/.claude/settings.json：

{
  "env": {
    "ANTHROPIC_BASE_URL": "https://api.example.com/v1",
    "ANTHROPIC_AUTH_TOKEN": "sk-xxx",
    "ANTHROPIC_DEFAULT_HAIKU_MODEL": "claude-haiku-4-5-20251001",
    "ANTHROPIC_DEFAULT_SONNET_MODEL": "claude-sonnet-4-6",
    "ANTHROPIC_DEFAULT_OPUS_MODEL": "claude-opus-4-6"
  }
}

CoStrict 专有模块

企业认证体系 (src/costrict/provider/)

Token 刷新策略：

请求发起 → 读取凭证 → Token 是否过期？
  ├─ 否 → 正常请求（注入 Authorization + X-Costrict-* headers）
  └─ 是 → refresh_token 刷新 → 成功？
       ├─ 是 → 更新凭证 → 正常请求
       └─ 否 → 使用旧 Token 尝试 → 401？
            ├─ 是 → 再次刷新 → 重试请求
            └─ 否 → 返回原始响应

模型名解析优先级：

1. 传入 model 已是已知 CoStrict 模型 ID（用户 /model 明确选择）
2. COSTRICT_MODEL 环境变量（管理员全局覆盖）
3. COSTRICT_DEFAULT_{HAIKU|SONNET|OPUS}_MODEL 环境变量（按族映射）
4. 缓存模型列表的第一个可用模型
5. 透传原始模型名（兜底）

结构化 Agent (src/costrict/agents/)

CoStrict 提供严格分阶段的 Agent 编排，覆盖从需求到交付的全链路：

StrictSpec 全链路编排：

用户需求 → StrictSpec
  ├─ Stage 1: Requirement → 结构化需求文档
  ├─ Stage 2: DesignAgent → C4 Model 架构设计
  ├─ Stage 3: TaskPlan → 任务规划
  └─ Stage 4: SubCoding → 编码实现

CoStrict 技能 (src/costrict/skill/)

API 多协议兼容

CoStrict 通过流适配器模式将所有 API 协议转为内部统一格式，下游代码零改动。

架构总览

┌───────────────────────────────────────────────────────────┐
│  CLI 入口 (cli.tsx) — 12 快速路径 + main.tsx 完整 CLI     │
├───────────────────────────────────────────────────────────┤
│  REPL 对话循环                                             │
│  REPL.tsx → QueryEngine → query() → API Client            │
│  流式响应 · Tool 调度 · 上下文压缩 · 记忆管理             │
├───────────────┬───────────────────────────────────────────┤
│  CoStrict 专有 │            通用工具层                     │
│  ┌──────────┐ │  ┌─────────────────────────────────────┐  │
│  │ Provider  │ │  │ 53+ 内置工具                        │  │
│  │  OAuth    │ │  │ 文件 / Shell / Agent / Web / MCP   │  │
│  │  Token    │ │  │ Cron / Worktree / LSP / Skill      │  │
│  │  Fetch    │ │  └─────────────────────────────────────┘  │
│  │ Models    │ ├───────────────────────────────────────────┤
│  │ Mapping   │ │            Agent 编排层                   │
│  └──────────┘ │  ┌─────────────────────────────────────┐  │
│  ┌──────────┐ │  │ CoStrict Agents (16)                │  │
│  │ Agents   │ │  │ StrictSpec · TDD · Wiki · Security  │  │
│  │  (16)    │ │  └─────────────────────────────────────┘  │
│  └──────────┘ │  ┌─────────────────────────────────────┐  │
│  ┌──────────┐ │  │ 通用 Agents                         │  │
│  │ Skills   │ │  │ AgentTool · Team · Coordinator      │  │
│  │  (3)     │ │  │ Fork Subagent · Worktree 隔离       │  │
│  └──────────┘ │  └─────────────────────────────────────┘  │
├───────────────┴───────────────────────────────────────────┤
│  API 兼容层 (8 协议) → 统一流适配器 → 下游代码零改动     │
├───────────────────────────────────────────────────────────┤
│  基础设施                                                 │
│  Feature Flag · Daemon · Bridge/RCS · Voice Mode          │
│  BG Sessions · Policy 网关 · Sentry · GrowthBook          │
└───────────────────────────────────────────────────────────┘

CLI 入口快速路径

工具体系

内置工具分类

MCP 扩展

csc mcp serve     # 启动 MCP 服务器
csc mcp add       # 添加 MCP 服务
csc mcp list      # 列出已配置服务

Feature Flag 体系

所有特性通过 FEATURE_<FLAG_NAME>=1 环境变量按需启用。

默认启用（Dev + Build）

按需启用

FEATURE_FORK_SUBAGENT=1 FEATURE_BG_SESSIONS=1 bun run dev

Workspace Packages

测试与质量

bun test                                       # 全量测试
bun test src/utils/__tests__/hash.test.ts       # 单文件
bun test --coverage                            # 覆盖率
bun run lint                                    # 静态检查
bun run health                                  # 健康检查

开发调试

常用脚本

VS Code 调试

bun run dev:inspect   # → ws://localhost:8888/xxx
# VS Code: F5 → "Attach to Bun (TUI debug)"

终端 Agent 状态

交互式 TTY 默认支持 OSC 7501，可在 herdr Agents 栏展示工作、等待授权/回答、完成及失败状态。使用 CSC_OSC7501=0 csc 关闭。详见 终端状态协议说明。