同花顺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、权限、文件搜索全部来自真实数据，拿不到真实数据的面板显示明确空态，不回退模拟。
真实数据口径
| 指标 | 口径 |
|---|---|
| 分时主图 | 仅当天的累计 Token 消耗（meter 分钟桶按天隔离；每点 = 当天到该分钟为止的累计值，与日K收盘同口径） |
| 分时成交 | 仅当天的每分钟 Token 流量（新笔在前） |
| 涨跌幅（左栏 / 右栏 / 搜索） | 当日该工作区消耗 对昨日同一工作区的环比；无昨日数据时显示 0.00% |
| 日 K | 当日累计消耗；开盘 = 前一日收盘，收盘 = 当日总量（真实日桶，不生成噪声曲线） |
| 周 K / 月 K | 周期内日成交量的真实合计（周收盘 = 一周每日总量之和，月收盘 = 全月每日总量之和） |
| 5 日 | minuteSeriesByDay 的真实跨日分钟桶累计；旧版 meter 无该字段时退回日总量累计 |
| 子图（代码变更量） | 该工作区当日 git 净变更行数（红 = 净增，绿 = 净删） |
| Token 总量 | input + output + cacheRead + cacheWrite；reasoningTokens 已包含在 outputTokens 中，只进模型明细，不重复计总量 |
| 会话数 | meter 记录到的该工作区 distinct 会话数（无 meter 数据时退回 DSH 会话列表计数） |
| 状态栏连接态 | 快照连续拉取失败会显示「数据延迟」，此时面板仍展示最后一次成功的快照 |
所有工作区共享同一条全局分时序列（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 的集成路径（插件注入）
- 独立运行：
npm run dev模式，行情与轨迹全部本地模拟，右下角有demo · mock market徽标。 - 数据插件：
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 探针。
- 终端界面插件：
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。
- 组件复用：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 后即可用同批测试文件。
