tonghuashun-webuiDeepSeek Harness plugin

仿同花顺的webui插件

GitHub
Stars
19
Forks
3
License
Unspecified
Last commit
Sep 1, 2026

Overview

仿同花顺的webui插件

Original README

Cached from the project repository on Sep 3, 2026. This is source content, separate from the Agents.md review above.

View source

同花顺harness

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

设计参考截图1 设计参考截图2

快速开始

bash
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 的集成路径（插件注入）

  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 后即可用同批测试文件。