foliko 1.0.0

package/.claude/settings.local.json

@@ -0,0 +1,30 @@
+{
+  "permissions": {
+    "allow": [
+      "Bash(grep -r \"dotenv\" \"D:/Code/vb-agent/\" --include=\"*.json\" 2>/dev/null | head -20)",
+      "Bash(cd \"D:/Code/vb-agent\" && pnpm add dotenv)",
+      "Bash(cd \"D:/Code/vb-agent\" && node -e \"const ai = require\\('ai'\\); console.log\\(Object.keys\\(ai\\).filter\\(k => k.toLowerCase\\(\\).includes\\('reason'\\) || k.toLowerCase\\(\\).includes\\('split'\\) || k.toLowerCase\\(\\).includes\\('think'\\)\\)\\)\")",
+      "Bash(cd \"D:/Code/vb-agent\" && node -e \"const ai = require\\('ai'\\); console.log\\(typeof ai.extractReasoningMiddleware, ai.extractReasoningMiddleware.toString\\(\\).substring\\(0, 500\\)\\)\")",
+      "Bash(cd \"D:/Code/vb-agent\" && node -e \"\nconst ai = require\\('ai'\\);\nconsole.log\\('=== extractReasoningMiddleware ==='\\);\nconsole.log\\(ai.extractReasoningMiddleware.toString\\(\\)\\);\nconsole.log\\('\\\\n=== isReasoningUIPart ==='\\);\nconsole.log\\(typeof ai.isReasoningUIPart\\);\n\")",
+      "Bash(cd \"D:/Code/vb-agent\" && node -e \"const ai = require\\('ai'\\); console.log\\(Object.keys\\(ai\\).filter\\(k => k.toLowerCase\\(\\).includes\\('split'\\)\\)\\)\")",
+      "Bash(cd \"D:/Code/vb-agent\" && pnpm add ink react)",
+      "Bash(cd \"D:/Code/vb-agent\" && node cli/bin/foliko.js --help)",
+      "Bash(cd \"D:/Code/vb-agent\" && timeout 2 node cli/bin/foliko.js chat 2>&1 || true)",
+      "Bash(cd \"D:/Code/vb-agent\" && node -e \"const mt = require\\('marked-terminal'\\); console.log\\(typeof mt, Object.keys\\(mt\\)\\)\")",
+      "Bash(cd \"D:/Code/vb-agent\" && timeout 3 node cli/bin/foliko.js chat 2>&1 || true)",
+      "Bash(echo \"你好\" | node cli/bin/foliko.js chat 2>&1 | head -50)",
+      "Bash(printf '思考一下1+1等于几\\\\n' | node cli/bin/foliko.js chat 2>&1 | head -100)",
+      "Bash(printf '1+1等于几\\\\n' | node cli/bin/foliko.js chat 2>&1)",
+      "Bash(node -e \"\nconst { renderLine } = require\\('./cli/src/utils/markdown'\\)\nconsole.log\\(renderLine\\('🎉 这是一个 emoji'\\)\\)\nconsole.log\\(renderLine\\('**粗体** 和 🎉'\\)\\)\n\")",
+      "Bash(node -e \"\nconst { render } = require\\('./cli/src/utils/markdown'\\)\nconst text = '🎉 今天是个好日子\\\\n## 标题\\\\n- 列表项1\\\\n- 列表项2'\nconsole.log\\(render\\(text\\)\\)\n\")",
+      "Bash(node -e \"\nconst { renderLine } = require\\('./cli/src/utils/markdown'\\)\n\n// 模拟emoji被截断的情况\nconst emoji = '🎉'\nconsole.log\\('完整的 emoji:', renderLine\\(emoji\\)\\)\n\n// 模拟截断 - emoji的UTF-8字节是 \\\\xF0\\\\x9F\\\\x8E\\\\x89\nconst partial = '\\\\xF0\\\\x9F'  // 不完整的emoji\nconsole.log\\('截断的 emoji:', renderLine\\(partial\\)\\)\n\")",
+      "Bash(node -e \"\nconst isIncompleteUTF8 = \\(str\\) => {\n  if \\(!str || str.length === 0\\) return false\n  const lastChar = str.charCodeAt\\(str.length - 1\\)\n  if \\(lastChar >= 0x80 && lastChar < 0xC0\\) return true\n  return false\n}\n\n// 测试各种emoji\nconst tests = ['🎉', '📁', '⚡', '🛠️', '🔑', '💾', '📝', '⏰', '🔌', '📋']\ntests.forEach\\(e => {\n  console.log\\(e, '完整:', !isIncompleteUTF8\\(e\\)\\)\n}\\)\n\n// 测试被截断的emoji \\(只保留第一字节\\)\nconst broken = '🎉'.slice\\(0, 1\\)\nconsole.log\\('截断emoji:', broken, '检测:', isIncompleteUTF8\\(broken\\)\\)\n\")",
+      "Bash(node -e \"\nconst { renderLine } = require\\('./cli/src/utils/markdown'\\)\nconsole.log\\('测试:', renderLine\\('📁 文件操作：读取、创建'\\)\\)\n\")",
+      "Bash(node -e \"\nconst hasIncompleteSurrogate = \\(str\\) => {\n  if \\(!str || str.length === 0\\) return false\n  const lastChar = str.charCodeAt\\(str.length - 1\\)\n  console.log\\('检查:', str, 'lastChar:', lastChar.toString\\(16\\), '范围:', \\(lastChar >= 0xD800 && lastChar <= 0xDBFF\\)\\)\n  return lastChar >= 0xD800 && lastChar <= 0xDBFF\n}\n\nconst chunk1 = '\\\\xD83C'\nconsole.log\\('结果:', hasIncompleteSurrogate\\(chunk1\\)\\)\n\")",
+      "Bash(cd D:/Code/vb-agent && node test-stream-emoji.js 2>&1)",
+      "Read(//d/Date/20260321/app/**)",
+      "Bash(node -e \":*)",
+      "Bash(node -e \"\nconst { loadAgentConfig } = require\\('./plugins/default-plugins'\\);\nconst config = loadAgentConfig\\('D:/Date/20260321/app/.agent'\\);\nconsole.log\\('skillsDirs:', config.skillsDirs\\);\n\")"
+    ]
+  }
+}

package/22.txt

@@ -0,0 +1,10 @@
+{
+  "mcpServers": {
+    "fetch": {
+      "args": [
+        "mcp-server-fetch"
+      ],
+      "command": "uvx"
+    }
+  }
+}

package/README.md

@@ -0,0 +1,218 @@
+# JavaScript 测试代码示例
+
+这个项目展示了现代 JavaScript 测试的最佳实践，使用 Jest 作为测试框架。
+
+## 文件结构
+
+- `test-example.js` - 完整的测试示例，包含多种测试类型
+- `simple-test-example.js` - 简洁的测试示例，适合初学者
+- `package.json` - 项目配置和 Jest 设置
+
+## 包含的测试类型
+
+### 1. 单元测试
+- 函数测试
+- 类方法测试
+- 边界情况测试
+- 异常测试
+
+### 2. 异步测试
+- Promise 测试
+- async/await 测试
+- 超时处理
+
+### 3. 集成测试
+- 多个类的组合测试
+- 完整流程测试
+
+### 4. Mock 和 Spy
+- 模拟函数
+- 模拟 API 调用
+- 验证函数调用
+
+### 5. 参数化测试
+- 使用 `test.each` 测试多组数据
+
+### 6. 快照测试
+- 对象结构验证
+
+## 最佳实践展示
+
+### 1. AAA 模式 (Arrange-Act-Assert)
+```javascript
+test('应该正确计算两个数的和', () => {
+  // Arrange: 准备测试数据
+  const a = 5;
+  const b = 3;
+  const expected = 8;
+
+  // Act: 执行被测试的方法
+  const result = calculator.add(a, b);
+
+  // Assert: 验证结果
+  expect(result).toBe(expected);
+});
+```
+
+### 2. 描述性测试名称
+- 使用 "should" 描述预期行为
+- 包含测试条件
+- 清晰表达测试目的
+
+### 3. 测试隔离
+- 每个测试独立运行
+- 使用 `beforeEach` 重置状态
+- 避免测试间的依赖
+
+### 4. 恰当的断言
+- 使用合适的匹配器
+- 验证异常
+- 检查异步结果
+
+### 5. 测试覆盖率
+- 行覆盖率
+- 分支覆盖率
+- 函数覆盖率
+- 语句覆盖率
+
+## 安装和运行
+
+### 1. 安装依赖
+```bash
+npm install
+```
+
+### 2. 运行测试
+```bash
+# 运行所有测试
+npm test
+
+# 监视模式（文件变化时自动运行）
+npm run test:watch
+
+# 生成覆盖率报告
+npm run test:coverage
+
+# 详细输出
+npm run test:verbose
+
+# 更新快照
+npm run test:update
+```
+
+### 3. 查看覆盖率报告
+运行 `npm run test:coverage` 后，打开 `coverage/index.html` 查看详细的覆盖率报告。
+
+## Jest 配置说明
+
+在 `package.json` 中的 Jest 配置：
+
+```json
+{
+  "jest": {
+    "testEnvironment": "node",          // 测试环境
+    "verbose": true,                    // 详细输出
+    "collectCoverage": true,            // 收集覆盖率
+    "coverageDirectory": "coverage",    // 覆盖率输出目录
+    "coverageReporters": ["text", "lcov", "html"], // 报告格式
+    "coverageThreshold": {              // 覆盖率阈值
+      "global": {
+        "branches": 80,
+        "functions": 80,
+        "lines": 80,
+        "statements": 80
+      }
+    },
+    "testMatch": [                      // 测试文件匹配模式
+      "**/__tests__/**/*.js",
+      "**/?(*.)+(spec|test).js"
+    ],
+    "testTimeout": 10000,               // 测试超时时间
+    "clearMocks": true,                 // 自动清理 mock
+    "resetMocks": true,                 // 重置 mock
+    "restoreMocks": true                // 恢复原始实现
+  }
+}
+```
+
+## 测试技巧
+
+### 1. 测试异步代码
+```javascript
+// 使用 async/await
+test('应该异步返回数据', async () => {
+  const result = await fetchData();
+  expect(result).toEqual({ data: '测试数据' });
+});
+
+// 测试异步异常
+test('应该抛出异步错误', async () => {
+  await expect(asyncFunction()).rejects.toThrow('错误信息');
+});
+```
+
+### 2. Mock 函数
+```javascript
+// 创建 mock 函数
+const mockFn = jest.fn();
+
+// 设置返回值
+mockFn.mockReturnValue('返回值');
+
+// 验证调用
+expect(mockFn).toHaveBeenCalledTimes(1);
+expect(mockFn).toHaveBeenCalledWith('参数');
+```
+
+### 3. 参数化测试
+```javascript
+test.each([
+  [1, 1, 2],
+  [1, 2, 3],
+  [2, 1, 3],
+])('add(%i, %i) should equal %i', (a, b, expected) => {
+  expect(a + b).toBe(expected);
+});
+```
+
+### 4. 快照测试
+```javascript
+test('对象应该匹配快照', () => {
+  const obj = {
+    id: 1,
+    name: '测试',
+    date: new Date('2024-01-01')
+  };
+  
+  expect(obj).toMatchSnapshot({
+    date: expect.any(Date) // 忽略具体日期值
+  });
+});
+```
+
+## 常见问题
+
+### 1. 测试运行太慢
+- 减少不必要的异步等待
+- 使用 `jest.useFakeTimers()` 模拟时间
+- 避免在测试中执行真实 API 调用
+
+### 2. 测试不稳定（Flaky Tests）
+- 确保测试独立
+- 避免依赖外部状态
+- 使用固定的测试数据
+
+### 3. 覆盖率不足
+- 添加边界情况测试
+- 测试错误处理路径
+- 验证所有分支条件
+
+## 扩展阅读
+
+- [Jest 官方文档](https://jestjs.io/)
+- [测试金字塔原则](https://martinfowler.com/bliki/TestPyramid.html)
+- [AAA 测试模式](https://medium.com/@pjbgf/title-testing-code-ocd-and-the-aaa-pattern-df453975ab80)
+
+## 许可证
+
+MIT