phinix 0.0.4 → 0.0.6

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "phinix",
-  "version": "0.0.4",
+  "version": "0.0.6",
   "description": "phinix - A Model Context Protocol server for managing and generating React components",
   "main": "src/index.js",
   "bin": {

package/src/resources/project-knowledge.md

@@ -9,6 +9,7 @@
 - **UI 组件库**: DPAntd (定制化 Ant Design)
 - **路由**: React Router DOM
 - **图标**: AliIcon (@ali/icon)
+- **公共方法**: DPUtils（全局可用，无需导入）
 
 ## 代码规范
 以下是项目的代码规范，必须要遵循！
@@ -19,6 +20,13 @@
 - 非常重要：优先使用get_component_list获取到的组件，如果没有符合条件的组件，再使用DPAntd中的组件
 - 非常重要：单文件代码行数不得超过300行，如果超过必须拆分
 - 非常重要：枚举定义、interface定义等代码放到一个单独的define.ts文件中
+- 非常重要：所有文件顶部需要包含文件描述和作者信息${author}，例如
+  ```js
+  /**
+   * @description 组件的描述
+   * @author ${author}
+   */
+  ```
 
 ## 🎨 样式规范
 - 非常重要：优先使用tailwind完成样式开发
@@ -69,6 +77,41 @@ import { slice } from "@alife/raft"; // Raft方法全局可用
 - 重要：slice中的状态都需要添加注释说明
 
 - 非常重要：raft相关的所有方法全局可用，不需要导入
+- 非常重要：slice文件格式要和使用示例相同
+- 非常重要：slice使用时，需要和示例相同，先将state结构出来再进行使用
+
+### 使用示例
+#### slice文件
+```tsx
+/**
+ * @author 作者
+ * @description 对话式AI，反馈组件（点赞、点踩） slice
+ */
+export const AIFeedbackSlice = slice(({ set }) => ({
+  /** 反馈结果 */
+  feedbackResult: API.metaCenter.aiFeedback.postMessageFeedback.initFetchResult(),
+
+  /** 反馈 */
+  feedback: API.metaCenter.aiFeedback.postMessageFeedback.createSliceAction(set, 'feedbackResult'),
+
+  /** 内部的反馈类型 */
+  innerFeedbackType: '' as 'LIKE' | 'DISLIKE' | '',
+
+  /** 是否展示反馈popover */
+  isShowFeedbackPopover: false,
+
+  /** 反馈标签 */
+  feedbackTags: [] as string[],
+
+  /** 反馈文本 */
+  feedbackText: '',
+}));
+```
+#### slice使用：
+``` tsx
+const [{ feedback, innerFeedbackType, feedbackTags, feedbackText, isShowFeedbackPopover, feedbackResult }, setState] =
+    useStateSlice(SliceName);
+```
 
 ## 📝 文本处理规范
 

package/src/tools/projectKnowledge.js

@@ -3,10 +3,39 @@ import path from "path";
 import { z } from "zod";
 import { __dirname } from "../config.js";
 
-export const projectKnowledgeSchema = {};
+// 获取作者信息，参照config.js中获取项目根目录的逻辑
+function getAuthor() {
+  // 优先级：命令行参数 > 环境变量 > 默认空字符串
+  const args = process.argv.slice(2);
+
+  // 检查命名参数 --author=name
+  const authorArg = args.find((arg) => arg.startsWith("--author="));
+  if (authorArg) {
+    return authorArg.split("=")[1];
+  }
+
+  // 检查环境变量
+  if (process.env.AUTHOR) {
+    return process.env.AUTHOR;
+  }
+
+  // 默认返回空字符串
+  return "";
+}
+
+export const projectKnowledgeSchema = {
+  author: {
+    type: "string",
+    description: "作者信息，将替换项目背景知识中的${author}占位符。优先级：参数 > --author命令行参数 > AUTHOR环境变量 > 空字符串",
+    default: ""
+  }
+};
 
 export async function getProjectKnowledge(params) {
   try {
+    // 获取作者信息，优先级：传入参数 > 命令行参数 > 环境变量 > 默认空字符串
+    const author = params.author !== undefined ? params.author : getAuthor();
+    
     // 尝试多个可能的文件路径
     const possiblePaths = [
       path.join(__dirname, "resources/project-knowledge.md"),
@@ -37,6 +66,9 @@ export async function getProjectKnowledge(params) {
       );
     }
 
+    // 替换文件内容中的${author}占位符
+    const processedContent = fileContent.replace(/\$\{author\}/g, author);
+
     // 在第一次成功加载时记录路径
     if (!global._knowledgePath) {
       global._knowledgePath = knowledgePath;
@@ -47,11 +79,15 @@ export async function getProjectKnowledge(params) {
       content: [
         {
           type: "text",
-          text: fileContent,
+          text: processedContent,
         },
       ],
       data: {
         filePath: knowledgePath,
+        author: author,
+        authorSource: params.author !== undefined ? "parameter" : 
+                     process.argv.find(arg => arg.startsWith("--author=")) ? "command-line" :
+                     process.env.AUTHOR ? "environment" : "default",
         timestamp: new Date().toISOString(),
       },
     };