@chenglu.she/sandy 1.0.3 → 1.0.4

package/README.md

@@ -31,7 +31,7 @@ mkdir -p ~/treedome && cd ~/treedome
 sandy init
 ```
 
-会交互式询问飞书 / Cursor / Agent 等项，并写入当前目录的 `config.yaml`。也可参考 [config.yaml.example](./config.yaml.example) 手改。
+会交互式询问飞书 / Cursor / Agent 等项，并写入当前目录的 `config.yaml`。人设模板见 [templates/sandy.mdc](./templates/sandy.mdc)，可复制到 `.cursor/rules/`。
 
 必填项：
 
@@ -68,14 +68,16 @@ Agent 通过 `settingSources: ["project"]` 加载这些规则。人设、业务
 
 1. **应用能力** → 开通 **机器人**
 2. **权限**（开通后**发布新版本**才生效），至少：
-   - 消息：获取与发送单聊/群消息、上传图片、上传文件、下载文件（如 `im:message`、`im:resource`）
-   - 文档：读正文、创建文档、编辑文档（如 `docx:document:readonly`、`docx:document` / write）
-   - 若要把新建文档放到指定文件夹：Drive 文件夹相关权限，并填 `feishuDocsFolder`
-3. **版本管理**：发布；可用范围包含你自己
-4. **事件与回调** → 订阅方式选 **长连接**（先让 bot 进程在线再保存）
-5. 事件：`im.message.receive_v1`
-6. 回调：`card.action.trigger`（Agent 选择题卡片用）
-7. **读写已有文档**：在飞书文档里把机器人加为协作者（读/编辑），仅开通 API 权限不够
+   - **单聊**：`im:message.p2p_msg:readonly`（只有群聊 @ 能回、私聊没反应，通常是缺这个）
+   - **群聊 @**：`im:message.group_at_msg:readonly`
+   - **发消息**：`im:message`
+   - 文件：上传/下载（`im:resource` 等）
+   - 文档：读/写 docx（按需）
+3. **版本管理**：发布；**可用范围**包含你自己
+4. **事件与回调** → 长连接（先 `sandy` 在线再保存）
+5. 事件 `im.message.receive_v1`：点进去确认 **单聊消息**、**群聊 @ 机器人** 子开关都已开通
+6. 回调：`card.action.trigger`
+7. **读写已有文档**：把机器人加为文档协作者
 
 ### 5. 启动
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@chenglu.she/sandy",
-  "version": "1.0.3",
+  "version": "1.0.4",
   "license": "MIT",
   "type": "module",
   "description": "Feishu long-connection bot that drives Cursor agents via @cursor/sdk",
@@ -26,7 +26,8 @@
     "assets",
     "README.md",
     "LICENSE",
-    "config.yaml.example"
+    "config.yaml.example",
+    "templates"
   ],
   "scripts": {
     "dev": "tsx watch src/cli.ts",

package/src/index.ts

@@ -218,9 +218,14 @@ async function handleMessage(raw: Parameters<typeof parseIncomingMessage>[0]) {
   const { text, mentionedBot } = extractText(msg, botOpenId ?? "");
 
   if (!shouldHandleMessage(msg, mentionedBot)) {
+    console.log(
+      `[handle] ignored chat_type=${msg.chatType} message_type=${msg.messageType} mentionedBot=${mentionedBot}`,
+    );
     return;
   }
 
+  console.log(`[handle] chat_type=${msg.chatType} message_id=${msg.messageId}`);
+
   const sessionKey = msg.chatId;
 
   let attachmentPrompt: string | undefined;

package/src/init-guides.ts

@@ -36,10 +36,15 @@ export const INIT_FIELD_GUIDES = {
     title: "飞书后台还需完成（init 不会替你操作）",
     lines: [
       "1. 应用能力 → 开通「机器人」",
-      "2. 权限管理 → 开通消息 / 文件 / 文档等权限，并发布新版本",
-      "3. 事件与回调 → 订阅方式选「长连接」",
-      "   事件：im.message.receive_v1；回调：card.action.trigger",
-      "4. 先在本机运行 sandy，看到 ws client ready 后再在后台保存长连接配置",
+      "2. 权限管理（缺一不可，改完必须发布新版本）：",
+      "   · 读取用户发给机器人的单聊消息 im:message.p2p_msg:readonly",
+      "   · 获取用户在群组中@机器人的消息 im:message.group_at_msg:readonly",
+      "   · 获取与发送单聊、群组消息 im:message",
+      "   · 文件 / 文档权限按需开通",
+      "3. 事件与回调 → 长连接；订阅 im.message.receive_v1",
+      "   点进该事件，确认「单聊消息」「群聊 @ 机器人」等子项均为已开通",
+      "4. 可用范围包含测试账号；先运行 sandy（ws client ready）再保存长连接",
+      "5. 群聊能回、私聊不回 → 几乎总是缺 p2p 权限或事件子开关未开",
     ],
     links: [
       { label: "事件订阅（长连接）", url: "https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/event-subscription-guide/long-connection-mode" },

package/src/write-hook-policy.ts

@@ -29,7 +29,6 @@ export function writeHookPolicy(): string {
   const payload = {
     updatedAt: new Date().toISOString(),
     allowedRoots: [...new Set(roots)],
-    protectedWriteGlobs: [".cursor/rules", ".rules"],
   };
   fs.writeFileSync(policyPath, JSON.stringify(payload, null, 2), "utf8");
   return policyPath;

package/templates/sandy.mdc

@@ -0,0 +1,22 @@
+---
+description: Sandy 松鼠 — 通用飞书 Cursor Agent 人设模板
+alwaysApply: true
+---
+
+# Sandy 松鼠
+
+你是 **Sandy 松鼠**，开发与运维助手。
+
+## 职责
+
+- 协助写代码、排障、运维与部署
+- 在飞书里回答简洁、可执行；需要选择时用选择题
+- 可在 `AGENT_CWD/.cursor/rules/` 下创建或更新规则，沉淀领域约定与协作习惯
+- 文件修改范围以 `config.yaml` 里的 `agent.cwd` / `agent.dirs` 白名单为准
+- 可使用本机 shell（SSH / git / 项目脚本），除非 `agent.sandbox=true`
+
+## 风格
+
+- 自称：Sandy 松鼠
+- 直接、靠谱、少废话；先给结论再展开
+- 领域约定写在同目录其它 rules 里，按需维护