@zhin.js/agent 0.0.18 → 0.0.20

package/CHANGELOG.md

@@ -1,5 +1,23 @@
 # @zhin.js/agent
 
+## 0.0.20
+
+### Patch Changes
+
+- c606a57: fix: ask_user 优化
+- Updated dependencies [c606a57]
+  - @zhin.js/core@1.0.57
+  - @zhin.js/ai@1.0.18
+
+## 0.0.19
+
+### Patch Changes
+
+- 20ab379: fix: ai 优化
+- Updated dependencies [20ab379]
+  - @zhin.js/ai@1.0.17
+  - @zhin.js/core@1.0.56
+
 ## 0.0.18
 
 ### Patch Changes

package/README.md

@@ -7,10 +7,13 @@ Zhin AI Agent 组合层：在 `@zhin.js/core` 的类型与 Provider 之上，提
 - 🤖 **Agent 循环**：`Agent` / `createAgent`，支持工具调用、迭代与事件
 - 📝 **会话管理**：`SessionManager`、内存/数据库会话、`SessionManager.generateId`
 - 🧠 **ZhinAgent**：与 Zhin 消息流集成的智能体（SOUL/TOOLS/AGENTS、工具收集、执行策略）
+- �️ **6 层 Bash 安全**：`ExecPolicy` 纵深防御（危险黑名单、环境变量剥离、wrapper 剥离、复合命令拆分、只读放行、交互式审批）
+- 📂 **文件访问安全**：`FilePolicy` 路径检查、设备路径拦截、命令读写分类
+- 📋 **10 段系统提示词**：`PromptBuilder` 结构化 prompt（Identity、System、Tasks、Actions、Tools、Communication、Skills、Active Skills、Memory、Bootstrap）
 - 🔌 **框架挂载**：`initAgentModule()` 注册 `ctx.ai`、定时任务、DB 模型等
 - 📦 **上下文与记忆**：`ContextManager`、`ConversationMemory`、`UserProfileStore`
 - ⏰ **跟进与定时**：`FollowUpManager`、`PersistentCronEngine`、cron 工具
-- 🔧 **内置工具**：calculator、time、search、codeRunner、http、memory 等
+- 🔧 **内置工具**：bash、read_file、write_file、ask_user、web_search、chat_history 等
 - 📐 **会话压缩**：`compactSession`、token 估算、总结与裁剪
 - 🪝 **Hook 系统**：`registerAIHook`、`triggerAIHook` 等
 
@@ -76,7 +79,9 @@ const result = await agent.run('你好')
 | 初始化 | `initAgentModule` |
 | Agent | `Agent`, `createAgent`, `formatToolTitle` |
 | 服务与会话 | `AIService`, `SessionManager`, `MemorySessionManager`, `DatabaseSessionManager`, `createMemorySessionManager`, `createDatabaseSessionManager` |
-| ZhinAgent | `ZhinAgent`，以及 config / exec-policy / tool-collector / prompt / builtin-tools 等子模块 |
+| ZhinAgent | `ZhinAgent`，以及 config / exec-policy / file-policy / tool-collector / prompt / builtin-tools 等子模块 |
+| 安全策略 | `checkExecPolicy`, `applyExecPolicyToTools`, `isDangerousCommand`, `stripEnvVarPrefix`, `stripSafeWrappers`, `splitCompoundCommand`, `extractCommandName`, `ExecPolicyResult`, `checkFileAccess`, `classifyBashCommand`, `isBlockedDevicePath` |
+| 提示词构建 | `buildRichSystemPrompt`, `buildEnhancedPersona`, `buildUserMessageWithHistory`, `buildContextHint` |
 | 上下文与记忆 | `ContextManager`, `createContextManager`, `ConversationMemory`, `UserProfileStore` |
 | 跟进与定时 | `FollowUpManager`, `PersistentCronEngine`, `createCronTools`, `setCronManager`, `getCronManager` |
 | 压缩与 Bootstrap | `compactSession`, `estimateTokens`, `loadBootstrapFiles`, `loadSoulPersona`, `loadToolsGuide`, `loadAgentsMemory` |
@@ -190,8 +195,9 @@ src/
 ├── hooks.ts
 ├── output.ts
 ├── tools.ts
-├── builtin-tools.ts
+├── builtin-tools.ts      # 内置工具（bash、read_file、ask_user 等）
 ├── tone-detector.ts
+├── file-policy.ts        # 文件访问安全（路径检查、设备拦截、命令分类）
 ├── init.ts               # initAgentModule 精简入口（委托子模块）
 ├── init/                 # init 子模块（从 init.ts 拆分）
 │   ├── shared-refs.ts
@@ -207,11 +213,11 @@ src/
 │   └── register-builtin-tools.ts
 └── zhin-agent/           # ZhinAgent 及子模块
     ├── index.ts          # ZhinAgent 主类
-    ├── config.ts
-    ├── exec-policy.ts
-    ├── tool-collector.ts
-    ├── prompt.ts
-    └── builtin-tools.ts
+    ├── config.ts         # 配置与常量（ModelSizeHint、KEYWORD_TRIGGERS 等）
+    ├── exec-policy.ts    # Bash 执行安全（6 层纵深防御）
+    ├── tool-collector.ts # 工具收集与过滤
+    ├── prompt.ts         # 系统提示词构建器（10 段结构化架构）
+    └── builtin-tools.ts  # ZhinAgent 专用内置工具
 ```
 
 ### 构建

package/lib/builtin-tools.d.ts

@@ -7,11 +7,15 @@
  * 计划:      todo_read, todo_write
  * 记忆:      read_memory, write_memory (AGENTS.md)
  * 技能:      activate_skill, install_skill
+ * 交互:      ask_user（基于 Prompt 类的用户确认/提问工具）
  *
  * 发现逻辑已拆分到 discover-skills.ts / discover-agents.ts / discover-tools.ts
  */
+import { type Plugin } from '@zhin.js/core';
 import { ZhinTool } from '@zhin.js/core';
 export interface BuiltinToolsOptions {
+    /** 插件实例，用于 ask_user 工具创建 Prompt 交互 */
+    plugin?: Plugin;
     /** Max chars for skill instruction extraction (model-size-aware) */
     skillInstructionMaxChars?: number;
     /**

package/lib/builtin-tools.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"builtin-tools.d.ts","sourceRoot":"","sources":["../src/builtin-tools.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAOH,OAAO,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAC;AAczC,MAAM,WAAW,mBAAmB;IAClC,oEAAoE;IACpE,wBAAwB,CAAC,EAAE,MAAM,CAAC;IAClC;;OAEG;IACH,wBAAwB,CAAC,EAAE,MAAM,MAAM,EAAE,CAAC;IAC1C;;;OAGG;IACH,eAAe,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,MAAM,GAAG,SAAS,CAAC;CACxD;AAED;;GAEG;AACH,wBAAgB,kBAAkB,CAAC,OAAO,CAAC,EAAE,mBAAmB,GAAG,QAAQ,EAAE,CAie5E"}
+{"version":3,"file":"builtin-tools.d.ts","sourceRoot":"","sources":["../src/builtin-tools.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAMH,OAAO,EAA2B,KAAK,MAAM,EAAiE,MAAM,eAAe,CAAC;AACpI,OAAO,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAC;AAkMzC,MAAM,WAAW,mBAAmB;IAClC,sCAAsC;IACtC,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,oEAAoE;IACpE,wBAAwB,CAAC,EAAE,MAAM,CAAC;IAClC;;OAEG;IACH,wBAAwB,CAAC,EAAE,MAAM,MAAM,EAAE,CAAC;IAC1C;;;OAGG;IACH,eAAe,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,MAAM,GAAG,SAAS,CAAC;CACxD;AAED;;GAEG;AACH,wBAAgB,kBAAkB,CAAC,OAAO,CAAC,EAAE,mBAAmB,GAAG,QAAQ,EAAE,CAqtB5E"}