@johnnren/dsh-zen 1.0.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 dsh-zen contributors
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,123 @@
+# dsh-zen
+
+A Zen Mode view tab + foreground time tracker for [DeepSeek Harness](https://github.com/deepseek-ai/deepseek-harness) (DSH).
+
+While an agent works in the background, switch to the **Zen** tab and get a calm, minimal
+surface: a status message, your latest user message, and one line of statistics — no tool
+calls, no reasoning rows, no noise. Zen also tracks how much of your "running" time was spent
+actually watching the screen, and reports a daily / weekly Zen score.
+
+[中文说明](./README.zh-CN.md)
+
+## Screenshots
+
+Zen view (while generating) | Zen view (done) | Zen settings
+:---: | :---: | :---:
+![Zen view while generating](docs/screenshots/zen-running.png) | ![Zen view done](docs/screenshots/zen-view.png) | ![Zen settings](docs/screenshots/settings.png)
+
+## Features
+
+- **Zen view tab** — a dedicated `conversation.view` tab (`对话 / Zen / 轨迹`), showing:
+  - running / done status message (configurable, with or without the second-line description)
+  - your user message (while generating), the previous round's reply and live activity hints
+  - the final AI reply rendered with markdown
+  - one-line turn stats: `步数 N · 用时 Nm · 统计`
+- **Foreground time tracker** — records foreground (visible window) vs. total running time
+  per session, persisted in `localStorage`. Daily / weekly **Zen score** (`100% − 盯屏比例`)
+  is shown in the settings panel.
+- **Chat hide toggle** — a header button (`隐藏中间过程`) that hides tool-call, command,
+  context, compaction, reasoning rows, etc. from the chat view via CSS.
+- **Auto enter / exit Zen** — optional: auto-switch to the Zen tab when a task starts, and
+  back to chat when it completes.
+- **Shortcut** — press `Alt+Z` to toggle between the Zen and chat views from anywhere.
+- **Animation toggle** — disable all entry animations/transitions in Zen view if you prefer
+  instant rendering.
+
+## Install
+
+This plugin is distributed as a DSH bundle. It requires a Web-capable profile (the default
+`web` profile).
+
+### From a Git repository (recommended)
+
+```sh
+dsh plugin --profile web add github:john-walks-slow/dsh-zen#<40-character-commit>
+```
+
+Then restart `dsh web`. The bundle patch (`cordis.patch.yml`) inserts the `zen` row
+into the profile's composition, and the Web client is served from the committed `lib/client.js`.
+
+> Prefer pinning the exact commit hash; a floating branch can be force-pushed. See
+> [docs/PUBLISHING.md](docs/PUBLISHING.md) for the catalog submission flow.
+
+### From npm (once published)
+
+```sh
+dsh plugin --profile web add @johnnren/dsh-zen
+```
+
+## Usage
+
+1. Open any conversation in the DSH Web GUI.
+2. Click the **Zen** tab (or press `Alt+Z`) to switch to the Zen view.
+3. Optionally use the **隐藏中间过程** button in the session header to collapse
+   intermediate process nodes in the chat view.
+4. Open **Settings → Zen 设置** to configure what is shown:
+   - 显示进行中标题 / 显示进行中副标题 / 显示结束标题 — status message title/subtitle on/off
+   - 生成中显示用户消息 / 生成中显示上轮回复 / 生成中显示动态 — hints shown while generating
+   - 显示本轮轮次和用时 — the `步数 N · 用时 Nm` line
+   - 显示盯屏时间统计 — the foreground stats tooltip
+   - 自动进入禅 / 自动解除禅 — auto view switching on task start / complete
+   - 动效 — entry animations on/off
+
+The settings panel also shows your **今日禅 / 本周禅** scores and the current Zen level.
+
+## Development
+
+```sh
+npm install
+npm run build        # bundle src/client.ts + src/index.ts → lib/, deploy into web profile
+npm run typecheck    # tsc --noEmit against the local shims in src/dts-shim.d.ts
+```
+
+The deploy target is `$DSH_HOME/profiles/web/node_modules` (default `~/.dsh`). Client-only
+changes need a page refresh; host-side changes need a DSH restart.
+
+### Repository layout
+
+```
+├── src/
+│   ├── client.ts            # Web client: slots, settings section, shortcuts
+│   ├── index.ts             # Host face (empty apply; bundle row only)
+│   ├── foreground-tracker.ts# Foreground time tracking + persistence
+│   ├── zen-settings.ts      # Settings store + migration
+│   ├── locales.ts           # zh / en dictionaries
+│   └── components/          # ZenView, ChatHideToggle, ZenSettingsSection
+├── lib/                     # Committed build artifacts (client factory bundle + host)
+├── assets/icon.svg          # Plugin icon
+├── cordis.patch.yml         # Bundle patch: inserts the zen row
+├── build.mjs                # esbuild bundler + deploy
+└── docs/                    # Screenshots and publishing guide
+```
+
+## Compatibility
+
+- Requires DeepSeek Harness with the Web client module system (default `web` profile).
+- Slot contracts used: `conversation.view`, `conversation.session.header.actions`,
+  `settings.section`. Verify against your Harness version's source snapshot if upgrading.
+- **Zero permissions**: no network requests, no file system access, no external
+  services — the host face is an empty `apply()` and all data stays in browser
+  `localStorage` (`dsh.zen.*`). 无网络请求、无文件写入、无外部服务、无遥测。
+
+## Uninstall
+
+```sh
+dsh plugin --profile web remove @johnnren/dsh-zen
+```
+
+Or remove the row from the profile composition. Stored stats/settings in `localStorage`
+can be cleared by deleting keys prefixed `dsh.zen.`.
+
+## License
+
+MIT — see [LICENSE](LICENSE).

package/README.zh-CN.md

@@ -0,0 +1,114 @@
+# dsh-zen
+
+为 [DeepSeek Harness](https://github.com/deepseek-ai/deepseek-harness)（DSH）打造的 **禅（Zen）模式视图** + **前台盯屏时间统计** 插件。
+
+当智能体在后台干活时，切到 **Zen** 标签页，得到一块干净、极简的界面：一条状态文案、你最新发出的用户消息、一行统计——没有工具调用、没有推理过程、没有噪音。同时 Zen 会记录你「任务运行中」到底有多少时间真的盯着屏幕，并给出每日 / 每周禅值。
+
+[English README](./README.md)
+
+## 截图
+
+禅视图（生成中） | 禅视图（完成态） | 设置面板
+:---: | :---: | :---:
+![Zen view（生成中）](docs/screenshots/zen-running.png) | ![Zen view（完成态）](docs/screenshots/zen-view.png) | ![Zen settings](docs/screenshots/settings.png)
+
+## 功能
+
+- **Zen 视图标签** —— 独立的 `conversation.view` 标签（对话 / Zen / 轨迹），展示：
+  - 进行中 / 结束状态文案（可配置，第二行描述可隐藏）
+  - 生成中的用户消息、上轮回复与动态提示
+  - 最终 AI 回复（Markdown 渲染）
+  - 一行本轮统计：`步数 N · 用时 Nm · 统计`
+- **前台盯屏统计** —— 按会话记录「窗口可见」时长与「运行」总时长，持久化在 `localStorage`。
+  设置面板展示每日 / 每周 **禅值**（`100% − 盯屏比例`）与当前禅等级。
+- **隐藏中间过程按钮** —— 会话头部按钮（`隐藏中间过程`），通过 CSS 一键隐藏对话视图中的
+  工具调用、命令、上下文注入、压缩、推理行等中间节点。
+- **自动进出禅** —— 可选：任务开始时自动切入 Zen 标签，任务完成时自动切回对话。
+- **快捷键** —— 任意位置按 `Alt+Z` 在 Zen 视图与对话视图间切换。
+- **动效开关** —— 可关闭 Zen 视图内的全部入场动画与过渡，改为瞬时渲染。
+
+## 安装
+
+本插件以 DSH bundle 形式分发，需要 Web 能力 profile（默认 `web` profile）。
+
+### 从 Git 仓库安装（推荐）
+
+```sh
+dsh plugin --profile web add github:john-walks-slow/dsh-zen#<40位commit>
+```
+
+然后重启 `dsh web`。bundle 补丁（`cordis.patch.yml`）会把 `zen` 行插入 profile 组合，
+Web 客户端由已提交的 `lib/client.js` 提供。
+
+> 建议固定完整 commit 哈希，避免分支被强推导致安装内容漂移。
+> 商店上架流程见 [docs/PUBLISHING.md](docs/PUBLISHING.md)。
+
+### 从 npm 安装（发布后可用）
+
+```sh
+dsh plugin --profile web add @johnnren/dsh-zen
+```
+
+## 使用
+
+1. 在 DSH Web GUI 打开任意会话。
+2. 点击 **Zen** 标签（或按 `Alt+Z`）进入禅视图。
+3. 可选：使用会话头部的「隐藏中间过程」按钮折叠对话视图中的中间过程节点。
+4. 打开 **设置 → Zen 设置** 配置显示内容：
+   - 显示进行中文案 / 显示结束文案 —— 状态文案开关
+   - 生成中显示用户消息 / 生成中显示上轮回复 / 生成中显示动态 —— 生成中的提示
+   - 显示本轮轮次和用时 —— `步数 N · 用时 Nm` 一行
+   - 显示盯屏时间统计 —— 前台统计 tooltip
+   - 自动进入禅 / 自动解除禅 —— 任务开始 / 完成时自动切换视图
+   - 动效 —— 入场动画开关
+
+设置面板同时展示 **今日禅 / 本周禅** 分数与当前禅等级。
+
+## 开发
+
+```sh
+npm install
+npm run build        # 打包 src/client.ts + src/index.ts → lib/，部署到 web profile
+npm run typecheck    # 基于 src/dts-shim.d.ts 本地 shim 做 tsc --noEmit
+```
+
+部署目标为 `$DSH_HOME/profiles/web/node_modules`（默认 `~/.dsh`）。仅客户端改动刷新页面即可；
+host 侧改动需要重启 DSH。
+
+### 仓库结构
+
+```
+├── src/
+│   ├── client.ts            # Web 客户端：slots、设置分区、快捷键
+│   ├── index.ts             # Host 面（空 apply；仅 bundle 行）
+│   ├── foreground-tracker.ts# 前台时长统计 + 持久化
+│   ├── zen-settings.ts      # 设置 store + 迁移
+│   ├── locales.ts           # zh / en 词典
+│   └── components/          # ZenView、ChatHideToggle、ZenSettingsSection
+├── lib/                     # 已提交的构建产物（client factory bundle + host）
+├── assets/icon.svg          # 插件图标
+├── cordis.patch.yml         # bundle 补丁：插入 zen 行
+├── build.mjs                # esbuild 打包 + 部署
+└── docs/                    # 截图与发布指南
+```
+
+## 兼容性
+
+- 需要带 Web 客户端模块系统的 DeepSeek Harness（默认 `web` profile）。
+- 使用的 slot 契约：`conversation.view`、`conversation.session.header.actions`、
+  `settings.section`。升级 Harness 版本时请对照对应源码快照核验。
+- **零权限**：无网络请求、无文件写入、无外部服务——host 面是空的 `apply()`，
+  所有数据保存在浏览器 `localStorage`（`dsh.zen.*`），无遥测。
+
+## 卸载
+
+```sh
+dsh plugin --profile web remove @johnnren/dsh-zen
+```
+
+或从 profile 组合中移除对应行。如需清除数据，删除 `localStorage` 中前缀为
+`dsh.zen.` 的键。
+
+## License
+
+MIT — 见 [LICENSE](LICENSE)。

package/assets/icon.svg

@@ -0,0 +1,9 @@
+<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 128 128" width="128" height="128">
+  <rect width="128" height="128" rx="24" fill="#0f172a"/>
+  <circle cx="64" cy="64" r="40" fill="none" stroke="#38bdf8" stroke-width="8"/>
+  <path d="M64 24v24M64 80v24" stroke="#38bdf8" stroke-width="8" stroke-linecap="round"/>
+  <path d="M64 30c-14 0-24 10-24 24 0 8 5 12 5 12h38s5-4 5-12c0-14-10-24-24-24z" fill="#0ea5e9" opacity="0.25"/>
+  <circle cx="52" cy="58" r="4" fill="#38bdf8"/>
+  <circle cx="76" cy="58" r="4" fill="#38bdf8"/>
+  <path d="M56 68h16" stroke="#38bdf8" stroke-width="5" stroke-linecap="round"/>
+</svg>

package/cordis.patch.yml

@@ -0,0 +1,3 @@
+- insert:
+    - id: zen
+      name: '@johnnren/dsh-zen'