{"id":24618142,"url":"https://github.com/atorber/one-man-team","last_synced_at":"2026-02-08T15:02:19.015Z","repository":{"id":270934991,"uuid":"911897187","full_name":"atorber/one-man-team","owner":"atorber","description":"将飞书知识库与cursor联系在一起的文档同步工具，一人团队文档协作利器。","archived":false,"fork":false,"pushed_at":"2025-01-04T08:12:36.000Z","size":307,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":1,"default_branch":"main","last_synced_at":"2025-03-05T13:08:55.914Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":"","language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/atorber.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":null,"code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2025-01-04T06:02:48.000Z","updated_at":"2025-01-04T08:12:16.000Z","dependencies_parsed_at":"2025-01-04T07:25:04.478Z","dependency_job_id":"61940c02-b74f-4abe-b291-0eec34ffaf5d","html_url":"https://github.com/atorber/one-man-team","commit_stats":null,"previous_names":["atorber/one-man-team"],"tags_count":4,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/atorber%2Fone-man-team","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/atorber%2Fone-man-team/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/atorber%2Fone-man-team/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/atorber%2Fone-man-team/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/atorber","download_url":"https://codeload.github.com/atorber/one-man-team/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":244313902,"owners_count":20433011,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":[],"created_at":"2025-01-24T23:50:20.170Z","updated_at":"2026-02-08T15:02:18.783Z","avatar_url":"https://github.com/atorber.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"# OMT - OneManTeam CLI Tool\n\nOMT 是一个用于管理文档知识库的命令行工具。它可以帮助你管理产品文档知识库，快速和你的开发项目进行知识共享。\n\n## 快速入门\n\n1. 安装omt cli工具\n\n```bash\npip install one-man-team\n```\n\n2. 设置飞书应用凭证  \n\n```bash\nomt config set --app-id YOUR_APP_ID --app-secret YOUR_APP_SECRET\n```\n\n3. 运行`omt project init my-project`，就可以在知识库中创建一个项目文档，然后你可以在飞书知识库中创建，进行知识共享。\n\n![omt-project-init](./docs/images/lark-docs.png)\n\n4. 运行`omt project clone my-project`，就可以将你项目文档克隆到本地项目的dev-docs目录下，之后就可以使用cursor愉快进行项目开发。\n\n![omt-project-init](./docs/images/dev-docs.png)\n\n## 安装\n\n1. 克隆仓库：\n```bash\ngit clone \u003crepository-url\u003e\ncd \u003crepository-directory\u003e\n```\n\n2. 安装依赖：\n```bash\npip install -e .\n```\n\n## 快速开始\n\n1. 设置配置：\n```bash\n# 设置应用凭证\nomt config set --app-id YOUR_APP_ID --app-secret YOUR_APP_SECRET\n\n# 验证配置\nomt config get\n```\n\n2. 创建项目：\n```bash\n# 创建新项目\nomt project init my-project\n\n# 创建项目并关联知识库\nomt project init my-project --space-name \"My Project Space\"\n```\n\n## 命令参考\n\n### 配置命令 (config)\n```bash\n# 完整形式\nomt config set --app-id YOUR_APP_ID --app-secret YOUR_APP_SECRET --output-format yaml\n\n# 简写形式\nomt config set -i YOUR_APP_ID -s YOUR_APP_SECRET -t YOUR_APP_TOKEN -o yaml\n\n# 查看配置\nomt config get\n\n# 设置默认空间（完整形式）\nomt config set --default-space SPACE_NAME\n\n# 设置默认空间（简写形式）\nomt config set -d SPACE_NAME\n```\n\n### 项目命令 (project)\n```bash\n# 初始化项目（完整形式）\nomt project init PROJECT_NAME --space-name SPACE_NAME\n\n# 初始化项目（简写形式）\nomt project init PROJECT_NAME -s SPACE_NAME\n\n# 克隆项目（完整形式）\nomt project clone PROJECT_NAME --space-name SPACE_NAME [--force]\n\n# 克隆项目（简写形式）\nomt project clone PROJECT_NAME -s SPACE_NAME [-f]\n```\n\n### 知识库命令 (space)\n```bash\n# 列出知识库（完整形式）\nomt space list --page-size 20 --lang zh\n\n# 列出知识库（简写形式）\nomt space list -p 20 -l zh\n\n# 获取知识库信息\nomt space get                       # 使用默认空间\nomt space get SPACE_NAME           # 指定空间名称\n\n# 创建知识库\nomt space create SPACE_NAME\n\n# 列出知识库节点（完整形式）\nomt space nodes SPACE_NAME --parent-token TOKEN\n\n# 列出知识库节点（简写形式）\nomt space nodes SPACE_NAME -p TOKEN\n\n# 获取知识库拓扑\nomt space topology SPACE_NAME\n\n# 获取节点信息\nomt space node SPACE_NAME NODE_NAME\n\n# 创建节点（完整形式）\nomt space create-node SPACE_NAME NODE_TITLE --node-type origin --obj-type docx\n\n# 创建节点（简写形式）\nomt space create-node SPACE_NAME NODE_TITLE -t origin -o docx\n\n# 获取节点内容（完整形式）\nomt space content SPACE_NAME NODE_NAME --format markdown\n\n# 获取节点内容（简写形式）\nomt space content SPACE_NAME NODE_NAME -f markdown\n\n# 列出知识库节点\nomt space nodes                     # 使用默认空间\nomt space nodes SPACE_NAME          # 指定空间名称\nomt space nodes -p PARENT_TOKEN     # 列出指定父节点下的节点\n\n# 获取知识库信息\nomt space get                       # 使用默认空间\nomt space get SPACE_NAME           # 指定空间名称\n\n# 获取节点内容\nomt space content NODE_NAME         # 使用默认空间\nomt space content SPACE_NAME NODE_NAME  # 指定空间名称\n```\n\n### 节点命令 (node)\n```bash\n# 获取节点信息\nomt node info OBJ_TOKEN\n\n# 获取节点内容（完整形式）\nomt node content OBJ_TOKEN --format markdown\n\n# 获取节点内容（简写形式）\nomt node content OBJ_TOKEN -f markdown\n\n# 获取原始内容\nomt node content OBJ_TOKEN --format raw\n```\n\n### 命令补全\n```bash\n# 安装补全脚本\nomt completion install --shell bash  # 完整形式\nomt completion install -s bash      # 简写形式\n\n# 查看补全脚本\nomt completion show [--shell bash|zsh|fish]\n```\n\n## 项目结构模板\n\n当使用 `omt project init` 创建项目时，会创建以下标准结构：\n\n```\nPROJECT_NAME/\n├── 需求文档/\n│   └── 需求规格说明书\n├── 原型文档/\n├── 接口文档/\n│   ├── 资源池API文档\n│   └── 分布式训练任务API文档\n└── 设计文档/\n```\n\n## 环境变量\n\n工具会按以下优先级查找配置：\n\n1. 项目目录下的 `.env` 文件\n2. 用户目录下的 `~/.omt/.env` 文件\n\n主要的环境变量：\n- `app_id`: 飞书应用 ID\n- `app_secret`: 飞书应用密钥\n- `app_token`: 飞书应用令牌\n- `output_format`: 输出格式（yaml/json，默认：yaml）\n- `default_space`: 默认知识库名称\n\n## 命令补全\n\nOMT 支持命令行补全功能。\n\n### 安装补全脚本\n\n```bash\n# 安装 Bash 补全\nomt completion install\n\n# 或者手动安装（Bash）\nomt completion show \u003e\u003e ~/.bashrc\nsource ~/.bashrc\n```\n\n## 注意事项\n\n1. 请妥善保管应用凭证，不要将其提交到版本控制系统\n2. 建议使用项目级的 `.env` 文件来存储项目特定的配置\n3. 部分操作可能需要较长时间，请耐心等待\n4. 创建节点时的类型说明：\n   - node_type: 通常使用 \"origin\"\n   - obj_type: 可以是 \"docx\"（文档）等\n\n## 常见问题\n\n1. 配置文件找不到\n   - 确保已运行 `omt config set` 设置配置\n   - 检查 `~/.omt/.env` 文件是否存在\n\n2. 权限不足\n   - 确保应用具有足够的权限\n   - 检查应用凭证是否正确\n\n3. 命令格式错误\n   - 不要重复输入 `omt`\n   - 确保按照文档中的命令格式使用\n\n## 贡献\n\n欢迎提交 Issue 和 Pull Request！\n\n## 许可证\n\n[MIT License](LICENSE)\n\n## 参数简写对照表\n\n| 命令组    | 完整参数        | 简写参数 | 说明                    |\n|-----------|----------------|----------|------------------------|\n| config    | --app-id       | -i       | 飞书应用 ID            |\n|           | --app-secret   | -s       | 飞书应用密钥           |\n|           | --app-token    | -t       | 飞书应用令牌           |\n|           | --output-format| -o       | 输出格式               |\n|           | --default-space| -d       | 默认知识库             |\n| space     | --page-size    | -p       | 每页显示数量           |\n|           | --lang         | -l       | 语言                   |\n|           | --parent-token | -p       | 父节点 Token           |\n|           | --node-type    | -t       | 节点类型               |\n|           | --obj-type     | -o       | 对象类型               |\n|           | --format       | -f       | 内容格式               |\n| project   | --space-name   | -s       | 知识库名称             |\n| completion| --shell        | --shell  | Shell 类型             |\n| node      | --format       | -f       | 内容格式               |\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fatorber%2Fone-man-team","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fatorber%2Fone-man-team","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fatorber%2Fone-man-team/lists"}