dsh-cc — 在 DeepSeek Harness 网页里使用 Claude Code

dsh-cc 是一个 DSH 外挂双面插件：在 DSH Web GUI 右缘加入一个 Claude Code dock 按钮（cc-dock，注册在宿主的 shell.overlay 槽），点开一个全屏会话 overlay。每个会话由官方 Claude Agent SDK 驱动一个真实的 Claude Code 进程，支持多轮对话、工具权限审批、会话恢复（resume），并且模型 / 代理 / API Key / Base URL 全部通过环境变量与 cordis.yml 配置。

功能

• 右缘「Claude Code」dock 按钮，打开全屏会话 overlay（Escape 关闭）
• 多会话管理：新建（可指定名称 / 工作目录 / 模型）、切换、重命名、删除；CLI 原生创建的会话也在列表里，终端正在使用的只读展示
• 实时流式输出（SSE）：文本、思考过程、工具调用与结果、回合统计（耗时 / 步数 / 花费）；中途加入 / 切回会话也能拿到进行中的回合
• 工具权限审批：把 permissionMode 设为 default 后，Claude Code 的每次工具授权请求会弹到页面上，点「允许 / 拒绝」（可选记住为规则）即可
• AskUserQuestion 对话桥：模型向用户提问（选项 / 输入框）时直接在页面上作答
• 模型与思考档位热切换：会话进行中切换模型 / effort，忙碌回合就地切换，选择持久化为该会话的默认
• 权限模式会话级热切换：状态栏菜单切换六种权限姿态（默认 / 接受编辑 / 计划 / 免打扰 / 跳过全部确认 / 自动），忙碌回合就地切换，持久化为会话默认
• 底部任务面板：会话进程正在跑的子代理 / 命令 / 监视 / 工作流的实时进度（token · 时长 · 最近工具），每行「结束」「转后台」控制；随下一回合开始清理已结束行
• 输入框上方固定当前任务清单：从转录的清单工具调用推导的 TODO 面板（兼容旧版 TodoWrite 与新版 TaskCreate/TaskUpdate），计划常驻眼前不用翻历史
• 斜杠命令菜单：输入框打 / 弹出 CLI 的命令目录（内置命令、用户技能、项目命令），↑↓ 选择、Tab/Enter 补全；识别为可调用的命令（含技能）在输入框与转录里显示蓝色识别态；/compact 等本地命令的输出以「命令输出」行进转录
• @ 文件/文件夹提及：打 @ 即全项目模糊搜索 —— 一次有界索引（5000 行 / 层 2000 / 深 16，忽略 node_modules、.git 等重目录）覆盖整个工作目录，子序列匹配（mc 找 mention-core）按 basename 精确>前缀>连续>子序列排名；输入绝对路径则实时列出该目录子项导航盘上任何位置。↑↓/PageUp/PageDown/Home/End 选择，Enter/Tab 插入（整段替换半打的 token、自动补尾空格、文件夹补 /）；手打的 @相对路径 / @绝对路径 同样生效 —— 文件内容与文件夹目录树随消息注入上下文（总量上限 1MB）
• 文件路径点击查看：对话文本里反引号包裹的文本文件路径（带分隔符或绝对路径 + 已知文本扩展名）可点击打开查看器，显示磁盘最新内容（行号 + 语法高亮，> 2MB 截断）
• 图片输入：粘贴或拖入图片（每张 ≤ 5MB）随消息发送，转录回读同一份内容寻址存储
• 用量与上下文读数：状态栏显示模型 / 档位选择、上下文窗口占用与账户用量；每次模型响应完成后经 SSE 自动刷新一次（CLI statusline 的节奏 —— 按响应计，不按流式增量计）。订阅额度窗口存的是 CLI 返回的 resets_at 时间戳，重置倒计时按用户本地时钟逐秒重算并直接显示在 5h / 周窗口旁，不会冻结在上次快照
• 分支 / worktree 标签：状态条显示会话 cwd 当前所在的 git 分支（detached 时显示短 sha；位于 linked worktree 时悬停可见 worktree 名与仓库根）。读数由插件直接跑 git rev-parse 获得 —— SDK 控制通道没有分支查询，CLI 持久化的 gitBranch 只是回合结束时的滞后快照；冷会话同样可查，回合结束后自动重读（回合中可能 git checkout 过）
• Esc 中断回合：回合进行中在输入框按 Esc 即中断（与「停止」按钮同路径）；Esc 分层保持「菜单 → 中断 → 离开输入框 → 关闭面板」
• 每会话草稿与输入历史：未发送的草稿（含已上传图片）按会话落盘，切换 / 刷新不丢；发送过的消息按「项目 + 账号」记入历史，输入框空态或回溯态下 ↑↓ 翻取、编辑即退出回溯
• 排队交给 CLI 自己做：回合进行中发送的消息立即推给 CLI，由 CLI 的命令队列排；它回的 command_lifecycle 帧就是页面「谁在等」的唯一真相。等待中的消息在转录流上方成条列出（时间 + 首行预览 + 「撤回」），撤回走 CLI 原生 dequeue，撤得掉才算撤掉；本轮结束时整批合并成一个回合发出（CLI 的 coalescing，模型一次看到用户的连续意图，也只计一次费）。转录行在消息真正被取进回合时才写 —— 排队中的消息不会伪装成已发出。引擎异常死亡时未开跑的队列整体移交下一个进程
• MCP 服务器面板：状态条上的 MCP n/m 展开服务器列表 —— 连接状态、配置作用域、工具数、失败原因，可就地重连 / 停用 / 启用。哪些服务器生效取决于会话 cwd（项目作用域）、账号根目录（用户作用域）和企业策略，只有活进程解析全了这三层，所以这里读的是进程而不是配置文件；没配 MCP 的会话完全不显示这个控件
• 技能/插件热重载：CLI 只在启动时解析技能与插件，所以刚写完的技能原本要重开会话才能用。命令菜单底部的「重新加载技能/插件」就地重新发现（实测 77 → 78 条，新技能立即出现）
• 压缩进度可见：/compact 或自动压缩进行中，进行中回合区显示「正在压缩对话」脉冲指示（CLI 的 status 帧）；完成即提示，失败以警告条给出原因
• CLI 三手势：Shift+Tab 轮换权限模式、Alt+P 打开模型菜单、Alt+T 切换思考档位（IME / 浮层守卫与 Esc 一致）
• 会话回退（/rewind 语义）：任意历史消息 hover「回退」——对话回到这条消息之前，这条消息的文本自动填回输入框（可编辑后重发，与 CLI /rewind 的编辑重发一致）；可选同时回滚文件到该消息时（CLI 文件检查点，弹窗内预览将恢复的文件数与 ±行数，symlink 跳过数警示；需要会话进程在运行，冷会话自动禁用该选项）。实现上由「原生 fork 截断到锚点前一条 + 承袭会话设置 + 删除原会话」组合而成——SDK 没有原地截断 API，页面上读起来就是同一会话回到了过去；压缩后的转录渲染「对话已压缩 · 前 N tokens → 后 M tokens」分隔线（含 /compact 与自动压缩两种触发来源）
• 行级复制（宿主同款图标交互）：每条消息 hover 出图标动作 + Tooltip 说明，复制成功图标变对勾一秒——用户消息可「复制」本条文本或「复制回合」（整回合折成 Markdown：输入+附图清单、思考过程、正文、每次工具调用的参数与输出（剥 <system-reminder>、单条 12k 截断）、命令输出、错误与回合计时；流式中点击带上未落定内容并注明「仍在进行中」）；每段 AI 正文、每段思考过程可单独复制；回合统计条上可一键复制整段回复；「分叉」「回滚文件」同为图标（Tooltip 注明用途）
• ! shell 模式：输入以 ! 开头直接在会话工作目录执行命令，输出以「命令输出」行进转录并自动交给模型回应（CLI respondToBashCommands 语义）；权限姿态为默认 / 计划模式时拒绝执行并提示切换模式，不静默绕过权限
• 命令目录三层兜底：活进程目录 → 会话内存缓存 → 服务端按「账号 + 项目」记忆的上次目录（冷会话标注 stale）；菜单里「页面」徽标标出已有等价控件的命令、「终端」徽标警示交互式 TUI 命令经流式通道可能无输出
• 流式 Markdown 与回合计时：进行中回合的文本直接按 Markdown 排版渐进渲染（未闭合代码围栏保持纯文本，落定无视觉跳变）；等待行旁显示回合已耗时（m:ss）
• Agent 工具卡与 @ 匹配高亮：Agent 委派与 Task 同卡片渲染；@ 文件菜单中命中字符品牌色高亮（排名依据一目了然）
• 会话持久化：JSONL 转录存放在数据目录，重启 DSH 后会话列表与记录仍在；继续对话自动通过 Claude 原生 session resume
• 环境变量可配置：ANTHROPIC_AUTH_TOKEN、ANTHROPIC_BASE_URL、HTTPS_PROXY 等任意变量，通过 profile 的 cordis.patch.yml、结构化 provider 字段或页内设置面板注入
• 环境预设一键切换：设置面板顶部预设条（首启播种「账号直连」＝快照本机代理环境；本机已设 ANTHROPIC_BASE_URL 网关时另播种「GLM 中转」＝快照整套网关环境，干净机器不播种、不内置任何端点）。激活的预设整体接管服务商键域——没列出的变量一律从生效环境里移除，包括 dsh 进程继承的用户级环境变量（逐键覆盖做不到的删除语义）；可另存 / 删除预设，激活时保存会把表单同步进该预设
• 会话级账号绑定：会话在创建/收养那一刻，把当时生效的账号根目录（CLAUDE_CONFIG_DIR）与服务商键域（BASE_URL / 凭据 / 模型别名 / 代理 / 超时）盖进自己的配置行——之后这个会话的每一次 spawn 都用自己的章，全局预设或账号切来切去都不会把 A 会话的额度串到 B 账号上。A、B 两个账号的会话可以同时跑；绑定到别的根的会话在标题栏标「账号根 <名>」，会话环境弹窗里可查看完整绑定（凭据打码）。绑定之前创建的旧会话行跟随全局账号，行为不变

安装

前置：安装 DSH

本机还没有 dsh 命令时，先全局安装 DSH（需要 Node 22+）：

npm install -g @deepseek-ai/dsh

然后用 dsh web 启动 Web GUI（已在运行则跳过，装完插件重启即可）。

从 npm 安装（推荐）

dsh plugin --profile web add @young1lin/dsh-cc

重启 dsh（web profile）后刷新页面，界面右缘即出现「Claude Code」dock 按钮。零配置即可用（使用本机 Claude Code 登录态）；要切换模型 / 走代理，见下方「配置」一节。

更新到最新版：

dsh plugin --profile web update @young1lin/dsh-cc@latest

从源码安装（开发）

前置：本机已安装 Node 22+、pnpm。

git clone https://github.com/young1lin/dsh-cc.git
cd dsh-cc
pnpm install
pnpm run build

# 装进 web profile（GUI 使用的 profile）
dsh plugin --profile web add .

# 重启 dsh（web profile）后刷新页面

开发迭代：改完代码 pnpm run build 后重新执行上面的 dsh plugin ... add 并重启即可（file: 安装按 files 打包）。也可以用 dsh plugin --profile web add link:<本仓库路径> 做链接安装，配合 pnpm run watch 免重新 add（仅改 lib 产物时）。

配置（模型 / 代理 / 密钥）

默认零配置即可用（使用本机 Claude Code 登录态）。要切换模型或走代理，编辑 profile 的补丁层 ~/.dsh/profiles/web/cordis.patch.yml（或 $DSH_HOME 下），加入或修改 dsh-cc 行：

- id: dsh-cc
  config:
    model: claude-sonnet-4-5        # 默认模型；会话里也可单独选
    permissionMode: auto            # default / acceptEdits / plan / dontAsk / bypassPermissions / auto（默认 auto）
    effort: high                    # 新会话默认思考档位：low / medium / high / xhigh / max；不填 = CLI 默认
    cwd: D:/work                    # 新会话的默认工作目录
    dataDir: C:/Users/me/.dsh/claude-code
    configDir: C:/Users/me/.claude-work   # Claude Code 配置目录（CLAUDE_CONFIG_DIR）；空 = dsh 启动时的环境值，再回落 ~/.claude
    maxLiveSessions: 4              # 同时存活的 claude 进程上限，超出关闭最久未用的
    maxTurns: 0                     # 单回合工具调用上限；0 = 不限
    executablePath: ''              # 覆盖 claude 可执行文件路径；空 = 用 SDK 自带载荷
    provider:                       # 结构化网关配置，逐字段解析成环境变量
      baseUrl: https://api.example.com   # → ANTHROPIC_BASE_URL；空 = 官方 API
      authToken: sk-xxx                  # → ANTHROPIC_AUTH_TOKEN
      apiKey: ''                         # → ANTHROPIC_API_KEY（仅在未设 authToken 时生效）
      model: ''                          # → ANTHROPIC_MODEL（网关目录里的 id / 别名）
      opusModel: ''                      # → ANTHROPIC_DEFAULT_OPUS_MODEL
      sonnetModel: ''                    # → ANTHROPIC_DEFAULT_SONNET_MODEL
      haikuModel: ''                     # → ANTHROPIC_DEFAULT_HAIKU_MODEL
      smallFastModel: ''                 # → ANTHROPIC_SMALL_FAST_MODEL
      httpsProxy: http://127.0.0.1:7890  # → HTTPS_PROXY
      httpProxy: ''                      # → HTTP_PROXY
      noProxy: localhost,127.0.0.1       # → NO_PROXY
      apiTimeoutMs: 300000               # → API_TIMEOUT_MS
    env:                            # 直接注入 claude 进程的环境变量；同名键永远赢过 provider 结构化字段
      HTTPS_PROXY: http://127.0.0.1:7890
      NO_PROXY: localhost,127.0.0.1

注意：id 定位的补丁会整行替换 config —— 改哪项就把整块写全。保存后 profile 补丁层会热重载（watchUserPatches），但已存活的 claude 进程要新会话/重发消息后才会带上新环境。

provider.model（→ ANTHROPIC_MODEL，由 CLI 在网关目录里解析）与顶层 model（SDK 查询参数）是两条独立的解析通道，可只设其一或都设。

多账号（CLAUDE_CONFIG_DIR）

Claude Code 把一个账号的全部家当放在同一个根目录下：凭证、settings.json、记忆与技能、活进程注册表，以及 projects/<编码后的 cwd>/ 里的会话转录。所以「换账号」就是换这个根目录。

设置面板顶部的账号区维护一张目录列表（「添加账号」按钮加行，可浏览目录选路径），并标出当前用的是哪一个。点「切换」立即生效：会话列表、登录身份、模型目录、用量读数、记忆与技能、以及该根目录自己 settings.json 里的 permissions.defaultMode 一起换过去。列表的增删改随「保存」落盘，切换本身是独立接口 POST /cc/api/accounts/active。

两条规则值得记住：

• 有会话正在跑就切不了（返回 409）。正在跑的回合握着一个用旧根目录起的 claude 进程，既搬不走也打断不了。
• CLAUDE_CONFIG_DIR 不能写进 env（页面全局 env、会话 env 都会被拒），cordis 配置里写了则自动提升成 configDir。原因是 env 只影响被 spawn 的 claude 进程，不影响插件自己读会话目录 —— 两边一旦分叉，新会话会写进 A 账号却从 B 账号的列表里找，直接从会话栏消失。

会话栏的可见性按账号绑定走：每个会话行创建/收养时盖上「根目录 + 服务商键域」的账号绑定章，之后 spawn、resume、转录读取都按行上自己的章走——所以 A 账号的会话在全局切到 B 账号后照常可见、照常可用、额度不串。绑定功能之前创建的旧行没有章，跟随当前根目录显示与使用，切换后不串台。

页面内设置

聊天页面内建的设置面板（SettingsModal）读写 GET/PUT /cc/api/settings，持久化到 dataDir/settings.json，可改默认模型、permissionMode 与环境变量。保存即时生效：空闲引擎被回收、下一条消息用新配置起进程，无需重启 dsh（忙碌回合先跑完）。非空字段覆盖 cordis 配置的同名字段，留空则回落到 cordis 层；env 按键合并而非整块替换。

页面写入的 ANTHROPIC_AUTH_TOKEN / ANTHROPIC_API_KEY 不以明文落盘：Windows 使用当前用户 DPAPI 包裹随机 AES 设备密钥；macOS 使用 Keychain 中的随机 AES 密钥；Linux 优先使用 Secret Service，缺少桌面密钥环时使用“随机本地种子 + machine-id”设备绑定后备。settings.json、预设以及会话索引里的账号章/会话 env 只保存 dshcc1.* 密文，旧版明文在首次加载时原地迁移；若本机凭据设施不可用则闭锁移除旧明文并要求在页面重新输入，不让插件整体失效。密钥只在启动 Claude 子进程前于内存中解开。GET / SSE 只返回“已设置”占位符，页面不能回读明文，安全导出会省略密钥，所以复制配置到另一台设备后必须重新输入。cordis 补丁和父进程环境由用户/宿主管理，不在插件的落盘加密边界内。

预设（presets）是命名的服务商环境包：activePresetId 指向其一时，PROVIDER_ENV_KEYS 键域内预设即全部真相——预设里的键替换各层、没列的键从生效环境删除（spawn 时逐键剥离，含大小写变体），这样「账号直连」才能在 shell 里导出了网关凭证的机器上真正回到账号登录。/cc/api 前缀整体校验 Host 必须为本机回环，堵住 DNS rebinding 经由 fs/file、fs/list 读任意文件的通路。

常用环境变量参考：

| 变量 | 作用 | |---|---| | ANTHROPIC_AUTH_TOKEN / ANTHROPIC_API_KEY | API 密钥 | | ANTHROPIC_BASE_URL | 自定义 API 地址（中转/网关） | | ANTHROPIC_MODEL | 默认模型 | | HTTPS_PROXY / HTTP_PROXY / NO_PROXY | HTTP 代理 | | ANTHROPIC_SMALL_FAST_MODEL | 后台小模型 |

架构

dsh-cc（仓库根目录）
├─ package.json          dsh.bundle + dsh.client 声明（双面插件）
├─ cordis.patch.yml      bundle 层：挂载 dsh-cc 插件行
└─ src/
   ├─ index.ts           node 半区（函数插件）：inject webServer，挂 /cc/api 路由
   ├─ config.ts          schemastery 配置 schema + 显式默认值 + provider → env 解析
   ├─ types.ts           两半共享的契约类型（SessionMeta / 事件 / 设置 / 线路消息）
   ├─ store.ts           sidecar 持久化：index.json + 每会话 JSONL 转录
   ├─ catalog.ts         统一会话目录：CLI 原生存储 + sidecar 合并成一张列表
   ├─ native-sessions.ts     适配 CLI 原生存储（~/.claude/projects/...）到 SessionMeta
   ├─ native-transcript.ts   读 CLI 原生 JSONL 转录（尾部截断）
   ├─ peer-sessions.ts   只读观察 ~/.claude/sessions/<pid>.json 活进程注册表 → terminalOwned
   ├─ engine.ts          每会话一个 SDK query：流式多轮、canUseTool 权限桥、resume
   ├─ live-turn.ts       流式帧折叠 reducer（两半共用，中途加入拿到一致的进行中回合）
   ├─ mentions.ts        @ 提及展开：文件内容 / 文件夹目录树作为文本块随消息注入
   ├─ file-index.ts      @ 菜单的项目文件索引：有界 BFS 遍历 + TTL 缓存
   ├─ blobs.ts           图片字节 SHA-256 内容寻址存储
   ├─ runtime.ts         REST + SSE 路由（/cc/api/*）
   └─ client/            浏览器半区：右缘 dock + 全屏聊天 overlay
        index.tsx          apply(): ctx.slots 注入 shell.overlay 槽（cc-dock 按钮）
        App.tsx            会话列表 / 聊天 / 权限与提问卡片 / 设置入口
        SessionRail.tsx    会话侧栏    Transcript.tsx  消息流
        Composer.tsx       输入框      LiveTurnView.tsx  进行中回合
        CommandMenu.tsx    斜杠命令弹窗 MentionPicker.tsx  @ 文件菜单渲染
        mention-core.ts    @ 菜单纯逻辑（token 语法 / 模糊排名 / 绝对路径导航 / 插入规划）
        StatusBar.tsx      模型 / 档位 / 分支 / 上下文 / 用量状态条
        Interaction.tsx    权限审批卡片 + AskUserQuestion 卡片
        api/               fetch + EventSource 封装（http / sessions / settings / telemetry / interaction）
        tool/              各类工具卡片（terminal / read / diff / search / web / TodoList…）
        settings/          SettingsModal / ProviderForm / EnvEditor / SessionEnvModal / AccountPanel
        status/            用量与上下文读数（UsageReadout / ContextMeter / ModelMenu / BranchTag）

• node 半区是函数插件（具名导出 name/inject/Config/apply），等待 webServer 服务后把 /cc/api 前缀路由注册到宿主 HTTP 服务上；不与宿主 cordis 发生类继承耦合。
• 浏览器半区通过 package.json 的 dsh.client 声明被 client-modules 自动扫描，bundle 以 window.__ModuleLoader__ 闭包格式构建，react / react-dom 走宿主模块表。

HTTP API（本机调试用）

全部 28 个方法-路径对，与 src/runtime.ts 的路由注册一一对应：

| 方法 | 路径 | 说明 | |---|---|---| | GET | /cc/api/config | 生效配置摘要：数据目录、默认 cwd、模型、权限模式、SDK 版本；环境变量逐键列出并标注来源层（进程 / 插件 / 页面设置），以 TOKEN / KEY / SECRET / PASSWORD / COOKIE 结尾的键打码，其余原样返回 | | GET | /cc/api/models | 当前全局配置下的模型目录（由 CLI / 网关解析；available: false 表示无 CLI 应答，回落静态别名） | | GET | /cc/api/settings | 读取页面可编辑设置层（模型 / permissionMode / env）；密钥值只返回不可回读的“已设置/设备不匹配”占位符 | | PUT | /cc/api/settings | 替换页面可编辑设置层（含账号列表）；密钥占位符表示保留原值，新密钥先设备加密再持久化到 dataDir/settings.json，并即时生效 | | POST | /cc/api/accounts/active | 切换当前账号根目录（{id}，空 id = 回默认）；有会话在跑返回 409 | | POST | /cc/api/images | 上传一张图片（原始字节 + content-type，≤ 5MB），返回内容寻址引用 | | GET | /cc/api/blobs/:id.:ext | 回读已存图片（immutable 长缓存） | | GET | /cc/api/fs/list?path= | 工作目录选择器的目录列表（无 path 列盘符根） | | GET | /cc/api/fs/index?path= | @ 提及菜单的项目文件索引：path 下的一次有界遍历（5000 行 / 层 2000 / 深 16，忽略依赖与构建目录），工作目录相对路径 + 截断标记；宿主侧短暂缓存 | | GET | /cc/api/fs/file?path= | 读取文本文件最新内容（≤2MB，超出截断；二进制拒绝） | | GET | /cc/api/sessions | 会话列表（含 CLI 原生会话；terminalOwned 标注终端持有）；env/accountEnv 密钥只含占位符，SSE 同样不传明文或密文 | | POST | /cc/api/sessions | 新建会话（可带名称 / cwd / 模型）；创建时把当时生效的账号根目录与服务商键域盖成该会话的绑定章（accountEnv + configDir），之后的 spawn 永远用它 | | GET | /cc/api/sessions/:id | 会话详情 + 转录（尾部 800 条）+ 进行中回合快照 + 任务表快照 | | DELETE | /cc/api/sessions/:id | 删除会话（连同 CLI 原生转录）；原生存储删除失败（如 Windows 下文件被终端进程占用）时返回 409 + error，会话保留 | | PUT | /cc/api/sessions/:id/name | 重命名（同步改 CLI 记录，claude --resume 列表同名；手动命名后永不被自动命名覆盖） | | PUT | /cc/api/sessions/:id/env | 会话级环境层；密钥设备加密、占位符保留原值；空闲引擎即时回收，下一条消息用新环境起进程 | | POST | /cc/api/sessions/:id/messages | 发送消息（可带图片引用）；一律立即推给 CLI，回合运行中由 CLI 的命令队列排队、本轮结束时整批合并成一个回合发出（queued 计数随 sessions 帧下发）；终端持有（terminalOwned）的会话返回 409 | | GET | /cc/api/sessions/:id/queue | CLI 报告为「在等」的消息（uuid + 正文 + 入队时间 + 附件数），投递顺序 | | DELETE | /cc/api/sessions/:id/queue/:uuid | 撤回一条排队消息（走 CLI 原生 dequeue）；已被取进回合则返回 404 | | GET | /cc/api/sessions/:id/context | 当前回合上下文占用（需活跃引擎） | | GET | /cc/api/sessions/:id/models | 会话视角的模型目录、当前选择与 effort 档位 | | POST | /cc/api/sessions/:id/model | 切换模型；持久化为该会话默认，忙碌引擎就地热切换 | | POST | /cc/api/sessions/:id/effort | 切换思考档位；per-session：持久化到该会话，只影响该会话 | | POST | /cc/api/sessions/:id/permission-mode | 切换权限模式；持久化为该会话默认，忙碌引擎就地热切换 | | GET | /cc/api/sessions/:id/usage | 账户用量（需活跃引擎） | | GET | /cc/api/sessions/:id/git | 会话 cwd 的 git 分支 / worktree / detached 读数（直接跑 git，无需活跃引擎；不在仓库内回 available: false） | | GET | /cc/api/sessions/:id/commands | CLI 支持的斜杠命令（需活跃引擎；冷会话回退到该「账号+项目」上次记档的目录，带 stale） | | POST | /cc/api/sessions/:id/commands | 先重新加载插件与技能再返回目录（改完技能不必重开会话）；插件/技能各自失败各自报，走 failures | | GET | /cc/api/sessions/:id/mcp | 该会话的 MCP 服务器与连接状态、作用域、工具数（读自活进程；无进程返回 available: false） | | POST | /cc/api/sessions/:id/mcp/:name | 对一个 MCP 服务器执行 reconnect / enable / disable，返回刷新后的列表；CLI 拒绝时原样透传原因（409） | | GET | /cc/api/sessions/:id/agents | 该会话可用的子代理目录（需活跃引擎） | | POST | /cc/api/sessions/:id/stop | 中断当前回合 | | POST | /cc/api/sessions/:id/tasks/:taskId/stop | 结束一个运行中的任务（子代理/命令等） | | POST | /cc/api/sessions/:id/tasks/:taskId/background | 把前台任务转后台继续跑（CLI 的 Ctrl+B 等价物） | | POST | /cc/api/sessions/:id/dialogs/:requestId | 应答 AskUserQuestion（cancel: true 取消） | | POST | /cc/api/sessions/:id/permissions/:requestId | 权限审批（allow / deny，可选 message 与 remember 目标） | | GET | /cc/api/events | SSE 实时推送（hello / sessions / event / delta / permission / dialog / tasks / telemetry …） |

已知限制

• 审批卡片的来源：插件自身的 permissionMode 默认就是 auto（config.ts），零配置时 Claude Code 自行允许/拒绝工具请求，页面收不到审批卡片。想在页面里审批，把它显式设为 default（cordis 配置或页内设置均可）；本机 ~/.claude/settings.json 的 permissions.defaultMode 是另一条同效果的来源，若设为 "auto" 页面同样收不到卡片。
• 权限模式为 default 时依赖页面在线答复授权请求；关着页面时请求会一直挂起（关会话则自动拒绝）。
• bypassPermissions 会跳过 Claude Code 全部确认，请仅在可信目录使用。
• 终端正在使用的会话（terminalOwned）在页面上只读：发消息返回 409，也无法中断它的回合 —— Windows 无法向其他控制台进程发信号。
• 每个活跃会话是一个真实 claude 进程，受 maxLiveSessions（默认 4）约束；被挤出的进程下次发消息时自动 resume。
• 转录读取对页面按尾部 800 条截断；完整记录在数据目录的 JSONL 里。
• 对话文本里的文件路径链接只作用于已完成回合的文本：流式中的文本保持普通代码样式，回合结束落定后才变成可点击链接。
• 斜杠命令菜单需要活跃引擎（新会话发出第一条消息后可用）；输入框与转录里的蓝色识别态依赖该会话的命令列表缓存，拿不到列表时保持普通文本。
• @ 提及只在 @ 位于行首或空白之后时触发（user@host 这类词中 @ 永不触发）；文件夹提及注入的是目录树而非文件内容；二进制或不可读的路径静默保持普通文本；一条消息全部提及的注入总量上限 1MB，超出部分打省略标记。
• SDK 固定为 @anthropic-ai/[email protected]（自带对应版本 CLI 载荷，与本机安装的 claude 版本无关）。

许可证

MIT