dsh-atelier-plugin

dsh plugin --profile web add dsh-atelier-plugin

<div align="center">

<img src="./icon.svg" alt="DSH Atelier icon" width="88" height="88" />

<h1>DSH Atelier · 工作台</h1>

<p>让模型工作过程可读，让用量与成本可查，让提示词配置可管理。</p>

<p>

<a href="https://github.com/ForceMind/dsh-atelier/actions/workflows/ci.yml"><img alt="CI" src="https://github.com/ForceMind/dsh-atelier/actions/workflows/ci.yml/badge.svg" /></a>

<a href="https://www.npmjs.com/package/dsh-atelier-plugin"><img alt="npm version" src="https://img.shields.io/npm/v/dsh-atelier-plugin" /></a>

<a href="./LICENSE"><img alt="License MIT" src="https://img.shields.io/badge/license-MIT-blue.svg" /></a>

<img alt="Tested with DSH 0.2.1-rc.5" src="https://img.shields.io/badge/tested%20DSH-0.2.1--rc.5-235d60" />

</p>

<p>简体中文 · <a href="./README.en.md">English</a></p>

</div>

DSH Atelier 是面向 DeepSeek Harness 的社区 Host + Web UI 插件：紧凑模型指标、API 等价成本、全局提示词库、动态工作文案，自动回复候选，以及可选的本地请求审计。安装在当前 profile，不修改 DSH 应用文件，也不启动额外服务器。

1.7.0 的重要默认行为：自动生成回复候选默认开启，不是 opt-in。 助手完成文字回复、当前可见会话输入框空闲且为空时，默认 5 秒后使用独立的 Luna 推荐模型／low 发起可能收费的 API 请求，并发送有界的最近对话文字。可在“回复建议”中关闭或调整等待时间。候选不会自动发送；鼠标点击或键盘 Tab 都只采纳到输入框。请求/响应正文记录仍默认关闭、须主动开启；DSH 原版身份与语言偏好默认保留。插件不是匿名化网关或供应商账单系统。

1.7.0 更新

本说明对应 1.7.0。npm、GitHub Release 与市场索引是独立发布渠道，分发状态以实际渠道结果为准。

新增自动回复候选、独立模型选择（默认推荐已配置 Luna，low 档位）、最近任务上下文、可点击 Tab 采纳，以及“本轮＋总计”运行时长。总计只累计会话运行区间，不包含轮次之间的空闲时间。模型容量设置采用预览／确认／版本校验；缓存诊断不承诺供应商命中率提高。价格来源见 [价格证据](docs/price-evidence.md)。

“设置 → 整合与依赖”只提供导航与职责说明，不是 Suite 已完成或替代验证通过。Better Reasoning Effort 与 dsh-context 仍须独立安装使用，BrowserSkill 继续独立维护；本版不会据此卸载它们。

目录

• [功能](#功能)
• [安装与迁移](#安装与迁移)
• [快速上手](#快速上手)
• [回复候选与自动调用](#回复候选与自动调用)
• [全局提示词库](#全局提示词库)
• [用量与 API 等价费用](#用量与-api-等价费用)
• [本地日志与隐私](#本地日志与隐私)
• [动态工作文案](#动态工作文案)
• [开发与测试](#开发与测试)
• [兼容性与已知限制](#兼容性与已知限制)
• [参与贡献](#参与贡献)

功能

模块 · 提供的能力

紧凑状态栏 · 模型 / provider、本轮与会话累计运行耗时（不含轮间空闲）、可观测的思考流时长、输入 / 输出 / 缓存、API 等价费用；图标对齐、K/M/B 数字、完整值悬停提示

GPT 轨道图标 · 原创双轨光点，运行时缓慢旋转、空闲静止；遵循系统“减少动态效果”

全局提示词库 · DSH 原版、通用 AI 编程助手、可命名保存/选择/删除的自定义条目

动态 Chat 文案 · 可选轮换中文/英文工作提示，保留原生鲸鱼、计时、工具状态和滚动逻辑

本地请求审计 · 按会话列出新模型请求；查看 JSON、按角色展开的请求文本、响应流 JSONL 和响应文本

可配置计价 · 精确 provider/model 或通配符；输入、输出、缓存读取/写入；长上下文档位、来源和核对日期

回复候选 · 默认空闲 5 秒自动生成，独立 Luna 推荐模型／low；最近 6 轮、最多 12 条、24K 字符；点击或键盘 Tab 只采纳，编辑时隐藏、删空恢复缓存

整合导航 · 导航到上下文洞察／插件管理并说明依赖边界；不是 Suite 完成或原插件替代

Agent 集成 · atelier 工具与 /atelier 命令，共用 Host 操作，不维护另一套配置逻辑

底部只显示指标，不重复上方的等待文案。GPT 图标位于插件模型指标旁；并不替换原生 Chat 内部的鲸鱼图标。

安装与迁移

环境要求

• DeepSeek Harness 0.2.1-rc.5：1.7.0 当前目标与运行验证基线。
• 包声明允许 >=0.2.1-rc.5 <0.3.0；范围内其他版本仍需自行验证，不承诺未来所有版本无改动兼容。
• Web GUI，或包含相同 Host / Web Client 服务的 Desktop profile。
• 本地开发使用 Node.js >=22.19.0、pnpm 11.28.5。普通用户无需手工安装这些依赖。

使用 DSH 插件管理器

在 DSH 的 插件 → 安装插件 中输入：

dsh-atelier-plugin@1.7.0

确认安装并启用。也可以让拥有插件管理权限的 Agent 使用 plugin_manager，将以上包名作为 install_bundle 的 target。市场目录收录与 npm 发布是独立流程；若市场搜索尚未显示该插件，可直接使用包名安装。

包已附带构建好的浏览器模块。安装后打开应用 设置 → 工作台，或会话顶部 工作台 → 全局设置。若当前页面未跟随模块更新，重新打开该 DSH 窗口；是否需要应用重启以插件管理器的实际结果为准。

从源码开发

git clone https://github.com/ForceMind/dsh-atelier.git
cd dsh-atelier
pnpm install --frozen-lockfile --ignore-scripts
pnpm build
pnpm check

之后通过 DSH 插件管理器安装这个目录的绝对路径。不要直接编辑 profile 的依赖清单或组合补丁。

从早期本地版迁移

早期会话开发版的包名是 @local/dsh-atelier；公开包名是 dsh-atelier-plugin。npm 上的 dsh-atelier 是其他作者的不同项目，不是本插件。

1. 备份当前 profile 数据；日志可能含敏感信息。

2. 在插件管理器中先禁用/卸载早期本地版，再启用公开版。不能同时启用两者，因为它们使用相同的工具、API 路由、projection 与存储域。

3. 公开版沿用 dsh_atelier_v1 存储域，不主动删除旧数据。原设置会被保留；因此旧版已经开启的正文记录不会因为安装公开版而自动关闭。

4. 在全局设置重新检查记录开关、提示词、价格与语言包选项。

快速上手

1. 先检查“回复建议”的自动开关：默认开启、5 秒，可能调用模型并收费；不需要时先关闭，再观察底部指标。

2. 打开 设置 → 工作台。这里的提示词、价格、记录策略和词库都属于当前 profile 的全局设置；请求日志则按会话隔离。

3. 按需要选择提示词，或开启动态等待提示。

4. 如需日志正文，阅读隐私说明后开启 记录完整请求与响应正文。

5. 配置供应商实际单价；未配置时显示“未知”，不会冒充免费。

6. 点击 保存设置。提示词变更从各会话下一次 admitted step 生效，历史消息不改写。

/atelier 显示当前会话统计。Agent 的 atelier 工具支持 status、settings、save、logs、get、diagnose、cache、display、模型容量操作，以及 reply-models／reply-options／reply-draft。日志默认分页，建议只读取必要片段。配置可由该 Agent 工具修改；如果不希望 Agent 修改全局设置，请通过宿主工具可见性/权限机制限制它，而不是把 UI 开关当作授权边界。

回复候选与自动调用

• 默认开启自动生成，等待 5 秒；不是用户首次点击后才联网。 在“回复建议”中设置自动开关、整数 0–60 秒延时和独立模型。0 秒表示满足条件后立即调度，不是关闭。
• 默认从已注册模型中推荐 Luna，优先 gpt-6-luna；可选择其他精确渠道／模型。模型须支持 low，这是低强度思考，不是关闭思考；不改变正常对话的模型或档位。没有可用 Luna 时提示选择，不虚构模型或静默回退。
• 草稿模型读取最近最多 6 个用户轮次／12 条用户与助手文字／24,000 字符，明确标记截断；不发送系统／开发者提示、reasoning 块、工具结果或非文字附件。对话文字内本身的敏感信息仍可能被发送到所选提供方，不是额外脱敏。
• 候选以较浅文字显示；鼠标点击 Tab 与键盘 Tab 都只采纳到输入框，之后用原生发送按钮发送。不会自动发送。输入时隐藏并保留同来源候选，删空后恢复缓存，不另发生成请求；新消息、切换会话或重新生成会使旧候选失效。
• 每条助手回复在当前 Host 进程内只自动尝试一次，失败不循环重试；最近 500 个会话／来源组合在内存去重，重启不保证保留。手动生成仍可能再次收费。
• 独立草稿请求的成本不计入底栏会话费用总计，但提供方可能计费。已发出的调用不会因关闭开关撤销费用。候选需要人工审阅；删除、付款、外发、权限或生产部署等敏感操作仍保留确认限制。

完整交互与验证边界见 [回复候选说明](docs/reply-draft.md)。

全局提示词库

DSH 原版（默认）

撤销本插件对身份和软件说明的覆盖，继续使用当前 DSH、模型、preset 与其他插件动态组装的内容。不是一份容易过期的完整提示词副本。

通用 AI 编程助手

将身份段设置为：

You are a helpful AI coding assistant.

该条目同时启用客户端固定自述精简：将两项已知的软件说明改为中性措辞，并不再额外贡献对应的安装路径/GUI URL 上下文。工作目录、构建验证、工具使用和权限约束保留。

自定义条目

编辑身份和追加系统指令，填写名称后点击 将当前提示词存入库。可再次选择或删除自定义条目；两项内置条目不可删除。选择、添加和删除都需要 保存设置 才持久化。价格和日志选项不会随提示词选择被覆盖。

这不提供客户端匿名化。历史内容、工具定义、权限说明、SDK 协议或请求头仍可能透露客户端；插件不删除沙箱/审批策略，不暗改冻结的模型请求。

用量与 API 等价费用

独立回复草稿请求不计入此总计，但可能出现在供应商账单中。费用是当前会话已提交响应的累计 API 等价估算，不是余额、单次请求价格或渠道账单。新装公开版价格表为空，不自动下载或套用费率。

示例仅演示结构，不是当前官方价，单位为每百万 tokens：

[
  {
    "provider": "YOUR_PROVIDER",
    "model": "YOUR_MODEL",
    "currency": "USD",
    "input": 2,
    "output": 10,
    "cacheRead": 0.1,
    "cacheWrite": 2.5,
    "longContext": {
      "threshold": 272000,
      "input": 4,
      "output": 15,
      "cacheRead": 0.2,
      "cacheWrite": 5
    },
    "source": "https://your-provider.example/pricing",
    "checkedAt": "YYYY-MM-DD"
  }
]

• 精确 provider 优先，其次精确 model，再比较 model 通配符具体程度。provider * 是跨渠道的同名模型等价估算，不证明其上游路由。
• DSH 的未缓存输入、缓存读取和缓存写入是独立桶；思考

…(truncated)