同花顺harness

同花顺风格股票终端 + AI Agent 工作区融合的 DeepSeek Harness（DSH）终端式前端。

快速开始

npm install        # 依赖安装
npm run dev        # 开发服务器（默认 http://localhost:5173）
npm run build      # 类型检查 + 生产构建（dist/）
npm run preview    # 预览生产构建
npm test           # 单元测试（node:test，先经 tsc 编译）
npm run typecheck  # 仅类型检查

要求 Node ≥ 20.19（开发环境实测 Node 24）。

独立运行（npm run dev）时为确定性模拟行情；嵌入 DSH 后 token 行情、K 线、最近变更、git tree、权限、文件搜索全部来自真实数据，拿不到真实数据的面板显示明确空态，不回退模拟。

真实数据口径

所有工作区共享同一条全局分时序列（meter 未按工作区拆分钟桶）；每工作区独立分时需要
变更 wire 格式，见 plan/ 中的记录。

代码结构

client-plugin/                 # DSH 客户端插件 @deepseek-ai/dsh-client-tonghuashun
  src/                         # 终端 UI 本体（App / components / lib / data / bridge / styles）
  src/index.ts                 # node half（空 apply）
  src/client/                  # 浏览器半：样式注入 + 'root' 槽注册（TerminalRoot）
  scripts/gen-styles.mjs       # 构建期样式烘焙（global.css → styles.generated.ts）
  scripts/smoke-bundle.mjs     # bundle 装载 + SSR 冒烟
  deploy/web-terminal.patch.yml  # 禁用默认 web UI 行的 profile overlay
  tsdown.config.ts             # 复刻 monorepo clientBundle 产物约定（闭包工厂 + 平台外部化）
src/main.tsx                   # 独立开发外壳入口（Vite，引用 client-plugin 的 UI 源码）
styles 见 client-plugin/src/styles/global.css（主题，CSS 变量，红涨绿跌）
plugin/                        # 数据插件 dsh-tonghuashun-meter（bundle，详见 plugin/README.md）
  src/  fold / aggregate / store / index（cordis 入口）
  scripts/smoke-real-session.mjs   # 真实会话日志冒烟（解码 session.jsonl.zstd）
tests/                         # node:test 单元测试（数据层）

数据层说明：client-plugin/src/lib/（rand / format / market / useMarketEngine）、
client-plugin/src/data/trajectory.ts、client-plugin/src/bridge/（DSH 数据接入契约 + 插件快照契约，
详见 client-plugin/src/bridge/README.md）。

与 DSH 的集成路径（插件注入）

1. 独立运行：npm run dev 模式，行情与轨迹全部本地模拟，右下角有 demo · mock market 徽标。
2. 数据插件：plugin/ 是 bundle 形态的 dsh-tonghuashun-meter——挂载后
   （官方加载方式是 dsh 仓库根目录源码启动 pnpm dsh），
   实时收集/记录每个会话的 Token 消耗与工具调用（$DSH_HOME/tonghuashun/usage.jsonl + days.json），
   读取工作区 git 提交/文件树/LOC，并在 web 组合暴露 GET /tonghuashun/snapshot；
   前端 client-plugin/src/bridge/snapshot.ts 已含契约与 fetch 探针。
3. 终端界面插件：client-plugin/ 是 @deepseek-ai/dsh-client-tonghuashun（bundle + dsh.client），
   浏览器半注册 'root' 槽替换默认界面；安装 = pnpm dsh plugin --profile web add "<repo>/client-plugin"
   • 叠加 deploy/web-terminal.patch.yml 禁用默认 web UI 行（'root' 是 single 槽，先到先得）。
     会话/Trajectory/队列、快照→UI 映射、权限投影、文件索引搜索均已接入，详见 client-plugin/src/bridge/README.md。
4. 组件复用：DSH SDK 中可替换的现成组件（ui-conversation / ui-trajectory / ui-primitives）已评估，
   本 profile 因接管 root 槽而禁用默认 UI 行，本轮保持自绘实现（见 bridge README）。

历史回填、数据本地保存方式与隐私边界见根目录 AGENT.md；meter 插件的回填命令为
cd plugin && npm run backfill。

开发注意事项

• .npmrc 设置了 ignore-scripts=true：本仓库最初在受限沙箱内开发，包 postinstall 脚本（如 esbuild 校验）无法 spawn 子进程，但 esbuild 平台二进制以 optionalDependencies 安装，构建不受影响。在普通开发机上可删除该设置后重新安装。
• 测试脚本使用 node --test --experimental-test-isolation=none：test runner 按文件 spawn 子进程在沙箱内被禁，改为进程内运行。
• 测试管线为「tsc 编译到 .test-dist/（CommonJS）→ node:test」，不依赖 vitest/esbuild 转译；如需 vitest 工作流，安装 vitest 后即可用同批测试文件。