dsh-just-chat 0.1.0

package/LICENSE

@@ -0,0 +1,201 @@
+Apache License
+                           Version 2.0, January 2004
+                        http://www.apache.org/licenses/
+
+   TERMS AND CONDITIONS FOR USE, REPRODUCTION, AND DISTRIBUTION
+
+   1. Definitions.
+
+      "License" shall mean the terms and conditions for use, reproduction,
+      and distribution as defined by Sections 1 through 9 of this document.
+
+      "Licensor" shall mean the copyright owner or entity authorized by
+      the copyright owner that is granting the License.
+
+      "Legal Entity" shall mean the union of the acting entity and all
+      other entities that control, are controlled by, or are under common
+      control with that entity. For the purposes of this definition,
+      "control" means (i) the power, direct or indirect, to cause the
+      direction or management of such entity, whether by contract or
+      otherwise, or (ii) ownership of fifty percent (50%) or more of the
+      outstanding shares, or (iii) beneficial ownership of such entity.
+
+      "You" (or "Your") shall mean an individual or Legal Entity
+      exercising permissions granted by this License.
+
+      "Source" form shall mean the preferred form for making modifications,
+      including but not limited to software source code, documentation
+      source, and configuration files.
+
+      "Object" form shall mean any form resulting from mechanical
+      transformation or translation of a Source form, including but
+      not limited to compiled object code, generated documentation,
+      and conversions to other media types.
+
+      "Work" shall mean the work of authorship, whether in Source or
+      Object form, made available under the License, as indicated by a
+      copyright notice that is included in or attached to the work
+      (an example is provided in the Appendix below).
+
+      "Derivative Works" shall mean any work, whether in Source or Object
+      form, that is based on (or derived from) the Work and for which the
+      editorial revisions, annotations, elaborations, or other modifications
+      represent, as a whole, an original work of authorship. For the purposes
+      of this License, Derivative Works shall not include works that remain
+      separable from, or merely link (or bind by name) to the interfaces of,
+      the Work and Derivative Works thereof.
+
+      "Contribution" shall mean any work of authorship, including
+      the original version of the Work and any modifications or additions
+      to that Work or Derivative Works thereof, that is intentionally
+      submitted to Licensor for inclusion in the Work by the copyright owner
+      or by an individual or Legal Entity authorized to submit on behalf of
+      the copyright owner. For the purposes of this definition, "submitted"
+      means any form of electronic, verbal, or written communication sent
+      to the Licensor or its representatives, including but not limited to
+      communication on electronic mailing lists, source code control systems,
+      and issue tracking systems that are managed by, or on behalf of, the
+      Licensor for the purpose of discussing and improving the Work, but
+      excluding communication that is conspicuously marked or otherwise
+      designated in writing by the copyright owner as "Not a Contribution."
+
+      "Contributor" shall mean Licensor and any individual or Legal Entity
+      on behalf of whom a Contribution has been received by Licensor and
+      subsequently incorporated within the Work.
+
+   2. Grant of Copyright License. Subject to the terms and conditions of
+      this License, each Contributor hereby grants to You a perpetual,
+      worldwide, non-exclusive, no-charge, royalty-free, irrevocable
+      copyright license to reproduce, prepare Derivative Works of,
+      publicly display, publicly perform, sublicense, and distribute the
+      Work and such Derivative Works in Source or Object form.
+
+   3. Grant of Patent License. Subject to the terms and conditions of
+      this License, each Contributor hereby grants to You a perpetual,
+      worldwide, non-exclusive, no-charge, royalty-free, irrevocable
+      (except as stated in this section) patent license to make, have made,
+      use, offer to sell, sell, import, and otherwise transfer the Work,
+      where such license applies only to those patent claims licensable
+      by such Contributor that are necessarily infringed by their
+      Contribution(s) alone or by combination of their Contribution(s)
+      with the Work to which such Contribution(s) was submitted. If You
+      institute patent litigation against any entity (including a
+      cross-claim or counterclaim in a lawsuit) alleging that the Work
+      or a Contribution incorporated within the Work constitutes direct
+      or contributory patent infringement, then any patent licenses
+      granted to You under this License for that Work shall terminate
+      as of the date such litigation is filed.
+
+   4. Redistribution. You may reproduce and distribute copies of the
+      Work or Derivative Works thereof in any medium, with or without
+      modifications, and in Source or Object form, provided that You
+      meet the following conditions:
+
+      (a) You must give any other recipients of the Work or
+          Derivative Works a copy of this License; and
+
+      (b) You must cause any modified files to carry prominent notices
+          stating that You changed the files; and
+
+      (c) You must retain, in the Source form of any Derivative Works
+          that You distribute, all copyright, patent, trademark, and
+          attribution notices from the Source form of the Work,
+          excluding those notices that do not pertain to any part of
+          the Derivative Works; and
+
+      (d) If the Work includes a "NOTICE" text file as part of its
+          distribution, then any Derivative Works that You distribute must
+          include a readable copy of the attribution notices contained
+          within such NOTICE file, excluding those notices that do not
+          pertain to any part of the Derivative Works, in at least one
+          of the following places: within a NOTICE text file distributed
+          as part of the Derivative Works; within the Source form or
+          documentation, if provided along with the Derivative Works; or,
+          within a display generated by the Derivative Works, if and
+          wherever such third-party notices normally appear. The contents
+          of the NOTICE file are for informational purposes only and
+          do not modify the License. You may add Your own attribution
+          notices within Derivative Works that You distribute, alongside
+          or as an addendum to the NOTICE text from the Work, provided
+          that such additional attribution notices cannot be construed
+          as modifying the License.
+
+      You may add Your own copyright statement to Your modifications and
+      may provide additional or different license terms and conditions
+      for use, reproduction, or distribution of Your modifications, or
+      for any such Derivative Works as a whole, provided Your use,
+      reproduction, and distribution of the Work otherwise complies with
+      the conditions stated in this License.
+
+   5. Submission of Contributions. Unless You explicitly state otherwise,
+      any Contribution intentionally submitted for inclusion in the Work
+      by You to the Licensor shall be under the terms and conditions of
+      this License, without any additional terms or conditions.
+      Notwithstanding the above, nothing herein shall supersede or modify
+      the terms of any separate license agreement you may have executed
+      with Licensor regarding such Contributions.
+
+   6. Trademarks. This License does not grant permission to use the trade
+      names, trademarks, service marks, or product names of the Licensor,
+      except as required for reasonable and customary use in describing the
+      origin of the Work and reproducing the content of the NOTICE file.
+
+   7. Disclaimer of Warranty. Unless required by applicable law or
+      agreed to in writing, Licensor provides the Work (and each
+      Contributor provides its Contributions) on an "AS IS" BASIS,
+      WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or
+      implied, including, without limitation, any warranties or conditions
+      of TITLE, NON-INFRINGEMENT, MERCHANTABILITY, or FITNESS FOR A
+      PARTICULAR PURPOSE. You are solely responsible for determining the
+      appropriateness of using or redistributing the Work and assume any
+      risks associated with Your exercise of permissions under this License.
+
+   8. Limitation of Liability. In no event and under no legal theory,
+      whether in tort (including negligence), contract, or otherwise,
+      unless required by applicable law (such as deliberate and grossly
+      negligent acts) or agreed to in writing, shall any Contributor be
+      liable to You for damages, including any direct, indirect, special,
+      incidental, or consequential damages of any character arising as a
+      result of this License or out of the use or inability to use the
+      Work (including but not limited to damages for loss of goodwill,
+      work stoppage, computer failure or malfunction, or any and all
+      other commercial damages or losses), even if such Contributor
+      has been advised of the possibility of such damages.
+
+   9. Accepting Warranty or Additional Liability. While redistributing
+      the Work or Derivative Works thereof, You may choose to offer,
+      and charge a fee for, acceptance of support, warranty, indemnity,
+      or other liability obligations and/or rights consistent with this
+      License. However, in accepting such obligations, You may act only
+      on Your own behalf and on Your sole responsibility, not on behalf
+      of any other Contributor, and only if You agree to indemnify,
+      defend, and hold each Contributor harmless for any liability
+      incurred by, or claims asserted against, such Contributor by reason
+      of your accepting any such warranty or additional liability.
+
+   END OF TERMS AND CONDITIONS
+
+   APPENDIX: How to apply the Apache License to your work.
+
+      To apply the Apache License to your work, attach the following
+      boilerplate notice, with the fields enclosed by brackets "[]"
+      replaced with your own identifying information. (Don't include
+      the brackets!)  The text should be enclosed in the appropriate
+      comment syntax for the file format. We also recommend that a
+      file or class name and description of purpose be included on the
+      same "printed page" as the copyright notice for easier
+      identification within third-party archives.
+
+   Copyright [yyyy] [name of copyright owner]
+
+   Licensed under the Apache License, Version 2.0 (the "License");
+   you may not use this file except in compliance with the License.
+   You may obtain a copy of the License at
+
+       http://www.apache.org/licenses/LICENSE-2.0
+
+   Unless required by applicable law or agreed to in writing, software
+   distributed under the License is distributed on an "AS IS" BASIS,
+   WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+   See the License for the specific language governing permissions and
+   limitations under the License.

package/README.md

@@ -0,0 +1,97 @@
+# 快速对话 · Just Chat
+
+[![npm version](https://img.shields.io/npm/v/dsh-just-chat?logo=npm)](https://www.npmjs.com/package/dsh-just-chat)
+[![CI](https://github.com/exoticknight/dsh-just-chat/actions/workflows/ci.yml/badge.svg)](https://github.com/exoticknight/dsh-just-chat/actions/workflows/ci.yml)
+[![License: Apache-2.0](https://img.shields.io/badge/license-Apache--2.0-blue)](https://github.com/exoticknight/dsh-just-chat/blob/main/LICENSE)
+![DSH compatibility: 0.1.5-rc.2](https://img.shields.io/badge/DSH-0.1.5--rc.2-blue)
+<a href="https://github.com/exoticknight/red"><img src="https://img.shields.io/badge/maintained_with-RED-C1121F" alt="Maintained with RED"></a>
+
+为 DeepSeek Harness 添加一键对话入口：点击即可进入独立工作目录中的原生会话，省去手动选择工作区。
+
+![首页标准模式旁和侧栏的快速对话入口](https://raw.githubusercontent.com/exoticknight/dsh-just-chat/main/docs/images/quick-chat.png)
+
+## 功能特点
+
+- **一键开始**：首页“标准模式”旁、侧栏各有一个入口，可分别开启或关闭。
+- **独立目录**：每次完成一次入口点击，都会新建独立工作区及对话。启动插件时不预建工作区。
+- **原生对话体验**：复用 DSH 的会话、模型、权限与附件流程；Workspace 和 Session ID 由 DSH 生成。
+- **自定义命名**：用占位符设置新工作区名称，编辑时预览，保存后生效。
+- **融入现有界面**：使用 DSH 原生图标和按钮，窄窗口自动换行；中文显示“快速对话”，英文显示“Just Chat”。
+
+## 快速开始
+
+### 安装插件
+
+适用于 DSH `0.1.5-rc.2` 的 Web 界面。先确认你的 DSH 已能正常对话，并且终端中可以使用 `dsh`。
+
+通过 DSH 插件管理命令从 npm 安装：
+
+```sh
+dsh plugin --profile web add dsh-just-chat
+```
+
+如果你使用自定义 `DSH_HOME` 或其他 profile，请选择与平时启动 DSH 相同的环境。安装后重启该 DSH 并刷新页面。
+
+### 开始对话
+
+1. 打开你平时使用的 DSH 页面。
+2. 点击首页“标准模式”旁或侧栏的 **快速对话**。
+3. 在打开的对话中输入消息并发送。
+
+插件会自动准备独立工作目录并打开原生对话，无需选择目录。模型与权限沿用 DSH 的配置。
+
+## 配置入口与命名
+
+打开 **设置 → 插件 → 插件配置 → 快速对话**。
+
+![快速对话配置卡片：入口开关、名称模板、预览和保存操作](https://raw.githubusercontent.com/exoticknight/dsh-just-chat/main/docs/images/settings.png)
+
+“标准模式旁入口”和“侧栏入口”控制两个按钮的显示位置。修改开关或模板后，卡片会标记“未保存”；点击“保存”统一应用，或点击“放弃更改”恢复已保存的值。配置集中在这张卡片中。
+
+### 工作区名称模板
+
+默认模板：
+
+```text
+{label} · {MM}-{DD} {HH}:{mm}
+```
+
+例如，中文界面创建的工作区显示为 `快速对话 · 09-14 18:01`；英文界面显示为 `Just Chat · 09-14 18:01`。
+
+| 占位符 | 含义 | 示例 |
+| --- | --- | --- |
+| `{label}` | 创建时的本地化名称 | 快速对话 / Just Chat |
+| `{YYYY}` | 四位年份 | 2026 |
+| `{MM}` / `{DD}` | 两位月份 / 日期 | 09 / 14 |
+| `{HH}` / `{mm}` / `{ss}` | 24 小时制的时 / 分 / 秒 | 18 / 01 / 05 |
+
+也可以写成 `灵感 {YYYY}-{MM}-{DD}` 或 `{label} {HH}:{mm}:{ss}`，普通文字会原样保留。
+
+- 时间取自浏览器本地时间，占位符区分大小写。
+- 模板最多 200 个字符；展开并去除首尾空白后的名称必须为 1–100 个字符。
+- 未知或不完整的占位符会显示错误并阻止保存。
+- “恢复默认模板”只修改草稿，还需点击“保存”。
+- 模板与语言变更只影响之后新建的工作区，不会重命名已有工作区，也不会改变磁盘目录。
+
+## 工作区与对话的关系
+
+每次通过快速对话入口创建的工作目录位于：
+
+```text
+<DSH_HOME>/just-chat/sessions/chat-<随机后缀>
+```
+
+`DSH_HOME` 是当前 DSH 的用户数据目录。显示名称与目录名分开管理；即使两个工作区显示名称相同，目录和原生 ID 仍然不同。
+
+| 操作 | 结果 |
+| --- | --- |
+| 点击快速对话入口 | 新建独立目录、工作区和原生对话 |
+| 在该工作区使用 DSH 原生“新建会话” | 仍使用该工作区的目录 |
+| 归档会话 | 隐藏会话，保留记录和目录，可恢复 |
+| 原生删除工作区 | 移除工作区登记，保留目录与会话记录，会话转入“未分组” |
+
+快速对话创建的会话和工作区使用 DSH 原生管理操作。删除工作区后，磁盘上的工作目录仍会保留；快速对话插件不会自动清理这些目录。
+
+## 开发与维护
+
+本地环境初始化、调试、测试和实现说明见[开发指南](https://github.com/exoticknight/dsh-just-chat/blob/main/docs/development.md)。

package/RED.md

@@ -0,0 +1,18 @@
+# RED 工作约定
+
+本项目使用 RED Protocol 1，把未解决的研究证据、进行中的工程变更和已接受的项目知识分开管理。
+
+## 当前映射
+
+- Document：`README.md` 与 `docs/**`。README 面向使用者说明安装、功能、配置与生命周期；`docs/development.md` 面向开发者说明初始化、调试、测试与实现结构；`docs/images/` 保存配图。
+- Research：`.research/**`。这里保留既有纯净 DSH 调研、运行时证据和交接材料，不迁移旧文件，也不把其中的历史工作记录当作规范要求。
+- Evolve：`.evolve/**`。这里记录当前 Just Chat 插件的实施范围、验收证据、未决替代方案和后续工作。
+
+项目使用 Git。Research 和 Evolve 由 `.gitignore` 排除，仅作为本地工作记录保存；Document 和配置纳入版本管理。
+
+## 维护规则
+
+- 新 Research / Evolve 文件使用 UTF-8 Markdown 和 RED TOML front matter。
+- Document 只写已接受、可供使用者和后续 agent 直接依赖的知识；验证日志、历史过程和开放问题留在 Research / Evolve。
+- Evolve 的验收证据提交评审后，获得单独接受前不更新 Document。
+- DSH 宿主和宿主 UI 的边界以实现证据为准；如规范文档与代码、配置或运行时结果冲突，先记录为 Research 冲突。

package/client.js

@@ -0,0 +1,425 @@
+window.__ModuleLoader__.load({
+  id: 'dsh-just-chat',
+  factory: (require) => {
+    const React = require('react')
+    const { createPortal } = require('react-dom')
+    const { Button, Tag, IconChevronDownOutline14, IconNewChatOutline16 } = require('@deepseek-ai/dsh-client-ui-primitives')
+    const module = { exports: {} }
+    const exports = module.exports
+
+    let runtimeCtx
+    let entrySettings
+    let sidebarRegistration
+    let sidebarInjectionLive = false
+    let openingChat
+    let pendingPath
+
+    const localeNamespace = 'dsh-just-chat'
+    const settingsNamespace = 'dsh-just-chat'
+    const defaultNameTemplate = '{label} · {MM}-{DD} {HH}:{mm}'
+    const defaultSettings = Object.freeze({ hero: true, sidebar: true, workspaceNameTemplate: defaultNameTemplate })
+    const fallbackSettingsSnapshot = Object.freeze({
+      status: 'loading',
+      value: defaultSettings,
+      writable: false,
+    })
+
+    const localeDictionaries = {
+      zh: {
+        entry: '快速对话',
+        opening: '打开中…',
+        'panel.loaded': '正在打开快速对话…',
+        'panel.failed': '打开失败：{error}',
+        'panel.retry': '重试',
+        'settings.description': '配置快速对话入口和新工作区的命名规则',
+        'settings.hero': '标准模式旁入口',
+        'settings.sidebar': '侧栏入口',
+        'settings.template': '工作区名称模板',
+        'settings.help': '可用占位符：{label} 本地化名称、{YYYY} 年、{MM} 月、{DD} 日、{HH} 时、{mm} 分、{ss} 秒。使用本地时间，仅影响新建工作区。',
+        'settings.preview': '预览',
+        'settings.save': '保存',
+        'settings.reset': '恢复默认模板',
+        'settings.invalid': '请使用已列出的占位符，且展开后的名称须为 1–100 个字符。',
+        'settings.discard': '放弃更改',
+        'settings.unsaved': '未保存',
+        'settings.saving': '保存中…',
+        'settings.expand': '展开设置',
+        'settings.collapse': '收起设置',
+        'settings.readOnly': '当前设置只读。',
+      },
+      en: {
+        entry: 'Just Chat',
+        opening: 'Opening…',
+        'panel.loaded': 'Opening Just Chat…',
+        'panel.failed': 'Could not open Just Chat: {error}',
+        'panel.retry': 'Retry',
+        'settings.description': 'Configure entry points and names for new workspaces',
+        'settings.hero': 'Beside Standard mode',
+        'settings.sidebar': 'In the sidebar',
+        'settings.template': 'Workspace name template',
+        'settings.help': 'Placeholders: {label} localized name, {YYYY} year, {MM} month, {DD} day, {HH} hour, {mm} minute, {ss} second. Uses local time; affects new workspaces only.',
+        'settings.preview': 'Preview',
+        'settings.save': 'Save',
+        'settings.reset': 'Restore default template',
+        'settings.invalid': 'Use the listed placeholders and a resulting name of 1–100 characters.',
+        'settings.discard': 'Discard changes',
+        'settings.unsaved': 'Unsaved',
+        'settings.saving': 'Saving…',
+        'settings.expand': 'Show settings',
+        'settings.collapse': 'Hide settings',
+        'settings.readOnly': 'These settings are read-only.',
+      },
+    }
+
+    function PanelIcon({ size = 16 }) {
+      return React.createElement(IconNewChatOutline16, { size })
+    }
+
+    // Deliberately a small literal-token formatter, not an executable template language.
+    function formatWorkspaceName(template, label, now = new Date()) {
+      const pad = (value) => String(value).padStart(2, '0')
+      const values = { label, YYYY: String(now.getFullYear()), MM: pad(now.getMonth() + 1),
+        DD: pad(now.getDate()), HH: pad(now.getHours()), mm: pad(now.getMinutes()), ss: pad(now.getSeconds()) }
+      if (typeof template !== 'string' || template.length > 200) throw new Error('Invalid template')
+      const title = template.replace(/\{([^{}]*)\}/g, (token, key) => {
+        if (!Object.hasOwn(values, key)) throw new Error('Unknown placeholder')
+        return values[key]
+      }).trim()
+      if (/[{}]/.test(title) || !title || title.length > 100) throw new Error('Invalid workspace name')
+      return title
+    }
+
+    function useJustChatT() {
+      const locale = runtimeCtx.get('locale')
+      const subscribe = React.useCallback((listener) => locale.subscribe(listener), [locale])
+      const getRevision = React.useCallback(() => locale.getSnapshot().revision, [locale])
+      React.useSyncExternalStore(subscribe, getRevision, getRevision)
+      return locale.bind(localeNamespace)
+    }
+
+    function useEntrySettings() {
+      const scope = entrySettings
+      const subscribe = React.useCallback(
+        (listener) => scope?.subscribe(listener) ?? (() => {}),
+        [scope],
+      )
+      const getSnapshot = React.useCallback(
+        () => scope?.getSnapshot?.() ?? fallbackSettingsSnapshot,
+        [scope],
+      )
+      return React.useSyncExternalStore(subscribe, getSnapshot, getSnapshot)
+    }
+
+    function settingEnabled(snapshot, key) {
+      return snapshot?.value?.[key] !== false
+    }
+
+    function openJustChat() {
+      if (openingChat) return openingChat
+      openingChat = (async () => {
+        if (!pendingPath) {
+          let title
+          const t = runtimeCtx.get('locale').bind(localeNamespace)
+          try {
+            title = formatWorkspaceName(entrySettings.getSnapshot()?.value?.workspaceNameTemplate ?? defaultNameTemplate, t('entry'))
+          } catch {
+            throw new Error(t('settings.invalid'))
+          }
+          const response = await fetch('/api/just-chat/prepare', {
+            method: 'POST',
+            headers: { 'Content-Type': 'application/json' },
+            body: JSON.stringify({ title }),
+          })
+          if (!response.ok) throw new Error(await response.text())
+          const result = await response.json()
+          pendingPath = result.path
+        }
+        // Native create adopts the registered path and synchronizes Client state.
+        // Keep it for retry if opening fails; both native operations are idempotent.
+        const workspace = await runtimeCtx.get('workspaces').create({ path: pendingPath })
+        await runtimeCtx.get('uiWorkspace').openWorkspace(workspace.workspaceId)
+        pendingPath = undefined
+      })().finally(() => { openingChat = undefined })
+      return openingChat
+    }
+
+    function useHeroMount() {
+      const [mount, setMount] = React.useState(null)
+      React.useEffect(() => {
+        const node = document.createElement('span')
+        node.dataset.justChatMount = 'true'
+        const style = document.createElement('style')
+        style.textContent = 'div:has(> [data-just-chat-mount]) { flex-wrap: wrap; row-gap: 4px; }'
+        document.head.appendChild(style)
+        Object.assign(node.style, { display: 'inline-flex', minWidth: '0', flexShrink: '0', marginLeft: '6px' })
+        const sync = () => {
+          const slot = document.querySelector('[data-slot="conversation.hero.agentPreset"]')
+          if (!slot) {
+            node.remove()
+            setMount(null)
+          } else {
+            // Join the existing flex row, so long workspace labels reserve space for the action.
+            if (node.previousSibling !== slot) slot.after(node)
+            setMount(node)
+          }
+        }
+        const observer = new MutationObserver(sync)
+        observer.observe(document.getElementById('root') ?? document.body, { childList: true, subtree: true })
+        sync()
+        return () => { observer.disconnect(); node.remove(); style.remove() }
+      }, [])
+      return mount
+    }
+
+    function JustChatOverlay() {
+      const t = useJustChatT()
+      const settings = useEntrySettings()
+      const mount = useHeroMount()
+      const [busy, setBusy] = React.useState(false)
+      const [error, setError] = React.useState(null)
+      if (!mount || !settingEnabled(settings, 'hero')) return null
+      const openChat = async () => {
+        if (busy) return
+        setBusy(true)
+        setError(null)
+        try { await openJustChat() } catch (error) { setError(error.message) }
+        finally { setBusy(false) }
+      }
+      return createPortal(React.createElement('span', { style: { position: 'relative' } },
+        React.createElement(Button, {
+          variant: 'ghost', size: 'sm', onClick: openChat, disabled: busy,
+          'aria-label': busy ? t('opening') : t('entry'), title: t('entry'),
+          style: { borderRadius: 16, height: 28, padding: '0 8px', gap: 4, whiteSpace: 'nowrap' },
+        }, React.createElement(IconNewChatOutline16, { size: 14 }), busy ? t('opening') : t('entry')),
+        error && React.createElement('span', { role: 'alert', style: {
+          position: 'absolute', top: '100%', right: 0, width: 280, zIndex: 10,
+          padding: 8, background: 'var(--dsw-alias-bg-layer-3)', color: 'var(--dsw-alias-label-error)',
+        } }, error),
+      ), mount)
+    }
+
+    function ChatPanel() {
+      const t = useJustChatT()
+      const [attempt, setAttempt] = React.useState(0)
+      const [message, setMessage] = React.useState({ key: 'panel.loaded' })
+
+      React.useEffect(() => {
+        let active = true
+        setMessage({ key: 'panel.loaded' })
+        void openJustChat().catch((error) => {
+          if (active) {
+            setMessage({
+              key: 'panel.failed',
+              params: { error: error?.message ?? JSON.stringify(error) },
+            })
+          }
+        })
+        return () => {
+          active = false
+        }
+      }, [attempt])
+
+      return React.createElement(
+        'section',
+        { style: { fontFamily: 'sans-serif', padding: '24px' } },
+        React.createElement('h1', null, t('entry')),
+        React.createElement('p', null, t(message.key, message.params)),
+        message.key === 'panel.failed'
+          ? React.createElement(
+            Button,
+            { variant: 'outline', size: 'sm', onClick: () => setAttempt((value) => value + 1), type: 'button' },
+            t('panel.retry'),
+          )
+          : null,
+      )
+    }
+
+    // The host's PluginCard is private. Match its layout with owned, scoped styles.
+    const settingsCss = `
+      .jc-card{border:.5px solid var(--dsw-alias-border-l4);background:var(--dsw-alias-bg-layer-3);border-radius:16px;list-style:none;transition:border-color .16s,background .16s}
+      .jc-card:hover{border-color:var(--dsw-alias-label-dimmed)}
+      .jc-card[data-open=true]{background:var(--dsw-alias-bg-layer-2);border-color:var(--dsw-alias-label-dimmed)}
+      .jc-card-header{appearance:none;width:100%;font:inherit;color:inherit;text-align:left;cursor:pointer;background:transparent;border:0;border-radius:12px;display:flex;align-items:center;gap:12px;padding:14px 16px}
+      .jc-card-header:focus-visible{outline:2px solid var(--dsw-alias-brand-primary);outline-offset:-2px}
+      .jc-card-heading{display:flex;flex:1;flex-direction:column;gap:4px;min-width:0}
+      .jc-card-name{color:var(--dsw-alias-label-primary);font-size:15px;font-weight:600;line-height:1.4}
+      .jc-card-description{color:var(--dsw-alias-label-tertiary);font-size:13px;line-height:1.5}
+      .jc-card-chevron{color:var(--dsw-alias-label-tertiary);flex:none;transition:transform .16s}
+      .jc-card[data-open=true] .jc-card-chevron{transform:rotate(180deg)}
+      .jc-card-body{border-top:.5px solid var(--dsw-alias-border-l2);margin:0 16px;padding-bottom:8px}
+      .jc-field{display:flex;flex-direction:column;gap:6px;padding:12px 0}
+      .jc-field+.jc-field{border-top:.5px solid var(--dsw-alias-border-l2)}
+      .jc-field-head{display:flex;align-items:center;gap:8px}
+      .jc-field-label{flex:1;min-width:0;color:var(--dsw-alias-label-primary);font-size:13px;font-weight:500;line-height:1.5}
+      .jc-field-toggle{accent-color:var(--dsw-alias-brand-primary);width:16px;height:16px;cursor:pointer}
+      .jc-field-input{box-sizing:border-box;width:100%;height:34px;border:.5px solid var(--dsw-alias-border-l4);background:var(--dsw-alias-bg-layer-3);font:inherit;color:var(--dsw-alias-label-primary);border-radius:8px;padding:0 12px;font-size:13px;line-height:1.5}
+      .jc-field-input:focus-visible{outline:2px solid var(--dsw-alias-brand-primary);outline-offset:1px}
+      .jc-field-input[aria-invalid=true]{border-color:var(--dsw-alias-label-error)}
+      .jc-field-hint{margin:0;color:var(--dsw-alias-label-tertiary);font-size:12px;line-height:1.5;overflow-wrap:anywhere}
+      .jc-field-reset{background:none;border:0;padding:0;font:inherit;font-size:12px;color:var(--dsw-alias-label-secondary);cursor:pointer}
+      .jc-card-footer{display:flex;justify-content:flex-end;align-items:center;flex-wrap:wrap;gap:8px;border-top:.5px solid var(--dsw-alias-border-l2);padding:12px 0 4px}
+      .jc-card-error{color:var(--dsw-alias-label-error);font-size:12px;line-height:1.5;overflow-wrap:anywhere}
+    `
+
+    function PluginSettingsCard() {
+      const t = useJustChatT()
+      const snapshot = useEntrySettings()
+      const current = { ...defaultSettings, ...(snapshot.value ?? {}) }
+      const [open, setOpen] = React.useState(false)
+      const [editor, setEditor] = React.useState(null)
+      const [saving, setSaving] = React.useState(false)
+      const [error, setError] = React.useState(null)
+      const draft = editor?.value ?? current
+      const dirty = Object.keys(defaultSettings).some((key) => draft[key] !== current[key])
+      const disabled = saving || snapshot.writable === false
+      let preview
+      try { preview = formatWorkspaceName(draft.workspaceNameTemplate, t('entry')) } catch {}
+      const edit = (key, value) => {
+        setEditor((previous) => ({ revision: previous?.revision ?? snapshot.revision,
+          value: { ...(previous?.value ?? current), [key]: value } }))
+        setError(null)
+      }
+      const save = async () => {
+        if (!dirty || !preview || disabled) return
+        setSaving(true); setError(null)
+        try {
+          const ops = Object.keys(defaultSettings).filter((key) => draft[key] !== current[key])
+            .map((key) => ({ op: 'set', path: [key], value: draft[key] }))
+          await entrySettings.mutate(ops, editor?.revision)
+          setEditor(null); setOpen(false)
+        } catch (error) { setError(error.message) }
+        finally { setSaving(false) }
+      }
+      if (snapshot.status === 'unavailable') return null
+      return React.createElement('li', { className: 'jc-card', 'data-open': open },
+        React.createElement('button', {
+          className: 'jc-card-header', type: 'button', 'aria-expanded': open,
+          'aria-controls': 'just-chat-settings-body',
+          'aria-label': t(open ? 'settings.collapse' : 'settings.expand') + ': ' + t('entry'),
+          onClick: () => setOpen(!open),
+        },
+          React.createElement('span', { className: 'jc-card-heading' },
+            React.createElement('span', { className: 'jc-card-name' }, t('entry')),
+            React.createElement('span', { className: 'jc-card-description' }, t('settings.description'))),
+          dirty && React.createElement(Tag, { tone: 'neutral' }, t('settings.unsaved')),
+          React.createElement(IconChevronDownOutline14, { className: 'jc-card-chevron' })),
+        open && React.createElement('div', { className: 'jc-card-body', id: 'just-chat-settings-body' },
+          snapshot.writable === false && React.createElement('p', { className: 'jc-field-hint', role: 'status' }, t('settings.readOnly')),
+          ['hero', 'sidebar'].map((key) => React.createElement('div', { key, className: 'jc-field' },
+            React.createElement('label', { className: 'jc-field-head' },
+              React.createElement('span', { className: 'jc-field-label' }, t('settings.' + key)),
+              React.createElement('input', { className: 'jc-field-toggle', type: 'checkbox',
+                checked: draft[key], disabled, 'aria-label': t('settings.' + key),
+                onChange: (event) => edit(key, event.target.checked) })))),
+          React.createElement('div', { className: 'jc-field' },
+            React.createElement('div', { className: 'jc-field-head' },
+              React.createElement('label', { className: 'jc-field-label', htmlFor: 'just-chat-name-template' }, t('settings.template')),
+              React.createElement('button', { className: 'jc-field-reset', type: 'button', disabled,
+                onClick: () => edit('workspaceNameTemplate', defaultNameTemplate) }, t('settings.reset'))),
+            React.createElement('input', { className: 'jc-field-input', id: 'just-chat-name-template',
+              value: draft.workspaceNameTemplate, maxLength: 200, disabled, 'aria-invalid': !preview,
+              'aria-describedby': 'just-chat-template-help just-chat-template-preview',
+              onChange: (event) => edit('workspaceNameTemplate', event.target.value) }),
+            React.createElement('p', { id: 'just-chat-template-help', className: 'jc-field-hint' }, t('settings.help')),
+            React.createElement('p', { id: 'just-chat-template-preview', role: preview ? 'status' : 'alert',
+              className: preview ? 'jc-field-hint' : 'jc-card-error' },
+              preview ? t('settings.preview') + ': ' + preview : t('settings.invalid'))),
+          error && React.createElement('p', { role: 'alert', className: 'jc-card-error' }, error),
+          React.createElement('div', { className: 'jc-card-footer' },
+            React.createElement(Button, { variant: 'outline', size: 'sm', disabled: !dirty || saving,
+              onClick: () => { setEditor(null); setError(null) } }, t('settings.discard')),
+            React.createElement(Button, { size: 'sm', disabled: disabled || !dirty || !preview,
+              onClick: save }, t(saving ? 'settings.saving' : 'settings.save'))),
+        ))
+    }
+
+    const inject = [
+      'slots',
+      'sessions',
+      'workspaces',
+      'uiWorkspace',
+      'layout',
+      'locale',
+      'settingsScope',
+    ]
+
+    function apply(ctx) {
+      runtimeCtx = ctx
+      ctx.effect(() => {
+        const style = document.createElement('style')
+        style.dataset.pluginCss = 'dsh-just-chat/settings'
+        style.textContent = settingsCss
+        document.head.appendChild(style)
+        return () => style.remove()
+      }, 'dsh-just-chat: settings styles')
+      const locale = ctx.get('locale')
+      entrySettings = ctx.settingsScope.bind({ namespace: settingsNamespace })
+
+      ctx.effect(
+        () => locale.register(localeNamespace, localeDictionaries),
+        'dsh-just-chat: dictionaries',
+      )
+
+      let sidebarEnabled = settingEnabled(entrySettings.getSnapshot(), 'sidebar')
+      const registerSidebarEntry = () => ctx.slots.register(
+        {
+          name: 'sidebar.panellist',
+          id: 'dsh-just-chat',
+          order: 10,
+          label: () => locale.bind(localeNamespace)('entry'),
+        },
+        PanelIcon,
+      )
+
+      ctx.slots.inject('sidebar.panellist', () => {
+        sidebarInjectionLive = true
+        sidebarRegistration = sidebarEnabled ? registerSidebarEntry() : undefined
+        return () => {
+          sidebarRegistration?.()
+          sidebarRegistration = undefined
+          sidebarInjectionLive = false
+        }
+      })
+
+      ctx.effect(() => {
+        const syncSidebar = () => {
+          const next = settingEnabled(entrySettings.getSnapshot(), 'sidebar')
+          if (next === sidebarEnabled) return
+          sidebarEnabled = next
+          if (!sidebarInjectionLive) return
+          sidebarRegistration?.()
+          sidebarRegistration = sidebarEnabled ? registerSidebarEntry() : undefined
+        }
+        const stop = entrySettings.subscribe(syncSidebar)
+        syncSidebar()
+        return stop
+      }, 'dsh-just-chat: sidebar entry setting')
+
+      ctx.slots.inject('shell.overlay', () => ctx.slots.register(
+        {
+          name: 'shell.overlay',
+          id: 'dsh-just-chat-hero',
+          order: 100,
+        },
+        JustChatOverlay,
+      ))
+
+      ctx.slots.inject('main', () => ctx.slots.register(
+        { name: 'main', key: 'dsh-just-chat' },
+        ChatPanel,
+      ))
+
+      ctx.slots.inject('settings.plugin.item', () => ctx.slots.register(
+        { name: 'settings.plugin.item', key: settingsNamespace, locale: localeNamespace },
+        PluginSettingsCard,
+      ))
+
+
+    }
+
+    exports.formatWorkspaceName = formatWorkspaceName
+    exports.apply = apply
+    exports.inject = inject
+    return module.exports
+  },
+})

package/cordis.patch.yml

@@ -0,0 +1,3 @@
+- insert:
+    - id: dsh-just-chat
+      name: dsh-just-chat

package/docs/development.md

@@ -0,0 +1,124 @@
+# 开发指南
+
+本页面向修改和调试插件的开发者。插件安装、功能与配置见 [README](../README.md)。
+
+## 准备环境
+
+开发脚本面向 Windows，要求系统已安装 Node.js（`^22.19.0 || >=24.0.0`）、npm、pnpm，并可使用 PowerShell。
+
+从 GitHub 克隆或下载源码后，在仓库根目录运行：
+
+```powershell
+npm run dev
+```
+
+脚本会依次：
+
+1. 使用系统 pnpm 按锁文件安装依赖，包括项目内的 DSH `0.1.5-rc.2`。
+2. 创建或复用仓库中的 `.dsh-dev`，作为调试用 `DSH_HOME`。
+3. 将当前插件安装到该 Home 的 `web` profile，同时安装调试伴随插件 `@michengai/dsh-archive-manager@0.1.41`。
+4. 使用项目内的 DSH 启动服务，在终端输出带登录 token 的本地访问链接。
+
+打开终端链接，在 DSH 模型设置中配置凭据，即可点击“快速对话”调试。端口由系统分配，每次启动可能不同；不要公开带 token 的链接。结束调试时在启动终端按 `Ctrl+C`。
+
+仅初始化、不启动服务：
+
+```powershell
+npm run setup
+```
+
+重复运行会保留 `.dsh-dev` 中的对话、设置与凭据。脚本不依赖全局 DSH，不复制其他 Home 的凭据；Node/pnpm 使用系统原生环境，不重定位缓存。修改插件后先停止当前调试服务，再运行 `npm run dev`，打开新输出的链接。
+
+### 安装本地源码到已有 DSH
+
+若需要在指定的已有 DSH 环境中验证源码，在仓库根目录运行：
+
+```powershell
+pnpm install --frozen-lockfile
+dsh plugin --profile web add .
+```
+
+确认 `DSH_HOME` 和 profile 与目标环境一致，安装后重启目标 DSH 并刷新页面。本地安装引用当前目录，请保留该目录。日常开发优先使用上面的隔离调试环境。
+
+## 业务验证
+
+```powershell
+npm test
+```
+
+自动测试覆盖入口调用和命名规则。运行环境中还应检查：
+
+- 从没有工作区的状态点击入口，能够进入对话并收到真实模型回复。
+- 两个入口连续新建时使用不同目录；原生“新建会话”仍使用所在工作区的目录。
+- 归档会话、删除工作区后，再次点击入口仍可对话；刷新后记录正常保留。
+- 两个入口开关、模板预览与校验、保存/放弃、语言切换，以及刷新和重启后的配置保留。
+- 窄窗口布局、附件、取消响应和断线恢复。
+
+模型凭据与原生目录选择器由人工操作。清理测试数据前确认目标，保留非测试会话和文件。
+
+### 归档管理伴随插件
+
+开发初始化额外安装的归档管理插件在 **设置 → 归档会话** 中提供恢复和永久删除功能，用于验证快速对话与原生会话管理的兼容性。它不是快速对话插件的依赖。
+
+**永久删除会话不可恢复**，但会保留工作目录。原生删除工作区也不删除磁盘目录；详细生命周期见 [README](../README.md#工作区与对话的关系)。
+
+## 实现结构
+
+仓库根目录就是可安装的插件 package root，无需单独构建。
+
+| 文件 | 职责 |
+| --- | --- |
+| `index.js` | 注册设置、准备目录、调用原生 Workspace 服务 |
+| `client.js` | 入口、原生 UI 组件、配置卡片和命名模板 |
+| `cordis.patch.yml` | DSH bundle 的 Host 激活配置 |
+| `scripts/install-dsh-dev.ps1` | 安装项目内 DSH 与调试插件 |
+| `scripts/start-dsh-dev.ps1` | 初始化并启动隔离的调试环境 |
+| `tests/` | 入口调用与命名规则测试 |
+
+所有功能在插件中实现，不修改 DSH 宿主源码。首页入口使用 `conversation.hero.agentPreset` 的 DOM 锚点，侧栏和配置卡片使用官方插槽；升级 DSH 时需重新验证入口挂载和布局。
+
+调试时生成的工作目录位于 `.dsh-dev/just-chat/sessions/`。Workspace 和 Session ID、归档和工作区删除均由 DSH 管理。
+
+## 打包与版本控制
+
+```powershell
+npm pack --dry-run
+```
+
+检查发布清单包含插件运行文件、README、开发指南和配图，不含调试 Home。提交源码、锁文件和文档；`.gitignore` 排除调试 Home、依赖、临时输出及本地研究记录。不要提交 `.dsh-dev` 中的凭据与对话数据。
+
+### GitHub 与 npm 发布准备
+
+仓库提供以下自动化：
+
+- `ci.yml`：main 推送和 PR 触发，在 Windows/Linux、Node 22.19/24 上按锁文件安装依赖，检查 JavaScript 语法、运行现有测试并预检发布包。
+- `release.yml`：推送 `v*` tag 后先运行同一套 CI；tag 必须等于 `v` 加 package.json 的版本号。通过后发布 npm，随后创建带自动发布说明的 GitHub Release。含预发布后缀的版本使用 npm `next` 和 GitHub prerelease，其余使用 `latest`。
+- Dependabot：每周检查 GitHub Actions 更新并创建更新 PR。
+
+CI 不启动模型服务，真实对话和界面流程仍按上面的业务验证执行。
+
+首次启用发布：
+
+1. 将源码推送到实际 GitHub 仓库，完成下面的发布准备项。发布工作流会检查 repository.url 与当前仓库一致，并要求设置许可证。
+2. 在 GitHub 创建 `npm` environment，限制仅发布 tag 可部署；按团队需要配置审批，并保护 main 和 `v*` tag。
+3. 在 npm 包设置中添加 GitHub Actions Trusted Publisher，填写实际 owner/repository、工作流文件名 `release.yml`、environment `npm`，允许直接 `npm publish`。见 [npm Trusted Publishing 配置说明](https://docs.npmjs.com/trusted-publishers/)。如果新包尚不能配置 Trusted Publisher，先由维护者登录 npm 手动完成首次发布，再绑定后续自动发布。
+4. 工作流使用 Node 24 和 OIDC，不需保存 NPM_TOKEN。npm CLI 需至少 11.5.1。
+
+发布一个新版本（以下以 0.1.1 为例，工作区应先保持干净）：
+
+```sh
+npm version 0.1.1
+git push origin main
+git push origin v0.1.1
+```
+
+`npm version` 会更新版本、提交并创建 tag；首次手动发布过的版本不要再次触发 npm 发布。npm 版本不可覆盖。若 npm 成功但 GitHub Release 失败，使用 Actions 的 **Re-run failed jobs**，只重试后续 Release job；不要重跑已经成功的 npm 发布 job。
+
+GitHub 提供源码和开发文档，npm 提供可安装的 `dsh-just-chat` 插件包。发布前：
+
+- 确认 npm 包名可用、版本号和发布权限，以及项目许可证。
+- 在 `package.json` 中补齐实际 GitHub 地址对应的 `repository`、`homepage` 和 `bugs`。
+- 将 README 配图和开发指南链接改为该 GitHub 仓库的绝对链接，并检查 GitHub 与 npm 页面都能正常展示；仅把图片打入 npm 包不能保证 npm 页面解析相对图片地址。
+- 检查发布清单和业务流程，发布后在独立 DSH Home 中验证 README 的 npm 安装命令。
+- 首次 npm 发布可用后，移除 README 中“发布后可用”的提示。
+- npm 版本 badge 从注册表读取已发布版本，首次发布前可能显示无法获取；RED badge 使用 RED 项目提供的样式并链接到其 GitHub 仓库。

package/index.js

@@ -0,0 +1,50 @@
+import z from '@deepseek-ai/schemastery'
+import { mkdir, mkdtemp, rmdir } from 'node:fs/promises'
+import { join } from 'node:path'
+import { dshHomePath } from '@deepseek-ai/dsh-home-paths'
+
+export const name = 'dsh-just-chat'
+
+const SETTINGS_NAMESPACE = 'dsh-just-chat'
+const SettingsSchema = z.object({
+  hero: z.boolean().default(true),
+  sidebar: z.boolean().default(true),
+  workspaceNameTemplate: z.string().min(1).max(200).default('{label} · {MM}-{DD} {HH}:{mm}'),
+})
+
+export function apply(ctx) {
+  ctx.inject(['settings'], (pluginCtx) => {
+    pluginCtx.settings.register(SETTINGS_NAMESPACE, SettingsSchema)
+  })
+  ctx.inject(['connection', 'workspaceRegistry'], (pluginCtx) => {
+    // The shared API channel owns authentication, origin checks, and route lifetime.
+    pluginCtx.connection.fetch.register({
+      path: '/api/just-chat/prepare',
+      methods: ['POST'],
+      requestBody: 'buffered',
+      async fetch(request) {
+        let path
+        try {
+          request.signal.throwIfAborted()
+          const { title } = await request.json()
+          if (typeof title !== 'string' || !title.trim() || title.length > 100) {
+            return Response.json({ error: 'Invalid workspace title' }, { status: 400 })
+          }
+          const root = dshHomePath('just-chat', 'sessions')
+          await mkdir(root, { recursive: true })
+          path = await mkdtemp(join(root, 'chat-'))
+          request.signal.throwIfAborted()
+          // Only the folder name is ours; DSH generates Workspace and Session IDs.
+          await pluginCtx.workspaceRegistry.create(path, title)
+          return Response.json({ path })
+        } catch (error) {
+          // Undo only an empty directory that never acquired a Workspace.
+          if (path && !pluginCtx.workspaceRegistry.list().some((workspace) => workspace.path === path)) {
+            await rmdir(path).catch(() => {})
+          }
+          return Response.json({ error: error.message }, { status: 500 })
+        }
+      },
+    })
+  })
+}

package/package.json

@@ -0,0 +1,72 @@
+{
+  "name": "dsh-just-chat",
+  "description": "One-click native conversations with independent workspaces for DeepSeek Harness",
+  "homepage": "https://github.com/exoticknight/dsh-just-chat#readme",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/exoticknight/dsh-just-chat.git"
+  },
+  "bugs": {
+    "url": "https://github.com/exoticknight/dsh-just-chat/issues"
+  },
+  "keywords": ["dsh", "deepseek-harness", "dsh-plugin", "chat", "workspace"],
+  "engines": {
+    "node": "^22.19.0 || >=24.0.0"
+  },
+  "publishConfig": {
+    "access": "public",
+    "registry": "https://registry.npmjs.org/"
+  },
+  "version": "0.1.0",
+  "license": "Apache-2.0",
+  "author": "exoticknight",
+  "type": "module",
+  "main": "./index.js",
+  "exports": {
+    ".": "./index.js",
+    "./client": "./client.js",
+    "./cordis.patch.yml": "./cordis.patch.yml",
+    "./package.json": "./package.json"
+  },
+  "files": [
+    "index.js",
+    "client.js",
+    "cordis.patch.yml",
+    "README.md",
+    "RED.md",
+    "docs/images",
+    "docs/development.md"
+  ],
+  "scripts": {
+    "setup": "powershell -NoProfile -ExecutionPolicy Bypass -File .\\scripts\\install-dsh-dev.ps1",
+    "test": "node --test \"tests/*.test.js\"",
+    "dev": "powershell -NoProfile -ExecutionPolicy Bypass -File .\\scripts\\start-dsh-dev.ps1",
+    "dev:install": "powershell -NoProfile -ExecutionPolicy Bypass -File .\\scripts\\install-dsh-dev.ps1"
+  },
+  "dsh": {
+    "bundle": {
+      "patch": "./cordis.patch.yml"
+    },
+    "client": {
+      "platform": "web",
+      "inject": [
+        "@deepseek-ai/dsh-api-session-controller",
+        "@deepseek-ai/dsh-api-workspace-controller",
+        "@deepseek-ai/dsh-client-locale",
+        "@deepseek-ai/dsh-client-ui-layout",
+        "@deepseek-ai/dsh-client-ui-renderer",
+        "@deepseek-ai/dsh-client-ui-sidebar",
+        "@deepseek-ai/dsh-client-ui-settings",
+        "@deepseek-ai/dsh-client-ui-settings-plugins",
+        "@deepseek-ai/dsh-client-ui-workspace"
+      ]
+    }
+  },
+  "dependencies": {
+    "@deepseek-ai/dsh-home-paths": "0.1.5-rc.2",
+    "@deepseek-ai/schemastery": "^3.18.2"
+  },
+  "devDependencies": {
+    "@deepseek-ai/dsh": "0.1.5-rc.2"
+  }
+}