docs(guide): rewrite CLAUDE.md with ZCLAW-first perspective

Major changes:
- Shift from "OpenFang desktop client" to "independent AI Agent desktop app"
- Add decision principle: "Is this useful for ZCLAW? Does it affect ZCLAW?"
- Simplify project structure and tech stack sections
- Replace OpenClaw vs OpenFang comparison with unified backend approach
- Consolidate troubleshooting from scattered sections into organized FAQ
- Update Hands system documentation with 8 capabilities and status
- Stream
This commit is contained in:
iven
2026-03-20 19:30:09 +08:00
parent 3518fc8ece
commit 6f72442531
63 changed files with 8920 additions and 857 deletions

View File

@@ -30,7 +30,11 @@ export function TeamList({ onSelectTeam, selectedTeamId }: TeamListProps) {
const [isCreating, setIsCreating] = useState(false);
useEffect(() => {
loadTeams();
try {
loadTeams();
} catch (err) {
console.error('[TeamList] Failed to load teams:', err);
}
}, [loadTeams]);
const handleSelectTeam = (teamId: string) => {
@@ -93,12 +97,17 @@ export function TeamList({ onSelectTeam, selectedTeamId }: TeamListProps) {
}
};
// Merge clones and agents for display
const availableAgents = clones.length > 0 ? clones : agents.map(a => ({
id: a.id,
name: a.name,
role: '默认助手',
}));
// Merge clones and agents for display - normalize to common type with defensive checks
const availableAgents: Array<{ id: string; name: string; role?: string }> =
(clones && clones.length > 0)
? clones.map(c => ({ id: c.id, name: c.name, role: c.role }))
: (agents && agents.length > 0)
? agents.map(a => ({
id: a.id,
name: a.name,
role: '默认助手',
}))
: [];
return (
<div className="h-full flex flex-col">
@@ -106,12 +115,12 @@ export function TeamList({ onSelectTeam, selectedTeamId }: TeamListProps) {
<div className="p-3 border-b border-gray-200 dark:border-gray-700">
<div className="flex items-center justify-between">
<h3 className="text-xs font-semibold text-gray-500 dark:text-gray-400 uppercase tracking-wider">
Teams
</h3>
<button
onClick={() => setShowCreateModal(true)}
className="p-1 hover:bg-gray-100 dark:hover:bg-gray-800 rounded transition-colors"
title="Create Team"
title="创建团队"
>
<Plus className="w-4 h-4 text-gray-400 hover:text-gray-600 dark:hover:text-gray-200" />
</button>
@@ -124,7 +133,7 @@ export function TeamList({ onSelectTeam, selectedTeamId }: TeamListProps) {
<div className="bg-white dark:bg-gray-800 rounded-xl shadow-xl w-80 max-h-[90vh] overflow-y-auto">
<div className="p-4 border-b border-gray-200 dark:border-gray-700">
<div className="flex items-center justify-between">
<h3 className="text-sm font-semibold text-gray-900 dark:text-white">Create Team</h3>
<h3 className="text-sm font-semibold text-gray-900 dark:text-white"></h3>
<button
onClick={() => setShowCreateModal(false)}
className="p-1 hover:bg-gray-100 dark:hover:bg-gray-700 rounded"
@@ -138,51 +147,51 @@ export function TeamList({ onSelectTeam, selectedTeamId }: TeamListProps) {
{/* Team Name */}
<div>
<label className="block text-xs font-medium text-gray-700 dark:text-gray-300 mb-1">
Team Name *
*
</label>
<input
type="text"
value={teamName}
onChange={(e) => setTeamName(e.target.value)}
placeholder="e.g., Dev Team Alpha"
className="w-full px-3 py-2 text-sm border border-gray-200 dark:border-gray-600 rounded-lg bg-white dark:bg-gray-700 text-gray-900 dark:text-white focus:outline-none focus:ring-2 focus:ring-blue-500"
placeholder="例如:开发团队 Alpha"
className="w-full px-3 py-2 text-sm border border-gray-200 dark:border-gray-600 rounded-lg bg-white dark:bg-gray-700 text-gray-900 dark:text-white focus:outline-none focus:ring-2 focus:ring-gray-400"
/>
</div>
{/* Team Description */}
<div>
<label className="block text-xs font-medium text-gray-700 dark:text-gray-300 mb-1">
Description
</label>
<textarea
value={teamDescription}
onChange={(e) => setTeamDescription(e.target.value)}
placeholder="What will this team work on?"
placeholder="这个团队将负责什么工作?"
rows={2}
className="w-full px-3 py-2 text-sm border border-gray-200 dark:border-gray-600 rounded-lg bg-white dark:bg-gray-700 text-gray-900 dark:text-white focus:outline-none focus:ring-2 focus:ring-blue-500 resize-none"
className="w-full px-3 py-2 text-sm border border-gray-200 dark:border-gray-600 rounded-lg bg-white dark:bg-gray-700 text-gray-900 dark:text-white focus:outline-none focus:ring-2 focus:ring-gray-400 resize-none"
/>
</div>
{/* Collaboration Pattern */}
<div>
<label className="block text-xs font-medium text-gray-700 dark:text-gray-300 mb-1">
Collaboration Pattern
</label>
<select
value={teamPattern}
onChange={(e) => setTeamPattern(e.target.value as typeof teamPattern)}
className="w-full px-3 py-2 text-sm border border-gray-200 dark:border-gray-600 rounded-lg bg-white dark:bg-gray-700 text-gray-900 dark:text-white focus:outline-none focus:ring-2 focus:ring-blue-500"
className="w-full px-3 py-2 text-sm border border-gray-200 dark:border-gray-600 rounded-lg bg-white dark:bg-gray-700 text-gray-900 dark:text-white focus:outline-none focus:ring-2 focus:ring-gray-400"
>
<option value="sequential">Sequential (Task by task)</option>
<option value="parallel">Parallel (Concurrent work)</option>
<option value="pipeline">Pipeline (Output feeds next)</option>
<option value="sequential"></option>
<option value="parallel"></option>
<option value="pipeline">线</option>
</select>
</div>
{/* Agent Selection */}
<div>
<label className="block text-xs font-medium text-gray-700 dark:text-gray-300 mb-2">
Select Agents ({selectedAgents.length} selected) *
( {selectedAgents.length} ) *
</label>
<div className="space-y-2 max-h-40 overflow-y-auto">
{availableAgents.map((agent) => (
@@ -195,7 +204,7 @@ export function TeamList({ onSelectTeam, selectedTeamId }: TeamListProps) {
: 'bg-gray-50 dark:bg-gray-700 border border-transparent hover:bg-gray-100 dark:hover:bg-gray-600'
}`}
>
<div className="w-6 h-6 rounded-full bg-gradient-to-br from-orange-400 to-red-500 flex items-center justify-center text-white text-xs">
<div className="w-6 h-6 rounded-full bg-gray-600 flex items-center justify-center text-white text-xs">
<Bot className="w-3 h-3" />
</div>
<span className="text-gray-900 dark:text-white truncate">{agent.name}</span>
@@ -206,7 +215,7 @@ export function TeamList({ onSelectTeam, selectedTeamId }: TeamListProps) {
))}
{availableAgents.length === 0 && (
<p className="text-xs text-gray-500 dark:text-gray-400 text-center py-2">
No agents available. Create an agent first.
</p>
)}
</div>
@@ -219,14 +228,14 @@ export function TeamList({ onSelectTeam, selectedTeamId }: TeamListProps) {
onClick={() => setShowCreateModal(false)}
className="flex-1 px-4 py-2 text-sm text-gray-700 dark:text-gray-300 bg-gray-100 dark:bg-gray-700 rounded-lg hover:bg-gray-200 dark:hover:bg-gray-600 transition-colors"
>
Cancel
</button>
<button
onClick={handleCreateTeam}
disabled={!teamName.trim() || selectedAgents.length === 0 || isCreating}
className="flex-1 px-4 py-2 text-sm text-white bg-blue-500 rounded-lg hover:bg-blue-600 disabled:opacity-50 disabled:cursor-not-allowed transition-colors"
className="flex-1 px-4 py-2 text-sm text-white bg-gray-700 dark:bg-gray-600 rounded-lg hover:bg-gray-800 dark:hover:bg-gray-500 disabled:opacity-50 disabled:cursor-not-allowed transition-colors"
>
{isCreating ? 'Creating...' : 'Create'}
{isCreating ? '创建中...' : '创建'}
</button>
</div>
</div>
@@ -236,15 +245,15 @@ export function TeamList({ onSelectTeam, selectedTeamId }: TeamListProps) {
{/* Team List */}
<div className="flex-1 overflow-y-auto">
{isLoading ? (
<div className="p-4 text-center text-gray-400 text-sm">Loading...</div>
) : teams.length === 0 ? (
<div className="p-4 text-center text-gray-400 text-sm">...</div>
) : !Array.isArray(teams) || teams.length === 0 ? (
<div className="p-4 text-center">
<Users className="w-8 h-8 mx-auto mb-2 text-gray-300 dark:text-gray-600" />
<p className="text-xs text-gray-400 dark:text-gray-500">
No teams yet
</p>
<p className="text-xs text-gray-400 dark:text-gray-500 mt-1">
Click + to create one
+
</p>
</div>
) : (
@@ -271,7 +280,7 @@ export function TeamList({ onSelectTeam, selectedTeamId }: TeamListProps) {
{team.members.length}
</span>
<span>·</span>
<span>{team.tasks.length} tasks</span>
<span>{team.tasks.length} </span>
</div>
</button>
))}