@young1lin/dsh-cc
DeepSeek Harness 网页 GUI 中的 Claude Code：右侧边缘停靠入口、会话覆盖层，以及可通过环境变量配置的 Claude Agent SDK 桥接器
插件会安装到这里；不确定时保持 web。
npx -y @deepseek-ai/dsh plugin --profile web add @young1lin/dsh-cc@0.1.4Cc 以 @young1lin/dsh-cc 发布，当前版本为 0.1.4。Plugin Hub 会校验它的 manifest，并保存精确安装来源，便于复现安装结果。
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 配置。
permissionMode 设为 default 后，Claude Code 的每次工具授权请求会弹到页面上，点「允许 / 拒绝」（可选记住为规则）即可/ 弹出 CLI 的命令目录（内置命令、用户技能、项目命令），↑↓ 选择、Tab/Enter 补全；识别为可调用的命令（含技能）在输入框与转录里显示蓝色识别态；/compact 等本地命令的输出以「命令输出」行进转录@ 即全项目模糊搜索 —— 一次有界索引（5000 行 / 层 2000 / 深 16，忽略 node_modules、.git 等重目录）覆盖整个工作目录，子序列匹配（mc 找 mention-core）按 basename 精确>前缀>连续>子序列排名；输入绝对路径则实时列出该目录子项导航盘上任何位置。↑↓/PageUp/PageDown/Home/End 选择，Enter/Tab 插入（整段替换半打的 token、自动补尾空格、文件夹补 /）；手打的 @相对路径 / @绝对路径 同样生效 —— 文件内容与文件夹目录树随消息注入上下文（总量上限 1MB）resets_at 时间戳，重置倒计时按用户本地时钟逐秒重算并直接显示在 5h / 周窗口旁，不会冻结在上次快照git rev-parse 获得 —— SDK 控制通道没有分支查询，CLI 持久化的 gitBranch 只是回合结束时的滞后快照；冷会话同样可查，回合结束后自动重读（回合中可能 git checkout 过）command_lifecycle 帧就是页面「谁在等」的唯一真相。等待中的消息在转录流上方成条列出（时间 + 首行预览 + 「撤回」），撤回走 CLI 原生 dequeue，撤得掉才算撤掉；本轮结束时整批合并成一个回合发出（CLI 的 coalescing，模型一次看到用户的连续意图，也只计一次费）。转录行在消息真正被取进回合时才写 —— 排队中的消息不会伪装成已发出。引擎异常死亡时未开跑的队列整体移交下一个进程MCP n/m 展开服务器列表 —— 连接状态、配置作用域、工具数、失败原因，可就地重连 / 停用 / 启用。哪些服务器生效取决于会话 cwd（项目作用域）、账号根目录（用户作用域）和企业策略，只有活进程解析全了这三层，所以这里读的是进程而不是配置文件；没配 MCP 的会话完全不显示这个控件/compact 或自动压缩进行中，进行中回合区显示「正在压缩对话」脉冲指示（CLI 的 status 帧）；完成即提示，失败以警告条给出原因<system-reminder>、单条 12k 截断）、命令输出、错误与回合计时；流式中点击带上未落定内容并注明「仍在进行中」）；每段 AI 正文、每段思考过程可单独复制；回合统计条上可一键复制整段回复；「分叉」「回滚文件」同为图标（Tooltip 注明用途）! 开头直接在会话工作目录执行命令，输出以「命令输出」行进转录并自动交给模型回应（CLI respondToBashCommands 语义）；权限姿态为默认 / 计划模式时拒绝执行并提示切换模式，不静默绕过权限Agent 委派与 Task 同卡片渲染；@ 文件菜单中命中字符品牌色高亮（排名依据一目了然）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（需要 Node 22+）：
npm install -g @deepseek-ai/dsh
然后用 dsh web 启动 Web GUI（已在运行则跳过，装完插件重启即可）。
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 Code 把一个账号的全部家当放在同一个根目录下：凭证、settings.json、记忆与技能、活进程注册表，以及 projects/<编码后的 cwd>/ 里的会话转录。所以「换账号」就是换这个根目录。
设置面板顶部的账号区维护一张目录列表（「添加账号」按钮加行，可浏览目录选路径），并标出当前用的是哪一个。点「切换」立即生效：会话列表、登录身份、模型目录、用量读数、记忆与技能、以及该根目录自己 settings.json 里的 permissions.defaultMode 一起换过去。列表的增删改随「保存」落盘，切换本身是独立接口 POST /cc/api/accounts/active。
两条规则值得记住：
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）
name/inject/Config/apply），等待 webServer 服务后把 /cc/api 前缀路由注册到宿主 HTTP 服务上；不与宿主 cordis 发生类继承耦合。dsh.client 声明被 client-modules 自动扫描，bundle 以 window.__ModuleLoader__ 闭包格式构建，react / react-dom 走宿主模块表。全部 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 + 正文 + 入队时间 + 附件数），投递顺序 |
permissionMode 默认就是 auto（config.ts），零配置时 Claude Code 自行允许/拒绝工具请求，页面收不到审批卡片。想在页面里审批，把它显式设为 default（cordis 配置或页内设置均可）；本机 ~/.claude/settings.json 的 permissions.defaultMode 是另一条同效果的来源，若设为 "auto" 页面同样收不到卡片。default 时依赖页面在线答复授权请求；关着页面时请求会一直挂起（关会话则自动拒绝）。bypassPermissions 会跳过 Claude Code 全部确认，请仅在可信目录使用。maxLiveSessions（默认 4）约束；被挤出的进程下次发消息时自动 resume。@ 提及只在 @ 位于行首或空白之后时触发（user@host 这类词中 @ 永不触发）；文件夹提及注入的是目录树而非文件内容；二进制或不可读的路径静默保持普通文本；一条消息全部提及的注入总量上限 1MB，超出部分打省略标记。@anthropic-ai/claude-agent-sdk@0.3.220（自带对应版本 CLI 载荷，与本机安装的 claude 版本无关）。| 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 …） |