claude-code-mode 0.0.0-stage → 0.3.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 claude-code-mode 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

@@ -1,3 +1,102 @@
-# Temporary Holding Version
+<div align="center">
 
-This version is a temporary placeholder for this package. An operational version to replace this has been submitted for review and is awaiting a staged release.
+# claude-code-mode
+
+**A session workspace for DeepSeek Harness, modeled on the Claude app.**
+
+<a href="https://www.npmjs.com/package/claude-code-mode"><img alt="npm version" src="https://img.shields.io/npm/v/claude-code-mode" /></a>
+<a href="https://www.npmjs.com/package/claude-code-mode"><img alt="npm downloads" src="https://img.shields.io/npm/dm/claude-code-mode" /></a>
+<a href="https://github.com/little-thing/claude-code-mode/actions/workflows/ci.yml"><img alt="CI" src="https://github.com/little-thing/claude-code-mode/actions/workflows/ci.yml/badge.svg" /></a>
+<a href="https://github.com/little-thing/claude-code-mode/stargazers"><img alt="GitHub stars" src="https://img.shields.io/github/stars/little-thing/claude-code-mode" /></a>
+<a href="https://opensource.org/licenses/MIT"><img alt="License: MIT" src="https://img.shields.io/badge/License-MIT-yellow.svg" /></a>
+<a href="https://www.npmjs.com/package/@deepseek-ai/dsh?activeTab=versions"><img alt="DSH 0.2.2-rc.1+" src="https://img.shields.io/badge/DSH-0.2.2--rc.1%2B-4d6bfe" /></a>
+
+English · <a href="./README_ZH.md">简体中文</a>
+
+</div>
+
+<div align="center">
+  <video src="https://github.com/user-attachments/assets/d6eb91bd-b836-41ce-af9d-90cd9acd4bf1" muted autoplay loop playsinline controls width="100%"></video>
+</div>
+
+DSH keeps every session as an independent row in a flat list. A fork looks like any other conversation, and comparing two sessions means switching back and forth.
+
+claude-code-mode gives that list the structure of the Claude app: sessions remember where they came from, several can stay visible at once, and each carries its own tools. Everything DSH already does keeps working — the plugin changes how sessions are organised and presented, not what the host can do.
+
+## Features
+
+| | |
+|---|---|
+| **Session tree**<br/>Forked sessions stay attached to their source, and a fork of a fork still hangs under the same root, so a line of work reads as one continuous tree. Collapsed branches keep their parent visible with a count of what is hidden.<br/><img alt="Session tree" src="docs/media/session-tree.png" width="100%"> | **Split view**<br/>Up to four sessions on one screen, arranged in two columns and two rows. Each pane is a complete session with its own composer, scroll position and right rail, and the layout survives a reload.<br/><img alt="Split view" src="docs/media/split-view.png" width="100%"> |
+| **Pins and sections**<br/>Pin the sessions you return to most. Sections are groups that cut across projects, so sessions from different repositories can sit in one place without being moved out of their project.<br/><img alt="Pins and sections" src="docs/media/sections.png" width="100%"> | **Right rail**<br/>Files, editor, terminal, Git, browser and session diagnostics live in a rail bound to the session rather than to the window. Panels can be split, maximized and rearranged, and every pane in split view keeps its own rail.<br/><img alt="Right rail" src="docs/media/right-rail.png" width="100%"> |
+| **Views and sorting**<br/>Group sessions by folder, date, status, or not at all; sort by last update, creation date or name in either direction. Archived sessions can be shown or hidden, and each group remembers its own view.<br/><img alt="View menu" src="docs/media/view-menu.png" width="100%"> | **Message rewind**<br/>Return to any user message and continue from there. The session log is left untouched, and files changed in the rewound range can be restored when nothing has touched them since.<br/><img alt="Message rewind" src="docs/media/rewind.png" width="100%"> |
+| **Search and new sessions**<br/>One palette searches sessions, projects, automations and actions. Unsent drafts survive switching sessions and follow you when you start a session in another project.<br/><img alt="Search" src="docs/media/search.png" width="100%"> | **Image preview**<br/>Every image inside a session — tool output, collapsed summaries, message links and delivered files — opens in the same full-size lightbox.<br/><img alt="Image preview" src="docs/media/image-preview.png" width="100%"> |
+| **Session actions**<br/>Rename in place, fork, archive, delete, copy the session ID, and browse every session in a full page with active and archived tabs.<br/><img alt="Session actions" src="docs/media/session-actions.png" width="100%"> | **Skins**<br/>A light and a dark skin modeled on the Claude app. The skin is a separate layer: switch it off and every feature keeps working in DSH's native look.<br/><img alt="Skin" src="docs/media/skin.png" width="100%"> |
+
+**Also**: a settings page with a switch per feature (sidebar, split view, session header, right rail, message rewind, image preview — all on by default) · background jobs with running and completed groups · window controls for the sidebar, back and forward · `mcp_tool_search`, which keeps MCP tools out of the model context until they are needed · a shimmer on sessions that are still running.
+
+## Settings
+
+Every feature can be turned off in **Settings → claude-code-mode**. Switches are grouped by what you see — the sidebar, split view, the session header, the right rail, message rewind and image preview — so a single switch can cover several related behaviours. Turning one off hands that part of the interface back to DSH. The skin picker lives in the same section and offers the Claude skin or DSH's native look.
+
+## Install
+
+**Web profile:**
+
+```bash
+dsh plugin --profile web add claude-code-mode@latest
+```
+
+**Desktop app:**
+
+```bash
+dsh plugin --profile desktop add claude-code-mode@latest
+```
+
+Open DeepSeek Harness Desktop once so it initializes its profile, then quit the app before running the command.
+
+Restart DSH if the plugin does not load by itself, then refresh the page.
+
+Requires DSH **0.2.2-rc.1** or newer; older hosts are rejected at install time.
+
+<details>
+<summary><b>Install from source</b></summary>
+
+```bash
+git clone https://github.com/little-thing/claude-code-mode.git
+cd claude-code-mode
+pnpm install && pnpm build
+dsh plugin --profile web add file:$PWD   # or --profile desktop
+```
+
+</details>
+
+## Compatibility
+
+| DSH version | Status |
+|---|---|
+| `0.2.2-rc.1` and newer | Supported |
+| `< 0.2.2-rc.1` | Rejected at install time |
+
+## Development
+
+<details>
+<summary><b>Build and test</b></summary>
+
+```bash
+pnpm install
+pnpm build
+node --test test/mcp-tool-search/*.test.mjs test/theme/*.test.mjs
+```
+
+</details>
+
+## License
+
+MIT.
+
+---
+
+<div align="center">
+  <sub>Built for the <a href="https://github.com/deepseek-ai/deepseek-harness">DeepSeek Harness</a> ecosystem · <a href="https://github.com/little-thing/claude-code-mode">github.com/little-thing/claude-code-mode</a></sub>
+</div>

package/README_ZH.md

@@ -0,0 +1,102 @@
+<div align="center">
+
+# claude-code-mode
+
+**为 DeepSeek Harness 打造的会话工作区，界面参照 Claude 应用。**
+
+<a href="https://www.npmjs.com/package/claude-code-mode"><img alt="npm version" src="https://img.shields.io/npm/v/claude-code-mode" /></a>
+<a href="https://www.npmjs.com/package/claude-code-mode"><img alt="npm downloads" src="https://img.shields.io/npm/dm/claude-code-mode" /></a>
+<a href="https://github.com/little-thing/claude-code-mode/actions/workflows/ci.yml"><img alt="CI" src="https://github.com/little-thing/claude-code-mode/actions/workflows/ci.yml/badge.svg" /></a>
+<a href="https://github.com/little-thing/claude-code-mode/stargazers"><img alt="GitHub stars" src="https://img.shields.io/github/stars/little-thing/claude-code-mode" /></a>
+<a href="https://opensource.org/licenses/MIT"><img alt="License: MIT" src="https://img.shields.io/badge/License-MIT-yellow.svg" /></a>
+<a href="https://www.npmjs.com/package/@deepseek-ai/dsh?activeTab=versions"><img alt="DSH 0.2.2-rc.1+" src="https://img.shields.io/badge/DSH-0.2.2--rc.1%2B-4d6bfe" /></a>
+
+<a href="./README.md">English</a> · 简体中文
+
+</div>
+
+<div align="center">
+  <video src="https://github.com/user-attachments/assets/d6eb91bd-b836-41ce-af9d-90cd9acd4bf1" muted autoplay loop playsinline controls width="100%"></video>
+</div>
+
+DSH 把每个会话当作扁平列表里的一条独立记录：分叉出来的会话看起来和别的对话没有区别，想同时看两个会话，只能来回切换。
+
+claude-code-mode 把这份列表换成 Claude 应用那样的结构：会话保留来源关系，多个会话可以同时显示，每个会话带着自己的工具。DSH 原有的能力全部保留 —— 插件改变的是会话如何组织和呈现，不是宿主能做什么。
+
+## 功能
+
+| | |
+|---|---|
+| **会话树**<br/>fork 出来的会话挂在来源下面，fork 再 fork 也回到同一根行，一支工作长成一棵连续的树。折叠后父行仍然可见，并标出被收起的会话数量。<br/><img alt="会话树" src="docs/media/session-tree.png" width="100%"> | **分屏**<br/>一屏最多四个会话，按两列两行排布。每一屏都是完整会话，有自己的输入框、滚动位置和右栏；布局在刷新后保留。<br/><img alt="分屏" src="docs/media/split-view.png" width="100%"> |
+| **置顶与分区**<br/>把常用的会话固定在最上面。分区是跨项目的分组，不同仓库的会话可以放在一起，而不必离开各自的项目。<br/><img alt="置顶与分区" src="docs/media/sections.png" width="100%"> | **右栏**<br/>文件、编辑器、终端、Git、浏览器和会话诊断都在属于会话而不是窗口的右栏里。面板可以分栏、最大化和重新排列，分屏时每一屏各自保留自己的右栏。<br/><img alt="右栏" src="docs/media/right-rail.png" width="100%"> |
+| **视图与排序**<br/>按文件夹、日期、状态或不分组建视图；按上次更新、创建日期或名称正序或倒序排列。归档会话可以选择显示或隐藏，每个分组记住自己的视图。<br/><img alt="视图菜单" src="docs/media/view-menu.png" width="100%"> | **消息回退**<br/>回到任意一条用户消息，从那里继续对话。会话日志不会被改写；如果回退范围内的文件此后没有被改动过，可以一并还原。<br/><img alt="消息回退" src="docs/media/rewind.png" width="100%"> |
+| **搜索与新建**<br/>一个搜索入口覆盖会话、项目、自动化和操作。未发送的草稿在切换会话后保留，换一个项目新建时也能一起带过去。<br/><img alt="搜索" src="docs/media/search.png" width="100%"> | **图片预览**<br/>会话里的图片 —— 工具输出、折叠摘要、消息里的链接和交付文件 —— 都在同一个原尺寸灯箱里打开。<br/><img alt="图片预览" src="docs/media/image-preview.png" width="100%"> |
+| **会话操作**<br/>就地重命名、分叉、归档、删除、复制 Session ID，以及在完整会话页里按活跃和已归档浏览全部会话。<br/><img alt="会话操作" src="docs/media/session-actions.png" width="100%"> | **皮肤**<br/>一套参照 Claude 应用的浅色和深色皮肤。皮肤是独立的一层：关掉它，所有功能照常工作，只是回到 DSH 原生观感。<br/><img alt="皮肤" src="docs/media/skin.png" width="100%"> |
+
+**还有**：设置页里每个功能一个开关（侧栏、分屏、会话 header、右栏、消息回退、图片预览，默认全开）· 后台任务按运行中和已完成分区 · 侧栏开关与前进/后退的窗口控件 · `mcp_tool_search` 让 MCP 工具在需要时才进入模型上下文 · 运行中的会话带扫光。
+
+## 设置
+
+每个功能都能在 **设置 → claude-code-mode** 里单独关掉。开关按用户看到的部分分组 —— 侧栏、分屏、会话 header、右栏、消息回退、图片预览 —— 一个开关可以覆盖几项相关行为。关掉之后，那部分界面交还给 DSH。皮肤选择器也在同一处，可以选 Claude 皮肤或 DSH 原生观感。
+
+## 安装
+
+**Web profile：**
+
+```bash
+dsh plugin --profile web add claude-code-mode@latest
+```
+
+**桌面端：**
+
+```bash
+dsh plugin --profile desktop add claude-code-mode@latest
+```
+
+先打开一次 DeepSeek Harness Desktop 让它初始化 profile，然后退出应用再执行。
+
+如果插件没有自动加载，重启 DSH，再刷新页面。
+
+需要 DSH **0.2.2-rc.1** 或更高版本，更低版本会在安装时被拒绝。
+
+<details>
+<summary><b>从源码安装</b></summary>
+
+```bash
+git clone https://github.com/little-thing/claude-code-mode.git
+cd claude-code-mode
+pnpm install && pnpm build
+dsh plugin --profile web add file:$PWD   # 或 --profile desktop
+```
+
+</details>
+
+## 兼容性
+
+| DSH 版本 | 状态 |
+|---|---|
+| `0.2.2-rc.1` 及更新 | 支持 |
+| `< 0.2.2-rc.1` | 安装时拒绝 |
+
+## 开发
+
+<details>
+<summary><b>构建与测试</b></summary>
+
+```bash
+pnpm install
+pnpm build
+node --test test/mcp-tool-search/*.test.mjs test/theme/*.test.mjs
+```
+
+</details>
+
+## License
+
+MIT。
+
+---
+
+<div align="center">
+  <sub>为 <a href="https://github.com/deepseek-ai/deepseek-harness">DeepSeek Harness</a> 生态而做 · <a href="https://github.com/little-thing/claude-code-mode">github.com/little-thing/claude-code-mode</a></sub>
+</div>

package/THIRD_PARTY_NOTICES.md

@@ -0,0 +1,30 @@
+# Third-party notices
+
+`lib/client.js` bundles the following packages at build time.
+
+## Floating UI
+
+- `@floating-ui/dom`
+- `@floating-ui/core`
+- `@floating-ui/utils`
+
+MIT License
+
+Copyright (c) 2021-present Floating UI 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/cordis.patch.yml

@@ -0,0 +1,27 @@
+# claude-code-mode bundle patch: mounts the host half and the client half.
+#
+# Optional config:
+#   skin:               skin id to mount (default: src/skins/<id>)
+#   mcpToolSearch:      MCP 工具按需加载（Claude ToolSearch 式）；默认关闭，下面显式打开
+#     enabled           true / false
+#     preload           永远可见的 MCP 工具名
+#     maxResults        单次搜索最多激活几个工具（1–20）
+#     maxActiveTools    0 = 不限制；非 0 时只限制新激活数量
+#     hint              是否写 system prompt 提示
+#
+# 功能开关（设置 → Claude Code）：偏好存在 $DSH_HOME/claude-code-mode/preferences.json，
+# 由宿主侧 preferences 路由读写、并注入首屏快照；默认全开，存「被关掉的集合」。
+# 桌面端用随机端口（--port 0），所以不用 localStorage：端口一变 origin 就变，开关会丢。
+#
+# 注意：模型路由必须支持中途 tool-addition，或不要声明 toolUpdate: addition-only。
+# 后者让 DSH 自动剥离 developer 消息，工具列表变更仍然生效；当前 MaaS 路由属于后者。
+- insert:
+    - id: claude-code-mode
+      name: 'claude-code-mode'
+      config:
+        skin: claude
+        mcpToolSearch:
+          enabled: true
+          preload: []
+          maxResults: 8
+          hint: true