docs: stabilization directive + TRUTH document + AI session prompts + dockerignore

- STABILIZATION_DIRECTIVE.md: feature freeze rules, banned actions, priorities
- TRUTH.md: single source of truth for system state (crate counts, store counts)
- AI_SESSION_PROMPTS.md: three-layer prompt system for AI sessions
- Industry agent delivery design spec
- Stabilization test suite for regression prevention
- Delete stale ISSUE-TRACKER.md
- Add .dockerignore for container builds
- Add brainstorm session artifacts
This commit is contained in:
iven
2026-04-03 00:29:16 +08:00
parent 5c74e74f2a
commit d8e2954d73
22 changed files with 2035 additions and 363 deletions

View File

@@ -0,0 +1 @@
{"reason":"owner process exited","timestamp":1775026601420}

View File

@@ -0,0 +1 @@
1627

View File

@@ -0,0 +1,68 @@
<h2>ZCLAW 功能优先级矩阵</h2>
<p class="subtitle">哪些功能能让用户"啊"的一声觉得值?点击选择你认为的杀手级功能(可多选)</p>
<div class="options" data-multiselect>
<div class="option" data-choice="smart-chat" onclick="toggleSelect(this)">
<div class="letter">A</div>
<div class="content">
<h3>智能对话(深度优化)</h3>
<p>多模型无缝切换、流式响应、上下文记忆闭环、Tool Call 可视化。<br><strong>现状:</strong>基础已好,需打磨体验细节(消息虚拟化、搜索、导出)</p>
</div>
</div>
<div class="option" data-choice="hands" onclick="toggleSelect(this)">
<div class="letter">B</div>
<div class="content">
<h3>自主 Hands数字员工</h3>
<p>Browser 自动化、深度研究、数据采集、Twitter 运营——让 AI 真正干活。<br><strong>现状:</strong>9个 Hand 有实现,但需真实场景验证 + 可视化执行流程</p>
</div>
</div>
<div class="option" data-choice="pipeline" onclick="toggleSelect(this)">
<div class="letter">C</div>
<div class="content">
<h3>Pipeline 工作流</h3>
<p>拖拽式自动化编排:多步骤、多模型、并行/条件分支、定时触发。<br><strong>现状:</strong>引擎完成、UI 有基础版,需完善可视化编辑器 + 模板市场</p>
</div>
</div>
<div class="option" data-choice="memory" onclick="toggleSelect(this)">
<div class="letter">D</div>
<div class="content">
<h3>记忆与成长系统</h3>
<p>跨会话记忆、事实提取、偏好学习、知识图谱——AI 越用越懂你。<br><strong>现状:</strong>Growth 系统完成Fact 提取可用,需增强检索质量和可视化</p>
</div>
</div>
<div class="option" data-choice="skills" onclick="toggleSelect(this)">
<div class="letter">E</div>
<div class="content">
<h3>技能市场</h3>
<p>75+ 预置技能 + 社区技能分享 + 一键安装——AI 能力的 App Store。<br><strong>现状:</strong>SKILL.md 体系完成需技能发现UI + 安装/卸载流程</p>
</div>
</div>
<div class="option" data-choice="gateway" onclick="toggleSelect(this)">
<div class="letter">F</div>
<div class="content">
<h3>LLM 网关SaaS 变现核心)</h3>
<p>Key Pool 代理、用量计费、配额管理、组织级 API Key 管理——企业买单的理由。<br><strong>现状:</strong>Relay+Key Pool 完成,缺计费/配额/支付闭环</p>
</div>
</div>
<div class="option" data-choice="multi-agent" onclick="toggleSelect(this)">
<div class="letter">G</div>
<div class="content">
<h3>多 Agent 协作</h3>
<p>Director 编排、A2A 协议、角色分配——多个 AI 角色协同解决复杂问题。<br><strong>现状:</strong>代码完成但 feature-gated未接入桌面端</p>
</div>
</div>
<div class="option" data-choice="admin" onclick="toggleSelect(this)">
<div class="letter">H</div>
<div class="content">
<h3>Admin V2 管理面板</h3>
<p>用户管理、模型配置、用量统计、操作审计——SaaS 运维必备。<br><strong>现状:</strong>10个页面完成需测试 + 告警 + 数据看板</p>
</div>
</div>
</div>

View File

@@ -0,0 +1,123 @@
<h2>ZCLAW 系统现状全景</h2>
<p class="subtitle">基于代码库深度扫描2026-04-01</p>
<div class="section">
<h3>技术架构成熟度</h3>
<div style="display:grid; grid-template-columns: 1fr 1fr; gap: 12px; margin-top: 12px;">
<div style="background: #1a2332; border-radius: 8px; padding: 16px; border-left: 4px solid #22c55e;">
<div style="font-size: 13px; color: #94a3b8;">核心类型 (zclaw-types)</div>
<div style="font-size: 20px; font-weight: 700; color: #22c55e;">95%</div>
<div style="font-size: 12px; color: #64748b;">ID/Message/Event/Capability/Error 全套</div>
</div>
<div style="background: #1a2332; border-radius: 8px; padding: 16px; border-left: 4px solid #22c55e;">
<div style="font-size: 13px; color: #94a3b8;">存储层 (zclaw-memory)</div>
<div style="font-size: 20px; font-weight: 700; color: #22c55e;">90%</div>
<div style="font-size: 12px; color: #64748b;">SQLite + Fact提取 + KV Store</div>
</div>
<div style="background: #1a2332; border-radius: 8px; padding: 16px; border-left: 4px solid #22c55e;">
<div style="font-size: 13px; color: #94a3b8;">运行时 (zclaw-runtime)</div>
<div style="font-size: 20px; font-weight: 700; color: #22c55e;">90%</div>
<div style="font-size: 12px; color: #64748b;">4驱动 + 11中间件 + Agent Loop</div>
</div>
<div style="background: #1a2332; border-radius: 8px; padding: 16px; border-left: 4px solid #eab308;">
<div style="font-size: 13px; color: #94a3b8;">协调层 (zclaw-kernel)</div>
<div style="font-size: 20px; font-weight: 700; color: #eab308;">85%</div>
<div style="font-size: 12px; color: #64748b;">注册/调度/事件/Director(feature-gated)</div>
</div>
<div style="background: #1a2332; border-radius: 8px; padding: 16px; border-left: 4px solid #22c55e;">
<div style="font-size: 13px; color: #94a3b8;">SaaS 后端 (zclaw-saas)</div>
<div style="font-size: 20px; font-weight: 700; color: #22c55e;">95%</div>
<div style="font-size: 12px; color: #64748b;">76+ API / 17表 / Relay代理 / Key Pool</div>
</div>
<div style="background: #1a2332; border-radius: 8px; padding: 16px; border-left: 4px solid #22c55e;">
<div style="font-size: 13px; color: #94a3b8;">桌面端 (Tauri+React)</div>
<div style="font-size: 20px; font-weight: 700; color: #22c55e;">85%</div>
<div style="font-size: 12px; color: #64748b;">60+组件 / 13 Store / 3连接模式</div>
</div>
<div style="background: #1a2332; border-radius: 8px; padding: 16px; border-left: 4px solid #22c55e;">
<div style="font-size: 13px; color: #94a3b8;">技能系统 (75 SKILL.md)</div>
<div style="font-size: 20px; font-weight: 700; color: #22c55e;">80%</div>
<div style="font-size: 12px; color: #64748b;">PromptOnly可执行 / Wasm+Native未完成</div>
</div>
<div style="background: #1a2332; border-radius: 8px; padding: 16px; border-left: 4px solid #22c55e;">
<div style="font-size: 13px; color: #94a3b8;">安全体系</div>
<div style="font-size: 20px; font-weight: 700; color: #22c55e;">HIGH</div>
<div style="font-size: 12px; color: #64748b;">16层防御 / 渗透测试15项修复完成</div>
</div>
</div>
</div>
<div class="section">
<h3>商业基础设施 vs 商业能力</h3>
<div style="display:grid; grid-template-columns: 1fr 1fr; gap: 16px; margin-top: 12px;">
<div style="background: #0c1a0c; border: 1px solid #22c55e33; border-radius: 8px; padding: 16px;">
<h4 style="color: #22c55e; margin:0 0 10px 0;">已建成的基础设施</h4>
<ul style="margin:0; padding-left: 18px; color: #cbd5e1; font-size: 14px; line-height: 1.8;">
<li>LLM Relay 代理 (Key Pool + 429处理 + RPM/TPM)</li>
<li>每模型定价元数据 (input/output pricing)</li>
<li>用量追踪 (per-account/per-model token)</li>
<li>账户路由 (relay vs local 模式)</li>
<li>RBAC 权限体系 (3角色 + 细粒度权限)</li>
<li>Admin V2 管理面板 (10页面)</li>
<li>Docker + Nginx 部署方案</li>
<li>Admin V2 前端 (Ant Design Pro)</li>
</ul>
</div>
<div style="background: #1a0c0c; border: 1px solid #ef444433; border-radius: 8px; padding: 16px;">
<h4 style="color: #ef4444; margin:0 0 10px 0;">缺失的商业能力</h4>
<ul style="margin:0; padding-left: 18px; color: #cbd5e1; font-size: 14px; line-height: 1.8;">
<li><strong>无订阅/计费系统</strong> — 无Stripe/支付宝/微信支付</li>
<li><strong>无配额管理</strong> — quota字段已被移除</li>
<li><strong>无计划/层级定义</strong> — 无 free/pro/enterprise</li>
<li><strong>无发票/账单</strong> — 无成本计算逻辑</li>
<li><strong>无支付集成</strong> — 无任何支付网关代码</li>
</ul>
</div>
</div>
</div>
<div class="section">
<h3>核心差异化竞争力</h3>
<div style="display:grid; grid-template-columns: repeat(3, 1fr); gap: 12px; margin-top: 12px;">
<div style="background: linear-gradient(135deg, #1e293b, #0f172a); border-radius: 8px; padding: 16px; text-align: center;">
<div style="font-size: 28px; margin-bottom: 6px;"></div>
<div style="font-size: 14px; font-weight: 600; color: #e2e8f0;">Rust 原生性能</div>
<div style="font-size: 12px; color: #64748b; margin-top: 4px;">~40MB RAM / &lt;200ms 冷启动<br>vs Electron 400MB+</div>
</div>
<div style="background: linear-gradient(135deg, #1e293b, #0f172a); border-radius: 8px; padding: 16px; text-align: center;">
<div style="font-size: 28px; margin-bottom: 6px;">🤖</div>
<div style="font-size: 14px; font-weight: 600; color: #e2e8f0;">9个自主 Hands</div>
<div style="font-size: 12px; color: #64748b; margin-top: 4px;">Browser/Researcher/Twitter<br>预置数字员工</div>
</div>
<div style="background: linear-gradient(135deg, #1e293b, #0f172a); border-radius: 8px; padding: 16px; text-align: center;">
<div style="font-size: 28px; margin-bottom: 6px;">🧩</div>
<div style="font-size: 14px; font-weight: 600; color: #e2e8f0;">75+ 技能 + Pipeline</div>
<div style="font-size: 12px; color: #64748b; margin-top: 4px;">SKILL.md 声明式定义<br>12种 Pipeline Action</div>
</div>
<div style="background: linear-gradient(135deg, #1e293b, #0f172a); border-radius: 8px; padding: 16px; text-align: center;">
<div style="font-size: 28px; margin-bottom: 6px;">🇨🇳</div>
<div style="font-size: 14px; font-weight: 600; color: #e2e8f0;">中文市场原生</div>
<div style="font-size: 12px; color: #64748b; margin-top: 4px;">GLM/Qwen/Kimi/DeepSeek<br>27+ LLM Provider</div>
</div>
<div style="background: linear-gradient(135deg, #1e293b, #0f172a); border-radius: 8px; padding: 16px; text-align: center;">
<div style="font-size: 28px; margin-bottom: 6px;">☁️</div>
<div style="font-size: 14px; font-weight: 600; color: #e2e8f0;">自托管 SaaS 网关</div>
<div style="font-size: 12px; color: #64748b; margin-top: 4px;">Key Pool 代理 / 用量追踪<br>组织级 LLM 管理</div>
</div>
<div style="background: linear-gradient(135deg, #1e293b, #0f172a); border-radius: 8px; padding: 16px; text-align: center;">
<div style="font-size: 28px; margin-bottom: 6px;">🔒</div>
<div style="font-size: 14px; font-weight: 600; color: #e2e8f0;">16层安全防护</div>
<div style="font-size: 12px; color: #64748b; margin-top: 4px;">渗透测试通过<br>企业级安全合规</div>
</div>
</div>
</div>
<div class="section" style="margin-top: 20px; padding: 16px; background: #1e293b; border-radius: 8px;">
<h3 style="margin: 0 0 8px 0;">战略定位一句话</h3>
<p style="color: #f59e0b; font-size: 16px; margin: 0; font-weight: 600;">
ZCLAW = 中文市场的 AI Agent OS不是另一个 ChatGPT 套壳。
</p>
<p style="color: #94a3b8; font-size: 13px; margin: 8px 0 0 0;">
核心问题:技术基础设施已建成 ~90%,但商业变现路径从 0 → 1 尚未打通。
</p>
</div>