workspacePrompt.test.ts 11 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179
  1. // @vitest-environment node
  2. import { describe, expect, it } from 'vitest'
  3. import { buildWorkspacePrompt, workspaceEnvironmentPrompt, type WorkspacePromptEnvironment, type WorkspacePromptInput } from '../../src/server/workspacePrompt'
  4. function environment(): WorkspacePromptEnvironment {
  5. return {
  6. open: { computer: true, server: true, vm: true, cloud: true },
  7. tools: { desktopView: true, desktopFile: true, vm: true, cloud: true, plugins: false },
  8. version: 1, capturedAt: 1, execution: { nodeId: 'local', profile: 'dev' },
  9. desktop: { capturedAt: 1, sourceHost: 'mac-id', hosts: [{ id: 'mac-id', target: 'mac-id', name: '工作 Mac', kind: 'computer', source: true, online: true, open: true,
  10. capabilities: { view: { enabled: true, status: 'ready' }, input: { enabled: true, status: 'ready' }, fileRead: { enabled: true, status: 'ready' }, fileWrite: { enabled: true, status: 'ready' }, shell: { enabled: true, status: 'ready' }, fileTransfer: { enabled: true, status: 'ready' } },
  11. transfer: { protocol: 'chunked', readMaxMiB: 50, writeMaxMiB: 50 } }] },
  12. virtual: { vm: { status: 'on_demand', environmentId: 'bot' }, cloud: { status: 'on_demand', cwd: '/workspace' } },
  13. cwd: '/srv/hermes/project', fileTransferMaxMiB: 50,
  14. }
  15. }
  16. function input(): WorkspacePromptInput {
  17. return {
  18. agent: { id: 'bot', name: '助手', avatar: '', instructions: '规则原文\n保留格式', description: '处理开发任务', job: '开发与验证', voice: 'concise', actBias: 'act_now', nodeId: 'local', profile: 'dev', archived: false, revision: 7, createdAt: 1, updatedAt: 1 },
  19. conversation: { id: 'chat', kind: 'direct', name: '对话', avatar: '', memberIds: ['bot'], administratorId: 'bot', mode: 'free', instructions: '', autoReplyIds: [], maxReplyRounds: 1, archived: false, pinned: false, readSeq: 0, lastSeq: 0, preview: '', createdAt: 1, updatedAt: 1 },
  20. members: [{ id: 'bot', name: '助手' }],
  21. work: { depth: 0, requiredReply: true, replyMode: 'mentioned', messageId: 'message' },
  22. run: { mentionIds: [] }, environment: environment(),
  23. memory: '已确认的项目事实', noReply: '[[YAOYAO_NO_REPLY_V1]]', marker: '[yaoyao-run:run:result]',
  24. content: '读取本机文件\n然后核对结果', contentKind: 'user', attachmentRefs: ['[附件](ref:file)'],
  25. }
  26. }
  27. describe('Bot environment routing', () => {
  28. it('describes all mounted environments conditionally without moving the model or the message origin', () => {
  29. const text = workspaceEnvironmentPrompt(environment())
  30. expect(text).toContain('模型会话运行在服务端 Hermes')
  31. expect(text).toContain('「本机」只指本轮消息来源电脑')
  32. expect(text).toContain('不得切换其他机器代做')
  33. expect(text).toContain('host="server"')
  34. expect(text).toContain('desktop_shell')
  35. expect(text).toContain('computer_shell')
  36. expect(text).toContain('cloud_computer_*')
  37. expect(text).toContain('最大 50 MiB')
  38. expect(text).not.toContain('25 MiB')
  39. expect(text).not.toContain('当前环境是')
  40. expect(text).not.toContain('一律用 desktop_*')
  41. expect(text.match(/工作 Mac/g)).toHaveLength(2) // source and inventory, not one list per environment
  42. expect(text).toContain('该路径仅属于 Hermes 运行环境')
  43. })
  44. it('distinguishes global policy from mounted capabilities and does not promise native tools', () => {
  45. const env = environment()
  46. env.tools = { desktopView: false, desktopFile: false, vm: false, cloud: false, plugins: false }
  47. const text = workspaceEnvironmentPrompt(env)
  48. expect(text).toContain('开放不等于在线或已授权')
  49. expect(text).toContain('以本轮实际工具目录为准')
  50. expect(text).not.toContain('工具均可使用')
  51. for (const tool of ['desktop_file_copy', 'desktop_environment_view', 'computer_shell', 'cloud_computer_*']) expect(text).not.toContain(tool)
  52. })
  53. it.each(['none','server','virtual'] as const)('uses default %s as a preference and prioritizes the enabled managed browser',mode=>{
  54. const env=environment()
  55. env.selection={mode,revision:2,credentialSource:mode==='server'?'native':'yaoyao'}
  56. env.tools.managedBrowser=true
  57. const text=workspaceEnvironmentPrompt(env)
  58. expect(text).toContain('不限制其他已开放且获授权的环境')
  59. expect(text).toContain('用户明确指定目标时优先使用该目标')
  60. expect(text).toContain('「本机」只指本轮消息来源电脑')
  61. expect(text).toContain('默认使用 managed_browser_open')
  62. expect(text).toContain('此规则优先于服务器或虚拟机的默认运行环境')
  63. expect(text).toContain('不要仅因历史曾用过其他浏览器而覆盖本轮默认')
  64. expect(text).toContain('继续操作已经明确指定的页面')
  65. expect(text).toContain('computer_shell')
  66. expect(text).toContain('cloud_computer_*')
  67. expect(text).not.toContain('只使用所选环境')
  68. expect(text).not.toContain('执行位置已由系统固定')
  69. expect(text).not.toContain('虚拟环境不可用')
  70. env.tools.managedBrowser=false
  71. expect(workspaceEnvironmentPrompt(env)).not.toContain('managed_browser_open')
  72. })
  73. it('does not require a screenshot for file-only computers', () => {
  74. const env = environment()
  75. env.tools.desktopView = false
  76. const text = workspaceEnvironmentPrompt(env)
  77. expect(text).toContain('文件与命令操作无需先截图')
  78. expect(text).not.toContain('desktop_environment_view')
  79. expect(text).toContain('desktop_file_copy')
  80. env.tools.desktopFile = false
  81. env.tools.desktopView = true
  82. const view = workspaceEnvironmentPrompt(env)
  83. expect(view).toContain('desktop_environment_view')
  84. expect(view).not.toContain('电脑文件与命令工具已挂载')
  85. expect(view).not.toContain('desktop_file_copy')
  86. })
  87. it('cannot turn Grok model discussion, old VM text or a follow-up into environment selection', () => {
  88. const fixture = input()
  89. fixture.environment.tools.cloud = false
  90. fixture.environment.tools.vm = false
  91. const prompts = ['介绍 Grok 模型', '以前使用过虚拟机', '继续'].map(content => buildWorkspacePrompt({ ...fixture, content }))
  92. const environments = prompts.map(text => text.split('【本轮环境与设备】')[1]!.split('【Bot 记忆与相关事实】')[0])
  93. expect(new Set(environments).size).toBe(1)
  94. expect(environments[0]).not.toContain('cloud_computer_*')
  95. expect(environments[0]).not.toContain('computer_shell')
  96. })
  97. })
  98. describe('Bot prompt composition', () => {
  99. it('routes configured MCP discovery through the current Bot catalog instead of Hermes CLI configuration', () => {
  100. const fixture = input()
  101. fixture.environment.tools.plugins = true
  102. fixture.pluginServices = [{ name: 'vaultwarden', transport: 'stdio', toolCount: 59 }, { name: '远程服务', transport: 'http', toolCount: 2 }]
  103. const text = buildWorkspacePrompt(fixture)
  104. expect(text).toContain('"name":"vaultwarden","transport":"stdio","toolCount":59')
  105. expect(text).toContain('"name":"远程服务","transport":"http","toolCount":2')
  106. expect(text).toContain('tool_search')
  107. expect(text).toContain('yaoyao_tools')
  108. expect(text).toContain('yaoyao_call')
  109. expect(text).toContain('按 service(服务名)或 query')
  110. expect(text).toContain('不要在拿到参数后重复搜索')
  111. expect(text).toContain('普通 Bot 对话不是 Hermes 看板任务')
  112. expect(text).toContain('不重复相同的无效调用')
  113. expect(text).toContain('yaoyao_plugin_')
  114. expect(text).not.toContain('工具名以 plugin_ 开头')
  115. expect(text).toContain('不能根据 hermes mcp list/test 的结果判断这些服务不存在')
  116. expect(text).toContain('工具发现成功不代表账号已登录')
  117. fixture.environment.tools.plugins = false
  118. expect(buildWorkspacePrompt(fixture)).not.toContain('vaultwarden')
  119. })
  120. it('keeps persona, provenance, user content and attachments in their own sections', () => {
  121. const fixture = input(), text = buildWorkspacePrompt(fixture)
  122. expect(text).toContain(`版本 7):\n${fixture.agent.instructions}`)
  123. expect(text).toContain('你是 助手。')
  124. expect(text).toContain('直接行动:合理默认即可开工')
  125. expect(text).toContain(`【本轮用户消息】\n${fixture.content}`)
  126. expect(text).toContain('【本轮附件】\n[附件](ref:file)')
  127. expect(text).toContain(fixture.marker)
  128. expect(text.indexOf('【Bot 身份与长期规则】')).toBeLessThan(text.indexOf('【本轮任务与协作】'))
  129. expect(text.indexOf('【本轮环境与设备】')).toBeLessThan(text.indexOf('【Bot 记忆与相关事实】'))
  130. expect(text.indexOf('【Bot 记忆与相关事实】')).toBeLessThan(text.indexOf('【本轮用户消息】'))
  131. })
  132. it('preserves discussion participation, member roles and history boundaries', () => {
  133. const fixture = input()
  134. fixture.conversation = { ...fixture.conversation, kind: 'group', memberRoles: { bot: { name: '审核', description: '核实事实' } } }
  135. fixture.run = { mentionIds: ['bot'], discussion: { memberIds: ['bot'], rounds: 2 }, projectId: 'project' }
  136. fixture.work.depth = 1
  137. fixture.contentKind = 'history'
  138. const text = buildWorkspacePrompt(fixture)
  139. expect(text).toContain('平等讨论,第 2 轮')
  140. expect(text).toContain('@助手:审核;核实事实')
  141. expect(text).toContain('本轮用户指定成员:@助手')
  142. expect(text).toContain('不要用私信或 @ 再次派发本轮工作')
  143. expect(text).toContain('【本轮对话上下文】')
  144. expect(text).toContain('当前项目 ID:project')
  145. })
  146. it('preserves automatic silence and does not offer unmounted export tools to a helper', () => {
  147. const fixture = input()
  148. fixture.work.requiredReply = false
  149. fixture.work.replyMode = 'automatic'
  150. fixture.agent.temporaryGoalId = 'goal'
  151. fixture.environment.tools.vm = false
  152. const text = buildWorkspacePrompt(fixture)
  153. expect(text).toContain('完整答复只能是 [[YAOYAO_NO_REPLY_V1]]')
  154. expect(text).toContain('不要创建团队或改变自身权限')
  155. expect(text).not.toContain('computer_export')
  156. })
  157. })
  158. it('describes failed optional services separately without replacing the user request or promising unavailable tools',()=>{
  159. const value=input()
  160. value.pluginWarnings=[{service:'故障 MCP',code:'plugin_initialization_failed',message:'本轮暂时不可用'}]
  161. const prompt=buildWorkspacePrompt(value)
  162. expect(prompt).toContain('【本轮服务连接提示】')
  163. expect(prompt).toContain(JSON.stringify(value.pluginWarnings))
  164. expect(prompt).toContain('不要因为无关插件离线而中断整轮对话')
  165. expect(prompt).toContain('不能宣称已经调用或执行成功')
  166. expect(prompt).toContain('【本轮用户消息】\n'+value.content)
  167. expect(prompt).not.toContain('已完成本轮连接和工具发现的服务')
  168. })