tkmind/memind_adm
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

feat(skills): 在技能页配置联网搜索 web 能力开关

Browse Source 
与 web 技能一并保存角色/用户默认，避免 load_skill 后缺少 web_search 工具。

Co-authored-by: Cursor <cursoragent@cursor.com>
This commit is contained in:
john
2026-07-06 16:06:39 +08:00
parent 13485558b5
commit ebcc33b367
1 changed files with 170 additions and 16 deletions
Download Patch File Download Diff File Expand all files Collapse all files
src/components/SkillSettings.tsx
+170 -16
View File
@@ -1,14 +1,23 @@
import { useCallback, useEffect, useState } from 'react';
import { useCallback, useEffect, useMemo, useState } from 'react';
import {
clearUserCapabilityOverrides,
clearUserSkillOverrides,
getRoleCapabilities,
getRoleSkills,
getUserCapabilities,
getUserSkills,
listCapabilityCatalog,
listSkillCatalog,
updateRoleCapabilities,
updateRoleSkills,
updateUserCapabilities,
updateUserSkills,
} from '../api/client';
import type { AdminUserRow, SkillDefinition, SkillMap } from '../types';
const WEB_CAPABILITY_KEY = 'web';
const WEB_SKILL_NAME = 'web';
function SkillGrid({
catalog,
values,
@@ -51,6 +60,75 @@ function SkillGrid({
);
}
function WebSearchToolPanel({
roleEnabled,
userEnabled,
showUser,
disabled,
onRoleChange,
onUserChange,
}: {
roleEnabled: boolean;
userEnabled: boolean;
showUser: boolean;
disabled?: boolean;
onRoleChange: (enabled: boolean) => void;
onUserChange: (enabled: boolean) => void;
}) {
return (
<div className="capability-grid" style={{ marginBottom: '1.25rem' }}>
<div className="capability-group">
<div className="capability-group-header">
<h3>联网搜索工具</h3>
<span className="capability-group-count">platform/web</span>
</div>
<ul>
<li className="capability-item">
<div className="capability-item-info">
<span className="capability-label">
网页搜索
<code className="skill-name-tag">{WEB_CAPABILITY_KEY}</code>
<span className="risk-pill risk-medium">风险 中</span>
</span>
<span className="muted capability-desc">
在 Agent session 挂载 <code>platform/web</code> 扩展，提供{' '}
<code>web_search</code> / <code>fetch_url</code>。需同时开启下方{' '}
<code>{WEB_SKILL_NAME}</code> 技能；用户策略 <code>network_egress=deny</code>{' '}
时会自动禁用。
</span>
</div>
{!showUser ? (
<label className="capability-toggle" aria-label="启用网页搜索">
<input
type="checkbox"
checked={roleEnabled}
disabled={disabled}
onChange={(e) => onRoleChange(e.target.checked)}
/>
<span className="toggle-track">
<span className="toggle-thumb" />
</span>
</label>
) : (
<label className="capability-toggle" aria-label="启用网页搜索">
<input
type="checkbox"
checked={userEnabled}
disabled={disabled}
onChange={(e) => onUserChange(e.target.checked)}
/>
<span className="toggle-track">
<span className="toggle-thumb" />
</span>
</label>
)}
</li>
</ul>
</div>
</div>
);
}
export function SkillSettings({
users,
userId,
@@ -62,8 +140,12 @@ export function SkillSettings({
}) {
const [catalog, setCatalog] = useState<SkillDefinition[]>([]);
const [roleSkills, setRoleSkills] = useState<SkillMap>({});
const [roleWebEnabled, setRoleWebEnabled] = useState(false);
const [hasWebCapabilityCatalog, setHasWebCapabilityCatalog] = useState(false);
const [selectedUserId, setSelectedUserId] = useState(userId ?? '');
const [userSkills, setUserSkills] = useState<SkillMap>({});
const [userWebEnabled, setUserWebEnabled] = useState(false);
const [userWebOverride, setUserWebOverride] = useState<boolean | null>(null);
const [userOverrides, setUserOverrides] = useState<SkillMap>({});
const [loading, setLoading] = useState(true);
const [message, setMessage] = useState<string | null>(null);
@@ -73,12 +155,16 @@ export function SkillSettings({
setLoading(true);
setError(null);
try {
const [catalogItems, roleState] = await Promise.all([
const [catalogItems, roleState, capabilityCatalog, roleCapabilities] = await Promise.all([
listSkillCatalog(),
getRoleSkills('user'),
listCapabilityCatalog(),
getRoleCapabilities('user'),
]);
setCatalog(catalogItems);
setRoleSkills(roleState.skills);
setHasWebCapabilityCatalog(capabilityCatalog.some((item) => item.key === WEB_CAPABILITY_KEY));
setRoleWebEnabled(Boolean(roleCapabilities.capabilities[WEB_CAPABILITY_KEY]));
} catch (err) {
setError(err instanceof Error ? err.message : '加载技能目录失败');
} finally {
@@ -89,13 +175,24 @@ export function SkillSettings({
const loadUserSkills = useCallback(async (userId: string) => {
if (!userId) {
setUserSkills({});
setUserWebEnabled(false);
setUserWebOverride(null);
setUserOverrides({});
return;
}
try {
const state = await getUserSkills(userId);
const [state, capabilityState] = await Promise.all([
getUserSkills(userId),
getUserCapabilities(userId),
]);
setUserSkills(state.skills);
setUserOverrides(state.overrides);
setUserWebEnabled(Boolean(capabilityState.capabilities[WEB_CAPABILITY_KEY]));
setUserWebOverride(
Object.prototype.hasOwnProperty.call(capabilityState.overrides, WEB_CAPABILITY_KEY)
? Boolean(capabilityState.overrides[WEB_CAPABILITY_KEY])
: null,
);
} catch (err) {
setError(err instanceof Error ? err.message : '加载用户技能失败');
}
@@ -119,9 +216,14 @@ export function SkillSettings({
setMessage(null);
setError(null);
try {
const result = await updateRoleSkills('user', roleSkills);
setRoleSkills(result.skills);
setMessage('普通用户默认技能已保存，并已同步到各用户工作区');
const [skillsResult] = await Promise.all([
updateRoleSkills('user', roleSkills),
hasWebCapabilityCatalog
? updateRoleCapabilities('user', { [WEB_CAPABILITY_KEY]: roleWebEnabled })
: Promise.resolve(null),
]);
setRoleSkills(skillsResult.skills);
setMessage('普通用户默认技能与联网工具已保存，并已同步到各用户工作区');
} catch (err) {
setError(err instanceof Error ? err.message : '保存失败');
}
@@ -132,10 +234,15 @@ export function SkillSettings({
setMessage(null);
setError(null);
try {
const result = await updateUserSkills(selectedUserId, userSkills);
setUserSkills(result.skills);
const [skillsResult] = await Promise.all([
updateUserSkills(selectedUserId, userSkills),
hasWebCapabilityCatalog
? updateUserCapabilities(selectedUserId, { [WEB_CAPABILITY_KEY]: userWebEnabled })
: Promise.resolve(null),
]);
setUserSkills(skillsResult.skills);
await loadUserSkills(selectedUserId);
setMessage('用户技能已保存，并已安装到其 MindSpace 发布目录');
setMessage('用户技能与联网工具已保存，并已安装到其 MindSpace 发布目录');
} catch (err) {
setError(err instanceof Error ? err.message : '保存失败');
}
@@ -146,15 +253,28 @@ export function SkillSettings({
setMessage(null);
setError(null);
try {
await clearUserSkillOverrides(selectedUserId);
await Promise.all([
clearUserSkillOverrides(selectedUserId),
hasWebCapabilityCatalog ? clearUserCapabilityOverrides(selectedUserId) : Promise.resolve(),
]);
await loadUserSkills(selectedUserId);
setMessage('已恢复为角色默认技能');
setMessage('已恢复为角色默认技能与联网工具');
} catch (err) {
setError(err instanceof Error ? err.message : '重置失败');
}
};
const regularUsers = users.filter((user) => user.role === 'user');
const webSkillEnabledForRole = Boolean(roleSkills[WEB_SKILL_NAME]);
const webSkillEnabledForUser = Boolean(userSkills[WEB_SKILL_NAME]);
const webMismatchRole = useMemo(
() => hasWebCapabilityCatalog && webSkillEnabledForRole && !roleWebEnabled,
[hasWebCapabilityCatalog, webSkillEnabledForRole, roleWebEnabled],
);
const webMismatchUser = useMemo(
() => hasWebCapabilityCatalog && webSkillEnabledForUser && !userWebEnabled,
[hasWebCapabilityCatalog, webSkillEnabledForUser, userWebEnabled],
);
return (
<section className="admin-card">
@@ -166,18 +286,36 @@ export function SkillSettings({
</div>
<p className="muted capability-intro">
勾选后技能会安装到用户 <code>MindSpace/用户名/.agents/skills/</code>，对话中可通过 load_skill
使用。开通「静态页面发布」技能会自动启用页面写入能力。
使用。开通「静态页面发布」技能会自动启用页面写入能力。联网搜索需在下方同时开启{' '}
<strong>网页搜索工具</strong> 与 <code>web</code> 技能。
</p>
{error && <p className="banner banner-error">{error}</p>}
{message && <p className="banner banner-info">{message}</p>}
{loading ? (
<p className="muted">加载中…</p>
) : !hasWebCapabilityCatalog ? (
<p className="banner banner-error">
当前 Portal 能力目录缺少 <code>web</code>，请更新 Memind 后端并重启 admin-api。
</p>
) : catalog.length === 0 ? (
<p className="muted">暂无平台技能，请在 Memind/skills/ 下添加 SKILL.md</p>
) : (
<>
{!userOnly && (
<>
<h3 className="capability-section-title">普通用户默认</h3>
<WebSearchToolPanel
roleEnabled={roleWebEnabled}
userEnabled={userWebEnabled}
showUser={false}
onRoleChange={setRoleWebEnabled}
onUserChange={setUserWebEnabled}
/>
{webMismatchRole ? (
<p className="banner banner-error">
已开启 <code>web</code> 技能但未启用网页搜索工具，Agent 将无法使用 web_search。
</p>
) : null}
<h3 className="capability-section-title">普通用户默认技能</h3>
<SkillGrid
catalog={catalog}
@@ -186,13 +324,13 @@ export function SkillSettings({
/>
<div className="capability-actions">
<button type="button" className="send-btn" onClick={() => void saveRoleDefaults()}>
保存默认技能
保存默认配置
</button>
</div>
</>
)}
{!userOnly && <h3 className="capability-section-title">单用户技能覆盖</h3>}
{!userOnly && <h3 className="capability-section-title">单用户覆盖</h3>}
{!userOnly && (
<div className="admin-form capability-user-picker">
<select value={selectedUserId} onChange={(e) => setSelectedUserId(e.target.value)}>
@@ -207,11 +345,27 @@ export function SkillSettings({
)}
{selectedUserId && (
<>
{userWebOverride != null && (
<p className="muted">联网工具已单独覆盖为 {userWebOverride ? '开启' : '关闭'}。</p>
)}
<WebSearchToolPanel
roleEnabled={roleWebEnabled}
userEnabled={userWebEnabled}
showUser
onRoleChange={setRoleWebEnabled}
onUserChange={setUserWebEnabled}
/>
{webMismatchUser ? (
<p className="banner banner-error">
该用户已开启 <code>web</code> 技能但未启用网页搜索工具。
</p>
) : null}
{Object.keys(userOverrides).length > 0 && (
<p className="muted">
已设置 {Object.keys(userOverrides).length} 项单独覆盖。
已设置 {Object.keys(userOverrides).length} 项技能单独覆盖。
</p>
)}
<h3 className="capability-section-title">用户技能</h3>
<SkillGrid
catalog={catalog}
values={userSkills}
@@ -221,7 +375,7 @@ export function SkillSettings({
/>
<div className="capability-actions">
<button type="button" className="send-btn" onClick={() => void saveUserOverrides()}>
保存用户技能
保存用户配置
</button>
<button type="button" className="ghost-btn" onClick={() => void resetUserOverrides()}>
恢复角色默认