@cjhyy/code-shell-server

@cjhyy/code-shell-server

CodeShell 服务端传输层（纯 Node、零 Electron）：mobile remote 的 HTTP/WS host、配对、passcode 门、tunnel、rooms、上传，以及 headless 无账号 Web host（code-shell-serve）。

聚焦入口

宿主代码应选择职责最窄的稳定入口：

入口	职责
@cjhyy/code-shell-server/storage	磁盘 Session、附件暂存、图片探测和稳定 client-message ID
@cjhyy/code-shell-server/worker	与传输无关的 stdio worker 生命周期和行协议桥接
@cjhyy/code-shell-server/mobile-remote	配对、访问门禁、rooms、上传、LAN/tunnel host 和移动端协议类型
@cjhyy/code-shell-server/serve	Headless HTTP/WebSocket host 与 code-shell-serve CLI 组合默认值

import { listDiskSessions } from "@cjhyy/code-shell-server/storage";
import { RemoteHostManager } from "@cjhyy/code-shell-server/mobile-remote";
import { WorkerBridgeCore } from "@cjhyy/code-shell-server/worker";

包根入口仍是四个入口的兼容并集。新消费方应避免根入口，以免只使用 storage 或 transport 时也求值无关的宿主组合。

/storage、/worker 和 /mobile-remote 没有 Coding/Web 静态导入。外部 Agent 策略由产品宿主通过 ResidentAgentOptions.appendSystemPrompt 注入。 /serve 则是有意保留的开箱即用产品入口：CLI 被调用时解析 Coding stdio worker 和已构建的 Web app。

code-shell-serve — 无账号 Web host

在任意机器上把一个 workspace 变成浏览器可访问的 CodeShell：

# 构建（repo 内）：core → coding → server → web app
bun run build && bun run --cwd packages/web build:app

# 启动
node packages/server/dist/bin/code-shell-serve.js \
  --cwd ~/work/my-repo \
  --port 8790 \
  --passcode <你的口令>     # 省略则首次启动生成随机口令并打印一次

浏览器打开 http://127.0.0.1:8790：输入口令（记住 cookie 后不再询问）→ 会话列表 / 新建对话 / 流式输出 / 工具审批 / 停止。

架构

浏览器 SPA（packages/web dist-app，说 core JSON-RPC 协议）
   │  WS /ws（passcode/cookie 门禁）
headless serve（本包 serve/）
   │  stdio line-JSON-RPC（WorkerBridgeCore：按需 spawn、崩溃记账）
agent-server-stdio worker（@cjhyy/code-shell-capability-coding）

• 浏览器使用受限的 core 协议投影：serve 自己处理会话列表/详情，只允许向 worker 转发 agent/run、agent/approve、agent/cancel，并在转发前校验 workspace 与 session 归属。配置修改、任意 workspace 切换等原始 RPC 不对 Web 开放。
• 每个 tab 的请求 ID 会在 host 内重写，响应只回到发起 tab；agent/streamEvent 等通知才广播给所有已认证 tab，避免多 tab 使用相同本地 ID 时串包。
• 访问控制只有 passcode + remember-cookie（决策见 TODO 约束边界「服务端部署不做账号体系」）：scrypt 哈希存储、防爆破锁定、轮换口令使所有旧 cookie 失效。无注册登录、无多用户。
• 默认只绑 127.0.0.1；--host 0.0.0.0 暴露到局域网是运维者的显式选择。公网建议走反向代理/tunnel 终结 TLS。
• 会话、设置与凭据持久在 serve 独占的 worker data root（默认 <data-dir>/worker），不再读取宿主机默认 ~/.code-shell；serve 或 worker 重启后浏览器重连即可恢复列表。

CLI 参数

参数	默认	说明
--cwd	当前目录	worker 的 workspace 根
--port	8790	监听端口
--host	127.0.0.1	监听地址
--passcode	（生成）	设置/轮换访问口令
--data-dir	~/.code-shell/serve	access.json 与隔离 worker data root 的父目录
--static-root	自动解析 web dist-app	覆盖静态资源目录

Web 客户端开发

bun run --cwd packages/web dev:app   # vite dev server，/ws 代理到 127.0.0.1:8790