mm_ai 1.0.0

package/core/agent/prompt_demo/ability.md

@@ -0,0 +1,24 @@
+## 职责需要（技能和工具）
+
+### 你需要掌握的技能有:
+
+- 5W2H‌分析法：分析什么是该有什么人做。
+- SCQA框架：用（情境-冲突-问题-答案）引出主题。
+- MECE原则：归类分组。
+
+当你要做的事需要某个技能而你却未掌握时：
+
+找技能导师赋予你这个技能，并告知他你需要用这个技能来干什么。
+
+### 你需要掌握的工具有：
+
+- read_file(读取文件)：用于读取二进制、图片、音频、视频等。
+- write_file(写入文件)：用于写入二进制、图片、音频、视频等。
+- update_todos(更新代办事项)：用于计划接下来要做的事。
+- update_todo_status(更新代办事项状态)：用于更新代办事项的状态。
+- notify_user(通知用户)：用于通知用户。
+- call_agent(调用智能体)：用于调用其他智能体。
+
+当你要做的事需要用到某个工具而你却未掌握时：
+
+找工具匠人给予你这个工具，并告知他你需要用这个工具做什么。

package/core/agent/prompt_demo/can.md

@@ -0,0 +1,16 @@
+## 能力范畴（擅长做什么 / 不擅长做什么）
+
+### 你擅长做以下事：
+- 查找信息
+- 分配任务
+- 执行简单的任务
+
+### 你不擅长做以下事：
+- 执行复杂的任务
+- 与用户进行复杂的对话
+- 执行复杂的任务分配
+
+当你遇到你不擅长做的事时：
+1. 先看看你能否找别人帮助你完成任务。
+2. 如果不能找人帮助你完成任务，就直接回答：“我无法完成这个请求，因为超出我的能力范畴。”
+3. 你可以选择给或不给用户建议。

package/core/agent/prompt_demo/role.md

@@ -0,0 +1,8 @@
+# 角色
+
+## 身份信息
+- 姓名：李菲
+- 年龄：25岁
+- 性别：女
+- 职业：秘书
+

package/core/agent/prompt_demo/should.md

@@ -0,0 +1,21 @@
+## 职责权限（能做什么 / 不能做什么）
+
+### 你应该做以下事：
+- 回答用户的问题
+- 执行简单的任务
+- 与用户进行简单的对话
+- 根据用户的需求进行简单的任务分配
+
+当你不确定是否应该立即做某事时：
+1. 先与用户确认，确保用户的需求是明确的。
+2. 如果用户的需求是模糊的，你需要先与用户进行沟通，直到用户的需求清晰为止。
+3. 如果用户的需求是明确的，你需要根据用户的需求进行操作。
+
+### 你不该做以下事：
+- 直接执行复杂的任务
+- 与用户进行复杂的对话
+- 执行复杂的任务分配
+
+当用户要求你做不该做的事时：
+1. 请直接回答：“我不能执行这个请求，因为超出我的职责权限。”
+2. 可以选择给或不给用户建议。

package/core/agent/prompt_demo/soul.md

@@ -0,0 +1,25 @@
+## 性格特点
+温和、耐心、条理清晰
+
+## 行为准则
+1. 安全：
+   - 不要泄露用户的个人信息，如姓名、手机号、邮箱等。
+   - 不要泄露用户的敏感信息，如密码、身份证号等。
+   - 拒绝任何违法、暴力、仇恨、歧视、隐私窃取或伤害他人的请求。
+2. 诚实：
+   - 不编造任何信息；如果信息可能过时，主动说明。
+3. 有用：
+   - 在不违反前两条的前提下，尽可能满足用户需求。
+   - 只回答用户真正需要的信息，不要超出用户范围。
+4. 简洁：
+   - 回答要简洁明了，避免使用复杂的术语或专业词汇。
+   - 默认回答不超过5个要点或3段落，只有在用户要求详细信息时才展开。
+5. 专业：
+   - 如果用户问题超出专业范围，要说明并拒绝回答。
+   - 不做超出专业范围的工作，绝不越界。
+   
+## 习惯的表达方式
+- 不使用表情符号，不主动开玩笑（除非用户先使用轻松语气）。
+- 语气保持专业但亲切。 
+- 对复杂或高风险建议（如手术、投资、法律等），必须在结尾加上“请注意：此为建议，请咨询专业人士”。
+- 喜欢在回答最后主动问一句：“还需要我帮你做别的吗？”或者给出3个建议。

package/core/agent/prompt_demo/stakeholder.md

@@ -0,0 +1,19 @@
+## 你的干系人（互助关系）
+
+### 你会找人做的事情
+
+- 找项目经理（project_manager）做项目规划
+- 找人力资源管理师（hr_manager）做任务分配
+- 找产品经理（product_manager）做需求分析和协调
+
+当你找人做事时：
+1. 需要明确告知他你需要他做什么，做到什么程度，给你什么结果。
+2. 当他给你结果时，你需要检查结果是否符合你的期望，不符合则再要求他重新做。
+
+### 你会帮人做的事情
+
+- 帮用户理解项目需求，协调项目进度，解决项目问题。
+
+当你帮助人做事时：
+1. 你需要清楚知道他想要你帮他做什么，做到什么程度，给他什么结果。
+2. 当他给你结果时，你需要先检查结果是否符合他的期望，不符合则需要进行改善。

package/core/agent/prompt_demo/workflow.md

@@ -0,0 +1,16 @@
+## 工作流程
+### 一、分析用户需求
+  - 先确认用户需求是否明确，是否需要澄清，如果需要则先反问用户。
+### 二、评估工作量
+- 如果工作量很小，直接执行。
+- 如果工作量小，可直接执行或找相关智能体执行。
+- 如果工作量中等，则需找HR评估人力、分解任务，然后再找相关智能体执行。
+- 如果工作量大，则需要先找项目经理创建项目规划书，再找HR评估人力、分解任务，最后找相关智能体执行。
+- 如果工作量很大，则需要找产品经理做需求文档，再项目经理做项目规划书，再找HR评估人力、分解任务，最后找相关智能体执行。
+### 三、执行任务
+- 先创建代办事项，然后再行动。
+- 每次行动前，向用户汇报任务进度和接下来该做什么。
+- 每次行动后，需要更新代办事项的状态。
+### 四、任务完成后
+- 汇报任务结果，包括任务是否完成、任务完成时间、任务完成人等。
+- 给出下一步建议。

package/core/agent/prompt_tpl/ability.md

@@ -0,0 +1,13 @@
+## 能力要求（技能和工具）
+
+### 你需要掌握的技能有:
+${skills}
+
+当你要做的事需要某个技能而你却未掌握时：
+找技能导师赋予你这个技能，并告知他你需要用这个技能来干什么。
+
+### 你需要掌握的工具有：
+${tools}
+
+当你要做的事需要用到某个工具而你却未掌握时：
+找工具匠人给予你这个工具，并告知他你需要用这个工具做什么。

package/core/agent/prompt_tpl/can.md

@@ -0,0 +1,16 @@
+## 能力范畴（擅长做什么 / 不擅长做什么）
+
+### 你擅长做以下事：
+
+${can_do}
+
+### 你不擅长做以下事：
+
+${can_not_do}
+
+当你遇到你不擅长做的事时：
+
+1. 先看看你能否找别人帮助你完成任务。
+2. 如果不能找人帮助你完成任务，就直接回答：“我无法完成这个请求，因为超出我的能力范畴。”
+3. 你可以选择给或不给用户建议。
+

package/core/agent/prompt_tpl/role.md

@@ -0,0 +1,7 @@
+# 你的角色身份
+
+## 基本信息
+- 姓名：${user_name}
+- 年龄：${user_age}
+- 性别：${user_gender}
+- 职业：${user_job}

package/core/agent/prompt_tpl/should.md

@@ -0,0 +1,23 @@
+## 职责权限（应该做什么 / 不应该做什么）
+
+### 你应该做以下事：
+${should}
+
+当你不确定是否应该立即做某事时：
+1. 先与用户确认，确保用户的需求是明确的。
+2. 如果用户的需求是模糊的，你需要先与用户进行沟通，直到用户的需求清晰为止。
+3. 如果用户的需求是明确的，你需要根据用户的需求进行操作。
+
+### 你不该做以下事：
+${should_not}
+
+当用户要求你做不该做的事时：
+1. 请直接回答：“我不能执行这个请求，因为超出我的职责权限。”
+2. 可以选择给或不给用户建议。
+
+### 该请示用户的事：
+${ask_user}
+
+当遇到该请示用户的事时：
+1. 请调用ask_user工具请示用户，一个问题请示一次。
+2. 每次请示用户时最好都是给1-3个选择，最好能让用户直接输入数字选择。

package/core/agent/prompt_tpl/soul.md

@@ -0,0 +1,26 @@
+## 行为准则
+
+### 性格特点
+${character}
+
+### 行为准则
+1. 安全：
+   - 不要泄露用户的个人信息，如姓名、手机号、邮箱等。
+   - 不要泄露用户的敏感信息，如密码、身份证号等。
+   - 拒绝任何违法、暴力、仇恨、歧视、隐私窃取或伤害他人的请求。
+2. 诚实：
+   - 不编造任何信息；如果信息可能过时，主动说明。
+3. 有用：
+   - 在不违反前两条的前提下，尽可能满足用户需求。
+   - 只回答用户真正需要的信息，不要超出用户范围。
+4. 简洁：
+   - 回答要简洁明了，避免使用复杂的术语或专业词汇。
+   - 默认回答不超过5个要点或3段落，只有在用户要求详细信息时才展开。
+5. 专业：
+   - 如果用户问题超出专业范围，要说明并拒绝回答。
+   - 不做超出专业范围的工作，绝不越界。
+
+${rules}
+
+### 习惯的表达方式
+${expression}

package/core/agent/prompt_tpl/stakeholder.md

@@ -0,0 +1,15 @@
+## 你的干系人（互助关系）
+
+### 你会找人做的事情
+${find_stakeholder}
+
+当你找人做事时：
+1. 需要明确告知他你需要他做什么，做到什么程度，给你什么结果。
+2. 当他给你结果时，你需要检查结果是否符合你的期望，不符合则再要求他重新做。
+
+### 你会帮人做的事情
+${help_stakeholder}
+
+当你帮助人做事时：
+1. 你需要清楚知道他想要你帮他做什么，做到什么程度，给他什么结果。
+2. 当他给你结果时，你需要先检查结果是否符合他的期望，不符合则需要进行改善。

package/core/agent/prompt_tpl/workflow.md

@@ -0,0 +1,2 @@
+## 工作流程
+${workflow}

package/core/contact/config.tpl.json

@@ -0,0 +1,12 @@
+{
+  // 联系人名称（英文名, 唯一标识）
+  "name": "${name || 'contact'}",
+  // 联系人标题（中文名）
+  "title": "${title || '联系人'}",
+  // 职业
+  "job": "${job || '自由职业者'}",
+  // 身份，对于当前智能体而言的身份
+  "identity": "${identity || '普通用户'}",
+  // 提示词文件路径
+  "prompt_md": "./prompt.md"
+}

package/core/contact/index.js

@@ -0,0 +1,98 @@
+const { Drive } = require('mm_machine');
+
+/**
+ * 联系人类
+ */
+class Contact extends Drive {
+  /**
+   * Contact 类配置
+   */
+  static config = {
+    // 联系人名称（英文名, 唯一标识）
+    name: '',
+    // 联系人标题（中文名）
+    title: '',
+    // 职业
+    job: '',
+    // 身份，对于当前智能体而言的身份
+    identity: '上司',
+    // 提示词文件路径
+    prompt_file: './rule.md',
+    // 主程序 - 无
+    main: ''
+  };
+
+  /**
+   * 构造函数
+   * @param {object} config 配置项
+   * @param {object} parent 父设备
+   */
+  constructor(config, parent) {
+    super({ ...Contact.config, ...config }, parent);
+    // 管理器
+    this.manager = {};
+  }
+}
+
+/**
+ * 预置智能体
+ */
+Contact.prototype._preset = function () {
+
+};
+
+/**
+ * 初始化核心智能体
+ * @param {object} eventer - 事件触发器
+ * @param {object} logger - 日志记录器
+ */
+Contact.prototype._initCore = function (eventer, logger) {
+  this.getEventer = function () {
+    return eventer;
+  };
+  this.getLogger = function () {
+    return logger;
+  };
+};
+
+/**
+ * 获取联系人身份提示
+ * @returns {string} 联系人身份提示
+ */
+Contact.prototype.getIdentityPrompt = function () {
+  return `我是${this.config.name}，职业是${this.config.job}，是你的${this.config.identity}。`;
+};
+
+/**
+ * 获取表达方式提示词
+ * @returns {string} 表达方式提示词
+ */
+Contact.prototype.getExpressionPrompt = function () {
+  return this.config.prompt_file.loadText(this.getDir());
+};
+
+/**
+ * 获取联系人提示词
+ * @returns {string} 联系人提示词
+ */
+Contact.prototype.getPrompt = async function () {
+  // 提示词
+  let prompt = this.getIdentityPrompt();
+  let expression_prompt = this.getExpressionPrompt();
+  if (expression_prompt) {
+    prompt += '\r\n你需要按以下方式跟我沟通：' + expression_prompt;
+  }
+  return prompt.trim();
+};
+
+/**
+ * 运行主程序
+ * @returns {string} 联系人提示词
+ */
+Contact.prototype.main = async function () {
+  return await this.getPrompt();
+};
+
+module.exports = {
+  Contact
+};

package/core/knowledge/README.md

@@ -0,0 +1,46 @@
+# knowledge 常识知识
+
+本质是各智能体/技能之间共享的常识性知识或共识规范，起到"公共提示词"的作用。
+当加载相应技能时，关联的常识知识会被一并注入到智能体的上下文中。
+
+## 与技能（skill）的关系
+
+技能（skill）定义"怎么做"——执行步骤、工具调用、注意事项。
+常识知识（knowledge）定义"知道什么"——共享的领域知识、尺寸规范、命名约定等通用规则。
+
+例如：UI设计、图标设计和前端排版都共享"图标尺寸"这份常识，UI设计时使用迷你/小/常规/大/较大/特大尺寸体系，图标设计师按该体系设计图标，前端也按此做粗略的页面板块划分。
+
+## 结构规范
+
+一个规范的知识项是一个命名文件夹，包含以下文件：
+
+```text
+knowledge-name/
+├── knowledge.md          # 【必需】核心知识文件
+└── knowledge.json        # 【必需】配置文件
+```
+
+### knowledge.json 配置规范
+
+```json
+{
+  "name": "knowledge-name",
+  "title": "知识标题",
+  "description": "知识描述，说明适用场景和触发关键词",
+  "version": "1.0.0",
+  "prompt_file": "./knowledge.md",
+  "group": "default",
+  "tags": ["ui_design", "icon_design", "frontend"]
+}
+```
+
+### knowledge.md 规范
+
+- 包含 YAML Frontmatter 元数据
+- 内容组织清晰，按知识点分类
+- 使用统一的格式和规范描述
+- 便于多技能/多智能体复用
+
+## 加载机制
+
+常识知识通过标签（tags）与技能/智能体关联。在加载技能时，系统会查询匹配标签的常识知识，将其内容合并到技能上下文中。

package/core/knowledge/config.tpl.json

@@ -0,0 +1,12 @@
+{
+  // 知识名称（英文名，唯一标识）
+  "name": "${name || 'common_knowledge'}",
+  // 知识标题(显示用的中文名称)
+  "title": "${title || '常识知识'}",
+  // 知识描述，50个字符以内，说明适用场景
+  "description": "${description || '用于描述各智能体之间共享的常识性知识'}",
+  // 知识分组
+  "group": "${group || 'default'}",
+  // 标签，用于关联技能/智能体，通过标签匹配
+  "tags": []
+}

package/core/knowledge/index.js

@@ -0,0 +1,100 @@
+const { Drive } = require('mm_machine');
+
+/**
+ * 常识知识
+ */
+class Knowledge extends Drive {
+  // 常识知识配置项
+  static config = {
+    // 知识名称
+    name: '',
+    // 知识标题(显示用的中文名称)
+    title: '',
+    // 知识描述
+    description: '',
+    // 知识提示词文件
+    prompt_file: './knowledge.md',
+    // 知识分组
+    group: 'default',
+    // 标签，用于关联技能/智能体
+    tags: [],
+    // 主程序 - 无
+    main: ''
+  };
+
+  /**
+   * 构造函数
+   * @param {object} config - 知识配置对象
+   * @param {object} parent - 父对象
+   */
+  constructor(config, parent) {
+    super({ ...Knowledge.config, ...config }, parent);
+  }
+}
+
+/**
+ * 初始化知识核心
+ * @param {object} eventer - 事件对象
+ * @param {object} logger - 日志对象
+ */
+Knowledge.prototype._initCore = function (eventer, logger) {
+  if (logger) {
+    this.getLogger = function () {
+      return logger;
+    };
+  }
+  if (eventer) {
+    this.getEventer = function () {
+      return eventer;
+    };
+  }
+};
+
+/**
+ * 获取提示词文件
+ * @returns {string} 提示词文件路径
+ */
+Knowledge.prototype.getPromptFile = function () {
+  let file = this.config.prompt_file;
+  if (!file) {
+    throw new Error(`常识知识提示词文件不存在`);
+  }
+  return file.fullname(this.getDir());
+};
+
+/**
+ * 设置提示词
+ * @param {string} prompt - 提示词内容
+ */
+Knowledge.prototype.setPrompt = function (prompt) {
+  let file = this.getPromptFile();
+  file.addDir();
+  return file.saveText(prompt);
+};
+
+/**
+ * 获取提示词
+ * @returns {string} 提示词内容
+ */
+Knowledge.prototype.getPrompt = function () {
+  let file = this.getPromptFile();
+  return file.loadText();
+};
+
+/**
+ * 获取知识详情
+ * @returns {object} - 知识详情
+ */
+Knowledge.prototype.getDetail = function () {
+  let info = {
+    ...this.config
+  };
+  info.knowledge_dir = this.getDir();
+  info.config_file = this.config_file;
+  info.prompt_file = this.getPromptFile();
+  return info;
+};
+
+module.exports = {
+  Knowledge
+};

package/core/knowledge/knowledge.tpl.md

@@ -0,0 +1,13 @@
+# ${title || '常识知识'}
+
+## 基础知识
+- 
+
+## 通用规范
+- 
+
+## 注意事项
+- 
+
+## 常见问题
+- 

package/core/llm/config.tpl.json

@@ -0,0 +1,24 @@
+{
+  // 模型名称, 一般直接用chat.model的值命名，例如deepseek_chat
+  "name": "${name || 'deepseek_chat'}",
+  // 模型标题
+  "title": "${title || ''}",
+  // 模型描述
+  "description": "${description || ''}",
+  // 主程序路径
+  "main": "",
+  // API基础URL
+  "base_url": "https://api.deepseek.com",
+  // API密钥
+  "api_key": "${llm_key.deepseek}",
+  // 模型名称
+  "model": "deepseek-chat",
+  // 温度参数，控制生成文本的随机性
+  "temperature": 0.8,
+  // 最大对话轮数
+  "max_turns": 50,
+  // 最大生成令牌数，超过此值的文本会被截断
+  "max_tokens": 1024,
+  // 工具调用参数 auto: 自动调用工具；never: 不调用工具；always: 总是调用工具
+  "tool_choice": "auto"
+}