前言¶
在 DeepSeek Harness (DSH) 的插件化生态中，可视化监控 Agent 的行为与项目状态是提升开发效率的关键。现有的方案往往缺乏直观的行情展示，难以快速捕捉代码量的变化趋势与 Token 消耗情况。dsh-tonghuashun 插件旨在解决这一问题，它提供了同花顺行情终端风格的界面皮肤，并集成了代码量 K 线行情面板，帮助开发者以更直观的方式审视 Agent 的“运行轨迹”。
是什么¶
dsh-tonghuashun 是一个 DSH harness 客户端插件。它包含两个核心部分：
1. 同花顺行情终端风格皮肤：基于 ui-skin-ths 和 ui-market 模块构建。
2. 代码量 K 线行情面板：位于宿主详情栏右侧，用于展示代码行数与 Token 使用情况。
该插件由 AdamPlatin123 维护，遵循 MIT 协议。
核心功能¶
K 线行情面板¶
K 线面板位于右侧，默认宽度 360px、高度 260px。它支持以下模式：
* 连续柱流：逐笔记录，首尾相接，用于查看完整的代码变更流。
* 逐步：每一笔变化占一根，等距排列，方便逐笔核对。
* 分时：基于真实时间，横轴为时间刻度，自动处理空槽。
* 日 / 周 / 月：按 UTC 日历聚合，周从周一开始。
纵轴口径¶
面板底部纵轴支持三档口径：
1. 绝对行数：项目真实总量。
2. 相对基线：总量减去固定锚点。
3. 每笔变化：单根柱的净变化（0 居中）。当总量漂移较大时，此口径能避免小改动被压扁。
视觉与筛选¶
- 空/满表示：实心表示 Agent 归属的改动（红涨绿跌），空心表示未归属的改动（如外部校准、补齐漂移）。
- 仅 Agent 筛选：勾选后仅绘制 Agent 归属柱，纵轴按 Agent 柱计算，避免大额漂移干扰视线。
Git 统计规则¶
统计以 git ls-files --cached --others --exclude-standard 为准：
* 已跟踪文件：永远计入。
* 未跟踪文件：若被 .gitignore 忽略，视为“外部校准”，产生灰色未归属柱。
* 修改忽略文件：不产生 K 线，状态中标记 git-ignored-source-excluded。
Token 口径¶
按宿主提供者记录保存：未缓存输入、缓存读取、缓存写入、输出及推理。推理不重复计入总量。
安装与启用¶
本插件兼容 DSH Desktop 2.0.5 内置的 Harness 0.1.2-rc.1 及同版网页客户端。
构建后，通过 DSH 官方命令加入目标 Profile：
dsh plugin --profile desktop add -w "./dsh-tonghuashun-0.3.4.tgz"
应用重新加载后，在常规设置中切换“同花顺风格皮肤”。默认启用，关闭或卸载会还原主题覆盖。
典型用法¶
- 构建插件：在插件目录下执行
npm pack，生成dsh-tonghuashun-0.3.4.tgz。 - 安装：执行上述安装命令。
- 预览调试：本地开发时可运行
npm run dev，默认地址http://127.0.0.1:4317。预览操作仅修改output/acceptance-project/src/ledger.js。 - 导出数据：点击导出按钮可获取当前项目的 JSON 数据。
适用场景与注意¶
- 适用场景：需要长时间观察 Agent 编程过程、监控代码行数变化趋势、统计 Token 消耗的开发者。
- 头部压缩：宿主头部行情条按可用宽度分级收缩，始终保留代码总量与状态点。插件自身内容上限为 42vw。宿主的
headerUtilities为flex:none，插件只能压缩自身内容，不会挤压宿主标题。 - 数据共享：网页和桌面连接同一个本机 Host 时共用数据。一个账本由一个 Host 进程写入，独占锁阻止第二个 Host 静默覆盖。
- Shell 命令限制：Shell 命令没有宿主级文件归属证据，不会仅凭命令成功就生成 Agent K 线，实际总量会重扫校准。
结尾¶
dsh-tonghuashun 通过轻量级图表与同花顺风格的结合，为 DSH 用户提供了可视化的项目监控手段。其 MIT 许可证允许自由使用与修改，早期实现仍可在仓库历史中取回。仓库地址：https://github.com/AdamPlatin123/dsh-tonghuashun。
