@panda-agent/panda-cli 0.1.54

package/README.md

@@ -0,0 +1,192 @@
+# 智能化办公 - Dify 独立前端
+
+基于 Next.js 15 和 Dify 后端 API 的独立前端应用，提供类似 NotebookLM 的三栏布局界面。
+
+## 项目结构
+
+```
+src/
+├── app/                      # Next.js App Router
+│   ├── (auth)/              # 认证相关页面
+│   │   ├── signin/          # 登录页
+│   │   └── signup/          # 注册页
+│   ├── (main)/              # 主应用布局（三栏）
+│   │   ├── layout.tsx       # 三栏布局
+│   │   ├── page.tsx         # 首页（聊天）
+│   │   ├── conversations/   # 会话管理
+│   │   ├── datasets/        # 知识库管理
+│   │   └── notebooks/       # 笔记管理
+│   ├── layout.tsx           # 根布局
+│   ├── providers.tsx        # React Query Provider
+│   └── globals.css          # 全局样式
+├── components/
+│   ├── ui/                  # 基础 UI 组件
+│   │   ├── button.tsx
+│   │   └── input.tsx
+│   ├── layout/              # 布局组件
+│   │   ├── top-nav.tsx      # 顶部导航
+│   │   ├── left-sidebar.tsx # 左栏（来源）
+│   │   ├── right-sidebar.tsx# 右栏（Studio）
+│   │   └── status-bar.tsx   # 底部状态栏
+│   ├── chat/                # 聊天组件
+│   │   ├── chat-area.tsx
+│   │   ├── message-list.tsx
+│   │   ├── message-item.tsx
+│   │   └── chat-input.tsx
+│   ├── sources/             # 来源管理组件（待实现）
+│   └── studio/              # Studio 工具组件（待实现）
+├── services/
+│   └── dify-client.ts       # Dify API 客户端
+├── stores/
+│   ├── auth-store.ts        # 认证状态 (Zustand)
+│   └── chat-store.ts        # 聊天状态 (Zustand)
+├── hooks/
+│   └── use-chat.ts          # 聊天 Hook
+├── lib/
+│   └── utils.ts             # 工具函数
+└── types/
+    └── index.ts             # TypeScript 类型定义
+```
+
+## 已完成功能
+
+### 阶段 1: 基础架构 ✅
+- [x] Next.js 15 项目初始化
+- [x] Tailwind CSS 4 + 暗色主题支持
+- [x] Zustand 状态管理
+- [x] TanStack Query 数据缓存
+- [x] TypeScript 类型定义
+- [x] Dify API 客户端封装
+
+### 阶段 2: 认证系统 
+- [x] 登录页面
+- [ ] 注册页面
+- [ ] 密码找回
+- [ ] OAuth 登录
+
+### 阶段 3: 三栏布局 ✅
+- [x] 主布局（响应式）
+- [x] 顶部导航栏
+- [x] 左侧边栏（来源管理）
+- [x] 右侧边栏（Studio 工具）
+- [x] 底部状态栏
+
+### 阶段 4: 聊天功能 🟡
+- [x] 聊天区域组件
+- [x] 消息列表
+- [x] 消息项（支持引用）
+- [x] 聊天输入框（支持文件拖放）
+- [x] 流式响应处理
+- [ ] 会话管理（创建/删除/重命名）
+- [ ] 会话历史加载
+
+## 待实现功能
+
+### 阶段 5: 来源管理
+- [ ] 知识库列表和选择
+- [ ] 文件上传组件
+- [ ] 网站链接添加
+- [ ] 来源状态监控
+
+### 阶段 6: 笔记功能
+- [ ] 笔记数据库设计
+- [ ] 笔记 API 服务
+- [ ] 笔记编辑器
+- [ ] 笔记与会话关联
+
+### 阶段 7: Studio 工具
+- [ ] 音频概览（TTS）
+- [ ] 报告生成
+- [ ] 思维导图
+- [ ] 闪卡/测验
+
+### 阶段 8: 优化
+- [ ] 性能优化（长会话渲染、截断策略等）
+- [ ] 错误边界
+- [ ] 加载状态优化
+- [ ] 端到端测试
+
+## 开发指南
+
+### 环境配置
+
+1. 复制 `.env.local.example` 到 `.env.local`
+2. 配置 Dify 后端 API 地址：
+   ```bash
+   NEXT_PUBLIC_DIFY_API_URL=http://localhost:5001
+   ```
+
+### 启动开发服务器
+
+```bash
+npm run dev
+```
+
+访问 http://localhost:3000
+
+### 构建生产版本
+```bash
+npm run build
+npm start
+```
+
+## API 集成
+
+### Dify API 端点
+
+- **认证**: `/console/api/login`, `/console/api/register`
+- **聊天**: `/v1/chat-messages` (支持流式)
+- **会话**: `/v1/conversations`
+- **知识库**: `/console/api/datasets`
+
+### 添加新的 API 调用
+
+在 `src/services/dify-client.ts` 中添加新方法：
+
+```typescript
+async myNewMethod(params: MyParams): Promise<ApiResponse<MyResult>> {
+  return this.fetch('/endpoint', {
+    method: 'POST',
+    body: JSON.stringify(params),
+  })
+}
+```
+
+## 状态管理
+
+### Auth Store
+
+```typescript
+import { useAuthStore } from '@/stores/auth-store'
+
+const { user, login, logout } = useAuthStore()
+```
+
+### Chat Store
+
+```typescript
+import { useChatStore } from '@/stores/chat-store'
+
+const { messages, addMessage, updateMessage } = useChatStore()
+```
+
+## 技术栈
+
+- **框架**: Next.js 15 (App Router)
+- **语言**: TypeScript 5
+- **样式**: Tailwind CSS 4
+- **状态管理**: Zustand 5
+- **数据获取**: TanStack Query 5
+- **图标**: Lucide React
+- **UI 组件**: 自研（基于 Shadcn/ui 设计）
+
+## 下一步
+
+1. **完成认证流程** - 注册、密码找回
+2. **实现会话管理** - 加载历史会话、创建新会话
+3. **集成知识库** - 来源选择、文件上传
+4. **完善 Studio 工具** - 音频概览、报告生成
+
+## License
+
+MIT

package/bin/pandacli.mjs

@@ -0,0 +1,85 @@
+#!/usr/bin/env node
+/**
+ * 全局/本地安装后的入口：工作目录始终为调用方 shell 的 cwd（默认 spawn 即 process.cwd()）。
+ * 先 dedupe（仅 vscode monorepo 时删本包内 react）再启动 bundle。
+ */
+
+import { spawnSync } from 'node:child_process';
+import { existsSync, readFileSync } from 'node:fs';
+import { dirname, join } from 'node:path';
+import { fileURLToPath } from 'node:url';
+
+// 修改进程标题，防止 `pkill node` / `killall node` 误杀
+process.title = 'panda-cli';
+
+const here = dirname(fileURLToPath(import.meta.url));
+const pkgRoot = join(here, '..');
+const dedupe = join(pkgRoot, 'scripts', 'dedupe-react-for-cli.mjs');
+const bundle = join(pkgRoot, 'dist', 'panda-cli-ink.bundle.mjs');
+
+function parseNodeMajor(version) {
+	const match = /^v?(\d+)/.exec(version ?? '');
+	return match ? Number(match[1]) : 0;
+}
+
+function parseEnginesNodeMajor(spec) {
+	const match = />=\s*(\d+)/.exec(spec ?? '');
+	return match ? Number(match[1]) : 22;
+}
+
+function readRequiredNodeMajor() {
+	const pkgPath = join(pkgRoot, 'package.json');
+	try {
+		const pkg = JSON.parse(readFileSync(pkgPath, 'utf8'));
+		return parseEnginesNodeMajor(pkg.engines?.node);
+	} catch {
+		return 22;
+	}
+}
+
+function assertNodeVersion() {
+	const requiredMajor = readRequiredNodeMajor();
+	const currentMajor = parseNodeMajor(process.version);
+	if (currentMajor < requiredMajor) {
+		console.error(
+			`[pandacli] 需要 Node.js >= ${requiredMajor}（package.json engines），当前为 ${process.version}。\n` +
+				`请安装 Node ${requiredMajor} LTS 或更高版本: https://nodejs.org/\n` +
+				'安装后请重新打开终端，执行 node -v 确认版本后再运行 panda。',
+		);
+		process.exit(1);
+	}
+}
+
+assertNodeVersion();
+
+if (!existsSync(bundle)) {
+	console.error(
+		'[pandacli] 缺少 dist/panda-cli-ink.bundle.mjs。请在 panda-cli 目录执行: npm run vendor:panda-ink && npm run build，或重新安装/打包容器。',
+	);
+	process.exit(1);
+}
+
+const dedupeResult = spawnSync(process.execPath, [dedupe], {
+	stdio: 'inherit',
+	cwd: pkgRoot,
+	env: process.env,
+});
+if (dedupeResult.status !== 0) {
+	process.exit(dedupeResult.status === null ? 1 : dedupeResult.status);
+}
+
+const run = spawnSync(
+	process.execPath,
+	[
+		'--max-old-space-size=16384',
+		'--disable-warning=ExperimentalWarning', // node:sqlite 实验性 API
+		bundle,
+		...process.argv.slice(2),
+	],
+	{
+		stdio: 'inherit',
+		cwd: process.cwd(),
+		env: process.env,
+	},
+);
+process.exit(run.status ?? (run.signal ? 1 : 0));

package/bundled-preset-commands/README.md

@@ -0,0 +1,3 @@
+# Preset slash commands (SSOT)
+
+One command per `*.md` file. Synced to `panda-cli/bundled-preset-commands/` before npm pack.

package/bundled-preset-commands/init.md

@@ -0,0 +1,78 @@
+# Initialize Panda project context
+
+Set up minimal **CLAUDE.md** (and optionally **CLAUDE.local.md**, **skills**, **hooks**) for this repo. These files load into every Panda session — keep them concise: only include what the model would get wrong without them.
+
+## Phase 1: Ask what to set up
+
+Use **ask_question** to learn what the user wants:
+
+- **Which instruction files?** Options: "Project CLAUDE.md" | "Personal CLAUDE.local.md" | "Both"
+- **Skills and hooks?** Options: "Skills + hooks" | "Skills only" | "Hooks only" | "Neither, just CLAUDE.md"
+
+## Phase 2: Survey the codebase
+
+Launch a **Task** subagent with `subagent_type: Explore` to read: manifest files (package.json, Cargo.toml, pyproject.toml, go.mod, etc.), README, Makefile, CI config, existing CLAUDE.md / AGENTS.md, `.panda/`, `.cursor/rules`, `.github/copilot-instructions.md`.
+
+Detect: build/test/lint commands, languages, monorepo layout, formatters, existing `.panda/skills/` and `.panda/rules/`.
+
+## Phase 3: Gap fill + proposal
+
+Use **ask_question** for team practices and personal preferences the code cannot answer.
+
+Synthesize a proposal (hook | skill | CLAUDE.md note), **filtered by Phase 1 choice**. Use each option's **preview** field (Markdown) to show the full proposal — keep previews compact (one line per item).
+
+## Phase 4: Write CLAUDE.md (if chosen)
+
+Write minimal `CLAUDE.md` at project root. Prefix:
+
+```
+# CLAUDE.md
+
+This file provides guidance to Panda when working with code in this repository.
+```
+
+Include only: non-obvious commands, style rules that differ from defaults, test quirks, env setup, gotchas. Exclude file trees and generic advice. If CLAUDE.md exists: propose diffs, do not overwrite silently.
+
+Suggest `.panda/rules/*.md` for large projects (unconditional rules) or scoped rules with frontmatter:
+
+```yaml
+---
+paths:
+  - "src/**/*.ts"
+---
+```
+
+## Phase 5: Write CLAUDE.local.md (if chosen)
+
+Write `CLAUDE.local.md`, add `CLAUDE.local.md` to `.gitignore`. Personal sandbox URLs, role, communication preferences only.
+
+## Phase 6: Create skills (if chosen)
+
+Create `.panda/skills/<name>/SKILL.md` (or `.claude/skills/` for Claude-compat):
+
+```yaml
+---
+name: <skill-name>
+description: <when to use>
+---
+```
+
+Side-effect skills (deploy, etc.): add `disable-model-invocation: true` in frontmatter if supported.
+
+## Phase 7: Hooks + environment (if chosen)
+
+Write hooks to `.panda/settings.json` (team) or `.panda/settings.local.json` (personal).
+
+Before first hook: invoke **use_skill** with `update-config` and args `[hooks-only] <one-line summary>`.
+
+**Live proof (Phase 7)**: after writing `.panda/settings.json`, run one matching tool (e.g. save a file for `Write|Edit` PostToolUse) in the **same session** and verify the hook command executed. Hook scripts should read `tool_input.file_path` from stdin JSON (`jq -r '.tool_input.file_path'`) or use env `$FILE_PATH`.
+
+Examples:
+- Format on edit: `PostToolUse` matcher `Write|Edit`
+- Before review: `Stop` event
+
+Check `which gh`; offer lint setup if missing.
+
+## Phase 8: Summary
+
+Recap files written. Recommend: `/skill-creator`, `/skills`, MCP setup, verification subagent.

package/bundled-preset-skills/README.md

@@ -0,0 +1,17 @@
+# Preset skills (SSOT)
+
+Place one skill per subdirectory. Each subdirectory must contain `SKILL.md`.
+
+Example:
+
+```text
+panda-resources/skills/
+  my-skill/
+    SKILL.md
+```
+
+Release builds embed this tree as `bundled-preset-skills/` in CLI / Desktop / IDE packages, then seed into `~/.panda/skills` on first run (skip if `SKILL.md` already exists for that skill name).
+
+- CLI: `sync-preset-skills.mjs` → `panda-cli/bundled-preset-skills/` (gitignored) before `npm pack`
+- Desktop: `electron-builder` reads SSOT directly into `Resources/bundled-preset-skills/`
+- IDE: gulp merges into `Resources/bundled-preset-skills/`

package/bundled-preset-skills/docx/.skill-metadata.yaml

@@ -0,0 +1,208 @@
+examples:
+  - id: create-official-document
+    title:
+      zh: 撰写公司公文
+      en: Create Official Document (公文)
+    description:
+      zh: 按公司公文规范生成通知、请示等正式文书
+      en: Generate formal official documents per company 公文 standards
+    prompt:
+      zh: |-
+        请帮我起草一份公司公文（.docx），要求如下：
+
+        文种：{{通知 / 请示 / 报告 等}}
+        标题：{{公文标题}}
+        主送单位：{{主送单位名称}}
+        正文要点：
+        {{列出正文主要内容或提纲}}
+
+        格式须符合公司公文规范：
+        - 正文仿宋_GB2312 三号，段首左空二字，回行顶格
+        - 结构层次：一、（黑体）；（一）（楷体）；1.（仿宋）；（1）（仿宋），不超过四层
+        - 数字、年份不在行中断开
+        - 坚持实事求是、准确规范、精简高效、安全保密
+
+        请生成完整文稿。
+      en: |-
+        Please draft a company official document (.docx) with:
+
+        Type: {{notice / request / report, etc.}}
+        Title: {{document title}}
+        Primary recipient: {{recipient}}
+        Body outline: {{key points}}
+
+        Format per company 公文 rules: FangSong_GB2312 size 3 body; 2-char first-line indent; structure levels 一、/（一）/1./（1） with Heiti/KaiTi/FangSong fonts; no line breaks inside numbers or years.
+
+        Generate the full document.
+  - id: create-document
+    title:
+      zh: 创建新文档
+      en: Create New Document
+    description:
+      zh: 创建一个新的 Word 文档，包含指定的内容和格式
+      en: Create a new Word document with specified content and formatting
+    prompt:
+      zh: |-
+        请帮我创建一个专业的 Word 文档，要求如下：
+
+        标题：{{项目报告标题}}
+        内容结构：
+        1. 项目概述（200字左右）
+        2. 主要成果（要点列出）
+        3. 数据分析（包含图表说明）
+        4. 结论与建议
+
+        格式要求：
+        - 使用正式的商务文档样式
+        - 标题使用加粗格式
+        - 正文使用 12 号字体
+        - 添加页眉页脚
+        - 生成目录
+
+        请根据以上要求生成文档。
+      en: |-
+        Please help me create a professional Word document with the following requirements:
+
+        Title: {{Project Report Title}}
+        Content structure:
+        1. Project Overview (about 200 words)
+        2. Key Achievements (bullet points)
+        3. Data Analysis (including chart descriptions)
+        4. Conclusion and Recommendations
+
+        Formatting requirements:
+        - Use formal business document style
+        - Headers in bold format
+        - Body text in 12-point font
+        - Add headers and footers
+        - Generate table of contents
+
+        Please generate the document according to the above requirements.
+  - id: extract-content
+    title:
+      zh: 提取文档内容
+      en: Extract Document Content
+    description:
+      zh: 从 Word 文档中提取纯文本内容或特定结构化信息
+      en: Extract plain text content or specific structured information from Word documents
+    prompt:
+      zh: |-
+        请帮我分析这个 Word 文档并提取以下信息：
+
+        文档路径：{{文档文件路径}}
+
+        需要提取的内容：
+        1. 完整的纯文本内容
+        2. 所有标题和子标题
+        3. 表格数据（如果有）
+        4. 图片描述和位置信息
+        5. 文档的总体结构分析
+
+        输出格式：JSON 格式，便于后续处理。
+      en: |-
+        Please help me analyze this Word document and extract the following information:
+
+        Document path: {{Document file path}}
+
+        Content to extract:
+        1. Complete plain text content
+        2. All headings and subheadings
+        3. Table data (if any)
+        4. Image descriptions and position information
+        5. Overall document structure analysis
+
+        Output format: JSON format for easy subsequent processing.
+  - id: convert-format
+    title:
+      zh: 格式转换
+      en: Format Conversion
+    description:
+      zh: 将 Word 文档转换为其他格式或调整文档格式
+      en: Convert Word documents to other formats or adjust document formatting
+    prompt:
+      zh: |-
+        我需要转换和优化这个 Word 文档：
+
+        源文档：{{源文档路径}}
+        目标格式：{{目标格式，如 PDF、HTML 等}}
+
+        转换要求：
+        1. 保持原有的格式和布局
+        2. 优化字体和段落间距
+        3. 确保图片清晰度
+        4. 添加水印（可选）
+        5. 设置页面边距和纸张大小
+
+        如果是转换为 PDF，请确保：
+        - 所有链接可点击
+        - 书签结构完整
+        - 文件大小适中
+
+        请处理并提供转换后的文件。
+      en: |-
+        I need to convert and optimize this Word document:
+
+        Source document: {{Source document path}}
+        Target format: {{Target format, such as PDF, HTML, etc.}}
+
+        Conversion requirements:
+        1. Maintain original formatting and layout
+        2. Optimize fonts and paragraph spacing
+        3. Ensure image clarity
+        4. Add watermark (optional)
+        5. Set page margins and paper size
+
+        If converting to PDF, please ensure:
+        - All links are clickable
+        - Bookmark structure is complete
+        - File size is appropriate
+
+        Please process and provide the converted file.
+  - id: template-fill
+    title:
+      zh: 模板填充
+      en: Template Filling
+    description:
+      zh: 使用数据自动填充 Word 模板文档
+      en: Automatically fill Word template documents with data
+    prompt:
+      zh: |-
+        请帮我使用以下数据填充 Word 模板：
+
+        模板文件：{{模板文件路径}}
+        数据来源：{{JSON数据或表格数据}}
+
+        需要替换的占位符：
+        - {{姓名}} -> 实际姓名
+        - {{日期}} -> 当前日期
+        - {{项目名称}} -> 项目名称
+        - {{金额}} -> 数值金额
+        - {{部门}} -> 部门名称
+
+        特殊要求：
+        1. 保持模板原有格式
+        2. 自动计算合计金额（如果有）
+        3. 根据数据动态调整表格行数
+        4. 添加适当的条件格式
+
+        请生成填充完成的文档。
+      en: |-
+        Please help me fill the Word template with the following data:
+
+        Template file: {{Template file path}}
+        Data source: {{JSON data or table data}}
+
+        Placeholders to replace:
+        - {{Name}} -> Actual name
+        - {{Date}} -> Current date
+        - {{Project Name}} -> Project name
+        - {{Amount}} -> Numeric amount
+        - {{Department}} -> Department name
+
+        Special requirements:
+        1. Maintain original template formatting
+        2. Automatically calculate total amounts (if any)
+        3. Dynamically adjust table rows based on data
+        4. Add appropriate conditional formatting
+
+        Please generate the completed filled document.

package/bundled-preset-skills/docx/LICENSE.txt

@@ -0,0 +1,30 @@
+© 2025 Anthropic, PBC. All rights reserved.
+
+LICENSE: Use of these materials (including all code, prompts, assets, files,
+and other components of this Skill) is governed by your agreement with
+Anthropic regarding use of Anthropic's services. If no separate agreement
+exists, use is governed by Anthropic's Consumer Terms of Service or
+Commercial Terms of Service, as applicable:
+https://www.anthropic.com/legal/consumer-terms
+https://www.anthropic.com/legal/commercial-terms
+Your applicable agreement is referred to as the "Agreement." "Services" are
+as defined in the Agreement.
+
+ADDITIONAL RESTRICTIONS: Notwithstanding anything in the Agreement to the
+contrary, users may not:
+
+- Extract these materials from the Services or retain copies of these
+  materials outside the Services
+- Reproduce or copy these materials, except for temporary copies created
+  automatically during authorized use of the Services
+- Create derivative works based on these materials
+- Distribute, sublicense, or transfer these materials to any third party
+- Make, offer to sell, sell, or import any inventions embodied in these
+  materials
+- Reverse engineer, decompile, or disassemble these materials
+
+The receipt, viewing, or possession of these materials does not convey or
+imply any license or right beyond those expressly granted above.
+
+Anthropic retains all right, title, and interest in these materials,
+including all copyrights, patents, and other intellectual property rights.