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 采纳,以及“本轮+总计”运行时长。总计只累计会话运行区间,不包含轮次之间的空闲时间。模型容量设置采用预览/确认/版本校验;缓存诊断不承诺供应商命中率提高。价格来源见 价格证据。
“设置 → 整合与依赖”只提供导航与职责说明,不是 Suite 已完成或替代验证通过。Better Reasoning Effort 与 dsh-context 仍须独立安装使用,BrowserSkill 继续独立维护;本版不会据此卸载它们。
目录
功能
| 模块 | 提供的能力 |
|---|---|
| 紧凑状态栏 | 模型 / 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 是其他作者的不同项目,不是本插件。
- 备份当前 profile 数据;日志可能含敏感信息。
- 在插件管理器中先禁用/卸载早期本地版,再启用公开版。不能同时启用两者,因为它们使用相同的工具、API 路由、projection 与存储域。
- 公开版沿用
dsh_atelier_v1存储域,不主动删除旧数据。原设置会被保留;因此旧版已经开启的正文记录不会因为安装公开版而自动关闭。 - 在全局设置重新检查记录开关、提示词、价格与语言包选项。
快速上手
- 先检查“回复建议”的自动开关:默认开启、5 秒,可能调用模型并收费;不需要时先关闭,再观察底部指标。
- 打开 设置 → 工作台。这里的提示词、价格、记录策略和词库都属于当前 profile 的全局设置;请求日志则按会话隔离。
- 按需要选择提示词,或开启动态等待提示。
- 如需日志正文,阅读隐私说明后开启 记录完整请求与响应正文。
- 配置供应商实际单价;未配置时显示“未知”,不会冒充免费。
- 点击 保存设置。提示词变更从各会话下一次 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 个会话/来源组合在内存去重,重启不保证保留。手动生成仍可能再次收费。
- 独立草稿请求的成本不计入底栏会话费用总计,但提供方可能计费。已发出的调用不会因关闭开关撤销费用。候选需要人工审阅;删除、付款、外发、权限或生产部署等敏感操作仍保留确认限制。
完整交互与验证边界见 回复候选说明。
全局提示词库
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 的未缓存输入、缓存读取和缓存写入是独立桶;思考 tokens 已在输出中,不重复计费。
- 按单次请求的输入总量选长短档,分别累计后汇总;不是对会话累计 tokens 套一次长上下文价格。当前开发版支持
100000与272000两种阈值,并按请求分别累计。 - 缺失/非法 usage、未匹配价格都明确标为未知;已有可计算费用只代表已知部分。
- 默认缓存写入按匹配规则的单价处理;宿主不报告实际 TTL,不能声称自动识别。开发版有证据不完整的预设会将缺失缓存费率保留为未知,而不推价。12h 字段仅为显式扩展,不是 Claude 的 1h 字段。
- 不包括渠道倍率、Fast/Flex/Batch、地区加价、税费、工具附加费;失败/重试 attempt 可能已被供应商收费,但不计入已提交响应 aggregate。
完整字段和算法见 配置参考。请在 OpenAI 或相应供应商官网核实当前价格,维护 source / checkedAt,不要把仓库示例当作永久价目表。
本地日志与隐私
**公开版默认关闭正文记录。**关闭时仍保存请求元数据、模型/provider、用量、时间、结束状态与错误摘要。开启后,可能保存系统/开发者提示词、对话、代码、工具 schema/参数和模型输出。
日志捕获层级:
DSH 统一请求(适配器转换前) → 供应商适配器 → DSH 统一响应流(转换后)
它不是最终 HTTP body、请求头或供应商原始 SSE;图片/文件只保留附件引用,不复制二进制内容。插件不拦截全局 fetch,不读取 API key,也不新增日志上传或价格查询网络服务;但默认开启的回复候选会通过已配置模型适配器发送最近对话文字并可能产生 API 费用。它不改变 DSH 本体或其他插件拥有的联网行为。
- 凭据字段和常见字符串模式尽力脱敏,不是 DLP;分享前务必人工检查。
- 为防止凭据跨 chunk 拆分绕过脱敏,正文流在 attempt 结束后重建并清洗。
rebuiltForRedaction表示原 token 边界已改变,不适合精确流时序回放。 - 默认保留策略:14 天、256 MiB 总量、每 attempt 32 MiB 捕获预算。清理发生在启动、请求结束和保存设置时,不是定时硬过期;格式化/标记可能增加存储大小。
- 开始与结束时持久化,崩溃可能仅留下开始记录。只记录启用后的新正文,不追溯补录历史。
- 下载按钮下载当前已加载内容;未完整加载时文件名带
partial。卸载插件不会自动删除日志。
详见 安全政策 和 数据与配置参考。不要在公开 issue 上传完整请求日志、个人配置或未审查的截图。
动态工作文案
主动开启后,通过 zh-x-atelier / en-x-atelier 语言包只覆盖原生 Chat 的两个等待翻译键,其他文案回退原语言;不操作宿主 DOM,也不替换整个聊天渲染器。
它会持久化一个 profile 共享的语言偏好。关闭或卸载时,仅当语言仍为本插件变体才恢复对应中文/英文,不覆盖用户手动切换的其他语言;不能恢复“未显式选择”的自动检测状态。默认 4 秒轮换,仅在有会话运行时刷新;词典更新会产生少量全局 locale 刷新成本。读屏提示保持稳定,避免频繁播报。
缓存诊断
点击底栏缓存指标,可分别查看本次、最近 20 次、累计的已报告样本命中率,以及未报告缓存字段的次数。缺字段不等于 0% 命中;百分比按 tokens 加权,不是逐请求比例的平均。
在 工作台 → 请求日志 → 缓存诊断 → 分析最近请求,或调用 atelier 的 cache 动作,可查看系统段、工具定义、请求选项与历史前缀变化。只返回布尔、计数与有限工具名,不返回请求正文或指纹。新请求只在内存保存有限指纹;历史回看使用已有脱敏记录,无法证明上游缓存键、路由或 TTL。
已优化:只保存价格、词库或日志策略时,不再重绑所有会话的提示词。趣味状态词仍只存在于 Client。不会自动改写请求、删除安全规则,或发送额外付费请求来刷命中率。详见 缓存诊断参考。
深空飞船思考滑块
安装并启用 Better Reasoning Effort 0.5.4 的模型菜单滑块时,Atelier 为现有控件提供原创深空飞船外观:320px 长、28px 厚轨道,96×72 飞船可伸出边界,无额外白边;开启减少动态效果时静止。此为依赖 .bre-* 标记的版本适配,不是独立滑块或稳定跨插件主题 API;不改变模型档位、保存和回滚逻辑。严格会话覆盖/恢复继承仍依赖宿主扩展,详见思考设置与兼容边界。
会话永久删除尚未提供:当前宿主没有安全删除 API,按用户决定列入下一阶段,本版仍只使用原生归档。
开发与测试
pnpm build # 生成可加载的 client.js
pnpm check # 语法、核心、Host、语言包、格式及发布守卫
npm pack --dry-run --ignore-scripts
- Host / domain:
host.js、core.mjs。 - Client 源码:
client-source.js、activity.mjs、ui-format.mjs。 - 构建:
build-client.mjs;生成的client.js随包发布。 - 包采用运行文件白名单,无安装脚本,无独立服务器,无重复 React。
测试包含设置 CAS 并发保护、日志会话隔离、缺失 usage、上下文分档、跨片段脱敏、原版提示词恢复、语言包清理与格式边界。测试不等同于视觉截图验收或真实供应商账单对账。架构见 architecture,发布流程见 releasing。
兼容性与已知限制
1.7.0 主要验证平台:macOS Desktop / Web、DSH 0.2.1-rc.5;早期 0.2.1-rc.3 验证仅覆盖当时已有功能,不支持将新回复候选功能归为 rc.3 已验证。其他 OS、第三方主题和未来版本尚未全面验收。
Host 缺少声明依赖时插件不会激活;仅安装成功不代表浏览器端已加载。可用
atelier diagnose检查版本和 Client 注册。活动中更换插件若宿主返回
restart-required,请在当前回复结束后重启;不要通过另起服务器代替刷新当前应用。思考耗时是可观察的 reasoning stream 区间,不是供应商内部思考时间;没有该流时显示
—。原生鲸鱼图标仍由宿主控制;GPT 轨道图标位于底部指标旁。迷你土星已准备独立源码补丁,尚未接入当前应用,详见实验方案。
旧本地版与公开版不能在同一 profile 同时启用。
发布状态、内部型号映射、缓存验证及可选功能见后续计划。
参与贡献
欢迎 issue 与 PR。提交前阅读 贡献指南,安全问题请使用 私密报告流程。功能边界和版本记录见 CHANGELOG。
致谢与许可
灵感来自 Claude-Code-Chinese-Simplified 的中文体验方向;本项目没有复制其代码或词库。图标和轨道动画为原创。
社区项目,非 DeepSeek 或 OpenAI 官方产品;相关名称与商标属于各自权利人。代码按 MIT 许可发布。
No comments yet. Be the first to write one.