Codex Taskboard常见问题解答新手入门到高级用户的疑难解决【免费下载链接】dashi-taskboard项目地址: https://gitcode.com/gh_mirrors/da/dashi-taskboardCodex Taskboard是一个本地优先的议题面板可在浏览器中运行也可通过独立CDP启动器或其注入脚本嵌入Codex同一套HTTP API为React UI和随附Codex Skill使用的taskctlCLI提供支持能帮助用户高效管理项目任务。一、基础安装与运行问题1. 安装前需要满足哪些系统要求Codex Taskboard对系统环境有一定要求Node.js需22.5或更高版本。如果要构建macOS App和DMG还需要Xcode Command Line Tools、Rust 1.88或更高版本以及aarch64-apple-darwin和x86_64-apple-darwintargetnpm install会安装本项目使用的Tauri CLI。2. 如何在本地快速运行Codex Taskboard在项目中依次运行以下命令即可在本地启动npm install npm run build npm start之后打开 http://127.0.0.1:47823 就能使用SQLite数据库存储在.data/taskboard.sqlite。如果需要在前端实时重载模式下开发可运行npm run devVite UI会运行在 http://127.0.0.1:5173 并将API请求代理到本地服务。3. 从哪里获取项目代码如果需要clone仓库仓库的地址是 https://gitcode.com/gh_mirrors/da/dashi-taskboard 。二、CLI使用问题1. 如何使用taskctlCLI创建项目和任务在项目中运行相应命令即可创建项目和任务例如创建项目npm run taskctl -- project create \ --id my-project \ --name My project \ --workspace-path /absolute/path/to/repository创建任务npm run taskctl -- issue create \ --project my-project \ --title Implement the next slice \ --status todo \ --priority high \ --labels product,mvp还可以运行npm link以便在shell路径中直接使用taskctl。2. 如何让CLI指向其他本地或局域网服务设置CODEX_TASKBOARD_URL环境变量就可让CLI指向另一个本地或局域网服务。云端部署通过回环companion使用taskctl cloud login配置。三、Codex Skill安装与使用问题1. 怎样安装Codex Skill将skills/manage-taskboard复制或符号链接到Codex Skill目录然后启动一个新的Codex任务命令如下ln -s /absolute/path/to/codex-taskboard/skills/manage-taskboard \ ~/.codex/skills/manage-taskboard2. Codex Skill有什么功能该Skill会指导Codex检查议题将其移到in_progress使用乐观版本控制验证工作然后将其移到in_review只有在用户明确确认接受或要求将议题标记为完成后才会将议题移到done。四、嵌入Codex相关问题1. 如何手动使用专用CDP端口嵌入Codex首先让现有Codex窗口保持打开在Taskboard仓库中使用专用CDP端口启动第二个Codex实例open -n -a /Applications/ChatGPT.app --args \ --remote-debugging-port9231 \ --remote-allow-originshttp://127.0.0.1:9231新Codex窗口出现后在另一个终端中运行注入器CODEX_TASKBOARD_HOST127.0.0.1 \ npm run codex:inject -- --port 9231 --open使用嵌入式面板时让注入器终端保持运行原Codex窗口不会变化新窗口会显示Taskboard侧边栏入口。如果端口9231已被占用可在两个命令中使用另一个端口。2. 有没有更推荐的启动独立Taskboard窗口的方法有的让现有Codex窗口保持打开然后运行CODEX_TASKBOARD_HOST127.0.0.1 npm run codex该命令会在需要时启动本地Taskboard服务使用独立配置文件和仅限回环访问的端口9231启动官方macOS Codex App等使用嵌入式面板时请让该命令保持运行。3. macOS App如何使用如需进行Tauri开发运行npm run app:dev如需构建本地App和DMG先安装两个Rust target然后运行构建rustup target add aarch64-apple-darwin x86_64-apple-darwin npm run app:build从Finder打开src-tauri/target/universal-apple-darwin/release/bundle/macos/Codex Taskboard.appDMG位于src-tauri/target/universal-apple-darwin/release/bundle/dmg/。该App包含自己的Node运行时等数据存储在~/Library/Application Support/Codex Taskboard启动器输出写入~/Library/Logs/Codex Taskboard/codex-taskboard-launcher.log。五、配置问题1. 有哪些常用的配置变量及用途常用的配置变量如下 | 变量 | 默认值 | 用途 | | --- | --- | --- | |CODEX_TASKBOARD_HOST|0.0.0.0| HTTP绑定地址使用127.0.0.1可禁用局域网访问 | |CODEX_TASKBOARD_PORT|47823| 本地HTTP端口 | |CODEX_TASKBOARD_DATA_DIR|.data| SQLite数据目录 | |CODEX_TASKBOARD_URL|http://127.0.0.1:47823| CLI API源地址 |2. 局域网共享服务需要注意什么npm start会输出本地URL和可用的局域网URL同一受信任网络中的协作者可打开局域网URL使用同一个Taskboard服务。但局域网模式没有账户身份验证受信任本地网络中任何能访问该URL的人都可以读取和写入Taskboard公网和云端部署需要经过身份验证的部署边界。六、云端协作问题对于两名受信任的协作者Taskboard可以在Cloudflare上运行使用Worker Static Assets和API路由以D1作为权威业务数据库并使用私有R2 bucket存储附件。每台设备保留自己的项目检出映射并继续使用本地companion提供相关能力云端模式绝不会回退到本地SQLite数据库也不会同时写入本地数据库。详细内容可参阅云端协作。七、验证问题可通过运行npm run check命令来验证该命令会运行TypeScript检查、生产前端构建以及服务器/CLI/注入测试套件。【免费下载链接】dashi-taskboard项目地址: https://gitcode.com/gh_mirrors/da/dashi-taskboard创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考