growork 1.0.0

package/.claude/commands/push.md

@@ -0,0 +1,48 @@
+---
+allowed-tools: Bash
+argument-hint: "[commit message]"
+description: 自动提交所有更改并推送到远程仓库
+---
+
+## 自动提交并推送代码
+
+自动执行 git add、commit 和 push 操作。
+
+### 当前状态
+
+- 当前分支: !`git branch --show-current`
+- Git 状态: !`git status --short`
+
+### 执行任务
+
+1. 查看当前所有变更：`git status`
+2. 添加所有文件：`git add .`
+3. 创建提交：
+   - 如果用户提供了提交信息（$ARGUMENTS），使用该信息
+   - 如果没有提供，根据变更内容生成简洁明了的中文提交信息
+4. 推送到远程：`git push`
+5. 报告结果（显示提交哈希和推送状态）
+
+### 提交信息规范
+
+如果需要自动生成提交信息，请遵循以下原则：
+- 使用中文
+- 使用现在时态（例如："添加功能" 而不是 "已添加功能"）
+- 简洁明了，总结主要变更
+- 示例："更新简历模型和UI"、"重构认证流程"、"修复导航bug"
+
+### 错误处理
+
+- 如果没有需要提交的变更，提示用户
+- 如果推送失败（远程有新提交），建议先执行 `git pull --rebase`
+- 如果有其他错误，显示错误信息并提供解决建议
+
+### 使用示例
+
+```bash
+# 自动生成提交信息
+/push
+
+# 使用自定义提交信息
+/push 添加面试功能模块
+```

package/.claude/settings.local.json

@@ -0,0 +1,22 @@
+{
+  "permissions": {
+    "allow": [
+      "Bash",
+      "Read",
+      "Write",
+      "Edit",
+      "Glob",
+      "Grep",
+      "Task",
+      "WebFetch",
+      "WebSearch",
+      "NotebookEdit",
+      "mcp__*",
+      "mcp__dart__*"
+    ]
+  },
+  "enableAllProjectMcpServers": true,
+  "enabledMcpjsonServers": [
+    "dart-mcp"
+  ]
+}

package/.mcp.json

@@ -0,0 +1,14 @@
+{
+  "mcpServers": {
+    "figma": {
+      "type": "http",
+      "url": "https://mcp.figma.com/mcp"
+    },
+    "dart": {
+      "command": "dart",
+      "args": [
+        "mcp-server"
+      ]
+    }
+  }
+}

package/README.md

@@ -0,0 +1,244 @@
+# GroWork - 文档同步工具
+
+把你的**飞书文档**和 **Notion 页面**自动下载到本地，变成 Markdown 文件。
+
+这样 AI 工具（如 Claude、Cursor、Windsurf）就能直接读取你的产品文档，帮你写代码。
+
+---
+
+## 这个工具能做什么？
+
+✅ 自动下载飞书文档，转成 Markdown 格式
+✅ 自动下载 Notion 页面，转成 Markdown 格式
+✅ 一条命令同步所有文档
+✅ 文档更新后，重新运行命令即可获取最新内容
+
+---
+
+## 安装步骤
+
+### 第一步：安装 Node.js
+
+GroWork 需要 Node.js 才能运行。如果你还没安装：
+
+1. 打开 https://nodejs.org/
+2. 点击绿色的 **"LTS"** 按钮下载
+3. 双击下载的文件，按提示完成安装
+
+**检查是否安装成功：**
+
+打开「终端」（Mac）或「命令提示符」（Windows），输入：
+
+```bash
+node -v
+```
+
+如果显示类似 `v18.17.0` 的版本号，说明安装成功。
+
+---
+
+### 第二步：安装 GroWork
+
+在终端中输入：
+
+```bash
+npm install -g growork
+```
+
+等待安装完成即可。
+
+---
+
+## 使用方法
+
+### 1. 初始化项目
+
+进入你的项目文件夹，运行：
+
+```bash
+growork init
+```
+
+这会在当前目录创建一个 `growork.config.yaml` 配置文件。
+
+---
+
+### 2. 获取飞书凭证（如果你要同步飞书文档）
+
+你需要在飞书开放平台创建一个应用，获取「App ID」和「App Secret」。
+
+**详细步骤：**
+
+1. **打开飞书开放平台**
+   - 国际版 Lark：https://open.larksuite.com/
+   - 国内版飞书：https://open.feishu.cn/
+
+2. **创建应用**
+   - 点击「创建企业自建应用」
+   - 填写应用名称（随便起，比如「文档同步」）
+   - 点击「创建」
+
+3. **获取凭证**
+   - 在应用详情页，找到「凭证与基础信息」
+   - 复制 **App ID**（以 `cli_` 开头）
+   - 复制 **App Secret**
+
+4. **开通权限**
+   - 点击左侧「权限管理」
+   - 搜索并开通以下权限：
+     - `docx:document:readonly`（读取文档）
+     - `wiki:wiki:readonly`（读取知识库）
+   - 点击「批量开通」
+
+5. **发布应用**
+   - 点击「版本管理与发布」
+   - 点击「创建版本」，填写版本号（如 1.0.0）
+   - 提交审核（企业内部应用一般自动通过）
+
+---
+
+### 3. 获取 Notion 凭证（如果你要同步 Notion 页面）
+
+**详细步骤：**
+
+1. **创建 Integration**
+   - 打开 https://www.notion.so/my-integrations
+   - 点击「New integration」
+   - 填写名称（随便起，比如「文档同步」）
+   - 选择你的 Workspace
+   - 点击「Submit」
+
+2. **复制 Token**
+   - 在 Integration 详情页，点击「Show」查看 Token
+   - 复制这个 Token（以 `ntn_` 或 `secret_` 开头）
+
+3. **给页面授权**（重要！）
+   - 打开你要同步的 Notion 页面
+   - 点击右上角「···」→「Connections」→「Connect to」
+   - 选择你刚创建的 Integration
+   - **每个要同步的页面都需要做这一步！**
+
+---
+
+### 4. 编辑配置文件
+
+用任意文本编辑器打开 `growork.config.yaml`，填入你的凭证和文档链接：
+
+```yaml
+# 飞书配置（如果不用飞书，可以删除这部分）
+feishu:
+  appId: "cli_你的AppID"        # 替换成你的 App ID
+  appSecret: "你的AppSecret"     # 替换成你的 App Secret
+  domain: "lark"                # 国际版用 lark，国内版用 feishu
+
+# Notion 配置（如果不用 Notion，可以删除这部分）
+notion:
+  token: "ntn_你的Token"         # 替换成你的 Token
+
+# 要同步的文档列表
+docs:
+  # 飞书文档示例
+  - name: prd                    # 给文档起个名字（英文，方便记忆）
+    type: feishu                 # 类型：feishu
+    url: "https://xxx.larksuite.com/wiki/xxxxx"  # 文档链接
+    output: "docs/prd.md"        # 保存到哪里
+
+  # Notion 页面示例
+  - name: design                 # 给文档起个名字
+    type: notion                 # 类型：notion
+    url: "https://notion.so/xxxxx"  # 页面链接
+    output: "docs/design.md"     # 保存到哪里
+```
+
+**如何获取文档链接？**
+
+- **飞书**：打开文档，直接复制浏览器地址栏的链接
+- **Notion**：打开页面，点击右上角「Share」→「Copy link」
+
+---
+
+### 5. 同步文档
+
+运行以下命令，自动下载所有文档：
+
+```bash
+growork sync
+```
+
+同步完成后，文档会保存到你配置的 `output` 路径。
+
+**只同步某一个文档：**
+
+```bash
+growork sync prd
+```
+
+**查看所有已配置的文档：**
+
+```bash
+growork list
+```
+
+---
+
+## 常见问题
+
+### Q: 提示「权限不足」或「401」错误
+
+**飞书文档：**
+- 确认应用已开通 `docx:document:readonly` 和 `wiki:wiki:readonly` 权限
+- 确认应用已发布上线
+- 确认你有权限访问该文档
+
+**Notion 页面：**
+- 确认你已经把 Integration 连接到了该页面（见上面第 3 步的「给页面授权」）
+
+---
+
+### Q: 提示「找不到命令」或「command not found」
+
+Node.js 可能没有正确安装，或者 npm 全局路径没有加入系统 PATH。
+
+尝试重新安装 Node.js，或者使用 `npx` 运行：
+
+```bash
+npx growork sync
+```
+
+---
+
+### Q: 同步后文档是空的
+
+- 检查文档链接是否正确
+- 检查你是否有权限访问该文档
+- 飞书知识库文档需要使用 `/wiki/` 格式的链接
+
+---
+
+### Q: 如何更新已同步的文档？
+
+直接再次运行 `growork sync`，会自动覆盖本地文件。
+
+---
+
+## 支持的文档类型
+
+| 平台 | 支持的内容 |
+| --- | --- |
+| 飞书 | 普通文档 (`/docx/`)、知识库 (`/wiki/`) |
+| Notion | 任意页面（包含数据库的页面会自动转为表格） |
+
+---
+
+## 需要帮助？
+
+如果遇到问题，可以：
+
+1. 在 GitHub 上提 Issue：https://github.com/你的仓库/issues
+2. 检查上面的「常见问题」部分
+
+---
+
+## License
+
+MIT

package/bin/growork.js

@@ -0,0 +1,2 @@
+#!/usr/bin/env node
+import('../dist/index.js');

package/claude.md

@@ -0,0 +1,150 @@
+# GroWork 架构原则
+
+## 核心原则：用最少的代码实现功能
+
+### 为什么
+
+- 代码越少，bug 越少
+- 代码越少，维护成本越低
+- 代码越少，理解成本越低
+- AI Agent 时代，简洁的代码更容易被 AI 理解和修改
+
+### 具体实践
+
+#### 1. 不要提前抽象
+
+```typescript
+// ❌ 不要这样：还没用到就提前封装
+class DocumentSyncerFactory {
+  create(type: string): DocumentSyncer { ... }
+}
+
+// ✅ 应该这样：直接写，等真正需要时再抽象
+async function syncFeishuDoc(url: string, output: string) { ... }
+```
+
+#### 2. 不要写"可能用到"的代码
+
+- 只实现当前需求，不实现"将来可能需要"的功能
+- 删掉所有注释掉的代码
+- 删掉所有未使用的函数、变量、导入
+
+#### 3. 优先使用标准库和成熟依赖
+
+```typescript
+// ❌ 不要自己造轮子
+function parseYaml(content: string) { ... }
+
+// ✅ 使用成熟的库
+import yaml from 'yaml'
+```
+
+#### 4. 一个函数只做一件事
+
+```typescript
+// ❌ 不要这样：一个函数做太多事
+async function syncDoc(config) {
+  const yaml = readFile(...)
+  const parsed = parseYaml(yaml)
+  for (const doc of parsed.docs) {
+    const content = await fetchFeishu(doc.url)
+    const md = convertToMarkdown(content)
+    writeFile(doc.output, md)
+  }
+}
+
+// ✅ 应该这样：职责分离，但不过度拆分
+async function syncDoc(doc: DocConfig) {
+  const content = await fetchFeishuDoc(doc.url)
+  await writeFile(doc.output, content)
+}
+```
+
+#### 5. 避免过度配置化
+
+```typescript
+// ❌ 不要这样：过度灵活
+interface Config {
+  outputFormat: 'markdown' | 'html' | 'json'
+  templatePath?: string
+  customConverter?: (content: any) => string
+  hooks?: { beforeSync?: () => void, afterSync?: () => void }
+}
+
+// ✅ 应该这样：满足当前需求即可
+interface DocConfig {
+  name: string
+  url: string
+  output: string
+}
+```
+
+#### 6. 错误处理要简洁
+
+```typescript
+// ❌ 不要这样：过度防御
+try {
+  const result = await fetchDoc(url)
+  if (!result) throw new Error('Empty result')
+  if (!result.data) throw new Error('No data')
+  if (!result.data.content) throw new Error('No content')
+  return result.data.content
+} catch (e) {
+  if (e instanceof NetworkError) { ... }
+  else if (e instanceof AuthError) { ... }
+  else if (e instanceof TimeoutError) { ... }
+  else { ... }
+}
+
+// ✅ 应该这样：让错误自然抛出，在顶层统一处理
+const { data } = await fetchDoc(url)
+return data.content
+```
+
+#### 7. 目录结构保持扁平
+
+```
+// ❌ 不要这样：过深的嵌套
+src/
+  core/
+    services/
+      sync/
+        feishu/
+          index.ts
+
+// ✅ 应该这样：扁平简洁
+src/
+  commands/
+  services/
+  utils/
+```
+
+## 代码规范
+
+### 命名
+
+- 文件名：小写 + 连字符，如 `feishu-sync.ts`
+- 函数名：动词开头，如 `syncDoc`, `parseConfig`
+- 布尔变量：is/has/should 开头，如 `isValid`
+
+### 注释
+
+- 好的代码不需要注释
+- 只在"为什么"不明显时写注释，不要写"做什么"的注释
+- 删掉所有 TODO 注释，要么现在做，要么建 issue
+
+### 依赖
+
+- 能用标准库解决的不引入新依赖
+- 优先选择零依赖或依赖少的库
+- 定期清理未使用的依赖
+
+## 检查清单
+
+提交代码前问自己：
+
+- [ ] 这个函数/文件/模块可以删掉吗？
+- [ ] 这段代码有更简单的写法吗？
+- [ ] 这个抽象真的需要吗？
+- [ ] 这个配置项真的会用到吗？
+- [ ] 新人看到这段代码能立刻理解吗？

package/dist/index.d.ts

@@ -0,0 +1 @@
+#!/usr/bin/env node