@movemama/opencode-legacy 1.0.0 → 1.0.1

package/README.md

@@ -4,6 +4,25 @@ OpenCode legacy 文本处理插件，面向 `GB2312` 文本、脚本型 `.txt`
 
 当前主链路已经改为纯 JS 编码实现，不再依赖系统外部 `iconv.exe`。
 
+## 规则注入
+
+插件现在会在每轮对话自动读取并注入以下规则文件：
+
+1. 全局 `AGENTS.md`：根据当前环境变量 `USERPROFILE` 或 `HOME` 动态解析到 `~/.config/opencode/AGENTS.md`
+2. 项目 `AGENTS.md`：根据当前打开项目的 `worktree` 动态解析到 `<worktree>/AGENTS.md`
+
+注入后的硬规则会进入系统上下文，用于约束代理优先读取规则、完整读取目标文件、以及统一输出回执。
+
+另外，插件已为以下编辑类工具增加前置守卫：
+
+- `edit`
+- `write`
+- `script-edit`
+- `legacy_edit`
+- `legacy_write`
+
+如果当前会话尚未完成 `AGENTS.md` 规则注入，上述工具会直接拒绝执行，以避免代理在未读取规则的情况下改文件。
+
 ## 安装
 
 在 OpenCode 配置中加入：

package/index.js

@@ -4,18 +4,27 @@ import editTool from './tools/edit.js'
 import scriptEditTool from './tools/script-edit.js'
 import legacyStatusTool from './tools/legacy-status.js'
 import { edit as legacyEditTool, read as legacyReadTool, write as legacyWriteTool } from './tools/legacy.js'
+import { createAgentsRuleHooks } from './tools/agents-rules.js'
 
-export const OpenCodeLegacyPlugin = async () => ({
-  tool: {
-    read: readTool,
-    write: writeTool,
-    edit: editTool,
-    'script-edit': scriptEditTool,
-    legacy_read: legacyReadTool,
-    legacy_write: legacyWriteTool,
-    legacy_edit: legacyEditTool,
-    legacy_status: legacyStatusTool,
-  },
-})
+export const OpenCodeLegacyPlugin = async (context, options = {}) => {
+  const agentsRuleHooks = createAgentsRuleHooks({
+    worktree: context.worktree,
+    globalAgentsPath: options.globalAgentsPath,
+  })
+
+  return {
+    tool: {
+      read: readTool,
+      write: writeTool,
+      edit: editTool,
+      'script-edit': scriptEditTool,
+      legacy_read: legacyReadTool,
+      legacy_write: legacyWriteTool,
+      legacy_edit: legacyEditTool,
+      legacy_status: legacyStatusTool,
+    },
+    ...agentsRuleHooks,
+  }
+}
 
 export default OpenCodeLegacyPlugin

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@movemama/opencode-legacy",
-  "version": "1.0.0",
+  "version": "1.0.1",
   "description": "OpenCode legacy text processing plugin for GB2312 and script-safe editing workflows.",
   "type": "module",
   "main": "./index.js",

package/plugin-meta.js

@@ -10,5 +10,6 @@ export function getPluginMeta() {
       'legacy_write',
       'legacy_edit',
     ],
+    hookNames: ['experimental.chat.system.transform', 'tool.execute.before'],
   }
 }

package/tools/agents-rules.js

@@ -0,0 +1,76 @@
+import { existsSync, readFileSync } from 'node:fs'
+import path from 'node:path'
+
+const EDIT_GUARDED_TOOLS = new Set(['edit', 'write', 'script-edit', 'legacy_edit', 'legacy_write'])
+
+function normalizeLineEndings(content) {
+  return content.replace(/\r\n/g, '\n').trim()
+}
+
+function getDefaultGlobalAgentsPath() {
+  const home = process.env.USERPROFILE || process.env.HOME || ''
+  return path.join(home, '.config', 'opencode', 'AGENTS.md')
+}
+
+function readAgentsFileIfExists(filePath) {
+  if (!filePath || !existsSync(filePath)) {
+    return null
+  }
+
+  return normalizeLineEndings(readFileSync(filePath, 'utf8'))
+}
+
+function buildInjectedRulesBlock(entries) {
+  const sections = entries
+    .filter((entry) => entry.content)
+    .map((entry) => [`## ${entry.label}`, entry.content].join('\n'))
+
+  return [
+    '[AGENTS Rules Bootstrap]',
+    '你必须在本轮严格遵守以下规则优先级：系统 > 开发者 > 全局 AGENTS.md > 项目 AGENTS.md > 用户临时偏好。',
+    '硬性要求：分析或编辑前先读取规则与目标文件完整内容；文件过长时连续分段读取；上下文不足前不得做结构判断或编辑判断。',
+    '硬性要求：所有用户可见输出必须使用简体中文；受限时必须说明受限原因、影响范围、备选方案；回复末尾必须输出规则执行回执。',
+    ...sections,
+  ].join('\n\n')
+}
+
+export function createAgentsRuleHooks(input = {}) {
+  const globalAgentsPath = input.globalAgentsPath || getDefaultGlobalAgentsPath()
+  const projectAgentsPath = path.join(input.worktree, 'AGENTS.md')
+  const sessionBootstrapState = new Set()
+
+  function loadRules() {
+    return [
+      {
+        label: 'Global AGENTS.md',
+        path: globalAgentsPath,
+        content: readAgentsFileIfExists(globalAgentsPath),
+      },
+      {
+        label: 'Project AGENTS.md',
+        path: projectAgentsPath,
+        content: readAgentsFileIfExists(projectAgentsPath),
+      },
+    ]
+  }
+
+  return {
+    'experimental.chat.system.transform': async (hookInput, output) => {
+      const entries = loadRules()
+      const injected = buildInjectedRulesBlock(entries)
+      output.system.push(injected)
+      if (hookInput?.sessionID) {
+        sessionBootstrapState.add(hookInput.sessionID)
+      }
+    },
+    'tool.execute.before': async (hookInput) => {
+      if (!EDIT_GUARDED_TOOLS.has(hookInput.tool)) {
+        return
+      }
+
+      if (!sessionBootstrapState.has(hookInput.sessionID)) {
+        throw new Error('当前会话尚未完成 AGENTS.md 规则注入，已禁止编辑类工具执行。请先让插件读取全局与项目 AGENTS.md。')
+      }
+    },
+  }
+}