From 601f13c4f859bb5494f992c477a877a90bf302c3 Mon Sep 17 00:00:00 2001 From: Agent Workbench Dev Date: Fri, 30 Oct 2026 18:58:55 +0800 Subject: [PATCH] feat: add source-verified project skills --- docs/CAPABILITIES.md | 2 +- docs/PLAN-1.12.md | 2 + docs/SKILLS.md | 33 +++++ docs/skills-ui-validation.json | 22 ++++ findings.md | 9 ++ package.json | 3 +- progress.md | 7 ++ scripts/verify-skills-ui.mjs | 93 ++++++++++++++ src/client/App.tsx | 4 + src/client/RequestContextPanel.tsx | 2 + src/client/SkillCenter.css | 70 +++++++++++ src/client/SkillCenter.tsx | 63 ++++++++++ src/client/types.ts | 1 + src/core/context/request-plan.mjs | 37 +++++- src/core/skills/skill-registry.mjs | 180 +++++++++++++++++++++++++++ src/server/app.mjs | 12 ++ src/server/hot-upgrade.mjs | 4 +- src/server/runtime.mjs | 19 ++- task_plan.md | 7 ++ tests/skills.test.mjs | 190 +++++++++++++++++++++++++++++ tests/upgrade-artifacts.test.mjs | 5 +- 21 files changed, 753 insertions(+), 12 deletions(-) create mode 100644 docs/SKILLS.md create mode 100644 docs/skills-ui-validation.json create mode 100644 scripts/verify-skills-ui.mjs create mode 100644 src/client/SkillCenter.css create mode 100644 src/client/SkillCenter.tsx create mode 100644 src/core/skills/skill-registry.mjs create mode 100644 tests/skills.test.mjs diff --git a/docs/CAPABILITIES.md b/docs/CAPABILITIES.md index 36d99636..17ec5747 100644 --- a/docs/CAPABILITIES.md +++ b/docs/CAPABILITIES.md @@ -112,7 +112,7 @@ | C03 工程识别与索引 | 提供有界文件清单/文本搜索,没有工程索引 | 识别语言、入口、规则、脚本、依赖和Git;增量索引;符号/引用与必要的语义检索 | CU-2、DS-3 / context / M2 | 对Node/React/Python样本定位实际修改入口;代码变动后索引更新 | | C04 上下文与项目归属 | 有提取式消息投影、运行诊断和当前项目资料 | 为Run组合需求、规则、代码、错误与验证结果;引用来源;严格绑定项目 | CC-2、CU-1 / context、contracts / M1–M2 | 切换两个项目/任务后,错误与工具结果仍归属正确;大输出用工件引用 | | C05 长期项目记忆 | 项目所属持久条目、来源/工程指纹、到期/归档、不完整扫描降级、有界且脱敏的请求接入与原快照已实现 | 自动提取/归并、长任务恢复包及真实模型收益继续验收 | CC-2、WB-1 / context、storage / M4 | 长任务压缩/重启后完成标准不丢;过期代码事实被更新或标记 | -| C06 工具、Skills与MCP | 固定6工具,没有动态注册或外部工具契约 | 工具注册、schema与能力声明;版本锁定Skills/MCP;安装/调用有来源和范围 | CC-1、CU-1、WB-2 / tools / M3 | 未知工具、错误参数、工具失联有原调用身份;新工具可按契约接入 | +| C06 工具、Skills与MCP | 自有工程工具/固定REA MCP;1.12源码支持项目Skills登记、启停/修订、按需读取与请求证据,见SKILLS.md | 动态MCP、schema与能力声明;插件安装/调用有来源和范围 | CC-1、CU-1、WB-2 / tools / M3 | 未知工具、错误参数、工具失联有原调用身份;新工具可按契约接入 | | C07 执行控制 | 文件范围/基线检查、逐次命令确认与进程停止 | 操作范围、授权记录、预算、进程所有权、并发准入和取消传播;沿用用户已授权的范围 | CC-1、CU-1、DS-1 / tools、tasks / M1–M4 | 过期授权不能用于新Run;停止只处理所属任务;修改后的输入重新校验 | | C08 精确编辑与多文件变更 | 完整替换单文件提案,有备份与冲突拒绝 | patch、创建/改名/删除、多文件ChangeSet、基线校验、隔离应用与可恢复合并 | CU-2 / workspaces / M2 | 跨4文件修改保留无关内容;外部改动引起冲突;部分失败有明确状态 | | C09 用户工程Git | 本产品源码已建Git;界面内用户工程Git未实现 | 仓库/dirty状态、基线、任务分支/worktree、diff、审查后提交与合并 | CX-1、CU-3、DS-3 / workspaces / M2 | 保留用户已有修改;每个交付可定位commit;冲突合并可审查 | diff --git a/docs/PLAN-1.12.md b/docs/PLAN-1.12.md index 0cd6b1a7..bb567b20 100644 --- a/docs/PLAN-1.12.md +++ b/docs/PLAN-1.12.md @@ -22,6 +22,8 @@ A–D分别提交和验收。A先建立注册与归属,B依赖A,C使用A的 后续[任务恢复检查点](TASK-CHECKPOINTS.md)源码已实现保存完整要求/原工具工件/计划与证明、复核当前源码和Git/工作区、显式同Task续接。12项专项含真实进程提交前后退出及桌面/390px三组通过,最终源码/构建334/334回归及204份输入已独立封存;新包与真实模型长任务收益尚未验收。 +本地[Skills](SKILLS.md)源码已实现项目登记、来源SHA256、默认停用、显式启停/新修订、每轮目录与按需读取工件;10项专项和升级2项、桌面/390px四组通过。完整MCP与隔离worker仍在后续,附带脚本不自动加载执行。 + ## 专业界面与操作结构 用户需要持续交付工程的工作空间。桌面采用坚实的工程控制台:蓝黑文字、钢灰底、清楚的实体面板和高辨识操作状态;减少小字号、低对比细线和大块无用途留白。数字只显示实际量测结果。 diff --git a/docs/SKILLS.md b/docs/SKILLS.md new file mode 100644 index 00000000..c240bcc0 --- /dev/null +++ b/docs/SKILLS.md @@ -0,0 +1,33 @@ +# 项目所属本地技能 + +2026-10-30源码切片,正式4318仍运行原1.11不可变发行。本切片接入本地SKILL.md的登记、来源核对、显式启停、版本记录和实际模型按需读取;完整外部插件、任意附件/脚本自动运行、动态MCP另行实现和验收。 + +## 使用与边界 + +在“项目技能”填写已审查的SKILL.md绝对路径、名称、用途和版本。登记只读取UTF-8常规文本,最多64KB;默认停用。审查保存的原文后显式启用,后续任务才能从项目目录按需读取。管理、来源核对和查看旧修订均不请求模型。 + +每项目最多32项注册、8项同时启用,每项最多20修订,全部注册元数据最多8MB。来源使用规范路径与实际文件SHA256,快照正文脱敏后独立保存散列;版本字符串是用户声明,SHA256才是本次实际字节身份。来源内容改变或无法读取时显示明确状态,不自动采用新文件。登记新修订保留旧文本并自动停用,用户审查后重新启用。configurationRevision防止旧页签迟到启停覆盖当前状态。 + +技能是用户选择的参考流程。注册内容不授予文件、命令或其他工具权限,不能覆盖原用户目标或既有审查;文本里的命令不会在注册或读取时执行。本切片只登记SKILL.md,正文中的相对附件、脚本、网站或其他技能没有因此自动加载/执行。原文审查使用纯文本,不渲染HTML。 + +## 实际请求与追溯 + +每轮模型请求前重新读取来源字节并核对,只为当前项目启用项生成目录。目录最多8项/12000个转义UTF-8 JSON字节,仅使用原目标、完整工具配对和当前代码选择后的剩余预算;空间不足的整项省略,已启用不保证每次请求都有预算。目录保留来源状态,变化项不可调用。 + +发送目录保存为context-skill-catalog工件,绑定消费Session/Task/Run;请求计划保留ID/SHA/条数,verifyPlanEvidence核对原工件、归属、预算和实际消息正文。之后停用、更新来源或重启不改写旧请求证据,旧工件损坏直接拒绝。 + +模型通过read_registered_skill按本次已发送目录的ID/revision/source_sha256读取,宿主复核完整请求证据、当前启用状态和来源。不能猜测跨项目或被省略的技能ID。原文以脱敏后的skill-instructions工件保存,绑定当前Task/Run并按已有工具JSON预算分页;后续使用read_artifact和next_offset读取同一快照,避免重新读取变化后的来源。完整工具调用和结果沿用原账本,重复区间沿用读取进展限制。技能文字不作为任务计划的工程完成证明。 + +凭据在注册和发送时由当前Provider已知秘密脱敏。程序不扫描用户Skills目录、不导入第三方登录态或环境变量,也不会因目录通知自动安装代码。配置写入事务失败保留原注册状态,快照损坏阻止目录消费,原任务和工件保持可核对。 + +## API与本地验收 + +- GET /api/projects/:projectId/skills:当前项目列表和来源核对。 +- POST /api/projects/:projectId/skills:登记path/name/description/version,默认停用。 +- POST /api/projects/:projectId/skills/toggle:id/revision/configurationRevision/enabled,项目执行时拒绝。 +- POST /api/projects/:projectId/skills/refresh:id/revision/configurationRevision/version,保留旧修订并停用新修订。 +- GET /api/projects/:projectId/skills/content?id=…&revision=…:查看保存的原文,不读取附带文件或执行内容。 + +10项专项覆盖真实本地HTTP目录/正文读取、脱敏、项目隔离、停用/来源变化、长Unicode分页、预算、事务失败、原工件损坏、SQLite重开和API。现有升级2项扩充技能注册对象重建/失败回滚,12/12通过。桌面1440px/390px四组通过并目视核对,证据.qa/skills-ui-aa3ba90d-1038-442b-9729-d41a00ac65c0;2次自有本地HTTP请求,0真实模型请求。验证器此前字段/格式假设导致的三个末尾失败目录保留,没有改动产品协议以迎合测试。 + +完整回归在后续源码冻结时单独封存,不以本地夹具证明真实模型使用技能后的业务完成率。 diff --git a/docs/skills-ui-validation.json b/docs/skills-ui-validation.json new file mode 100644 index 00000000..4dfb839b --- /dev/null +++ b/docs/skills-ui-validation.json @@ -0,0 +1,22 @@ +{ + "success": true, + "viewportWidths": [ + 1440, + 390 + ], + "assertions": [ + "desktop registers a disabled skill, reviews original UTF-8 instructions and explicitly enables it with no model calls", + "source edit blocks activation until a new reviewed revision is registered; original revision remains available", + "390px review and activation retain readable paths, revision history and visible source state without horizontal overflow", + "actual local HTTP task reads precisely revision 2 and exposes its SHA-bound sent catalog in task evidence" + ], + "pageErrors": [], + "requestFailures": [], + "localFixtureModelRequests": 2, + "realModelRequests": 0, + "screenshots": [ + "desktop-skill-source.png", + "mobile-skill-source.png", + "desktop-sent-skill-catalog.png" + ] +} \ No newline at end of file diff --git a/findings.md b/findings.md index f6af00a0..6bee2bc0 100644 --- a/findings.md +++ b/findings.md @@ -361,3 +361,12 @@ Claude Code 报告已验证工具输入校验、权限决定、队列并发屏 - 长任务恢复核验限制每Task30个检查点、2000条工具引用和64MB原结果字节;先预检体积,再核对原工件,避免长历史重复展开查找。一次不存在的task-plan-crash.test.mjs只读查询已改用rg确认task-plans.test.mjs及现有worker路径。 - 最终12项专项和334/334完整回归通过,204份源码/构建输入一致,TAP SHA256 e4a07d969c5f256cf1035730b9bc0763da98e93728972de16dac6649f4669ed9;原始文件在.qa/task-checkpoint-regression-40d8ec07-c24d-4439-a169-cf03bfd63a56。冻结期间只更新文档,正式4318和真实凭据未触碰。 - 接续恢复读取有过量输出截断,后续限定段落;一次计划补丁锚点不匹配未写入任何文件,已改用实际锚点。未将读取或补丁失败当作验证通过。 + +## 版本化Skills开发与验证 + +- b25b7ef已封存检查点。技能注册使用项目所属SQLite元数据和实际文件SHA256,默认停用;修订保留脱敏全文,来源变化不覆盖旧版本。每轮只发送有界目录,完整正文经工具读取并保存Task/Run所属工件。 +- 首轮10项专项7通过/3失败:预算用例没有重新计算新窗口的安全预留;新测试使用错误addProject参数;长正文第二页因历史挤掉目录被按契约拒绝。前两项修正夹具,长正文后续分页改用已有read_artifact读取已封存快照,避免重复调用技能。9/10中间失败保留.qa/skills-initial-failure.log。 +- 一次只读查询指向不存在的server/server.mjs与artifact-budget测试,改为现有index.mjs/read-budget;后续输出限制到真实文件与段落。 +- 技能配置独立configurationRevision防止迟到启停覆盖新状态;技能源码revision只表示内容修订。最终10项与升级2项12/12通过。UI前两轮在末尾查询不存在的工具列表字段失败,第三轮原目录呈现成功但验证器错误假定JSON有空格;按实际progress/events和JSON解析核对,原失败目录保留。 +- 界面沿用工程控制台:海军蓝#16324c/钢灰#c8d2dc/纸白#fff/浅灰#f3f6f9/青绿#307f72/琥珀#ab712c;中文标题和正文使用已有系统字体,散列与修订用Consolas。标识性的左侧来源状态边线编码真实状态,空白/无效/长路径不以装饰替代。 +- 修正验证器后桌面/390px四组全部通过,证据.qa/skills-ui-aa3ba90d-1038-442b-9729-d41a00ac65c0;两张管理界面已目视核对,来源/版本/状态与44px窄屏操作清楚,长路径换行且无横向溢出。2次本地HTTP夹具/0真实模型请求。此前三个失败目录8c888d80、11108ca5、8325c4a9原样保留。 diff --git a/package.json b/package.json index dee1841b..2ee941c7 100644 --- a/package.json +++ b/package.json @@ -23,7 +23,8 @@ "verify:task-plans": "node scripts/verify-task-plans-ui.mjs", "verify:model-center": "node scripts/verify-model-center-ui.mjs", "verify:project-memory": "node scripts/verify-project-memory-ui.mjs", - "verify:task-checkpoints": "node scripts/verify-task-checkpoints-ui.mjs" + "verify:task-checkpoints": "node scripts/verify-task-checkpoints-ui.mjs", + "verify:skills": "node scripts/verify-skills-ui.mjs" }, "dependencies": { "@babel/parser": "7.29.11", diff --git a/progress.md b/progress.md index 9bffb405..5d8c6d00 100644 --- a/progress.md +++ b/progress.md @@ -400,3 +400,10 @@ - 12项专项覆盖真实进程提交前/后退出、原证据损坏、身份/并发/预算和恢复。桌面/390px三组通过,原图已目视核对,证据.qa/task-checkpoint-ui-19c55755-cdf3-4f97-9802-421fd2460096。 - 最终334/334、0失败/取消/跳过,204份源码/构建输入一致;固定Node24.22.1/Python3.10.11/pytest8.4.2。原TAP与核验器在.qa/task-checkpoint-regression-40d8ec07-c24d-4439-a169-cf03bfd63a56;TAP SHA256 e4a07d969c5f256cf1035730b9bc0763da98e93728972de16dac6649f4669ed9。 - 新报告另存docs/task-checkpoint-regression.json,旧1.11发行证据保持。真实模型0请求,正式4318不重启、不升级。接续版本化Skills/MCP切片。 + +## 项目Skills切片完成 + +- 项目所属本地SKILL.md登记、显式启停、来源SHA/不可变修订、配置乐观并发、每轮有界目录、实际按需读取/原文工件及预算分页已完成;API、任务请求证据和专业界面已接入。 +- 10项Skills专项与升级2项12/12,记忆/上下文/检查点/分页相关52/52通过,最终构建通过。完整新回归待下一冻结切片统一封存,不改写334项原结果。 +- 四组桌面/390px通过并目视核对,.qa/skills-ui-aa3ba90d-1038-442b-9729-d41a00ac65c0;2次本地HTTP夹具请求/0真实模型。中间验证器字段及JSON格式错误和长文分页失败另存,不掩盖原记录。 +- 正式4318继续原1.11,不读取凭据、不重启;下一项为项目所属受控stdio MCP注册与调用。 diff --git a/scripts/verify-skills-ui.mjs b/scripts/verify-skills-ui.mjs new file mode 100644 index 00000000..050a2feb --- /dev/null +++ b/scripts/verify-skills-ui.mjs @@ -0,0 +1,93 @@ +import fs from 'node:fs'; +import path from 'node:path'; +import assert from 'node:assert/strict'; +import { randomUUID } from 'node:crypto'; +import { chromium, expect } from 'playwright/test'; +import { fixture, launchWorkbench, compatibleFixture, completion, call, until } from '../tests/helpers.mjs'; + +const directory = path.resolve('.qa', 'skills-ui-' + randomUUID()); fs.mkdirSync(directory, { recursive: true }); +const disposers = [], t = { after: dispose => disposers.push(dispose) }, f = fixture(t); f.store.close(); +const filename = path.join(f.root, 'engineering-workflow', 'SKILL.md'); fs.mkdirSync(path.dirname(filename)); +fs.writeFileSync(filename, '# 工程交付技能\n\n读取实际代码,保留用户已有修改。使用原始测试结果核对交付,不以模型文字代替完成。\n'); +let saved; +const model = await compatibleFixture(t, (_url, _body, requests) => requests.length === 1 + ? completion([call('ui-skill-read', 'read_registered_skill', { skill_id: saved.id, revision: saved.revision, source_sha256: saved.source.sha256 })]) + : completion([], '本地夹具:技能原文已读取,模型能力不在此验收。')); +const host = await launchWorkbench(t, f.data); assert.notEqual(new URL(host.url).port, '4318'); +const browser = await chromium.launch({ channel: 'msedge', headless: true }); +const page = await browser.newPage({ viewport: { width: 1440, height: 1000 } }); +const pageErrors = [], requestFailures = [], marks = []; +page.on('pageerror', error => pageErrors.push(error.message)); +page.on('requestfailed', request => requestFailures.push(request.url() + ': ' + request.failure()?.errorText)); +const mark = value => { marks.push(value); console.log('PASS ' + value); }; +try { + await page.addInitScript(({ projectId, sessionId }) => { localStorage.setItem('awb-project', projectId); localStorage.setItem('awb-session', sessionId); }, + { projectId: f.project.id, sessionId: f.session.id }); + await page.goto(host.url); await page.waitForLoadState('networkidle'); + await page.getByRole('button', { name: '项目技能', exact: true }).click(); + const dialog = page.getByRole('dialog', { name: '项目技能', exact: true }); await expect(dialog).toBeVisible(); + const editor = dialog.locator('.skill-register'); + await editor.getByLabel('技能名称', { exact: true }).fill('工程交付核验'); + await editor.getByLabel('版本', { exact: true }).fill('1.0.0'); + await editor.getByLabel('技能文件路径', { exact: true }).fill(filename); + await editor.getByLabel('用途说明', { exact: true }).fill('工程修改与交付前使用,核对代码、测试和用户已有变更。'); + await editor.getByRole('button', { name: '登记技能', exact: true }).click(); + const row = dialog.locator('.skill-row').filter({ hasText: '工程交付核验' }); + await expect(row).toContainText('已停用'); await expect(row).toContainText('来源一致'); + await row.getByRole('button', { name: '审查原文', exact: true }).click(); + await expect(dialog.getByLabel('技能原文')).toContainText('读取实际代码'); + await row.getByRole('button', { name: '启用技能', exact: true }).click(); + await expect(row).toContainText('已启用'); + saved = (await host.api('/projects/' + f.project.id + '/skills')).skills[0]; + assert.equal(saved.enabled, true); assert.equal(model.requests.length, 0); + await page.screenshot({ path: path.join(directory, 'desktop-skill-source.png') }); + mark('desktop registers a disabled skill, reviews original UTF-8 instructions and explicitly enables it with no model calls'); + fs.appendFileSync(filename, '\n新修订:发现失败后保留原结果,修正后重新检查。\n'); + await dialog.getByRole('button', { name: '核对来源', exact: true }).click(); + await expect(row).toContainText('来源已变化'); + await row.getByRole('button', { name: '停用技能', exact: true }).click(); + await expect(row.getByRole('button', { name: '启用技能', exact: true })).toBeDisabled(); + await row.locator('summary').click(); + await row.getByLabel('新修订版本 工程交付核验', { exact: true }).fill('1.1.0'); + await row.getByRole('button', { name: '登记新修订', exact: true }).click(); + await expect(row).toContainText('修订 2'); await expect(row).toContainText('已停用'); + await expect(row).toContainText('来源一致'); + mark('source edit blocks activation until a new reviewed revision is registered; original revision remains available'); + await page.setViewportSize({ width: 390, height: 844 }); + await row.getByRole('button', { name: '启用技能', exact: true }).click(); + await expect(row).toContainText('已启用'); + await row.getByRole('button', { name: '审查原文', exact: true }).click(); + await expect(dialog.getByLabel('技能原文')).toContainText('新修订'); + assert.ok(await page.locator('body').evaluate(node => node.scrollWidth <= 390)); + await dialog.locator('.skill-heading').scrollIntoViewIfNeeded(); + await page.screenshot({ path: path.join(directory, 'mobile-skill-source.png') }); + mark('390px review and activation retain readable paths, revision history and visible source state without horizontal overflow'); + saved = (await host.api('/projects/' + f.project.id + '/skills')).skills[0]; + await page.keyboard.press('Escape'); + await host.api('/config', { mode: 'compatible', baseUrl: model.baseUrl, model: 'owned-skills-ui', apiKey: 'owned-ui-skills-key', contextLimit: 24000 }); + await host.api('/sessions/' + f.session.id + '/messages', { content: '使用本项目已启用的工程交付技能,读取原文。' }); + await until(async () => (await host.api('/sessions/' + f.session.id)).status === 'completed'); + assert.equal(model.requests.length, 2); + const execution = await host.api('/sessions/' + f.session.id + '/execution'); + assert.equal(execution.progress.totalTools, 1); assert.equal(execution.progress.completedTools, 1); + const completedSession = await host.api('/sessions/' + f.session.id); + assert.equal(completedSession.events.filter(value => value.tool === 'read_registered_skill' && value.phase === 'completed').length, 1); + await page.setViewportSize({ width: 1440, height: 1000 }); await page.reload(); await page.waitForLoadState('networkidle'); + await page.getByRole('button', { name: '查看任务记录', exact: true }).click(); + const context = page.getByLabel('请求上下文', { exact: true }); await expect(context).toContainText('1 项本次目录记录'); + await context.getByRole('button', { name: '查看本次技能目录', exact: true }).click(); + const artifact = page.getByRole('dialog', { name: '执行结果工件', exact: true }); + await expect(artifact.locator('pre')).toContainText(saved.source.sha256); + assert.equal(JSON.parse(await artifact.locator('pre').innerText()).entries[0].revision, 2); + await page.screenshot({ path: path.join(directory, 'desktop-sent-skill-catalog.png') }); + mark('actual local HTTP task reads precisely revision 2 and exposes its SHA-bound sent catalog in task evidence'); + assert.deepEqual(pageErrors, []); assert.deepEqual(requestFailures, []); + fs.writeFileSync(path.join(directory, 'result.json'), JSON.stringify({ success: true, viewportWidths: [1440, 390], assertions: marks, + pageErrors, requestFailures, localFixtureModelRequests: model.requests.length, realModelRequests: 0, + screenshots: ['desktop-skill-source.png', 'mobile-skill-source.png', 'desktop-sent-skill-catalog.png'] }, null, 2)); + console.log('EVIDENCE ' + directory); +} catch (error) { + await page.screenshot({ path: path.join(directory, 'failure.png') }).catch(() => {}); + fs.writeFileSync(path.join(directory, 'result.json'), JSON.stringify({ success: false, error: error.message, assertions: marks, pageErrors, requestFailures }, null, 2)); + console.error('EVIDENCE ' + directory); throw error; +} finally { await browser.close(); for (const dispose of disposers.reverse()) await dispose(); } diff --git a/src/client/App.tsx b/src/client/App.tsx index 7ef82186..7db93fca 100644 --- a/src/client/App.tsx +++ b/src/client/App.tsx @@ -11,6 +11,7 @@ import { ResearchPanel } from './ResearchPanel'; import { EnginePanel } from './EnginePanel'; import { ModelCenter } from './ModelCenter'; import { ProjectMemoryPanel } from './ProjectMemoryPanel'; +import { SkillCenter } from './SkillCenter'; const activeStates = ['running', 'awaiting_approval', 'stopping']; const defaultConfig: Config = { mode: 'demo', baseUrl: 'http://127.0.0.1:11434/v1', model: '', contextLimit: 16000, maxSteps: 12, maxOutputTokens: 2048, hasKey: false, maxRunDurationMs: 600000, maxRunTokens: 200000, maxTaskTokens: 1000000 }; @@ -68,6 +69,7 @@ export default function App() { const [engineOpen, setEngineOpen] = useState(false); const [modelCenterOpen, setModelCenterOpen] = useState(false); const [memoryOpen, setMemoryOpen] = useState(false); + const [skillsOpen, setSkillsOpen] = useState(false); const [researchDocs, setResearchDocs] = useState([]); const [report, setReport] = useState<{ title: string; content: string } | null>(null); const chatEnd = useRef(null); @@ -510,6 +512,7 @@ export default function App() {
本地项目{session ? : 等待新任务}
openDiagnostics()}> + setSkillsOpen(true)} disabled={!selectedProject}> showInspector('task')}> setEngineOpen(true)} disabled={!session}> void openRea()} disabled={!selectedProject || creatingSession}> @@ -555,6 +558,7 @@ export default function App() { {researchOpen && setResearchOpen(false)}>
{report && }
} {modelCenterOpen && setModelCenterOpen(false)}> { setModelCenterOpen(false); openSettings(); }} />} {memoryOpen && selectedProject && setMemoryOpen(false)}>} + {skillsOpen && selectedProject && setSkillsOpen(false)}>} {toast &&
{toast} setToast('')}>
}
); diff --git a/src/client/RequestContextPanel.tsx b/src/client/RequestContextPanel.tsx index b720bce3..080c506c 100644 --- a/src/client/RequestContextPanel.tsx +++ b/src/client/RequestContextPanel.tsx @@ -40,6 +40,7 @@ export function RequestContextPanel({ session, runId, openArtifact, onError }: {
历史记录
保留 {plan.retainedMessages} 条 · 保存 {plan.archivedGroups} 组原记录
{!!plan.workingSetEntries && <>
当前任务依据
{plan.workingSetEntries} 项代码与执行结果
} {!!plan.projectMemoryEntries && <>
项目记忆
{plan.projectMemoryEntries} 条来源已核对的记录
} + {!!plan.skillCatalogEntries && <>
技能目录
{plan.skillCatalogEntries} 项本次目录记录
}
发送内容
{number(plan.requestBytes)} B{plan.requestSha256.slice(0, 16)}

估算包含系统提示、工具定义和历史。任务要求完整保留;省略的原记录可从本机工件检索。实际用量以模型服务为准。

@@ -49,6 +50,7 @@ export function RequestContextPanel({ session, runId, openArtifact, onError }: { {plan.workingSetArtifactId && } {plan.latestToolsArtifactId && } {plan.projectMemoryArtifactId && } + {plan.skillCatalogArtifactId && } {!!plan.archivedGroups && }
{historyId && setHistoryId('')} openArtifact={id => { setHistoryId(''); openArtifact(id); }} />} diff --git a/src/client/SkillCenter.css b/src/client/SkillCenter.css new file mode 100644 index 00000000..242a80c7 --- /dev/null +++ b/src/client/SkillCenter.css @@ -0,0 +1,70 @@ +.skill-center { color: #27394b; --skill-line: #c8d2dc; --skill-surface: #f3f6f9; } +.skill-heading { display: flex; align-items: start; justify-content: space-between; gap: 20px; margin-bottom: 18px; } +.skill-kicker { display: flex; align-items: center; gap: 7px; color: #516d85; font-size: 11px; font-weight: 700; letter-spacing: .07em; } +.skill-heading h3 { margin: 9px 0; font: 700 23px/1.4 'Microsoft YaHei UI', 'Segoe UI', sans-serif; color: #16324c; } +.skill-heading p { max-width: 590px; margin: 0; color: #62758a; font-size: 13px; line-height: 1.7; } +.skill-heading > button { flex-shrink: 0; } +.skill-status-bar { display: flex; align-items: center; flex-wrap: wrap; gap: 12px 22px; border-block: 1px solid var(--skill-line); padding: 13px 2px; margin-bottom: 18px; font-size: 12px; color: #486077; } +.skill-status-bar > span { display: inline-flex; align-items: center; gap: 7px; } +.skill-light { width: 7px; height: 7px; background: #307f72; border-radius: 50%; } +.skill-list { display: grid; gap: 14px; } +.skill-row { border: 1px solid var(--skill-line); border-left: 4px solid #647f99; background: #fff; padding: 18px; border-radius: 6px; } +.skill-row.skill-changed, .skill-row.skill-unavailable { border-left-color: #ab712c; } +.skill-row-title { display: flex; align-items: start; gap: 11px; } +.skill-row-title > svg { margin-top: 3px; color: #4f708e; flex-shrink: 0; } +.skill-row-title > div { flex: 1; min-width: 0; } +.skill-row h4 { margin: 0 0 6px; font-size: 15px; color: #213f59; overflow-wrap: anywhere; } +.skill-row h4 span { margin-left: 9px; font: 500 11px/1.4 Consolas, monospace; color: #697e91; } +.skill-row-title p { margin: 0; font-size: 12px; color: #63788b; line-height: 1.6; overflow-wrap: anywhere; } +.skill-switch-state { border: 1px solid #d2dce5; color: #6b7d8b; padding: 4px 7px; font-size: 11px; white-space: nowrap; border-radius: 4px; } +.skill-switch-state.on { color: #266b5d; background: #edf6f2; border-color: #b7d4c9; } +.skill-source { margin: 15px 0; display: flex; align-items: center; gap: 8px 16px; flex-wrap: wrap; font-size: 11px; color: #698096; } +.skill-source code, .skill-revision-list code, .skill-snapshot > code { font: 11px/1.6 Consolas, 'Cascadia Code', monospace; overflow-wrap: anywhere; } +.skill-source-state { color: #35746a; font-weight: 600; } +.skill-source-state.changed, .skill-source-state.unavailable { color: #986324; } +.skill-path { flex: 0 0 100%; color: #5f7489; } +.skill-controls { display: flex; gap: 9px; } +.skill-revisions { border-top: 1px solid #e1e7ed; margin-top: 15px; padding-top: 12px; } +.skill-revisions summary { color: #5d7287; font-size: 12px; cursor: pointer; min-height: 25px; } +.skill-revision-list { display: grid; gap: 8px; margin: 10px 0; } +.skill-revision-list > div { display: flex; align-items: center; gap: 12px; font-size: 12px; flex-wrap: wrap; } +.skill-refresh { display: flex; align-items: end; gap: 10px; margin-top: 14px; } +.skill-refresh label { display: grid; gap: 5px; font-size: 11px; } +.skill-refresh input { max-width: 160px; } +.skill-alert, .skill-notice { display: flex; gap: 8px; align-items: start; padding: 12px; font-size: 12px; line-height: 1.6; overflow-wrap: anywhere; border: 1px solid #d7c3ba; color: #95513c; background: #fff6f1; border-radius: 4px; } +.skill-notice { color: #34695d; background: #eff7f3; border-color: #bfd8cb; } +.skill-alert svg, .skill-notice svg { flex-shrink: 0; margin-top: 2px; } +.skill-warning { color: #916126; font-size: 12px; line-height: 1.6; overflow-wrap: anywhere; } +.skill-empty { display: grid; gap: 10px; justify-items: center; text-align: center; padding: 30px 14px; color: #688098; border: 1px dashed #cad7e1; border-radius: 6px; margin: 14px 0; } +.skill-empty strong { color: #36566f; font-size: 14px; } +.skill-empty p { font-size: 12px; margin: 0; line-height: 1.7; } +.skill-register { border: 1px solid var(--skill-line); border-radius: 6px; padding: 18px; margin-top: 20px; background: var(--skill-surface); } +.skill-register-heading { display: flex; gap: 10px; align-items: center; justify-content: space-between; margin-bottom: 16px; flex-wrap: wrap; } +.skill-register-heading h4 { display: flex; align-items: center; gap: 6px; margin: 0; font-size: 14px; } +.skill-register-heading > span { font-size: 11px; color: #6f8193; } +.skill-form-grid { display: grid; grid-template-columns: minmax(0, 1fr) minmax(0, .4fr); gap: 12px; } +.skill-form-grid label { display: grid; gap: 6px; font-size: 12px; font-weight: 600; } +.skill-center input, .skill-center textarea { width: 100%; min-width: 0; background: #fff; border: 1px solid #c8d4df; border-radius: 4px; padding: 9px 10px; font: 13px/1.5 'Segoe UI', 'Microsoft YaHei UI', sans-serif; color: #263d52; } +.skill-center input:focus-visible, .skill-center textarea:focus-visible, .skill-center summary:focus-visible, .skill-snapshot pre:focus-visible { outline: 2px solid #4f7b9e; outline-offset: 2px; } +.skill-full { grid-column: 1 / -1; } +.skill-register footer { margin-top: 16px; display: flex; justify-content: space-between; align-items: center; gap: 12px; font-size: 11px; color: #6c8297; } +.skill-snapshot { margin-top: 18px; border: 1px solid #aac0d1; border-radius: 6px; overflow: hidden; } +.skill-snapshot header { display: flex; align-items: center; justify-content: space-between; padding: 10px 14px; background: #e8f0f6; font-size: 12px; gap: 8px; } +.skill-snapshot p { margin: 12px 14px; color: #63788b; font-size: 12px; line-height: 1.6; } +.skill-snapshot > code { display: block; margin: 0 14px; color: #55718b; } +.skill-snapshot pre { padding: 14px; margin: 10px 0 0; max-height: 330px; overflow: auto; white-space: pre-wrap; overflow-wrap: anywhere; font: 12px/1.8 Consolas, 'Microsoft YaHei UI', monospace; background: #f4f7fa; } +@media (max-width: 620px) { + .skill-heading { flex-direction: column; gap: 13px; } + .skill-heading h3 { font-size: 21px; } + .skill-row, .skill-register { padding: 13px; } + .skill-row-title { gap: 8px; } + .skill-row-title > svg { display: none; } + .skill-row h4 span { display: block; margin: 5px 0 0; } + .skill-status-bar { gap: 10px 16px; } + .skill-controls > button { flex: 1; } + .skill-center button, .skill-center summary { min-height: 44px; } + .skill-form-grid { grid-template-columns: minmax(0, 1fr); } + .skill-register footer { flex-direction: column; align-items: stretch; } + .skill-register footer > button { justify-content: center; } + .skill-revision-list { gap: 4px; } +} diff --git a/src/client/SkillCenter.tsx b/src/client/SkillCenter.tsx new file mode 100644 index 00000000..048703a4 --- /dev/null +++ b/src/client/SkillCenter.tsx @@ -0,0 +1,63 @@ +import { useEffect, useRef, useState } from 'react'; +import type { FormEvent } from 'react'; +import { BookOpenText, Check, CircleAlert, FileText, LoaderCircle, Plus, Power, RefreshCw, ShieldCheck } from 'lucide-react'; +import { api } from './api'; +import './SkillCenter.css'; + +type SkillVersion = { revision: number; version: string; source: { path: string; sha256: string; bytes: number }; snapshotSha256: string; createdAt: string }; +type Skill = SkillVersion & { id: string; projectId: string; name: string; description: string; enabled: boolean; configurationRevision: number; updatedAt: string; status: string; reason: string; revisions: SkillVersion[] }; +type SkillView = { skills: Skill[]; projectId: string; revision: number; modelRequests: number }; +type Snapshot = SkillVersion & { id: string; content: string }; +const statusNames: Record = { current: '来源一致', changed: '来源已变化', unavailable: '来源不可用' }; + +export function SkillCenter({ projectId, busy }: { projectId: string; busy: boolean }) { + const [view, setView] = useState(null), [working, setWorking] = useState(false); + const [error, setError] = useState(''), [notice, setNotice] = useState(''); + const [snapshot, setSnapshot] = useState(null), [versions, setVersions] = useState>({}); + const [draft, setDraft] = useState({ name: '', description: '', path: '', version: '1.0.0' }); + const generation = useRef(0); + const url = '/projects/' + projectId + '/skills'; + const load = async (current = generation.current) => { const result = await api(url); if (current === generation.current) setView(result); }; + useEffect(() => { + const current = ++generation.current; setView(null); setSnapshot(null); setError(''); + void load(current).catch(cause => { if (current === generation.current) setError(String(cause.message ?? cause)); }); + return () => { generation.current++; }; + }, [projectId]); + const perform = async (action: () => Promise, success: string) => { + const current = generation.current; setWorking(true); setError(''); setNotice(''); + try { await action(); if (current === generation.current) { setNotice(success); await load(current); } } + catch (cause) { if (current === generation.current) setError(cause instanceof Error ? cause.message : String(cause)); } + finally { if (current === generation.current) setWorking(false); } + }; + const register = (event: FormEvent) => { + event.preventDefault(); + void perform(async () => { await api(url, draft); }, '技能已登记。审查原文后,可以为当前项目启用。'); + }; + const read = (skill: Skill, revision: number) => { + const current = generation.current; + void perform(async () => { + const value = await api(url + '/content?id=' + skill.id + '&revision=' + revision); + if (current === generation.current) setSnapshot(value); + }, '已读取保存的原修订。'); + }; + const skills = view?.skills ?? [], active = skills.filter(value => value.enabled && value.status === 'current').length; + const locked = busy || working; + return
+
项目能力 / SKILLS

让工作流程有据可查

登记本地技能,在本项目任务中按需读取。启用前先审查内容,来源改变后需要重新确认。

+
{active} 项可用{skills.length} 项已登记沿用项目权限与审查
+ {error &&

{error}

} + {notice &&

{notice}

} + {busy &&

项目正在执行,停止任务后可以修改技能配置。

} +
{skills.map(skill =>
+

{skill.name}v{skill.version}

{skill.description}

{skill.enabled ? '已启用' : '已停用'}
+
{statusNames[skill.status]}修订 {skill.revision}SHA256 {skill.source.sha256.slice(0, 16)}{skill.source.bytes.toLocaleString()} B{skill.source.path}
+ {skill.reason &&

{skill.reason}

} +
+
版本与来源记录 · {skill.revisions.length} 个修订
{skill.revisions.map(version =>
r{version.revision} · {version.version}{version.source.sha256.slice(0, 16)}
)}
{ event.preventDefault(); void perform(() => api(url + '/refresh', { id: skill.id, revision: skill.revision, configurationRevision: skill.configurationRevision, version: versions[skill.id] || skill.version }), '新修订已登记,并已停用。请审查后重新启用。'); }} className="skill-refresh">
+
)}
+ {!view && !error &&

正在核对已登记技能

} + {view && !skills.length &&
为项目接入第一项技能

选择你已审查的 SKILL.md,填写名称与用途。登记后默认停用。

} + {snapshot &&
原文审查 · {snapshot.version} / r{snapshot.revision}

这是保存的技能参考流程,执行仍需遵循项目权限。附带脚本和文件不会自动运行。

快照 SHA256 {snapshot.snapshotSha256}
{snapshot.content}
} +

登记本地技能

UTF-8 · SKILL.md · 最大 64KB