前言¶
在 DeepSeek Harness（DSH）里跑 Agent 时，模型请求往往分散在会话流、工具调用和宿主适配层之间：本轮用了哪个 provider、输入输出和缓存各占多少、等价 API 费用大概多少，默认界面不一定一眼能看清。若还要切换身份提示词、或在本地排查某次请求的 JSON 与响应流，通常得依赖外部脚本或手工翻日志。
DSH Atelier 是社区维护的 Host + Web UI 插件，把紧凑指标、可配置计价、全局提示词库和可选请求审计收进「工作台」，数据留在当前 profile，不另起服务器。下面介绍它的定位、能力与安装用法。
这是什么¶
DSH Atelier（npm 包名 dsh-atelier-plugin）由 ForceMind 维护，面向 DeepSeek Harness 的「模型推理」类插件。简介概括为：Local-first 工作台——紧凑用量与成本指标、提示词库、动态工作文案，以及可选的本地请求审计。
安装在当前 profile，不修改 DSH 应用文件。公开版默认保留 DSH 原版身份，不记录请求/响应正文，不改变语言偏好；完整日志、通用助手身份和动态语言包需主动开启。插件不是匿名化网关，也不是供应商账单系统。
当前文档记载的版本为 1.5.0，在 DSH 0.2.1-rc.3 上经过运行验证；包声明允许 >=0.2.1-rc.3 <0.3.0。代码以 MIT 许可发布。
核心功能¶
README 将能力拆成若干模块，安装后可在底部状态栏与会话内工作台设置中体现。
紧凑状态栏与指标详情¶
底部展示模型 / provider、本轮耗时、可观测的思考流时长、输入 / 输出 / 缓存 token，以及 API 等价费用；数字支持 K/M/B 缩写，悬停可看完整值。1.5.0 起，七项底栏指标可点击查看简洁浮窗，支持按币种费用拆分。另有原创双轨 GPT 轨道图标（运行时缓慢旋转，遵循系统「减少动态效果」），位于插件模型指标旁，不替换 Chat 内原生鲸鱼图标。
全局提示词库¶
三种来源：默认 DSH 原版（撤销本插件对身份与软件说明的覆盖，继续由当前 DSH、模型、preset 与其他插件动态组装）；通用 AI 编程助手（固定身份段为 You are a helpful AI coding assistant.，并精简部分客户端自述）；以及可命名保存、选择、删除的自定义条目。选择与持久化需在工作台 保存设置；提示词变更从各会话下一次 admitted step 生效，历史消息不改写。
用量与 API 等价费用¶
费用是当前会话已提交响应的累计 API 等价估算，不是余额或渠道账单。新装公开版价格表为空，未配置时显示「未知」，不会冒充免费。可按 provider / model 或通配符配置输入、输出、缓存读写的每百万 token 单价，并可选长上下文档位；需自行维护 source 与 checkedAt，并在供应商官网核实现价。仓库提供 JSON 结构示例与价格证据文档，示例价不是官方永久价目表。
本地请求审计（可选）¶
默认仅保留请求元数据、模型、用量、时间与错误摘要。开启 记录完整请求与响应正文 后，可按会话列出新模型请求，查看 JSON、按角色展开的请求文本、响应流 JSONL 与响应文本。捕获的是 DSH 统一请求/响应流层级，不是最终 HTTP body 或原始 SSE；凭据字段尽力脱敏，不是 DLP。默认保留策略为 14 天、256 MiB 总量等，详见仓库安全与配置文档。
动态工作文案¶
可选开启后，通过 zh-x-atelier / en-x-atelier 语言包只覆盖 Chat 两个等待翻译键，保留原生鲸鱼、计时与工具状态逻辑；默认约 4 秒轮换，含 76 句原创状态词（1.5.0 更新说明）。
缓存诊断¶
点击底栏缓存指标可查看本次、最近 20 次与累计的已报告样本命中率；缺字段不等于 0% 命中。工作台或 atelier 工具的 cache 动作可分析系统段、工具定义与历史前缀变化，不返回请求正文。诊断不承诺提高供应商命中率。
Agent 集成¶
提供 atelier 工具与 /atelier 命令，动作包括 status、settings、save、logs、get、diagnose、cache、display 等，与 Host 共用同一套配置逻辑。
安装与启用¶
环境要求：DSH 0.2.1-rc.3（当前验证版本），需 Web GUI 或含相同 Host / Web Client 的 Desktop profile。
在 DSH 的 插件 → 安装插件 中输入官方包名（勿与 npm 上其他作者的 dsh-atelier 混淆）：
dsh-atelier-plugin@1.5.0
确认安装并启用。也可由具备插件管理权限的 Agent 通过 plugin_manager，将上述包名作为 install_bundle 的 target。若市场目录尚未收录，可直接用包名安装。
安装后打开 设置 → 工作台，或会话顶部 工作台 → 全局设置。若页面未跟随模块更新，重新打开 DSH 窗口；是否需应用重启以插件管理器结果为准。
从早期本地包 @local/dsh-atelier 迁移时，需先禁用/卸载旧版再启用公开版，不能同时启用两者（共用相同工具、路由与存储域 dsh_atelier_v1）。
插件以当前 DSH 进程权限运行；安装前建议在 GitHub 查看源码与 MIT 许可证，并理解默认不记录正文的隐私边界。
典型用法¶
经过安装，可按 README 快速上手顺序操作：
- 安装后先观察底部模型指标。
- 打开 设置 → 工作台，配置属于当前 profile 的全局项；请求日志按会话隔离。
- 按需选择提示词，或开启动态等待提示。
- 如需日志正文，阅读隐私说明后开启 记录完整请求与响应正文。
- 配置供应商实际单价 JSON；未配置则费用显示未知。
- 点击 保存设置。
在会话中输入 /atelier 可查看当前会话统计。Agent 可通过 atelier 工具读取状态或日志；若不希望 Agent 修改全局设置，应通过宿主工具可见性/权限限制，而非仅依赖 UI 开关。
计价表示例结构（单位：每百万 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"
}
]
适用场景与注意¶
适合希望在 DSH 内本地优先查看 token 用量、自维护 API 等价成本、统一管理身份提示词，并在可控前提下做请求审计的开发者。主要验证平台为 macOS Desktop / Web 与 DSH 0.2.1-rc.3；其他 OS 与未来版本需自行验证。Host 缺少声明依赖时插件不会激活；可用 atelier diagnose 检查 Client 注册。
已知边界：费用不含渠道倍率、Batch、税费等；失败/重试 attempt 可能已被供应商收费但不计入已提交响应 aggregate。模型增强、BrowserSkill、dsh-context 的统一入口尚未在本插件实现，需继续独立使用原插件。卸载插件不会自动删除已落盘日志。
DSH 生态强调「一切皆插件」；SkillHub 目录页 与 DeepSeek / 幻方无官方从属关系，本文事实以仓库 README 与 npm 包说明为准。
结尾¶
DSH Atelier 把可读的过程指标、可管理的提示词与可选审计收进工作台，不改变 DSH 本体联网行为，也不默认上传数据。若要安装或查变更记录，可访问 GitHub：ForceMind/dsh-atelier 与目录页 forcemind/dsh-atelier。
