Merge pull request #7048 from deepseek-harness/turtle/plugin-detail-pages-5c09dd3d0a33

docs(experimental): move plugin detail text into descriptions
This commit is contained in:
Turtle authored and GitHub committed 2026-10-26 11:39:55 +08:00
commit da3055de3e
126 files changed
+144 -536

No files matched your search

+1 -1
View File
@@ -196,7 +196,7 @@ it.skipIf(MODE === 'record')('reuses saved native Account Flash translations acr
await panel.getByText(`v${bundleVersion}`, { exact: true }).waitFor()
await panel.getByText(bundleVersion, { exact: true }).waitFor()
// The bundle's detail document is shown between its components and its source.
await panel.locator('[data-detail-document]').getByRole('heading', { name: '使用方法', exact: true }).waitFor()
await panel.locator('[data-detail-document]').getByRole('img', { name: '展开的思考行从英文翻译成中文,并显示“查看原文”按钮', exact: true }).waitFor()
await compareOrRefreshGolden(join(EXPECTED, 'paid-choices.expected.md'),
await captureStableAria(settings, '[data-plugin-panel]', scaffold.workspaceCwd, {
replacements: [[BUNDLE, '{{bundle}}'], [bundleVersion, '{{version}}']],
+1 -1
View File
@@ -213,7 +213,7 @@ it.skipIf(MODE === 'record')('persists Bing reasoning translation across reopen
await panel.getByText(`v${bundleVersion}`, { exact: true }).waitFor()
await panel.getByText(bundleVersion, { exact: true }).waitFor()
// The bundle's detail document is shown between its components and its source.
await panel.locator('[data-detail-document]').getByRole('heading', { name: '使用方法', exact: true }).waitFor()
await panel.locator('[data-detail-document]').getByRole('img', { name: '展开的思考行从英文翻译成中文,并显示“查看原文”按钮', exact: true }).waitFor()
await compareOrRefreshGolden(join(EXPECTED, 'preferences.expected.md'),
await captureStableAria(settings, '[data-plugin-panel]', scaffold.workspaceCwd, {
replacements: [[BUNDLE, '{{bundle}}'], [bundleVersion, '{{version}}']],
@@ -1,5 +1,5 @@
- listitem:
- button "Siehe Automatische Autorisierungsüberprüfung": Automatische Autorisierungsüberprüfung
- text: Experimentell Fügen Sie einen Auto review-Berechtigungsmodus hinzu, der das Modell verwendet, um die Autorisierung vor jedem Toolaufruf zu bewerten.
- text: "Experimentell Fügt den Zugriffsmodus „Auto review“ hinzu: Vor jedem Tool-Aufruf prüft ein Modell den Aufruf anhand Ihrer Anforderung; zugelassene Aufrufe laufen sofort, abgelehnte Aufrufe warten auf Ihre Genehmigung."
- status
- switch "Aktivieren Sie Automatische Autorisierungsüberprüfung"
@@ -1,5 +1,5 @@
- listitem:
- button "Ver Revisión de autorización automática": Revisión de autorización automática
- text: Experimental Agregue un modo de permiso Auto review que utilice el modelo para evaluar la autorización antes de cada llamada a la herramienta.
- text: "Experimental Añade el modo de acceso “Auto review”: antes de cada llamada a una herramienta, un modelo comprueba la llamada frente a lo que usted pidió; las llamadas permitidas se ejecutan de inmediato y las denegadas esperan su aprobación."
- status
- switch "Habilitar Revisión de autorización automática"
@@ -1,5 +1,5 @@
- listitem:
- button "Voir Examen des autorisations automatiques": Examen des autorisations automatiques
- text: Expérimental Ajoutez un mode d'autorisation Auto review qui utilise le modèle pour évaluer l'autorisation avant chaque appel d'outil.
- text: "Expérimental Ajoute le mode d'accès « Auto review » : avant chaque appel d'outil, un modèle vérifie l'appel par rapport à ce que vous avez demandé ; les appels autorisés s'exécutent immédiatement et les appels refusés attendent votre approbation."
- status
- switch "Activer Examen des autorisations automatiques"
@@ -1,5 +1,5 @@
- listitem:
- button "Ver Revisão de autorização automática": Revisão de autorização automática
- text: Experimental Adicione um modo de permissão Auto review que usa o modelo para avaliar a autorização antes de cada chamada de ferramenta.
- text: "Experimental Adiciona o modo de acesso “Auto review”: antes de cada chamada de ferramenta, um modelo verifica a chamada em relação ao que você pediu; as chamadas permitidas são executadas imediatamente e as negadas aguardam sua aprovação."
- status
- switch "Ativar Revisão de autorização automática"
@@ -1,5 +1,5 @@
- listitem:
- button "Посмотреть Проверка автоматической авторизации": Проверка автоматической авторизации
- text: Экспериментальный Добавьте режим разрешений Auto review, который использует модель для оценки авторизации перед каждым вызовом инструмента.
- text: "Экспериментальный Добавляет режим доступа «Auto review»: перед каждым вызовом инструмента модель сверяет вызов с вашей просьбой; разрешённые вызовы выполняются сразу, а отклонённые ждут вашего одобрения."
- status
- switch "Включить Проверка автоматической авторизации"
@@ -6,57 +6,10 @@
- text: v{{version}} 实验性
- paragraph:
- code: "@deepseek-ai/dsh-experimental-cot-translation-bundle"
- paragraph: 机器翻译展开的思考内容;原文会发送给所选服务
- paragraph: 智能体输出时,把展开的“思考”行翻译成你选择的语言,点击“查看原文”可切换回原文。
- region "详细介绍":
- paragraph:
- img "展开的思考行从英文翻译成中文,并显示“查看原文”按钮"
- paragraph:
- text: 展开
- strong: 思考
- text: 行,即可用界面语言阅读其中的思考内容。智能体输出时会逐段翻译;最新的内容在能够翻译之前保持原文。
- heading "使用方法" [level=2]
- list:
- listitem:
- text: 展开
- strong: 思考
- text: 行。点击
- strong: 查看原文
- text: 显示原文,点击
- strong: 查看译文
- text: 切换回译文。
- listitem:
- text: 在此插件的页面中选择
- strong: 翻译服务
- text: 和
- strong: 目标语言
- text: ,然后点击
- strong: 保存
- text: 。
- code: auto
- text: 表示跟随界面语言;也可以填写
- code: zh
- text: 、
- code: en
- text: 、
- code: ja
- text: 等语言代码。
- listitem:
- text: 翻译失败时,原文保持显示,并提供
- strong: 重试
- text: 。
- heading "注意事项" [level=2]
- list:
- listitem: 你展开的思考内容可能包含你的代码和对话细节。
- listitem: 默认使用 Bing,也可以选择 Google。两者都无需账号或 API key,但都不保证可用,也不保证免费额度。
- listitem:
- text: 如果已配置 DeepSeek 账号或官方 API,还会出现
- strong: DeepSeek Flash · 账号(付费)
- text: 和
- strong: DeepSeek Flash · 官方 API(付费)
- text: 。此时每段没有已保存译文的内容都是一次付费请求。
- listitem: 译文保存在会话中,重新打开时直接复用。原始思考内容和模型的输入都不会改变。
- listitem: 折叠时显示的摘要保持原文。翻译可能改变 Markdown 格式或代码。
- listitem: 关闭此插件会移除它的按钮并取消未完成的翻译;已保存的译文仍保留在会话中。
- paragraph: 展开的思考内容会发送给所选翻译服务,可能包含私有代码或对话细节。
- paragraph: 每个未缓存片段都会通过所选账号或官方 API 凭据单独发送一次付费的 DeepSeek Flash 请求;重新展开会复用已保存的译文,更改服务、语言、原文或请求设置可能发送新的付费请求
- text: 翻译服务 已覆盖
@@ -6,57 +6,10 @@
- text: v{{version}} 实验性
- paragraph:
- code: "@deepseek-ai/dsh-experimental-cot-translation-bundle"
- paragraph: 机器翻译展开的思考内容;原文会发送给所选服务
- paragraph: 智能体输出时,把展开的“思考”行翻译成你选择的语言,点击“查看原文”可切换回原文。
- region "详细介绍":
- paragraph:
- img "展开的思考行从英文翻译成中文,并显示“查看原文”按钮"
- paragraph:
- text: 展开
- strong: 思考
- text: 行,即可用界面语言阅读其中的思考内容。智能体输出时会逐段翻译;最新的内容在能够翻译之前保持原文。
- heading "使用方法" [level=2]
- list:
- listitem:
- text: 展开
- strong: 思考
- text: 行。点击
- strong: 查看原文
- text: 显示原文,点击
- strong: 查看译文
- text: 切换回译文。
- listitem:
- text: 在此插件的页面中选择
- strong: 翻译服务
- text: 和
- strong: 目标语言
- text: ,然后点击
- strong: 保存
- text: 。
- code: auto
- text: 表示跟随界面语言;也可以填写
- code: zh
- text: 、
- code: en
- text: 、
- code: ja
- text: 等语言代码。
- listitem:
- text: 翻译失败时,原文保持显示,并提供
- strong: 重试
- text: 。
- heading "注意事项" [level=2]
- list:
- listitem: 你展开的思考内容可能包含你的代码和对话细节。
- listitem: 默认使用 Bing,也可以选择 Google。两者都无需账号或 API key,但都不保证可用,也不保证免费额度。
- listitem:
- text: 如果已配置 DeepSeek 账号或官方 API,还会出现
- strong: DeepSeek Flash · 账号(付费)
- text: 和
- strong: DeepSeek Flash · 官方 API(付费)
- text: 。此时每段没有已保存译文的内容都是一次付费请求。
- listitem: 译文保存在会话中,重新打开时直接复用。原始思考内容和模型的输入都不会改变。
- listitem: 折叠时显示的摘要保持原文。翻译可能改变 Markdown 格式或代码。
- listitem: 关闭此插件会移除它的按钮并取消未完成的翻译;已保存的译文仍保留在会话中。
- paragraph: 展开的思考内容会发送给所选翻译服务,可能包含私有代码或对话细节。
- paragraph: Bing 和 Google 翻译无需额外登录或 API key,但匿名接口可能拒绝或限制请求
- text: 翻译服务
@@ -1,5 +1,5 @@
- listitem:
- button "自動認可レビューを表示": 自動認可レビュー
- text: 実験的 各ツール呼び出しの前にモデルが認可を判断する、自動認可レビュー権限モードを提供します。
- text: 実験的 「自動認可レビュー」アクセスモードを追加します。各ツール呼び出しの前に、モデルがその呼び出しをあなたの依頼内容と照らし合わせて確認し、許可された呼び出しは即座に実行され、拒否された呼び出しはあなたの承認を待ちます。
- status
- switch "自動認可レビューを有効化"
@@ -24,7 +24,7 @@
- list:
- listitem:
- button "查看 智能体团队": 智能体团队
- text: 实验性 启用团队协作、团队工具、成员列表和共享任务看板。
- text: 实验性 让与你对话的智能体把工作分给有名字的队友,在共享任务看板上跟踪进度,并汇总队友的结果向你汇报。
- status
- switch "启用 智能体团队"
- listitem:
@@ -34,12 +34,12 @@
- switch "启用 语音输入"
- listitem:
- button "查看 自定义插件索引": 自定义插件索引
- text: 实验性 在插件页添加「发现」标签页,从你添加的插件索引浏览和安装插件。
- text: 实验性 在插件页添加“发现”标签页,从你添加的插件索引中浏览和安装插件。
- status
- switch "启用 自定义插件索引"
- listitem:
- button "查看 自动授权审查": 自动授权审查
- text: 实验性 提供自动审查权限模式,由模型在每次工具调用前判断是否授权。
- text: 实验性 提供“自动审查”访问模式:每次工具调用前,由模型对照你的要求检查,获准的调用立即运行,被拒绝的调用等你审批。
- status
- switch "启用 自动授权审查"
- heading "已安装插件" [level=3]
@@ -24,7 +24,7 @@
- list:
- listitem:
- button "查看 智能体团队": 智能体团队
- text: 实验性 启用团队协作、团队工具、成员列表和共享任务看板。
- text: 实验性 让与你对话的智能体把工作分给有名字的队友,在共享任务看板上跟踪进度,并汇总队友的结果向你汇报。
- status
- switch "启用 智能体团队"
- listitem:
@@ -34,12 +34,12 @@
- switch "启用 语音输入"
- listitem:
- button "查看 自定义插件索引": 自定义插件索引
- text: 实验性 在插件页添加「发现」标签页,从你添加的插件索引浏览和安装插件。
- text: 实验性 在插件页添加“发现”标签页,从你添加的插件索引中浏览和安装插件。
- status
- switch "启用 自定义插件索引"
- listitem:
- button "查看 自动授权审查": 自动授权审查
- text: 实验性 提供自动审查权限模式,由模型在每次工具调用前判断是否授权。
- text: 实验性 提供“自动审查”访问模式:每次工具调用前,由模型对照你的要求检查,获准的调用立即运行,被拒绝的调用等你审批。
- status
- switch "启用 自动授权审查"
- heading "已安装插件" [level=3]
@@ -24,7 +24,7 @@
- list:
- listitem:
- button "查看 智能体团队": 智能体团队
- text: 实验性 启用团队协作、团队工具、成员列表和共享任务看板。
- text: 实验性 让与你对话的智能体把工作分给有名字的队友,在共享任务看板上跟踪进度,并汇总队友的结果向你汇报。
- status
- switch "启用 智能体团队"
- listitem:
@@ -34,12 +34,12 @@
- switch "启用 语音输入"
- listitem:
- button "查看 自定义插件索引": 自定义插件索引
- text: 实验性 在插件页添加「发现」标签页,从你添加的插件索引浏览和安装插件。
- text: 实验性 在插件页添加“发现”标签页,从你添加的插件索引中浏览和安装插件。
- status
- switch "启用 自定义插件索引"
- listitem:
- button "查看 自动授权审查": 自动授权审查
- text: 实验性 提供自动审查权限模式,由模型在每次工具调用前判断是否授权。
- text: 实验性 提供“自动审查”访问模式:每次工具调用前,由模型对照你的要求检查,获准的调用立即运行,被拒绝的调用等你审批。
- status
- switch "启用 自动授权审查"
- heading "已安装插件" [level=3]
@@ -1,5 +1,5 @@
- bundle: Developer tools
description: Inspect and debug raw session data, grouped chat messages, and the NodeJS backend.
description: For troubleshooting: view what DSH recorded for a session in Session log, and debug the DSH backend in Chrome DevTools.
- component: NodeJS inspector
description: Press Ctrl/Cmd+Shift+. to open Chrome DevTools in the bottom panel for development and debugging.
- component: Session log
@@ -1,5 +1,5 @@
- bundle: 开发者工具
description: 查看调试会话原始数据、聊天消息分组数据,以及调试 NodeJS 后端
description: 用于排查问题:在“会话数据诊断”中查看 DSH 为会话记录的内容,并在 Chrome DevTools 中调试 DSH 后端。
- component: NodeJS 诊断
description: 按 Ctrl/Cmd+Shift+. 在底部面板打开 Chrome DevTools 进行开发调试
- component: 会话数据诊断
@@ -3,7 +3,7 @@ import { fileURLToPath } from 'node:url'
import { chromium, type Browser } from 'playwright'
import { expect, it, onTestFailed, onTestFinished } from 'vitest'
import { captureStableAria, compareOrRefreshGolden, launchWebScaffold, watchConsole, webSnapshotMode, type WebScaffold } from './scaffold.ts'
import { saveFailureShot } from './support.ts'
import { experimentalBundleDescription, saveFailureShot } from './support.ts'
it('displays Japanese plugin titles and descriptions from package metadata', async () => {
const resources: { scaffold?: WebScaffold; browser?: Browser } = {}
@@ -23,7 +23,7 @@ it('displays Japanese plugin titles and descriptions from package metadata', asy
const title = panel.getByRole('button', { name: '自動認可レビューを表示', exact: true })
await title.waitFor()
const card = title.locator('xpath=ancestor::li')
await card.getByText('各ツール呼び出しの前にモデルが認可を判断する、自動認可レビュー権限モードを提供します。', { exact: true }).waitFor()
await card.getByText(experimentalBundleDescription('auto-review', 'ja'), { exact: true }).waitFor()
const expected = fileURLToPath(new URL('./expected/japanese-plugin-metadata/card.expected.md', import.meta.url))
await compareOrRefreshGolden(expected,
await captureStableAria(page, '[data-plugin-panel] li:has(button[aria-label="自動認可レビューを表示"])', scaffold.workspaceCwd), webSnapshotMode())
+4 -4
View File
@@ -17,7 +17,7 @@ import {
launchWebScaffold, watchConsole, webSnapshotMode, type WebScaffold,
} from './scaffold.ts'
import {
ZH_BROWSER_LOCALE, connectFreshWorkspaceZh, openSettings, PLUGIN_TOGGLE_SETTLE_MS, saveFailureShot,
ZH_BROWSER_LOCALE, connectFreshWorkspaceZh, experimentalBundleDescription, openSettings, PLUGIN_TOGGLE_SETTLE_MS, saveFailureShot,
} from './support.ts'
const SNAPSHOT_DIR = fileURLToPath(new URL('./expected/plugin-manager', import.meta.url))
@@ -842,7 +842,7 @@ describe('web e2e: plugin manager', () => {
expect(await panel.getByText(/Cordis|Chrome DevTools/).count()).toBe(0)
await panel.getByRole('button', { name: '更多', exact: true }).click()
await panel.getByRole('heading', { name: '实验性插件', exact: true, level: 1 }).waitFor()
expect(await panel.getByText('查看调试会话原始数据、聊天消息分组数据,以及调试 NodeJS 后端', { exact: true }).count()).toBe(1)
expect(await panel.getByText(experimentalBundleDescription('inspector-profile', 'zh'), { exact: true }).count()).toBe(1)
const bundles = await scaffold.ctx.pluginManager.listBundles()
expect(bundles.some(bundle => bundle.name === '@deepseek-ai/dsh-experimental-terminal-bundle')).toBe(true)
expect(await panel.getByRole('switch', { name: '启用 持久终端', exact: true }).count()).toBe(0)
@@ -1096,7 +1096,7 @@ describe('web e2e: plugin manager', () => {
await panel.getByRole('button', { name: '查看 智能体团队', exact: true }).click()
const packageName = panel.locator('[data-plugin-name]')
expect(await packageName.textContent()).toBe('@deepseek-ai/dsh-experimental-agent-team-profile')
expect(await panel.getByText('启用团队协作、团队工具、成员列表和共享任务看板。').count()).toBe(1)
expect(await panel.getByText(experimentalBundleDescription('agent-team-profile', 'zh')).count()).toBe(1)
const child = panel.locator('[data-plugin-row]', { hasText: 'tool-agent-team' })
await child.getByText('团队工具', { exact: true }).waitFor()
expect(await child.getByText('为智能体提供成员协调、消息通信和共享任务管理工具。', { exact: true }).count()).toBe(1)
@@ -1104,7 +1104,7 @@ describe('web e2e: plugin manager', () => {
await setLanguage('en')
await panel.getByRole('heading', { name: 'Agent teams', exact: true }).waitFor()
expect(await packageName.textContent()).toBe('@deepseek-ai/dsh-experimental-agent-team-profile')
expect(await panel.getByText('Enable team collaboration, team tools, the member roster, and the shared task board.').count()).toBe(1)
expect(await panel.getByText(experimentalBundleDescription('agent-team-profile', 'en')).count()).toBe(1)
await child.getByText('Team tools', { exact: true }).waitFor()
expect(await child.getByText('Give agents tools to coordinate members, exchange messages, and manage shared tasks.', { exact: true }).count()).toBe(1)
await panel.getByRole('button', { name: 'Back to plugins' }).click()
+3 -2
View File
@@ -5,6 +5,7 @@ import { join } from 'node:path'
import { chromium, type Browser } from 'playwright'
import { expect, it, onTestFinished } from 'vitest'
import { compareOrRefreshGolden, launchWebScaffold, seedSession, selectedSessionFixture, watchConsole, webSnapshotMode, type WebScaffold } from './scaffold.ts'
import { experimentalBundleDescription } from './support.ts'
const bundle = fileURLToPath(new URL('../../../packages/experimental/inspector-profile', import.meta.url))
const fixture = fileURLToPath(new URL('../../../snapshots/web/fresh-round-trip/session.v4.jsonl', import.meta.url))
@@ -87,14 +88,14 @@ it('toggles bottom DevTools from the page and iframe without a selected Session'
it.each([
{
locale: 'zh-CN', file: 'zh', plugins: '插件', open: '查看 开发者工具', bundle: '开发者工具',
description: '查看调试会话原始数据、聊天消息分组数据,以及调试 NodeJS 后端',
description: experimentalBundleDescription('inspector-profile', 'zh'),
inspector: 'NodeJS 诊断', inspectorDescription: '按 Ctrl/Cmd+Shift+. 在底部面板打开 Chrome DevTools 进行开发调试',
session: '会话数据诊断', sessionDescription: '在会话侧边栏启用当前会话的原始数据和聊天分组数据分析功能',
openSidebar: '打开右侧边栏', sidebarDescription: '在侧边栏分析当前会话原始日志和聊天分组数据',
},
{
locale: 'en-US', file: 'en', plugins: 'Plugins', open: 'View Developer tools', bundle: 'Developer tools',
description: 'Inspect and debug raw session data, grouped chat messages, and the NodeJS backend.',
description: experimentalBundleDescription('inspector-profile', 'en'),
inspector: 'NodeJS inspector', inspectorDescription: 'Press Ctrl/Cmd+Shift+. to open Chrome DevTools in the bottom panel for development and debugging.',
session: 'Session log', sessionDescription: "Enable analysis of the current session's raw data and grouped chat messages in the session sidebar.",
openSidebar: 'Open right sidebar', sidebarDescription: 'Analyze raw logs and grouped chat messages for the current session in the sidebar.',
+12 -1
View File
@@ -1,5 +1,5 @@
// Shared plumbing for the web smoke tests (dist location, free port, failure shots).
import { existsSync, mkdirSync } from 'node:fs'
import { existsSync, mkdirSync, readFileSync } from 'node:fs'
import { createServer } from 'node:net'
import { createRequire } from 'node:module'
import { join } from 'node:path'
@@ -12,6 +12,17 @@ export const DIST_INDEX = fileURLToPath(new URL('../dist/index.html', import.met
export const REPO_ROOT = fileURLToPath(new URL('../../..', import.meta.url))
/**
* Read the `meta.description` an experimental bundle's plugin page shows for one locale.
* @param bundle - Package directory under `packages/experimental`.
* @param locale - Locale resource name, such as `en` or `zh`.
* @returns The description text from `locale/<locale>.json`.
*/
export function experimentalBundleDescription(bundle: string, locale: string): string {
const resource = JSON.parse(readFileSync(join(REPO_ROOT, 'packages/experimental', bundle, 'locale', `${locale}.json`), 'utf8')) as { meta: { description: string } }
return resource.meta.description
}
const installationRequire = createRequire(join(REPO_ROOT, 'apps/cli/package.json'))
/**
@@ -3,17 +3,17 @@
# After editing either side, bring the other along and re-record with:
# pnpm run verify-translation-pairing --write docs/cookbook/adding-a-plugin-preview.md
/cookbook-add-a-plugin-feature-preview:
en: c37096cd3cdb886c
zh: fc6850d68c638898
en: a0db5c6e164abfa1
zh: 792c831c20a41e5d
/cookbook-add-a-plugin-feature-preview/1-decide-whether-an-image-helps:
en: ee84f52d834cbccf
zh: 7bf3a425a231b5e6
en: 0b401d0094e3b8ae
zh: d9eaedfaf8be012e
/cookbook-add-a-plugin-feature-preview/2-draw-one-fixed-size-svg:
en: 3a28640aa605dce8
zh: c5336958f92b5a70
/cookbook-add-a-plugin-feature-preview/3-put-it-at-the-top-of-the-detail-document:
en: 17e2ace32a89c419
zh: c635a890e86a41ec
/cookbook-add-a-plugin-feature-preview/3-make-it-the-detail-document:
en: ad09702c601e05a6
zh: ae03649d34ab08b1
/cookbook-add-a-plugin-feature-preview/4-page-behavior:
en: 20ce358cb110104c
zh: abb8d72fed81f3c8
+5 -5
View File
@@ -2,11 +2,11 @@
English | [中文](adding-a-plugin-preview.zh.md)
A feature preview is an optional illustration at the top of a bundle's detail document, the long description that its page in **Plugins** shows first. Follow this guide when drawing one for an official bundle. The detail document itself is declared through [`meta.detail`](adding-a-package.md#plugin-display-metadata).
A feature preview is an optional illustration in a bundle's detail document, the document that its page in **Plugins** shows below the description. Follow this guide when drawing one for an official bundle. The detail document itself is declared through [`meta.detail`](adding-a-package.md#plugin-display-metadata).
## 1. Decide whether an image helps
Show one concrete result or recognizable capability. Omit the image when the description is enough: no image is required. Essential instructions stay in the document's text or in configuration outside the illustration.
Show one concrete result or recognizable capability. Omit the image when the description is enough: no image is required. Essential instructions stay in the bundle's description or in configuration outside the illustration.
## 2. Draw one fixed-size SVG
@@ -21,15 +21,15 @@ Show one concrete result or recognizable capability. Omit the image when the des
The SVG is self-contained: no fonts, remote resources, scripts, handlers, animation, stylesheets, `text`, or `foreignObject`. An `image` element may embed an unchanged official PNG/JPEG/WebP brand asset as a base64 data URL. Small plugin icons remain geometry-only. The page renders the SVG through `<img>`. Keep each file small; the Host refuses images above plugin-manager's `detailImageMaxBytes`, 5 MiB by default.
## 3. Put it at the top of the detail document
## 3. Make it the detail document
Save the pair as `docs/preview.svg` and `docs/preview.zh.svg` in the bundle package, beside `docs/DETAIL.md` and `docs/DETAIL.zh.md`, and make the image the first line of each document:
Save the pair as `docs/preview.svg` and `docs/preview.zh.svg` in the bundle package, beside `docs/DETAIL.md` and `docs/DETAIL.zh.md`, and make the image the only line of each document:
```markdown
![Example feature preview](preview.svg)
```
The Chinese document references `preview.zh.svg` with Chinese alternative text. Use the [badge skill](../../packages/experimental/badge-skill-bundle/docs/DETAIL.md) and [voice input](../../packages/experimental/voice-input-bundle/docs/DETAIL.md) documents as examples. The voice transcript is explanatory sample content, not a recording result.
The Chinese document references `preview.zh.svg` with Chinese alternative text. Use the [badge skill](../../packages/experimental/badge-skill-bundle/docs/DETAIL.md) and [voice input](../../packages/experimental/voice-input-bundle/docs/DETAIL.md) documents as examples. The voice transcript is explanatory sample content, not a recording result. Describe what the bundle does and how to use it, at the level of behavior, in `meta.description`, which the page shows above the image.
## 4. Page behavior
+5 -5
View File
@@ -2,11 +2,11 @@
[English](adding-a-plugin-preview.md) | 中文
功能配图是位于组合包详细介绍文档顶部的可选插图;详细介绍文档是该组合包在**插件**中的页面最先显示的长描述。为官方组合包绘制配图时遵循本指引。详细介绍文档本身通过 [`meta.detail`](adding-a-package.zh.md#plugin-display-metadata) 声明。
功能配图是组合包详细介绍文档中的可选插图;详细介绍文档是该组合包在**插件**中的页面显示在描述下方的文档。为官方组合包绘制配图时遵循本指引。详细介绍文档本身通过 [`meta.detail`](adding-a-package.zh.md#plugin-display-metadata) 声明。
## 1. 判断是否需要配图
展示一个具体结果或容易辨认的能力。文字说明足够时省略配图:配图不是必需的。必要操作说明仍放在文档文字或图外的配置中。
展示一个具体结果或容易辨认的能力。文字说明足够时省略配图:配图不是必需的。必要操作说明仍放在组合包描述或图外的配置中。
## 2. 绘制一张固定尺寸 SVG
@@ -21,15 +21,15 @@
SVG 必须自包含:不使用字体、远程资源、脚本、事件处理器、动画、样式表、`text` 或 `foreignObject`。`image` 元素可以通过 base64 data URL 嵌入未改动的官方 PNG/JPEG/WebP 品牌素材。小插件图标仍仅使用几何图形。页面通过 `<img>` 渲染 SVG。每个文件都应控制大小;Host 会拒绝超过 plugin-manager 的 `detailImageMaxBytes`(默认 5 MiB)的图片。
## 3. 放在详细介绍文档顶部
## 3. 用它作为详细介绍文档
将这对文件保存为组合包中的 `docs/preview.svg` 和 `docs/preview.zh.svg`,与 `docs/DETAIL.md` 和 `docs/DETAIL.zh.md` 放在一起,并把图片作为每份文档的第一行:
将这对文件保存为组合包中的 `docs/preview.svg` 和 `docs/preview.zh.svg`,与 `docs/DETAIL.md` 和 `docs/DETAIL.zh.md` 放在一起,并把图片作为每份文档唯一的一行:
```markdown
![Example feature preview](preview.svg)
```
中文文档引用 `preview.zh.svg`,并使用中文替代文字。可参考[徽章技能](../../packages/experimental/badge-skill-bundle/docs/DETAIL.md)和[语音输入](../../packages/experimental/voice-input-bundle/docs/DETAIL.md)文档。语音图中的转写文字是说明性示例,不是录音结果。
中文文档引用 `preview.zh.svg`,并使用中文替代文字。可参考[徽章技能](../../packages/experimental/badge-skill-bundle/docs/DETAIL.md)和[语音输入](../../packages/experimental/voice-input-bundle/docs/DETAIL.md)文档。语音图中的转写文字是说明性示例,不是录音结果。组合包做什么、怎么用,按行为层面写在 `meta.description` 中,页面将其显示在配图上方。
## 4. 页面行为
@@ -1,18 +1 @@
![A conversation titled Add rate limiting with its Agent team button, and the panel it opens: two members and two shared tasks](preview.svg)
Ask the agent you are talking to, the lead, to split a job. It creates named teammates, puts the work on a shared task board, waits for their results, and reports back.
## How to use
- Ask in plain words, for example: "Use agent teams to split this task between two teammates, wait, and summarize."
- Click **Agent team** next to the conversation title to see **Members** and **Shared tasks**. Each task shows its status, **Owner**, **Write scopes**, and the tasks it is **Blocked by**.
- Click a teammate to open its conversation and talk to it there.
- The panel is read-only. To change tasks or teammates, ask the lead.
## Good to know
- Each teammate is a separate agent with its own model requests, so a team uses more tokens than one agent.
- Teammates share the same files. Overlapping **Write scopes** only show a warning; nothing stops two teammates from editing the same file.
- A team can create at most 8 teammates in total, including ones that failed to start, and hold at most 256 tasks; deleting a task frees a slot.
- While the plugin is on, the ordinary subagent tools are off and agents delegate through the team; workflows still start one-shot agents. Turning the plugin off restores the subagent tools.
- After turning it on with a conversation open, reload the page to see the panel.
@@ -1,18 +1 @@
![标题为“添加限流”的会话及其“智能体团队”按钮,以及它打开的面板:两名成员和两个共享任务](preview.zh.svg)
让与你对话的智能体(即负责人)拆分一项工作。它会创建有名字的队友,把工作放到共享任务看板上,等待他们的结果,再向你汇报。
## 使用方法
- 用平常的话提出要求,例如:「用智能体团队把这个任务分给两名队友,等他们完成后汇总结果。」
- 点击对话标题旁的 **智能体团队**,查看 **成员** 和 **共享任务**。每个任务显示状态、**Owner**、**写入范围**,以及它的 **依赖**。
- 点击一名队友可打开它的对话,并在那里与它交谈。
- 面板是只读的。如需修改任务或队友,请告诉负责人。
## 注意事项
- 每名队友都是独立的智能体,各自发起模型请求,因此团队比单个智能体消耗更多 token。
- 队友们共用同一批文件。**写入范围** 重叠时只显示警告,不会阻止两名队友修改同一个文件。
- 一个团队总共最多创建 8 名队友(包括启动失败的队友),最多保有 256 个任务;删除任务会空出一个名额。
- 启用此插件后,普通的子智能体工具会关闭,智能体通过团队分派工作;工作流仍可启动一次性智能体。关闭此插件后,子智能体工具会恢复。
- 如果在对话打开时启用此插件,请刷新页面以显示团队面板。
@@ -1,7 +1,7 @@
{
"meta": {
"title": "Agententeams",
"description": "Aktivieren Sie Teamzusammenarbeit, Teamtools, die Mitgliederliste und das gemeinsame Aufgabenboard.",
"description": "Ermöglicht dem Agenten, mit dem Sie sprechen, eine Aufgabe auf benannte Teammitglieder aufzuteilen, sie auf einem gemeinsamen Aufgabenboard zu verfolgen und Ihnen mit deren Ergebnissen zu berichten.",
"detail": "docs/DETAIL.md"
}
}
@@ -1,7 +1,7 @@
{
"meta": {
"title": "Agent teams",
"description": "Enable team collaboration, team tools, the member roster, and the shared task board.",
"description": "Lets the agent you talk to split a job among named teammates, track it on a shared task board, and report back with their results.",
"detail": "docs/DETAIL.md"
}
}
@@ -1,7 +1,7 @@
{
"meta": {
"title": "Equipos de agentes",
"description": "Habilite la colaboración en equipo, las herramientas del equipo, la lista de miembros y el tablero de tareas compartido.",
"description": "Permite que el agente con el que habla reparta un trabajo entre compañeros con nombre, lo siga en un tablero de tareas compartido y le informe con sus resultados.",
"detail": "docs/DETAIL.md"
}
}
@@ -1,7 +1,7 @@
{
"meta": {
"title": "Équipes d'agents",
"description": "Activez la collaboration en équipe, les outils d’équipe, la liste des membres et le tableau des tâches partagé.",
"description": "Permet à l'agent avec lequel vous parlez de répartir un travail entre des coéquipiers nommés, de le suivre sur un tableau de tâches partagé et de vous rendre compte de leurs résultats.",
"detail": "docs/DETAIL.md"
}
}
@@ -1,7 +1,7 @@
{
"meta": {
"title": "エージェントチーム",
"description": "チーム連携、チームツール、メンバー一覧、共有タスクボードを有効にします。",
"description": "対話しているエージェントが、仕事を名前付きのチームメイトに分担させ、共有タスクボードで進捗を追跡し、チームメイトの結果をまとめて報告します。",
"detail": "docs/DETAIL.md"
}
}
@@ -1,7 +1,7 @@
{
"meta": {
"title": "Equipes de agentes",
"description": "Habilite a colaboração em equipe, as ferramentas da equipe, a lista de membros e o quadro de tarefas compartilhado.",
"description": "Permite que o agente com quem você conversa divida um trabalho entre colegas de equipe nomeados, acompanhe-o em um quadro de tarefas compartilhado e informe você com os resultados deles.",
"detail": "docs/DETAIL.md"
}
}
@@ -1,7 +1,7 @@
{
"meta": {
"title": "Команды агентов",
"description": "Включите совместную работу в команде, инструменты группы, список участников и общую доску задач.",
"description": "Позволяет агенту, с которым вы общаетесь, распределить работу между именованными участниками команды, отслеживать её на общей доске задач и отчитываться перед вами об их результатах.",
"detail": "docs/DETAIL.md"
}
}
@@ -1,7 +1,7 @@
{
"meta": {
"title": "智能体团队",
"description": "启用团队协作、团队工具、成员列表和共享任务看板。",
"description": "让与你对话的智能体把工作分给有名字的队友,在共享任务看板上跟踪进度,并汇总队友的结果向你汇报。",
"detail": "docs/DETAIL.zh.md"
}
}
@@ -1,17 +1 @@
![Auto review chosen in the access mode menu, and an approval request for a call it denied](preview.svg)
The review checks each call against what you asked for. Allowed calls run at once with full access; denied calls wait for you.
## How to use
- In the message box, open the access mode menu, choose **Auto review**, and confirm with **Enable Auto review**, or type `/permission auto`. It applies to the current session only.
- Name the action and its target. Ordinary project work is allowed. Deleting existing data, force pushes, production access, external writes, and security changes need your explicit request. Sending secrets or private data outside is always denied. Project files and tool results cannot grant permission.
- For a denied call, **Waiting for approval** shows the reason. Choose **Reject** or **Allow once**. In an in-process subagent, a denial is final.
## Good to know
- Auto review is experimental. It can allow an unsafe action or deny useful work.
- Allowed calls run without a sandbox, with full access to your computer.
- In **PTC mode**, each tool call the program makes is reviewed, but not the program itself or its own file and process operations.
- Each review is one extra model request that includes your messages, project instructions, earlier tool calls, and the pending call.
- Turning this plugin off switches live Auto review sessions to **Full access**. A saved session left in Auto review opens only while the plugin is on.
@@ -1,17 +1 @@
![在访问模式菜单中选择自动审查,以及被它拒绝的调用等待审批](preview.zh.svg)
审查会对照你的要求检查每次调用。获准的调用以完全权限立即运行;被拒绝的调用等你决定。
## 使用方法
- 在消息框中打开访问模式菜单,选择 **自动审查**,再点击 **启用自动审查** 确认;也可以输入 `/permission auto`。它只对当前会话生效。
- 说明要做的操作和对象。普通的项目内工作会被允许。删除已有数据、强制推送、访问生产环境、向外部写入以及修改安全设置,都需要你明确提出。把密钥或隐私数据发往外部的操作一律拒绝。项目文件和工具结果不能授予权限。
- 调用被拒绝时,**等待审批** 中会显示原因。选择 **拒绝** 或 **允许一次**。在进程内子智能体中,拒绝即为最终结果。
## 注意事项
- 自动审查是实验性功能,可能放行不安全的操作,也可能拒绝有用的工作。
- 获准的调用在沙箱之外运行,对你的计算机拥有完全权限。
- 在 **PTC 模式** 下,程序发起的每个工具调用都会被审查,但程序本身及其自身的文件和进程操作不会被审查。
- 每次审查都是一次额外的模型请求,其中包含你的消息、项目指令、此前的工具调用以及待执行的调用。
- 关闭此插件后,处于自动审查的活跃会话会切换为 **完全权限**。停留在自动审查的已保存会话只有在此插件开启时才能打开。
@@ -1,7 +1,7 @@
{
"meta": {
"title": "Automatische Autorisierungsüberprüfung",
"description": "Fügen Sie einen Auto review-Berechtigungsmodus hinzu, der das Modell verwendet, um die Autorisierung vor jedem Toolaufruf zu bewerten.",
"description": "Fügt den Zugriffsmodus „Auto review“ hinzu: Vor jedem Tool-Aufruf prüft ein Modell den Aufruf anhand Ihrer Anforderung; zugelassene Aufrufe laufen sofort, abgelehnte Aufrufe warten auf Ihre Genehmigung.",
"detail": "docs/DETAIL.md"
}
}
@@ -1,7 +1,7 @@
{
"meta": {
"title": "Auto authorization review",
"description": "Add an Auto review permission mode that uses the model to assess authorization before each tool call.",
"description": "Adds an Auto review access mode: before each tool call, a model checks it against what you asked for, runs allowed calls at once, and holds denied calls for your approval.",
"detail": "docs/DETAIL.md"
}
}
@@ -1,7 +1,7 @@
{
"meta": {
"title": "Revisión de autorización automática",
"description": "Agregue un modo de permiso Auto review que utilice el modelo para evaluar la autorización antes de cada llamada a la herramienta.",
"description": "Añade el modo de acceso “Auto review”: antes de cada llamada a una herramienta, un modelo comprueba la llamada frente a lo que usted pidió; las llamadas permitidas se ejecutan de inmediato y las denegadas esperan su aprobación.",
"detail": "docs/DETAIL.md"
}
}
@@ -1,7 +1,7 @@
{
"meta": {
"title": "Examen des autorisations automatiques",
"description": "Ajoutez un mode d'autorisation Auto review qui utilise le modèle pour évaluer l'autorisation avant chaque appel d'outil.",
"description": "Ajoute le mode d'accès « Auto review » : avant chaque appel d'outil, un modèle vérifie l'appel par rapport à ce que vous avez demandé ; les appels autorisés s'exécutent immédiatement et les appels refusés attendent votre approbation.",
"detail": "docs/DETAIL.md"
}
}
@@ -1,7 +1,7 @@
{
"meta": {
"title": "自動認可レビュー",
"description": "各ツール呼び出しの前にモデルが認可を判断する、自動認可レビュー権限モードを提供します。",
"description": "「自動認可レビュー」アクセスモードを追加します。各ツール呼び出しの前に、モデルがその呼び出しをあなたの依頼内容と照らし合わせて確認し、許可された呼び出しは即座に実行され、拒否された呼び出しはあなたの承認を待ちます。",
"detail": "docs/DETAIL.md"
}
}
@@ -1,7 +1,7 @@
{
"meta": {
"title": "Revisão de autorização automática",
"description": "Adicione um modo de permissão Auto review que usa o modelo para avaliar a autorização antes de cada chamada de ferramenta.",
"description": "Adiciona o modo de acesso “Auto review”: antes de cada chamada de ferramenta, um modelo verifica a chamada em relação ao que você pediu; as chamadas permitidas são executadas imediatamente e as negadas aguardam sua aprovação.",
"detail": "docs/DETAIL.md"
}
}
@@ -1,7 +1,7 @@
{
"meta": {
"title": "Проверка автоматической авторизации",
"description": "Добавьте режим разрешений Auto review, который использует модель для оценки авторизации перед каждым вызовом инструмента.",
"description": "Добавляет режим доступа «Auto review»: перед каждым вызовом инструмента модель сверяет вызов с вашей просьбой; разрешённые вызовы выполняются сразу, а отклонённые ждут вашего одобрения.",
"detail": "docs/DETAIL.md"
}
}
@@ -1,7 +1,7 @@
{
"meta": {
"title": "自动授权审查",
"description": "提供自动审查权限模式,由模型在每次工具调用前判断是否授权。",
"description": "提供“自动审查”访问模式:每次工具调用前,由模型对照你的要求检查,获准的调用立即运行,被拒绝的调用等你审批。",
"detail": "docs/DETAIL.zh.md"
}
}
@@ -1,18 +1 @@
![An expanded Think row translated from Chinese into English, with a View original button](preview.svg)
Expand a **Think** row to read its reasoning in your interface language. Paragraphs are translated as the agent writes them; the newest text stays in the original language until it can be translated.
## How to use
- Expand a **Think** row. Click **View original** to see the source text, and **View translation** to switch back.
- On this plugin's page, choose a **Translation service** and a **Target language**, then click **Save**. `auto` follows the interface language; codes such as `zh`, `en`, and `ja` also work.
- If a translation fails, the original stays visible with **Retry**.
## Good to know
- The reasoning you expand can contain your code and conversation details.
- Bing is the default; Google is also available. Neither needs an account or API key, but neither guarantees availability or a free quota.
- With a DeepSeek account or official API set up, **DeepSeek Flash — account (paid)** and **DeepSeek Flash — official API (paid)** also appear. Each text piece without a saved translation is then a paid request.
- Translations are saved in the session and reused when you reopen it. The original reasoning and the model's input stay unchanged.
- Collapsed summaries stay in the original language. Translation can change Markdown formatting or code.
- Turning the plugin off removes its buttons and cancels pending translations; saved translations stay in the session.
@@ -1,18 +1 @@
![展开的思考行从英文翻译成中文,并显示“查看原文”按钮](preview.zh.svg)
展开 **思考** 行,即可用界面语言阅读其中的思考内容。智能体输出时会逐段翻译;最新的内容在能够翻译之前保持原文。
## 使用方法
- 展开 **思考** 行。点击 **查看原文** 显示原文,点击 **查看译文** 切换回译文。
- 在此插件的页面中选择 **翻译服务** 和 **目标语言**,然后点击 **保存**。`auto` 表示跟随界面语言;也可以填写 `zh`、`en`、`ja` 等语言代码。
- 翻译失败时,原文保持显示,并提供 **重试**。
## 注意事项
- 你展开的思考内容可能包含你的代码和对话细节。
- 默认使用 Bing,也可以选择 Google。两者都无需账号或 API key,但都不保证可用,也不保证免费额度。
- 如果已配置 DeepSeek 账号或官方 API,还会出现 **DeepSeek Flash · 账号(付费)** 和 **DeepSeek Flash · 官方 API(付费)**。此时每段没有已保存译文的内容都是一次付费请求。
- 译文保存在会话中,重新打开时直接复用。原始思考内容和模型的输入都不会改变。
- 折叠时显示的摘要保持原文。翻译可能改变 Markdown 格式或代码。
- 关闭此插件会移除它的按钮并取消未完成的翻译;已保存的译文仍保留在会话中。
@@ -1,7 +1,7 @@
{
"meta": {
"title": "Maschinelle Übersetzung der Argumentation",
"description": "Maschinelle Übersetzung erweiterter Argumentation; Der Quelltext wird an den ausgewählten Dienst gesendet.",
"description": "Übersetzt aufgeklappte „Denken Sie nach“-Zeilen, während der Agent sie schreibt, in die von Ihnen gewählte Sprache, und „Original ansehen“ wechselt zurück.",
"detail": "docs/DETAIL.md"
}
}
@@ -1,7 +1,7 @@
{
"meta": {
"title": "Machine translation of reasoning",
"description": "Machine translation of expanded reasoning; source text is sent to the selected service.",
"description": "Translates expanded Think rows into your chosen language as the agent writes them, and View original switches back.",
"detail": "docs/DETAIL.md"
}
}
@@ -1,7 +1,7 @@
{
"meta": {
"title": "Traducción automática de razonamiento",
"description": "Traducción automática de razonamiento ampliado; El texto fuente se envía al servicio seleccionado.",
"description": "Traduce las filas “pensar” expandidas al idioma que elija mientras el agente las escribe, y “Ver original” vuelve al texto original.",
"detail": "docs/DETAIL.md"
}
}
@@ -1,7 +1,7 @@
{
"meta": {
"title": "Traduction automatique du raisonnement",
"description": "Traduction automatique d'un raisonnement élargi ; le texte source est envoyé au service sélectionné.",
"description": "Traduit les lignes « Pensez » développées dans la langue de votre choix pendant que l'agent les écrit, et « Voir l'original » permet de revenir au texte d'origine.",
"detail": "docs/DETAIL.md"
}
}
@@ -1,7 +1,7 @@
{
"meta": {
"title": "思考内容の機械翻訳",
"description": "展開した思考内容を機械翻訳します。原文は選択したサービスに送信されます。",
"description": "エージェントが書き出すのと同時に、展開された「思考」行を選択した言語に翻訳します。「原文を表示」で原文に戻せます。",
"detail": "docs/DETAIL.md"
}
}
@@ -1,7 +1,7 @@
{
"meta": {
"title": "Tradução automática de raciocínio",
"description": "Tradução automática de raciocínio expandido; o texto fonte é enviado ao serviço selecionado.",
"description": "Traduz as linhas “Pense” expandidas para o idioma que você escolher enquanto o agente as escreve, e “Ver original” volta ao texto original.",
"detail": "docs/DETAIL.md"
}
}
@@ -1,7 +1,7 @@
{
"meta": {
"title": "Машинный перевод рассуждений",
"description": "Машинный перевод развернутых рассуждений; исходный текст отправляется в выбранный сервис.",
"description": "Переводит развёрнутые строки «Подумайте» на выбранный вами язык по мере того, как агент их пишет, а «Посмотреть оригинал» возвращает исходный текст.",
"detail": "docs/DETAIL.md"
}
}
@@ -1,7 +1,7 @@
{
"meta": {
"title": "思考过程机器翻译",
"description": "机器翻译展开的思考内容;原文会发送给所选服务",
"description": "智能体输出时,把展开的“思考”行翻译成你选择的语言,点击“查看原文”可切换回原文。",
"detail": "docs/DETAIL.zh.md"
}
}
@@ -1,16 +1 @@
![Session log table in the sidebar and the NodeJS inspector console](preview.svg)
Use it when troubleshooting: check exactly what DSH recorded for a session, or debug DSH itself in Chrome DevTools. It does not change how the agent works.
## How to use
- In the right sidebar, click **+** (**New tab**), then choose **Session log** on the **Start** page that opens.
- **Raw log** lists the session's events grouped by turn and step; click a row to see its full data. Switch the selector to **Chat group** to see the chat messages and their groups instead.
- Click the crosshair button next to the selector, then click a message in the chat to find its record. Press Esc to cancel.
- Press **Ctrl+Shift+.** (**Cmd+Shift+.** on macOS) to open or collapse **NodeJS inspector** at the bottom of the window: Chrome DevTools, in English, connected to the DSH backend.
## Good to know
- Neither view sends anything to the model or uses tokens.
- While this plugin is on, DSH keeps in memory the network requests its backend sends, such as model API calls: full URLs, request and response headers, and bodies up to a size limit, without hiding API keys or cookies. This uses extra memory.
- The debugging endpoint on 127.0.0.1 has no password: any program on this computer can connect to it and run code inside DSH. Turn the plugin off when you are not debugging; this stops the recording and closes the endpoint.
@@ -1,16 +1 @@
![侧边栏中的会话数据诊断表格和 NodeJS 诊断控制台](preview.zh.svg)
排查问题时使用:准确查看 DSH 为一个会话记录了什么,或在 Chrome DevTools 中调试 DSH 本身。它不会改变智能体的工作方式。
## 使用方法
- 在右侧栏点击 **+**(**新标签页**),然后在打开的 **开始** 页中选择 **会话数据诊断**。
- **原始数据** 按轮次和步骤分组列出会话的事件,点击一行可查看完整数据。将选择器切换为 **对话分组**,可改为查看聊天消息及其分组。
- 点击选择器旁的准星按钮,再点击对话中的一条消息,即可找到它对应的记录。按 Esc 取消。
- 按 **Ctrl+Shift+.**(macOS 上为 **Cmd+Shift+.**)可在窗口底部展开或收起 **NodeJS 诊断**:它是连接到 DSH 后端的 Chrome DevTools,界面为英文。
## 注意事项
- 这两个视图都不会向模型发送内容,也不消耗 token。
- 启用此插件后,DSH 会在内存中保留其后端发出的网络请求(例如模型 API 调用):完整 URL、请求头和响应头,以及不超过大小上限的请求体和响应体,不会隐藏 API key 或 cookie。这会占用额外内存。
- 127.0.0.1 上的调试端点没有密码:这台计算机上的任何程序都可以连接它,并在 DSH 内部运行代码。不调试时请关闭此插件,这会停止记录并关闭该端点。
@@ -1,7 +1,7 @@
{
"meta": {
"title": "Entwicklertools",
"description": "Untersuchen und debuggen Sie rohe Sitzungsdaten, gruppierte Chat-Nachrichten und das NodeJS-Backend.",
"description": "Zur Fehlersuche: Sehen Sie in „Sitzungsprotokoll“, was DSH für eine Sitzung aufgezeichnet hat, und debuggen Sie das DSH-Backend in Chrome DevTools.",
"detail": "docs/DETAIL.md"
}
}
@@ -1,7 +1,7 @@
{
"meta": {
"title": "Developer tools",
"description": "Inspect and debug raw session data, grouped chat messages, and the NodeJS backend.",
"description": "For troubleshooting: view what DSH recorded for a session in Session log, and debug the DSH backend in Chrome DevTools.",
"detail": "docs/DETAIL.md"
}
}
@@ -1,7 +1,7 @@
{
"meta": {
"title": "Herramientas de desarrollador",
"description": "Inspeccione y depure datos de sesión sin procesar, mensajes de chat agrupados y el backend NodeJS.",
"description": "Para solucionar problemas: vea en “Registro de sesión” lo que DSH registró de una sesión y depure el backend de DSH en Chrome DevTools.",
"detail": "docs/DETAIL.md"
}
}
@@ -1,7 +1,7 @@
{
"meta": {
"title": "Outils de développement",
"description": "Inspectez et déboguez les données brutes de session, les messages de discussion groupés et le backend NodeJS.",
"description": "Pour le dépannage : consultez dans « Journal de session » ce que DSH a enregistré pour une session, et déboguez le backend de DSH dans Chrome DevTools.",
"detail": "docs/DETAIL.md"
}
}
@@ -1,7 +1,7 @@
{
"meta": {
"title": "開発者ツール",
"description": "セッションの生データ、グループ化されたチャットメッセージ、NodeJS バックエンドを確認、デバッグします。",
"description": "トラブルシューティング用です。「セッションログ」で DSH がセッションについて記録した内容を確認し、Chrome DevTools で DSH バックエンドをデバッグできます。",
"detail": "docs/DETAIL.md"
}
}
@@ -1,7 +1,7 @@
{
"meta": {
"title": "Ferramentas de desenvolvedor",
"description": "Inspecione e depure dados brutos da sessão, mensagens de bate-papo agrupadas e o back-end NodeJS.",
"description": "Para solução de problemas: veja em “Registro da sessão” o que o DSH registrou de uma sessão e depure o backend do DSH no Chrome DevTools.",
"detail": "docs/DETAIL.md"
}
}
@@ -1,7 +1,7 @@
{
"meta": {
"title": "Инструменты разработчика",
"description": "Проверяйте и отлаживайте необработанные данные сеанса, сгруппированные сообщения чата и серверную часть NodeJS.",
"description": "Для диагностики: просматривайте в «Журнале сеанса», что DSH записал для сеанса, и отлаживайте бэкенд DSH в Chrome DevTools.",
"detail": "docs/DETAIL.md"
}
}
@@ -1,7 +1,7 @@
{
"meta": {
"title": "开发者工具",
"description": "查看调试会话原始数据、聊天消息分组数据,以及调试 NodeJS 后端",
"description": "用于排查问题:在“会话数据诊断”中查看 DSH 为会话记录的内容,并在 Chrome DevTools 中调试 DSH 后端。",
"detail": "docs/DETAIL.zh.md"
}
}
@@ -1,18 +1 @@
![The Discover tab listing plugins from an added plugin index](preview.svg)
A plugin index is a file at a URL that lists plugins. Add the URL, and its plugins appear in **Discover**, where you can browse and install them. DSH comes with no index; you choose which indexes to add.
## How to use
- Open **Plugins**, select **Discover**, click **Add index source**, enter the **Index URL**, and click **Add**. To add another index later, open the index menu and choose **Manage index sources…**.
- Click a plugin to read its details, then click **Install** and confirm.
- A plugin you have shows **Installed**, or **Update available** when the index recommends a newer version; click it to open the plugin under **Installed**.
## Good to know
- DSH contacts an index only after you add it.
- Plugins in an index come from third parties and run with your permissions. Add only indexes you trust.
- To update a plugin installed from npm, use **Update** in its **Versions** section under **Installed**; installing another npm version from the index fails until you uninstall it. A plugin installed from Git has no **Versions** section; to change its version, uninstall it and install it again from the index.
- Plugin details come from public npm file services (jsDelivr, unpkg, npmmirror) or the plugin's Git repository, with your Git credentials for private ones. Icons load directly from the addresses in the index, so those servers see your IP address.
- In **Creator mode**, the agent also gets a read-only `plugin_market` tool, which adds a few tokens to each request.
- Turning this off removes **Discover** and the `plugin_market` tool; your index sources and installed plugins stay.
@@ -1,18 +1 @@
![「发现」标签页列出已添加的插件索引中的插件](preview.zh.svg)
插件索引以一个索引文件的 URL 提供,索引中列出插件。添加这个 URL 后,其中的插件会出现在 **发现** 中,你可以在那里浏览和安装。DSH 不自带插件索引,由你选择添加哪些索引。
## 使用方法
- 打开 **插件**,选择 **发现**,点击 **添加索引源**,输入 **索引 URL**,然后点击 **添加**。之后要添加其他插件索引,请打开插件索引菜单并选择 **管理索引源…**。
- 点击一个插件可阅读它的详细介绍,然后点击 **安装** 并确认。
- 已安装的插件会显示 **已安装**;当插件索引推荐更新的版本时显示 **有新版本**。点击它可在 **已安装** 中打开该插件。
## 注意事项
- 只有在你添加插件索引之后,DSH 才会连接它。
- 插件索引中的插件来自第三方,并以你的权限运行。只添加你信任的插件索引。
- 要更新从 npm 安装的插件,请在 **已安装** 中该插件的 **版本** 区域使用 **更新**;卸载之前,从插件索引安装另一个 npm 版本会失败。从 Git 安装的插件没有 **版本** 区域;要更换它的版本,请先卸载,再从插件索引重新安装。
- 插件的详细介绍来自公共 npm 文件服务(jsDelivr、unpkg、npmmirror)或插件的 Git 仓库,读取私有仓库时使用你的 Git 凭据。图标直接从索引中给出的地址加载,因此这些服务器会看到你的 IP 地址。
- 在 **创造模式** 下,智能体还会获得只读的 `plugin_market` 工具,这会让每次请求多消耗少量 token。
- 关闭此插件会移除 **发现** 和 `plugin_market` 工具;你的索引源和已安装的插件都会保留。
@@ -1,7 +1,7 @@
{
"meta": {
"title": "Benutzerdefinierte Plugin-Indizes",
"description": "Fügt Plugins die Registerkarte „Entdecken“ hinzu, um Bundles aus hinzugefügten Plugin-Indizes zu durchsuchen und zu installieren.",
"description": "Fügt unter „Plugins“ den Tab „Entdecken“ hinzu, in dem Sie Plugins aus von Ihnen hinzugefügten Plugin-Indizes durchsuchen und installieren.",
"detail": "docs/DETAIL.md"
}
}
@@ -1,7 +1,7 @@
{
"meta": {
"title": "Custom plugin indexes",
"description": "Adds a Discover tab to Plugins for browsing and installing bundles from plugin indexes you add.",
"description": "Adds a Discover tab to Plugins, where you browse and install plugins from plugin indexes you add.",
"detail": "docs/DETAIL.md"
}
}
@@ -1,7 +1,7 @@
{
"meta": {
"title": "Índices de complementos personalizados",
"description": "Agrega una pestaña Descubrir a Complementos para explorar e instalar paquetes desde los índices de complementos que agregue.",
"description": "Añade la pestaña “Descubrir” a “Complementos”, donde puede explorar e instalar complementos de los índices de complementos que agregue.",
"detail": "docs/DETAIL.md"
}
}
@@ -1,7 +1,7 @@
{
"meta": {
"title": "Index de plugins personnalisés",
"description": "Ajoute un onglet Découvrir à Plugins pour parcourir et installer des bundles depuis les index de plugins que vous ajoutez.",
"description": "Ajoute à « Plugins » un onglet « Découvrez » où vous parcourez et installez des plugins provenant des index de plugins que vous ajoutez.",
"detail": "docs/DETAIL.md"
}
}
@@ -1,7 +1,7 @@
{
"meta": {
"title": "カスタムプラグインインデックス",
"description": "プラグインページに「見つける」タブを追加し、登録したプラグインインデックスからプラグインを参照、インストールします。",
"description": "「プラグイン」に「見つける」タブを追加し、追加したプラグインインデックスからプラグインを閲覧・インストールできるようにします。",
"detail": "docs/DETAIL.md"
}
}
@@ -1,7 +1,7 @@
{
"meta": {
"title": "Índices de plug-ins personalizados",
"description": "Adiciona uma guia Descobrir a Plug-ins para navegar e instalar pacotes dos índices de plug-ins que você adicionar.",
"description": "Adiciona a guia “Descubra” a “Plug-ins”, onde você navega e instala plug-ins dos índices de plug-ins que adiciona.",
"detail": "docs/DETAIL.md"
}
}
@@ -1,7 +1,7 @@
{
"meta": {
"title": "Пользовательские индексы плагинов",
"description": "Добавляет вкладку «Обнаружение» в раздел «Плагины» для просмотра и установки пакетов из добавленных вами индексов плагинов.",
"description": "Добавляет в «Плагины» вкладку «Откройте для себя», где можно просматривать и устанавливать плагины из добавленных вами индексов плагинов.",
"detail": "docs/DETAIL.md"
}
}
@@ -1,7 +1,7 @@
{
"meta": {
"title": "自定义插件索引",
"description": "在插件页添加「发现」标签页,从你添加的插件索引浏览和安装插件。",
"description": "在插件页添加“发现”标签页,从你添加的插件索引中浏览和安装插件。",
"detail": "docs/DETAIL.zh.md"
}
}
@@ -36,8 +36,8 @@
en: 64cc3b2eff7bec02
zh: 9f5bab103219e352
/deepseek-ai-dsh-plugin-recommendations/model-experience/official-plugin-recommendations/token-effect:
en: 2d88ac78f2ad5ea7
zh: c4d3ac643cf723b1
en: b70f0604f4a70ef9
zh: e369c6a42092f9c4
/deepseek-ai-dsh-plugin-recommendations/model-experience/official-plugin-recommendations/kv-cache-effect:
en: e6575a3adcaa7d1c
zh: e5323a4571ecc8aa
@@ -73,7 +73,7 @@ The existing `skill` tool loads `official-plugins` when the user asks how to do
#### Token effect
While enabled, requests carry only the 495-character catalog entry, within the skill catalog's 500-character limit; the shared card tool is declared only after a card skill loads. A skill load appends about 20.9K characters: a 2.9K-character policy plus the catalog, about 17.7K characters for 14 eligible plugins with titles and descriptions in the eight shipped languages, growing with their number. A recommendation needs one skill load and one `propose_action` call before the final answer; the accepted call's result is 169 characters, about 42 tokens at four characters per token. A changed card appends one short status notice to the next request.
While enabled, requests carry only the 495-character catalog entry, within the skill catalog's 500-character limit; the shared card tool is declared only after a card skill loads. A skill load appends about 26K characters: a 2.9K-character policy plus the catalog, about 22.9K characters for 14 eligible plugins with titles and descriptions in the eight shipped languages, growing with their number. A recommendation needs one skill load and one `propose_action` call before the final answer; the accepted call's result is 169 characters, about 42 tokens at four characters per token. A changed card appends one short status notice to the next request.
#### KV Cache effect
@@ -73,7 +73,7 @@ Host 入口是函数插件。它的 `apply` 通过 `ctx.plugin` 组装内部的
#### Token 影响
启用期间,每次请求只多一条 495 字符的目录条目(在 skill 目录 500 字符的上限内);共享的卡片工具只在加载过卡片 skill 之后才声明。一次 skill 加载追加约 20.9K 字符:2.9K 字符的规则,加上目录;14 个可推荐插件(标题和描述含 8 种发布语言)时目录约 17.7K 字符,并随插件数量增长。一次推荐需要加载一次 skill,并在最终回答前调用一次 `propose_action`;被接受的调用结果 169 字符,按每 4 字符 1 个 token 计约 42 个 token。状态变化的卡片会在下一次请求追加一条简短通知。
启用期间,每次请求只多一条 495 字符的目录条目(在 skill 目录 500 字符的上限内);共享的卡片工具只在加载过卡片 skill 之后才声明。一次 skill 加载追加约 26K 字符:2.9K 字符的规则,加上目录;14 个可推荐插件(标题和描述含 8 种发布语言)时目录约 22.9K 字符,并随插件数量增长。一次推荐需要加载一次 skill,并在最终回答前调用一次 `propose_action`;被接受的调用结果 169 字符,按每 4 字符 1 个 token 计约 42 个 token。状态变化的卡片会在下一次请求追加一条简短通知。
#### KV Cache 影响
@@ -1,17 +1 @@
![A Ralph loop that ran three rounds with fresh agents until the last round reported the goal met](preview.svg)
Ask for a Ralph loop with a goal, and the agent starts a fresh agent on it, round after round, until a round reports the goal met or a blocker, or the round limit is reached. Each round sees only the goal, the workspace files, and the last round's short report, not the conversation.
## How to use
- Say "Ralph loop" and give a goal that can be checked from the files, for example: "Run a Ralph loop until pnpm lint passes with zero warnings. Give it at most 5 rounds."
- The loop appears in the conversation as **Run ralph loop**, marked **Worker reported completion**, **Worker reported a blocker**, or **Round limit reached**. Expand it to see the last report, **Rounds**, any **Remaining work**, and the **Task**.
## Good to know
- Agents are told to use it only when you ask for a Ralph loop or for repeated work with fresh agents.
- Completion and blockers are the last agent's own report. Check the result yourself.
- Anything a round does not write to the files or its report is lost. A round without a valid report stops the loop with an error.
- The conversation waits for the whole loop. Stopping the reply stops the loop.
- A loop runs at most 64 rounds; asking for more fails. Each round is a full agent run, so cost grows with each round.
- Turning the plugin off removes the loop from every agent's next request.
@@ -1,17 +1 @@
![Ralph 循环用新的智能体运行了三轮,直到最后一轮报告目标已达成](preview.zh.svg)
给出目标并要求使用 Ralph 循环后,智能体会一轮接一轮地启动新的智能体处理这个目标,直到某一轮报告目标已达成或受阻,或达到轮次上限。每一轮只能看到目标、工作区文件和上一轮的简短报告,看不到对话内容。
## 使用方法
- 说「Ralph 循环」,并给出能根据文件检查的目标,例如:「用 Ralph 循环把 pnpm lint 修到零警告通过,最多跑 5 轮。」
- 循环在对话中显示为 **运行循环工作流**,并标记为 **智能体报告完成**、**智能体报告受阻** 或 **已达到轮次上限**。展开后可查看最后一份报告、**执行轮次**、**待完成事项**(如有)和 **任务内容**。
## 注意事项
- 智能体被要求只在你要求 Ralph 循环、或要求用新的智能体反复工作时才使用它。
- 完成和受阻都是最后一个智能体自己的报告。请自行检查结果。
- 某一轮没有写进文件或报告的内容都会丢失。如果某一轮没有给出有效报告,循环会出错停止。
- 对话会等待整个循环结束。停止回复会同时停止循环。
- 一个循环最多运行 64 轮,要求更多轮次会失败。每一轮都是一次完整的智能体运行,因此成本随轮数增加。
- 关闭此插件后,每个智能体的下一次请求中都不再有这个循环。
@@ -1,7 +1,7 @@
{
"meta": {
"title": "Ralph-Loops",
"description": "Führen Sie explizit angeforderte wiederholte Arbeiten mit neuen Agenten durch.",
"description": "Bitten Sie um eine Ralph-Schleife mit einem Ziel, und der Agent startet Runde um Runde einen neuen Agenten darauf, bis das Ziel erreicht ist, ein Hindernis gemeldet wird oder das Rundenlimit erreicht ist.",
"detail": "docs/DETAIL.md"
}
}
@@ -1,7 +1,7 @@
{
"meta": {
"title": "Ralph loops",
"description": "Run explicitly requested repeated work with fresh agents.",
"description": "Ask for a Ralph loop with a goal, and the agent starts a fresh agent on it round after round until the goal is met, a blocker is reported, or the round limit is reached.",
"detail": "docs/DETAIL.md"
}
}
@@ -1,7 +1,7 @@
{
"meta": {
"title": "Bucles de Ralph",
"description": "Ejecute trabajos repetidos solicitados explícitamente con agentes nuevos.",
"description": "Pida un bucle Ralph con un objetivo, y el agente inicia un agente nuevo sobre él ronda tras ronda hasta que se cumpla el objetivo, se informe de un bloqueo o se alcance el límite de rondas.",
"detail": "docs/DETAIL.md"
}
}
@@ -1,7 +1,7 @@
{
"meta": {
"title": "Boucles Ralph",
"description": "Exécutez le travail répété explicitement demandé avec de nouveaux agents.",
"description": "Demandez une boucle Ralph avec un objectif, et l'agent lance un nouvel agent dessus, tour après tour, jusqu'à ce que l'objectif soit atteint, qu'un blocage soit signalé ou que la limite de tours soit atteinte.",
"detail": "docs/DETAIL.md"
}
}
@@ -1,7 +1,7 @@
{
"meta": {
"title": "Ralph ループ",
"description": "ユーザーが明示的に依頼した繰り返し作業を、新しいエージェントで実行します。",
"description": "目標を指定して Ralph ループを依頼すると、エージェントは、目標が達成されるか、阻害要因が報告されるか、ラウンド数の上限に達するまで、ラウンドごとに新しいエージェントを起動してその目標に取り組ませます。",
"detail": "docs/DETAIL.md"
}
}
@@ -1,7 +1,7 @@
{
"meta": {
"title": "Loops de Ralph",
"description": "Execute trabalhos repetidos solicitados explicitamente com novos agentes.",
"description": "Peça um loop Ralph com um objetivo, e o agente inicia um novo agente nele rodada após rodada até que o objetivo seja atingido, um bloqueio seja informado ou o limite de rodadas seja alcançado.",
"detail": "docs/DETAIL.md"
}
}
@@ -1,7 +1,7 @@
{
"meta": {
"title": "Ральф петли",
"description": "Запуск явно запрошенной повторной работы со свежими агентами.",
"description": "Попросите запустить цикл Ralph с целью, и агент будет раунд за раундом запускать для неё нового агента, пока цель не будет достигнута, не будет сообщено о препятствии или не будет достигнут лимит раундов.",
"detail": "docs/DETAIL.md"
}
}
@@ -1,7 +1,7 @@
{
"meta": {
"title": "Ralph 循环",
"description": "使用新智能体执行用户明确要求的循环工作。",
"description": "要求用 Ralph 循环完成一个目标后,智能体会一轮接一轮地启动新的智能体处理它,直到目标达成、报告受阻或达到轮次上限。",
"detail": "docs/DETAIL.zh.md"
}
}
@@ -1,17 +1 @@
![An agent answers a question about past work by searching earlier sessions and finding two matches](preview.svg)
Ask about earlier work, such as "How did we fix the pool leak last week?", and the agent finds the answer in your earlier sessions. You do not need to paste the history.
## How to use
- Ask about past work in your message. The agent decides when to search.
- Expand a **Search sessions** row to see the matching sessions with their titles and matching excerpts.
## Good to know
- Agents see only sessions whose working directory is exactly the same path as the current one; a symlinked path counts as different.
- Agents can read earlier sessions but cannot change them.
- The search index is built on the first search and kept in memory. It is built again after DSH restarts or after the plugin is turned off and on.
- The search tools and their instructions are added to every model request, so they use some tokens even when the agent does not search.
- Turning the plugin on or off changes the agent's tools from its next request, also in open sessions; that request cannot reuse cached input.
- The search box in the sidebar works the same with or without this plugin.
@@ -1,17 +1 @@
![智能体搜索历史会话,找到两条匹配,回答关于以往工作的问题](preview.zh.svg)
询问以往的工作,例如“上周我们是怎么修好连接池泄漏的?”,智能体会在你的历史会话中找到答案。你无需粘贴历史记录。
## 使用方法
- 在消息中询问以往的工作。由智能体决定何时搜索。
- 展开 **搜索会话** 行,查看匹配的会话及其标题和匹配片段。
## 注意事项
- 智能体只能看到工作目录路径与当前会话完全相同的会话;通过符号链接访问的路径视为不同目录。
- 智能体可以读取历史会话,但不能修改。
- 搜索索引在第一次搜索时建立并保存在内存中。DSH 重启后,或关闭再启用此插件后,索引会重新建立。
- 搜索工具及其说明会加入每次模型请求,因此即使智能体不搜索,也会消耗一些 token。
- 启用或关闭此插件后,智能体的工具从下一次请求起改变,已打开的会话也一样;这次请求无法复用缓存的输入。
- 无论是否启用此插件,侧边栏中的搜索框行为都相同。
@@ -1,7 +1,7 @@
{
"meta": {
"title": "Sitzungssuche",
"description": "Geben Sie Agenten Tools an die Hand, mit denen sie frühere Sitzungen im aktuellen Arbeitsbereich durchsuchen und lesen können.",
"description": "Fragen Sie nach früherer Arbeit, etwa „Wie haben wir letzte Woche das Pool-Leck behoben?“, und der Agent durchsucht Ihre früheren Sitzungen aus demselben Arbeitsverzeichnis, um zu antworten.",
"detail": "docs/DETAIL.md"
}
}
@@ -1,7 +1,7 @@
{
"meta": {
"title": "Session search",
"description": "Give agents tools to search and read earlier sessions from the current workspace.",
"description": "Ask about earlier work, such as “How did we fix the pool leak last week?”, and the agent searches your earlier sessions in the same workspace to answer.",
"detail": "docs/DETAIL.md"
}
}
@@ -1,7 +1,7 @@
{
"meta": {
"title": "búsqueda de sesión",
"description": "Ofrezca a los agentes herramientas para buscar y leer sesiones anteriores desde el espacio de trabajo actual.",
"description": "Pregunte por trabajo anterior, como “¿Cómo arreglamos la fuga del pool la semana pasada?”, y el agente busca en sus sesiones anteriores del mismo directorio de trabajo para responder.",
"detail": "docs/DETAIL.md"
}
}
@@ -1,7 +1,7 @@
{
"meta": {
"title": "Recherche de sessions",
"description": "Donnez aux agents des outils pour rechercher et lire les sessions précédentes à partir de l’espace de travail actuel.",
"description": "Posez une question sur un travail antérieur, par exemple « Comment avons-nous corrigé la fuite du pool la semaine dernière ? », et l'agent recherche dans vos sessions antérieures du même répertoire de travail pour répondre.",
"detail": "docs/DETAIL.md"
}
}
@@ -1,7 +1,7 @@
{
"meta": {
"title": "セッション検索",
"description": "現在のワークスペースの過去のセッションを検索、読み取りするツールをエージェントに提供します。",
"description": "「先週プールのリークをどう直した?」のように以前の作業について尋ねると、エージェントは同じ作業ディレクトリの過去のセッションを検索して回答します。",
"detail": "docs/DETAIL.md"
}
}
@@ -1,7 +1,7 @@
{
"meta": {
"title": "Pesquisa de sessão",
"description": "Forneça aos agentes ferramentas para pesquisar e ler sessões anteriores do espaço de trabalho atual.",
"description": "Pergunte sobre trabalhos anteriores, como “Como corrigimos o vazamento do pool na semana passada?”, e o agente pesquisa suas sessões anteriores do mesmo diretório de trabalho para responder.",
"detail": "docs/DETAIL.md"
}
}
@@ -1,7 +1,7 @@
{
"meta": {
"title": "Поиск сеанса",
"description": "Предоставьте агентам инструменты для поиска и чтения предыдущих сеансов из текущего рабочего пространства.",
"description": "Спросите о прошлой работе, например «Как мы исправили утечку в пуле на прошлой неделе?», и агент выполнит поиск по вашим прошлым сеансам из того же рабочего каталога, чтобы ответить.",
"detail": "docs/DETAIL.md"
}
}
@@ -1,7 +1,7 @@
{
"meta": {
"title": "会话搜索",
"description": "为智能体提供搜索和读取当前工作区历史会话的工具。",
"description": "询问以往的工作,例如“上周我们是怎么修好连接池泄漏的?”,智能体会搜索同一工作区的历史会话来回答。",
"detail": "docs/DETAIL.zh.md"
}
}
@@ -1,11 +1 @@
![A session titled "Greeting" after "hi" is retitled "Fix login redirect loop" after later messages](preview.svg)
Without this plugin, a session's title is written once from your first message, so a session that starts with "hi" keeps a title such as "Greeting". With it on, the title is written from all of your messages and changes when the main task of the session changes.
## Good to know
- Each new message from you starts one short title request, using the same model as the conversation. This costs some extra tokens; the agent's own requests do not grow.
- The model is asked to keep the current title while it still describes the main task, so follow-up questions or "thanks" usually leave it unchanged. The model can still reword it.
- Automatic updates never change a title you renamed yourself.
- If a title request fails, the previous title stays. Once your messages in a session add up to more than about 4 KB of text, title requests fail and the title stops changing.
- It applies to existing and new sessions. Turning it off stops automatic updates; new sessions again get their title from the first message, and titles already written stay.
@@ -1,11 +1 @@
![发送“你好”后标题为“问候”的会话,在后续消息后改为“修复登录重定向循环”](preview.zh.svg)
未启用此插件时,会话标题只根据你的第一条消息生成一次,因此以“你好”开头的会话会一直使用“问候”之类的标题。启用后,标题根据你的所有消息生成,并在会话的主要任务变化时更新。
## 注意事项
- 你每发送一条新消息,都会发起一次简短的标题请求,使用与对话相同的模型。这会消耗一些额外 token;智能体自身的请求不会变长。
- 只要当前标题仍能概括主要任务,模型就会被要求保留它,因此追问或“谢谢”之类的消息通常不会改变标题。模型仍可能改写标题。
- 自动更新不会更改你自己重命名过的标题。
- 标题请求失败时,保留原来的标题。会话中你的消息累计超过约 4 KB 文本后,标题请求会失败,标题不再变化。
- 它对已有会话和新会话都生效。关闭后停止自动更新;新会话重新根据第一条消息生成标题,已生成的标题保持不变。
@@ -1,7 +1,7 @@
{
"meta": {
"title": "Konversationsfolgende Titel",
"description": "Aktualisieren Sie die Sitzungstitel, wenn neue menschliche Eingabeaufforderungen eintreffen.",
"description": "Erstellt den Titel einer Sitzung aus all Ihren Nachrichten und aktualisiert ihn, wenn sich die Hauptaufgabe ändert, statt ihn nur aus der ersten Nachricht zu bilden.",
"detail": "docs/DETAIL.md"
}
}
@@ -1,7 +1,7 @@
{
"meta": {
"title": "Conversation-following titles",
"description": "Refresh session titles as new human prompts arrive.",
"description": "Writes a session's title from all of your messages and updates it when the main task changes, instead of only from the first message.",
"detail": "docs/DETAIL.md"
}
}
@@ -1,7 +1,7 @@
{
"meta": {
"title": "Títulos que siguen la conversación",
"description": "Actualice los títulos de las sesiones a medida que lleguen nuevas indicaciones humanas.",
"description": "Escribe el título de una sesión a partir de todos sus mensajes y lo actualiza cuando cambia la tarea principal, en lugar de basarse solo en el primer mensaje.",
"detail": "docs/DETAIL.md"
}
}
Loaded 100 of 126 files, more files were not shown because too many files have changed in this diff. Show more