foliko 1.0.73 → 1.0.75

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (237) hide show
  1. package/.agent/.shared/ui-ux-pro-max/data/charts.csv +26 -0
  2. package/.agent/.shared/ui-ux-pro-max/data/colors.csv +97 -0
  3. package/.agent/.shared/ui-ux-pro-max/data/icons.csv +101 -0
  4. package/.agent/.shared/ui-ux-pro-max/data/landing.csv +31 -0
  5. package/.agent/.shared/ui-ux-pro-max/data/products.csv +97 -0
  6. package/.agent/.shared/ui-ux-pro-max/data/prompts.csv +24 -0
  7. package/.agent/.shared/ui-ux-pro-max/data/react-performance.csv +45 -0
  8. package/.agent/.shared/ui-ux-pro-max/data/stacks/flutter.csv +53 -0
  9. package/.agent/.shared/ui-ux-pro-max/data/stacks/html-tailwind.csv +56 -0
  10. package/.agent/.shared/ui-ux-pro-max/data/stacks/jetpack-compose.csv +53 -0
  11. package/.agent/.shared/ui-ux-pro-max/data/stacks/nextjs.csv +53 -0
  12. package/.agent/.shared/ui-ux-pro-max/data/stacks/nuxt-ui.csv +51 -0
  13. package/.agent/.shared/ui-ux-pro-max/data/stacks/nuxtjs.csv +59 -0
  14. package/.agent/.shared/ui-ux-pro-max/data/stacks/react-native.csv +52 -0
  15. package/.agent/.shared/ui-ux-pro-max/data/stacks/react.csv +54 -0
  16. package/.agent/.shared/ui-ux-pro-max/data/stacks/shadcn.csv +61 -0
  17. package/.agent/.shared/ui-ux-pro-max/data/stacks/svelte.csv +54 -0
  18. package/.agent/.shared/ui-ux-pro-max/data/stacks/swiftui.csv +51 -0
  19. package/.agent/.shared/ui-ux-pro-max/data/stacks/vue.csv +50 -0
  20. package/.agent/.shared/ui-ux-pro-max/data/styles.csv +59 -0
  21. package/.agent/.shared/ui-ux-pro-max/data/typography.csv +58 -0
  22. package/.agent/.shared/ui-ux-pro-max/data/ui-reasoning.csv +101 -0
  23. package/.agent/.shared/ui-ux-pro-max/data/ux-guidelines.csv +100 -0
  24. package/.agent/.shared/ui-ux-pro-max/data/web-interface.csv +31 -0
  25. package/.agent/.shared/ui-ux-pro-max/scripts/__pycache__/core.cpython-313.pyc +0 -0
  26. package/.agent/.shared/ui-ux-pro-max/scripts/__pycache__/design_system.cpython-313.pyc +0 -0
  27. package/.agent/.shared/ui-ux-pro-max/scripts/core.py +258 -0
  28. package/.agent/.shared/ui-ux-pro-max/scripts/design_system.py +1067 -0
  29. package/.agent/.shared/ui-ux-pro-max/scripts/search.py +106 -0
  30. package/.agent/ARCHITECTURE.md +288 -0
  31. package/.agent/agents/ambient-agent.md +57 -0
  32. package/.agent/agents/debugger.md +55 -0
  33. package/.agent/agents/email-assistant.md +49 -0
  34. package/.agent/agents/file-manager.md +42 -0
  35. package/.agent/agents/python-developer.md +60 -0
  36. package/.agent/agents/scheduler.md +59 -0
  37. package/.agent/agents/web-developer.md +45 -0
  38. package/.agent/data/default.json +29 -0
  39. package/.agent/data/plugins-state.json +255 -0
  40. package/.agent/mcp_config.json +4 -0
  41. package/.agent/mcp_config_updated.json +12 -0
  42. package/.agent/plugins.json +5 -0
  43. package/.agent/rules/GEMINI.md +273 -0
  44. package/.agent/rules/allow-rule.md +77 -0
  45. package/.agent/rules/log-rule.md +83 -0
  46. package/.agent/rules/security-rule.md +93 -0
  47. package/.agent/scripts/auto_preview.py +148 -0
  48. package/.agent/scripts/checklist.py +217 -0
  49. package/.agent/scripts/session_manager.py +120 -0
  50. package/.agent/scripts/verify_all.py +327 -0
  51. package/.agent/skills/api-patterns/SKILL.md +81 -0
  52. package/.agent/skills/api-patterns/api-style.md +42 -0
  53. package/.agent/skills/api-patterns/auth.md +24 -0
  54. package/.agent/skills/api-patterns/documentation.md +26 -0
  55. package/.agent/skills/api-patterns/graphql.md +41 -0
  56. package/.agent/skills/api-patterns/rate-limiting.md +31 -0
  57. package/.agent/skills/api-patterns/response.md +37 -0
  58. package/.agent/skills/api-patterns/rest.md +40 -0
  59. package/.agent/skills/api-patterns/scripts/api_validator.py +211 -0
  60. package/.agent/skills/api-patterns/security-testing.md +122 -0
  61. package/.agent/skills/api-patterns/trpc.md +41 -0
  62. package/.agent/skills/api-patterns/versioning.md +22 -0
  63. package/.agent/skills/app-builder/SKILL.md +75 -0
  64. package/.agent/skills/app-builder/agent-coordination.md +71 -0
  65. package/.agent/skills/app-builder/feature-building.md +53 -0
  66. package/.agent/skills/app-builder/project-detection.md +34 -0
  67. package/.agent/skills/app-builder/scaffolding.md +118 -0
  68. package/.agent/skills/app-builder/tech-stack.md +40 -0
  69. package/.agent/skills/app-builder/templates/SKILL.md +39 -0
  70. package/.agent/skills/app-builder/templates/astro-static/TEMPLATE.md +76 -0
  71. package/.agent/skills/app-builder/templates/chrome-extension/TEMPLATE.md +92 -0
  72. package/.agent/skills/app-builder/templates/cli-tool/TEMPLATE.md +88 -0
  73. package/.agent/skills/app-builder/templates/electron-desktop/TEMPLATE.md +88 -0
  74. package/.agent/skills/app-builder/templates/express-api/TEMPLATE.md +83 -0
  75. package/.agent/skills/app-builder/templates/flutter-app/TEMPLATE.md +90 -0
  76. package/.agent/skills/app-builder/templates/monorepo-turborepo/TEMPLATE.md +90 -0
  77. package/.agent/skills/app-builder/templates/nextjs-fullstack/TEMPLATE.md +122 -0
  78. package/.agent/skills/app-builder/templates/nextjs-saas/TEMPLATE.md +122 -0
  79. package/.agent/skills/app-builder/templates/nextjs-static/TEMPLATE.md +169 -0
  80. package/.agent/skills/app-builder/templates/nuxt-app/TEMPLATE.md +134 -0
  81. package/.agent/skills/app-builder/templates/python-fastapi/TEMPLATE.md +83 -0
  82. package/.agent/skills/app-builder/templates/react-native-app/TEMPLATE.md +119 -0
  83. package/.agent/skills/architecture/SKILL.md +55 -0
  84. package/.agent/skills/architecture/context-discovery.md +43 -0
  85. package/.agent/skills/architecture/examples.md +94 -0
  86. package/.agent/skills/architecture/pattern-selection.md +68 -0
  87. package/.agent/skills/architecture/patterns-reference.md +50 -0
  88. package/.agent/skills/architecture/trade-off-analysis.md +77 -0
  89. package/.agent/skills/clean-code/SKILL.md +201 -0
  90. package/.agent/skills/doc.md +177 -0
  91. package/.agent/skills/frontend-design/SKILL.md +418 -0
  92. package/.agent/skills/frontend-design/animation-guide.md +331 -0
  93. package/.agent/skills/frontend-design/color-system.md +311 -0
  94. package/.agent/skills/frontend-design/decision-trees.md +418 -0
  95. package/.agent/skills/frontend-design/motion-graphics.md +306 -0
  96. package/.agent/skills/frontend-design/scripts/accessibility_checker.py +183 -0
  97. package/.agent/skills/frontend-design/scripts/ux_audit.py +722 -0
  98. package/.agent/skills/frontend-design/typography-system.md +345 -0
  99. package/.agent/skills/frontend-design/ux-psychology.md +1116 -0
  100. package/.agent/skills/frontend-design/visual-effects.md +383 -0
  101. package/.agent/skills/i18n-localization/SKILL.md +154 -0
  102. package/.agent/skills/i18n-localization/scripts/i18n_checker.py +241 -0
  103. package/.agent/skills/mcp-builder/SKILL.md +176 -0
  104. package/.agent/skills/web-design-guidelines/SKILL.md +57 -0
  105. package/.agent/workflows/brainstorm.md +113 -0
  106. package/.agent/workflows/create.md +59 -0
  107. package/.agent/workflows/debug.md +103 -0
  108. package/.agent/workflows/deploy.md +176 -0
  109. package/.agent/workflows/enhance.md +63 -0
  110. package/.agent/workflows/orchestrate.md +237 -0
  111. package/.agent/workflows/plan.md +89 -0
  112. package/.agent/workflows/preview.md +81 -0
  113. package/.agent/workflows/simple-test.md +42 -0
  114. package/.agent/workflows/status.md +86 -0
  115. package/.agent/workflows/structured-orchestrate.md +180 -0
  116. package/.agent/workflows/test.md +144 -0
  117. package/.agent/workflows/ui-ux-pro-max.md +296 -0
  118. package/.claude/settings.local.json +157 -149
  119. package/.editorconfig +56 -0
  120. package/.husky/pre-commit +4 -0
  121. package/.lintstagedrc +7 -0
  122. package/.prettierignore +29 -0
  123. package/.prettierrc +11 -0
  124. package/CLAUDE.md +2 -0
  125. package/README.md +64 -55
  126. package/SPEC.md +102 -61
  127. package/cli/bin/foliko.js +4 -4
  128. package/cli/src/commands/chat.js +53 -51
  129. package/cli/src/commands/list.js +40 -37
  130. package/cli/src/index.js +18 -18
  131. package/cli/src/ui/chat-ui.js +78 -76
  132. package/cli/src/utils/ansi.js +15 -15
  133. package/cli/src/utils/markdown.js +112 -116
  134. package/docker-compose.yml +1 -1
  135. package/docs/ai-sdk-optimization.md +655 -636
  136. package/docs/features.md +80 -80
  137. package/docs/quick-reference.md +49 -46
  138. package/docs/user-manual.md +411 -380
  139. package/examples/ambient-example.js +95 -97
  140. package/examples/basic.js +115 -110
  141. package/examples/bootstrap.js +52 -43
  142. package/examples/mcp-example.js +56 -53
  143. package/examples/skill-example.js +49 -49
  144. package/examples/test-chat.js +60 -58
  145. package/examples/test-mcp.js +49 -43
  146. package/examples/test-reload.js +38 -40
  147. package/examples/test-telegram.js +3 -3
  148. package/examples/test-tg-bot.js +7 -4
  149. package/examples/test-tg-simple.js +4 -3
  150. package/examples/test-tg.js +3 -3
  151. package/examples/test-think.js +13 -7
  152. package/examples/test-web-plugin.js +61 -56
  153. package/examples/test-weixin-feishu.js +40 -37
  154. package/examples/workflow.js +49 -49
  155. package/foliko-1.0.75.tgz +0 -0
  156. package/package.json +37 -3
  157. package/plugins/ai-plugin.js +7 -5
  158. package/plugins/ambient-agent/EventWatcher.js +113 -0
  159. package/plugins/ambient-agent/ExplorerLoop.js +640 -0
  160. package/plugins/ambient-agent/GoalManager.js +197 -0
  161. package/plugins/ambient-agent/Reflector.js +95 -0
  162. package/plugins/ambient-agent/StateStore.js +90 -0
  163. package/plugins/ambient-agent/constants.js +101 -0
  164. package/plugins/ambient-agent/index.js +579 -0
  165. package/plugins/default-plugins.js +62 -49
  166. package/plugins/email/constants.js +64 -0
  167. package/plugins/email/handlers.js +461 -0
  168. package/plugins/email/index.js +278 -0
  169. package/plugins/email/monitor.js +269 -0
  170. package/plugins/email/parser.js +138 -0
  171. package/plugins/email/reply.js +151 -0
  172. package/plugins/email/utils.js +124 -0
  173. package/plugins/feishu-plugin.js +23 -19
  174. package/plugins/file-system-plugin.js +469 -120
  175. package/plugins/install-plugin.js +6 -4
  176. package/plugins/python-executor-plugin.js +3 -1
  177. package/plugins/python-plugin-loader.js +10 -8
  178. package/plugins/rules-plugin.js +5 -3
  179. package/plugins/scheduler-plugin.js +18 -16
  180. package/plugins/session-plugin.js +3 -1
  181. package/plugins/storage-plugin.js +5 -3
  182. package/plugins/subagent-plugin.js +152 -92
  183. package/plugins/telegram-plugin.js +26 -19
  184. package/plugins/think-plugin.js +4 -2
  185. package/plugins/tools-plugin.js +3 -1
  186. package/plugins/web-plugin.js +15 -13
  187. package/plugins/weixin-plugin.js +43 -36
  188. package/reports/system-health-report-20260401.md +79 -0
  189. package/skills/ambient-agent/SKILL.md +49 -39
  190. package/skills/foliko-dev/AGENTS.md +64 -61
  191. package/skills/foliko-dev/SKILL.md +125 -119
  192. package/skills/mcp-usage/SKILL.md +19 -17
  193. package/skills/python-plugin-dev/SKILL.md +16 -15
  194. package/skills/skill-guide/SKILL.md +12 -12
  195. package/skills/subagent-guide/SKILL.md +237 -0
  196. package/skills/workflow-guide/SKILL.md +90 -45
  197. package/skills/workflow-troubleshooting/DEBUGGING.md +36 -21
  198. package/skills/workflow-troubleshooting/SKILL.md +156 -79
  199. package/src/capabilities/index.js +4 -4
  200. package/src/capabilities/skill-manager.js +211 -197
  201. package/src/capabilities/workflow-engine.js +461 -547
  202. package/src/core/agent-chat.js +426 -279
  203. package/src/core/agent.js +453 -248
  204. package/src/core/framework.js +183 -149
  205. package/src/core/index.js +8 -8
  206. package/src/core/plugin-base.js +52 -52
  207. package/src/core/plugin-manager.js +377 -281
  208. package/src/core/provider.js +35 -32
  209. package/src/core/sub-agent-config.js +264 -0
  210. package/src/core/system-prompt-builder.js +120 -0
  211. package/src/core/tool-registry.js +416 -33
  212. package/src/core/tool-router.js +149 -68
  213. package/src/executors/executor-base.js +58 -58
  214. package/src/executors/mcp-executor.js +269 -257
  215. package/src/index.js +5 -17
  216. package/src/utils/circuit-breaker.js +301 -0
  217. package/src/utils/error-boundary.js +363 -0
  218. package/src/utils/error.js +374 -0
  219. package/src/utils/event-emitter.js +20 -20
  220. package/src/utils/id.js +133 -0
  221. package/src/utils/index.js +217 -3
  222. package/src/utils/logger.js +181 -0
  223. package/src/utils/plugin-helpers.js +90 -0
  224. package/src/utils/retry.js +122 -0
  225. package/src/utils/sandbox.js +292 -0
  226. package/test/tool-registry-validation.test.js +218 -0
  227. package/test_report.md +70 -0
  228. package/website/docs/api.html +169 -107
  229. package/website/docs/configuration.html +296 -144
  230. package/website/docs/plugin-development.html +154 -85
  231. package/website/docs/project-structure.html +110 -109
  232. package/website/docs/skill-development.html +117 -61
  233. package/website/index.html +209 -205
  234. package/website/script.js +20 -17
  235. package/website/styles.css +1 -1
  236. package/plugins/ambient-agent-plugin.js +0 -1565
  237. package/plugins/email.js +0 -1142
package/website/docs/configuration.html CHANGED
@@ -1,57 +1,125 @@
1
- <!DOCTYPE html>
1
+ <!doctype html>
2
2
  <html lang="zh-CN">
3
- <head>
4
- <meta charset="UTF-8">
5
- <meta name="viewport" content="width=device-width, initial-scale=1.0">
6
- <title>配置指南 - Foliko</title>
7
- <link rel="stylesheet" href="../styles.css">
8
- <style>
9
- .sidebar { position: fixed; left: 0; top: 60px; width: 250px; height: calc(100vh - 60px); background: var(--bg-card); border-right: 1px solid var(--border); padding: 2rem 1rem; overflow-y: auto; }
10
- .sidebar ul { list-style: none; }
11
- .sidebar li { margin-bottom: 0.5rem; }
12
- .sidebar a { color: var(--text-secondary); text-decoration: none; display: block; padding: 0.5rem; border-radius: 4px; }
13
- .sidebar a:hover, .sidebar a.active { background: rgba(99, 102, 241, 0.2); color: var(--primary); }
14
- .main-content { margin-left: 250px; padding: 2rem; max-width: 900px; }
15
- .main-content h1 { font-size: 2rem; margin-bottom: 1rem; }
16
- .main-content h2 { font-size: 1.5rem; margin: 2rem 0 1rem; color: var(--secondary); }
17
- .main-content p { margin-bottom: 1rem; color: var(--text-secondary); }
18
- .main-content pre { background: var(--bg-card); padding: 1rem; border-radius: 8px; overflow-x: auto; margin-bottom: 1rem; }
19
- .main-content code { font-family: 'Fira Code', monospace; background: var(--bg-dark); padding: 0.2rem 0.4rem; border-radius: 4px; }
20
- table { width: 100%; border-collapse: collapse; margin-bottom: 1rem; }
21
- th, td { padding: 0.75rem; text-align: left; border: 1px solid var(--border); }
22
- th { background: var(--bg-card); color: var(--secondary); }
23
- @media (max-width: 768px) { .sidebar { display: none; } .main-content { margin-left: 0; } }
24
- </style>
25
- </head>
26
- <body>
27
- <header>
28
- <nav>
29
- <div class="logo">Foliko</div>
30
- <ul class="nav-links">
31
- <li><a href="../index.html">首页</a></li>
32
- <li><a href="../index.html#features">特性</a></li>
33
- <li><a href="../index.html#quickstart">快速开始</a></li>
34
- <li><a href="../index.html#docs">文档</a></li>
35
- </ul>
36
- </nav>
37
- </header>
3
+ <head>
4
+ <meta charset="UTF-8" />
5
+ <meta name="viewport" content="width=device-width, initial-scale=1.0" />
6
+ <title>配置指南 - Foliko</title>
7
+ <link rel="stylesheet" href="../styles.css" />
8
+ <style>
9
+ .sidebar {
10
+ position: fixed;
11
+ left: 0;
12
+ top: 60px;
13
+ width: 250px;
14
+ height: calc(100vh - 60px);
15
+ background: var(--bg-card);
16
+ border-right: 1px solid var(--border);
17
+ padding: 2rem 1rem;
18
+ overflow-y: auto;
19
+ }
20
+ .sidebar ul {
21
+ list-style: none;
22
+ }
23
+ .sidebar li {
24
+ margin-bottom: 0.5rem;
25
+ }
26
+ .sidebar a {
27
+ color: var(--text-secondary);
28
+ text-decoration: none;
29
+ display: block;
30
+ padding: 0.5rem;
31
+ border-radius: 4px;
32
+ }
33
+ .sidebar a:hover,
34
+ .sidebar a.active {
35
+ background: rgba(99, 102, 241, 0.2);
36
+ color: var(--primary);
37
+ }
38
+ .main-content {
39
+ margin-left: 250px;
40
+ padding: 2rem;
41
+ max-width: 900px;
42
+ }
43
+ .main-content h1 {
44
+ font-size: 2rem;
45
+ margin-bottom: 1rem;
46
+ }
47
+ .main-content h2 {
48
+ font-size: 1.5rem;
49
+ margin: 2rem 0 1rem;
50
+ color: var(--secondary);
51
+ }
52
+ .main-content p {
53
+ margin-bottom: 1rem;
54
+ color: var(--text-secondary);
55
+ }
56
+ .main-content pre {
57
+ background: var(--bg-card);
58
+ padding: 1rem;
59
+ border-radius: 8px;
60
+ overflow-x: auto;
61
+ margin-bottom: 1rem;
62
+ }
63
+ .main-content code {
64
+ font-family: 'Fira Code', monospace;
65
+ background: var(--bg-dark);
66
+ padding: 0.2rem 0.4rem;
67
+ border-radius: 4px;
68
+ }
69
+ table {
70
+ width: 100%;
71
+ border-collapse: collapse;
72
+ margin-bottom: 1rem;
73
+ }
74
+ th,
75
+ td {
76
+ padding: 0.75rem;
77
+ text-align: left;
78
+ border: 1px solid var(--border);
79
+ }
80
+ th {
81
+ background: var(--bg-card);
82
+ color: var(--secondary);
83
+ }
84
+ @media (max-width: 768px) {
85
+ .sidebar {
86
+ display: none;
87
+ }
88
+ .main-content {
89
+ margin-left: 0;
90
+ }
91
+ }
92
+ </style>
93
+ </head>
94
+ <body>
95
+ <header>
96
+ <nav>
97
+ <div class="logo">Foliko</div>
98
+ <ul class="nav-links">
99
+ <li><a href="../index.html">首页</a></li>
100
+ <li><a href="../index.html#features">特性</a></li>
101
+ <li><a href="../index.html#quickstart">快速开始</a></li>
102
+ <li><a href="../index.html#docs">文档</a></li>
103
+ </ul>
104
+ </nav>
105
+ </header>
38
106
 
39
- <div class="sidebar">
40
- <ul>
41
- <li><a href="project-structure.html">项目结构</a></li>
42
- <li><a href="configuration.html" class="active">配置指南</a></li>
43
- <li><a href="plugin-development.html">插件开发</a></li>
44
- <li><a href="skill-development.html">技能开发</a></li>
45
- <li><a href="api.html">API 参考</a></li>
46
- </ul>
47
- </div>
107
+ <div class="sidebar">
108
+ <ul>
109
+ <li><a href="project-structure.html">项目结构</a></li>
110
+ <li><a href="configuration.html" class="active">配置指南</a></li>
111
+ <li><a href="plugin-development.html">插件开发</a></li>
112
+ <li><a href="skill-development.html">技能开发</a></li>
113
+ <li><a href="api.html">API 参考</a></li>
114
+ </ul>
115
+ </div>
48
116
 
49
- <div class="main-content">
50
- <h1>配置指南</h1>
117
+ <div class="main-content">
118
+ <h1>配置指南</h1>
51
119
 
52
- <h2>环境变量配置 (.env)</h2>
53
- <p>在项目根目录创建 <code>.env</code> 文件：</p>
54
- <pre><code># AI Provider: minimax, deepseek, openai, anthropic 等
120
+ <h2>环境变量配置 (.env)</h2>
121
+ <p>在项目根目录创建 <code>.env</code> 文件：</p>
122
+ <pre><code># AI Provider: minimax, deepseek, openai, anthropic 等
55
123
  FOLIKO_PROVIDER=minimax
56
124
 
57
125
  # AI Model（可选，不填则使用 provider 默认值）
@@ -70,11 +138,11 @@ FOLIKO_API_KEY=
70
138
  # Provider 专用 API Key（可选）
71
139
  DEEPSEEK_API_KEY=sk-your-deepseek-api-key
72
140
  MINIMAX_API_KEY=sk-your-minimax-api-key</code></pre>
73
- <p><strong>配置优先级</strong>：命令行参数 > .env配置 > provider默认值</p>
141
+ <p><strong>配置优先级</strong>：命令行参数 > .env配置 > provider默认值</p>
74
142
 
75
- <h2>目录结构</h2>
76
- <p>在项目根目录创建 <code>.agent</code> 目录：</p>
77
- <pre><code>项目目录/
143
+ <h2>目录结构</h2>
144
+ <p>在项目根目录创建 <code>.agent</code> 目录：</p>
145
+ <pre><code>项目目录/
78
146
  └── .agent/
79
147
  ├── config # 配置文件
80
148
  ├── ai.json # AI 配置
@@ -83,25 +151,25 @@ MINIMAX_API_KEY=sk-your-minimax-api-key</code></pre>
83
151
  ├── skills/ # 用户技能
84
152
  └── data/ # 数据目录</code></pre>
85
153
 
86
- <h2>config 文件</h2>
87
- <p>简单的 key=value 格式配置：</p>
88
- <pre><code>ai_key: your-api-key
154
+ <h2>config 文件</h2>
155
+ <p>简单的 key=value 格式配置：</p>
156
+ <pre><code>ai_key: your-api-key
89
157
  ai_model: MiniMax-M2.7
90
158
  ai_provider: minimax
91
159
  ai_base_url: https://api.minimaxi.com/v1</code></pre>
92
160
 
93
- <h2>ai.json</h2>
94
- <p>JSON 格式的 AI 配置：</p>
95
- <pre><code>{
161
+ <h2>ai.json</h2>
162
+ <p>JSON 格式的 AI 配置：</p>
163
+ <pre><code>{
96
164
  "provider": "minimax",
97
165
  "model": "MiniMax-M2.7",
98
166
  "apiKey": "your-api-key",
99
167
  "baseURL": "https://api.minimaxi.com/v1"
100
168
  }</code></pre>
101
169
 
102
- <h2>mcp_config.json</h2>
103
- <p>MCP 服务器配置：</p>
104
- <pre><code>{
170
+ <h2>mcp_config.json</h2>
171
+ <p>MCP 服务器配置：</p>
172
+ <pre><code>{
105
173
  "mcpServers": {
106
174
  "fetch": {
107
175
  "command": "npx",
@@ -114,38 +182,38 @@ ai_base_url: https://api.minimaxi.com/v1</code></pre>
114
182
  }
115
183
  }</code></pre>
116
184
 
117
- <h2>CLI 参数</h2>
118
- <p>命令行参数会覆盖 .env 配置：</p>
119
- <table>
120
- <tr>
121
- <th>参数</th>
122
- <th>说明</th>
123
- <th>示例</th>
124
- </tr>
125
- <tr>
126
- <td><code>--provider</code></td>
127
- <td>指定 AI 提供商</td>
128
- <td><code>deepseek</code>, <code>minimax</code></td>
129
- </tr>
130
- <tr>
131
- <td><code>--model</code></td>
132
- <td>指定 AI 模型</td>
133
- <td><code>deepseek-chat</code>, <code>MiniMax-M2.7</code></td>
134
- </tr>
135
- <tr>
136
- <td><code>--base-url</code></td>
137
- <td>指定 API 地址</td>
138
- <td><code>https://api.deepseek.com/v1</code></td>
139
- </tr>
140
- <tr>
141
- <td><code>--api-key</code></td>
142
- <td>指定 API 密钥</td>
143
- <td><code>sk-xxx</code></td>
144
- </tr>
145
- </table>
185
+ <h2>CLI 参数</h2>
186
+ <p>命令行参数会覆盖 .env 配置：</p>
187
+ <table>
188
+ <tr>
189
+ <th>参数</th>
190
+ <th>说明</th>
191
+ <th>示例</th>
192
+ </tr>
193
+ <tr>
194
+ <td><code>--provider</code></td>
195
+ <td>指定 AI 提供商</td>
196
+ <td><code>deepseek</code>, <code>minimax</code></td>
197
+ </tr>
198
+ <tr>
199
+ <td><code>--model</code></td>
200
+ <td>指定 AI 模型</td>
201
+ <td><code>deepseek-chat</code>, <code>MiniMax-M2.7</code></td>
202
+ </tr>
203
+ <tr>
204
+ <td><code>--base-url</code></td>
205
+ <td>指定 API 地址</td>
206
+ <td><code>https://api.deepseek.com/v1</code></td>
207
+ </tr>
208
+ <tr>
209
+ <td><code>--api-key</code></td>
210
+ <td>指定 API 密钥</td>
211
+ <td><code>sk-xxx</code></td>
212
+ </tr>
213
+ </table>
146
214
 
147
- <h3>使用示例</h3>
148
- <pre><code># 使用 .env 中的配置
215
+ <h3>使用示例</h3>
216
+ <pre><code># 使用 .env 中的配置
149
217
  npm run chat
150
218
 
151
219
  # 指定完整配置
@@ -157,10 +225,10 @@ foliko chat --provider deepseek --api-key sk-xxx
157
225
  # 只指定 api-key（使用 FOLIKO_PROVIDER 设定的 provider）
158
226
  foliko chat --api-key sk-xxx</code></pre>
159
227
 
160
- <h2>插件配置</h2>
228
+ <h2>插件配置</h2>
161
229
 
162
- <h3>Telegram 插件</h3>
163
- <pre><code>{
230
+ <h3>Telegram 插件</h3>
231
+ <pre><code>{
164
232
  "telegram": {
165
233
  "botToken": "your-bot-token",
166
234
  "allowedChats": ["123456789"],
@@ -168,31 +236,67 @@ foliko chat --api-key sk-xxx</code></pre>
168
236
  "prefix": "/"
169
237
  }
170
238
  }</code></pre>
171
- <table>
172
- <tr><th>配置项</th><th>说明</th><th>默认值</th></tr>
173
- <tr><td>botToken</td><td>Telegram Bot Token</td><td>TELEGRAM_BOT_TOKEN 环境变量</td></tr>
174
- <tr><td>allowedChats</td><td>允许的聊天 ID 数组</td><td>[] (允许所有人)</td></tr>
175
- <tr><td>groupMode</td><td>是否启用群组模式</td><td>false</td></tr>
176
- <tr><td>prefix</td><td>命令前缀</td><td>/</td></tr>
177
- </table>
239
+ <table>
240
+ <tr>
241
+ <th>配置项</th>
242
+ <th>说明</th>
243
+ <th>默认值</th>
244
+ </tr>
245
+ <tr>
246
+ <td>botToken</td>
247
+ <td>Telegram Bot Token</td>
248
+ <td>TELEGRAM_BOT_TOKEN 环境变量</td>
249
+ </tr>
250
+ <tr>
251
+ <td>allowedChats</td>
252
+ <td>允许的聊天 ID 数组</td>
253
+ <td>[] (允许所有人)</td>
254
+ </tr>
255
+ <tr>
256
+ <td>groupMode</td>
257
+ <td>是否启用群组模式</td>
258
+ <td>false</td>
259
+ </tr>
260
+ <tr>
261
+ <td>prefix</td>
262
+ <td>命令前缀</td>
263
+ <td>/</td>
264
+ </tr>
265
+ </table>
178
266
 
179
- <h3>WeChat 插件</h3>
180
- <pre><code>{
267
+ <h3>WeChat 插件</h3>
268
+ <pre><code>{
181
269
  "weixin": {
182
270
  "forceLogin": false,
183
271
  "qrcodeTerminal": true,
184
272
  "allowedUsers": []
185
273
  }
186
274
  }</code></pre>
187
- <table>
188
- <tr><th>配置项</th><th>说明</th><th>默认值</th></tr>
189
- <tr><td>forceLogin</td><td>强制重新扫码登录</td><td>false</td></tr>
190
- <tr><td>qrcodeTerminal</td><td>终端渲染二维码</td><td>true</td></tr>
191
- <tr><td>allowedUsers</td><td>允许的用户 ID 数组</td><td>[] (允许所有人)</td></tr>
192
- </table>
275
+ <table>
276
+ <tr>
277
+ <th>配置项</th>
278
+ <th>说明</th>
279
+ <th>默认值</th>
280
+ </tr>
281
+ <tr>
282
+ <td>forceLogin</td>
283
+ <td>强制重新扫码登录</td>
284
+ <td>false</td>
285
+ </tr>
286
+ <tr>
287
+ <td>qrcodeTerminal</td>
288
+ <td>终端渲染二维码</td>
289
+ <td>true</td>
290
+ </tr>
291
+ <tr>
292
+ <td>allowedUsers</td>
293
+ <td>允许的用户 ID 数组</td>
294
+ <td>[] (允许所有人)</td>
295
+ </tr>
296
+ </table>
193
297
 
194
- <h3>Session 插件</h3>
195
- <pre><code>{
298
+ <h3>Session 插件</h3>
299
+ <pre><code>{
196
300
  "session": {
197
301
  "sessionTTL": 1800000,
198
302
  "maxSessions": 100,
@@ -201,44 +305,92 @@ foliko chat --api-key sk-xxx</code></pre>
201
305
  "cleanupInterval": 300000
202
306
  }
203
307
  }</code></pre>
204
- <table>
205
- <tr><th>配置项</th><th>说明</th><th>默认值</th></tr>
206
- <tr><td>sessionTTL</td><td>会话过期时间(毫秒)</td><td>30分钟</td></tr>
207
- <tr><td>maxSessions</td><td>最大会话数</td><td>100</td></tr>
208
- <tr><td>maxHistoryLength</td><td>最大历史消息数</td><td>50</td></tr>
209
- <tr><td>autoCleanup</td><td>自动清理过期会话</td><td>true</td></tr>
210
- <tr><td>cleanupInterval</td><td>清理检查间隔(毫秒)</td><td>5分钟</td></tr>
211
- </table>
308
+ <table>
309
+ <tr>
310
+ <th>配置项</th>
311
+ <th>说明</th>
312
+ <th>默认值</th>
313
+ </tr>
314
+ <tr>
315
+ <td>sessionTTL</td>
316
+ <td>会话过期时间(毫秒)</td>
317
+ <td>30分钟</td>
318
+ </tr>
319
+ <tr>
320
+ <td>maxSessions</td>
321
+ <td>最大会话数</td>
322
+ <td>100</td>
323
+ </tr>
324
+ <tr>
325
+ <td>maxHistoryLength</td>
326
+ <td>最大历史消息数</td>
327
+ <td>50</td>
328
+ </tr>
329
+ <tr>
330
+ <td>autoCleanup</td>
331
+ <td>自动清理过期会话</td>
332
+ <td>true</td>
333
+ </tr>
334
+ <tr>
335
+ <td>cleanupInterval</td>
336
+ <td>清理检查间隔(毫秒)</td>
337
+ <td>5分钟</td>
338
+ </tr>
339
+ </table>
212
340
 
213
- <h3>Storage 插件</h3>
214
- <pre><code>{
341
+ <h3>Storage 插件</h3>
342
+ <pre><code>{
215
343
  "storage": {
216
344
  "type": "json",
217
345
  "path": ".agent/data",
218
346
  "namespace": "default"
219
347
  }
220
348
  }</code></pre>
221
- <table>
222
- <tr><th>配置项</th><th>说明</th><th>默认值</th></tr>
223
- <tr><td>type</td><td>存储类型 (json/memory)</td><td>json</td></tr>
224
- <tr><td>path</td><td>存储文件路径</td><td>.agent/data</td></tr>
225
- <tr><td>namespace</td><td>命名空间</td><td>default</td></tr>
226
- </table>
349
+ <table>
350
+ <tr>
351
+ <th>配置项</th>
352
+ <th>说明</th>
353
+ <th>默认值</th>
354
+ </tr>
355
+ <tr>
356
+ <td>type</td>
357
+ <td>存储类型 (json/memory)</td>
358
+ <td>json</td>
359
+ </tr>
360
+ <tr>
361
+ <td>path</td>
362
+ <td>存储文件路径</td>
363
+ <td>.agent/data</td>
364
+ </tr>
365
+ <tr>
366
+ <td>namespace</td>
367
+ <td>命名空间</td>
368
+ <td>default</td>
369
+ </tr>
370
+ </table>
227
371
 
228
- <h3>Scheduler 插件</h3>
229
- <pre><code>{
372
+ <h3>Scheduler 插件</h3>
373
+ <pre><code>{
230
374
  "scheduler": {
231
375
  "checkInterval": 1000
232
376
  }
233
377
  }</code></pre>
234
- <table>
235
- <tr><th>配置项</th><th>说明</th><th>默认值</th></tr>
236
- <tr><td>checkInterval</td><td>任务检查间隔(毫秒)</td><td>1000</td></tr>
237
- </table>
378
+ <table>
379
+ <tr>
380
+ <th>配置项</th>
381
+ <th>说明</th>
382
+ <th>默认值</th>
383
+ </tr>
384
+ <tr>
385
+ <td>checkInterval</td>
386
+ <td>任务检查间隔(毫秒)</td>
387
+ <td>1000</td>
388
+ </tr>
389
+ </table>
238
390
 
239
- <h3>Email 插件</h3>
240
- <p>通过环境变量配置：</p>
241
- <pre><code># SMTP 配置 (发送邮件)
391
+ <h3>Email 插件</h3>
392
+ <p>通过环境变量配置：</p>
393
+ <pre><code># SMTP 配置 (发送邮件)
242
394
  SMTP_HOST=smtp.gmail.com
243
395
  SMTP_PORT=587
244
396
  SMTP_SECURE=false
@@ -254,9 +406,9 @@ IMAP_PASS=your-app-password
254
406
  # 默认发件人
255
407
  FROM_EMAIL=your-email@gmail.com</code></pre>
256
408
 
257
- <h3>MCP 配置</h3>
258
- <p>在 <code>.agent/mcp_config.json</code> 中配置 MCP 服务器：</p>
259
- <pre><code>{
409
+ <h3>MCP 配置</h3>
410
+ <p>在 <code>.agent/mcp_config.json</code> 中配置 MCP 服务器：</p>
411
+ <pre><code>{
260
412
  "mcpServers": {
261
413
  "fetch": {
262
414
  "command": "npx",
@@ -268,6 +420,6 @@ FROM_EMAIL=your-email@gmail.com</code></pre>
268
420
  }
269
421
  }
270
422
  }</code></pre>
271
- </div>
272
- </body>
423
+ </div>
424
+ </body>
273
425
  </html>